@stigg/typescript 0.1.0-beta.62 → 0.1.0-beta.63

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

@@ -0,0 +1,156 @@
+import { APIResource } from "../../../core/resource.mjs";
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Governance extends APIResource {
+    /**
+     * Queries the customer's governance hierarchy tree, returning a cursor-paginated
+     * list of nodes with their usage configuration (limit, cadence, scope) and current
+     * usage, sortable and filterable by usage. Each node carries `parentId` so the
+     * tree can be rebuilt client-side. Usage is read from a periodically-refreshed
+     * read model and never gates access.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const governanceListResponse of client.v1Beta.customers.governance.list(
+     *   'id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(id: string, params?: GovernanceListParams | null | undefined, options?: RequestOptions): PagePromise<GovernanceListResponsesMyCursorIDPage, GovernanceListResponse>;
+}
+export type GovernanceListResponsesMyCursorIDPage = MyCursorIDPage<GovernanceListResponse>;
+/**
+ * A node of the governance hierarchy tree with its usage configuration (limit,
+ * cadence, scope) and current usage. Usage is read from a periodically-refreshed
+ * read model and may lag the live counter by a short interval; it never gates
+ * access.
+ */
+export interface GovernanceListResponse {
+    /**
+     * Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+     * `PT1M`; `null` when the node has no usage configuration.
+     */
+    cadence: string | null;
+    /**
+     * Usage consumed in the current cadence period (may lag the live counter by a
+     * short interval).
+     */
+    currentUsage: number | null;
+    /**
+     * Human-readable name of the entity, or null when none is set (display the entity
+     * id instead).
+     */
+    displayName: string | null;
+    /**
+     * External id of the entity at this node.
+     */
+    entityId: string;
+    /**
+     * External id of the entity type (e.g. `team`, `user`).
+     */
+    entityTypeId: string;
+    /**
+     * External id of the parent entity in the tree. `null` means the entity is either
+     * a root or not yet placed in the hierarchy — placement rides on an assignment, so
+     * an entity with no limits set has no parent yet. Both render at the top level;
+     * use it to rebuild the tree.
+     */
+    parentId: string | null;
+    /**
+     * The configuration scope (entity ids). Empty is the node-wide configuration; a
+     * non-empty set is a dimension-scoped sub-configuration.
+     */
+    scopeEntityIds: Array<string>;
+    /**
+     * Hard usage limit for this node per cadence period.
+     */
+    usageLimit: number | null;
+    /**
+     * Exclusive end of the cadence period in progress now — when usage resets. `null`
+     * when the node has no usage configuration, or when a stored cadence cannot be
+     * parsed.
+     */
+    usagePeriodEnd: string | null;
+    /**
+     * Start of the cadence period in progress now, derived from the cadence and the
+     * assignment anchor — it stays correct across a rollover. `null` when the node has
+     * no usage configuration, or when a stored cadence cannot be parsed.
+     */
+    usagePeriodStart: string | null;
+    /**
+     * `currentUsage / usageLimit` (1 when usageLimit is 0 — always at limit). The
+     * cross-capability-safe sort key.
+     */
+    utilization: number | null;
+    /**
+     * The metered currency ID (present when the configured capability is a credit
+     * currency).
+     */
+    currencyId?: string;
+    /**
+     * The metered feature ID (present when the configured capability is a feature).
+     */
+    featureId?: string;
+}
+export interface GovernanceListParams extends MyCursorIDPageParams {
+    /**
+     * Query param: Currency ids to include, comma-separated (e.g.
+     * `?currencyIds=credits`), up to 100. Omit both featureIds and currencyIds for
+     * tree mode.
+     */
+    currencyIds?: Array<string>;
+    /**
+     * Query param: Case-insensitive substring match on the entity id or its display
+     * name (`%`/`_` matched literally).
+     */
+    entityIdSearch?: string;
+    /**
+     * Query param: Filter to one or more entity types, comma-separated (e.g.
+     * `?entityTypeIds=team,user`), up to 100.
+     */
+    entityTypeIds?: Array<string>;
+    /**
+     * Query param: Feature ids to include, comma-separated (e.g.
+     * `?featureIds=ai-tokens,seats`), up to 100. Omit both featureIds and currencyIds
+     * for tree mode — every node in the hierarchy with no usage configuration
+     * attached.
+     */
+    featureIds?: Array<string>;
+    /**
+     * Query param: Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for
+     * at/over limit).
+     */
+    minUtilization?: number;
+    /**
+     * Query param: Sort direction: `asc` or `desc` (default `desc`).
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Query param: Filter by configuration scope: `all` (default), `nodeWide` (`[]`
+     * only), or `scoped` (non-empty only).
+     */
+    scope?: 'all' | 'nodeWide' | 'scoped';
+    /**
+     * Query param: Sort key: `utilization` (default, cross-capability-safe),
+     * `currentUsage`, `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+     */
+    sortBy?: 'utilization' | 'currentUsage' | 'usageLimit' | 'scopeSize' | 'id' | 'createdAt';
+    /**
+     * 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 Governance {
+    export { type GovernanceListResponse as GovernanceListResponse, type GovernanceListResponsesMyCursorIDPage as GovernanceListResponsesMyCursorIDPage, type GovernanceListParams as GovernanceListParams, };
+}
+//# sourceMappingURL=governance.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.mts","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/governance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,WAAW,EAAE,qCAAiC;AAElG,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAGnE,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CACF,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,oBAAoB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,qCAAqC,EAAE,sBAAsB,CAAC;CAkB9E;AAED,MAAM,MAAM,qCAAqC,GAAG,cAAc,CAAC,sBAAsB,CAAC,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;OAIG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IAEtC;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,IAAI,GAAG,WAAW,CAAC;IAE1F;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

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

@@ -0,0 +1,156 @@
+import { APIResource } from "../../../core/resource.js";
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from "../../../core/pagination.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Governance extends APIResource {
+    /**
+     * Queries the customer's governance hierarchy tree, returning a cursor-paginated
+     * list of nodes with their usage configuration (limit, cadence, scope) and current
+     * usage, sortable and filterable by usage. Each node carries `parentId` so the
+     * tree can be rebuilt client-side. Usage is read from a periodically-refreshed
+     * read model and never gates access.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const governanceListResponse of client.v1Beta.customers.governance.list(
+     *   'id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(id: string, params?: GovernanceListParams | null | undefined, options?: RequestOptions): PagePromise<GovernanceListResponsesMyCursorIDPage, GovernanceListResponse>;
+}
+export type GovernanceListResponsesMyCursorIDPage = MyCursorIDPage<GovernanceListResponse>;
+/**
+ * A node of the governance hierarchy tree with its usage configuration (limit,
+ * cadence, scope) and current usage. Usage is read from a periodically-refreshed
+ * read model and may lag the live counter by a short interval; it never gates
+ * access.
+ */
+export interface GovernanceListResponse {
+    /**
+     * Usage-reset cadence as an ISO-8601 single-unit duration, e.g. `P1M`, `P30D`,
+     * `PT1M`; `null` when the node has no usage configuration.
+     */
+    cadence: string | null;
+    /**
+     * Usage consumed in the current cadence period (may lag the live counter by a
+     * short interval).
+     */
+    currentUsage: number | null;
+    /**
+     * Human-readable name of the entity, or null when none is set (display the entity
+     * id instead).
+     */
+    displayName: string | null;
+    /**
+     * External id of the entity at this node.
+     */
+    entityId: string;
+    /**
+     * External id of the entity type (e.g. `team`, `user`).
+     */
+    entityTypeId: string;
+    /**
+     * External id of the parent entity in the tree. `null` means the entity is either
+     * a root or not yet placed in the hierarchy — placement rides on an assignment, so
+     * an entity with no limits set has no parent yet. Both render at the top level;
+     * use it to rebuild the tree.
+     */
+    parentId: string | null;
+    /**
+     * The configuration scope (entity ids). Empty is the node-wide configuration; a
+     * non-empty set is a dimension-scoped sub-configuration.
+     */
+    scopeEntityIds: Array<string>;
+    /**
+     * Hard usage limit for this node per cadence period.
+     */
+    usageLimit: number | null;
+    /**
+     * Exclusive end of the cadence period in progress now — when usage resets. `null`
+     * when the node has no usage configuration, or when a stored cadence cannot be
+     * parsed.
+     */
+    usagePeriodEnd: string | null;
+    /**
+     * Start of the cadence period in progress now, derived from the cadence and the
+     * assignment anchor — it stays correct across a rollover. `null` when the node has
+     * no usage configuration, or when a stored cadence cannot be parsed.
+     */
+    usagePeriodStart: string | null;
+    /**
+     * `currentUsage / usageLimit` (1 when usageLimit is 0 — always at limit). The
+     * cross-capability-safe sort key.
+     */
+    utilization: number | null;
+    /**
+     * The metered currency ID (present when the configured capability is a credit
+     * currency).
+     */
+    currencyId?: string;
+    /**
+     * The metered feature ID (present when the configured capability is a feature).
+     */
+    featureId?: string;
+}
+export interface GovernanceListParams extends MyCursorIDPageParams {
+    /**
+     * Query param: Currency ids to include, comma-separated (e.g.
+     * `?currencyIds=credits`), up to 100. Omit both featureIds and currencyIds for
+     * tree mode.
+     */
+    currencyIds?: Array<string>;
+    /**
+     * Query param: Case-insensitive substring match on the entity id or its display
+     * name (`%`/`_` matched literally).
+     */
+    entityIdSearch?: string;
+    /**
+     * Query param: Filter to one or more entity types, comma-separated (e.g.
+     * `?entityTypeIds=team,user`), up to 100.
+     */
+    entityTypeIds?: Array<string>;
+    /**
+     * Query param: Feature ids to include, comma-separated (e.g.
+     * `?featureIds=ai-tokens,seats`), up to 100. Omit both featureIds and currencyIds
+     * for tree mode — every node in the hierarchy with no usage configuration
+     * attached.
+     */
+    featureIds?: Array<string>;
+    /**
+     * Query param: Only nodes with utilization ≥ this value (e.g. 0.8 for ≥80%, 1 for
+     * at/over limit).
+     */
+    minUtilization?: number;
+    /**
+     * Query param: Sort direction: `asc` or `desc` (default `desc`).
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Query param: Filter by configuration scope: `all` (default), `nodeWide` (`[]`
+     * only), or `scoped` (non-empty only).
+     */
+    scope?: 'all' | 'nodeWide' | 'scoped';
+    /**
+     * Query param: Sort key: `utilization` (default, cross-capability-safe),
+     * `currentUsage`, `usageLimit`, `scopeSize`, `id`, or `createdAt`.
+     */
+    sortBy?: 'utilization' | 'currentUsage' | 'usageLimit' | 'scopeSize' | 'id' | 'createdAt';
+    /**
+     * 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 Governance {
+    export { type GovernanceListResponse as GovernanceListResponse, type GovernanceListResponsesMyCursorIDPage as GovernanceListResponsesMyCursorIDPage, type GovernanceListParams as GovernanceListParams, };
+}
+//# sourceMappingURL=governance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/governance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,WAAW,EAAE,oCAAiC;AAElG,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CACF,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,oBAAoB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,qCAAqC,EAAE,sBAAsB,CAAC;CAkB9E;AAED,MAAM,MAAM,qCAAqC,GAAG,cAAc,CAAC,sBAAsB,CAAC,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;OAIG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IAEtC;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,IAAI,GAAG,WAAW,CAAC;IAE1F;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

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

@@ -0,0 +1,43 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Governance = 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 Governance extends resource_1.APIResource {
+    /**
+     * Queries the customer's governance hierarchy tree, returning a cursor-paginated
+     * list of nodes with their usage configuration (limit, cadence, scope) and current
+     * usage, sortable and filterable by usage. Each node carries `parentId` so the
+     * tree can be rebuilt client-side. Usage is read from a periodically-refreshed
+     * read model and never gates access.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const governanceListResponse of client.v1Beta.customers.governance.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}/governance`, (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,
+            ]),
+        });
+    }
+}
+exports.Governance = Governance;
+//# sourceMappingURL=governance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/governance.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AACrD,4DAAkG;AAClG,0DAAyD;AAEzD,0DAAoD;AAEpD,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;;;;;;;;;;;;;;OAgBG;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,aAAa,EAC7C,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;CACF;AAxCD,gCAwCC"}

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

@@ -0,0 +1,39 @@
+// 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 Governance extends APIResource {
+    /**
+     * Queries the customer's governance hierarchy tree, returning a cursor-paginated
+     * list of nodes with their usage configuration (limit, cadence, scope) and current
+     * usage, sortable and filterable by usage. Each node carries `parentId` so the
+     * tree can be rebuilt client-side. Usage is read from a periodically-refreshed
+     * read model and never gates access.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const governanceListResponse of client.v1Beta.customers.governance.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}/governance`, (MyCursorIDPage), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=governance.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.mjs","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/governance.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,EAAE,cAAc,EAA0C,qCAAiC;AAClG,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;;;;OAgBG;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,IAAI,CAAA,0BAA0B,EAAE,aAAa,EAC7C,CAAA,cAAsC,CAAA,EACtC;YACE,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,CACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -2,4 +2,5 @@ export { Assignments, type AssignmentListResponse, type AssignmentUpsertResponse
 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";
+export { Governance, type GovernanceListResponse, type GovernanceListParams, type GovernanceListResponsesMyCursorIDPage, } from "./governance.mjs";
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +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"}
+{"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;AAC1G,OAAO,EACL,UAAU,EACV,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,qCAAqC,GAC3C,yBAAqB"}

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

@@ -2,4 +2,5 @@ export { Assignments, type AssignmentListResponse, type AssignmentUpsertResponse
 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";
+export { Governance, type GovernanceListResponse, type GovernanceListParams, type GovernanceListResponsesMyCursorIDPage, } from "./governance.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAC1G,OAAO,EACL,UAAU,EACV,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,qCAAqC,GAC3C,wBAAqB"}

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

@@ -1,7 +1,7 @@
 "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;
+exports.Governance = 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");
@@ -10,4 +10,6 @@ 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; } });
+var governance_1 = require("./governance.js");
+Object.defineProperty(exports, "Governance", { enumerable: true, get: function () { return governance_1.Governance; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"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;AACrB,8CAKsB;AAJpB,wGAAA,UAAU,OAAA"}

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

@@ -3,4 +3,5 @@ export { Assignments, } from "./assignments.mjs";
 export { Customers } from "./customers.mjs";
 export { Entities, } from "./entities.mjs";
 export { Entitlements } from "./entitlements.mjs";
+export { Governance, } from "./governance.mjs";
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,WAAW,GAMZ,0BAAsB;AACvB,OAAO,EAAE,SAAS,EAAE,wBAAoB;AACxC,OAAO,EACL,QAAQ,GAYT,uBAAmB;AACpB,OAAO,EAAE,YAAY,EAA8D,2BAAuB"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,WAAW,GAMZ,0BAAsB;AACvB,OAAO,EAAE,SAAS,EAAE,wBAAoB;AACxC,OAAO,EACL,QAAQ,GAYT,uBAAmB;AACpB,OAAO,EAAE,YAAY,EAA8D,2BAAuB;AAC1G,OAAO,EACL,UAAU,GAIX,yBAAqB"}

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

@@ -122,7 +122,7 @@ export namespace ReservationReleaseResponse {
       /**
        * The status of the reservation.
        */
-      status: 'ACTIVE' | 'RELEASED';
+      status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
     }
   }
 }

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

