@tuwaio/pulsar-react 1.0.0-fix-orbit-integration-alpha.3.86c8fdb → 1.0.0-fix-orbit-integration-alpha.4.bd24308

package/dist/index.d.mts

@@ -1,38 +1,3 @@
-import { Transaction, ITxTrackingStore } from '@tuwaio/pulsar-core';
-import React, { PropsWithChildren } from 'react';
-import { StoreApi } from 'zustand';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PulsarAdapter, ITxTrackingStore as ITxTrackingStore$1 } from '@tuwaio/pulsar-core/src';
-import { PersistOptions } from 'zustand/middleware';
-
-/**
- * Type alias for the core store state (ITxTrackingStore<TTransaction>).
- */
-type PulsarStore<TTransaction extends Transaction> = ITxTrackingStore<TTransaction>;
-interface BoundedUseStore<T extends Transaction> {
-    <TRet>(selector: (state: PulsarStore<T>) => TRet): TRet;
-    <TTransaction extends T, TRet>(selector: (state: PulsarStore<TTransaction>) => TRet): TRet;
-}
-declare const PulsarStoreBindings: {
-    usePulsarStore: BoundedUseStore<any>;
-};
-type StoreContext<T extends Transaction> = React.Context<StoreApi<PulsarStore<T>> | null>;
-/**
- * Factory function to create a unique React Context and a strictly typed Bounded Hook for a specific T.
- */
-declare function createPulsarStoreContextAndHook<T extends Transaction>(): {
-    StoreContext: StoreContext<T>;
-    usePulsarStore: BoundedUseStore<T>;
-};
-/**
- * Public hook to access the Pulsar Store.
- * @template T The specific Transaction type (inferred from usage or specified).
- * @template TSelected The type of the value returned by the selector (inferred).
- * * NOTE: The T = Transaction default helps with base type hints, but the actual hook
- * resolves T via the Provider-bound instance.
- */
-declare function usePulsarStore<T extends Transaction = Transaction, TSelected = unknown>(selector: (state: PulsarStore<T>) => TSelected): TSelected;
-
 /**
  * @file This file defines a React hook for initializing the transaction pool.
  * This hook is crucial for resuming the tracking of pending transactions after a page reload.
@@ -70,8 +35,4 @@ declare const useInitializeTransactionsPool: ({ initializeTransactionsPool, onEr
     onError?: (error: Error) => void;
 }) => void;
 
-interface PulsarCoreProviderProps<T extends Transaction> extends PropsWithChildren, PulsarAdapter<T>, Partial<PersistOptions<ITxTrackingStore$1<T>>> {
-}
-declare function PulsarCoreProvider<T extends Transaction>({ children, ...params }: PulsarCoreProviderProps<T>): react_jsx_runtime.JSX.Element;
-
-export { type BoundedUseStore, PulsarCoreProvider, type PulsarStore, PulsarStoreBindings, type StoreContext, createPulsarStoreContextAndHook, useInitializeTransactionsPool, usePulsarStore };
+export { useInitializeTransactionsPool };

package/dist/index.d.ts

@@ -1,38 +1,3 @@
-import { Transaction, ITxTrackingStore } from '@tuwaio/pulsar-core';
-import React, { PropsWithChildren } from 'react';
-import { StoreApi } from 'zustand';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PulsarAdapter, ITxTrackingStore as ITxTrackingStore$1 } from '@tuwaio/pulsar-core/src';
-import { PersistOptions } from 'zustand/middleware';
-
-/**
- * Type alias for the core store state (ITxTrackingStore<TTransaction>).
- */
-type PulsarStore<TTransaction extends Transaction> = ITxTrackingStore<TTransaction>;
-interface BoundedUseStore<T extends Transaction> {
-    <TRet>(selector: (state: PulsarStore<T>) => TRet): TRet;
-    <TTransaction extends T, TRet>(selector: (state: PulsarStore<TTransaction>) => TRet): TRet;
-}
-declare const PulsarStoreBindings: {
-    usePulsarStore: BoundedUseStore<any>;
-};
-type StoreContext<T extends Transaction> = React.Context<StoreApi<PulsarStore<T>> | null>;
-/**
- * Factory function to create a unique React Context and a strictly typed Bounded Hook for a specific T.
- */
-declare function createPulsarStoreContextAndHook<T extends Transaction>(): {
-    StoreContext: StoreContext<T>;
-    usePulsarStore: BoundedUseStore<T>;
-};
-/**
- * Public hook to access the Pulsar Store.
- * @template T The specific Transaction type (inferred from usage or specified).
- * @template TSelected The type of the value returned by the selector (inferred).
- * * NOTE: The T = Transaction default helps with base type hints, but the actual hook
- * resolves T via the Provider-bound instance.
- */
-declare function usePulsarStore<T extends Transaction = Transaction, TSelected = unknown>(selector: (state: PulsarStore<T>) => TSelected): TSelected;
-
 /**
  * @file This file defines a React hook for initializing the transaction pool.
  * This hook is crucial for resuming the tracking of pending transactions after a page reload.
@@ -70,8 +35,4 @@ declare const useInitializeTransactionsPool: ({ initializeTransactionsPool, onEr
     onError?: (error: Error) => void;
 }) => void;
 
-interface PulsarCoreProviderProps<T extends Transaction> extends PropsWithChildren, PulsarAdapter<T>, Partial<PersistOptions<ITxTrackingStore$1<T>>> {
-}
-declare function PulsarCoreProvider<T extends Transaction>({ children, ...params }: PulsarCoreProviderProps<T>): react_jsx_runtime.JSX.Element;
-
-export { type BoundedUseStore, PulsarCoreProvider, type PulsarStore, PulsarStoreBindings, type StoreContext, createPulsarStoreContextAndHook, useInitializeTransactionsPool, usePulsarStore };
+export { useInitializeTransactionsPool };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var react=require('react'),zustand=require('zustand'),pulsarCore=require('@tuwaio/pulsar-core'),S=require('lodash.once'),jsxRuntime=require('react/jsx-runtime');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var S__default=/*#__PURE__*/_interopDefault(S);var a={usePulsarStore:(r=>{throw new Error("usePulsarStore must be called within PulsarCoreProvider.")})};function i(){let r=react.createContext(null);return {StoreContext:r,usePulsarStore:(t=>{let e=react.useContext(r);if(!e)throw new Error("usePulsarStore must be used within a PulsarCoreProvider");return zustand.useStore(e,t)})}}function k(r){return a.usePulsarStore(r)}var u=({initializeTransactionsPool:r,onError:o})=>{react.useEffect(()=>{(async()=>{try{await r();}catch(e){(o??(s=>console.error("Failed to initialize transactions pool:",s)))(e);}})();},[r,o]);};var p=S__default.default(r=>{let{StoreContext:o,usePulsarStore:t}=i(),e=pulsarCore.createPulsarStore({...r,name:r.name??"tuwa:pulsar-store"});return {StoreContext:o,usePulsarStore:t,store:e}});function E({children:r,...o}){let{StoreContext:t,usePulsarStore:e,store:n}=p(o);return u({initializeTransactionsPool:n.getState().initializeTransactionsPool,onError:s=>console.error("Failed to initialize transactions pool:",s)}),a.usePulsarStore=e,jsxRuntime.jsx(t.Provider,{value:n,children:r})}exports.PulsarCoreProvider=E;exports.PulsarStoreBindings=a;exports.createPulsarStoreContextAndHook=i;exports.useInitializeTransactionsPool=u;exports.usePulsarStore=k;//# sourceMappingURL=index.js.map
+'use strict';var react=require('react');var c=({initializeTransactionsPool:r,onError:o})=>{react.useEffect(()=>{(async()=>{try{await r();}catch(e){(o??(i=>console.error("Failed to initialize transactions pool:",i)))(e);}})();},[r,o]);};exports.useInitializeTransactionsPool=c;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/pulsarHook.ts","../src/hooks/useInitializeTransactionsPool.tsx","../src/providers/PulsarCoreProvider.tsx"],"names":["PulsarStoreBindings","selector","createPulsarStoreContextAndHook","StoreContext","createContext","store","useContext","useStore","usePulsarStore","useInitializeTransactionsPool","initializeTransactionsPool","onError","useEffect","error","e","getBoundedStoreInstance","once","params","useBoundedPulsarStore","createPulsarStore","PulsarCoreProvider","children","jsx"],"mappings":"8RA2BO,IAAMA,CAAAA,CAAsB,CAGjC,cAAA,EAAkBC,CAAAA,EAAuB,CACvC,MAAM,IAAI,MAAM,0DAA0D,CAC5E,CAAA,CACF,EAUO,SAASC,CAAAA,EAAyD,CAEvE,IAAMC,CAAAA,CAAgCC,oBAA+C,IAAI,CAAA,CAezF,OAAO,CAAE,YAAA,CAAAD,CAAAA,CAAc,cAAA,EAX6BF,CAAAA,EAAuB,CACzE,IAAMI,CAAAA,CAAQC,gBAAAA,CAAWH,CAAY,CAAA,CAErC,GAAI,CAACE,EACH,MAAM,IAAI,KAAA,CAAM,yDAAyD,CAAA,CAI3E,OAAOE,iBAASF,CAAAA,CAAOJ,CAAQ,CACjC,CAAA,CAE6D,CAC/D,CAWO,SAASO,CAAAA,CACdP,CAAAA,CACW,CAGX,OAAOD,CAAAA,CAAoB,eAA6BC,CAAQ,CAClE,CC3CO,IAAMQ,CAAAA,CAAgC,CAAC,CAC5C,0BAAA,CAAAC,EACA,OAAA,CAAAC,CACF,IAGM,CACJC,eAAAA,CAAU,IAAM,CAAA,CACe,SAAY,CACvC,GAAI,CACF,MAAMF,IACR,CAAA,MAASG,CAAAA,CAAO,CAAA,CACOF,CAAAA,GAAaG,CAAAA,EAAa,QAAQ,KAAA,CAAM,yCAAA,CAA2CA,CAAC,CAAA,CAAA,EAC5FD,CAAc,EAC7B,CACF,CAAA,IAOF,EAAG,CAACH,CAAAA,CAA4BC,CAAO,CAAC,EAC1C,EC3CA,IAAMI,CAAAA,CAA0BC,kBAAAA,CAA6BC,CAAAA,EAAuC,CAClG,GAAM,CAAE,YAAA,CAAAd,CAAAA,CAAc,eAAgBe,CAAsB,CAAA,CAAIhB,GAAmC,CAE7FG,CAAAA,CAAQc,4BAAAA,CAAqB,CACjC,GAAGF,CAAAA,CACH,KAAMA,CAAAA,CAAO,IAAA,EAAQ,mBACvB,CAAC,CAAA,CAED,OAAO,CAAE,YAAA,CAAAd,CAAAA,CAAc,cAAA,CAAgBe,CAAAA,CAAuB,KAAA,CAAAb,CAAM,CACtE,CAAC,CAAA,CAEM,SAASe,CAAAA,CAA0C,CAAE,SAAAC,CAAAA,CAAU,GAAGJ,CAAO,CAAA,CAA+B,CAC7G,GAAM,CAAE,YAAA,CAAAd,CAAAA,CAAc,cAAA,CAAgBe,CAAAA,CAAuB,KAAA,CAAAb,CAAM,EAAIU,CAAAA,CAAwBE,CAAM,CAAA,CAErG,OAAAR,CAAAA,CAA8B,CAC5B,2BAA4BJ,CAAAA,CAAM,QAAA,GAAW,0BAAA,CAC7C,OAAA,CAAUQ,GAAU,OAAA,CAAQ,KAAA,CAAM,yCAAA,CAA2CA,CAAK,CACpF,CAAC,EAEAb,CAAAA,CAAoB,cAAA,CAAwCkB,CAAAA,CAEtDI,cAAAA,CAACnB,CAAAA,CAAa,QAAA,CAAb,CAAsB,KAAA,CAAOE,CAAAA,CAAQ,QAAA,CAAAgB,CAAAA,CAAS,CACxD","file":"index.js","sourcesContent":["// packages/pulsar-react/src/hooks/usePulsarStore.ts\n\nimport { ITxTrackingStore, Transaction } from '@tuwaio/pulsar-core';\nimport React, { createContext, useContext } from 'react';\nimport { StoreApi, useStore } from 'zustand';\n\n// --- CORE TYPES ---\n\n/**\n * Type alias for the core store state (ITxTrackingStore<TTransaction>).\n */\nexport type PulsarStore<TTransaction extends Transaction> = ITxTrackingStore<TTransaction>;\n\n// --- GLOBAL HOOK BINDINGS ---\n\n// Signature for the Bounded Hook assigned by the Provider.\n// T must be explicitly provided in the declaration to allow TSelected to be inferred from the selector.\nexport interface BoundedUseStore<T extends Transaction> {\n  // Overload 1: Simplest call. T is the type bound to the context. TSelected (TRet) is inferred.\n  <TRet>(selector: (state: PulsarStore<T>) => TRet): TRet;\n\n  // Overload 2: Call with an explicit subtype TTransaction. TSelected (TRet) is inferred.\n  <TTransaction extends T, TRet>(selector: (state: PulsarStore<TTransaction>) => TRet): TRet;\n}\n\n// Global object to hold the *actual* Bounded Hook assigned by the Provider.\n// This is the object that the Provider modifies.\nexport const PulsarStoreBindings = {\n  // We use a temporary non-functional placeholder that satisfies the widest type signature.\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  usePulsarStore: ((selector: any): any => {\n    throw new Error('usePulsarStore must be called within PulsarCoreProvider.');\n  }) as BoundedUseStore<any>, // BoundedUseStore<any> is the only way to satisfy TS globally.\n};\n\n// --- FACTORY LOGIC (Used by the Provider) ---\n\n// This must be exported so the Provider can use it.\nexport type StoreContext<T extends Transaction> = React.Context<StoreApi<PulsarStore<T>> | null>;\n\n/**\n * Factory function to create a unique React Context and a strictly typed Bounded Hook for a specific T.\n */\nexport function createPulsarStoreContextAndHook<T extends Transaction>() {\n  // Context created with the specific T from the Provider's generic.\n  const StoreContext: StoreContext<T> = createContext<StoreApi<PulsarStore<T>> | null>(null);\n\n  // The Bounded Hook implementation. It knows T from the factory's closure.\n  // The signature must be the most general one from the BoundedUseStore interface.\n  const useBoundedPulsarStore: BoundedUseStore<T> = ((selector: any): any => {\n    const store = useContext(StoreContext); // Uses the strictly typed local Context\n\n    if (!store) {\n      throw new Error('usePulsarStore must be used within a PulsarCoreProvider');\n    }\n\n    // TSelected (TRet) is correctly inferred here from the selector. No casting needed.\n    return useStore(store, selector);\n  }) as BoundedUseStore<T>;\n\n  return { StoreContext, usePulsarStore: useBoundedPulsarStore };\n}\n\n// --- CONSUMER API (Hook for components to import) ---\n\n/**\n * Public hook to access the Pulsar Store.\n * @template T The specific Transaction type (inferred from usage or specified).\n * @template TSelected The type of the value returned by the selector (inferred).\n * * NOTE: The T = Transaction default helps with base type hints, but the actual hook\n * resolves T via the Provider-bound instance.\n */\nexport function usePulsarStore<T extends Transaction = Transaction, TSelected = unknown>(\n  selector: (state: PulsarStore<T>) => TSelected,\n): TSelected {\n  // Delegate the call to the actual Bounded Hook stored in the global bindings.\n  // This is the necessary indirection to make the generic typing work across modules.\n  return PulsarStoreBindings.usePulsarStore<T, TSelected>(selector);\n}\n","/**\n * @file This file defines a React hook for initializing the transaction pool.\n * This hook is crucial for resuming the tracking of pending transactions after a page reload.\n */\n\nimport { useEffect } from 'react';\n\n/**\n * A React hook that triggers the initialization of the transaction pool when the component mounts.\n *\n * This should be used once in your application's layout or root component. It ensures that any\n * pending transactions from a previous session (stored in `localStorage`) are picked up and\n\n * their trackers are re-activated.\n *\n * @param {object} params - The parameters for the hook.\n * @param {() => Promise<void>} params.initializeTransactionsPool - The `initializeTransactionsPool` function from your Pulsar store instance.\n * @param {(error: Error) => void} [params.onError] - An optional custom function to handle any errors that occur during initialization. Defaults to `console.error`.\n *\n * @example\n * ```tsx\n * import { useInitializeTransactionsPool } from '@tuwaio/pulsar-react';\n * import { pulsarStore } from './path/to/your/store';\n *\n * function AppLayout({ children }) {\n * // This hook will run once when the layout mounts.\n * useInitializeTransactionsPool({\n * initializeTransactionsPool: pulsarStore.getState().initializeTransactionsPool,\n * onError: (err) => console.warn('Failed to re-initialize trackers:', err),\n * });\n *\n * return <div>{children}</div>;\n * }\n * ```\n */\nexport const useInitializeTransactionsPool = ({\n  initializeTransactionsPool,\n  onError,\n}: {\n  initializeTransactionsPool: () => Promise<void>;\n  onError?: (error: Error) => void;\n}) => {\n  useEffect(() => {\n    const reinitializeTrackers = async () => {\n      try {\n        await initializeTransactionsPool();\n      } catch (error) {\n        const errorHandler = onError ?? ((e: Error) => console.error('Failed to initialize transactions pool:', e));\n        errorHandler(error as Error);\n      }\n    };\n\n    // Run the initialization process.\n    reinitializeTrackers();\n\n    // The dependency array is empty to ensure this effect runs only once on mount.\n    // The functions from a vanilla Zustand store are stable and do not need to be in the array.\n  }, [initializeTransactionsPool, onError]);\n};\n","import { createPulsarStore, Transaction } from '@tuwaio/pulsar-core';\nimport { ITxTrackingStore, PulsarAdapter } from '@tuwaio/pulsar-core/src';\nimport once from 'lodash.once';\nimport { PropsWithChildren } from 'react';\nimport { PersistOptions } from 'zustand/middleware';\n\nimport type { BoundedUseStore } from '../hooks/pulsarHook';\nimport { createPulsarStoreContextAndHook, PulsarStoreBindings } from '../hooks/pulsarHook';\nimport { useInitializeTransactionsPool } from '../hooks/useInitializeTransactionsPool';\n\ninterface PulsarCoreProviderProps<T extends Transaction>\n  extends PropsWithChildren,\n    PulsarAdapter<T>,\n    Partial<PersistOptions<ITxTrackingStore<T>>> {}\n\nconst getBoundedStoreInstance = once(<T extends Transaction>(params: PulsarCoreProviderProps<T>) => {\n  const { StoreContext, usePulsarStore: useBoundedPulsarStore } = createPulsarStoreContextAndHook<T>();\n\n  const store = createPulsarStore<T>({\n    ...params,\n    name: params.name ?? 'tuwa:pulsar-store',\n  });\n\n  return { StoreContext, usePulsarStore: useBoundedPulsarStore, store };\n});\n\nexport function PulsarCoreProvider<T extends Transaction>({ children, ...params }: PulsarCoreProviderProps<T>) {\n  const { StoreContext, usePulsarStore: useBoundedPulsarStore, store } = getBoundedStoreInstance(params);\n\n  useInitializeTransactionsPool({\n    initializeTransactionsPool: store.getState().initializeTransactionsPool,\n    onError: (error) => console.error('Failed to initialize transactions pool:', error),\n  });\n\n  (PulsarStoreBindings.usePulsarStore as BoundedUseStore<T>) = useBoundedPulsarStore;\n\n  return <StoreContext.Provider value={store}>{children}</StoreContext.Provider>;\n}\n"]}
+{"version":3,"sources":["../src/hooks/useInitializeTransactionsPool.tsx"],"names":["useInitializeTransactionsPool","initializeTransactionsPool","onError","useEffect","error","e"],"mappings":"4CAmCaA,CAAAA,CAAgC,CAAC,CAC5C,0BAAA,CAAAC,CAAAA,CACA,QAAAC,CACF,CAAA,GAGM,CACJC,eAAAA,CAAU,IAAM,EACe,SAAY,CACvC,GAAI,CACF,MAAMF,IACR,CAAA,MAASG,EAAO,CAAA,CACOF,CAAAA,GAAaG,GAAa,OAAA,CAAQ,KAAA,CAAM,0CAA2CA,CAAC,CAAA,CAAA,EAC5FD,CAAc,EAC7B,CACF,KAOF,CAAA,CAAG,CAACH,CAAAA,CAA4BC,CAAO,CAAC,EAC1C","file":"index.js","sourcesContent":["/**\n * @file This file defines a React hook for initializing the transaction pool.\n * This hook is crucial for resuming the tracking of pending transactions after a page reload.\n */\n\nimport { useEffect } from 'react';\n\n/**\n * A React hook that triggers the initialization of the transaction pool when the component mounts.\n *\n * This should be used once in your application's layout or root component. It ensures that any\n * pending transactions from a previous session (stored in `localStorage`) are picked up and\n\n * their trackers are re-activated.\n *\n * @param {object} params - The parameters for the hook.\n * @param {() => Promise<void>} params.initializeTransactionsPool - The `initializeTransactionsPool` function from your Pulsar store instance.\n * @param {(error: Error) => void} [params.onError] - An optional custom function to handle any errors that occur during initialization. Defaults to `console.error`.\n *\n * @example\n * ```tsx\n * import { useInitializeTransactionsPool } from '@tuwaio/pulsar-react';\n * import { pulsarStore } from './path/to/your/store';\n *\n * function AppLayout({ children }) {\n * // This hook will run once when the layout mounts.\n * useInitializeTransactionsPool({\n * initializeTransactionsPool: pulsarStore.getState().initializeTransactionsPool,\n * onError: (err) => console.warn('Failed to re-initialize trackers:', err),\n * });\n *\n * return <div>{children}</div>;\n * }\n * ```\n */\nexport const useInitializeTransactionsPool = ({\n  initializeTransactionsPool,\n  onError,\n}: {\n  initializeTransactionsPool: () => Promise<void>;\n  onError?: (error: Error) => void;\n}) => {\n  useEffect(() => {\n    const reinitializeTrackers = async () => {\n      try {\n        await initializeTransactionsPool();\n      } catch (error) {\n        const errorHandler = onError ?? ((e: Error) => console.error('Failed to initialize transactions pool:', e));\n        errorHandler(error as Error);\n      }\n    };\n\n    // Run the initialization process.\n    reinitializeTrackers();\n\n    // The dependency array is empty to ensure this effect runs only once on mount.\n    // The functions from a vanilla Zustand store are stable and do not need to be in the array.\n  }, [initializeTransactionsPool, onError]);\n};\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {createContext,useContext,useEffect}from'react';import {useStore}from'zustand';import {createPulsarStore}from'@tuwaio/pulsar-core';import S from'lodash.once';import {jsx}from'react/jsx-runtime';var a={usePulsarStore:(r=>{throw new Error("usePulsarStore must be called within PulsarCoreProvider.")})};function i(){let r=createContext(null);return {StoreContext:r,usePulsarStore:(t=>{let e=useContext(r);if(!e)throw new Error("usePulsarStore must be used within a PulsarCoreProvider");return useStore(e,t)})}}function k(r){return a.usePulsarStore(r)}var u=({initializeTransactionsPool:r,onError:o})=>{useEffect(()=>{(async()=>{try{await r();}catch(e){(o??(s=>console.error("Failed to initialize transactions pool:",s)))(e);}})();},[r,o]);};var p=S(r=>{let{StoreContext:o,usePulsarStore:t}=i(),e=createPulsarStore({...r,name:r.name??"tuwa:pulsar-store"});return {StoreContext:o,usePulsarStore:t,store:e}});function E({children:r,...o}){let{StoreContext:t,usePulsarStore:e,store:n}=p(o);return u({initializeTransactionsPool:n.getState().initializeTransactionsPool,onError:s=>console.error("Failed to initialize transactions pool:",s)}),a.usePulsarStore=e,jsx(t.Provider,{value:n,children:r})}export{E as PulsarCoreProvider,a as PulsarStoreBindings,i as createPulsarStoreContextAndHook,u as useInitializeTransactionsPool,k as usePulsarStore};//# sourceMappingURL=index.mjs.map
+import {useEffect}from'react';var c=({initializeTransactionsPool:r,onError:o})=>{useEffect(()=>{(async()=>{try{await r();}catch(e){(o??(i=>console.error("Failed to initialize transactions pool:",i)))(e);}})();},[r,o]);};export{c as useInitializeTransactionsPool};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/pulsarHook.ts","../src/hooks/useInitializeTransactionsPool.tsx","../src/providers/PulsarCoreProvider.tsx"],"names":["PulsarStoreBindings","selector","createPulsarStoreContextAndHook","StoreContext","createContext","store","useContext","useStore","usePulsarStore","useInitializeTransactionsPool","initializeTransactionsPool","onError","useEffect","error","e","getBoundedStoreInstance","once","params","useBoundedPulsarStore","createPulsarStore","PulsarCoreProvider","children","jsx"],"mappings":"yMA2BO,IAAMA,CAAAA,CAAsB,CAGjC,cAAA,EAAkBC,CAAAA,EAAuB,CACvC,MAAM,IAAI,MAAM,0DAA0D,CAC5E,CAAA,CACF,EAUO,SAASC,CAAAA,EAAyD,CAEvE,IAAMC,CAAAA,CAAgCC,cAA+C,IAAI,CAAA,CAezF,OAAO,CAAE,YAAA,CAAAD,CAAAA,CAAc,cAAA,EAX6BF,CAAAA,EAAuB,CACzE,IAAMI,CAAAA,CAAQC,UAAAA,CAAWH,CAAY,CAAA,CAErC,GAAI,CAACE,EACH,MAAM,IAAI,KAAA,CAAM,yDAAyD,CAAA,CAI3E,OAAOE,SAASF,CAAAA,CAAOJ,CAAQ,CACjC,CAAA,CAE6D,CAC/D,CAWO,SAASO,CAAAA,CACdP,CAAAA,CACW,CAGX,OAAOD,CAAAA,CAAoB,eAA6BC,CAAQ,CAClE,CC3CO,IAAMQ,CAAAA,CAAgC,CAAC,CAC5C,0BAAA,CAAAC,EACA,OAAA,CAAAC,CACF,IAGM,CACJC,SAAAA,CAAU,IAAM,CAAA,CACe,SAAY,CACvC,GAAI,CACF,MAAMF,IACR,CAAA,MAASG,CAAAA,CAAO,CAAA,CACOF,CAAAA,GAAaG,CAAAA,EAAa,QAAQ,KAAA,CAAM,yCAAA,CAA2CA,CAAC,CAAA,CAAA,EAC5FD,CAAc,EAC7B,CACF,CAAA,IAOF,EAAG,CAACH,CAAAA,CAA4BC,CAAO,CAAC,EAC1C,EC3CA,IAAMI,CAAAA,CAA0BC,CAAAA,CAA6BC,CAAAA,EAAuC,CAClG,GAAM,CAAE,YAAA,CAAAd,CAAAA,CAAc,eAAgBe,CAAsB,CAAA,CAAIhB,GAAmC,CAE7FG,CAAAA,CAAQc,iBAAAA,CAAqB,CACjC,GAAGF,CAAAA,CACH,KAAMA,CAAAA,CAAO,IAAA,EAAQ,mBACvB,CAAC,CAAA,CAED,OAAO,CAAE,YAAA,CAAAd,CAAAA,CAAc,cAAA,CAAgBe,CAAAA,CAAuB,KAAA,CAAAb,CAAM,CACtE,CAAC,CAAA,CAEM,SAASe,CAAAA,CAA0C,CAAE,SAAAC,CAAAA,CAAU,GAAGJ,CAAO,CAAA,CAA+B,CAC7G,GAAM,CAAE,YAAA,CAAAd,CAAAA,CAAc,cAAA,CAAgBe,CAAAA,CAAuB,KAAA,CAAAb,CAAM,EAAIU,CAAAA,CAAwBE,CAAM,CAAA,CAErG,OAAAR,CAAAA,CAA8B,CAC5B,2BAA4BJ,CAAAA,CAAM,QAAA,GAAW,0BAAA,CAC7C,OAAA,CAAUQ,GAAU,OAAA,CAAQ,KAAA,CAAM,yCAAA,CAA2CA,CAAK,CACpF,CAAC,EAEAb,CAAAA,CAAoB,cAAA,CAAwCkB,CAAAA,CAEtDI,GAAAA,CAACnB,CAAAA,CAAa,QAAA,CAAb,CAAsB,KAAA,CAAOE,CAAAA,CAAQ,QAAA,CAAAgB,CAAAA,CAAS,CACxD","file":"index.mjs","sourcesContent":["// packages/pulsar-react/src/hooks/usePulsarStore.ts\n\nimport { ITxTrackingStore, Transaction } from '@tuwaio/pulsar-core';\nimport React, { createContext, useContext } from 'react';\nimport { StoreApi, useStore } from 'zustand';\n\n// --- CORE TYPES ---\n\n/**\n * Type alias for the core store state (ITxTrackingStore<TTransaction>).\n */\nexport type PulsarStore<TTransaction extends Transaction> = ITxTrackingStore<TTransaction>;\n\n// --- GLOBAL HOOK BINDINGS ---\n\n// Signature for the Bounded Hook assigned by the Provider.\n// T must be explicitly provided in the declaration to allow TSelected to be inferred from the selector.\nexport interface BoundedUseStore<T extends Transaction> {\n  // Overload 1: Simplest call. T is the type bound to the context. TSelected (TRet) is inferred.\n  <TRet>(selector: (state: PulsarStore<T>) => TRet): TRet;\n\n  // Overload 2: Call with an explicit subtype TTransaction. TSelected (TRet) is inferred.\n  <TTransaction extends T, TRet>(selector: (state: PulsarStore<TTransaction>) => TRet): TRet;\n}\n\n// Global object to hold the *actual* Bounded Hook assigned by the Provider.\n// This is the object that the Provider modifies.\nexport const PulsarStoreBindings = {\n  // We use a temporary non-functional placeholder that satisfies the widest type signature.\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  usePulsarStore: ((selector: any): any => {\n    throw new Error('usePulsarStore must be called within PulsarCoreProvider.');\n  }) as BoundedUseStore<any>, // BoundedUseStore<any> is the only way to satisfy TS globally.\n};\n\n// --- FACTORY LOGIC (Used by the Provider) ---\n\n// This must be exported so the Provider can use it.\nexport type StoreContext<T extends Transaction> = React.Context<StoreApi<PulsarStore<T>> | null>;\n\n/**\n * Factory function to create a unique React Context and a strictly typed Bounded Hook for a specific T.\n */\nexport function createPulsarStoreContextAndHook<T extends Transaction>() {\n  // Context created with the specific T from the Provider's generic.\n  const StoreContext: StoreContext<T> = createContext<StoreApi<PulsarStore<T>> | null>(null);\n\n  // The Bounded Hook implementation. It knows T from the factory's closure.\n  // The signature must be the most general one from the BoundedUseStore interface.\n  const useBoundedPulsarStore: BoundedUseStore<T> = ((selector: any): any => {\n    const store = useContext(StoreContext); // Uses the strictly typed local Context\n\n    if (!store) {\n      throw new Error('usePulsarStore must be used within a PulsarCoreProvider');\n    }\n\n    // TSelected (TRet) is correctly inferred here from the selector. No casting needed.\n    return useStore(store, selector);\n  }) as BoundedUseStore<T>;\n\n  return { StoreContext, usePulsarStore: useBoundedPulsarStore };\n}\n\n// --- CONSUMER API (Hook for components to import) ---\n\n/**\n * Public hook to access the Pulsar Store.\n * @template T The specific Transaction type (inferred from usage or specified).\n * @template TSelected The type of the value returned by the selector (inferred).\n * * NOTE: The T = Transaction default helps with base type hints, but the actual hook\n * resolves T via the Provider-bound instance.\n */\nexport function usePulsarStore<T extends Transaction = Transaction, TSelected = unknown>(\n  selector: (state: PulsarStore<T>) => TSelected,\n): TSelected {\n  // Delegate the call to the actual Bounded Hook stored in the global bindings.\n  // This is the necessary indirection to make the generic typing work across modules.\n  return PulsarStoreBindings.usePulsarStore<T, TSelected>(selector);\n}\n","/**\n * @file This file defines a React hook for initializing the transaction pool.\n * This hook is crucial for resuming the tracking of pending transactions after a page reload.\n */\n\nimport { useEffect } from 'react';\n\n/**\n * A React hook that triggers the initialization of the transaction pool when the component mounts.\n *\n * This should be used once in your application's layout or root component. It ensures that any\n * pending transactions from a previous session (stored in `localStorage`) are picked up and\n\n * their trackers are re-activated.\n *\n * @param {object} params - The parameters for the hook.\n * @param {() => Promise<void>} params.initializeTransactionsPool - The `initializeTransactionsPool` function from your Pulsar store instance.\n * @param {(error: Error) => void} [params.onError] - An optional custom function to handle any errors that occur during initialization. Defaults to `console.error`.\n *\n * @example\n * ```tsx\n * import { useInitializeTransactionsPool } from '@tuwaio/pulsar-react';\n * import { pulsarStore } from './path/to/your/store';\n *\n * function AppLayout({ children }) {\n * // This hook will run once when the layout mounts.\n * useInitializeTransactionsPool({\n * initializeTransactionsPool: pulsarStore.getState().initializeTransactionsPool,\n * onError: (err) => console.warn('Failed to re-initialize trackers:', err),\n * });\n *\n * return <div>{children}</div>;\n * }\n * ```\n */\nexport const useInitializeTransactionsPool = ({\n  initializeTransactionsPool,\n  onError,\n}: {\n  initializeTransactionsPool: () => Promise<void>;\n  onError?: (error: Error) => void;\n}) => {\n  useEffect(() => {\n    const reinitializeTrackers = async () => {\n      try {\n        await initializeTransactionsPool();\n      } catch (error) {\n        const errorHandler = onError ?? ((e: Error) => console.error('Failed to initialize transactions pool:', e));\n        errorHandler(error as Error);\n      }\n    };\n\n    // Run the initialization process.\n    reinitializeTrackers();\n\n    // The dependency array is empty to ensure this effect runs only once on mount.\n    // The functions from a vanilla Zustand store are stable and do not need to be in the array.\n  }, [initializeTransactionsPool, onError]);\n};\n","import { createPulsarStore, Transaction } from '@tuwaio/pulsar-core';\nimport { ITxTrackingStore, PulsarAdapter } from '@tuwaio/pulsar-core/src';\nimport once from 'lodash.once';\nimport { PropsWithChildren } from 'react';\nimport { PersistOptions } from 'zustand/middleware';\n\nimport type { BoundedUseStore } from '../hooks/pulsarHook';\nimport { createPulsarStoreContextAndHook, PulsarStoreBindings } from '../hooks/pulsarHook';\nimport { useInitializeTransactionsPool } from '../hooks/useInitializeTransactionsPool';\n\ninterface PulsarCoreProviderProps<T extends Transaction>\n  extends PropsWithChildren,\n    PulsarAdapter<T>,\n    Partial<PersistOptions<ITxTrackingStore<T>>> {}\n\nconst getBoundedStoreInstance = once(<T extends Transaction>(params: PulsarCoreProviderProps<T>) => {\n  const { StoreContext, usePulsarStore: useBoundedPulsarStore } = createPulsarStoreContextAndHook<T>();\n\n  const store = createPulsarStore<T>({\n    ...params,\n    name: params.name ?? 'tuwa:pulsar-store',\n  });\n\n  return { StoreContext, usePulsarStore: useBoundedPulsarStore, store };\n});\n\nexport function PulsarCoreProvider<T extends Transaction>({ children, ...params }: PulsarCoreProviderProps<T>) {\n  const { StoreContext, usePulsarStore: useBoundedPulsarStore, store } = getBoundedStoreInstance(params);\n\n  useInitializeTransactionsPool({\n    initializeTransactionsPool: store.getState().initializeTransactionsPool,\n    onError: (error) => console.error('Failed to initialize transactions pool:', error),\n  });\n\n  (PulsarStoreBindings.usePulsarStore as BoundedUseStore<T>) = useBoundedPulsarStore;\n\n  return <StoreContext.Provider value={store}>{children}</StoreContext.Provider>;\n}\n"]}
+{"version":3,"sources":["../src/hooks/useInitializeTransactionsPool.tsx"],"names":["useInitializeTransactionsPool","initializeTransactionsPool","onError","useEffect","error","e"],"mappings":"kCAmCaA,CAAAA,CAAgC,CAAC,CAC5C,0BAAA,CAAAC,CAAAA,CACA,QAAAC,CACF,CAAA,GAGM,CACJC,SAAAA,CAAU,IAAM,EACe,SAAY,CACvC,GAAI,CACF,MAAMF,IACR,CAAA,MAASG,EAAO,CAAA,CACOF,CAAAA,GAAaG,GAAa,OAAA,CAAQ,KAAA,CAAM,0CAA2CA,CAAC,CAAA,CAAA,EAC5FD,CAAc,EAC7B,CACF,KAOF,CAAA,CAAG,CAACH,CAAAA,CAA4BC,CAAO,CAAC,EAC1C","file":"index.mjs","sourcesContent":["/**\n * @file This file defines a React hook for initializing the transaction pool.\n * This hook is crucial for resuming the tracking of pending transactions after a page reload.\n */\n\nimport { useEffect } from 'react';\n\n/**\n * A React hook that triggers the initialization of the transaction pool when the component mounts.\n *\n * This should be used once in your application's layout or root component. It ensures that any\n * pending transactions from a previous session (stored in `localStorage`) are picked up and\n\n * their trackers are re-activated.\n *\n * @param {object} params - The parameters for the hook.\n * @param {() => Promise<void>} params.initializeTransactionsPool - The `initializeTransactionsPool` function from your Pulsar store instance.\n * @param {(error: Error) => void} [params.onError] - An optional custom function to handle any errors that occur during initialization. Defaults to `console.error`.\n *\n * @example\n * ```tsx\n * import { useInitializeTransactionsPool } from '@tuwaio/pulsar-react';\n * import { pulsarStore } from './path/to/your/store';\n *\n * function AppLayout({ children }) {\n * // This hook will run once when the layout mounts.\n * useInitializeTransactionsPool({\n * initializeTransactionsPool: pulsarStore.getState().initializeTransactionsPool,\n * onError: (err) => console.warn('Failed to re-initialize trackers:', err),\n * });\n *\n * return <div>{children}</div>;\n * }\n * ```\n */\nexport const useInitializeTransactionsPool = ({\n  initializeTransactionsPool,\n  onError,\n}: {\n  initializeTransactionsPool: () => Promise<void>;\n  onError?: (error: Error) => void;\n}) => {\n  useEffect(() => {\n    const reinitializeTrackers = async () => {\n      try {\n        await initializeTransactionsPool();\n      } catch (error) {\n        const errorHandler = onError ?? ((e: Error) => console.error('Failed to initialize transactions pool:', e));\n        errorHandler(error as Error);\n      }\n    };\n\n    // Run the initialization process.\n    reinitializeTrackers();\n\n    // The dependency array is empty to ensure this effect runs only once on mount.\n    // The functions from a vanilla Zustand store are stable and do not need to be in the array.\n  }, [initializeTransactionsPool, onError]);\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/pulsar-react",
-  "version": "1.0.0-fix-orbit-integration-alpha.3.86c8fdb",
+  "version": "1.0.0-fix-orbit-integration-alpha.4.bd24308",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -58,7 +58,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
     "zustand": "^5.0.8",
-    "@tuwaio/pulsar-core": "^1.0.0-fix-orbit-integration-alpha.3.86c8fdb"
+    "@tuwaio/pulsar-core": "^1.0.0-fix-orbit-integration-alpha.4.bd24308"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",