@marcfargas/odoo-cli 0.1.0

package/dist/help/extra-help.d.ts

@@ -0,0 +1,18 @@
+/**
+ * --help-extra resolver and renderer.
+ *
+ * When --help-extra is passed, renders skill documentation for the command group.
+ *
+ * Strategy (hybrid):
+ * 1. Runtime primary: if skills/ directory is accessible, read and render full markdown.
+ * 2. Runtime fallback: use the built-in summary strings (works in compiled binaries).
+ *
+ * Skill map: command group → relevant skill files.
+ */
+/**
+ * Show extended help for a command group.
+ *
+ * Writes to stdout (so it can be piped / paged).
+ */
+export declare function showHelpExtra(group: string): Promise<void>;
+//# sourceMappingURL=extra-help.d.ts.map

package/dist/help/extra-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extra-help.d.ts","sourceRoot":"","sources":["../../src/help/extra-help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+JH;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ChE"}

package/dist/help/extra-help.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * --help-extra resolver and renderer.
+ *
+ * When --help-extra is passed, renders skill documentation for the command group.
+ *
+ * Strategy (hybrid):
+ * 1. Runtime primary: if skills/ directory is accessible, read and render full markdown.
+ * 2. Runtime fallback: use the built-in summary strings (works in compiled binaries).
+ *
+ * Skill map: command group → relevant skill files.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showHelpExtra = showHelpExtra;
+const debug_1 = __importDefault(require("debug"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const log = (0, debug_1.default)('odoo-cli:help');
+const HELP_EXTRA_SKILLS = {
+    records: ['base/crud.md', 'base/search.md', 'base/domains.md', 'base/field-types.md'],
+    mail: ['mail/chatter.md'],
+    modules: ['base/modules.md'],
+    attendance: ['modules/timesheets.md'], // attendance is in hr module docs
+    timesheets: ['modules/timesheets.md'],
+    accounting: ['modules/accounting.md'],
+    url: ['base/connection.md'],
+    schema: ['base/introspection.md'],
+    state: [],
+    config: ['base/connection.md'],
+};
+const HELP_SUMMARIES = {
+    records: `
+## odoo records — Generic CRUD on any Odoo model
+
+Search, get, create, update, and delete records on ANY Odoo model.
+
+### Examples
+
+  odoo records search crm.lead --fields id,name,stage_id --limit 20
+  odoo records get res.partner 42
+  odoo records create res.partner --data '{"name":"Acme Corp"}' --confirm
+  odoo records write crm.lead 42 --data '{"stage_id":5}' --confirm
+  odoo records delete crm.lead 42 --confirm
+
+### Domain syntax
+
+  --domain '[("active","=",True),("stage_id.name","=","Won")]'
+  --filter active=true --filter state=sale    (simple AND equality)
+  --domain-file domain.json                   (from file)
+  --domain-file -                             (from stdin)
+
+Run 'odoo schema fields <model>' to discover available fields.
+`,
+    mail: `
+## odoo mail — Chatter messages and internal notes
+
+Post messages on any record's chatter.
+
+  odoo mail note crm.lead 42 "Called customer" --confirm
+  odoo mail post sale.order 88 "Order shipped" --confirm
+  echo "Deployed: v1.2.3" | odoo mail note project.task 17 --message-file - --confirm
+
+note: internal only (staff), post: public (notifies followers).
+`,
+    modules: `
+## odoo modules — Install, upgrade, and list modules
+
+  odoo modules list --filter installed
+  odoo modules install hr_timesheet --confirm
+  odoo modules upgrade sale_management --confirm
+  odoo modules status sale_management     (exits 3 if not found)
+
+Scripting pattern:
+  if [ "$(odoo modules status sale)" = "installed" ]; then echo ready; fi
+`,
+    timesheets: `
+## odoo timesheets — Time tracking
+
+Timer workflow:
+  odoo timesheets start --task-id 42 --description "Feature work" --confirm
+  odoo timesheets stop --confirm
+  odoo timesheets running
+
+Manual logging:
+  odoo timesheets log --task-id 42 --hours 1.5 --description "Review" --confirm
+  odoo timesheets log --task-id 42 --hours 1:30 --confirm
+`,
+    attendance: `
+## odoo attendance — Clock in/out
+
+  odoo attendance clock-in --confirm
+  odoo attendance clock-out --confirm
+  odoo attendance status
+  odoo attendance list --from 2024-03-11 --to 2024-03-15
+`,
+    accounting: `
+## odoo accounting — Read-only accounting queries (no mutations)
+
+  odoo accounting cash-accounts
+  odoo accounting cash-balance --as-of 2024-03-31
+  odoo accounting posted-moves --from 2024-01-01 --to 2024-03-31
+  odoo accounting trace-recon 42
+  odoo accounting days-to-pay 1042
+`,
+    schema: `
+## odoo schema — Model and field introspection
+
+  odoo schema models --search sale
+  odoo schema fields crm.lead --type many2one
+  odoo schema describe res.partner
+  odoo schema codegen sale.order --out ./types/sale-order.ts
+`,
+    url: `
+## odoo url — Generate record URLs
+
+  odoo url record crm.lead 42
+  odoo url portal sale.order 88
+`,
+    config: `
+## odoo config — Connection management
+
+  odoo config check     # verify credentials and show current user
+  odoo config show      # show resolved config (password redacted)
+`,
+    state: `
+## odoo state — State management ⚠ EXPERIMENTAL
+
+Requires --experimental flag on all commands.
+
+  odoo state plan ./crm-stages.json --experimental
+  odoo state apply ./crm-stages.json --experimental --confirm
+
+No extended docs available yet for this experimental feature.
+`,
+};
+/**
+ * Resolve the skills directory relative to this package or the monorepo root.
+ */
+function findSkillsDir() {
+    // Try: relative to this file (dev install in monorepo)
+    const candidates = [
+        // monorepo: packages/odoo-cli → ../../skills/odoo
+        (0, path_1.resolve)(__dirname, '..', '..', '..', '..', 'skills', 'odoo'),
+        // npm install: alongside package
+        (0, path_1.resolve)(__dirname, '..', 'skills', 'odoo'),
+    ];
+    for (const candidate of candidates) {
+        if ((0, fs_1.existsSync)(candidate)) {
+            log('Found skills dir: %s', candidate);
+            return candidate;
+        }
+    }
+    log('Skills directory not found, using built-in summaries');
+    return null;
+}
+/**
+ * Show extended help for a command group.
+ *
+ * Writes to stdout (so it can be piped / paged).
+ */
+async function showHelpExtra(group) {
+    const skillFiles = HELP_EXTRA_SKILLS[group];
+    if (skillFiles === undefined) {
+        process.stdout.write(`No extended help available for '${group}'.\n`);
+        return;
+    }
+    if (skillFiles.length === 0) {
+        const summary = HELP_SUMMARIES[group];
+        if (summary) {
+            process.stdout.write(summary + '\n');
+        }
+        else {
+            process.stdout.write(`No extended help available for '${group}'.\n`);
+        }
+        return;
+    }
+    // Try to read full markdown files
+    const skillsDir = findSkillsDir();
+    if (skillsDir) {
+        let rendered = false;
+        for (const file of skillFiles) {
+            const fullPath = (0, path_1.join)(skillsDir, file);
+            if ((0, fs_1.existsSync)(fullPath)) {
+                try {
+                    const content = (0, fs_1.readFileSync)(fullPath, 'utf8');
+                    process.stdout.write(`\n${'─'.repeat(60)}\n`);
+                    process.stdout.write(`# Skill: ${file}\n`);
+                    process.stdout.write(`${'─'.repeat(60)}\n\n`);
+                    process.stdout.write(content + '\n');
+                    rendered = true;
+                }
+                catch (err) {
+                    log('Could not read %s: %o', fullPath, err);
+                }
+            }
+        }
+        if (rendered)
+            return;
+    }
+    // Fallback: built-in summary
+    const summary = HELP_SUMMARIES[group] ?? `No extended help available for '${group}'.`;
+    process.stdout.write(summary + '\n');
+}
+//# sourceMappingURL=extra-help.js.map

package/dist/help/extra-help.js.map

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

package/dist/middleware/auth.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Authentication middleware for odoo-cli.
+ *
+ * Creates an authenticated OdooClient from environment variables,
+ * optionally overriding with CLI flags (--url, --db, --user, --password).
+ *
+ * Priority: CLI flags > env vars
+ * CLI flags should be avoided in practice (shell history exposure).
+ */
+import { OdooClient, type OdooClientConfig } from '@marcfargas/odoo-client';
+export interface AuthFlags {
+    url?: string;
+    db?: string;
+    user?: string;
+    password?: string;
+}
+/**
+ * Build an OdooClientConfig from env vars + CLI flag overrides.
+ * Does NOT authenticate yet.
+ */
+export declare function buildConfig(flags: AuthFlags): OdooClientConfig;
+/**
+ * Create an authenticated OdooClient from env vars + CLI flag overrides.
+ *
+ * Throws CliAuthError if credentials are missing.
+ * Throws OdooAuthError if authentication fails (propagates from client).
+ */
+export declare function createAuthClient(flags: AuthFlags): Promise<OdooClient>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/middleware/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAK5E,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,CAyB9D;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAa5E"}

package/dist/middleware/auth.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Authentication middleware for odoo-cli.
+ *
+ * Creates an authenticated OdooClient from environment variables,
+ * optionally overriding with CLI flags (--url, --db, --user, --password).
+ *
+ * Priority: CLI flags > env vars
+ * CLI flags should be avoided in practice (shell history exposure).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildConfig = buildConfig;
+exports.createAuthClient = createAuthClient;
+const debug_1 = __importDefault(require("debug"));
+const odoo_client_1 = require("@marcfargas/odoo-client");
+const errors_1 = require("../output/errors");
+const log = (0, debug_1.default)('odoo-cli:auth');
+/**
+ * Build an OdooClientConfig from env vars + CLI flag overrides.
+ * Does NOT authenticate yet.
+ */
+function buildConfig(flags) {
+    const url = flags.url || process.env['ODOO_URL'] || '';
+    const database = flags.db || process.env['ODOO_DB'] || process.env['ODOO_DATABASE'] || '';
+    const username = flags.user || process.env['ODOO_USERNAME'] || process.env['ODOO_USER'] || '';
+    const password = flags.password || process.env['ODOO_PASSWORD'] || '';
+    const missing = [];
+    if (!url)
+        missing.push('ODOO_URL');
+    if (!database)
+        missing.push('ODOO_DB');
+    if (!username)
+        missing.push('ODOO_USERNAME');
+    if (!password)
+        missing.push('ODOO_PASSWORD');
+    if (missing.length > 0) {
+        throw new errors_1.CliAuthError(`Missing Odoo credentials: ${missing.join(', ')}`, [
+            'Set the following environment variables:',
+            '  ODOO_URL=https://mycompany.odoo.com',
+            '  ODOO_DB=mycompany',
+            '  ODOO_USERNAME=admin@example.com',
+            '  ODOO_PASSWORD=secret',
+            'Or use --url, --db, --user, --password flags (avoid in CI — use env vars)',
+        ]);
+    }
+    log('Config: url=%s db=%s user=%s', url, database, username);
+    return { url, database, username, password };
+}
+/**
+ * Create an authenticated OdooClient from env vars + CLI flag overrides.
+ *
+ * Throws CliAuthError if credentials are missing.
+ * Throws OdooAuthError if authentication fails (propagates from client).
+ */
+async function createAuthClient(flags) {
+    const config = buildConfig(flags);
+    const client = new odoo_client_1.OdooClient(config);
+    log('Authenticating as %s @ %s', config.username, config.url);
+    // Disable client-side safety guard — we handle confirmation ourselves
+    client.setSafetyContext(null);
+    await client.authenticate();
+    log('Authenticated successfully');
+    return client;
+}
+//# sourceMappingURL=auth.js.map

package/dist/middleware/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/middleware/auth.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;AAmBH,kCAyBC;AAQD,4CAaC;AA/DD,kDAA0B;AAC1B,yDAA4E;AAC5E,6CAAgD;AAEhD,MAAM,GAAG,GAAG,IAAA,eAAK,EAAC,eAAe,CAAC,CAAC;AASnC;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAgB;IAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IAC1F,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC9F,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IAEtE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,qBAAY,CAAC,6BAA6B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;YACxE,0CAA0C;YAC1C,uCAAuC;YACvC,qBAAqB;YACrB,mCAAmC;YACnC,wBAAwB;YACxB,2EAA2E;SAC5E,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,8BAA8B,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7D,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,gBAAgB,CAAC,KAAgB;IACrD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,wBAAU,CAAC,MAAM,CAAC,CAAC;IAEtC,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE9D,sEAAsE;IACtE,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;IAC5B,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/middleware/common-params.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Centralized parameter definitions for odoo-cli commands.
+ *
+ * ONE implementation for all shared flags:
+ *   - --fields, --domain, --domain-json, --domain-file, --filter
+ *   - --limit, --all, --offset, --page-size, --order
+ *   - --format, --confirm, --dry-run, --context
+ *   - Auth: --url, --db, --user, --password
+ *
+ * Commands compose these via Commander .addOption() calls.
+ * Never duplicate these definitions in individual command files.
+ */
+import { Command, Option } from 'commander';
+/** --url: Odoo base URL */
+export declare const urlOption: () => Option;
+/** --db: Database name */
+export declare const dbOption: () => Option;
+/** --user: Username */
+export declare const userOption: () => Option;
+/** --password: Password (use env var instead) */
+export declare const passwordOption: () => Option;
+/** All auth options as a group */
+export declare function addAuthOptions(cmd: Command): Command;
+/** --format: Output format */
+export declare const formatOption: () => Option;
+/** --fields: Comma-separated fields */
+export declare const fieldsOption: () => Option;
+/** --domain: Odoo domain filter */
+export declare const domainOption: () => Option;
+/** --domain-json: Strict JSON domain */
+export declare const domainJsonOption: () => Option;
+/** --domain-file: Read domain from file */
+export declare const domainFileOption: () => Option;
+/** --filter: Simple K=V equality shorthand — repeatable, values collected into array */
+export declare const filterOption: () => Option;
+/** --limit: Max records */
+export declare const limitOption: (defaultVal?: number) => Option;
+/** --all: Fetch all records (--limit 0 alias) */
+export declare const allOption: () => Option;
+/** --offset: Skip first N records */
+export declare const offsetOption: () => Option;
+/** --page-size: Paging chunk size */
+export declare const pageSizeOption: () => Option;
+/** --order: Sort order */
+export declare const orderOption: () => Option;
+/** --count: Print count instead of records */
+export declare const countOption: () => Option;
+/** --confirm: Required for WRITE/DESTRUCTIVE */
+export declare const confirmOption: () => Option;
+/** --dry-run: Preview without executing */
+export declare const dryRunOption: () => Option;
+/** --context: Extra Odoo context JSON */
+export declare const contextOption: () => Option;
+/** --no-color: Disable ANSI colors */
+export declare const noColorOption: () => Option;
+/** --quiet: Suppress stderr progress/warnings */
+export declare const quietOption: () => Option;
+/** --experimental: Required for experimental commands */
+export declare const experimentalOption: () => Option;
+/**
+ * Add search/filter options to a command.
+ * Used by: records search, records count, attendance list, timesheets list, etc.
+ */
+export declare function addSearchOptions(cmd: Command): Command;
+/**
+ * Add pagination options to a command.
+ */
+export declare function addPaginationOptions(cmd: Command, defaultLimit?: number): Command;
+/**
+ * Add output options (format + fields) to a command.
+ */
+export declare function addOutputOptions(cmd: Command): Command;
+/**
+ * Add write safety options to a command.
+ */
+export declare function addWriteOptions(cmd: Command): Command;
+/**
+ * Parse --fields value into an array of field names.
+ * Returns empty array if not specified (means "all fields").
+ */
+export declare function parseFields(fields?: string): string[];
+/**
+ * Resolve the effective limit.
+ * --all overrides --limit (sets to 0 = all).
+ */
+export declare function resolveLimit(options: {
+    limit?: number;
+    all?: boolean;
+}): number;
+//# sourceMappingURL=common-params.d.ts.map

package/dist/middleware/common-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-params.d.ts","sourceRoot":"","sources":["../../src/middleware/common-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAI5C,2BAA2B;AAC3B,eAAO,MAAM,SAAS,cAA8D,CAAC;AAErF,0BAA0B;AAC1B,eAAO,MAAM,QAAQ,cAAgE,CAAC;AAEtF,uBAAuB;AACvB,eAAO,MAAM,UAAU,cAAqE,CAAC;AAE7F,iDAAiD;AACjD,eAAO,MAAM,cAAc,cACwE,CAAC;AAEpG,kCAAkC;AAClC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMpD;AAED,8BAA8B;AAC9B,eAAO,MAAM,YAAY,cAMrB,CAAC;AAEL,uCAAuC;AACvC,eAAO,MAAM,YAAY,cAC6C,CAAC;AAEvE,mCAAmC;AACnC,eAAO,MAAM,YAAY,cACuE,CAAC;AAEjG,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,cACwD,CAAC;AAEtF,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,cACgD,CAAC;AAE9E,wFAAwF;AACxF,eAAO,MAAM,YAAY,cAGT,CAAC;AAEjB,2BAA2B;AAC3B,eAAO,MAAM,WAAW,GAAI,aAAY,MAAW,WAGb,CAAC;AAEvC,iDAAiD;AACjD,eAAO,MAAM,SAAS,cAAuE,CAAC;AAE9F,qCAAqC;AACrC,eAAO,MAAM,YAAY,cAGa,CAAC;AAEvC,qCAAqC;AACrC,eAAO,MAAM,cAAc,cAGW,CAAC;AAEvC,0BAA0B;AAC1B,eAAO,MAAM,WAAW,cAA0E,CAAC;AAEnG,8CAA8C;AAC9C,eAAO,MAAM,WAAW,cAAgE,CAAC;AAEzF,gDAAgD;AAChD,eAAO,MAAM,aAAa,cAC+D,CAAC;AAE1F,2CAA2C;AAC3C,eAAO,MAAM,YAAY,cACgE,CAAC;AAE1F,yCAAyC;AACzC,eAAO,MAAM,aAAa,cACiE,CAAC;AAE5F,sCAAsC;AACtC,eAAO,MAAM,aAAa,cAAwE,CAAC;AAEnG,iDAAiD;AACjD,eAAO,MAAM,WAAW,cAA2E,CAAC;AAEpG,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,cAC+D,CAAC;AAI/F;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMtD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,GAAE,MAAW,GAAG,OAAO,CAOrF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAG/E"}

package/dist/middleware/common-params.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Centralized parameter definitions for odoo-cli commands.
+ *
+ * ONE implementation for all shared flags:
+ *   - --fields, --domain, --domain-json, --domain-file, --filter
+ *   - --limit, --all, --offset, --page-size, --order
+ *   - --format, --confirm, --dry-run, --context
+ *   - Auth: --url, --db, --user, --password
+ *
+ * Commands compose these via Commander .addOption() calls.
+ * Never duplicate these definitions in individual command files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experimentalOption = exports.quietOption = exports.noColorOption = exports.contextOption = exports.dryRunOption = exports.confirmOption = exports.countOption = exports.orderOption = exports.pageSizeOption = exports.offsetOption = exports.allOption = exports.limitOption = exports.filterOption = exports.domainFileOption = exports.domainJsonOption = exports.domainOption = exports.fieldsOption = exports.formatOption = exports.passwordOption = exports.userOption = exports.dbOption = exports.urlOption = void 0;
+exports.addAuthOptions = addAuthOptions;
+exports.addSearchOptions = addSearchOptions;
+exports.addPaginationOptions = addPaginationOptions;
+exports.addOutputOptions = addOutputOptions;
+exports.addWriteOptions = addWriteOptions;
+exports.parseFields = parseFields;
+exports.resolveLimit = resolveLimit;
+const commander_1 = require("commander");
+// ── Option factories ─────────────────────────────────────────────────
+/** --url: Odoo base URL */
+const urlOption = () => new commander_1.Option('--url <url>', 'Odoo URL').env('ODOO_URL');
+exports.urlOption = urlOption;
+/** --db: Database name */
+const dbOption = () => new commander_1.Option('--db <db>', 'Database name').env('ODOO_DB');
+exports.dbOption = dbOption;
+/** --user: Username */
+const userOption = () => new commander_1.Option('--user <user>', 'Username').env('ODOO_USERNAME');
+exports.userOption = userOption;
+/** --password: Password (use env var instead) */
+const passwordOption = () => new commander_1.Option('--password <password>', 'Password ⚠ use env instead').env('ODOO_PASSWORD').hideHelp();
+exports.passwordOption = passwordOption;
+/** All auth options as a group */
+function addAuthOptions(cmd) {
+    return cmd
+        .addOption((0, exports.urlOption)())
+        .addOption((0, exports.dbOption)())
+        .addOption((0, exports.userOption)())
+        .addOption((0, exports.passwordOption)());
+}
+/** --format: Output format */
+const formatOption = () => new commander_1.Option('--format <format>', 'Output format: json | table | csv | ndjson').choices([
+    'json',
+    'table',
+    'csv',
+    'ndjson',
+]);
+exports.formatOption = formatOption;
+/** --fields: Comma-separated fields */
+const fieldsOption = () => new commander_1.Option('--fields <fields>', 'Comma-separated fields to include');
+exports.fieldsOption = fieldsOption;
+/** --domain: Odoo domain filter */
+const domainOption = () => new commander_1.Option('--domain <domain>', 'Odoo domain filter (Python syntax): \'["name","=","Acme"]\'');
+exports.domainOption = domainOption;
+/** --domain-json: Strict JSON domain */
+const domainJsonOption = () => new commander_1.Option('--domain-json <json>', 'Strict JSON domain: \'[["name","=","Acme"]]\'');
+exports.domainJsonOption = domainJsonOption;
+/** --domain-file: Read domain from file */
+const domainFileOption = () => new commander_1.Option('--domain-file <file>', "Read domain from file ('-' for stdin)");
+exports.domainFileOption = domainFileOption;
+/** --filter: Simple K=V equality shorthand — repeatable, values collected into array */
+const filterOption = () => new commander_1.Option('--filter <k=v>', "Simple equality filter (repeatable, AND'd)")
+    .argParser((val, prev = []) => [...prev, val])
+    .default([]);
+exports.filterOption = filterOption;
+/** --limit: Max records */
+const limitOption = (defaultVal = 80) => new commander_1.Option('--limit <n>', `Max records (default: ${defaultVal}, 0 = all)`)
+    .default(defaultVal)
+    .argParser((v) => parseInt(v, 10));
+exports.limitOption = limitOption;
+/** --all: Fetch all records (--limit 0 alias) */
+const allOption = () => new commander_1.Option('--all', 'Fetch all records (alias for --limit 0)');
+exports.allOption = allOption;
+/** --offset: Skip first N records */
+const offsetOption = () => new commander_1.Option('--offset <n>', 'Skip first N records (default: 0)')
+    .default(0)
+    .argParser((v) => parseInt(v, 10));
+exports.offsetOption = offsetOption;
+/** --page-size: Paging chunk size */
+const pageSizeOption = () => new commander_1.Option('--page-size <n>', 'Records per page when fetching all (default: 500)')
+    .default(500)
+    .argParser((v) => parseInt(v, 10));
+exports.pageSizeOption = pageSizeOption;
+/** --order: Sort order */
+const orderOption = () => new commander_1.Option('--order <order>', 'Sort: "date_order desc,name asc"');
+exports.orderOption = orderOption;
+/** --count: Print count instead of records */
+const countOption = () => new commander_1.Option('--count', 'Print count instead of records');
+exports.countOption = countOption;
+/** --confirm: Required for WRITE/DESTRUCTIVE */
+const confirmOption = () => new commander_1.Option('--confirm', 'Confirm mutation (required for WRITE/DESTRUCTIVE operations)');
+exports.confirmOption = confirmOption;
+/** --dry-run: Preview without executing */
+const dryRunOption = () => new commander_1.Option('--dry-run', 'Show RPC call without executing — does not require --confirm');
+exports.dryRunOption = dryRunOption;
+/** --context: Extra Odoo context JSON */
+const contextOption = () => new commander_1.Option('--context <json>', 'Extra Odoo context: \'{"lang":"fr_FR","company_id":3}\'');
+exports.contextOption = contextOption;
+/** --no-color: Disable ANSI colors */
+const noColorOption = () => new commander_1.Option('--no-color', 'Disable ANSI colors').env('NO_COLOR');
+exports.noColorOption = noColorOption;
+/** --quiet: Suppress stderr progress/warnings */
+const quietOption = () => new commander_1.Option('-q, --quiet', 'Suppress stderr progress and warnings');
+exports.quietOption = quietOption;
+/** --experimental: Required for experimental commands */
+const experimentalOption = () => new commander_1.Option('--experimental', 'Enable experimental features (required for `state` commands)');
+exports.experimentalOption = experimentalOption;
+// ── Option groups ────────────────────────────────────────────────────
+/**
+ * Add search/filter options to a command.
+ * Used by: records search, records count, attendance list, timesheets list, etc.
+ */
+function addSearchOptions(cmd) {
+    return cmd
+        .addOption((0, exports.domainOption)())
+        .addOption((0, exports.domainJsonOption)())
+        .addOption((0, exports.domainFileOption)())
+        .addOption((0, exports.filterOption)());
+}
+/**
+ * Add pagination options to a command.
+ */
+function addPaginationOptions(cmd, defaultLimit = 80) {
+    return cmd
+        .addOption((0, exports.limitOption)(defaultLimit))
+        .addOption((0, exports.allOption)())
+        .addOption((0, exports.offsetOption)())
+        .addOption((0, exports.pageSizeOption)())
+        .addOption((0, exports.orderOption)());
+}
+/**
+ * Add output options (format + fields) to a command.
+ */
+function addOutputOptions(cmd) {
+    return cmd.addOption((0, exports.formatOption)()).addOption((0, exports.fieldsOption)());
+}
+/**
+ * Add write safety options to a command.
+ */
+function addWriteOptions(cmd) {
+    return cmd.addOption((0, exports.confirmOption)()).addOption((0, exports.dryRunOption)()).addOption((0, exports.contextOption)());
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+/**
+ * Parse --fields value into an array of field names.
+ * Returns empty array if not specified (means "all fields").
+ */
+function parseFields(fields) {
+    if (!fields)
+        return [];
+    return fields
+        .split(',')
+        .map((f) => f.trim())
+        .filter(Boolean);
+}
+/**
+ * Resolve the effective limit.
+ * --all overrides --limit (sets to 0 = all).
+ */
+function resolveLimit(options) {
+    if (options.all)
+        return 0;
+    return options.limit ?? 80;
+}
+//# sourceMappingURL=common-params.js.map

package/dist/middleware/common-params.js.map

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

package/dist/middleware/safety.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+export type SafetyLevel = 'READ' | 'WRITE' | 'DESTRUCTIVE';
+export interface SafetyOptions {
+    confirm?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * 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).
+ */
+export declare function requireConfirm(level: SafetyLevel, options: SafetyOptions, commandDescription: string): void;
+/**
+ * Format a dry-run message to stderr showing what WOULD be called.
+ */
+export declare function printDryRun(model: string, method: string, args: any[], kwargs?: Record<string, any>): void;
+//# sourceMappingURL=safety.d.ts.map

package/dist/middleware/safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../src/middleware/safety.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,aAAa,EACtB,kBAAkB,EAAE,MAAM,GACzB,IAAI,CA0BN;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAC/B,IAAI,CAQN"}