fractostate 4.8.5 → 4.8.6

package/dist/cjs/index.js

@@ -41,6 +41,24 @@ store.store.setProxyCreator(proxy.createDeepProxy);
 function initFlow(flow) {
     store.store.get(flow.key, flow.initial, flow.options);
 }
+let _flowsRun = false;
+/**
+ * Executes a list of predefined flows immediately and optimally.
+ * Guaranteed to run exactly once per application initialization.
+ * Ideal for authentication checks, data pre-fetching, or setting up
+ * global state at the root of your application (e.g., in main.tsx).
+ */
+function runFlows(flows) {
+    if (_flowsRun)
+        return;
+    _flowsRun = true;
+    // Synchronous resolution ensures that when React renders,
+    // all initial states are already available in the Vault without flashing
+    for (let i = 0; i < flows.length; i++) {
+        const flow = flows[i];
+        store.store.get(flow.key, flow.initial, flow.options);
+    }
+}
 /**
  * Clears the entire store, all timers, and runs cleanup for all active flow effects.
  */
@@ -253,5 +271,6 @@ exports.defineDerived = defineDerived;
 exports.defineFlow = defineFlow;
 exports.getFlow = getFlow;
 exports.initFlow = initFlow;
+exports.runFlows = runFlows;
 exports.useFlow = useFlow;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\n/**\n * Clears the entire store, all timers, and runs cleanup for all active flow effects.\n */\nexport function clearAll() {\n  store.clearAll();\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n      /**\n       * Automatic initialization action.\n       * Executed once when the flow is first initialized (e.g., page refresh or first use).\n       * Useful for fetching initial data or setting up state before components consume it.\n       */\n      __init__?: () => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" | \"__init__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\" || name === \"__init__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\n    _undo: () => store.undo(key),\n    _redo: () => store.redo(key),\n    history: store.getHistory(key),\n    _canUndo: store.getHistory(key).length > 1,\n    _canRedo: store.getRedoStack(key).length > 0,\n    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  const latestState = store.get(key, initial);\n  return [latestState, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [snapshot, setSnapshot] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setSnapshot(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\" || name === \"__init__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\n      _undo: () => store.undo(key),\n      _redo: () => store.redo(key),\n      history: store.getHistory(key),\n      _canUndo: store.getHistory(key).length > 1,\n      _canRedo: store.getRedoStack(key).length > 0,\n      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, snapshot, flowOptions]);\n\n  const state = isDerived\n    ? (keyOrDef as any).selector(store.get(key, initialVal))\n    : store.get(key, initialVal);\n\n  return [state, toolbox] as any;\n}\n"],"names":["store","createDeepProxy","useState","useEffect","useMemo"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\nlet _flowsRun = false;\n\n/**\n * Executes a list of predefined flows immediately and optimally.\n * Guaranteed to run exactly once per application initialization.\n * Ideal for authentication checks, data pre-fetching, or setting up\n * global state at the root of your application (e.g., in main.tsx).\n */\nexport function runFlows(flows: FlowDefinition<any, any, any>[]) {\n  if (_flowsRun) return;\n  _flowsRun = true;\n\n  // Synchronous resolution ensures that when React renders,\n  // all initial states are already available in the Vault without flashing\n  for (let i = 0; i < flows.length; i++) {\n    const flow = flows[i];\n    store.get(flow.key, flow.initial, flow.options);\n  }\n}\n\n/**\n * Clears the entire store, all timers, and runs cleanup for all active flow effects.\n */\nexport function clearAll() {\n  store.clearAll();\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n      /**\n       * Automatic initialization action.\n       * Executed once when the flow is first initialized (e.g., page refresh or first use).\n       * Useful for fetching initial data or setting up state before components consume it.\n       */\n      __init__?: () => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" | \"__init__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\" || name === \"__init__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\n    _undo: () => store.undo(key),\n    _redo: () => store.redo(key),\n    history: store.getHistory(key),\n    _canUndo: store.getHistory(key).length > 1,\n    _canRedo: store.getRedoStack(key).length > 0,\n    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  const latestState = store.get(key, initial);\n  return [latestState, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [snapshot, setSnapshot] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setSnapshot(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\" || name === \"__init__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\n      _undo: () => store.undo(key),\n      _redo: () => store.redo(key),\n      history: store.getHistory(key),\n      _canUndo: store.getHistory(key).length > 1,\n      _canRedo: store.getRedoStack(key).length > 0,\n      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, snapshot, flowOptions]);\n\n  const state = isDerived\n    ? (keyOrDef as any).selector(store.get(key, initialVal))\n    : store.get(key, initialVal);\n\n  return [state, toolbox] as any;\n}\n"],"names":["store","createDeepProxy","useState","useEffect","useMemo"],"mappings":"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"}

package/dist/esm/index.js

@@ -39,6 +39,24 @@ store.setProxyCreator(createDeepProxy);
 function initFlow(flow) {
     store.get(flow.key, flow.initial, flow.options);
 }
+let _flowsRun = false;
+/**
+ * Executes a list of predefined flows immediately and optimally.
+ * Guaranteed to run exactly once per application initialization.
+ * Ideal for authentication checks, data pre-fetching, or setting up
+ * global state at the root of your application (e.g., in main.tsx).
+ */
+function runFlows(flows) {
+    if (_flowsRun)
+        return;
+    _flowsRun = true;
+    // Synchronous resolution ensures that when React renders,
+    // all initial states are already available in the Vault without flashing
+    for (let i = 0; i < flows.length; i++) {
+        const flow = flows[i];
+        store.get(flow.key, flow.initial, flow.options);
+    }
+}
 /**
  * Clears the entire store, all timers, and runs cleanup for all active flow effects.
  */
@@ -246,5 +264,5 @@ function useFlow(keyOrDef, initial, options) {
     return [state, toolbox];
 }
 
-export { clearAll, defineDerived, defineFlow, getFlow, initFlow, useFlow };
+export { clearAll, defineDerived, defineFlow, getFlow, initFlow, runFlows, useFlow };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\n/**\n * Clears the entire store, all timers, and runs cleanup for all active flow effects.\n */\nexport function clearAll() {\n  store.clearAll();\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n      /**\n       * Automatic initialization action.\n       * Executed once when the flow is first initialized (e.g., page refresh or first use).\n       * Useful for fetching initial data or setting up state before components consume it.\n       */\n      __init__?: () => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" | \"__init__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\" || name === \"__init__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\n    _undo: () => store.undo(key),\n    _redo: () => store.redo(key),\n    history: store.getHistory(key),\n    _canUndo: store.getHistory(key).length > 1,\n    _canRedo: store.getRedoStack(key).length > 0,\n    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  const latestState = store.get(key, initial);\n  return [latestState, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [snapshot, setSnapshot] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setSnapshot(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\" || name === \"__init__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\n      _undo: () => store.undo(key),\n      _redo: () => store.redo(key),\n      history: store.getHistory(key),\n      _canUndo: store.getHistory(key).length > 1,\n      _canRedo: store.getRedoStack(key).length > 0,\n      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, snapshot, flowOptions]);\n\n  const state = isDerived\n    ? (keyOrDef as any).selector(store.get(key, initialVal))\n    : store.get(key, initialVal);\n\n  return [state, toolbox] as any;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\nlet _flowsRun = false;\n\n/**\n * Executes a list of predefined flows immediately and optimally.\n * Guaranteed to run exactly once per application initialization.\n * Ideal for authentication checks, data pre-fetching, or setting up\n * global state at the root of your application (e.g., in main.tsx).\n */\nexport function runFlows(flows: FlowDefinition<any, any, any>[]) {\n  if (_flowsRun) return;\n  _flowsRun = true;\n\n  // Synchronous resolution ensures that when React renders,\n  // all initial states are already available in the Vault without flashing\n  for (let i = 0; i < flows.length; i++) {\n    const flow = flows[i];\n    store.get(flow.key, flow.initial, flow.options);\n  }\n}\n\n/**\n * Clears the entire store, all timers, and runs cleanup for all active flow effects.\n */\nexport function clearAll() {\n  store.clearAll();\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n      /**\n       * Automatic initialization action.\n       * Executed once when the flow is first initialized (e.g., page refresh or first use).\n       * Useful for fetching initial data or setting up state before components consume it.\n       */\n      __init__?: () => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" | \"__init__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\" || name === \"__init__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\n    _undo: () => store.undo(key),\n    _redo: () => store.redo(key),\n    history: store.getHistory(key),\n    _canUndo: store.getHistory(key).length > 1,\n    _canRedo: store.getRedoStack(key).length > 0,\n    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  const latestState = store.get(key, initial);\n  return [latestState, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [snapshot, setSnapshot] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setSnapshot(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\" || name === \"__init__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\n      _undo: () => store.undo(key),\n      _redo: () => store.redo(key),\n      history: store.getHistory(key),\n      _canUndo: store.getHistory(key).length > 1,\n      _canRedo: store.getRedoStack(key).length > 0,\n      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, snapshot, flowOptions]);\n\n  const state = isDerived\n    ? (keyOrDef as any).selector(store.get(key, initialVal))\n    : store.get(key, initialVal);\n\n  return [state, toolbox] as any;\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,6 +6,13 @@ export { c as ArrayOps, B as BaseOps, d as BooleanOps, e as BoundActions, f as F
  * This is useful for flows that need to start working before any component subscribes to them.
  */
 declare function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>): void;
+/**
+ * Executes a list of predefined flows immediately and optimally.
+ * Guaranteed to run exactly once per application initialization.
+ * Ideal for authentication checks, data pre-fetching, or setting up
+ * global state at the root of your application (e.g., in main.tsx).
+ */
+declare function runFlows(flows: FlowDefinition<any, any, any>[]): void;
 /**
  * Clears the entire store, all timers, and runs cleanup for all active flow effects.
  */
@@ -44,4 +51,4 @@ declare function useFlow<K extends string, T = any>(key: K, initial?: T, options
 declare function useFlow<T, A, C>(def: FlowDefinition<T, A, C>, options?: UseFlowOptions<T>): [T, FlowOperations<T, A>];
 declare function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];
 
-export { ActionOpsObject, ContextGetterOps, DerivedFlowDefinition, FlowDefinition, FlowOperations, FlowOptions, UseFlowOptions, clearAll, defineDerived, defineFlow, getFlow, initFlow, useFlow };
+export { ActionOpsObject, ContextGetterOps, DerivedFlowDefinition, FlowDefinition, FlowOperations, FlowOptions, UseFlowOptions, clearAll, defineDerived, defineFlow, getFlow, initFlow, runFlows, useFlow };

package/package.json

@@ -112,5 +112,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "4.8.5"
+  "version": "4.8.6"
 }