@37signals/basecamp 0.2.0

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

@@ -0,0 +1,145 @@
+/**
+ * Timesheets service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+import { BaseService } from "../../services/base.js";
+import type { components } from "../schema.js";
+/**
+ * Options for forProject.
+ */
+export interface ForProjectTimesheetOptions {
+    /** From */
+    from?: string;
+    /** To */
+    to?: string;
+    /** Person id */
+    personId?: number;
+}
+/**
+ * Options for forRecording.
+ */
+export interface ForRecordingTimesheetOptions {
+    /** From */
+    from?: string;
+    /** To */
+    to?: string;
+    /** Person id */
+    personId?: number;
+}
+/**
+ * Request parameters for create.
+ */
+export interface CreateTimesheetRequest {
+    /** Date */
+    date: string;
+    /** Hours */
+    hours: string;
+    /** Rich text description (HTML) */
+    description?: string;
+    /** Person id */
+    personId?: number;
+}
+/**
+ * Options for report.
+ */
+export interface ReportTimesheetOptions {
+    /** From */
+    from?: string;
+    /** To */
+    to?: string;
+    /** Person id */
+    personId?: number;
+}
+/**
+ * Request parameters for update.
+ */
+export interface UpdateTimesheetRequest {
+    /** Date */
+    date?: string;
+    /** Hours */
+    hours?: string;
+    /** Rich text description (HTML) */
+    description?: string;
+    /** Person id */
+    personId?: number;
+}
+/**
+ * Service for Timesheets operations.
+ */
+export declare class TimesheetsService extends BaseService {
+    /**
+     * Get timesheet for a specific project
+     * @param projectId - The project ID
+     * @param options - Optional query parameters
+     * @returns Array of results
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.forProject(123);
+     * ```
+     */
+    forProject(projectId: number, options?: ForProjectTimesheetOptions): Promise<components["schemas"]["GetProjectTimesheetResponseContent"]>;
+    /**
+     * Get timesheet for a specific recording
+     * @param recordingId - The recording ID
+     * @param options - Optional query parameters
+     * @returns Array of results
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.forRecording(123);
+     * ```
+     */
+    forRecording(recordingId: number, options?: ForRecordingTimesheetOptions): Promise<components["schemas"]["GetRecordingTimesheetResponseContent"]>;
+    /**
+     * Create a timesheet entry on a recording
+     * @param recordingId - The recording ID
+     * @param req - Timesheet_entry creation parameters
+     * @returns The timesheet_entry
+     * @throws {BasecampError} If required fields are missing or invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.create(123, { date: "example", hours: "example" });
+     * ```
+     */
+    create(recordingId: number, req: CreateTimesheetRequest): Promise<components["schemas"]["CreateTimesheetEntryResponseContent"]>;
+    /**
+     * Get account-wide timesheet report
+     * @param options - Optional query parameters
+     * @returns Array of results
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.report();
+     * ```
+     */
+    report(options?: ReportTimesheetOptions): Promise<components["schemas"]["GetTimesheetReportResponseContent"]>;
+    /**
+     * Get a single timesheet entry
+     * @param entryId - The entry ID
+     * @returns The timesheet_entry
+     * @throws {BasecampError} If the resource is not found
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.get(123);
+     * ```
+     */
+    get(entryId: number): Promise<components["schemas"]["GetTimesheetEntryResponseContent"]>;
+    /**
+     * Update a timesheet entry
+     * @param entryId - The entry ID
+     * @param req - Timesheet_entry update parameters
+     * @returns The timesheet_entry
+     * @throws {BasecampError} If the resource is not found or fields are invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.update(123, { });
+     * ```
+     */
+    update(entryId: number, req: UpdateTimesheetRequest): Promise<components["schemas"]["UpdateTimesheetEntryResponseContent"]>;
+}
+//# sourceMappingURL=timesheets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timesheets.d.ts","sourceRoot":"","sources":["../../../src/generated/services/timesheets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ/C;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS;IACT,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS;IACT,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS;IACT,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAEhD;;;;;;;;;;OAUG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,oCAAoC,CAAC,CAAC;IAoB/I;;;;;;;;;;OAUG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,sCAAsC,CAAC,CAAC;IAoBvJ;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,qCAAqC,CAAC,CAAC;IA+BrI;;;;;;;;;OASG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,mCAAmC,CAAC,CAAC;IAkBnH;;;;;;;;;;OAUG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,kCAAkC,CAAC,CAAC;IAmB9F;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,qCAAqC,CAAC,CAAC;CAwBlI"}

