@tuwaio/pulsar-core 0.7.0 → 0.8.1

package/dist/index.js

@@ -1 +1 @@
-'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;
+'use strict';var immer=require('immer'),vanilla=require('zustand/vanilla'),orbitCore=require('@tuwaio/orbit-core'),ce=require('dayjs'),middleware=require('zustand/middleware'),zustand=require('zustand');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var ce__default=/*#__PURE__*/_interopDefault(ce);var ee=(p=>(p.Ethereum="ethereum",p.Safe="safe",p.Gelato="gelato",p.Solana="solana",p.ERC4337="erc4337",p))(ee||{}),K=(l=>(l.Failed="Failed",l.Success="Success",l.Replaced="Replaced",l))(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 S(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,p)=>{let T=Array.isArray(e)?`${n}[${p}]`: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.`);O(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"){O(e,n);return}n===null||typeof n!="object"||Object.entries(n).forEach(([o,l])=>{let d=`${e}.${o}`;O(d,o),_(l,d);});}function O(n,e){if(ne.some(o=>o.test(e)))throw new P(n,`${n} contains a blocked executable-like pattern.`)}function te(n){let e={...n};return delete e.pimlicoApiKey,delete e.gelatoApiKey,e}function G({maxTransactions:n,onRemoteCreate:e}){let o=false,l=new Set;return (d,p)=>{let T=async(t,r)=>{let s=p().transactionsPool[t];if(!(!e||!s||l.has(t))){l.add(t);try{await e(te(s)),d(a=>immer.produce(a,i=>{let c=i.transactionsPool[t];c&&(c.syncStatus="synced"),i.unsyncedTxKeys&&delete i.unsyncedTxKeys[t];}));}catch(a){console.warn(r,a);}finally{l.delete(t);}}};return {transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,unsyncedTxKeys:{},reconcileUnsyncedTransactions:async()=>{if(!e||o)return;let t=Object.keys(p().unsyncedTxKeys||{});if(t.length!==0){o=true;try{for(let r of t){if(!p().transactionsPool[r]){d(s=>immer.produce(s,a=>{a.unsyncedTxKeys&&delete a.unsyncedTxKeys[r];}));continue}await T(r,`[Pulsar] Failed to reconcile tx ${r}:`);}}finally{o=false;}}},addTxToPool:t=>{S(t);let r={...t,pending:true,...e&&{syncStatus:"pending-sync"}};return d(s=>immer.produce(s,a=>{if(a.lastAddedTxKey=t.txKey,t.txKey){if(e&&(a.unsyncedTxKeys||(a.unsyncedTxKeys={}),a.unsyncedTxKeys[t.txKey]=true),Object.keys(a.transactionsPool).length>=n){let c=Object.values(a.transactionsPool).sort((x,y)=>x.localTimestamp-y.localTimestamp);if(c.length>0){let x=c[0];delete a.transactionsPool[x.txKey];}}a.transactionsPool[t.txKey]=r;}})),e&&t.txKey&&T(t.txKey,"[Pulsar] onRemoteCreate failed, transaction queued for background sync:"),Promise.resolve()},updateTxParams:(t,r)=>{d(a=>immer.produce(a,i=>{let c=i.transactionsPool[t];c&&Object.assign(c,r);})),(r.status==="Success"||r.status==="Failed"||r.status==="Replaced")&&p().reconcileUnsyncedTransactions&&p().unsyncedTxKeys?.[t]&&p().reconcileUnsyncedTransactions().catch(a=>{console.error("[Pulsar] Terminal reconciliation failed:",a);});},removeTxFromPool:t=>{d(r=>immer.produce(r,s=>{delete s.transactionsPool[t];}));},closeTxTrackedModal:t=>{d(r=>immer.produce(r,s=>{if(t&&s.transactionsPool[t]){let a=s.transactionsPool[t];s.transactionsPool[t]={...a,isTrackedModalOpen:false};}s.initialTx=void 0;}));},getLastTxKey:()=>p().lastAddedTxKey}}}var D=n=>Object.values(n).sort((e,o)=>Number(e.localTimestamp)-Number(o.localTimestamp)),ke=n=>D(n).filter(e=>e.pending),ve=(n,e)=>n[e],re=(n,e)=>D(n).filter(o=>o.from.toLowerCase()===e.toLowerCase()),Ie=(n,e)=>re(n,e).filter(o=>o.pending);var{produce:q}=new immer.Immer({autoFreeze:false}),ae=n=>n.filter(e=>{try{return S(e),!0}catch(o){return console.warn("[Pulsar] Skipped invalid transaction from history:",o),false}}),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 l=typeof e.confirmations=="number"?e.confirmations:0,d=typeof o.confirmations=="number"?o.confirmations:0;return l>d?(n[e.txKey]={...o,...e},true):false}}return n[e.txKey]=e,true};function Me({localTransactionsPool:n,reconcileUnsyncedTransactions:e,getHistory:o,onHistoryFetched:l}){let d=T=>({isLoading:T,isError:false}),p=T=>{if(!T)return {isLoading:false};let t=ae(T.docs);return l&&queueMicrotask(()=>l(t)),r=>q(r,s=>{let a=s.transactionsPool;for(let i of t)H(a,i);s.currentPage=T.page,s.hasMore=T.hasNextPage,s.isLoading=false;})};return vanilla.createStore()((T,t)=>({transactionsPool:n,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{T(s=>q(s,a=>{let i=a.transactionsPool;for(let c of Object.values(r))H(i,c);}));},fetchInitial:async r=>{if(!(!o||!r)){T(d(true)),e&&await e();try{let s=await o({page:1,walletAddress:r});T(p(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:a,currentPage:i}=t();if(!(!o||!s||a||!r)){T(d(true));try{let c=i+1,x=await o({page:c,walletAddress:r});T(p(x));}catch(c){console.error(`[Pulsar] Failed to fetch transaction history page ${i+1}:`,c),T({isLoading:false,isError:true});}}}}))}function Ye({adapter:n,maxTransactions:e=50,onRemoteCreate:o,gelatoApiKey:l,beforeTxProcess:d,abortOnTxError:p,...T}){return vanilla.createStore()(middleware.persist((t,r)=>({...G({maxTransactions:e,onRemoteCreate:o})(t,r),getAdapter:()=>n,initializeTransactionsPool:async()=>{let a=Object.values(r().transactionsPool).filter(i=>i.pending).filter(i=>{try{return S(i),!0}catch(c){return console.warn("[Pulsar] Removed invalid persisted transaction:",c),r().removeTxFromPool(i.txKey),false}});await Promise.all(a.map(i=>orbitCore.selectAdapterByKey({adapterKey:i.adapter,adapter:n})?.checkAndInitializeTrackerInStore({tx:i,gelatoApiKey:l,...r()})));},injectExternalPendingTxs:async s=>{let i=r().getAdapter(),c=[],x=s.filter(y=>{try{return S(y),!0}catch(m){return console.warn("[Pulsar] Skipped invalid remote transaction:",m),false}});t(y=>immer.produce(y,m=>{let b=m.transactionsPool;x.forEach(u=>{let g=b[u.txKey];u.pending&&!g&&(b[u.txKey]=u,c.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));});})),c.length>0&&await Promise.all(c.map(y=>orbitCore.selectAdapterByKey({adapterKey:y.adapter,adapter:i})?.checkAndInitializeTrackerInStore({tx:y,gelatoApiKey:l,...r()})));},executeTxAction:async({defaultTracker:s,actionFunction:a,params:i,beforeTxProcess:c,abortOnTxError:x,...y})=>{let m=x??p??true,b=ce__default.default().unix();r().reconcileUnsyncedTransactions().catch(f=>console.error("[Pulsar] Reconciliation failed:",f)),$(i);let{desiredChainID:u,tracker:g,...I}=i,{onSuccess:W,onError:J,onReplaced:Y}=y;t({initialTx:{...i,actionFunction:a,localTimestamp:b,isInitializing:true}});let k=orbitCore.selectAdapterByKey({adapterKey:I.adapter,adapter:n}),z=f=>{t(E=>immer.produce(E,h=>{h.initialTx&&(h.initialTx.isInitializing=false,h.initialTx.error=orbitCore.normalizeError(f));}));};if(!k){let f=new Error("No adapter found for this transaction.");throw z(f),f}try{let{connectorType:f,walletAddress:E}=k.getConnectorInfo();await k.checkChainForTx(u);try{await(c??d)?.();}catch(v){if(m)throw t({initialTx:{...i,actionFunction:a,localTimestamp:b,isInitializing:!1,error:orbitCore.normalizeError(v)}}),v;console.warn("[Pulsar] beforeTxProcess failed:",v);}let h=await a();if(!h){t({initialTx:void 0});return}let{tracker:M,txKey:R}=k.checkTransactionsTracker({actionTxKey:h,connectorType:f,tracker:g,gelatoApiKey:i.gelatoApiKey??l,bundlerUrl:i.bundlerUrl,pimlicoApiKey:i.pimlicoApiKey}),Q={...I,connectorType:f,from:E,tracker:M||s,chainId:orbitCore.setChainId(u),localTimestamp:b,txKey:R,bundlerUrl:i.bundlerUrl,pimlicoApiKey:i.pimlicoApiKey,hash:M==="ethereum"?h:void 0,pending:!1,isTrackedModalOpen:i.withTrackedModal};await r().addTxToPool(Q),t(v=>immer.produce(v,F=>{F.initialTx&&(F.initialTx.isInitializing=!1,F.initialTx.lastTxKey=R);}));let Z=r().transactionsPool[R];await k.checkAndInitializeTrackerInStore({tx:Z,onSuccess:W,onError:J,onReplaced:Y,gelatoApiKey:l,...r()});}catch(f){throw z(f),f}}}),{partialize:t=>{let r={...t};return delete r.initialTx,r},merge:(t,r)=>({...r,...t,initialTx:r.initialTx}),...T}))}var nn=(n=>e=>zustand.useStore(n,e));function rn({tx:n,transactionsPool:e,updateTxParams:o}){let l=e[n.txKey];return d=>(o(n.txKey,d),l&&(l={...l,...d}),l)}var pe=5e3,ue=10;function an(n){let{tx:e,fetcher:o,onInitialize:l,onSuccess:d,onFailure:p,onIntervalTick:T,onReplaced:t,removeTxFromPool:r,pollingInterval:s=pe,maxRetries:a=ue}=n;if(!e.pending)return;l?.();let i=a,c=true,x=m=>{c&&(c=false,r&&!m?.withoutRemoving&&r(e.txKey));};(async()=>{for(;c&&i>0;)try{if(await new Promise(m=>setTimeout(m,s)),!c)break;await o({tx:e,stopPolling:x,onSuccess:d,onFailure:p,onIntervalTick:T,onReplaced:t}),i=a;}catch(m){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,m),i--;}i<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),p(),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=nn;exports.createPulsarStore=Ye;exports.createTxInMemoryStore=Me;exports.createTxUpdater=rn;exports.initializePollingTracker=an;exports.initializeTxTrackingStore=G;exports.selectAllTransactions=D;exports.selectAllTransactionsByActiveWallet=re;exports.selectPendingTransactions=ke;exports.selectPendingTransactionsByActiveWallet=Ie;exports.selectTxByKey=ve;exports.validateInitialTransactionParams=$;exports.validateTransaction=S;

package/dist/index.mjs

@@ -1 +1 @@
-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};
+import {Immer,produce}from'immer';import {createStore}from'zustand/vanilla';import {selectAdapterByKey,normalizeError,setChainId}from'@tuwaio/orbit-core';import ce from'dayjs';import {persist}from'zustand/middleware';import {useStore}from'zustand';var ee=(p=>(p.Ethereum="ethereum",p.Safe="safe",p.Gelato="gelato",p.Solana="solana",p.ERC4337="erc4337",p))(ee||{}),K=(l=>(l.Failed="Failed",l.Success="Success",l.Replaced="Replaced",l))(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 S(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,p)=>{let T=Array.isArray(e)?`${n}[${p}]`: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.`);O(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"){O(e,n);return}n===null||typeof n!="object"||Object.entries(n).forEach(([o,l])=>{let d=`${e}.${o}`;O(d,o),_(l,d);});}function O(n,e){if(ne.some(o=>o.test(e)))throw new P(n,`${n} contains a blocked executable-like pattern.`)}function te(n){let e={...n};return delete e.pimlicoApiKey,delete e.gelatoApiKey,e}function G({maxTransactions:n,onRemoteCreate:e}){let o=false,l=new Set;return (d,p)=>{let T=async(t,r)=>{let s=p().transactionsPool[t];if(!(!e||!s||l.has(t))){l.add(t);try{await e(te(s)),d(a=>produce(a,i=>{let c=i.transactionsPool[t];c&&(c.syncStatus="synced"),i.unsyncedTxKeys&&delete i.unsyncedTxKeys[t];}));}catch(a){console.warn(r,a);}finally{l.delete(t);}}};return {transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,unsyncedTxKeys:{},reconcileUnsyncedTransactions:async()=>{if(!e||o)return;let t=Object.keys(p().unsyncedTxKeys||{});if(t.length!==0){o=true;try{for(let r of t){if(!p().transactionsPool[r]){d(s=>produce(s,a=>{a.unsyncedTxKeys&&delete a.unsyncedTxKeys[r];}));continue}await T(r,`[Pulsar] Failed to reconcile tx ${r}:`);}}finally{o=false;}}},addTxToPool:t=>{S(t);let r={...t,pending:true,...e&&{syncStatus:"pending-sync"}};return d(s=>produce(s,a=>{if(a.lastAddedTxKey=t.txKey,t.txKey){if(e&&(a.unsyncedTxKeys||(a.unsyncedTxKeys={}),a.unsyncedTxKeys[t.txKey]=true),Object.keys(a.transactionsPool).length>=n){let c=Object.values(a.transactionsPool).sort((x,y)=>x.localTimestamp-y.localTimestamp);if(c.length>0){let x=c[0];delete a.transactionsPool[x.txKey];}}a.transactionsPool[t.txKey]=r;}})),e&&t.txKey&&T(t.txKey,"[Pulsar] onRemoteCreate failed, transaction queued for background sync:"),Promise.resolve()},updateTxParams:(t,r)=>{d(a=>produce(a,i=>{let c=i.transactionsPool[t];c&&Object.assign(c,r);})),(r.status==="Success"||r.status==="Failed"||r.status==="Replaced")&&p().reconcileUnsyncedTransactions&&p().unsyncedTxKeys?.[t]&&p().reconcileUnsyncedTransactions().catch(a=>{console.error("[Pulsar] Terminal reconciliation failed:",a);});},removeTxFromPool:t=>{d(r=>produce(r,s=>{delete s.transactionsPool[t];}));},closeTxTrackedModal:t=>{d(r=>produce(r,s=>{if(t&&s.transactionsPool[t]){let a=s.transactionsPool[t];s.transactionsPool[t]={...a,isTrackedModalOpen:false};}s.initialTx=void 0;}));},getLastTxKey:()=>p().lastAddedTxKey}}}var D=n=>Object.values(n).sort((e,o)=>Number(e.localTimestamp)-Number(o.localTimestamp)),ke=n=>D(n).filter(e=>e.pending),ve=(n,e)=>n[e],re=(n,e)=>D(n).filter(o=>o.from.toLowerCase()===e.toLowerCase()),Ie=(n,e)=>re(n,e).filter(o=>o.pending);var{produce:q}=new Immer({autoFreeze:false}),ae=n=>n.filter(e=>{try{return S(e),!0}catch(o){return console.warn("[Pulsar] Skipped invalid transaction from history:",o),false}}),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 l=typeof e.confirmations=="number"?e.confirmations:0,d=typeof o.confirmations=="number"?o.confirmations:0;return l>d?(n[e.txKey]={...o,...e},true):false}}return n[e.txKey]=e,true};function Me({localTransactionsPool:n,reconcileUnsyncedTransactions:e,getHistory:o,onHistoryFetched:l}){let d=T=>({isLoading:T,isError:false}),p=T=>{if(!T)return {isLoading:false};let t=ae(T.docs);return l&&queueMicrotask(()=>l(t)),r=>q(r,s=>{let a=s.transactionsPool;for(let i of t)H(a,i);s.currentPage=T.page,s.hasMore=T.hasNextPage,s.isLoading=false;})};return createStore()((T,t)=>({transactionsPool:n,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{T(s=>q(s,a=>{let i=a.transactionsPool;for(let c of Object.values(r))H(i,c);}));},fetchInitial:async r=>{if(!(!o||!r)){T(d(true)),e&&await e();try{let s=await o({page:1,walletAddress:r});T(p(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:a,currentPage:i}=t();if(!(!o||!s||a||!r)){T(d(true));try{let c=i+1,x=await o({page:c,walletAddress:r});T(p(x));}catch(c){console.error(`[Pulsar] Failed to fetch transaction history page ${i+1}:`,c),T({isLoading:false,isError:true});}}}}))}function Ye({adapter:n,maxTransactions:e=50,onRemoteCreate:o,gelatoApiKey:l,beforeTxProcess:d,abortOnTxError:p,...T}){return createStore()(persist((t,r)=>({...G({maxTransactions:e,onRemoteCreate:o})(t,r),getAdapter:()=>n,initializeTransactionsPool:async()=>{let a=Object.values(r().transactionsPool).filter(i=>i.pending).filter(i=>{try{return S(i),!0}catch(c){return console.warn("[Pulsar] Removed invalid persisted transaction:",c),r().removeTxFromPool(i.txKey),false}});await Promise.all(a.map(i=>selectAdapterByKey({adapterKey:i.adapter,adapter:n})?.checkAndInitializeTrackerInStore({tx:i,gelatoApiKey:l,...r()})));},injectExternalPendingTxs:async s=>{let i=r().getAdapter(),c=[],x=s.filter(y=>{try{return S(y),!0}catch(m){return console.warn("[Pulsar] Skipped invalid remote transaction:",m),false}});t(y=>produce(y,m=>{let b=m.transactionsPool;x.forEach(u=>{let g=b[u.txKey];u.pending&&!g&&(b[u.txKey]=u,c.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));});})),c.length>0&&await Promise.all(c.map(y=>selectAdapterByKey({adapterKey:y.adapter,adapter:i})?.checkAndInitializeTrackerInStore({tx:y,gelatoApiKey:l,...r()})));},executeTxAction:async({defaultTracker:s,actionFunction:a,params:i,beforeTxProcess:c,abortOnTxError:x,...y})=>{let m=x??p??true,b=ce().unix();r().reconcileUnsyncedTransactions().catch(f=>console.error("[Pulsar] Reconciliation failed:",f)),$(i);let{desiredChainID:u,tracker:g,...I}=i,{onSuccess:W,onError:J,onReplaced:Y}=y;t({initialTx:{...i,actionFunction:a,localTimestamp:b,isInitializing:true}});let k=selectAdapterByKey({adapterKey:I.adapter,adapter:n}),z=f=>{t(E=>produce(E,h=>{h.initialTx&&(h.initialTx.isInitializing=false,h.initialTx.error=normalizeError(f));}));};if(!k){let f=new Error("No adapter found for this transaction.");throw z(f),f}try{let{connectorType:f,walletAddress:E}=k.getConnectorInfo();await k.checkChainForTx(u);try{await(c??d)?.();}catch(v){if(m)throw t({initialTx:{...i,actionFunction:a,localTimestamp:b,isInitializing:!1,error:normalizeError(v)}}),v;console.warn("[Pulsar] beforeTxProcess failed:",v);}let h=await a();if(!h){t({initialTx:void 0});return}let{tracker:M,txKey:R}=k.checkTransactionsTracker({actionTxKey:h,connectorType:f,tracker:g,gelatoApiKey:i.gelatoApiKey??l,bundlerUrl:i.bundlerUrl,pimlicoApiKey:i.pimlicoApiKey}),Q={...I,connectorType:f,from:E,tracker:M||s,chainId:setChainId(u),localTimestamp:b,txKey:R,bundlerUrl:i.bundlerUrl,pimlicoApiKey:i.pimlicoApiKey,hash:M==="ethereum"?h:void 0,pending:!1,isTrackedModalOpen:i.withTrackedModal};await r().addTxToPool(Q),t(v=>produce(v,F=>{F.initialTx&&(F.initialTx.isInitializing=!1,F.initialTx.lastTxKey=R);}));let Z=r().transactionsPool[R];await k.checkAndInitializeTrackerInStore({tx:Z,onSuccess:W,onError:J,onReplaced:Y,gelatoApiKey:l,...r()});}catch(f){throw z(f),f}}}),{partialize:t=>{let r={...t};return delete r.initialTx,r},merge:(t,r)=>({...r,...t,initialTx:r.initialTx}),...T}))}var nn=(n=>e=>useStore(n,e));function rn({tx:n,transactionsPool:e,updateTxParams:o}){let l=e[n.txKey];return d=>(o(n.txKey,d),l&&(l={...l,...d}),l)}var pe=5e3,ue=10;function an(n){let{tx:e,fetcher:o,onInitialize:l,onSuccess:d,onFailure:p,onIntervalTick:T,onReplaced:t,removeTxFromPool:r,pollingInterval:s=pe,maxRetries:a=ue}=n;if(!e.pending)return;l?.();let i=a,c=true,x=m=>{c&&(c=false,r&&!m?.withoutRemoving&&r(e.txKey));};(async()=>{for(;c&&i>0;)try{if(await new Promise(m=>setTimeout(m,s)),!c)break;await o({tx:e,stopPolling:x,onSuccess:d,onFailure:p,onIntervalTick:T,onReplaced:t}),i=a;}catch(m){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,m),i--;}i<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),p(),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,nn as createBoundedUseStore,Ye as createPulsarStore,Me as createTxInMemoryStore,rn as createTxUpdater,an as initializePollingTracker,G as initializeTxTrackingStore,D as selectAllTransactions,re as selectAllTransactionsByActiveWallet,ke as selectPendingTransactions,Ie as selectPendingTransactionsByActiveWallet,ve as selectTxByKey,$ as validateInitialTransactionParams,S as validateTransaction};

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tuwaio/pulsar-core",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
-  "description": "Layer 3 (L3) of the TUWA Ecosystem. Framework-agnostic headless core store providing append-only localStorage transaction history ledgers.",
+  "description": "L3 core of Pulsar (TUWA): headless, framework-agnostic transaction store with localStorage persistence, a chain adapter contract, metadata validation and remote sync hooks for tracking EVM and Solana transactions.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -16,13 +16,17 @@
     "socket.json"
   ],
   "keywords": [
+    "tuwa",
+    "pulsar",
+    "transaction-tracking",
     "web3",
-    "transaction",
-    "tracking",
+    "multi-chain",
+    "evm",
+    "solana",
     "zustand",
     "immer",
     "typescript",
-    "core",
+    "framework-agnostic",
     "headless"
   ],
   "repository": {
@@ -47,12 +51,12 @@
     "zustand": "5.x.x"
   },
   "devDependencies": {
-    "@tuwaio/orbit-core": "^0.3.0",
+    "@tuwaio/orbit-core": "^0.3.1",
     "dayjs": "^1.11.23",
     "immer": "^11.1.18",
     "tsup": "^8.5.1",
     "typescript": "6.0.3",
-    "vitest": "^5.0.0",
+    "vitest": "^5.0.2",
     "zustand": "^5.0.15"
   },
   "scripts": {