@linqapp/sdk 0.32.0 → 0.33.0

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-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,17 @@ 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`, and you should send nothing further on this chat.
+       * 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. Suppressing sends to opted-out recipients is
+       * your responsibility — Linq surfaces the status but does not block the send.
        */
       status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 
@@ -345,6 +367,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 +968,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 +1011,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 +1196,17 @@ 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`, and you should send nothing further on this chat.
+         * 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. Suppressing sends to opted-out recipients is
+         * your responsibility — Linq surfaces the status but does not block the send.
          */
         status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 
@@ -1579,6 +1629,17 @@ 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`, and you should send nothing further on this chat.
+       * 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. Suppressing sends to opted-out recipients is
+       * your responsibility — Linq surfaces the status but does not block the send.
        */
       status: 'HEALTHY' | 'AT_RISK' | 'CRITICAL' | 'OPTED_OUT';
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.32.0'; // x-release-please-version
+export const VERSION = '0.33.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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