@marcfargas/odoo-client 0.0.1 → 0.2.0

package/dist/client/odoo-client.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Main Odoo client — RPC transport, CRUD, and safety guards.
+ *
+ * Domain-specific helpers (mail, accounting, etc.) are accessed via lazy
+ * service accessors:
+ *
+ *   client.mail.postInternalNote(...)
+ *   client.modules.isModuleInstalled(...)
+ *
+ * OdooClient itself is strictly RPC/CRUD/auth/safety. No business logic.
+ *
+ * ## Adding a new service accessor
+ *
+ * 1. Create `services/{module}/` directory
+ * 2. Add a lazy getter here (3 lines: private field + getter)
+ * 3. Export from `services/index.ts`
+ * 4. Update skill docs to show `client.{module}.*` pattern
+ */
+import { OdooSessionInfo } from '../rpc/transport';
+import { type SafetyContext, type SafetyLevel } from '../safety';
+import { MailService } from '../services/mail/mail-service';
+import { ModuleManager } from '../services/modules/module-manager';
+import { AttendanceService } from '../services/attendance/attendance-service';
+import { TimesheetsService } from '../services/timesheets/timesheets-service';
+export interface OdooClientConfig {
+    url: string;
+    database: string;
+    username: string;
+    password: string;
+    /**
+     * Opt-in safety context for this client.
+     * - undefined: use global default (setDefaultSafetyContext)
+     * - null: explicitly disable safety for this client
+     * - SafetyContext: custom confirm callback
+     */
+    safety?: SafetyContext | null;
+}
+/**
+ * Main client for interacting with Odoo.
+ *
+ * Core: authentication, CRUD operations, raw RPC calls, safety guards.
+ * Services: accessed via lazy getters — `client.mail`, `client.modules`, etc.
+ */
+export declare class OdooClient {
+    private config;
+    private transport;
+    private authenticated;
+    private safetyContext;
+    constructor(config: OdooClientConfig);
+    private _mail?;
+    /**
+     * Mail / Chatter service — post messages and notes on records.
+     *
+     * ```typescript
+     * await client.mail.postInternalNote('crm.lead', 42, '<p>Called customer.</p>');
+     * await client.mail.postOpenMessage('res.partner', 7, '<p>Order shipped.</p>');
+     * ```
+     */
+    get mail(): MailService;
+    private _modules?;
+    /**
+     * Module management — install, uninstall, list, and check Odoo modules.
+     *
+     * ```typescript
+     * if (await client.modules.isModuleInstalled('sale')) { ... }
+     * await client.modules.installModule('project');
+     * ```
+     */
+    get modules(): ModuleManager;
+    private _attendance?;
+    /**
+     * Attendance service — clock in/out and presence tracking.
+     *
+     * Requires the `hr_attendance` module to be installed.
+     *
+     * ```typescript
+     * await client.attendance.clockIn();
+     * const status = await client.attendance.getStatus();
+     * await client.attendance.clockOut();
+     * ```
+     */
+    get attendance(): AttendanceService;
+    private _timesheets?;
+    /**
+     * Timesheets service — timer-based and manual time tracking on projects.
+     *
+     * Requires the `hr_timesheet` module to be installed.
+     *
+     * ```typescript
+     * // Timer workflow
+     * const entry = await client.timesheets.startTimer({
+     *   description: 'Feature work',
+     *   projectId: 5,
+     * });
+     * // ... later ...
+     * await client.timesheets.stopTimer(entry.id);
+     *
+     * // Manual logging
+     * await client.timesheets.logTime({
+     *   description: 'Code review',
+     *   projectId: 5,
+     *   hours: 1.5,
+     * });
+     * ```
+     */
+    get timesheets(): TimesheetsService;
+    /**
+     * Override safety context for this client instance.
+     * Pass null to explicitly disable, undefined to use global default.
+     */
+    setSafetyContext(ctx: SafetyContext | null | undefined): void;
+    /**
+     * Authenticate with Odoo
+     *
+     * Must be called before making any RPC calls
+     */
+    authenticate(): Promise<OdooSessionInfo>;
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current session info
+     */
+    getSession(): OdooSessionInfo | null;
+    /**
+     * Check safety guard for an operation.
+     * Throws OdooSafetyError if the operation is blocked.
+     */
+    private guard;
+    /**
+     * Make a raw RPC call to a model method
+     *
+     * Safety level is inferred from the method name:
+     * - Known read methods (search, read, fields_get, etc.) → READ (never blocked)
+     * - unlink → DELETE
+     * - Everything else → WRITE
+     *
+     * Override with `options.safetyLevel` for methods the inference gets wrong.
+     *
+     * @param model - Model name (e.g., 'res.partner')
+     * @param method - Method name (e.g., 'search', 'read')
+     * @param args - Positional arguments
+     * @param kwargs - Keyword arguments (context, etc)
+     * @param options - Additional options (safetyLevel override)
+     * @returns Method result, typed as T
+     */
+    call<T = any>(model: string, method: string, args?: any[], kwargs?: Record<string, any>, options?: {
+        safetyLevel?: SafetyLevel;
+    }): Promise<T>;
+    /**
+     * Search for records
+     *
+     * @param model - Model name
+     * @param domain - Search domain (e.g., [['active', '=', true]])
+     * @param options - Search options (offset, limit, order, etc)
+     * @returns Array of record IDs
+     */
+    search(model: string, domain?: any[], options?: {
+        offset?: number;
+        limit?: number;
+        order?: string;
+    }): Promise<number[]>;
+    /**
+     * Read records
+     *
+     * @param model - Model name
+     * @param ids - Record IDs to read
+     * @param fields - Fields to read (empty = all fields)
+     * @returns Array of record objects
+     */
+    read<T extends Record<string, any> = Record<string, any>>(model: string, ids: number | number[], fields?: string[]): Promise<T[]>;
+    /**
+     * Search and read records in one call
+     *
+     * @param model - Model name
+     * @param domain - Search domain
+     * @param options - Search and read options
+     * @returns Array of record objects
+     */
+    searchRead<T extends Record<string, any> = Record<string, any>>(model: string, domain?: any[], options?: {
+        fields?: string[];
+        offset?: number;
+        limit?: number;
+        order?: string;
+    }): Promise<T[]>;
+    /**
+     * Create a new record
+     *
+     * @param model - Model name
+     * @param values - Record values
+     * @param context - Optional context for creation
+     * @returns Created record ID
+     */
+    create(model: string, values: Record<string, any>, context?: Record<string, any>): Promise<number>;
+    /**
+     * Update records
+     *
+     * @param model - Model name
+     * @param ids - Record IDs to update
+     * @param values - Values to update
+     * @param context - Optional context for update
+     * @returns True if successful
+     */
+    write(model: string, ids: number | number[], values: Record<string, any>, context?: Record<string, any>): Promise<boolean>;
+    /**
+     * Delete records
+     *
+     * @param model - Model name
+     * @param ids - Record IDs to delete
+     * @returns True if successful
+     */
+    unlink(model: string, ids: number | number[]): Promise<boolean>;
+    /**
+     * Count matching records
+     *
+     * @param model - Model name
+     * @param domain - Search domain
+     * @returns Number of matching records
+     */
+    searchCount(model: string, domain?: any[]): Promise<number>;
+    /**
+     * Logout and close connection
+     */
+    logout(): void;
+}
+//# sourceMappingURL=odoo-client.d.ts.map

