busa-cli 0.9.5 → 0.9.6

package/dist/{chunk-N6NMNVQT.js → chunk-5ZYF74IE.js}

@@ -124,6 +124,7 @@ import { createHash as createHash2 } from "crypto";
 import { readFileSync as readFileSync2 } from "fs";
 import { basename, extname } from "path";
 import {
+  CREATABLE_NODE_TYPES,
   cloudContract,
   createBusabaseClient,
   DEFAULT_BASE_URL as DEFAULT_BASE_URL2,
@@ -363,9 +364,9 @@ async function oauthLogin(baseUrl, useBrowser) {
     throw new Error(`Token exchange failed (HTTP ${tokenRes.status})${text ? `: ${text}` : ""}`);
   }
   const payload = await tokenRes.json();
-  const token = payload.token ?? payload.accessToken;
-  if (!token) throw new Error("Token exchange returned no session token.");
-  return { token, expiresAt: payload.expiresAt };
+  const token = payload.apiKey ?? payload.token ?? payload.accessToken;
+  if (!token) throw new Error("Token exchange returned no credential.");
+  return { token, expiresAt: payload.expiresAt ?? void 0 };
 }
 async function refreshToken(baseUrl, token) {
   const res = await fetch(`${baseUrl}/api/oauth/refresh`, {
@@ -889,8 +890,10 @@ var GENERATED_SKIP = /* @__PURE__ */ new Set([
   // `whoami`
   "records.search",
   // `records by-field-text`
-  "records.listChangeRequests"
+  "records.listChangeRequests",
   // `records change-requests`
+  "airapps.listFiles"
+  // `airapps files`
 ]);
 function registerGeneratedCommands(program, state) {
   const getGroup = (displayName, tag) => program.commands.find((c2) => c2.name() === displayName) ?? program.command(displayName).description(tag ?? `${displayName} endpoints`);
@@ -1052,7 +1055,7 @@ The flags below skip the menu (handy for scripts / CI):
   const nodes = program.command("nodes").description("Workspace node tree");
   addGlobalFlags(nodes.command("list")).description("Workspace node tree").action(runAction(state, (client) => client.nodes.list()));
   addGlobalFlags(nodes.command("create-change-request")).description("Propose a new node via a Change Request").addOption(
-    new Option("--type <folder|base|skill|drive|file|doc>", "node type").choices(["folder", "base", "skill", "drive", "file", "doc"]).makeOptionMandatory()
+    new Option(`--type <${CREATABLE_NODE_TYPES.join("|")}>`, "node type").choices(CREATABLE_NODE_TYPES).makeOptionMandatory()
   ).requiredOption("--slug <slug>", "node slug").requiredOption("--name <name>", "node name").option("--description <text>", "optional node description").option("--parent-node-id <id>", "parent folder node id; omit for root").option("--message <text>", "reviewer-facing Change Request message").option("--submitted-by <name>", "producer label").option("--field <slug:name:type...>", "base field, repeatable (for --type base)").option("--fields-json <json|@file>", "base fields as JSON array (for --type base)").option("--asset-id <id>", "backing Asset id (required for --type file)").addHelpText(
     "after",
     `
@@ -1212,6 +1215,95 @@ Examples:
       })
     )
   );
+  const airapps = program.command("airapps").description("AirApps (sandboxed mini-apps)");
+  addGlobalFlags(airapps.command("list")).description("List AirApps in the active space").action(runAction(state, (client) => client.airapps.list()));
+  addGlobalFlags(airapps.command("get")).description("Get one AirApp by node id").requiredOption("--node-id <id>", "AirApp node id").action(
+    runAction(state, (client, opts) => client.airapps.get({ nodeId: opts.nodeId }))
+  );
+  addGlobalFlags(airapps.command("create")).description("Create an AirApp \u2014 review-first by default: returns a pending Change Request").requiredOption("--slug <slug>", "AirApp slug").requiredOption("--name <name>", "AirApp name").option("--description <text>", "optional description").option("--parent-node-id <id>", "parent folder node id; omit for root").addOption(
+    new Option(
+      "--visibility <private|workspace|public>",
+      "AirApp visibility (default private)"
+    ).choices(["private", "workspace", "public"])
+  ).option("--version <semver>", "AirApp version (default 0.1.0)").option(
+    "--files-json <json|@file>",
+    'files as a JSON array, or @file.json \u2014 text files {"path","content","mimeType?"} or asset-backed files {"path","assetId","displayName?","mimeType?"}'
+  ).addOption(
+    new Option(
+      "--merge-mode <merge|replace>",
+      "how --files-json combines with the default scaffold (default merge)"
+    ).choices(["merge", "replace"])
+  ).option(
+    "--auto-merge",
+    "skip review and create the AirApp immediately (default: propose a pending Change Request)"
+  ).addHelpText(
+    "after",
+    `
+mergeMode explains how --files-json combines with the AirApp's default scaffold:
+  merge (default) \u2014 your files are layered on top of the default Hono-template
+                     scaffold by path; supply just a few files (e.g. one custom
+                     route) and still get the rest of the scaffold for any path
+                     you didn't provide yourself.
+  replace          \u2014 your files replace the scaffold entirely; use this when
+                     handing over a complete, self-contained project (e.g. a Vite
+                     app) so you don't end up with stray unrelated default files
+                     mixed in.
+
+Examples:
+  busabase-cli airapps create --slug hello-app --name "Hello App" --files-json @files.json
+  busabase-cli airapps create --slug vite-app --name "Vite App" --files-json @files.json --merge-mode replace
+  busabase-cli airapps create --slug hello-app --name "Hello App" --files-json @files.json --auto-merge   # skip review, create immediately`
+  ).action(
+    runAction(
+      state,
+      (client, opts) => client.airapps.create({
+        slug: opts.slug,
+        name: opts.name,
+        description: opts.description,
+        parentNodeId: opts.parentNodeId,
+        visibility: opts.visibility,
+        version: opts.version,
+        files: opts.filesJson ? parseJsonValue(opts.filesJson, "files-json") : void 0,
+        mergeMode: opts.mergeMode,
+        ...opts.autoMerge ? { autoMerge: true } : {}
+      })
+    )
+  );
+  addGlobalFlags(airapps.command("files")).description("List an AirApp's files").requiredOption("--node-id <id>", "AirApp node id").action(
+    runAction(
+      state,
+      (client, opts) => client.airapps.listFiles({ nodeId: opts.nodeId })
+    )
+  );
+  addGlobalFlags(airapps.command("read-file")).description("Read one AirApp file's content").requiredOption("--node-id <id>", "AirApp node id").requiredOption("--path <path>", "file path within the AirApp").action(
+    runAction(
+      state,
+      (client, opts) => client.airapps.readFile({ nodeId: opts.nodeId, filePath: opts.path })
+    )
+  );
+  addGlobalFlags(airapps.command("create-change-request")).description("Propose file changes to an existing AirApp via a Change Request").requiredOption("--node-id <id>", "AirApp node id").requiredOption(
+    "--operations-json <json|@file>",
+    'file operations as a JSON array, or @file.json \u2014 "create"/"update" (text {"kind","path","content","mimeType?"} or asset-backed {"kind","path","assetId","displayName?","mimeType?"}), "delete" {"kind","path"}, or "metadata_update" {"kind","metadata":{"entryFile?","visibility?","version?"}}'
+  ).option("--message <text>", "reviewer-facing Change Request message").option("--submitted-by <name>", "producer label").addHelpText(
+    "after",
+    `
+Examples:
+  busabase-cli airapps create-change-request --node-id nod_123 --operations-json @operations.json
+  busabase-cli airapps create-change-request --node-id nod_123 --operations-json '[{"kind":"update","path":"index.js","content":"..."}]' --message "Fix handler bug"`
+  ).action(
+    runAction(
+      state,
+      (client, opts) => client.airapps.createChangeRequest({
+        nodeId: opts.nodeId,
+        message: opts.message,
+        submittedBy: opts.submittedBy,
+        operations: parseJsonValue(
+          opts.operationsJson,
+          "operations-json"
+        )
+      })
+    )
+  );
   const records = program.command("records").description("Records");
   addGlobalFlags(records.command("list")).description("List records").option("--limit <n>", "max results (1-100)", parseLimit).option("--base-id <id>", "restrict to one Base").option("--cursor <cursor>", "opaque nextCursor from a previous page").action(
     runAction(state, (_client, opts, config) => {
@@ -1283,13 +1375,17 @@ Examples:
       (client, opts) => client.changeRequests.merge({ changeRequestId: opts.changeRequestId })
     )
   );
-  addGlobalFlags(program.command("search")).description("Full-text search").requiredOption("--query <q>", "search query").option("--limit <n>", "max results", parseNum).option("--offset <n>", "results offset", parseNum).action(
+  addGlobalFlags(program.command("search")).description("Full-text search").requiredOption("--query <q>", "search query").option("--limit <n>", "max results", parseNum).option("--offset <n>", "results offset", parseNum).option(
+    "--sources <sources...>",
+    'restrict which content to search: "records", "files", and/or "names" (default: all three)'
+  ).action(
     runAction(
       state,
       (client, opts) => client.search({
         query: opts.query,
         limit: opts.limit,
-        offset: opts.offset
+        offset: opts.offset,
+        sources: opts.sources
       })
     )
   );

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-N6NMNVQT.js";
+} from "./chunk-5ZYF74IE.js";
 
 // src/cli.ts
 process.exit(await runCli(process.argv.slice(2)));

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   HELP,
   render,
   runCli
-} from "./chunk-N6NMNVQT.js";
+} from "./chunk-5ZYF74IE.js";
 
 // src/index.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-cli",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "description": "Command-line client for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server`. Short-name alias for busabase-cli.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-cli",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "dependencies": {
-    "busabase-sdk": "0.9.5",
+    "busabase-sdk": "0.9.6",
     "commander": "^14.0.0"
   },
   "engines": {