@kelpie/ui 0.1.0

package/dist/api/resource.d.ts

@@ -0,0 +1,110 @@
+import type { Decoder, QueryParameters } from './client.ts';
+/**
+ * The read and write hooks for one `/v1` collection.
+ *
+ * Every CRM resource is the same five operations over the same list envelope,
+ * so they are built once here and configured per resource. A resource module
+ * supplies its path, its decoder, and its two body builders; it writes no cache
+ * handling of its own.
+ *
+ * Pages see the three result types below and never import from
+ * `@tanstack/react-query` directly. That is deliberate: it keeps page code short
+ * and leaves the cache library replaceable without touching a page.
+ */
+/** A list, one page at a time. Nothing is truncated in silence: `hasMore` says so. */
+export interface RecordListResult<TRecord> {
+    readonly records: readonly TRecord[];
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly hasMore: boolean;
+    readonly isLoadingMore: boolean;
+    readonly loadMore: () => void;
+}
+export interface RecordResult<TRecord> {
+    readonly record: TRecord | undefined;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    /** The record is not in this workspace, which `api.md` makes indistinguishable from not existing. */
+    readonly isNotFound: boolean;
+}
+export interface MutationResult<TInput, TOutput> {
+    /** Fire and forget. A failure lands in `error` rather than in an unhandled rejection. */
+    readonly run: (input: TInput) => void;
+    /** Await the result, for a caller that navigates or chains on success. Rejects on failure. */
+    readonly runAsync: (input: TInput) => Promise<TOutput>;
+    readonly isPending: boolean;
+    readonly error: Error | null;
+}
+export interface UpdateArguments<TUpdateInput> {
+    readonly id: string;
+    readonly changes: TUpdateInput;
+}
+export interface PatchResult<TChanges> {
+    /** Fire and forget, bound to one record's id. A failure lands in `error`. */
+    readonly patch: (changes: TChanges) => void;
+    readonly error: Error | null;
+}
+export interface ListOptions {
+    /**
+     * Set false to hold the request back. A list filtered by a set of ids has
+     * nothing to ask until those ids are known, and asking with the filter omitted
+     * would answer with every record instead of none.
+     */
+    readonly enabled?: boolean;
+}
+export interface ResourceHooks<TRecord, TCreateInput, TUpdateInput> extends ReadOnlyResourceHooks<TRecord> {
+    useCreate(): MutationResult<TCreateInput, TRecord>;
+    useUpdate(): MutationResult<UpdateArguments<TUpdateInput>, TRecord>;
+    useRemove(): MutationResult<string, void>;
+}
+/** What a collection with no write verbs offers. Activities are the case: the table is append-only. */
+export interface ReadOnlyResourceHooks<TRecord> {
+    useList(query?: QueryParameters, options?: ListOptions): RecordListResult<TRecord>;
+    useRecord(id: string | undefined): RecordResult<TRecord>;
+}
+export interface ReadOnlyResourceDefinition<TRecord> {
+    /** Cache key root. The plural resource name, e.g. `activities`. */
+    readonly name: string;
+    /** Path under the API base, e.g. `/activities`. */
+    readonly path: string;
+    readonly decode: Decoder<TRecord>;
+}
+export interface ResourceDefinition<TRecord, TCreateInput, TUpdateInput> extends ReadOnlyResourceDefinition<TRecord> {
+    readonly createBody: (input: TCreateInput) => unknown;
+    readonly updateBody: (input: TUpdateInput) => unknown;
+    /**
+     * Other resources whose cached lists a write here can invalidate.
+     *
+     * A join record is the case that needs it. `GET /v1/people?company_id=` is a
+     * list of people, so creating a Position changes its contents without
+     * touching a single person, and a company page that only refetched positions
+     * would render the new row against a name it never fetched.
+     */
+    readonly alsoInvalidates?: readonly string[];
+}
+/**
+ * The read half: `useList` and `useRecord`, and nothing that writes.
+ *
+ * Split out because a collection can be read-only. `createResourceHooks` builds
+ * on this rather than repeating it, so both kinds of resource page, cache, and
+ * report a 404 identically.
+ */
+export declare function createReadOnlyResourceHooks<TRecord>(definition: ReadOnlyResourceDefinition<TRecord>): ReadOnlyResourceHooks<TRecord>;
+export declare function createResourceHooks<TRecord extends {
+    readonly id: string;
+}, TCreateInput, TUpdateInput extends Partial<TRecord>>(definition: ResourceDefinition<TRecord, TCreateInput, TUpdateInput>): ResourceHooks<TRecord, TCreateInput, TUpdateInput>;
+/**
+ * Binds a resource's `useUpdate` hook to one record's id, for a detail page's
+ * inline edits.
+ *
+ * Every detail page had its own three-line `use<X>Patch` doing exactly this,
+ * and every one of them discarded `update.error`. `InlineEdit`'s `onChange` has
+ * no return value to reject, so a failed `PATCH` — a duplicate email or domain,
+ * a dropped connection — had nowhere left to surface: the field just reverted
+ * to its old value with no explanation. Callers now get the error back and
+ * decide where to show it.
+ */
+export declare function usePatch<TRecord extends {
+    readonly id: string;
+}, TChanges>(useUpdate: () => MutationResult<UpdateArguments<TChanges>, TRecord>, record: TRecord): PatchResult<TChanges>;
+//# sourceMappingURL=resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/api/resource.ts"],"names":[],"mappings":"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"}

