storion 0.8.3 → 0.10.0

package/dist/async/safe.d.ts

@@ -0,0 +1,221 @@
+import { Abortable } from './abortable';
+
+/**
+ * Check if a value is a PromiseLike (has a .then method).
+ *
+ * @example
+ * isPromiseLike(Promise.resolve(1)) // true
+ * isPromiseLike({ then: () => {} }) // true
+ * isPromiseLike(42) // false
+ */
+export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+/**
+ * Convert a value or parameterless function to a Promise.
+ * Handles: PromiseLike, sync values, functions returning either.
+ *
+ * @example
+ * toPromise(42)                    // Promise.resolve(42)
+ * toPromise(Promise.resolve(42))   // Promise.resolve(42)
+ * toPromise(() => 42)              // Promise.resolve(42)
+ * toPromise(() => fetchData())     // fetchData() promise
+ * toPromise(thenable)              // Promise wrapping thenable
+ */
+export declare function toPromise<T>(value: T | (() => T)): Promise<Awaited<T>>;
+/**
+ * Safe input: any value or parameterless function.
+ * Functions are invoked and their return value is processed.
+ */
+export type SafeInput<T> = T | (() => T);
+/**
+ * Extract the resolved type from a SafeInput.
+ */
+export type SafeInputResult<T> = T extends () => infer R ? Awaited<R> : Awaited<T>;
+type SafeAllArrayResult<T extends readonly SafeInput<any>[]> = {
+    -readonly [K in keyof T]: SafeInputResult<T[K]>;
+};
+type SafeAllObjectResult<T extends Record<string, SafeInput<any>>> = {
+    [K in keyof T]: SafeInputResult<T[K]>;
+};
+export interface SafeAll {
+    /**
+     * Wait for all inputs to complete. Returns array preserving order and types.
+     *
+     * @example
+     * const [user, posts] = await safe.all([fetchUser(), () => fetchPosts()]);
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeAllArrayResult<T>>;
+    /**
+     * Wait for all inputs to complete. Returns object preserving keys.
+     *
+     * @example
+     * const { user, posts } = await safe.all({
+     *   user: fetchUser(),
+     *   posts: () => fetchPosts(),
+     * });
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeAllObjectResult<T>>;
+}
+type SafeRaceArrayResult<T extends readonly SafeInput<any>[]> = SafeInputResult<T[number]>;
+type SafeRaceObjectResult<T extends Record<string, SafeInput<any>>> = {
+    [K in keyof T]: [K, SafeInputResult<T[K]>];
+}[keyof T];
+export interface SafeRace {
+    /**
+     * Race inputs. Returns the first value to resolve.
+     *
+     * @example
+     * const fastest = await safe.race([api1(), api2(), api3()]);
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeRaceArrayResult<T>>;
+    /**
+     * Race inputs. Returns [winnerKey, value] tuple.
+     *
+     * @example
+     * const [winner, value] = await safe.race({
+     *   primary: primaryApi(),
+     *   fallback: fallbackApi(),
+     * });
+     * // winner: "primary" | "fallback"
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeRaceObjectResult<T>>;
+}
+type SafeSettledArrayResult<T extends readonly SafeInput<any>[]> = {
+    -readonly [K in keyof T]: PromiseSettledResult<SafeInputResult<T[K]>>;
+};
+type SafeSettledObjectResult<T extends Record<string, SafeInput<any>>> = {
+    [K in keyof T]: PromiseSettledResult<SafeInputResult<T[K]>>;
+};
+export interface SafeSettled {
+    /**
+     * Wait for all inputs to settle (resolve or reject).
+     *
+     * @example
+     * const results = await safe.settled([api1(), api2()]);
+     * results.forEach(r => {
+     *   if (r.status === "fulfilled") console.log(r.value);
+     *   else console.error(r.reason);
+     * });
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeSettledArrayResult<T>>;
+    /**
+     * Wait for all inputs to settle. Returns object with PromiseSettledResult values.
+     *
+     * @example
+     * const { user, posts } = await safe.settled({
+     *   user: fetchUser(),
+     *   posts: fetchPosts(),
+     * });
+     * if (user.status === "fulfilled") console.log(user.value);
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeSettledObjectResult<T>>;
+}
+export interface SafeAny {
+    /**
+     * Returns the first successful result. Throws AggregateError if all fail.
+     *
+     * @example
+     * const result = await safe.any([api1(), api2(), api3()]);
+     */
+    <T extends readonly SafeInput<any>[]>(inputs: [...T]): Promise<SafeRaceArrayResult<T>>;
+    /**
+     * Returns [winnerKey, value] for first success. Throws AggregateError if all fail.
+     *
+     * @example
+     * const [winner, value] = await safe.any({
+     *   primary: primaryApi(),
+     *   fallback: fallbackApi(),
+     * });
+     */
+    <T extends Record<string, SafeInput<any>>>(inputs: T): Promise<SafeRaceObjectResult<T>>;
+}
+export interface SafeCallback {
+    /**
+     * Wrap a callback to only execute if not cancelled.
+     * If cancelled, the callback is a no-op.
+     *
+     * @example
+     * const handleClick = safe.callback((e: MouseEvent) => {
+     *   state.clicked = true;
+     * });
+     * document.addEventListener('click', handleClick);
+     */
+    <TArgs extends any[]>(callback: (...args: TArgs) => void): (...args: TArgs) => void;
+}
+/**
+ * Safe function type returned by createSafe.
+ *
+ * Overloads:
+ * 1. `safe(promise)` - Wrap promise, never resolve/reject if cancelled
+ * 2. `safe(normalFn, ...args)` - Call function, wrap result if promise
+ * 3. `safe(Abortable, ...args)` - Call with signal, wrap result if promise
+ */
+export interface SafeFn {
+    /**
+     * Wrap a promise to never resolve/reject if cancelled.
+     *
+     * @example
+     * ctx.safe(fetchData()).then(data => {
+     *   // Only runs if not cancelled
+     *   state.data = data;
+     * });
+     */
+    <T>(promise: PromiseLike<T>): Promise<T>;
+    /**
+     * Call a normal function and wrap result if it's a promise.
+     *
+     * @example
+     * const result = await ctx.safe(myAsyncFn, arg1, arg2);
+     */
+    <TArgs extends any[], TResult>(fn: (...args: TArgs) => TResult, ...args: TArgs): TResult extends PromiseLike<infer U> ? Promise<U> : TResult;
+    /**
+     * Call an abortable function with the context's signal.
+     * Wraps result if it's a promise.
+     *
+     * @example
+     * const user = await ctx.safe(getUser, userId);
+     */
+    <TArgs extends any[], TResult>(fn: Abortable<TArgs, TResult>, ...args: TArgs): TResult extends PromiseLike<infer U> ? Promise<U> : TResult;
+}
+/**
+ * Safe function with utility methods for concurrent operations.
+ */
+export interface SafeFnWithUtils extends SafeFn {
+    /** Wait for all inputs to complete */
+    all: SafeAll;
+    /** Race inputs, return first to resolve */
+    race: SafeRace;
+    /** Wait for all inputs to settle (resolve or reject) */
+    settled: SafeSettled;
+    /** Return first successful result */
+    any: SafeAny;
+    /** Wrap callback to only execute if not cancelled */
+    callback: SafeCallback;
+}
+/**
+ * Create a safe function for a given context.
+ *
+ * @param getSignal - Function to get the current AbortSignal
+ * @param isCancelled - Function to check if the context is cancelled/stale
+ * @returns A safe function with utility methods
+ *
+ * @example
+ * ```ts
+ * const safe = createSafe(
+ *   () => abortController.signal,
+ *   () => abortController.signal.aborted
+ * );
+ *
+ * // Wrap promise
+ * await safe(fetchData());
+ *
+ * // Call abortable function
+ * await safe(getUser, userId);
+ *
+ * // Concurrent operations
+ * const [a, b] = await safe.all([fetchA(), fetchB()]);
+ * const fastest = await safe.race([api1(), api2()]);
+ * ```
+ */
+export declare function createSafe(getSignal: () => AbortSignal | undefined, isCancelled: () => boolean): SafeFnWithUtils;
+export {};
+//# sourceMappingURL=safe.d.ts.map

