@isnap/sdk 1.1.0-next.83 → 1.1.0-next.85

package/dist/resources/lookup.d.ts

@@ -6,9 +6,28 @@ export type LookupResult = components['schemas']['Lookup'];
 export declare class LookupResource extends BaseResource {
     /**
      * `POST /v1/lookup` — check whether a handle is reachable on iMessage.
-     * Synchronous: returns `imessage: true | false | null`. `null` means
-     * the iMessage status is unknown and the handle should be treated as
-     * SMS-safe (degrade to SMS instead of relying on iMessage delivery).
+     *
+     * Two outcomes. The client returns the envelope's `data` and does not
+     * surface the HTTP status, so branch on `pending` — the in-band signal:
+     *
+     * - **Terminal (`200`)** — `imessage: true | false | null`, and `pending`
+     *   is absent. `null` means the iMessage status is unknown and the handle
+     *   should be treated as SMS-safe (degrade to SMS instead of relying on
+     *   iMessage delivery).
+     * - **Pending (`202`)** — a device probe was dispatched but had not
+     *   answered within the wait budget. `pending: true`, `imessage: null`,
+     *   plus `probe_id` and `retry_after` (seconds).
+     *
+     * Completion is poll-only — there is no `lookup.completed` webhook.
+     * Re-issue the same request after `retry_after`; the shared cache the
+     * probe warms answers `200`.
+     *
+     * ```ts
+     * const result = await client.lookup.check({ handle })
+     * if (result.pending) {
+     *   setTimeout(retry, (result.retry_after ?? 1) * 1000)
+     * }
+     * ```
      */
     check(params: LookupRequest, opts?: RequestOptions): Promise<LookupResult>;
 }

package/dist/resources/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/resources/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAA;AAClE,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAA;AAE1D,qBAAa,cAAe,SAAQ,YAAY;IAC9C;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAG3E"}
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/resources/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAA;AAClE,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAA;AAE1D,qBAAa,cAAe,SAAQ,YAAY;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAG3E"}

package/dist/resources/lookup.js

@@ -2,9 +2,28 @@ import { BaseResource } from './base.js';
 export class LookupResource extends BaseResource {
     /**
      * `POST /v1/lookup` — check whether a handle is reachable on iMessage.
-     * Synchronous: returns `imessage: true | false | null`. `null` means
-     * the iMessage status is unknown and the handle should be treated as
-     * SMS-safe (degrade to SMS instead of relying on iMessage delivery).
+     *
+     * Two outcomes. The client returns the envelope's `data` and does not
+     * surface the HTTP status, so branch on `pending` — the in-band signal:
+     *
+     * - **Terminal (`200`)** — `imessage: true | false | null`, and `pending`
+     *   is absent. `null` means the iMessage status is unknown and the handle
+     *   should be treated as SMS-safe (degrade to SMS instead of relying on
+     *   iMessage delivery).
+     * - **Pending (`202`)** — a device probe was dispatched but had not
+     *   answered within the wait budget. `pending: true`, `imessage: null`,
+     *   plus `probe_id` and `retry_after` (seconds).
+     *
+     * Completion is poll-only — there is no `lookup.completed` webhook.
+     * Re-issue the same request after `retry_after`; the shared cache the
+     * probe warms answers `200`.
+     *
+     * ```ts
+     * const result = await client.lookup.check({ handle })
+     * if (result.pending) {
+     *   setTimeout(retry, (result.retry_after ?? 1) * 1000)
+     * }
+     * ```
      */
     check(params, opts) {
         return this.client.request('POST', '/v1/lookup', params, opts);

package/dist/resources/lookup.js.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/resources/lookup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAKxC,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC9C;;;;;OAKG;IACH,KAAK,CAAC,MAAqB,EAAE,IAAqB;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAe,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;IAC9E,CAAC;CACF"}
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/resources/lookup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAKxC,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,MAAqB,EAAE,IAAqB;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAe,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;IAC9E,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isnap/sdk",
-  "version": "1.1.0-next.83",
+  "version": "1.1.0-next.85",
   "description": "Official TypeScript SDK for the iSnap P2P telephony API",
   "license": "MIT",
   "type": "module",
@@ -45,7 +45,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "generate": "openapi-typescript ../backend/openapi.json -o src/generated/openapi.d.ts",
-    "prepublishOnly": "bun run lint && bun run typecheck && bun run test && bun run build"
+    "verify:generated": "bun scripts/verify-generated.ts",
+    "prepublishOnly": "bun run verify:generated && bun run lint && bun run typecheck && bun run test && bun run build"
   },
   "engines": {
     "node": ">=20"