package/dist/api/resource.js

@@ -0,0 +1,238 @@
+import { keepPreviousData, useInfiniteQuery, useMutation, useQuery, useQueryClient, } from '@tanstack/react-query';
+import { ApiError } from './client.js';
+import { useApiClient } from './context.js';
+import { toError } from './errors.js';
+function keysFor(name) {
+    return {
+        all: [name],
+        lists: [name, 'list'],
+        list: (query) => [name, 'list', query],
+        detail: (id) => [name, 'detail', id],
+    };
+}
+/**
+ * Applies a partial update to a record.
+ *
+ * `undefined` means "not sent" and `null` means "clear this field", per
+ * `api.md`, so an undefined value must leave the existing one alone rather than
+ * overwrite it.
+ */
+function mergeDefined(record, changes) {
+    const merged = { ...record };
+    for (const [key, value] of Object.entries(changes)) {
+        if (value !== undefined) {
+            Object.assign(merged, { [key]: value });
+        }
+    }
+    return merged;
+}
+/** Rewrites one record everywhere it is cached: its own entry, and every list page holding it. */
+function writeRecordEverywhere(queryClient, keys, record) {
+    queryClient.setQueryData(keys.detail(record.id), record);
+    queryClient.setQueriesData({ queryKey: keys.lists }, (data) => data === undefined
+        ? data
+        : {
+            ...data,
+            pages: data.pages.map((page) => ({
+                ...page,
+                items: page.items.map((item) => (item.id === record.id ? record : item)),
+            })),
+        });
+}
+function removeRecordEverywhere(queryClient, keys, id) {
+    queryClient.removeQueries({ queryKey: keys.detail(id) });
+    queryClient.setQueriesData({ queryKey: keys.lists }, (data) => data === undefined
+        ? data
+        : {
+            ...data,
+            pages: data.pages.map((page) => ({
+                ...page,
+                items: page.items.filter((item) => item.id !== id),
+            })),
+        });
+}
+/**
+ * The read half: `useList` and `useRecord`, and nothing that writes.
+ *
+ * Split out because a collection can be read-only. `createResourceHooks` builds
+ * on this rather than repeating it, so both kinds of resource page, cache, and
+ * report a 404 identically.
+ */
+export function createReadOnlyResourceHooks(definition) {
+    const keys = keysFor(definition.name);
+    function useList(query = {}, options = {}) {
+        const client = useApiClient();
+        const enabled = options.enabled ?? true;
+        const result = useInfiniteQuery({
+            queryKey: keys.list(query),
+            queryFn: ({ pageParam }) => client.list(definition.path, definition.decode, {
+                ...query,
+                ...(pageParam === null ? {} : { cursor: pageParam }),
+            }),
+            initialPageParam: null,
+            getNextPageParam: (lastPage) => lastPage.nextCursor,
+            // Without this a keystroke in the filter box blanks the table while the
+            // next query runs, which reads as "no results" for as long as it takes.
+            placeholderData: keepPreviousData,
+            enabled,
+        });
+        return {
+            records: result.data?.pages.flatMap((page) => page.items) ?? [],
+            // A disabled query stays pending forever, which is not the same as loading.
+            isLoading: result.isPending && enabled,
+            error: toError(result.error),
+            hasMore: result.hasNextPage,
+            isLoadingMore: result.isFetchingNextPage,
+            loadMore: () => {
+                void result.fetchNextPage();
+            },
+        };
+    }
+    function useRecord(id) {
+        const client = useApiClient();
+        const result = useQuery({
+            queryKey: keys.detail(id ?? ''),
+            queryFn: () => client.get(`${definition.path}/${id ?? ''}`, definition.decode),
+            enabled: id !== undefined,
+        });
+        return {
+            record: result.data,
+            isLoading: result.isPending && id !== undefined,
+            error: toError(result.error),
+            isNotFound: result.error instanceof ApiError && result.error.status === 404,
+        };
+    }
+    return { useList, useRecord };
+}
+export function createResourceHooks(definition) {
+    const keys = keysFor(definition.name);
+    const related = (definition.alsoInvalidates ?? []).map(keysFor);
+    const { useList, useRecord } = createReadOnlyResourceHooks(definition);
+    /**
+     * Marks this resource's lists stale, and the related resources' with them.
+     * Applied to every write rather than only to create and delete: a resource
+     * that declares a relation has one, whichever verb reaches it.
+     */
+    function invalidateLists(queryClient) {
+        for (const target of [keys, ...related]) {
+            void queryClient.invalidateQueries({ queryKey: target.lists });
+        }
+    }
+    function useCreate() {
+        const client = useApiClient();
+        const queryClient = useQueryClient();
+        const mutation = useMutation({
+            mutationFn: (input) => client.post(definition.path, definition.createBody(input), definition.decode),
+            // No optimistic insert: the id comes from the server, and the caller
+            // usually navigates straight to the new record. A placeholder id would be
+            // a route to a record that does not exist yet.
+            onSuccess: (record) => {
+                queryClient.setQueryData(keys.detail(record.id), record);
+            },
+            onSettled: () => {
+                invalidateLists(queryClient);
+            },
+        });
+        return {
+            run: (input) => {
+                mutation.mutate(input);
+            },
+            runAsync: (input) => mutation.mutateAsync(input),
+            isPending: mutation.isPending,
+            error: toError(mutation.error),
+        };
+    }
+    function useUpdate() {
+        const client = useApiClient();
+        const queryClient = useQueryClient();
+        const mutation = useMutation({
+            mutationFn: ({ id, changes }) => client.patch(`${definition.path}/${id}`, definition.updateBody(changes), definition.decode),
+            // Inline editing is the whole interaction on a detail page, so the field
+            // has to settle the moment it is committed. The snapshot is what makes
+            // that safe: a rejected PATCH puts the old value back.
+            onMutate: async ({ id, changes }) => {
+                await queryClient.cancelQueries({ queryKey: keys.detail(id) });
+                const previous = queryClient.getQueryData(keys.detail(id));
+                if (previous !== undefined) {
+                    writeRecordEverywhere(queryClient, keys, mergeDefined(previous, changes));
+                }
+                return { previous };
+            },
+            onError: (_error, _arguments_, context) => {
+                if (context?.previous !== undefined) {
+                    writeRecordEverywhere(queryClient, keys, context.previous);
+                }
+            },
+            onSuccess: (record) => {
+                writeRecordEverywhere(queryClient, keys, record);
+            },
+            onSettled: (_record, _error, { id }) => {
+                void queryClient.invalidateQueries({ queryKey: keys.detail(id) });
+                invalidateLists(queryClient);
+            },
+        });
+        return {
+            run: (input) => {
+                mutation.mutate(input);
+            },
+            runAsync: (input) => mutation.mutateAsync(input),
+            isPending: mutation.isPending,
+            error: toError(mutation.error),
+        };
+    }
+    function useRemove() {
+        const client = useApiClient();
+        const queryClient = useQueryClient();
+        const mutation = useMutation({
+            mutationFn: (id) => client.delete(`${definition.path}/${id}`),
+            onMutate: async (id) => {
+                await queryClient.cancelQueries({ queryKey: keys.all });
+                const previous = queryClient.getQueryData(keys.detail(id));
+                const previousLists = queryClient.getQueriesData({ queryKey: keys.lists });
+                removeRecordEverywhere(queryClient, keys, id);
+                return { previous, previousLists };
+            },
+            onError: (_error, id, context) => {
+                for (const [key, data] of context?.previousLists ?? []) {
+                    queryClient.setQueryData(key, data);
+                }
+                if (context?.previous !== undefined) {
+                    queryClient.setQueryData(keys.detail(id), context.previous);
+                }
+            },
+            onSettled: () => {
+                invalidateLists(queryClient);
+            },
+        });
+        return {
+            run: (id) => {
+                mutation.mutate(id);
+            },
+            runAsync: (id) => mutation.mutateAsync(id),
+            isPending: mutation.isPending,
+            error: toError(mutation.error),
+        };
+    }
+    return { useList, useRecord, useCreate, useUpdate, useRemove };
+}
+/**
+ * Binds a resource's `useUpdate` hook to one record's id, for a detail page's
+ * inline edits.
+ *
+ * Every detail page had its own three-line `use<X>Patch` doing exactly this,
+ * and every one of them discarded `update.error`. `InlineEdit`'s `onChange` has
+ * no return value to reject, so a failed `PATCH` — a duplicate email or domain,
+ * a dropped connection — had nowhere left to surface: the field just reverted
+ * to its old value with no explanation. Callers now get the error back and
+ * decide where to show it.
+ */
+export function usePatch(useUpdate, record) {
+    const update = useUpdate();
+    return {
+        patch: (changes) => {
+            update.run({ id: record.id, changes });
+        },
+        error: update.error,
+    };
+}
+//# sourceMappingURL=resource.js.map