package/dist/async/safe.d.ts.map

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

package/dist/async/types.d.ts

@@ -1,3 +1,5 @@
+import { ActionsBase, StateBase, StoreSpec, StoreTuple } from '../types';
+
 /**
  * Async data mode:
  * - "fresh": data is undefined during loading/error (only show fresh data)
@@ -116,36 +118,33 @@ export interface AsyncContext {
     /** AbortSignal for cancellation */
     signal: AbortSignal;
     /**
-     * Wrap a promise to never resolve if the async operation is cancelled.
-     * Useful for nested async operations that should be cancelled together.
+     * Safely execute operations that should be cancelled together.
      *
-     * @example
-     * async(focus, async (ctx) => {
-     *   const data1 = await ctx.safe(fetch('/api/1'));
-     *   const data2 = await ctx.safe(fetch('/api/2'));
-     *   return { data1, data2 };
-     * });
-     */
-    safe<T>(promise: Promise<T>): Promise<T>;
-    /**
-     * Wrap a callback to not run if the async operation is cancelled.
-     * Useful for event handlers and timeouts.
+     * Overloads:
+     * 1. `safe(promise)` - Wrap promise, never resolve/reject if cancelled
+     * 2. `safe(fn, ...args)` - Call function, wrap result if promise
+     * 3. `safe(Abortable, ...args)` - Call with signal, wrap result if promise
      *
      * @example
-     * async(focus, async (ctx) => {
-     *   setTimeout(ctx.safe(() => {
-     *     // Only runs if not cancelled
-     *     doSomething();
-     *   }), 1000);
-     * });
+     * ```ts
+     * // Wrap a promise
+     * const data = await ctx.safe(fetch('/api/data'));
+     *
+     * // Call a normal function
+     * const result = await ctx.safe(myAsyncFn, arg1, arg2);
+     *
+     * // Call an abortable function (auto-injects signal)
+     * const user = await ctx.safe(getUser, userId);
+     * ```
      */
