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

package/resources/v2/usage.d.mts

@@ -0,0 +1,284 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * 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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.mts","sourceRoot":"","sources":["../../src/resources/v2/usage.ts"],"names":[],"mappings":"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"}

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":"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"}

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