@37signals/basecamp 0.7.2 → 0.8.0

package/src/generated/services/campfires.ts

@@ -73,6 +73,14 @@ export interface CreateLineCampfireRequest {
   contentType?: string;
 }
 
+/**
+ * Request parameters for updateLine.
+ */
+export interface UpdateLineCampfireRequest {
+  /** The new line content, interpreted as rich text (HTML) */
+  content: string;
+}
+
 /**
  * Options for listUploads.
  */
@@ -420,7 +428,44 @@ export class CampfiresService extends BaseService {
   }
 
   /**
-   * Delete a campfire line
+   * Update an existing campfire line; the content is always treated as rich text (HTML).
+   * @param campfireId - The campfire ID
+   * @param lineId - The line ID
+   * @param req - Campfire_line update parameters
+   * @returns void
+   * @throws {BasecampError} If the resource is not found or fields are invalid
+   *
+   * @example
+   * ```ts
+   * await client.campfires.updateLine(123, 123, { content: "Hello world" });
+   * ```
+   */
+  async updateLine(campfireId: number, lineId: number, req: UpdateLineCampfireRequest): Promise<void> {
+    if (!req.content) {
+      throw Errors.validation("Content is required");
+    }
+    await this.request(
+      {
+        service: "Campfires",
+        operation: "UpdateCampfireLine",
+        resourceType: "campfire_line",
+        isMutation: true,
+        resourceId: lineId,
+      },
+      () =>
+        this.client.PUT("/chats/{campfireId}/lines/{lineId}", {
+          params: {
+            path: { campfireId, lineId },
+          },
+          body: {
+            content: req.content,
+          },
+        })
+    );
+  }
+
+  /**
+   * Delete a campfire line; allowed for the line's creator or an admin.
    * @param campfireId - The campfire ID
    * @param lineId - The line ID
    * @returns void

package/src/generated/services/card-columns.ts

@@ -15,6 +15,14 @@ import { Errors } from "../../errors.js";
 /** CardColumn entity from the Basecamp API. */
 export type CardColumn = components["schemas"]["CardColumn"];
 
+/**
+ * Request parameters for setColor.
+ */
+export interface SetColorCardColumnRequest {
+  /** Valid colors: white, red, orange, yellow, green, blue, aqua, purple, gray, pink, brown */
+  color: string;
+}
+
 /**
  * Request parameters for update.
  */
@@ -25,14 +33,6 @@ export interface UpdateCardColumnRequest {
   description?: string;
 }
 
-/**
- * Request parameters for setColor.
- */
-export interface SetColorCardColumnRequest {
-  /** Valid colors: white, red, orange, yellow, green, blue, aqua, purple, gray, pink, brown */
-  color: string;
-}
-
 /**
  * Request parameters for create.
  */
