@raster-app/react 0.0.0-stage → 0.1.0-canary-fd0f8dd

package/dist/use-asset-search.d.ts

@@ -0,0 +1,28 @@
+import { type RasterApiError, type SearchHit } from '@raster-app/sdk';
+/** Where a search looks: one organization, optionally narrowed to one of its libraries. */
+export type SearchScope = {
+    organizationId: string;
+    /** Null searches every library in the organization. */
+    libraryId: string | null;
+};
+export type AssetSearch = {
+    /** Whether there is a query to show results for — views swap to results on this. */
+    active: boolean;
+    /** The trimmed query the results are (or will be) for. */
+    query: string;
+    /** Null until the first page has landed. */
+    hits: Array<SearchHit> | null;
+    /** Total matches in scope, from the index — not just those loaded so far. */
+    found: number;
+    isSearching: boolean;
+    hasMore: boolean;
+    /** Fetch the next page. A no-op while one is already in flight, at the end, or after a failure. */
+    loadMore: () => void;
+    error: RasterApiError | null;
+};
+/**
+ * Full-text search over Raster, as a header search box drives it. The previous results stay
+ * on screen while the next query runs, since a grid that blanks on every keystroke makes
+ * typing feel destructive. A null scope switches the search off.
+ */
+export declare function useAssetSearch(scope: SearchScope | null, rawQuery: string): AssetSearch;

package/dist/use-asset-search.js

@@ -0,0 +1,82 @@
+import { skipToken, useInfiniteQuery, } from '@tanstack/react-query';
+import { useCallback, useEffect, useState } from 'react';
+import { SEARCH_PAGE_SIZE, } from '@raster-app/sdk';
+import { useRasterClient } from './context.js';
+import { rasterKeys } from './query-keys.js';
+import { useCredentialIdentity } from './use-session.js';
+/** How long typing must pause before a query is sent, so a word costs one request. */
+const SEARCH_DEBOUNCE_MS = 300;
+function toResults(data) {
+    return {
+        // The index can shift between pages; a hit already shown is not shown twice.
+        hits: Array.from(new Map(data.pages.flatMap((page) => page.hits).map((hit) => [hit.id, hit])).values()),
+        found: data.pages[data.pages.length - 1]?.found ?? 0,
+    };
+}
+/**
+ * Full-text search over Raster, as a header search box drives it. The previous results stay
+ * on screen while the next query runs, since a grid that blanks on every keystroke makes
+ * typing feel destructive. A null scope switches the search off.
+ */
+export function useAssetSearch(scope, rawQuery) {
+    const client = useRasterClient();
+    const identity = useCredentialIdentity();
+    const [debouncedQuery, setDebouncedQuery] = useState('');
+    const query = rawQuery.trim();
+    const active = scope !== null && query !== '';
+    const { data, error, isFetching, isError, hasNextPage, fetchNextPage } = useInfiniteQuery({
+        queryKey: [
+            ...rasterKeys.search(identity, scope?.organizationId ?? null),
+            scope?.libraryId ?? null,
+            debouncedQuery,
+        ],
+        queryFn: scope === null
+            ? skipToken
+            : ({ pageParam, signal }) => client.search({
+                organizationId: scope.organizationId,
+                libraryIds: scope.libraryId === null ? undefined : [scope.libraryId],
+                query: debouncedQuery,
+                page: pageParam,
+                signal,
+            }),
+        initialPageParam: 1,
+        getNextPageParam: (lastPage, pages) => lastPage.hits.length === SEARCH_PAGE_SIZE && pages.length * SEARCH_PAGE_SIZE < lastPage.found
+            ? pages.length + 1
+            : undefined,
+        select: toResults,
+        // `keepPreviousData` within one sign-in's search of one organization. The observer holds
+        // the last account's results after their cache is dropped, and a hit names its library but
+        // not its organization, so one shown under another organization would be acted on there.
+        placeholderData: (previous, previousQuery) => {
+            const [, signIn, , organizationId] = previousQuery?.queryKey ?? [];
+            return signIn === identity && organizationId === scope?.organizationId ? previous : undefined;
+        },
+        // A blank `q` returns recent assets rather than matches.
+        enabled: identity !== null && active && debouncedQuery !== '',
+    });
+    const shown = active ? data : undefined;
+    // Up from the keystroke rather than from when the request goes out, so the spinner confirms
+    // the typing was noticed.
+    const isSearching = active && (query !== debouncedQuery || isFetching);
+    // A failure also stops paging, rather than let an observer retry it on every scroll.
+    const hasMore = active && hasNextPage && !isError;
+    const loadMore = useCallback(() => {
+        if (hasMore)
+            void fetchNextPage({ cancelRefetch: false });
+    }, [hasMore, fetchNextPage]);
+    useEffect(() => {
+        const timer = setTimeout(() => setDebouncedQuery(query), SEARCH_DEBOUNCE_MS);
+        return () => clearTimeout(timer);
+    }, [query]);
+    return {
+        active,
+        query,
+        hits: shown?.hits ?? null,
+        found: shown?.found ?? 0,
+        isSearching,
+        hasMore,
+        loadMore,
+        error: active ? error : null,
+    };
+}
+//# sourceMappingURL=use-asset-search.js.map

