@linqapp/sdk 0.27.0 → 0.27.1

package/src/resources/chats/chats.ts

@@ -478,7 +478,7 @@ export interface MessageContent {
    *   sub-limit. For bulk media sends exceeding 40 files, pre-upload via
    *   `POST /v3/attachments` and reference by `attachment_id` or `download_url`.
    */
-  parts: Array<TextPart | MediaPart | LinkPart>;
+  parts: Array<TextPart | MediaPart | LinkPart | MessageContent.IMessageAppPart>;
 
   /**
    * iMessage effect to apply to this message (screen or bubble effect)
@@ -502,6 +502,122 @@ export interface MessageContent {
   reply_to?: MessagesAPI.ReplyTo;
 }
 
+export namespace MessageContent {
+  /**
+   * An iMessage app card, backed by a Messages app extension. iMessage only — an
+   * `imessage_app` part must be the **only** part in the message and is never
+   * delivered over SMS/RCS. See the IMessageAppServiceUnsupported (2018) and
+   * RecipientUnsupportedMessageType (4005) error codes.
+   */
+  export interface IMessageAppPart {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    app: IMessageAppPart.App;
+
+    /**
+     * Visible layout of the card. At least one of `caption`, `subcaption`,
+     * `trailing_caption`, `trailing_subcaption`, or `image_url` must be set, otherwise
+     * the card renders as an empty bubble.
+     */
+    layout: IMessageAppPart.Layout;
+
+    /**
+     * Indicates this is an iMessage app card part.
+     */
+    type: 'imessage_app';
+
+    /**
+     * Absolute HTTPS URL delivered to the recipient's installed iMessage app when they
+     * tap the card. Opaque to Messages.
+     */
+    url: string;
+
+    /**
+     * Text shown on surfaces that cannot render the card (notifications, lock screen).
+     * Defaults to the caption when omitted.
+     */
+    fallback_text?: string;
+
+    /**
+     * Optional client-supplied identifier to correlate updatable/collaborative app
+     * sessions (advanced). Not interpreted by Synapse.
+     */
+    session_id?: string;
+  }
+
+  export namespace IMessageAppPart {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    export interface App {
+      /**
+       * Bundle identifier of the Messages app extension. Must not contain `:`.
+       */
+      bundle_id: string;
+
+      /**
+       * Display name of the app, shown by Messages' fallback UI.
+       */
+      name: string;
+
+      /**
+       * The app's 10-character uppercase alphanumeric team identifier.
+       */
+      team_id: string;
+
+      /**
+       * The owning app's App Store id (optional). When set, recipients without the
+       * iMessage app installed see a "Get the app" affordance.
+       */
+      app_store_id?: number;
+    }
+
+    /**
+     * Visible layout of the card. At least one of `caption`, `subcaption`,
+     * `trailing_caption`, `trailing_subcaption`, or `image_url` must be set, otherwise
+     * the card renders as an empty bubble.
+     */
+    export interface Layout {
+      /**
+       * Primary label, top-left and bold.
+       */
+      caption?: string;
+
+      /**
+       * Overlay text shown below `image_title`. Requires `image_url`.
+       */
+      image_subtitle?: string;
+
+      /**
+       * Overlay text shown above the image. Requires `image_url`.
+       */
+      image_title?: string;
+
+      /**
+       * Optional HTTPS URL of a preview image. The server downloads it and embeds it in
+       * the card as JPEG (10MB max, same fetch rules as media parts).
+       */
+      image_url?: string;
+
+      /**
+       * Secondary label, below `caption` on the left.
+       */
+      subcaption?: string;
+
+      /**
+       * Label shown top-right.
+       */
+      trailing_caption?: string;
+
+      /**
+       * Label shown below `trailing_caption`, on the right.
+       */
+      trailing_subcaption?: string;
+    }
+  }
+}
+
 export interface TextPart {
   /**
    * Indicates this is a text message part

package/src/resources/chats/messages.ts

@@ -149,7 +149,12 @@ export interface SentMessage {
   /**
    * Message parts in order (text, media, and link)
    */
-  parts: Array<Shared.TextPartResponse | Shared.MediaPartResponse | Shared.LinkPartResponse>;
+  parts: Array<
+    | Shared.TextPartResponse
+    | Shared.MediaPartResponse
+    | Shared.LinkPartResponse
+    | SentMessage.IMessageAppPartResponse
+  >;
 
   /**
    * When the message was actually sent (null if still queued)
@@ -187,6 +192,121 @@ export interface SentMessage {
   service?: Shared.ServiceType | null;
 }
 
+export namespace SentMessage {
+  /**
+   * An iMessage app card part.
+   */
+  export interface IMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    app: IMessageAppPartResponse.App;
+
+    /**
+     * Visible layout of the card. At least one of `caption`, `subcaption`,
+     * `trailing_caption`, `trailing_subcaption`, or `image_url` must be set, otherwise
+     * the card renders as an empty bubble.
+     */
+    layout: IMessageAppPartResponse.Layout;
+
+    /**
+     * Reactions on this message part
+     */
+    reactions: Array<Shared.Reaction> | null;
+
+    /**
+     * Indicates this is an iMessage app card part.
+     */
+    type: 'imessage_app';
+
+    /**
+     * The URL delivered to the iMessage app on tap.
+     */
+    url: string;
+
+    /**
+     * Fallback text for surfaces that cannot render the card.
+     */
+    fallback_text?: string | null;
+
+    /**
+     * Client-supplied session identifier, echoed back when provided.
+     */
+    session_id?: string | null;
+  }
+
+  export namespace IMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    export interface App {
+      /**
+       * Bundle identifier of the Messages app extension. Must not contain `:`.
+       */
+      bundle_id: string;
+
+      /**
+       * Display name of the app, shown by Messages' fallback UI.
+       */
+      name: string;
+
+      /**
+       * The app's 10-character uppercase alphanumeric team identifier.
+       */
+      team_id: string;
+
+      /**
+       * The owning app's App Store id (optional). When set, recipients without the
+       * iMessage app installed see a "Get the app" affordance.
+       */
+      app_store_id?: number;
+    }
+
+    /**
+     * Visible layout of the card. At least one of `caption`, `subcaption`,
+     * `trailing_caption`, `trailing_subcaption`, or `image_url` must be set, otherwise
+     * the card renders as an empty bubble.
+     */
+    export interface Layout {
+      /**
+       * Primary label, top-left and bold.
+       */
+      caption?: string;
+
+      /**
+       * Overlay text shown below `image_title`. Requires `image_url`.
+       */
+      image_subtitle?: string;
+
+      /**
+       * Overlay text shown above the image. Requires `image_url`.
+       */
+      image_title?: string;
+
+      /**
+       * Optional HTTPS URL of a preview image. The server downloads it and embeds it in
+       * the card as JPEG (10MB max, same fetch rules as media parts).
+       */
+      image_url?: string;
+
+      /**
+       * Secondary label, below `caption` on the left.
+       */
+      subcaption?: string;
+
+      /**
+       * Label shown top-right.
+       */
+      trailing_caption?: string;
+
+      /**
+       * Label shown below `trailing_caption`, on the right.
+       */
+      trailing_subcaption?: string;
+    }
+  }
+}
+
 /**
  * Response for sending a message to a chat
  */

