@37signals/basecamp 0.2.0

package/src/generated/services/attachments.ts

@@ -0,0 +1,59 @@
+/**
+ * Attachments 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";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Attachments operations.
+ */
+export class AttachmentsService extends BaseService {
+
+  /**
+   * Create an attachment (upload a file for embedding)
+   * @param data - Binary file data to upload
+   * @param contentType - MIME type of the file (e.g., "image/png", "application/pdf")
+   * @param name - name
+   * @returns The attachment
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.attachments.create(fileData, "image/png", "name");
+   * ```
+   */
+  async create(data: ArrayBuffer | Uint8Array | string, contentType: string, name: string): Promise<components["schemas"]["CreateAttachmentResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Attachments",
+        operation: "CreateAttachment",
+        resourceType: "attachment",
+        isMutation: true,
+      },
+      () =>
+        this.client.POST("/attachments.json", {
+          params: {
+            query: { name: name },
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            header: { "Content-Type": contentType } as any,
+          },
+          body: data as unknown as string,
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          bodySerializer: (body: unknown) => body as any,
+        })
+    );
+    return response;
+  }
+}

package/src/generated/services/boosts.ts

@@ -0,0 +1,250 @@
+/**
+ * Boosts 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
+// =============================================================================
+
+
+/**
+ * Options for listForRecording.
+ */
+export interface ListForRecordingBoostOptions extends PaginationOptions {
+}
+
+/**
+ * Request parameters for createForRecording.
+ */
+export interface CreateForRecordingBoostRequest {
+  /** Text content */
+  content: string;
+}
+
+/**
+ * Options for listForEvent.
+ */
+export interface ListForEventBoostOptions extends PaginationOptions {
+}
+
+/**
+ * Request parameters for createForEvent.
+ */
+export interface CreateForEventBoostRequest {
+  /** Text content */
+  content: string;
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Boosts operations.
+ */
+export class BoostsService extends BaseService {
+
+  /**
+   * Get a single boost
+   * @param boostId - The boost ID
+   * @returns The boost
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.boosts.get(123);
+   * ```
+   */
+  async get(boostId: number): Promise<components["schemas"]["GetBoostResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Boosts",
+        operation: "GetBoost",
+        resourceType: "boost",
+        isMutation: false,
+        resourceId: boostId,
+      },
+      () =>
+        this.client.GET("/boosts/{boostId}", {
+          params: {
+            path: { boostId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Delete a boost
+   * @param boostId - The boost ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.boosts.delete(123);
+   * ```
+   */
+  async delete(boostId: number): Promise<void> {
+    await this.request(
+      {
+        service: "Boosts",
+        operation: "DeleteBoost",
+        resourceType: "boost",
+        isMutation: true,
+        resourceId: boostId,
+      },
+      () =>
+        this.client.DELETE("/boosts/{boostId}", {
+          params: {
+            path: { boostId },
+          },
+        })
+    );
+  }
+
+  /**
+   * List boosts on a recording
+   * @param recordingId - The recording ID
+   * @param options - Optional query parameters
+   * @returns All results across all pages, with .meta.totalCount
+   *
+   * @example
+   * ```ts
+   * const result = await client.boosts.listForRecording(123);
+   * ```
+   */
+  async listForRecording(recordingId: number, options?: ListForRecordingBoostOptions): Promise<components["schemas"]["ListRecordingBoostsResponseContent"]> {
+    return this.requestPaginated(
+      {
+        service: "Boosts",
+        operation: "ListRecordingBoosts",
+        resourceType: "recording_boost",
+        isMutation: false,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.GET("/recordings/{recordingId}/boosts.json", {
+          params: {
+            path: { recordingId },
+          },
+        })
+      , options
+    );
+  }
+
+  /**
+   * Create a boost on a recording
+   * @param recordingId - The recording ID
+   * @param req - Recording_boost creation parameters
+   * @returns The recording_boost
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.boosts.createForRecording(123, { content: "Hello world" });
+   * ```
+   */
+  async createForRecording(recordingId: number, req: CreateForRecordingBoostRequest): Promise<components["schemas"]["CreateRecordingBoostResponseContent"]> {
+    if (!req.content) {
+      throw Errors.validation("Content is required");
+    }
+    const response = await this.request(
+      {
+        service: "Boosts",
+        operation: "CreateRecordingBoost",
+        resourceType: "recording_boost",
+        isMutation: true,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.POST("/recordings/{recordingId}/boosts.json", {
+          params: {
+            path: { recordingId },
+          },
+          body: {
+            content: req.content,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * List boosts on a specific event within a recording
+   * @param recordingId - The recording ID
+   * @param eventId - The event ID
+   * @param options - Optional query parameters
+   * @returns All results across all pages, with .meta.totalCount
+   *
+   * @example
+   * ```ts
+   * const result = await client.boosts.listForEvent(123, 123);
+   * ```
+   */
+  async listForEvent(recordingId: number, eventId: number, options?: ListForEventBoostOptions): Promise<components["schemas"]["ListEventBoostsResponseContent"]> {
+    return this.requestPaginated(
+      {
+        service: "Boosts",
+        operation: "ListEventBoosts",
+        resourceType: "event_boost",
+        isMutation: false,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.GET("/recordings/{recordingId}/events/{eventId}/boosts.json", {
+          params: {
+            path: { recordingId, eventId },
+          },
+        })
+      , options
+    );
+  }
+
+  /**
+   * Create a boost on a specific event within a recording
+   * @param recordingId - The recording ID
+   * @param eventId - The event ID
+   * @param req - Event_boost creation parameters
+   * @returns The event_boost
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.boosts.createForEvent(123, 123, { content: "Hello world" });
+   * ```
+   */
+  async createForEvent(recordingId: number, eventId: number, req: CreateForEventBoostRequest): Promise<components["schemas"]["CreateEventBoostResponseContent"]> {
+    if (!req.content) {
+      throw Errors.validation("Content is required");
+    }
+    const response = await this.request(
+      {
+        service: "Boosts",
+        operation: "CreateEventBoost",
+        resourceType: "event_boost",
+        isMutation: true,
+        resourceId: recordingId,
+      },
+      () =>
+        this.client.POST("/recordings/{recordingId}/events/{eventId}/boosts.json", {
+          params: {
+            path: { recordingId, eventId },
+          },
+          body: {
+            content: req.content,
+          },
+        })
+    );
+    return response;
+  }
+}