# Shared

## Domain Types

### Chat Handle

- `ChatHandle`

  - `id: string`

    Unique identifier for this handle

  - `handle: string`

    Phone number (E.164) or email address of the participant

  - `joined_at: string`

    When this participant joined the chat

  - `service: ServiceType`

    Messaging service type

    - `"iMessage"`

    - `"SMS"`

    - `"RCS"`

  - `is_me?: boolean | null`

    Whether this handle belongs to the sender (your phone number)

  - `left_at?: string | null`

    When they left (if applicable)

  - `status?: "active" | "left" | "removed" | null`

    Participant status

    - `"active"`

    - `"left"`

    - `"removed"`

### Link Part Response

- `LinkPartResponse`

  A rich link preview part

  - `reactions: Array<Reaction> | null`

    Reactions on this message part

    - `handle: ChatHandle`

      - `id: string`

        Unique identifier for this handle

      - `handle: string`

        Phone number (E.164) or email address of the participant

      - `joined_at: string`

        When this participant joined the chat

      - `service: ServiceType`

        Messaging service type

        - `"iMessage"`

        - `"SMS"`

        - `"RCS"`

      - `is_me?: boolean | null`

        Whether this handle belongs to the sender (your phone number)

      - `left_at?: string | null`

        When they left (if applicable)

      - `status?: "active" | "left" | "removed" | null`

        Participant status

        - `"active"`

        - `"left"`

        - `"removed"`

    - `is_me: boolean`

      Whether this reaction is from the current user

    - `type: ReactionType`

      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.
      Sticker reactions have type "sticker" with sticker attachment details in the sticker field.

      - `"love"`

      - `"like"`

      - `"dislike"`

      - `"laugh"`

      - `"emphasize"`

      - `"question"`

      - `"custom"`

      - `"sticker"`

    - `custom_emoji?: string | null`

      Custom emoji if type is "custom", null otherwise

    - `sticker?: Sticker | null`

      Sticker attachment details when reaction_type is "sticker". Null for non-sticker reactions.

      - `file_name?: string`

        Filename of the sticker

      - `height?: number`

        Sticker image height in pixels

      - `mime_type?: string`

        MIME type of the sticker image

      - `url?: string`

        Presigned URL for downloading the sticker image (expires in 1 hour).

      - `width?: number`

        Sticker image width in pixels

  - `type: "link"`

    Indicates this is a rich link preview part

    - `"link"`

  - `value: string`

    The URL

### Media Part Response

- `MediaPartResponse`

  A media attachment part

  - `id: string`

    Unique attachment identifier

  - `filename: string`

    Original filename

  - `mime_type: string`

    MIME type of the file

  - `reactions: Array<Reaction> | null`

    Reactions on this message part

    - `handle: ChatHandle`

      - `id: string`

        Unique identifier for this handle

      - `handle: string`

        Phone number (E.164) or email address of the participant

      - `joined_at: string`

        When this participant joined the chat

      - `service: ServiceType`

        Messaging service type

        - `"iMessage"`

        - `"SMS"`

        - `"RCS"`

      - `is_me?: boolean | null`

        Whether this handle belongs to the sender (your phone number)

      - `left_at?: string | null`

        When they left (if applicable)

      - `status?: "active" | "left" | "removed" | null`

        Participant status

        - `"active"`

        - `"left"`

        - `"removed"`

    - `is_me: boolean`

      Whether this reaction is from the current user

    - `type: ReactionType`

      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.
      Sticker reactions have type "sticker" with sticker attachment details in the sticker field.

      - `"love"`

      - `"like"`

      - `"dislike"`

      - `"laugh"`

      - `"emphasize"`

      - `"question"`

      - `"custom"`

      - `"sticker"`

    - `custom_emoji?: string | null`

      Custom emoji if type is "custom", null otherwise

    - `sticker?: Sticker | null`

      Sticker attachment details when reaction_type is "sticker". Null for non-sticker reactions.

      - `file_name?: string`

        Filename of the sticker

      - `height?: number`

        Sticker image height in pixels

      - `mime_type?: string`

        MIME type of the sticker image

      - `url?: string`

        Presigned URL for downloading the sticker image (expires in 1 hour).

      - `width?: number`

        Sticker image width in pixels

  - `size_bytes: number`

    File size in bytes

  - `type: "media"`

    Indicates this is a media attachment part

    - `"media"`

  - `url: string`

    Presigned URL for downloading the attachment (expires in 1 hour).

### Reaction

