@stigg/typescript 0.1.0-beta.43 → 0.1.0-beta.44

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

@@ -10,6 +10,8 @@ const EntitiesAPI = tslib_1.__importStar(require("./entities.js"));
 const entities_1 = require("./entities.js");
 const EntitlementsAPI = tslib_1.__importStar(require("./entitlements.js"));
 const entitlements_1 = require("./entitlements.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
 class Customers extends resource_1.APIResource {
     constructor() {
         super(...arguments);
@@ -17,6 +19,33 @@ class Customers extends resource_1.APIResource {
         this.entities = new EntitiesAPI.Entities(this._client);
         this.assignments = new AssignmentsAPI.Assignments(this._client);
     }
+    /**
+     * 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
+     * const response =
+     *   await client.v1Beta.customers.retrieveGovernance('id');
+     * ```
+     */
+    retrieveGovernance(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}/governance`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
 }
 exports.Customers = Customers;
 Customers.Entitlements = entitlements_1.Entitlements;

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

@@ -1 +1 @@
-{"version":3,"file":"customers.js","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/customers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,yEAAgD;AAChD,kDAOuB;AACvB,mEAA0C;AAC1C,4CAaoB;AACpB,2EAAkD;AAClD,oDAAgG;AAEhG,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5F,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAJD,8BAIC;AAED,SAAS,CAAC,YAAY,GAAG,2BAAY,CAAC;AACtC,SAAS,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC9B,SAAS,CAAC,WAAW,GAAG,yBAAW,CAAC"}
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/customers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,yEAAgD;AAChD,kDAOuB;AACvB,mEAA0C;AAC1C,4CAaoB;AACpB,2EAAkD;AAClD,oDAAgG;AAEhG,0DAAyD;AAEzD,0DAAoD;AAEpD,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5F,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAiCzF,CAAC;IA/BC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAChB,EAAU,EACV,SAA8D,EAAE,EAChE,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,aAAa,EAAE;YACrE,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;AApCD,8BAoCC;AA4KD,SAAS,CAAC,YAAY,GAAG,2BAAY,CAAC;AACtC,SAAS,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC9B,SAAS,CAAC,WAAW,GAAG,yBAAW,CAAC"}

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

@@ -6,6 +6,8 @@ import * as EntitiesAPI from "./entities.mjs";
 import { Entities, } from "./entities.mjs";
 import * as EntitlementsAPI from "./entitlements.mjs";
 import { Entitlements } from "./entitlements.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
 export class Customers extends APIResource {
     constructor() {
         super(...arguments);
@@ -13,6 +15,33 @@ export class Customers extends APIResource {
         this.entities = new EntitiesAPI.Entities(this._client);
         this.assignments = new AssignmentsAPI.Assignments(this._client);
     }
+    /**
+     * 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
+     * const response =
+     *   await client.v1Beta.customers.retrieveGovernance('id');
+     * ```
+     */
+    retrieveGovernance(id, params = {}, options) {
+        const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+        return this._client.get(path `/api/v1-beta/customers/${id}/governance`, {
+            query,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+                    ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
 }
 Customers.Entitlements = Entitlements;
 Customers.Entities = Entities;

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

@@ -1 +1 @@
-{"version":3,"file":"customers.mjs","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/customers.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,KAAK,cAAc,0BAAsB;AAChD,OAAO,EAML,WAAW,GACZ,0BAAsB;AACvB,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EACL,QAAQ,GAYT,uBAAmB;AACpB,OAAO,KAAK,eAAe,2BAAuB;AAClD,OAAO,EAAoD,YAAY,EAAE,2BAAuB;AAEhG,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5F,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAED,SAAS,CAAC,YAAY,GAAG,YAAY,CAAC;AACtC,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,SAAS,CAAC,WAAW,GAAG,WAAW,CAAC"}
+{"version":3,"file":"customers.mjs","sourceRoot":"","sources":["../../../src/resources/v1-beta/customers/customers.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,KAAK,cAAc,0BAAsB;AAChD,OAAO,EAML,WAAW,GACZ,0BAAsB;AACvB,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EACL,QAAQ,GAYT,uBAAmB;AACpB,OAAO,KAAK,eAAe,2BAAuB;AAClD,OAAO,EAAoD,YAAY,EAAE,2BAAuB;AAEhG,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5F,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAiCzF,CAAC;IA/BC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAChB,EAAU,EACV,SAA8D,EAAE,EAChE,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,aAAa,EAAE;YACrE,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;AA4KD,SAAS,CAAC,YAAY,GAAG,YAAY,CAAC;AACtC,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,SAAS,CAAC,WAAW,GAAG,WAAW,CAAC"}

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

@@ -1,5 +1,5 @@
 export { Assignments, type AssignmentListResponse, type AssignmentUpsertResponse, type AssignmentListParams, type AssignmentUpsertParams, type AssignmentListResponsesMyCursorIDPage, } from "./assignments.mjs";
-export { Customers } from "./customers.mjs";
+export { Customers, type CustomerRetrieveGovernanceResponse, type CustomerRetrieveGovernanceParams, } 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

@@ -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,EACL,SAAS,EACT,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,GACtC,wBAAoB;AACrB,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

@@ -1,5 +1,5 @@
 export { Assignments, type AssignmentListResponse, type AssignmentUpsertResponse, type AssignmentListParams, type AssignmentUpsertParams, type AssignmentListResponsesMyCursorIDPage, } from "./assignments.js";
-export { Customers } from "./customers.js";
+export { Customers, type CustomerRetrieveGovernanceResponse, type CustomerRetrieveGovernanceParams, } 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

@@ -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,EACL,SAAS,EACT,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,GACtC,uBAAoB;AACrB,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.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,4CAIqB;AAHnB,sGAAA,SAAS,OAAA;AAIX,0CAaoB;AAZlB,oGAAA,QAAQ,OAAA;AAaV,kDAA0G;AAAjG,4GAAA,YAAY,OAAA"}

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

@@ -1,6 +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 { Customers, } from "./customers.mjs";
 export { Entities, } from "./entities.mjs";
 export { Entitlements } from "./entitlements.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,EACL,SAAS,GAGV,wBAAoB;AACrB,OAAO,EACL,QAAQ,GAYT,uBAAmB;AACpB,OAAO,EAAE,YAAY,EAA8D,2BAAuB"}

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

@@ -1,4 +1,4 @@
-export { Customers } from "./customers/index.mjs";
+export { Customers, type CustomerRetrieveGovernanceResponse, type CustomerRetrieveGovernanceParams, } from "./customers/index.mjs";
 export { EntityTypes, type EntityTypeListResponse, type EntityTypeUpsertResponse, type EntityTypeListParams, type EntityTypeUpsertParams, type EntityTypeListResponsesMyCursorIDPage, } from "./entity-types.mjs";
 export { V1Beta } from "./v1-beta.mjs";
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,8BAA0B;AAC9C,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qCAAqC,GAC3C,2BAAuB;AACxB,OAAO,EAAE,MAAM,EAAE,sBAAkB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,GACtC,8BAA0B;AAC3B,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qCAAqC,GAC3C,2BAAuB;AACxB,OAAO,EAAE,MAAM,EAAE,sBAAkB"}

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

@@ -1,4 +1,4 @@
-export { Customers } from "./customers/index.js";
+export { Customers, type CustomerRetrieveGovernanceResponse, type CustomerRetrieveGovernanceParams, } from "./customers/index.js";
 export { EntityTypes, type EntityTypeListResponse, type EntityTypeUpsertResponse, type EntityTypeListParams, type EntityTypeUpsertParams, type EntityTypeListResponsesMyCursorIDPage, } from "./entity-types.js";
 export { V1Beta } from "./v1-beta.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,6BAA0B;AAC9C,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qCAAqC,GAC3C,0BAAuB;AACxB,OAAO,EAAE,MAAM,EAAE,qBAAkB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,GACtC,6BAA0B;AAC3B,OAAO,EACL,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qCAAqC,GAC3C,0BAAuB;AACxB,OAAO,EAAE,MAAM,EAAE,qBAAkB"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8CAA8C;AAArC,kGAAA,SAAS,OAAA;AAClB,kDAOwB;AANtB,2GAAA,WAAW,OAAA;AAOb,wCAAmC;AAA1B,iGAAA,MAAM,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8CAI2B;AAHzB,kGAAA,SAAS,OAAA;AAIX,kDAOwB;AANtB,2GAAA,WAAW,OAAA;AAOb,wCAAmC;AAA1B,iGAAA,MAAM,OAAA"}

package/resources/v1-beta/index.mjs

@@ -1,5 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-export { Customers } from "./customers/index.mjs";
+export { Customers, } from "./customers/index.mjs";
 export { EntityTypes, } from "./entity-types.mjs";
 export { V1Beta } from "./v1-beta.mjs";
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,SAAS,EAAE,8BAA0B;AAC9C,OAAO,EACL,WAAW,GAMZ,2BAAuB;AACxB,OAAO,EAAE,MAAM,EAAE,sBAAkB"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/v1-beta/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,SAAS,GAGV,8BAA0B;AAC3B,OAAO,EACL,WAAW,GAMZ,2BAAuB;AACxB,OAAO,EAAE,MAAM,EAAE,sBAAkB"}

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

@@ -2,13 +2,13 @@ import { APIResource } from "../../core/resource.mjs";
 import * as EntityTypesAPI from "./entity-types.mjs";
 import { EntityTypeListParams, EntityTypeListResponse, EntityTypeListResponsesMyCursorIDPage, EntityTypeUpsertParams, EntityTypeUpsertResponse, EntityTypes } from "./entity-types.mjs";
 import * as CustomersAPI from "./customers/customers.mjs";
-import { Customers } from "./customers/customers.mjs";
+import { CustomerRetrieveGovernanceParams, CustomerRetrieveGovernanceResponse, Customers } from "./customers/customers.mjs";
 export declare class V1Beta extends APIResource {
     customers: CustomersAPI.Customers;
     entityTypes: EntityTypesAPI.EntityTypes;
 }
 export declare namespace V1Beta {
-    export { Customers as Customers };
+    export { Customers as Customers, type CustomerRetrieveGovernanceResponse as CustomerRetrieveGovernanceResponse, type CustomerRetrieveGovernanceParams as CustomerRetrieveGovernanceParams, };
     export { EntityTypes as EntityTypes, type EntityTypeListResponse as EntityTypeListResponse, type EntityTypeUpsertResponse as EntityTypeUpsertResponse, type EntityTypeListResponsesMyCursorIDPage as EntityTypeListResponsesMyCursorIDPage, type EntityTypeListParams as EntityTypeListParams, type EntityTypeUpsertParams as EntityTypeUpsertParams, };
 }
 //# sourceMappingURL=v1-beta.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"v1-beta.d.mts","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,cAAc,2BAAuB;AACjD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qCAAqC,EACrC,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACZ,2BAAuB;AACxB,OAAO,KAAK,YAAY,kCAA8B;AACtD,OAAO,EAAE,SAAS,EAAE,kCAA8B;AAElD,qBAAa,MAAO,SAAQ,WAAW;IACrC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;CACxF;AAKD,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC;IAElC,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"v1-beta.d.mts","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,cAAc,2BAAuB;AACjD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qCAAqC,EACrC,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACZ,2BAAuB;AACxB,OAAO,KAAK,YAAY,kCAA8B;AACtD,OAAO,EACL,gCAAgC,EAChC,kCAAkC,EAClC,SAAS,EACV,kCAA8B;AAE/B,qBAAa,MAAO,SAAQ,WAAW;IACrC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;CACxF;AAKD,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,gCAAgC,IAAI,gCAAgC,GAC1E,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

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

@@ -2,13 +2,13 @@ import { APIResource } from "../../core/resource.js";
 import * as EntityTypesAPI from "./entity-types.js";
 import { EntityTypeListParams, EntityTypeListResponse, EntityTypeListResponsesMyCursorIDPage, EntityTypeUpsertParams, EntityTypeUpsertResponse, EntityTypes } from "./entity-types.js";
 import * as CustomersAPI from "./customers/customers.js";
-import { Customers } from "./customers/customers.js";
+import { CustomerRetrieveGovernanceParams, CustomerRetrieveGovernanceResponse, Customers } from "./customers/customers.js";
 export declare class V1Beta extends APIResource {
     customers: CustomersAPI.Customers;
     entityTypes: EntityTypesAPI.EntityTypes;
 }
 export declare namespace V1Beta {
-    export { Customers as Customers };
+    export { Customers as Customers, type CustomerRetrieveGovernanceResponse as CustomerRetrieveGovernanceResponse, type CustomerRetrieveGovernanceParams as CustomerRetrieveGovernanceParams, };
     export { EntityTypes as EntityTypes, type EntityTypeListResponse as EntityTypeListResponse, type EntityTypeUpsertResponse as EntityTypeUpsertResponse, type EntityTypeListResponsesMyCursorIDPage as EntityTypeListResponsesMyCursorIDPage, type EntityTypeListParams as EntityTypeListParams, type EntityTypeUpsertParams as EntityTypeUpsertParams, };
 }
 //# sourceMappingURL=v1-beta.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"v1-beta.d.ts","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,cAAc,0BAAuB;AACjD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qCAAqC,EACrC,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACZ,0BAAuB;AACxB,OAAO,KAAK,YAAY,iCAA8B;AACtD,OAAO,EAAE,SAAS,EAAE,iCAA8B;AAElD,qBAAa,MAAO,SAAQ,WAAW;IACrC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;CACxF;AAKD,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC;IAElC,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"v1-beta.d.ts","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,cAAc,0BAAuB;AACjD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qCAAqC,EACrC,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACZ,0BAAuB;AACxB,OAAO,KAAK,YAAY,iCAA8B;AACtD,OAAO,EACL,gCAAgC,EAChC,kCAAkC,EAClC,SAAS,EACV,iCAA8B;AAE/B,qBAAa,MAAO,SAAQ,WAAW;IACrC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAC7E,WAAW,EAAE,cAAc,CAAC,WAAW,CAAgD;CACxF;AAKD,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,gCAAgC,IAAI,gCAAgC,GAC1E,CAAC;IAEF,OAAO,EACL,WAAW,IAAI,WAAW,EAC1B,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qCAAqC,IAAI,qCAAqC,EACnF,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

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

@@ -1 +1 @@
-{"version":3,"file":"v1-beta.js","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,0EAAiD;AACjD,oDAOwB;AACxB,+EAAsD;AACtD,wDAAkD;AAElD,MAAa,MAAO,SAAQ,sBAAW;IAAvC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAHD,wBAGC;AAED,MAAM,CAAC,SAAS,GAAG,qBAAS,CAAC;AAC7B,MAAM,CAAC,WAAW,GAAG,0BAAW,CAAC"}
+{"version":3,"file":"v1-beta.js","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,0EAAiD;AACjD,oDAOwB;AACxB,+EAAsD;AACtD,wDAI+B;AAE/B,MAAa,MAAO,SAAQ,sBAAW;IAAvC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAHD,wBAGC;AAED,MAAM,CAAC,SAAS,GAAG,qBAAS,CAAC;AAC7B,MAAM,CAAC,WAAW,GAAG,0BAAW,CAAC"}

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

@@ -3,7 +3,7 @@ import { APIResource } from "../../core/resource.mjs";
 import * as EntityTypesAPI from "./entity-types.mjs";
 import { EntityTypes, } from "./entity-types.mjs";
 import * as CustomersAPI from "./customers/customers.mjs";
-import { Customers } from "./customers/customers.mjs";
+import { Customers, } from "./customers/customers.mjs";
 export class V1Beta extends APIResource {
     constructor() {
         super(...arguments);

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

@@ -1 +1 @@
-{"version":3,"file":"v1-beta.mjs","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,cAAc,2BAAuB;AACjD,OAAO,EAML,WAAW,GACZ,2BAAuB;AACxB,OAAO,KAAK,YAAY,kCAA8B;AACtD,OAAO,EAAE,SAAS,EAAE,kCAA8B;AAElD,MAAM,OAAO,MAAO,SAAQ,WAAW;IAAvC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAED,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;AAC7B,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC"}
+{"version":3,"file":"v1-beta.mjs","sourceRoot":"","sources":["../../src/resources/v1-beta/v1-beta.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,cAAc,2BAAuB;AACjD,OAAO,EAML,WAAW,GACZ,2BAAuB;AACxB,OAAO,KAAK,YAAY,kCAA8B;AACtD,OAAO,EAGL,SAAS,GACV,kCAA8B;AAE/B,MAAM,OAAO,MAAO,SAAQ,WAAW;IAAvC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;CAAA;AAED,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;AAC7B,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC"}

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

@@ -1,8 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
-import * as BetaAPI from './beta/beta';
-import { Beta } from './beta/beta';
 import * as DataExportAPI from './data-export/data-export';
 import {
   DataExport,
@@ -22,7 +20,6 @@ import { RequestOptions } from '../../../internal/request-options';
  */
 export class Events extends APIResource {
   dataExport: DataExportAPI.DataExport = new DataExportAPI.DataExport(this._client);
-  beta: BetaAPI.Beta = new BetaAPI.Beta(this._client);
 
   /**
    * Estimates the credit cost of a usage event without ingesting it. Returns the
@@ -251,7 +248,6 @@ export namespace EventReportParams {
 }
 
 Events.DataExport = DataExport;
-Events.Beta = Beta;
 
 export declare namespace Events {
   export {
@@ -270,6 +266,4 @@ export declare namespace Events {
     type DataExportMintScopedTokenParams as DataExportMintScopedTokenParams,
     type DataExportTriggerSyncParams as DataExportTriggerSyncParams,
   };
-
-  export { Beta as Beta };
 }

package/src/resources/v1/events/index.ts

@@ -1,6 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Beta } from './beta/index';
 export {
   DataExport,
   type DataExportListModelsResponse,

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

@@ -27,11 +27,217 @@ import {
 } from './entities';
 import * as EntitlementsAPI from './entitlements';
 import { EntitlementCheckParams, EntitlementCheckResponse, Entitlements } from './entitlements';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
 
 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);
+
+  /**
+   * 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
+   * const response =
+   *   await client.v1Beta.customers.retrieveGovernance('id');
+   * ```
+   */
+  retrieveGovernance(
+    id: string,
+    params: CustomerRetrieveGovernanceParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CustomerRetrieveGovernanceResponse> {
+    const { 'X-ACCOUNT-ID': xAccountID, 'X-ENVIRONMENT-ID': xEnvironmentID, ...query } = params ?? {};
+    return this._client.get(path`/api/v1-beta/customers/${id}/governance`, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAccountID != null ? { 'X-ACCOUNT-ID': xAccountID } : undefined),
+          ...(xEnvironmentID != null ? { 'X-ENVIRONMENT-ID': xEnvironmentID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+/**
+ * Paginated list of governance tree nodes, each with its usage configuration and
+ * current usage.
+ */
+export interface CustomerRetrieveGovernanceResponse {
+  data: Array<CustomerRetrieveGovernanceResponse.Data>;
+
+  pagination: CustomerRetrieveGovernanceResponse.Pagination;
+}
+
+export namespace CustomerRetrieveGovernanceResponse {
+  /**
+   * 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 Data {
+    /**
+     * 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;
+
+    /**
+     * 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` for a root. 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 — when usage resets; `null` once the period
+     * has rolled over.
+     */
+    usagePeriodEnd: string | null;
+
+    /**
+     * Start of the cadence period the usage snapshot belongs to; `null` once the
+     * period has rolled over.
+     */
+    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 Pagination {
+    /**
+     * Cursor for fetching the next page of results, or null if no additional pages
+     * exist
+     */
+    next: string | null;
+  }
+}
+
+export interface CustomerRetrieveGovernanceParams {
+  /**
+   * Query param: Return items that come after this cursor
+   */
+  after?: string;
+
+  /**
+   * Query param: Currency ids to include, repeated per value (e.g.
+   * `?currencyIds=credits`). Omit both featureIds and currencyIds for tree mode.
+   */
+  currencyIds?: Array<string>;
+
+  /**
+   * Query param: Case-insensitive substring match on the entity id (`%`/`_` matched
+   * literally).
+   */
+  entityIdSearch?: string;
+
+  /**
+   * Query param: Filter to one or more entity types, repeated per value (e.g.
+   * `?entityTypeIds=team&entityTypeIds=user`).
+   */
+  entityTypeIds?: Array<string>;
+
+  /**
+   * Query param: Feature ids to include, repeated per value (e.g.
+   * `?featureIds=ai-tokens&featureIds=seats`). Omit both featureIds and currencyIds
+   * for tree mode — every node in the hierarchy with no usage configuration
+   * attached.
+   */
+  featureIds?: Array<string>;
+
+  /**
+   * Query param: Maximum number of items to return
+   */
+  limit?: number;
+
+  /**
+   * 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;
 }
 
 Customers.Entitlements = Entitlements;
@@ -39,6 +245,11 @@ Customers.Entities = Entities;
 Customers.Assignments = Assignments;
 
 export declare namespace Customers {
+  export {
+    type CustomerRetrieveGovernanceResponse as CustomerRetrieveGovernanceResponse,
+    type CustomerRetrieveGovernanceParams as CustomerRetrieveGovernanceParams,
+  };
+
   export {
     Entitlements as Entitlements,
     type EntitlementCheckResponse as EntitlementCheckResponse,

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

@@ -8,7 +8,11 @@ export {
   type AssignmentUpsertParams,
   type AssignmentListResponsesMyCursorIDPage,
 } from './assignments';
-export { Customers } from './customers';
+export {
+  Customers,
+  type CustomerRetrieveGovernanceResponse,
+  type CustomerRetrieveGovernanceParams,
+} from './customers';
 export {
   Entities,
   type EntityRetrieveResponse,

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

@@ -1,6 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Customers } from './customers/index';
+export {
+  Customers,
+  type CustomerRetrieveGovernanceResponse,
+  type CustomerRetrieveGovernanceParams,
+} from './customers/index';
 export {
   EntityTypes,
   type EntityTypeListResponse,

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

@@ -11,7 +11,11 @@ import {
   EntityTypes,
 } from './entity-types';
 import * as CustomersAPI from './customers/customers';
-import { Customers } from './customers/customers';
+import {
+  CustomerRetrieveGovernanceParams,
+  CustomerRetrieveGovernanceResponse,
+  Customers,
+} from './customers/customers';
 
 export class V1Beta extends APIResource {
   customers: CustomersAPI.Customers = new CustomersAPI.Customers(this._client);
@@ -22,7 +26,11 @@ V1Beta.Customers = Customers;
 V1Beta.EntityTypes = EntityTypes;
 
 export declare namespace V1Beta {
-  export { Customers as Customers };
+  export {
+    Customers as Customers,
+    type CustomerRetrieveGovernanceResponse as CustomerRetrieveGovernanceResponse,
+    type CustomerRetrieveGovernanceParams as CustomerRetrieveGovernanceParams,
+  };
 
   export {
     EntityTypes as EntityTypes,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-beta.43'; // x-release-please-version
+export const VERSION = '0.1.0-beta.44'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-beta.43";
+export declare const VERSION = "0.1.0-beta.44";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-beta.43";
+export declare const VERSION = "0.1.0-beta.44";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.1.0-beta.43'; // x-release-please-version
+exports.VERSION = '0.1.0-beta.44'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-beta.43'; // x-release-please-version
+export const VERSION = '0.1.0-beta.44'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map

package/resources/v1/events/beta/beta.d.mts

@@ -1,10 +0,0 @@
-import { APIResource } from "../../../../core/resource.mjs";
-import * as CustomersAPI from "./customers.mjs";
-import { CustomerRetrieveGovernanceParams, CustomerRetrieveGovernanceResponse, Customers } from "./customers.mjs";
-export declare class Beta extends APIResource {
-    customers: CustomersAPI.Customers;
-}
-export declare namespace Beta {
-    export { Customers as Customers, type CustomerRetrieveGovernanceResponse as CustomerRetrieveGovernanceResponse, type CustomerRetrieveGovernanceParams as CustomerRetrieveGovernanceParams, };
-}
-//# sourceMappingURL=beta.d.mts.map