@marcfargas/odoo-cli 0.1.0

package/dist/middleware/safety.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Safety enforcement middleware for odoo-cli.
+ *
+ * Every command has a safety level: READ | WRITE | DESTRUCTIVE.
+ *
+ * - READ:         No requirements. Safe to run anywhere.
+ * - WRITE:        Requires --confirm. Clear error if missing.
+ * - DESTRUCTIVE:  Requires --confirm. Prints a DESTRUCTIVE warning.
+ *
+ * The CLI enforces safety at the command level, independently of the
+ * odoo-client safety guard (which uses a confirm callback). Here we
+ * use a simpler model: just check if the --confirm flag is present.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireConfirm = requireConfirm;
+exports.printDryRun = printDryRun;
+const debug_1 = __importDefault(require("debug"));
+const errors_1 = require("../output/errors");
+const log = (0, debug_1.default)('odoo-cli:safety');
+/**
+ * Assert that a WRITE or DESTRUCTIVE operation has --confirm.
+ *
+ * Throws CliUsageError (exit 1) if --confirm is missing.
+ * In --dry-run mode, skips the check (we're not actually mutating).
+ */
+function requireConfirm(level, options, commandDescription) {
+    log('Safety check: level=%s confirm=%s dryRun=%s', level, options.confirm, options.dryRun);
+    if (level === 'READ')
+        return;
+    // --dry-run bypasses confirm: safe because no RPC is executed.
+    // This allows previewing any operation without --confirm.
+    if (options.dryRun) {
+        log('Skipping safety check: --dry-run mode');
+        return;
+    }
+    if (!options.confirm) {
+        const levelStr = level === 'DESTRUCTIVE' ? 'DESTRUCTIVE ⚠' : 'WRITE';
+        throw new errors_1.CliUsageError(`${commandDescription} is a ${levelStr} operation and requires --confirm`, [
+            'Add --confirm to execute the operation',
+            'Add --dry-run to preview the RPC call without executing',
+            `This command modifies Odoo data. Safety level: ${level}`,
+        ]);
+    }
+    if (level === 'DESTRUCTIVE') {
+        process.stderr.write(`⚠  DESTRUCTIVE operation: ${commandDescription}\n`);
+    }
+}
+/**
+ * Format a dry-run message to stderr showing what WOULD be called.
+ */
+function printDryRun(model, method, args, kwargs = {}) {
+    process.stderr.write(`DRY RUN: Would call execute_kw\n`);
+    process.stderr.write(`  model:  ${model}\n`);
+    process.stderr.write(`  method: ${method}\n`);
+    process.stderr.write(`  args:   ${JSON.stringify(args)}\n`);
+    if (Object.keys(kwargs).length > 0) {
+        process.stderr.write(`  kwargs: ${JSON.stringify(kwargs)}\n`);
+    }
+}
+//# sourceMappingURL=safety.js.map

