@ic-reactor/react 3.12.5 → 4.0.0-beta.1

package/dist/utils.js

@@ -1,105 +0,0 @@
-/**
- * Shared internal utilities for query and mutation factories.
- */
-import { generateKey } from "@ic-reactor/core";
-/**
- * Internal query-key segment used to distinguish per-call factory args
- * from the base query key. Not part of the public API.
- */
-export const FACTORY_KEY_ARGS_QUERY_KEY = "__ic_reactor_factory_key_args";
-/** Convert a direct reactor result into a value TanStack Query can cache. */
-export const normalizeQueryData = (value) => (value === undefined ? null : value);
-/**
- * Merge a base query key, optional per-call query key, and optional key-args
- * into a single query key array.
- *
- * Used by createInfiniteQueryFactory and createSuspenseInfiniteQueryFactory to
- * ensure each unique set of factory args produces a distinct cache entry.
- */
-export function mergeFactoryQueryKey(baseQueryKey, callQueryKey, keyArgs) {
-    const merged = [];
-    if (baseQueryKey)
-        merged.push(...baseQueryKey);
-    if (callQueryKey)
-        merged.push(...callQueryKey);
-    if (keyArgs !== undefined) {
-        // Serialize keyArgs through generateKey so BigInt values (and other
-        // non-JSON-serializable Candid types such as Principal) are safely
-        // converted to strings before React Query hashes the key.
-        const safeKeyArgs = generateKey(Array.isArray(keyArgs) ? keyArgs : [keyArgs]);
-        merged.push({ [FACTORY_KEY_ARGS_QUERY_KEY]: safeKeyArgs });
-    }
-    return merged.length > 0 ? merged : undefined;
-}
-/**
- * Build a chained select that applies the config-level select (if any) and then
- * the hook-level select (if any).
- *
- * Returns the caller's own function untouched when only one of the two is
- * present, and `undefined` when neither is — allocating a wrapper only for the
- * genuinely chained case. Identity matters here: `QueryObserver` memoizes a
- * select result on `options.select === previousSelectFn`, so a wrapper rebuilt
- * on every render defeats that check. The select then re-runs each render, and
- * for a select returning a non-plain value (a `Map`, a `Date`, a `Principal`)
- * `replaceEqualDeep` cannot structurally share the result either, so `data`
- * gets a fresh reference every render and a `useEffect([data])` that sets state
- * becomes an unbounded loop.
- *
- * Callers should still memoize the result, since the chained case allocates.
- */
-export function buildChainedSelect(configSelect, hookSelect) {
-    if (!configSelect) {
-        // `hookSelect` receives the raw data when there is no config-level select,
-        // matching the previous behaviour.
-        return hookSelect;
-    }
-    if (!hookSelect)
-        return configSelect;
-    return (rawData) => hookSelect(configSelect(rawData));
-}
-/**
- * How many memoized query objects an args-late factory keeps.
- *
- * The memo exists so `getBalance(sameArgs)` returns the same object twice; it
- * was unbounded, so an open-ended argument space — a per-principal balance in a
- * long-lived SPA, a search-as-you-type filter, a cursor-keyed list — grew it
- * forever (measured at ~2.9 kB per entry, 55.8 MB for 20k). A few hundred
- * covers any realistic working set while capping the worst case.
- */
-const FACTORY_CACHE_LIMIT = 256;
-/**
- * Smallest useful LRU: a `Map` already iterates in insertion order, so
- * re-inserting on read is enough to track recency.
- *
- * Eviction is safe — it costs memoization, never correctness. A query object is
- * a closure over the reactor and config, so one rebuilt after eviction behaves
- * identically; only its reference identity differs.
- */
-export function createBoundedCache(limit = FACTORY_CACHE_LIMIT) {
-    const entries = new Map();
-    return {
-        get(key) {
-            const value = entries.get(key);
-            if (value === undefined)
-                return undefined;
-            // Touch: move to the most-recent end.
-            entries.delete(key);
-            entries.set(key, value);
-            return value;
-        },
-        set(key, value) {
-            if (entries.has(key))
-                entries.delete(key);
-            else if (entries.size >= limit) {
-                const oldest = entries.keys().next().value;
-                if (oldest !== undefined)
-                    entries.delete(oldest);
-            }
-            entries.set(key, value);
-        },
-        get size() {
-            return entries.size;
-        },
-    };
-}
-//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/validation.d.ts