package/dist/api/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/api/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AA2GrC,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,CAAC;QACX,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC;QACtC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;KACrC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAyB,MAAe,EAAE,OAAyB;IACtF,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAE5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,kGAAkG;AAClG,SAAS,qBAAqB,CAC5B,WAAwB,EACxB,IAAkB,EAClB,MAAe;IAEf,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;IACxD,WAAW,CAAC,cAAc,CAAoB,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAC/E,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC;YACE,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC/B,GAAG,IAAI;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACzE,CAAC,CAAC;SACJ,CACN,CAAA;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,WAAwB,EACxB,IAAkB,EAClB,EAAU;IAEV,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACxD,WAAW,CAAC,cAAc,CAAoB,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAC/E,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC;YACE,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC/B,GAAG,IAAI;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;aACnD,CAAC,CAAC;SACJ,CACN,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA+C;IAE/C,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAErC,SAAS,OAAO,CAAC,KAAK,GAAoB,EAAE,EAAE,OAAO,GAAgB,EAAE;QACrE,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAA;QACvC,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC9B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAC1B,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CACzB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE;gBAC9C,GAAG,KAAK;gBACR,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;aACrD,CAAC;YACJ,gBAAgB,EAAE,IAAqB;YACvC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU;YACnD,wEAAwE;YACxE,wEAAwE;YACxE,eAAe,EAAE,gBAAgB;YACjC,OAAO;SACR,CAAC,CAAA;QAEF,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAC/D,4EAA4E;YAC5E,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO;YACtC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC5B,OAAO,EAAE,MAAM,CAAC,WAAW;YAC3B,aAAa,EAAE,MAAM,CAAC,kBAAkB;YACxC,QAAQ,EAAE,GAAG,EAAE;gBACb,KAAK,MAAM,CAAC,aAAa,EAAE,CAAA;YAC7B,CAAC;SACF,CAAA;IACH,CAAC;IAED,SAAS,SAAS,CAAC,EAAsB;QACvC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC;YACtB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YAC/B,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC;YAC9E,OAAO,EAAE,EAAE,KAAK,SAAS;SAC1B,CAAC,CAAA;QAEF,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,KAAK,SAAS;YAC/C,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC5B,UAAU,EAAE,MAAM,CAAC,KAAK,YAAY,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,GAAG;SAC5E,CAAA;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAKjC,UAAmE;IAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAA;IAEtE;;;;OAIG;IACH,SAAS,eAAe,CAAC,WAAwB;QAC/C,KAAK,MAAM,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;YACxC,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;QAChE,CAAC;IACH,CAAC;IAED,SAAS,SAAS;QAChB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;QACpC,MAAM,QAAQ,GAAG,WAAW,CAAC;YAC3B,UAAU,EAAE,CAAC,KAAmB,EAAE,EAAE,CAClC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC;YAC/E,qEAAqE;YACrE,0EAA0E;YAC1E,+CAA+C;YAC/C,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;gBACpB,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;YAC1D,CAAC;YACD,SAAS,EAAE,GAAG,EAAE;gBACd,eAAe,CAAC,WAAW,CAAC,CAAA;YAC9B,CAAC;SACF,CAAC,CAAA;QAEF,OAAO;YACL,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;gBACb,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACxB,CAAC;YACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;YAChD,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;SAC/B,CAAA;IACH,CAAC;IAED,SAAS,SAAS;QAChB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;QACpC,MAAM,QAAQ,GAAG,WAAW,CAAC;YAC3B,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAiC,EAAE,EAAE,CAC7D,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC;YAE7F,yEAAyE;YACzE,uEAAuE;YACvE,uDAAuD;YACvD,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;gBAClC,MAAM,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;gBAC9D,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAU,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;gBAEnE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,qBAAqB,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;gBAC3E,CAAC;gBAED,OAAO,EAAE,QAAQ,EAAE,CAAA;YACrB,CAAC;YAED,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;gBACxC,IAAI,OAAO,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;oBACpC,qBAAqB,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAC5D,CAAC;YACH,CAAC;YAED,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;gBACpB,qBAAqB,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;YAClD,CAAC;YAED,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;gBACrC,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;gBACjE,eAAe,CAAC,WAAW,CAAC,CAAA;YAC9B,CAAC;SACF,CAAC,CAAA;QAEF,OAAO;YACL,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;gBACb,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACxB,CAAC;YACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;YAChD,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;SAC/B,CAAA;IACH,CAAC;IAED,SAAS,SAAS;QAChB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;QACpC,MAAM,QAAQ,GAAG,WAAW,CAAC;YAC3B,UAAU,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;YAErE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;gBACrB,MAAM,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;gBACvD,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAU,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;gBACnE,MAAM,aAAa,GAAG,WAAW,CAAC,cAAc,CAAoB,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;gBAE7F,sBAAsB,CAAU,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;gBAEtD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;YACpC,CAAC;YAED,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;gBAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,aAAa,IAAI,EAAE,EAAE,CAAC;oBACvD,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;gBACrC,CAAC;gBAED,IAAI,OAAO,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;oBACpC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAC7D,CAAC;YACH,CAAC;YAED,SAAS,EAAE,GAAG,EAAE;gBACd,eAAe,CAAC,WAAW,CAAC,CAAA;YAC9B,CAAC;SACF,CAAC,CAAA;QAEF,OAAO;YACL,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;gBACV,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YACrB,CAAC;YACD,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;SAC/B,CAAA;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;AAChE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAmE,EACnE,MAAe;IAEf,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAE1B,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;QACxC,CAAC;QACD,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAA;AACH,CAAC"}

