@axtrabase/cli 0.1.0

package/dist/prompt-masked.js

@@ -0,0 +1,75 @@
+import { createInterface } from "node:readline";
+const ENTER_CHARS = new Set(["\n", "\r"]);
+const BACKSPACE_CHARS = new Set([String.fromCharCode(127), "\b"]);
+const CTRL_C = String.fromCharCode(3);
+const CTRL_D = String.fromCharCode(4);
+/**
+ * Prompts for a secret on stdin, echoing `*` instead of the typed/pasted
+ * characters — used by `axtrabase login` for the pasted CLI token (build
+ * brief §5 treats the token as sensitive from the moment it's entered).
+ * Falls back to an unmasked `readline` prompt when stdin isn't a TTY (piped
+ * input, most test environments) since there's no terminal to mask against
+ * and raw mode isn't available there anyway.
+ *
+ * Control characters (Enter, Backspace, Ctrl-C, Ctrl-D) are matched via
+ * `String.fromCharCode` rather than escape-sequence literals in this file's
+ * source text — keeps the file plain, diffable ASCII instead of risking
+ * literal control bytes ending up embedded in the source.
+ */
+export function promptMasked(promptText) {
+    if (!process.stdin.isTTY)
+        return promptUnmasked(promptText);
+    return new Promise((resolve, reject) => {
+        const stdin = process.stdin;
+        const stdout = process.stdout;
+        let value = "";
+        stdout.write(promptText);
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding("utf8");
+        const cleanup = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.removeListener("data", onData);
+        };
+        // A single 'data' event can carry more than one character — a paste
+        // arrives as one chunk, not one event per character — so each chunk is
+        // walked character by character rather than treated as a single key.
+        const onData = (chunk) => {
+            for (const char of chunk) {
+                if (ENTER_CHARS.has(char)) {
+                    cleanup();
+                    stdout.write("\n");
+                    resolve(value.trim());
+                    return;
+                }
+                if (char === CTRL_C || char === CTRL_D) {
+                    cleanup();
+                    stdout.write("\n");
+                    reject(new Error("Prompt cancelled."));
+                    return;
+                }
+                if (BACKSPACE_CHARS.has(char)) {
+                    if (value.length > 0) {
+                        value = value.slice(0, -1);
+                        stdout.write("\b \b");
+                    }
+                    continue;
+                }
+                value += char;
+                stdout.write("*");
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+function promptUnmasked(promptText) {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+        rl.question(promptText, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+//# sourceMappingURL=prompt-masked.js.map

package/dist/prompt-masked.js.map

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

package/dist/report-error.d.ts

@@ -0,0 +1,18 @@
+import { EXIT_CODES } from "./exit-codes.js";
+export interface ErrorReportOptions {
+    json?: boolean;
+    /** Prints the error's cause/stack to stderr — still never a raw secret (build brief §24: "redact secrets/tokens"). */
+    debug?: boolean;
+}
+/**
+ * The one place a caught error becomes CLI output + an exit code (build
+ * brief §24). Every command's action calls this from its top-level catch —
+ * no stack trace by default, no ANSI in --json, and the mapping from error
+ * code to exit code is centralized in exit-codes.ts so it can't drift
+ * per-command.
+ */
+export declare function reportError(error: unknown, options?: ErrorReportOptions): never;
+/** Wraps a command action so every command doesn't hand-roll the same try/catch; the action itself decides what --json/--debug values to pass through, since only it knows how to read the merged command options. */
+export declare function runWithErrorHandling(action: () => Promise<void>, options: ErrorReportOptions): Promise<void>;
+export { EXIT_CODES };
+//# sourceMappingURL=report-error.d.ts.map

package/dist/report-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-error.d.ts","sourceRoot":"","sources":["../src/report-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AAGnE,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sHAAsH;IACtH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,KAAK,CA8BnF;AAeD,sNAAsN;AACtN,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/report-error.js

@@ -0,0 +1,63 @@
+import { CliError } from "./http/errors.js";
+import { EXIT_CODES, exitCodeForErrorCode } from "./exit-codes.js";
+import { printJson, printLine } from "./output/print.js";
+/**
+ * The one place a caught error becomes CLI output + an exit code (build
+ * brief §24). Every command's action calls this from its top-level catch —
+ * no stack trace by default, no ANSI in --json, and the mapping from error
+ * code to exit code is centralized in exit-codes.ts so it can't drift
+ * per-command.
+ */
+export function reportError(error, options = {}) {
+    const cliError = toCliError(error);
+    if (options.json) {
+        printJson({
+            error: {
+                code: cliError.code,
+                message: cliError.message,
+                ...(cliError.requestId ? { requestId: cliError.requestId } : {})
+            }
+        });
+    }
+    else {
+        printLine();
+        printLine(`Error:`);
+        printLine(cliError.message);
+        printLine();
+        printLine(`Code:`);
+        printLine(cliError.code);
+        if (cliError.requestId) {
+            printLine();
+            printLine(`Request ID:`);
+            printLine(cliError.requestId);
+        }
+    }
+    if (options.debug && cliError.cause) {
+        process.stderr.write(`${describeCause(cliError.cause)}\n`);
+    }
+    process.exit(exitCodeForErrorCode(cliError.code));
+}
+function toCliError(error) {
+    if (error instanceof CliError)
+        return error;
+    if (error instanceof Error) {
+        return new CliError("AXTRA_CLI_UNEXPECTED_ERROR", error.message, { status: 0, cause: error });
+    }
+    return new CliError("AXTRA_CLI_UNEXPECTED_ERROR", "An unexpected error occurred.", { status: 0 });
+}
+function describeCause(cause) {
+    if (cause instanceof Error)
+        return cause.stack ?? cause.message;
+    return String(cause);
+}
+/** Wraps a command action so every command doesn't hand-roll the same try/catch; the action itself decides what --json/--debug values to pass through, since only it knows how to read the merged command options. */
+export async function runWithErrorHandling(action, options) {
+    try {
+        await action();
+    }
+    catch (error) {
+        reportError(error, options);
+    }
+}
+export { EXIT_CODES };
+//# sourceMappingURL=report-error.js.map

package/dist/report-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-error.js","sourceRoot":"","sources":["../src/report-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAQzD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,UAA8B,EAAE;IAC1E,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,SAAS,CAAC;YACR,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE;SACF,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,SAAS,EAAE,CAAC;QACZ,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5B,SAAS,EAAE,CAAC;QACZ,SAAS,CAAC,OAAO,CAAC,CAAC;QACnB,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,SAAS,EAAE,CAAC;YACZ,SAAS,CAAC,aAAa,CAAC,CAAC;YACzB,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,QAAQ,CAAC,4BAA4B,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,4BAA4B,EAAE,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;IAChE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,sNAAsN;AACtN,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA2B,EAC3B,OAA2B;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,EAAE,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/resolve-entity.d.ts

@@ -0,0 +1,13 @@
+export declare function looksLikeUuid(value: string): boolean;
+/**
+ * Resolves an `<id-or-slug>` argument (build brief §8/§9: "axtrabase
+ * projects use hr-portal" as well as a raw id) against a list already
+ * fetched from the control plane — there is no server-side "get by slug"
+ * endpoint, so this is a client-side lookup over data the caller already
+ * has, not an invented capability.
+ */
+export declare function resolveByIdOrSlug<T extends {
+    id: string;
+    slug: string;
+}>(idOrSlug: string, candidates: T[]): T | undefined;
+//# sourceMappingURL=resolve-entity.d.ts.map

package/dist/resolve-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-entity.d.ts","sourceRoot":"","sources":["../src/resolve-entity.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACtE,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,EAAE,GACd,CAAC,GAAG,SAAS,CAKf"}

package/dist/resolve-entity.js

@@ -0,0 +1,18 @@
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function looksLikeUuid(value) {
+    return UUID_PATTERN.test(value);
+}
+/**
+ * Resolves an `<id-or-slug>` argument (build brief §8/§9: "axtrabase
+ * projects use hr-portal" as well as a raw id) against a list already
+ * fetched from the control plane — there is no server-side "get by slug"
+ * endpoint, so this is a client-side lookup over data the caller already
+ * has, not an invented capability.
+ */
+export function resolveByIdOrSlug(idOrSlug, candidates) {
+    if (looksLikeUuid(idOrSlug)) {
+        return candidates.find((candidate) => candidate.id === idOrSlug);
+    }
+    return candidates.find((candidate) => candidate.slug === idOrSlug);
+}
+//# sourceMappingURL=resolve-entity.js.map

package/dist/resolve-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-entity.js","sourceRoot":"","sources":["../src/resolve-entity.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,iEAAiE,CAAC;AAEvF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,UAAe;IAEf,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACrE,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+/** Bump alongside package.json's version — read at runtime for --version and the X-AxtraBase-Client User-Agent, same convention as @axtrabase/sdk's SDK_VERSION. */
+export declare const CLI_VERSION = "0.1.0";
+export declare const CLI_CLIENT_NAME = "axtrabase-cli";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,oKAAoK;AACpK,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,eAAe,kBAAkB,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+/** Bump alongside package.json's version — read at runtime for --version and the X-AxtraBase-Client User-Agent, same convention as @axtrabase/sdk's SDK_VERSION. */
+export const CLI_VERSION = "0.1.0";
+export const CLI_CLIENT_NAME = "axtrabase-cli";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,oKAAoK;AACpK,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@axtrabase/cli",
+  "version": "0.1.0",
+  "description": "The AxtraBase CLI — inspect an AxtraBase project's schema, permissions, and environment, and build against it without touching Dataverse directly.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/erdhem/axtrabase.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/erdhem/axtrabase/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/erdhem/axtrabase/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "axtrabase": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "smoke-test": "bash scripts/pack-install-smoke-test.sh"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.3",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  }
+}