@linqapp/sdk 0.1.5 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.2.0 (2026-03-05)
+
+Full Changelog: [v0.1.5...v0.2.0](https://github.com/linq-team/linq-node/compare/v0.1.5...v0.2.0)
+
+### Features
+
+* Allow 100 presigned URL or uploaded attachments (URL + ID) in a message ([adb1e81](https://github.com/linq-team/linq-node/commit/adb1e812c68ab101e2f1362a3c53602dc9c589af))
+* Plt 361 synapse support editing messages in v3 ([68d7b8a](https://github.com/linq-team/linq-node/commit/68d7b8afbc158ecb3fd0ce85e9ca8c0ad324b6bc))
+
+
+### Bug Fixes
+
+* remove unused part-level idempotency_key from OpenAPI spec ([24df345](https://github.com/linq-team/linq-node/commit/24df345db930e173b4618ce04819dd9dc021aa02))
+
+
+### Chores
+
+* **internal:** codegen related update ([3c28377](https://github.com/linq-team/linq-node/commit/3c283771a2d2ff459ed32f289d2e03fa379278af))
+* **internal:** move stringifyQuery implementation to internal function ([b86f2c0](https://github.com/linq-team/linq-node/commit/b86f2c05a2c2e2b2ea4fe1df03c70b27f35def30))
+
 ## 0.1.5 (2026-02-24)
 
 Full Changelog: [v0.1.4...v0.1.5](https://github.com/linq-team/linq-node/compare/v0.1.4...v0.1.5)

package/client.d.mts

@@ -125,7 +125,7 @@ export declare class LinqAPIV3 {
     /**
      * Basic re-implementation of `qs.stringify` for primitive types.
      */
-    protected stringifyQuery(query: Record<string, unknown>): string;
+    protected stringifyQuery(query: object | Record<string, unknown>): string;
     private getUserAgent;
     protected defaultIdempotencyKey(): string;
     protected makeStatusError(status: number, error: Object, message: string | undefined, headers: Headers): Errors.APIError;
@@ -183,12 +183,291 @@ export declare class LinqAPIV3 {
     static UnprocessableEntityError: typeof Errors.UnprocessableEntityError;
     static toFile: typeof Uploads.toFile;
     chats: API.Chats;
+    /**
+     * Messages are individual text or multimedia communications within a chat thread.
+     *
+     * Messages can include text, attachments, special effects (like confetti or fireworks),
+     * and reactions. All messages are associated with a specific chat and sent from a
+     * phone number you own.
+     *
+     * Messages support delivery status tracking, read receipts, and editing capabilities.
+     *
+     */
     messages: API.Messages;
+    /**
+     * Send files (images, videos, documents, audio) with messages by providing a URL in a media part.
+     * Pre-uploading via `POST /v3/attachments` is **optional** and only needed for specific optimization scenarios.
+     *
+     * ## Sending Media via URL (up to 10MB)
+     *
+     * Provide a publicly accessible HTTPS URL with a [supported media type](#supported-file-types) in the `url` field of a media part.
+     *
+     * ```json
+     * {
+     *   "parts": [
+     *     { "type": "media", "url": "https://your-cdn.com/images/photo.jpg" }
+     *   ]
+     * }
+     * ```
+     *
+     * This works with any URL you already host — no pre-upload step required. **Maximum file size: 10MB.**
+     *
+     * ## Pre-Upload (required for files over 10MB)
+     *
+     * Use `POST /v3/attachments` when you want to:
+     * - **Send files larger than 10MB** (up to 100MB) — URL-based downloads are limited to 10MB
+     * - **Send the same file to many recipients** — upload once, reuse the `attachment_id` without re-downloading each time
+     * - **Reduce message send latency** — the file is already stored, so sending is faster
+     *
+     * **How it works:**
+     * 1. `POST /v3/attachments` with file metadata → returns a presigned `upload_url` (valid for **15 minutes**) and a permanent `attachment_id`
+     * 2. PUT the raw file bytes to the `upload_url` with the `required_headers` (no JSON or multipart — just the binary content)
+     * 3. Reference the `attachment_id` in your media part when sending messages (no expiration)
+     *
+     * **Key difference:** When you provide an external `url`, we download and process the file on every send.
+     * When you use a pre-uploaded `attachment_id`, the file is already stored — so repeated sends skip the download step entirely.
+     *
+     * ## Domain Allowlisting
+     *
+     * Attachment URLs in API responses are served from `cdn.linqapp.com`. This includes:
+     * - `url` fields in media and voice memo message parts
+     * - `download_url` fields in attachment and upload response objects
+     *
+     * If your application enforces domain allowlists (e.g., for SSRF protection), add:
+     *
+     * ```
+     * cdn.linqapp.com
+     * ```
+     *
+     * ## Supported File Types
+     *
+     * - **Images:** JPEG, PNG, GIF, HEIC, HEIF, TIFF, BMP
+     * - **Videos:** MP4, MOV, M4V
+     * - **Audio:** M4A, AAC, MP3, WAV, AIFF, CAF, AMR
+     * - **Documents:** PDF, TXT, RTF, CSV, Office formats, ZIP
+     * - **Contact & Calendar:** VCF, ICS
+     *
+     * ## Audio: Attachment vs Voice Memo
+     *
+     * Audio files sent as media parts appear as **downloadable file attachments** in iMessage.
+     * To send audio as an **iMessage voice memo bubble** (with native inline playback UI),
+     * use the dedicated `POST /v3/chats/{chatId}/voicememo` endpoint instead.
+     *
+     * ## File Size Limits
+     *
+     * - **URL-based (`url` field):** 10MB maximum
+     * - **Pre-upload (`attachment_id`):** 100MB maximum
+     *
+     */
     attachments: API.Attachments;
+    /**
+     * Phone Numbers represent the phone numbers assigned to your partner account.
+     *
+     * Use the list phone numbers endpoint to discover which phone numbers are available
+     * for sending messages.
+     *
+     * When creating chats, listing chats, or sending a voice memo, use one of your assigned phone numbers
+     * in the `from` field.
+     *
+     */
     phonenumbers: API.Phonenumbers;
+    /**
+     * Phone Numbers represent the phone numbers assigned to your partner account.
+     *
+     * Use the list phone numbers endpoint to discover which phone numbers are available
+     * for sending messages.
+     *
+     * When creating chats, listing chats, or sending a voice memo, use one of your assigned phone numbers
+     * in the `from` field.
+     *
+     */
     phoneNumbers: API.PhoneNumbers;
+    /**
+     * Webhook Subscriptions allow you to receive real-time notifications when events
+     * occur on your account.
+     *
+     * Configure webhook endpoints to receive events such as messages sent/received,
+     * delivery status changes, reactions, typing indicators, and more.
+     *
+     * Failed deliveries (5xx, 429, network errors) are retried up to 10 times over
+     * ~2 hours with exponential backoff. Each event includes a unique ID for
+     * deduplication.
+     *
+     * ## Webhook Headers
+     *
+     * Each webhook request includes the following headers:
+     *
+     * | Header | Description |
+     * |--------|-------------|
+     * | `X-Webhook-Event` | The event type (e.g., `message.sent`, `message.received`) |
+     * | `X-Webhook-Subscription-ID` | Your webhook subscription ID |
+     * | `X-Webhook-Timestamp` | Unix timestamp (seconds) when the webhook was sent |
+     * | `X-Webhook-Signature` | HMAC-SHA256 signature for verification |
+     *
+     * ## Verifying Webhook Signatures
+     *
+     * All webhooks are signed using HMAC-SHA256. You should always verify the signature
+     * to ensure the webhook originated from Linq and hasn't been tampered with.
+     *
+     * **Signature Construction:**
+     *
+     * The signature is computed over a concatenation of the timestamp and payload:
+     *
+     * ```
+     * {timestamp}.{payload}
+     * ```
+     *
+     * Where:
+     * - `timestamp` is the value from the `X-Webhook-Timestamp` header
+     * - `payload` is the raw JSON request body (exact bytes, not re-serialized)
+     *
+     * **Verification Steps:**
+     *
+     * 1. Extract the `X-Webhook-Timestamp` and `X-Webhook-Signature` headers
+     * 2. Get the raw request body bytes (do not parse and re-serialize)
+     * 3. Concatenate: `"{timestamp}.{payload}"`
+     * 4. Compute HMAC-SHA256 using your signing secret as the key
+     * 5. Hex-encode the result and compare with `X-Webhook-Signature`
+     * 6. Use constant-time comparison to prevent timing attacks
+     *
+     * **Example (Python):**
+     *
+     * ```python
+     * import hmac
+     * import hashlib
+     *
+     * def verify_webhook(signing_secret, payload, timestamp, signature):
+     *     message = f"{timestamp}.{payload.decode('utf-8')}"
+     *     expected = hmac.new(
+     *         signing_secret.encode('utf-8'),
+     *         message.encode('utf-8'),
+     *         hashlib.sha256
+     *     ).hexdigest()
+     *     return hmac.compare_digest(expected, signature)
+     * ```
+     *
+     * **Example (Node.js):**
+     *
+     * ```javascript
+     * const crypto = require('crypto');
+     *
+     * function verifyWebhook(signingSecret, payload, timestamp, signature) {
+     *   const message = `${timestamp}.${payload}`;
+     *   const expected = crypto
+     *     .createHmac('sha256', signingSecret)
+     *     .update(message)
+     *     .digest('hex');
+     *   return crypto.timingSafeEqual(
+     *     Buffer.from(expected),
+     *     Buffer.from(signature)
+     *   );
+     * }
+     * ```
+     *
+     * **Security Best Practices:**
+     *
+     * - Reject webhooks with timestamps older than 5 minutes to prevent replay attacks
+     * - Always use constant-time comparison for signature verification
+     * - Store your signing secret securely (e.g., environment variable, secrets manager)
+     * - Return a 2xx status code quickly, then process the webhook asynchronously
+     *
+     */
     webhookEvents: API.WebhookEvents;
+    /**
+     * Webhook Subscriptions allow you to receive real-time notifications when events
+     * occur on your account.
+     *
+     * Configure webhook endpoints to receive events such as messages sent/received,
+     * delivery status changes, reactions, typing indicators, and more.
+     *
+     * Failed deliveries (5xx, 429, network errors) are retried up to 10 times over
+     * ~2 hours with exponential backoff. Each event includes a unique ID for
+     * deduplication.
+     *
+     * ## Webhook Headers
+     *
+     * Each webhook request includes the following headers:
+     *
+     * | Header | Description |
+     * |--------|-------------|
+     * | `X-Webhook-Event` | The event type (e.g., `message.sent`, `message.received`) |
+     * | `X-Webhook-Subscription-ID` | Your webhook subscription ID |
+     * | `X-Webhook-Timestamp` | Unix timestamp (seconds) when the webhook was sent |
+     * | `X-Webhook-Signature` | HMAC-SHA256 signature for verification |
+     *
+     * ## Verifying Webhook Signatures
+     *
+     * All webhooks are signed using HMAC-SHA256. You should always verify the signature
+     * to ensure the webhook originated from Linq and hasn't been tampered with.
+     *
+     * **Signature Construction:**
+     *
+     * The signature is computed over a concatenation of the timestamp and payload:
+     *
+     * ```
+     * {timestamp}.{payload}
+     * ```
+     *
+     * Where:
+     * - `timestamp` is the value from the `X-Webhook-Timestamp` header
+     * - `payload` is the raw JSON request body (exact bytes, not re-serialized)
+     *
+     * **Verification Steps:**
+     *
+     * 1. Extract the `X-Webhook-Timestamp` and `X-Webhook-Signature` headers
+     * 2. Get the raw request body bytes (do not parse and re-serialize)
+     * 3. Concatenate: `"{timestamp}.{payload}"`
+     * 4. Compute HMAC-SHA256 using your signing secret as the key
+     * 5. Hex-encode the result and compare with `X-Webhook-Signature`
+     * 6. Use constant-time comparison to prevent timing attacks
+     *
+     * **Example (Python):**
+     *
+     * ```python
+     * import hmac
+     * import hashlib
+     *
+     * def verify_webhook(signing_secret, payload, timestamp, signature):
+     *     message = f"{timestamp}.{payload.decode('utf-8')}"
+     *     expected = hmac.new(
+     *         signing_secret.encode('utf-8'),
+     *         message.encode('utf-8'),
+     *         hashlib.sha256
+     *     ).hexdigest()
+     *     return hmac.compare_digest(expected, signature)
+     * ```
+     *
+     * **Example (Node.js):**
+     *
+     * ```javascript
+     * const crypto = require('crypto');
+     *
+     * function verifyWebhook(signingSecret, payload, timestamp, signature) {
+     *   const message = `${timestamp}.${payload}`;
+     *   const expected = crypto
+     *     .createHmac('sha256', signingSecret)
+     *     .update(message)
+     *     .digest('hex');
+     *   return crypto.timingSafeEqual(
+     *     Buffer.from(expected),
+     *     Buffer.from(signature)
+     *   );
+     * }
+     * ```
+     *
+     * **Security Best Practices:**
+     *
+     * - Reject webhooks with timestamps older than 5 minutes to prevent replay attacks
+     * - Always use constant-time comparison for signature verification
+     * - Store your signing secret securely (e.g., environment variable, secrets manager)
+     * - Return a 2xx status code quickly, then process the webhook asynchronously
+     *
+     */
     webhookSubscriptions: API.WebhookSubscriptions;
+    /**
+     * Check whether a recipient address supports iMessage or RCS before sending a message.
+     *
+     */
     capability: API.Capability;
 }
 export declare namespace LinqAPIV3 {

package/client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.mts","sourceRoot":"","sources":["src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.mts","sourceRoot":"","sources":["src/client.ts"],"names":[],"mappings":"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"}

package/client.d.ts

@@ -125,7 +125,7 @@ export declare class LinqAPIV3 {
     /**
      * Basic re-implementation of `qs.stringify` for primitive types.
      */
-    protected stringifyQuery(query: Record<string, unknown>): string;
+    protected stringifyQuery(query: object | Record<string, unknown>): string;
     private getUserAgent;
     protected defaultIdempotencyKey(): string;
     protected makeStatusError(status: number, error: Object, message: string | undefined, headers: Headers): Errors.APIError;
@@ -183,12 +183,291 @@ export declare class LinqAPIV3 {
     static UnprocessableEntityError: typeof Errors.UnprocessableEntityError;
     static toFile: typeof Uploads.toFile;
     chats: API.Chats;
+    /**
+     * Messages are individual text or multimedia communications within a chat thread.
+     *
+     * Messages can include text, attachments, special effects (like confetti or fireworks),
+     * and reactions. All messages are associated with a specific chat and sent from a
+     * phone number you own.
+     *
+     * Messages support delivery status tracking, read receipts, and editing capabilities.
+     *
+     */
     messages: API.Messages;
+    /**
+     * Send files (images, videos, documents, audio) with messages by providing a URL in a media part.
+     * Pre-uploading via `POST /v3/attachments` is **optional** and only needed for specific optimization scenarios.
+     *
+     * ## Sending Media via URL (up to 10MB)
+     *
+     * Provide a publicly accessible HTTPS URL with a [supported media type](#supported-file-types) in the `url` field of a media part.
+     *
+     * ```json
+     * {
+     *   "parts": [
+     *     { "type": "media", "url": "https://your-cdn.com/images/photo.jpg" }
+     *   ]
+     * }
+     * ```
+     *
+     * This works with any URL you already host — no pre-upload step required. **Maximum file size: 10MB.**
+     *
+     * ## Pre-Upload (required for files over 10MB)
+     *
+     * Use `POST /v3/attachments` when you want to:
+     * - **Send files larger than 10MB** (up to 100MB) — URL-based downloads are limited to 10MB
+     * - **Send the same file to many recipients** — upload once, reuse the `attachment_id` without re-downloading each time
+     * - **Reduce message send latency** — the file is already stored, so sending is faster
+     *
+     * **How it works:**
+     * 1. `POST /v3/attachments` with file metadata → returns a presigned `upload_url` (valid for **15 minutes**) and a permanent `attachment_id`
+     * 2. PUT the raw file bytes to the `upload_url` with the `required_headers` (no JSON or multipart — just the binary content)
+     * 3. Reference the `attachment_id` in your media part when sending messages (no expiration)
+     *
+     * **Key difference:** When you provide an external `url`, we download and process the file on every send.
+     * When you use a pre-uploaded `attachment_id`, the file is already stored — so repeated sends skip the download step entirely.
+     *
+     * ## Domain Allowlisting
+     *
+     * Attachment URLs in API responses are served from `cdn.linqapp.com`. This includes:
+     * - `url` fields in media and voice memo message parts
+     * - `download_url` fields in attachment and upload response objects
+     *
+     * If your application enforces domain allowlists (e.g., for SSRF protection), add:
+     *
+     * ```
+     * cdn.linqapp.com
+     * ```
+     *
+     * ## Supported File Types
+     *
+     * - **Images:** JPEG, PNG, GIF, HEIC, HEIF, TIFF, BMP
+     * - **Videos:** MP4, MOV, M4V
+     * - **Audio:** M4A, AAC, MP3, WAV, AIFF, CAF, AMR
+     * - **Documents:** PDF, TXT, RTF, CSV, Office formats, ZIP
+     * - **Contact & Calendar:** VCF, ICS
+     *
+     * ## Audio: Attachment vs Voice Memo
+     *
+     * Audio files sent as media parts appear as **downloadable file attachments** in iMessage.
+     * To send audio as an **iMessage voice memo bubble** (with native inline playback UI),
+     * use the dedicated `POST /v3/chats/{chatId}/voicememo` endpoint instead.
+     *
+     * ## File Size Limits
+     *
+     * - **URL-based (`url` field):** 10MB maximum
+     * - **Pre-upload (`attachment_id`):** 100MB maximum
+     *
+     */
     attachments: API.Attachments;
+    /**
+     * Phone Numbers represent the phone numbers assigned to your partner account.
+     *
+     * Use the list phone numbers endpoint to discover which phone numbers are available
+     * for sending messages.
+     *
+     * When creating chats, listing chats, or sending a voice memo, use one of your assigned phone numbers
+     * in the `from` field.
+     *
+     */
     phonenumbers: API.Phonenumbers;
+    /**
+     * Phone Numbers represent the phone numbers assigned to your partner account.
+     *
+     * Use the list phone numbers endpoint to discover which phone numbers are available
+     * for sending messages.
+     *
+     * When creating chats, listing chats, or sending a voice memo, use one of your assigned phone numbers
+     * in the `from` field.
+     *
+     */
     phoneNumbers: API.PhoneNumbers;
+    /**
+     * Webhook Subscriptions allow you to receive real-time notifications when events
+     * occur on your account.
+     *
+     * Configure webhook endpoints to receive events such as messages sent/received,
+     * delivery status changes, reactions, typing indicators, and more.
+     *
+     * Failed deliveries (5xx, 429, network errors) are retried up to 10 times over
+     * ~2 hours with exponential backoff. Each event includes a unique ID for
+     * deduplication.
+     *
+     * ## Webhook Headers
+     *
+     * Each webhook request includes the following headers:
+     *
+     * | Header | Description |
+     * |--------|-------------|
+     * | `X-Webhook-Event` | The event type (e.g., `message.sent`, `message.received`) |
+     * | `X-Webhook-Subscription-ID` | Your webhook subscription ID |
+     * | `X-Webhook-Timestamp` | Unix timestamp (seconds) when the webhook was sent |
+     * | `X-Webhook-Signature` | HMAC-SHA256 signature for verification |
+     *
+     * ## Verifying Webhook Signatures
+     *
+     * All webhooks are signed using HMAC-SHA256. You should always verify the signature
+     * to ensure the webhook originated from Linq and hasn't been tampered with.
+     *
+     * **Signature Construction:**
+     *
+     * The signature is computed over a concatenation of the timestamp and payload:
+     *
+     * ```
+     * {timestamp}.{payload}
+     * ```
+     *
+     * Where:
+     * - `timestamp` is the value from the `X-Webhook-Timestamp` header
+     * - `payload` is the raw JSON request body (exact bytes, not re-serialized)
+     *
+     * **Verification Steps:**
+     *
+     * 1. Extract the `X-Webhook-Timestamp` and `X-Webhook-Signature` headers
+     * 2. Get the raw request body bytes (do not parse and re-serialize)
+     * 3. Concatenate: `"{timestamp}.{payload}"`
+     * 4. Compute HMAC-SHA256 using your signing secret as the key
+     * 5. Hex-encode the result and compare with `X-Webhook-Signature`
+     * 6. Use constant-time comparison to prevent timing attacks
+     *
+     * **Example (Python):**
+     *
+     * ```python
+     * import hmac
+     * import hashlib
+     *
+     * def verify_webhook(signing_secret, payload, timestamp, signature):
+     *     message = f"{timestamp}.{payload.decode('utf-8')}"
+     *     expected = hmac.new(
+     *         signing_secret.encode('utf-8'),
+     *         message.encode('utf-8'),
+     *         hashlib.sha256
+     *     ).hexdigest()
+     *     return hmac.compare_digest(expected, signature)
+     * ```
+     *
+     * **Example (Node.js):**
+     *
+     * ```javascript
+     * const crypto = require('crypto');
+     *
+     * function verifyWebhook(signingSecret, payload, timestamp, signature) {
+     *   const message = `${timestamp}.${payload}`;
+     *   const expected = crypto
+     *     .createHmac('sha256', signingSecret)
+     *     .update(message)
+     *     .digest('hex');
+     *   return crypto.timingSafeEqual(
+     *     Buffer.from(expected),
+     *     Buffer.from(signature)
+     *   );
+     * }
+     * ```
+     *
+     * **Security Best Practices:**
+     *
+     * - Reject webhooks with timestamps older than 5 minutes to prevent replay attacks
+     * - Always use constant-time comparison for signature verification
+     * - Store your signing secret securely (e.g., environment variable, secrets manager)
+     * - Return a 2xx status code quickly, then process the webhook asynchronously
+     *
+     */
     webhookEvents: API.WebhookEvents;
+    /**
+     * Webhook Subscriptions allow you to receive real-time notifications when events
+     * occur on your account.
+     *
+     * Configure webhook endpoints to receive events such as messages sent/received,
+     * delivery status changes, reactions, typing indicators, and more.
+     *
+     * Failed deliveries (5xx, 429, network errors) are retried up to 10 times over
+     * ~2 hours with exponential backoff. Each event includes a unique ID for
+     * deduplication.
+     *
+     * ## Webhook Headers
+     *
+     * Each webhook request includes the following headers:
+     *
+     * | Header | Description |
+     * |--------|-------------|
+     * | `X-Webhook-Event` | The event type (e.g., `message.sent`, `message.received`) |
+     * | `X-Webhook-Subscription-ID` | Your webhook subscription ID |
+     * | `X-Webhook-Timestamp` | Unix timestamp (seconds) when the webhook was sent |
+     * | `X-Webhook-Signature` | HMAC-SHA256 signature for verification |
+     *
+     * ## Verifying Webhook Signatures
+     *
+     * All webhooks are signed using HMAC-SHA256. You should always verify the signature
+     * to ensure the webhook originated from Linq and hasn't been tampered with.
+     *
+     * **Signature Construction:**
+     *
+     * The signature is computed over a concatenation of the timestamp and payload:
+     *
+     * ```
+     * {timestamp}.{payload}
+     * ```
+     *
+     * Where:
+     * - `timestamp` is the value from the `X-Webhook-Timestamp` header
+     * - `payload` is the raw JSON request body (exact bytes, not re-serialized)
+     *
+     * **Verification Steps:**
+     *
+     * 1. Extract the `X-Webhook-Timestamp` and `X-Webhook-Signature` headers
+     * 2. Get the raw request body bytes (do not parse and re-serialize)
+     * 3. Concatenate: `"{timestamp}.{payload}"`
+     * 4. Compute HMAC-SHA256 using your signing secret as the key
+     * 5. Hex-encode the result and compare with `X-Webhook-Signature`
+     * 6. Use constant-time comparison to prevent timing attacks
+     *
+     * **Example (Python):**
+     *
+     * ```python
+     * import hmac
+     * import hashlib
+     *
+     * def verify_webhook(signing_secret, payload, timestamp, signature):
+     *     message = f"{timestamp}.{payload.decode('utf-8')}"
+     *     expected = hmac.new(
+     *         signing_secret.encode('utf-8'),
+     *         message.encode('utf-8'),
+     *         hashlib.sha256
+     *     ).hexdigest()
+     *     return hmac.compare_digest(expected, signature)
+     * ```
+     *
+     * **Example (Node.js):**
+     *
+     * ```javascript
+     * const crypto = require('crypto');
+     *
+     * function verifyWebhook(signingSecret, payload, timestamp, signature) {
+     *   const message = `${timestamp}.${payload}`;
+     *   const expected = crypto
+     *     .createHmac('sha256', signingSecret)
+     *     .update(message)
+     *     .digest('hex');
+     *   return crypto.timingSafeEqual(
+     *     Buffer.from(expected),
+     *     Buffer.from(signature)
+     *   );
+     * }
+     * ```
+     *
+     * **Security Best Practices:**
+     *
+     * - Reject webhooks with timestamps older than 5 minutes to prevent replay attacks
+     * - Always use constant-time comparison for signature verification
+     * - Store your signing secret securely (e.g., environment variable, secrets manager)
+     * - Return a 2xx status code quickly, then process the webhook asynchronously
+     *
+     */
     webhookSubscriptions: API.WebhookSubscriptions;
+    /**
+     * Check whether a recipient address supports iMessage or RCS before sending a message.
+     *
+     */
     capability: API.Capability;
 }
 export declare namespace LinqAPIV3 {