@stigg/typescript 0.1.0-beta.4 → 0.1.0-beta.41

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

@@ -0,0 +1,249 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Assignments extends APIResource {
+    /**
+     * Returns a cursor-paginated list of capability assignments for the given
+     * customer. An assignment ties an entity to a capability with a usage limit and
+     * reset cadence.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const assignmentListResponse of client.v1Beta.customers.assignments.list(
+     *   'id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(id: string, params?: AssignmentListParams | null | undefined, options?: RequestOptions): PagePromise<AssignmentListResponsesMyCursorIDPage, AssignmentListResponse>;
+    /**
+     * Batched create-or-update of capability assignments. Existing assignments matched
+     * by (entityId, capabilityId) are updated; new pairs are created. On update,
+     * omitted fields (usageLimit, cadence) are preserved; on create both are required
+     * by the governance service.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.assignments.upsert('id', {
+     *     assignments: [
+     *       {
+     *         entityId: 'workspace-001',
+     *         featureId: 'compute-minutes',
+     *         usageLimit: 1000,
+     *         cadence: 'P1M',
+     *       },
+     *       {
+     *         entityId: 'workspace-002',
+     *         currencyId: 'cred-type-tokens',
+     *         usageLimit: 2000,
+     *         cadence: 'P1M',
+     *         parentId: 'workspace-001',
+     *         scopeEntityIds: ['user-1'],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    upsert(id: string, params: AssignmentUpsertParams, options?: RequestOptions): APIPromise<AssignmentUpsertResponse>;
+}
+export type AssignmentListResponsesMyCursorIDPage = MyCursorIDPage<AssignmentListResponse>;
+/**
+ * A capability assignment for an entity belonging to a customer. Defines how much
+ * of the capability the entity may consume (`usageLimit`) and how often the
+ * counter resets (`cadence`).
+ */
+export interface AssignmentListResponse {
+    /**
+     * Synthetic UUID identifier — also the cursor anchor for paginated lists
+     */
+    id: string;
+    /**
+     * Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+     * `PT1M`.
+     */
+    cadence: string;
+    /**
+     * Timestamp of when the record was created
+     */
+    createdAt: string;
+    /**
+     * The entity ID this assignment is attached to
+     */
+    entityId: string;
+    /**
+     * Parent entity ID in the hierarchy, or `null` for a root.
+     */
+    parentId: string | null;
+    /**
+     * Dimension-scoped sub-budget key: the set of entity IDs this budget applies to.
+     * Empty is the node-wide budget that always matches; a non-empty set only applies
+     * when every listed entity is present in the resolved set (order-insensitive).
+     */
+    scopeEntityIds: Array<string>;
+    /**
+     * Timestamp of when the record was last updated
+     */
+    updatedAt: string;
+    /**
+     * Maximum usage allowed within one cadence window
+     */
+    usageLimit: number | null;
+    /**
+     * Currency ID this assignment grants (present for credit capabilities).
+     */
+    currencyId?: string;
+    /**
+     * Feature ID this assignment grants (present for feature capabilities).
+     */
+    featureId?: string;
+}
+/**
+ * Assignments after upsert.
+ */
+export interface AssignmentUpsertResponse {
+    data: Array<AssignmentUpsertResponse.Data>;
+}
+export declare namespace AssignmentUpsertResponse {
+    /**
+     * A capability assignment for an entity belonging to a customer. Defines how much
+     * of the capability the entity may consume (`usageLimit`) and how often the
+     * counter resets (`cadence`).
+     */
+    interface Data {
+        /**
+         * Synthetic UUID identifier — also the cursor anchor for paginated lists
+         */
+        id: string;
+        /**
+         * Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+         * `PT1M`.
+         */
+        cadence: string;
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * The entity ID this assignment is attached to
+         */
+        entityId: string;
+        /**
+         * Parent entity ID in the hierarchy, or `null` for a root.
+         */
+        parentId: string | null;
+        /**
+         * Dimension-scoped sub-budget key: the set of entity IDs this budget applies to.
+         * Empty is the node-wide budget that always matches; a non-empty set only applies
+         * when every listed entity is present in the resolved set (order-insensitive).
+         */
+        scopeEntityIds: Array<string>;
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * Maximum usage allowed within one cadence window
+         */
+        usageLimit: number | null;
+        /**
+         * Currency ID this assignment grants (present for credit capabilities).
+         */
+        currencyId?: string;
+        /**
+         * Feature ID this assignment grants (present for feature capabilities).
+         */
+        featureId?: string;
+    }
+}
+export interface AssignmentListParams extends MyCursorIDPageParams {
+    /**
+     * Query param: Filter assignments to a specific currency, by its ID. Mutually
+     * exclusive with `featureId`.
+     */
+    currencyId?: string;
+    /**
+     * Query param: Filter assignments to a specific entity ID
+     */
+    entityId?: string;
+    /**
+     * Query param: Filter assignments to a specific feature, by its ID. Mutually
+     * exclusive with `currencyId`.
+     */
+    featureId?: 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 interface AssignmentUpsertParams {
+    /**
+     * Body param: Assignments to upsert (1–100 per request)
+     */
+    assignments: Array<AssignmentUpsertParams.Assignment>;
+    /**
+     * 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 AssignmentUpsertParams {
+    /**
+     * A single assignment to create or update. Identify the capability with exactly
+     * one of `featureId` or `currencyId`. The natural key is the
+     * `(entityId, capability, scopeEntityIds)` triple. On create both `usageLimit` and
+     * `cadence` are required; on update they may be omitted individually to preserve
+     * the existing value.
+     */
+    interface Assignment {
+        /**
+         * The entity ID this assignment is attached to
+         */
+        entityId: string;
+        /**
+         * Usage-reset cadence (required on create) as an ISO-8601 single-unit duration,
+         * e.g. `P1M`, `P30D`, `PT1M`.
+         */
+        cadence?: string;
+        /**
+         * Currency ID this assignment grants (credit budgets). Mutually exclusive with
+         * `featureId`.
+         */
+        currencyId?: string;
+        /**
+         * Feature ID this assignment grants. Mutually exclusive with `currencyId`.
+         */
+        featureId?: string;
+        /**
+         * Parent entity ID in the hierarchy. Omit to leave the current parent untouched (a
+         * new node defaults to a root); `null` detaches to a root; an ID sets or changes
+         * the parent. Reparenting an existing node is leaf-only.
+         */
+        parentId?: string | null;
+        scopeEntityIds?: Array<string>;
+        /**
+         * Maximum usage allowed within one cadence window (required on create)
+         */
+        usageLimit?: number | null;
+    }
+}
+export declare namespace Assignments {
+    export { type AssignmentListResponse as AssignmentListResponse, type AssignmentUpsertResponse as AssignmentUpsertResponse, type AssignmentListResponsesMyCursorIDPage as AssignmentListResponsesMyCursorIDPage, type AssignmentListParams as AssignmentListParams, type AssignmentUpsertParams as AssignmentUpsertParams, };
+}
+//# sourceMappingURL=assignments.d.mts.map

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

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

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

@@ -0,0 +1,249 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Assignments extends APIResource {
+    /**
+     * Returns a cursor-paginated list of capability assignments for the given
+     * customer. An assignment ties an entity to a capability with a usage limit and
+     * reset cadence.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const assignmentListResponse of client.v1Beta.customers.assignments.list(
+     *   'id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(id: string, params?: AssignmentListParams | null | undefined, options?: RequestOptions): PagePromise<AssignmentListResponsesMyCursorIDPage, AssignmentListResponse>;
+    /**
+     * Batched create-or-update of capability assignments. Existing assignments matched
+     * by (entityId, capabilityId) are updated; new pairs are created. On update,
+     * omitted fields (usageLimit, cadence) are preserved; on create both are required
+     * by the governance service.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.assignments.upsert('id', {
+     *     assignments: [
+     *       {
+     *         entityId: 'workspace-001',
+     *         featureId: 'compute-minutes',
+     *         usageLimit: 1000,
+     *         cadence: 'P1M',
+     *       },
+     *       {
+     *         entityId: 'workspace-002',
+     *         currencyId: 'cred-type-tokens',
+     *         usageLimit: 2000,
+     *         cadence: 'P1M',
+     *         parentId: 'workspace-001',
+     *         scopeEntityIds: ['user-1'],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    upsert(id: string, params: AssignmentUpsertParams, options?: RequestOptions): APIPromise<AssignmentUpsertResponse>;
+}
+export type AssignmentListResponsesMyCursorIDPage = MyCursorIDPage<AssignmentListResponse>;
+/**
+ * A capability assignment for an entity belonging to a customer. Defines how much
+ * of the capability the entity may consume (`usageLimit`) and how often the
+ * counter resets (`cadence`).
+ */
+export interface AssignmentListResponse {
+    /**
+     * Synthetic UUID identifier — also the cursor anchor for paginated lists
+     */
+    id: string;
+    /**
+     * Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+     * `PT1M`.
+     */
+    cadence: string;
+    /**
+     * Timestamp of when the record was created
+     */
+    createdAt: string;
+    /**
+     * The entity ID this assignment is attached to
+     */
+    entityId: string;
+    /**
+     * Parent entity ID in the hierarchy, or `null` for a root.
+     */
+    parentId: string | null;
+    /**
+     * Dimension-scoped sub-budget key: the set of entity IDs this budget applies to.
+     * Empty is the node-wide budget that always matches; a non-empty set only applies
+     * when every listed entity is present in the resolved set (order-insensitive).
+     */
+    scopeEntityIds: Array<string>;
+    /**
+     * Timestamp of when the record was last updated
+     */
+    updatedAt: string;
+    /**
+     * Maximum usage allowed within one cadence window
+     */
+    usageLimit: number | null;
+    /**
+     * Currency ID this assignment grants (present for credit capabilities).
+     */
+    currencyId?: string;
+    /**
+     * Feature ID this assignment grants (present for feature capabilities).
+     */
+    featureId?: string;
+}
+/**
+ * Assignments after upsert.
+ */
+export interface AssignmentUpsertResponse {
+    data: Array<AssignmentUpsertResponse.Data>;
+}
+export declare namespace AssignmentUpsertResponse {
+    /**
+     * A capability assignment for an entity belonging to a customer. Defines how much
+     * of the capability the entity may consume (`usageLimit`) and how often the
+     * counter resets (`cadence`).
+     */
+    interface Data {
+        /**
+         * Synthetic UUID identifier — also the cursor anchor for paginated lists
+         */
+        id: string;
+        /**
+         * Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+         * `PT1M`.
+         */
+        cadence: string;
+        /**
+         * Timestamp of when the record was created
+         */
+        createdAt: string;
+        /**
+         * The entity ID this assignment is attached to
+         */
+        entityId: string;
+        /**
+         * Parent entity ID in the hierarchy, or `null` for a root.
+         */
+        parentId: string | null;
+        /**
+         * Dimension-scoped sub-budget key: the set of entity IDs this budget applies to.
+         * Empty is the node-wide budget that always matches; a non-empty set only applies
+         * when every listed entity is present in the resolved set (order-insensitive).
+         */
+        scopeEntityIds: Array<string>;
+        /**
+         * Timestamp of when the record was last updated
+         */
+        updatedAt: string;
+        /**
+         * Maximum usage allowed within one cadence window
+         */
+        usageLimit: number | null;
+        /**
+         * Currency ID this assignment grants (present for credit capabilities).
+         */
+        currencyId?: string;
+        /**
+         * Feature ID this assignment grants (present for feature capabilities).
+         */
+        featureId?: string;
+    }
+}
+export interface AssignmentListParams extends MyCursorIDPageParams {
+    /**
+     * Query param: Filter assignments to a specific currency, by its ID. Mutually
+     * exclusive with `featureId`.
+     */
+    currencyId?: string;
+    /**
+     * Query param: Filter assignments to a specific entity ID
+     */
+    entityId?: string;
+    /**
+     * Query param: Filter assignments to a specific feature, by its ID. Mutually
+     * exclusive with `currencyId`.
+     */
+    featureId?: 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 interface AssignmentUpsertParams {
+    /**
+     * Body param: Assignments to upsert (1–100 per request)
+     */
+    assignments: Array<AssignmentUpsertParams.Assignment>;
+    /**
+     * 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 AssignmentUpsertParams {
+    /**
+     * A single assignment to create or update. Identify the capability with exactly
+     * one of `featureId` or `currencyId`. The natural key is the
+     * `(entityId, capability, scopeEntityIds)` triple. On create both `usageLimit` and
+     * `cadence` are required; on update they may be omitted individually to preserve
+     * the existing value.
+     */
+    interface Assignment {
+        /**
+         * The entity ID this assignment is attached to
+         */
+        entityId: string;
+        /**
+         * Usage-reset cadence (required on create) as an ISO-8601 single-unit duration,
+         * e.g. `P1M`, `P30D`, `PT1M`.
+         */
+        cadence?: string;
+        /**
+         * Currency ID this assignment grants (credit budgets). Mutually exclusive with
+         * `featureId`.
+         */
+        currencyId?: string;
+        /**
+         * Feature ID this assignment grants. Mutually exclusive with `currencyId`.
+         */
+        featureId?: string;
+        /**
+         * Parent entity ID in the hierarchy. Omit to leave the current parent untouched (a
+         * new node defaults to a root); `null` detaches to a root; an ID sets or changes
+         * the parent. Reparenting an existing node is leaf-only.
+         */
+        parentId?: string | null;
+        scopeEntityIds?: Array<string>;
+        /**
+         * Maximum usage allowed within one cadence window (required on create)
+         */
+        usageLimit?: number | null;
+    }
+}
+export declare namespace Assignments {
+    export { type AssignmentListResponse as AssignmentListResponse, type AssignmentUpsertResponse as AssignmentUpsertResponse, type AssignmentListResponsesMyCursorIDPage as AssignmentListResponsesMyCursorIDPage, type AssignmentListParams as AssignmentListParams, type AssignmentUpsertParams as AssignmentUpsertParams, };
+}
+//# sourceMappingURL=assignments.d.ts.map

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

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

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

@@ -0,0 +1,84 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Assignments = void 0;
+const resource_1 = require("../../../core/resource.js");
+const pagination_1 = require("../../../core/pagination.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Assignments extends resource_1.APIResource {
+    /**
+     * Returns a cursor-paginated list of capability assignments for the given
+     * customer. An assignment ties an entity to a capability with a usage limit and
+     * reset cadence.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const assignmentListResponse of client.v1Beta.customers.assignments.list(
+     *   'id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(id, params = {}, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/api/v1-beta/customers/${id}/assignments`, (pagination_1.MyCursorIDPage), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Batched create-or-update of capability assignments. Existing assignments matched
+     * by (entityId, capabilityId) are updated; new pairs are created. On update,
+     * omitted fields (usageLimit, cadence) are preserved; on create both are required
+     * by the governance service.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.assignments.upsert('id', {
+     *     assignments: [
+     *       {
+     *         entityId: 'workspace-001',
+     *         featureId: 'compute-minutes',
+     *         usageLimit: 1000,
+     *         cadence: 'P1M',
+     *       },
+     *       {
+     *         entityId: 'workspace-002',
+     *         currencyId: 'cred-type-tokens',
+     *         usageLimit: 2000,
+     *         cadence: 'P1M',
+     *         parentId: 'workspace-001',
+     *         scopeEntityIds: ['user-1'],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    upsert(id, params, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+        return this._client.put((0, path_1.path) `/api/v1-beta/customers/${id}/assignments`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Assignments = Assignments;
+//# sourceMappingURL=assignments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assignments.js","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/assignments.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAErD,4DAAkG;AAClG,0DAAyD;AAEzD,0DAAoD;AAEpD,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;OAcG;IACH,IAAI,CACF,EAAU,EACV,SAAkD,EAAE,EACpD,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,UAAU,CAC5B,IAAA,WAAI,EAAA,0BAA0B,EAAE,cAAc,EAC9C,CAAA,2BAAsC,CAAA,EACtC;YACE,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,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CACJ,EAAU,EACV,MAA8B,EAC9B,OAAwB;QAExB,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,0BAA0B,EAAE,cAAc,EAAE;YACtE,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;AAtFD,kCAsFC"}

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

@@ -0,0 +1,80 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { MyCursorIDPage } from "../../../core/pagination.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+export class Assignments extends APIResource {
+    /**
+     * Returns a cursor-paginated list of capability assignments for the given
+     * customer. An assignment ties an entity to a capability with a usage limit and
+     * reset cadence.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const assignmentListResponse of client.v1Beta.customers.assignments.list(
+     *   'id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(id, params = {}, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+        return this._client.getAPIList(path `/api/v1-beta/customers/${id}/assignments`, (MyCursorIDPage), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Batched create-or-update of capability assignments. Existing assignments matched
+     * by (entityId, capabilityId) are updated; new pairs are created. On update,
+     * omitted fields (usageLimit, cadence) are preserved; on create both are required
+     * by the governance service.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1Beta.customers.assignments.upsert('id', {
+     *     assignments: [
+     *       {
+     *         entityId: 'workspace-001',
+     *         featureId: 'compute-minutes',
+     *         usageLimit: 1000,
+     *         cadence: 'P1M',
+     *       },
+     *       {
+     *         entityId: 'workspace-002',
+     *         currencyId: 'cred-type-tokens',
+     *         usageLimit: 2000,
+     *         cadence: 'P1M',
+     *         parentId: 'workspace-001',
+     *         scopeEntityIds: ['user-1'],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    upsert(id, params, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...body } = params;
+        return this._client.put(path `/api/v1-beta/customers/${id}/assignments`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=assignments.mjs.map