@37signals/basecamp 0.5.0 → 0.7.0

package/dist/generated/services/forwards.ts

@@ -39,6 +39,10 @@ export interface CreateReplyForwardRequest {
  * Options for list.
  */
 export interface ListForwardOptions extends PaginationOptions {
+  /** Filter by sort */
+  sort?: "created_at" | "updated_at";
+  /** Filter by direction */
+  direction?: "asc" | "desc";
 }
 
 
@@ -167,7 +171,7 @@ export class ForwardsService extends BaseService {
         operation: "GetForwardReply",
         resourceType: "forward_reply",
         isMutation: false,
-        resourceId: forwardId,
+        resourceId: replyId,
       },
       () =>
         this.client.GET("/inbox_forwards/{forwardId}/replies/{replyId}", {
@@ -218,6 +222,9 @@ export class ForwardsService extends BaseService {
    * @example
    * ```ts
    * const result = await client.forwards.list(123);
+   *
+   * // With options
+   * const filtered = await client.forwards.list(123, { sort: "created_at" });
    * ```
    */
   async list(inboxId: number, options?: ListForwardOptions): Promise<ListResult<Forward>> {
@@ -233,6 +240,7 @@ export class ForwardsService extends BaseService {
         this.client.GET("/inboxes/{inboxId}/forwards.json", {
           params: {
             path: { inboxId },
+            query: { sort: options?.sort, direction: options?.direction },
           },
         })
       , options

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

@@ -0,0 +1,140 @@
+/**
+ * Gauges 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 type { PaginationOptions } from "../../pagination.js";
+/**
+ * Request parameters for updateGaugeNeedle.
+ */
+export interface UpdateGaugeNeedleGaugeRequest {
+    /** Gauge needle */
+    gaugeNeedle?: components["schemas"]["GaugeNeedleUpdatePayload"];
+}
+/**
+ * Request parameters for toggleGauge.
+ */
+export interface ToggleGaugeGaugeRequest {
+    /** Gauge */
+    gauge: components["schemas"]["GaugeTogglePayload"];
+}
+/**
+ * Options for listGaugeNeedles.
+ */
+export interface ListGaugeNeedlesGaugeOptions extends PaginationOptions {
+}
+/**
+ * Request parameters for createGaugeNeedle.
+ */
+export interface CreateGaugeNeedleGaugeRequest {
+    /** Gauge needle */
+    gaugeNeedle: components["schemas"]["GaugeNeedlePayload"];
+    /** Who to notify: "everyone", "working_on", "custom", or omit for nobody */
+    notify?: string;
+    /** Array of people IDs to notify (only used when notify is "custom") */
+    subscriptions?: number[];
+}
+/**
+ * Options for listGauges.
+ */
+export interface ListGaugesGaugeOptions extends PaginationOptions {
+    /** Comma-separated list of project IDs. When provided, results are returned
+  in the order specified instead of by risk level. */
+    bucketIds?: string;
+}
+/**
+ * Service for Gauges operations.
+ */
+export declare class GaugesService extends BaseService {
+    /**
+     * Get a gauge needle by ID
+     * @param needleId - The needle ID
+     * @returns The gauge_needle
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.gaugeNeedle(123);
+     * ```
+     */
+    gaugeNeedle(needleId: number): Promise<components["schemas"]["GetGaugeNeedleResponseContent"]>;
+    /**
+     * Update a gauge needle's description. Position and color are immutable.
+     * @param needleId - The needle ID
+     * @param req - Gauge_needle update parameters
+     * @returns The gauge_needle
+     * @throws {BasecampError} If the resource is not found or fields are invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.updateGaugeNeedle(123, { });
+     * ```
+     */
+    updateGaugeNeedle(needleId: number, req: UpdateGaugeNeedleGaugeRequest): Promise<components["schemas"]["UpdateGaugeNeedleResponseContent"]>;
+    /**
+     * Destroy a gauge needle
+     * @param needleId - The needle ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.gauges.destroyGaugeNeedle(123);
+     * ```
+     */
+    destroyGaugeNeedle(needleId: number): Promise<void>;
+    /**
+     * Enable or disable the gauge for a project. Only project admins can toggle gauges.
+     * @param projectId - The project ID
+     * @param req - Resource request parameters
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.gauges.toggleGauge(123, { gauge: "example" });
+     * ```
+     */
+    toggleGauge(projectId: number, req: ToggleGaugeGaugeRequest): Promise<void>;
+    /**
+     * List gauge needles for a project, ordered newest first.
+     * @param projectId - The project ID
+     * @param options - Optional query parameters
+     * @returns All results across all pages, with .meta.totalCount
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.listGaugeNeedles(123);
+     * ```
+     */
+    listGaugeNeedles(projectId: number, options?: ListGaugeNeedlesGaugeOptions): Promise<components["schemas"]["ListGaugeNeedlesResponseContent"]>;
+    /**
+     * Create a gauge needle (progress update) for a project
+     * @param projectId - The project ID
+     * @param req - Gauge_needle creation parameters
+     * @returns The gauge_needle
+     * @throws {BasecampError} If required fields are missing or invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.createGaugeNeedle(123, { gaugeNeedle: "example" });
+     * ```
+     */
+    createGaugeNeedle(projectId: number, req: CreateGaugeNeedleGaugeRequest): Promise<components["schemas"]["CreateGaugeNeedleResponseContent"]>;
+    /**
+     * List gauges across all projects the authenticated user has access to.
+     * @param options - Optional query parameters
+     * @returns All results across all pages, with .meta.totalCount
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.listGauges();
+     *
+     * // With options
+     * const filtered = await client.gauges.listGauges({ bucketIds: "example" });
+     * ```
+     */
+    listGauges(options?: ListGaugesGaugeOptions): Promise<components["schemas"]["ListGaugesResponseContent"]>;
+}
+//# sourceMappingURL=gauges.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gauges.d.ts","sourceRoot":"","sources":["../../../src/generated/services/gauges.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ7D;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,mBAAmB;IACnB,WAAW,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY;IACZ,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,mBAAmB;IACnB,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;IACzD,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D;qDACiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAE5C;;;;;;;;;OASG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,+BAA+B,CAAC,CAAC;IAmBpG;;;;;;;;;;;OAWG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,6BAA6B,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,kCAAkC,CAAC,CAAC;IAsBjJ;;;;;;;;;;OAUG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzD;;;;;;;;;;;OAWG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjF;;;;;;;;;;OAUG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,iCAAiC,CAAC,CAAC;IAmBpJ;;;;;;;;;;;OAWG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,6BAA6B,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,kCAAkC,CAAC,CAAC;IA2BlJ;;;;;;;;;;;;OAYG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,2BAA2B,CAAC,CAAC;CAiBhH"}

package/dist/generated/services/gauges.js

@@ -0,0 +1,207 @@
+/**
+ * Gauges service for the Basecamp API.
+ *
+ * @generated from OpenAPI spec - do not edit directly
+ */
+import { BaseService } from "../../services/base.js";
+import { Errors } from "../../errors.js";
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Service for Gauges operations.
+ */
+export class GaugesService extends BaseService {
+    /**
+     * Get a gauge needle by ID
+     * @param needleId - The needle ID
+     * @returns The gauge_needle
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.gaugeNeedle(123);
+     * ```
+     */
+    async gaugeNeedle(needleId) {
+        const response = await this.request({
+            service: "Gauges",
+            operation: "GetGaugeNeedle",
+            resourceType: "gauge_needle",
+            isMutation: false,
+            resourceId: needleId,
+        }, () => this.client.GET("/gauge_needles/{needleId}", {
+            params: {
+                path: { needleId },
+            },
+        }));
+        return response;
+    }
+    /**
+     * Update a gauge needle's description. Position and color are immutable.
+     * @param needleId - The needle ID
+     * @param req - Gauge_needle update parameters
+     * @returns The gauge_needle
+     * @throws {BasecampError} If the resource is not found or fields are invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.updateGaugeNeedle(123, { });
+     * ```
+     */
+    async updateGaugeNeedle(needleId, req) {
+        const response = await this.request({
+            service: "Gauges",
+            operation: "UpdateGaugeNeedle",
+            resourceType: "gauge_needle",
+            isMutation: true,
+            resourceId: needleId,
+        }, () => this.client.PUT("/gauge_needles/{needleId}", {
+            params: {
+                path: { needleId },
+            },
+            body: {
+                gauge_needle: req.gaugeNeedle,
+            },
+        }));
+        return response;
+    }
+    /**
+     * Destroy a gauge needle
+     * @param needleId - The needle ID
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.gauges.destroyGaugeNeedle(123);
+     * ```
+     */
+    async destroyGaugeNeedle(needleId) {
+        await this.request({
+            service: "Gauges",
+            operation: "DestroyGaugeNeedle",
+            resourceType: "resource",
+            isMutation: true,
+            resourceId: needleId,
+        }, () => this.client.DELETE("/gauge_needles/{needleId}", {
+            params: {
+                path: { needleId },
+            },
+        }));
+    }
+    /**
+     * Enable or disable the gauge for a project. Only project admins can toggle gauges.
+     * @param projectId - The project ID
+     * @param req - Resource request parameters
+     * @returns void
+     * @throws {BasecampError} If the request fails
+     *
+     * @example
+     * ```ts
+     * await client.gauges.toggleGauge(123, { gauge: "example" });
+     * ```
+     */
+    async toggleGauge(projectId, req) {
+        if (!req.gauge) {
+            throw Errors.validation("Gauge is required");
+        }
+        await this.request({
+            service: "Gauges",
+            operation: "ToggleGauge",
+            resourceType: "resource",
+            isMutation: true,
+            projectId,
+        }, () => this.client.PUT("/projects/{projectId}/gauge.json", {
+            params: {
+                path: { projectId },
+            },
+            body: {
+                gauge: req.gauge,
+            },
+        }));
+    }
+    /**
+     * List gauge needles for a project, ordered newest first.
+     * @param projectId - The project ID
+     * @param options - Optional query parameters
+     * @returns All results across all pages, with .meta.totalCount
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.listGaugeNeedles(123);
+     * ```
+     */
+    async listGaugeNeedles(projectId, options) {
+        return this.requestPaginated({
+            service: "Gauges",
+            operation: "ListGaugeNeedles",
+            resourceType: "gauge_needle",
+            isMutation: false,
+            projectId,
+        }, () => this.client.GET("/projects/{projectId}/gauge/needles.json", {
+            params: {
+                path: { projectId },
+            },
+        }), options);
+    }
+    /**
+     * Create a gauge needle (progress update) for a project
+     * @param projectId - The project ID
+     * @param req - Gauge_needle creation parameters
+     * @returns The gauge_needle
+     * @throws {BasecampError} If required fields are missing or invalid
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.createGaugeNeedle(123, { gaugeNeedle: "example" });
+     * ```
+     */
+    async createGaugeNeedle(projectId, req) {
+        if (!req.gaugeNeedle) {
+            throw Errors.validation("Gauge needle is required");
+        }
+        const response = await this.request({
+            service: "Gauges",
+            operation: "CreateGaugeNeedle",
+            resourceType: "gauge_needle",
+            isMutation: true,
+            projectId,
+        }, () => this.client.POST("/projects/{projectId}/gauge/needles.json", {
+            params: {
+                path: { projectId },
+            },
+            body: {
+                gauge_needle: req.gaugeNeedle,
+                notify: req.notify,
+                subscriptions: req.subscriptions,
+            },
+        }));
+        return response;
+    }
+    /**
+     * List gauges across all projects the authenticated user has access to.
+     * @param options - Optional query parameters
+     * @returns All results across all pages, with .meta.totalCount
+     *
+     * @example
+     * ```ts
+     * const result = await client.gauges.listGauges();
+     *
+     * // With options
+     * const filtered = await client.gauges.listGauges({ bucketIds: "example" });
+     * ```
+     */
+    async listGauges(options) {
+        return this.requestPaginated({
+            service: "Gauges",
+            operation: "ListGauges",
+            resourceType: "gauge",
+            isMutation: false,
+        }, () => this.client.GET("/reports/gauges.json", {
+            params: {
+                query: { "bucket_ids": options?.bucketIds },
+            },
+        }), options);
+    }
+}
+//# sourceMappingURL=gauges.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gauges.js","sourceRoot":"","sources":["../../../src/generated/services/gauges.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIrD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAmDzC,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAE5C;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,gBAAgB;YAC3B,YAAY,EAAE,cAAc;YAC5B,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE;YAC3C,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,GAAkC;QAC1E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,mBAAmB;YAC9B,YAAY,EAAE,cAAc;YAC5B,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE;YAC3C,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;YACD,IAAI,EAAE;gBACJ,YAAY,EAAE,GAAG,CAAC,WAAW;aAC9B;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB,CAAC,QAAgB;QACvC,MAAM,IAAI,CAAC,OAAO,CAChB;YACE,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,oBAAoB;YAC/B,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,QAAQ;SACrB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,2BAA2B,EAAE;YAC9C,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC,CACL,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,GAA4B;QAC/D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAChB;YACE,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,aAAa;YACxB,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,IAAI;YAChB,SAAS;SACV,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kCAAkC,EAAE;YAClD,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,SAAS,EAAE;aACpB;YACD,IAAI,EAAE;gBACJ,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB;SACF,CAAC,CACL,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,OAAsC;QAC9E,OAAO,IAAI,CAAC,gBAAgB,CAC1B;YACE,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,kBAAkB;YAC7B,YAAY,EAAE,cAAc;YAC5B,UAAU,EAAE,KAAK;YACjB,SAAS;SACV,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0CAA0C,EAAE;YAC1D,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,SAAS,EAAE;aACpB;SACF,CAAC,EACF,OAAO,CACV,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAiB,EAAE,GAAkC;QAC3E,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,MAAM,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC;YACE,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,mBAAmB;YAC9B,YAAY,EAAE,cAAc;YAC5B,UAAU,EAAE,IAAI;YAChB,SAAS;SACV,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;YAC3D,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE,SAAS,EAAE;aACpB;YACD,IAAI,EAAE;gBACJ,YAAY,EAAE,GAAG,CAAC,WAAW;gBAC7B,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,aAAa,EAAE,GAAG,CAAC,aAAa;aACjC;SACF,CAAC,CACL,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgC;QAC/C,OAAO,IAAI,CAAC,gBAAgB,CAC1B;YACE,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,YAAY;YACvB,YAAY,EAAE,OAAO;YACrB,UAAU,EAAE,KAAK;SAClB,EACD,GAAG,EAAE,CACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE;YACtC,MAAM,EAAE;gBACN,KAAK,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE;aAC5C;SACF,CAAC,EACF,OAAO,CACV,CAAC;IACJ,CAAC;CACF"}

package/dist/generated/services/gauges.ts

@@ -0,0 +1,298 @@
+/**
+ * Gauges 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
+// =============================================================================
+
+
+/**
+ * Request parameters for updateGaugeNeedle.
+ */
+export interface UpdateGaugeNeedleGaugeRequest {
+  /** Gauge needle */
+  gaugeNeedle?: components["schemas"]["GaugeNeedleUpdatePayload"];
+}
+
+/**
+ * Request parameters for toggleGauge.
+ */
+export interface ToggleGaugeGaugeRequest {
+  /** Gauge */
+  gauge: components["schemas"]["GaugeTogglePayload"];
+}
+
+/**
+ * Options for listGaugeNeedles.
+ */
+export interface ListGaugeNeedlesGaugeOptions extends PaginationOptions {
+}
+
+/**
+ * Request parameters for createGaugeNeedle.
+ */
+export interface CreateGaugeNeedleGaugeRequest {
+  /** Gauge needle */
+  gaugeNeedle: components["schemas"]["GaugeNeedlePayload"];
+  /** Who to notify: "everyone", "working_on", "custom", or omit for nobody */
+  notify?: string;
+  /** Array of people IDs to notify (only used when notify is "custom") */
+  subscriptions?: number[];
+}
+
+/**
+ * Options for listGauges.
+ */
+export interface ListGaugesGaugeOptions extends PaginationOptions {
+  /** Comma-separated list of project IDs. When provided, results are returned
+in the order specified instead of by risk level. */
+  bucketIds?: string;
+}
+
+
+// =============================================================================
+// Service
+// =============================================================================
+
+/**
+ * Service for Gauges operations.
+ */
+export class GaugesService extends BaseService {
+
+  /**
+   * Get a gauge needle by ID
+   * @param needleId - The needle ID
+   * @returns The gauge_needle
+   *
+   * @example
+   * ```ts
+   * const result = await client.gauges.gaugeNeedle(123);
+   * ```
+   */
+  async gaugeNeedle(needleId: number): Promise<components["schemas"]["GetGaugeNeedleResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Gauges",
+        operation: "GetGaugeNeedle",
+        resourceType: "gauge_needle",
+        isMutation: false,
+        resourceId: needleId,
+      },
+      () =>
+        this.client.GET("/gauge_needles/{needleId}", {
+          params: {
+            path: { needleId },
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Update a gauge needle's description. Position and color are immutable.
+   * @param needleId - The needle ID
+   * @param req - Gauge_needle update parameters
+   * @returns The gauge_needle
+   * @throws {BasecampError} If the resource is not found or fields are invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.gauges.updateGaugeNeedle(123, { });
+   * ```
+   */
+  async updateGaugeNeedle(needleId: number, req: UpdateGaugeNeedleGaugeRequest): Promise<components["schemas"]["UpdateGaugeNeedleResponseContent"]> {
+    const response = await this.request(
+      {
+        service: "Gauges",
+        operation: "UpdateGaugeNeedle",
+        resourceType: "gauge_needle",
+        isMutation: true,
+        resourceId: needleId,
+      },
+      () =>
+        this.client.PUT("/gauge_needles/{needleId}", {
+          params: {
+            path: { needleId },
+          },
+          body: {
+            gauge_needle: req.gaugeNeedle,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * Destroy a gauge needle
+   * @param needleId - The needle ID
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.gauges.destroyGaugeNeedle(123);
+   * ```
+   */
+  async destroyGaugeNeedle(needleId: number): Promise<void> {
+    await this.request(
+      {
+        service: "Gauges",
+        operation: "DestroyGaugeNeedle",
+        resourceType: "resource",
+        isMutation: true,
+        resourceId: needleId,
+      },
+      () =>
+        this.client.DELETE("/gauge_needles/{needleId}", {
+          params: {
+            path: { needleId },
+          },
+        })
+    );
+  }
+
+  /**
+   * Enable or disable the gauge for a project. Only project admins can toggle gauges.
+   * @param projectId - The project ID
+   * @param req - Resource request parameters
+   * @returns void
+   * @throws {BasecampError} If the request fails
+   *
+   * @example
+   * ```ts
+   * await client.gauges.toggleGauge(123, { gauge: "example" });
+   * ```
+   */
+  async toggleGauge(projectId: number, req: ToggleGaugeGaugeRequest): Promise<void> {
+    if (!req.gauge) {
+      throw Errors.validation("Gauge is required");
+    }
+    await this.request(
+      {
+        service: "Gauges",
+        operation: "ToggleGauge",
+        resourceType: "resource",
+        isMutation: true,
+        projectId,
+      },
+      () =>
+        this.client.PUT("/projects/{projectId}/gauge.json", {
+          params: {
+            path: { projectId },
+          },
+          body: {
+            gauge: req.gauge,
+          },
+        })
+    );
+  }
+
+  /**
+   * List gauge needles for a project, ordered newest first.
+   * @param projectId - The project ID
+   * @param options - Optional query parameters
+   * @returns All results across all pages, with .meta.totalCount
+   *
+   * @example
+   * ```ts
+   * const result = await client.gauges.listGaugeNeedles(123);
+   * ```
+   */
+  async listGaugeNeedles(projectId: number, options?: ListGaugeNeedlesGaugeOptions): Promise<components["schemas"]["ListGaugeNeedlesResponseContent"]> {
+    return this.requestPaginated(
+      {
+        service: "Gauges",
+        operation: "ListGaugeNeedles",
+        resourceType: "gauge_needle",
+        isMutation: false,
+        projectId,
+      },
+      () =>
+        this.client.GET("/projects/{projectId}/gauge/needles.json", {
+          params: {
+            path: { projectId },
+          },
+        })
+      , options
+    );
+  }
+
+  /**
+   * Create a gauge needle (progress update) for a project
+   * @param projectId - The project ID
+   * @param req - Gauge_needle creation parameters
+   * @returns The gauge_needle
+   * @throws {BasecampError} If required fields are missing or invalid
+   *
+   * @example
+   * ```ts
+   * const result = await client.gauges.createGaugeNeedle(123, { gaugeNeedle: "example" });
+   * ```
+   */
+  async createGaugeNeedle(projectId: number, req: CreateGaugeNeedleGaugeRequest): Promise<components["schemas"]["CreateGaugeNeedleResponseContent"]> {
+    if (!req.gaugeNeedle) {
+      throw Errors.validation("Gauge needle is required");
+    }
+    const response = await this.request(
+      {
+        service: "Gauges",
+        operation: "CreateGaugeNeedle",
+        resourceType: "gauge_needle",
+        isMutation: true,
+        projectId,
+      },
+      () =>
+        this.client.POST("/projects/{projectId}/gauge/needles.json", {
+          params: {
+            path: { projectId },
+          },
+          body: {
+            gauge_needle: req.gaugeNeedle,
+            notify: req.notify,
+            subscriptions: req.subscriptions,
+          },
+        })
+    );
+    return response;
+  }
+
+  /**
+   * List gauges across all projects the authenticated user has access to.
+   * @param options - Optional query parameters
+   * @returns All results across all pages, with .meta.totalCount
+   *
+   * @example
+   * ```ts
+   * const result = await client.gauges.listGauges();
+   *
+   * // With options
+   * const filtered = await client.gauges.listGauges({ bucketIds: "example" });
+   * ```
+   */
+  async listGauges(options?: ListGaugesGaugeOptions): Promise<components["schemas"]["ListGaugesResponseContent"]> {
+    return this.requestPaginated(
+      {
+        service: "Gauges",
+        operation: "ListGauges",
+        resourceType: "gauge",
+        isMutation: false,
+      },
+      () =>
+        this.client.GET("/reports/gauges.json", {
+          params: {
+            query: { "bucket_ids": options?.bucketIds },
+          },
+        })
+      , options
+    );
+  }
+}