@@ -1,131 +0,0 @@
-/**
- * Validation utilities for React
- *
- * Helpers for working with ValidationError in React components,
- * especially for form integration.
- */
-import { ValidationError, isValidationError, ValidationIssue } from "@ic-reactor/core";
-export { isValidationError, ValidationError };
-export type { ValidationIssue };
-/**
- * A map of field names to error messages.
- * This format is compatible with most form libraries.
- */
-export type FieldErrors = Record<string, string>;
-/**
- * A map of field names to arrays of error messages.
- * Use when you need to show multiple errors per field.
- */
-export type FieldErrorsMultiple = Record<string, string[]>;
-/**
- * Options for mapValidationErrors
- */
-export interface MapValidationErrorsOptions {
-    /**
-     * If true, returns all messages for each field as an array.
-     * If false (default), returns only the first message for each field.
-     */
-    multiple?: boolean;
-}
-/**
- * Maps validation error issues to a simple field -> message object.
- * Returns the first error message for each field path.
- *
- * @example
- * ```tsx
- * const { mutate } = useActorMutation({
- *   functionName: "transfer",
- *   onError: (error) => {
- *     if (isValidationError(error)) {
- *       const fieldErrors = mapValidationErrors(error)
- *       // { to: "Recipient is required", amount: "Must be a number" }
- *
- *       // Use with React Hook Form
- *       Object.entries(fieldErrors).forEach(([field, message]) => {
- *         form.setError(field, { message })
- *       })
- *     }
- *   }
- * })
- * ```
- */
-export declare function mapValidationErrors(error: ValidationError): FieldErrors;
-export declare function mapValidationErrors(error: ValidationError, options: {
-    multiple: true;
-}): FieldErrorsMultiple;
-export declare function mapValidationErrors(error: ValidationError, options: {
-    multiple: false;
-}): FieldErrors;
-/**
- * Gets error message for a specific field from a ValidationError.
- * Returns undefined if no error exists for that field.
- *
- * @example
- * ```tsx
- * if (isValidationError(error)) {
- *   const toError = getFieldError(error, "to")
- *   const amountError = getFieldError(error, "amount")
- * }
- * ```
- */
-export declare function getFieldError(error: ValidationError, fieldName: string): string | undefined;
-/**
- * Gets all error messages for a specific field from a ValidationError.
- * Returns empty array if no errors exist for that field.
- *
- * @example
- * ```tsx
- * if (isValidationError(error)) {
- *   const amountErrors = getFieldErrors(error, "amount")
- *   // ["Amount is required", "Amount must be positive"]
- * }
- * ```
- */
-export declare function getFieldErrors(error: ValidationError, fieldName: string): string[];
-/**
- * Checks if a given error is a ValidationError and optionally
- * extracts field errors in one step.
- *
- * @example
- * ```tsx
- * const { mutateAsync } = useActorMutation({ functionName: "transfer" })
- *
- * const handleSubmit = async (data) => {
- *   try {
- *     await mutateAsync([data])
- *   } catch (error) {
- *     const fieldErrors = extractValidationErrors(error)
- *     if (fieldErrors) {
- *       // Handle validation errors
- *       Object.entries(fieldErrors).forEach(([field, message]) => {
- *         form.setError(field, { message })
- *       })
- *     } else {
- *       // Handle other errors
- *       console.error(error)
- *     }
- *   }
- * }
- * ```
- */
-export declare function extractValidationErrors(error: unknown): FieldErrors | null;
-/**
- * React hook-friendly error handler that extracts validation errors.
- * Returns a callback suitable for onError handlers.
- *
- * @example
- * ```tsx
- * const [fieldErrors, setFieldErrors] = useState<FieldErrors>({})
- *
- * const { mutate } = useActorMutation({
- *   functionName: "transfer",
- *   onError: handleValidationError(setFieldErrors),
- * })
- *
- * // In JSX
- * <input name="to" />
- * {fieldErrors.to && <span className="error">{fieldErrors.to}</span>}
- * ```
- */
-export declare function handleValidationError(setFieldErrors: (errors: FieldErrors) => void, onOtherError?: (error: Error) => void): (error: Error) => void;
-//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAAA;AACxE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAC1B,mBAAmB,CAAA;AACtB,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,GAC3B,WAAW,CAAA;AA2Bd;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAK1E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,EAC7C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GACpC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CASxB"}

package/dist/validation.js

