@marcfargas/odoo-client 0.1.0 → 0.2.0

package/dist/services/attendance/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Types for hr.attendance service.
+ *
+ * @see https://github.com/odoo/odoo/blob/17.0/addons/hr_attendance/models/hr_attendance.py
+ */
+/**
+ * Raw hr.attendance record as returned by Odoo read/search_read.
+ *
+ * Key fields:
+ * - check_in: always set when record exists
+ * - check_out: null/false when the employee is still checked in
+ * - worked_hours: computed from check_in/check_out (0 when still checked in)
+ */
+export interface AttendanceRecord {
+    id: number;
+    /** Many2one → hr.employee: [id, display_name] */
+    employee_id: [number, string] | false;
+    /** Datetime string (UTC): when the employee checked in */
+    check_in: string;
+    /** Datetime string (UTC) or false: when the employee checked out */
+    check_out: string | false;
+    /** Computed: hours worked (check_out - check_in), 0 if still checked in */
+    worked_hours: number;
+}
+/**
+ * Options for listing attendance records.
+ */
+export interface AttendanceListOptions {
+    /** Filter by employee ID */
+    employeeId?: number;
+    /** Start date (inclusive, YYYY-MM-DD) */
+    dateFrom?: string;
+    /** End date (inclusive, YYYY-MM-DD) */
+    dateTo?: string;
+    /** Max records to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort order (default: 'check_in desc') */
+    order?: string;
+}
+/**
+ * Attendance status for an employee.
+ */
+export interface AttendanceStatus {
+    /** Whether the employee is currently checked in */
+    checkedIn: boolean;
+    /** The current (open) attendance record, or null if checked out */
+    currentAttendance: AttendanceRecord | null;
+    /** Employee info: [id, display_name] */
+    employee: [number, string];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/attendance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/attendance/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1B,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,iBAAiB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,wCAAwC;IACxC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B"}

package/dist/services/attendance/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Types for hr.attendance service.
+ *
+ * @see https://github.com/odoo/odoo/blob/17.0/addons/hr_attendance/models/hr_attendance.py
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/services/attendance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/attendance/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/services/index.d.ts

@@ -19,4 +19,6 @@
  */
 export * from './mail';
 export * from './modules';
+export * from './attendance';
+export * from './timesheets';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/services/index.js

@@ -35,4 +35,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./mail"), exports);
 __exportStar(require("./modules"), exports);
+__exportStar(require("./attendance"), exports);
+__exportStar(require("./timesheets"), exports);
 //# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;AAEH,yCAAuB;AACvB,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;AAEH,yCAAuB;AACvB,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA6B"}

package/dist/services/timesheets/functions.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Timesheet standalone functions — timer start/stop and time logging.
+ *
+ * Timer concept in Odoo timesheets is simple:
+ * - A running clock = account.analytic.line with unit_amount = 0 (no duration)
+ * - A stopped clock = account.analytic.line with unit_amount > 0 (duration filled)
+ *
+ * This is standard hr_timesheet behavior. The OCA module
+ * `project_timesheet_time_control` adds UI buttons for this workflow,
+ * but the data model needs nothing beyond the base module.
+ *
+ * We use create_date to compute elapsed time when stopping a timer.
+ *
+ * @see https://github.com/odoo/odoo/blob/17.0/addons/hr_timesheet/models/account_analytic_line.py
+ * @see https://github.com/OCA/project/tree/17.0/project_timesheet_time_control
+ */
+import type { OdooClient } from '../../client/odoo-client';
+import type { TimesheetEntry, TimerStartOptions, LogTimeOptions, TimesheetListOptions } from './types';
+/**
+ * Start a timesheet timer — creates a line with no duration.
+ *
+ * An entry with unit_amount = 0 represents a running clock.
+ * Call stopTimer() to compute elapsed time and fill in the duration.
+ *
+ * @param client  - Authenticated OdooClient
+ * @param options - Timer options (description, projectId, optional taskId/employeeId)
+ * @returns The created timesheet entry (unit_amount = 0)
+ *
+ * @throws OdooValidationError if description or projectId missing
+ */
+export declare function startTimer(client: OdooClient, options: TimerStartOptions): Promise<TimesheetEntry>;
+/**
+ * Stop a running timesheet timer.
+ *
+ * Computes elapsed time from create_date to now and writes unit_amount.
+ * After this call, the entry has unit_amount > 0 (closed).
+ *
+ * @param client      - Authenticated OdooClient
+ * @param timesheetId - ID of the timesheet entry to stop (must have unit_amount = 0)
+ * @returns The updated timesheet entry with duration filled in
+ *
+ * @throws OdooValidationError if the entry already has a duration
+ */
+export declare function stopTimer(client: OdooClient, timesheetId: number): Promise<TimesheetEntry>;
+/**
+ * Find running timers for an employee.
+ *
+ * Running timers are timesheet entries with unit_amount = 0.
+ *
+ * @param client     - Authenticated OdooClient
+ * @param employeeId - Employee ID (omit for current user's employee)
+ * @returns Array of timesheet entries with unit_amount = 0
+ */
+export declare function getRunningTimers(client: OdooClient, employeeId?: number): Promise<TimesheetEntry[]>;
+/**
+ * Log a completed timesheet entry (no timer, just hours).
+ *
+ * Creates an account.analytic.line with unit_amount already set.
+ *
+ * @param client  - Authenticated OdooClient
+ * @param options - Time log options
+ * @returns The created timesheet entry
+ *
+ * @throws OdooValidationError if required fields missing or hours <= 0
+ */
+export declare function logTime(client: OdooClient, options: LogTimeOptions): Promise<TimesheetEntry>;
+/**
+ * List timesheet entries with optional filters.
+ *
+ * @param client  - Authenticated OdooClient
+ * @param options - Filter and pagination options
+ * @returns Array of timesheet entries
+ */
+export declare function listTimesheets(client: OdooClient, options?: TimesheetListOptions): Promise<TimesheetEntry[]>;
+//# sourceMappingURL=functions.d.ts.map

package/dist/services/timesheets/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/services/timesheets/functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAsBjB;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,cAAc,CAAC,CAiCzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA2ChG;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CAgB3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAkCzB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC,CAmC3B"}

package/dist/services/timesheets/functions.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Timesheet standalone functions — timer start/stop and time logging.
+ *
+ * Timer concept in Odoo timesheets is simple:
+ * - A running clock = account.analytic.line with unit_amount = 0 (no duration)
+ * - A stopped clock = account.analytic.line with unit_amount > 0 (duration filled)
+ *
+ * This is standard hr_timesheet behavior. The OCA module
+ * `project_timesheet_time_control` adds UI buttons for this workflow,
+ * but the data model needs nothing beyond the base module.
+ *
+ * We use create_date to compute elapsed time when stopping a timer.
+ *
+ * @see https://github.com/odoo/odoo/blob/17.0/addons/hr_timesheet/models/account_analytic_line.py
+ * @see https://github.com/OCA/project/tree/17.0/project_timesheet_time_control
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startTimer = startTimer;
+exports.stopTimer = stopTimer;
+exports.getRunningTimers = getRunningTimers;
+exports.logTime = logTime;
+exports.listTimesheets = listTimesheets;
+const debug_1 = __importDefault(require("debug"));
+const errors_1 = require("../../types/errors");
+const functions_1 = require("../attendance/functions");
+const log = (0, debug_1.default)('odoo-client:timesheets');
+/** Fields we always fetch for timesheet entries. */
+const TIMESHEET_FIELDS = [
+    'name',
+    'date',
+    'unit_amount',
+    'project_id',
+    'task_id',
+    'employee_id',
+    'create_date',
+];
+/**
+ * Get the current date as YYYY-MM-DD.
+ */
+function today() {
+    return new Date().toISOString().split('T')[0];
+}
+/**
+ * Start a timesheet timer — creates a line with no duration.
+ *
+ * An entry with unit_amount = 0 represents a running clock.
+ * Call stopTimer() to compute elapsed time and fill in the duration.
+ *
+ * @param client  - Authenticated OdooClient
+ * @param options - Timer options (description, projectId, optional taskId/employeeId)
+ * @returns The created timesheet entry (unit_amount = 0)
+ *
+ * @throws OdooValidationError if description or projectId missing
+ */
+async function startTimer(client, options) {
+    if (!options.description?.trim()) {
+        throw new errors_1.OdooValidationError('Timesheet description is required. Describe the work being done.');
+    }
+    if (!options.projectId) {
+        throw new errors_1.OdooValidationError('Project ID is required for timesheet entries. ' +
+            'The project must have allow_timesheets = true.');
+    }
+    const empId = await (0, functions_1.resolveEmployeeId)(client, options.employeeId);
+    log('Starting timer for employee %d on project %d', empId, options.projectId);
+    const values = {
+        name: options.description.trim(),
+        project_id: options.projectId,
+        employee_id: empId,
+        unit_amount: 0,
+        date: today(),
+    };
+    if (options.taskId) {
+        values.task_id = options.taskId;
+    }
+    const id = await client.create('account.analytic.line', values);
+    log('Created timesheet entry %d with unit_amount=0 (running)', id);
+    const [entry] = await client.read('account.analytic.line', id, TIMESHEET_FIELDS);
+    return entry;
+}
+/**
+ * Stop a running timesheet timer.
+ *
+ * Computes elapsed time from create_date to now and writes unit_amount.
+ * After this call, the entry has unit_amount > 0 (closed).
+ *
+ * @param client      - Authenticated OdooClient
+ * @param timesheetId - ID of the timesheet entry to stop (must have unit_amount = 0)
+ * @returns The updated timesheet entry with duration filled in
+ *
+ * @throws OdooValidationError if the entry already has a duration
+ */
+async function stopTimer(client, timesheetId) {
+    log('Stopping timer on entry %d', timesheetId);
+    const [entry] = await client.read('account.analytic.line', timesheetId, TIMESHEET_FIELDS);
+    if (entry.unit_amount !== 0) {
+        throw new errors_1.OdooValidationError(`Timesheet entry ${timesheetId} is not a running timer ` +
+            `(unit_amount = ${entry.unit_amount}). ` +
+            'Only entries with unit_amount = 0 can be stopped.');
+    }
+    // Compute elapsed time from create_date
+    const createDate = entry.create_date;
+    if (!createDate) {
+        throw new errors_1.OdooValidationError(`Cannot determine start time for entry ${timesheetId}: create_date not available.`);
+    }
+    const startMs = new Date(createDate.replace(' ', 'T') + 'Z').getTime();
+    const nowMs = Date.now();
+    const elapsedHours = Math.max(0, (nowMs - startMs) / (1000 * 60 * 60));
+    // Round to 2 decimal places, minimum 0.01 (36s) to avoid staying at 0 (= "running")
+    const roundedHours = Math.max(0.01, Math.round(elapsedHours * 100) / 100);
+    await client.write('account.analytic.line', timesheetId, {
+        unit_amount: roundedHours,
+    });
+    log('Timer stopped on entry %d: %.2f hours (from %s)', timesheetId, roundedHours, createDate);
+    const [updated] = await client.read('account.analytic.line', timesheetId, TIMESHEET_FIELDS);
+    return updated;
+}
+/**
+ * Find running timers for an employee.
+ *
+ * Running timers are timesheet entries with unit_amount = 0.
+ *
+ * @param client     - Authenticated OdooClient
+ * @param employeeId - Employee ID (omit for current user's employee)
+ * @returns Array of timesheet entries with unit_amount = 0
+ */
+async function getRunningTimers(client, employeeId) {
+    const empId = await (0, functions_1.resolveEmployeeId)(client, employeeId);
+    log('Looking for running timers for employee %d', empId);
+    return client.searchRead('account.analytic.line', [
+        ['employee_id', '=', empId],
+        ['unit_amount', '=', 0],
+        ['project_id', '!=', false],
+    ], {
+        fields: TIMESHEET_FIELDS,
+        order: 'create_date desc',
+    });
+}
+/**
+ * Log a completed timesheet entry (no timer, just hours).
+ *
+ * Creates an account.analytic.line with unit_amount already set.
+ *
+ * @param client  - Authenticated OdooClient
+ * @param options - Time log options
+ * @returns The created timesheet entry
+ *
+ * @throws OdooValidationError if required fields missing or hours <= 0
+ */
+async function logTime(client, options) {
+    if (!options.description?.trim()) {
+        throw new errors_1.OdooValidationError('Timesheet description is required. Describe the work done.');
+    }
+    if (!options.projectId) {
+        throw new errors_1.OdooValidationError('Project ID is required for timesheet entries.');
+    }
+    if (!options.hours || options.hours <= 0) {
+        throw new errors_1.OdooValidationError(`Hours must be greater than 0 (got: ${options.hours}). ` +
+            'Use startTimer() for entries where duration is unknown.');
+    }
+    const empId = await (0, functions_1.resolveEmployeeId)(client, options.employeeId);
+    log('Logging %f hours for employee %d on project %d', options.hours, empId, options.projectId);
+    const values = {
+        name: options.description.trim(),
+        project_id: options.projectId,
+        employee_id: empId,
+        unit_amount: options.hours,
+        date: options.date ?? today(),
+    };
+    if (options.taskId) {
+        values.task_id = options.taskId;
+    }
+    const id = await client.create('account.analytic.line', values);
+    log('Logged timesheet entry %d: %f hours', id, options.hours);
+    const [entry] = await client.read('account.analytic.line', id, TIMESHEET_FIELDS);
+    return entry;
+}
+/**
+ * List timesheet entries with optional filters.
+ *
+ * @param client  - Authenticated OdooClient
+ * @param options - Filter and pagination options
+ * @returns Array of timesheet entries
+ */
+async function listTimesheets(client, options = {}) {
+    const domain = [];
+    if (options.employeeId) {
+        domain.push(['employee_id', '=', options.employeeId]);
+    }
+    if (options.projectId) {
+        domain.push(['project_id', '=', options.projectId]);
+    }
+    if (options.taskId) {
+        domain.push(['task_id', '=', options.taskId]);
+    }
+    if (options.dateFrom) {
+        domain.push(['date', '>=', options.dateFrom]);
+    }
+    if (options.dateTo) {
+        domain.push(['date', '<=', options.dateTo]);
+    }
+    if (options.runningOnly) {
+        domain.push(['unit_amount', '=', 0]);
+    }
+    // Ensure we only get timesheet lines (not generic analytic lines)
+    if (!options.projectId) {
+        domain.push(['project_id', '!=', false]);
+    }
+    log('Listing timesheets with domain: %o', domain);
+    return client.searchRead('account.analytic.line', domain, {
+        fields: TIMESHEET_FIELDS,
+        limit: options.limit,
+        offset: options.offset,
+        order: options.order ?? 'date desc, id desc',
+    });
+}
+//# sourceMappingURL=functions.js.map

package/dist/services/timesheets/functions.js.map

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

package/dist/services/timesheets/index.d.ts

@@ -0,0 +1,4 @@
+export { TimesheetsService } from './timesheets-service';
+export { startTimer, stopTimer, getRunningTimers, logTime, listTimesheets } from './functions';
+export type { TimesheetEntry, TimerStartOptions, LogTimeOptions, TimesheetListOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/timesheets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/timesheets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/F,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/services/timesheets/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listTimesheets = exports.logTime = exports.getRunningTimers = exports.stopTimer = exports.startTimer = exports.TimesheetsService = void 0;
+var timesheets_service_1 = require("./timesheets-service");
+Object.defineProperty(exports, "TimesheetsService", { enumerable: true, get: function () { return timesheets_service_1.TimesheetsService; } });
+var functions_1 = require("./functions");
+Object.defineProperty(exports, "startTimer", { enumerable: true, get: function () { return functions_1.startTimer; } });
+Object.defineProperty(exports, "stopTimer", { enumerable: true, get: function () { return functions_1.stopTimer; } });
+Object.defineProperty(exports, "getRunningTimers", { enumerable: true, get: function () { return functions_1.getRunningTimers; } });
+Object.defineProperty(exports, "logTime", { enumerable: true, get: function () { return functions_1.logTime; } });
+Object.defineProperty(exports, "listTimesheets", { enumerable: true, get: function () { return functions_1.listTimesheets; } });
+//# sourceMappingURL=index.js.map

package/dist/services/timesheets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/timesheets/index.ts"],"names":[],"mappings":";;;AAAA,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,yCAA+F;AAAtF,uGAAA,UAAU,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,oGAAA,OAAO,OAAA;AAAE,2GAAA,cAAc,OAAA"}

package/dist/services/timesheets/timesheets-service.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Timesheets service — the typed interface exposed via `client.timesheets.*`
+ *
+ * Delegates to standalone functions in functions.ts.
+ *
+ * Timer concept: unit_amount = 0 means running, unit_amount > 0 means closed.
+ * This is standard hr_timesheet behavior — no extra modules needed.
+ *
+ * Requires the `hr_timesheet` module to be installed.
+ *
+ * @see https://github.com/odoo/odoo/blob/17.0/addons/hr_timesheet/models/account_analytic_line.py
+ */
+import type { OdooClient } from '../../client/odoo-client';
+import type { TimesheetEntry, TimerStartOptions, LogTimeOptions, TimesheetListOptions } from './types';
+/**
+ * Timesheets service for managing time tracking on projects and tasks.
+ *
+ * Access via `client.timesheets` — never instantiate directly.
+ *
+ * Two workflows:
+ * 1. **Timer-based**: startTimer() → work → stopTimer() (duration auto-computed)
+ * 2. **Manual**: logTime() with known hours (e.g., logging past work)
+ *
+ * All methods accept an optional employeeId. When omitted, the current
+ * user's linked hr.employee record is used automatically.
+ */
+export declare class TimesheetsService {
+    private client;
+    /** @internal */
+    constructor(client: OdooClient);
+    /**
+     * Start a timesheet timer.
+     *
+     * Creates a timesheet entry and starts the clock. Duration is tracked
+     * automatically until stopTimer() is called.
+     *
+     * @param options - Description, projectId, optional taskId/employeeId
+     * @returns The created timesheet entry with timer running
+     *
+     * @example
+     * ```typescript
+     * const entry = await client.timesheets.startTimer({
+     *   description: 'Implementing login feature',
+     *   projectId: 5,
+     *   taskId: 42,
+     * });
+     * console.log(`Timer started: ${entry.id}`);
+     * ```
+     */
+    startTimer(options: TimerStartOptions): Promise<TimesheetEntry>;
+    /**
+     * Stop a running timesheet timer.
+     *
+     * Computes the elapsed time and saves it to the entry's unit_amount.
+     *
+     * @param timesheetId - ID of the timesheet entry with a running timer
+     * @returns The updated entry with hours filled in
+     * @throws OdooValidationError if no running timer on this entry
+     *
+     * @example
+     * ```typescript
+     * const entry = await client.timesheets.stopTimer(123);
+     * console.log(`Logged ${entry.unit_amount.toFixed(2)} hours`);
+     * ```
+     */
+    stopTimer(timesheetId: number): Promise<TimesheetEntry>;
+    /**
+     * Find all running timers for an employee.
+     *
+     * @param employeeId - Employee ID (omit for current user's employee)
+     * @returns Array of entries with running timers (usually 0 or 1)
+     *
+     * @example
+     * ```typescript
+     * const running = await client.timesheets.getRunningTimers();
+     * if (running.length > 0) {
+     *   console.log(`Timer running since ${running[0].timer_start}`);
+     * }
+     * ```
+     */
+    getRunningTimers(employeeId?: number): Promise<TimesheetEntry[]>;
+    /**
+     * Log a completed timesheet entry with known hours.
+     *
+     * Use this when you know the duration (no timer needed).
+     *
+     * @param options - Description, projectId, hours, optional taskId/date/employeeId
+     * @returns The created timesheet entry
+     *
+     * @example
+     * ```typescript
+     * const entry = await client.timesheets.logTime({
+     *   description: 'Code review for PR #42',
+     *   projectId: 5,
+     *   taskId: 42,
+     *   hours: 1.5,
+     * });
+     * ```
+     */
+    logTime(options: LogTimeOptions): Promise<TimesheetEntry>;
+    /**
+     * List timesheet entries with optional filters.
+     *
+     * @param options - Filter by employee, project, task, date range, etc.
+     * @returns Array of timesheet entries
+     *
+     * @example
+     * ```typescript
+     * // This week's timesheets
+     * const entries = await client.timesheets.list({
+     *   dateFrom: '2026-02-09',
+     *   dateTo: '2026-02-15',
+     *   employeeId: 42,
+     * });
+     * const total = entries.reduce((sum, e) => sum + e.unit_amount, 0);
+     * console.log(`Total: ${total.toFixed(2)} hours`);
+     * ```
+     */
+    list(options?: TimesheetListOptions): Promise<TimesheetEntry[]>;
+}
+//# sourceMappingURL=timesheets-service.d.ts.map

package/dist/services/timesheets/timesheets-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timesheets-service.d.ts","sourceRoot":"","sources":["../../../src/services/timesheets/timesheets-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AASjB;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAEhB,OAAO,CAAC,MAAM;IAD1B,gBAAgB;gBACI,MAAM,EAAE,UAAU;IAEtC;;;;;;;;;;;;;;;;;;OAkBG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIrE;;;;;;;;;;;;;;OAcG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAItE;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAI/D;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAGtE"}