@botiverse/hands-cli 0.4.0

package/README.md

@@ -0,0 +1,71 @@
+# @botiverse/hands-cli
+
+Hands CLI — manage apps, builds, releases from the terminal.
+
+Status: **alpha**. The npm package is public as `@botiverse/hands-cli`; v1 ships
+`login`, `logout`, `whoami`, `apps list/get`, `builds list/get`, and
+`builds publish-android`. Other commands listed in `docs/cli-reference.md` land
+incrementally as backend endpoints become available.
+
+## Install
+
+```bash
+npm install -g @botiverse/hands-cli
+hands --help
+
+# Or run without installing globally:
+npm exec --package @botiverse/hands-cli@0.3.2 -- hands --help
+
+# Local repo development:
+pnpm --filter @botiverse/hands-cli build
+pnpm --filter @botiverse/hands-cli start -- whoami
+```
+
+## Quickstart
+
+```bash
+# 1. Log in. The CLI prints a URL you must open in a browser.
+hands login
+
+# 2. Verify who you are.
+hands whoami
+
+# 3. List your apps.
+hands apps list
+
+# 4. List builds for an app (by slug or id).
+hands builds list myapp-android
+
+# 5. Publish an Android APK release.
+hands builds publish-android raft-android \
+  --channel main \
+  --apk ./app-release.apk \
+  --version-name 1.0.3 \
+  --version-code 1000300
+```
+
+## CI mode
+
+```bash
+export QUIVER_API=https://quiver.oranix.io
+export QUIVER_SESSION_COOKIE=...   # paste from browser DevTools
+hands whoami
+hands builds list myapp-android
+```
+
+## How auth works (v1)
+
+Raft OAuth today only supports the browser-redirect flow with HttpOnly
+cookies. The CLI can't intercept the redirect, so `hands login` asks
+you to:
+
+1. Open the printed URL in any browser.
+2. Sign in with Raft.
+3. Copy the `quiver_session` cookie value from DevTools.
+4. Paste it back into the CLI.
+
+The token is saved to `$XDG_CONFIG_HOME/quiver/auth.json` (mode 0600).
+For CI, pass it via `QUIVER_SESSION_COOKIE` instead.
+
+v2 will swap this for a true headless flow (Raft Device Flow or a
+`--token-stdin` service-user mode). See `publish-tasks.md` P3.4.x.

package/dist/commands/apps.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `quiver apps` — list / inspect apps in the caller's org.
+ *
+ * Wires GET /api/apps + GET /api/apps/:appId.
+ */
+import type { Command } from "commander";
+export declare function registerAppCommands(program: Command): void;

package/dist/commands/apps.js

@@ -0,0 +1,71 @@
+/**
+ * `quiver apps` — list / inspect apps in the caller's org.
+ *
+ * Wires GET /api/apps + GET /api/apps/:appId.
+ */
+import { apiRequest } from "../lib/api.js";
+export function registerAppCommands(program) {
+    const apps = program.command("apps").description("Manage apps in your org.");
+    apps
+        .command("list")
+        .alias("ls")
+        .description("List apps in the current org.")
+        .option("--include-archived", "Include archived (soft-deleted) apps.", false)
+        .option("--json", "Output JSON.", false)
+        .action(async (opts) => {
+        const res = await apiRequest("/api/apps", {
+            query: { include_archived: opts.includeArchived ? "1" : "0" },
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        if (res.apps.length === 0) {
+            console.log("No apps. Create one in the admin UI first.");
+            return;
+        }
+        console.log(["SLUG", "PLATFORM", "ARCHIVED", "DEFAULT_CHANNEL", "ID"].join("\t"));
+        for (const a of res.apps) {
+            console.log([
+                a.slug,
+                a.platform,
+                a.archived ? "yes" : "no",
+                a.default_channel_slug ?? "—",
+                a.id.slice(0, 8),
+            ].join("\t"));
+        }
+    });
+    apps
+        .command("get <appIdOrSlug>")
+        .description("Show details for a single app.")
+        .option("--json", "Output JSON.", false)
+        .action(async (appIdOrSlug, opts) => {
+        // The Worker endpoint accepts UUID; for slug we list + filter.
+        // Cheap heuristic: 36-char with dashes = UUID.
+        const isUuid = appIdOrSlug.length === 36 && appIdOrUuidDash(appIdOrSlug);
+        let id = appIdOrSlug;
+        if (!isUuid) {
+            const res = await apiRequest("/api/apps");
+            const match = res.apps.find((a) => a.slug === appIdOrSlug);
+            if (!match) {
+                console.error(`No app with slug '${appIdOrSlug}'.`);
+                process.exit(1);
+            }
+            id = match.id;
+        }
+        const app = await apiRequest(`/api/apps/${id}`);
+        if (opts.json) {
+            console.log(JSON.stringify(app, null, 2));
+            return;
+        }
+        console.log(`${app.name}  (${app.platform})`);
+        console.log(`  id: ${app.id}`);
+        console.log(`  slug: ${app.slug}`);
+        console.log(`  archived: ${app.archived ? "yes" : "no"}`);
+        console.log(`  default_channel: ${app.default_channel_slug ?? "(none)"}`);
+    });
+}
+function appIdOrUuidDash(s) {
+    return s.split("-").length === 5;
+}
+//# sourceMappingURL=apps.js.map

package/dist/commands/apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.js","sourceRoot":"","sources":["../../src/commands/apps.ts"],"names":[],"mappings":"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"}

package/dist/commands/builds.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `quiver builds` — list / inspect builds inside an app.
+ *
+ * Wires GET /api/apps/:appId/builds + GET /api/apps/:appId/builds/:buildId.
+ */
+import type { Command } from "commander";
+export declare function parseChangelogOptions(opts: {
+    changelog?: string | string[];
+    changelogFile?: string | string[];
+}): string | null;
+export declare function registerBuildCommands(program: Command): void;
+export declare function inferElectronPlatform(filePath: string | undefined): string;
+export declare function inferElectronFiletype(filePath: string): string;
+export declare function inferIosFiletype(filePath: string): string;