@kelpie/ui 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @kelpie/ui
+
+The React UI for [Kelpie](https://github.com/velvet-tiger/kelpie).
+
+Kelpie is an open-source, agent-native CRM and company brain. This package holds the components, the pages, the typed API client, and the extension registry that an assembly composes modules through. It talks to the same public API agents use; there are no private UI-only endpoints.
+
+## Install
+
+```bash
+npm install @kelpie/ui react react-dom
+```
+
+React 19 is a peer dependency, so it resolves to your copy rather than a second one.
+
+## Use
+
+```tsx
+import { KelpieApp, registerUiModules } from '@kelpie/ui'
+import '@kelpie/ui/styles.css'
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+
+import { uiModules } from './kelpie.ui.config.ts'
+
+createRoot(document.getElementById('root')).render(
+  <StrictMode>
+    <KelpieApp extensions={registerUiModules(uiModules)} />
+  </StrictMode>,
+)
+```
+
+Registration happens once, above the root, at build time. A module clashing with another fails at startup rather than as a tab someone notices is missing a week later.
+
+## Styling
+
+`@kelpie/ui/styles.css` imports Tailwind CSS 4 and declares the theme tokens every component uses. Your build needs to process it with Tailwind, for example through `@tailwindcss/vite`.
+
+The stylesheet carries an `@source` directive pointing at the components beside it, which is how Tailwind finds the classes they name. Tailwind skips `node_modules` when it detects sources by itself, so that directive is doing real work. If it ever stops, the build still succeeds and every page renders unstyled.
+
+Colours are tokens rather than literals, so light and dark are the same markup against a different `:root` block, and a module replacing a component inherits the palette.
+
+## Licence
+
+AGPL-3.0-only.

package/dist/ServiceStatus.d.ts

@@ -0,0 +1,6 @@
+export interface ServiceStatusProps {
+    /** Path or URL of the service health endpoint. */
+    readonly healthUrl: string;
+}
+export declare function ServiceStatus({ healthUrl }: ServiceStatusProps): React.JSX.Element;
+//# sourceMappingURL=ServiceStatus.d.ts.map

package/dist/ServiceStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceStatus.d.ts","sourceRoot":"","sources":["../src/ServiceStatus.tsx"],"names":[],"mappings":"AAeA,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6BlF"}

package/dist/ServiceStatus.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { fetchServiceHealth } from './api/health.js';
+export function ServiceStatus({ healthUrl }) {
+    const [state, setState] = useState({ kind: 'loading' });
+    useEffect(() => {
+        let active = true;
+        fetchServiceHealth({ url: healthUrl })
+            .then((health) => {
+            if (active) {
+                setState({ kind: 'loaded', health });
+            }
+        })
+            .catch((error) => {
+            if (active) {
+                setState({ kind: 'unreachable', reason: error instanceof Error ? error.message : String(error) });
+            }
+        });
+        return () => {
+            active = false;
+        };
+    }, [healthUrl]);
+    return (_jsxs("main", { className: "mx-auto flex min-h-screen max-w-xl flex-col justify-center gap-3 px-6", children: [_jsx("h1", { className: "text-2xl font-semibold", children: "Kelpie" }), _jsx("p", { className: "text-sm text-gray-600", children: describe(state) })] }));
+}
+function describe(state) {
+    switch (state.kind) {
+        case 'loading':
+            return 'Checking the service…';
+        case 'loaded':
+            return `Service ${state.health.status}, database ${state.health.database}.`;
+        case 'unreachable':
+            return `Service unreachable: ${state.reason}`;
+    }
+}
+//# sourceMappingURL=ServiceStatus.js.map

package/dist/ServiceStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceStatus.js","sourceRoot":"","sources":["../src/ServiceStatus.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAkBpD,MAAM,UAAU,aAAa,CAAC,EAAE,SAAS,EAAsB;IAC7D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAc,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAEpE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,GAAG,IAAI,CAAA;QAEjB,kBAAkB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;aACnC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;YACtC,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACnG,CAAC;QACH,CAAC,CAAC,CAAA;QAEJ,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAA;QAChB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAEf,OAAO,CACL,gBAAM,SAAS,EAAC,uEAAuE,aACrF,aAAI,SAAS,EAAC,wBAAwB,uBAAY,EAClD,YAAG,SAAS,EAAC,uBAAuB,YAAE,QAAQ,CAAC,KAAK,CAAC,GAAK,IACrD,CACR,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAkB;IAClC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,uBAAuB,CAAA;QAChC,KAAK,QAAQ;YACX,OAAO,WAAW,KAAK,CAAC,MAAM,CAAC,MAAM,cAAc,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAA;QAC7E,KAAK,aAAa;YAChB,OAAO,wBAAwB,KAAK,CAAC,MAAM,EAAE,CAAA;IACjD,CAAC;AACH,CAAC"}

package/dist/api/ApiProvider.d.ts

@@ -0,0 +1,19 @@
+import type { QueryClient } from '@tanstack/react-query';
+import type { ReactNode } from 'react';
+import type { ApiClient } from './client.ts';
+export interface ApiProviderProps {
+    /** Origin plus base path, e.g. `/v1` in the browser. */
+    readonly baseUrl?: string;
+    /** A prepared client, for tests and for assemblies that construct their own. */
+    readonly client?: ApiClient;
+    readonly queryClient?: QueryClient;
+    readonly children: ReactNode;
+}
+/**
+ * Puts an API client and a query cache in reach of the tree below it.
+ *
+ * Both are held in state rather than built inline, because a fresh
+ * `QueryClient` on every render throws the cache away on every render.
+ */
+export declare function ApiProvider({ baseUrl, client, queryClient, children, }: ApiProviderProps): React.JSX.Element;
+//# sourceMappingURL=ApiProvider.d.ts.map

package/dist/api/ApiProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiProvider.d.ts","sourceRoot":"","sources":["../../src/api/ApiProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAe,EACf,MAAM,EACN,WAAW,EACX,QAAQ,GACT,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAStC"}

package/dist/api/ApiProvider.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { QueryClientProvider } from '@tanstack/react-query';
+import { useState } from 'react';
+import { createApiClient } from './client.js';
+import { ApiClientContext } from './context.js';
+import { createQueryClient } from './queryClient.js';
+/**
+ * Puts an API client and a query cache in reach of the tree below it.
+ *
+ * Both are held in state rather than built inline, because a fresh
+ * `QueryClient` on every render throws the cache away on every render.
+ */
+export function ApiProvider({ baseUrl = '/v1', client, queryClient, children, }) {
+    const [resolvedClient] = useState(() => client ?? createApiClient({ baseUrl }));
+    const [resolvedQueryClient] = useState(() => queryClient ?? createQueryClient());
+    return (_jsx(QueryClientProvider, { client: resolvedQueryClient, children: _jsx(ApiClientContext, { value: resolvedClient, children: children }) }));
+}
+//# sourceMappingURL=ApiProvider.js.map

package/dist/api/ApiProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiProvider.js","sourceRoot":"","sources":["../../src/api/ApiProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGhC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAWpD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,OAAO,GAAG,KAAK,EACf,MAAM,EACN,WAAW,EACX,QAAQ,GACS;IACjB,MAAM,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAY,GAAG,EAAE,CAAC,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IAC1F,MAAM,CAAC,mBAAmB,CAAC,GAAG,QAAQ,CAAc,GAAG,EAAE,CAAC,WAAW,IAAI,iBAAiB,EAAE,CAAC,CAAA;IAE7F,OAAO,CACL,KAAC,mBAAmB,IAAC,MAAM,EAAE,mBAAmB,YAC9C,KAAC,gBAAgB,IAAC,KAAK,EAAE,cAAc,YAAG,QAAQ,GAAoB,GAClD,CACvB,CAAA;AACH,CAAC"}

package/dist/api/client.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Client for the public `/v1` API. The UI is one more API consumer, exactly like
+ * an agent, so this file encodes only what `api.md` documents: the list envelope,
+ * the error shape, and the write verbs.
+ *
+ * Responses are untrusted input. Every method takes a `Decoder` and returns what
+ * the decoder produced, so nothing is asserted into a type it was not checked
+ * against.
+ *
+ * Roadmap decision 8: decoders come from Zod. A schema's `.parse` already matches
+ * `Decoder`, so pass `personSchema.parse` and nothing in this file changes. Do
+ * not hand-write a decoder for a new resource.
+ *
+ * Response schemas cannot live in `@kelpie/server`: importing it here would drag
+ * Drizzle, postgres.js, and Node built-ins into the browser bundle. They belong
+ * in a package that depends on nothing but Zod.
+ */
+export type Decoder<T> = (value: unknown) => T;
+export interface ErrorDetail {
+    readonly field: string;
+    readonly message: string;
+}
+/** A `{ error: … }` response rendered as a throwable. */
+export declare class ApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details: readonly ErrorDetail[];
+    constructor(status: number, code: string, message: string, details?: readonly ErrorDetail[]);
+}
+/** A cursor page: `{ data, next_cursor }` from `api.md`. */
+export interface Page<T> {
+    readonly items: readonly T[];
+    readonly nextCursor: string | null;
+}
+/**
+ * Query string values. An array becomes a repeated parameter, which is how
+ * `api.md` names a set of ids: `?person_id=per_1&person_id=per_2`.
+ */
+export type QueryParameters = Readonly<Record<string, string | number | boolean | readonly string[] | undefined>>;
+export interface ApiClientOptions {
+    /** Origin plus base path, e.g. `/v1` in the browser or `http://localhost:3000/v1` in tests. */
+    readonly baseUrl: string;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export interface ApiClient {
+    get<T>(path: string, decode: Decoder<T>, query?: QueryParameters): Promise<T>;
+    /**
+     * A `GET` answering something other than JSON. CSV export is the case: the
+     * response is a file, and there is nothing to decode.
+     */
+    getText(path: string): Promise<string>;
+    list<T>(path: string, decodeItem: Decoder<T>, query?: QueryParameters): Promise<Page<T>>;
+    post<T>(path: string, body: unknown, decode: Decoder<T>): Promise<T>;
+    /**
+     * A `POST` carrying a file. Creating an import job is the case: base64 in a
+     * JSON body would spend a third of the ten megabyte limit on encoding.
+     *
+     * The body sets its own `Content-Type` with the multipart boundary in it, so
+     * unlike `post` this must not name one.
+     */
+    postForm<T>(path: string, form: FormData, decode: Decoder<T>): Promise<T>;
+    /**
+     * A `POST` whose success carries no body. `api.md` has resource writes return
+     * the resulting object, but the session endpoints have nothing to return:
+     * logout answers `204`, and a password reset request answers `202`.
+     */
+    postEmpty(path: string, body?: unknown): Promise<void>;
+    patch<T>(path: string, body: unknown, decode: Decoder<T>): Promise<T>;
+    /**
+     * A `PATCH` whose success carries no body. Changing a password is the case:
+     * it answers `204` because the one thing it changed is the one thing the API
+     * will not hand back.
+     */
+    patchEmpty(path: string, body: unknown): Promise<void>;
+    /**
+     * `query` is for a delete that takes a confirmation, which
+     * `DELETE /v1/workspaces/:id?slug=` is. A `DELETE` body would be the other
+     * option, and HTTP lets a client drop one.
+     */
+    delete(path: string, query?: QueryParameters): Promise<void>;
+}
+export declare function createApiClient(options: ApiClientOptions): ApiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,yDAAyD;AACzD,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IAExC,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,WAAW,EAAO,EAM9F;CACF;AAED,4DAA4D;AAC5D,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAC1E,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACzC;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC7E;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IACxF,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACpE;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACzE;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACrE;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7D;AA+DD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAyGpE"}

package/dist/api/client.js

@@ -0,0 +1,162 @@
+/**
+ * Client for the public `/v1` API. The UI is one more API consumer, exactly like
+ * an agent, so this file encodes only what `api.md` documents: the list envelope,
+ * the error shape, and the write verbs.
+ *
+ * Responses are untrusted input. Every method takes a `Decoder` and returns what
+ * the decoder produced, so nothing is asserted into a type it was not checked
+ * against.
+ *
+ * Roadmap decision 8: decoders come from Zod. A schema's `.parse` already matches
+ * `Decoder`, so pass `personSchema.parse` and nothing in this file changes. Do
+ * not hand-write a decoder for a new resource.
+ *
+ * Response schemas cannot live in `@kelpie/server`: importing it here would drag
+ * Drizzle, postgres.js, and Node built-ins into the browser bundle. They belong
+ * in a package that depends on nothing but Zod.
+ */
+import { isRecord } from './json.js';
+/** A `{ error: … }` response rendered as a throwable. */
+export class ApiError extends Error {
+    code;
+    status;
+    details;
+    constructor(status, code, message, details = []) {
+        super(message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+    }
+}
+function isErrorDetail(value) {
+    return isRecord(value) && typeof value.field === 'string' && typeof value.message === 'string';
+}
+function buildUrl(baseUrl, path, query) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(query ?? {})) {
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            // append, not set: every id has to survive into the query string.
+            for (const item of value) {
+                search.append(key, item);
+            }
+        }
+        else {
+            search.set(key, String(value));
+        }
+    }
+    const queryString = search.toString();
+    return queryString.length > 0 ? `${baseUrl}${path}?${queryString}` : `${baseUrl}${path}`;
+}
+/**
+ * Turns a failed response into an `ApiError`. A body that does not match the
+ * documented error shape still produces an error carrying the HTTP status,
+ * because the alternative is a rejected promise with no cause.
+ */
+function readErrorBody(status, payload) {
+    const unreadable = new ApiError(status, 'internal_error', `Unreadable error response (HTTP ${status})`);
+    if (!isRecord(payload) || !isRecord(payload.error)) {
+        return unreadable;
+    }
+    const { code, message, details } = payload.error;
+    if (typeof code !== 'string' || typeof message !== 'string') {
+        return unreadable;
+    }
+    return new ApiError(status, code, message, Array.isArray(details) ? details.filter(isErrorDetail) : []);
+}
+function readPage(payload, decodeItem) {
+    if (!isRecord(payload) || !Array.isArray(payload.data)) {
+        throw new TypeError('Expected a list envelope with a "data" array');
+    }
+    const nextCursor = payload.next_cursor;
+    if (nextCursor !== null && typeof nextCursor !== 'string') {
+        throw new TypeError('Expected "next_cursor" to be a string or null');
+    }
+    return { items: payload.data.map((item) => decodeItem(item)), nextCursor };
+}
+export function createApiClient(options) {
+    const doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+    function headersFor(body) {
+        return body === undefined
+            ? { Accept: 'application/json' }
+            : { Accept: 'application/json', 'Content-Type': 'application/json' };
+    }
+    function request(method, url, body) {
+        return doFetch(url, {
+            method,
+            credentials: 'same-origin',
+            headers: headersFor(body),
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+    }
+    /** Reads a JSON response, converting any non-2xx into an `ApiError`. */
+    async function readJson(response) {
+        const payload = await response.json();
+        if (!response.ok) {
+            throw readErrorBody(response.status, payload);
+        }
+        return payload;
+    }
+    async function send(method, url, decode, body) {
+        return decode(await readJson(await request(method, url, body)));
+    }
+    /**
+     * Builds the error for a response that was supposed to have no body. The body
+     * is parsed defensively: a proxy answering `502` with HTML would otherwise
+     * surface as a JSON syntax error, hiding the status that explains it.
+     */
+    async function readEmptyError(response) {
+        const payload = await response.json().catch(() => null);
+        return readErrorBody(response.status, payload);
+    }
+    return {
+        get: (path, decode, query) => send('GET', buildUrl(options.baseUrl, path, query), decode),
+        getText: async (path) => {
+            const response = await doFetch(buildUrl(options.baseUrl, path, undefined), {
+                method: 'GET',
+                credentials: 'same-origin',
+                headers: { Accept: 'text/csv' },
+            });
+            if (!response.ok) {
+                throw await readEmptyError(response);
+            }
+            return response.text();
+        },
+        postForm: async (path, form, decode) => {
+            const response = await doFetch(buildUrl(options.baseUrl, path, undefined), {
+                method: 'POST',
+                credentials: 'same-origin',
+                headers: { Accept: 'application/json' },
+                body: form,
+            });
+            return decode(await readJson(response));
+        },
+        list: async (path, decodeItem, query) => readPage(await readJson(await request('GET', buildUrl(options.baseUrl, path, query))), decodeItem),
+        post: (path, body, decode) => send('POST', buildUrl(options.baseUrl, path, undefined), decode, body),
+        postEmpty: async (path, body) => {
+            const response = await request('POST', buildUrl(options.baseUrl, path, undefined), body);
+            if (!response.ok) {
+                throw await readEmptyError(response);
+            }
+        },
+        patch: (path, body, decode) => send('PATCH', buildUrl(options.baseUrl, path, undefined), decode, body),
+        patchEmpty: async (path, body) => {
+            const response = await request('PATCH', buildUrl(options.baseUrl, path, undefined), body);
+            if (!response.ok) {
+                throw await readEmptyError(response);
+            }
+        },
+        delete: async (path, query) => {
+            const response = await request('DELETE', buildUrl(options.baseUrl, path, query));
+            // Stricter than `response.ok`: `api.md` says a successful delete is `204`,
+            // and anything else means the server is not doing what it documents.
+            if (response.status !== 204) {
+                throw await readEmptyError(response);
+            }
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AASpC,yDAAyD;AACzD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAQ;IACZ,MAAM,CAAQ;IACd,OAAO,CAAwB;IAExC,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe,EAAE,OAAO,GAA2B,EAAE;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AA4DD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAA;AAChG,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,IAAY,EAAE,KAAkC;IACjF,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IAEpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAQ;QACV,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,kEAAkE;YAClE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IACrC,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,CAAA;AAC1F,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAc,EAAE,OAAgB;IACrD,MAAM,UAAU,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,mCAAmC,MAAM,GAAG,CAAC,CAAA;IAEvG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAEhD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACzG,CAAC;AAED,SAAS,QAAQ,CAAI,OAAgB,EAAE,UAAsB;IAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAA;IACrE,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAA;IAEtC,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAA;IACtE,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAElE,SAAS,UAAU,CAAC,IAAa;QAC/B,OAAO,IAAI,KAAK,SAAS;YACvB,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAChC,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA;IACxE,CAAC;IAED,SAAS,OAAO,CAAC,MAAc,EAAE,GAAW,EAAE,IAAc;QAC1D,OAAO,OAAO,CAAC,GAAG,EAAE;YAClB,MAAM;YACN,WAAW,EAAE,aAAa;YAC1B,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC;YACzB,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC5D,CAAC,CAAA;IACJ,CAAC;IAED,wEAAwE;IACxE,KAAK,UAAU,QAAQ,CAAC,QAAkB;QACxC,MAAM,OAAO,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAE9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/C,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,UAAU,IAAI,CAAI,MAAc,EAAE,GAAW,EAAE,MAAkB,EAAE,IAAc;QACpF,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACjE,CAAC;IAED;;;;OAIG;IACH,KAAK,UAAU,cAAc,CAAC,QAAkB;QAC9C,MAAM,OAAO,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAEhE,OAAO,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChD,CAAC;IAED,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAEzF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE;gBACzE,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;aAChC,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAA;YACtC,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;QACxB,CAAC;QAED,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE;gBACzE,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;gBACvC,IAAI,EAAE,IAAI;aACX,CAAC,CAAA;YAEF,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzC,CAAC;QAED,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CACtC,QAAQ,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC;QAEpG,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC;QAEpG,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAA;YAExF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;QAED,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC;QAEtG,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC/B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAA;YAEzF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;YAEhF,2EAA2E;YAC3E,qEAAqE;YACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/api/context.d.ts

@@ -0,0 +1,14 @@
+import type { ApiClient } from './client.ts';
+/**
+ * Reading the API client from a component.
+ *
+ * There is no default. A page that renders without a provider would otherwise
+ * fetch from an unset base URL and fail somewhere in the network layer, a long
+ * way from the missing wiring that caused it.
+ *
+ * The provider lives in its own file so Fast Refresh keeps working; a module
+ * that exports both a component and a hook loses it.
+ */
+export declare const ApiClientContext: import("react").Context<ApiClient | null>;
+export declare function useApiClient(): ApiClient;
+//# sourceMappingURL=context.d.ts.map

package/dist/api/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/api/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,2CAAwC,CAAA;AAErE,wBAAgB,YAAY,IAAI,SAAS,CAQxC"}

package/dist/api/context.js

@@ -0,0 +1,20 @@
+import { createContext, useContext } from 'react';
+/**
+ * Reading the API client from a component.
+ *
+ * There is no default. A page that renders without a provider would otherwise
+ * fetch from an unset base URL and fail somewhere in the network layer, a long
+ * way from the missing wiring that caused it.
+ *
+ * The provider lives in its own file so Fast Refresh keeps working; a module
+ * that exports both a component and a hook loses it.
+ */
+export const ApiClientContext = createContext(null);
+export function useApiClient() {
+    const client = useContext(ApiClientContext);
+    if (client === null) {
+        throw new Error('No ApiClient in context. Wrap the tree in <ApiProvider>.');
+    }
+    return client;
+}
+//# sourceMappingURL=context.js.map

package/dist/api/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/api/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAIjD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAmB,IAAI,CAAC,CAAA;AAErE,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAA;IAE3C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/api/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Normalises what a query or mutation rejected with.
+ *
+ * `unknown` is honest about what a rejected promise carries, but a component
+ * rendering a message needs something with a `message`. `ApiError` already
+ * extends `Error`, so a failed request survives this untouched.
+ */
+export declare function toError(error: unknown): Error | null;
+//# sourceMappingURL=errors.d.ts.map

package/dist/api/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAMpD"}

package/dist/api/errors.js

@@ -0,0 +1,14 @@
+/**
+ * Normalises what a query or mutation rejected with.
+ *
+ * `unknown` is honest about what a rejected promise carries, but a component
+ * rendering a message needs something with a `message`. `ApiError` already
+ * extends `Error`, so a failed request survives this untouched.
+ */
+export function toError(error) {
+    if (error === null || error === undefined) {
+        return null;
+    }
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AAClE,CAAC"}

package/dist/api/health.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `/healthz` sits outside `/v1`: it is the service's own liveness surface, not a
+ * versioned resource. It gets its own fetch rather than an `ApiClient` method.
+ */
+export interface ServiceHealth {
+    readonly status: 'ok' | 'degraded';
+    readonly database: 'up' | 'down';
+}
+export interface HealthRequestOptions {
+    readonly url: string;
+    readonly fetch?: typeof globalThis.fetch;
+}
+/** Resolves with the reported health, or rejects if the service is unreachable. */
+export declare function fetchServiceHealth(options: HealthRequestOptions): Promise<ServiceHealth>;
+//# sourceMappingURL=health.d.ts.map

package/dist/api/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/api/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,UAAU,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACzC;AAgBD,mFAAmF;AACnF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAK9F"}

package/dist/api/health.js

@@ -0,0 +1,22 @@
+/**
+ * `/healthz` sits outside `/v1`: it is the service's own liveness surface, not a
+ * versioned resource. It gets its own fetch rather than an `ApiClient` method.
+ */
+import { isRecord } from './json.js';
+function decodeServiceHealth(value) {
+    if (!isRecord(value)) {
+        throw new TypeError('Expected a health object');
+    }
+    const { status, database } = value;
+    if ((status !== 'ok' && status !== 'degraded') || (database !== 'up' && database !== 'down')) {
+        throw new TypeError('Unrecognised health response');
+    }
+    return { status, database };
+}
+/** Resolves with the reported health, or rejects if the service is unreachable. */
+export async function fetchServiceHealth(options) {
+    const doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+    const response = await doFetch(options.url, { headers: { Accept: 'application/json' } });
+    return decodeServiceHealth(await response.json());
+}
+//# sourceMappingURL=health.js.map

package/dist/api/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/api/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAYpC,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAA;IACjD,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;IAElC,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAA;IACrD,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC7B,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA6B;IACpE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAA;IAExF,OAAO,mBAAmB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;AACnD,CAAC"}

package/dist/api/json.d.ts

@@ -0,0 +1,3 @@
+/** Narrows parsed JSON to something with readable properties, without casting. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=json.d.ts.map

package/dist/api/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/api/json.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/api/json.js

@@ -0,0 +1,5 @@
+/** Narrows parsed JSON to something with readable properties, without casting. */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=json.js.map

package/dist/api/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/api/json.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AACpD,CAAC"}

package/dist/api/queryClient.d.ts

@@ -0,0 +1,17 @@
+import { QueryClient } from '@tanstack/react-query';
+/**
+ * Cache defaults for the whole app.
+ *
+ * The two that matter:
+ *
+ * `staleTime` is 30 seconds, not zero. Zero refetches every list on every
+ * navigation, which turns a click from People back to People into a network
+ * round trip and a visible flash. Thirty seconds keeps the screen instant while
+ * still catching a change another tab or an agent made.
+ *
+ * Retries skip client errors. Retrying a `422` or a `404` cannot succeed, and
+ * retrying a `401` three times is three chances to lock an account out. Only
+ * `5xx` and transport failures are worth a second attempt.
+ */
+export declare function createQueryClient(): QueryClient;
+//# sourceMappingURL=queryClient.d.ts.map

package/dist/api/queryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryClient.d.ts","sourceRoot":"","sources":["../../src/api/queryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAInD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAY/C"}

package/dist/api/queryClient.js

@@ -0,0 +1,33 @@
+import { QueryClient } from '@tanstack/react-query';
+import { ApiError } from './client.js';
+/**
+ * Cache defaults for the whole app.
+ *
+ * The two that matter:
+ *
+ * `staleTime` is 30 seconds, not zero. Zero refetches every list on every
+ * navigation, which turns a click from People back to People into a network
+ * round trip and a visible flash. Thirty seconds keeps the screen instant while
+ * still catching a change another tab or an agent made.
+ *
+ * Retries skip client errors. Retrying a `422` or a `404` cannot succeed, and
+ * retrying a `401` three times is three chances to lock an account out. Only
+ * `5xx` and transport failures are worth a second attempt.
+ */
+export function createQueryClient() {
+    return new QueryClient({
+        defaultOptions: {
+            queries: {
+                staleTime: 30_000,
+                retry: (failureCount, error) => failureCount < 2 && isWorthRetrying(error),
+            },
+            mutations: {
+                retry: false,
+            },
+        },
+    });
+}
+function isWorthRetrying(error) {
+    return !(error instanceof ApiError) || error.status >= 500;
+}
+//# sourceMappingURL=queryClient.js.map

package/dist/api/queryClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryClient.js","sourceRoot":"","sources":["../../src/api/queryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,WAAW,CAAC;QACrB,cAAc,EAAE;YACd,OAAO,EAAE;gBACP,SAAS,EAAE,MAAM;gBACjB,KAAK,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC;aAC3E;YACD,SAAS,EAAE;gBACT,KAAK,EAAE,KAAK;aACb;SACF;KACF,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAA;AAC5D,CAAC"}