@linqapp/sdk 0.32.1 → 0.33.1

package/src/resources/payment-handles.ts

@@ -0,0 +1,114 @@
+// 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';
+import { path } from '../internal/utils/path';
+
+/**
+ * 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.
+ */
+export class PaymentHandles extends APIResource {
+  /**
+   * Starts connecting a customer (by phone/email) so an agent can pay on their
+   * behalf. Linq drives the OTP + consent ceremony through the messaging channel;
+   * this returns `pending` and a `connection.created` webhook fires once the
+   * customer completes it.
+   *
+   * @example
+   * ```ts
+   * const paymentHandleConnection =
+   *   await client.paymentHandles.connect('handle');
+   * ```
+   */
+  connect(handle: string, options?: RequestOptions): APIPromise<PaymentHandleConnection> {
+    return this._client.post(path`/v3/payments/handles/${handle}/connect`, options);
+  }
+
+  /**
+   * Get a handle's connection status
+   *
+   * @example
+   * ```ts
+   * const paymentHandleConnection =
+   *   await client.paymentHandles.connection('handle');
+   * ```
+   */
+  connection(handle: string, options?: RequestOptions): APIPromise<PaymentHandleConnection> {
+    return this._client.get(path`/v3/payments/handles/${handle}/connection`, options);
+  }
+
+  /**
+   * Revokes this partner's grant for the customer. Only your grant is removed; the
+   * customer's wallet at the provider is untouched.
+   *
+   * @example
+   * ```ts
+   * const paymentHandleConnection =
+   *   await client.paymentHandles.revoke('handle');
+   * ```
+   */
+  revoke(handle: string, options?: RequestOptions): APIPromise<PaymentHandleConnection> {
+    return this._client.delete(path`/v3/payments/handles/${handle}/connection`, options);
+  }
+
+  /**
+   * Completes the ceremony `connect` started: verifies the code, records the
+   * customer's consent, and stores the connection. Returns `connected` on success,
+   * after which payments for this handle no longer need the customer present.
+   *
+   * The code reaches you however your channel works — typically the customer replies
+   * with it in the thread. Codes are single-use and short-lived; if one has expired,
+   * call `connect` again for a fresh `connect_id`.
+   *
+   * @example
+   * ```ts
+   * const paymentHandleConnection =
+   *   await client.paymentHandles.verify('handle', {
+   *     code: '482913',
+   *     connect_id: 'cs_01HZY8',
+   *   });
+   * ```
+   */
+  verify(
+    handle: string,
+    body: PaymentHandleVerifyParams,
+    options?: RequestOptions,
+  ): APIPromise<PaymentHandleConnection> {
+    return this._client.post(path`/v3/payments/handles/${handle}/verify`, { body, ...options });
+  }
+}
+
+export interface PaymentHandleConnection {
+  /**
+   * Returned only by `connect`, and only while the ceremony is pending. Nothing on
+   * our side persists it — it comes back from the provider and is required again to
+   * verify — so hold it until you submit the code.
+   */
+  connect_id?: string;
+
+  handle?: string;
+
+  status?: 'not_connected' | 'pending' | 'connected' | 'revoked';
+}
+
+export interface PaymentHandleVerifyParams {
+  /**
+   * The one-time code the customer received.
+   */
+  code: string;
+
+  /**
+   * The id returned by `connect`.
+   */
+  connect_id: string;
+}
+
+export declare namespace PaymentHandles {
+  export {
+    type PaymentHandleConnection as PaymentHandleConnection,
+    type PaymentHandleVerifyParams as PaymentHandleVerifyParams,
+  };
+}

package/src/resources/payment-providers.ts