package/src/resources/index.ts

@@ -12,7 +12,7 @@ export {
   Capability,
   type HandleCheck,
   type HandleCheckResponse,
-  type CapabilityCheckiMessageParams,
+  type CapabilityCheckIMessageParams,
   type CapabilityCheckRCSParams,
 } from './capability';
 export {

package/src/resources/messages.ts

@@ -210,7 +210,12 @@ export interface Message {
   /**
    * Message parts in order (text, media, and link)
    */
-  parts?: Array<Shared.TextPartResponse | Shared.MediaPartResponse | Shared.LinkPartResponse> | null;
+  parts?: Array<
+    | Shared.TextPartResponse
+    | Shared.MediaPartResponse
+    | Shared.LinkPartResponse
+    | Message.IMessageAppPartResponse
+  > | null;
 
   /**
    * Messaging service type
@@ -238,6 +243,121 @@ export interface Message {
   service?: Shared.ServiceType | null;
 }
 
+export namespace Message {
+  /**
+   * An iMessage app card part.
+   */
+  export interface IMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    app: IMessageAppPartResponse.App;
+
+    /**
+     * Visible layout of the card. At least one of `caption`, `subcaption`,
+     * `trailing_caption`, `trailing_subcaption`, or `image_url` must be set, otherwise
+     * the card renders as an empty bubble.
+     */
+    layout: IMessageAppPartResponse.Layout;
+
+    /**
+     * Reactions on this message part
+     */
+    reactions: Array<Shared.Reaction> | null;
+
+    /**
+     * Indicates this is an iMessage app card part.
+     */
+    type: 'imessage_app';
+
+    /**
+     * The URL delivered to the iMessage app on tap.
+     */
+    url: string;
+
+    /**
+     * Fallback text for surfaces that cannot render the card.
+     */
+    fallback_text?: string | null;
+
+    /**
+     * Client-supplied session identifier, echoed back when provided.
+     */
+    session_id?: string | null;
+  }
+
+  export namespace IMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    export interface App {
+      /**
+       * Bundle identifier of the Messages app extension. Must not contain `:`.
+       */
+      bundle_id: string;
+
+      /**
+       * Display name of the app, shown by Messages' fallback UI.
+       */
+      name: string;
+
+      /**
+       * The app's 10-character uppercase alphanumeric team identifier.
+       */
+      team_id: string;
+
+      /**
+       * The owning app's App Store id (optional). When set, recipients without the
+       * iMessage app installed see a "Get the app" affordance.
+       */
+      app_store_id?: number;
+    }
+
+    /**
+     * Visible layout of the card. At least one of `caption`, `subcaption`,
+     * `trailing_caption`, `trailing_subcaption`, or `image_url` must be set, otherwise
+     * the card renders as an empty bubble.
+     */
+    export interface Layout {
+      /**
+       * Primary label, top-left and bold.
+       */
+      caption?: string;
+
+      /**
+       * Overlay text shown below `image_title`. Requires `image_url`.
+       */
+      image_subtitle?: string;
+
+      /**
+       * Overlay text shown above the image. Requires `image_url`.
+       */
+      image_title?: string;
+
+      /**
+       * Optional HTTPS URL of a preview image. The server downloads it and embeds it in
+       * the card as JPEG (10MB max, same fetch rules as media parts).
+       */
+      image_url?: string;
+
+      /**
+       * Secondary label, below `caption` on the left.
+       */
+      subcaption?: string;
+
+      /**
+       * Label shown top-right.
+       */
+      trailing_caption?: string;
+
+      /**
+       * Label shown below `trailing_caption`, on the right.
+       */
+      trailing_subcaption?: string;
+    }
+  }
+}
+
 /**
  * iMessage effect applied to a message (screen or bubble effect)
  */

