staticx 0.1.6 → 0.1.8

package/README.md

@@ -40,13 +40,17 @@ staticx mcp
 
 ## Custom domains
 
-Use the CLI when you want to connect a domain without opening the dashboard.
+Use the CLI when you want to start custom domain setup without opening the dashboard.
 
 ```bash
 staticx domain --site-id SITE_ID --domain app.example.com
 ```
 
-The command moves the site to that domain and prints the single DNS record to create. After the DNS record is added, StaticX detects it and activates SSL automatically.
+The command starts the manual DNS flow and prints the single DNS record to create. After the DNS record is added, StaticX detects it and activates SSL automatically.
+
+If you want StaticX to create the DNS record inside an external DNS account, approve DNS Connect from the dashboard. The CLI cannot authorize an external provider silently because the domain owner must approve access in a browser.
+
+Generated subdomain suffixes are configured from the dashboard. If an account has an active publishing domain, open `Site → Settings → Domain` to save a free subdomain on either the StaticX default domain or that publishing domain. The CLI custom-domain command is for exact hosts such as `app.example.com`.
 
 Check progress any time:
 
@@ -117,5 +121,5 @@ STATICX_API_TOKEN=sx_replace_with_your_token npx staticx-mcp-server http
 - `staticx login` stores the base URL and bearer token locally.
 - `staticx whoami` verifies the token with `GET /user`.
 - `staticx deploy` zips the contents of the given build directory, uploads them, and publishes a new release. The directory must contain `index.html` or `index.htm` plus `404.html` at its root.
-- `staticx domain` calls `POST /projects/{project}/domain` and returns the DNS record plus activation status.
+- `staticx domain` calls `POST /projects/{project}/domain` and returns the manual DNS record plus activation status.
 - Golden deploy prompt: “Deploy `dist` to StaticX project `SITE_ID` using `STATICX_API_TOKEN`. Build, validate `index.html` + `404.html`, apply StaticX form rules if forms exist, zip `dist` root, upload, deploy, check logs, then return the live URL or the exact API error. If you receive `PLAN_QUOTA_EXCEEDED`, stop and return the exact quota message. Never expose the token.”

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "staticx",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Public CLI for STATICX using token-authenticated /api/v1 routes.",
   "type": "module",
   "publishConfig": {

package/src/index.js

@@ -19,7 +19,7 @@ import {
   mcpGuideJson,
 } from './output.js';
 
-const CLI_VERSION = '0.1.5';
+const CLI_VERSION = '0.1.7';
 
 export async function run(argv) {
   const program = new Command();
@@ -296,7 +296,7 @@ Deploy rule:
 
   program
     .command('domain')
-    .description('Move a site to a custom domain and print the one DNS record to create.')
+    .description('Start manual custom domain setup and print the one DNS record to create.')
     .requiredOption('--site-id <id>', 'Site ID')
     .requiredOption('--domain <domain>', 'Custom domain, for example app.example.com')
     .option('--json', 'Print JSON output')

package/src/output.js

@@ -65,7 +65,7 @@ export function printLoginSuccess({ baseUrl, user, token }) {
     ['staticx guide', 'Show the complete CLI workflow.'],
     ['staticx sites', 'List the sites visible to this token.'],
     ['staticx deploy --site-id SITE_ID --dir dist', 'Upload and publish a build folder.'],
-    ['staticx domain --site-id SITE_ID --domain app.example.com', 'Move a site to a custom domain.'],
+    ['staticx domain --site-id SITE_ID --domain app.example.com', 'Start manual custom domain setup.'],
   ]);
   console.log('');
   console.log('Build rule: deploy folders must include index.html or index.htm and 404.html at the root.');
@@ -95,7 +95,7 @@ export function printCliGuide() {
   ]);
   console.log('');
   printCommandGroup('Custom domains', [
-    ['staticx domain --site-id SITE_ID --domain app.example.com', 'Move a site to a custom domain and print the DNS record.'],
+    ['staticx domain --site-id SITE_ID --domain app.example.com', 'Start manual custom domain setup and print the DNS record.'],
     ['staticx domain-status --site-id SITE_ID', 'Check DNS, SSL, and activation status.'],
   ]);
   console.log('');
@@ -112,6 +112,8 @@ export function printCliGuide() {
   console.log('');
   console.log('Token scopes: use Site tokens for one-site deploys, Workspace tokens for client workspaces, and Global tokens only for broad operator workflows.');
   console.log('Build rule: deploy folders must include index.html or index.htm and 404.html at the root.');
+  console.log('Domain rule: CLI custom domains use the one-record manual DNS flow. DNS Connect requires browser approval in the dashboard.');
+  console.log('Publishing-domain rule: generated subdomain suffix changes are dashboard-only in Site Settings > Domain.');
   console.log('Plan limits: Free includes 1 site, 500 MB storage, 500 MB uploads, 1,000 form entries, 1 seat, and 5 rollback versions. Plus and Pro raise capacity. Agency uses custom capacity.');
   console.log('Quota rule: stop on PLAN_QUOTA_EXCEEDED and return the exact API message before retrying.');
 }
@@ -193,6 +195,7 @@ export function cliGuideJson() {
       'https://staticx.site/api/v1/openapi.json',
     ],
     build_rule: 'Deploy folders must include index.html or index.htm and 404.html at the root.',
+    domain_rule: 'CLI exact custom domains use the one-record manual DNS flow. Generated subdomain suffix changes are dashboard-only in Site Settings > Domain.',
     token_scopes: 'Use Site tokens for one-site deploys, Workspace tokens for client workspaces, and Global tokens only for broad operator workflows.',
     plan_limits: {
       free: '1 site, 500 MB storage, 500 MB max upload, 1,000 form entries, 1 team seat, last 5 rollback versions.',