package/dist/api/resources/account.d.ts

@@ -0,0 +1,49 @@
+import type { Account, AccountPreferences, AccountSession, ChangePasswordInput, ThemePreference, UpdateAccountInput, UpdateAccountPreferencesInput } from '@kelpie/schemas';
+import type { MutationResult } from '../resource.ts';
+export interface AccountState {
+    readonly account: Account | undefined;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+}
+export declare function useAccount(): AccountState;
+export declare function useUpdateAccount(): MutationResult<UpdateAccountInput, Account>;
+export interface AccountPreferencesState {
+    readonly preferences: AccountPreferences | undefined;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+}
+export declare function useAccountPreferences(): AccountPreferencesState;
+export declare function useUpdateAccountPreferences(): MutationResult<UpdateAccountPreferencesInput, AccountPreferences>;
+export interface AccountSessionsState {
+    readonly sessions: readonly AccountSession[];
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+}
+/** Where this account is signed in. The caller's own session is marked `current`. */
+export declare function useAccountSessions(): AccountSessionsState;
+export declare function useRevokeAccountSession(): MutationResult<string, void>;
+/**
+ * Changes the password and ends every other session, which is what the service
+ * does, so the session list on the same page is refetched rather than left
+ * showing devices that are no longer signed in.
+ */
+export declare function useChangePassword(): MutationResult<ChangePasswordInput, void>;
+export interface ThemeControl {
+    readonly theme: ThemePreference;
+    readonly setTheme: (theme: ThemePreference) => void;
+}
+/**
+ * The theme, applied to the document and stored on the account.
+ *
+ * The account's preference is the source of truth, so the theme follows the
+ * person to a new browser. `localStorage` seeds the first paint only: waiting
+ * for the request would render the default theme and then correct itself on
+ * every cold load.
+ *
+ * The value comes from the query cache rather than component state, because
+ * more than one control changes it. The shell's toggle and the preferences page
+ * are separate components, and two `useState` copies of one preference disagree
+ * the moment either is clicked.
+ */
+export declare function useTheme(): ThemeControl;
+//# sourceMappingURL=account.d.ts.map

