@37signals/basecamp 0.18.0 → 0.20.0

package/src/generated/services/event-feed.ts

@@ -0,0 +1,153 @@
+/**
+ * EventFeed 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
+// =============================================================================
+
+
+/**
+ * Options for pollEvents.
+ */
+export interface PollEventsEventFeedOptions {
+  /** Entry point: a decimal event id (start after it; `0` replays served
+history back to the epoch), or the literal `now` (skip history). Mutually
+exclusive with `position` in practice; omit both to enter at the present. */
+  since?: string;
+  /** Resume token from a previous page's `position`. Opaque and signed; never
+constructed or parsed client-side. */
+  position?: string;
+  /** Comma-separated event types from the catalog (e.g. `message.created,comment.created`). */
+  types?: string;
+  /** Comma-separated bucket (project) ids, at most 100. */
+  buckets?: string;
+  /** Comma-separated creator person ids, at most 100. */
+  creators?: string;
+  /** Comma-separated effective-performer ids (the agent on a delegated action,
+else the creator), at most 100. The literal `self` means the request's own
+effective actor and is resolved server-side before filtering. */
+  performers?: string;
+  /** Comma-separated effective-performer ids to exclude, at most 100; `self`
+as on `performers`. `exclude_performers=self` is the loop guard for an
+agent that acts on what it hears. */
+  excludePerformers?: string;
+  /** Comma-separated actor kinds: `agent`, `person`, or both. A filter, not a
+default — agent activity is real account activity. */
+  actorTypes?: string;
+}
+
+/**
+ * Options for pollInbox.
+ */
+export interface PollInboxEventFeedOptions {
+  /** Entry point: `0` (earliest retained), `now` (present), or a decimal item
+id to start after. */
+  since?: string;
+  /** Resume token from a previous inbox page's `position`. */
+  position?: string;
+  /** Comma-separated addressing reasons: `mentioned`, `assigned`, `subscribed`,
+`watched`, `pinged`, `boosted`. */
+  reasons?: string;
+  /** Comma-separated event types, as a narrowing filter. */
+  types?: string;
+  /** Comma-separated bucket ids, as a narrowing filter (at most 100). */
+  buckets?: string;
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for EventFeed operations.
+ */
+export class EventFeedService extends BaseService {
+
+  /**
+   * Poll the account event feed for events after a position (oldest first, strict event-id order, up to 100 per page).
+   * @param options - Optional query parameters
+   * @returns The feed_event
+   *
+   * @example
+   * ```ts
+   * const result = await client.eventFeed.pollEvents();
+   * ```
+   */
+  async pollEvents(options?: PollEventsEventFeedOptions): Promise<components["schemas"]["PollEventsResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "EventFeed",
+        operation: "PollEvents",
+        resourceType: "feed_event",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/events.json", {
+          params: {
+            query: { since: options?.since, position: options?.position, types: options?.types, buckets: options?.buckets, creators: options?.creators, performers: options?.performers, "exclude_performers": options?.excludePerformers, "actor_types": options?.actorTypes },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Mint a short-lived stream ticket and the exact WebSocket URL to open a live event stream with.
+   * @returns The stream_ticket
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.eventFeed.createStreamTicket();
+   * ```
+   */
+  async createStreamTicket(): Promise<components["schemas"]["CreateStreamTicketResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "EventFeed",
+        operation: "CreateStreamTicket",
+        resourceType: "stream_ticket",
+        isMutation: true,
+      },
+      () =>
+        this.client.POST("/events/stream_ticket.json", {
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Poll the authenticated agent's inbox for the items that addressed it (oldest first, strict item-id order); people receive 403.
+   * @param options - Optional query parameters
+   * @returns The inbox_item
+   *
+   * @example
+   * ```ts
+   * const result = await client.eventFeed.pollInbox();
+   * ```
+   */
+  async pollInbox(options?: PollInboxEventFeedOptions): Promise<components["schemas"]["PollInboxResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "EventFeed",
+        operation: "PollInbox",
+        resourceType: "inbox_item",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/inbox.json", {
+          params: {
+            query: { since: options?.since, position: options?.position, reasons: options?.reasons, types: options?.types, buckets: options?.buckets },
+          },
+        })
+    );
+    return response;
+  }
+}

package/src/generated/services/gauges.ts

@@ -20,7 +20,7 @@ import { Errors } from "../../errors.js";
  */
 export interface UpdateGaugeNeedleGaugeRequest {
   /** Gauge needle */
-  gaugeNeedle?: components["schemas"]["GaugeNeedleUpdatePayload"];
+  gaugeNeedle: components["schemas"]["GaugeNeedleUpdatePayload"];
 }
 
 /**
@@ -45,7 +45,11 @@ export interface ListGaugeNeedlesGaugeOptions extends PaginationOptions {
 export interface CreateGaugeNeedleGaugeRequest {
   /** Gauge needle */
   gaugeNeedle: components["schemas"]["GaugeNeedlePayload"];
-  /** Who to notify: "everyone", "working_on", "custom", or omit for nobody */
+  /** Who to notify: "everyone", "default" (the project's existing
+subscribers), or "custom" (the people in `subscriptions`). Omit for
+nobody: bc3 defaults `notify` to "custom", which with no `subscriptions`
+notifies no one, and any unrecognized value (`Subscribers#find_subscribers`
+accepts exactly these three) falls through to nobody as well. */
   notify?: string;
   /** Array of people IDs to notify (only used when notify is "custom") */
   subscriptions?: number[];
@@ -110,10 +114,13 @@ export class GaugesService extends BaseService {
    *
    * @example
    * ```ts
-   * const result = await client.gauges.updateGaugeNeedle(123, { });
+   * const result = await client.gauges.updateGaugeNeedle(123, { gaugeNeedle: { description: "Details here" } });
    * ```
    */
   async updateGaugeNeedle(needleId: number, req: UpdateGaugeNeedleGaugeRequest): Promise<components["schemas"]["UpdateGaugeNeedleResponseContent"]> {
+    if (!req.gaugeNeedle) {
+      throw Errors.validation("Gauge needle is required");
+    }
     const response = await this.request(
       {
         service: "Gauges",

package/src/generated/services/index.ts

@@ -21,9 +21,9 @@ export { EverythingService } from "./everything.js";
 export { PeopleService } from "./people.js";
 export { CommentsService } from "./comments.js";
 export { DocumentsService } from "./documents.js";
+export { EventFeedService } from "./event-feed.js";
 export { GaugesService } from "./gauges.js";
 export { ForwardsService } from "./forwards.js";
-export { AutomationService } from "./automation.js";
 export { LineupService } from "./lineup.js";
 export { MessageBoardsService } from "./message-boards.js";
 export { MessagesService } from "./messages.js";

package/src/generated/services/lineup.ts

@@ -12,6 +12,8 @@ import { Errors } from "../../errors.js";
 // Types
 // =============================================================================
 
+/** LineupMarker entity from the Basecamp API. */
+export type LineupMarker = components["schemas"]["LineupMarker"];
 
 /**
  * Request parameters for create.
@@ -43,6 +45,30 @@ export interface UpdateLineupRequest {
  */
 export class LineupService extends BaseService {
 
+  /**
+   * List all lineup markers for the account
+   * @returns Array of LineupMarker
+   *
+   * @example
+   * ```ts
+   * const result = await client.lineup.listLineupMarkers();
+   * ```
+   */
+  async listLineupMarkers(): Promise<LineupMarker[]> {
+    const response = await this.request(
+      {
+        service: "Lineup",
+        operation: "ListLineupMarkers",
+        resourceType: "lineup_marker",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/lineup/markers.json", {
+        })
+    );
+    return response ?? [];
+  }
+
   /**
    * Create a new lineup marker
    * @param req - Lineup_marker creation parameters

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

@@ -1,25 +0,0 @@
-/**
- * Automation 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";
-/** LineupMarker entity from the Basecamp API. */
-export type LineupMarker = components["schemas"]["LineupMarker"];
-/**
- * Service for Automation operations.
- */
-export declare class AutomationService extends BaseService {
-    /**
-     * List all lineup markers for the account
-     * @returns Array of LineupMarker
-     *
-     * @example
-     * ```ts
-     * const result = await client.automation.listLineupMarkers();
-     * ```
-     */
-    listLineupMarkers(): Promise<LineupMarker[]>;
-}
-//# sourceMappingURL=automation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../../src/generated/services/automation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;AAMjE;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAEhD;;;;;;;;OAQG;IACG,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAcnD"}

package/dist/generated/services/automation.js

@@ -1,33 +0,0 @@
-/**
- * Automation service for the Basecamp API.
- *
- * @generated from OpenAPI spec - do not edit directly
- */
-import { BaseService } from "../../services/base.js";
-// =============================================================================
-// Service
-// =============================================================================
-/**
- * Service for Automation operations.
- */
-export class AutomationService extends BaseService {
-    /**
-     * List all lineup markers for the account
-     * @returns Array of LineupMarker
-     *
-     * @example
-     * ```ts
-     * const result = await client.automation.listLineupMarkers();
-     * ```
-     */
-    async listLineupMarkers() {
-        const response = await this.request({
-            service: "Automation",
-            operation: "ListLineupMarkers",
-            resourceType: "lineup_marker",
-            isMutation: false,
-        }, () => this.client.GET("/lineup/markers.json", {}));
-        return response ?? [];
-    }
-}
-//# sourceMappingURL=automation.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../../src/generated/services/automation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAUrD,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAEhD;;;;;;;;OAQG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,YAAY;YACrB,SAAS,EAAE,mBAAmB;YAC9B,YAAY,EAAE,eAAe;YAC7B,UAAU,EAAE,KAAK;SAClB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,EACvC,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,IAAI,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/generated/services/automation.ts

@@ -1,49 +0,0 @@
-/**
- * Automation 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
-// =============================================================================
-
-/** LineupMarker entity from the Basecamp API. */
-export type LineupMarker = components["schemas"]["LineupMarker"];
-
-// =============================================================================
-// Service
-// =============================================================================
-
-/**
- * Service for Automation operations.
- */
-export class AutomationService extends BaseService {
-
-  /**
-   * List all lineup markers for the account
-   * @returns Array of LineupMarker
-   *
-   * @example
-   * ```ts
-   * const result = await client.automation.listLineupMarkers();
-   * ```
-   */
-  async listLineupMarkers(): Promise<LineupMarker[]> {
-    const response = await this.request(
-      {
-        service: "Automation",
-        operation: "ListLineupMarkers",
-        resourceType: "lineup_marker",
-        isMutation: false,
-      },
-      () =>
-        this.client.GET("/lineup/markers.json", {
-        })
-    );
-    return response ?? [];
-  }
-}

package/src/generated/services/automation.ts

@@ -1,49 +0,0 @@
-/**
- * Automation 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
-// =============================================================================
-
-/** LineupMarker entity from the Basecamp API. */
-export type LineupMarker = components["schemas"]["LineupMarker"];
-
-// =============================================================================
-// Service
-// =============================================================================
-
-/**
- * Service for Automation operations.
- */
-export class AutomationService extends BaseService {
-
-  /**
-   * List all lineup markers for the account
-   * @returns Array of LineupMarker
-   *
-   * @example
-   * ```ts
-   * const result = await client.automation.listLineupMarkers();
-   * ```
-   */
-  async listLineupMarkers(): Promise<LineupMarker[]> {
-    const response = await this.request(
-      {
-        service: "Automation",
-        operation: "ListLineupMarkers",
-        resourceType: "lineup_marker",
-        isMutation: false,
-      },
-      () =>
-        this.client.GET("/lineup/markers.json", {
-        })
-    );
-    return response ?? [];
-  }
-}