@linqapp/sdk 0.36.1 → 0.37.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.37.0](https://github.com/linq-team/linq-node/compare/v0.36.1...v0.37.0) (2026-08-13)
+
+
+### Features
+
+* add detailed 503 errors and response fields for capability checks ([eda6a4a](https://github.com/linq-team/linq-node/commit/eda6a4a70b0c488e0f9f802084e98c3f728e384f))
+
 ## [0.36.1](https://github.com/linq-team/linq-node/compare/v0.36.0...v0.36.1) (2026-08-12)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linqapp/sdk",
-  "version": "0.36.1",
+  "version": "0.37.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/capability.d.mts

@@ -21,6 +21,13 @@ export declare class Capability extends APIResource {
     /**
      * Check whether a recipient address (phone number) supports RCS messaging.
      *
+     * A `200` means the check ran and the answer is about the **recipient**. A `503`
+     * means the check could not produce an answer because of a fault on the **sender**
+     * line — `4004` (RCS not turned on for the line), `4009` (line has no RCS
+     * account), or `4010` (the check could not run). Treat all three as "unknown",
+     * never as "the recipient does not support RCS", and do not cache them as a
+     * negative result.
+     *
      * @example
      * ```ts
      * const handleCheckResponse =
@@ -51,6 +58,21 @@ export interface HandleCheckResponse {
      * Whether the recipient supports the checked messaging service
      */
     available: boolean;
+    /**
+     * Why `available` is `false`. Only present on a negative result.
+     *
+     * `not_supported` is the only value returned with a `200`, and it means the check
+     * completed and the recipient is genuinely not reachable over this service. On
+     * `check_rcs`, sender-side faults do not return `200` — they return `503` with a
+     * specific error code. `check_imessage` does not use this mapping.
+     */
+    reason?: 'not_supported';
+    /**
+     * The service that would actually carry a message to this address right now, which
+     * is not always the service you checked — a recipient without RCS resolves to
+     * `SMS`. Absent when the check could not determine one.
+     */
+    selected_service?: string;
 }
 export interface CapabilityCheckIMessageParams {
     /**

package/resources/capability.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.mts","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAE7D;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAI,EAAE,6BAA6B,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;IAIlC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAGpG;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}
+{"version":3,"file":"capability.d.mts","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAE7D;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAI,EAAE,6BAA6B,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;IAIlC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAGpG;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/capability.d.ts

@@ -21,6 +21,13 @@ export declare class Capability extends APIResource {
     /**
      * Check whether a recipient address (phone number) supports RCS messaging.
      *
+     * A `200` means the check ran and the answer is about the **recipient**. A `503`
+     * means the check could not produce an answer because of a fault on the **sender**
+     * line — `4004` (RCS not turned on for the line), `4009` (line has no RCS
+     * account), or `4010` (the check could not run). Treat all three as "unknown",
+     * never as "the recipient does not support RCS", and do not cache them as a
+     * negative result.
+     *
      * @example
      * ```ts
      * const handleCheckResponse =
@@ -51,6 +58,21 @@ export interface HandleCheckResponse {
      * Whether the recipient supports the checked messaging service
      */
     available: boolean;
+    /**
+     * Why `available` is `false`. Only present on a negative result.
+     *
+     * `not_supported` is the only value returned with a `200`, and it means the check
+     * completed and the recipient is genuinely not reachable over this service. On
+     * `check_rcs`, sender-side faults do not return `200` — they return `503` with a
+     * specific error code. `check_imessage` does not use this mapping.
+     */
+    reason?: 'not_supported';
+    /**
+     * The service that would actually carry a message to this address right now, which
+     * is not always the service you checked — a recipient without RCS resolves to
+     * `SMS`. Absent when the check could not determine one.
+     */
+    selected_service?: string;
 }
 export interface CapabilityCheckIMessageParams {
     /**

package/resources/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAE7D;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAI,EAAE,6BAA6B,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;IAIlC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAGpG;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAE7D;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAI,EAAE,6BAA6B,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;IAIlC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAGpG;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,WAAW,IAAI,WAAW,EAC/B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/capability.js

@@ -25,6 +25,13 @@ class Capability extends resource_1.APIResource {
     /**
      * Check whether a recipient address (phone number) supports RCS messaging.
      *
+     * A `200` means the check ran and the answer is about the **recipient**. A `503`
+     * means the check could not produce an answer because of a fault on the **sender**
+     * line — `4004` (RCS not turned on for the line), `4009` (line has no RCS
+     * account), or `4010` (the check could not run). Treat all three as "unknown",
+     * never as "the recipient does not support RCS", and do not cache them as a
+     * negative result.
+     *
      * @example
      * ```ts
      * const handleCheckResponse =

package/resources/capability.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C;;GAEG;AACH,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA8B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF;AAlCD,gCAkCC"}
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C;;GAEG;AACH,MAAa,UAAW,SAAQ,sBAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,IAA8B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF;AAzCD,gCAyCC"}

package/resources/capability.mjs

@@ -22,6 +22,13 @@ export class Capability extends APIResource {
     /**
      * Check whether a recipient address (phone number) supports RCS messaging.
      *
+     * A `200` means the check ran and the answer is about the **recipient**. A `503`
+     * means the check could not produce an answer because of a fault on the **sender**
+     * line — `4004` (RCS not turned on for the line), `4009` (line has no RCS
+     * account), or `4010` (the check could not run). Treat all three as "unknown",
+     * never as "the recipient does not support RCS", and do not cache them as a
+     * negative result.
+     *
      * @example
      * ```ts
      * const handleCheckResponse =

package/resources/capability.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capability.mjs","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA8B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF"}
+{"version":3,"file":"capability.mjs","sourceRoot":"","sources":["../src/resources/capability.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,IAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,IAA8B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/src/resources/capability.ts

@@ -30,6 +30,13 @@ export class Capability extends APIResource {
   /**
    * Check whether a recipient address (phone number) supports RCS messaging.
    *
+   * A `200` means the check ran and the answer is about the **recipient**. A `503`
+   * means the check could not produce an answer because of a fault on the **sender**
+   * line — `4004` (RCS not turned on for the line), `4009` (line has no RCS
+   * account), or `4010` (the check could not run). Treat all three as "unknown",
+   * never as "the recipient does not support RCS", and do not cache them as a
+   * negative result.
+   *
    * @example
    * ```ts
    * const handleCheckResponse =
@@ -66,6 +73,23 @@ export interface HandleCheckResponse {
    * Whether the recipient supports the checked messaging service
    */
   available: boolean;
+
+  /**
+   * Why `available` is `false`. Only present on a negative result.
+   *
+   * `not_supported` is the only value returned with a `200`, and it means the check
+   * completed and the recipient is genuinely not reachable over this service. On
+   * `check_rcs`, sender-side faults do not return `200` — they return `503` with a
+   * specific error code. `check_imessage` does not use this mapping.
+   */
+  reason?: 'not_supported';
+
+  /**
+   * The service that would actually carry a message to this address right now, which
+   * is not always the service you checked — a recipient without RCS resolves to
+   * `SMS`. Absent when the check could not determine one.
+   */
+  selected_service?: string;
 }
 
 export interface CapabilityCheckIMessageParams {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.36.1'; // x-release-please-version
+export const VERSION = '0.37.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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