package/dist/api/resources/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/api/resources/account.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,6BAA6B,EAC9B,MAAM,iBAAiB,CAAA;AAOxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAgBpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAC7B;AAED,wBAAgB,UAAU,IAAI,YAAY,CAQzC;AAED,wBAAgB,gBAAgB,IAAI,cAAc,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAe9E;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAC7B;AAED,wBAAgB,qBAAqB,IAAI,uBAAuB,CAQ/D;AAED,wBAAgB,2BAA2B,IAAI,cAAc,CAC3D,6BAA6B,EAC7B,kBAAkB,CACnB,CAqBA;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;IAC5C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAC7B;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,IAAI,oBAAoB,CAYzD;AAED,wBAAgB,uBAAuB,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAWtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAY7E;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,IAAI,YAAY,CAkCvC"}

package/dist/api/resources/account.js

@@ -0,0 +1,146 @@
+import { accountPreferencesSchema, accountSchema, accountSessionSchema, changePasswordBody, updateAccountBody, updateAccountPreferencesBody, } from '@kelpie/schemas';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useEffect, useState } from 'react';
+import { applyTheme, getStoredTheme, setStoredTheme, watchSystemTheme } from '../../lib/theme.js';
+import { useApiClient } from '../context.js';
+import { toError } from '../errors.js';
+import { asMutationResult } from './mutation.js';
+/**
+ * The signed-in person, as the `/account/*` pages read and write them.
+ *
+ * Not CRM resources, so none of these go through `createResourceHooks`: there is
+ * no collection and no id in a path. They are also not workspace-scoped, which
+ * is why nothing here keys on the session's workspace: renaming an account
+ * renames it everywhere it is a member.
+ */
+const ACCOUNT_KEY = ['account'];
+const PREFERENCES_KEY = ['account', 'preferences'];
+const SESSIONS_KEY = ['account', 'sessions'];
+export function useAccount() {
+    const client = useApiClient();
+    const result = useQuery({
+        queryKey: ACCOUNT_KEY,
+        queryFn: () => client.get('/account', accountSchema.parse),
+    });
+    return { account: result.data, isLoading: result.isPending, error: toError(result.error) };
+}
+export function useUpdateAccount() {
+    const client = useApiClient();
+    const queryClient = useQueryClient();
+    const mutation = useMutation({
+        mutationFn: (input) => client.patch('/account', updateAccountBody(input), accountSchema.parse),
+        onSuccess: async (account) => {
+            queryClient.setQueryData(ACCOUNT_KEY, account);
+            // The team page lists this person by name and address out of the member
+            // list, which the account write knows nothing about.
+            await queryClient.invalidateQueries({ queryKey: ['members'] });
+        },
+    });
+    return asMutationResult(mutation);
+}
+export function useAccountPreferences() {
+    const client = useApiClient();
+    const result = useQuery({
+        queryKey: PREFERENCES_KEY,
+        queryFn: () => client.get('/account/preferences', accountPreferencesSchema.parse),
+    });
+    return { preferences: result.data, isLoading: result.isPending, error: toError(result.error) };
+}
+export function useUpdateAccountPreferences() {
+    const client = useApiClient();
+    const queryClient = useQueryClient();
+    const mutation = useMutation({
+        mutationFn: (input) => client.patch('/account/preferences', updateAccountPreferencesBody(input), accountPreferencesSchema.parse),
+        onSuccess: (preferences) => {
+            queryClient.setQueryData(PREFERENCES_KEY, preferences);
+        },
+        // A failed write leaves an optimistic theme on screen that the account does
+        // not hold. Ask the service what is true rather than guessing back.
+        onError: async () => {
+            await queryClient.invalidateQueries({ queryKey: PREFERENCES_KEY });
+        },
+    });
+    return asMutationResult(mutation);
+}
+/** Where this account is signed in. The caller's own session is marked `current`. */
+export function useAccountSessions() {
+    const client = useApiClient();
+    const result = useQuery({
+        queryKey: SESSIONS_KEY,
+        queryFn: () => client.list('/auth/sessions', accountSessionSchema.parse),
+    });
+    return {
+        sessions: result.data?.items ?? [],
+        isLoading: result.isPending,
+        error: toError(result.error),
+    };
+}
+export function useRevokeAccountSession() {
+    const client = useApiClient();
+    const queryClient = useQueryClient();
+    const mutation = useMutation({
+        mutationFn: (sessionId) => client.delete(`/auth/sessions/${sessionId}`),
+        onSuccess: async () => {
+            await queryClient.invalidateQueries({ queryKey: SESSIONS_KEY });
+        },
+    });
+    return asMutationResult(mutation);
+}
+/**
+ * Changes the password and ends every other session, which is what the service
+ * does, so the session list on the same page is refetched rather than left
+ * showing devices that are no longer signed in.
+ */
+export function useChangePassword() {
+    const client = useApiClient();
+    const queryClient = useQueryClient();
+    const mutation = useMutation({
+        mutationFn: (input) => client.patchEmpty('/auth/password', changePasswordBody(input)),
+        onSuccess: async () => {
+            await queryClient.invalidateQueries({ queryKey: SESSIONS_KEY });
+        },
+    });
+    return asMutationResult(mutation);
+}
+/**
+ * The theme, applied to the document and stored on the account.
+ *
+ * The account's preference is the source of truth, so the theme follows the
+ * person to a new browser. `localStorage` seeds the first paint only: waiting
+ * for the request would render the default theme and then correct itself on
+ * every cold load.
+ *
+ * The value comes from the query cache rather than component state, because
+ * more than one control changes it. The shell's toggle and the preferences page
+ * are separate components, and two `useState` copies of one preference disagree
+ * the moment either is clicked.
+ */
+export function useTheme() {
+    const queryClient = useQueryClient();
+    const { preferences } = useAccountPreferences();
+    const update = useUpdateAccountPreferences();
+    const [firstPaintTheme] = useState(() => getStoredTheme());
+    const theme = preferences?.theme ?? firstPaintTheme;
+    useEffect(() => {
+        applyTheme(theme);
+        // Kept current so the next cold load in this browser paints the right theme
+        // before the request answers.
+        setStoredTheme(theme);
+    }, [theme]);
+    useEffect(() => {
+        if (theme !== 'system') {
+            return;
+        }
+        return watchSystemTheme(() => {
+            applyTheme('system');
+        });
+    }, [theme]);
+    function setTheme(next) {
+        // Applied to the cache first: the click is about something visible, and the
+        // eye should not wait on a round trip. `onError` puts the truth back.
+        queryClient.setQueryData(PREFERENCES_KEY, (current) => current === undefined ? current : { ...current, theme: next });
+        update.run({ theme: next });
+    }
+    return { theme, setTheme };
+}
+//# sourceMappingURL=account.js.map

