@linqapp/sdk 0.26.0 → 0.27.1

package/src/resources/webhooks.ts

@@ -3,10 +3,20 @@
 import { APIResource } from '../core/resource';
 import * as Shared from './shared';
 import * as WebhookEventsAPI from './webhook-events';
+import { Webhook } from 'standardwebhooks';
 
 export class Webhooks extends APIResource {
-  events(body: string): EventsWebhookEvent {
-    return JSON.parse(body) as EventsWebhookEvent;
+  unwrap(
+    body: string,
+    { headers, key }: { headers: Record<string, string>; key?: string },
+  ): UnwrapWebhookEvent {
+    if (headers !== undefined) {
+      const keyStr: string | null = key === undefined ? this._client.webhookSecret : key;
+      if (keyStr === null) throw new Error('Webhook key must not be null in order to unwrap');
+      const wh = new Webhook(keyStr);
+      wh.verify(body, headers);
+    }
+    return JSON.parse(body) as UnwrapWebhookEvent;
   }
 }
 
@@ -50,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
@@ -183,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)
    */
@@ -236,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
@@ -275,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
    */
@@ -1966,7 +2190,7 @@ export namespace PhoneNumberStatusUpdatedWebhookEvent {
 /**
  * Complete webhook payload for message.sent events (2026-02-03 format)
  */
-export type EventsWebhookEvent =
+export type UnwrapWebhookEvent =
   | MessageSentWebhookEvent
   | MessageReceivedWebhookEvent
   | MessageReadWebhookEvent
@@ -2012,6 +2236,6 @@ export declare namespace Webhooks {
     type ChatTypingIndicatorStartedWebhookEvent as ChatTypingIndicatorStartedWebhookEvent,
     type ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent,
     type PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
-    type EventsWebhookEvent as EventsWebhookEvent,
+    type UnwrapWebhookEvent as UnwrapWebhookEvent,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.26.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.26.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.26.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.26.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.26.0'; // x-release-please-version
+export const VERSION = '0.27.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map