@linqapp/sdk 0.53.0 → 0.54.0

package/src/resources/payment-requests.ts

@@ -141,7 +141,7 @@ import { path } from '../internal/utils/path';
  * `POST /v3/chats/{chatId}/messages` — it renders as a rich card with your
  * branding (title, amount, image) instead of a bare URL, which converts far
  * better. A `link` part must be the only part in the message. See
- * [Rich Link Previews](/guides/messaging/sending-messages).
+ * [Rich Link Previews](/channel/imessage/guides/messaging/sending-messages).
  *
  * On a supported iPhone the link opens an **Apple Pay App Clip** — a native,
  * no-install checkout sheet. Everywhere else (Android, desktop, iPhones
@@ -191,7 +191,7 @@ import { path } from '../internal/utils/path';
  * Subscribe to payment lifecycle events to reconcile server-side rather than
  * polling: `payment.succeeded`, `payment.canceled`, and `payment.expired`.
  * Each event carries the payment request id, amount, currency, and your
- * `metadata`. See [Webhooks](/guides/webhooks).
+ * `metadata`. See [Webhooks](/channel/imessage/guides/webhooks).
  */
 export class PaymentRequests extends APIResource {
   /**

package/src/resources/phone-numbers.ts

@@ -383,8 +383,9 @@ export namespace PhoneNumberListResponse {
      * Unlike chat health, line reputation does not include `opted_out` — opt-out
      * applies to individual recipients, not the whole line.
      *
-     * See the [Phone Reputation guide](/guides/phone-numbers/phone-reputation) for
-     * what each status means and how to react.
+     * See the
+     * [Phone Reputation guide](/channel/imessage/guides/phone-numbers/phone-reputation)
+     * for what each status means and how to react.
      */
     reputation: PhoneNumber.Reputation;
 
@@ -404,8 +405,9 @@ export namespace PhoneNumberListResponse {
      * Unlike chat health, line reputation does not include `opted_out` — opt-out
      * applies to individual recipients, not the whole line.
      *
-     * See the [Phone Reputation guide](/guides/phone-numbers/phone-reputation) for
-     * what each status means and how to react.
+     * See the
+     * [Phone Reputation guide](/channel/imessage/guides/phone-numbers/phone-reputation)
+     * for what each status means and how to react.
      */
     export interface Reputation {
       /**

package/src/resources/webhook-events.ts

@@ -202,7 +202,7 @@ export interface WebhookEventListResponse {
   /**
    * URL to the webhook events documentation
    */
-  doc_url: 'https://docs.linqapp.com/guides/webhooks/events';
+  doc_url: 'https://docs.linqapp.com/channel/imessage/guides/webhooks/events';
 
   /**
    * List of all available webhook event types

package/src/resources/webhook-subscriptions.ts

@@ -161,7 +161,7 @@ export class WebhookSubscriptions extends APIResource {
    * - Legacy `X-Webhook-*` headers are also sent for backwards compatibility
    *   (deprecated)
    * - See
-   *   [Verifying Webhook Signatures](https://docs.linqapp.com/guides/webhooks#verifying-webhook-signatures)
+   *   [Verifying Webhook Signatures](https://docs.linqapp.com/channel/imessage/guides/webhooks#verifying-webhook-signatures)
    *   for verification details
    * - Failed deliveries (5xx, 429, network errors) are retried up to 10 times over
    *   ~25 minutes with exponential backoff

package/src/resources/webhooks.ts

@@ -146,8 +146,8 @@ export namespace MessageEventV2 {
      * relevant section of the Chat Health guide. To gate a send, act on the response
      * rather than the status: a `403` is the authoritative answer.
      *
-     * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-     * means and how to react.
+     * See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+     * each status means and how to react.
      */
     health_status: Chat.HealthStatus;
 
@@ -174,8 +174,8 @@ export namespace MessageEventV2 {
      * relevant section of the Chat Health guide. To gate a send, act on the response
      * rather than the status: a `403` is the authoritative answer.
      *
-     * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-     * means and how to react.
+     * See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+     * each status means and how to react.
      */
     export interface HealthStatus {
       /**
@@ -185,8 +185,8 @@ export namespace MessageEventV2 {
 
       /**
        * Current health bucket for the chat. See the
-       * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
-       * to react. `doc_url` deep-links to the relevant section.
+       * [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each
+       * value means and how to react. `doc_url` deep-links to the relevant section.
        *
        * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
        * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -1308,8 +1308,8 @@ export namespace MessageEditedWebhookEvent {
        * relevant section of the Chat Health guide. To gate a send, act on the response
        * rather than the status: a `403` is the authoritative answer.
        *
-       * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-       * means and how to react.
+       * See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+       * each status means and how to react.
        */
       health_status: Chat.HealthStatus;
 
@@ -1336,8 +1336,8 @@ export namespace MessageEditedWebhookEvent {
        * relevant section of the Chat Health guide. To gate a send, act on the response
        * rather than the status: a `403` is the authoritative answer.
        *
-       * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-       * means and how to react.
+       * See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+       * each status means and how to react.
        */
       export interface HealthStatus {
         /**
@@ -1347,8 +1347,8 @@ export namespace MessageEditedWebhookEvent {
 
         /**
          * Current health bucket for the chat. See the
-         * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
-         * to react. `doc_url` deep-links to the relevant section.
+         * [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each
+         * value means and how to react. `doc_url` deep-links to the relevant section.
          *
          * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
          * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -2798,8 +2798,8 @@ export namespace ChatCreatedWebhookEvent {
      * relevant section of the Chat Health guide. To gate a send, act on the response
      * rather than the status: a `403` is the authoritative answer.
      *
-     * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-     * means and how to react.
+     * See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+     * each status means and how to react.
      */
     health_status: Data.HealthStatus;
 
@@ -2831,8 +2831,8 @@ export namespace ChatCreatedWebhookEvent {
      * relevant section of the Chat Health guide. To gate a send, act on the response
      * rather than the status: a `403` is the authoritative answer.
      *
-     * See the [Chat Health guide](/guides/chats/chat-health) for what each status
-     * means and how to react.
+     * See the [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what
+     * each status means and how to react.
      */
     export interface HealthStatus {
       /**
@@ -2842,8 +2842,8 @@ export namespace ChatCreatedWebhookEvent {
 
       /**
        * Current health bucket for the chat. See the
-       * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
-       * to react. `doc_url` deep-links to the relevant section.
+       * [Chat Health guide](/channel/imessage/guides/chats/chat-health) for what each
+       * value means and how to react. `doc_url` deep-links to the relevant section.
        *
        * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
        * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
@@ -3539,6 +3539,107 @@ export namespace ChatBackgroundUpdateFailedWebhookEvent {
   }
 }
 
+/**
+ * Complete webhook payload for contact_card.received events
+ */
+export interface ContactCardReceivedWebhookEvent {
+  /**
+   * API version for the webhook payload format
+   */
+  api_version: string;
+
+  /**
+   * When the event was created
+   */
+  created_at: string;
+
+  /**
+   * Payload for contact_card.received webhook events.
+   *
+   * A contact belongs to a line, not to an individual chat. You receive one event
+   * per person who shares their contact, regardless of how many chats they have in
+   * common with your line.
+   *
+   * The event fires again whenever the shared contact's name or media changes.
+   */
+  data: ContactCardReceivedWebhookEvent.Data;
+
+  /**
+   * Unique identifier for this event (for deduplication)
+   */
+  event_id: string;
+
+  /**
+   * Valid webhook event types that can be subscribed to.
+   *
+   * **Note:** `message.edited` is only delivered to subscriptions using
+   * `webhook_version: "2026-02-03"`. Subscribing to this event on a v2025
+   * subscription will not produce any deliveries.
+   */
+  event_type: WebhookEventsAPI.WebhookEventType;
+
+  /**
+   * Partner identifier. Present on all webhooks for cross-referencing.
+   */
+  partner_id: string;
+
+  /**
+   * Trace ID for debugging and correlation across systems.
+   */
+  trace_id: string;
+
+  /**
+   * Date-based webhook payload version. Determined by the `?version=` query
+   * parameter in your webhook subscription URL. If no version parameter is
+   * specified, defaults based on subscription creation date.
+   */
+  webhook_version: string;
+}
+
+export namespace ContactCardReceivedWebhookEvent {
+  /**
+   * Payload for contact_card.received webhook events.
+   *
+   * A contact belongs to a line, not to an individual chat. You receive one event
+   * per person who shares their contact, regardless of how many chats they have in
+   * common with your line.
+   *
+   * The event fires again whenever the shared contact's name or media changes.
+   */
+  export interface Data {
+    /**
+     * First name from the shared contact card
+     */
+    first_name: string;
+
+    /**
+     * Last name from the shared contact card (may be empty)
+     */
+    last_name: string;
+
+    /**
+     * Which of your lines they shared it with.
+     */
+    owner_handle: string;
+
+    /**
+     * The person who shared their card — a phone number or email address.
+     */
+    sender_handle: string;
+
+    /**
+     * URL of the contact's media, served from `cdn.linqapp.com`. `null` when the
+     * contact shared no media, and also when media was shared but could not be
+     * retrieved — this field does not distinguish the two.
+     *
+     * Download the media and store it yourself. The URL may be signed and expire, in
+     * as little as 45 minutes, and altering its query string invalidates it
+     * immediately.
+     */
+    media_url?: string | null;
+  }
+}
+
 /**
  * Complete webhook payload for phone_number.status_updated events
  */
@@ -3701,6 +3802,7 @@ export type UnwrapWebhookEvent =
   | ChatTypingIndicatorStoppedWebhookEvent
   | ChatBackgroundUpdatedWebhookEvent
   | ChatBackgroundUpdateFailedWebhookEvent
+  | ContactCardReceivedWebhookEvent
   | PhoneNumberStatusUpdatedWebhookEvent;
 
 export declare namespace Webhooks {
@@ -3739,6 +3841,7 @@ export declare namespace Webhooks {
     type ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent,
     type ChatBackgroundUpdatedWebhookEvent as ChatBackgroundUpdatedWebhookEvent,
     type ChatBackgroundUpdateFailedWebhookEvent as ChatBackgroundUpdateFailedWebhookEvent,
+    type ContactCardReceivedWebhookEvent as ContactCardReceivedWebhookEvent,
     type PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
     type UnwrapWebhookEvent as UnwrapWebhookEvent,
   };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.53.0'; // x-release-please-version
+export const VERSION = '0.54.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.53.0";
+export declare const VERSION = "0.54.0";
 //# 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.53.0'; // x-release-please-version
+exports.VERSION = '0.54.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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