shiply-cli 0.2.0 → 0.3.0

package/README.md

@@ -13,12 +13,16 @@ curl -fsSL https://shiply.now/install.sh | bash
 
 ```bash
 shiply publish ./dist          # publish a directory, print the live URL
+shiply publish ./dist          # run it AGAIN → updates the SAME site (no new subdomain)
 shiply publish ./dist --spa    # single-page app mode
 shiply login                   # email a 6-digit code, mint + save an API key
-shiply update ./dist --claim-token <token>   # push a new version to an anonymous site
 shiply status <slug-or-domain> [--wait]      # SSL + readiness check — confetti when live 🎉
 ```
 
+shiply remembers each directory's site in `.shiply.json` (slug + update token),
+so repeat publishes always hit the same URL. Use `--new-site` to start fresh;
+gitignore `.shiply.json` in public repos.
+
 `shiply status` prints stable `SSL_READY` / `SITE_READY` markers for agents and
 exits 0 only when the certificate is valid and the site serves. `--wait` polls
 until ready (great while a custom domain's certificate issues).

package/dist/index.js

@@ -4,32 +4,35 @@ import { parseArgs } from 'node:util';
 import { confetti } from './confetti.js';
 import { loadApiKey, saveApiKey } from './config.js';
 import { api, DEFAULT_BASE, publish, resolveBase } from './publish.js';
+import { readState, writeState } from './state.js';
 import { checkReadiness, targetToHostname } from './status.js';
-const HELP = `shiply — instant static hosting for agents (https://shiply.now)
-
-Usage:
-  shiply publish <dir> [options]              Publish a directory, print the live URL
-  shiply update <dir> --claim-token <token>   Push a new version to an anonymous site
-  shiply status <slug-or-domain> [--wait]     SSL + readiness check (agent-friendly output)
-  shiply login [--email <address>]            Email a 6-digit code, mint + save an API key
-  shiply help
-
-Options:
-  --spa                  Single-page app mode (unknown paths fall back to index.html)
-  --claim-token <tok>    Update the anonymous site this token belongs to
-  --key <key>            API key (default: $SHIPLY_API_KEY, then ~/.shiply/credentials)
-  --anonymous            Publish without an API key even if one is saved
-  --base <url>           API origin (default: ${DEFAULT_BASE})
-  --wait                 (status) poll until the site is ready
-  --timeout <seconds>    (status --wait) give up after this long (default 300)
-  --no-confetti          Celebrate quietly
-
-\`shiply status\` prints stable machine-readable markers for agents:
-SSL_READY and SITE_READY on success (exit 0); ✖ lines and exit 1 otherwise.
-
-With an API key the site is permanent and owned by your account. Without one
-it expires in 24 hours — save the printed claimToken/claimUrl to update or
-claim it later.
+const HELP = `shiply — instant static hosting for agents (https://shiply.now)
+
+Usage:
+  shiply publish <dir> [options]              Publish a directory, print the live URL.
+                                              Re-running UPDATES the same site (state in .shiply.json)
+  shiply update <dir>                         Same as publish when .shiply.json exists
+  shiply status <slug-or-domain> [--wait]     SSL + readiness check (agent-friendly output)
+  shiply login [--email <address>]            Email a 6-digit code, mint + save an API key
+  shiply help
+
+Options:
+  --spa                  Single-page app mode (unknown paths fall back to index.html)
+  --claim-token <tok>    Update a specific anonymous site (overrides .shiply.json)
+  --new-site             Ignore .shiply.json and create a fresh site
+  --key <key>            API key (default: $SHIPLY_API_KEY, then ~/.shiply/credentials)
+  --anonymous            Publish without an API key even if one is saved
+  --base <url>           API origin (default: ${DEFAULT_BASE})
+  --wait                 (status) poll until the site is ready
+  --timeout <seconds>    (status --wait) give up after this long (default 300)
+  --no-confetti          Celebrate quietly
+
+\`shiply status\` prints stable machine-readable markers for agents:
+SSL_READY and SITE_READY on success (exit 0); ✖ lines and exit 1 otherwise.
+
+With an API key the site is permanent and owned by your account. Without one
+it expires in 24 hours — save the printed claimToken/claimUrl to update or
+claim it later.
 `;
 async function reportReadiness(host, celebrate) {
     const r = await checkReadiness(host);
@@ -65,6 +68,7 @@ async function main() {
             base: { type: 'string' },
             email: { type: 'string' },
             wait: { type: 'boolean' },
+            'new-site': { type: 'boolean' },
             timeout: { type: 'string' },
             'no-confetti': { type: 'boolean' },
             help: { type: 'boolean', short: 'h' },
@@ -80,18 +84,34 @@ async function main() {
         case 'update': {
             if (!dir)
                 throw new Error(`usage: shiply ${cmd} <dir>`);
-            if (cmd === 'update' && !values['claim-token']) {
-                throw new Error('shiply update needs --claim-token <token> (printed by the original publish)');
-            }
             const apiKey = values.anonymous ? undefined : (values.key ?? (await loadApiKey()));
+            // same command, same URL: reuse this directory's site automatically
+            const state = await readState(dir);
+            let claimToken = values['claim-token'] ?? state?.claimToken;
+            let slug = state?.owned && apiKey ? state.slug : undefined;
+            if (values['new-site']) {
+                claimToken = values['claim-token'];
+                slug = undefined;
+            }
+            if (cmd === 'update' && !claimToken && !slug) {
+                throw new Error('nothing to update here — publish first (shiply remembers the site in .shiply.json), or pass --claim-token');
+            }
+            const updating = Boolean(claimToken || slug);
             const res = await publish(dir, {
                 apiKey,
                 base: values.base,
                 spaMode: values.spa,
-                claimToken: values['claim-token'],
+                claimToken,
+                slug,
+            });
+            await writeState(dir, {
+                slug: res.slug,
+                siteUrl: res.siteUrl,
+                ...(res.claimToken ? { claimToken: res.claimToken } : state?.claimToken && updating ? { claimToken: state.claimToken } : {}),
+                owned: !res.anonymous,
             });
             const skipped = res.skipped > 0 ? ` (${res.skipped} unchanged, skipped)` : '';
-            console.log(`✔ published ${res.uploaded} file${res.uploaded === 1 ? '' : 's'}${skipped}`);
+            console.log(`✔ ${updating ? `updated ${res.slug} in place` : 'published'} — ${res.uploaded} file${res.uploaded === 1 ? '' : 's'}${skipped}`);
             console.log(`\n  ${res.siteUrl}\n`);
             // confirm the site actually serves, then celebrate
             try {
@@ -107,14 +127,14 @@ async function main() {
             catch {
                 /* serving check is best-effort */
             }
+            if (!updating) {
+                console.log(`  saved .shiply.json — run \`shiply publish ${dir}\` again to UPDATE this same site`);
+                console.log(`  (gitignore .shiply.json if this folder is public — it can update the site)`);
+            }
             if (res.anonymous) {
                 console.log(`  anonymous site — expires ${res.expiresAt ?? 'in 24h'}`);
                 if (res.claimUrl)
-                    console.log(`  claim it (make permanent): ${res.claimUrl}`);
-                if (res.claimToken) {
-                    console.log(`  claimToken (SAVE THIS — shown once): ${res.claimToken}`);
-                    console.log(`  update later: shiply update <dir> --claim-token ${res.claimToken}`);
-                }
+                    console.log(`  claim it to KEEP it (free account): ${res.claimUrl}`);
                 console.log(`  tip: run \`shiply login\` first to publish permanent sites`);
             }
             return;

package/dist/publish.js

@@ -39,6 +39,7 @@ export async function publish(dir, opts = {}) {
             files,
             ...(opts.spaMode ? { spaMode: true } : {}),
             ...(opts.claimToken ? { claimToken: opts.claimToken } : {}),
+            ...(opts.slug ? { slug: opts.slug } : {}),
         }),
     });
     await uploadAll(dir, created.upload.uploads);

package/dist/state.js

@@ -0,0 +1,16 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export const stateFile = (dir) => join(dir, '.shiply.json');
+export async function readState(dir) {
+    try {
+        const raw = await readFile(stateFile(dir), 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed.slug ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeState(dir, state) {
+    await writeFile(stateFile(dir), `${JSON.stringify(state, null, 2)}\n`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shiply-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Publish static sites to shiply.now from the command line — instant web hosting for agents.",
   "license": "MIT",
   "type": "module",