@homespunapps/cli 1.6.67 → 1.6.69

package/dist/commands/apps.js

@@ -49,6 +49,12 @@ export async function runApps(args) {
             return runShareLink(sub);
         case "delete":
             return runDelete(sub);
+        case "deleted":
+            return runDeleted(sub);
+        case "restore":
+            return runRestore(sub);
+        case "purge":
+            return runPurge(sub);
         case "wake":
             return runWake(sub);
         case "watch":
@@ -56,7 +62,7 @@ export async function runApps(args) {
         case "domain":
             return runDomain(sub);
         default:
-            fail(`unknown verb '${verb}': homespun apps <list|show|audit|update|share-link|delete|wake|watch|domain>`, "invalid_args");
+            fail(`unknown verb '${verb}': homespun apps <list|show|audit|update|share-link|delete|deleted|restore|purge|wake|watch|domain>`, "invalid_args");
     }
 }
 // ---------------------------------------------------------------------------
@@ -66,8 +72,8 @@ async function runList(args) {
     assertKnownFlags(args, ...specFor("apps", "list"));
     const status = args.flags.get("status");
     if (status !== undefined &&
-        !["active", "dormant", "archived", "suspended", "all"].includes(status)) {
-        fail("--status must be active|dormant|archived|suspended|all", "invalid_args");
+        !["active", "dormant", "archived", "suspended", "deleted", "all"].includes(status)) {
+        fail("--status must be active|dormant|archived|suspended|deleted|all", "invalid_args");
     }
     const limitRaw = args.flags.get("limit");
     const limit = limitRaw !== undefined ? Number(limitRaw) : undefined;
@@ -225,13 +231,74 @@ async function runDelete(args) {
     if (!appArg)
         fail("usage: homespun apps delete <app> [--yes]", "invalid_args");
     if (!args.bools.has("yes")) {
-        fail("'homespun apps delete' permanently removes the app and all its data — it is destructive. Pass --yes to confirm.", "invalid_args");
+        fail("'homespun apps delete' takes the app offline immediately. Its data is kept and it can be brought back with 'homespun apps restore' until the retention window elapses ('homespun apps deleted' shows the deadline); 'homespun apps purge' destroys it for good. Pass --yes to confirm.", "invalid_args");
     }
     const client = makeClient(args);
     const id = await resolveAppId(client, appArg);
     try {
         await client.deleteApp(id);
-        printJson({ deleted: true, app_id: id });
+        printJson({ deleted: true, app_id: id, restorable: true });
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}
+// ---------------------------------------------------------------------------
+// deleted / restore / purge
+//
+// Named after the row-level `data deleted|restore|purge` verbs that already do
+// exactly this one level down, so the same word means the same thing whichever
+// noun it is typed against.
+// ---------------------------------------------------------------------------
+async function runDeleted(args) {
+    assertKnownFlags(args, ...specFor("apps", "deleted"));
+    const limitRaw = args.flags.get("limit");
+    const limit = limitRaw !== undefined ? Number(limitRaw) : undefined;
+    if (limit !== undefined && !Number.isInteger(limit)) {
+        fail("--limit must be an integer", "invalid_args");
+    }
+    const client = makeClient(args);
+    try {
+        printJson(await client.listApps({
+            status: "deleted",
+            limit,
+            cursor: args.flags.get("cursor"),
+        }));
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}
+async function runRestore(args) {
+    assertKnownFlags(args, ...specFor("apps", "restore"));
+    const appArg = args.positionals[0];
+    if (!appArg)
+        fail("usage: homespun apps restore <app>", "invalid_args");
+    const client = makeClient(args);
+    // includeDeleted, because the whole point is that this app is in trash: the
+    // default resolution path hides it and would fail with app_not_found.
+    const id = await resolveAppId(client, appArg, { includeDeleted: true });
+    try {
+        printJson(await client.restoreApp(id));
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}
+async function runPurge(args) {
+    assertKnownFlags(args, ...specFor("apps", "purge"));
+    const appArg = args.positionals[0];
+    if (!appArg) {
+        fail("usage: homespun apps purge <app> [--yes]", "invalid_args");
+    }
+    if (!args.bools.has("yes")) {
+        fail("'homespun apps purge' destroys the app and all its data immediately and forever — there is no restore afterwards. Pass --yes to confirm.", "invalid_args");
+    }
+    const client = makeClient(args);
+    const id = await resolveAppId(client, appArg, { includeDeleted: true });
+    try {
+        await client.purgeApp(id);
+        printJson({ purged: true, app_id: id });
     }
     catch (e) {
         failFromError(e);

package/dist/help-catalog.js

@@ -31,7 +31,7 @@ const APPS = {
     noun: "apps",
     tagline: "app lifecycle management",
     group: "app",
-    rootSummary: "App lifecycle: list, show, audit (security review of your apps' collection permissions), update, delete, wake, domain (custom domains), watch (stream the app's change feed as JSON-lines).",
+    rootSummary: "App lifecycle: list, show, audit (security review of your apps' collection permissions), update, delete, deleted (what is in the trash), restore, purge (destroy a deleted app for good), wake, domain (custom domains), watch (stream the app's change feed as JSON-lines).",
     verbs: [
         {
             verb: "list",
@@ -39,7 +39,7 @@ const APPS = {
             flags: [
                 {
                     name: "status",
-                    value: "<active|dormant|archived|all>",
+                    value: "<active|dormant|archived|deleted|all>",
                     description: "Filter by lifecycle status",
                 },
                 { name: "limit", value: "<n>", description: "Page size" },
@@ -92,7 +92,26 @@ const APPS = {
         {
             verb: "delete",
             positionals: "<app>",
-            summary: "Soft-deletes an app.",
+            summary: "Takes an app offline. Its data is kept and `apps restore` brings it back until the retention window elapses.",
+            bools: [{ name: "yes", description: "Skip the confirmation prompt" }],
+        },
+        {
+            verb: "deleted",
+            summary: "Lists your deleted apps, each with when it was deleted and when it is purged for good.",
+            flags: [
+                { name: "limit", value: "<n>", description: "Page size" },
+                { name: "cursor", value: "<cursor>", description: "Page cursor" },
+            ],
+        },
+        {
+            verb: "restore",
+            positionals: "<app>",
+            summary: "Brings a deleted app back, with all of its data. Fails if your account is at its app limit.",
+        },
+        {
+            verb: "purge",
+            positionals: "<app>",
+            summary: "Destroys a deleted app and all its data now, instead of waiting out the retention window. Irreversible.",
             bools: [{ name: "yes", description: "Skip the confirmation prompt" }],
         },
         {

package/dist/resolve-app.js

@@ -29,10 +29,17 @@ function looksLikeId(value) {
  * `GET /v1/apps?slug=`. Values that don't look like a cuid skip straight to
  * the slug lookup. Fails with `app_not_found` if no app matches either way.
  */
-export async function resolveAppId(client, value) {
+export async function resolveAppId(client, value, opts = {}) {
+    // Both lookups hide soft-deleted apps by default, which is right for every
+    // verb that operates on a live app and wrong for the three that operate on
+    // trash (`apps deleted|restore|purge`). Those pass includeDeleted, which
+    // swaps BOTH lookups for their trash-aware forms: `?include_deleted=true` on
+    // the detail read, and `?status=deleted` on the slug lookup, since
+    // `?status=all` means "every live status" and would never match.
+    const { includeDeleted = false } = opts;
     if (looksLikeId(value)) {
         try {
-            await client.getApp(value);
+            await client.getApp(value, { includeDeleted });
             return value;
         }
         catch (e) {
@@ -42,10 +49,16 @@ export async function resolveAppId(client, value) {
             // Fall through: treat it as a slug instead.
         }
     }
-    const page = await client.listApps({ status: "all", slug: value, limit: 1 });
+    const page = await client.listApps({
+        status: includeDeleted ? "deleted" : "all",
+        slug: value,
+        limit: 1,
+    });
     const match = page.items[0];
     if (!match) {
-        fail(`no app found with slug '${value}'`, "app_not_found");
+        fail(includeDeleted
+            ? `no deleted app found with slug '${value}'`
+            : `no app found with slug '${value}'`, "app_not_found");
     }
     return match.id;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homespunapps/cli",
-  "version": "1.6.67",
+  "version": "1.6.69",
   "description": "Command-line client for the Homespun relay: deploy a real multi-user web app from your agent, then keep reading and writing its data.",
   "license": "MIT",
   "type": "module",
@@ -36,14 +36,14 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@homespunapps/core": "^1.6.67",
+    "@homespunapps/core": "^1.6.69",
     "qrcode-terminal": "^0.12.0"
   },
   "devDependencies": {
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "@types/qrcode-terminal": "^0.12.2",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "repository": {
     "type": "git",