@37signals/basecamp 0.25.0 → 0.27.0

package/src/generated/services/boosts.ts

@@ -17,6 +17,14 @@ import { Errors } from "../../errors.js";
 /** Boost entity from the Basecamp API. */
 export type Boost = components["schemas"]["Boost"];
 
+/**
+ * Request parameters for update.
+ */
+export interface UpdateBoostRequest {
+  /** Text content */
+  content: string;
+}
+
 /**
  * Options for listForRecording.
  */
@@ -89,6 +97,43 @@ export class BoostsService extends BaseService {
     return response;
   }
 
+  /**
+   * Replace the content of a boost. Only the boost's creator may update it: an
+   * @param boostId - The boost ID
+   * @param req - Boost update parameters
+   * @returns The Boost
+   * @throws {BasecampError} If the resource is not found or fields are invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.boosts.update(123, { content: "Hello world" });
+   * ```
+   */
+  async update(boostId: number, req: UpdateBoostRequest): Promise<Boost> {
+    if (!req.content) {
+      throw Errors.validation("Content is required");
+    }
+    const response = await this.request(
+      {
+        service: "Boosts",
+        operation: "UpdateBoost",
+        resourceType: "boost",
+        isMutation: true,
+        resourceId: boostId,
+      },
+      () =>
+        this.client.PUT("/boosts/{boostId}", {
+          params: {
+            path: { boostId },
+          },
+          body: {
+            content: req.content,
+          },
+        })
+    );
+    return response;
+  }
+
   /**
    * Delete a boost
    * @param boostId - The boost ID

package/src/generated/services/cards.ts

@@ -35,7 +35,8 @@ export interface UpdateVerbatimCardRequest {
  * Request parameters for move.
  */
 export interface MoveCardRequest {
-  /** Column id */
+  /** Any column in the card's project, on this or another card table, or a
+wormhole id to send the card to another project. */
   columnId: number;
   /** 1-indexed position within the destination column. Defaults to 1 (top). */
   position?: number;
@@ -144,7 +145,7 @@ export class CardsService extends BaseService {
   }
 
   /**
-   * Move a card to a different column
+   * Move a card to any column in its project, including on another card table there, or through a linked wormhole to another project (queued: the card gets a new id, and position, if sent, must still be positive but doesn't set placement).
    * @param cardId - The card ID
    * @param req - Card request parameters
    * @returns void

package/src/generated/services/embeds.ts

@@ -0,0 +1,94 @@
+/**
+ * Embeds 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
+// =============================================================================
+
+
+/**
+ * Request parameters for create.
+ */
+export interface CreateEmbedRequest {
+  /** The URL of the content to embed. */
+  url: string;
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Embeds operations.
+ */
+export class EmbedsService extends BaseService {
+
+  /**
+   * Create an embed for a URL, or return the one Basecamp already has for it.
+   * @param req - Embed creation parameters
+   * @returns The embed
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.embeds.create({ url: "example" });
+   * ```
+   */
+  async create(req: CreateEmbedRequest): Promise<components["schemas"]["CreateEmbedResponseContent"]> {
+    if (!req.url) {
+      throw Errors.validation("Url is required");
+    }
+    const response = await this.request(
+      {
+        service: "Embeds",
+        operation: "CreateEmbed",
+        resourceType: "embed",
+        isMutation: true,
+      },
+      () =>
+        this.client.POST("/embeds.json", {
+          body: {
+            url: req.url,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Get an embed by its sgid.
+   * @param sgid - An embed's signed global id, an opaque string.
+   * @returns The embed
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.embeds.get("example");
+   * ```
+   */
+  async get(sgid: string): Promise<components["schemas"]["GetEmbedResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Embeds",
+        operation: "GetEmbed",
+        resourceType: "embed",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/embeds/{sgid}", {
+          params: {
+            path: { sgid },
+          },
+        })
+    );
+    return response;
+  }
+}

package/src/generated/services/index.ts

@@ -19,9 +19,11 @@ export { CardsService } from "./cards.js";
 export { CardStepsService } from "./card-steps.js";
 export { CardTablesService } from "./card-tables.js";
 export { EverythingService } from "./everything.js";
+export { PingsService } from "./pings.js";
 export { PeopleService } from "./people.js";
 export { CommentsService } from "./comments.js";
 export { DocumentsService } from "./documents.js";
+export { EmbedsService } from "./embeds.js";
 export { EventFeedService } from "./event-feed.js";
 export { GaugesService } from "./gauges.js";
 export { ForwardsService } from "./forwards.js";

package/src/generated/services/pings.ts

@@ -0,0 +1,125 @@
+/**
+ * Pings 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
+// =============================================================================
+
+
+/**
+ * Request parameters for create.
+ */
+export interface CreatePingRequest {
+  /** Person ids of the people to ping. People the caller cannot reach are
+dropped. */
+  userIds: number[];
+  /** Create a new group even when a Ping with exactly these people exists. */
+  newGroup?: boolean;
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Pings operations.
+ */
+export class PingsService extends BaseService {
+
+  /**
+   * Get Pings: the caller's active Pings that have a line in them, most
+   * @returns Array of results
+   *
+   * @example
+   * ```ts
+   * const result = await client.pings.list();
+   * ```
+   */
+  async list(): Promise<components["schemas"]["ListPingsResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Pings",
+        operation: "ListPings",
+        resourceType: "ping",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/circles.json", {
+        })
+    );
+    return response ?? [];
+  }
+
+  /**
+   * Create a Ping with people, or return the one that already holds exactly
+   * @param req - Ping creation parameters
+   * @returns The ping
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.pings.create({ userIds: [1234] });
+   * ```
+   */
+  async create(req: CreatePingRequest): Promise<components["schemas"]["CreatePingResponseContent"]> {
+    if (!req.userIds) {
+      throw Errors.validation("User ids is required");
+    }
+    const response = await this.request(
+      {
+        service: "Pings",
+        operation: "CreatePing",
+        resourceType: "ping",
+        isMutation: true,
+      },
+      () =>
+        this.client.POST("/circles.json", {
+          body: {
+            user_ids: req.userIds,
+            new_group: req.newGroup,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Get a Ping by its id, which is its bucket's id.
+   * @param pingId - A Ping's id is the id of the bucket that holds it (the bucket type is
+"Circle", which is also the wire path), so the `bucket.id` a Ping's
+recordings carry is the id GetPing takes.
+   * @returns The ping
+   * @throws {BasecampError} If the resource is not found
+   *
+   * @example
+   * ```ts
+   * const result = await client.pings.get(123);
+   * ```
+   */
+  async get(pingId: number): Promise<components["schemas"]["GetPingResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Pings",
+        operation: "GetPing",
+        resourceType: "ping",
+        isMutation: false,
+        resourceId: pingId,
+      },
+      () =>
+        this.client.GET("/circles/{pingId}", {
+          params: {
+            path: { pingId },
+          },
+        })
+    );
+    return response;
+  }
+}

package/src/generated/services/wormholes.ts

@@ -41,7 +41,7 @@ export interface CreateWormholeRequest {
 export class WormholesService extends BaseService {
 
   /**
-   * Update a wormhole's destination column
+   * Point a card table's wormhole, its shortcut for sending cards to another card table, at a different destination column
    * @param bucketId - The bucket ID
    * @param wormholeId - The wormhole ID
    * @param req - Wormhole update parameters
@@ -77,7 +77,7 @@ export class WormholesService extends BaseService {
   }
 
   /**
-   * Delete a wormhole
+   * Permanently delete a card table's wormhole, the shortcut that sends cards to another card table.
    * @param bucketId - The bucket ID
    * @param wormholeId - The wormhole ID
    * @returns void
@@ -108,7 +108,7 @@ export class WormholesService extends BaseService {
   }
 
   /**
-   * Create a wormhole linking this card table to a column on another card table.
+   * Add a wormhole to a card table: a standing shortcut that sends cards to a column on another card table, usually in another project.
    * @param bucketId - The bucket ID
    * @param cardTableId - The card table ID
    * @param req - Wormhole creation parameters