@stigg/typescript 0.1.0-beta.3 → 0.1.0-beta.31

package/resources/v1-beta/customers/entitlements.d.mts

@@ -0,0 +1,261 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Entitlements extends APIResource {
+    /**
+     * Experimental — request and response shapes may change without notice. Same
+     * semantics as `Check entitlement`, plus an optional `dimensions` query param that
+     * resolves to per-entity governance limits surfaced as `chains` on the response.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.entitlements.check('x');
+     * ```
+     */
+    check(id: string, params?: EntitlementCheckParams | null | undefined, options?: RequestOptions): APIPromise<EntitlementCheckResponse>;
+}
+/**
+ * Response object
+ */
+export interface EntitlementCheckResponse {
+    /**
+     * Feature entitlement with optional governance chains attached.
+     */
+    data: EntitlementCheckResponse.Feature | EntitlementCheckResponse.Credit;
+}
+export declare namespace EntitlementCheckResponse {
+    /**
+     * Feature entitlement with optional governance chains attached.
+     */
+    interface Feature {
+        accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+        isGranted: boolean;
+        type: 'FEATURE';
+        /**
+         * Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+         * was not provided.
+         */
+        chains?: Array<Array<Feature.Chain>>;
+        currentUsage?: number;
+        /**
+         * Timestamp of the last update to the entitlement grant or configuration.
+         */
+        entitlementUpdatedAt?: string;
+        feature?: Feature.Feature;
+        hasUnlimitedUsage?: boolean;
+        resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+        usageLimit?: number | null;
+        /**
+         * The anchor for calculating the usage period for metered entitlements with a
+         * reset period configured
+         */
+        usagePeriodAnchor?: string;
+        /**
+         * The end date of the usage period for metered entitlements with a reset period
+         * configured
+         */
+        usagePeriodEnd?: string;
+        /**
+         * The start date of the usage period for metered entitlements with a reset period
+         * configured
+         */
+        usagePeriodStart?: string;
+        /**
+         * The next time the entitlement should be recalculated
+         */
+        validUntil?: string;
+    }
+    namespace Feature {
+        /**
+         * Per-entity governance node — limit and current usage for a single resolved
+         * entity.
+         */
+        interface Chain {
+            /**
+             * Amount consumed by this entity in the current cadence period.
+             */
+            currentUsage: number;
+            /**
+             * External id of the entity within the customer.
+             */
+            entityId: string;
+            /**
+             * Whether this node alone permits the requested usage.
+             */
+            isGranted: boolean;
+            /**
+             * External ids of the entities this budget is scoped to. Empty (`[]`) is the
+             * node-wide budget; a non-empty set is the dimension-scoped budget that matched
+             * this request — use it to tell apart multiple budgets on the same entity.
+             */
+            scopeEntityIds: Array<string>;
+            /**
+             * Hard usage limit for this node; null when no assignment is configured.
+             */
+            usageLimit: number | null;
+        }
+        interface Feature {
+            /**
+             * The unique reference ID of the entitlement.
+             */
+            id: string;
+            /**
+             * The human-readable name of the entitlement, shown in UI elements.
+             */
+            displayName: string;
+            /**
+             * The current status of the feature.
+             */
+            featureStatus: 'NEW' | 'SUSPENDED' | 'ACTIVE';
+            /**
+             * The type of feature associated with the entitlement.
+             */
+            featureType: 'BOOLEAN' | 'NUMBER' | 'ENUM';
+        }
+    }
+    /**
+     * Credit entitlement with optional governance chains attached.
+     */
+    interface Credit {
+        accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+        /**
+         * The currency associated with a credit entitlement.
+         */
+        currency: Credit.Currency;
+        currentUsage: number;
+        isGranted: boolean;
+        type: 'CREDIT';
+        usageLimit: number;
+        /**
+         * Timestamp of the last update to the credit usage.
+         */
+        usageUpdatedAt: string;
+        /**
+         * Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+         * was not provided.
+         */
+        chains?: Array<Array<Credit.Chain>>;
+        /**
+         * Timestamp of the last update to the entitlement grant or configuration.
+         */
+        entitlementUpdatedAt?: string;
+        /**
+         * The end date of the current billing period for recurring credit grants.
+         */
+        usagePeriodEnd?: string;
+        /**
+         * The next time the entitlement should be recalculated
+         */
+        validUntil?: string;
+    }
+    namespace Credit {
+        /**
+         * The currency associated with a credit entitlement.
+         */
+        interface Currency {
+            /**
+             * The unique identifier of the custom currency.
+             */
+            currencyId: string;
+            /**
+             * The display name of the currency.
+             */
+            displayName: string;
+            /**
+             * A description of the currency.
+             */
+            description?: string | null;
+            /**
+             * Additional metadata associated with the currency.
+             */
+            metadata?: {
+                [key: string]: string;
+            } | null;
+            /**
+             * The plural form of the currency unit.
+             */
+            unitPlural?: string | null;
+            /**
+             * The singular form of the currency unit.
+             */
+            unitSingular?: string | null;
+        }
+        /**
+         * Per-entity governance node — limit and current usage for a single resolved
+         * entity.
+         */
+        interface Chain {
+            /**
+             * Amount consumed by this entity in the current cadence period.
+             */
+            currentUsage: number;
+            /**
+             * External id of the entity within the customer.
+             */
+            entityId: string;
+            /**
+             * Whether this node alone permits the requested usage.
+             */
+            isGranted: boolean;
+            /**
+             * External ids of the entities this budget is scoped to. Empty (`[]`) is the
+             * node-wide budget; a non-empty set is the dimension-scoped budget that matched
+             * this request — use it to tell apart multiple budgets on the same entity.
+             */
+            scopeEntityIds: Array<string>;
+            /**
+             * Hard usage limit for this node; null when no assignment is configured.
+             */
+            usageLimit: number | null;
+        }
+    }
+}
+export interface EntitlementCheckParams {
+    /**
+     * Query param: Currency ID (refId) to check for credit entitlements. Mutually
+     * exclusive with `featureId`.
+     */
+    currencyId?: string;
+    /**
+     * Query param: Optional attribution map (e.g. `dimensions[userId]=u1`). When
+     * provided, the response includes a `chains` array with per-entity governance
+     * limits.
+     */
+    dimensions?: {
+        [key: string]: string;
+    };
+    /**
+     * Query param: Feature ID (refId) to check. Mutually exclusive with `currencyId`.
+     */
+    featureId?: string;
+    /**
+     * Query param: Requested usage amount to evaluate against the entitlement limit
+     * (numeric features only)
+     */
+    requestedUsage?: number;
+    /**
+     * Query param: Requested values to evaluate against allowed values (enum features
+     * only)
+     */
+    requestedValues?: Array<string>;
+    /**
+     * Query param: Resource ID to scope the entitlement check to a specific resource
+     */
+    resourceId?: string;
+    /**
+     * 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 Entitlements {
+    export { type EntitlementCheckResponse as EntitlementCheckResponse, type EntitlementCheckParams as EntitlementCheckParams, };
+}
+//# sourceMappingURL=entitlements.d.mts.map

package/resources/v1-beta/customers/entitlements.d.mts.map

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

package/resources/v1-beta/customers/entitlements.d.ts

@@ -0,0 +1,261 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Entitlements extends APIResource {
+    /**
+     * Experimental — request and response shapes may change without notice. Same
+     * semantics as `Check entitlement`, plus an optional `dimensions` query param that
+     * resolves to per-entity governance limits surfaced as `chains` on the response.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.entitlements.check('x');
+     * ```
+     */
+    check(id: string, params?: EntitlementCheckParams | null | undefined, options?: RequestOptions): APIPromise<EntitlementCheckResponse>;
+}
+/**
+ * Response object
+ */
+export interface EntitlementCheckResponse {
+    /**
+     * Feature entitlement with optional governance chains attached.
+     */
+    data: EntitlementCheckResponse.Feature | EntitlementCheckResponse.Credit;
+}
+export declare namespace EntitlementCheckResponse {
+    /**
+     * Feature entitlement with optional governance chains attached.
+     */
+    interface Feature {
+        accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+        isGranted: boolean;
+        type: 'FEATURE';
+        /**
+         * Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+         * was not provided.
+         */
+        chains?: Array<Array<Feature.Chain>>;
+        currentUsage?: number;
+        /**
+         * Timestamp of the last update to the entitlement grant or configuration.
+         */
+        entitlementUpdatedAt?: string;
+        feature?: Feature.Feature;
+        hasUnlimitedUsage?: boolean;
+        resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
+        usageLimit?: number | null;
+        /**
+         * The anchor for calculating the usage period for metered entitlements with a
+         * reset period configured
+         */
+        usagePeriodAnchor?: string;
+        /**
+         * The end date of the usage period for metered entitlements with a reset period
+         * configured
+         */
+        usagePeriodEnd?: string;
+        /**
+         * The start date of the usage period for metered entitlements with a reset period
+         * configured
+         */
+        usagePeriodStart?: string;
+        /**
+         * The next time the entitlement should be recalculated
+         */
+        validUntil?: string;
+    }
+    namespace Feature {
+        /**
+         * Per-entity governance node — limit and current usage for a single resolved
+         * entity.
+         */
+        interface Chain {
+            /**
+             * Amount consumed by this entity in the current cadence period.
+             */
+            currentUsage: number;
+            /**
+             * External id of the entity within the customer.
+             */
+            entityId: string;
+            /**
+             * Whether this node alone permits the requested usage.
+             */
+            isGranted: boolean;
+            /**
+             * External ids of the entities this budget is scoped to. Empty (`[]`) is the
+             * node-wide budget; a non-empty set is the dimension-scoped budget that matched
+             * this request — use it to tell apart multiple budgets on the same entity.
+             */
+            scopeEntityIds: Array<string>;
+            /**
+             * Hard usage limit for this node; null when no assignment is configured.
+             */
+            usageLimit: number | null;
+        }
+        interface Feature {
+            /**
+             * The unique reference ID of the entitlement.
+             */
+            id: string;
+            /**
+             * The human-readable name of the entitlement, shown in UI elements.
+             */
+            displayName: string;
+            /**
+             * The current status of the feature.
+             */
+            featureStatus: 'NEW' | 'SUSPENDED' | 'ACTIVE';
+            /**
+             * The type of feature associated with the entitlement.
+             */
+            featureType: 'BOOLEAN' | 'NUMBER' | 'ENUM';
+        }
+    }
+    /**
+     * Credit entitlement with optional governance chains attached.
+     */
+    interface Credit {
+        accessDeniedReason: 'FeatureNotFound' | 'CustomerNotFound' | 'CustomerIsArchived' | 'CustomerResourceNotFound' | 'NoActiveSubscription' | 'NoFeatureEntitlementInSubscription' | 'RequestedUsageExceedingLimit' | 'RequestedValuesMismatch' | 'BudgetExceeded' | 'Unknown' | 'FeatureTypeMismatch' | 'Revoked' | 'InsufficientCredits' | 'EntitlementNotFound' | null;
+        /**
+         * The currency associated with a credit entitlement.
+         */
+        currency: Credit.Currency;
+        currentUsage: number;
+        isGranted: boolean;
+        type: 'CREDIT';
+        usageLimit: number;
+        /**
+         * Timestamp of the last update to the credit usage.
+         */
+        usageUpdatedAt: string;
+        /**
+         * Per-entity rollups, one chain per resolved dimension. Omitted when dimensions
+         * was not provided.
+         */
+        chains?: Array<Array<Credit.Chain>>;
+        /**
+         * Timestamp of the last update to the entitlement grant or configuration.
+         */
+        entitlementUpdatedAt?: string;
+        /**
+         * The end date of the current billing period for recurring credit grants.
+         */
+        usagePeriodEnd?: string;
+        /**
+         * The next time the entitlement should be recalculated
+         */
+        validUntil?: string;
+    }
+    namespace Credit {
+        /**
+         * The currency associated with a credit entitlement.
+         */
+        interface Currency {
+            /**
+             * The unique identifier of the custom currency.
+             */
+            currencyId: string;
+            /**
+             * The display name of the currency.
+             */
+            displayName: string;
+            /**
+             * A description of the currency.
+             */
+            description?: string | null;
+            /**
+             * Additional metadata associated with the currency.
+             */
+            metadata?: {
+                [key: string]: string;
+            } | null;
+            /**
+             * The plural form of the currency unit.
+             */
+            unitPlural?: string | null;
+            /**
+             * The singular form of the currency unit.
+             */
+            unitSingular?: string | null;
+        }
+        /**
+         * Per-entity governance node — limit and current usage for a single resolved
+         * entity.
+         */
+        interface Chain {
+            /**
+             * Amount consumed by this entity in the current cadence period.
+             */
+            currentUsage: number;
+            /**
+             * External id of the entity within the customer.
+             */
+            entityId: string;
+            /**
+             * Whether this node alone permits the requested usage.
+             */
+            isGranted: boolean;
+            /**
+             * External ids of the entities this budget is scoped to. Empty (`[]`) is the
+             * node-wide budget; a non-empty set is the dimension-scoped budget that matched
+             * this request — use it to tell apart multiple budgets on the same entity.
+             */
+            scopeEntityIds: Array<string>;
+            /**
+             * Hard usage limit for this node; null when no assignment is configured.
+             */
+            usageLimit: number | null;
+        }
+    }
+}
+export interface EntitlementCheckParams {
+    /**
+     * Query param: Currency ID (refId) to check for credit entitlements. Mutually
+     * exclusive with `featureId`.
+     */
+    currencyId?: string;
+    /**
+     * Query param: Optional attribution map (e.g. `dimensions[userId]=u1`). When
+     * provided, the response includes a `chains` array with per-entity governance
+     * limits.
+     */
+    dimensions?: {
+        [key: string]: string;
+    };
+    /**
+     * Query param: Feature ID (refId) to check. Mutually exclusive with `currencyId`.
+     */
+    featureId?: string;
+    /**
+     * Query param: Requested usage amount to evaluate against the entitlement limit
+     * (numeric features only)
+     */
+    requestedUsage?: number;
+    /**
+     * Query param: Requested values to evaluate against allowed values (enum features
+     * only)
+     */
+    requestedValues?: Array<string>;
+    /**
+     * Query param: Resource ID to scope the entitlement check to a specific resource
+     */
+    resourceId?: string;
+    /**
+     * 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 Entitlements {
+    export { type EntitlementCheckResponse as EntitlementCheckResponse, type EntitlementCheckParams as EntitlementCheckParams, };
+}
+//# sourceMappingURL=entitlements.d.ts.map

package/resources/v1-beta/customers/entitlements.d.ts.map

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

package/resources/v1-beta/customers/entitlements.js

@@ -0,0 +1,36 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entitlements = void 0;
+const resource_1 = require("../../../core/resource.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Entitlements extends resource_1.APIResource {
+    /**
+     * Experimental — request and response shapes may change without notice. Same
+     * semantics as `Check entitlement`, plus an optional `dimensions` query param that
+     * resolves to per-entity governance limits surfaced as `chains` on the response.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.entitlements.check('x');
+     * ```
+     */
+    check(id, params = {}, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+        return this._client.get((0, path_1.path) `/api/v1-beta/customers/${id}/entitlements/check`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Entitlements = Entitlements;
+//# sourceMappingURL=entitlements.js.map

package/resources/v1-beta/customers/entitlements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/entitlements.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAErD,0DAAyD;AAEzD,0DAAoD;AAEpD,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;;;;OAUG;IACH,KAAK,CACH,EAAU,EACV,SAAoD,EAAE,EACtD,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAClG,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,0BAA0B,EAAE,qBAAqB,EAAE;YAC7E,KAAK;YACL,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;AA9BD,oCA8BC"}

package/resources/v1-beta/customers/entitlements.mjs

@@ -0,0 +1,32 @@
+// 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";
+import { path } from "../../../internal/utils/path.mjs";
+export class Entitlements extends APIResource {
+    /**
+     * Experimental — request and response shapes may change without notice. Same
+     * semantics as `Check entitlement`, plus an optional `dimensions` query param that
+     * resolves to per-entity governance limits surfaced as `chains` on the response.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.entitlements.check('x');
+     * ```
+     */
+    check(id, params = {}, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+        return this._client.get(path `/api/v1-beta/customers/${id}/entitlements/check`, {
+            query,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=entitlements.mjs.map

package/resources/v1-beta/customers/entitlements.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.mjs","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/entitlements.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAErD,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;OAUG;IACH,KAAK,CACH,EAAU,EACV,SAAoD,EAAE,EACtD,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAClG,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,0BAA0B,EAAE,qBAAqB,EAAE;YAC7E,KAAK;YACL,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/v1-beta/customers/index.d.mts

@@ -0,0 +1,5 @@
+export { Assignments, type AssignmentListResponse, type AssignmentUpsertResponse, type AssignmentListParams, type AssignmentUpsertParams, type AssignmentListResponsesMyCursorIDPage, } from "./assignments.mjs";
+export { Customers } from "./customers.mjs";
+export { Entities, type EntityRetrieveResponse, type EntityListResponse, type EntityArchiveResponse, type EntityUnarchiveResponse, type EntityUpsertResponse, type EntityRetrieveParams, type EntityListParams, type EntityArchiveParams, type EntityUnarchiveParams, type EntityUpsertParams, type EntityListResponsesMyCursorIDPage, } from "./entities.mjs";
+export { Entitlements, type EntitlementCheckResponse, type EntitlementCheckParams } from "./entitlements.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/v1-beta/customers/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qCAAqC,GAC3C,0BAAsB;AACvB,OAAO,EAAE,SAAS,EAAE,wBAAoB;AACxC,OAAO,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iCAAiC,GACvC,uBAAmB;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,2BAAuB"}

package/resources/v1-beta/customers/index.d.ts

@@ -0,0 +1,5 @@
+export { Assignments, type AssignmentListResponse, type AssignmentUpsertResponse, type AssignmentListParams, type AssignmentUpsertParams, type AssignmentListResponsesMyCursorIDPage, } from "./assignments.js";
+export { Customers } from "./customers.js";
+export { Entities, type EntityRetrieveResponse, type EntityListResponse, type EntityArchiveResponse, type EntityUnarchiveResponse, type EntityUpsertResponse, type EntityRetrieveParams, type EntityListParams, type EntityArchiveParams, type EntityUnarchiveParams, type EntityUpsertParams, type EntityListResponsesMyCursorIDPage, } from "./entities.js";
+export { Entitlements, type EntitlementCheckResponse, type EntitlementCheckParams } from "./entitlements.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/v1-beta/customers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qCAAqC,GAC3C,yBAAsB;AACvB,OAAO,EAAE,SAAS,EAAE,uBAAoB;AACxC,OAAO,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iCAAiC,GACvC,sBAAmB;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,0BAAuB"}

package/resources/v1-beta/customers/index.js

@@ -0,0 +1,13 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entitlements = exports.Entities = exports.Customers = exports.Assignments = void 0;
+var assignments_1 = require("./assignments.js");
+Object.defineProperty(exports, "Assignments", { enumerable: true, get: function () { return assignments_1.Assignments; } });
+var customers_1 = require("./customers.js");
+Object.defineProperty(exports, "Customers", { enumerable: true, get: function () { return customers_1.Customers; } });
+var entities_1 = require("./entities.js");
+Object.defineProperty(exports, "Entities", { enumerable: true, get: function () { return entities_1.Entities; } });
+var entitlements_1 = require("./entitlements.js");
+Object.defineProperty(exports, "Entitlements", { enumerable: true, get: function () { return entitlements_1.Entitlements; } });
+//# sourceMappingURL=index.js.map

package/resources/v1-beta/customers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,gDAOuB;AANrB,0GAAA,WAAW,OAAA;AAOb,4CAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,0CAaoB;AAZlB,oGAAA,QAAQ,OAAA;AAaV,kDAA0G;AAAjG,4GAAA,YAAY,OAAA"}

package/resources/v1-beta/customers/index.mjs

@@ -0,0 +1,6 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Assignments, } from "./assignments.mjs";
+export { Customers } from "./customers.mjs";
+export { Entities, } from "./entities.mjs";
+export { Entitlements } from "./entitlements.mjs";
+//# sourceMappingURL=index.mjs.map