@@ -0,0 +1,81 @@
+// 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';
+import { path } from '../internal/utils/path';
+
+/**
+ * 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.
+ */
+export class PaymentProviders extends APIResource {
+  /**
+   * Returns your organization's onboarding status for a payment provider.
+   *
+   * @example
+   * ```ts
+   * const paymentProvider =
+   *   await client.paymentProviders.retrieve('provider');
+   * ```
+   */
+  retrieve(provider: string, options?: RequestOptions): APIPromise<PaymentProvider> {
+    return this._client.get(path`/v3/payments/providers/${provider}`, options);
+  }
+
+  /**
+   * Begins connecting your organization to a payment provider (e.g. `agentcard`).
+   * Returns a hosted URL where an admin authorizes the connection; on completion the
+   * provider redirects back and Linq stores your connected credentials.
+   *
+   * @example
+   * ```ts
+   * const response = await client.paymentProviders.connect(
+   *   'provider',
+   *   {
+   *     return_url: 'https://partner.example/settings/payments',
+   *   },
+   * );
+   * ```
+   */
+  connect(
+    provider: string,
+    body: PaymentProviderConnectParams,
+    options?: RequestOptions,
+  ): APIPromise<PaymentProviderConnectResponse> {
+    return this._client.post(path`/v3/payments/providers/${provider}/connect`, { body, ...options });
+  }
+}
+
+export interface PaymentProvider {
+  provider?: string;
+
+  status?: 'onboarding' | 'ready' | 'disabled';
+}
+
+export interface PaymentProviderConnectResponse {
+  /**
+   * Send the admin here to authorize the connection.
+   */
+  hosted_url?: string;
+
+  session_id?: string;
+
+  status?: string;
+}
+
+export interface PaymentProviderConnectParams {
+  /**
+   * Where to send the admin after they authorize the connection.
+   */
+  return_url: string;
+}
+
+export declare namespace PaymentProviders {
+  export {
+    type PaymentProvider as PaymentProvider,
+    type PaymentProviderConnectResponse as PaymentProviderConnectResponse,
+    type PaymentProviderConnectParams as PaymentProviderConnectParams,
+  };
+}

package/src/resources/payment-requests.ts

@@ -25,7 +25,7 @@ import { path } from '../internal/utils/path';
  *
  * ## 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
@@ -108,7 +108,7 @@ import { path } from '../internal/utils/path';
  * 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.
  *

package/src/resources/payments.ts

@@ -0,0 +1,163 @@
+// 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';
+import { path } from '../internal/utils/path';
+
+/**
+ * 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.
+ */
+export class Payments extends APIResource {
+  /**
+   * Advances the pay flow for a connected customer handle and returns a `status`
+   * describing where it is (`needs_connection`, `awaiting_user_action`, `ready`,
+   * ...). A payment `id` appears once a card is minted. Idempotent on the
+   * `Idempotency-Key` header.
+   *
+   * @example
+   * ```ts
+   * const payment = await client.payments.create({
+   *   amount_cents: 2500,
+   *   currency: 'usd',
+   *   handle: '+14155550123',
+   * });
+   * ```
+   */
+  create(body: PaymentCreateParams, options?: RequestOptions): APIPromise<Payment> {
+    return this._client.post('/v3/payments', { body, ...options });
+  }
+
+  /**
+   * Get a payment
+   *
+   * @example
+   * ```ts
+   * const payment = await client.payments.retrieve('paymentId');
+   * ```
+   */
+  retrieve(paymentID: string, options?: RequestOptions): APIPromise<Payment> {
+    return this._client.get(path`/v3/payments/${paymentID}`, options);
+  }
+
+  /**
+   * Closes the virtual card and cancels the payment.
+   *
+   * @example
+   * ```ts
+   * const payment = await client.payments.cancel('paymentId');
+   * ```
+   */
+  cancel(paymentID: string, options?: RequestOptions): APIPromise<Payment> {
+    return this._client.post(path`/v3/payments/${paymentID}/cancel`, options);
+  }
+
+  /**
+   * Returns a short-lived handoff for a `ready` payment. Fetch the card credentials
+   * **directly from the provider** with the returned `user_token` at `fetch_url` —
+   * the card number never passes through Linq. Do not persist PAN/CVC.
+   *
+   * @example
+   * ```ts
+   * const response = await client.payments.credentials(
+   *   'paymentId',
+   * );
+   * ```
+   */
+  credentials(paymentID: string, options?: RequestOptions): APIPromise<PaymentCredentialsResponse> {
+    return this._client.get(path`/v3/payments/${paymentID}/credentials`, options);
+  }
+}
+
+export interface Payment {
+  id?: string;
+
+  amount_cents?: number;
+
+  /**
+   * Present when the customer must approve with a passkey.
+   */
+  approval_url?: string;
+
+  /**
+   * Present when the customer must attach a card.
+   */
+  attach_url?: string;
+
+  currency?: string;
+
+  description?: string;
+
+  handle?: string;
+
+  status?:
+    | 'needs_connection'
+    | 'connecting'
+    | 'awaiting_user_action'
+    | 'ready'
+    | 'authorized'
+    | 'succeeded'
+    | 'declined'
+    | 'canceled'
+    | 'expired';
+}
+
+export interface PaymentCredentialsResponse {
+  /**
+   * Fetch the card directly from the provider with these — never through Linq.
+   */
+  handoff?: PaymentCredentialsResponse.Handoff;
+}
+
+export namespace PaymentCredentialsResponse {
+  /**
+   * Fetch the card directly from the provider with these — never through Linq.
+   */
+  export interface Handoff {
+    card_ref?: string;
+
+    fetch_url?: string;
+
+    provider?: string;
+
+    /**
+     * Short-lived bearer to fetch the card from the provider.
+     */
+    user_token?: string;
+  }
+}
+
+export interface PaymentCreateParams {
+  amount_cents: number;
+
+  currency: string;
+
+  /**
+   * Customer phone (E.164) or email.
+   */
+  handle: string;
+
+  description?: string;
+
+  merchant?: PaymentCreateParams.Merchant;
+
+  metadata?: { [key: string]: string };
+}
+
+export namespace PaymentCreateParams {
+  export interface Merchant {
+    name?: string;
+
+    url?: string;
+  }
+}
+
+export declare namespace Payments {
+  export {
+    type Payment as Payment,
+    type PaymentCredentialsResponse as PaymentCredentialsResponse,
+    type PaymentCreateParams as PaymentCreateParams,
+  };
+}

