@augno/sdk 0.1.6

package/resources/identity/roles.d.mts

@@ -0,0 +1,185 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as APIKeysAPI from "../auth/api-keys/api-keys.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * List and manage roles.
+ */
+export declare class Roles extends APIResource {
+    /**
+     * Creates a new role with the specified permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.create({
+     *   name: 'Warehouse Manager',
+     *   permissions: [
+     *     'customers:create',
+     *     'customers:read',
+     *     'customers:update',
+     *     'invoices:read',
+     *   ],
+     * });
+     * ```
+     */
+    create(params: RoleCreateParams, options?: RequestOptions): APIPromise<APIKeysAPI.Role>;
+    /**
+     * Returns a role by ID, including its structured permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.retrieve(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    retrieve(id: string, query?: RoleRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<APIKeysAPI.Role>;
+    /**
+     * Partially updates a custom role's name or permissions. Provided permissions
+     * replace all existing ones; global roles cannot be modified.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.update(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     *   {
+     *     name: 'Updated Manager',
+     *     permissions: ['customers:read', 'customers:update'],
+     *   },
+     * );
+     * ```
+     */
+    update(id: string, params?: RoleUpdateParams | null | undefined, options?: RequestOptions): APIPromise<APIKeysAPI.Role>;
+    /**
+     * Returns a paginated list of roles for the target account, including global
+     * roles.
+     *
+     * @example
+     * ```ts
+     * const listRole = await client.identity.roles.list();
+     * ```
+     */
+    list(query?: RoleListParams | null | undefined, options?: RequestOptions): APIPromise<ListRole>;
+    /**
+     * Deletes a role and its associated permissions. Global roles cannot be deleted.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.delete(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<RoleDeleteResponse>;
+}
+/**
+ * CreateRoleRequest is a request to create a role.
+ */
+export interface CreateRoleRequest {
+    /**
+     * Display name.
+     */
+    name: string;
+    /**
+     * Permissions to attach in `<domain>:<action>` format.
+     */
+    permissions: Array<string>;
+}
+/**
+ * List represents a paginated list of resources.
+ */
+export interface ListRole {
+    /**
+     * Resources in this page.
+     */
+    data: Array<APIKeysAPI.Role>;
+    /**
+     * Resource type identifier.
+     */
+    object: 'list';
+    /**
+     * PageInfo contains URL-based pagination metadata.
+     */
+    page_info: APIKeysAPI.PageInfo;
+}
+/**
+ * UpdateRoleRequest is a request to update a role.
+ */
+export interface UpdateRoleRequest {
+    /**
+     * Display name.
+     */
+    name?: string;
+    /**
+     * Permissions in `<domain>:<action>` format. Replaces all existing permissions;
+     * omit to leave unchanged.
+     */
+    permissions?: Array<string>;
+}
+export interface RoleDeleteResponse {
+}
+export interface RoleCreateParams {
+    /**
+     * Body param: Display name.
+     */
+    name: string;
+    /**
+     * Body param: Permissions to attach in `<domain>:<action>` format.
+     */
+    permissions: Array<string>;
+    /**
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+}
+export interface RoleRetrieveParams {
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+}
+export interface RoleUpdateParams {
+    /**
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+    /**
+     * Body param: Display name.
+     */
+    name?: string;
+    /**
+     * Body param: Permissions in `<domain>:<action>` format. Replaces all existing
+     * permissions; omit to leave unchanged.
+     */
+    permissions?: Array<string>;
+}
+export interface RoleListParams {
+    /**
+     * Cursor token used to retrieve the next or previous page of results.
+     */
+    cursor?: string;
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+    /**
+     * Maximum number of results per page (default: 100, max: 1000).
+     */
+    limit?: number;
+    /**
+     * Search query used to filter results.
+     */
+    q?: string;
+    /**
+     * Filter by role types.
+     */
+    types?: Array<'admin' | 'user' | 'scanner' | 'sales_rep' | 'agent'>;
+}
+export declare namespace Roles {
+    export { type CreateRoleRequest as CreateRoleRequest, type ListRole as ListRole, type UpdateRoleRequest as UpdateRoleRequest, type RoleDeleteResponse as RoleDeleteResponse, type RoleCreateParams as RoleCreateParams, type RoleRetrieveParams as RoleRetrieveParams, type RoleUpdateParams as RoleUpdateParams, type RoleListParams as RoleListParams, };
+}
+//# sourceMappingURL=roles.d.mts.map

package/resources/identity/roles.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.mts","sourceRoot":"","sources":["../../src/resources/identity/roles.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,UAAU,sCAAkC;AACxD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;IAKvF;;;;;;;;;OASG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;IAI9B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,gBAAgB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;IAK9B;;;;;;;;OAQG;IACH,IAAI,CAAC,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC;IAInG;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;CAG7E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;CAAG;AAEtC,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,aAAa,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,aAAa,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,aAAa,CAAC,CAAC;IAE3D;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,eAAe,GAAG,aAAa,CAAC,CAAC;IAE3D;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC,CAAC;CACrE;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/identity/roles.d.ts

@@ -0,0 +1,185 @@
+import { APIResource } from "../../core/resource.js";
+import * as APIKeysAPI from "../auth/api-keys/api-keys.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * List and manage roles.
+ */
+export declare class Roles extends APIResource {
+    /**
+     * Creates a new role with the specified permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.create({
+     *   name: 'Warehouse Manager',
+     *   permissions: [
+     *     'customers:create',
+     *     'customers:read',
+     *     'customers:update',
+     *     'invoices:read',
+     *   ],
+     * });
+     * ```
+     */
+    create(params: RoleCreateParams, options?: RequestOptions): APIPromise<APIKeysAPI.Role>;
+    /**
+     * Returns a role by ID, including its structured permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.retrieve(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    retrieve(id: string, query?: RoleRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<APIKeysAPI.Role>;
+    /**
+     * Partially updates a custom role's name or permissions. Provided permissions
+     * replace all existing ones; global roles cannot be modified.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.update(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     *   {
+     *     name: 'Updated Manager',
+     *     permissions: ['customers:read', 'customers:update'],
+     *   },
+     * );
+     * ```
+     */
+    update(id: string, params?: RoleUpdateParams | null | undefined, options?: RequestOptions): APIPromise<APIKeysAPI.Role>;
+    /**
+     * Returns a paginated list of roles for the target account, including global
+     * roles.
+     *
+     * @example
+     * ```ts
+     * const listRole = await client.identity.roles.list();
+     * ```
+     */
+    list(query?: RoleListParams | null | undefined, options?: RequestOptions): APIPromise<ListRole>;
+    /**
+     * Deletes a role and its associated permissions. Global roles cannot be deleted.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.delete(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<RoleDeleteResponse>;
+}
+/**
+ * CreateRoleRequest is a request to create a role.
+ */
+export interface CreateRoleRequest {
+    /**
+     * Display name.
+     */
+    name: string;
+    /**
+     * Permissions to attach in `<domain>:<action>` format.
+     */
+    permissions: Array<string>;
+}
+/**
+ * List represents a paginated list of resources.
+ */
+export interface ListRole {
+    /**
+     * Resources in this page.
+     */
+    data: Array<APIKeysAPI.Role>;
+    /**
+     * Resource type identifier.
+     */
+    object: 'list';
+    /**
+     * PageInfo contains URL-based pagination metadata.
+     */
+    page_info: APIKeysAPI.PageInfo;
+}
+/**
+ * UpdateRoleRequest is a request to update a role.
+ */
+export interface UpdateRoleRequest {
+    /**
+     * Display name.
+     */
+    name?: string;
+    /**
+     * Permissions in `<domain>:<action>` format. Replaces all existing permissions;
+     * omit to leave unchanged.
+     */
+    permissions?: Array<string>;
+}
+export interface RoleDeleteResponse {
+}
+export interface RoleCreateParams {
+    /**
+     * Body param: Display name.
+     */
+    name: string;
+    /**
+     * Body param: Permissions to attach in `<domain>:<action>` format.
+     */
+    permissions: Array<string>;
+    /**
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+}
+export interface RoleRetrieveParams {
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+}
+export interface RoleUpdateParams {
+    /**
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+    /**
+     * Body param: Display name.
+     */
+    name?: string;
+    /**
+     * Body param: Permissions in `<domain>:<action>` format. Replaces all existing
+     * permissions; omit to leave unchanged.
+     */
+    permissions?: Array<string>;
+}
+export interface RoleListParams {
+    /**
+     * Cursor token used to retrieve the next or previous page of results.
+     */
+    cursor?: string;
+    /**
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
+     */
+    include?: Array<'owner' | 'owner.account' | 'permissions'>;
+    /**
+     * Maximum number of results per page (default: 100, max: 1000).
+     */
+    limit?: number;
+    /**
+     * Search query used to filter results.
+     */
+    q?: string;
+    /**
+     * Filter by role types.
+     */
+    types?: Array<'admin' | 'user' | 'scanner' | 'sales_rep' | 'agent'>;
+}
+export declare namespace Roles {
+    export { type CreateRoleRequest as CreateRoleRequest, type ListRole as ListRole, type UpdateRoleRequest as UpdateRoleRequest, type RoleDeleteResponse as RoleDeleteResponse, type RoleCreateParams as RoleCreateParams, type RoleRetrieveParams as RoleRetrieveParams, type RoleUpdateParams as RoleUpdateParams, type RoleListParams as RoleListParams, };
+}
+//# sourceMappingURL=roles.d.ts.map

package/resources/identity/roles.d.ts.map

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

package/resources/identity/roles.js

@@ -0,0 +1,90 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Roles = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * List and manage roles.
+ */
+class Roles extends resource_1.APIResource {
+    /**
+     * Creates a new role with the specified permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.create({
+     *   name: 'Warehouse Manager',
+     *   permissions: [
+     *     'customers:create',
+     *     'customers:read',
+     *     'customers:update',
+     *     'invoices:read',
+     *   ],
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { include, ...body } = params;
+        return this._client.post('/v1/identity/roles', { query: { include }, body, ...options });
+    }
+    /**
+     * Returns a role by ID, including its structured permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.retrieve(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/identity/roles/${id}`, { query, ...options });
+    }
+    /**
+     * Partially updates a custom role's name or permissions. Provided permissions
+     * replace all existing ones; global roles cannot be modified.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.update(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     *   {
+     *     name: 'Updated Manager',
+     *     permissions: ['customers:read', 'customers:update'],
+     *   },
+     * );
+     * ```
+     */
+    update(id, params = {}, options) {
+        const { include, ...body } = params ?? {};
+        return this._client.patch((0, path_1.path) `/v1/identity/roles/${id}`, { query: { include }, body, ...options });
+    }
+    /**
+     * Returns a paginated list of roles for the target account, including global
+     * roles.
+     *
+     * @example
+     * ```ts
+     * const listRole = await client.identity.roles.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/identity/roles', { query, ...options });
+    }
+    /**
+     * Deletes a role and its associated permissions. Global roles cannot be deleted.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.delete(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/v1/identity/roles/${id}`, options);
+    }
+}
+exports.Roles = Roles;
+//# sourceMappingURL=roles.js.map

package/resources/identity/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/resources/identity/roles.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,MAAwB,EAAE,OAAwB;QACvD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CACN,EAAU,EACV,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,sBAAsB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CACJ,EAAU,EACV,SAA8C,EAAE,EAChD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,sBAAsB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,QAA2C,EAAE,EAAE,OAAwB;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,sBAAsB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AA1FD,sBA0FC"}

package/resources/identity/roles.mjs

@@ -0,0 +1,86 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * List and manage roles.
+ */
+export class Roles extends APIResource {
+    /**
+     * Creates a new role with the specified permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.create({
+     *   name: 'Warehouse Manager',
+     *   permissions: [
+     *     'customers:create',
+     *     'customers:read',
+     *     'customers:update',
+     *     'invoices:read',
+     *   ],
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { include, ...body } = params;
+        return this._client.post('/v1/identity/roles', { query: { include }, body, ...options });
+    }
+    /**
+     * Returns a role by ID, including its structured permissions.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.retrieve(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get(path `/v1/identity/roles/${id}`, { query, ...options });
+    }
+    /**
+     * Partially updates a custom role's name or permissions. Provided permissions
+     * replace all existing ones; global roles cannot be modified.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.update(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     *   {
+     *     name: 'Updated Manager',
+     *     permissions: ['customers:read', 'customers:update'],
+     *   },
+     * );
+     * ```
+     */
+    update(id, params = {}, options) {
+        const { include, ...body } = params ?? {};
+        return this._client.patch(path `/v1/identity/roles/${id}`, { query: { include }, body, ...options });
+    }
+    /**
+     * Returns a paginated list of roles for the target account, including global
+     * roles.
+     *
+     * @example
+     * ```ts
+     * const listRole = await client.identity.roles.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/identity/roles', { query, ...options });
+    }
+    /**
+     * Deletes a role and its associated permissions. Global roles cannot be deleted.
+     *
+     * @example
+     * ```ts
+     * const role = await client.identity.roles.delete(
+     *   'rl_01c16d2eb637c0d1f3a372937c',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/v1/identity/roles/${id}`, options);
+    }
+}
+//# sourceMappingURL=roles.mjs.map

package/resources/identity/roles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.mjs","sourceRoot":"","sources":["../../src/resources/identity/roles.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,MAAwB,EAAE,OAAwB;QACvD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CACN,EAAU,EACV,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,sBAAsB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CACJ,EAAU,EACV,SAA8C,EAAE,EAChD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,sBAAsB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,QAA2C,EAAE,EAAE,OAAwB;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,sBAAsB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/identity.d.mts

@@ -0,0 +1,2 @@
+export * from "./identity/index.mjs";
+//# sourceMappingURL=identity.d.mts.map

package/resources/identity.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.mts","sourceRoot":"","sources":["../src/resources/identity.ts"],"names":[],"mappings":"AAEA,qCAAiC"}

package/resources/identity.d.ts

@@ -0,0 +1,2 @@
+export * from "./identity/index.js";
+//# sourceMappingURL=identity.d.ts.map

package/resources/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/resources/identity.ts"],"names":[],"mappings":"AAEA,oCAAiC"}

package/resources/identity.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./identity/index.js"), exports);
+//# sourceMappingURL=identity.js.map

package/resources/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/resources/identity.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/identity.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./identity/index.mjs";
+//# sourceMappingURL=identity.mjs.map

package/resources/identity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.mjs","sourceRoot":"","sources":["../src/resources/identity.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,qCAAiC"}

package/resources/index.d.mts

@@ -0,0 +1,8 @@
+export { Auth } from "./auth/auth.mjs";
+export { Catalog } from "./catalog/catalog.mjs";
+export { Core } from "./core/core.mjs";
+export { Finance, type AdjustmentType, type ListAdjustmentType, type ListTransactionMethod, type ListTransactionType, type TransactionMethod, type TransactionType, type FinanceRetrieveAdjustmentTypesParams, type FinanceRetrieveTransactionMethodsParams, type FinanceRetrieveTransactionTypesParams, } from "./finance/finance.mjs";
+export { Identity } from "./identity/identity.mjs";
+export { Operations } from "./operations/operations.mjs";
+export { Sales } from "./sales/sales.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,wBAAoB;AACnC,OAAO,EAAE,OAAO,EAAE,8BAA0B;AAC5C,OAAO,EAAE,IAAI,EAAE,wBAAoB;AACnC,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oCAAoC,EACzC,KAAK,uCAAuC,EAC5C,KAAK,qCAAqC,GAC3C,8BAA0B;AAC3B,OAAO,EAAE,QAAQ,EAAE,gCAA4B;AAC/C,OAAO,EAAE,UAAU,EAAE,oCAAgC;AACrD,OAAO,EAAE,KAAK,EAAE,0BAAsB"}

package/resources/index.d.ts

@@ -0,0 +1,8 @@
+export { Auth } from "./auth/auth.js";
+export { Catalog } from "./catalog/catalog.js";
+export { Core } from "./core/core.js";
+export { Finance, type AdjustmentType, type ListAdjustmentType, type ListTransactionMethod, type ListTransactionType, type TransactionMethod, type TransactionType, type FinanceRetrieveAdjustmentTypesParams, type FinanceRetrieveTransactionMethodsParams, type FinanceRetrieveTransactionTypesParams, } from "./finance/finance.js";
+export { Identity } from "./identity/identity.js";
+export { Operations } from "./operations/operations.js";
+export { Sales } from "./sales/sales.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,uBAAoB;AACnC,OAAO,EAAE,OAAO,EAAE,6BAA0B;AAC5C,OAAO,EAAE,IAAI,EAAE,uBAAoB;AACnC,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oCAAoC,EACzC,KAAK,uCAAuC,EAC5C,KAAK,qCAAqC,GAC3C,6BAA0B;AAC3B,OAAO,EAAE,QAAQ,EAAE,+BAA4B;AAC/C,OAAO,EAAE,UAAU,EAAE,mCAAgC;AACrD,OAAO,EAAE,KAAK,EAAE,yBAAsB"}

package/resources/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sales = exports.Operations = exports.Identity = exports.Finance = exports.Core = exports.Catalog = exports.Auth = void 0;
+var auth_1 = require("./auth/auth.js");
+Object.defineProperty(exports, "Auth", { enumerable: true, get: function () { return auth_1.Auth; } });
+var catalog_1 = require("./catalog/catalog.js");
+Object.defineProperty(exports, "Catalog", { enumerable: true, get: function () { return catalog_1.Catalog; } });
+var core_1 = require("./core/core.js");
+Object.defineProperty(exports, "Core", { enumerable: true, get: function () { return core_1.Core; } });
+var finance_1 = require("./finance/finance.js");
+Object.defineProperty(exports, "Finance", { enumerable: true, get: function () { return finance_1.Finance; } });
+var identity_1 = require("./identity/identity.js");
+Object.defineProperty(exports, "Identity", { enumerable: true, get: function () { return identity_1.Identity; } });
+var operations_1 = require("./operations/operations.js");
+Object.defineProperty(exports, "Operations", { enumerable: true, get: function () { return operations_1.Operations; } });
+var sales_1 = require("./sales/sales.js");
+Object.defineProperty(exports, "Sales", { enumerable: true, get: function () { return sales_1.Sales; } });
+//# sourceMappingURL=index.js.map

package/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,uCAAmC;AAA1B,4FAAA,IAAI,OAAA;AACb,gDAA4C;AAAnC,kGAAA,OAAO,OAAA;AAChB,uCAAmC;AAA1B,4FAAA,IAAI,OAAA;AACb,gDAW2B;AAVzB,kGAAA,OAAO,OAAA;AAWT,mDAA+C;AAAtC,oGAAA,QAAQ,OAAA;AACjB,yDAAqD;AAA5C,wGAAA,UAAU,OAAA;AACnB,0CAAsC;AAA7B,8FAAA,KAAK,OAAA"}

package/resources/index.mjs

@@ -0,0 +1,9 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Auth } from "./auth/auth.mjs";
+export { Catalog } from "./catalog/catalog.mjs";
+export { Core } from "./core/core.mjs";
+export { Finance, } from "./finance/finance.mjs";
+export { Identity } from "./identity/identity.mjs";
+export { Operations } from "./operations/operations.mjs";
+export { Sales } from "./sales/sales.mjs";
+//# sourceMappingURL=index.mjs.map