staticx 0.1.2 → 0.1.3

package/README.md

@@ -30,9 +30,27 @@ staticx create --workspace-id WORKSPACE_ID --name "Marketing Site"
 staticx create --name "Imported Site" --archive site.zip
 staticx create --name "Imported Site" --source-url "https://example.com"
 staticx deploy --site-id SITE_ID --dir dist
+staticx domain --site-id SITE_ID --domain app.example.com
+staticx domain-status --site-id SITE_ID
 staticx logs --site-id SITE_ID
 ```
 
+## Custom domains
+
+Use the CLI when you want to connect a domain 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.
+
+Check progress any time:
+
+```bash
+staticx domain-status --site-id SITE_ID
+```
+
 ## Token scopes
 
 - Global token: account-wide access for internal operator tools.
@@ -50,3 +68,4 @@ Generate those tokens from:
 - `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.

package/package.json

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

package/src/index.js

@@ -10,13 +10,14 @@ import {
   cliGuideJson,
   formatTokenSummary,
   printCliGuide,
+  printDomainSetup,
   printJson,
   printKeyValue,
   printLoginSuccess,
   printTable,
 } from './output.js';
 
-const CLI_VERSION = '0.1.2';
+const CLI_VERSION = '0.1.3';
 
 export async function run(argv) {
   const program = new Command();
@@ -32,6 +33,7 @@ Common workflow:
   staticx login --base-url "https://staticx.site/api/v1" --token "STATICX_API_TOKEN"
   staticx guide
   staticx deploy --site-id SITE_ID --dir dist
+  staticx domain --site-id SITE_ID --domain app.example.com
 
 Deploy rule:
   The build directory must contain index.html or index.htm and 404.html at its root.
@@ -276,6 +278,47 @@ Deploy rule:
       })));
     });
 
+  program
+    .command('domain')
+    .description('Move a site to a custom domain 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')
+    .option('--base-url <url>', 'Override the stored STATICX API base URL')
+    .option('--token <token>', 'Override the stored STATICX bearer token')
+    .action(async (options, command) => {
+      const client = await clientFromCommand(command);
+      const response = await client.post(`/projects/${options.siteId}/domain`, {
+        json: { domain: options.domain },
+      });
+
+      if (options.json) {
+        printJson(response);
+        return;
+      }
+
+      printDomainSetup(response);
+    });
+
+  program
+    .command('domain-status')
+    .description('Check the custom domain status for one site.')
+    .requiredOption('--site-id <id>', 'Site ID')
+    .option('--json', 'Print JSON output')
+    .option('--base-url <url>', 'Override the stored STATICX API base URL')
+    .option('--token <token>', 'Override the stored STATICX bearer token')
+    .action(async (options, command) => {
+      const client = await clientFromCommand(command);
+      const response = await client.get(`/projects/${options.siteId}/domain`);
+
+      if (options.json) {
+        printJson(response);
+        return;
+      }
+
+      printDomainSetup({ message: 'Custom domain status.', data: response?.data ?? response }, { statusOnly: true });
+    });
+
   await program.parseAsync(argv);
 }
 

package/src/output.js

@@ -10,6 +10,46 @@ export function printTable(rows) {
   console.table(rows);
 }
 
+export function printDomainSetup(response, { statusOnly = false } = {}) {
+  const data = response?.data ?? {};
+  const project = data.project ?? {};
+  const domain = data.custom_domain ?? null;
+  const records = data.dns?.records ?? [];
+  const steps = Array.isArray(data.steps) ? data.steps : [];
+
+  console.log(response?.message || (statusOnly ? 'Custom domain status.' : 'Custom domain setup started.'));
+  console.log('');
+  printAlignedRows([
+    ['Site', project.name || project.id || 'Unknown'],
+    ['Current URL', project.public_url || 'Pending'],
+    ['Custom domain', domain?.host || 'Not connected'],
+    ['Status', domain?.status_label || data.status?.label || 'Pending'],
+  ]);
+
+  if (domain?.status_message || data.status?.message) {
+    console.log('');
+    console.log(domain?.status_message || data.status?.message);
+  }
+
+  if (records.length > 0) {
+    console.log('');
+    console.log('Create this DNS record:');
+    printTable(records.map((record) => ({
+      type: record.type,
+      name: record.name,
+      value: record.value,
+    })));
+  }
+
+  if (steps.length > 0) {
+    console.log('');
+    console.log('Next steps');
+    steps.forEach((step, index) => {
+      console.log(`  ${index + 1}. ${step}`);
+    });
+  }
+}
+
 export function printLoginSuccess({ baseUrl, user, token }) {
   printBanner();
   console.log('Successfully authenticated.');
@@ -25,6 +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.'],
   ]);
   console.log('');
   console.log('Build rule: deploy folders must include index.html or index.htm and 404.html at the root.');
@@ -53,6 +94,11 @@ export function printCliGuide() {
     ['staticx deploy --site-id SITE_ID --dir dist', 'Zip, upload, and publish a build folder.'],
   ]);
   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-status --site-id SITE_ID', 'Check DNS, SSL, and activation status.'],
+  ]);
+  console.log('');
   printCommandGroup('Inspect', [
     ['staticx logs --site-id SITE_ID', 'Read recent site activity.'],
     ['staticx logs --site-id SITE_ID --limit 50', 'Read more rows.'],
@@ -82,6 +128,10 @@ export function cliGuideJson() {
         'staticx create --name "Imported Site" --source-url "https://example.com"',
         'staticx deploy --site-id SITE_ID --dir dist',
       ],
+      domains: [
+        'staticx domain --site-id SITE_ID --domain app.example.com',
+        'staticx domain-status --site-id SITE_ID',
+      ],
       inspect: [
         'staticx logs --site-id SITE_ID',
         'staticx logs --site-id SITE_ID --limit 50',