package/dist/api/resources/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/api/resources/account.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAA;AAUxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;GAOG;AAEH,MAAM,WAAW,GAAG,CAAC,SAAS,CAAU,CAAA;AACxC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,aAAa,CAAU,CAAA;AAC3D,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,UAAU,CAAU,CAAA;AAQrD,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC;QACtB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC;KAC3D,CAAC,CAAA;IAEF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AAC5F,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC;QAC3B,UAAU,EAAE,CAAC,KAAyB,EAAE,EAAE,CACxC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC;QACzE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3B,WAAW,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;YAC9C,wEAAwE;YACxE,qDAAqD;YACrD,MAAM,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QAChE,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAA;AACnC,CAAC;AAQD,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC;QACtB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,KAAK,CAAC;KAClF,CAAC,CAAA;IAEF,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AAChG,CAAC;AAED,MAAM,UAAU,2BAA2B;IAIzC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC;QAC3B,UAAU,EAAE,CAAC,KAAoC,EAAE,EAAE,CACnD,MAAM,CAAC,KAAK,CACV,sBAAsB,EACtB,4BAA4B,CAAC,KAAK,CAAC,EACnC,wBAAwB,CAAC,KAAK,CAC/B;QACH,SAAS,EAAE,CAAC,WAAW,EAAE,EAAE;YACzB,WAAW,CAAC,YAAY,CAAC,eAAe,EAAE,WAAW,CAAC,CAAA;QACxD,CAAC;QACD,4EAA4E;QAC5E,oEAAoE;QACpE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAA;QACpE,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAA;AACnC,CAAC;AAQD,qFAAqF;AACrF,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC;QACtB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,KAAK,CAAC;KACzE,CAAC,CAAA;IAEF,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;KAC7B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC;QAC3B,UAAU,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,SAAS,EAAE,CAAC;QAC/E,SAAS,EAAE,KAAK,IAAI,EAAE;YACpB,MAAM,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;QACjE,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC;QAC3B,UAAU,EAAE,CAAC,KAA0B,EAAE,EAAE,CACzC,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAChE,SAAS,EAAE,KAAK,IAAI,EAAE;YACpB,MAAM,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;QACjE,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAA;AACnC,CAAC;AAOD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,EAAE,WAAW,EAAE,GAAG,qBAAqB,EAAE,CAAA;IAC/C,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAA;IAC5C,MAAM,CAAC,eAAe,CAAC,GAAG,QAAQ,CAAkB,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAA;IAC3E,MAAM,KAAK,GAAG,WAAW,EAAE,KAAK,IAAI,eAAe,CAAA;IAEnD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,KAAK,CAAC,CAAA;QACjB,4EAA4E;QAC5E,8BAA8B;QAC9B,cAAc,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,OAAM;QACR,CAAC;QAED,OAAO,gBAAgB,CAAC,GAAG,EAAE;YAC3B,UAAU,CAAC,QAAQ,CAAC,CAAA;QACtB,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,SAAS,QAAQ,CAAC,IAAqB;QACrC,4EAA4E;QAC5E,sEAAsE;QACtE,WAAW,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,OAAuC,EAAE,EAAE,CACpF,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAC9D,CAAA;QACD,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;AAC5B,CAAC"}

