bem-ai-sdk 0.26.0 → 0.27.0

package/resources/entity-types/entity-types.js

@@ -0,0 +1,104 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityTypes = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const ReviewersAPI = tslib_1.__importStar(require("./reviewers.js"));
+const reviewers_1 = require("./reviewers.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Entity Types are the customer-defined taxonomy for the knowledge graph,
+ * scoped to an account+environment. Each type has a unique, immutable name
+ * and can be organised into hierarchies via `parentTypeID`. A type may
+ * carry per-type structured attribute metadata in `attributeSchema` (for
+ * example `{"unit": "mg", "range": [0, 100]}`).
+ *
+ * Use these endpoints to create, list, fetch, update, and delete entity
+ * types:
+ *
+ * - **`POST /v3/entity-types`** creates a type, optionally under a parent.
+ * - **`GET /v3/entity-types`** lists types with cursor pagination
+ *   (`startingAfter` / `endingBefore` over `typeID`) and an optional
+ *   `parentTypeId` filter for direct children.
+ * - **`PATCH /v3/entity-types/{typeID}`** updates `description`,
+ *   `parentTypeID`, and/or `attributeSchema`. The `name` is immutable.
+ * - **`DELETE /v3/entity-types/{typeID}`** soft-deletes a type. The request
+ *   is rejected with `409 Conflict` while any live entity is assigned to
+ *   the type or any live child type points at it.
+ */
+class EntityTypes extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.reviewers = new ReviewersAPI.Reviewers(this._client);
+    }
+    /**
+     * Create an Entity Type
+     *
+     * @example
+     * ```ts
+     * const entityType = await client.entityTypes.create({
+     *   name: 'Drug',
+     *   description: 'A pharmaceutical compound',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v3/entity-types', { body, ...options });
+    }
+    /**
+     * Get an Entity Type
+     *
+     * @example
+     * ```ts
+     * const entityType = await client.entityTypes.retrieve(
+     *   'typeID',
+     * );
+     * ```
+     */
+    retrieve(typeID, options) {
+        return this._client.get((0, path_1.path) `/v3/entity-types/${typeID}`, options);
+    }
+    /**
+     * Update an Entity Type
+     *
+     * @example
+     * ```ts
+     * const entityType = await client.entityTypes.update(
+     *   'typeID',
+     * );
+     * ```
+     */
+    update(typeID, body, options) {
+        return this._client.patch((0, path_1.path) `/v3/entity-types/${typeID}`, { body, ...options });
+    }
+    /**
+     * List Entity Types
+     *
+     * @example
+     * ```ts
+     * const entityTypes = await client.entityTypes.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v3/entity-types', { query, ...options });
+    }
+    /**
+     * Delete an Entity Type
+     *
+     * @example
+     * ```ts
+     * await client.entityTypes.delete('typeID');
+     * ```
+     */
+    delete(typeID, options) {
+        return this._client.delete((0, path_1.path) `/v3/entity-types/${typeID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.EntityTypes = EntityTypes;
+EntityTypes.Reviewers = reviewers_1.Reviewers;
+//# sourceMappingURL=entity-types.js.map

package/resources/entity-types/entity-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-types.js","sourceRoot":"","sources":["../../src/resources/entity-types/entity-types.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,qEAA4C;AAC5C,8CAMqB;AAErB,uDAAsD;AAEtD,uDAAiD;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,WAAY,SAAQ,sBAAW;IAA5C;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA8E/E,CAAC;IA5EC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,MAAc,EACd,IAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,MAAM,EAAE,EAAE;YAC3D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA/ED,kCA+EC;AAoQD,WAAW,CAAC,SAAS,GAAG,qBAAS,CAAC"}

package/resources/entity-types/entity-types.mjs

@@ -0,0 +1,99 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as ReviewersAPI from "./reviewers.mjs";
+import { Reviewers, } from "./reviewers.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Entity Types are the customer-defined taxonomy for the knowledge graph,
+ * scoped to an account+environment. Each type has a unique, immutable name
+ * and can be organised into hierarchies via `parentTypeID`. A type may
+ * carry per-type structured attribute metadata in `attributeSchema` (for
+ * example `{"unit": "mg", "range": [0, 100]}`).
+ *
+ * Use these endpoints to create, list, fetch, update, and delete entity
+ * types:
+ *
+ * - **`POST /v3/entity-types`** creates a type, optionally under a parent.
+ * - **`GET /v3/entity-types`** lists types with cursor pagination
+ *   (`startingAfter` / `endingBefore` over `typeID`) and an optional
+ *   `parentTypeId` filter for direct children.
+ * - **`PATCH /v3/entity-types/{typeID}`** updates `description`,
+ *   `parentTypeID`, and/or `attributeSchema`. The `name` is immutable.
+ * - **`DELETE /v3/entity-types/{typeID}`** soft-deletes a type. The request
+ *   is rejected with `409 Conflict` while any live entity is assigned to
+ *   the type or any live child type points at it.
+ */
+export class EntityTypes extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.reviewers = new ReviewersAPI.Reviewers(this._client);
+    }
+    /**
+     * Create an Entity Type
+     *
+     * @example
+     * ```ts
+     * const entityType = await client.entityTypes.create({
+     *   name: 'Drug',
+     *   description: 'A pharmaceutical compound',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v3/entity-types', { body, ...options });
+    }
+    /**
+     * Get an Entity Type
+     *
+     * @example
+     * ```ts
+     * const entityType = await client.entityTypes.retrieve(
+     *   'typeID',
+     * );
+     * ```
+     */
+    retrieve(typeID, options) {
+        return this._client.get(path `/v3/entity-types/${typeID}`, options);
+    }
+    /**
+     * Update an Entity Type
+     *
+     * @example
+     * ```ts
+     * const entityType = await client.entityTypes.update(
+     *   'typeID',
+     * );
+     * ```
+     */
+    update(typeID, body, options) {
+        return this._client.patch(path `/v3/entity-types/${typeID}`, { body, ...options });
+    }
+    /**
+     * List Entity Types
+     *
+     * @example
+     * ```ts
+     * const entityTypes = await client.entityTypes.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v3/entity-types', { query, ...options });
+    }
+    /**
+     * Delete an Entity Type
+     *
+     * @example
+     * ```ts
+     * await client.entityTypes.delete('typeID');
+     * ```
+     */
+    delete(typeID, options) {
+        return this._client.delete(path `/v3/entity-types/${typeID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+EntityTypes.Reviewers = Reviewers;
+//# sourceMappingURL=entity-types.mjs.map

package/resources/entity-types/entity-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-types.mjs","sourceRoot":"","sources":["../../src/resources/entity-types/entity-types.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,YAAY,wBAAoB;AAC5C,OAAO,EAKL,SAAS,GACV,wBAAoB;AAErB,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAA5C;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA8E/E,CAAC;IA5EC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,MAAc,EACd,IAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAc,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,MAAM,EAAE,EAAE;YAC3D,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAoQD,WAAW,CAAC,SAAS,GAAG,SAAS,CAAC"}

package/resources/entity-types/index.d.mts

@@ -0,0 +1,3 @@
+export { EntityTypes, type EntityTypeCreateResponse, type EntityTypeRetrieveResponse, type EntityTypeUpdateResponse, type EntityTypeListResponse, type EntityTypeCreateParams, type EntityTypeUpdateParams, type EntityTypeListParams, } from "./entity-types.mjs";
+export { Reviewers, type ReviewerListResponse, type ReviewerAssignResponse, type ReviewerAssignParams, type ReviewerRemoveParams, } from "./reviewers.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/entity-types/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/entity-types/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,2BAAuB;AACxB,OAAO,EACL,SAAS,EACT,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,wBAAoB"}

package/resources/entity-types/index.d.ts

@@ -0,0 +1,3 @@
+export { EntityTypes, type EntityTypeCreateResponse, type EntityTypeRetrieveResponse, type EntityTypeUpdateResponse, type EntityTypeListResponse, type EntityTypeCreateParams, type EntityTypeUpdateParams, type EntityTypeListParams, } from "./entity-types.js";
+export { Reviewers, type ReviewerListResponse, type ReviewerAssignResponse, type ReviewerAssignParams, type ReviewerRemoveParams, } from "./reviewers.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/entity-types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/entity-types/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,0BAAuB;AACxB,OAAO,EACL,SAAS,EACT,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,uBAAoB"}

package/resources/entity-types/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reviewers = exports.EntityTypes = void 0;
+var entity_types_1 = require("./entity-types.js");
+Object.defineProperty(exports, "EntityTypes", { enumerable: true, get: function () { return entity_types_1.EntityTypes; } });
+var reviewers_1 = require("./reviewers.js");
+Object.defineProperty(exports, "Reviewers", { enumerable: true, get: function () { return reviewers_1.Reviewers; } });
+//# sourceMappingURL=index.js.map

package/resources/entity-types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/entity-types/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDASwB;AARtB,2GAAA,WAAW,OAAA;AASb,4CAMqB;AALnB,sGAAA,SAAS,OAAA"}

package/resources/entity-types/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { EntityTypes, } from "./entity-types.mjs";
+export { Reviewers, } from "./reviewers.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/entity-types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/entity-types/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,WAAW,GAQZ,2BAAuB;AACxB,OAAO,EACL,SAAS,GAKV,wBAAoB"}

package/resources/entity-types/reviewers.d.mts

@@ -0,0 +1,136 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Reviewer assignments link users to the entity types they are responsible
+ * for reviewing, scoped to an account+environment. These are dashboard-only
+ * endpoints: an assignment needs a user identity, which only the dashboard
+ * (JWT) surface carries.
+ *
+ * - **`POST /v3/entity-types/{typeID}/reviewers`** assigns a user as a
+ *   reviewer of the type. The assignment is idempotent: re-assigning an
+ *   existing reviewer returns the existing assignment. Requires the `admin`
+ *   role.
+ * - **`GET /v3/entity-types/{typeID}/reviewers`** lists the users assigned
+ *   to review the type, with each user's email and role. Requires the
+ *   `operator` role.
+ * - **`DELETE /v3/entity-types/{typeID}/reviewers/{userID}`** removes an
+ *   assignment. Requires the `admin` role.
+ * - **`GET /v3/users/{userID}/reviewer-assignments`** is the reverse lookup:
+ *   the entity types a user reviews. A user may read their own assignments;
+ *   reading another user's assignments requires the `admin` role.
+ */
+export declare class Reviewers extends APIResource {
+    /**
+     * List Reviewers
+     *
+     * @example
+     * ```ts
+     * const reviewers = await client.entityTypes.reviewers.list(
+     *   'typeID',
+     * );
+     * ```
+     */
+    list(typeID: string, options?: RequestOptions): APIPromise<ReviewerListResponse>;
+    /**
+     * Assign a Reviewer
+     *
+     * @example
+     * ```ts
+     * const response = await client.entityTypes.reviewers.assign(
+     *   'typeID',
+     *   { userID: 'usr_2xyz...' },
+     * );
+     * ```
+     */
+    assign(typeID: string, body: ReviewerAssignParams, options?: RequestOptions): APIPromise<ReviewerAssignResponse>;
+    /**
+     * Remove a Reviewer
+     *
+     * @example
+     * ```ts
+     * await client.entityTypes.reviewers.remove('userID', {
+     *   typeID: 'typeID',
+     * });
+     * ```
+     */
+    remove(userID: string, params: ReviewerRemoveParams, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * Response body for listing the reviewers of an entity type.
+ */
+export interface ReviewerListResponse {
+    reviewers: Array<ReviewerListResponse.Reviewer>;
+}
+export declare namespace ReviewerListResponse {
+    /**
+     * A reviewer assignment links a user to an entity type they are responsible for
+     * reviewing. The assignment is scoped to an account+environment and is unique per
+     * (entity type, user).
+     */
+    interface Reviewer {
+        /**
+         * When the assignment was created (RFC 3339).
+         */
+        createdAt: string;
+        /**
+         * The assigned user's email.
+         */
+        email: string;
+        /**
+         * Stable public identifier for the assignment (`etr_...`).
+         */
+        reviewerID: string;
+        /**
+         * The assigned user's account role (for example `operator`, `admin`).
+         */
+        role: string;
+        /**
+         * Public identifier of the assigned user (`usr_...`).
+         */
+        userID: string;
+    }
+}
+/**
+ * A reviewer assignment links a user to an entity type they are responsible for
+ * reviewing. The assignment is scoped to an account+environment and is unique per
+ * (entity type, user).
+ */
+export interface ReviewerAssignResponse {
+    /**
+     * When the assignment was created (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * The assigned user's email.
+     */
+    email: string;
+    /**
+     * Stable public identifier for the assignment (`etr_...`).
+     */
+    reviewerID: string;
+    /**
+     * The assigned user's account role (for example `operator`, `admin`).
+     */
+    role: string;
+    /**
+     * Public identifier of the assigned user (`usr_...`).
+     */
+    userID: string;
+}
+export interface ReviewerAssignParams {
+    /**
+     * Public ID (`usr_...`) of the user to assign. Must belong to the account.
+     */
+    userID: string;
+}
+export interface ReviewerRemoveParams {
+    /**
+     * Entity type public ID (`ety_...`).
+     */
+    typeID: string;
+}
+export declare namespace Reviewers {
+    export { type ReviewerListResponse as ReviewerListResponse, type ReviewerAssignResponse as ReviewerAssignResponse, type ReviewerAssignParams as ReviewerAssignParams, type ReviewerRemoveParams as ReviewerRemoveParams, };
+}
+//# sourceMappingURL=reviewers.d.mts.map

package/resources/entity-types/reviewers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.d.mts","sourceRoot":"","sources":["../../src/resources/entity-types/reviewers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAIhF;;;;;;;;;;OAUG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;IAIrC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOjG;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CACjD;AAED,yBAAiB,oBAAoB,CAAC;IACpC;;;;OAIG;IACH,UAAiB,QAAQ;QACvB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;KAChB;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/entity-types/reviewers.d.ts

@@ -0,0 +1,136 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Reviewer assignments link users to the entity types they are responsible
+ * for reviewing, scoped to an account+environment. These are dashboard-only
+ * endpoints: an assignment needs a user identity, which only the dashboard
+ * (JWT) surface carries.
+ *
+ * - **`POST /v3/entity-types/{typeID}/reviewers`** assigns a user as a
+ *   reviewer of the type. The assignment is idempotent: re-assigning an
+ *   existing reviewer returns the existing assignment. Requires the `admin`
+ *   role.
+ * - **`GET /v3/entity-types/{typeID}/reviewers`** lists the users assigned
+ *   to review the type, with each user's email and role. Requires the
+ *   `operator` role.
+ * - **`DELETE /v3/entity-types/{typeID}/reviewers/{userID}`** removes an
+ *   assignment. Requires the `admin` role.
+ * - **`GET /v3/users/{userID}/reviewer-assignments`** is the reverse lookup:
+ *   the entity types a user reviews. A user may read their own assignments;
+ *   reading another user's assignments requires the `admin` role.
+ */
+export declare class Reviewers extends APIResource {
+    /**
+     * List Reviewers
+     *
+     * @example
+     * ```ts
+     * const reviewers = await client.entityTypes.reviewers.list(
+     *   'typeID',
+     * );
+     * ```
+     */
+    list(typeID: string, options?: RequestOptions): APIPromise<ReviewerListResponse>;
+    /**
+     * Assign a Reviewer
+     *
+     * @example
+     * ```ts
+     * const response = await client.entityTypes.reviewers.assign(
+     *   'typeID',
+     *   { userID: 'usr_2xyz...' },
+     * );
+     * ```
+     */
+    assign(typeID: string, body: ReviewerAssignParams, options?: RequestOptions): APIPromise<ReviewerAssignResponse>;
+    /**
+     * Remove a Reviewer
+     *
+     * @example
+     * ```ts
+     * await client.entityTypes.reviewers.remove('userID', {
+     *   typeID: 'typeID',
+     * });
+     * ```
+     */
+    remove(userID: string, params: ReviewerRemoveParams, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * Response body for listing the reviewers of an entity type.
+ */
+export interface ReviewerListResponse {
+    reviewers: Array<ReviewerListResponse.Reviewer>;
+}
+export declare namespace ReviewerListResponse {
+    /**
+     * A reviewer assignment links a user to an entity type they are responsible for
+     * reviewing. The assignment is scoped to an account+environment and is unique per
+     * (entity type, user).
+     */
+    interface Reviewer {
+        /**
+         * When the assignment was created (RFC 3339).
+         */
+        createdAt: string;
+        /**
+         * The assigned user's email.
+         */
+        email: string;
+        /**
+         * Stable public identifier for the assignment (`etr_...`).
+         */
+        reviewerID: string;
+        /**
+         * The assigned user's account role (for example `operator`, `admin`).
+         */
+        role: string;
+        /**
+         * Public identifier of the assigned user (`usr_...`).
+         */
+        userID: string;
+    }
+}
+/**
+ * A reviewer assignment links a user to an entity type they are responsible for
+ * reviewing. The assignment is scoped to an account+environment and is unique per
+ * (entity type, user).
+ */
+export interface ReviewerAssignResponse {
+    /**
+     * When the assignment was created (RFC 3339).
+     */
+    createdAt: string;
+    /**
+     * The assigned user's email.
+     */
+    email: string;
+    /**
+     * Stable public identifier for the assignment (`etr_...`).
+     */
+    reviewerID: string;
+    /**
+     * The assigned user's account role (for example `operator`, `admin`).
+     */
+    role: string;
+    /**
+     * Public identifier of the assigned user (`usr_...`).
+     */
+    userID: string;
+}
+export interface ReviewerAssignParams {
+    /**
+     * Public ID (`usr_...`) of the user to assign. Must belong to the account.
+     */
+    userID: string;
+}
+export interface ReviewerRemoveParams {
+    /**
+     * Entity type public ID (`ety_...`).
+     */
+    typeID: string;
+}
+export declare namespace Reviewers {
+    export { type ReviewerListResponse as ReviewerListResponse, type ReviewerAssignResponse as ReviewerAssignResponse, type ReviewerAssignParams as ReviewerAssignParams, type ReviewerRemoveParams as ReviewerRemoveParams, };
+}
+//# sourceMappingURL=reviewers.d.ts.map

package/resources/entity-types/reviewers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.d.ts","sourceRoot":"","sources":["../../src/resources/entity-types/reviewers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAIhF;;;;;;;;;;OAUG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,sBAAsB,CAAC;IAIrC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOjG;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CACjD;AAED,yBAAiB,oBAAoB,CAAC;IACpC;;;;OAIG;IACH,UAAiB,QAAQ;QACvB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;KAChB;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/entity-types/reviewers.js

@@ -0,0 +1,74 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reviewers = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Reviewer assignments link users to the entity types they are responsible
+ * for reviewing, scoped to an account+environment. These are dashboard-only
+ * endpoints: an assignment needs a user identity, which only the dashboard
+ * (JWT) surface carries.
+ *
+ * - **`POST /v3/entity-types/{typeID}/reviewers`** assigns a user as a
+ *   reviewer of the type. The assignment is idempotent: re-assigning an
+ *   existing reviewer returns the existing assignment. Requires the `admin`
+ *   role.
+ * - **`GET /v3/entity-types/{typeID}/reviewers`** lists the users assigned
+ *   to review the type, with each user's email and role. Requires the
+ *   `operator` role.
+ * - **`DELETE /v3/entity-types/{typeID}/reviewers/{userID}`** removes an
+ *   assignment. Requires the `admin` role.
+ * - **`GET /v3/users/{userID}/reviewer-assignments`** is the reverse lookup:
+ *   the entity types a user reviews. A user may read their own assignments;
+ *   reading another user's assignments requires the `admin` role.
+ */
+class Reviewers extends resource_1.APIResource {
+    /**
+     * List Reviewers
+     *
+     * @example
+     * ```ts
+     * const reviewers = await client.entityTypes.reviewers.list(
+     *   'typeID',
+     * );
+     * ```
+     */
+    list(typeID, options) {
+        return this._client.get((0, path_1.path) `/v3/entity-types/${typeID}/reviewers`, options);
+    }
+    /**
+     * Assign a Reviewer
+     *
+     * @example
+     * ```ts
+     * const response = await client.entityTypes.reviewers.assign(
+     *   'typeID',
+     *   { userID: 'usr_2xyz...' },
+     * );
+     * ```
+     */
+    assign(typeID, body, options) {
+        return this._client.post((0, path_1.path) `/v3/entity-types/${typeID}/reviewers`, { body, ...options });
+    }
+    /**
+     * Remove a Reviewer
+     *
+     * @example
+     * ```ts
+     * await client.entityTypes.reviewers.remove('userID', {
+     *   typeID: 'typeID',
+     * });
+     * ```
+     */
+    remove(userID, params, options) {
+        const { typeID } = params;
+        return this._client.delete((0, path_1.path) `/v3/entity-types/${typeID}/reviewers/${userID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Reviewers = Reviewers;
+//# sourceMappingURL=reviewers.js.map

package/resources/entity-types/reviewers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.js","sourceRoot":"","sources":["../../src/resources/entity-types/reviewers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAc,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,MAAM,YAAY,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,MAAc,EACd,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,MAAM,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAc,EAAE,MAA4B,EAAE,OAAwB;QAC3E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,MAAM,cAAc,MAAM,EAAE,EAAE;YAC/E,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAnDD,8BAmDC"}