@lumavox/server 0.2.1 → 0.2.2

package/dist/errors.js

@@ -17,7 +17,8 @@ export class PlatformError extends Error {
     // Written out, not `new.target.name`: a customer's minifier renames classes.
     name = "PlatformError";
     constructor(init) {
-        super(init.message, init.cause === undefined ? {} : { cause: init.cause });
+        // `init` is the options too: `Error` reads only its `cause`.
+        super(init.message, init);
         this.status = init.status;
         this.type = init.type;
         this.requestId = init.requestId;

package/dist/transport.d.ts

@@ -49,9 +49,13 @@ export interface Answer<T> {
 }
 /** The longest `Retry-After` slept through; past it the 429 is thrown. */
 export declare const MAX_RETRY_AFTER_S = 60;
-/** A path parameter, encoded: an `external_id` may hold `/` or `?`. */
-export declare const segment: (value: string) => string;
-/** A request id of the API's own shape: 16 hex. */
+/** A path parameter or a query's value, encoded: an `external_id` may hold `/` or `?`. */
+export declare const segment: (value: string | number | boolean) => string;
+/**
+ * A request id of the API's own shape: 16 hex. From `Math.random`, not
+ * `crypto`, which React Native lacks (this file is the client SDK's too):
+ * an id names a call in the logs and is no secret.
+ */
 export declare const newRequestId: () => string;
 /**
  * How long to wait before retry `attempt` (1, 2, …): the doubling backoff

package/dist/transport.js

@@ -26,6 +26,10 @@
  *   wins, up to a minute. A longer one is thrown at once as a
  *   `RateLimitError` with its `retryAfter`: a call that sleeps for an hour
  *   is not one a caller can reason about.
+ * - **The client SDK runs this file too** (`sdks/client/src/transport.ts`,
+ *   a copy its `test/copies.test.ts` holds identical), on React Native's
+ *   Hermes as well: so no `crypto`, `URLSearchParams`, `AbortSignal.any`
+ *   or global `ReadableStream` taken for granted, each of which it lacks.
  */
 import { ConnectionError, errorFromResponse, NotFoundError, PlatformError, TimeoutError, } from "./errors.js";
 const RETRIED_STATUS = new Set([429, 502, 503, 504]);
@@ -33,10 +37,14 @@ const BASE_DELAY_MS = 500;
 const MAX_DELAY_MS = 8_000;
 /** The longest `Retry-After` slept through; past it the 429 is thrown. */
 export const MAX_RETRY_AFTER_S = 60;
-/** A path parameter, encoded: an `external_id` may hold `/` or `?`. */
+/** A path parameter or a query's value, encoded: an `external_id` may hold `/` or `?`. */
 export const segment = (value) => encodeURIComponent(value);
-/** A request id of the API's own shape: 16 hex. */
-export const newRequestId = () => crypto.randomUUID().replaceAll("-", "").slice(0, 16);
+/**
+ * A request id of the API's own shape: 16 hex. From `Math.random`, not
+ * `crypto`, which React Native lacks (this file is the client SDK's too):
+ * an id names a call in the logs and is no secret.
+ */
+export const newRequestId = () => "x".repeat(16).replace(/x/g, () => ((Math.random() * 16) | 0).toString(16));
 /**
  * How long to wait before retry `attempt` (1, 2, …): the doubling backoff
  * less up to a quarter, or `Retry-After`'s seconds when the API sent one.
@@ -101,7 +109,8 @@ export class Transport {
     }
     async request(call, options = {}) {
         const requestId = options.requestId ?? newRequestId();
-        const once = call.raw instanceof ReadableStream;
+        // A stream by its shape: not every runtime has a global `ReadableStream`.
+        const once = "getReader" in Object(call.raw);
         const maxRetries = once
             ? 0
             : (options.maxRetries ?? this.config.maxRetries);
@@ -170,27 +179,37 @@ export class Transport {
         }
     }
     url(call) {
-        const params = new URLSearchParams();
+        // By hand: React Native's `URLSearchParams` is partial.
+        let query = "";
         for (const [key, value] of Object.entries(call.query ?? {})) {
-            if (value !== undefined && value !== null)
-                params.set(key, String(value));
+            if (value != null) {
+                query += `${query ? "&" : "?"}${key}=${segment(value)}`;
+            }
         }
-        const query = params.toString();
         const base = /^https?:/.test(call.path) ? "" : this.config.baseUrl;
-        return `${base}${call.path}${query ? `?${query}` : ""}`;
+        return base + call.path + query;
     }
     /**
      * One send and its body read, under this attempt's timer — which stops
      * at the headers of a stream the caller reads (and of nothing else).
      */
     async attempt(url, init, read, options) {
+        // The caller's signal joined to the timer by hand, its reason carried
+        // over: `AbortSignal.any` is not React Native's. Left joined for a
+        // stream, whose body the caller's abort still ends.
+        const { signal } = options;
         const timer = new AbortController();
-        const clock = setTimeout(() => timer.abort(), options.timeoutMs ?? this.config.timeoutMs);
-        const signal = options.signal
-            ? AbortSignal.any([options.signal, timer.signal])
-            : timer.signal;
+        const stop = () => timer.abort(signal?.reason);
+        const clock = setTimeout(stop, options.timeoutMs ?? this.config.timeoutMs);
+        signal?.addEventListener("abort", stop);
+        // Already aborted: no event will come, and `fetch` sends nothing.
+        if (signal?.aborted)
+            stop();
         try {
-            const response = await this.config.fetch(url, { ...init, signal });
+            const response = await this.config.fetch(url, {
+                ...init,
+                signal: timer.signal,
+            });
             const body = !response.ok
                 ? await response.text()
                 : read === "stream"
@@ -202,14 +221,16 @@ export class Transport {
         }
         catch (error) {
             // The caller's abort is the caller's, whatever else happened.
-            if (options.signal?.aborted)
-                throw options.signal.reason;
+            if (signal?.aborted)
+                throw signal.reason;
             if (timer.signal.aborted)
                 return { kind: "timeout" };
             return { kind: "network", error };
         }
         finally {
             clearTimeout(clock);
+            if (read !== "stream")
+                signal?.removeEventListener("abort", stop);
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumavox/server",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "The Lumavox API from your server: end users, ephemeral keys and the rest, typed from the published OpenAPI document. Zero dependencies.",
   "license": "MIT",
   "type": "module",