@markwharton/liquidplanner 1.0.0 → 1.1.0

package/dist/client.d.ts

@@ -6,7 +6,7 @@
  *
  * @see https://api-docs.liquidplanner.com/
  */
-import type { LPConfig, LPWorkspace, LPMember, LPItem, LPCostCode, LPSyncResult, LPTimesheetEntry, LPTimesheetEntryWithId } from './types.js';
+import type { LPConfig, LPWorkspace, LPMember, LPItem, LPCostCode, LPSyncResult, LPTimesheetEntry, LPTimesheetEntryWithId, LPUpsertOptions } from './types.js';
 /**
  * LiquidPlanner API Client
  *
@@ -132,4 +132,39 @@ export declare class LPClient {
      * @param updates - Fields to update (merged with existing)
      */
     updateTimesheetEntry(entryId: number, existingEntry: LPTimesheetEntryWithId, updates: Partial<LPTimesheetEntry>): Promise<LPSyncResult>;
+    /**
+     * Create or update a timesheet entry (upsert)
+     *
+     * Checks for an existing entry first. If found, updates it (accumulating
+     * hours by default). If not found, creates a new entry.
+     *
+     * This follows the proven "fetch first" pattern from the CLI.
+     *
+     * By default, hours are accumulated (added to existing). Set `accumulate: false`
+     * to replace existing hours instead.
+     *
+     * **Note behavior:** Notes are appended to existing notes by the LP API.
+     * Pass an empty string to avoid adding notes on update.
+     *
+     * @example
+     * ```typescript
+     * // Accumulate hours (default)
+     * await client.upsertTimesheetEntry({
+     *   date: '2026-01-29',
+     *   itemId: 12345,
+     *   hours: 1.5,
+     *   note: 'Timer session'
+     * });
+     *
+     * // Replace hours instead of accumulating
+     * await client.upsertTimesheetEntry(
+     *   { date: '2026-01-29', itemId: 12345, hours: 4.0 },
+     *   { accumulate: false }
+     * );
+     * ```
+     *
+     * @param entry - The timesheet entry to create or update
+     * @param options - Upsert options (accumulate defaults to true)
+     */
+    upsertTimesheetEntry(entry: LPTimesheetEntry, options?: LPUpsertOptions): Promise<LPSyncResult>;
 }

package/dist/client.js

@@ -321,4 +321,67 @@ export class LPClient {
             return { success: false, error: getErrorMessage(error) };
         }
     }
+    /**
+     * Create or update a timesheet entry (upsert)
+     *
+     * Checks for an existing entry first. If found, updates it (accumulating
+     * hours by default). If not found, creates a new entry.
+     *
+     * This follows the proven "fetch first" pattern from the CLI.
+     *
+     * By default, hours are accumulated (added to existing). Set `accumulate: false`
+     * to replace existing hours instead.
+     *
+     * **Note behavior:** Notes are appended to existing notes by the LP API.
+     * Pass an empty string to avoid adding notes on update.
+     *
+     * @example
+     * ```typescript
+     * // Accumulate hours (default)
+     * await client.upsertTimesheetEntry({
+     *   date: '2026-01-29',
+     *   itemId: 12345,
+     *   hours: 1.5,
+     *   note: 'Timer session'
+     * });
+     *
+     * // Replace hours instead of accumulating
+     * await client.upsertTimesheetEntry(
+     *   { date: '2026-01-29', itemId: 12345, hours: 4.0 },
+     *   { accumulate: false }
+     * );
+     * ```
+     *
+     * @param entry - The timesheet entry to create or update
+     * @param options - Upsert options (accumulate defaults to true)
+     */
+    async upsertTimesheetEntry(entry, options = {}) {
+        const { accumulate = true } = options;
+        // Fetch existing entries for this date/item first
+        const { entries, error: fetchError } = await this.getTimesheetEntries(entry.date, entry.itemId);
+        if (fetchError) {
+            return { success: false, error: fetchError };
+        }
+        // Find matching entry
+        // If no costCodeId specified, match any entry (LP uses assignment's default)
+        // If costCodeId specified, match exactly
+        const existingEntry = entries?.find((e) => {
+            if (entry.costCodeId === undefined || entry.costCodeId === null) {
+                return true;
+            }
+            return e.costCodeId === entry.costCodeId;
+        });
+        if (existingEntry) {
+            // Update existing entry
+            const newHours = accumulate
+                ? existingEntry.hours + entry.hours
+                : entry.hours;
+            return this.updateTimesheetEntry(existingEntry.id, existingEntry, {
+                hours: newHours,
+                note: entry.note,
+            });
+        }
+        // No existing entry, create new
+        return this.createTimesheetEntry(entry);
+    }
 }

package/dist/index.d.ts

@@ -28,7 +28,7 @@
  */
 export { LPClient } from './client.js';
 export { resolveTaskToAssignment } from './workflows.js';
-export type { LPConfig, LPItemType, LPItem, LPWorkspace, LPMember, LPCostCode, LPSyncResult, LPTimesheetEntry, LPTimesheetEntryWithId, LPTaskResolution, LPResult, } from './types.js';
+export type { LPConfig, LPItemType, LPItem, LPWorkspace, LPMember, LPCostCode, LPSyncResult, LPTimesheetEntry, LPTimesheetEntryWithId, LPTaskResolution, LPResult, LPUpsertOptions, } from './types.js';
 export { hoursToMinutes, normalizeItemType, buildAuthHeader, filterIs, filterIn, paginatedFetch, } from './utils.js';
 export type { PaginateOptions } from './utils.js';
 export { LP_API_BASE, DEFAULT_ITEM_NAME, DEFAULT_ASSIGNMENT_NAME, } from './constants.js';

package/dist/types.d.ts

@@ -136,3 +136,14 @@ export interface LPResult<T> {
     /** Error message if failed */
     error?: string;
 }
+/**
+ * Options for upsert timesheet entry operation
+ */
+export interface LPUpsertOptions {
+    /**
+     * Whether to accumulate hours with existing entry (default: true)
+     * - true: Add new hours to existing hours
+     * - false: Replace existing hours with new hours
+     */
+    accumulate?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markwharton/liquidplanner",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "LiquidPlanner API client for timesheet integration",
   "type": "module",
   "main": "dist/index.js",