@forjio/fulkruma-cli 0.4.0

package/dist/lib/util.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Per-command helpers: global option resolution, error formatting,
+ * JSON body parsing for commands that accept --body.
+ */
+import { Command } from 'commander';
+import { type GlobalOpts } from './client.js';
+import { type FormatOptions } from './output.js';
+export declare function getGlobalOpts(cmd: Command): GlobalOpts;
+export declare function formatOpts(g: GlobalOpts): FormatOptions;
+export declare function handleError(err: unknown, g: GlobalOpts): never;
+/**
+ * Parse `--body` value. Accepts either:
+ *   - inline JSON string (e.g., `'{"courierCode":"jne"}'`)
+ *   - `@path/to/file.json` to read from disk
+ *   - `-` to read from stdin (only when stdin is a pipe)
+ */
+export declare function parseBody(raw: string | undefined): Record<string, unknown> | undefined;
+export declare function parseIntArg(value: string): number;

package/dist/lib/util.js

@@ -0,0 +1,65 @@
+import { readFileSync } from 'node:fs';
+import { isFulkrumaError } from './client.js';
+import { printError } from './output.js';
+export function getGlobalOpts(cmd) {
+    let p = cmd;
+    while (p.parent)
+        p = p.parent;
+    return p.opts();
+}
+export function formatOpts(g) {
+    return {
+        json: Boolean(g.json),
+        noColor: process.env['NO_COLOR'] === '1',
+    };
+}
+export function handleError(err, g) {
+    // Re-throw test sentinels (vitest stubs `process.exit` to throw with
+    // a `__exit:<code>` message). Without this, the action's `try/catch`
+    // turns successful runs into spurious failures during testing.
+    if (err instanceof Error && err.message.startsWith('__exit:')) {
+        throw err;
+    }
+    if (isFulkrumaError(err)) {
+        printError({ code: err.code, message: err.message, requestId: err.requestId }, formatOpts(g));
+        process.exit(err.status === 401 || err.status === 403 ? 2 : 1);
+    }
+    const msg = err instanceof Error ? err.message : String(err);
+    printError({ code: 'error', message: msg }, formatOpts(g));
+    process.exit(1);
+}
+/**
+ * Parse `--body` value. Accepts either:
+ *   - inline JSON string (e.g., `'{"courierCode":"jne"}'`)
+ *   - `@path/to/file.json` to read from disk
+ *   - `-` to read from stdin (only when stdin is a pipe)
+ */
+export function parseBody(raw) {
+    if (!raw)
+        return undefined;
+    let text = raw;
+    if (raw.startsWith('@')) {
+        text = readFileSync(raw.slice(1), 'utf8');
+    }
+    else if (raw === '-') {
+        text = readFileSync(0, 'utf8');
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('--body must decode to a JSON object');
+        }
+        return parsed;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`failed to parse --body: ${msg}`);
+    }
+}
+export function parseIntArg(value) {
+    const n = Number.parseInt(value, 10);
+    if (Number.isNaN(n))
+        throw new Error(`invalid integer: ${value}`);
+    return n;
+}
+//# sourceMappingURL=util.js.map

package/dist/lib/util.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@forjio/fulkruma-cli",
+  "version": "0.4.0",
+  "description": "CLI for Fulkruma (part of the Forjio commerce suite).",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "fulkruma": "bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@forjio/fulkruma-node": "^0.5.0",
+    "@forjio/sdk": "^0.5.0",
+    "chalk": "^5.6.2",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}