package/dist/generated/services/timesheets.js

@@ -0,0 +1,186 @@
+/**
+ * Timesheets service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+import { BaseService } from "../../services/base.js";
+import { Errors } from "../../errors.js";
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Service for Timesheets operations.
+ */
+export class TimesheetsService extends BaseService {
+    /**
+     * Get timesheet for a specific project
+     * @param projectId - The project ID
+     * @param options - Optional query parameters
+     * @returns Array of results
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.forProject(123);
+     * ```
+     */
+    async forProject(projectId, options) {
+        const response = await this.request({
+            service: "Timesheets",
+            operation: "GetProjectTimesheet",
+            resourceType: "project_timesheet",
+            isMutation: false,
+            projectId,
+        }, () => this.client.GET("/projects/{projectId}/timesheet.json", {
+            params: {
+                path: { projectId },
+                query: { from: options?.from, to: options?.to, "person_id": options?.personId },
+            },
+        }));
+        return response ?? [];
+    }
+    /**
+     * Get timesheet for a specific recording
+     * @param recordingId - The recording ID
+     * @param options - Optional query parameters
+     * @returns Array of results
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.forRecording(123);
+     * ```
+     */
+    async forRecording(recordingId, options) {
+        const response = await this.request({
+            service: "Timesheets",
+            operation: "GetRecordingTimesheet",
+            resourceType: "recording_timesheet",
+            isMutation: false,
+            resourceId: recordingId,
+        }, () => this.client.GET("/recordings/{recordingId}/timesheet.json", {
+            params: {
+                path: { recordingId },
+                query: { from: options?.from, to: options?.to, "person_id": options?.personId },
+            },
+        }));
+        return response ?? [];
+    }
+    /**
+     * Create a timesheet entry on a recording
+     * @param recordingId - The recording ID
+     * @param req - Timesheet_entry creation parameters
+     * @returns The timesheet_entry
+     * @throws {BasecampError} If required fields are missing or invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.create(123, { date: "example", hours: "example" });
+     * ```
+     */
+    async create(recordingId, req) {
+        if (!req.date) {
+            throw Errors.validation("Date is required");
+        }
+        if (!req.hours) {
+            throw Errors.validation("Hours is required");
+        }
+        const response = await this.request({
+            service: "Timesheets",
+            operation: "CreateTimesheetEntry",
+            resourceType: "timesheet_entry",
+            isMutation: true,
+            resourceId: recordingId,
+        }, () => this.client.POST("/recordings/{recordingId}/timesheet/entries.json", {
+            params: {
+                path: { recordingId },
+            },
+            body: {
+                date: req.date,
+                hours: req.hours,
+                description: req.description,
+                person_id: req.personId,
+            },
+        }));
+        return response;
+    }
+    /**
+     * Get account-wide timesheet report
+     * @param options - Optional query parameters
+     * @returns Array of results
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.report();
+     * ```
+     */
+    async report(options) {
+        const response = await this.request({
+            service: "Timesheets",
+            operation: "GetTimesheetReport",
+            resourceType: "timesheet_report",
+            isMutation: false,
+        }, () => this.client.GET("/reports/timesheet.json", {
+            params: {
+                query: { from: options?.from, to: options?.to, "person_id": options?.personId },
+            },
+        }));
+        return response ?? [];
+    }
+    /**
+     * Get a single timesheet entry
+     * @param entryId - The entry ID
+     * @returns The timesheet_entry
+     * @throws {BasecampError} If the resource is not found
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.get(123);
+     * ```
+     */
+    async get(entryId) {
+        const response = await this.request({
+            service: "Timesheets",
+            operation: "GetTimesheetEntry",
+            resourceType: "timesheet_entry",
+            isMutation: false,
+            resourceId: entryId,
+        }, () => this.client.GET("/timesheet_entries/{entryId}", {
+            params: {
+                path: { entryId },
+            },
+        }));
+        return response;
+    }
+    /**
+     * Update a timesheet entry
+     * @param entryId - The entry ID
+     * @param req - Timesheet_entry update parameters
+     * @returns The timesheet_entry
+     * @throws {BasecampError} If the resource is not found or fields are invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.timesheets.update(123, { });
+     * ```
+     */
+    async update(entryId, req) {
+        const response = await this.request({
+            service: "Timesheets",
+            operation: "UpdateTimesheetEntry",
+            resourceType: "timesheet_entry",
+            isMutation: true,
+            resourceId: entryId,
+        }, () => this.client.PUT("/timesheet_entries/{entryId}", {
+            params: {
+                path: { entryId },
+            },
+            body: {
+                date: req.date,
+                hours: req.hours,
+                description: req.description,
+                person_id: req.personId,
+            },
+        }));
+        return response;
+    }
+}
+//# sourceMappingURL=timesheets.js.map

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

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