package/src/resources/phone-numbers.ts

@@ -15,20 +15,6 @@ import { path } from '../internal/utils/path';
  * in the `from` field.
  */
 export class PhoneNumbers extends APIResource {
-  /**
-   * Returns all phone numbers assigned to the authenticated partner. Use this
-   * endpoint to discover which phone numbers are available for use as the `from`
-   * field when creating a chat, listing chats, or sending a voice memo.
-   *
-   * @example
-   * ```ts
-   * const phoneNumbers = await client.phoneNumbers.list();
-   * ```
-   */
-  list(options?: RequestOptions): APIPromise<PhoneNumberListResponse> {
-    return this._client.get('/v3/phone_numbers', options);
-  }
-
   /**
    * Updates the forwarding number for a phone number. The forwarding number is where
    * inbound calls will be forwarded to.
@@ -50,6 +36,20 @@ export class PhoneNumbers extends APIResource {
   ): APIPromise<PhoneNumberUpdateResponse> {
     return this._client.put(path`/v3/phone_numbers/${phoneNumberID}`, { body, ...options });
   }
+
+  /**
+   * Returns all phone numbers assigned to the authenticated partner. Use this
+   * endpoint to discover which phone numbers are available for use as the `from`
+   * field when creating a chat, listing chats, or sending a voice memo.
+   *
+   * @example
+   * ```ts
+   * const phoneNumbers = await client.phoneNumbers.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<PhoneNumberListResponse> {
+    return this._client.get('/v3/phone_numbers', options);
+  }
 }
 
 export interface PhoneNumberUpdateResponse {

package/src/resources/webhook-events.ts

@@ -159,6 +159,15 @@ export type WebhookEventType =
   | 'message.edited'
   | 'reaction.added'
   | 'reaction.removed'
+  | 'poll.received'
+  | 'poll.failed'
+  | 'poll.sent'
+  | 'poll.delivered'
+  | 'poll.read'
+  | 'poll.updated'
+  | 'poll.vote.added'
+  | 'poll.vote.removed'
+  | 'poll.reaction.added'
   | 'participant.added'
   | 'participant.removed'
   | 'chat.created'

package/src/resources/webhook-subscriptions.ts

@@ -187,20 +187,6 @@ export class WebhookSubscriptions extends APIResource {
     return this._client.post('/v3/webhook-subscriptions', { body, ...options });
   }
 
-  /**
-   * Retrieve all webhook subscriptions for the authenticated partner. Returns a list
-   * of active and inactive subscriptions with their configuration and status.
-   *
-   * @example
-   * ```ts
-   * const webhookSubscriptions =
-   *   await client.webhookSubscriptions.list();
-   * ```
-   */
-  list(options?: RequestOptions): APIPromise<WebhookSubscriptionListResponse> {
-    return this._client.get('/v3/webhook-subscriptions', options);
-  }
-
   /**
    * Retrieve details for a specific webhook subscription including its target URL,
    * subscribed events, and current status.
@@ -243,6 +229,20 @@ export class WebhookSubscriptions extends APIResource {
     return this._client.put(path`/v3/webhook-subscriptions/${subscriptionID}`, { body, ...options });
   }
 
+  /**
+   * Retrieve all webhook subscriptions for the authenticated partner. Returns a list
+   * of active and inactive subscriptions with their configuration and status.
+   *
+   * @example
+   * ```ts
+   * const webhookSubscriptions =
+   *   await client.webhookSubscriptions.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<WebhookSubscriptionListResponse> {
+    return this._client.get('/v3/webhook-subscriptions', options);
+  }
+
   /**
    * Delete a webhook subscription.
    *

package/src/resources/webhooks.ts

@@ -102,6 +102,17 @@ export interface MessageEventV2 {
    */
   read_at?: string | null;
 
+  /**
+   * Present only when this message was recovered by reconciliation rather than
+   * delivered live, and set to the time of that recovery. The field is omitted
+   * entirely for normally-delivered messages, which is the overwhelming majority.
+   * When present, expect `sent_at` to be substantially earlier than delivery of this
+   * event: the message is genuine but is arriving late and out of real-time order,
+   * so treat it as history rather than as a live inbound (for example, suppress
+   * auto-replies).
+   */
+  reconciled_at?: string;
+
   /**
    * Reference to the message this is replying to (for threaded replies)
    */
@@ -173,6 +184,21 @@ 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.
+       *
+       * `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.
+       *
+       * 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
+       * every chat and every line on your account. Nothing is delivered, including a
+       * final courtesy message — to send one, set `override_optout: true` on that single
+       * request.
        */
       status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 
@@ -345,6 +371,17 @@ export interface MessagePayload {
    */
   read_at?: string | null;
 
+  /**
+   * Present only when this message was recovered by reconciliation rather than
+   * delivered live, and set to the time of that recovery. The field is omitted
+   * entirely for normally-delivered messages, which is the overwhelming majority.
+   * When present, expect `sent_at` to be substantially earlier than delivery of this
+   * event: the message is genuine but is arriving late and out of real-time order,
+   * so treat it as history rather than as a live inbound (for example, suppress
+   * auto-replies).
+   */
+  reconciled_at?: string;
+
   /**
    * Reference to the message this is replying to
    */
@@ -935,6 +972,9 @@ export interface MessageFailedWebhookEvent {
    * Error details for message.failed webhook events. See
    * [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
    * code reference.
+   *
+   * In rare cases the message can still be delivered after this event fires — a
+   * `message.delivered` webhook for the same message ID may follow.
    */
   data: MessageFailedWebhookEvent.Data;
 
@@ -975,6 +1015,9 @@ export namespace MessageFailedWebhookEvent {
    * Error details for message.failed webhook events. See
    * [WebhookErrorCode](#/components/schemas/WebhookErrorCode) for the full error
    * code reference.
+   *
+   * In rare cases the message can still be delivered after this event fires — a
+   * `message.delivered` webhook for the same message ID may follow.
    */
   export interface Data {
     /**
@@ -1157,6 +1200,21 @@ 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.
+         *
+         * `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.
+         *
+         * 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
+         * every chat and every line on your account. Nothing is delivered, including a
+         * final courtesy message — to send one, set `override_optout: true` on that single
+         * request.
          */
         status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 
@@ -1579,6 +1637,21 @@ 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.
+       *
+       * `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.
+       *
+       * 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
+       * every chat and every line on your account. Nothing is delivered, including a
+       * final courtesy message — to send one, set `override_optout: true` on that single
+       * request.
        */
       status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 
@@ -2072,6 +2145,15 @@ export interface PhoneNumberStatusUpdatedWebhookEvent {
     | 'message.edited'
     | 'reaction.added'
     | 'reaction.removed'
+    | 'poll.received'
+    | 'poll.failed'
+    | 'poll.sent'
+    | 'poll.delivered'
+    | 'poll.read'
+    | 'poll.updated'
+    | 'poll.vote.added'
+    | 'poll.vote.removed'
+    | 'poll.reaction.added'
     | 'participant.added'
     | 'participant.removed'
     | 'chat.created'

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.32.1'; // x-release-please-version
+export const VERSION = '0.33.1'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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