busa-cli 0.9.4 → 0.9.6

package/dist/{chunk-5P2ZNCL5.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",
     `
@@ -1089,6 +1092,28 @@ Examples:
       });
     })
   );
+  addGlobalFlags(nodes.command("move")).description("Move or reorder a node (applied immediately, no review needed)").requiredOption("--node-id <id>", "node id to move").option("--parent-node-id <id>", "new parent folder node id; omit to keep the current parent").option(
+    "--position <n>",
+    "new position among the target parent's children",
+    (v) => Number.parseInt(v, 10)
+  ).option("--message <text>", "Change Request message").option("--submitted-by <name>", "producer label").addHelpText(
+    "after",
+    `
+Examples:
+  busabase-cli nodes move --node-id nod_123 --position 0
+  busabase-cli nodes move --node-id nod_123 --parent-node-id nod_456 --position 2`
+  ).action(
+    runAction(
+      state,
+      (client, opts) => client.nodes.move({
+        nodeId: opts.nodeId,
+        parentNodeId: opts.parentNodeId,
+        position: opts.position,
+        message: opts.message,
+        submittedBy: opts.submittedBy
+      })
+    )
+  );
   const bases = program.command("bases").description("Bases (structured tables)");
   addGlobalFlags(bases.command("list")).description("List Bases in the active space").action(runAction(state, (client) => client.bases.list()));
   addGlobalFlags(bases.command("get")).description("Get one Base by slug").requiredOption("--slug <slug>", "Base slug").action(
@@ -1190,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) => {
@@ -1261,16 +1375,51 @@ 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
       })
     )
   );
+  addGlobalFlags(program.command("grep")).description(
+    "Search files, Docs, and Base records with one pattern (unified grep; use `assets grep` for files-only)"
+  ).requiredOption("--pattern <regex>", "literal or regex pattern").option("--flags <flags>", 'RegExp flags, e.g. "i" for case-insensitive').option(
+    "--sources <sources...>",
+    'sources to scan: "files", "docs", and/or "records" (default: all three)'
+  ).option("--asset-ids <ids...>", "files scope: specific asset ids").option("--drive-path <path>", "files scope: Drive/Skill mounted path prefix").option("--mime-types <types...>", "files scope: MIME types").option("--node-ids <ids...>", "docs scope: specific Doc node ids").option("--base-ids <ids...>", "records scope: specific Base ids").option("--base-slugs <slugs...>", "records scope: specific Base slugs").option(
+    "--max-matches <n>",
+    "max matches, shared across sources (default 100, cap 1000)",
+    parsePositiveInt
+  ).option("--context-lines <n>", "lines of before/after context (default 0, cap 10)", parseNum).action(
+    runAction(state, (client, opts) => {
+      const filesScope = opts.assetIds || opts.drivePath || opts.mimeTypes ? {
+        assetIds: opts.assetIds,
+        drivePath: opts.drivePath,
+        mimeTypes: opts.mimeTypes
+      } : void 0;
+      const docsScope = opts.nodeIds ? { nodeIds: opts.nodeIds } : void 0;
+      const recordsScope = opts.baseIds || opts.baseSlugs ? {
+        baseIds: opts.baseIds,
+        baseSlugs: opts.baseSlugs
+      } : void 0;
+      return client.grep({
+        pattern: opts.pattern,
+        flags: opts.flags,
+        sources: opts.sources,
+        scope: filesScope || docsScope || recordsScope ? { files: filesScope, docs: docsScope, records: recordsScope } : void 0,
+        maxMatches: opts.maxMatches,
+        contextLines: opts.contextLines
+      });
+    })
+  );
   const addUploadCommand = (parent, hidden = false) => addGlobalFlags(parent.command("upload", { noHelp: hidden })).description("Upload a file and print an asset ref for record fields").requiredOption("--file <path>", "local file to upload").option("--file-name <name>", "stored file name (default: basename of --file)").option("--mime-type <mime>", "MIME type (default: inferred from extension)").option("--context <value>", "upload context (default record-field)").addHelpText(
     "after",
     `

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-5P2ZNCL5.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-5P2ZNCL5.js";
+} from "./chunk-5ZYF74IE.js";
 
 // src/index.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-cli",
-  "version": "0.9.4",
+  "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.4",
+    "busabase-sdk": "0.9.6",
     "commander": "^14.0.0"
   },
   "engines": {