@linqapp/sdk 0.34.0 → 0.35.1

package/src/resources/attachments.ts

@@ -435,7 +435,8 @@ export interface AttachmentCreateResponse {
   /**
    * Presigned URL for uploading the file. PUT the raw binary file content to this
    * URL with the `required_headers`. Do not JSON-encode or multipart-wrap the body.
-   * Expires after 15 minutes.
+   * Expires after 15 minutes. Treat the URL as opaque — the hostname depends on
+   * partner configuration and is the same across sandbox and production.
    */
   upload_url: string;
 }

package/src/resources/blocked-handles.ts

@@ -0,0 +1,129 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+
+/**
+ * Block handles — phone numbers, email addresses, SMS short codes, or
+ * sender IDs. Inbound messages from a blocked handle are dropped before
+ * they reach your webhooks, and direct sends to a blocked handle are
+ * rejected with `403` (error code `2026`). Group sends that include
+ * unblocked members are not restricted.
+ */
+export class BlockedHandles extends APIResource {
+  /**
+   * Returns all handles you have blocked. Inbound messages from a blocked handle are
+   * dropped and produce no webhooks, and direct sends to a blocked handle are
+   * rejected with `403` (error code `2026`). Group sends that include unblocked
+   * members are not restricted.
+   *
+   * @example
+   * ```ts
+   * const blockedHandles = await client.blockedHandles.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<BlockedHandleListResponse> {
+    return this._client.get('/v3/blocked_handles', options);
+  }
+
+  /**
+   * Blocks a handle — an E.164 phone number, an email address (iMessage sender), an
+   * SMS short code (e.g. `262966`), or an alphanumeric sender ID. Inbound messages
+   * from it are dropped and produce no webhooks, and direct sends to it are rejected
+   * with `403` (error code `2026`); group sends that include unblocked members are
+   * not restricted. Blocking is idempotent — re-blocking an already blocked handle
+   * returns the existing entry.
+   *
+   * @example
+   * ```ts
+   * const response = await client.blockedHandles.block({
+   *   handle: '+12025551234',
+   *   reason: 'spam',
+   * });
+   * ```
+   */
+  block(body: BlockedHandleBlockParams, options?: RequestOptions): APIPromise<BlockedHandleBlockResponse> {
+    return this._client.post('/v3/blocked_handles', { body, ...options });
+  }
+
+  /**
+   * Removes a handle from your blocklist. Inbound messages from it will be delivered
+   * again and sends to it are allowed again. The handle goes in the request body,
+   * mirroring block — no URL encoding needed.
+   *
+   * @example
+   * ```ts
+   * await client.blockedHandles.unblock({
+   *   handle: '+12025551234',
+   * });
+   * ```
+   */
+  unblock(body: BlockedHandleUnblockParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete('/v3/blocked_handles', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface BlockedHandleEntry {
+  /**
+   * When the handle was blocked
+   */
+  blocked_at: string;
+
+  /**
+   * The blocked handle, normalized (E.164 phone, lowercased email, short code, or
+   * sender ID)
+   */
+  handle: string;
+
+  /**
+   * Optional note recorded when the handle was blocked
+   */
+  reason?: string;
+}
+
+export interface BlockedHandleListResponse {
+  /**
+   * All handles blocked by the partner, newest first
+   */
+  blocked_handles: Array<BlockedHandleEntry>;
+}
+
+export interface BlockedHandleBlockResponse {
+  blocked_handle: BlockedHandleEntry;
+}
+
+export interface BlockedHandleBlockParams {
+  /**
+   * The handle to block: an E.164 phone number, an email address, an SMS short code
+   * (3-8 digits), or an alphanumeric sender ID.
+   */
+  handle: string;
+
+  /**
+   * Optional free-text note on why the handle was blocked
+   */
+  reason?: string;
+}
+
+export interface BlockedHandleUnblockParams {
+  /**
+   * The handle to unblock
+   */
+  handle: string;
+}
+
+export declare namespace BlockedHandles {
+  export {
+    type BlockedHandleEntry as BlockedHandleEntry,
+    type BlockedHandleListResponse as BlockedHandleListResponse,
+    type BlockedHandleBlockResponse as BlockedHandleBlockResponse,
+    type BlockedHandleBlockParams as BlockedHandleBlockParams,
+    type BlockedHandleUnblockParams as BlockedHandleUnblockParams,
+  };
+}

package/src/resources/chats/chats.ts

@@ -387,14 +387,14 @@ export namespace Chat {
      * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
      * to react. `doc_url` deep-links to the relevant section.
      *
-     * `OPTED_OUT` is terminal — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`,
-     * `CANCEL`, `END`, or `QUIT`. The keyword must be the whole trimmed message, never
-     * part of a longer one: `STOP` counts, `please stop` does not. Most keywords must
-     * match exactly, including case. `OPT OUT` is the exception — it matches in any
-     * casing, with or without the space or a hyphen, so `opt out`, `Opt-Out` and
-     * `optout` all count. It clears if they later send `START`, `OPTIN`, or `UNSTOP`,
-     * or if they keep replying on the chat — sustained two-way conversation is treated
-     * as a sign the stop keyword was a false positive.
+     * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
+     * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
+     * longer one: `STOP` counts, `please stop` does not. Most keywords must match
+     * exactly, including case. `OPT OUT` is the exception — it matches in any casing,
+     * with or without the space or a hyphen, so `opt out`, `Opt-Out` and `optout` all
+     * count. It clears as soon as they reply again: any later message from them that
+     * is not itself an opt-out keyword opts them back in immediately — a reply in any
+     * conversation with you counts, the same way the block does.
      *
      * Linq enforces this: while a recipient is opted out, every send to them is
      * rejected with `403` (error code `2024`) before the message is queued, across
@@ -875,14 +875,14 @@ export namespace ChatCreateResponse {
        * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
        * to react. `doc_url` deep-links to the relevant section.
        *
-       * `OPTED_OUT` is terminal — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`,
-       * `CANCEL`, `END`, or `QUIT`. The keyword must be the whole trimmed message, never
-       * part of a longer one: `STOP` counts, `please stop` does not. Most keywords must
-       * match exactly, including case. `OPT OUT` is the exception — it matches in any
-       * casing, with or without the space or a hyphen, so `opt out`, `Opt-Out` and
-       * `optout` all count. It clears if they later send `START`, `OPTIN`, or `UNSTOP`,
-       * or if they keep replying on the chat — sustained two-way conversation is treated
-       * as a sign the stop keyword was a false positive.
+       * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
+       * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
+       * longer one: `STOP` counts, `please stop` does not. Most keywords must match
+       * exactly, including case. `OPT OUT` is the exception — it matches in any casing,
+       * with or without the space or a hyphen, so `opt out`, `Opt-Out` and `optout` all
+       * count. It clears as soon as they reply again: any later message from them that
+       * is not itself an opt-out keyword opts them back in immediately — a reply in any
+       * conversation with you counts, the same way the block does.
        *
        * Linq enforces this: while a recipient is opted out, every send to them is
        * rejected with `403` (error code `2024`) before the message is queued, across

package/src/resources/index.ts

@@ -13,6 +13,14 @@ export {
   type AvailableNumberRetrieveResponse,
   type AvailableNumberRetrieveParams,
 } from './available-number';
+export {
+  BlockedHandles,
+  type BlockedHandleEntry,
+  type BlockedHandleListResponse,
+  type BlockedHandleBlockResponse,
+  type BlockedHandleBlockParams,
+  type BlockedHandleUnblockParams,
+} from './blocked-handles';
 export {
   Capability,
   type HandleCheck,

package/src/resources/messages/messages.ts

@@ -846,6 +846,16 @@ export interface MessageUpdateAppCardParams {
    */
   layout: MessageUpdateAppCardParams.Layout;
 
+  /**
+   * Invokes an action on an experience — a third party that renders inside Linq's
+   * iMessage app. Linq resolves the recipient's connection, mints any session the
+   * action needs, composes the card and sends it; none of that is visible to you.
+   *
+   * Call `GET /v3/experiences/{experience}` for the actions you may invoke and the
+   * fields each accepts.
+   */
+  action?: MessageUpdateAppCardParams.Action;
+
   /**
    * Text shown on surfaces that cannot render the card (notifications, lock screen).
    * Defaults to the caption when omitted.
@@ -867,6 +877,8 @@ export interface MessageUpdateAppCardParams {
 
   /**
    * URL the recipient's app opens when they tap the updated card.
+   *
+   * Mutually exclusive with `action` and `raw_payload_data`.
    */
   url?: string;
 }
@@ -930,6 +942,35 @@ export namespace MessageUpdateAppCardParams {
      */
     trailing_subcaption?: string;
   }
+
+  /**
+   * Invokes an action on an experience — a third party that renders inside Linq's
+   * iMessage app. Linq resolves the recipient's connection, mints any session the
+   * action needs, composes the card and sends it; none of that is visible to you.
+   *
+   * Call `GET /v3/experiences/{experience}` for the actions you may invoke and the
+   * fields each accepts.
+   */
+  export interface Action {
+    /**
+     * Which of its actions, e.g. `attach_card`.
+     */
+    action: string;
+
+    /**
+     * The experience to invoke, e.g. `agentcard`.
+     */
+    experience: string;
+
+    /**
+     * Values for the fields this action exposes. Keys are exactly the field names
+     * listed for the action — no mapping, no nesting.
+     *
+     * Display copy only, except a `url`-type field — that value sets the destination,
+     * and must be an absolute `https` URL.
+     */
+    params?: { [key: string]: unknown };
+  }
 }
 
 Messages.Poll = Poll;

package/src/resources/webhooks.ts

@@ -185,14 +185,14 @@ export namespace MessageEventV2 {
        * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
        * to react. `doc_url` deep-links to the relevant section.
        *
-       * `OPTED_OUT` is terminal — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`,
-       * `CANCEL`, `END`, or `QUIT`. The keyword must be the whole trimmed message, never
-       * part of a longer one: `STOP` counts, `please stop` does not. Most keywords must
-       * match exactly, including case. `OPT OUT` is the exception — it matches in any
-       * casing, with or without the space or a hyphen, so `opt out`, `Opt-Out` and
-       * `optout` all count. It clears if they later send `START`, `OPTIN`, or `UNSTOP`,
-       * or if they keep replying on the chat — sustained two-way conversation is treated
-       * as a sign the stop keyword was a false positive.
+       * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
+       * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
+       * longer one: `STOP` counts, `please stop` does not. Most keywords must match
+       * exactly, including case. `OPT OUT` is the exception — it matches in any casing,
+       * with or without the space or a hyphen, so `opt out`, `Opt-Out` and `optout` all
+       * count. It clears as soon as they reply again: any later message from them that
+       * is not itself an opt-out keyword opts them back in immediately — a reply in any
+       * conversation with you counts, the same way the block does.
        *
        * Linq enforces this: while a recipient is opted out, every send to them is
        * rejected with `403` (error code `2024`) before the message is queued, across
@@ -1021,7 +1021,10 @@ export namespace MessageFailedWebhookEvent {
    */
   export interface Data {
     /**
-     * Error codes in webhook failure events (3007, 4001, 4005).
+     * Error codes in webhook failure events. The possible set varies by event:
+     * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
+     * update failure events (chat.group_name_update_failed,
+     * chat.group_icon_update_failed) carry 3007 or 4001.
      */
     code: number;
 
@@ -1035,15 +1038,32 @@ export namespace MessageFailedWebhookEvent {
      */
     chat_id?: string;
 
+    /**
+     * Opaque diagnostic code identifying the specific failure class within `code`.
+     * Values are not enumerated and may change without notice — log it and include it
+     * in support requests, but do not branch on it.
+     */
+    detail_code?: number | null;
+
     /**
      * Message identifier (UUID)
      */
     message_id?: string;
 
+    /**
+     * Preferred messaging service type. Includes "auto" for default fallback behavior.
+     */
+    preferred_service?: 'iMessage' | 'SMS' | 'RCS' | 'auto' | null;
+
     /**
      * Human-readable description of the failure
      */
     reason?: string;
+
+    /**
+     * Messaging service type
+     */
+    service?: Shared.ServiceType | null;
   }
 }
 
@@ -1201,14 +1221,14 @@ export namespace MessageEditedWebhookEvent {
          * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
          * to react. `doc_url` deep-links to the relevant section.
          *
-         * `OPTED_OUT` is terminal — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`,
-         * `CANCEL`, `END`, or `QUIT`. The keyword must be the whole trimmed message, never
-         * part of a longer one: `STOP` counts, `please stop` does not. Most keywords must
-         * match exactly, including case. `OPT OUT` is the exception — it matches in any
-         * casing, with or without the space or a hyphen, so `opt out`, `Opt-Out` and
-         * `optout` all count. It clears if they later send `START`, `OPTIN`, or `UNSTOP`,
-         * or if they keep replying on the chat — sustained two-way conversation is treated
-         * as a sign the stop keyword was a false positive.
+         * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
+         * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
+         * longer one: `STOP` counts, `please stop` does not. Most keywords must match
+         * exactly, including case. `OPT OUT` is the exception — it matches in any casing,
+         * with or without the space or a hyphen, so `opt out`, `Opt-Out` and `optout` all
+         * count. It clears as soon as they reply again: any later message from them that
+         * is not itself an opt-out keyword opts them back in immediately — a reply in any
+         * conversation with you counts, the same way the block does.
          *
          * Linq enforces this: while a recipient is opted out, every send to them is
          * rejected with `403` (error code `2024`) before the message is queued, across
@@ -1638,14 +1658,14 @@ export namespace ChatCreatedWebhookEvent {
        * [Chat Health guide](/guides/chats/chat-health) for what each value means and how
        * to react. `doc_url` deep-links to the relevant section.
        *
-       * `OPTED_OUT` is terminal — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`,
-       * `CANCEL`, `END`, or `QUIT`. The keyword must be the whole trimmed message, never
-       * part of a longer one: `STOP` counts, `please stop` does not. Most keywords must
-       * match exactly, including case. `OPT OUT` is the exception — it matches in any
-       * casing, with or without the space or a hyphen, so `opt out`, `Opt-Out` and
-       * `optout` all count. It clears if they later send `START`, `OPTIN`, or `UNSTOP`,
-       * or if they keep replying on the chat — sustained two-way conversation is treated
-       * as a sign the stop keyword was a false positive.
+       * `OPTED_OUT` — the recipient sent `STOP`, `UNSUBSCRIBE`, `OPTOUT`, `CANCEL`,
+       * `END`, or `QUIT`. The keyword must be the whole trimmed message, never part of a
+       * longer one: `STOP` counts, `please stop` does not. Most keywords must match
+       * exactly, including case. `OPT OUT` is the exception — it matches in any casing,
+       * with or without the space or a hyphen, so `opt out`, `Opt-Out` and `optout` all
+       * count. It clears as soon as they reply again: any later message from them that
+       * is not itself an opt-out keyword opts them back in immediately — a reply in any
+       * conversation with you counts, the same way the block does.
        *
        * Linq enforces this: while a recipient is opted out, every send to them is
        * rejected with `403` (error code `2024`) before the message is queued, across
@@ -1895,7 +1915,10 @@ export namespace ChatGroupNameUpdateFailedWebhookEvent {
     chat_id: string;
 
     /**
-     * Error codes in webhook failure events (3007, 4001, 4005).
+     * Error codes in webhook failure events. The possible set varies by event:
+     * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
+     * update failure events (chat.group_name_update_failed,
+     * chat.group_icon_update_failed) carry 3007 or 4001.
      */
     error_code: number;
 
@@ -1972,7 +1995,10 @@ export namespace ChatGroupIconUpdateFailedWebhookEvent {
     chat_id: string;
 
     /**
-     * Error codes in webhook failure events (3007, 4001, 4005).
+     * Error codes in webhook failure events. The possible set varies by event:
+     * message.failed can carry 3007, 4001, 4002, 4005, 4006, 4007, or 4008; the group
+     * update failure events (chat.group_name_update_failed,
+     * chat.group_icon_update_failed) carry 3007 or 4001.
      */
     error_code: number;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.34.0'; // x-release-please-version
+export const VERSION = '0.35.1'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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