package/dist/api/resources/activities.d.ts

@@ -0,0 +1,8 @@
+import type { Activity, RecordTargetType } from '@kelpie/schemas';
+import type { RecordListResult } from '../resource.ts';
+export interface ActivityTimeline {
+    readonly targetType: RecordTargetType;
+    readonly targetId: string;
+}
+export declare function useActivities(timeline: ActivityTimeline): RecordListResult<Activity>;
+//# sourceMappingURL=activities.d.ts.map

package/dist/api/resources/activities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.d.ts","sourceRoot":"","sources":["../../../src/api/resources/activities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAmBtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAEpF"}

package/dist/api/resources/activities.js

@@ -0,0 +1,21 @@
+import { activitySchema } from '@kelpie/schemas';
+import { createReadOnlyResourceHooks } from '../resource.js';
+/**
+ * `/v1/activities`, read-only.
+ *
+ * No write hooks, because the API has no write routes: activity is emitted by
+ * the service that made the change, in the same transaction, and the table is
+ * append-only.
+ *
+ * The roll-up a person's or company's timeline shows is resolved server-side.
+ * Nothing here fetches related deals to merge them in.
+ */
+const activities = createReadOnlyResourceHooks({
+    name: 'activities',
+    path: '/activities',
+    decode: activitySchema.parse,
+});
+export function useActivities(timeline) {
+    return activities.useList({ target_type: timeline.targetType, target_id: timeline.targetId });
+}
+//# sourceMappingURL=activities.js.map

