@linqapp/sdk 0.1.0-alpha.1

package/src/resources/phone-numbers.ts

@@ -0,0 +1,72 @@
+// 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';
+
+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 sending messages via
+   * the `from` field in create chat and send message requests.
+   */
+  list(options?: RequestOptions): APIPromise<PhoneNumberListResponse> {
+    return this._client.get('/v3/phonenumbers', options);
+  }
+}
+
+export interface PhoneNumberListResponse {
+  /**
+   * List of phone numbers assigned to the partner
+   */
+  phone_numbers: Array<PhoneNumberListResponse.PhoneNumber>;
+}
+
+export namespace PhoneNumberListResponse {
+  export interface PhoneNumber {
+    /**
+     * Unique identifier for the phone number
+     */
+    id: string;
+
+    capabilities: PhoneNumber.Capabilities;
+
+    /**
+     * ISO 3166-1 alpha-2 country code
+     */
+    country_code: string;
+
+    /**
+     * Phone number in E.164 format
+     */
+    phone_number: string;
+
+    /**
+     * Type of phone number
+     */
+    type: 'TWILIO' | 'APPLE_ID';
+  }
+
+  export namespace PhoneNumber {
+    export interface Capabilities {
+      /**
+       * Whether MMS messaging is supported
+       */
+      mms: boolean;
+
+      /**
+       * Whether SMS messaging is supported
+       */
+      sms: boolean;
+
+      /**
+       * Whether voice calls are supported
+       */
+      voice: boolean;
+    }
+  }
+}
+
+export declare namespace PhoneNumbers {
+  export { type PhoneNumberListResponse as PhoneNumberListResponse };
+}

package/src/resources/webhooks/events.ts

@@ -0,0 +1,55 @@
+// 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';
+
+export class Events extends APIResource {
+  /**
+   * Returns all available webhook event types that can be subscribed to. Use this
+   * endpoint to discover valid values for the `subscribed_events` field when
+   * creating or updating webhook subscriptions.
+   *
+   * @example
+   * ```ts
+   * const events = await client.webhooks.events.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<EventListResponse> {
+    return this._client.get('/v3/webhook-events', options);
+  }
+}
+
+export interface EventListResponse {
+  /**
+   * URL to the webhook events documentation
+   */
+  doc_url: 'https://apidocs.linqapp.com/documentation/webhook-events';
+
+  /**
+   * List of all available webhook event types
+   */
+  events: Array<
+    | 'message.sent'
+    | 'message.received'
+    | 'message.read'
+    | 'message.delivered'
+    | 'message.failed'
+    | 'reaction.added'
+    | 'reaction.removed'
+    | 'participant.added'
+    | 'participant.removed'
+    | 'chat.created'
+    | 'chat.group_name_updated'
+    | 'chat.group_icon_updated'
+    | 'chat.group_name_update_failed'
+    | 'chat.group_icon_update_failed'
+    | 'chat.typing_indicator.started'
+    | 'chat.typing_indicator.stopped'
+    | 'phone_number.status_updated'
+  >;
+}
+
+export declare namespace Events {
+  export { type EventListResponse as EventListResponse };
+}

package/src/resources/webhooks/index.ts

@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Events, type EventListResponse } from './events';
+export {
+  Subscriptions,
+  type SubscriptionCreateResponse,
+  type SubscriptionRetrieveResponse,
+  type SubscriptionUpdateResponse,
+  type SubscriptionListResponse,
+  type SubscriptionCreateParams,
+  type SubscriptionUpdateParams,
+} from './subscriptions';
+export { Webhooks } from './webhooks';

package/src/resources/webhooks/subscriptions.ts

