layro-cli 0.1.0 → 0.3.0

package/README.md

@@ -1,8 +1,9 @@
 # layro-cli
 
-Publish React components to [Layro](https://layro.dev) from your terminal.
+Find and publish React components on [Layro](https://layro.dev) from your terminal.
 
 ```bash
+npx layro-cli search pricing toggle
 npx layro-cli login
 npx layro-cli publish components/pricing-card.tsx
 ```
@@ -11,23 +12,24 @@ Requires Node 20 or newer. No dependencies.
 
 ## Commands
 
-| Command                    | Does                                                                                                     |
-| -------------------------- | -------------------------------------------------------------------------------------------------------- |
-| `layro login`              | Sign in with GitHub in your browser (no API keys). `--no-browser` prints the link.                       |
-| `layro whoami`             | Who you're signed in as, and submissions left today.                                                     |
-| `layro publish <files…>`   | Send a new component, or a new version of one you already have (same name). The first file is the entry. |
-| `layro status [component]` | Where your submissions stand, with reviewers' reasons. `component` is a slug or `author/slug`.           |
-| `layro add <author/slug>`  | Prints the shadcn command that installs a component.                                                     |
-| `layro logout`             | Revokes the session and forgets it on this computer.                                                     |
+| Command                    | Does                                                                                                           |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `layro search <words…>`    | Find components, best match first (typos are fine, no sign-in). `--category`, `--author`, `--limit`, `--json`. |
+| `layro login`              | Sign in with GitHub in your browser (no API keys). `--no-browser` prints the link.                             |
+| `layro whoami`             | Who you're signed in as, and submissions left today.                                                           |
+| `layro publish <files…>`   | Send a new component, or a new version of one you already have (same name). The first file is the entry.       |
+| `layro status [component]` | Where your submissions stand, with reviewers' reasons. `component` is a slug or `author/slug`.                 |
+| `layro add <author/slug>`  | Prints the shadcn command that installs a component.                                                           |
+| `layro logout`             | Revokes the session and forgets it on this computer.                                                           |
 
 ### 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.1.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(
@@ -520,6 +534,36 @@ async function publish(server2, paths, flags) {
   say(dim(`  Submissions left today: ${result.submissionsLeftToday}`));
 }
 
+// src/search.ts
+async function search(server2, words, flags) {
+  const q = words.join(" ").trim();
+  if (!q) throw new CliError("Give some words: layro search <words\u2026>");
+  const params = new URLSearchParams({ q });
+  if (flags.category) params.set("category", flags.category);
+  if (flags.author) params.set("author", flags.author);
+  if (flags.limit) params.set("limit", flags.limit);
+  const found = await api(server2, `/search?${params}`, { auth: false });
+  if (flags.json) return say(JSON.stringify(found, null, 2));
+  if (found.results.length === 0) {
+    say(`Nothing matches "${q}".`);
+    if (found.suggestion)
+      say(
+        `The closest category is ${bold(found.suggestion.name)}: ${found.suggestion.url}`
+      );
+    return;
+  }
+  for (const c of found.results) {
+    say(`${bold(c.name)} ${dim(c.id)}`);
+    say(`  ${c.description}`);
+    say(dim(`  ${c.install}`));
+  }
+  say(
+    dim(
+      `${found.results.length} ${found.results.length === 1 ? "result" : "results"}. Install one with the command under it.`
+    )
+  );
+}
+
 // src/status.ts
 var LABEL = {
   live: "live",
@@ -574,9 +618,10 @@ async function status(server2, target) {
 }
 
 // src/index.ts
-var HELP = `${bold("layro")} ${dim(VERSION)}: publish React components to Layro
+var HELP = `${bold("layro")} ${dim(VERSION)}: find and publish React components on Layro
 
 Usage
+  layro search <words\u2026>       Find components (typos are fine; no sign-in needed)
   layro login                 Sign in with GitHub in your browser
   layro whoami                Who you're signed in as
   layro publish <files\u2026>      Send a new component, or a new version of yours
@@ -593,13 +638,21 @@ 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
+  --category <slug>           Only this category
+  --author <handle>           Only this author's components
+  --limit <n>                 1 to 50 (default 20)
+  --json                      Print the API's JSON
+
 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`;
@@ -661,14 +714,34 @@ 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;
+    }
+    case "search": {
+      const { values, positionals } = parseArgs({
+        args: rest,
+        allowPositionals: true,
+        options: {
+          category: { type: "string" },
+          author: { type: "string" },
+          limit: { type: "string" },
+          json: { type: "boolean" }
+        }
       });
+      await search(server, positionals, values);
       return;
     }
     case "status": {

package/package.json

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