@columenlabs/lumen-ui 0.1.126 → 0.1.128

package/dist/api-fetch.d.ts

@@ -5,5 +5,18 @@ export declare class ApiError extends Error {
     readonly code?: string;
     constructor(message: string, method: string, url: string, status: number, code?: string);
 }
-/** A JSON request; `where` names the caller in the error log (`assistant.undo`, `workspace.read`). */
-export declare function apiJson<T>(url: string, init?: RequestInit, where?: string): Promise<T>;
+/**
+ * How long a request waits for the server before it fails as unreachable, so a page never waits
+ * forever: reads give up sooner than writes, which may be doing slow work the person asked for.
+ */
+export declare const API_TIMEOUT_MS: {
+    read: number;
+    write: number;
+};
+/**
+ * A JSON request; `where` names the caller in the error log (`assistant.undo`, `workspace.read`).
+ * It gives up after `API_TIMEOUT_MS` (or `timeoutMs`); a caller's own `signal` still aborts it.
+ */
+export declare function apiJson<T>(url: string, init?: RequestInit & {
+    timeoutMs?: number;
+}, where?: string): Promise<T>;

package/dist/api-fetch.js

@@ -22,13 +22,24 @@ export class ApiError extends Error {
         this.code = code;
     }
 }
-/** A JSON request; `where` names the caller in the error log (`assistant.undo`, `workspace.read`). */
+/**
+ * How long a request waits for the server before it fails as unreachable, so a page never waits
+ * forever: reads give up sooner than writes, which may be doing slow work the person asked for.
+ */
+export const API_TIMEOUT_MS = { read: 15_000, write: 60_000 };
+/**
+ * A JSON request; `where` names the caller in the error log (`assistant.undo`, `workspace.read`).
+ * It gives up after `API_TIMEOUT_MS` (or `timeoutMs`); a caller's own `signal` still aborts it.
+ */
 export async function apiJson(url, init = {}, where = 'api') {
     const method = (init.method ?? 'GET').toUpperCase();
+    const { timeoutMs, ...rest } = init;
+    const timeout = AbortSignal.timeout(timeoutMs ?? (method === 'GET' ? API_TIMEOUT_MS.read : API_TIMEOUT_MS.write));
     let res;
     try {
         res = await fetch(url, {
-            ...init,
+            ...rest,
+            signal: init.signal ? AbortSignal.any([init.signal, timeout]) : timeout,
             headers: {
                 accept: 'application/json',
                 ...(init.body ? { 'content-type': 'application/json' } : {}),
@@ -37,9 +48,12 @@ export async function apiJson(url, init = {}, where = 'api') {
         });
     }
     catch (err) {
-        if (err.name === 'AbortError')
+        // The caller's own abort is theirs to handle; running out of time is a failure like no network.
+        if (err.name === 'AbortError' && !timeout.aborted)
             throw err;
-        const e = new ApiError(`Couldn't reach the server (${method} ${url})`, method, url, 0);
+        const e = new ApiError(timeout.aborted
+            ? `The server didn't answer in time (${method} ${url})`
+            : `Couldn't reach the server (${method} ${url})`, method, url, 0);
         reportError(e, 'shown', where);
         reportFailedFetch(apiRoute(url), 0);
         throw e;

package/dist/index.d.ts

@@ -75,7 +75,7 @@ export { type TasksConfig, TasksButton, TasksProvider, useTaskFor, useTasks } fr
 export { type McpServer, McpSettings } from './mcp-settings.js';
 export { lumenToast } from './lumen-toast.js';
 export { LumenShell, type LumenShellProps, type ShellUser, StatusItem, firstName, initials, maskAmount, useAmountsHidden, useApp, useShell, } from './shell.js';
-export { apiJson } from './api-fetch.js';
+export { API_TIMEOUT_MS, apiJson } from './api-fetch.js';
 export { savedAnswers, type SavedAnswersOptions, type SavedAnswersPersister, } from './saved-answers.js';
 export { cn } from './lib/utils.js';
 export { type HealthProbe, StatusHealth } from './status-health.js';

package/dist/index.js

@@ -82,7 +82,7 @@ export { TasksButton, TasksProvider, useTaskFor, useTasks } from './tasks.js';
 export { McpSettings } from './mcp-settings.js';
 export { lumenToast } from './lumen-toast.js';
 export { LumenShell, StatusItem, firstName, initials, maskAmount, useAmountsHidden, useApp, useShell, } from './shell.js';
-export { apiJson } from './api-fetch.js';
+export { API_TIMEOUT_MS, apiJson } from './api-fetch.js';
 export { savedAnswers, } from './saved-answers.js';
 export { cn } from './lib/utils.js';
 export { StatusHealth } from './status-health.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ui",
-  "version": "0.1.126",
+  "version": "0.1.128",
   "description": "Lumen: shared React components (frame, views, widgets, charts, drawers).",
   "license": "MIT",
   "type": "module",
@@ -49,7 +49,7 @@
     "@codemirror/lang-javascript": "6.2.5",
     "@codemirror/lang-json": "6.0.2",
     "@codemirror/lang-sql": "6.10.0",
-    "@columenlabs/lumen-ui-types": "0.1.126",
+    "@columenlabs/lumen-ui-types": "0.1.128",
     "@dnd-kit/core": "6.3.1",
     "@dnd-kit/sortable": "10.0.0",
     "@dnd-kit/utilities": "3.2.2",