@37signals/basecamp 0.2.0

package/dist/generated/services/projects.ts

@@ -0,0 +1,224 @@
+/**
+ * Projects 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 { ListResult } from "../../pagination.js";
+import type { PaginationOptions } from "../../pagination.js";
+import { Errors } from "../../errors.js";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/** Project entity from the Basecamp API. */
+export type Project = components["schemas"]["Project"];
+
+/**
+ * Options for list.
+ */
+export interface ListProjectOptions extends PaginationOptions {
+  /** Filter by status */
+  status?: "active" | "archived" | "trashed";
+}
+
+/**
+ * Request parameters for create.
+ */
+export interface CreateProjectRequest {
+  /** Display name */
+  name: string;
+  /** Rich text description (HTML) */
+  description?: string;
+}
+
+/**
+ * Request parameters for update.
+ */
+export interface UpdateProjectRequest {
+  /** Display name */
+  name: string;
+  /** Rich text description (HTML) */
+  description?: string;
+  /** Admissions */
+  admissions?: "invite" | "employee" | "team";
+  /** Schedule date range settings */
+  scheduleAttributes?: components["schemas"]["ScheduleAttributes"];
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Projects operations.
+ */
+export class ProjectsService extends BaseService {
+
+  /**
+   * List projects (active by default; optionally archived/trashed)
+   * @param options - Optional query parameters
+   * @returns All Project across all pages, with .meta.totalCount
+   *
+   * @example
+   * ```ts
+   * const result = await client.projects.list();
+   *
+   * // With options
+   * const filtered = await client.projects.list({ status: "active" });
+   * ```
+   */
+  async list(options?: ListProjectOptions): Promise<ListResult<Project>> {
+    return this.requestPaginated(
+      {
+        service: "Projects",
+        operation: "ListProjects",
+        resourceType: "project",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/projects.json", {
+          params: {
+            query: { status: options?.status },
+          },
+        })
+      , options
+    );
+  }
+
+  /**
+   * Create a new project
+   * @param req - Project creation parameters
+   * @returns The Project
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.projects.create({ name: "My example" });
+   * ```
+   */
+  async create(req: CreateProjectRequest): Promise<Project> {
+    if (!req.name) {
+      throw Errors.validation("Name is required");
+    }
+    const response = await this.request(
+      {
+        service: "Projects",
+        operation: "CreateProject",
+        resourceType: "project",
+        isMutation: true,
+      },
+      () =>
+        this.client.POST("/projects.json", {
+          body: {
+            name: req.name,
+            description: req.description,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Get a single project by id
+   * @param projectId - The project ID
+   * @returns The Project
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.projects.get(123);
+   * ```
+   */
+  async get(projectId: number): Promise<Project> {
+    const response = await this.request(
+      {
+        service: "Projects",
+        operation: "GetProject",
+        resourceType: "project",
+        isMutation: false,
+        projectId,
+      },
+      () =>
+        this.client.GET("/projects/{projectId}", {
+          params: {
+            path: { projectId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Update an existing project
+   * @param projectId - The project ID
+   * @param req - Project update parameters
+   * @returns The Project
+   * @throws {BasecampError} If the resource is not found or fields are invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.projects.update(123, { name: "My example" });
+   * ```
+   */
+  async update(projectId: number, req: UpdateProjectRequest): Promise<Project> {
+    if (!req.name) {
+      throw Errors.validation("Name is required");
+    }
+    const response = await this.request(
+      {
+        service: "Projects",
+        operation: "UpdateProject",
+        resourceType: "project",
+        isMutation: true,
+        projectId,
+      },
+      () =>
+        this.client.PUT("/projects/{projectId}", {
+          params: {
+            path: { projectId },
+          },
+          body: {
+            name: req.name,
+            description: req.description,
+            admissions: req.admissions,
+            schedule_attributes: req.scheduleAttributes,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Trash a project. Trashed items can be recovered.
+   * @param projectId - The project ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.projects.trash(123);
+   * ```
+   */
+  async trash(projectId: number): Promise<void> {
+    await this.request(
+      {
+        service: "Projects",
+        operation: "TrashProject",
+        resourceType: "project",
+        isMutation: true,
+        projectId,
+      },
+      () =>
+        this.client.DELETE("/projects/{projectId}", {
+          params: {
+            path: { projectId },
+          },
+        })
+    );
+  }
+}

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

@@ -0,0 +1,93 @@
+/**
+ * Recordings 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 { ListResult } from "../../pagination.js";
+import type { PaginationOptions } from "../../pagination.js";
+/** Recording entity from the Basecamp API. */
+export type Recording = components["schemas"]["Recording"];
+/**
+ * Options for list.
+ */
+export interface ListRecordingOptions extends PaginationOptions {
+    /** Project IDs to filter by */
+    bucket?: number[];
+    /** Filter by status */
+    status?: "active" | "archived" | "trashed";
+    /** Filter by sort */
+    sort?: "created_at" | "updated_at";
+    /** Filter by direction */
+    direction?: "asc" | "desc";
+}
+/**
+ * Service for Recordings operations.
+ */
+export declare class RecordingsService extends BaseService {
+    /**
+     * List recordings of a given type across projects
+     * @param type - Comment|Document|Kanban::Card|Kanban::Step|Message|Question::Answer|Schedule::Entry|Todo|Todolist|Upload|Vault
+     * @param options - Optional query parameters
+     * @returns All Recording across all pages, with .meta.totalCount
+     *
+     * @example
+     * ```ts
+     * const result = await client.recordings.list("type");
+     *
+     * // With options
+     * const filtered = await client.recordings.list("type", { bucket: [123] });
+     * ```
+     */
+    list(type: "Comment" | "Document" | "Kanban::Card" | "Kanban::Step" | "Message" | "Question::Answer" | "Schedule::Entry" | "Todo" | "Todolist" | "Upload" | "Vault", options?: ListRecordingOptions): Promise<ListResult<Recording>>;
+    /**
+     * Get a single recording by id
+     * @param recordingId - The recording ID
+     * @returns The Recording
+     * @throws {BasecampError} If the resource is not found
+     *
+     * @example
+     * ```ts
+     * const result = await client.recordings.get(123);
+     * ```
+     */
+    get(recordingId: number): Promise<Recording>;
+    /**
+     * Unarchive a recording (restore to active status)
+     * @param recordingId - The recording ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.recordings.unarchive(123);
+     * ```
+     */
+    unarchive(recordingId: number): Promise<void>;
+    /**
+     * Archive a recording
+     * @param recordingId - The recording ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.recordings.archive(123);
+     * ```
+     */
+    archive(recordingId: number): Promise<void>;
+    /**
+     * Trash a recording. Trashed items can be recovered.
+     * @param recordingId - The recording ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.recordings.trash(123);
+     * ```
+     */
+    trash(recordingId: number): Promise<void>;
+}
+//# sourceMappingURL=recordings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recordings.d.ts","sourceRoot":"","sources":["../../../src/generated/services/recordings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,uBAAuB;IACvB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,qBAAqB;IACrB,IAAI,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;IACnC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAOD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAEhD;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,SAAS,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAkB1O;;;;;;;;;;OAUG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAmBlD;;;;;;;;;;OAUG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBnD;;;;;;;;;;OAUG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBhD"}

package/dist/generated/services/recordings.js

@@ -0,0 +1,138 @@
+/**
+ * Recordings service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+import { BaseService } from "../../services/base.js";
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Service for Recordings operations.
+ */
+export class RecordingsService extends BaseService {
+    /**
+     * List recordings of a given type across projects
+     * @param type - Comment|Document|Kanban::Card|Kanban::Step|Message|Question::Answer|Schedule::Entry|Todo|Todolist|Upload|Vault
+     * @param options - Optional query parameters
+     * @returns All Recording across all pages, with .meta.totalCount
+     *
+     * @example
+     * ```ts
+     * const result = await client.recordings.list("type");
+     *
+     * // With options
+     * const filtered = await client.recordings.list("type", { bucket: [123] });
+     * ```
+     */
+    async list(type, options) {
+        return this.requestPaginated({
+            service: "Recordings",
+            operation: "ListRecordings",
+            resourceType: "recording",
+            isMutation: false,
+        }, () => this.client.GET("/projects/recordings.json", {
+            params: {
+                query: { type: type, bucket: options?.bucket?.join(","), status: options?.status, sort: options?.sort, direction: options?.direction },
+            },
+        }), options);
+    }
+    /**
+     * Get a single recording by id
+     * @param recordingId - The recording ID
+     * @returns The Recording
+     * @throws {BasecampError} If the resource is not found
+     *
+     * @example
+     * ```ts
+     * const result = await client.recordings.get(123);
+     * ```
+     */
+    async get(recordingId) {
+        const response = await this.request({
+            service: "Recordings",
+            operation: "GetRecording",
+            resourceType: "recording",
+            isMutation: false,
+            resourceId: recordingId,
+        }, () => this.client.GET("/recordings/{recordingId}", {
+            params: {
+                path: { recordingId },
+            },
+        }));
+        return response;
+    }
+    /**
+     * Unarchive a recording (restore to active status)
+     * @param recordingId - The recording ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.recordings.unarchive(123);
+     * ```
+     */
+    async unarchive(recordingId) {
+        await this.request({
+            service: "Recordings",
+            operation: "UnarchiveRecording",
+            resourceType: "recording",
+            isMutation: true,
+            resourceId: recordingId,
+        }, () => this.client.PUT("/recordings/{recordingId}/status/active.json", {
+            params: {
+                path: { recordingId },
+            },
+        }));
+    }
+    /**
+     * Archive a recording
+     * @param recordingId - The recording ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.recordings.archive(123);
+     * ```
+     */
+    async archive(recordingId) {
+        await this.request({
+            service: "Recordings",
+            operation: "ArchiveRecording",
+            resourceType: "recording",
+            isMutation: true,
+            resourceId: recordingId,
+        }, () => this.client.PUT("/recordings/{recordingId}/status/archived.json", {
+            params: {
+                path: { recordingId },
+            },
+        }));
+    }
+    /**
+     * Trash a recording. Trashed items can be recovered.
+     * @param recordingId - The recording ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.recordings.trash(123);
+     * ```
+     */
+    async trash(recordingId) {
+        await this.request({
+            service: "Recordings",
+            operation: "TrashRecording",
+            resourceType: "recording",
+            isMutation: true,
+            resourceId: recordingId,
+        }, () => this.client.PUT("/recordings/{recordingId}/status/trashed.json", {
+            params: {
+                path: { recordingId },
+            },
+        }));
+    }
+}
+//# sourceMappingURL=recordings.js.map

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

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

package/dist/generated/services/recordings.ts

@@ -0,0 +1,191 @@
+/**
+ * Recordings 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 { ListResult } from "../../pagination.js";
+import type { PaginationOptions } from "../../pagination.js";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/** Recording entity from the Basecamp API. */
+export type Recording = components["schemas"]["Recording"];
+
+/**
+ * Options for list.
+ */
+export interface ListRecordingOptions extends PaginationOptions {
+  /** Project IDs to filter by */
+  bucket?: number[];
+  /** Filter by status */
+  status?: "active" | "archived" | "trashed";
+  /** Filter by sort */
+  sort?: "created_at" | "updated_at";
+  /** Filter by direction */
+  direction?: "asc" | "desc";
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Recordings operations.
+ */
+export class RecordingsService extends BaseService {
+
+  /**
+   * List recordings of a given type across projects
+   * @param type - Comment|Document|Kanban::Card|Kanban::Step|Message|Question::Answer|Schedule::Entry|Todo|Todolist|Upload|Vault
+   * @param options - Optional query parameters
+   * @returns All Recording across all pages, with .meta.totalCount
+   *
+   * @example
+   * ```ts
+   * const result = await client.recordings.list("type");
+   *
+   * // With options
+   * const filtered = await client.recordings.list("type", { bucket: [123] });
+   * ```
+   */
+  async list(type: "Comment" | "Document" | "Kanban::Card" | "Kanban::Step" | "Message" | "Question::Answer" | "Schedule::Entry" | "Todo" | "Todolist" | "Upload" | "Vault", options?: ListRecordingOptions): Promise<ListResult<Recording>> {
+    return this.requestPaginated(
+      {
+        service: "Recordings",
+        operation: "ListRecordings",
+        resourceType: "recording",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/projects/recordings.json", {
+          params: {
+            query: { type: type, bucket: options?.bucket?.join(","), status: options?.status, sort: options?.sort, direction: options?.direction },
+          },
+        })
+      , options
+    );
+  }
+
+  /**
+   * Get a single recording by id
+   * @param recordingId - The recording ID
+   * @returns The Recording
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.recordings.get(123);
+   * ```
+   */
+  async get(recordingId: number): Promise<Recording> {
+    const response = await this.request(
+      {
+        service: "Recordings",
+        operation: "GetRecording",
+        resourceType: "recording",
+        isMutation: false,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.GET("/recordings/{recordingId}", {
+          params: {
+            path: { recordingId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Unarchive a recording (restore to active status)
+   * @param recordingId - The recording ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.recordings.unarchive(123);
+   * ```
+   */
+  async unarchive(recordingId: number): Promise<void> {
+    await this.request(
+      {
+        service: "Recordings",
+        operation: "UnarchiveRecording",
+        resourceType: "recording",
+        isMutation: true,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.PUT("/recordings/{recordingId}/status/active.json", {
+          params: {
+            path: { recordingId },
+          },
+        })
+    );
+  }
+
+  /**
+   * Archive a recording
+   * @param recordingId - The recording ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.recordings.archive(123);
+   * ```
+   */
+  async archive(recordingId: number): Promise<void> {
+    await this.request(
+      {
+        service: "Recordings",
+        operation: "ArchiveRecording",
+        resourceType: "recording",
+        isMutation: true,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.PUT("/recordings/{recordingId}/status/archived.json", {
+          params: {
+            path: { recordingId },
+          },
+        })
+    );
+  }
+
+  /**
+   * Trash a recording. Trashed items can be recovered.
+   * @param recordingId - The recording ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.recordings.trash(123);
+   * ```
+   */
+  async trash(recordingId: number): Promise<void> {
+    await this.request(
+      {
+        service: "Recordings",
+        operation: "TrashRecording",
+        resourceType: "recording",
+        isMutation: true,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.PUT("/recordings/{recordingId}/status/trashed.json", {
+          params: {
+            path: { recordingId },
+          },
+        })
+    );
+  }
+}