@linqapp/sdk 0.8.1 → 0.10.0

package/src/resources/attachments.ts

@@ -97,13 +97,19 @@ export class Attachments extends APIResource {
    * ## Step 2: Upload the file
    *
    * Make a PUT request to the `upload_url` with the raw file bytes as the request
-   * body.. Include the headers from `required_headers`. The request body is the
-   * binary file content — **not** JSON, **not** multipart form data.
+   * body. You **must** include all headers from `required_headers` exactly as
+   * returned — the presigned URL is signed with these values and S3 will reject the
+   * upload if they don't match.
+   *
+   * The request body is the binary file content — **not** JSON, **not** multipart
+   * form data. The file must equal `size_bytes` bytes (the value you declared in
+   * step 1).
    *
    * ```bash
    * curl -X PUT "<upload_url from step 1>" \
    *   -H "Content-Type: image/jpeg" \
-   *   --data-binary @filebytes
+   *   -H "Content-Length: 1024000" \
+   *   --data-binary @photo.jpg
    * ```
    *
    * ## Step 3: Send a message with the attachment
@@ -269,7 +275,8 @@ export interface AttachmentCreateResponse {
   http_method: 'PUT';
 
   /**
-   * HTTP headers required for the upload request
+   * HTTP headers that must be set on the upload request. The presigned URL is signed
+   * with these exact values — S3 will reject the upload if they don't match.
    */
   required_headers: { [key: string]: string };
 

package/src/resources/capability.ts

@@ -14,15 +14,16 @@ export class Capability extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.capability.checkiMessage({
-   *   address: '+15551234567',
-   * });
+   * const handleCheckResponse =
+   *   await client.capability.checkiMessage({
+   *     address: '+15551234567',
+   *   });
    * ```
    */
   checkiMessage(
     body: CapabilityCheckiMessageParams,
     options?: RequestOptions,
-  ): APIPromise<CapabilityCheckiMessageResponse> {
+  ): APIPromise<HandleCheckResponse> {
     return this._client.post('/v3/capability/check_imessage', { body, ...options });
   }
 
@@ -31,29 +32,31 @@ export class Capability extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.capability.checkRCS({
-   *   address: '+15551234567',
-   * });
+   * const handleCheckResponse =
+   *   await client.capability.checkRCS({
+   *     address: '+15551234567',
+   *   });
    * ```
    */
-  checkRCS(body: CapabilityCheckRCSParams, options?: RequestOptions): APIPromise<CapabilityCheckRCSResponse> {
+  checkRCS(body: CapabilityCheckRCSParams, options?: RequestOptions): APIPromise<HandleCheckResponse> {
     return this._client.post('/v3/capability/check_rcs', { body, ...options });
   }
 }
 
-export interface CapabilityCheckiMessageResponse {
+export interface HandleCheck {
   /**
-   * The recipient address that was checked
+   * The recipient phone number or email address to check
    */
   address: string;
 
   /**
-   * Whether the recipient supports the checked messaging service
+   * Optional sender phone number. If omitted, an available phone from your pool is
+   * used automatically.
    */
-  available: boolean;
+  from?: string;
 }
 
-export interface CapabilityCheckRCSResponse {
+export interface HandleCheckResponse {
   /**
    * The recipient address that was checked
    */
@@ -93,8 +96,8 @@ export interface CapabilityCheckRCSParams {
 
 export declare namespace Capability {
   export {
-    type CapabilityCheckiMessageResponse as CapabilityCheckiMessageResponse,
-    type CapabilityCheckRCSResponse as CapabilityCheckRCSResponse,
+    type HandleCheck as HandleCheck,
+    type HandleCheckResponse as HandleCheckResponse,
     type CapabilityCheckiMessageParams as CapabilityCheckiMessageParams,
     type CapabilityCheckRCSParams as CapabilityCheckRCSParams,
   };

package/src/resources/chats/chats.ts

@@ -123,6 +123,32 @@ export class Chats extends APIResource {
     return this._client.put(path`/v3/chats/${chatID}`, { body, ...options });
   }
 
+  /**
+   * Removes your phone number from a group chat. Once you leave, you will no longer
+   * receive messages from the group and all interaction endpoints (send message,
+   * typing, mark read, etc.) will return 409.
+   *
+   * A `participant.removed` webhook will fire once the leave has been processed.
+   *
+   * **Supported**
+   *
+   * - iMessage group chats with 4 or more active participants (including yourself)
+   *
+   * **Not supported**
+   *
+   * - DM (1-on-1) chats — use the chat directly to continue the conversation
+   *
+   * @example
+   * ```ts
+   * const response = await client.chats.leaveChat(
+   *   '550e8400-e29b-41d4-a716-446655440000',
+   * );
+   * ```
+   */
+  leaveChat(chatID: string, options?: RequestOptions): APIPromise<ChatLeaveChatResponse> {
+    return this._client.post(path`/v3/chats/${chatID}/leave`, options);
+  }
+
   /**
    * Retrieves a paginated list of chats for the authenticated partner.
    *
@@ -280,6 +306,22 @@ export interface Chat {
   service?: Shared.ServiceType | null;
 }
 
+export interface LinkPart {
+  /**
+   * Indicates this is a rich link preview part
+   */
+  type: 'link';
+
+  /**
+   * URL to send with a rich link preview. The recipient will see an inline card with
+   * the page's title, description, and preview image (when available).
+   *
+   * A `link` part must be the **only** part in the message. To send a URL as plain
+   * text (no preview card), use a `text` part instead.
+   */
+  value: string;
+}
+
 export interface MediaPart {
   /**
    * Indicates this is a media attachment part
@@ -364,7 +406,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>;
+  parts: Array<TextPart | MediaPart | LinkPart>;
 
   /**
    * iMessage effect to apply to this message (screen or bubble effect)
@@ -420,28 +462,7 @@ export interface TextPart {
    * **Note:** Text decorations only render for iMessage recipients. For SMS/RCS,
    * text decorations are not applied.
    */
-  text_decorations?: Array<TextPart.TextDecoration>;
-}
-
-export namespace TextPart {
-  export interface TextDecoration {
-    /**
-     * 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._
-     */
-    range: Array<number>;
-
-    /**
-     * Animated text effect to apply. Mutually exclusive with `style`.
-     */
-    animation?: 'big' | 'small' | 'shake' | 'nod' | 'explode' | 'ripple' | 'bloom' | 'jitter';
-
-    /**
-     * Text style to apply. Mutually exclusive with `animation`.
-     */
-    style?: 'bold' | 'italic' | 'strikethrough' | 'underline';
-  }
+  text_decorations?: Array<MessagesAPI.TextDecoration>;
 }
 
 /**
@@ -493,6 +514,14 @@ export interface ChatUpdateResponse {
   status?: string;
 }
 
+export interface ChatLeaveChatResponse {
+  message?: string;
+
+  status?: string;
+
+  trace_id?: string;
+}
+
 /**
  * Response for sending a voice memo to a chat
  */
@@ -664,11 +693,13 @@ Chats.Messages = Messages;
 export declare namespace Chats {
   export {
     type Chat as Chat,
+    type LinkPart as LinkPart,
     type MediaPart as MediaPart,
     type MessageContent as MessageContent,
     type TextPart as TextPart,
     type ChatCreateResponse as ChatCreateResponse,
     type ChatUpdateResponse as ChatUpdateResponse,
+    type ChatLeaveChatResponse as ChatLeaveChatResponse,
     type ChatSendVoicememoResponse as ChatSendVoicememoResponse,
     type ChatsListChatsPagination as ChatsListChatsPagination,
     type ChatCreateParams as ChatCreateParams,

package/src/resources/chats/index.ts

@@ -3,11 +3,13 @@
 export {
   Chats,
   type Chat,
+  type LinkPart,
   type MediaPart,
   type MessageContent,
   type TextPart,
   type ChatCreateResponse,
   type ChatUpdateResponse,
+  type ChatLeaveChatResponse,
   type ChatSendVoicememoResponse,
   type ChatCreateParams,
   type ChatUpdateParams,

package/src/resources/contact-card.ts

@@ -0,0 +1,185 @@
+// 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 { RequestOptions } from '../internal/request-options';
+
+/**
+ * Contact Card lets you set and share your contact information (name and profile photo) with chat participants via iMessage Name and Photo Sharing.
+ *
+ * Use `POST /v3/contact_card` to create or update a card for a phone number.
+ * Use `PATCH /v3/contact_card` to update an existing active card.
+ * Use `GET /v3/contact_card` to retrieve the active card(s) for your partner account.
+ */
+export class ContactCard extends APIResource {
+  /**
+   * Creates a contact card for a phone number.
+   *
+   * The contact card is stored in an inactive state first. Once it's applied
+   * successfully, it is activated and `is_active` is returned as `true`. On failure,
+   * `is_active` is `false`.
+   *
+   * @example
+   * ```ts
+   * const setContactCard = await client.contactCard.create({
+   *   first_name: 'John',
+   *   phone_number: '+15551234567',
+   *   image_url:
+   *     'https://cdn.linqapp.com/contact-card/example.jpg',
+   *   last_name: 'Doe',
+   * });
+   * ```
+   */
+  create(body: ContactCardCreateParams, options?: RequestOptions): APIPromise<SetContactCard> {
+    return this._client.post('/v3/contact_card', { body, ...options });
+  }
+
+  /**
+   * Returns the contact card for a specific phone number, or all contact cards for
+   * the authenticated partner if no `phone_number` is provided.
+   *
+   * @example
+   * ```ts
+   * const contactCard = await client.contactCard.retrieve();
+   * ```
+   */
+  retrieve(
+    query: ContactCardRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ContactCardRetrieveResponse> {
+    return this._client.get('/v3/contact_card', { query, ...options });
+  }
+
+  /**
+   * Partially updates an existing active contact card for a phone number.
+   *
+   * Fetches the current active contact card and merges the provided fields. Only
+   * fields present in the request body are updated; omitted fields retain their
+   * existing values.
+   *
+   * Requires an active contact card to exist for the phone number.
+   *
+   * @example
+   * ```ts
+   * const setContactCard = await client.contactCard.update({
+   *   phone_number: '+15551234567',
+   *   first_name: 'John',
+   *   image_url:
+   *     'https://cdn.linqapp.com/contact-card/example.jpg',
+   *   last_name: 'Doe',
+   * });
+   * ```
+   */
+  update(params: ContactCardUpdateParams, options?: RequestOptions): APIPromise<SetContactCard> {
+    const { phone_number, ...body } = params;
+    return this._client.patch('/v3/contact_card', { query: { phone_number }, body, ...options });
+  }
+}
+
+export interface SetContactCard {
+  /**
+   * First name on the contact card
+   */
+  first_name: string;
+
+  /**
+   * Whether the contact card was successfully applied to the device
+   */
+  is_active: boolean;
+
+  /**
+   * The phone number the contact card is associated with
+   */
+  phone_number: string;
+
+  /**
+   * Image URL on the contact card
+   */
+  image_url?: string;
+
+  /**
+   * Last name on the contact card
+   */
+  last_name?: string;
+}
+
+export interface ContactCardRetrieveResponse {
+  contact_cards: Array<ContactCardRetrieveResponse.ContactCard>;
+}
+
+export namespace ContactCardRetrieveResponse {
+  export interface ContactCard {
+    first_name: string;
+
+    is_active: boolean;
+
+    phone_number: string;
+
+    image_url?: string;
+
+    last_name?: string;
+  }
+}
+
+export interface ContactCardCreateParams {
+  /**
+   * First name for the contact card. Required.
+   */
+  first_name: string;
+
+  /**
+   * E.164 phone number to associate the contact card with
+   */
+  phone_number: string;
+
+  /**
+   * URL of the profile image to rehost on the CDN. Only re-uploaded when a new value
+   * is provided.
+   */
+  image_url?: string;
+
+  /**
+   * Last name for the contact card. Optional.
+   */
+  last_name?: string;
+}
+
+export interface ContactCardRetrieveParams {
+  /**
+   * E.164 phone number to filter by. If omitted, all my cards for the partner are
+   * returned.
+   */
+  phone_number?: string;
+}
+
+export interface ContactCardUpdateParams {
+  /**
+   * Query param: E.164 phone number of the contact card to update
+   */
+  phone_number: string;
+
+  /**
+   * Body param: Updated first name. If omitted, the existing value is kept.
+   */
+  first_name?: string;
+
+  /**
+   * Body param: Updated profile image URL. If omitted, the existing image is kept.
+   */
+  image_url?: string;
+
+  /**
+   * Body param: Updated last name. If omitted, the existing value is kept.
+   */
+  last_name?: string;
+}
+
+export declare namespace ContactCard {
+  export {
+    type SetContactCard as SetContactCard,
+    type ContactCardRetrieveResponse as ContactCardRetrieveResponse,
+    type ContactCardCreateParams as ContactCardCreateParams,
+    type ContactCardRetrieveParams as ContactCardRetrieveParams,
+    type ContactCardUpdateParams as ContactCardUpdateParams,
+  };
+}

package/src/resources/index.ts

@@ -10,19 +10,21 @@ export {
 } from './attachments';
 export {
   Capability,
-  type CapabilityCheckiMessageResponse,
-  type CapabilityCheckRCSResponse,
+  type HandleCheck,
+  type HandleCheckResponse,
   type CapabilityCheckiMessageParams,
   type CapabilityCheckRCSParams,
 } from './capability';
 export {
   Chats,
   type Chat,
+  type LinkPart,
   type MediaPart,
   type MessageContent,
   type TextPart,
   type ChatCreateResponse,
   type ChatUpdateResponse,
+  type ChatLeaveChatResponse,
   type ChatSendVoicememoResponse,
   type ChatCreateParams,
   type ChatUpdateParams,
@@ -30,11 +32,20 @@ export {
   type ChatSendVoicememoParams,
   type ChatsListChatsPagination,
 } from './chats/chats';
+export {
+  ContactCard,
+  type SetContactCard,
+  type ContactCardRetrieveResponse,
+  type ContactCardCreateParams,
+  type ContactCardRetrieveParams,
+  type ContactCardUpdateParams,
+} from './contact-card';
 export {
   Messages,
   type Message,
   type MessageEffect,
   type ReplyTo,
+  type TextDecoration,
   type MessageAddReactionResponse,
   type MessageUpdateParams,
   type MessageAddReactionParams,

package/src/resources/messages.ts

@@ -255,6 +255,25 @@ export interface ReplyTo {
   part_index?: number;
 }
 
+export interface TextDecoration {
+  /**
+   * 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._
+   */
+  range: Array<number>;
+
+  /**
+   * Animated text effect to apply. Mutually exclusive with `style`.
+   */
+  animation?: 'big' | 'small' | 'shake' | 'nod' | 'explode' | 'ripple' | 'bloom' | 'jitter';
+
+  /**
+   * Text style to apply. Mutually exclusive with `animation`.
+   */
+  style?: 'bold' | 'italic' | 'strikethrough' | 'underline';
+}
+
 export interface MessageAddReactionResponse {
   message?: string;
 
@@ -313,6 +332,7 @@ export declare namespace Messages {
     type Message as Message,
     type MessageEffect as MessageEffect,
     type ReplyTo as ReplyTo,
+    type TextDecoration as TextDecoration,
     type MessageAddReactionResponse as MessageAddReactionResponse,
     type MessagesListMessagesPagination as MessagesListMessagesPagination,
     type MessageUpdateParams as MessageUpdateParams,

package/src/resources/shared.ts

@@ -1,5 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import * as MessagesAPI from './messages';
+
 export interface ChatHandle {
   /**
    * Unique identifier for this handle
@@ -181,26 +183,5 @@ export interface TextPartResponse {
   /**
    * Text decorations applied to character ranges in the value
    */
-  text_decorations?: Array<TextPartResponse.TextDecoration> | null;
-}
-
-export namespace TextPartResponse {
-  export interface TextDecoration {
-    /**
-     * 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._
-     */
-    range: Array<number>;
-
-    /**
-     * Animated text effect to apply. Mutually exclusive with `style`.
-     */
-    animation?: 'big' | 'small' | 'shake' | 'nod' | 'explode' | 'ripple' | 'bloom' | 'jitter';
-
-    /**
-     * Text style to apply. Mutually exclusive with `animation`.
-     */
-    style?: 'bold' | 'italic' | 'strikethrough' | 'underline';
-  }
+  text_decorations?: Array<MessagesAPI.TextDecoration> | null;
 }

package/src/resources/webhooks.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import * as WebhooksAPI from './webhooks';
+import * as MessagesAPI from './messages';
 import * as Shared from './shared';
 import * as WebhookEventsAPI from './webhook-events';
 
@@ -376,28 +377,7 @@ export interface SchemasTextPartResponse {
   /**
    * Text decorations applied to character ranges in the value
    */
-  text_decorations?: Array<SchemasTextPartResponse.TextDecoration> | null;
-}
-
-export namespace SchemasTextPartResponse {
-  export interface TextDecoration {
-    /**
-     * 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._
-     */
-    range: Array<number>;
-
-    /**
-     * Animated text effect to apply. Mutually exclusive with `style`.
-     */
-    animation?: 'big' | 'small' | 'shake' | 'nod' | 'explode' | 'ripple' | 'bloom' | 'jitter';
-
-    /**
-     * Text style to apply. Mutually exclusive with `animation`.
-     */
-    style?: 'bold' | 'italic' | 'strikethrough' | 'underline';
-  }
+  text_decorations?: Array<MessagesAPI.TextDecoration> | null;
 }
 
 /**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.8.1'; // x-release-please-version
+export const VERSION = '0.10.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}