@loj-lang/rdsl-runtime 0.5.0 → 0.6.1

package/dist/hooks/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/hooks/navigation.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAU7E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE3E;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAetD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,wBAAgB,uBAAuB,IAAI,eAAe,GAAG,IAAI,CAGhE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BvE;AAMD,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtE,aAAa,EAAE,CAAC,EAChB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAClC,GACL,CAAC,CAUH;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrB,GACL,IAAI,CAuBN;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGxF;AAED,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAGzF"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/hooks/navigation.ts"],"names":[],"mappings":"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"}

package/dist/hooks/navigation.js

@@ -1,14 +1,8 @@
+import React from 'react';
+import { buildAppHrefWithSearchEntries as buildAppHrefWithSearchEntriesCore, getLocationSearchValues as getLocationSearchValuesCore, getSanitizedReturnTo as getSanitizedReturnToCore, normalizeAppBasePath as normalizeAppBasePathCore, prefixAppBasePath as prefixAppBasePathCore, sanitizeAppLocalHref as sanitizeAppLocalHrefCore, shiftDateInputValue as shiftDateInputValueCore, stripAppBasePath as stripAppBasePathCore, } from '../../../runtime-core/dist/navigation.js';
 let configuredAppBasePath = '/';
 export function normalizeAppBasePath(value) {
-    if (!value) {
-        return '/';
-    }
-    const trimmed = value.trim();
-    if (!trimmed || trimmed === '/') {
-        return '/';
-    }
-    const prefixed = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
-    return prefixed.endsWith('/') ? prefixed.slice(0, -1) || '/' : prefixed;
+    return normalizeAppBasePathCore(value);
 }
 export function configureAppBasePath(value) {
     configuredAppBasePath = normalizeAppBasePath(value);
@@ -17,34 +11,54 @@ export function getConfiguredAppBasePath() {
     return configuredAppBasePath;
 }
 export function prefixAppBasePath(path) {
-    if (!path.startsWith('/')) {
-        return path;
-    }
-    const basePath = getConfiguredAppBasePath();
-    if (basePath === '/') {
-        return path;
+    return prefixAppBasePathCore(getConfiguredAppBasePath(), path);
+}
+export function buildAppHrefWithSearchEntries(path, entries) {
+    return buildAppHrefWithSearchEntriesCore(getConfiguredAppBasePath(), path, entries);
+}
+export function buildResourceRecordHref(resourceName, recordId, options = {}) {
+    const suffix = options.surface === 'edit'
+        ? '/edit'
+        : options.surface === 'workflow'
+            ? '/workflow'
+            : '';
+    const path = `/${resourceName}/${recordId}${suffix}`;
+    return options.returnTo
+        ? buildAppHrefWithSearchEntries(path, [['returnTo', options.returnTo]])
+        : prefixAppBasePath(path);
+}
+export function buildRelatedCollectionHref(parentResourceName, recordId, relatedPath, options = {}) {
+    const path = `/${parentResourceName}/${recordId}/related/${relatedPath}`;
+    return options.returnTo
+        ? buildAppHrefWithSearchEntries(path, [['returnTo', options.returnTo]])
+        : prefixAppBasePath(path);
+}
+export function buildRelatedCreateHref(resourceName, options = {}) {
+    const entries = [];
+    if (options.inverseFieldName && options.parentId) {
+        entries.push([options.inverseFieldName, options.parentId]);
     }
-    if (path === basePath || path.startsWith(`${basePath}/`)) {
-        return path;
+    if (options.returnTo) {
+        entries.push(['returnTo', options.returnTo]);
     }
-    if (path === '/') {
-        return basePath;
+    return buildAppHrefWithSearchEntries(`/${resourceName}/create`, entries);
+}
+export function buildWorkflowStepHref(step, options) {
+    if (!step?.name) {
+        return null;
     }
-    return `${basePath}${path}`;
+    const path = step.surface === 'form'
+        ? (options.editPath ?? options.readPath ?? options.workflowPath)
+        : step.surface === 'read'
+            ? (options.readPath ?? options.workflowPath)
+            : options.workflowPath;
+    return buildAppHrefWithSearchEntries(path, [
+        ['workflowStep', step.name],
+        ...(options.returnTo ? [['returnTo', options.returnTo]] : []),
+    ]);
 }
 export function stripAppBasePath(pathname) {
-    const normalizedPathname = pathname && pathname.startsWith('/') ? pathname : `/${pathname || ''}`;
-    const basePath = getConfiguredAppBasePath();
-    if (basePath === '/') {
-        return normalizedPathname === '' ? '/' : normalizedPathname;
-    }
-    if (normalizedPathname === basePath) {
-        return '/';
-    }
-    if (normalizedPathname.startsWith(`${basePath}/`)) {
-        return normalizedPathname.slice(basePath.length) || '/';
-    }
-    return normalizedPathname === '' ? '/' : normalizedPathname;
+    return stripAppBasePathCore(getConfiguredAppBasePath(), pathname);
 }
 export function getCurrentAppPathname() {
     if (typeof window === 'undefined')
@@ -56,50 +70,41 @@ export function getCurrentAppHref() {
         return '/';
     return `${window.location.pathname}${window.location.search}`;
 }
+export function navigateToAppHref(href) {
+    if (typeof window === 'undefined' || !href) {
+        return false;
+    }
+    if (href === getCurrentAppHref()) {
+        return false;
+    }
+    window.location.assign(href);
+    return true;
+}
 export function getLocationSearchParams() {
     if (typeof window === 'undefined')
         return null;
     return new URLSearchParams(window.location.search);
 }
+export function getCurrentReturnToNavigation(fallbackHref) {
+    const searchParams = getLocationSearchParams();
+    const returnTo = getSanitizedReturnTo(searchParams);
+    return {
+        searchParams,
+        returnTo,
+        href: returnTo || fallbackHref,
+    };
+}
 export function shiftDateInputValue(value, days) {
-    const trimmed = String(value ?? '').trim();
-    const match = trimmed.match(/^(\d{4})([-/])(\d{2})\2(\d{2})$/);
-    if (!match) {
-        return trimmed;
-    }
-    const [, yearText, separator, monthText, dayText] = match;
-    const year = Number(yearText);
-    const month = Number(monthText);
-    const day = Number(dayText);
-    if (!Number.isInteger(year) || !Number.isInteger(month) || !Number.isInteger(day)) {
-        return trimmed;
-    }
-    const date = new Date(Date.UTC(year, month - 1, day));
-    if (Number.isNaN(date.getTime())
-        || date.getUTCFullYear() !== year
-        || date.getUTCMonth() !== month - 1
-        || date.getUTCDate() !== day) {
-        return trimmed;
-    }
-    date.setUTCDate(date.getUTCDate() + days);
-    const nextYear = String(date.getUTCFullYear()).padStart(4, '0');
-    const nextMonth = String(date.getUTCMonth() + 1).padStart(2, '0');
-    const nextDay = String(date.getUTCDate()).padStart(2, '0');
-    return `${nextYear}${separator}${nextMonth}${separator}${nextDay}`;
+    return shiftDateInputValueCore(value, days);
 }
 function scopedSearchParamKey(prefix, key) {
     return prefix ? `${prefix}.${key}` : key;
 }
 export function getLocationSearchValues(defaultValues, options = {}) {
-    const params = options.searchParams ?? getLocationSearchParams();
-    const nextValues = { ...defaultValues };
-    for (const key of Object.keys(defaultValues)) {
-        const value = params?.get(scopedSearchParamKey(options.prefix, key));
-        if (value !== null && value !== undefined) {
-            nextValues[key] = value;
-        }
-    }
-    return nextValues;
+    return getLocationSearchValuesCore(defaultValues, {
+        prefix: options.prefix,
+        searchParams: options.searchParams ?? getLocationSearchParams(),
+    });
 }
 export function replaceLocationSearchValues(values, options = {}) {
     if (typeof window === 'undefined') {
@@ -124,12 +129,44 @@ export function replaceLocationSearchValues(values, options = {}) {
         window.history.replaceState(window.history.state, '', nextHref);
     }
 }
+function hasSameLocationSearchValues(left, right) {
+    const keys = new Set([...Object.keys(left), ...Object.keys(right)]);
+    for (const key of keys) {
+        if ((left[key] ?? '') !== (right[key] ?? '')) {
+            return false;
+        }
+    }
+    return true;
+}
+export function useLocationSearchState(defaultValues, options = {}) {
+    const [values, setValues] = React.useState(() => getLocationSearchValues(defaultValues, { prefix: options.prefix }));
+    const setQuery = React.useCallback((next) => {
+        React.startTransition(() => {
+            setValues((previous) => typeof next === 'function'
+                ? next(previous)
+                : next);
+        });
+    }, []);
+    const deferredValues = React.useDeferredValue(values);
+    React.useEffect(() => {
+        if (typeof window === 'undefined') {
+            return undefined;
+        }
+        const syncFromLocation = () => {
+            const nextValues = getLocationSearchValues(defaultValues, { prefix: options.prefix });
+            setValues((previous) => hasSameLocationSearchValues(previous, nextValues) ? previous : nextValues);
+        };
+        window.addEventListener('popstate', syncFromLocation);
+        return () => window.removeEventListener('popstate', syncFromLocation);
+    }, [defaultValues, options.prefix]);
+    React.useEffect(() => {
+        replaceLocationSearchValues(values, { prefix: options.prefix, keys: options.keys });
+    }, [options.keys, options.prefix, values]);
+    return [values, setQuery, deferredValues];
+}
 export function sanitizeAppLocalHref(candidate) {
-    if (!candidate || !candidate.startsWith('/') || candidate.startsWith('//'))
-        return null;
-    return candidate;
+    return sanitizeAppLocalHrefCore(candidate);
 }
 export function getSanitizedReturnTo(searchParams) {
-    const params = searchParams ?? getLocationSearchParams();
-    return sanitizeAppLocalHref(params?.get('returnTo'));
+    return getSanitizedReturnToCore(searchParams ?? getLocationSearchParams());
 }

package/dist/hooks/readModelStore.d.ts

@@ -0,0 +1,29 @@
+export interface ReadModelStoreResult<T extends {
+    id: string;
+}> {
+    items: T[];
+    page: number;
+    totalItems: number;
+    totalPages: number;
+}
+export interface ReadModelStoreSnapshot<T extends {
+    id: string;
+}> {
+    result: ReadModelStoreResult<T> | null;
+    error: unknown;
+    pendingCount: number;
+    resolvedOnce: boolean;
+}
+export interface ReadModelStore<T extends {
+    id: string;
+}> {
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): ReadModelStoreSnapshot<T>;
+    load(force?: boolean): Promise<ReadModelStoreResult<T>>;
+}
+export declare function getReadModelStore<T extends {
+    id: string;
+}>(client: object, requestUrl: string, loader: () => Promise<ReadModelStoreResult<T>>): ReadModelStore<T>;
+export declare function clearReadModelStores(): void;
+export declare function resetReadModelStoreTestState(): void;
+//# sourceMappingURL=readModelStore.d.ts.map

package/dist/hooks/readModelStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readModelStore.d.ts","sourceRoot":"","sources":["../../src/hooks/readModelStore.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC5D,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC9D,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACtD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,WAAW,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;CACzD;AAqJD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACxD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,GAC7C,cAAc,CAAC,CAAC,CAAC,CAOnB;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

package/dist/hooks/readModelStore.js

@@ -0,0 +1,135 @@
+const readModelStores = new Map();
+const resourceClientIds = new WeakMap();
+let nextClientId = 1;
+function storeKey(client, requestUrl) {
+    let id = resourceClientIds.get(client);
+    if (!id) {
+        id = nextClientId;
+        nextClientId += 1;
+        resourceClientIds.set(client, id);
+    }
+    return `${id}:${requestUrl}`;
+}
+function notifyState(state) {
+    for (const listener of state.listeners) {
+        listener();
+    }
+}
+function createReadModelStore(requestUrl, loader) {
+    const state = {
+        result: null,
+        listeners: new Set(),
+        error: null,
+        pendingCount: 0,
+        resolvedOnce: false,
+        inFlightLoad: null,
+        pendingForceLoad: null,
+        queuedForceReload: false,
+        loadSequence: 0,
+    };
+    function emptyResult() {
+        return {
+            items: [],
+            page: 1,
+            totalItems: 0,
+            totalPages: 1,
+        };
+    }
+    function isStaleLoad(requestSequence) {
+        return requestSequence !== state.loadSequence;
+    }
+    function load(force = false) {
+        if (!force && state.resolvedOnce && !state.error && state.result) {
+            return Promise.resolve(state.result);
+        }
+        if (state.inFlightLoad) {
+            if (!force) {
+                return state.inFlightLoad;
+            }
+            state.queuedForceReload = true;
+            if (state.pendingForceLoad) {
+                return state.pendingForceLoad;
+            }
+            state.pendingForceLoad = state.inFlightLoad
+                .catch(() => state.result ?? emptyResult())
+                .then(() => {
+                if (!state.queuedForceReload) {
+                    return state.result ?? emptyResult();
+                }
+                state.queuedForceReload = false;
+                return load(true);
+            })
+                .finally(() => {
+                state.pendingForceLoad = null;
+            });
+            return state.pendingForceLoad;
+        }
+        state.pendingCount += 1;
+        state.error = null;
+        notifyState(state);
+        const requestSequence = state.loadSequence + 1;
+        state.loadSequence = requestSequence;
+        state.inFlightLoad = loader()
+            .then((result) => {
+            if (isStaleLoad(requestSequence)) {
+                return state.result ?? emptyResult();
+            }
+            state.result = {
+                items: [...result.items],
+                page: Number(result.page ?? 1),
+                totalItems: Number(result.totalItems ?? result.items.length),
+                totalPages: Math.max(1, Number(result.totalPages ?? 1)),
+            };
+            state.error = null;
+            state.resolvedOnce = true;
+            return state.result;
+        })
+            .catch((error) => {
+            if (isStaleLoad(requestSequence)) {
+                return state.result ?? emptyResult();
+            }
+            state.error = error;
+            state.resolvedOnce = true;
+            throw error;
+        })
+            .finally(() => {
+            state.pendingCount = Math.max(0, state.pendingCount - 1);
+            state.inFlightLoad = null;
+            notifyState(state);
+        });
+        return state.inFlightLoad;
+    }
+    return {
+        subscribe(listener) {
+            state.listeners.add(listener);
+            return () => {
+                state.listeners.delete(listener);
+            };
+        },
+        getSnapshot() {
+            return {
+                result: state.result,
+                error: state.error,
+                pendingCount: state.pendingCount,
+                resolvedOnce: state.resolvedOnce,
+            };
+        },
+        load,
+    };
+}
+export function getReadModelStore(client, requestUrl, loader) {
+    const key = storeKey(client, requestUrl);
+    const existing = readModelStores.get(key);
+    if (existing)
+        return existing;
+    const created = createReadModelStore(requestUrl, loader);
+    readModelStores.set(key, created);
+    return created;
+}
+export function clearReadModelStores() {
+    readModelStores.clear();
+}
+export function resetReadModelStoreTestState() {
+    readModelStores.clear();
+    nextClientId = 1;
+}

package/dist/hooks/recordScopedWorkflow.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowStateMetaDescriptor, WorkflowStateSummaryDescriptor, WorkflowStepMetaDescriptor, WorkflowTransitionMetaDescriptor } from '@loj-lang/shared-contracts';
+export interface RecordScopedWorkflowSummaryOptions<TRecord extends object> {
+    currentUser: unknown;
+    record: TRecord | null;
+    workflowField: string;
+    defaultState: string;
+    workflowHref: string;
+    workflowSteps: WorkflowStepMetaDescriptor[];
+    workflowTransitions: WorkflowTransitionMetaDescriptor[];
+    workflowStates: WorkflowStateMetaDescriptor[];
+}
+export declare function useRecordScopedWorkflowSummary<TRecord extends object>({ currentUser, record, workflowField, defaultState, workflowHref, workflowSteps, workflowTransitions, workflowStates, }: RecordScopedWorkflowSummaryOptions<TRecord>): WorkflowStateSummaryDescriptor | null;
+//# sourceMappingURL=recordScopedWorkflow.d.ts.map

package/dist/hooks/recordScopedWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordScopedWorkflow.d.ts","sourceRoot":"","sources":["../../src/hooks/recordScopedWorkflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EACjC,MAAM,4BAA4B,CAAC;AAGpC,MAAM,WAAW,kCAAkC,CAAC,OAAO,SAAS,MAAM;IACxE,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,0BAA0B,EAAE,CAAC;IAC5C,mBAAmB,EAAE,gCAAgC,EAAE,CAAC;IACxD,cAAc,EAAE,2BAA2B,EAAE,CAAC;CAC/C;AAQD,wBAAgB,8BAA8B,CAAC,OAAO,SAAS,MAAM,EAAE,EACrE,WAAW,EACX,MAAM,EACN,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,EAAE,kCAAkC,CAAC,OAAO,CAAC,GAAG,8BAA8B,GAAG,IAAI,CAgCrF"}

package/dist/hooks/recordScopedWorkflow.js

@@ -0,0 +1,40 @@
+import React from 'react';
+import { can } from '../policies/can.js';
+function matchesWorkflowCurrentState(step, currentState) {
+    return step.currentStateMatch === 'activation'
+        ? step.activationState === currentState
+        : step.targetState === currentState;
+}
+export function useRecordScopedWorkflowSummary({ currentUser, record, workflowField, defaultState, workflowHref, workflowSteps, workflowTransitions, workflowStates, }) {
+    return React.useMemo(() => {
+        if (!record) {
+            return null;
+        }
+        const recordValues = record;
+        const currentState = String(recordValues[workflowField] ?? defaultState);
+        const currentStateLabel = workflowStates.find((state) => state.name === currentState)?.label ?? currentState;
+        const visibleWorkflowSteps = workflowSteps.filter((step) => !step.allow || can(step.allow, { currentUser, record, formData: record }));
+        const activeWorkflowIndex = visibleWorkflowSteps.findIndex((step) => matchesWorkflowCurrentState(step, currentState));
+        const availableWorkflowTransitions = workflowTransitions.filter((transition) => transition.from.includes(currentState) && (!transition.allow || can(transition.allow, { currentUser, record })));
+        return {
+            field: workflowField,
+            currentState,
+            currentStateLabel,
+            workflowHref,
+            steps: visibleWorkflowSteps.map((step, index) => ({
+                name: step.name,
+                targetState: step.targetState,
+                completionTransition: step.completionTransition ?? null,
+                status: index < activeWorkflowIndex ? 'done' : index === activeWorkflowIndex ? 'current' : 'upcoming',
+            })),
+            transitions: availableWorkflowTransitions.map((transition) => ({
+                name: transition.name,
+                label: transition.label ?? transition.templateName ?? transition.name,
+                templateName: transition.templateName ?? transition.name,
+                expandedFrom: transition.expandedFrom ?? undefined,
+                to: transition.to,
+                toLabel: workflowStates.find((state) => state.name === transition.to)?.label ?? transition.to,
+            })),
+        };
+    }, [currentUser, defaultState, record, workflowField, workflowHref, workflowStates, workflowSteps, workflowTransitions]);
+}

package/dist/hooks/resourceClient.d.ts

@@ -1,8 +1,15 @@
+import type { AuthState } from './useAuth.js';
+export { ResourceClientError } from '../../../runtime-core/dist/resourceHttp.js';
+export type { ResourceClientErrorInit } from '../../../runtime-core/dist/resourceHttp.js';
+export type { ResourceFieldError } from '../../../runtime-core/dist/resourceErrors.js';
 export interface ResourceClient {
     get<T>(path: string): Promise<T>;
     list<T extends {
         id: string;
     }>(api: string): Promise<T[]>;
+    listPage<T extends {
+        id: string;
+    }>(api: string, query?: ResourceListQuery): Promise<ResourceListPage<T>>;
     create<T extends {
         id: string;
     }>(api: string, input: Partial<T>): Promise<T>;
@@ -10,8 +17,35 @@ export interface ResourceClient {
         id: string;
     }>(api: string, id: string, input: Partial<T>): Promise<T>;
     delete(api: string, id: string): Promise<void>;
+    batch(api: string, action: string, ids: string[]): Promise<void>;
+    export(api: string, format: string, query?: ResourceListQuery): Promise<ResourceExportPayload>;
     post<T>(path: string, input?: unknown): Promise<T>;
 }
+export interface ResourceListQuery {
+    page?: number;
+    size?: number;
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    } | null;
+    filters?: Record<string, string>;
+    projections?: string[];
+    fields?: string[];
+}
+export interface ResourceListPage<T extends {
+    id: string;
+}> {
+    items: T[];
+    page: number;
+    size: number;
+    totalItems: number;
+    totalPages: number;
+}
+export interface ResourceExportPayload {
+    bytes: ArrayBuffer;
+    contentType?: string;
+    filename?: string;
+}
 export interface ResourceProviderProps {
     client: ResourceClient;
     children?: React.ReactNode;
@@ -19,12 +53,16 @@ export interface ResourceProviderProps {
 export interface FetchResourceClientOptions {
     baseUrl?: string;
     headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    auth?: AuthState | (() => AuthState | Promise<AuthState | null | undefined> | null | undefined) | null;
     credentials?: RequestCredentials;
     fetch?: typeof fetch;
 }
 export declare function normalizeListPayload<T extends {
     id: string;
 }>(payload: unknown, api: string): T[];
+export declare function normalizeListPagePayload<T extends {
+    id: string;
+}>(payload: unknown, api: string, query?: ResourceListQuery): ResourceListPage<T>;
 export declare function normalizeRecordPayload<T extends {
     id: string;
 }>(payload: unknown, api: string, operation: string): T;
@@ -32,5 +70,6 @@ export declare function createFetchResourceClient(options?: FetchResourceClientO
 export declare function createMemoryResourceClient(): ResourceClient;
 export declare function ResourceProvider({ client, children }: ResourceProviderProps): any;
 export declare function useResourceClient(): ResourceClient;
+export declare function clearResourceClientCaches(): void;
 export declare function resetResourceClientTestState(): void;
 //# sourceMappingURL=resourceClient.d.ts.map

package/dist/hooks/resourceClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceClient.d.ts","sourceRoot":"","sources":["../../src/hooks/resourceClient.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACnE,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AA2DD,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC3D,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,CAAC,EAAE,CAcL;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC7D,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,CAAC,CAQH;AA4CD,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,0BAA+B,GAAG,cAAc,CAkFlG;AAED,wBAAgB,0BAA0B,IAAI,cAAc,CAwC3D;AAqCD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,qBAAqB,OAE3E;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAIlD;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAKnD"}
+{"version":3,"file":"resourceClient.d.ts","sourceRoot":"","sources":["../../src/hooks/resourceClient.ts"],"names":[],"mappings":"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"}