@stigg/typescript 0.1.0-beta.57 → 0.1.0-beta.58

package/resources/v2/usage.d.ts

@@ -0,0 +1,284 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Operations related to usage & metering
+ */
+export declare class Usage extends APIResource {
+    /**
+     * Reports usage measurements for metered features. The reported usage is used to
+     * track, limit, and bill customer consumption. Credit balances are returned once
+     * per wallet in `credits`, not on each measurement.
+     */
+    report(params: UsageReportParams, options?: RequestOptions): APIPromise<UsageReportResponse>;
+}
+/**
+ * Response containing reported usage measurements with current usage values,
+ * period information and reset dates, plus the balance of each credit wallet they
+ * drew from.
+ */
+export interface UsageReportResponse {
+    /**
+     * Reported usage measurements and the credit balances they drew from
+     */
+    data: UsageReportResponse.Data;
+}
+export declare namespace UsageReportResponse {
+    /**
+     * Reported usage measurements and the credit balances they drew from
+     */
+    interface Data {
+        /**
+         * Usage measurements, in request order, with current values and period info
+         */
+        usages: Array<Data.Usage>;
+        /**
+         * The balance of each credit wallet the request drew from. Omitted when no
+         * reported feature consumes credits, or when credit balances aren't computed
+         * synchronously for the environment; each usage's `credit` is then `null`.
+         */
+        credits?: Array<Data.Credit>;
+        /**
+         * The current usage of each governance entitlement this request counted towards.
+         * Absent when governance is not enabled or the usage is unknown. Entitlements
+         * whose usage could not be read, and those of repeated idempotent requests, are
+         * left out
+         */
+        entities?: Array<Data.Entity>;
+    }
+    namespace Data {
+        /**
+         * Recorded usage with period info and the credits it deducted
+         */
+        interface Usage {
+            /**
+             * Unique identifier for the entity
+             */
+            id: string;
+            /**
+             * Timestamp of when the record was created
+             */
+            createdAt: string;
+            /**
+             * Customer id
+             */
+            customerId: string;
+            /**
+             * Feature id
+             */
+            featureId: string;
+            /**
+             * Timestamp
+             */
+            timestamp: string;
+            /**
+             * The usage measurement record
+             */
+            value: number;
+            /**
+             * The credits this measurement deducted. `null` when the measurement drew from no
+             * wallet listed in `credits`. The balance of the wallet it drew from is in the
+             * response `credits` list, matched by customer, resource and currency.
+             */
+            credit?: Usage.Credit | null;
+            /**
+             * The current measured usage value
+             */
+            currentUsage?: number | null;
+            /**
+             * The date when the next usage reset will occur
+             */
+            nextResetDate?: string | null;
+            /**
+             * The customer resource this usage applies to. Optional — only required if the
+             * customer has multiple resources (for example, one subscription per workspace or
+             * site) and usage needs to be tracked separately per resource; omit it to report
+             * usage at the customer level.
+             */
+            resourceId?: string | null;
+            /**
+             * The end date of the usage period in which this measurement resides (for
+             * entitlements with a reset period)
+             */
+            usagePeriodEnd?: string | null;
+            /**
+             * The start date of the usage period in which this measurement resides (for
+             * entitlements with a reset period)
+             */
+            usagePeriodStart?: string | null;
+        }
+        namespace Usage {
+            /**
+             * The credits this measurement deducted. `null` when the measurement drew from no
+             * wallet listed in `credits`. The balance of the wallet it drew from is in the
+             * response `credits` list, matched by customer, resource and currency.
+             */
+            interface Credit {
+                /**
+                 * The credits this single reportUsage call deducted, in credit units — scoped to
+                 * this one measurement (0 for idempotency duplicates). Contrast `currentUsage`,
+                 * which is the wallet-wide running total shared across all features on this
+                 * currency. Use it to reconcile expected per-call deductions.
+                 */
+                consumed: number;
+                /**
+                 * The credit currency identifier
+                 */
+                currencyId: string;
+            }
+        }
+        /**
+         * Optimistic credit balance of one wallet (customer, resource and currency) after
+         * the request, listed once however many measurements drew from it
+         */
+        interface Credit {
+            /**
+             * The credit currency identifier
+             */
+            currencyId: string;
+            /**
+             * The wallet's total consumed credits for this currency (optimistic — includes
+             * not-yet-reconciled usage), shared across every feature that draws on the
+             * currency. This is the running balance, not this call's deduction — see
+             * `consumed` for that.
+             */
+            currentUsage: number;
+            /**
+             * Customer id
+             */
+            customerId: string;
+            /**
+             * The wallet's resource; `null` for the customer-level wallet
+             */
+            resourceId: string | null;
+            /**
+             * The grant-version timestamp of this balance, used by the SDK for last-write-wins
+             * reconciliation
+             */
+            timestamp: string;
+            /**
+             * The total credits granted
+             */
+            usageLimit: number;
+            /**
+             * End of the current credit grant period (when recurring credits reset), if
+             * applicable
+             */
+            usagePeriodEnd?: string | null;
+        }
+        /**
+         * The usage counted against one governance entitlement
+         */
+        interface Entity {
+            /**
+             * The absolute usage counted against the entitlement
+             */
+            currentUsage: number;
+            /**
+             * The customer whose usage counted towards the entitlement
+             */
+            customerId: string;
+            /**
+             * The governance entitlement the usage counts towards
+             */
+            entitlementId: string;
+            /**
+             * The governance entity the entitlement belongs to
+             */
+            entityId: string;
+            /**
+             * The customer resource the usage counted from; `null` for customer-level usage
+             */
+            resourceId: string | null;
+            /**
+             * The entities the entitlement is scoped to (empty when it is not scoped)
+             */
+            scopeEntityIds: Array<string>;
+            /**
+             * When the entitlement usage was last updated
+             */
+            usageUpdatedAt: string;
+            /**
+             * The credit currency the entitlement governs (exactly one of featureId and
+             * currencyId is set)
+             */
+            currencyId?: string;
+            /**
+             * The feature the entitlement governs (exactly one of featureId and currencyId is
+             * set)
+             */
+            featureId?: string;
+        }
+    }
+}
+export interface UsageReportParams {
+    /**
+     * Body param: A list of usage reports to be submitted in bulk
+     */
+    usages: Array<UsageReportParams.Usage>;
+    /**
+     * Header param: Account ID — optional when authenticating with a user JWT (Bearer
+     * token); falls back to the user's first membership. Ignored for API-key auth.
+     */
+    'X-ACCOUNT-ID'?: string;
+    /**
+     * Header param: Environment ID — required when authenticating with a user JWT
+     * (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is
+     * intrinsic to the key).
+     */
+    'X-ENVIRONMENT-ID'?: string;
+}
+export declare namespace UsageReportParams {
+    /**
+     * Single usage measurement
+     */
+    interface Usage {
+        /**
+         * Customer id
+         */
+        customerId: string;
+        /**
+         * Feature id
+         */
+        featureId: string;
+        /**
+         * The value to report for usage. Must be a whole number — the REST API does not
+         * accept fractional (float) usage values; scale up (e.g. report cents instead of
+         * dollars, or milliseconds instead of seconds) if you need sub-unit precision.
+         */
+        value: number;
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt?: string;
+        /**
+         * Additional dimensions for the usage report
+         */
+        dimensions?: {
+            [key: string]: string | number | boolean;
+        };
+        /**
+         * A key you provide to safely retry the same usage report without double-counting
+         * it. Reports with a previously-seen idempotency key are deduplicated for 7 days;
+         * after that window a retry is treated as new usage.
+         */
+        idempotencyKey?: string;
+        /**
+         * The customer resource this usage applies to. Optional — only required if the
+         * customer has multiple resources (for example, one subscription per workspace or
+         * site) and usage needs to be tracked separately per resource; omit it to report
+         * usage at the customer level.
+         */
+        resourceId?: string | null;
+        /**
+         * How the reported value is applied: DELTA (default) adds it to the feature's
+         * current usage; SET treats it as the new absolute usage total, and Stigg computes
+         * the delta internally.
+         */
+        updateBehavior?: 'DELTA' | 'SET';
+    }
+}
+export declare namespace Usage {
+    export { type UsageReportResponse as UsageReportResponse, type UsageReportParams as UsageReportParams };
+}
+//# sourceMappingURL=usage.d.ts.map

