@linqapp/sdk 0.32.1 → 0.33.1

package/src/client.ts

@@ -52,21 +52,18 @@ import {
   ContactCardUpdateParams,
   SetContactCard,
 } from './resources/contact-card';
+import { ExperienceListResponse, ExperienceRetrieveResponse, Experiences } from './resources/experiences';
 import {
-  Message,
-  MessageAddReactionParams,
-  MessageAddReactionResponse,
-  MessageCreateParams,
-  MessageCreateResponse,
-  MessageEffect,
-  MessageListMessagesThreadParams,
-  MessageUpdateAppCardParams,
-  MessageUpdateAppCardResponse,
-  MessageUpdateParams,
-  Messages,
-  MessagesListMessagesPagination,
-  ReplyTo,
-} from './resources/messages';
+  PaymentHandleConnection,
+  PaymentHandleVerifyParams,
+  PaymentHandles,
+} from './resources/payment-handles';
+import {
+  PaymentProvider,
+  PaymentProviderConnectParams,
+  PaymentProviderConnectResponse,
+  PaymentProviders,
+} from './resources/payment-providers';
 import {
   PaymentRequest,
   PaymentRequestCreateParams,
@@ -74,6 +71,7 @@ import {
   PaymentRequestListResponse,
   PaymentRequests,
 } from './resources/payment-requests';
+import { Payment, PaymentCreateParams, PaymentCredentialsResponse, Payments } from './resources/payments';
 import {
   PhoneNumberListResponse,
   PhoneNumberUpdateParams,
@@ -135,6 +133,21 @@ import {
   MessageContent,
   TextPart,
 } from './resources/chats/chats';
+import {
+  Message,
+  MessageAddReactionParams,
+  MessageAddReactionResponse,
+  MessageCreateParams,
+  MessageCreateResponse,
+  MessageEffect,
+  MessageListMessagesThreadParams,
+  MessageUpdateAppCardParams,
+  MessageUpdateAppCardResponse,
+  MessageUpdateParams,
+  Messages,
+  MessagesListMessagesPagination,
+  ReplyTo,
+} from './resources/messages/messages';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -1192,7 +1205,7 @@ export class LinqAPIV3 {
    *
    * ## Connected accounts (Stripe Standard, direct charges)
    *
-   * Agent Pay runs on **Stripe Connect Standard accounts** using **direct
+   * Payments run on **Stripe Connect Standard accounts** using **direct
    * charges**: the charge is created on *your* connected account and **you are
    * the merchant of record**. That means the money, the payout schedule, the
    * customer relationship, and the compliance surface are all yours — Linq
@@ -1275,7 +1288,7 @@ export class LinqAPIV3 {
    * no-install checkout sheet. Everywhere else (Android, desktop, iPhones
    * without the App Clip yet) the same URL opens the web checkout, so the link
    * always works. The App Clip experience for your payment links is registered
-   * automatically by Linq and refreshed whenever you update your Agent Pay
+   * automatically by Linq and refreshed whenever you update your payments
    * branding; a newly registered experience can take up to ~24 hours to
    * activate on Apple's side, during which links open the web checkout.
    *
@@ -1288,6 +1301,34 @@ export class LinqAPIV3 {
    *
    */
   paymentRequests: API.PaymentRequests = new API.PaymentRequests(this);
+  /**
+   * Let an agent pay on a customer's behalf with a single-use virtual card.
+   * Connect a customer once, then create a payment — a virtual card is minted
+   * scoped to that purchase and the card details are handed back for checkout.
+   *
+   */
+  paymentProviders: API.PaymentProviders = new API.PaymentProviders(this);
+  /**
+   * Let an agent pay on a customer's behalf with a single-use virtual card.
+   * Connect a customer once, then create a payment — a virtual card is minted
+   * scoped to that purchase and the card details are handed back for checkout.
+   *
+   */
+  paymentHandles: API.PaymentHandles = new API.PaymentHandles(this);
+  /**
+   * Let an agent pay on a customer's behalf with a single-use virtual card.
+   * Connect a customer once, then create a payment — a virtual card is minted
+   * scoped to that purchase and the card details are handed back for checkout.
+   *
+   */
+  payments: API.Payments = new API.Payments(this);
+  /**
+   * Let an agent pay on a customer's behalf with a single-use virtual card.
+   * Connect a customer once, then create a payment — a virtual card is minted
+   * scoped to that purchase and the card details are handed back for checkout.
+   *
+   */
+  experiences: API.Experiences = new API.Experiences(this);
   /**
    * Webhook Subscriptions allow you to receive real-time notifications when events
    * occur on your account.
@@ -1574,6 +1615,10 @@ LinqAPIV3.Phonenumbers = Phonenumbers;
 LinqAPIV3.PhoneNumbers = PhoneNumbers;
 LinqAPIV3.AvailableNumber = AvailableNumber;
 LinqAPIV3.PaymentRequests = PaymentRequests;
+LinqAPIV3.PaymentProviders = PaymentProviders;
+LinqAPIV3.PaymentHandles = PaymentHandles;
+LinqAPIV3.Payments = Payments;
+LinqAPIV3.Experiences = Experiences;
 LinqAPIV3.WebhookEvents = WebhookEvents;
 LinqAPIV3.WebhookSubscriptions = WebhookSubscriptions;
 LinqAPIV3.Capability = Capability;
@@ -1608,8 +1653,8 @@ export declare namespace LinqAPIV3 {
     type ChatSendVoicememoResponse as ChatSendVoicememoResponse,
     type ChatsListChatsPagination as ChatsListChatsPagination,
     type ChatCreateParams as ChatCreateParams,
-    type ChatListChatsParams as ChatListChatsParams,
     type ChatUpdateParams as ChatUpdateParams,
+    type ChatListChatsParams as ChatListChatsParams,
     type ChatSendVoicememoParams as ChatSendVoicememoParams,
   };
 
@@ -1623,9 +1668,9 @@ export declare namespace LinqAPIV3 {
     type MessageUpdateAppCardResponse as MessageUpdateAppCardResponse,
     type MessagesListMessagesPagination as MessagesListMessagesPagination,
     type MessageCreateParams as MessageCreateParams,
-    type MessageListMessagesThreadParams as MessageListMessagesThreadParams,
-    type MessageAddReactionParams as MessageAddReactionParams,
     type MessageUpdateParams as MessageUpdateParams,
+    type MessageAddReactionParams as MessageAddReactionParams,
+    type MessageListMessagesThreadParams as MessageListMessagesThreadParams,
     type MessageUpdateAppCardParams as MessageUpdateAppCardParams,
   };
 
@@ -1660,6 +1705,32 @@ export declare namespace LinqAPIV3 {
     type PaymentRequestListParams as PaymentRequestListParams,
   };
 
+  export {
+    PaymentProviders as PaymentProviders,
+    type PaymentProvider as PaymentProvider,
+    type PaymentProviderConnectResponse as PaymentProviderConnectResponse,
+    type PaymentProviderConnectParams as PaymentProviderConnectParams,
+  };
+
+  export {
+    PaymentHandles as PaymentHandles,
+    type PaymentHandleConnection as PaymentHandleConnection,
+    type PaymentHandleVerifyParams as PaymentHandleVerifyParams,
+  };
+
+  export {
+    Payments as Payments,
+    type Payment as Payment,
+    type PaymentCredentialsResponse as PaymentCredentialsResponse,
+    type PaymentCreateParams as PaymentCreateParams,
+  };
+
+  export {
+    Experiences as Experiences,
+    type ExperienceRetrieveResponse as ExperienceRetrieveResponse,
+    type ExperienceListResponse as ExperienceListResponse,
+  };
+
   export {
     WebhookEvents as WebhookEvents,
     type WebhookEventType as WebhookEventType,
@@ -1716,8 +1787,8 @@ export declare namespace LinqAPIV3 {
     ContactCard as ContactCard,
     type SetContactCard as SetContactCard,
     type ContactCardRetrieveResponse as ContactCardRetrieveResponse,
-    type ContactCardRetrieveParams as ContactCardRetrieveParams,
     type ContactCardCreateParams as ContactCardCreateParams,
+    type ContactCardRetrieveParams as ContactCardRetrieveParams,
     type ContactCardUpdateParams as ContactCardUpdateParams,
   };
 

package/src/core/error.ts

@@ -16,11 +16,30 @@ export class APIError<
   /** JSON body of the response that caused the error */
   readonly error: TError;
 
+  /**
+   * Linq API error code.
+   */
+  readonly code: number | undefined;
+  /**
+   * Link to documentation for this error code
+   */
+  readonly doc_url: string | undefined;
+  /**
+   * Number of seconds to wait before retrying. Only present on 429 rate limit
+   * errors.
+   */
+  readonly retry_after?: number | undefined;
+
   constructor(status: TStatus, error: TError, message: string | undefined, headers: THeaders) {
     super(`${APIError.makeMessage(status, error, message)}`);
     this.status = status;
     this.headers = headers;
     this.error = error;
+
+    const data = error as Record<string, any>;
+    this.code = data?.['code'];
+    this.doc_url = data?.['doc_url'];
+    this.retry_after = data?.['retry_after'];
   }
 
   private static makeMessage(status: number | undefined, error: any, message: string | undefined) {
@@ -54,7 +73,7 @@ export class APIError<
       return new APIConnectionError({ message, cause: castToError(errorResponse) });
     }
 
-    const error = errorResponse as Record<string, any>;
+    const error = (errorResponse as Record<string, any>)?.['error'];
 
     if (status === 400) {
       return new BadRequestError(status, error, message, headers);

package/src/resources/available-number.ts

@@ -30,7 +30,8 @@ export class AvailableNumber extends APIResource {
    * Also returns `vcf_url`: a time-limited link to a vCard (`.vcf`) for the chosen
    * line, carrying its contact card (name/photo) with the chosen number as the
    * primary `TEL` and the partner's other available lines as backups. Share it with
-   * recipients so they can save the line as a contact.
+   * recipients so they can save the line as a contact. Lines you pass in
+   * `exclude_from` are left out of the vCard too.
    */
   retrieve(
     query: AvailableNumberRetrieveParams | null | undefined = {},
@@ -59,6 +60,18 @@ export interface AvailableNumberRetrieveResponse {
 }
 
 export interface AvailableNumberRetrieveParams {
+  /**
+   * Lines (E.164) to leave out of this selection. Applies to the returned
+   * `phone_number`, to the sticky choice when `to` is given, and to the vCard's
+   * backup numbers. Repeat the parameter for multiple lines; use `%2B` for the
+   * leading `+`.
+   *
+   * Numbers that are not your lines are ignored. Every entry must be E.164 — a value
+   * like `4155551234` is rejected rather than silently skipped. Excluding every one
+   * of your available lines returns 400.
+   */
+  exclude_from?: Array<string>;
+
   /**
    * Recipient handles (E.164 or email) the message is destined for. When provided,
    * an existing chat with these recipients makes the choice sticky. Repeat the