@lumavox/server 0.2.1 → 0.4.0

package/dist/upload.d.ts

@@ -6,9 +6,11 @@
  *
  * - **The `PUT` carries no credential** — the URL is signed — and exactly
  *   the `Content-Type` the ticket was asked for, which is signed into it.
- * - **Its timer is the ticket's lifetime** unless the caller sets one: the
- *   URL is refused after it anyway, and a large file on a slow link is not
- *   a call that timed out at the client's 30 s — and then sent twice more.
+ * - **Its timer runs to the ticket's `expires_at`** unless the caller sets
+ *   one: the URL is refused after it anyway, and a large file on a slow
+ *   link is not a call that timed out at the client's 30 s — and then sent
+ *   twice more. A minute at least: the instant is the API's clock, and a
+ *   machine whose clock runs ahead would otherwise time out at once.
  * - **A Blob, an ArrayBuffer or a typed array; a stream only with its
  *   `size`**: a signed `PUT` needs `Content-Length`, which a stream cannot
  *   say. On Workers the stream goes through `FixedLengthStream`, which is
@@ -30,8 +32,8 @@ export declare const sizeOf: (data: UploadData, size?: number) => number | undef
 export declare const typeOf: (data: UploadData, type?: string | null) => string;
 /** `type`, or a `TypeError` naming what to pass. */
 export declare function needType(data: UploadData, type?: string | null): string;
-/** The bytes, to a ticket's signed URL, valid for its `expires_in` seconds. */
+/** The bytes, to a ticket's signed URL, valid until its `expires_at`. */
 export declare function put(api: Transport, ticket: {
     url: string;
-    expires_in: number;
+    expires_at: string;
 }, data: UploadData, type: string, options: UploadOptions): Promise<void>;

package/dist/upload.js

@@ -14,7 +14,9 @@ export function needType(data, type) {
         throw new TypeError("This upload needs its content_type.");
     return found;
 }
-/** The bytes, to a ticket's signed URL, valid for its `expires_in` seconds. */
+/** The least time a `PUT` is given, whatever the ticket's clock says. */
+const MIN_PUT_MS = 60_000;
+/** The bytes, to a ticket's signed URL, valid until its `expires_at`. */
 export async function put(api, ticket, data, type, options) {
     let raw = data;
     const headers = {};
@@ -30,5 +32,9 @@ export async function put(api, ticket, data, type, options) {
         if (Fixed)
             raw = data.pipeThrough(new Fixed(size));
     }
-    await api.request({ method: "PUT", path: ticket.url, raw, type, headers, open: true }, { ...options, timeoutMs: options.timeoutMs ?? ticket.expires_in * 1000 });
+    await api.request({ method: "PUT", path: ticket.url, raw, type, headers, open: true }, {
+        ...options,
+        timeoutMs: options.timeoutMs ??
+            Math.max(Date.parse(ticket.expires_at) - Date.now(), MIN_PUT_MS),
+    });
 }

package/dist/wait.d.ts

@@ -6,9 +6,9 @@
  *
  * - **One set of in-progress states for every kind**: a generation is
  *   `queued`, `submitted` or `running`, the rest `pending`, and a
- *   knowledge file or page `importing` before that — which the document
- *   does not list (left-overs #113; `STATUSES` in
- *   `apps/api/src/knowledge/service.ts`). Anything else — `succeeded`,
+ *   knowledge file or page `importing` before that (`STATUSES` in
+ *   `apps/api/src/knowledge/service.ts`), which the document lists only
+ *   since api 0.31.10. Anything else — `succeeded`,
  *   `failed`, `moderated`, `ready`, or a state this release does not know
  *   — ends the wait, so a new one cannot hang a caller.
  * - **It answers the last read, never throws for a failure**: a `failed`
@@ -27,13 +27,9 @@
  *   the root `CLAUDE.md`; in their first second, 250 are.
  */
 import { type RequestOptions } from "./transport.js";
-/**
- * A job as each kind's read answers it: with a `status` — which the
- * document lets an asset and an entry leave out (it has a default), and
- * which, absent, is no work in progress.
- */
+/** A job as each kind's read answers it: with its `status`. */
 export interface Job {
-    status?: string;
+    status: string;
 }
 /**
  * Reads `read` until its status is final, starting from `first` (a job

package/dist/wait.js

@@ -6,9 +6,9 @@
  *
  * - **One set of in-progress states for every kind**: a generation is
  *   `queued`, `submitted` or `running`, the rest `pending`, and a
- *   knowledge file or page `importing` before that — which the document
- *   does not list (left-overs #113; `STATUSES` in
- *   `apps/api/src/knowledge/service.ts`). Anything else — `succeeded`,
+ *   knowledge file or page `importing` before that (`STATUSES` in
+ *   `apps/api/src/knowledge/service.ts`), which the document lists only
+ *   since api 0.31.10. Anything else — `succeeded`,
  *   `failed`, `moderated`, `ready`, or a state this release does not know
  *   — ends the wait, so a new one cannot hang a caller.
  * - **It answers the last read, never throws for a failure**: a `failed`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumavox/server",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "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",