package/dist/use-asset-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-asset-search.js","sourceRoot":"","sources":["../src/use-asset-search.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype InfiniteData,\n\ttype QueryKey,\n\tskipToken,\n\tuseInfiniteQuery,\n} from '@tanstack/react-query'\nimport { useCallback, useEffect, useState } from 'react'\n\nimport {\n\ttype RasterApiError,\n\tSEARCH_PAGE_SIZE,\n\ttype SearchHit,\n\ttype SearchResult,\n} from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\nimport { rasterKeys } from './query-keys.js'\nimport { useCredentialIdentity } from './use-session.js'\n\n/** How long typing must pause before a query is sent, so a word costs one request. */\nconst SEARCH_DEBOUNCE_MS = 300\n\n/** Where a search looks: one organization, optionally narrowed to one of its libraries. */\nexport type SearchScope = {\n\torganizationId: string\n\t/** Null searches every library in the organization. */\n\tlibraryId: string | null\n}\n\nexport type AssetSearch = {\n\t/** Whether there is a query to show results for — views swap to results on this. */\n\tactive: boolean\n\t/** The trimmed query the results are (or will be) for. */\n\tquery: string\n\t/** Null until the first page has landed. */\n\thits: Array<SearchHit> | null\n\t/** Total matches in scope, from the index — not just those loaded so far. */\n\tfound: number\n\tisSearching: boolean\n\thasMore: boolean\n\t/** Fetch the next page. A no-op while one is already in flight, at the end, or after a failure. */\n\tloadMore: () => void\n\terror: RasterApiError | null\n}\n\ntype Results = Pick<SearchResult, 'hits' | 'found'>\n\nfunction toResults(data: InfiniteData<SearchResult>): Results {\n\treturn {\n\t\t// The index can shift between pages; a hit already shown is not shown twice.\n\t\thits: Array.from(\n\t\t\tnew Map(data.pages.flatMap((page) => page.hits).map((hit) => [hit.id, hit])).values()\n\t\t),\n\t\tfound: data.pages[data.pages.length - 1]?.found ?? 0,\n\t}\n}\n\n/**\n * Full-text search over Raster, as a header search box drives it. The previous results stay\n * on screen while the next query runs, since a grid that blanks on every keystroke makes\n * typing feel destructive. A null scope switches the search off.\n */\nexport function useAssetSearch(scope: SearchScope | null, rawQuery: string): AssetSearch {\n\tconst client = useRasterClient()\n\n\tconst identity = useCredentialIdentity()\n\n\tconst [debouncedQuery, setDebouncedQuery] = useState('')\n\n\tconst query = rawQuery.trim()\n\tconst active = scope !== null && query !== ''\n\n\tconst { data, error, isFetching, isError, hasNextPage, fetchNextPage } = useInfiniteQuery<\n\t\tSearchResult,\n\t\tRasterApiError,\n\t\tResults,\n\t\tQueryKey,\n\t\tnumber\n\t>({\n\t\tqueryKey: [\n\t\t\t...rasterKeys.search(identity, scope?.organizationId ?? null),\n\t\t\tscope?.libraryId ?? null,\n\t\t\tdebouncedQuery,\n\t\t],\n\t\tqueryFn:\n\t\t\tscope === null\n\t\t\t\t? skipToken\n\t\t\t\t: ({ pageParam, signal }) =>\n\t\t\t\t\t\tclient.search({\n\t\t\t\t\t\t\torganizationId: scope.organizationId,\n\t\t\t\t\t\t\tlibraryIds: scope.libraryId === null ? undefined : [scope.libraryId],\n\t\t\t\t\t\t\tquery: debouncedQuery,\n\t\t\t\t\t\t\tpage: pageParam,\n\t\t\t\t\t\t\tsignal,\n\t\t\t\t\t\t}),\n\t\tinitialPageParam: 1,\n\t\tgetNextPageParam: (lastPage, pages) =>\n\t\t\tlastPage.hits.length === SEARCH_PAGE_SIZE && pages.length * SEARCH_PAGE_SIZE < lastPage.found\n\t\t\t\t? pages.length + 1\n\t\t\t\t: undefined,\n\t\tselect: toResults,\n\t\t// `keepPreviousData` within one sign-in's search of one organization. The observer holds\n\t\t// the last account's results after their cache is dropped, and a hit names its library but\n\t\t// not its organization, so one shown under another organization would be acted on there.\n\t\tplaceholderData: (previous, previousQuery) => {\n\t\t\tconst [, signIn, , organizationId] = previousQuery?.queryKey ?? []\n\t\t\treturn signIn === identity && organizationId === scope?.organizationId ? previous : undefined\n\t\t},\n\t\t// A blank `q` returns recent assets rather than matches.\n\t\tenabled: identity !== null && active && debouncedQuery !== '',\n\t})\n\n\tconst shown = active ? data : undefined\n\t// Up from the keystroke rather than from when the request goes out, so the spinner confirms\n\t// the typing was noticed.\n\tconst isSearching = active && (query !== debouncedQuery || isFetching)\n\t// A failure also stops paging, rather than let an observer retry it on every scroll.\n\tconst hasMore = active && hasNextPage && !isError\n\n\tconst loadMore = useCallback(() => {\n\t\tif (hasMore) void fetchNextPage({ cancelRefetch: false })\n\t}, [hasMore, fetchNextPage])\n\n\tuseEffect(() => {\n\t\tconst timer = setTimeout(() => setDebouncedQuery(query), SEARCH_DEBOUNCE_MS)\n\t\treturn () => clearTimeout(timer)\n\t}, [query])\n\n\treturn {\n\t\tactive,\n\t\tquery,\n\t\thits: shown?.hits ?? null,\n\t\tfound: shown?.found ?? 0,\n\t\tisSearching,\n\t\thasMore,\n\t\tloadMore,\n\t\terror: active ? error : null,\n\t}\n}\n"]}

package/dist/use-asset-upload.d.ts

@@ -0,0 +1,46 @@
+import type { Asset, RasterApiError, UploadSource, UploadedAsset } from '@raster-app/sdk';
+export type UploadState = {
+    status: 'idle';
+} | {
+    status: 'uploading';
+}
+/** Raster has the file and is still processing it. */
+ | {
+    status: 'processing';
+    asset: UploadedAsset;
+}
+/** Processed. For a variant, `asset` is its parent, whose `variants` now carry it. */
+ | {
+    status: 'done';
+    asset: Asset;
+}
+/** Raster has the file, but was still processing it when the wait gave up. */
+ | {
+    status: 'timed-out';
+    asset: UploadedAsset;
+} | {
+    status: 'error';
+    error: RasterApiError;
+};
+type UploadOptions = {
+    organizationId: string;
+    libraryId: string;
+    /** Attach as a variant of this asset; omit for a new top-level asset. */
+    parentId?: string | null;
+    source: UploadSource;
+    filename?: string;
+};
+export type AssetUpload = {
+    state: UploadState;
+    /**
+     * Upload a file, then wait until Raster has processed it (`assets.waitUntilProcessed`).
+     *
+     * Resolves with the finished asset. Null leaves the rest to `state`: still processing when
+     * the wait gave up, which is not a failure, just "not yet" — or failed, or cancelled.
+     */
+    upload: (options: UploadOptions) => Promise<Asset | null>;
+    cancel: () => void;
+    reset: () => void;
+};
+export declare function useAssetUpload(): AssetUpload;
+export {};

package/dist/use-asset-upload.js

@@ -0,0 +1,73 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useRasterClient } from './context.js';
+import { rasterKeys } from './query-keys.js';
+import { useCredentialIdentity } from './use-session.js';
+function uploadState(mutation, uploaded) {
+    if (mutation.isSuccess)
+        return mutation.data;
+    if (mutation.isError)
+        return { status: 'error', error: mutation.error };
+    if (mutation.isIdle)
+        return { status: 'idle' };
+    return uploaded === null ? { status: 'uploading' } : { status: 'processing', asset: uploaded };
+}
+export function useAssetUpload() {
+    const client = useRasterClient();
+    const queryClient = useQueryClient();
+    const identity = useCredentialIdentity();
+    const mutation = useMutation({
+        mutationFn: async ({ signal, ...options }) => {
+            const uploaded = await client.assets.upload({ ...options, signal });
+            // An upload superseded by now must not show as the one processing.
+            if (!signal.aborted)
+                setUploaded(uploaded);
+            const asset = await client.assets.waitUntilProcessed({
+                organizationId: options.organizationId,
+                libraryId: options.libraryId,
+                assetId: uploaded.id,
+                parentId: uploaded.parentId,
+                signal,
+            });
+            return asset === null ? { status: 'timed-out', asset: uploaded } : { status: 'done', asset };
+        },
+        // Whatever failed, Raster may have the file by now.
+        onSettled: (_outcome, _error, { organizationId, libraryId }) => {
+            void queryClient.invalidateQueries({
+                queryKey: rasterKeys.libraries(identity, organizationId),
+            });
+            void queryClient.invalidateQueries({
+                queryKey: rasterKeys.assets(identity, organizationId, libraryId),
+            });
+            void queryClient.invalidateQueries({ queryKey: rasterKeys.search(identity, organizationId) });
+        },
+    });
+    const [uploaded, setUploaded] = useState(null);
+    const controllerRef = useRef(null);
+    const { mutateAsync, reset: resetMutation } = mutation;
+    const state = uploadState(mutation, uploaded);
+    const upload = useCallback(async (options) => {
+        controllerRef.current?.abort();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        setUploaded(null);
+        try {
+            const outcome = await mutateAsync({ ...options, signal: controller.signal });
+            return outcome.status === 'done' ? outcome.asset : null;
+        }
+        catch {
+            return null;
+        }
+    }, [mutateAsync]);
+    const reset = useCallback(() => {
+        resetMutation();
+        setUploaded(null);
+    }, [resetMutation]);
+    const cancel = useCallback(() => {
+        controllerRef.current?.abort();
+        reset();
+    }, [reset]);
+    useEffect(() => () => controllerRef.current?.abort(), []);
+    return { state, upload, cancel, reset };
+}
+//# sourceMappingURL=use-asset-upload.js.map

package/dist/use-asset-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-asset-upload.js","sourceRoot":"","sources":["../src/use-asset-upload.ts"],"names":[],"mappings":"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","sourcesContent":["import { type UseMutationResult, useMutation, useQueryClient } from '@tanstack/react-query'\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\nimport type { Asset, RasterApiError, UploadSource, UploadedAsset } from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\nimport { rasterKeys } from './query-keys.js'\nimport { useCredentialIdentity } from './use-session.js'\n\nexport type UploadState =\n\t| { status: 'idle' }\n\t| { status: 'uploading' }\n\t/** Raster has the file and is still processing it. */\n\t| { status: 'processing'; asset: UploadedAsset }\n\t/** Processed. For a variant, `asset` is its parent, whose `variants` now carry it. */\n\t| { status: 'done'; asset: Asset }\n\t/** Raster has the file, but was still processing it when the wait gave up. */\n\t| { status: 'timed-out'; asset: UploadedAsset }\n\t| { status: 'error'; error: RasterApiError }\n\ntype UploadOptions = {\n\torganizationId: string\n\tlibraryId: string\n\t/** Attach as a variant of this asset; omit for a new top-level asset. */\n\tparentId?: string | null\n\tsource: UploadSource\n\tfilename?: string\n}\n\ntype UploadOutcome = Extract<UploadState, { status: 'done' | 'timed-out' }>\n\ntype UploadVariables = UploadOptions & { signal: AbortSignal }\n\ntype UploadMutation = UseMutationResult<UploadOutcome, RasterApiError, UploadVariables>\n\nexport type AssetUpload = {\n\tstate: UploadState\n\t/**\n\t * Upload a file, then wait until Raster has processed it (`assets.waitUntilProcessed`).\n\t *\n\t * Resolves with the finished asset. Null leaves the rest to `state`: still processing when\n\t * the wait gave up, which is not a failure, just \"not yet\" — or failed, or cancelled.\n\t */\n\tupload: (options: UploadOptions) => Promise<Asset | null>\n\tcancel: () => void\n\treset: () => void\n}\n\nfunction uploadState(mutation: UploadMutation, uploaded: UploadedAsset | null): UploadState {\n\tif (mutation.isSuccess) return mutation.data\n\tif (mutation.isError) return { status: 'error', error: mutation.error }\n\tif (mutation.isIdle) return { status: 'idle' }\n\treturn uploaded === null ? { status: 'uploading' } : { status: 'processing', asset: uploaded }\n}\n\nexport function useAssetUpload(): AssetUpload {\n\tconst client = useRasterClient()\n\tconst queryClient = useQueryClient()\n\n\tconst identity = useCredentialIdentity()\n\tconst mutation = useMutation<UploadOutcome, RasterApiError, UploadVariables>({\n\t\tmutationFn: async ({ signal, ...options }) => {\n\t\t\tconst uploaded = await client.assets.upload({ ...options, signal })\n\t\t\t// An upload superseded by now must not show as the one processing.\n\t\t\tif (!signal.aborted) setUploaded(uploaded)\n\t\t\tconst asset = await client.assets.waitUntilProcessed({\n\t\t\t\torganizationId: options.organizationId,\n\t\t\t\tlibraryId: options.libraryId,\n\t\t\t\tassetId: uploaded.id,\n\t\t\t\tparentId: uploaded.parentId,\n\t\t\t\tsignal,\n\t\t\t})\n\t\t\treturn asset === null ? { status: 'timed-out', asset: uploaded } : { status: 'done', asset }\n\t\t},\n\t\t// Whatever failed, Raster may have the file by now.\n\t\tonSettled: (_outcome, _error, { organizationId, libraryId }) => {\n\t\t\tvoid queryClient.invalidateQueries({\n\t\t\t\tqueryKey: rasterKeys.libraries(identity, organizationId),\n\t\t\t})\n\t\t\tvoid queryClient.invalidateQueries({\n\t\t\t\tqueryKey: rasterKeys.assets(identity, organizationId, libraryId),\n\t\t\t})\n\t\t\tvoid queryClient.invalidateQueries({ queryKey: rasterKeys.search(identity, organizationId) })\n\t\t},\n\t})\n\n\tconst [uploaded, setUploaded] = useState<UploadedAsset | null>(null)\n\n\tconst controllerRef = useRef<AbortController | null>(null)\n\n\tconst { mutateAsync, reset: resetMutation } = mutation\n\tconst state = uploadState(mutation, uploaded)\n\n\tconst upload = useCallback<AssetUpload['upload']>(\n\t\tasync (options) => {\n\t\t\tcontrollerRef.current?.abort()\n\t\t\tconst controller = new AbortController()\n\t\t\tcontrollerRef.current = controller\n\t\t\tsetUploaded(null)\n\t\t\ttry {\n\t\t\t\tconst outcome = await mutateAsync({ ...options, signal: controller.signal })\n\t\t\t\treturn outcome.status === 'done' ? outcome.asset : null\n\t\t\t} catch {\n\t\t\t\treturn null\n\t\t\t}\n\t\t},\n\t\t[mutateAsync]\n\t)\n\n\tconst reset = useCallback(() => {\n\t\tresetMutation()\n\t\tsetUploaded(null)\n\t}, [resetMutation])\n\n\tconst cancel = useCallback(() => {\n\t\tcontrollerRef.current?.abort()\n\t\treset()\n\t}, [reset])\n\n\tuseEffect(() => () => controllerRef.current?.abort(), [])\n\n\treturn { state, upload, cancel, reset }\n}\n"]}

package/dist/use-assets.d.ts

@@ -0,0 +1,24 @@
+import { type Asset, type RasterApiError } from '@raster-app/sdk';
+export type AssetsResource = {
+    /** Null until the first page lands. */
+    assets: Array<Asset> | null;
+    isLoading: boolean;
+    error: RasterApiError | null;
+    hasMore: boolean;
+    /** Fetch the next page. A no-op while one is already in flight, at the end, or after a failure. */
+    loadMore: () => void;
+};
+/**
+ * Warm a library's first page, as a hover does before the click that opens it. A library already
+ * cached is left alone: its grid paints on the click and refreshes itself.
+ */
+export declare function usePrefetchAssets(): (organizationId: string, libraryId: string) => void;
+/**
+ * A library's assets, paged.
+ *
+ * Pass a null `libraryId` before a library is open; the hook then sits idle.
+ */
+export declare function useAssets(options: {
+    organizationId: string | null;
+    libraryId: string | null;
+}): AssetsResource;

package/dist/use-assets.js

@@ -0,0 +1,63 @@
+import { skipToken, useInfiniteQuery, useQueryClient, } from '@tanstack/react-query';
+import { useCallback } from 'react';
+import { ASSETS_PAGE_SIZE, } from '@raster-app/sdk';
+import { useRasterClient } from './context.js';
+import { rasterKeys } from './query-keys.js';
+import { useCredentialIdentity } from './use-session.js';
+/** A library can change between pages; an asset already shown is not shown twice. */
+function toAssets(data) {
+    return Array.from(new Map(data.pages.flat().map((asset) => [asset.id, asset])).values());
+}
+/** One page of a library, as the grid reads it and a hover warms it. */
+function listPage(client, organizationId, libraryId) {
+    // `signal` aborts a page nobody wants any more, which would otherwise hold the connection pool.
+    return ({ pageParam, signal }) => client.assets.list({ organizationId, libraryId, page: pageParam, signal });
+}
+/**
+ * Warm a library's first page, as a hover does before the click that opens it. A library already
+ * cached is left alone: its grid paints on the click and refreshes itself.
+ */
+export function usePrefetchAssets() {
+    const client = useRasterClient();
+    const queryClient = useQueryClient();
+    const identity = useCredentialIdentity();
+    return useCallback((organizationId, libraryId) => {
+        const queryKey = rasterKeys.assets(identity, organizationId, libraryId);
+        if (identity === null || queryClient.getQueryData(queryKey) !== undefined)
+            return;
+        void queryClient.prefetchInfiniteQuery({
+            queryKey,
+            queryFn: listPage(client, organizationId, libraryId),
+            initialPageParam: 1,
+        });
+    }, [client, queryClient, identity]);
+}
+/**
+ * A library's assets, paged.
+ *
+ * Pass a null `libraryId` before a library is open; the hook then sits idle.
+ */
+export function useAssets(options) {
+    const { organizationId, libraryId } = options;
+    const client = useRasterClient();
+    const identity = useCredentialIdentity();
+    const { data, error, isFetching, isError, hasNextPage, fetchNextPage } = useInfiniteQuery({
+        queryKey: rasterKeys.assets(identity, organizationId, libraryId),
+        queryFn: organizationId === null || libraryId === null
+            ? skipToken
+            : listPage(client, organizationId, libraryId),
+        initialPageParam: 1,
+        getNextPageParam: (lastPage, pages) => lastPage.length === ASSETS_PAGE_SIZE ? pages.length + 1 : undefined,
+        select: toAssets,
+        enabled: identity !== null && organizationId !== null && libraryId !== null,
+    });
+    // A failure also stops paging, rather than let a scroll observer retry it on every frame.
+    const hasMore = hasNextPage && !isError;
+    // Without `cancelRefetch: false`, a call while a page is in flight would abort it to ask again.
+    const loadMore = useCallback(() => {
+        if (hasMore)
+            void fetchNextPage({ cancelRefetch: false });
+    }, [hasMore, fetchNextPage]);
+    return { assets: data ?? null, isLoading: isFetching, error, hasMore, loadMore };
+}
+//# sourceMappingURL=use-assets.js.map

package/dist/use-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-assets.js","sourceRoot":"","sources":["../src/use-assets.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype InfiniteData,\n\ttype QueryFunctionContext,\n\ttype QueryKey,\n\tskipToken,\n\tuseInfiniteQuery,\n\tuseQueryClient,\n} from '@tanstack/react-query'\nimport { useCallback } from 'react'\n\nimport {\n\tASSETS_PAGE_SIZE,\n\ttype Asset,\n\ttype RasterApiError,\n\ttype RasterClient,\n} from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\nimport { rasterKeys } from './query-keys.js'\nimport { useCredentialIdentity } from './use-session.js'\n\nexport type AssetsResource = {\n\t/** Null until the first page lands. */\n\tassets: Array<Asset> | null\n\tisLoading: boolean\n\terror: RasterApiError | null\n\thasMore: boolean\n\t/** Fetch the next page. A no-op while one is already in flight, at the end, or after a failure. */\n\tloadMore: () => void\n}\n\n/** A library can change between pages; an asset already shown is not shown twice. */\nfunction toAssets(data: InfiniteData<Array<Asset>>): Array<Asset> {\n\treturn Array.from(new Map(data.pages.flat().map((asset) => [asset.id, asset])).values())\n}\n\n/** One page of a library, as the grid reads it and a hover warms it. */\nfunction listPage(client: RasterClient, organizationId: string, libraryId: string) {\n\t// `signal` aborts a page nobody wants any more, which would otherwise hold the connection pool.\n\treturn ({ pageParam, signal }: QueryFunctionContext<QueryKey, number>) =>\n\t\tclient.assets.list({ organizationId, libraryId, page: pageParam, signal })\n}\n\n/**\n * Warm a library's first page, as a hover does before the click that opens it. A library already\n * cached is left alone: its grid paints on the click and refreshes itself.\n */\nexport function usePrefetchAssets(): (organizationId: string, libraryId: string) => void {\n\tconst client = useRasterClient()\n\tconst queryClient = useQueryClient()\n\tconst identity = useCredentialIdentity()\n\n\treturn useCallback(\n\t\t(organizationId, libraryId) => {\n\t\t\tconst queryKey = rasterKeys.assets(identity, organizationId, libraryId)\n\t\t\tif (identity === null || queryClient.getQueryData(queryKey) !== undefined) return\n\t\t\tvoid queryClient.prefetchInfiniteQuery({\n\t\t\t\tqueryKey,\n\t\t\t\tqueryFn: listPage(client, organizationId, libraryId),\n\t\t\t\tinitialPageParam: 1,\n\t\t\t})\n\t\t},\n\t\t[client, queryClient, identity]\n\t)\n}\n\n/**\n * A library's assets, paged.\n *\n * Pass a null `libraryId` before a library is open; the hook then sits idle.\n */\nexport function useAssets(options: {\n\torganizationId: string | null\n\tlibraryId: string | null\n}): AssetsResource {\n\tconst { organizationId, libraryId } = options\n\n\tconst client = useRasterClient()\n\n\tconst identity = useCredentialIdentity()\n\tconst { data, error, isFetching, isError, hasNextPage, fetchNextPage } = useInfiniteQuery<\n\t\tArray<Asset>,\n\t\tRasterApiError,\n\t\tArray<Asset>,\n\t\tQueryKey,\n\t\tnumber\n\t>({\n\t\tqueryKey: rasterKeys.assets(identity, organizationId, libraryId),\n\t\tqueryFn:\n\t\t\torganizationId === null || libraryId === null\n\t\t\t\t? skipToken\n\t\t\t\t: listPage(client, organizationId, libraryId),\n\t\tinitialPageParam: 1,\n\t\tgetNextPageParam: (lastPage, pages) =>\n\t\t\tlastPage.length === ASSETS_PAGE_SIZE ? pages.length + 1 : undefined,\n\t\tselect: toAssets,\n\t\tenabled: identity !== null && organizationId !== null && libraryId !== null,\n\t})\n\n\t// A failure also stops paging, rather than let a scroll observer retry it on every frame.\n\tconst hasMore = hasNextPage && !isError\n\n\t// Without `cancelRefetch: false`, a call while a page is in flight would abort it to ask again.\n\tconst loadMore = useCallback(() => {\n\t\tif (hasMore) void fetchNextPage({ cancelRefetch: false })\n\t}, [hasMore, fetchNextPage])\n\n\treturn { assets: data ?? null, isLoading: isFetching, error, hasMore, loadMore }\n}\n"]}

package/dist/use-libraries.d.ts

@@ -0,0 +1,19 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import { type Library, type MeLibraryAccess, type RasterApiError } from '@raster-app/sdk';
+export type LibraryWithAccess = Library & {
+    /** What the credential may do here. Null is no access (see `meLibraryAccess`). */
+    access: MeLibraryAccess['access'] | null;
+};
+/** Warm an organization's libraries, as a hover in the organization switcher does. */
+export declare function usePrefetchLibraries(): (organizationId: string, organizationName: string | null) => void;
+/**
+ * Every library in one organization, each with the credential's access to it, so a host can
+ * hide upload where it is read-only.
+ *
+ * Pass a null `organizationId` before one has been resolved; the hook then sits idle rather
+ * than fetching against a placeholder.
+ */
+export declare function useLibraries(options: {
+    organizationId: string | null;
+    organizationName?: string | null;
+}): UseQueryResult<Array<LibraryWithAccess>, RasterApiError>;

package/dist/use-libraries.js

@@ -0,0 +1,57 @@
+import { skipToken, useQuery, useQueryClient, } from '@tanstack/react-query';
+import { useCallback } from 'react';
+import { meLibraryAccess, } from '@raster-app/sdk';
+import { useRasterClient } from './context.js';
+import { rasterKeys } from './query-keys.js';
+import { meQuery } from './use-organizations.js';
+import { useCredentialIdentity } from './use-session.js';
+/** An organization's libraries with their access, as the list reads them and a hover warms them. */
+function librariesQuery(client, queryClient, identity, organizationId, organizationName) {
+    return {
+        queryKey: [...rasterKeys.libraries(identity, organizationId), organizationName],
+        queryFn: async ({ signal }) => {
+            const [libraries, me] = await Promise.all([
+                client.libraries.list({ organizationId, organizationName, signal }),
+                queryClient.fetchQuery(meQuery(client, identity)),
+            ]);
+            return libraries.map((library) => ({
+                ...library,
+                access: meLibraryAccess(me, organizationId, library.id),
+            }));
+        },
+    };
+}
+/** Warm an organization's libraries, as a hover in the organization switcher does. */
+export function usePrefetchLibraries() {
+    const client = useRasterClient();
+    const queryClient = useQueryClient();
+    const identity = useCredentialIdentity();
+    return useCallback((organizationId, organizationName) => {
+        if (identity === null)
+            return;
+        void queryClient.prefetchQuery(librariesQuery(client, queryClient, identity, organizationId, organizationName));
+    }, [client, queryClient, identity]);
+}
+/**
+ * Every library in one organization, each with the credential's access to it, so a host can
+ * hide upload where it is read-only.
+ *
+ * Pass a null `organizationId` before one has been resolved; the hook then sits idle rather
+ * than fetching against a placeholder.
+ */
+export function useLibraries(options) {
+    const { organizationId, organizationName = null } = options;
+    const client = useRasterClient();
+    const queryClient = useQueryClient();
+    const identity = useCredentialIdentity();
+    return useQuery(organizationId === null
+        ? {
+            queryKey: [...rasterKeys.libraries(identity, organizationId), organizationName],
+            queryFn: skipToken,
+        }
+        : {
+            ...librariesQuery(client, queryClient, identity, organizationId, organizationName),
+            enabled: identity !== null,
+        });
+}
+//# sourceMappingURL=use-libraries.js.map

package/dist/use-libraries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-libraries.js","sourceRoot":"","sources":["../src/use-libraries.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,SAAS,EACT,QAAQ,EACR,cAAc,GACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEnC,OAAO,EAKN,eAAe,GACf,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAOxD,oGAAoG;AACpG,SAAS,cAAc,CACtB,MAAoB,EACpB,WAAwB,EACxB,QAAuB,EACvB,cAAsB,EACtB,gBAA+B;IAE/B,OAAO;QACN,QAAQ,EAAE,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,gBAAgB,CAAC;QAC/E,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAwB,EAAqC,EAAE;YACtF,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACzC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;gBACnE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;aACjD,CAAC,CAAA;YACF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAClC,GAAG,OAAO;gBACV,MAAM,EAAE,eAAe,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,CAAC;aACvD,CAAC,CAAC,CAAA;QACJ,CAAC;KACD,CAAA;AACF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB;IAInC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IAExC,OAAO,WAAW,CACjB,CAAC,cAAc,EAAE,gBAAgB,EAAE,EAAE;QACpC,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAM;QAC7B,KAAK,WAAW,CAAC,aAAa,CAC7B,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAC/E,CAAA;IACF,CAAC,EACD,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAC/B,CAAA;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAG5B;IACA,MAAM,EAAE,cAAc,EAAE,gBAAgB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IAE3D,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IAExC,OAAO,QAAQ,CACd,cAAc,KAAK,IAAI;QACtB,CAAC,CAAC;YACA,QAAQ,EAAE,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,gBAAgB,CAAC;YAC/E,OAAO,EAAE,SAAS;SAClB;QACF,CAAC,CAAC;YACA,GAAG,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC;YAClF,OAAO,EAAE,QAAQ,KAAK,IAAI;SAC1B,CACH,CAAA;AACF,CAAC","sourcesContent":["import {\n\ttype QueryClient,\n\ttype QueryFunctionContext,\n\ttype UseQueryResult,\n\tskipToken,\n\tuseQuery,\n\tuseQueryClient,\n} from '@tanstack/react-query'\nimport { useCallback } from 'react'\n\nimport {\n\ttype Library,\n\ttype MeLibraryAccess,\n\ttype RasterApiError,\n\ttype RasterClient,\n\tmeLibraryAccess,\n} from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\nimport { rasterKeys } from './query-keys.js'\nimport { meQuery } from './use-organizations.js'\nimport { useCredentialIdentity } from './use-session.js'\n\nexport type LibraryWithAccess = Library & {\n\t/** What the credential may do here. Null is no access (see `meLibraryAccess`). */\n\taccess: MeLibraryAccess['access'] | null\n}\n\n/** An organization's libraries with their access, as the list reads them and a hover warms them. */\nfunction librariesQuery(\n\tclient: RasterClient,\n\tqueryClient: QueryClient,\n\tidentity: string | null,\n\torganizationId: string,\n\torganizationName: string | null\n) {\n\treturn {\n\t\tqueryKey: [...rasterKeys.libraries(identity, organizationId), organizationName],\n\t\tqueryFn: async ({ signal }: QueryFunctionContext): Promise<Array<LibraryWithAccess>> => {\n\t\t\tconst [libraries, me] = await Promise.all([\n\t\t\t\tclient.libraries.list({ organizationId, organizationName, signal }),\n\t\t\t\tqueryClient.fetchQuery(meQuery(client, identity)),\n\t\t\t])\n\t\t\treturn libraries.map((library) => ({\n\t\t\t\t...library,\n\t\t\t\taccess: meLibraryAccess(me, organizationId, library.id),\n\t\t\t}))\n\t\t},\n\t}\n}\n\n/** Warm an organization's libraries, as a hover in the organization switcher does. */\nexport function usePrefetchLibraries(): (\n\torganizationId: string,\n\torganizationName: string | null\n) => void {\n\tconst client = useRasterClient()\n\tconst queryClient = useQueryClient()\n\tconst identity = useCredentialIdentity()\n\n\treturn useCallback(\n\t\t(organizationId, organizationName) => {\n\t\t\tif (identity === null) return\n\t\t\tvoid queryClient.prefetchQuery(\n\t\t\t\tlibrariesQuery(client, queryClient, identity, organizationId, organizationName)\n\t\t\t)\n\t\t},\n\t\t[client, queryClient, identity]\n\t)\n}\n\n/**\n * Every library in one organization, each with the credential's access to it, so a host can\n * hide upload where it is read-only.\n *\n * Pass a null `organizationId` before one has been resolved; the hook then sits idle rather\n * than fetching against a placeholder.\n */\nexport function useLibraries(options: {\n\torganizationId: string | null\n\torganizationName?: string | null\n}): UseQueryResult<Array<LibraryWithAccess>, RasterApiError> {\n\tconst { organizationId, organizationName = null } = options\n\n\tconst client = useRasterClient()\n\tconst queryClient = useQueryClient()\n\n\tconst identity = useCredentialIdentity()\n\n\treturn useQuery<Array<LibraryWithAccess>, RasterApiError>(\n\t\torganizationId === null\n\t\t\t? {\n\t\t\t\t\tqueryKey: [...rasterKeys.libraries(identity, organizationId), organizationName],\n\t\t\t\t\tqueryFn: skipToken,\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\t...librariesQuery(client, queryClient, identity, organizationId, organizationName),\n\t\t\t\t\tenabled: identity !== null,\n\t\t\t\t}\n\t)\n}\n"]}

package/dist/use-navigation.d.ts

@@ -0,0 +1,31 @@
+import type { Asset, Library, Organization } from '@raster-app/sdk';
+export type RasterNavigation = {
+    /** The organization whose libraries are listed, or null until one is resolved. */
+    organizationId: string | null;
+    /** The open library, or null on the library list. */
+    library: Library | null;
+    /**
+     * The asset whose variants are being browsed, or null for the plain grid. Held here so a
+     * breadcrumb can tell which level the user is on.
+     */
+    asset: Asset | null;
+    /** The search box's text. */
+    query: string;
+    selectOrganization: (organizationId: string | null) => void;
+    openLibrary: (library: Library | null) => void;
+    openAsset: (asset: Asset | null) => void;
+    setQuery: (query: string) => void;
+    /** Fetch everything on screen again, by invalidating every Raster query. */
+    refresh: () => void;
+    /** True once the persisted organization and library have been read back. */
+    isRestored: boolean;
+};
+/**
+ * The `organization → library → asset` model every Raster plugin navigates, remembering the
+ * last organization and library through the provider's `state`. The level is whichever
+ * fields are set, since no host has a URL to route with; "back" sets a field to null.
+ */
+export declare function useRasterNavigation(options: {
+    /** Used to drop a remembered organization the credential no longer reaches. */
+    organizations: Array<Organization> | null;
+}): RasterNavigation;

package/dist/use-navigation.js

@@ -0,0 +1,111 @@
+import { useQueryClient } from '@tanstack/react-query';
+import { useCallback, useEffect, useState } from 'react';
+import { useStateStore } from './context.js';
+import { rasterKeys } from './query-keys.js';
+const ORGANIZATION_KEY = 'organizationId';
+const LIBRARY_KEY = 'library';
+/**
+ * The `organization → library → asset` model every Raster plugin navigates, remembering the
+ * last organization and library through the provider's `state`. The level is whichever
+ * fields are set, since no host has a URL to route with; "back" sets a field to null.
+ */
+export function useRasterNavigation(options) {
+    const { organizations } = options;
+    const queryClient = useQueryClient();
+    const state = useStateStore();
+    const [organizationId, setOrganizationId] = useState(null);
+    const [library, setLibrary] = useState(null);
+    const [asset, setAsset] = useState(null);
+    const [query, setQuery] = useState('');
+    const [restored, setRestored] = useState(null);
+    const selectOrganization = useCallback((next) => {
+        setOrganizationId(next);
+        setLibrary(null);
+        setAsset(null);
+    }, []);
+    const openLibrary = useCallback((next) => {
+        setLibrary(next);
+        setAsset(null);
+    }, []);
+    const refresh = useCallback(() => {
+        void queryClient.invalidateQueries({ queryKey: rasterKeys.all });
+    }, [queryClient]);
+    // Read what the last session left, once.
+    useEffect(() => {
+        let cancelled = false;
+        void (async () => {
+            const [savedOrganization, savedLibrary] = await Promise.all([
+                state.get(ORGANIZATION_KEY),
+                state.get(LIBRARY_KEY),
+            ]);
+            if (cancelled)
+                return;
+            setRestored({ organizationId: savedOrganization });
+            if (savedLibrary)
+                setLibrary(savedLibrary);
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [state]);
+    // Resolve the remembered organization against what the credential actually reaches. A
+    // stale id — an organization left, or a different account — is ignored rather than
+    // leaving the UI pointed at something that will 404.
+    useEffect(() => {
+        if (organizations === null || restored === null)
+            return;
+        setOrganizationId((current) => {
+            if (current !== null && organizations.some((organization) => organization.id === current)) {
+                return current;
+            }
+            const remembered = organizations.find((organization) => organization.id === restored.organizationId);
+            return remembered?.id ?? organizations[0]?.id ?? null;
+        });
+    }, [organizations, restored]);
+    // Drop a library that does not belong to the selected organization — it can arrive that
+    // way from persistence, or from switching organization with one open.
+    useEffect(() => {
+        if (organizationId === null)
+            return;
+        setLibrary((current) => current !== null && current.organizationId !== organizationId ? null : current);
+    }, [organizationId]);
+    // A query belongs to the scope it was typed in. Switching organization, opening a library
+    // or going back to the list all start the next search from a clean box — results for
+    // "beach" in one library would be a different set in the next. Reset while rendering, so no
+    // render pairs the new scope with the old query:
+    // https://react.dev/learn/you-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes
+    const [queryScope, setQueryScope] = useState({ organizationId, libraryId: library?.id });
+    if (queryScope.organizationId !== organizationId || queryScope.libraryId !== library?.id) {
+        setQueryScope({ organizationId, libraryId: library?.id });
+        setQuery('');
+    }
+    // Persist, so a reopen lands where the user was: once the last session's state has been read,
+    // since the empty library a mount starts with would otherwise erase the one being read, and
+    // React's development double mount reads it again after that.
+    useEffect(() => {
+        if (organizationId === null)
+            return;
+        void state.set(ORGANIZATION_KEY, organizationId);
+    }, [state, organizationId]);
+    useEffect(() => {
+        if (restored === null)
+            return;
+        if (library === null)
+            void state.delete(LIBRARY_KEY);
+        else
+            void state.set(LIBRARY_KEY, library);
+    }, [state, library, restored]);
+    return {
+        organizationId,
+        library,
+        asset,
+        query,
+        selectOrganization,
+        openLibrary,
+        openAsset: setAsset,
+        setQuery,
+        refresh,
+        isRestored: restored !== null,
+    };
+}
+//# sourceMappingURL=use-navigation.js.map

package/dist/use-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-navigation.js","sourceRoot":"","sources":["../src/use-navigation.ts"],"names":[],"mappings":"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","sourcesContent":["import { useQueryClient } from '@tanstack/react-query'\nimport { useCallback, useEffect, useState } from 'react'\n\nimport type { Asset, Library, Organization } from '@raster-app/sdk'\n\nimport { useStateStore } from './context.js'\nimport { rasterKeys } from './query-keys.js'\n\nconst ORGANIZATION_KEY = 'organizationId'\nconst LIBRARY_KEY = 'library'\n\nexport type RasterNavigation = {\n\t/** The organization whose libraries are listed, or null until one is resolved. */\n\torganizationId: string | null\n\t/** The open library, or null on the library list. */\n\tlibrary: Library | null\n\t/**\n\t * The asset whose variants are being browsed, or null for the plain grid. Held here so a\n\t * breadcrumb can tell which level the user is on.\n\t */\n\tasset: Asset | null\n\t/** The search box's text. */\n\tquery: string\n\n\tselectOrganization: (organizationId: string | null) => void\n\topenLibrary: (library: Library | null) => void\n\topenAsset: (asset: Asset | null) => void\n\tsetQuery: (query: string) => void\n\t/** Fetch everything on screen again, by invalidating every Raster query. */\n\trefresh: () => void\n\t/** True once the persisted organization and library have been read back. */\n\tisRestored: boolean\n}\n\n/**\n * The `organization → library → asset` model every Raster plugin navigates, remembering the\n * last organization and library through the provider's `state`. The level is whichever\n * fields are set, since no host has a URL to route with; \"back\" sets a field to null.\n */\nexport function useRasterNavigation(options: {\n\t/** Used to drop a remembered organization the credential no longer reaches. */\n\torganizations: Array<Organization> | null\n}): RasterNavigation {\n\tconst { organizations } = options\n\n\tconst queryClient = useQueryClient()\n\tconst state = useStateStore()\n\n\tconst [organizationId, setOrganizationId] = useState<string | null>(null)\n\tconst [library, setLibrary] = useState<Library | null>(null)\n\tconst [asset, setAsset] = useState<Asset | null>(null)\n\tconst [query, setQuery] = useState('')\n\tconst [restored, setRestored] = useState<{ organizationId: string | null } | null>(null)\n\n\tconst selectOrganization = useCallback((next: string | null) => {\n\t\tsetOrganizationId(next)\n\t\tsetLibrary(null)\n\t\tsetAsset(null)\n\t}, [])\n\n\tconst openLibrary = useCallback((next: Library | null) => {\n\t\tsetLibrary(next)\n\t\tsetAsset(null)\n\t}, [])\n\n\tconst refresh = useCallback(() => {\n\t\tvoid queryClient.invalidateQueries({ queryKey: rasterKeys.all })\n\t}, [queryClient])\n\n\t// Read what the last session left, once.\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\t\tvoid (async () => {\n\t\t\tconst [savedOrganization, savedLibrary] = await Promise.all([\n\t\t\t\tstate.get<string>(ORGANIZATION_KEY),\n\t\t\t\tstate.get<Library>(LIBRARY_KEY),\n\t\t\t])\n\t\t\tif (cancelled) return\n\t\t\tsetRestored({ organizationId: savedOrganization })\n\t\t\tif (savedLibrary) setLibrary(savedLibrary)\n\t\t})()\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [state])\n\n\t// Resolve the remembered organization against what the credential actually reaches. A\n\t// stale id — an organization left, or a different account — is ignored rather than\n\t// leaving the UI pointed at something that will 404.\n\tuseEffect(() => {\n\t\tif (organizations === null || restored === null) return\n\t\tsetOrganizationId((current) => {\n\t\t\tif (current !== null && organizations.some((organization) => organization.id === current)) {\n\t\t\t\treturn current\n\t\t\t}\n\t\t\tconst remembered = organizations.find(\n\t\t\t\t(organization) => organization.id === restored.organizationId\n\t\t\t)\n\t\t\treturn remembered?.id ?? organizations[0]?.id ?? null\n\t\t})\n\t}, [organizations, restored])\n\n\t// Drop a library that does not belong to the selected organization — it can arrive that\n\t// way from persistence, or from switching organization with one open.\n\tuseEffect(() => {\n\t\tif (organizationId === null) return\n\t\tsetLibrary((current) =>\n\t\t\tcurrent !== null && current.organizationId !== organizationId ? null : current\n\t\t)\n\t}, [organizationId])\n\n\t// A query belongs to the scope it was typed in. Switching organization, opening a library\n\t// or going back to the list all start the next search from a clean box — results for\n\t// \"beach\" in one library would be a different set in the next. Reset while rendering, so no\n\t// render pairs the new scope with the old query:\n\t// https://react.dev/learn/you-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes\n\tconst [queryScope, setQueryScope] = useState({ organizationId, libraryId: library?.id })\n\tif (queryScope.organizationId !== organizationId || queryScope.libraryId !== library?.id) {\n\t\tsetQueryScope({ organizationId, libraryId: library?.id })\n\t\tsetQuery('')\n\t}\n\n\t// Persist, so a reopen lands where the user was: once the last session's state has been read,\n\t// since the empty library a mount starts with would otherwise erase the one being read, and\n\t// React's development double mount reads it again after that.\n\tuseEffect(() => {\n\t\tif (organizationId === null) return\n\t\tvoid state.set(ORGANIZATION_KEY, organizationId)\n\t}, [state, organizationId])\n\n\tuseEffect(() => {\n\t\tif (restored === null) return\n\t\tif (library === null) void state.delete(LIBRARY_KEY)\n\t\telse void state.set(LIBRARY_KEY, library)\n\t}, [state, library, restored])\n\n\treturn {\n\t\torganizationId,\n\t\tlibrary,\n\t\tasset,\n\t\tquery,\n\t\tselectOrganization,\n\t\topenLibrary,\n\t\topenAsset: setAsset,\n\t\tsetQuery,\n\t\trefresh,\n\t\tisRestored: restored !== null,\n\t}\n}\n"]}