@@ -66,29 +66,37 @@ export interface MoveCardColumnRequest {
 export class CardColumnsService extends BaseService {
 
   /**
-   * Get a card column by ID
+   * Set the color of a column
+   * @param bucketId - The bucket ID
    * @param columnId - The column ID
+   * @param req - Card_column_color request parameters
    * @returns The CardColumn
-   * @throws {BasecampError} If the resource is not found
+   * @throws {BasecampError} If the request fails
    *
    * @example
    * ```ts
-   * const result = await client.cardColumns.get(123);
+   * const result = await client.cardColumns.setColor(123, 123, { color: "example" });
    * ```
    */
-  async get(columnId: number): Promise<CardColumn> {
+  async setColor(bucketId: number, columnId: number, req: SetColorCardColumnRequest): Promise<CardColumn> {
+    if (!req.color) {
+      throw Errors.validation("Color is required");
+    }
     const response = await this.request(
       {
         service: "CardColumns",
-        operation: "GetCardColumn",
-        resourceType: "card_column",
-        isMutation: false,
+        operation: "SetCardColumnColor",
+        resourceType: "card_column_color",
+        isMutation: true,
         resourceId: columnId,
       },
       () =>
-        this.client.GET("/card_tables/columns/{columnId}", {
+        this.client.PUT("/buckets/{bucketId}/card_tables/columns/{columnId}/color.json", {
           params: {
-            path: { columnId },
+            path: { bucketId, columnId },
+          },
+          body: {
+            color: req.color,
           },
         })
     );
@@ -96,34 +104,30 @@ export class CardColumnsService extends BaseService {
   }
 
   /**
-   * Update an existing column
+   * Enable on-hold section in a column
+   * @param bucketId - The bucket ID
    * @param columnId - The column ID
-   * @param req - Card_column update parameters
    * @returns The CardColumn
-   * @throws {BasecampError} If the resource is not found or fields are invalid
+   * @throws {BasecampError} If the request fails
    *
    * @example
    * ```ts
-   * const result = await client.cardColumns.update(123, { });
+   * const result = await client.cardColumns.enableOnHold(123, 123);
    * ```
    */
-  async update(columnId: number, req: UpdateCardColumnRequest): Promise<CardColumn> {
+  async enableOnHold(bucketId: number, columnId: number): Promise<CardColumn> {
     const response = await this.request(
       {
         service: "CardColumns",
-        operation: "UpdateCardColumn",
-        resourceType: "card_column",
+        operation: "EnableCardColumnOnHold",
+        resourceType: "card_column_on_hold",
         isMutation: true,
         resourceId: columnId,
       },
       () =>
-        this.client.PUT("/card_tables/columns/{columnId}", {
+        this.client.POST("/buckets/{bucketId}/card_tables/columns/{columnId}/on_hold.json", {
           params: {
-            path: { columnId },
-          },
-          body: {
-            title: req.title,
-            description: req.description,
+            path: { bucketId, columnId },
           },
         })
     );
@@ -131,36 +135,30 @@ export class CardColumnsService extends BaseService {
   }
 
   /**
-   * Set the color of a column
+   * Disable on-hold section in a column
+   * @param bucketId - The bucket ID
    * @param columnId - The column ID
-   * @param req - Card_column_color request parameters
    * @returns The CardColumn
    * @throws {BasecampError} If the request fails
    *
    * @example
    * ```ts
-   * const result = await client.cardColumns.setColor(123, { color: "example" });
+   * const result = await client.cardColumns.disableOnHold(123, 123);
    * ```
    */
-  async setColor(columnId: number, req: SetColorCardColumnRequest): Promise<CardColumn> {
-    if (!req.color) {
-      throw Errors.validation("Color is required");
-    }
+  async disableOnHold(bucketId: number, columnId: number): Promise<CardColumn> {
     const response = await this.request(
       {
         service: "CardColumns",
-        operation: "SetCardColumnColor",
-        resourceType: "card_column_color",
+        operation: "DisableCardColumnOnHold",
+        resourceType: "card_column_on_hold",
         isMutation: true,
         resourceId: columnId,
       },
       () =>
-        this.client.PUT("/card_tables/columns/{columnId}/color.json", {
+        this.client.DELETE("/buckets/{bucketId}/card_tables/columns/{columnId}/on_hold.json", {
           params: {
-            path: { columnId },
-          },
-          body: {
-            color: req.color,
+            path: { bucketId, columnId },
           },
         })
     );
@@ -168,27 +166,27 @@ export class CardColumnsService extends BaseService {
   }
 
   /**
-   * Enable on-hold section in a column
+   * Get a card column by ID
    * @param columnId - The column ID
    * @returns The CardColumn
-   * @throws {BasecampError} If the request fails
+   * @throws {BasecampError} If the resource is not found
    *
    * @example
    * ```ts
-   * const result = await client.cardColumns.enableOnHold(123);
+   * const result = await client.cardColumns.get(123);
    * ```
    */
-  async enableOnHold(columnId: number): Promise<CardColumn> {
+  async get(columnId: number): Promise<CardColumn> {
     const response = await this.request(
       {
         service: "CardColumns",
-        operation: "EnableCardColumnOnHold",
-        resourceType: "card_column_on_hold",
-        isMutation: true,
+        operation: "GetCardColumn",
+        resourceType: "card_column",
+        isMutation: false,
         resourceId: columnId,
       },
       () =>
-        this.client.POST("/card_tables/columns/{columnId}/on_hold.json", {
+        this.client.GET("/card_tables/columns/{columnId}", {
           params: {
             path: { columnId },
           },
@@ -198,30 +196,35 @@ export class CardColumnsService extends BaseService {
   }
 
   /**
-   * Disable on-hold section in a column
+   * Update an existing column
    * @param columnId - The column ID
+   * @param req - Card_column update parameters
    * @returns The CardColumn
-   * @throws {BasecampError} If the request fails
+   * @throws {BasecampError} If the resource is not found or fields are invalid
    *
    * @example
    * ```ts
-   * const result = await client.cardColumns.disableOnHold(123);
+   * const result = await client.cardColumns.update(123, { });
    * ```
    */
-  async disableOnHold(columnId: number): Promise<CardColumn> {
+  async update(columnId: number, req: UpdateCardColumnRequest): Promise<CardColumn> {
     const response = await this.request(
       {
         service: "CardColumns",
-        operation: "DisableCardColumnOnHold",
-        resourceType: "card_column_on_hold",
+        operation: "UpdateCardColumn",
+        resourceType: "card_column",
         isMutation: true,
         resourceId: columnId,
       },
       () =>
-        this.client.DELETE("/card_tables/columns/{columnId}/on_hold.json", {
+        this.client.PUT("/card_tables/columns/{columnId}", {
           params: {
             path: { columnId },
           },
+          body: {
+            title: req.title,
+            description: req.description,
+          },
         })
     );
     return response;

package/src/generated/services/index.ts

@@ -1,10 +1,11 @@
 export { AccountService } from "./account.js";
 export { AttachmentsService } from "./attachments.js";
 export { BoostsService } from "./boosts.js";
+export { CardColumnsService } from "./card-columns.js";
+export { ToolsService } from "./tools.js";
 export { WebhooksService } from "./webhooks.js";
 export { CardsService } from "./cards.js";
 export { CardStepsService } from "./card-steps.js";
-export { CardColumnsService } from "./card-columns.js";
 export { CardTablesService } from "./card-tables.js";
 export { MessageTypesService } from "./message-types.js";
 export { CampfiresService } from "./campfires.js";
@@ -13,7 +14,6 @@ export { ClientApprovalsService } from "./client-approvals.js";
 export { ClientCorrespondencesService } from "./client-correspondences.js";
 export { ClientRepliesService } from "./client-replies.js";
 export { CommentsService } from "./comments.js";
-export { ToolsService } from "./tools.js";
 export { DocumentsService } from "./documents.js";
 export { GaugesService } from "./gauges.js";
 export { ForwardsService } from "./forwards.js";

package/src/generated/services/reports.ts

@@ -84,7 +84,7 @@ export class ReportsService extends BaseService {
   }
 
   /**
-   * Get upcoming schedule entries within a date window
+   * Get upcoming schedule entries and assignable items within a date window.
    * @param options - Optional query parameters
    * @returns The upcoming_schedule
    *

package/src/generated/services/todos.ts

@@ -48,11 +48,11 @@ export interface CreateTodoRequest {
 }
 
 /**
- * Request parameters for update.
+ * Request parameters for replace.
  */
-export interface UpdateTodoRequest {
+export interface ReplaceTodoRequest {
   /** Text content */
-  content?: string;
+  content: string;
   /** Rich text description (HTML) */
   description?: string;
   /** Person IDs to assign to */
@@ -201,18 +201,21 @@ export class TodosService extends BaseService {
   }
 
   /**
-   * Update an existing todo
+   * Replace a todo with a new complete representation.
    * @param todoId - The todo ID
-   * @param req - Todo update parameters
+   * @param req - Todo request parameters
    * @returns The Todo
-   * @throws {BasecampError} If the resource is not found or fields are invalid
+   * @throws {BasecampError} If the request fails
    *
    * @example
    * ```ts
-   * const result = await client.todos.update(123, { });
+   * const result = await client.todos.replace(123, { content: "Hello world" });
    * ```
    */
-  async update(todoId: number, req: UpdateTodoRequest): Promise<Todo> {
+  async replace(todoId: number, req: ReplaceTodoRequest): Promise<Todo> {
+    if (!req.content) {
+      throw Errors.validation("Content is required");
+    }
     if (req.dueOn && !/^\d{4}-\d{2}-\d{2}$/.test(req.dueOn)) {
       throw Errors.validation("Due on must be in YYYY-MM-DD format");
     }
@@ -222,7 +225,7 @@ export class TodosService extends BaseService {
     const response = await this.request(
       {
         service: "Todos",
-        operation: "UpdateTodo",
+        operation: "ReplaceTodo",
         resourceType: "todo",
         isMutation: true,
         resourceId: todoId,

package/src/generated/services/tools.ts

@@ -16,12 +16,12 @@ import { Errors } from "../../errors.js";
 export type Tool = components["schemas"]["Tool"];
 
 /**
- * Request parameters for clone.
+ * Request parameters for create.
  */
-export interface CloneToolRequest {
-  /** Source recording id */
-  sourceRecordingId: number;
-  /** Title */
+export interface CreateToolRequest {
+  /** Tool type to add to the project dock. Values: Chat::Transcript|Inbox|Kanban::Board|Message::Board|Questionnaire|Schedule|Todoset|Vault. */
+  toolType: string;
+  /** Title for the new tool. When omitted, Basecamp assigns the next available default title for the tool type. */
   title?: string;
 }
 
@@ -52,28 +52,36 @@ export interface RepositionToolRequest {
 export class ToolsService extends BaseService {
 
   /**
-   * Clone an existing tool to create a new one
-   * @param req - Tool request parameters
+   * Create a tool in a project dock
+   * @param bucketId - The bucket ID
+   * @param req - Tool creation parameters
    * @returns The Tool
-   * @throws {BasecampError} If the request fails
+   * @throws {BasecampError} If required fields are missing or invalid
    *
    * @example
    * ```ts
-   * const result = await client.tools.clone({ sourceRecordingId: 1 });
+   * const result = await client.tools.create(123, { toolType: "example" });
    * ```
    */
-  async clone(req: CloneToolRequest): Promise<Tool> {
+  async create(bucketId: number, req: CreateToolRequest): Promise<Tool> {
+    if (!req.toolType) {
+      throw Errors.validation("Tool type is required");
+    }
     const response = await this.request(
       {
         service: "Tools",
-        operation: "CloneTool",
+        operation: "CreateTool",
         resourceType: "tool",
         isMutation: true,
+        resourceId: bucketId,
       },
       () =>
-        this.client.POST("/dock/tools.json", {
+        this.client.POST("/buckets/{bucketId}/dock/tools.json", {
+          params: {
+            path: { bucketId },
+          },
           body: {
-            source_recording_id: req.sourceRecordingId,
+            tool_type: req.toolType,
             title: req.title,
           },
         })