package/dist/generated/services/timesheets.ts

@@ -0,0 +1,289 @@
+/**
+ * Timesheets service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+
+import { BaseService } from "../../services/base.js";
+import type { components } from "../schema.js";
+import { Errors } from "../../errors.js";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+
+/**
+ * Options for forProject.
+ */
+export interface ForProjectTimesheetOptions {
+  /** From */
+  from?: string;
+  /** To */
+  to?: string;
+  /** Person id */
+  personId?: number;
+}
+
+/**
+ * Options for forRecording.
+ */
+export interface ForRecordingTimesheetOptions {
+  /** From */
+  from?: string;
+  /** To */
+  to?: string;
+  /** Person id */
+  personId?: number;
+}
+
+/**
+ * Request parameters for create.
+ */
+export interface CreateTimesheetRequest {
+  /** Date */
+  date: string;
+  /** Hours */
+  hours: string;
+  /** Rich text description (HTML) */
+  description?: string;
+  /** Person id */
+  personId?: number;
+}
+
+/**
+ * Options for report.
+ */
+export interface ReportTimesheetOptions {
+  /** From */
+  from?: string;
+  /** To */
+  to?: string;
+  /** Person id */
+  personId?: number;
+}
+
+/**
+ * Request parameters for update.
+ */
+export interface UpdateTimesheetRequest {
+  /** Date */
+  date?: string;
+  /** Hours */
+  hours?: string;
+  /** Rich text description (HTML) */
+  description?: string;
+  /** Person id */
+  personId?: number;
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Timesheets operations.
+ */
+export class TimesheetsService extends BaseService {
+
+  /**
+   * Get timesheet for a specific project
+   * @param projectId - The project ID
+   * @param options - Optional query parameters
+   * @returns Array of results
+   *
+   * @example
+   * ```ts
+   * const result = await client.timesheets.forProject(123);
+   * ```
+   */
+  async forProject(projectId: number, options?: ForProjectTimesheetOptions): Promise<components["schemas"]["GetProjectTimesheetResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Timesheets",
+        operation: "GetProjectTimesheet",
+        resourceType: "project_timesheet",
+        isMutation: false,
+        projectId,
+      },
+      () =>
+        this.client.GET("/projects/{projectId}/timesheet.json", {
+          params: {
+            path: { projectId },
+            query: { from: options?.from, to: options?.to, "person_id": options?.personId },
+          },
+        })
+    );
+    return response ?? [];
+  }
+
+  /**
+   * Get timesheet for a specific recording
+   * @param recordingId - The recording ID
+   * @param options - Optional query parameters
+   * @returns Array of results
+   *
+   * @example
+   * ```ts
+   * const result = await client.timesheets.forRecording(123);
+   * ```
+   */
+  async forRecording(recordingId: number, options?: ForRecordingTimesheetOptions): Promise<components["schemas"]["GetRecordingTimesheetResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Timesheets",
+        operation: "GetRecordingTimesheet",
+        resourceType: "recording_timesheet",
+        isMutation: false,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.GET("/recordings/{recordingId}/timesheet.json", {
+          params: {
+            path: { recordingId },
+            query: { from: options?.from, to: options?.to, "person_id": options?.personId },
+          },
+        })
+    );
+    return response ?? [];
+  }
+
+  /**
+   * Create a timesheet entry on a recording
+   * @param recordingId - The recording ID
+   * @param req - Timesheet_entry creation parameters
+   * @returns The timesheet_entry
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.timesheets.create(123, { date: "example", hours: "example" });
+   * ```
+   */
+  async create(recordingId: number, req: CreateTimesheetRequest): Promise<components["schemas"]["CreateTimesheetEntryResponseContent"]> {
+    if (!req.date) {
+      throw Errors.validation("Date is required");
+    }
+    if (!req.hours) {
+      throw Errors.validation("Hours is required");
+    }
+    const response = await this.request(
+      {
+        service: "Timesheets",
+        operation: "CreateTimesheetEntry",
+        resourceType: "timesheet_entry",
+        isMutation: true,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.POST("/recordings/{recordingId}/timesheet/entries.json", {
+          params: {
+            path: { recordingId },
+          },
+          body: {
+            date: req.date,
+            hours: req.hours,
+            description: req.description,
+            person_id: req.personId,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Get account-wide timesheet report
+   * @param options - Optional query parameters
+   * @returns Array of results
+   *
+   * @example
+   * ```ts
+   * const result = await client.timesheets.report();
+   * ```
+   */
+  async report(options?: ReportTimesheetOptions): Promise<components["schemas"]["GetTimesheetReportResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Timesheets",
+        operation: "GetTimesheetReport",
+        resourceType: "timesheet_report",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/reports/timesheet.json", {
+          params: {
+            query: { from: options?.from, to: options?.to, "person_id": options?.personId },
+          },
+        })
+    );
+    return response ?? [];
+  }
+
+  /**
+   * Get a single timesheet entry
+   * @param entryId - The entry ID
+   * @returns The timesheet_entry
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.timesheets.get(123);
+   * ```
+   */
+  async get(entryId: number): Promise<components["schemas"]["GetTimesheetEntryResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Timesheets",
+        operation: "GetTimesheetEntry",
+        resourceType: "timesheet_entry",
+        isMutation: false,
+        resourceId: entryId,
+      },
+      () =>
+        this.client.GET("/timesheet_entries/{entryId}", {
+          params: {
+            path: { entryId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Update a timesheet entry
+   * @param entryId - The entry ID
+   * @param req - Timesheet_entry update parameters
+   * @returns The timesheet_entry
+   * @throws {BasecampError} If the resource is not found or fields are invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.timesheets.update(123, { });
+   * ```
+   */
+  async update(entryId: number, req: UpdateTimesheetRequest): Promise<components["schemas"]["UpdateTimesheetEntryResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Timesheets",
+        operation: "UpdateTimesheetEntry",
+        resourceType: "timesheet_entry",
+        isMutation: true,
+        resourceId: entryId,
+      },
+      () =>
+        this.client.PUT("/timesheet_entries/{entryId}", {
+          params: {
+            path: { entryId },
+          },
+          body: {
+            date: req.date,
+            hours: req.hours,
+            description: req.description,
+            person_id: req.personId,
+          },
+        })
+    );
+    return response;
+  }
+}