package/dist/middleware/safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/middleware/safety.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;AAoBH,wCA8BC;AAKD,kCAaC;AAlED,kDAA0B;AAC1B,6CAAiD;AAEjD,MAAM,GAAG,GAAG,IAAA,eAAK,EAAC,iBAAiB,CAAC,CAAC;AASrC;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,KAAkB,EAClB,OAAsB,EACtB,kBAA0B;IAE1B,GAAG,CAAC,6CAA6C,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3F,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO;IAC7B,+DAA+D;IAC/D,0DAA0D;IAC1D,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,GAAG,CAAC,uCAAuC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC;QACrE,MAAM,IAAI,sBAAa,CACrB,GAAG,kBAAkB,SAAS,QAAQ,mCAAmC,EACzE;YACE,wCAAwC;YACxC,yDAAyD;YACzD,kDAAkD,KAAK,EAAE;SAC1D,CACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,kBAAkB,IAAI,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CACzB,KAAa,EACb,MAAc,EACd,IAAW,EACX,SAA8B,EAAE;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/output/errors.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Error formatting and exit-code mapping for odoo-cli.
+ *
+ * ALL error output goes to stderr. stdout is reserved for data.
+ *
+ * Exit codes:
+ *   0  = success
+ *   1  = usage error (bad flags, missing args, --confirm missing)
+ *   2  = auth / network error
+ *   3  = not found (record, model, module)
+ *   4  = permission denied
+ *   5  = validation error (Odoo rejected write)
+ *   6  = conflict (already clocked in, timer running)
+ *   10 = partial success (batch, some failed)
+ */
+/** Suppress stderr progress/warnings. Called from cli.ts preAction hook. */
+export declare function setQuiet(v: boolean): void;
+/** Disable ANSI color in stderr output. Called from cli.ts preAction hook. */
+export declare function setNoColor(v: boolean): void;
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly USAGE_ERROR: 1;
+    readonly AUTH_NETWORK_ERROR: 2;
+    readonly NOT_FOUND: 3;
+    readonly PERMISSION_DENIED: 4;
+    readonly VALIDATION_ERROR: 5;
+    readonly CONFLICT: 6;
+    readonly PARTIAL_SUCCESS: 10;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
+/**
+ * Format and print an error to stderr, return the appropriate exit code.
+ */
+export declare function handleError(err: unknown): ExitCode;
+/**
+ * Print a formatted error to stderr.
+ */
+export declare function printError(message: string, detail?: string, hints?: string[]): void;
+/**
+ * Print a success message to stderr (decorative, not data).
+ */
+export declare function printSuccess(message: string): void;
+/**
+ * Print an info/progress message to stderr.
+ * Suppressed in --quiet mode.
+ */
+export declare function printInfo(message: string): void;
+/**
+ * Print a warning to stderr.
+ * Suppressed in --quiet mode.
+ */
+export declare function printWarning(message: string): void;
+export declare class CliUsageError extends Error {
+    readonly hints: string[];
+    constructor(message: string, hints?: string[]);
+}
+export declare class CliNotFoundError extends Error {
+    readonly hints: string[];
+    constructor(message: string, hints?: string[]);
+}
+export declare class CliConflictError extends Error {
+    readonly hints: string[];
+    constructor(message: string, hints?: string[]);
+}
+export declare class CliAuthError extends Error {
+    readonly hints: string[];
+    constructor(message: string, hints?: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/output/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/output/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAEzC;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3C;AAED,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAoElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAanF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG/C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMlD;AAID,qBAAa,aAAc,SAAQ,KAAK;aAGpB,KAAK,EAAE,MAAM,EAAE;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,GAAE,MAAM,EAAO;CAKvC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,KAAK,EAAE,MAAM,EAAE;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,GAAE,MAAM,EAAO;CAKvC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,KAAK,EAAE,MAAM,EAAE;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,GAAE,MAAM,EAAO;CAKvC;AAED,qBAAa,YAAa,SAAQ,KAAK;aAGnB,KAAK,EAAE,MAAM,EAAE;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,GAAE,MAAM,EAAO;CAKvC"}

package/dist/output/errors.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Error formatting and exit-code mapping for odoo-cli.
+ *
+ * ALL error output goes to stderr. stdout is reserved for data.
+ *
+ * Exit codes:
+ *   0  = success
+ *   1  = usage error (bad flags, missing args, --confirm missing)
+ *   2  = auth / network error
+ *   3  = not found (record, model, module)
+ *   4  = permission denied
+ *   5  = validation error (Odoo rejected write)
+ *   6  = conflict (already clocked in, timer running)
+ *   10 = partial success (batch, some failed)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliAuthError = exports.CliConflictError = exports.CliNotFoundError = exports.CliUsageError = exports.EXIT_CODES = void 0;
+exports.setQuiet = setQuiet;
+exports.setNoColor = setNoColor;
+exports.handleError = handleError;
+exports.printError = printError;
+exports.printSuccess = printSuccess;
+exports.printInfo = printInfo;
+exports.printWarning = printWarning;
+const odoo_client_1 = require("@marcfargas/odoo-client");
+// ── Global quiet / no-color flags ────────────────────────────────────
+let _quiet = false;
+let _noColor = false;
+/** Suppress stderr progress/warnings. Called from cli.ts preAction hook. */
+function setQuiet(v) {
+    _quiet = v;
+}
+/** Disable ANSI color in stderr output. Called from cli.ts preAction hook. */
+function setNoColor(v) {
+    _noColor = v;
+}
+exports.EXIT_CODES = {
+    SUCCESS: 0,
+    USAGE_ERROR: 1,
+    AUTH_NETWORK_ERROR: 2,
+    NOT_FOUND: 3,
+    PERMISSION_DENIED: 4,
+    VALIDATION_ERROR: 5,
+    CONFLICT: 6,
+    PARTIAL_SUCCESS: 10,
+};
+/**
+ * Format and print an error to stderr, return the appropriate exit code.
+ */
+function handleError(err) {
+    if (err instanceof odoo_client_1.OdooAuthError) {
+        printError('Cannot authenticate to Odoo', err.message, [
+            'Check ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD',
+        ]);
+        return exports.EXIT_CODES.AUTH_NETWORK_ERROR;
+    }
+    if (err instanceof odoo_client_1.OdooTimeoutError || err instanceof odoo_client_1.OdooNetworkError) {
+        printError('Connection failed', err.message, ['Check that ODOO_URL is reachable']);
+        return exports.EXIT_CODES.AUTH_NETWORK_ERROR;
+    }
+    if (err instanceof odoo_client_1.OdooAccessError) {
+        printError('Permission denied', err.message, ['You may lack the required access rights']);
+        return exports.EXIT_CODES.PERMISSION_DENIED;
+    }
+    if (err instanceof odoo_client_1.OdooMissingError) {
+        printError('Record not found', err.message);
+        return exports.EXIT_CODES.NOT_FOUND;
+    }
+    if (err instanceof odoo_client_1.OdooValidationError) {
+        printError('Validation error', err.message, ['Odoo rejected the request']);
+        return exports.EXIT_CODES.VALIDATION_ERROR;
+    }
+    if (err instanceof CliUsageError) {
+        printError(err.message, undefined, err.hints);
+        return exports.EXIT_CODES.USAGE_ERROR;
+    }
+    if (err instanceof CliNotFoundError) {
+        printError(err.message, undefined, err.hints);
+        return exports.EXIT_CODES.NOT_FOUND;
+    }
+    if (err instanceof CliConflictError) {
+        printError(err.message, undefined, err.hints);
+        return exports.EXIT_CODES.CONFLICT;
+    }
+    if (err instanceof CliAuthError) {
+        printError(err.message, undefined, err.hints);
+        return exports.EXIT_CODES.AUTH_NETWORK_ERROR;
+    }
+    if (err instanceof Error) {
+        // Check message patterns for categorization
+        const msg = err.message.toLowerCase();
+        if (msg.includes('not found') || msg.includes("doesn't exist")) {
+            printError('Not found', err.message);
+            return exports.EXIT_CODES.NOT_FOUND;
+        }
+        if (msg.includes('missing environment variable') || msg.includes('missing env')) {
+            printError('Configuration error', err.message, [
+                'Set ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD',
+                'Or use --url, --db, --user, --password flags',
+            ]);
+            return exports.EXIT_CODES.AUTH_NETWORK_ERROR;
+        }
+        printError('Unexpected error', err.message);
+        return exports.EXIT_CODES.USAGE_ERROR;
+    }
+    printError('Unknown error', String(err));
+    return exports.EXIT_CODES.USAGE_ERROR;
+}
+/**
+ * Print a formatted error to stderr.
+ */
+function printError(message, detail, hints) {
+    const noColor = _noColor || process.env.NO_COLOR !== undefined || !process.stderr.isTTY;
+    const red = noColor ? '' : '\x1b[31m';
+    const dim = noColor ? '' : '\x1b[2m';
+    const reset = noColor ? '' : '\x1b[0m';
+    process.stderr.write(`${red}✗ Error:${reset} ${message}\n`);
+    if (detail) {
+        process.stderr.write(`  ${dim}Details:${reset} ${detail}\n`);
+    }
+    for (const hint of hints ?? []) {
+        process.stderr.write(`  → ${hint}\n`);
+    }
+}
+/**
+ * Print a success message to stderr (decorative, not data).
+ */
+function printSuccess(message) {
+    const noColor = _noColor || process.env.NO_COLOR !== undefined || !process.stderr.isTTY;
+    const green = noColor ? '' : '\x1b[32m';
+    const reset = noColor ? '' : '\x1b[0m';
+    process.stderr.write(`${green}✓${reset} ${message}\n`);
+}
+/**
+ * Print an info/progress message to stderr.
+ * Suppressed in --quiet mode.
+ */
+function printInfo(message) {
+    if (_quiet)
+        return;
+    process.stderr.write(`  ${message}\n`);
+}
+/**
+ * Print a warning to stderr.
+ * Suppressed in --quiet mode.
+ */
+function printWarning(message) {
+    if (_quiet)
+        return;
+    const noColor = _noColor || process.env.NO_COLOR !== undefined || !process.stderr.isTTY;
+    const yellow = noColor ? '' : '\x1b[33m';
+    const reset = noColor ? '' : '\x1b[0m';
+    process.stderr.write(`${yellow}⚠${reset} ${message}\n`);
+}
+// ── CLI-specific errors ──────────────────────────────────────────────
+class CliUsageError extends Error {
+    hints;
+    constructor(message, hints = []) {
+        super(message);
+        this.hints = hints;
+        this.name = 'CliUsageError';
+    }
+}
+exports.CliUsageError = CliUsageError;
+class CliNotFoundError extends Error {
+    hints;
+    constructor(message, hints = []) {
+        super(message);
+        this.hints = hints;
+        this.name = 'CliNotFoundError';
+    }
+}
+exports.CliNotFoundError = CliNotFoundError;
+class CliConflictError extends Error {
+    hints;
+    constructor(message, hints = []) {
+        super(message);
+        this.hints = hints;
+        this.name = 'CliConflictError';
+    }
+}
+exports.CliConflictError = CliConflictError;
+class CliAuthError extends Error {
+    hints;
+    constructor(message, hints = []) {
+        super(message);
+        this.hints = hints;
+        this.name = 'CliAuthError';
+    }
+}
+exports.CliAuthError = CliAuthError;
+//# sourceMappingURL=errors.js.map

package/dist/output/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/output/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAiBH,4BAEC;AAGD,gCAEC;AAkBD,kCAoEC;AAKD,gCAaC;AAKD,oCAKC;AAMD,8BAGC;AAMD,oCAMC;AA7JD,yDAOiC;AAEjC,wEAAwE;AAExE,IAAI,MAAM,GAAG,KAAK,CAAC;AACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,4EAA4E;AAC5E,SAAgB,QAAQ,CAAC,CAAU;IACjC,MAAM,GAAG,CAAC,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,SAAgB,UAAU,CAAC,CAAU;IACnC,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,CAAC;IACd,kBAAkB,EAAE,CAAC;IACrB,SAAS,EAAE,CAAC;IACZ,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,CAAC;IACnB,QAAQ,EAAE,CAAC;IACX,eAAe,EAAE,EAAE;CACX,CAAC;AAIX;;GAEG;AACH,SAAgB,WAAW,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,2BAAa,EAAE,CAAC;QACjC,UAAU,CAAC,6BAA6B,EAAE,GAAG,CAAC,OAAO,EAAE;YACrD,uDAAuD;SACxD,CAAC,CAAC;QACH,OAAO,kBAAU,CAAC,kBAAkB,CAAC;IACvC,CAAC;IAED,IAAI,GAAG,YAAY,8BAAgB,IAAI,GAAG,YAAY,8BAAgB,EAAE,CAAC;QACvE,UAAU,CAAC,mBAAmB,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,kCAAkC,CAAC,CAAC,CAAC;QACnF,OAAO,kBAAU,CAAC,kBAAkB,CAAC;IACvC,CAAC;IAED,IAAI,GAAG,YAAY,6BAAe,EAAE,CAAC;QACnC,UAAU,CAAC,mBAAmB,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAC1F,OAAO,kBAAU,CAAC,iBAAiB,CAAC;IACtC,CAAC;IAED,IAAI,GAAG,YAAY,8BAAgB,EAAE,CAAC;QACpC,UAAU,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,kBAAU,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,IAAI,GAAG,YAAY,iCAAmB,EAAE,CAAC;QACvC,UAAU,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAC3E,OAAO,kBAAU,CAAC,gBAAgB,CAAC;IACrC,CAAC;IAED,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;QACjC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,kBAAU,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;QACpC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,kBAAU,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;QACpC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,kBAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;QAChC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,kBAAU,CAAC,kBAAkB,CAAC;IACvC,CAAC;IAED,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,4CAA4C;QAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC/D,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO,kBAAU,CAAC,SAAS,CAAC;QAC9B,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,CAAC,8BAA8B,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAChF,UAAU,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,EAAE;gBAC7C,qDAAqD;gBACrD,8CAA8C;aAC/C,CAAC,CAAC;YACH,OAAO,kBAAU,CAAC,kBAAkB,CAAC;QACvC,CAAC;QACD,UAAU,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,kBAAU,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,UAAU,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO,kBAAU,CAAC,WAAW,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAe,EAAE,MAAe,EAAE,KAAgB;IAC3E,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACxF,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,WAAW,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC;IAC5D,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,WAAW,KAAK,IAAI,MAAM,IAAI,CAAC,CAAC;IAC/D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACxF,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,SAAgB,SAAS,CAAC,OAAe;IACvC,IAAI,MAAM;QAAE,OAAO;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,OAAe;IAC1C,IAAI,MAAM;QAAE,OAAO;IACnB,MAAM,OAAO,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACxF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,wEAAwE;AAExE,MAAa,aAAc,SAAQ,KAAK;IAGpB;IAFlB,YACE,OAAe,EACC,QAAkB,EAAE;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,UAAK,GAAL,KAAK,CAAe;QAGpC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AARD,sCAQC;AAED,MAAa,gBAAiB,SAAQ,KAAK;IAGvB;IAFlB,YACE,OAAe,EACC,QAAkB,EAAE;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,UAAK,GAAL,KAAK,CAAe;QAGpC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AARD,4CAQC;AAED,MAAa,gBAAiB,SAAQ,KAAK;IAGvB;IAFlB,YACE,OAAe,EACC,QAAkB,EAAE;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,UAAK,GAAL,KAAK,CAAe;QAGpC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AARD,4CAQC;AAED,MAAa,YAAa,SAAQ,KAAK;IAGnB;IAFlB,YACE,OAAe,EACC,QAAkB,EAAE;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,UAAK,GAAL,KAAK,CAAe;QAGpC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AARD,oCAQC"}

package/dist/output/formatter.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Output formatter for odoo-cli.
+ *
+ * Formats: json | table | csv | ndjson
+ *
+ * Conventions:
+ * - stdout = data only (all formats write to stdout)
+ * - stderr = decorative messages, warnings (caller's responsibility)
+ * - Many2one fields [id, name]: expanded to two columns in table/csv
+ * - table warns above 5000 rows and suggests ndjson
+ * - ndjson: streams one JSON object per line
+ */
+export type OutputFormat = 'json' | 'table' | 'csv' | 'ndjson';
+/** Disable ANSI colors in table/CLI output. Called from cli.ts preAction hook. */
+export declare function setNoColor(v: boolean): void;
+/** Suppress stderr progress and warnings. Called from cli.ts preAction hook. */
+export declare function setQuiet(v: boolean): void;
+/** Whether quiet mode is active (used by other output modules). */
+export declare function isQuiet(): boolean;
+/** Whether no-color mode is active. */
+export declare function isNoColor(): boolean;
+/**
+ * Detect the default output format.
+ * TTY → table, pipe → json.
+ */
+export declare function detectFormat(): OutputFormat;
+/**
+ * Resolve the format from option string, falling back to auto-detect.
+ */
+export declare function resolveFormat(fmt: string | undefined): OutputFormat;
+/**
+ * Flatten many2one fields for table/csv output.
+ *
+ * Input record:  { id: 1, partner_id: [7, "Marc"] }
+ * Output record: { id: 1, partner_id: 7, partner_id_name: "Marc" }
+ *
+ * For boolean false (no relation): partner_id → null, partner_id_name → ""
+ */
+export declare function flattenRecord(record: Record<string, any>): Record<string, any>;
+/**
+ * Get column headers for a set of records, expanding many2one fields.
+ */
+export declare function getColumns(records: Record<string, any>[]): string[];
+/**
+ * Write JSON array to stdout.
+ */
+export declare function formatJson(records: Record<string, any>[]): Promise<void>;
+/**
+ * Write ndjson to stdout — one JSON object per line.
+ */
+export declare function formatNdjson(records: Record<string, any>[]): Promise<void>;
+/**
+ * Write table to stdout.
+ * Warns at >5000 rows and suggests --format ndjson.
+ */
+export declare function formatTable(records: Record<string, any>[]): Promise<void>;
+/**
+ * Write CSV to stdout.
+ * Expands many2one fields to two columns.
+ */
+export declare function formatCsv(records: Record<string, any>[]): Promise<void>;
+/**
+ * Master render function — routes to the appropriate formatter.
+ */
+export declare function render(records: Record<string, any>[], format: OutputFormat): Promise<void>;
+/**
+ * Render a single record (e.g., `records get`).
+ * JSON outputs an object (not array). Table shows key/value pairs.
+ */
+export declare function renderSingle(record: Record<string, any>, format: OutputFormat): Promise<void>;
+/**
+ * Render a simple key/value config-style object (for `config show`).
+ */
+export declare function renderKeyValue(data: Record<string, string>, format: OutputFormat): Promise<void>;
+/**
+ * Paged search-read generator — fetches from Odoo in pages.
+ * Used by `records search --all`.
+ */
+export declare function pagedSearchRead(searchFn: (offset: number, limit: number) => Promise<Record<string, any>[]>, pageSize?: number): AsyncGenerator<Record<string, any>[]>;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAO/D,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3C;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAEzC;AAED,mEAAmE;AACnE,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED,uCAAuC;AACvC,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,YAAY,CAE3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAKnE;AAaD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgB9E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,EAAE,CAanE;AAID;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B/E;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E;AAaD;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhG;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;GAGG;AACH,wBAAuB,eAAe,CACpC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,EAC3E,QAAQ,GAAE,MAAY,GACrB,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAOvC"}