- `Reaction`

  - `handle: ChatHandle`

    - `id: string`

      Unique identifier for this handle

    - `handle: string`

      Phone number (E.164) or email address of the participant

    - `joined_at: string`

      When this participant joined the chat

    - `service: ServiceType`

      Messaging service type

      - `"iMessage"`

      - `"SMS"`

      - `"RCS"`

    - `is_me?: boolean | null`

      Whether this handle belongs to the sender (your phone number)

    - `left_at?: string | null`

      When they left (if applicable)

    - `status?: "active" | "left" | "removed" | null`

      Participant status

      - `"active"`

      - `"left"`

      - `"removed"`

  - `is_me: boolean`

    Whether this reaction is from the current user

  - `type: ReactionType`

    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.
    Sticker reactions have type "sticker" with sticker attachment details in the sticker field.

    - `"love"`

    - `"like"`

    - `"dislike"`

    - `"laugh"`

    - `"emphasize"`

    - `"question"`

    - `"custom"`

    - `"sticker"`

  - `custom_emoji?: string | null`

    Custom emoji if type is "custom", null otherwise

  - `sticker?: Sticker | null`

    Sticker attachment details when reaction_type is "sticker". Null for non-sticker reactions.

    - `file_name?: string`

      Filename of the sticker

    - `height?: number`

      Sticker image height in pixels

    - `mime_type?: string`

      MIME type of the sticker image

    - `url?: string`

      Presigned URL for downloading the sticker image (expires in 1 hour).

    - `width?: number`

      Sticker image width in pixels

### Reaction Type

- `ReactionType = "love" | "like" | "dislike" | 5 more`

  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.
  Sticker reactions have type "sticker" with sticker attachment details in the sticker field.

  - `"love"`

  - `"like"`

  - `"dislike"`

  - `"laugh"`

  - `"emphasize"`

  - `"question"`

  - `"custom"`

  - `"sticker"`

### Service Type

- `ServiceType = "iMessage" | "SMS" | "RCS"`

  Messaging service type

  - `"iMessage"`

  - `"SMS"`

  - `"RCS"`

### Text Decoration

- `TextDecoration`

  - `range: Array<number>`

    Character range `[start, end)` in the `value` string where the decoration applies.
    `start` is inclusive, `end` is exclusive.
    *Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.*

  - `animation?: "big" | "small" | "shake" | 5 more`

    Animated text effect to apply. Mutually exclusive with `style`.

    - `"big"`

    - `"small"`

    - `"shake"`

    - `"nod"`

    - `"explode"`

    - `"ripple"`

    - `"bloom"`

    - `"jitter"`

  - `style?: "bold" | "italic" | "strikethrough" | "underline"`

    Text style to apply. Mutually exclusive with `animation`.

    - `"bold"`

    - `"italic"`

    - `"strikethrough"`

    - `"underline"`

### Text Part Response

- `TextPartResponse`

  A text message part

  - `reactions: Array<Reaction> | null`

    Reactions on this message part

    - `handle: ChatHandle`

      - `id: string`

        Unique identifier for this handle

      - `handle: string`

        Phone number (E.164) or email address of the participant

      - `joined_at: string`

        When this participant joined the chat

      - `service: ServiceType`

        Messaging service type

        - `"iMessage"`

        - `"SMS"`

        - `"RCS"`

      - `is_me?: boolean | null`

        Whether this handle belongs to the sender (your phone number)

      - `left_at?: string | null`

        When they left (if applicable)

      - `status?: "active" | "left" | "removed" | null`

        Participant status

        - `"active"`

        - `"left"`

        - `"removed"`

    - `is_me: boolean`

      Whether this reaction is from the current user

    - `type: ReactionType`

      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.
      Sticker reactions have type "sticker" with sticker attachment details in the sticker field.

      - `"love"`

      - `"like"`

      - `"dislike"`

      - `"laugh"`

      - `"emphasize"`

      - `"question"`

      - `"custom"`

      - `"sticker"`

    - `custom_emoji?: string | null`

      Custom emoji if type is "custom", null otherwise

    - `sticker?: Sticker | null`

      Sticker attachment details when reaction_type is "sticker". Null for non-sticker reactions.

      - `file_name?: string`

        Filename of the sticker

      - `height?: number`

        Sticker image height in pixels

      - `mime_type?: string`

        MIME type of the sticker image

      - `url?: string`

        Presigned URL for downloading the sticker image (expires in 1 hour).

      - `width?: number`

        Sticker image width in pixels

  - `type: "text"`

    Indicates this is a text message part

    - `"text"`

  - `value: string`

    The text content

  - `text_decorations?: Array<TextDecoration> | null`

    Text decorations applied to character ranges in the value

    - `range: Array<number>`

      Character range `[start, end)` in the `value` string where the decoration applies.
      `start` is inclusive, `end` is exclusive.
      *Characters are measured as UTF-16 code units. Most characters count as 1; some emoji count as 2.*

    - `animation?: "big" | "small" | "shake" | 5 more`

      Animated text effect to apply. Mutually exclusive with `style`.

      - `"big"`

      - `"small"`

      - `"shake"`

      - `"nod"`

      - `"explode"`

      - `"ripple"`

      - `"bloom"`

      - `"jitter"`

    - `style?: "bold" | "italic" | "strikethrough" | "underline"`

      Text style to apply. Mutually exclusive with `animation`.

      - `"bold"`

      - `"italic"`

      - `"strikethrough"`

      - `"underline"`