@tuwaio/pulsar-core 0.6.11 → 0.7.0

package/dist/index.d.mts

@@ -18,10 +18,15 @@ declare enum TransactionTracker {
     Ethereum = "ethereum",
     /** For multi-signature transactions managed and executed via a Safe contract. */
     Safe = "safe",
-    /** For meta-transactions relayed and executed by the Gelato Network. */
+    /**
+     * For meta-transactions relayed and executed by the Gelato Network.
+     * @deprecated Gelato gasless relay is deprecated. Use TransactionTracker.ERC4337 instead.
+     */
     Gelato = "gelato",
     /** The tracker for monitoring standard Solana transaction signatures. */
-    Solana = "solana"
+    Solana = "solana",
+    /** For native ERC-4337 UserOperation transactions tracked via bundler RPC. */
+    ERC4337 = "erc4337"
 }
 /**
  * Represents the terminal status of a transaction after it has been processed.
@@ -135,6 +140,10 @@ type EvmTransaction = BaseTransaction & {
     to?: `0x${string}`;
     /** The amount of native currency (in wei) being sent. */
     value?: string;
+    /** Optional custom bundler RPC URL for ERC-4337 UserOperation tracking. */
+    bundlerUrl?: string;
+    /** Optional Pimlico API key for ERC-4337 UserOperation tracking. */
+    pimlicoApiKey?: string;
 };
 /**
  * Represents a Solana-specific transaction, extending the base properties.
@@ -170,7 +179,7 @@ type Transaction = EvmTransaction | SolanaTransaction | StarknetTransaction;
 /**
  * Represents the parameters required to initiate a new transaction tracking flow.
  */
-type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' | 'type' | 'requiredConfirmations' | 'rpcUrl' | 'payload'> & {
+type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' | 'type' | 'requiredConfirmations' | 'rpcUrl' | 'payload'> & Pick<EvmTransaction, 'bundlerUrl' | 'pimlicoApiKey'> & {
     /** The specific blockchain adapter for this transaction. */
     adapter: OrbitAdapter;
     /** The function that executes the on-chain action (e.g., sending a transaction) and returns a preliminary identifier like a hash. */
@@ -179,8 +188,10 @@ type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' |
     desiredChainID: number | string;
     /** If true, the detailed tracking modal will open automatically upon initiation. */
     withTrackedModal?: boolean;
-    /** The specific tracker responsible for monitoring this transaction's status. Required for Gelato tracker. */
+    /** The specific tracker responsible for monitoring this transaction's status. Required for Gelato / ERC-4337 tracker. */
     tracker?: TransactionTracker;
+    /** @deprecated Gelato relay is deprecated. */
+    gelatoApiKey?: string;
 };
 /**
  * Represents a transaction in its temporary, pre-submission state.
@@ -242,13 +253,20 @@ type PulsarAdapter<T extends Transaction> = OrbitGenericAdapter<TxAdapter<T>> &
  * @property {ActionTxKey} actionTxKey - The key identifying the specific action related to the transaction.
  * @property {string} connectorType - The type of connector used for the transaction (e.g., wallet provider, blockchain interface).
  * @property {TransactionTracker} [tracker] - An optional tracker object that monitors the status and progress of the transaction.
- * @property {string} [gelatoApiKey] - An optional Gelato API key for Gelato relayer integration.
+ * @property {string} [gelatoApiKey] - @deprecated Gelato API key for Gelato relayer integration.
+ * @property {string} [bundlerUrl] - Optional custom bundler RPC URL for ERC-4337 UserOperation tracking.
+ * @property {string} [pimlicoApiKey] - Optional Pimlico API key for ERC-4337 UserOperation tracking.
  */
 type CheckTxTracker = {
     actionTxKey: ActionTxKey;
     connectorType: string;
     tracker?: TransactionTracker;
+    /** @deprecated Gelato relay is deprecated. Use bundlerUrl / pimlicoApiKey with ERC-4337 instead. */
     gelatoApiKey?: string;
+    /** Optional custom bundler RPC URL for ERC-4337 UserOperation tracking. */
+    bundlerUrl?: string;
+    /** Optional Pimlico API key for ERC-4337 UserOperation tracking. */
+    pimlicoApiKey?: string;
 };
 /**
  * Defines the interface for a transaction adapter, which provides chain-specific logic and utilities.

package/dist/index.d.ts

@@ -18,10 +18,15 @@ declare enum TransactionTracker {
     Ethereum = "ethereum",
     /** For multi-signature transactions managed and executed via a Safe contract. */
     Safe = "safe",
-    /** For meta-transactions relayed and executed by the Gelato Network. */
+    /**
+     * For meta-transactions relayed and executed by the Gelato Network.
+     * @deprecated Gelato gasless relay is deprecated. Use TransactionTracker.ERC4337 instead.
+     */
     Gelato = "gelato",
     /** The tracker for monitoring standard Solana transaction signatures. */
-    Solana = "solana"
+    Solana = "solana",
+    /** For native ERC-4337 UserOperation transactions tracked via bundler RPC. */
+    ERC4337 = "erc4337"
 }
 /**
  * Represents the terminal status of a transaction after it has been processed.
@@ -135,6 +140,10 @@ type EvmTransaction = BaseTransaction & {
     to?: `0x${string}`;
     /** The amount of native currency (in wei) being sent. */
     value?: string;
+    /** Optional custom bundler RPC URL for ERC-4337 UserOperation tracking. */
+    bundlerUrl?: string;
+    /** Optional Pimlico API key for ERC-4337 UserOperation tracking. */
+    pimlicoApiKey?: string;
 };
 /**
  * Represents a Solana-specific transaction, extending the base properties.
@@ -170,7 +179,7 @@ type Transaction = EvmTransaction | SolanaTransaction | StarknetTransaction;
 /**
  * Represents the parameters required to initiate a new transaction tracking flow.
  */
-type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' | 'type' | 'requiredConfirmations' | 'rpcUrl' | 'payload'> & {
+type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' | 'type' | 'requiredConfirmations' | 'rpcUrl' | 'payload'> & Pick<EvmTransaction, 'bundlerUrl' | 'pimlicoApiKey'> & {
     /** The specific blockchain adapter for this transaction. */
     adapter: OrbitAdapter;
     /** The function that executes the on-chain action (e.g., sending a transaction) and returns a preliminary identifier like a hash. */
@@ -179,8 +188,10 @@ type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' |
     desiredChainID: number | string;
     /** If true, the detailed tracking modal will open automatically upon initiation. */
     withTrackedModal?: boolean;
-    /** The specific tracker responsible for monitoring this transaction's status. Required for Gelato tracker. */
+    /** The specific tracker responsible for monitoring this transaction's status. Required for Gelato / ERC-4337 tracker. */
     tracker?: TransactionTracker;