package/resources/v2/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/v2/usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAEhE;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAc7F;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC;CAChC;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1B;;;;WAIG;QACH,OAAO,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7B;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;KAC/B;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,KAAK;YACpB;;eAEG;YACH,EAAE,EAAE,MAAM,CAAC;YAEX;;eAEG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;eAEG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,KAAK,EAAE,MAAM,CAAC;YAEd;;;;eAIG;YACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YAE7B;;eAEG;YACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAE7B;;eAEG;YACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAE9B;;;;;eAKG;YACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAE3B;;;eAGG;YACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAE/B;;;eAGG;YACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAClC;QAED,UAAiB,KAAK,CAAC;YACrB;;;;eAIG;YACH,UAAiB,MAAM;gBACrB;;;;;mBAKG;gBACH,QAAQ,EAAE,MAAM,CAAC;gBAEjB;;mBAEG;gBACH,UAAU,EAAE,MAAM,CAAC;aACpB;SACF;QAED;;;WAGG;QACH,UAAiB,MAAM;YACrB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;;;;eAKG;YACH,YAAY,EAAE,MAAM,CAAC;YAErB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;eAEG;YACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;YAE1B;;;eAGG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;;eAGG;YACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAChC;QAED;;WAEG;QACH,UAAiB,MAAM;YACrB;;eAEG;YACH,YAAY,EAAE,MAAM,CAAC;YAErB;;eAEG;YACH,UAAU,EAAE,MAAM,CAAC;YAEnB;;eAEG;YACH,aAAa,EAAE,MAAM,CAAC;YAEtB;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;YAEjB;;eAEG;YACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;YAE1B;;eAEG;YACH,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAE9B;;eAEG;YACH,cAAc,EAAE,MAAM,CAAC;YAEvB;;;eAGG;YACH,UAAU,CAAC,EAAE,MAAM,CAAC;YAEpB;;;eAGG;YACH,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB;KACF;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAEvC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,yBAAiB,iBAAiB,CAAC;IACjC;;OAEG;IACH,UAAiB,KAAK;QACpB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;;;WAIG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,UAAU,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAE1D;;;;WAIG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB;;;;;WAKG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;;;WAIG;QACH,cAAc,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;KAClC;CACF;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,KAAK,iBAAiB,IAAI,iBAAiB,EAAE,CAAC;CACzG"}

