@centry-digital/bukku-cli 2.0.0

package/build/input/json.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Read JSON input from --data flag or stdin pipe.
+ *
+ * Precedence:
+ * 1. If opts.data is set, parse it as JSON
+ * 2. If stdin is piped (!process.stdin.isTTY), read and parse stdin
+ * 3. Otherwise, exit with validation error
+ */
+export declare function readJsonInput(opts: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=json.d.ts.map

package/build/input/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/input/json.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyCnF"}

package/build/input/json.js

@@ -0,0 +1,42 @@
+import { outputError, ExitCode } from '../output/error.js';
+/**
+ * Read JSON input from --data flag or stdin pipe.
+ *
+ * Precedence:
+ * 1. If opts.data is set, parse it as JSON
+ * 2. If stdin is piped (!process.stdin.isTTY), read and parse stdin
+ * 3. Otherwise, exit with validation error
+ */
+export async function readJsonInput(opts) {
+    if (opts.data != null) {
+        try {
+            return JSON.parse(opts.data);
+        }
+        catch (err) {
+            outputError({
+                error: 'Invalid JSON input: ' + (err instanceof SyntaxError ? err.message : String(err)),
+                code: 'VALIDATION_ERROR',
+            }, ExitCode.VALIDATION);
+        }
+    }
+    if (!process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        const raw = Buffer.concat(chunks).toString('utf-8');
+        try {
+            return JSON.parse(raw);
+        }
+        catch (err) {
+            outputError({
+                error: 'Invalid JSON input: ' + (err instanceof SyntaxError ? err.message : String(err)),
+                code: 'VALIDATION_ERROR',
+            }, ExitCode.VALIDATION);
+        }
+    }
+    outputError({
+        error: 'JSON input required. Use --data flag or pipe JSON to stdin',
+        code: 'VALIDATION_ERROR',
+    }, ExitCode.VALIDATION);
+}

package/build/output/dry-run.d.ts

@@ -0,0 +1,21 @@
+export interface DryRunOutput {
+    dry_run: true;
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: unknown;
+}
+/**
+ * Output a dry-run request preview without executing the API call.
+ *
+ * Prints method, full URL, masked auth header, and optional body as JSON to stdout.
+ * Token is masked to first 3 characters + **** for safety.
+ */
+export declare function outputDryRun(opts: {
+    method: string;
+    path: string;
+    token: string;
+    subdomain: string;
+    body?: unknown;
+}): void;
+//# sourceMappingURL=dry-run.d.ts.map

package/build/output/dry-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/output/dry-run.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,IAAI,CAgBP"}

package/build/output/dry-run.js

@@ -0,0 +1,23 @@
+import { outputJson } from './json.js';
+/**
+ * Output a dry-run request preview without executing the API call.
+ *
+ * Prints method, full URL, masked auth header, and optional body as JSON to stdout.
+ * Token is masked to first 3 characters + **** for safety.
+ */
+export function outputDryRun(opts) {
+    const maskedToken = opts.token.length > 6 ? opts.token.slice(0, 3) + '****' : '****';
+    const output = {
+        dry_run: true,
+        method: opts.method,
+        url: `https://api.bukku.my${opts.path}`,
+        headers: {
+            Authorization: `Bearer ${maskedToken}`,
+            'Company-Subdomain': opts.subdomain,
+        },
+    };
+    if (opts.body !== undefined) {
+        output.body = opts.body;
+    }
+    outputJson(output);
+}

package/build/output/error.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Exit codes for CLI.
+ */
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL: 1;
+    readonly AUTH: 2;
+    readonly API: 3;
+    readonly VALIDATION: 4;
+};
+/**
+ * Structured CLI error shape written to stderr.
+ */
+export interface CliError {
+    error: string;
+    code: string;
+    details?: unknown;
+}
+/**
+ * Map error code strings to numeric exit codes.
+ */
+export declare function mapExitCode(errorCode: string): number;
+/**
+ * Write structured error JSON to stderr and exit with code.
+ */
+export declare function outputError(err: CliError, exitCode: number): never;
+//# sourceMappingURL=error.d.ts.map

package/build/output/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/output/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAGlE"}

package/build/output/error.js