package/src/resources/webhooks.ts

@@ -60,7 +60,12 @@ export interface MessageEventV2 {
   /**
    * Message parts (text and/or media)
    */
-  parts: Array<SchemasTextPartResponse | SchemasMediaPartResponse | MessageEventV2.SchemasLinkPartResponse>;
+  parts: Array<
+    | SchemasTextPartResponse
+    | SchemasMediaPartResponse
+    | MessageEventV2.SchemasLinkPartResponse
+    | MessageEventV2.SchemasIMessageAppPartResponse
+  >;
 
   /**
    * The handle that sent this message
@@ -193,6 +198,108 @@ export namespace MessageEventV2 {
     value: string;
   }
 
+  /**
+   * An iMessage app card part.
+   */
+  export interface SchemasIMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    app: SchemasIMessageAppPartResponse.App;
+
+    /**
+     * Visible layout of the card.
+     */
+    layout: SchemasIMessageAppPartResponse.Layout;
+
+    /**
+     * Indicates this is an iMessage app card part.
+     */
+    type: 'imessage_app';
+
+    /**
+     * The URL delivered to the iMessage app on tap.
+     */
+    url: string;
+
+    /**
+     * Fallback text for surfaces that cannot render the card.
+     */
+    fallback_text?: string | null;
+
+    /**
+     * Client-supplied session identifier, echoed back when provided.
+     */
+    session_id?: string | null;
+  }
+
+  export namespace SchemasIMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    export interface App {
+      /**
+       * Bundle identifier of the Messages app extension.
+       */
+      bundle_id: string;
+
+      /**
+       * Display name of the app.
+       */
+      name: string;
+
+      /**
+       * The app's 10-character team identifier.
+       */
+      team_id: string;
+
+      /**
+       * The owning app's App Store id, when known.
+       */
+      app_store_id?: number | null;
+    }
+
+    /**
+     * Visible layout of the card.
+     */
+    export interface Layout {
+      /**
+       * Primary label, top-left and bold.
+       */
+      caption?: string | null;
+
+      /**
+       * Overlay text shown below image_title.
+       */
+      image_subtitle?: string | null;
+
+      /**
+       * Overlay text shown above the image.
+       */
+      image_title?: string | null;
+
+      /**
+       * Presigned URL of the card preview image, when present.
+       */
+      image_url?: string | null;
+
+      /**
+       * Secondary label, below caption on the left.
+       */
+      subcaption?: string | null;
+
+      /**
+       * Label shown top-right.
+       */
+      trailing_caption?: string | null;
+
+      /**
+       * Label shown below trailing_caption.
+       */
+      trailing_subcaption?: string | null;
+    }
+  }
+
   /**
    * Reference to the message this is replying to (for threaded replies)
    */