-    safe<TArgs extends unknown[], TReturn>(callback: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn | undefined;
+    safe<T>(promise: Promise<T>): Promise<T>;
+    safe<TArgs extends any[], TResult>(fn: (...args: TArgs) => TResult, ...args: TArgs): TResult extends Promise<infer U> ? Promise<U> : TResult;
     /**
      * Cancel the current async operation.
      * Useful for implementing timeouts.
      *
      * @example
-     * async(focus, async (ctx) => {
+     * async.action(focus, async (ctx) => {
      *   // Timeout after 5 seconds
      *   setTimeout(ctx.cancel, 5000);
      *
@@ -154,26 +153,75 @@ export interface AsyncContext {
      * });
      */
     cancel(): void;
+    /**
+     * Get another store's state and actions.
+     *
+     * @example
+     * // Array destructuring
+     * const [state, actions] = get(counterSpec);
+     *
+     * // Named properties
+     * const tuple = get(counterSpec);
+     * tuple.state.count;
+     */
+    get<S extends StateBase, A extends ActionsBase>(spec: StoreSpec<S, A>): StoreTuple<S, A>;
+    /**
+     * Get a service or factory instance.
+     *
+     * @example
+     * const db = get(() => new IndexedDBService());
+     * await db.users.getAll();
+     */
+    get<T>(factory: (...args: any[]) => T): T;
 }
 /**
  * Async handler function signature.
  * Receives AsyncContext as first arg, then user-defined args.
  */
 export type AsyncHandler<T, TArgs extends any[]> = (context: AsyncContext, ...args: TArgs) => T | PromiseLike<T>;
+/**
+ * Built-in retry delay strategies.
+ */
+export declare const retryStrategy: {
+    /** Exponential backoff: 1s, 2s, 4s, 8s... (max 30s) */
+    readonly backoff: (attempt: number) => number;
+    /** Linear: 1s, 2s, 3s, 4s... (max 30s) */
+    readonly linear: (attempt: number) => number;
+    /** Fixed 1 second delay */
+    readonly fixed: () => number;
+    /** Fibonacci: 1s, 1s, 2s, 3s, 5s, 8s... (max 30s) */
+    readonly fibonacci: (attempt: number) => number;
+    /** Immediate retry (no delay) */
+    readonly immediate: () => number;
+    /** Add jitter (±30%) to any strategy */
+    readonly withJitter: (strategy: (n: number) => number) => (attempt: number) => number;
+};
+/** Built-in retry strategy names */
+export type RetryStrategyName = Exclude<keyof typeof retryStrategy, "withJitter">;
+export type AsyncRetryDelayFn = (attempt: number, error: Error) => number | Promise<void>;
+export type AsyncRetryDelay = number | AsyncRetryDelayFn;
 export interface AsyncRetryOptions {
     /** Number of retry attempts */
     count: number;
-    /** Delay between retries (ms) or function returning delay */
-    delay?: number | ((attempt: number, error: Error) => number);
+    /** Delay between retries: ms, strategy name, or custom function */
+    delay?: AsyncRetryDelay | RetryStrategyName;
 }
 /**
- * Options for async mixin setup.
+ * Options for async state management.
+ *
+ * For retry, error handling, and other cross-cutting concerns,
+ * use the `use()` pattern with wrapper utilities:
+ *
+ * ```ts
+ * import { retry, catchError } from "storion/async";
+ *
+ * const userQuery = async.action(
+ *   focus("user"),
+ *   userService.getUser.use(retry(3)).use(catchError(console.error))
+ * );
+ * ```
  */
 export interface AsyncOptions {
-    /** Error callback */
-    onError?: (error: Error) => void;
-    /** Retry configuration */
-    retry?: number | AsyncRetryOptions;
     /** Auto-cancel previous request on new dispatch (default: true) */
     autoCancel?: boolean;
 }