package/resources/v2/usage.js

@@ -0,0 +1,32 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Usage = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+/**
+ * Operations related to usage & metering
+ */
+class Usage extends resource_1.APIResource {
+    /**
+     * Reports usage measurements for metered features. The reported usage is used to
+     * track, limit, and bill customer consumption. Credit balances are returned once
+     * per wallet in `credits`, not on each measurement.
+     */
+    report(params, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+        return this._client.post('/api/v2/usage', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Usage = Usage;
+//# sourceMappingURL=usage.js.map

package/resources/v2/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/v2/usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAGtD;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;OAIG;IACH,MAAM,CAAC,MAAyB,EAAE,OAAwB;QACxD,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;YACxC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB;oBACE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBACpE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACjF;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AApBD,sBAoBC"}

package/resources/v2/usage.mjs

@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+/**
+ * Operations related to usage & metering
+ */
+export class Usage extends APIResource {
+    /**
+     * Reports usage measurements for metered features. The reported usage is used to
+     * track, limit, and bill customer consumption. Credit balances are returned once
+     * per wallet in `credits`, not on each measurement.
+     */
+    report(params, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+        return this._client.post('/api/v2/usage', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=usage.mjs.map

package/resources/v2/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","sourceRoot":"","sources":["../../src/resources/v2/usage.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAGtD;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;OAIG;IACH,MAAM,CAAC,MAAyB,EAAE,OAAwB;QACxD,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;YACxC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB;oBACE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBACpE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACjF;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/v2/v2.d.mts

@@ -0,0 +1,10 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as UsageAPI from "./usage.mjs";
+import { Usage, UsageReportParams, UsageReportResponse } from "./usage.mjs";
+export declare class V2 extends APIResource {
+    usage: UsageAPI.Usage;
+}
+export declare namespace V2 {
+    export { Usage as Usage, type UsageReportResponse as UsageReportResponse, type UsageReportParams as UsageReportParams, };
+}
+//# sourceMappingURL=v2.d.mts.map

package/resources/v2/v2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.d.mts","sourceRoot":"","sources":["../../src/resources/v2/v2.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,QAAQ,oBAAgB;AACpC,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,oBAAgB;AAExE,qBAAa,EAAG,SAAQ,WAAW;IACjC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAoC;CAC1D;AAID,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,OAAO,EACL,KAAK,IAAI,KAAK,EACd,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}

package/resources/v2/v2.d.ts

@@ -0,0 +1,10 @@
+import { APIResource } from "../../core/resource.js";
+import * as UsageAPI from "./usage.js";
+import { Usage, UsageReportParams, UsageReportResponse } from "./usage.js";
+export declare class V2 extends APIResource {
+    usage: UsageAPI.Usage;
+}
+export declare namespace V2 {
+    export { Usage as Usage, type UsageReportResponse as UsageReportResponse, type UsageReportParams as UsageReportParams, };
+}
+//# sourceMappingURL=v2.d.ts.map

package/resources/v2/v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../../src/resources/v2/v2.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,QAAQ,mBAAgB;AACpC,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAgB;AAExE,qBAAa,EAAG,SAAQ,WAAW;IACjC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAoC;CAC1D;AAID,MAAM,CAAC,OAAO,WAAW,EAAE,CAAC;IAC1B,OAAO,EACL,KAAK,IAAI,KAAK,EACd,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}

package/resources/v2/v2.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V2 = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const UsageAPI = tslib_1.__importStar(require("./usage.js"));
+const usage_1 = require("./usage.js");
+class V2 extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.usage = new UsageAPI.Usage(this._client);
+    }
+}
+exports.V2 = V2;
+V2.Usage = usage_1.Usage;
+//# sourceMappingURL=v2.js.map

package/resources/v2/v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.js","sourceRoot":"","sources":["../../src/resources/v2/v2.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6DAAoC;AACpC,sCAAwE;AAExE,MAAa,EAAG,SAAQ,sBAAW;IAAnC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;CAAA;AAFD,gBAEC;AAED,EAAE,CAAC,KAAK,GAAG,aAAK,CAAC"}

package/resources/v2/v2.mjs

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as UsageAPI from "./usage.mjs";
+import { Usage } from "./usage.mjs";
+export class V2 extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.usage = new UsageAPI.Usage(this._client);
+    }
+}
+V2.Usage = Usage;
+//# sourceMappingURL=v2.mjs.map