package/dist/client/odoo-client.d.ts.map

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

package/dist/client/odoo-client.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * Main Odoo client — RPC transport, CRUD, and safety guards.
+ *
+ * Domain-specific helpers (mail, accounting, etc.) are accessed via lazy
+ * service accessors:
+ *
+ *   client.mail.postInternalNote(...)
+ *   client.modules.isModuleInstalled(...)
+ *
+ * OdooClient itself is strictly RPC/CRUD/auth/safety. No business logic.
+ *
+ * ## Adding a new service accessor
+ *
+ * 1. Create `services/{module}/` directory
+ * 2. Add a lazy getter here (3 lines: private field + getter)
+ * 3. Export from `services/index.ts`
+ * 4. Update skill docs to show `client.{module}.*` pattern
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OdooClient = void 0;
+const transport_1 = require("../rpc/transport");
+const errors_1 = require("../types/errors");
+const safety_1 = require("../safety");
+const mail_service_1 = require("../services/mail/mail-service");
+const module_manager_1 = require("../services/modules/module-manager");
+const attendance_service_1 = require("../services/attendance/attendance-service");
+const timesheets_service_1 = require("../services/timesheets/timesheets-service");
+/**
+ * Main client for interacting with Odoo.
+ *
+ * Core: authentication, CRUD operations, raw RPC calls, safety guards.
+ * Services: accessed via lazy getters — `client.mail`, `client.modules`, etc.
+ */
+class OdooClient {
+    config;
+    transport;
+    authenticated = false;
+    safetyContext;
+    constructor(config) {
+        this.config = config;
+        this.transport = new transport_1.JsonRpcTransport(config.url, config.database);
+        this.safetyContext = config.safety;
+    }
+    // ── Service accessors (lazy) ────────────────────────────────────────
+    //
+    // Each service is created on first access and reused thereafter.
+    // Adding a service: private field + getter + import. That's it.
+    _mail;
+    /**
+     * Mail / Chatter service — post messages and notes on records.
+     *
+     * ```typescript
+     * await client.mail.postInternalNote('crm.lead', 42, '<p>Called customer.</p>');
+     * await client.mail.postOpenMessage('res.partner', 7, '<p>Order shipped.</p>');
+     * ```
+     */
+    get mail() {
+        return (this._mail ??= new mail_service_1.MailService(this));
+    }
+    _modules;
+    /**
+     * Module management — install, uninstall, list, and check Odoo modules.
+     *
+     * ```typescript
+     * if (await client.modules.isModuleInstalled('sale')) { ... }
+     * await client.modules.installModule('project');
+     * ```
+     */
+    get modules() {
+        return (this._modules ??= new module_manager_1.ModuleManager(this));
+    }
+    _attendance;
+    /**
+     * Attendance service — clock in/out and presence tracking.
+     *
+     * Requires the `hr_attendance` module to be installed.
+     *
+     * ```typescript
+     * await client.attendance.clockIn();
+     * const status = await client.attendance.getStatus();
+     * await client.attendance.clockOut();
+     * ```
+     */
+    get attendance() {
+        return (this._attendance ??= new attendance_service_1.AttendanceService(this));
+    }
+    _timesheets;
+    /**
+     * Timesheets service — timer-based and manual time tracking on projects.
+     *
+     * Requires the `hr_timesheet` module to be installed.
+     *
+     * ```typescript
+     * // Timer workflow
+     * const entry = await client.timesheets.startTimer({
+     *   description: 'Feature work',
+     *   projectId: 5,
+     * });
+     * // ... later ...
+     * await client.timesheets.stopTimer(entry.id);
+     *
+     * // Manual logging
+     * await client.timesheets.logTime({
+     *   description: 'Code review',
+     *   projectId: 5,
+     *   hours: 1.5,
+     * });
+     * ```
+     */
+    get timesheets() {
+        return (this._timesheets ??= new timesheets_service_1.TimesheetsService(this));
+    }
+    // ── Auth ────────────────────────────────────────────────────────────
+    /**
+     * Override safety context for this client instance.
+     * Pass null to explicitly disable, undefined to use global default.
+     */
+    setSafetyContext(ctx) {
+        this.safetyContext = ctx;
+    }
+    /**
+     * Authenticate with Odoo
+     *
+     * Must be called before making any RPC calls
+     */
+    async authenticate() {
+        const session = await this.transport.authenticate(this.config.username, this.config.password);
+        this.authenticated = true;
+        return session;
+    }
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated() {
+        return this.authenticated;
+    }
+    /**
+     * Get current session info
+     */
+    getSession() {
+        return this.transport.getSession();
+    }
+    // ── Safety ──────────────────────────────────────────────────────────
+    /**
+     * Check safety guard for an operation.
+     * Throws OdooSafetyError if the operation is blocked.
+     */
+    async guard(op) {
+        const ctx = (0, safety_1.resolveSafetyContext)(this.safetyContext);
+        if (!ctx)
+            return;
+        if (op.level === 'READ')
+            return;
+        const confirmed = await ctx.confirm(op);
+        if (!confirmed) {
+            throw new errors_1.OdooSafetyError(op);
+        }
+    }
+    // ── RPC ─────────────────────────────────────────────────────────────
+    /**
+     * Make a raw RPC call to a model method
+     *
+     * Safety level is inferred from the method name:
+     * - Known read methods (search, read, fields_get, etc.) → READ (never blocked)
+     * - unlink → DELETE
+     * - Everything else → WRITE
+     *
+     * Override with `options.safetyLevel` for methods the inference gets wrong.
+     *
+     * @param model - Model name (e.g., 'res.partner')
+     * @param method - Method name (e.g., 'search', 'read')
+     * @param args - Positional arguments
+     * @param kwargs - Keyword arguments (context, etc)
+     * @param options - Additional options (safetyLevel override)
+     * @returns Method result, typed as T
+     */
+    async call(model, method, args = [], kwargs = {}, options) {
+        if (!this.authenticated) {
+            throw new errors_1.OdooAuthError('Client not authenticated. Call authenticate() first.');
+        }
+        const level = options?.safetyLevel ?? (0, safety_1.inferSafetyLevel)(method);
+        await this.guard({
+            name: `odoo.${method}`,
+            level,
+            model,
+            description: `${model}.${method}()`,
+            target: this.config.url,
+        });
+        return this.transport.call(model, method, args, kwargs);
+    }
+    // ── CRUD ────────────────────────────────────────────────────────────
+    /**
+     * Search for records
+     *
+     * @param model - Model name
+     * @param domain - Search domain (e.g., [['active', '=', true]])
+     * @param options - Search options (offset, limit, order, etc)
+     * @returns Array of record IDs
+     */
+    async search(model, domain = [], options = {}) {
+        const kwargs = {};
+        if (options.offset !== undefined)
+            kwargs.offset = options.offset;
+        if (options.limit !== undefined)
+            kwargs.limit = options.limit;
+        if (options.order !== undefined)
+            kwargs.order = options.order;
+        return this.call(model, 'search', [domain], kwargs);
+    }
+    /**
+     * Read records
+     *
+     * @param model - Model name
+     * @param ids - Record IDs to read
+     * @param fields - Fields to read (empty = all fields)
+     * @returns Array of record objects
+     */
+    async read(model, ids, fields = []) {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        return this.call(model, 'read', [idArray, fields]);
+    }
+    /**
+     * Search and read records in one call
+     *
+     * @param model - Model name
+     * @param domain - Search domain
+     * @param options - Search and read options
+     * @returns Array of record objects
+     */
+    async searchRead(model, domain = [], options = {}) {
+        const kwargs = {};
+        if (options.fields !== undefined && options.fields.length > 0) {
+            kwargs.fields = options.fields;
+        }
+        if (options.offset !== undefined)
+            kwargs.offset = options.offset;
+        if (options.limit !== undefined)
+            kwargs.limit = options.limit;
+        if (options.order !== undefined)
+            kwargs.order = options.order;
+        return this.call(model, 'search_read', [domain], kwargs);
+    }
+    /**
+     * Create a new record
+     *
+     * @param model - Model name
+     * @param values - Record values
+     * @param context - Optional context for creation
+     * @returns Created record ID
+     */
+    async create(model, values, context = {}) {
+        return this.call(model, 'create', [values], { context });
+    }
+    /**
+     * Update records
+     *
+     * @param model - Model name
+     * @param ids - Record IDs to update
+     * @param values - Values to update
+     * @param context - Optional context for update
+     * @returns True if successful
+     */
+    async write(model, ids, values, context = {}) {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        return this.call(model, 'write', [idArray, values], { context });
+    }
+    /**
+     * Delete records
+     *
+     * @param model - Model name
+     * @param ids - Record IDs to delete
+     * @returns True if successful
+     */
+    async unlink(model, ids) {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        return this.call(model, 'unlink', [idArray]);
+    }
+    /**
+     * Count matching records
+     *
+     * @param model - Model name
+     * @param domain - Search domain
+     * @returns Number of matching records
+     */
+    async searchCount(model, domain = []) {
+        return this.call(model, 'search_count', [domain]);
+    }
+    /**
+     * Logout and close connection
+     */
+    logout() {
+        this.transport.logout();
+        this.authenticated = false;
+    }
+}
+exports.OdooClient = OdooClient;
+//# sourceMappingURL=odoo-client.js.map