@@ -192,7 +240,7 @@ export interface AsyncLastInvocation<T, M extends AsyncMode, TArgs extends any[]
     readonly state: AsyncState<T, M>;
 }
 /**
- * API returned from async() mixin.
+ * API returned from async.action() or async.mixin().
  */
 export interface AsyncActions<T, M extends AsyncMode, TArgs extends any[]> {
     /** Dispatch the async operation */

package/dist/async/types.d.ts.map

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

package/dist/async/wrappers.d.ts

@@ -0,0 +1,217 @@
+import { AbortableContext, AbortableWrapper, IdentityWrapper } from './abortable';
+import { RetryStrategyName, AsyncRetryDelayFn } from './types';
+
+/** Options for retry wrapper */
+export interface RetryOptions {
+    /** Number of retry attempts (default: 3) */
+    retries?: number;
+    /** Delay between retries: ms, strategy name, or custom function */
+    delay?: number | RetryStrategyName | AsyncRetryDelayFn;
+}
+/** Options for cache wrapper */
+export interface CacheOptions {
+    /** Time-to-live in milliseconds */
+    ttl: number;
+    /** Custom key function (default: JSON.stringify of args) */
+    key?: (...args: any[]) => string;
+}
+/** Options for rate limit wrapper */
+export interface RateLimitOptions {
+    /** Maximum number of calls allowed in the window */
+    limit: number;
+    /** Time window in milliseconds */
+    window: number;
+}
+/** Options for circuit breaker wrapper */
+export interface CircuitBreakerOptions {
+    /** Number of failures before opening circuit (default: 5) */
+    threshold?: number;
+    /** Time in ms before attempting to close circuit (default: 30000) */
+    resetTimeout?: number;
+}
+/**
+ * Retry on failure.
+ *
+ * @example
+ * ```ts
+ * // Retry 3 times with backoff delay
+ * fn.use(retry(3))
+ *
+ * // Retry 3 times with named strategy
+ * fn.use(retry("linear"))
+ *
+ * // Retry 5 times with linear delay
+ * fn.use(retry({ retries: 5, delay: "linear" }))
+ *
+ * // Custom delay function
+ * fn.use(retry({ retries: 3, delay: (attempt) => attempt * 1000 }))
+ * ```
+ */
+export declare function retry(retries?: number): IdentityWrapper;
+export declare function retry(strategy: RetryStrategyName): IdentityWrapper;
+export declare function retry(options: RetryOptions): IdentityWrapper;
+/**
+ * Catch and handle errors with a callback (without swallowing them).
+ *
+ * @example
+ * ```ts
+ * fn.use(catchError((error) => {
+ *   console.error("Failed:", error.message);
+ *   analytics.track("error", { message: error.message });
+ * }))
+ * ```
+ */
+export declare function catchError(callback: (error: Error, ctx: AbortableContext<any>, ...args: any[]) => void): IdentityWrapper;
+/**
+ * Add timeout to abort after specified milliseconds.
+ *
+ * @example
+ * ```ts
+ * // Abort after 5 seconds
+ * fn.use(timeout(5000))
+ *
+ * // With custom error message
+ * fn.use(timeout(5000, "Request timed out"))
+ * ```
+ */
+export declare function timeout(ms: number, message?: string): IdentityWrapper;
+/**
+ * Log function calls for debugging.
+ *
+ * @example
+ * ```ts
+ * fn.use(logging("getUser"))
+ * // Logs: [getUser] calling with: ["123"]
+ * // Logs: [getUser] success: { id: "123", name: "John" }
+ * // Or:   [getUser] error: Error: Not found
+ * ```
+ */
+export declare function logging(name: string, logger?: Pick<Console, "log" | "error">): IdentityWrapper;
+/**
+ * Debounce calls - only execute after delay with no new calls.
+ *
+ * Note: This creates a shared timer, so multiple calls to the same
+ * debounced function will share the debounce state.
+ *
+ * @example
+ * ```ts
+ * // Debounce search - only execute 300ms after last keystroke
+ * const debouncedSearch = search.use(debounce(300));
+ * ```
+ */
+export declare function debounce(ms: number): IdentityWrapper;
+/**
+ * Throttle calls - only execute once per time window.
+ *
+ * @example
+ * ```ts
+ * // Throttle to max once per second
+ * const throttledSave = save.use(throttle(1000));
+ * ```
+ */
+export declare function throttle(ms: number): IdentityWrapper;
+/**
+ * Return a fallback value on error instead of throwing.
+ *
+ * @example
+ * ```ts
+ * // Return null on error
+ * fn.use(fallback(null))
+ *
+ * // Return empty array on error
+ * fn.use(fallback([]))
+ *
+ * // Dynamic fallback based on error
+ * fn.use(fallback((error) => ({ error: error.message })))
+ * ```
+ */
+export declare function fallback<T>(value: T | ((error: Error, ctx: AbortableContext, ...args: any[]) => T)): IdentityWrapper;
+/**
+ * Cache results with TTL. Results are cached by serialized arguments.
+ *
+ * Note: This creates a shared cache, so all calls to the same
+ * cached function share the cache.
+ *
+ * @example
+ * ```ts
+ * // Cache for 5 minutes
+ * fn.use(cache(5 * 60 * 1000))
+ *
+ * // Cache with custom key function
+ * fn.use(cache({ ttl: 60000, key: (id) => `user:${id}` }))
+ * ```
+ */
+export declare function cache(ttlOrOptions: number | CacheOptions): IdentityWrapper;
+/**
+ * Rate limit calls - queue excess calls beyond the limit.
+ *
+ * Note: This creates shared state, so all calls to the same
+ * rate-limited function share the rate limit.
+ *
+ * @example
+ * ```ts
+ * // Max 10 calls per second
+ * fn.use(rateLimit({ limit: 10, window: 1000 }))
+ *
+ * // Max 100 calls per minute
+ * fn.use(rateLimit({ limit: 100, window: 60000 }))
+ * ```
+ */
+export declare function rateLimit(options: RateLimitOptions): IdentityWrapper;
+/**
+ * Circuit breaker - fail fast after repeated errors.
+ *
+ * States:
+ * - closed: Normal operation, requests pass through
+ * - open: Circuit tripped, requests fail immediately
+ * - half-open: Testing if service recovered (allows one request)
+ *
+ * @example
+ * ```ts
+ * // Open after 5 failures, try again after 30s
+ * fn.use(circuitBreaker())
+ *
+ * // Custom threshold and reset timeout
+ * fn.use(circuitBreaker({ threshold: 3, resetTimeout: 10000 }))
+ * ```
+ */
+export declare function circuitBreaker(options?: CircuitBreakerOptions): IdentityWrapper;
+/**
+ * Create a simplified wrapper for argument/result transformations.
+ *
+ * Unlike regular wrappers, `map()` hides the `ctx` parameter, providing
+ * a simple `next(...args)` function. Use this for transformations that
+ * don't need access to the abort signal.
+ *
+ * @example
+ * ```ts
+ * // Transform return type: User → string
+ * const getUserName = getUser.use(
+ *   map(async (next, id: string) => {
+ *     const user = await next(id);
+ *     return user.name;
+ *   })
+ * );
+ *
+ * // Change argument signature: email → id lookup
+ * const getUserByEmail = getUser.use(
+ *   map(async (next, email: string) => {
+ *     const id = await lookupUserId(email);
+ *     return next(id);
+ *   })
+ * );
+ *
+ * // Combine multiple calls
+ * const getUserWithPosts = getUser.use(
+ *   map(async (next, id: string) => {
+ *     const [user, posts] = await Promise.all([
+ *       next(id),
+ *       fetchPosts(id),
+ *     ]);
+ *     return { ...user, posts };
+ *   })
+ * );
+ * ```
+ */
+export declare function map<TArgs extends any[], TResult, TNewArgs extends any[], TNewResult>(mapper: (next: (...args: NoInfer<TArgs>) => Promise<NoInfer<TResult>>, ...newArgs: TNewArgs) => Promise<TNewResult>): AbortableWrapper<TArgs, TResult, any, TNewArgs, TNewResult, any>;
+//# sourceMappingURL=wrappers.d.ts.map

package/dist/async/wrappers.d.ts.map

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