@@ -0,0 +1,33 @@
+/**
+ * Exit codes for CLI.
+ */
+export const ExitCode = {
+    SUCCESS: 0,
+    GENERAL: 1,
+    AUTH: 2,
+    API: 3,
+    VALIDATION: 4,
+};
+/**
+ * Map error code strings to numeric exit codes.
+ */
+export function mapExitCode(errorCode) {
+    switch (errorCode) {
+        case 'AUTH_MISSING':
+            return ExitCode.AUTH;
+        case 'API_ERROR':
+        case 'API_HTTP_ERROR':
+            return ExitCode.API;
+        case 'VALIDATION_ERROR':
+            return ExitCode.VALIDATION;
+        default:
+            return ExitCode.GENERAL;
+    }
+}
+/**
+ * Write structured error JSON to stderr and exit with code.
+ */
+export function outputError(err, exitCode) {
+    process.stderr.write(JSON.stringify(err) + '\n');
+    process.exit(exitCode);
+}

package/build/output/json.d.ts

@@ -0,0 +1,6 @@
+/**
+ * JSON output formatter.
+ * Writes valid JSON to stdout for machine consumption.
+ */
+export declare function outputJson(data: unknown): void;
+//# sourceMappingURL=json.d.ts.map

package/build/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE9C"}

package/build/output/json.js

@@ -0,0 +1,7 @@
+/**
+ * JSON output formatter.
+ * Writes valid JSON to stdout for machine consumption.
+ */
+export function outputJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}

package/build/output/table.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Table output formatter with per-resource column definitions.
+ * Zero external dependencies — renders plain-text aligned tables to stdout.
+ */
+/**
+ * Output data as a formatted table to stdout.
+ *
+ * @param data - Array of resource objects
+ * @param columns - Optional string array where first element is the entity name
+ *                   (kept as string[] for backwards compatibility with factory calls)
+ */
+export declare function outputTable(data: unknown, columns?: string[]): void;
+//# sourceMappingURL=table.d.ts.map

package/build/output/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2HH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAanE"}

package/build/output/table.js