package/resources/v2/v2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.mjs","sourceRoot":"","sources":["../../src/resources/v2/v2.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,QAAQ,oBAAgB;AACpC,OAAO,EAAE,KAAK,EAA0C,oBAAgB;AAExE,MAAM,OAAO,EAAG,SAAQ,WAAW;IAAnC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;CAAA;AAED,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC"}

package/resources/v2.d.mts

@@ -0,0 +1,2 @@
+export * from "./v2/index.mjs";
+//# sourceMappingURL=v2.d.mts.map

package/resources/v2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.d.mts","sourceRoot":"","sources":["../src/resources/v2.ts"],"names":[],"mappings":"AAEA,+BAA2B"}

package/resources/v2.d.ts

@@ -0,0 +1,2 @@
+export * from "./v2/index.js";
+//# sourceMappingURL=v2.d.ts.map

package/resources/v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../src/resources/v2.ts"],"names":[],"mappings":"AAEA,8BAA2B"}

package/resources/v2.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./v2/index.js"), exports);
+//# sourceMappingURL=v2.js.map

package/resources/v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.js","sourceRoot":"","sources":["../src/resources/v2.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAA2B"}

package/resources/v2.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./v2/index.mjs";
+//# sourceMappingURL=v2.mjs.map

package/resources/v2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.mjs","sourceRoot":"","sources":["../src/resources/v2.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,+BAA2B"}

package/src/client.ts

@@ -21,6 +21,7 @@ import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
 import { V1Beta } from './resources/v1-beta/v1-beta';
 import { V1 } from './resources/v1/v1';
+import { V2 } from './resources/v2/v2';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -764,10 +765,12 @@ export class Stigg {
 
   v1: API.V1 = new API.V1(this);
   v1Beta: API.V1Beta = new API.V1Beta(this);
+  v2: API.V2 = new API.V2(this);
 }
 
 Stigg.V1 = V1;
 Stigg.V1Beta = V1Beta;
