@getxflow/cli 1.0.0 → 1.0.1

package/dist/bin.js

@@ -223,11 +223,15 @@ async function run(args) {
                 await (0, pages_1.pagesRollback)(rest);
                 return;
             }
+            if (second === 'rm' || second === 'remove') {
+                await (0, pages_1.pagesRemove)(rest);
+                return;
+            }
             if (second === undefined || second === 'list') {
                 await (0, pages_1.pagesList)(rest);
                 return;
             }
-            throw new errors_1.CliError(`Unknown command: pages ${second}`, 'Available: list, create, deploy, status and rollback');
+            throw new errors_1.CliError(`Unknown command: pages ${second}`, 'Available: list, create, deploy, status, rollback and rm');
         case 'status':
             await (0, sources_1.status)();
             return;

package/dist/commands/pages.js

@@ -5,6 +5,7 @@ exports.pagesCreate = pagesCreate;
 exports.pagesDeploy = pagesDeploy;
 exports.pagesStatus = pagesStatus;
 exports.pagesRollback = pagesRollback;
+exports.pagesRemove = pagesRemove;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const api_1 = require("../api");
@@ -231,3 +232,27 @@ async function pagesRollback(args) {
         (0, ui_1.warn)(`The page is switched off: version ${revision} is current and goes live when it is switched on`);
     (0, ui_1.out)(page.url);
 }
+async function pagesRemove(args) {
+    const ref = args.words[1];
+    if (!ref) {
+        throw new errors_1.CliError('A page is required', 'The name from its address, or its id. The pages: xflow pages');
+    }
+    // The page is read first: deleting is confirmed by the name in the address, and the
+    // page can be named here by its id.
+    const client = pagesClient();
+    const { page } = await (0, api_1.apiJson)(client, pagePath(ref));
+    const query = (0, args_1.flagBool)(args, 'yes') ? `?confirm=${encodeURIComponent(page.slug)}` : '';
+    try {
+        await (0, api_1.apiJson)(client, `${pagePath(page.id)}${query}`, { method: 'DELETE' });
+    }
+    catch (e) {
+        // The platform names what goes and refuses until the answer is seen. Said in the
+        // words of this command, not of the API.
+        if (e instanceof api_1.ApiError && e.code === 'confirm_required') {
+            throw new errors_1.CliError(e.message, `To delete it anyway: xflow pages rm ${page.slug} --yes`);
+        }
+        throw e;
+    }
+    (0, ui_1.ok)(`The page is deleted: ${page.url} shows nothing now`);
+    (0, ui_1.note)((0, ui_1.dim)(`  Its versions are gone for good, the name ${page.slug} stays reserved for the organization`));
+}

package/dist/flags.js

@@ -95,6 +95,8 @@ exports.KNOWN = {
     'pages deploy': ['message'],
     'pages status': ['json'],
     'pages rollback': [],
+    'pages rm': ['yes'],
+    'pages remove': ['yes'],
     status: [],
     dev: [],
     pull: ['into', 'force', 'revision'],

package/dist/help.js

@@ -108,6 +108,7 @@ ${(0, ui_1.bold)('Pages')}
                                   upload the site: live at once, there is no publish step
   xflow pages status <page>       the page and its versions
   xflow pages rollback <page> <N> put an earlier version back on the address
+  xflow pages rm <page> --yes     delete the page for good: the address empties
 
 ${(0, ui_1.bold)('Reference')}
   xflow logs [--limit N]          browser errors of the published apps
@@ -282,6 +283,8 @@ the platform builds, with versions, access levels and a database through functio
       -m <text>                        what changed, one short line: it names the version
   xflow pages status <page>            the page and its versions
   xflow pages rollback <page> <N>      put version N back on the address
+  xflow pages rm <page>                delete the page
+      --yes                            without it the command names what goes and stops
 
 ${(0, ui_1.bold)('<path>')} is a folder with index.html at the top, its .zip, or one .html file.
 ${(0, ui_1.bold)('<page>')} is the name from the address or the id. ${(0, ui_1.bold)('--json')} on list and status
@@ -304,9 +307,14 @@ add the page name there and run ${(0, ui_1.bold)('xflow deploy functions')}. The
 Such a function is open to the whole internet. Search engines are asked not to index pages,
 so do not promise SEO.
 
+${(0, ui_1.bold)('Deleting is final.')} The address goes empty and every version of the page is gone: there
+is no undo and no copy on the platform side. The name stays reserved for the organization, so
+the same ${(0, ui_1.bold)('--slug')} is free for the next page of yours and taken for everyone else. A
+throwaway page put up to try something is worth deleting the same way it was made.
+
 A page takes the key of the whole organization, the one ${(0, ui_1.bold)('xflow login')} issues: a key
-scoped to projects is refused. Switching a page off and deleting it are for a person, in the
-platform interface.`,
+scoped to projects is refused. A page is deleted by whoever made it, or by the owner of the
+organization. Switching a page off for a while is for a person, in the platform interface.`,
     update: `${(0, ui_1.bold)('xflow update')}: bring the CLI up to date
 
 Installs the published version and, if anything changed, rewrites the platform

package/dist/template.js

@@ -2,30 +2,30 @@
 /** Files the CLI lays into a new project root: the app itself comes from the platform template. */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectScaffold = projectScaffold;
-const GITIGNORE = `node_modules/
-dist/
-.xflow/
-.env
-.env.*
+const GITIGNORE = `node_modules/
+dist/
+.xflow/
+.env
+.env.*
 `;
-const README = `# %NAME%
-
-A project on XFlow: one database, cloud functions and the apps that use them.
-
-\`\`\`
-xflow.json          projectId, and which apps and pages may call each function
-package.json        dependencies of the functions
-functions/<name>/   cloud functions, shared by every app
-migrations/         the database of the project
-apps/<folder>/      an app: its own code, versions and address
-\`\`\`
-
-\`\`\`bash
-xflow deploy functions -m "..."      # ship the functions and their callers
-xflow deploy apps/<folder> -m "..."  # build one app
-xflow publish                        # inside an app folder: show the newest build
-xflow status                         # what is on the server
-\`\`\`
+const README = `# %NAME%
+
+A project on XFlow: one database, cloud functions and the apps that use them.
+
+\`\`\`
+xflow.json          projectId, and which apps and pages may call each function
+package.json        dependencies of the functions
+functions/<name>/   cloud functions, shared by every app
+migrations/         the database of the project
+apps/<folder>/      an app: its own code, versions and address
+\`\`\`
+
+\`\`\`bash
+xflow deploy functions -m "..."      # ship the functions and their callers
+xflow deploy apps/<folder> -m "..."  # build one app
+xflow publish                        # inside an app folder: show the newest build
+xflow status                         # what is on the server
+\`\`\`
 `;
 function projectScaffold(projectName) {
     return [

package/dist/version.js

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_API_URL = exports.CLI_VERSION = void 0;
 /** Keep in sync with cli/package.json. */
-exports.CLI_VERSION = '1.0.0';
+exports.CLI_VERSION = '1.0.1';
 /** Overridden by XFLOW_API_URL or the `api` field in xflow.json. */
 exports.DEFAULT_API_URL = 'https://app.getxflow.com';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getxflow/cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "CLI for the XFlow platform: projects with apps, functions and a database; source sync, deployment and publishing",
   "license": "UNLICENSED",
   "engines": {