@@ -1873,7 +1873,7 @@ export namespace CustomerCheckEntitlementResponse {
       /**
        * The status of the reservation.
        */
-      status: 'ACTIVE' | 'RELEASED';
+      status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
     }
   }
 }
@@ -2625,7 +2625,7 @@ export namespace CustomerRetrieveEntitlementsResponse {
         /**
          * The status of the reservation.
          */
-        status: 'ACTIVE' | 'RELEASED';
+        status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
       }
     }
   }

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

@@ -137,18 +137,31 @@ export namespace CustomerRetrieveGovernanceResponse {
      * exist
      */
     next: string | null;
+
+    /**
+     * Cursor for fetching the previous page of results, or null if at the beginning
+     */
+    prev: string | null;
   }
 }
 
 export interface CustomerRetrieveGovernanceParams {
   /**
-   * Query param: Return items that come after this cursor
+   * Query param: Opaque cursor from a page’s `next`; returns the page after it.
+   * Mutually exclusive with `before`.
    */
   after?: string;
 
   /**
-   * Query param: Currency ids to include, repeated per value (e.g.
-   * `?currencyIds=credits`). Omit both featureIds and currencyIds for tree mode.
+   * Query param: Opaque cursor from a page’s `prev`; returns the page before it.
+   * Mutually exclusive with `after`.
+   */
+  before?: string;
+
+  /**
+   * Query param: Currency ids to include, comma-separated (e.g.
+   * `?currencyIds=credits`), up to 100. Omit both featureIds and currencyIds for
+   * tree mode.
    */
   currencyIds?: Array<string>;
 
@@ -159,14 +172,14 @@ export interface CustomerRetrieveGovernanceParams {
   entityIdSearch?: string;
 
   /**
-   * Query param: Filter to one or more entity types, repeated per value (e.g.
-   * `?entityTypeIds=team&entityTypeIds=user`).
+   * Query param: Filter to one or more entity types, comma-separated (e.g.
+   * `?entityTypeIds=team,user`), up to 100.
    */
   entityTypeIds?: Array<string>;
 
   /**
-   * Query param: Feature ids to include, repeated per value (e.g.
-   * `?featureIds=ai-tokens&featureIds=seats`). Omit both featureIds and currencyIds
+   * Query param: Feature ids to include, comma-separated (e.g.
+   * `?featureIds=ai-tokens,seats`), up to 100. Omit both featureIds and currencyIds
    * for tree mode — every node in the hierarchy with no usage configuration
    * attached.
    */

package/src/resources/v1/subscriptions/subscriptions.ts

@@ -3029,7 +3029,7 @@ export namespace SubscriptionProvisionResponse {
         /**
          * The status of the reservation.
          */
-        status: 'ACTIVE' | 'RELEASED';
+        status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
       }
     }
 

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

@@ -312,7 +312,8 @@ export namespace AssignmentUpsertParams {
     /**
      * 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.
+     * the parent. Reparenting or detaching an existing node is leaf-only; place a
+     * parent before its children, or in the same batch.
      */
     parentId?: string | null;
 

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

@@ -27,16 +27,25 @@ import {
 } from './entities';
 import * as EntitlementsAPI from './entitlements';
 import { EntitlementCheckParams, EntitlementCheckResponse, Entitlements } from './entitlements';
+import * as GovernanceAPI from './governance';
+import {
+  Governance,
+  GovernanceListParams,
+  GovernanceListResponse,
+  GovernanceListResponsesMyCursorIDPage,
+} from './governance';
 
 export class Customers extends APIResource {
   entitlements: EntitlementsAPI.Entitlements = new EntitlementsAPI.Entitlements(this._client);
   entities: EntitiesAPI.Entities = new EntitiesAPI.Entities(this._client);
   assignments: AssignmentsAPI.Assignments = new AssignmentsAPI.Assignments(this._client);
+  governance: GovernanceAPI.Governance = new GovernanceAPI.Governance(this._client);
 }
 
 Customers.Entitlements = Entitlements;
 Customers.Entities = Entities;
 Customers.Assignments = Assignments;
+Customers.Governance = Governance;
 
 export declare namespace Customers {
   export {
@@ -68,4 +77,11 @@ export declare namespace Customers {
     type AssignmentListParams as AssignmentListParams,
     type AssignmentUpsertParams as AssignmentUpsertParams,
   };
+
+  export {
+    Governance as Governance,
+    type GovernanceListResponse as GovernanceListResponse,
+    type GovernanceListResponsesMyCursorIDPage as GovernanceListResponsesMyCursorIDPage,
+    type GovernanceListParams as GovernanceListParams,
+  };
 }

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

@@ -349,7 +349,7 @@ export namespace EntitlementCheckResponse {
       /**
        * The status of the reservation.
        */
-      status: 'ACTIVE' | 'RELEASED';
+      status: 'ACTIVE' | 'RELEASED' | 'EXPIRED';
     }
   }
 }