feat: CLI snapshots, auto-verify integrity, snapshot REST API (#55, #65, #54) #90

Merged

jmiller merged 3 commits from feat/batch-55-65-54 into main 2026-06-22 00:46:52 +00:00

Conversation 0 Commits 3 Files Changed 7

+790 -6

jmiller commented 2026-06-22 00:46:24 +00:00

Owner

Copy Link

Copy Source

Summary

Three features. Closes #55, closes #65, closes #54.

#55: CLI snapshot command

mokosuitebackup:snapshot with four actions:

• create --types=articles,categories,modules --description="text"
• restore --id=N --mode=replace|merge
• list — formatted table output
• delete --id=N

#65: Auto-verify backup integrity

After archive creation + checksum, automatically verifies:

• Archive opens without error
• Has entries, database.sql present for DB backups
• First entry readable (spot-check)
  Applied to both BackupEngine and SteppedBackupEngine.

#54: Snapshot REST API

Five endpoints via Joomla REST API:

• GET /snapshots — list with pagination
• POST /snapshot — create
• POST /snapshot/:id/restore — restore (mode + types)
• DELETE /snapshot/:id — delete
• GET /snapshot/:id/download — stream JSON

Test Plan

• CLI: bin/joomla mokosuitebackup:snapshot create --types=articles
• CLI: bin/joomla mokosuitebackup:snapshot list shows table
• CLI: bin/joomla mokosuitebackup:snapshot restore --id=1 --mode=merge
• Backup creates successfully and log shows "Archive integrity verified"
• Corrupt archive triggers verification failure
• API: GET /api/index.php/v1/mokosuitebackup/snapshots returns list
• API: POST /api/index.php/v1/mokosuitebackup/snapshot creates snapshot

## Summary Three features. Closes #55, closes #65, closes #54. ### #55: CLI snapshot command `mokosuitebackup:snapshot` with four actions: - `create --types=articles,categories,modules --description="text"` - `restore --id=N --mode=replace|merge` - `list` — formatted table output - `delete --id=N` ### #65: Auto-verify backup integrity After archive creation + checksum, automatically verifies: - Archive opens without error - Has entries, `database.sql` present for DB backups - First entry readable (spot-check) Applied to both `BackupEngine` and `SteppedBackupEngine`. ### #54: Snapshot REST API Five endpoints via Joomla REST API: - `GET /snapshots` — list with pagination - `POST /snapshot` — create - `POST /snapshot/:id/restore` — restore (mode + types) - `DELETE /snapshot/:id` — delete - `GET /snapshot/:id/download` — stream JSON ## Test Plan - [ ] CLI: `bin/joomla mokosuitebackup:snapshot create --types=articles` - [ ] CLI: `bin/joomla mokosuitebackup:snapshot list` shows table - [ ] CLI: `bin/joomla mokosuitebackup:snapshot restore --id=1 --mode=merge` - [ ] Backup creates successfully and log shows "Archive integrity verified" - [ ] Corrupt archive triggers verification failure - [ ] API: `GET /api/index.php/v1/mokosuitebackup/snapshots` returns list - [ ] API: `POST /api/index.php/v1/mokosuitebackup/snapshot` creates snapshot

jmiller added the component: enginecomponent: api labels 2026-06-22 00:46:24 +00:00

jmiller added 3 commits 2026-06-22 00:46:24 +00:00

feat: CLI command for content snapshots (#55) ... 0638c2cef6

Add `mokosuitebackup:snapshot` command with four actions:
- create: --types=articles,categories,modules --description="text"
- restore: --id=N --mode=replace|merge --types=articles
- list: displays table of all snapshots
- delete: --id=N removes file + DB record

Closes #55

feat: auto-verify backup integrity after creation (#65) ... 5dcba6d8cb

After archive is created and checksum computed, automatically verify:
- Archive opens without error
- Contains at least one entry
- database.sql present when backup type includes database
- First entry is readable (spot-check)

Applied to both BackupEngine and SteppedBackupEngine. Throws
RuntimeException on verification failure (backup marked as failed).

Closes #65

feat: REST API endpoints for content snapshots (#54) ... c72e950a25

Add five endpoints matching the existing backup API pattern:
- GET /snapshots — list with pagination
- POST /snapshot — create (content_types, description)
- POST /snapshot/:id/restore — restore (mode, content_types)
- DELETE /snapshot/:id — delete record + file
- GET /snapshot/:id/download — stream JSON file

ACL: mokosuitebackup.snapshot.manage for write ops, core.manage for read.
Routes registered in webservices plugin alongside backup routes.

Closes #54

jmiller merged commit 35b7e2a0b8 into main 2026-06-22 00:46:52 +00:00

jmiller deleted branch feat/batch-55-65-54 2026-06-22 00:46:54 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

component: admin

Admin UI and views

component: api

REST API

component: engine

Backup/restore engine

component: remote

Remote storage (FTP/GDrive)

component: scheduler

Scheduled tasks

No labels component: api component: engine

Priority -

Type -

Milestone

No items

No Milestone

Assignees

Clear assignees

jmiller (Jonathan Miller)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteBackup#90