+    /** @deprecated Gelato relay is deprecated. */
+    gelatoApiKey?: string;
 };
 /**
  * Represents a transaction in its temporary, pre-submission state.
@@ -242,13 +253,20 @@ type PulsarAdapter<T extends Transaction> = OrbitGenericAdapter<TxAdapter<T>> &
  * @property {ActionTxKey} actionTxKey - The key identifying the specific action related to the transaction.
  * @property {string} connectorType - The type of connector used for the transaction (e.g., wallet provider, blockchain interface).
  * @property {TransactionTracker} [tracker] - An optional tracker object that monitors the status and progress of the transaction.
- * @property {string} [gelatoApiKey] - An optional Gelato API key for Gelato relayer integration.
+ * @property {string} [gelatoApiKey] - @deprecated Gelato API key for Gelato relayer integration.
+ * @property {string} [bundlerUrl] - Optional custom bundler RPC URL for ERC-4337 UserOperation tracking.
+ * @property {string} [pimlicoApiKey] - Optional Pimlico API key for ERC-4337 UserOperation tracking.
  */
 type CheckTxTracker = {
     actionTxKey: ActionTxKey;
     connectorType: string;
     tracker?: TransactionTracker;
+    /** @deprecated Gelato relay is deprecated. Use bundlerUrl / pimlicoApiKey with ERC-4337 instead. */
     gelatoApiKey?: string;
+    /** Optional custom bundler RPC URL for ERC-4337 UserOperation tracking. */
+    bundlerUrl?: string;
+    /** Optional Pimlico API key for ERC-4337 UserOperation tracking. */
+    pimlicoApiKey?: string;
 };
 /**
  * Defines the interface for a transaction adapter, which provides chain-specific logic and utilities.

package/dist/index.js

@@ -1 +1 @@
-'use strict';var immer=require('immer'),vanilla=require('zustand/vanilla'),orbitCore=require('@tuwaio/orbit-core'),ie=require('dayjs'),middleware=require('zustand/middleware'),zustand=require('zustand');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var ie__default=/*#__PURE__*/_interopDefault(ie);var ee=(c=>(c.Ethereum="ethereum",c.Safe="safe",c.Gelato="gelato",c.Solana="solana",c))(ee||{}),I=(T=>(T.Failed="Failed",T.Success="Success",T.Replaced="Replaced",T))(I||{});var N=100,B=300,z=10*1024,te=[/\beval\s*\(/i,/\bFunction\s*\(/,/\bset(?:Timeout|Interval)\s*\(\s*['"`]/i,/javascript\s*:/i],P=class extends Error{field;constructor(e,o){super(o),this.name="PulsarTransactionValidationError",this.field=e;}};function $(t){w({field:"title",value:t.title,maxLength:N}),w({field:"description",value:t.description,maxLength:B}),U(t.payload);}function A(t){w({field:"title",value:t.title,maxLength:N}),w({field:"description",value:t.description,maxLength:B}),U(t.payload);}function w({field:t,value:e,maxLength:o}){if(e===void 0)return;(Array.isArray(e)?e:[e]).forEach((c,a)=>{let n=Array.isArray(e)?`${t}[${a}]`:t;if(typeof c!="string")throw new P(n,`${n} must be a string.`);if(c.length>o)throw new P(n,`${n} must be ${o} characters or less.`);O(n,c);});}function U(t){if(t===void 0)return;let e;try{e=JSON.stringify(t);}catch{throw new P("payload","payload must be JSON-serializable.")}if(e===void 0)throw new P("payload","payload must be JSON-serializable.");if(new TextEncoder().encode(e).length>z)throw new P("payload",`payload must be ${z} bytes or less when serialized.`);j(t);}function j(t,e="payload"){if(typeof t=="string"){O(e,t);return}t===null||typeof t!="object"||Object.entries(t).forEach(([o,T])=>{let c=`${e}.${o}`;O(c,o),j(T,c);});}function O(t,e){if(te.some(o=>o.test(e)))throw new P(t,`${t} contains a blocked executable-like pattern.`)}function _({maxTransactions:t,onRemoteCreate:e}){let o=false;return (T,c)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,unsyncedTxKeys:{},reconcileUnsyncedTransactions:async()=>{if(!e||o)return;let a=Object.keys(c().unsyncedTxKeys||{});if(a.length!==0){o=true;try{for(let n of a){let l=c().transactionsPool[n];if(!l){T(r=>immer.produce(r,i=>{i.unsyncedTxKeys&&delete i.unsyncedTxKeys[n];}));continue}try{await e(l),T(r=>immer.produce(r,i=>{let s=i.transactionsPool[n];s&&(s.syncStatus="synced"),i.unsyncedTxKeys&&delete i.unsyncedTxKeys[n];}));}catch(r){console.warn(`[Pulsar] Failed to reconcile tx ${n}:`,r);}}}finally{o=false;}}},addTxToPool:a=>{A(a);let n={...a,pending:true};return (async()=>{let r=false;if(e)try{await e(n),n.syncStatus="synced";}catch(i){console.warn("[Pulsar] onRemoteCreate failed, transaction queued for background sync:",i),n.syncStatus="pending-sync",r=true;}T(i=>immer.produce(i,s=>{if(s.lastAddedTxKey=a.txKey,r&&(s.unsyncedTxKeys||(s.unsyncedTxKeys={}),s.unsyncedTxKeys[a.txKey]=true),a.txKey){if(Object.keys(s.transactionsPool).length>=t){let p=Object.values(s.transactionsPool).sort((m,y)=>m.localTimestamp-y.localTimestamp);if(p.length>0){let m=p[0];delete s.transactionsPool[m.txKey];}}s.transactionsPool[a.txKey]=n;}}));})()},updateTxParams:(a,n)=>{T(r=>immer.produce(r,i=>{let s=i.transactionsPool[a];s&&Object.assign(s,n);})),(n.status==="Success"||n.status==="Failed"||n.status==="Replaced")&&c().reconcileUnsyncedTransactions&&c().unsyncedTxKeys?.[a]&&c().reconcileUnsyncedTransactions().catch(r=>{console.error("[Pulsar] Terminal reconciliation failed:",r);});},removeTxFromPool:a=>{T(n=>immer.produce(n,l=>{delete l.transactionsPool[a];}));},closeTxTrackedModal:a=>{T(n=>immer.produce(n,l=>{if(a&&l.transactionsPool[a]){let r=l.transactionsPool[a];l.transactionsPool[a]={...r,isTrackedModalOpen:false};}l.initialTx=void 0;}));},getLastTxKey:()=>c().lastAddedTxKey})}var G=t=>Object.values(t).sort((e,o)=>Number(e.localTimestamp)-Number(o.localTimestamp)),be=t=>G(t).filter(e=>e.pending),ke=(t,e)=>t[e],ne=(t,e)=>G(t).filter(o=>o.from.toLowerCase()===e.toLowerCase()),Ae=(t,e)=>ne(t,e).filter(o=>o.pending);var q=t=>t==="Success"||t==="Replaced",X=(t,e)=>{let o=t[e.txKey];if(o){if(q(o.status))return  false;if(o.pending){if(q(e.status))return t[e.txKey]={...o,...e},true;let T=typeof e.confirmations=="number"?e.confirmations:0,c=typeof o.confirmations=="number"?o.confirmations:0;return T>c?(t[e.txKey]={...o,...e},true):false}}return t[e.txKey]=e,true};function Ce({localTransactionsPool:t,reconcileUnsyncedTransactions:e,getHistory:o,onHistoryFetched:T}){immer.setAutoFreeze(false);let c=n=>({isLoading:n,isError:false}),a=n=>n?(T&&queueMicrotask(()=>T(n.docs)),l=>immer.produce(l,r=>{let i=r.transactionsPool;for(let s of n.docs)X(i,s);r.currentPage=n.page,r.hasMore=n.hasNextPage,r.isLoading=false;})):l=>l;return vanilla.createStore()((n,l)=>({transactionsPool:t,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{n(i=>immer.produce(i,s=>{let d=s.transactionsPool;for(let p of Object.values(r))X(d,p);}));},fetchInitial:async r=>{if(!(!o||!r)){n(c(true)),e&&await e();try{let i=await o({page:1,walletAddress:r});n(a(i));}catch(i){console.error("[Pulsar] Failed to fetch initial transaction history:",i),n({isLoading:false,isError:true});}}},fetchNextPage:async r=>{let{hasMore:i,isLoading:s,currentPage:d}=l();if(!(!o||!i||s||!r)){n(c(true));try{let p=d+1,m=await o({page:p,walletAddress:r});n(a(m));}catch(p){console.error(`[Pulsar] Failed to fetch transaction history page ${d+1}:`,p),n({isLoading:false,isError:true});}}}}))}function We({adapter:t,maxTransactions:e=50,onRemoteCreate:o,gelatoApiKey:T,beforeTxProcess:c,abortOnTxError:a,...n}){return vanilla.createStore()(middleware.persist((l,r)=>({..._({maxTransactions:e,onRemoteCreate:o})(l,r),getAdapter:()=>t,initializeTransactionsPool:async()=>{let s=Object.values(r().transactionsPool).filter(d=>d.pending).filter(d=>{try{return A(d),!0}catch(p){return console.warn("[Pulsar] Removed invalid persisted transaction:",p),r().removeTxFromPool(d.txKey),false}});await Promise.all(s.map(d=>orbitCore.selectAdapterByKey({adapterKey:d.adapter,adapter:t})?.checkAndInitializeTrackerInStore({tx:d,gelatoApiKey:T,...r()})));},injectExternalPendingTxs:async i=>{let d=r().getAdapter(),p=[],m=i.filter(y=>{try{return A(y),!0}catch(f){return console.warn("[Pulsar] Skipped invalid remote transaction:",f),false}});l(y=>immer.produce(y,f=>{let S=f.transactionsPool;m.forEach(x=>{let g=S[x.txKey];x.pending&&!g&&(S[x.txKey]=x,p.push(x));let v=x.status==="Success"||x.status==="Failed"||x.status==="Replaced";g?.pending&&v&&(g.status=x.status,g.pending=false,x.txKey&&(g.txKey=x.txKey),x.finishedTimestamp&&(g.finishedTimestamp=x.finishedTimestamp));});})),p.length>0&&await Promise.all(p.map(y=>orbitCore.selectAdapterByKey({adapterKey:y.adapter,adapter:d})?.checkAndInitializeTrackerInStore({tx:y,gelatoApiKey:T,...r()})));},executeTxAction:async({defaultTracker:i,actionFunction:s,params:d,beforeTxProcess:p,abortOnTxError:m,...y})=>{let f=m??a??true,S=ie__default.default().unix();r().reconcileUnsyncedTransactions().catch(u=>console.error("[Pulsar] Reconciliation failed:",u));try{await(p??c)?.();}catch(u){if(f)throw l({initialTx:{...d,actionFunction:s,localTimestamp:S,isInitializing:false,error:orbitCore.normalizeError(u)}}),u;console.warn("[Pulsar] beforeTxProcess failed:",u);}$(d);let{desiredChainID:x,tracker:g,...v}=d,{onSuccess:W,onError:J,onReplaced:V}=y;l({initialTx:{...d,actionFunction:s,localTimestamp:S,isInitializing:true}});let k=orbitCore.selectAdapterByKey({adapterKey:v.adapter,adapter:t}),L=u=>{l(K=>immer.produce(K,h=>{h.initialTx&&(h.initialTx.isInitializing=false,h.initialTx.error=orbitCore.normalizeError(u));}));};if(!k){let u=new Error("No adapter found for this transaction.");throw L(u),u}try{let{connectorType:u,walletAddress:K}=k.getConnectorInfo();await k.checkChainForTx(x);let h=await s();if(!h){l({initialTx:void 0});return}let{tracker:M,txKey:E}=k.checkTransactionsTracker({actionTxKey:h,connectorType:u,tracker:g,gelatoApiKey:T}),Y={...v,connectorType:u,from:K,tracker:M||i,chainId:orbitCore.setChainId(x),localTimestamp:S,txKey:E,hash:M==="ethereum"?h:void 0,pending:!1,isTrackedModalOpen:d.withTrackedModal};await r().addTxToPool(Y),l(Z=>immer.produce(Z,R=>{R.initialTx&&(R.initialTx.isInitializing=!1,R.initialTx.lastTxKey=E);}));let Q=r().transactionsPool[E];await k.checkAndInitializeTrackerInStore({tx:Q,onSuccess:W,onError:J,onReplaced:V,gelatoApiKey:T,...r()});}catch(u){throw L(u),u}}}),{...n}))}var Qe=(t=>e=>zustand.useStore(t,e));var Te=5e3,de=10;function et(t){let{tx:e,fetcher:o,onInitialize:T,onSuccess:c,onFailure:a,onIntervalTick:n,onReplaced:l,removeTxFromPool:r,pollingInterval:i=Te,maxRetries:s=de}=t;if(!e.pending)return;T?.();let d=s,p=true,m=f=>{p&&(p=false,r&&!f?.withoutRemoving&&r(e.txKey));};(async()=>{for(;p&&d>0;)try{if(await new Promise(f=>setTimeout(f,i)),!p)break;await o({tx:e,stopPolling:m,onSuccess:c,onFailure:a,onIntervalTick:n,onReplaced:l});}catch(f){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,f),d--;}d<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),a(),m());})();}exports.MAX_TRANSACTION_DESCRIPTION_LENGTH=B;exports.MAX_TRANSACTION_PAYLOAD_BYTES=z;exports.MAX_TRANSACTION_TITLE_LENGTH=N;exports.PulsarTransactionValidationError=P;exports.TransactionStatus=I;exports.TransactionTracker=ee;exports.createBoundedUseStore=Qe;exports.createPulsarStore=We;exports.createTxInMemoryStore=Ce;exports.initializePollingTracker=et;exports.initializeTxTrackingStore=_;exports.selectAllTransactions=G;exports.selectAllTransactionsByActiveWallet=ne;exports.selectPendingTransactions=be;exports.selectPendingTransactionsByActiveWallet=Ae;exports.selectTxByKey=ke;exports.validateInitialTransactionParams=$;exports.validateTransaction=A;
+'use strict';var immer=require('immer'),vanilla=require('zustand/vanilla'),orbitCore=require('@tuwaio/orbit-core'),ae=require('dayjs'),middleware=require('zustand/middleware'),zustand=require('zustand');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var ae__default=/*#__PURE__*/_interopDefault(ae);var ee=(i=>(i.Ethereum="ethereum",i.Safe="safe",i.Gelato="gelato",i.Solana="solana",i.ERC4337="erc4337",i))(ee||{}),K=(T=>(T.Failed="Failed",T.Success="Success",T.Replaced="Replaced",T))(K||{});var U=100,B=300,N=10*1024,ne=[/\beval\s*\(/i,/\bFunction\s*\(/,/\bset(?:Timeout|Interval)\s*\(\s*['"`]/i,/javascript\s*:/i],P=class extends Error{field;constructor(e,o){super(o),this.name="PulsarTransactionValidationError",this.field=e;}};function $(n){w({field:"title",value:n.title,maxLength:U}),w({field:"description",value:n.description,maxLength:B}),j(n.payload);}function v(n){w({field:"title",value:n.title,maxLength:U}),w({field:"description",value:n.description,maxLength:B}),j(n.payload);}function w({field:n,value:e,maxLength:o}){if(e===void 0)return;(Array.isArray(e)?e:[e]).forEach((d,i)=>{let t=Array.isArray(e)?`${n}[${i}]`:n;if(typeof d!="string")throw new P(t,`${t} must be a string.`);if(d.length>o)throw new P(t,`${t} must be ${o} characters or less.`);C(t,d);});}function j(n){if(n===void 0)return;let e;try{e=JSON.stringify(n);}catch{throw new P("payload","payload must be JSON-serializable.")}if(e===void 0)throw new P("payload","payload must be JSON-serializable.");if(new TextEncoder().encode(e).length>N)throw new P("payload",`payload must be ${N} bytes or less when serialized.`);_(n);}function _(n,e="payload"){if(typeof n=="string"){C(e,n);return}n===null||typeof n!="object"||Object.entries(n).forEach(([o,T])=>{let d=`${e}.${o}`;C(d,o),_(T,d);});}function C(n,e){if(ne.some(o=>o.test(e)))throw new P(n,`${n} contains a blocked executable-like pattern.`)}function G({maxTransactions:n,onRemoteCreate:e}){let o=false;return (T,d)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,unsyncedTxKeys:{},reconcileUnsyncedTransactions:async()=>{if(!e||o)return;let i=Object.keys(d().unsyncedTxKeys||{});if(i.length!==0){o=true;try{for(let t of i){let l=d().transactionsPool[t];if(!l){T(r=>immer.produce(r,s=>{s.unsyncedTxKeys&&delete s.unsyncedTxKeys[t];}));continue}try{await e(l),T(r=>immer.produce(r,s=>{let c=s.transactionsPool[t];c&&(c.syncStatus="synced"),s.unsyncedTxKeys&&delete s.unsyncedTxKeys[t];}));}catch(r){console.warn(`[Pulsar] Failed to reconcile tx ${t}:`,r);}}}finally{o=false;}}},addTxToPool:i=>{v(i);let t={...i,pending:true};return (async()=>{let r=false;if(e)try{await e(t),t.syncStatus="synced";}catch(s){console.warn("[Pulsar] onRemoteCreate failed, transaction queued for background sync:",s),t.syncStatus="pending-sync",r=true;}T(s=>immer.produce(s,c=>{if(c.lastAddedTxKey=i.txKey,r&&(c.unsyncedTxKeys||(c.unsyncedTxKeys={}),c.unsyncedTxKeys[i.txKey]=true),i.txKey){if(Object.keys(c.transactionsPool).length>=n){let p=Object.values(c.transactionsPool).sort((x,f)=>x.localTimestamp-f.localTimestamp);if(p.length>0){let x=p[0];delete c.transactionsPool[x.txKey];}}c.transactionsPool[i.txKey]=t;}}));})()},updateTxParams:(i,t)=>{T(r=>immer.produce(r,s=>{let c=s.transactionsPool[i];c&&Object.assign(c,t);})),(t.status==="Success"||t.status==="Failed"||t.status==="Replaced")&&d().reconcileUnsyncedTransactions&&d().unsyncedTxKeys?.[i]&&d().reconcileUnsyncedTransactions().catch(r=>{console.error("[Pulsar] Terminal reconciliation failed:",r);});},removeTxFromPool:i=>{T(t=>immer.produce(t,l=>{delete l.transactionsPool[i];}));},closeTxTrackedModal:i=>{T(t=>immer.produce(t,l=>{if(i&&l.transactionsPool[i]){let r=l.transactionsPool[i];l.transactionsPool[i]={...r,isTrackedModalOpen:false};}l.initialTx=void 0;}));},getLastTxKey:()=>d().lastAddedTxKey})}var D=n=>Object.values(n).sort((e,o)=>Number(e.localTimestamp)-Number(o.localTimestamp)),be=n=>D(n).filter(e=>e.pending),Ae=(n,e)=>n[e],te=(n,e)=>D(n).filter(o=>o.from.toLowerCase()===e.toLowerCase()),ke=(n,e)=>te(n,e).filter(o=>o.pending);var X=n=>n==="Success"||n==="Replaced",H=(n,e)=>{let o=n[e.txKey];if(o){if(X(o.status))return  false;if(o.pending){if(X(e.status))return n[e.txKey]={...o,...e},true;let T=typeof e.confirmations=="number"?e.confirmations:0,d=typeof o.confirmations=="number"?o.confirmations:0;return T>d?(n[e.txKey]={...o,...e},true):false}}return n[e.txKey]=e,true};function Fe({localTransactionsPool:n,reconcileUnsyncedTransactions:e,getHistory:o,onHistoryFetched:T}){immer.setAutoFreeze(false);let d=t=>({isLoading:t,isError:false}),i=t=>t?(T&&queueMicrotask(()=>T(t.docs)),l=>immer.produce(l,r=>{let s=r.transactionsPool;for(let c of t.docs)H(s,c);r.currentPage=t.page,r.hasMore=t.hasNextPage,r.isLoading=false;})):l=>l;return vanilla.createStore()((t,l)=>({transactionsPool:n,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{t(s=>immer.produce(s,c=>{let a=c.transactionsPool;for(let p of Object.values(r))H(a,p);}));},fetchInitial:async r=>{if(!(!o||!r)){t(d(true)),e&&await e();try{let s=await o({page:1,walletAddress:r});t(i(s));}catch(s){console.error("[Pulsar] Failed to fetch initial transaction history:",s),t({isLoading:false,isError:true});}}},fetchNextPage:async r=>{let{hasMore:s,isLoading:c,currentPage:a}=l();if(!(!o||!s||c||!r)){t(d(true));try{let p=a+1,x=await o({page:p,walletAddress:r});t(i(x));}catch(p){console.error(`[Pulsar] Failed to fetch transaction history page ${a+1}:`,p),t({isLoading:false,isError:true});}}}}))}function We({adapter:n,maxTransactions:e=50,onRemoteCreate:o,gelatoApiKey:T,beforeTxProcess:d,abortOnTxError:i,...t}){return vanilla.createStore()(middleware.persist((l,r)=>({...G({maxTransactions:e,onRemoteCreate:o})(l,r),getAdapter:()=>n,initializeTransactionsPool:async()=>{let c=Object.values(r().transactionsPool).filter(a=>a.pending).filter(a=>{try{return v(a),!0}catch(p){return console.warn("[Pulsar] Removed invalid persisted transaction:",p),r().removeTxFromPool(a.txKey),false}});await Promise.all(c.map(a=>orbitCore.selectAdapterByKey({adapterKey:a.adapter,adapter:n})?.checkAndInitializeTrackerInStore({tx:a,gelatoApiKey:T,...r()})));},injectExternalPendingTxs:async s=>{let a=r().getAdapter(),p=[],x=s.filter(f=>{try{return v(f),!0}catch(m){return console.warn("[Pulsar] Skipped invalid remote transaction:",m),false}});l(f=>immer.produce(f,m=>{let S=m.transactionsPool;x.forEach(u=>{let g=S[u.txKey];u.pending&&!g&&(S[u.txKey]=u,p.push(u));let I=u.status==="Success"||u.status==="Failed"||u.status==="Replaced";g?.pending&&I&&(g.status=u.status,g.pending=false,u.txKey&&(g.txKey=u.txKey),u.finishedTimestamp&&(g.finishedTimestamp=u.finishedTimestamp));});})),p.length>0&&await Promise.all(p.map(f=>orbitCore.selectAdapterByKey({adapterKey:f.adapter,adapter:a})?.checkAndInitializeTrackerInStore({tx:f,gelatoApiKey:T,...r()})));},executeTxAction:async({defaultTracker:s,actionFunction:c,params:a,beforeTxProcess:p,abortOnTxError:x,...f})=>{let m=x??i??true,S=ae__default.default().unix();r().reconcileUnsyncedTransactions().catch(y=>console.error("[Pulsar] Reconciliation failed:",y)),$(a);let{desiredChainID:u,tracker:g,...I}=a,{onSuccess:J,onError:V,onReplaced:Y}=f;l({initialTx:{...a,actionFunction:c,localTimestamp:S,isInitializing:true}});let A=orbitCore.selectAdapterByKey({adapterKey:I.adapter,adapter:n}),M=y=>{l(E=>immer.produce(E,h=>{h.initialTx&&(h.initialTx.isInitializing=false,h.initialTx.error=orbitCore.normalizeError(y));}));};if(!A){let y=new Error("No adapter found for this transaction.");throw M(y),y}try{let{connectorType:y,walletAddress:E}=A.getConnectorInfo();await A.checkChainForTx(u);try{await(p??d)?.();}catch(k){if(m)throw l({initialTx:{...a,actionFunction:c,localTimestamp:S,isInitializing:!1,error:orbitCore.normalizeError(k)}}),k;console.warn("[Pulsar] beforeTxProcess failed:",k);}let h=await c();if(!h){l({initialTx:void 0});return}let{tracker:z,txKey:R}=A.checkTransactionsTracker({actionTxKey:h,connectorType:y,tracker:g,gelatoApiKey:a.gelatoApiKey??T,bundlerUrl:a.bundlerUrl,pimlicoApiKey:a.pimlicoApiKey}),Q={...I,connectorType:y,from:E,tracker:z||s,chainId:orbitCore.setChainId(u),localTimestamp:S,txKey:R,bundlerUrl:a.bundlerUrl,pimlicoApiKey:a.pimlicoApiKey,hash:z==="ethereum"?h:void 0,pending:!1,isTrackedModalOpen:a.withTrackedModal};await r().addTxToPool(Q),l(k=>immer.produce(k,O=>{O.initialTx&&(O.initialTx.isInitializing=!1,O.initialTx.lastTxKey=R);}));let Z=r().transactionsPool[R];await A.checkAndInitializeTrackerInStore({tx:Z,onSuccess:J,onError:V,onReplaced:Y,gelatoApiKey:T,...r()});}catch(y){throw M(y),y}}}),{...t}))}var Qe=(n=>e=>zustand.useStore(n,e));var Te=5e3,de=10;function en(n){let{tx:e,fetcher:o,onInitialize:T,onSuccess:d,onFailure:i,onIntervalTick:t,onReplaced:l,removeTxFromPool:r,pollingInterval:s=Te,maxRetries:c=de}=n;if(!e.pending)return;T?.();let a=c,p=true,x=m=>{p&&(p=false,r&&!m?.withoutRemoving&&r(e.txKey));};(async()=>{for(;p&&a>0;)try{if(await new Promise(m=>setTimeout(m,s)),!p)break;await o({tx:e,stopPolling:x,onSuccess:d,onFailure:i,onIntervalTick:t,onReplaced:l});}catch(m){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,m),a--;}a<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),i(),x());})();}exports.MAX_TRANSACTION_DESCRIPTION_LENGTH=B;exports.MAX_TRANSACTION_PAYLOAD_BYTES=N;exports.MAX_TRANSACTION_TITLE_LENGTH=U;exports.PulsarTransactionValidationError=P;exports.TransactionStatus=K;exports.TransactionTracker=ee;exports.createBoundedUseStore=Qe;exports.createPulsarStore=We;exports.createTxInMemoryStore=Fe;exports.initializePollingTracker=en;exports.initializeTxTrackingStore=G;exports.selectAllTransactions=D;exports.selectAllTransactionsByActiveWallet=te;exports.selectPendingTransactions=be;exports.selectPendingTransactionsByActiveWallet=ke;exports.selectTxByKey=Ae;exports.validateInitialTransactionParams=$;exports.validateTransaction=v;

package/dist/index.mjs

@@ -1 +1 @@
-import {produce,setAutoFreeze}from'immer';import {createStore}from'zustand/vanilla';import {normalizeError,selectAdapterByKey,setChainId}from'@tuwaio/orbit-core';import ie from'dayjs';import {persist}from'zustand/middleware';import {useStore}from'zustand';var ee=(c=>(c.Ethereum="ethereum",c.Safe="safe",c.Gelato="gelato",c.Solana="solana",c))(ee||{}),I=(T=>(T.Failed="Failed",T.Success="Success",T.Replaced="Replaced",T))(I||{});var N=100,B=300,z=10*1024,te=[/\beval\s*\(/i,/\bFunction\s*\(/,/\bset(?:Timeout|Interval)\s*\(\s*['"`]/i,/javascript\s*:/i],P=class extends Error{field;constructor(e,o){super(o),this.name="PulsarTransactionValidationError",this.field=e;}};function $(t){w({field:"title",value:t.title,maxLength:N}),w({field:"description",value:t.description,maxLength:B}),U(t.payload);}function A(t){w({field:"title",value:t.title,maxLength:N}),w({field:"description",value:t.description,maxLength:B}),U(t.payload);}function w({field:t,value:e,maxLength:o}){if(e===void 0)return;(Array.isArray(e)?e:[e]).forEach((c,a)=>{let n=Array.isArray(e)?`${t}[${a}]`:t;if(typeof c!="string")throw new P(n,`${n} must be a string.`);if(c.length>o)throw new P(n,`${n} must be ${o} characters or less.`);O(n,c);});}function U(t){if(t===void 0)return;let e;try{e=JSON.stringify(t);}catch{throw new P("payload","payload must be JSON-serializable.")}if(e===void 0)throw new P("payload","payload must be JSON-serializable.");if(new TextEncoder().encode(e).length>z)throw new P("payload",`payload must be ${z} bytes or less when serialized.`);j(t);}function j(t,e="payload"){if(typeof t=="string"){O(e,t);return}t===null||typeof t!="object"||Object.entries(t).forEach(([o,T])=>{let c=`${e}.${o}`;O(c,o),j(T,c);});}function O(t,e){if(te.some(o=>o.test(e)))throw new P(t,`${t} contains a blocked executable-like pattern.`)}function _({maxTransactions:t,onRemoteCreate:e}){let o=false;return (T,c)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,unsyncedTxKeys:{},reconcileUnsyncedTransactions:async()=>{if(!e||o)return;let a=Object.keys(c().unsyncedTxKeys||{});if(a.length!==0){o=true;try{for(let n of a){let l=c().transactionsPool[n];if(!l){T(r=>produce(r,i=>{i.unsyncedTxKeys&&delete i.unsyncedTxKeys[n];}));continue}try{await e(l),T(r=>produce(r,i=>{let s=i.transactionsPool[n];s&&(s.syncStatus="synced"),i.unsyncedTxKeys&&delete i.unsyncedTxKeys[n];}));}catch(r){console.warn(`[Pulsar] Failed to reconcile tx ${n}:`,r);}}}finally{o=false;}}},addTxToPool:a=>{A(a);let n={...a,pending:true};return (async()=>{let r=false;if(e)try{await e(n),n.syncStatus="synced";}catch(i){console.warn("[Pulsar] onRemoteCreate failed, transaction queued for background sync:",i),n.syncStatus="pending-sync",r=true;}T(i=>produce(i,s=>{if(s.lastAddedTxKey=a.txKey,r&&(s.unsyncedTxKeys||(s.unsyncedTxKeys={}),s.unsyncedTxKeys[a.txKey]=true),a.txKey){if(Object.keys(s.transactionsPool).length>=t){let p=Object.values(s.transactionsPool).sort((m,y)=>m.localTimestamp-y.localTimestamp);if(p.length>0){let m=p[0];delete s.transactionsPool[m.txKey];}}s.transactionsPool[a.txKey]=n;}}));})()},updateTxParams:(a,n)=>{T(r=>produce(r,i=>{let s=i.transactionsPool[a];s&&Object.assign(s,n);})),(n.status==="Success"||n.status==="Failed"||n.status==="Replaced")&&c().reconcileUnsyncedTransactions&&c().unsyncedTxKeys?.[a]&&c().reconcileUnsyncedTransactions().catch(r=>{console.error("[Pulsar] Terminal reconciliation failed:",r);});},removeTxFromPool:a=>{T(n=>produce(n,l=>{delete l.transactionsPool[a];}));},closeTxTrackedModal:a=>{T(n=>produce(n,l=>{if(a&&l.transactionsPool[a]){let r=l.transactionsPool[a];l.transactionsPool[a]={...r,isTrackedModalOpen:false};}l.initialTx=void 0;}));},getLastTxKey:()=>c().lastAddedTxKey})}var G=t=>Object.values(t).sort((e,o)=>Number(e.localTimestamp)-Number(o.localTimestamp)),be=t=>G(t).filter(e=>e.pending),ke=(t,e)=>t[e],ne=(t,e)=>G(t).filter(o=>o.from.toLowerCase()===e.toLowerCase()),Ae=(t,e)=>ne(t,e).filter(o=>o.pending);var q=t=>t==="Success"||t==="Replaced",X=(t,e)=>{let o=t[e.txKey];if(o){if(q(o.status))return  false;if(o.pending){if(q(e.status))return t[e.txKey]={...o,...e},true;let T=typeof e.confirmations=="number"?e.confirmations:0,c=typeof o.confirmations=="number"?o.confirmations:0;return T>c?(t[e.txKey]={...o,...e},true):false}}return t[e.txKey]=e,true};function Ce({localTransactionsPool:t,reconcileUnsyncedTransactions:e,getHistory:o,onHistoryFetched:T}){setAutoFreeze(false);let c=n=>({isLoading:n,isError:false}),a=n=>n?(T&&queueMicrotask(()=>T(n.docs)),l=>produce(l,r=>{let i=r.transactionsPool;for(let s of n.docs)X(i,s);r.currentPage=n.page,r.hasMore=n.hasNextPage,r.isLoading=false;})):l=>l;return createStore()((n,l)=>({transactionsPool:t,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{n(i=>produce(i,s=>{let d=s.transactionsPool;for(let p of Object.values(r))X(d,p);}));},fetchInitial:async r=>{if(!(!o||!r)){n(c(true)),e&&await e();try{let i=await o({page:1,walletAddress:r});n(a(i));}catch(i){console.error("[Pulsar] Failed to fetch initial transaction history:",i),n({isLoading:false,isError:true});}}},fetchNextPage:async r=>{let{hasMore:i,isLoading:s,currentPage:d}=l();if(!(!o||!i||s||!r)){n(c(true));try{let p=d+1,m=await o({page:p,walletAddress:r});n(a(m));}catch(p){console.error(`[Pulsar] Failed to fetch transaction history page ${d+1}:`,p),n({isLoading:false,isError:true});}}}}))}function We({adapter:t,maxTransactions:e=50,onRemoteCreate:o,gelatoApiKey:T,beforeTxProcess:c,abortOnTxError:a,...n}){return createStore()(persist((l,r)=>({..._({maxTransactions:e,onRemoteCreate:o})(l,r),getAdapter:()=>t,initializeTransactionsPool:async()=>{let s=Object.values(r().transactionsPool).filter(d=>d.pending).filter(d=>{try{return A(d),!0}catch(p){return console.warn("[Pulsar] Removed invalid persisted transaction:",p),r().removeTxFromPool(d.txKey),false}});await Promise.all(s.map(d=>selectAdapterByKey({adapterKey:d.adapter,adapter:t})?.checkAndInitializeTrackerInStore({tx:d,gelatoApiKey:T,...r()})));},injectExternalPendingTxs:async i=>{let d=r().getAdapter(),p=[],m=i.filter(y=>{try{return A(y),!0}catch(f){return console.warn("[Pulsar] Skipped invalid remote transaction:",f),false}});l(y=>produce(y,f=>{let S=f.transactionsPool;m.forEach(x=>{let g=S[x.txKey];x.pending&&!g&&(S[x.txKey]=x,p.push(x));let v=x.status==="Success"||x.status==="Failed"||x.status==="Replaced";g?.pending&&v&&(g.status=x.status,g.pending=false,x.txKey&&(g.txKey=x.txKey),x.finishedTimestamp&&(g.finishedTimestamp=x.finishedTimestamp));});})),p.length>0&&await Promise.all(p.map(y=>selectAdapterByKey({adapterKey:y.adapter,adapter:d})?.checkAndInitializeTrackerInStore({tx:y,gelatoApiKey:T,...r()})));},executeTxAction:async({defaultTracker:i,actionFunction:s,params:d,beforeTxProcess:p,abortOnTxError:m,...y})=>{let f=m??a??true,S=ie().unix();r().reconcileUnsyncedTransactions().catch(u=>console.error("[Pulsar] Reconciliation failed:",u));try{await(p??c)?.();}catch(u){if(f)throw l({initialTx:{...d,actionFunction:s,localTimestamp:S,isInitializing:false,error:normalizeError(u)}}),u;console.warn("[Pulsar] beforeTxProcess failed:",u);}$(d);let{desiredChainID:x,tracker:g,...v}=d,{onSuccess:W,onError:J,onReplaced:V}=y;l({initialTx:{...d,actionFunction:s,localTimestamp:S,isInitializing:true}});let k=selectAdapterByKey({adapterKey:v.adapter,adapter:t}),L=u=>{l(K=>produce(K,h=>{h.initialTx&&(h.initialTx.isInitializing=false,h.initialTx.error=normalizeError(u));}));};if(!k){let u=new Error("No adapter found for this transaction.");throw L(u),u}try{let{connectorType:u,walletAddress:K}=k.getConnectorInfo();await k.checkChainForTx(x);let h=await s();if(!h){l({initialTx:void 0});return}let{tracker:M,txKey:E}=k.checkTransactionsTracker({actionTxKey:h,connectorType:u,tracker:g,gelatoApiKey:T}),Y={...v,connectorType:u,from:K,tracker:M||i,chainId:setChainId(x),localTimestamp:S,txKey:E,hash:M==="ethereum"?h:void 0,pending:!1,isTrackedModalOpen:d.withTrackedModal};await r().addTxToPool(Y),l(Z=>produce(Z,R=>{R.initialTx&&(R.initialTx.isInitializing=!1,R.initialTx.lastTxKey=E);}));let Q=r().transactionsPool[E];await k.checkAndInitializeTrackerInStore({tx:Q,onSuccess:W,onError:J,onReplaced:V,gelatoApiKey:T,...r()});}catch(u){throw L(u),u}}}),{...n}))}var Qe=(t=>e=>useStore(t,e));var Te=5e3,de=10;function et(t){let{tx:e,fetcher:o,onInitialize:T,onSuccess:c,onFailure:a,onIntervalTick:n,onReplaced:l,removeTxFromPool:r,pollingInterval:i=Te,maxRetries:s=de}=t;if(!e.pending)return;T?.();let d=s,p=true,m=f=>{p&&(p=false,r&&!f?.withoutRemoving&&r(e.txKey));};(async()=>{for(;p&&d>0;)try{if(await new Promise(f=>setTimeout(f,i)),!p)break;await o({tx:e,stopPolling:m,onSuccess:c,onFailure:a,onIntervalTick:n,onReplaced:l});}catch(f){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,f),d--;}d<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),a(),m());})();}export{B as MAX_TRANSACTION_DESCRIPTION_LENGTH,z as MAX_TRANSACTION_PAYLOAD_BYTES,N as MAX_TRANSACTION_TITLE_LENGTH,P as PulsarTransactionValidationError,I as TransactionStatus,ee as TransactionTracker,Qe as createBoundedUseStore,We as createPulsarStore,Ce as createTxInMemoryStore,et as initializePollingTracker,_ as initializeTxTrackingStore,G as selectAllTransactions,ne as selectAllTransactionsByActiveWallet,be as selectPendingTransactions,Ae as selectPendingTransactionsByActiveWallet,ke as selectTxByKey,$ as validateInitialTransactionParams,A as validateTransaction};
+import {produce,setAutoFreeze}from'immer';import {createStore}from'zustand/vanilla';import {selectAdapterByKey,normalizeError,setChainId}from'@tuwaio/orbit-core';import ae from'dayjs';import {persist}from'zustand/middleware';import {useStore}from'zustand';var ee=(i=>(i.Ethereum="ethereum",i.Safe="safe",i.Gelato="gelato",i.Solana="solana",i.ERC4337="erc4337",i))(ee||{}),K=(T=>(T.Failed="Failed",T.Success="Success",T.Replaced="Replaced",T))(K||{});var U=100,B=300,N=10*1024,ne=[/\beval\s*\(/i,/\bFunction\s*\(/,/\bset(?:Timeout|Interval)\s*\(\s*['"`]/i,/javascript\s*:/i],P=class extends Error{field;constructor(e,o){super(o),this.name="PulsarTransactionValidationError",this.field=e;}};function $(n){w({field:"title",value:n.title,maxLength:U}),w({field:"description",value:n.description,maxLength:B}),j(n.payload);}function v(n){w({field:"title",value:n.title,maxLength:U}),w({field:"description",value:n.description,maxLength:B}),j(n.payload);}function w({field:n,value:e,maxLength:o}){if(e===void 0)return;(Array.isArray(e)?e:[e]).forEach((d,i)=>{let t=Array.isArray(e)?`${n}[${i}]`:n;if(typeof d!="string")throw new P(t,`${t} must be a string.`);if(d.length>o)throw new P(t,`${t} must be ${o} characters or less.`);C(t,d);});}function j(n){if(n===void 0)return;let e;try{e=JSON.stringify(n);}catch{throw new P("payload","payload must be JSON-serializable.")}if(e===void 0)throw new P("payload","payload must be JSON-serializable.");if(new TextEncoder().encode(e).length>N)throw new P("payload",`payload must be ${N} bytes or less when serialized.`);_(n);}function _(n,e="payload"){if(typeof n=="string"){C(e,n);return}n===null||typeof n!="object"||Object.entries(n).forEach(([o,T])=>{let d=`${e}.${o}`;C(d,o),_(T,d);});}function C(n,e){if(ne.some(o=>o.test(e)))throw new P(n,`${n} contains a blocked executable-like pattern.`)}function G({maxTransactions:n,onRemoteCreate:e}){let o=false;return (T,d)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,unsyncedTxKeys:{},reconcileUnsyncedTransactions:async()=>{if(!e||o)return;let i=Object.keys(d().unsyncedTxKeys||{});if(i.length!==0){o=true;try{for(let t of i){let l=d().transactionsPool[t];if(!l){T(r=>produce(r,s=>{s.unsyncedTxKeys&&delete s.unsyncedTxKeys[t];}));continue}try{await e(l),T(r=>produce(r,s=>{let c=s.transactionsPool[t];c&&(c.syncStatus="synced"),s.unsyncedTxKeys&&delete s.unsyncedTxKeys[t];}));}catch(r){console.warn(`[Pulsar] Failed to reconcile tx ${t}:`,r);}}}finally{o=false;}}},addTxToPool:i=>{v(i);let t={...i,pending:true};return (async()=>{let r=false;if(e)try{await e(t),t.syncStatus="synced";}catch(s){console.warn("[Pulsar] onRemoteCreate failed, transaction queued for background sync:",s),t.syncStatus="pending-sync",r=true;}T(s=>produce(s,c=>{if(c.lastAddedTxKey=i.txKey,r&&(c.unsyncedTxKeys||(c.unsyncedTxKeys={}),c.unsyncedTxKeys[i.txKey]=true),i.txKey){if(Object.keys(c.transactionsPool).length>=n){let p=Object.values(c.transactionsPool).sort((x,f)=>x.localTimestamp-f.localTimestamp);if(p.length>0){let x=p[0];delete c.transactionsPool[x.txKey];}}c.transactionsPool[i.txKey]=t;}}));})()},updateTxParams:(i,t)=>{T(r=>produce(r,s=>{let c=s.transactionsPool[i];c&&Object.assign(c,t);})),(t.status==="Success"||t.status==="Failed"||t.status==="Replaced")&&d().reconcileUnsyncedTransactions&&d().unsyncedTxKeys?.[i]&&d().reconcileUnsyncedTransactions().catch(r=>{console.error("[Pulsar] Terminal reconciliation failed:",r);});},removeTxFromPool:i=>{T(t=>produce(t,l=>{delete l.transactionsPool[i];}));},closeTxTrackedModal:i=>{T(t=>produce(t,l=>{if(i&&l.transactionsPool[i]){let r=l.transactionsPool[i];l.transactionsPool[i]={...r,isTrackedModalOpen:false};}l.initialTx=void 0;}));},getLastTxKey:()=>d().lastAddedTxKey})}var D=n=>Object.values(n).sort((e,o)=>Number(e.localTimestamp)-Number(o.localTimestamp)),be=n=>D(n).filter(e=>e.pending),Ae=(n,e)=>n[e],te=(n,e)=>D(n).filter(o=>o.from.toLowerCase()===e.toLowerCase()),ke=(n,e)=>te(n,e).filter(o=>o.pending);var X=n=>n==="Success"||n==="Replaced",H=(n,e)=>{let o=n[e.txKey];if(o){if(X(o.status))return  false;if(o.pending){if(X(e.status))return n[e.txKey]={...o,...e},true;let T=typeof e.confirmations=="number"?e.confirmations:0,d=typeof o.confirmations=="number"?o.confirmations:0;return T>d?(n[e.txKey]={...o,...e},true):false}}return n[e.txKey]=e,true};function Fe({localTransactionsPool:n,reconcileUnsyncedTransactions:e,getHistory:o,onHistoryFetched:T}){setAutoFreeze(false);let d=t=>({isLoading:t,isError:false}),i=t=>t?(T&&queueMicrotask(()=>T(t.docs)),l=>produce(l,r=>{let s=r.transactionsPool;for(let c of t.docs)H(s,c);r.currentPage=t.page,r.hasMore=t.hasNextPage,r.isLoading=false;})):l=>l;return createStore()((t,l)=>({transactionsPool:n,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{t(s=>produce(s,c=>{let a=c.transactionsPool;for(let p of Object.values(r))H(a,p);}));},fetchInitial:async r=>{if(!(!o||!r)){t(d(true)),e&&await e();try{let s=await o({page:1,walletAddress:r});t(i(s));}catch(s){console.error("[Pulsar] Failed to fetch initial transaction history:",s),t({isLoading:false,isError:true});}}},fetchNextPage:async r=>{let{hasMore:s,isLoading:c,currentPage:a}=l();if(!(!o||!s||c||!r)){t(d(true));try{let p=a+1,x=await o({page:p,walletAddress:r});t(i(x));}catch(p){console.error(`[Pulsar] Failed to fetch transaction history page ${a+1}:`,p),t({isLoading:false,isError:true});}}}}))}function We({adapter:n,maxTransactions:e=50,onRemoteCreate:o,gelatoApiKey:T,beforeTxProcess:d,abortOnTxError:i,...t}){return createStore()(persist((l,r)=>({...G({maxTransactions:e,onRemoteCreate:o})(l,r),getAdapter:()=>n,initializeTransactionsPool:async()=>{let c=Object.values(r().transactionsPool).filter(a=>a.pending).filter(a=>{try{return v(a),!0}catch(p){return console.warn("[Pulsar] Removed invalid persisted transaction:",p),r().removeTxFromPool(a.txKey),false}});await Promise.all(c.map(a=>selectAdapterByKey({adapterKey:a.adapter,adapter:n})?.checkAndInitializeTrackerInStore({tx:a,gelatoApiKey:T,...r()})));},injectExternalPendingTxs:async s=>{let a=r().getAdapter(),p=[],x=s.filter(f=>{try{return v(f),!0}catch(m){return console.warn("[Pulsar] Skipped invalid remote transaction:",m),false}});l(f=>produce(f,m=>{let S=m.transactionsPool;x.forEach(u=>{let g=S[u.txKey];u.pending&&!g&&(S[u.txKey]=u,p.push(u));let I=u.status==="Success"||u.status==="Failed"||u.status==="Replaced";g?.pending&&I&&(g.status=u.status,g.pending=false,u.txKey&&(g.txKey=u.txKey),u.finishedTimestamp&&(g.finishedTimestamp=u.finishedTimestamp));});})),p.length>0&&await Promise.all(p.map(f=>selectAdapterByKey({adapterKey:f.adapter,adapter:a})?.checkAndInitializeTrackerInStore({tx:f,gelatoApiKey:T,...r()})));},executeTxAction:async({defaultTracker:s,actionFunction:c,params:a,beforeTxProcess:p,abortOnTxError:x,...f})=>{let m=x??i??true,S=ae().unix();r().reconcileUnsyncedTransactions().catch(y=>console.error("[Pulsar] Reconciliation failed:",y)),$(a);let{desiredChainID:u,tracker:g,...I}=a,{onSuccess:J,onError:V,onReplaced:Y}=f;l({initialTx:{...a,actionFunction:c,localTimestamp:S,isInitializing:true}});let A=selectAdapterByKey({adapterKey:I.adapter,adapter:n}),M=y=>{l(E=>produce(E,h=>{h.initialTx&&(h.initialTx.isInitializing=false,h.initialTx.error=normalizeError(y));}));};if(!A){let y=new Error("No adapter found for this transaction.");throw M(y),y}try{let{connectorType:y,walletAddress:E}=A.getConnectorInfo();await A.checkChainForTx(u);try{await(p??d)?.();}catch(k){if(m)throw l({initialTx:{...a,actionFunction:c,localTimestamp:S,isInitializing:!1,error:normalizeError(k)}}),k;console.warn("[Pulsar] beforeTxProcess failed:",k);}let h=await c();if(!h){l({initialTx:void 0});return}let{tracker:z,txKey:R}=A.checkTransactionsTracker({actionTxKey:h,connectorType:y,tracker:g,gelatoApiKey:a.gelatoApiKey??T,bundlerUrl:a.bundlerUrl,pimlicoApiKey:a.pimlicoApiKey}),Q={...I,connectorType:y,from:E,tracker:z||s,chainId:setChainId(u),localTimestamp:S,txKey:R,bundlerUrl:a.bundlerUrl,pimlicoApiKey:a.pimlicoApiKey,hash:z==="ethereum"?h:void 0,pending:!1,isTrackedModalOpen:a.withTrackedModal};await r().addTxToPool(Q),l(k=>produce(k,O=>{O.initialTx&&(O.initialTx.isInitializing=!1,O.initialTx.lastTxKey=R);}));let Z=r().transactionsPool[R];await A.checkAndInitializeTrackerInStore({tx:Z,onSuccess:J,onError:V,onReplaced:Y,gelatoApiKey:T,...r()});}catch(y){throw M(y),y}}}),{...t}))}var Qe=(n=>e=>useStore(n,e));var Te=5e3,de=10;function en(n){let{tx:e,fetcher:o,onInitialize:T,onSuccess:d,onFailure:i,onIntervalTick:t,onReplaced:l,removeTxFromPool:r,pollingInterval:s=Te,maxRetries:c=de}=n;if(!e.pending)return;T?.();let a=c,p=true,x=m=>{p&&(p=false,r&&!m?.withoutRemoving&&r(e.txKey));};(async()=>{for(;p&&a>0;)try{if(await new Promise(m=>setTimeout(m,s)),!p)break;await o({tx:e,stopPolling:x,onSuccess:d,onFailure:i,onIntervalTick:t,onReplaced:l});}catch(m){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,m),a--;}a<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),i(),x());})();}export{B as MAX_TRANSACTION_DESCRIPTION_LENGTH,N as MAX_TRANSACTION_PAYLOAD_BYTES,U as MAX_TRANSACTION_TITLE_LENGTH,P as PulsarTransactionValidationError,K as TransactionStatus,ee as TransactionTracker,Qe as createBoundedUseStore,We as createPulsarStore,Fe as createTxInMemoryStore,en as initializePollingTracker,G as initializeTxTrackingStore,D as selectAllTransactions,te as selectAllTransactionsByActiveWallet,be as selectPendingTransactions,ke as selectPendingTransactionsByActiveWallet,Ae as selectTxByKey,$ as validateInitialTransactionParams,v as validateTransaction};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/pulsar-core",
-  "version": "0.6.11",
+  "version": "0.7.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -41,23 +41,23 @@
     }
   ],
   "peerDependencies": {
-    "@tuwaio/orbit-core": ">=0.2.8",
+    "@tuwaio/orbit-core": ">=0.3",
     "dayjs": "1.x.x",
     "immer": "11.x.x",
     "zustand": "5.x.x"
   },
   "devDependencies": {
-    "@tuwaio/orbit-core": "^0.2.15",
-    "dayjs": "^1.11.21",
-    "immer": "^11.1.16",
+    "@tuwaio/orbit-core": "^0.3.0",
+    "dayjs": "^1.11.23",
+    "immer": "^11.1.18",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.10",
-    "zustand": "^5.0.14"
+    "typescript": "6.0.3",
+    "vitest": "^5.0.0",
+    "zustand": "^5.0.15"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",
     "build": "tsup",
-    "test": "vitest"
+    "test": "vitest run"
   }
 }