@@ -1,125 +0,0 @@
-/**
- * Validation utilities for React
- *
- * Helpers for working with ValidationError in React components,
- * especially for form integration.
- */
-import { ValidationError, isValidationError, } from "@ic-reactor/core";
-// Re-export for convenience
-export { isValidationError, ValidationError };
-export function mapValidationErrors(error, options) {
-    if (options?.multiple) {
-        const result = {};
-        for (const issue of error.issues) {
-            const fieldName = String(issue.path[0] ?? "");
-            if (!result[fieldName]) {
-                result[fieldName] = [];
-            }
-            result[fieldName].push(issue.message);
-        }
-        return result;
-    }
-    const result = {};
-    for (const issue of error.issues) {
-        const fieldName = String(issue.path[0] ?? "");
-        if (!result[fieldName]) {
-            result[fieldName] = issue.message;
-        }
-    }
-    return result;
-}
-/**
- * Gets error message for a specific field from a ValidationError.
- * Returns undefined if no error exists for that field.
- *
- * @example
- * ```tsx
- * if (isValidationError(error)) {
- *   const toError = getFieldError(error, "to")
- *   const amountError = getFieldError(error, "amount")
- * }
- * ```
- */
-export function getFieldError(error, fieldName) {
-    const issue = error.issues.find((i) => String(i.path[0]) === fieldName);
-    return issue?.message;
-}
-/**
- * Gets all error messages for a specific field from a ValidationError.
- * Returns empty array if no errors exist for that field.
- *
- * @example
- * ```tsx
- * if (isValidationError(error)) {
- *   const amountErrors = getFieldErrors(error, "amount")
- *   // ["Amount is required", "Amount must be positive"]
- * }
- * ```
- */
-export function getFieldErrors(error, fieldName) {
-    return error.issues
-        .filter((i) => String(i.path[0]) === fieldName)
-        .map((i) => i.message);
-}
-/**
- * Checks if a given error is a ValidationError and optionally
- * extracts field errors in one step.
- *
- * @example
- * ```tsx
- * const { mutateAsync } = useActorMutation({ functionName: "transfer" })
- *
- * const handleSubmit = async (data) => {
- *   try {
- *     await mutateAsync([data])
- *   } catch (error) {
- *     const fieldErrors = extractValidationErrors(error)
- *     if (fieldErrors) {
- *       // Handle validation errors
- *       Object.entries(fieldErrors).forEach(([field, message]) => {
- *         form.setError(field, { message })
- *       })
- *     } else {
- *       // Handle other errors
- *       console.error(error)
- *     }
- *   }
- * }
- * ```
- */
-export function extractValidationErrors(error) {
-    if (isValidationError(error)) {
-        return mapValidationErrors(error);
-    }
-    return null;
-}
-/**
- * React hook-friendly error handler that extracts validation errors.
- * Returns a callback suitable for onError handlers.
- *
- * @example
- * ```tsx
- * const [fieldErrors, setFieldErrors] = useState<FieldErrors>({})
- *
- * const { mutate } = useActorMutation({
- *   functionName: "transfer",
- *   onError: handleValidationError(setFieldErrors),
- * })
- *
- * // In JSX
- * <input name="to" />
- * {fieldErrors.to && <span className="error">{fieldErrors.to}</span>}
- * ```
- */
-export function handleValidationError(setFieldErrors, onOtherError) {
-    return (error) => {
-        const fieldErrors = extractValidationErrors(error);
-        if (fieldErrors) {
-            setFieldErrors(fieldErrors);
-        }
-        else if (onOtherError) {
-            onOtherError(error);
-        }
-    };
-}
-//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,iBAAiB,GAElB,MAAM,kBAAkB,CAAA;AAEzB,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAA;AAyD7C,MAAM,UAAU,mBAAmB,CACjC,KAAsB,EACtB,OAAoC;IAEpC,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,MAAM,MAAM,GAAwB,EAAE,CAAA;QACtC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;YACxB,CAAC;YACD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,OAAO,CAAA;QACnC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAsB,EACtB,SAAiB;IAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAA;IACvE,OAAO,KAAK,EAAE,OAAO,CAAA;AACvB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAsB,EACtB,SAAiB;IAEjB,OAAO,KAAK,CAAC,MAAM;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CACnC,cAA6C,EAC7C,YAAqC;IAErC,OAAO,CAAC,KAAY,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;QAClD,IAAI,WAAW,EAAE,CAAC;YAChB,cAAc,CAAC,WAAW,CAAC,CAAA;QAC7B,CAAC;aAAM,IAAI,YAAY,EAAE,CAAC;YACxB,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}