+Stigg.V2 = V2;
 
 export declare namespace Stigg {
   export type RequestOptions = Opts.RequestOptions;
@@ -781,4 +784,6 @@ export declare namespace Stigg {
   export { V1 as V1 };
 
   export { V1Beta as V1Beta };
+
+  export { V2 as V2 };
 }

package/src/resources/index.ts

@@ -2,3 +2,4 @@
 
 export { V1 } from './v1/v1';
 export { V1Beta } from './v1-beta/v1-beta';
+export { V2 } from './v2/v2';

package/src/resources/v1/credits/consumption.ts

@@ -92,6 +92,14 @@ export namespace ConsumptionConsumeResponse {
      */
     credit?: Data.Credit | null;
 
+    /**
+     * The current usage of each governance entitlement this request counted towards.
+     * Absent when governance is not enabled or the usage is unknown. Entitlements
+     * whose usage could not be read, and those of repeated idempotent requests, are
+     * left out
+     */
+    entities?: Array<Data.Entity>;
+
     /**
      * The resource the consumption was attributed to
      */
@@ -134,6 +142,58 @@ export namespace ConsumptionConsumeResponse {
        */
       usagePeriodEnd?: string | null;
     }
+
+    /**
+     * The usage counted against one governance entitlement
+     */
+    export interface Entity {
+      /**
+       * The absolute usage counted against the entitlement
+       */
+      currentUsage: number;
+
+      /**
+       * The customer whose usage counted towards the entitlement
+       */
+      customerId: string;
+
+      /**
+       * The governance entitlement the usage counts towards
+       */
+      entitlementId: string;
+
+      /**
+       * The governance entity the entitlement belongs to
+       */
+      entityId: string;
+
+      /**
+       * The customer resource the usage counted from; `null` for customer-level usage
+       */
+      resourceId: string | null;
+
+      /**
+       * The entities the entitlement is scoped to (empty when it is not scoped)
+       */
+      scopeEntityIds: Array<string>;
+
+      /**
+       * When the entitlement usage was last updated
+       */
+      usageUpdatedAt: string;
+
+      /**
+       * The credit currency the entitlement governs (exactly one of featureId and
+       * currencyId is set)
+       */
+      currencyId?: string;
+
+      /**
+       * The feature the entitlement governs (exactly one of featureId and currencyId is
+       * set)
+       */
+      featureId?: string;
+    }
   }
 }
 

package/src/resources/v1/customers/customers.ts

@@ -641,6 +641,12 @@ export namespace CustomerResponse {
        */
       billingId: string | null;
 
+      /**
+       * The card brand of the default payment method, as reported by the billing
+       * provider (e.g. visa, mastercard, amex)
+       */
+      cardBrand: string | null;
+
       /**
        * The expiration month of the default payment method
        */
@@ -660,6 +666,12 @@ export namespace CustomerResponse {
        * The default payment method type
        */
       type: 'CARD' | 'BANK' | 'CASH_APP' | 'PAYPAL' | null;
+
+      /**
+       * The digital wallet used to add the default card payment method, as reported by
+       * the billing provider (e.g. apple_pay, google_pay)
+       */
+      walletType: string | null;
     }
 
     /**
@@ -1239,6 +1251,12 @@ export namespace CustomerListResponse {
      */
     billingId: string | null;
 
+    /**
+     * The card brand of the default payment method, as reported by the billing
+     * provider (e.g. visa, mastercard, amex)
+     */
+    cardBrand: string | null;
+
     /**
      * The expiration month of the default payment method
      */
@@ -1258,6 +1276,12 @@ export namespace CustomerListResponse {
      * The default payment method type
      */
     type: 'CARD' | 'BANK' | 'CASH_APP' | 'PAYPAL' | null;
+
+    /**
+     * The digital wallet used to add the default card payment method, as reported by
+     * the billing provider (e.g. apple_pay, google_pay)
+     */
+    walletType: string | null;
   }
 
   /**

package/src/resources/v1/usage.ts

@@ -54,7 +54,10 @@ export class Usage extends APIResource {
 
   /**
    * Reports usage measurements for metered features. The reported usage is used to
-   * track, limit, and bill customer consumption.
+   * track, limit, and bill customer consumption. Deprecated: use
+   * `POST /api/v2/usage`.
+   *
+   * @deprecated
    */
   report(params: UsageReportParams, options?: RequestOptions): APIPromise<UsageReportResponse> {
     const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;

package/src/resources/v2/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Usage, type UsageReportResponse, type UsageReportParams } from './usage';
+export { V2 } from './v2';