@sentdm/sentdm 0.35.0 → 0.37.0

package/src/resources/users.ts

@@ -1,6 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as UsersAPI from './users';
+import * as WebhooksAPI from './webhooks';
 import { APIPromise } from '../core/api-promise';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
@@ -18,7 +20,7 @@ export class Users extends APIResource {
    *
    * @example
    * ```ts
-   * const user = await client.users.retrieve(
+   * const apiResponseOfUser = await client.users.retrieve(
    *   '880e8400-e29b-41d4-a716-446655440003',
    * );
    * ```
@@ -27,7 +29,7 @@ export class Users extends APIResource {
     userID: string,
     params: UserRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<UserRetrieveResponse> {
+  ): APIPromise<APIResponseOfUser> {
     const { 'x-profile-id': xProfileID } = params ?? {};
     return this._client.get(path`/v3/users/${userID}`, {
       ...options,
@@ -69,10 +71,10 @@ export class Users extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.users.invite();
+   * const apiResponseOfUser = await client.users.invite();
    * ```
    */
-  invite(params: UserInviteParams, options?: RequestOptions): APIPromise<UserInviteResponse> {
+  invite(params: UserInviteParams, options?: RequestOptions): APIPromise<APIResponseOfUser> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.post('/v3/users', {
       body,
@@ -116,7 +118,7 @@ export class Users extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.users.updateRole(
+   * const apiResponseOfUser = await client.users.updateRole(
    *   'aa0e8400-e29b-41d4-a716-446655440005',
    * );
    * ```
@@ -125,7 +127,7 @@ export class Users extends APIResource {
     userID: string,
     params: UserUpdateRoleParams,
     options?: RequestOptions,
-  ): APIPromise<UserUpdateRoleResponse> {
+  ): APIPromise<APIResponseOfUser> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.patch(path`/v3/users/${userID}`, {
       body,
@@ -144,21 +146,21 @@ export class Users extends APIResource {
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface UserRetrieveResponse {
+export interface APIResponseOfUser {
   /**
    * User response for v3 API
    */
-  data?: UserRetrieveResponse.Data | null;
+  data?: UserResponse | null;
 
   /**
    * Error information
    */
-  error?: UserRetrieveResponse.Error | null;
+  error?: WebhooksAPI.ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: UserRetrieveResponse.Meta;
+  meta?: WebhooksAPI.APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -166,452 +168,80 @@ export interface UserRetrieveResponse {
   success?: boolean;
 }
 
-export namespace UserRetrieveResponse {
-  /**
-   * User response for v3 API
-   */
-  export interface Data {
-    /**
-     * User unique identifier
-     */
-    id?: string;
-
-    /**
-     * When the user was added to the organization
-     */
-    created_at?: string;
-
-    /**
-     * Which customer owns this — the key's own, or the profile named in x-profile-id.
-     * Says whose resource this is, which the resource's own id does not.
-     */
-    customer_id?: string;
-
-    /**
-     * User email address
-     */
-    email?: string;
-
-    /**
-     * When the user was invited
-     */
-    invited_at?: string | null;
-
-    /**
-     * When the user last logged in
-     */
-    last_login_at?: string | null;
-
-    /**
-     * User full name
-     */
-    name?: string;
-
-    /**
-     * User role in the organization: admin, billing, developer
-     */
-    role?: string;
-
-    /**
-     * User status: active, invited, suspended, rejected
-     */
-    status?: string;
-
-    /**
-     * When the user record was last updated
-     */
-    updated_at?: string | null;
-  }
-
-  /**
-   * Error information
-   */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
-
-  /**
-   * Request and response metadata
-   */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
-     */
-    timestamp?: string;
-
-    /**
-     * API version used for this request
-     */
-    version?: string;
-  }
-}
-
 /**
- * Standard API response envelope for all v3 endpoints
+ * User response for v3 API
  */
-export interface UserListResponse {
-  /**
-   * The users in the organization.
-   */
-  data?: UserListResponse.Data | null;
-
-  /**
-   * Error information
-   */
-  error?: UserListResponse.Error | null;
-
-  /**
-   * Request and response metadata
-   */
-  meta?: UserListResponse.Meta;
-
-  /**
-   * Indicates whether the request was successful
-   */
-  success?: boolean;
-}
-
-export namespace UserListResponse {
+export interface UserResponse {
   /**
-   * The users in the organization.
+   * User unique identifier
    */
-  export interface Data {
-    /**
-     * Pagination metadata for list responses
-     */
-    pagination?: Data.Pagination;
-
-    /**
-     * The users on this page.
-     */
-    users?: Array<Data.User>;
-  }
-
-  export namespace Data {
-    /**
-     * Pagination metadata for list responses
-     */
-    export interface Pagination {
-      /**
-       * @deprecated Cursor-based pagination. Never populated — see Cursors.
-       */
-      cursors?: Pagination.Cursors | null;
-
-      /**
-       * Whether there are more pages after this one
-       */
-      has_more?: boolean;
-
-      /**
-       * Current page number (1-indexed)
-       */
-      page?: number;
-
-      /**
-       * Number of items per page
-       */
-      page_size?: number;
-
-      /**
-       * Total number of items across all pages
-       */
-      total_count?: number;
-
-      /**
-       * Total number of pages
-       */
-      total_pages?: number;
-    }
-
-    export namespace Pagination {
-      /**
-       * @deprecated Cursor-based pagination. Never populated — see Cursors.
-       */
-      export interface Cursors {
-        /**
-         * Cursor to fetch the next page.
-         */
-        after?: string | null;
-
-        /**
-         * Cursor to fetch the previous page.
-         */
-        before?: string | null;
-      }
-    }
-
-    /**
-     * User response for v3 API
-     */
-    export interface User {
-      /**
-       * User unique identifier
-       */
-      id?: string;
-
-      /**
-       * When the user was added to the organization
-       */
-      created_at?: string;
-
-      /**
-       * Which customer owns this — the key's own, or the profile named in x-profile-id.
-       * Says whose resource this is, which the resource's own id does not.
-       */
-      customer_id?: string;
-
-      /**
-       * User email address
-       */
-      email?: string;
-
-      /**
-       * When the user was invited
-       */
-      invited_at?: string | null;
-
-      /**
-       * When the user last logged in
-       */
-      last_login_at?: string | null;
-
-      /**
-       * User full name
-       */
-      name?: string;
-
-      /**
-       * User role in the organization: admin, billing, developer
-       */
-      role?: string;
-
-      /**
-       * User status: active, invited, suspended, rejected
-       */
-      status?: string;
-
-      /**
-       * When the user record was last updated
-       */
-      updated_at?: string | null;
-    }
-  }
+  id?: string;
 
   /**
-   * Error information
+   * When the user was added to the organization
    */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
+  created_at?: string;
 
   /**
-   * Request and response metadata
+   * Which customer owns this — the key's own, or the profile named in x-profile-id.
+   * Says whose resource this is, which the resource's own id does not.
    */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
-     */
-    timestamp?: string;
-
-    /**
-     * API version used for this request
-     */
-    version?: string;
-  }
-}
+  customer_id?: string;
 
-/**
- * Standard API response envelope for all v3 endpoints
- */
-export interface UserInviteResponse {
   /**
-   * User response for v3 API
+   * User email address
    */
-  data?: UserInviteResponse.Data | null;
+  email?: string;
 
   /**
-   * Error information
+   * When the user was invited
    */
-  error?: UserInviteResponse.Error | null;
+  invited_at?: string | null;
 
   /**
-   * Request and response metadata
+   * When the user last logged in
    */
-  meta?: UserInviteResponse.Meta;
+  last_login_at?: string | null;
 
   /**
-   * Indicates whether the request was successful
+   * User full name
    */
-  success?: boolean;
-}
+  name?: string;
 
-export namespace UserInviteResponse {
   /**
-   * User response for v3 API
+   * User role in the organization: admin, billing, developer
    */
-  export interface Data {
-    /**
-     * User unique identifier
-     */
-    id?: string;
-
-    /**
-     * When the user was added to the organization
-     */
-    created_at?: string;
-
-    /**
-     * Which customer owns this — the key's own, or the profile named in x-profile-id.
-     * Says whose resource this is, which the resource's own id does not.
-     */
-    customer_id?: string;
-
-    /**
-     * User email address
-     */
-    email?: string;
-
-    /**
-     * When the user was invited
-     */
-    invited_at?: string | null;
-
-    /**
-     * When the user last logged in
-     */
-    last_login_at?: string | null;
-
-    /**
-     * User full name
-     */
-    name?: string;
-
-    /**
-     * User role in the organization: admin, billing, developer
-     */
-    role?: string;
-
-    /**
-     * User status: active, invited, suspended, rejected
-     */
-    status?: string;
-
-    /**
-     * When the user record was last updated
-     */
-    updated_at?: string | null;
-  }
+  role?: string;
 
   /**
-   * Error information
+   * User status: active, invited, suspended, rejected
    */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
+  status?: string;
 
   /**
-   * Request and response metadata
+   * When the user record was last updated
    */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
-     */
-    timestamp?: string;
-
-    /**
-     * API version used for this request
-     */
-    version?: string;
-  }
+  updated_at?: string | null;
 }
 
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface UserUpdateRoleResponse {
+export interface UserListResponse {
   /**
-   * User response for v3 API
+   * The users in the organization.
    */
-  data?: UserUpdateRoleResponse.Data | null;
+  data?: UserListResponse.Data | null;
 
   /**
    * Error information
    */
-  error?: UserUpdateRoleResponse.Error | null;
+  error?: WebhooksAPI.ErrorDetail | null;
 
   /**
    * Request and response metadata
    */
-  meta?: UserUpdateRoleResponse.Meta;
+  meta?: WebhooksAPI.APIMeta;
 
   /**
    * Indicates whether the request was successful
@@ -619,106 +249,20 @@ export interface UserUpdateRoleResponse {
   success?: boolean;
 }
 
-export namespace UserUpdateRoleResponse {
+export namespace UserListResponse {
   /**
-   * User response for v3 API
+   * The users in the organization.
    */
   export interface Data {
     /**
-     * User unique identifier
-     */
-    id?: string;
-
-    /**
-     * When the user was added to the organization
-     */
-    created_at?: string;
-
-    /**
-     * Which customer owns this — the key's own, or the profile named in x-profile-id.
-     * Says whose resource this is, which the resource's own id does not.
-     */
-    customer_id?: string;
-
-    /**
-     * User email address
-     */
-    email?: string;
-
-    /**
-     * When the user was invited
-     */
-    invited_at?: string | null;
-
-    /**
-     * When the user last logged in
-     */
-    last_login_at?: string | null;
-
-    /**
-     * User full name
-     */
-    name?: string;
-
-    /**
-     * User role in the organization: admin, billing, developer
-     */
-    role?: string;
-
-    /**
-     * User status: active, invited, suspended, rejected
-     */
-    status?: string;
-
-    /**
-     * When the user record was last updated
-     */
-    updated_at?: string | null;
-  }
-
-  /**
-   * Error information
-   */
-  export interface Error {
-    /**
-     * Machine-readable error code (e.g., "RESOURCE_001")
-     */
-    code?: string;
-
-    /**
-     * Additional validation error details (field-level errors)
-     */
-    details?: { [key: string]: Array<string> } | null;
-
-    /**
-     * URL to documentation about this error
-     */
-    doc_url?: string | null;
-
-    /**
-     * Human-readable error message
-     */
-    message?: string;
-  }
-
-  /**
-   * Request and response metadata
-   */
-  export interface Meta {
-    /**
-     * Unique identifier for this request (for tracing and support)
-     */
-    request_id?: string;
-
-    /**
-     * Server timestamp when the response was generated
+     * Pagination metadata for list responses
      */
-    timestamp?: string;
+    pagination?: WebhooksAPI.PaginationMeta;
 
     /**
-     * API version used for this request
+     * The users on this page.
      */
-    version?: string;
+    users?: Array<UsersAPI.UserResponse>;
   }
 }
 
@@ -819,10 +363,9 @@ export interface UserUpdateRoleParams {
 
 export declare namespace Users {
   export {
-    type UserRetrieveResponse as UserRetrieveResponse,
+    type APIResponseOfUser as APIResponseOfUser,
+    type UserResponse as UserResponse,
     type UserListResponse as UserListResponse,
-    type UserInviteResponse as UserInviteResponse,
-    type UserUpdateRoleResponse as UserUpdateRoleResponse,
     type UserRetrieveParams as UserRetrieveParams,
     type UserListParams as UserListParams,
     type UserInviteParams as UserInviteParams,