@@ -0,0 +1,123 @@
+/**
+ * Table output formatter with per-resource column definitions.
+ * Zero external dependencies — renders plain-text aligned tables to stdout.
+ */
+function col(key, header, width, align = 'left') {
+    return { key, header, width, align };
+}
+function id(width = 6) {
+    return col('id', 'ID', width, 'right');
+}
+const paymentColumns = [
+    id(6),
+    col('date', 'Date', 12),
+    col('number', 'Number', 15),
+    col('contact_name', 'Contact', 25),
+    col('total', 'Amount', 12, 'right'),
+];
+function transactionColumns() {
+    return [
+        id(6),
+        col('date', 'Date', 12),
+        col('number', 'Number', 15),
+        col('contact_name', 'Contact', 25),
+        col('total', 'Total', 12, 'right'),
+        col('status', 'Status', 12),
+    ];
+}
+const DEFAULT_COLUMNS = [
+    id(8),
+    col('name', 'Name', 30),
+    col('description', 'Description', 40),
+];
+const TABLE_COLUMNS = {
+    // Sales / Purchase transaction types
+    'sales-invoice': transactionColumns(),
+    'sales-quote': transactionColumns(),
+    'sales-order': transactionColumns(),
+    'sales-credit-note': transactionColumns(),
+    'sales-payment': paymentColumns,
+    'sales-refund': paymentColumns,
+    'delivery-order': [id(6), col('date', 'Date', 12), col('number', 'Number', 15), col('contact_name', 'Contact', 25), col('status', 'Status', 12)],
+    'purchase-bill': transactionColumns(),
+    'purchase-order': transactionColumns(),
+    'purchase-credit-note': transactionColumns(),
+    'purchase-payment': paymentColumns,
+    'purchase-refund': paymentColumns,
+    'goods-received-note': [id(6), col('date', 'Date', 12), col('number', 'Number', 15), col('contact_name', 'Contact', 25), col('status', 'Status', 12)],
+    // Banking
+    'bank-money-in': transactionColumns(),
+    'bank-money-out': transactionColumns(),
+    'bank-transfer': [id(6), col('date', 'Date', 12), col('number', 'Number', 15), col('total', 'Amount', 12, 'right'), col('status', 'Status', 12)],
+    // Contacts
+    'contact': [id(6), col('name', 'Name', 30), col('email', 'Email', 25), col('type', 'Type', 10), col('phone', 'Phone', 15)],
+    'contact-group': [id(6), col('name', 'Name', 30), col('contacts_count', 'Contacts', 10, 'right')],
+    // Products
+    'product': [id(6), col('name', 'Name', 30), col('code', 'Code', 12), col('type', 'Type', 10), col('sale_price', 'Price', 12, 'right')],
+    'product-bundle': [id(6), col('name', 'Name', 30), col('code', 'Code', 12), col('sale_price', 'Price', 12, 'right')],
+    'product-group': [id(6), col('name', 'Name', 30)],
+    // Accounting
+    'journal-entry': [id(6), col('date', 'Date', 12), col('number', 'Number', 15), col('description', 'Description', 30), col('status', 'Status', 12)],
+    'account': [id(6), col('code', 'Code', 8), col('name', 'Name', 30), col('category', 'Category', 12), col('balance', 'Balance', 12, 'right')],
+    // Files
+    'file': [id(6), col('name', 'Name', 35), col('content_type', 'Type', 20), col('size', 'Size', 10, 'right')],
+    // Control Panel
+    'location': [id(6), col('name', 'Name', 30), col('is_archived', 'Archived', 10)],
+    'tag': [id(6), col('name', 'Name', 30), col('tag_group_id', 'Group ID', 10, 'right')],
+    'tag-group': [id(6), col('name', 'Name', 30)],
+};
+/**
+ * Convert a value to a display string.
+ */
+function toStr(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'boolean')
+        return value ? 'yes' : 'no';
+    return String(value);
+}
+/**
+ * Pad/truncate a string to exactly `width` characters.
+ */
+function fit(text, width, align) {
+    if (text.length > width) {
+        return width > 3 ? text.slice(0, width - 3) + '...' : text.slice(0, width);
+    }
+    return align === 'right' ? text.padStart(width) : text.padEnd(width);
+}
+/**
+ * Format rows into a plain-text table string.
+ */
+function formatTable(rows, columns) {
+    const gap = '  ';
+    const lines = [];
+    // Header row
+    lines.push(columns.map((c) => fit(c.header, c.width, c.align)).join(gap));
+    // Separator row
+    lines.push(columns.map((c) => '-'.repeat(c.width)).join(gap));
+    // Data rows
+    for (const row of rows) {
+        lines.push(columns
+            .map((c) => fit(toStr(row[c.key]), c.width, c.align))
+            .join(gap));
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Output data as a formatted table to stdout.
+ *
+ * @param data - Array of resource objects
+ * @param columns - Optional string array where first element is the entity name
+ *                   (kept as string[] for backwards compatibility with factory calls)
+ */
+export function outputTable(data, columns) {
+    const items = Array.isArray(data) ? data : [data];
+    if (items.length === 0) {
+        process.stdout.write('(no results)\n');
+        return;
+    }
+    const entityName = columns?.[0];
+    const colDefs = (entityName && TABLE_COLUMNS[entityName]) || DEFAULT_COLUMNS;
+    const rows = items;
+    process.stdout.write(formatTable(rows, colDefs));
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@centry-digital/bukku-cli",
+  "version": "2.0.0",
+  "description": "Bukku accounting CLI - manage invoices, contacts, and accounting from the command line",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "bukku": "build/index.js"
+  },
+  "files": ["build/", "LICENSE", "README.md"],
+  "scripts": {
+    "build": "tsc --build",
+    "test": "node --test --import tsx/esm 'src/**/*.test.ts'"
+  },
+  "keywords": [
+    "bukku", "accounting", "cli", "invoicing", "bookkeeping", "malaysia"
+  ],
+  "homepage": "https://github.com/centry-digital/bukku",
+  "bugs": {
+    "url": "https://github.com/centry-digital/bukku/issues"
+  },
+  "author": "Centry Digital",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/centry-digital/bukku.git"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^14.0.3"
+  }
+}