@vorlek/cli 0.1.0

package/dist/deps.js

@@ -0,0 +1,39 @@
+import * as clackPrompts from '@clack/prompts';
+import { createApiClient } from './client.js';
+import { deleteConfig as defaultDeleteConfig, loadConfig as defaultLoadConfig, saveConfig as defaultSaveConfig, } from './config.js';
+/** Default Deps bundle for production. */
+export function defaultDeps() {
+    return {
+        loadConfig: defaultLoadConfig,
+        saveConfig: defaultSaveConfig,
+        deleteConfig: defaultDeleteConfig,
+        createApiClient,
+        prompts: clackPrompts,
+        stdout: process.stdout,
+        stderr: process.stderr,
+        exit: process.exit,
+    };
+}
+/**
+ * Tests use this to construct a Deps bundle whose `exit` throws an
+ * `ExitError(code)` — pair with `expect(() => fn()).toThrow(ExitError)`
+ * + `.catch(e => e.code)` to assert the intended exit code without
+ * mocking process.exit (which can leak across tests).
+ */
+export class ExitError extends Error {
+    code;
+    constructor(code) {
+        super(`process.exit(${code})`);
+        this.name = 'ExitError';
+        this.code = code;
+    }
+}
+/**
+ * Helper: load config or instruct the user to run `vorlek auth signup` /
+ * `vorlek auth use`. Used by every command except `auth signup` itself.
+ * Returns null if no config; caller is responsible for printing + exiting.
+ */
+export async function tryLoadConfig(deps) {
+    return deps.loadConfig();
+}
+//# sourceMappingURL=deps.js.map

package/dist/idempotency.js

@@ -0,0 +1,22 @@
+import { randomBytes } from 'node:crypto';
+const CROCKFORD = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+const ULID_RE = /^[0-9A-HJKMNP-TV-Z]{26}$/;
+function encodeTime(nowMs) {
+    let value = Math.floor(nowMs);
+    const chars = Array.from({ length: 10 }, () => '0');
+    for (let i = chars.length - 1; i >= 0; i--) {
+        chars[i] = CROCKFORD[value % 32] ?? '0';
+        value = Math.floor(value / 32);
+    }
+    return chars.join('');
+}
+function encodeRandom() {
+    return Array.from(randomBytes(16), (byte) => CROCKFORD[byte & 31] ?? '0').join('');
+}
+export function newIdempotencyKey(nowMs = Date.now()) {
+    return `${encodeTime(nowMs)}${encodeRandom()}`;
+}
+export function isIdempotencyKey(value) {
+    return typeof value === 'string' && ULID_RE.test(value);
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/run-context.js

@@ -0,0 +1,79 @@
+import pc from 'picocolors';
+import { ApiError } from './client.js';
+/** Print a success result. JSON mode emits one machine-readable line. */
+export function renderSuccess(deps, ctx, data, human, meta) {
+    if (ctx.json) {
+        const out = { status: 'success', data };
+        if (meta?.request_id)
+            out.request_id = meta.request_id;
+        deps.stdout.write(`${JSON.stringify(out)}\n`);
+        return;
+    }
+    deps.stdout.write(`${human()}\n`);
+}
+/**
+ * Render an error and return the appropriate exit code per spec § 11. The
+ * caller passes the result to `deps.exit()` to actually terminate.
+ *
+ * - ApiError → exit 2 (server error). request_id rendered for support triage.
+ * - Error tagged with `.code === 'CONFIG_MISSING'` → exit 3.
+ * - Anything else → exit 1 (user error).
+ */
+export function renderError(deps, ctx, err) {
+    if (err instanceof ApiError) {
+        if (ctx.json) {
+            const out = {
+                status: 'error',
+                error: { code: err.code, message: err.envelope.error.message },
+                request_id: err.requestId,
+            };
+            if (err.envelope.error.fix)
+                out.fix = err.envelope.error.fix;
+            if (err.envelope.error.detail !== undefined)
+                out.detail = err.envelope.error.detail;
+            deps.stderr.write(`${JSON.stringify(out)}\n`);
+        }
+        else {
+            deps.stderr.write(`${pc.red('error')} ${pc.bold(err.code)} — ${err.envelope.error.message}\n`);
+            if (err.envelope.error.fix) {
+                deps.stderr.write(`  ${pc.dim('fix:')} ${err.envelope.error.fix.hint}\n`);
+            }
+            deps.stderr.write(`  ${pc.dim('request_id:')} ${err.requestId}\n`);
+        }
+        return 2;
+    }
+    // Local config / setup errors carry a tagged `code`.
+    const localCode = err.code;
+    if (localCode === 'CONFIG_MISSING') {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (ctx.json) {
+            deps.stderr.write(`${JSON.stringify({ status: 'error', error: { code: 'CONFIG_MISSING', message: msg } })}\n`);
+        }
+        else {
+            deps.stderr.write(`${pc.red('error')} ${pc.bold('CONFIG_MISSING')} — ${msg}\n`);
+            deps.stderr.write(`  ${pc.dim('hint:')} run ${pc.bold('vorlek auth signup')} or ${pc.bold('vorlek auth use --api-key vk_live_...')}\n`);
+        }
+        return 3;
+    }
+    // Default: user-facing error (bad flags, validation rejection).
+    const msg = err instanceof Error ? err.message : String(err);
+    if (ctx.json) {
+        deps.stderr.write(`${JSON.stringify({ status: 'error', error: { code: 'USER_ERROR', message: msg } })}\n`);
+    }
+    else {
+        deps.stderr.write(`${pc.red('error')} ${msg}\n`);
+    }
+    if (ctx.verbose && err instanceof Error && err.stack) {
+        deps.stderr.write(`${pc.dim(err.stack)}\n`);
+    }
+    return 1;
+}
+/** Tagged config-missing error. Throw from any command that requires config. */
+export class ConfigMissingError extends Error {
+    code = 'CONFIG_MISSING';
+    constructor(message = 'No config file found.') {
+        super(message);
+        this.name = 'ConfigMissingError';
+    }
+}
+//# sourceMappingURL=run-context.js.map

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@vorlek/cli",
+  "version": "0.1.0",
+  "description": "Vorlek CLI — thin REST API wrapper for the Vorlek aggregator",
+  "license": "UNLICENSED",
+  "homepage": "https://vorlek.dev/docs/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vorlek/vorlek-cli.git"
+  },
+  "type": "module",
+  "packageManager": "pnpm@9.15.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "vorlek": "dist/cli.js"
+  },
+  "files": ["dist/**/*.js"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "@vorlek/sdk": "^0.4.1",
+    "cac": "^6.7.14",
+    "ky": "^1.7.0",
+    "picocolors": "^1.1.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^24.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}