@linqapp/sdk 0.44.2 → 0.45.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.45.0](https://github.com/linq-team/linq-node/compare/v0.44.3...v0.45.0) (2026-08-24)
+
+
+### Features
+
+* add location sharing webhook metadata and request validation ([bcadf8c](https://github.com/linq-team/linq-node/commit/bcadf8cf5297c7489e86ab95a421576842b179c1))
+
+## [0.44.3](https://github.com/linq-team/linq-node/compare/v0.44.2...v0.44.3) (2026-08-20)
+
+
+### Documentation
+
+* clarify transcript background field requirements and examples ([c400402](https://github.com/linq-team/linq-node/commit/c400402cb24e171562a927af18d75a04d6373443))
+
 ## [0.44.2](https://github.com/linq-team/linq-node/compare/v0.44.1...v0.44.2) (2026-08-20)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linqapp/sdk",
-  "version": "0.44.2",
+  "version": "0.45.0",
   "description": "The official TypeScript library for the Linq API V3 API",
   "author": "Linq API V3 <support@linq.com>",
   "types": "./index.d.ts",

package/resources/chats/background.d.mts

@@ -64,15 +64,18 @@ export interface BackgroundSetParams {
      * fetched and re-hosted on our CDN before the request is accepted — the same way
      * `group_chat_icon` works. A URL we cannot fetch, or one that isn't an image, is
      * rejected with a `400` (`5007`/`5006`) rather than failing later on the device.
+     *
+     * Example: `https://cdn.linqapp.com/u/bg.jpg`.
      */
     image_url?: string;
     /**
-     * Color with `variant: custom`: the two gradient stops as hex, top then bottom.
-     * Ignored for named color variants (they carry their own two colors).
+     * Color with `variant: custom`: the two gradient stops as hex, top then bottom —
+     * e.g. `["#F2C4E1", "#F5A623"]`. Ignored for named color variants (they carry
+     * their own two colors).
      */
     shades?: Array<string>;
     /**
-     * Dynamic: the animated style.
+     * Dynamic: the animated style — `sky`, `water`, or `aurora`.
      */
     style?: 'sky' | 'water' | 'aurora';
     /**

package/resources/chats/background.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"background.d.mts","sourceRoot":"","sources":["../../src/resources/chats/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOlE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO3F;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAEpC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC5D"}
+{"version":3,"file":"background.d.mts","sourceRoot":"","sources":["../../src/resources/chats/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOlE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO3F;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAEpC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC5D"}

package/resources/chats/background.d.ts

@@ -64,15 +64,18 @@ export interface BackgroundSetParams {
      * fetched and re-hosted on our CDN before the request is accepted — the same way
      * `group_chat_icon` works. A URL we cannot fetch, or one that isn't an image, is
      * rejected with a `400` (`5007`/`5006`) rather than failing later on the device.
+     *
+     * Example: `https://cdn.linqapp.com/u/bg.jpg`.
      */
     image_url?: string;
     /**
-     * Color with `variant: custom`: the two gradient stops as hex, top then bottom.
-     * Ignored for named color variants (they carry their own two colors).
+     * Color with `variant: custom`: the two gradient stops as hex, top then bottom —
+     * e.g. `["#F2C4E1", "#F5A623"]`. Ignored for named color variants (they carry
+     * their own two colors).
      */
     shades?: Array<string>;
     /**
-     * Dynamic: the animated style.
+     * Dynamic: the animated style — `sky`, `water`, or `aurora`.
      */
     style?: 'sky' | 'water' | 'aurora';
     /**

package/resources/chats/background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/resources/chats/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOlE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO3F;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAEpC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC5D"}
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/resources/chats/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOlE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO3F;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAEpC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC5D"}

package/resources/chats/location.d.mts

@@ -6,7 +6,7 @@ import { RequestOptions } from "../../internal/request-options.mjs";
  * and subscribe to webhooks when someone starts or stops sharing.
  *
  * **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
- * `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+ * `[longitude, latitude]`.
  *
  * ### Reading location is poll-based
  *
@@ -52,6 +52,9 @@ export declare class Location extends APIResource {
      * separate feature for each participant who is sharing. Each feature's
      * `properties.handle` identifies the user.
      *
+     * A participant appears as soon as their first position arrives, typically within
+     * a second or two of sharing starting.
+     *
      * Returns an empty `data.features` array if no one is sharing or no location data
      * is available yet. If sharing started but this stays empty, see the **Location
      * Sharing** overview.
@@ -78,6 +81,12 @@ export declare class Location extends APIResource {
      * `{ "success": true, "message": "Location request sent" }` and does not return
      * coordinates.
      *
+     * Rejected with `409` if the recipient is already sharing — read their location
+     * with `GET /v3/chats/{chatId}/location` instead of re-requesting.
+     *
+     * Rate limited per chat, since each request prompts the recipient's device.
+     * Exceeding it returns `429` with a `Retry-After` header.
+     *
      * Location requests only work in **1:1 iMessage chats** (Apple limitation):
      *
      * - Group chats (any service) return `409` with code `2016`
@@ -113,7 +122,7 @@ export declare namespace GetChatLocationResponse {
         namespace Feature {
             interface Geometry {
                 /**
-                 * [longitude, latitude] or [longitude, latitude, altitude]
+                 * [longitude, latitude]
                  */
                 coordinates: Array<number>;
                 type: 'Point';

package/resources/chats/location.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"location.d.mts","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;IAOvF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;CAGvF;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;IAEnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,IAAI;QACnB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,EAAE,mBAAmB,CAAC;KAC3B;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,OAAO;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAE3B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;YAE/B,IAAI,EAAE,SAAS,CAAC;SACjB;QAED,UAAiB,OAAO,CAAC;YACvB,UAAiB,QAAQ;gBACvB;;mBAEG;gBACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAE3B,IAAI,EAAE,OAAO,CAAC;aACf;YAED,UAAiB,UAAU;gBACzB;;mBAEG;gBACH,MAAM,EAAE,MAAM,CAAC;gBAEf;;mBAEG;gBACH,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEjB;;mBAEG;gBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAElB;;mBAEG;gBACH,UAAU,CAAC,EAAE,MAAM,CAAC;aACrB;SACF;KACF;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}
+{"version":3,"file":"location.d.mts","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;IAOvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;CAGvF;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;IAEnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,IAAI;QACnB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,EAAE,mBAAmB,CAAC;KAC3B;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,OAAO;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAE3B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;YAE/B,IAAI,EAAE,SAAS,CAAC;SACjB;QAED,UAAiB,OAAO,CAAC;YACvB,UAAiB,QAAQ;gBACvB;;mBAEG;gBACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAE3B,IAAI,EAAE,OAAO,CAAC;aACf;YAED,UAAiB,UAAU;gBACzB;;mBAEG;gBACH,MAAM,EAAE,MAAM,CAAC;gBAEf;;mBAEG;gBACH,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEjB;;mBAEG;gBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAElB;;mBAEG;gBACH,UAAU,CAAC,EAAE,MAAM,CAAC;aACrB;SACF;KACF;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/chats/location.d.ts

@@ -6,7 +6,7 @@ import { RequestOptions } from "../../internal/request-options.js";
  * and subscribe to webhooks when someone starts or stops sharing.
  *
  * **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
- * `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+ * `[longitude, latitude]`.
  *
  * ### Reading location is poll-based
  *
@@ -52,6 +52,9 @@ export declare class Location extends APIResource {
      * separate feature for each participant who is sharing. Each feature's
      * `properties.handle` identifies the user.
      *
+     * A participant appears as soon as their first position arrives, typically within
+     * a second or two of sharing starting.
+     *
      * Returns an empty `data.features` array if no one is sharing or no location data
      * is available yet. If sharing started but this stays empty, see the **Location
      * Sharing** overview.
@@ -78,6 +81,12 @@ export declare class Location extends APIResource {
      * `{ "success": true, "message": "Location request sent" }` and does not return
      * coordinates.
      *
+     * Rejected with `409` if the recipient is already sharing — read their location
+     * with `GET /v3/chats/{chatId}/location` instead of re-requesting.
+     *
+     * Rate limited per chat, since each request prompts the recipient's device.
+     * Exceeding it returns `429` with a `Retry-After` header.
+     *
      * Location requests only work in **1:1 iMessage chats** (Apple limitation):
      *
      * - Group chats (any service) return `409` with code `2016`
@@ -113,7 +122,7 @@ export declare namespace GetChatLocationResponse {
         namespace Feature {
             interface Geometry {
                 /**
-                 * [longitude, latitude] or [longitude, latitude, altitude]
+                 * [longitude, latitude]
                  */
                 coordinates: Array<number>;
                 type: 'Point';

package/resources/chats/location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;IAOvF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;CAGvF;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;IAEnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,IAAI;QACnB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,EAAE,mBAAmB,CAAC;KAC3B;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,OAAO;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAE3B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;YAE/B,IAAI,EAAE,SAAS,CAAC;SACjB;QAED,UAAiB,OAAO,CAAC;YACvB,UAAiB,QAAQ;gBACvB;;mBAEG;gBACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAE3B,IAAI,EAAE,OAAO,CAAC;aACf;YAED,UAAiB,UAAU;gBACzB;;mBAEG;gBACH,MAAM,EAAE,MAAM,CAAC;gBAEf;;mBAEG;gBACH,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEjB;;mBAEG;gBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAElB;;mBAEG;gBACH,UAAU,CAAC,EAAE,MAAM,CAAC;aACrB;SACF;KACF;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;IAOvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;CAGvF;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;IAEnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,IAAI;QACnB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,EAAE,mBAAmB,CAAC;KAC3B;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,OAAO;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;YAE3B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;YAE/B,IAAI,EAAE,SAAS,CAAC;SACjB;QAED,UAAiB,OAAO,CAAC;YACvB,UAAiB,QAAQ;gBACvB;;mBAEG;gBACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAE3B,IAAI,EAAE,OAAO,CAAC;aACf;YAED,UAAiB,UAAU;gBACzB;;mBAEG;gBACH,MAAM,EAAE,MAAM,CAAC;gBAEf;;mBAEG;gBACH,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEjB;;mBAEG;gBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAElB;;mBAEG;gBACH,UAAU,CAAC,EAAE,MAAM,CAAC;aACrB;SACF;KACF;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/chats/location.js

@@ -10,7 +10,7 @@ const path_1 = require("../../internal/utils/path.js");
  * and subscribe to webhooks when someone starts or stops sharing.
  *
  * **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
- * `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+ * `[longitude, latitude]`.
  *
  * ### Reading location is poll-based
  *
@@ -56,6 +56,9 @@ class Location extends resource_1.APIResource {
      * separate feature for each participant who is sharing. Each feature's
      * `properties.handle` identifies the user.
      *
+     * A participant appears as soon as their first position arrives, typically within
+     * a second or two of sharing starting.
+     *
      * Returns an empty `data.features` array if no one is sharing or no location data
      * is available yet. If sharing started but this stays empty, see the **Location
      * Sharing** overview.
@@ -87,6 +90,12 @@ class Location extends resource_1.APIResource {
      * `{ "success": true, "message": "Location request sent" }` and does not return
      * coordinates.
      *
+     * Rejected with `409` if the recipient is already sharing — read their location
+     * with `GET /v3/chats/{chatId}/location` instead of re-requesting.
+     *
+     * Rate limited per chat, since each request prompts the recipient's device.
+     * Exceeding it returns `429` with a `Retry-After` header.
+     *
      * Location requests only work in **1:1 iMessage chats** (Apple limitation):
      *
      * - Group chats (any service) return `409` with code `2016`

package/resources/chats/location.js.map

@@ -1 +1 @@
-{"version":3,"file":"location.js","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,WAAW,EAAE;YAC1D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,MAAc,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AA/DD,4BA+DC"}
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,WAAW,EAAE;YAC1D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAc,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AAxED,4BAwEC"}

package/resources/chats/location.mjs

@@ -7,7 +7,7 @@ import { path } from "../../internal/utils/path.mjs";
  * and subscribe to webhooks when someone starts or stops sharing.
  *
  * **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
- * `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+ * `[longitude, latitude]`.
  *
  * ### Reading location is poll-based
  *
@@ -53,6 +53,9 @@ export class Location extends APIResource {
      * separate feature for each participant who is sharing. Each feature's
      * `properties.handle` identifies the user.
      *
+     * A participant appears as soon as their first position arrives, typically within
+     * a second or two of sharing starting.
+     *
      * Returns an empty `data.features` array if no one is sharing or no location data
      * is available yet. If sharing started but this stays empty, see the **Location
      * Sharing** overview.
@@ -84,6 +87,12 @@ export class Location extends APIResource {
      * `{ "success": true, "message": "Location request sent" }` and does not return
      * coordinates.
      *
+     * Rejected with `409` if the recipient is already sharing — read their location
+     * with `GET /v3/chats/{chatId}/location` instead of re-requesting.
+     *
+     * Rate limited per chat, since each request prompts the recipient's device.
+     * Exceeding it returns `429` with a `Retry-After` header.
+     *
      * Location requests only work in **1:1 iMessage chats** (Apple limitation):
      *
      * - Group chats (any service) return `409` with code `2016`

package/resources/chats/location.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"location.mjs","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,MAAM,WAAW,EAAE;YAC1D,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,MAAc,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF"}
+{"version":3,"file":"location.mjs","sourceRoot":"","sources":["../../src/resources/chats/location.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,MAAM,WAAW,EAAE;YAC1D,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAc,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,MAAM,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF"}

package/src/resources/chats/background.ts

@@ -83,17 +83,20 @@ export interface BackgroundSetParams {
    * fetched and re-hosted on our CDN before the request is accepted — the same way
    * `group_chat_icon` works. A URL we cannot fetch, or one that isn't an image, is
    * rejected with a `400` (`5007`/`5006`) rather than failing later on the device.
+   *
+   * Example: `https://cdn.linqapp.com/u/bg.jpg`.
    */
   image_url?: string;
 
   /**
-   * Color with `variant: custom`: the two gradient stops as hex, top then bottom.
-   * Ignored for named color variants (they carry their own two colors).
+   * Color with `variant: custom`: the two gradient stops as hex, top then bottom —
+   * e.g. `["#F2C4E1", "#F5A623"]`. Ignored for named color variants (they carry
+   * their own two colors).
    */
   shades?: Array<string>;
 
   /**
-   * Dynamic: the animated style.
+   * Dynamic: the animated style — `sky`, `water`, or `aurora`.
    */
   style?: 'sky' | 'water' | 'aurora';
 

package/src/resources/chats/location.ts

@@ -11,7 +11,7 @@ import { path } from '../../internal/utils/path';
  * and subscribe to webhooks when someone starts or stops sharing.
  *
  * **Coordinates** are returned in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format:
- * `[longitude, latitude]` or `[longitude, latitude, altitude]` if altitude is available.
+ * `[longitude, latitude]`.
  *
  * ### Reading location is poll-based
  *
@@ -57,6 +57,9 @@ export class Location extends APIResource {
    * separate feature for each participant who is sharing. Each feature's
    * `properties.handle` identifies the user.
    *
+   * A participant appears as soon as their first position arrives, typically within
+   * a second or two of sharing starting.
+   *
    * Returns an empty `data.features` array if no one is sharing or no location data
    * is available yet. If sharing started but this stays empty, see the **Location
    * Sharing** overview.
@@ -89,6 +92,12 @@ export class Location extends APIResource {
    * `{ "success": true, "message": "Location request sent" }` and does not return
    * coordinates.
    *
+   * Rejected with `409` if the recipient is already sharing — read their location
+   * with `GET /v3/chats/{chatId}/location` instead of re-requesting.
+   *
+   * Rate limited per chat, since each request prompts the recipient's device.
+   * Exceeding it returns `429` with a `Retry-After` header.
+   *
    * Location requests only work in **1:1 iMessage chats** (Apple limitation):
    *
    * - Group chats (any service) return `409` with code `2016`
@@ -134,7 +143,7 @@ export namespace GetChatLocationResponse {
     export namespace Feature {
       export interface Geometry {
         /**
-         * [longitude, latitude] or [longitude, latitude, altitude]
+         * [longitude, latitude]
          */
         coordinates: Array<number>;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.44.2'; // x-release-please-version
+export const VERSION = '0.45.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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