@@ -246,7 +353,12 @@ export interface MessagePayload {
   /**
    * Message content parts (text and/or media)
    */
-  parts?: Array<SchemasTextPartResponse | SchemasMediaPartResponse | MessagePayload.SchemasLinkPartResponse>;
+  parts?: Array<
+    | SchemasTextPartResponse
+    | SchemasMediaPartResponse
+    | MessagePayload.SchemasLinkPartResponse
+    | MessagePayload.SchemasIMessageAppPartResponse
+  >;
 
   /**
    * When the message was read
@@ -285,6 +397,108 @@ export namespace MessagePayload {
     value: string;
   }
 
+  /**
+   * An iMessage app card part.
+   */
+  export interface SchemasIMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    app: SchemasIMessageAppPartResponse.App;
+
+    /**
+     * Visible layout of the card.
+     */
+    layout: SchemasIMessageAppPartResponse.Layout;
+
+    /**
+     * Indicates this is an iMessage app card part.
+     */
+    type: 'imessage_app';
+
+    /**
+     * The URL delivered to the iMessage app on tap.
+     */
+    url: string;
+
+    /**
+     * Fallback text for surfaces that cannot render the card.
+     */
+    fallback_text?: string | null;
+
+    /**
+     * Client-supplied session identifier, echoed back when provided.
+     */
+    session_id?: string | null;
+  }
+
+  export namespace SchemasIMessageAppPartResponse {
+    /**
+     * Identifies the iMessage app (Messages app extension) that backs the card.
+     */
+    export interface App {
+      /**
+       * Bundle identifier of the Messages app extension.
+       */
+      bundle_id: string;
+
+      /**
+       * Display name of the app.
+       */
+      name: string;
+
+      /**
+       * The app's 10-character team identifier.
+       */
+      team_id: string;
+
+      /**
+       * The owning app's App Store id, when known.
+       */
+      app_store_id?: number | null;
+    }
+
+    /**
+     * Visible layout of the card.
+     */
+    export interface Layout {
+      /**
+       * Primary label, top-left and bold.
+       */
+      caption?: string | null;
+
+      /**
+       * Overlay text shown below image_title.
+       */
+      image_subtitle?: string | null;
+
+      /**
+       * Overlay text shown above the image.
+       */
+      image_title?: string | null;
+
+      /**
+       * Presigned URL of the card preview image, when present.
+       */
+      image_url?: string | null;
+
+      /**
+       * Secondary label, below caption on the left.
+       */
+      subcaption?: string | null;
+
+      /**
+       * Label shown top-right.
+       */
+      trailing_caption?: string | null;
+
+      /**
+       * Label shown below trailing_caption.
+       */
+      trailing_subcaption?: string | null;
+    }
+  }
+
   /**
    * Reference to the message this is replying to
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.27.0'; // x-release-please-version
+export const VERSION = '0.27.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.27.0";
+export declare const VERSION = "0.27.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.27.0";
+export declare const VERSION = "0.27.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.27.0'; // x-release-please-version
+exports.VERSION = '0.27.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.27.0'; // x-release-please-version
+export const VERSION = '0.27.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map