package/dist/api/resources/activities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.js","sourceRoot":"","sources":["../../../src/api/resources/activities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAG5D;;;;;;;;;GASG;AAEH,MAAM,UAAU,GAAG,2BAA2B,CAAW;IACvD,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,cAAc,CAAC,KAAK;CAC7B,CAAC,CAAA;AAOF,MAAM,UAAU,aAAa,CAAC,QAA0B;IACtD,OAAO,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;AAC/F,CAAC"}

package/dist/api/resources/agentTasks.d.ts

@@ -0,0 +1,31 @@
+import type { AgentRun, AgentRunStatus, AgentTaskDefinition, AgentTaskTargetType, CreateRegisteredAgentInput, RegisteredAgent, RegisteredAgentInput, ResolveAgentTaskInput, ResolvedAgentTask, RunAgentTaskInput } from '@kelpie/schemas';
+import type { ListOptions, MutationResult, RecordListResult, RecordResult, UpdateArguments } from '../resource.ts';
+/** The catalog for one target type. Code on the server, so never stale enough to refetch. */
+export declare function useAgentTasks(targetType: AgentTaskTargetType): RecordListResult<AgentTaskDefinition>;
+/** The whole catalog, for labelling run-log rows by task id. */
+export declare function useAllAgentTasks(): RecordListResult<AgentTaskDefinition>;
+export interface ResolveAgentTaskArguments extends ResolveAgentTaskInput {
+    readonly taskId: string;
+}
+/** A POST in verb only: it assembles a prompt and writes nothing, so no cache moves. */
+export declare function useResolveAgentTask(): MutationResult<ResolveAgentTaskArguments, ResolvedAgentTask>;
+export interface RunAgentTaskArguments extends RunAgentTaskInput {
+    readonly taskId: string;
+}
+export declare function useRunAgentTask(): MutationResult<RunAgentTaskArguments, AgentRun>;
+export interface AgentRunFilters {
+    readonly agentId?: string;
+    readonly status?: AgentRunStatus;
+}
+export declare function useAgentRuns(filters?: AgentRunFilters, options?: ListOptions): RecordListResult<AgentRun>;
+/**
+ * One run, polled while the dispatch is still moving. The server settles the
+ * run after the create response returns, so `queued` and `running` are moments
+ * the page would otherwise be stuck displaying forever.
+ */
+export declare function useAgentRun(id: string | undefined): RecordResult<AgentRun>;
+export declare function useAgents(options?: ListOptions): RecordListResult<RegisteredAgent>;
+export declare function useCreateAgent(): MutationResult<CreateRegisteredAgentInput, RegisteredAgent>;
+export declare function useUpdateAgent(): MutationResult<UpdateArguments<RegisteredAgentInput>, RegisteredAgent>;
+export declare function useDeleteAgent(): MutationResult<string, void>;
+//# sourceMappingURL=agentTasks.d.ts.map