layro-cli 0.2.0 → 0.3.0

package/README.md

@@ -24,12 +24,12 @@ Requires Node 20 or newer. No dependencies.
 
 ### Publish options
 
-`--name`, `--description` (20 to 200 characters), `--category` (a slug from layro.dev/components), `--license` (MIT, Apache-2.0, ISC or BSD-3-Clause; default MIT), `--version` (new versions: defaults to a patch bump), `--notes` (what changed), `--dark-only`, `--preview <plan.json>` (how to film the preview), `-y, --yes` (don't ask; for CI).
+`--name`, `--description` (20 to 200 characters), `--category` (a slug from layro.dev/components), `--license` (MIT, Apache-2.0, ISC or BSD-3-Clause; default MIT), `--version` (new versions: defaults to a patch bump), `--notes` (what changed), `--dark-only`, `--preview <plan.json>` (how to film the preview), `--if-changed` (new versions: unchanged code or a version still in review exits 0 with "Nothing sent"; for CI), `-y, --yes` (don't ask; for CI).
 
 Everything goes through review on Layro before it's live. The CLI and coding agents (MCP) share one daily allowance of submissions per account.
 
 ## Where tokens live
 
-`~/.config/layro/credentials.json` (or `$XDG_CONFIG_HOME/layro`), readable only by you. Access tokens last an hour and renew themselves. `LAYRO_TOKEN` uses an access token instead; `LAYRO_URL` points at another Layro server.
+`~/.config/layro/credentials.json` (or `$XDG_CONFIG_HOME/layro`), readable only by you. Access tokens last an hour and renew themselves. `LAYRO_TOKEN` uses a token instead: for CI, make a long-lived one at https://layro.dev/settings/tokens (publish only; a GitHub Actions example is at https://layro.dev/docs/cli); `LAYRO_URL` points at another Layro server.
 
 Docs: https://layro.dev/docs/cli

package/dist/layro.mjs

@@ -340,7 +340,7 @@ async function logout(server2) {
 }
 
 // src/api.ts
-var VERSION = true ? "0.2.0" : "dev";
+var VERSION = true ? "0.3.0" : "dev";
 var ApiFailure = class extends CliError {
   constructor(detail) {
     super(detail.error);
@@ -376,13 +376,16 @@ async function api(server2, path, init = {}) {
   if (response.ok && body) return body;
   if (response.status === 401) {
     if (process.env.LAYRO_TOKEN)
-      throw new CliError("LAYRO_TOKEN was refused: it's invalid or expired.");
+      throw new CliError(
+        `LAYRO_TOKEN was refused: it's invalid, revoked or expired. Make a new one at ${server2}/settings/tokens.`
+      );
     throw notSignedIn();
   }
   throw new ApiFailure({
     status: response.status,
     error: body?.error ?? `${server2} answered ${response.status} for ${path}.`,
-    errors: body?.errors
+    errors: body?.errors,
+    code: body?.code
   });
 }
 
@@ -461,14 +464,25 @@ async function publish(server2, paths, flags) {
     const notes = flags.notes ?? (interactive ? await ask("What changed", "") : "");
     if (interactive && !await confirm(`Send ${existing.id} ${version} for review?`))
       return say("Nothing sent.");
-    result = await api(
+    const sent = await api(
       server2,
       `/components/${existing.id}/versions`,
       {
         method: "POST",
         body: { version, notes, files, preview }
       }
-    ).catch(explain);
+    ).catch((error) => {
+      if (flags.ifChanged && error instanceof ApiFailure && (error.detail.code === "unchanged" || error.detail.code === "pending"))
+        return error;
+      return explain(error);
+    });
+    if (sent instanceof ApiFailure) {
+      say(
+        `Nothing sent: ${Object.values(sent.detail.errors ?? {})[0] ?? sent.message}`
+      );
+      return;
+    }
+    result = sent;
   } else {
     if (flags.version && flags.version !== "1.0.0")
       warn(
@@ -624,6 +638,7 @@ Publish options
   --notes <text>              New versions: what changed
   --dark-only                 It only works on a dark page
   --preview <plan.json>       How to film its preview (see the docs)
+  --if-changed                Unchanged code, or a version still in review: say so, exit 0 (CI)
   -y, --yes                   Don't ask; send what's given (for CI)
 
 Search options
@@ -636,7 +651,8 @@ Login options
   --no-browser                Print the sign-in link instead of opening it
 
 Environment
-  LAYRO_TOKEN                 An access token to use instead of signing in
+  LAYRO_TOKEN                 A token to use instead of signing in: an access
+                              token from https://layro.dev/settings/tokens (CI)
   LAYRO_URL                   Another Layro server (default https://layro.dev)
 
 Docs: https://layro.dev/docs/cli`;
@@ -698,13 +714,19 @@ async function main(argv) {
           notes: { type: "string" },
           preview: { type: "string" },
           "dark-only": { type: "boolean" },
+          "if-changed": { type: "boolean" },
           yes: { type: "boolean", short: "y" }
         }
       });
-      const { "dark-only": darkOnly, ...flags } = values;
+      const {
+        "dark-only": darkOnly,
+        "if-changed": ifChanged,
+        ...flags
+      } = values;
       await publish(server, positionals, {
         ...flags,
-        darkOnly
+        darkOnly,
+        ifChanged
       });
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layro-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Find and publish React components on Layro (layro.dev) from your terminal.",
   "license": "MIT",
   "type": "module",