package/dist/client/odoo-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"odoo-client.js","sourceRoot":"","sources":["../../src/client/odoo-client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,gDAAqE;AACrE,4CAAiE;AACjE,sCAMmB;AACnB,gEAA4D;AAC5D,uEAAmE;AACnE,kFAA8E;AAC9E,kFAA8E;AAgB9E;;;;;GAKG;AACH,MAAa,UAAU;IACb,MAAM,CAAmB;IACzB,SAAS,CAAmB;IAC5B,aAAa,GAAG,KAAK,CAAC;IACtB,aAAa,CAAmC;IAExD,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,4BAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,uEAAuE;IACvE,EAAE;IACF,iEAAiE;IACjE,gEAAgE;IAExD,KAAK,CAAe;IAE5B;;;;;;;OAOG;IACH,IAAI,IAAI;QACN,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,0BAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IAEO,QAAQ,CAAiB;IAEjC;;;;;;;OAOG;IACH,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,8BAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAEO,WAAW,CAAqB;IAExC;;;;;;;;;;OAUG;IACH,IAAI,UAAU;QACZ,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,sCAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAEO,WAAW,CAAqB;IAExC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,UAAU;QACZ,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,sCAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,uEAAuE;IAEvE;;;OAGG;IACH,gBAAgB,CAAC,GAAqC;QACpD,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9F,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,uEAAuE;IAEvE;;;OAGG;IACK,KAAK,CAAC,KAAK,CAAC,EAAiB;QACnC,MAAM,GAAG,GAAG,IAAA,6BAAoB,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,EAAE,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO;QAEhC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,wBAAe,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,uEAAuE;IAEvE;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,IAAI,CACR,KAAa,EACb,MAAc,EACd,OAAc,EAAE,EAChB,SAA8B,EAAE,EAChC,OAAuC;QAEvC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,sBAAa,CAAC,sDAAsD,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,WAAW,IAAI,IAAA,yBAAgB,EAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,KAAK,CAAC;YACf,IAAI,EAAE,QAAQ,MAAM,EAAE;YACtB,KAAK;YACL,KAAK;YACL,WAAW,EAAE,GAAG,KAAK,IAAI,MAAM,IAAI;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;SACxB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAI,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,uEAAuE;IAEvE;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,SAAgB,EAAE,EAClB,UAII,EAAE;QAEN,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACjE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE9D,OAAO,IAAI,CAAC,IAAI,CAAW,KAAK,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CACR,KAAa,EACb,GAAsB,EACtB,SAAmB,EAAE;QAErB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAM,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CACd,KAAa,EACb,SAAgB,EAAE,EAClB,UAKI,EAAE;QAEN,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACjE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE9D,OAAO,IAAI,CAAC,IAAI,CAAM,KAAK,EAAE,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,MAA2B,EAC3B,UAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,IAAI,CAAS,KAAK,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CACT,KAAa,EACb,GAAsB,EACtB,MAA2B,EAC3B,UAA+B,EAAE;QAEjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAU,KAAK,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,GAAsB;QAChD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAU,KAAK,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,SAAgB,EAAE;QACjD,OAAO,IAAI,CAAC,IAAI,CAAS,KAAK,EAAE,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;CACF;AAlUD,gCAkUC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './client';
+export * from './services';
+export * from './rpc';
+export * from './types';
+export * from './safety';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Core client, config, and factory
+__exportStar(require("./client"), exports);
+// Module services (mail, modules, etc.)
+__exportStar(require("./services"), exports);
+// RPC transport
+__exportStar(require("./rpc"), exports);
+// Types and errors
+__exportStar(require("./types"), exports);
+// Safety guards
+__exportStar(require("./safety"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mCAAmC;AACnC,2CAAyB;AAEzB,wCAAwC;AACxC,6CAA2B;AAE3B,gBAAgB;AAChB,wCAAsB;AAEtB,mBAAmB;AACnB,0CAAwB;AAExB,gBAAgB;AAChB,2CAAyB"}

package/dist/rpc/index.d.ts

@@ -0,0 +1,2 @@
+export { JsonRpcTransport, type JsonRpcRequest, type JsonRpcResponse, type OdooSessionInfo, } from './transport';
+//# sourceMappingURL=index.d.ts.map

package/dist/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}

package/dist/rpc/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonRpcTransport = void 0;
+// RPC transport layer
+var transport_1 = require("./transport");
+Object.defineProperty(exports, "JsonRpcTransport", { enumerable: true, get: function () { return transport_1.JsonRpcTransport; } });
+//# sourceMappingURL=index.js.map

package/dist/rpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":";;;AAAA,sBAAsB;AACtB,yCAKqB;AAJnB,6GAAA,gBAAgB,OAAA"}

package/dist/rpc/transport.d.ts

@@ -0,0 +1,77 @@
+/**
+ * JSON-RPC transport for Odoo
+ *
+ * Implements the JSON-RPC 2.0 protocol over HTTP for Odoo RPC calls
+ * Handles authentication, request/response formatting, and error parsing
+ */
+import { JsonRpcRequest, JsonRpcResponse, OdooSessionInfo } from './types';
+export { JsonRpcRequest, JsonRpcResponse, OdooSessionInfo };
+/**
+ * JSON-RPC transport client for Odoo
+ *
+ * Manages HTTP communication with Odoo using JSON-RPC protocol
+ */
+export declare class JsonRpcTransport {
+    private baseUrl;
+    private db;
+    private requestId;
+    private sessionInfo;
+    private password;
+    constructor(baseUrl: string, db: string);
+    /**
+     * Get the RPC endpoint URL
+     */
+    private getRpcUrl;
+    /**
+     * Generate a unique request ID
+     */
+    private nextRequestId;
+    /**
+     * Get current session info
+     */
+    getSession(): OdooSessionInfo | null;
+    /**
+     * Authenticate with Odoo using JSON-RPC
+     *
+     * Calls the common.login RPC method via /jsonrpc endpoint
+     * Stores session info (uid, db) for future requests
+     *
+     * @see https://www.odoo.com/documentation/17.0/developer/howtos/web_services.html#json-rpc-library
+     */
+    authenticate(username: string, password: string): Promise<OdooSessionInfo>;
+    /**
+     * Make an RPC call to Odoo
+     *
+     * Low-level method that sends JSON-RPC requests and parses responses
+     */
+    callRpc<T = any>(method: string, params: Record<string, any>): Promise<T>;
+    /**
+     * Categorize an Odoo RPC error into a specific error type.
+     *
+     * Checks exception_type first (more structured, Odoo 17+),
+     * then falls back to data.name (Python exception class name).
+     *
+     * @see https://github.com/odoo/odoo/blob/17.0/odoo/exceptions.py
+     */
+    private categorizeError;
+    /**
+     * Call an Odoo model method via JSON-RPC
+     *
+     * Uses the object.execute_kw RPC method to call model methods with
+     * both positional arguments and keyword arguments (kwargs).
+     *
+     * @param model - Model name (e.g., 'res.partner')
+     * @param method - Method name (e.g., 'search', 'read', 'create')
+     * @param args - Positional arguments
+     * @param kwargs - Keyword arguments (includes context)
+     * @returns Method result
+     *
+     * @see https://www.odoo.com/documentation/17.0/developer/reference/external_api.html#calling-methods
+     */
+    call<T = any>(model: string, method: string, args?: any[], kwargs?: Record<string, any>): Promise<T>;
+    /**
+     * Logout and clear session
+     */
+    logout(): void;
+}
+//# sourceMappingURL=transport.d.ts.map