@linqapp/sdk 0.1.0 → 0.1.4

package/src/resources/chats/messages.ts

@@ -1,6 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as MessagesAPI from '../messages';
+import * as Shared from '../shared';
+import * as ChatsAPI from './chats';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -59,369 +62,77 @@ export class Messages extends APIResource {
   }
 }
 
-export interface MessageListResponse {
+/**
+ * A message that was sent (used in CreateChat and SendMessage responses)
+ */
+export interface SentMessage {
   /**
-   * List of messages
+   * Message identifier (UUID)
    */
-  messages: Array<MessageListResponse.Message>;
+  id: string;
 
   /**
-   * Cursor for fetching the next page of results. Null if there are no more results
-   * to fetch. Pass this value as the `cursor` parameter in the next request.
+   * Current delivery status of a message
    */
-  next_cursor?: string | null;
-}
-
-export namespace MessageListResponse {
-  export interface Message {
-    /**
-     * Unique identifier for the message
-     */
-    id: string;
-
-    /**
-     * ID of the chat this message belongs to
-     */
-    chat_id: string;
-
-    /**
-     * When the message was created
-     */
-    created_at: string;
-
-    /**
-     * Whether the message has been delivered
-     */
-    is_delivered: boolean;
-
-    /**
-     * Whether this message was sent by the authenticated user
-     */
-    is_from_me: boolean;
-
-    /**
-     * Whether the message has been read
-     */
-    is_read: boolean;
-
-    /**
-     * When the message was last updated
-     */
-    updated_at: string;
-
-    /**
-     * When the message was delivered
-     */
-    delivered_at?: string | null;
-
-    /**
-     * iMessage effect applied to a message (screen or bubble effect)
-     */
-    effect?: Message.Effect | null;
-
-    /**
-     * @deprecated DEPRECATED: Use from_handle instead. Phone number of the message
-     * sender.
-     */
-    from?: string | null;
-
-    /**
-     * The sender of this message as a full handle object
-     */
-    from_handle?: Message.FromHandle | null;
-
-    /**
-     * Message parts in order (text and media)
-     */
-    parts?: Array<Message.TextPartResponse | Message.MediaPartResponse> | null;
-
-    /**
-     * Messaging service type
-     */
-    preferred_service?: 'iMessage' | 'SMS' | 'RCS' | null;
-
-    /**
-     * When the message was read
-     */
-    read_at?: string | null;
-
-    /**
-     * Indicates this message is a threaded reply to another message
-     */
-    reply_to?: Message.ReplyTo | null;
-
-    /**
-     * When the message was sent
-     */
-    sent_at?: string | null;
-
-    /**
-     * Messaging service type
-     */
-    service?: 'iMessage' | 'SMS' | 'RCS' | null;
-  }
-
-  export namespace Message {
-    /**
-     * iMessage effect applied to a message (screen or bubble effect)
-     */
-    export interface Effect {
-      /**
-       * Name of the effect. Common values:
-       *
-       * - Screen effects: confetti, fireworks, lasers, sparkles, celebration, hearts,
-       *   love, balloons, happy_birthday, echo, spotlight
-       * - Bubble effects: slam, loud, gentle, invisible
-       */
-      name?: string;
-
-      /**
-       * Type of effect
-       */
-      type?: 'screen' | 'bubble';
-    }
-
-    /**
-     * The sender of this message as a full handle object
-     */
-    export interface FromHandle {
-      /**
-       * Unique identifier for this handle
-       */
-      id: string;
-
-      /**
-       * Phone number (E.164) or email address of the participant
-       */
-      handle: string;
-
-      /**
-       * When this participant joined the chat
-       */
-      joined_at: string;
-
-      /**
-       * Messaging service type
-       */
-      service: 'iMessage' | 'SMS' | 'RCS';
-
-      /**
-       * Whether this handle belongs to the sender (your phone number)
-       */
-      is_me?: boolean | null;
-
-      /**
-       * When they left (if applicable)
-       */
-      left_at?: string | null;
-
-      /**
-       * Participant status
-       */
-      status?: 'active' | 'left' | 'removed' | null;
-    }
-
-    /**
-     * A text message part
-     */
-    export interface TextPartResponse {
-      /**
-       * Reactions on this message part
-       */
-      reactions: Array<TextPartResponse.Reaction> | null;
-
-      /**
-       * Indicates this is a text message part
-       */
-      type: 'text';
-
-      /**
-       * The text content
-       */
-      value: string;
-    }
-
-    export namespace TextPartResponse {
-      export interface Reaction {
-        handle: Reaction.Handle;
-
-        /**
-         * Whether this reaction is from the current user
-         */
-        is_me: boolean;
-
-        /**
-         * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-         * emphasize, question. Custom emoji reactions have type "custom" with the actual
-         * emoji in the custom_emoji field.
-         */
-        type: 'love' | 'like' | 'dislike' | 'laugh' | 'emphasize' | 'question' | 'custom';
-
-        /**
-         * Custom emoji if type is "custom", null otherwise
-         */
-        custom_emoji?: string | null;
-      }
-
-      export namespace Reaction {
-        export interface Handle {
-          /**
-           * Unique identifier for this handle
-           */
-          id: string;
+  delivery_status: 'pending' | 'queued' | 'sent' | 'delivered' | 'failed';
 
-          /**
-           * Phone number (E.164) or email address of the participant
-           */
-          handle: string;
-
-          /**
-           * When this participant joined the chat
-           */
-          joined_at: string;
-
-          /**
-           * Messaging service type
-           */
-          service: 'iMessage' | 'SMS' | 'RCS';
-
-          /**
-           * Whether this handle belongs to the sender (your phone number)
-           */
-          is_me?: boolean | null;
-
-          /**
-           * When they left (if applicable)
-           */
-          left_at?: string | null;
-
-          /**
-           * Participant status
-           */
-          status?: 'active' | 'left' | 'removed' | null;
-        }
-      }
-    }
-
-    /**
-     * A media attachment part
-     */
-    export interface MediaPartResponse {
-      /**
-       * Unique attachment identifier
-       */
-      id: string;
-
-      /**
-       * Original filename
-       */
-      filename: string;
-
-      /**
-       * MIME type of the file
-       */
-      mime_type: string;
-
-      /**
-       * Reactions on this message part
-       */
-      reactions: Array<MediaPartResponse.Reaction> | null;
-
-      /**
-       * File size in bytes
-       */
-      size_bytes: number;
-
-      /**
-       * Indicates this is a media attachment part
-       */
-      type: 'media';
-
-      /**
-       * Presigned URL for downloading the attachment (expires in 1 hour).
-       */
-      url: string;
-    }
-
-    export namespace MediaPartResponse {
-      export interface Reaction {
-        handle: Reaction.Handle;
-
-        /**
-         * Whether this reaction is from the current user
-         */
-        is_me: boolean;
-
-        /**
-         * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-         * emphasize, question. Custom emoji reactions have type "custom" with the actual
-         * emoji in the custom_emoji field.
-         */
-        type: 'love' | 'like' | 'dislike' | 'laugh' | 'emphasize' | 'question' | 'custom';
+  /**
+   * Whether the message has been read
+   */
+  is_read: boolean;
 
-        /**
-         * Custom emoji if type is "custom", null otherwise
-         */
-        custom_emoji?: string | null;
-      }
+  /**
+   * Message parts in order (text and media)
+   */
+  parts: Array<MessagesAPI.TextPart | MessagesAPI.MediaPart>;
 
-      export namespace Reaction {
-        export interface Handle {
-          /**
-           * Unique identifier for this handle
-           */
-          id: string;
+  /**
+   * When the message was sent
+   */
+  sent_at: string;
 
-          /**
-           * Phone number (E.164) or email address of the participant
-           */
-          handle: string;
+  /**
+   * When the message was delivered
+   */
+  delivered_at?: string | null;
 
-          /**
-           * When this participant joined the chat
-           */
-          joined_at: string;
+  /**
+   * iMessage effect applied to a message (screen or bubble effect)
+   */
+  effect?: MessagesAPI.MessageEffect | null;
 
-          /**
-           * Messaging service type
-           */
-          service: 'iMessage' | 'SMS' | 'RCS';
+  /**
+   * The sender of this message as a full handle object
+   */
+  from_handle?: MessagesAPI.ChatHandle | null;
 
-          /**
-           * Whether this handle belongs to the sender (your phone number)
-           */
-          is_me?: boolean | null;
+  /**
+   * Messaging service type
+   */
+  preferred_service?: Shared.ServiceType | null;
 
-          /**
-           * When they left (if applicable)
-           */
-          left_at?: string | null;
+  /**
+   * Indicates this message is a threaded reply to another message
+   */
+  reply_to?: MessagesAPI.ReplyTo | null;
 
-          /**
-           * Participant status
-           */
-          status?: 'active' | 'left' | 'removed' | null;
-        }
-      }
-    }
+  /**
+   * Messaging service type
+   */
+  service?: Shared.ServiceType | null;
+}
 
-    /**
-     * Indicates this message is a threaded reply to another message
-     */
-    export interface ReplyTo {
-      /**
-       * The ID of the message to reply to
-       */
-      message_id: string;
+export interface MessageListResponse {
+  /**
+   * List of messages
+   */
+  messages: Array<MessagesAPI.Message>;
 
-      /**
-       * The specific message part to reply to (0-based index). Defaults to 0 (first
-       * part) if not provided. Use this when replying to a specific part of a multipart
-       * message.
-       */
-      part_index?: number;
-    }
-  }
+  /**
+   * Cursor for fetching the next page of results. Null if there are no more results
+   * to fetch. Pass this value as the `cursor` parameter in the next request.
+   */
+  next_cursor?: string | null;
 }
 
 /**
@@ -436,331 +147,7 @@ export interface MessageSendResponse {
   /**
    * A message that was sent (used in CreateChat and SendMessage responses)
    */
-  message: MessageSendResponse.Message;
-}
-
-export namespace MessageSendResponse {
-  /**
-   * A message that was sent (used in CreateChat and SendMessage responses)
-   */
-  export interface Message {
-    /**
-     * Message identifier (UUID)
-     */
-    id: string;
-
-    /**
-     * Current delivery status of a message
-     */
-    delivery_status: 'pending' | 'queued' | 'sent' | 'delivered' | 'failed';
-
-    /**
-     * Whether the message has been read
-     */
-    is_read: boolean;
-
-    /**
-     * Message parts in order (text and media)
-     */
-    parts: Array<Message.TextPartResponse | Message.MediaPartResponse>;
-
-    /**
-     * When the message was sent
-     */
-    sent_at: string;
-
-    /**
-     * When the message was delivered
-     */
-    delivered_at?: string | null;
-
-    /**
-     * iMessage effect applied to a message (screen or bubble effect)
-     */
-    effect?: Message.Effect | null;
-
-    /**
-     * The sender of this message as a full handle object
-     */
-    from_handle?: Message.FromHandle | null;
-
-    /**
-     * Messaging service type
-     */
-    preferred_service?: 'iMessage' | 'SMS' | 'RCS' | null;
-
-    /**
-     * Indicates this message is a threaded reply to another message
-     */
-    reply_to?: Message.ReplyTo | null;
-
-    /**
-     * Messaging service type
-     */
-    service?: 'iMessage' | 'SMS' | 'RCS' | null;
-  }
-
-  export namespace Message {
-    /**
-     * A text message part
-     */
-    export interface TextPartResponse {
-      /**
-       * Reactions on this message part
-       */
-      reactions: Array<TextPartResponse.Reaction> | null;
-
-      /**
-       * Indicates this is a text message part
-       */
-      type: 'text';
-
-      /**
-       * The text content
-       */
-      value: string;
-    }
-
-    export namespace TextPartResponse {
-      export interface Reaction {
-        handle: Reaction.Handle;
-
-        /**
-         * Whether this reaction is from the current user
-         */
-        is_me: boolean;
-
-        /**
-         * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-         * emphasize, question. Custom emoji reactions have type "custom" with the actual
-         * emoji in the custom_emoji field.
-         */
-        type: 'love' | 'like' | 'dislike' | 'laugh' | 'emphasize' | 'question' | 'custom';
-
-        /**
-         * Custom emoji if type is "custom", null otherwise
-         */
-        custom_emoji?: string | null;
-      }
-
-      export namespace Reaction {
-        export interface Handle {
-          /**
-           * Unique identifier for this handle
-           */
-          id: string;
-
-          /**
-           * Phone number (E.164) or email address of the participant
-           */
-          handle: string;
-
-          /**
-           * When this participant joined the chat
-           */
-          joined_at: string;
-
-          /**
-           * Messaging service type
-           */
-          service: 'iMessage' | 'SMS' | 'RCS';
-
-          /**
-           * Whether this handle belongs to the sender (your phone number)
-           */
-          is_me?: boolean | null;
-
-          /**
-           * When they left (if applicable)
-           */
-          left_at?: string | null;
-
-          /**
-           * Participant status
-           */
-          status?: 'active' | 'left' | 'removed' | null;
-        }
-      }
-    }
-
-    /**
-     * A media attachment part
-     */
-    export interface MediaPartResponse {
-      /**
-       * Unique attachment identifier
-       */
-      id: string;
-
-      /**
-       * Original filename
-       */
-      filename: string;
-
-      /**
-       * MIME type of the file
-       */
-      mime_type: string;
-
-      /**
-       * Reactions on this message part
-       */
-      reactions: Array<MediaPartResponse.Reaction> | null;
-
-      /**
-       * File size in bytes
-       */
-      size_bytes: number;
-
-      /**
-       * Indicates this is a media attachment part
-       */
-      type: 'media';
-
-      /**
-       * Presigned URL for downloading the attachment (expires in 1 hour).
-       */
-      url: string;
-    }
-
-    export namespace MediaPartResponse {
-      export interface Reaction {
-        handle: Reaction.Handle;
-
-        /**
-         * Whether this reaction is from the current user
-         */
-        is_me: boolean;
-
-        /**
-         * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-         * emphasize, question. Custom emoji reactions have type "custom" with the actual
-         * emoji in the custom_emoji field.
-         */
-        type: 'love' | 'like' | 'dislike' | 'laugh' | 'emphasize' | 'question' | 'custom';
-
-        /**
-         * Custom emoji if type is "custom", null otherwise
-         */
-        custom_emoji?: string | null;
-      }
-
-      export namespace Reaction {
-        export interface Handle {
-          /**
-           * Unique identifier for this handle
-           */
-          id: string;
-
-          /**
-           * Phone number (E.164) or email address of the participant
-           */
-          handle: string;
-
-          /**
-           * When this participant joined the chat
-           */
-          joined_at: string;
-
-          /**
-           * Messaging service type
-           */
-          service: 'iMessage' | 'SMS' | 'RCS';
-
-          /**
-           * Whether this handle belongs to the sender (your phone number)
-           */
-          is_me?: boolean | null;
-
-          /**
-           * When they left (if applicable)
-           */
-          left_at?: string | null;
-
-          /**
-           * Participant status
-           */
-          status?: 'active' | 'left' | 'removed' | null;
-        }
-      }
-    }
-
-    /**
-     * iMessage effect applied to a message (screen or bubble effect)
-     */
-    export interface Effect {
-      /**
-       * Name of the effect. Common values:
-       *
-       * - Screen effects: confetti, fireworks, lasers, sparkles, celebration, hearts,
-       *   love, balloons, happy_birthday, echo, spotlight
-       * - Bubble effects: slam, loud, gentle, invisible
-       */
-      name?: string;
-
-      /**
-       * Type of effect
-       */
-      type?: 'screen' | 'bubble';
-    }
-
-    /**
-     * The sender of this message as a full handle object
-     */
-    export interface FromHandle {
-      /**
-       * Unique identifier for this handle
-       */
-      id: string;
-
-      /**
-       * Phone number (E.164) or email address of the participant
-       */
-      handle: string;
-
-      /**
-       * When this participant joined the chat
-       */
-      joined_at: string;
-
-      /**
-       * Messaging service type
-       */
-      service: 'iMessage' | 'SMS' | 'RCS';
-
-      /**
-       * Whether this handle belongs to the sender (your phone number)
-       */
-      is_me?: boolean | null;
-
-      /**
-       * When they left (if applicable)
-       */
-      left_at?: string | null;
-
-      /**
-       * Participant status
-       */
-      status?: 'active' | 'left' | 'removed' | null;
-    }
-
-    /**
-     * Indicates this message is a threaded reply to another message
-     */
-    export interface ReplyTo {
-      /**
-       * The ID of the message to reply to
-       */
-      message_id: string;
-
-      /**
-       * The specific message part to reply to (0-based index). Defaults to 0 (first
-       * part) if not provided. Use this when replying to a specific part of a multipart
-       * message.
-       */
-      part_index?: number;
-    }
-  }
+  message: SentMessage;
 }
 
 export interface MessageListParams {
@@ -781,177 +168,12 @@ export interface MessageSendParams {
    * separating the "what" (message content) from the "where" (routing fields like
    * from/to).
    */
-  message: MessageSendParams.Message;
-}
-
-export namespace MessageSendParams {
-  /**
-   * Message content container. Groups all message-related fields together,
-   * separating the "what" (message content) from the "where" (routing fields like
-   * from/to).
-   */
-  export interface Message {
-    /**
-     * Array of message parts. Each part can be either text or media. Parts are
-     * displayed in order. Text and media can be mixed.
-     *
-     * **Supported Media:**
-     *
-     * - Images: .jpg, .jpeg, .png, .gif, .heic, .heif, .tif, .tiff, .bmp
-     * - Videos: .mp4, .mov, .m4v, .mpeg, .mpg, .3gp
-     * - Audio: .m4a, .mp3, .aac, .caf, .wav, .aiff, .amr
-     * - Documents: .pdf, .txt, .rtf, .csv, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
-     *   .pages, .numbers, .key, .epub, .zip, .html, .htm
-     * - Contact & Calendar: .vcf, .ics
-     *
-     * **Audio:**
-     *
-     * - Audio files (.m4a, .mp3, .aac, .caf, .wav, .aiff, .amr) are fully supported as
-     *   media parts
-     * - To send audio as an **iMessage voice memo bubble** (inline playback UI), use
-     *   the dedicated `/v3/chats/{chatId}/voicememo` endpoint instead
-     *
-     * **Validation Rule:** Consecutive text parts are not allowed. Text parts must be
-     * separated by media parts. For example, [text, text] is invalid, but [text,
-     * media, text] is valid.
-     */
-    parts: Array<Message.TextPart | Message.MediaPart>;
-
-    /**
-     * iMessage effect to apply to this message (screen or bubble effect)
-     */
-    effect?: Message.Effect;
-
-    /**
-     * Optional idempotency key for this message. Use this to prevent duplicate sends
-     * of the same message.
-     */
-    idempotency_key?: string;
-
-    /**
-     * Messaging service type
-     */
-    preferred_service?: 'iMessage' | 'SMS' | 'RCS';
-
-    /**
-     * Reply to another message to create a threaded conversation
-     */
-    reply_to?: Message.ReplyTo;
-  }
-
-  export namespace Message {
-    export interface TextPart {
-      /**
-       * Indicates this is a text message part
-       */
-      type: 'text';
-
-      /**
-       * The text content
-       */
-      value: string;
-
-      /**
-       * Optional idempotency key for this specific message part. Use this to prevent
-       * duplicate sends of the same part.
-       */
-      idempotency_key?: string;
-    }
-
-    export interface MediaPart {
-      /**
-       * Indicates this is a media attachment part
-       */
-      type: 'media';
-
-      /**
-       * Reference to a file pre-uploaded via `POST /v3/attachments` (optional). The file
-       * is already stored, so sends using this ID skip the download step — useful when
-       * sending the same file to many recipients.
-       *
-       * Either `url` or `attachment_id` must be provided, but not both.
-       */
-      attachment_id?: string;
-
-      /**
-       * Optional idempotency key for this specific message part. Use this to prevent
-       * duplicate sends of the same part.
-       */
-      idempotency_key?: string;
-
-      /**
-       * Any publicly accessible HTTPS URL to the media file. The server downloads and
-       * sends the file automatically — no pre-upload step required.
-       *
-       * **Size limit:** 10MB maximum for URL-based downloads. For larger files (up to
-       * 100MB), use the pre-upload flow: `POST /v3/attachments` to get a presigned URL,
-       * upload directly, then reference by `attachment_id`.
-       *
-       * **Requirements:**
-       *
-       * - URL must use HTTPS
-       * - File content must be a supported format (the server validates the actual file
-       *   content)
-       *
-       * **Supported formats:**
-       *
-       * - Images: .jpg, .jpeg, .png, .gif, .heic, .heif, .tif, .tiff, .bmp
-       * - Videos: .mp4, .mov, .m4v, .mpeg, .mpg, .3gp
-       * - Audio: .m4a, .mp3, .aac, .caf, .wav, .aiff, .amr
-       * - Documents: .pdf, .txt, .rtf, .csv, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
-       *   .pages, .numbers, .key, .epub, .zip, .html, .htm
-       * - Contact & Calendar: .vcf, .ics
-       *
-       * **Tip:** Audio sent here appears as a regular file attachment. To send audio as
-       * an iMessage voice memo bubble (with inline playback), use
-       * `/v3/chats/{chatId}/voicememo`. For repeated sends of the same file, use
-       * `attachment_id` to avoid redundant downloads.
-       *
-       * Either `url` or `attachment_id` must be provided, but not both.
-       */
-      url?: string;
-    }
-
-    /**
-     * iMessage effect to apply to this message (screen or bubble effect)
-     */
-    export interface Effect {
-      /**
-       * Name of the effect. Common values:
-       *
-       * - Screen effects: confetti, fireworks, lasers, sparkles, celebration, hearts,
-       *   love, balloons, happy_birthday, echo, spotlight
-       * - Bubble effects: slam, loud, gentle, invisible
-       */
-      name?: string;
-
-      /**
-       * Type of effect
-       */
-      type?: 'screen' | 'bubble';
-    }
-
-    /**
-     * Reply to another message to create a threaded conversation
-     */
-    export interface ReplyTo {
-      /**
-       * The ID of the message to reply to
-       */
-      message_id: string;
-
-      /**
-       * The specific message part to reply to (0-based index). Defaults to 0 (first
-       * part) if not provided. Use this when replying to a specific part of a multipart
-       * message.
-       */
-      part_index?: number;
-    }
-  }
+  message: ChatsAPI.MessageContent;
 }
 
 export declare namespace Messages {
   export {
+    type SentMessage as SentMessage,
     type MessageListResponse as MessageListResponse,
     type MessageSendResponse as MessageSendResponse,
     type MessageListParams as MessageListParams,