@@ -0,0 +1,409 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+export class Subscriptions extends APIResource {
+  /**
+   * Create a new webhook subscription to receive events at a target URL. Upon
+   * creation, a signing secret is generated for verifying webhook authenticity.
+   * **Store this secret securely — it cannot be retrieved later.**
+   *
+   * **Webhook Delivery:**
+   *
+   * - Events are sent via HTTP POST to the target URL
+   * - Each request includes `X-Webhook-Signature` and `X-Webhook-Timestamp` headers
+   * - Signature is HMAC-SHA256 over `{timestamp}.{payload}` — see
+   *   [Webhook Events](/docs/webhook-events) for verification details
+   * - Failed deliveries (5xx, 429, network errors) are retried up to 6 times with
+   *   exponential backoff: 2s, 4s, 8s, 16s, 30s
+   * - Client errors (4xx except 429) are not retried
+   *
+   * @example
+   * ```ts
+   * const subscription =
+   *   await client.webhooks.subscriptions.create({
+   *     subscribed_events: [
+   *       'message.sent',
+   *       'message.delivered',
+   *       'message.read',
+   *     ],
+   *     target_url: 'https://webhooks.example.com/linq/events',
+   *   });
+   * ```
+   */
+  create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<SubscriptionCreateResponse> {
+    return this._client.post('/v3/webhook-subscriptions', { body, ...options });
+  }
+
+  /**
+   * Retrieve details for a specific webhook subscription including its target URL,
+   * subscribed events, and current status.
+   *
+   * @example
+   * ```ts
+   * const subscription =
+   *   await client.webhooks.subscriptions.retrieve(
+   *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+   *   );
+   * ```
+   */
+  retrieve(subscriptionID: string, options?: RequestOptions): APIPromise<SubscriptionRetrieveResponse> {
+    return this._client.get(path`/v3/webhook-subscriptions/${subscriptionID}`, options);
+  }
+
+  /**
+   * Update an existing webhook subscription. You can modify the target URL,
+   * subscribed events, or activate/deactivate the subscription.
+   *
+   * **Note:** The signing secret cannot be changed via this endpoint.
+   *
+   * @example
+   * ```ts
+   * const subscription =
+   *   await client.webhooks.subscriptions.update(
+   *     'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+   *     {
+   *       target_url:
+   *         'https://webhooks.example.com/linq/events',
+   *     },
+   *   );
+   * ```
+   */
+  update(
+    subscriptionID: string,
+    body: SubscriptionUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<SubscriptionUpdateResponse> {
+    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 subscriptions =
+   *   await client.webhooks.subscriptions.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<SubscriptionListResponse> {
+    return this._client.get('/v3/webhook-subscriptions', options);
+  }
+
+  /**
+   * Delete a webhook subscription.
+   *
+   * @example
+   * ```ts
+   * await client.webhooks.subscriptions.delete(
+   *   'b2c3d4e5-f6a7-8901-bcde-f23456789012',
+   * );
+   * ```
+   */
+  delete(subscriptionID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v3/webhook-subscriptions/${subscriptionID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Response returned when creating a webhook subscription. Includes the signing
+ * secret which is only shown once.
+ */
+export interface SubscriptionCreateResponse {
+  /**
+   * Unique identifier for the webhook subscription
+   */
+  id: string;
+
+  /**
+   * When the subscription was created
+   */
+  created_at: string;
+
+  /**
+   * Whether this subscription is currently active
+   */
+  is_active: boolean;
+
+  /**
+   * Secret for verifying webhook signatures. Store this securely - it cannot be
+   * retrieved again.
+   */
+  signing_secret: string;
+
+  /**
+   * List of event types this subscription receives
+   */
+  subscribed_events: Array<
+    | 'message.sent'
+    | 'message.received'
+    | 'message.read'
+    | 'message.delivered'
+    | 'message.failed'
+    | 'reaction.added'
+    | 'reaction.removed'
+    | 'participant.added'
+    | 'participant.removed'
+    | 'chat.created'
+    | 'chat.group_name_updated'
+    | 'chat.group_icon_updated'
+    | 'chat.group_name_update_failed'
+    | 'chat.group_icon_update_failed'
+    | 'chat.typing_indicator.started'
+    | 'chat.typing_indicator.stopped'
+    | 'phone_number.status_updated'
+  >;
+
+  /**
+   * URL where webhook events will be sent
+   */
+  target_url: string;
+
+  /**
+   * When the subscription was last updated
+   */
+  updated_at: string;
+}
+
+export interface SubscriptionRetrieveResponse {
+  /**
+   * Unique identifier for the webhook subscription
+   */
+  id: string;
+
+  /**
+   * When the subscription was created
+   */
+  created_at: string;
+
+  /**
+   * Whether this subscription is currently active
+   */
+  is_active: boolean;
+
+  /**
+   * List of event types this subscription receives
+   */
+  subscribed_events: Array<
+    | 'message.sent'
+    | 'message.received'
+    | 'message.read'
+    | 'message.delivered'
+    | 'message.failed'
+    | 'reaction.added'
+    | 'reaction.removed'
+    | 'participant.added'
+    | 'participant.removed'
+    | 'chat.created'
+    | 'chat.group_name_updated'
+    | 'chat.group_icon_updated'
+    | 'chat.group_name_update_failed'
+    | 'chat.group_icon_update_failed'
+    | 'chat.typing_indicator.started'
+    | 'chat.typing_indicator.stopped'
+    | 'phone_number.status_updated'
+  >;
+
+  /**
+   * URL where webhook events will be sent
+   */
+  target_url: string;
+
+  /**
+   * When the subscription was last updated
+   */
+  updated_at: string;
+}
+
+export interface SubscriptionUpdateResponse {
+  /**
+   * Unique identifier for the webhook subscription
+   */
+  id: string;
+
+  /**
+   * When the subscription was created
+   */
+  created_at: string;
+
+  /**
+   * Whether this subscription is currently active
+   */
+  is_active: boolean;
+
+  /**
+   * List of event types this subscription receives
+   */
+  subscribed_events: Array<
+    | 'message.sent'
+    | 'message.received'
+    | 'message.read'
+    | 'message.delivered'
+    | 'message.failed'
+    | 'reaction.added'
+    | 'reaction.removed'
+    | 'participant.added'
+    | 'participant.removed'
+    | 'chat.created'
+    | 'chat.group_name_updated'
+    | 'chat.group_icon_updated'
+    | 'chat.group_name_update_failed'
+    | 'chat.group_icon_update_failed'
+    | 'chat.typing_indicator.started'
+    | 'chat.typing_indicator.stopped'
+    | 'phone_number.status_updated'
+  >;
+
+  /**
+   * URL where webhook events will be sent
+   */
+  target_url: string;
+
+  /**
+   * When the subscription was last updated
+   */
+  updated_at: string;
+}
+
+export interface SubscriptionListResponse {
+  /**
+   * List of webhook subscriptions
+   */
+  subscriptions: Array<SubscriptionListResponse.Subscription>;
+}
+
+export namespace SubscriptionListResponse {
+  export interface Subscription {
+    /**
+     * Unique identifier for the webhook subscription
+     */
+    id: string;
+
+    /**
+     * When the subscription was created
+     */
+    created_at: string;
+
+    /**
+     * Whether this subscription is currently active
+     */
+    is_active: boolean;
+
+    /**
+     * List of event types this subscription receives
+     */
+    subscribed_events: Array<
+      | 'message.sent'
+      | 'message.received'
+      | 'message.read'
+      | 'message.delivered'
+      | 'message.failed'
+      | 'reaction.added'
+      | 'reaction.removed'
+      | 'participant.added'
+      | 'participant.removed'
+      | 'chat.created'
+      | 'chat.group_name_updated'
+      | 'chat.group_icon_updated'
+      | 'chat.group_name_update_failed'
+      | 'chat.group_icon_update_failed'
+      | 'chat.typing_indicator.started'
+      | 'chat.typing_indicator.stopped'
+      | 'phone_number.status_updated'
+    >;
+
+    /**
+     * URL where webhook events will be sent
+     */
+    target_url: string;
+
+    /**
+     * When the subscription was last updated
+     */
+    updated_at: string;
+  }
+}
+
+export interface SubscriptionCreateParams {
+  /**
+   * List of event types to subscribe to
+   */
+  subscribed_events: Array<
+    | 'message.sent'
+    | 'message.received'
+    | 'message.read'
+    | 'message.delivered'
+    | 'message.failed'
+    | 'reaction.added'
+    | 'reaction.removed'
+    | 'participant.added'
+    | 'participant.removed'
+    | 'chat.created'
+    | 'chat.group_name_updated'
+    | 'chat.group_icon_updated'
+    | 'chat.group_name_update_failed'
+    | 'chat.group_icon_update_failed'
+    | 'chat.typing_indicator.started'
+    | 'chat.typing_indicator.stopped'
+    | 'phone_number.status_updated'
+  >;
+
+  /**
+   * URL where webhook events will be sent. Must be HTTPS.
+   */
+  target_url: string;
+}
+
+export interface SubscriptionUpdateParams {
+  /**
+   * Activate or deactivate the subscription
+   */
+  is_active?: boolean;
+
+  /**
+   * Updated list of event types to subscribe to
+   */
+  subscribed_events?: Array<
+    | 'message.sent'
+    | 'message.received'
+    | 'message.read'
+    | 'message.delivered'
+    | 'message.failed'
+    | 'reaction.added'
+    | 'reaction.removed'
+    | 'participant.added'
+    | 'participant.removed'
+    | 'chat.created'
+    | 'chat.group_name_updated'
+    | 'chat.group_icon_updated'
+    | 'chat.group_name_update_failed'
+    | 'chat.group_icon_update_failed'
+    | 'chat.typing_indicator.started'
+    | 'chat.typing_indicator.stopped'
+    | 'phone_number.status_updated'
+  >;
+
+  /**
+   * New target URL for webhook events
+   */
+  target_url?: string;
+}
+
+export declare namespace Subscriptions {
+  export {
+    type SubscriptionCreateResponse as SubscriptionCreateResponse,
+    type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse,
+    type SubscriptionUpdateResponse as SubscriptionUpdateResponse,
+    type SubscriptionListResponse as SubscriptionListResponse,
+    type SubscriptionCreateParams as SubscriptionCreateParams,
+    type SubscriptionUpdateParams as SubscriptionUpdateParams,
+  };
+}

package/src/resources/webhooks/webhooks.ts

@@ -0,0 +1,37 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as EventsAPI from './events';
+import { EventListResponse, Events } from './events';
+import * as SubscriptionsAPI from './subscriptions';
+import {
+  SubscriptionCreateParams,
+  SubscriptionCreateResponse,
+  SubscriptionListResponse,
+  SubscriptionRetrieveResponse,
+  SubscriptionUpdateParams,
+  SubscriptionUpdateResponse,
+  Subscriptions,
+} from './subscriptions';
+
+export class Webhooks extends APIResource {
+  subscriptions: SubscriptionsAPI.Subscriptions = new SubscriptionsAPI.Subscriptions(this._client);
+  events: EventsAPI.Events = new EventsAPI.Events(this._client);
+}
+
+Webhooks.Subscriptions = Subscriptions;
+Webhooks.Events = Events;
+
+export declare namespace Webhooks {
+  export {
+    Subscriptions as Subscriptions,
+    type SubscriptionCreateResponse as SubscriptionCreateResponse,
+    type SubscriptionRetrieveResponse as SubscriptionRetrieveResponse,
+    type SubscriptionUpdateResponse as SubscriptionUpdateResponse,
+    type SubscriptionListResponse as SubscriptionListResponse,
+    type SubscriptionCreateParams as SubscriptionCreateParams,
+    type SubscriptionUpdateParams as SubscriptionUpdateParams,
+  };
+
+  export { Events as Events, type EventListResponse as EventListResponse };
+}

package/src/resources/webhooks.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './webhooks/index';

package/src/resources.ts

@@ -0,0 +1 @@
+export * from './resources/index';

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  // this config is included in the published src directory to prevent TS errors
+  // from appearing when users go to source, and VSCode opens the source .ts file
+  // via declaration maps
+  "include": ["index.ts"],
+  "compilerOptions": {
+    "target": "ES2015",
+    "lib": ["DOM", "DOM.Iterable", "ES2018"],
+    "moduleResolution": "node"
+  }
+}

package/src/uploads.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/uploads instead */
+export * from './core/uploads';

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = '0.1.0-alpha.1'; // x-release-please-version

package/uploads.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.js";
+//# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/uploads instead */
+tslib_1.__exportStar(require("./core/uploads.js"), exports);
+//# sourceMappingURL=uploads.js.map

package/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AACrD,4DAA+B"}

package/uploads.mjs

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/version.d.mts

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

package/version.d.mts.map

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

package/version.d.ts

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

package/version.d.ts.map

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

package/version.js

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

package/version.js.map

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

package/version.mjs

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

package/version.mjs.map

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