@tuwaio/pulsar-core 0.5.1 → 0.6.0

package/dist/index.d.mts

@@ -74,8 +74,8 @@ type BaseTransaction = {
     isTrackedModalOpen?: boolean;
     /** The local timestamp (in seconds) when the transaction was initiated by the user. */
     localTimestamp: number;
-    /** Any additional, custom data associated with the transaction. */
-    payload?: object;
+    /** Custom data (strings or numbers) to associate with the transaction. */
+    payload?: Record<string, string | number>;
     /** A flag indicating if the transaction is still awaiting on-chain confirmation. */
     pending: boolean;
     /** The final on-chain status of the transaction. */
@@ -97,6 +97,12 @@ type BaseTransaction = {
     type: string;
     /** The type of connector used to sign the transaction (e.g., 'injected', 'walletConnect'). */
     connectorType: string;
+    /** The number of confirmations required for the transaction to be considered confirmed. */
+    requiredConfirmations?: number;
+    /** The number of confirmations received. A string value indicates a confirmed transaction, while `null` means it's pending. */
+    confirmations?: number | string | null;
+    /** The RPC URL to use for the transaction. Required for Solana transactions. */
+    rpcUrl?: string;
 };
 /**
  * Represents an EVM-specific transaction, extending the base properties with EVM fields.
@@ -135,10 +141,6 @@ type SolanaTransaction = BaseTransaction & {
     recentBlockhash?: string;
     /** The slot in which the transaction was processed. */
     slot?: number;
-    /** The number of confirmations received. A string value indicates a confirmed transaction, while `null` means it's pending. */
-    confirmations?: number | string | null;
-    /** The RPC URL used to submit and track this transaction. */
-    rpcUrl?: string;
 };
 /**
  * Represents a Starknet-specific transaction, extending the base properties.
@@ -159,26 +161,16 @@ type Transaction = EvmTransaction | SolanaTransaction | StarknetTransaction;
 /**
  * Represents the parameters required to initiate a new transaction tracking flow.
  */
-type InitialTransactionParams = {
+type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' | 'type' | 'requiredConfirmations' | 'rpcUrl' | 'payload'> & {
     /** 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. */
     actionFunction: (...args: any[]) => Promise<ActionTxKey | undefined>;
-    /** A user-facing description for the transaction. Supports state-specific descriptions. */
-    description?: string | [string, string, string, string];
     /** The target chain ID for the transaction. */
     desiredChainID: number | string;
-    /** Any custom data to associate with the transaction. */
-    payload?: object;
-    /** A user-facing title for the transaction. Supports state-specific titles. */
-    title?: string | [string, string, string, string];
-    /** The application-specific type of the transaction. */
-    type: string;
     /** If true, the detailed tracking modal will open automatically upon initiation. */
     withTrackedModal?: boolean;
-    /** The RPC URL to use for the transaction. Required for Solana transactions. */
-    rpcUrl?: string;
-    /** The transaction tracker. Required for Gelato transactions. */
+    /** The specific tracker responsible for monitoring this transaction's status. Required for Gelato tracker. */
     tracker?: TransactionTracker;
 };
 /**
@@ -318,7 +310,7 @@ type TransactionPool<T extends Transaction> = Record<string, T>;
  * on a transaction object via the `updateTxParams` action. This ensures type safety
  * and prevents accidental modification of immutable properties.
  */
-type UpdatableTransactionFields = Partial<Pick<EvmTransaction, 'to' | 'nonce' | 'txKey' | 'pending' | 'hash' | 'status' | 'replacedTxHash' | 'error' | 'finishedTimestamp' | 'isTrackedModalOpen' | 'isError' | 'maxPriorityFeePerGas' | 'maxFeePerGas' | 'input' | 'value'>> & Partial<Pick<SolanaTransaction, 'slot' | 'confirmations' | 'fee' | 'instructions' | 'recentBlockhash' | 'rpcUrl'>>;
+type UpdatableTransactionFields = Partial<Pick<EvmTransaction, 'to' | 'nonce' | 'txKey' | 'pending' | 'hash' | 'status' | 'replacedTxHash' | 'error' | 'finishedTimestamp' | 'isTrackedModalOpen' | 'isError' | 'maxPriorityFeePerGas' | 'maxFeePerGas' | 'input' | 'value' | 'confirmations' | 'requiredConfirmations'>> & Partial<Pick<SolanaTransaction, 'slot' | 'confirmations' | 'fee' | 'instructions' | 'recentBlockhash' | 'rpcUrl'>>;
 /**
  * The interface for the base transaction tracking store slice.
  * It includes the state and actions for managing the transaction lifecycle.
@@ -387,6 +379,77 @@ type ITxTrackingStore<T extends Transaction> = IInitializeTxTrackingStore<T> & {
      * This is essential for resuming tracking after a page reload or application restart.
      */
     initializeTransactionsPool: () => Promise<void>;
+    /**
+     * Cross-device synchronization bridge.
+     * Injects remote pending transactions into the local pool and starts their lifecycle trackers.
+     * Also self-heals local pending transactions if the remote DB knows they are terminal.
+     */
+    injectExternalPendingTxs: (remoteTxs: T[]) => Promise<void>;
+};
+/**
+ * Represents the structure and behavior of an in-memory pagination system
+ * for managing transaction history.
+ */
+type TxInMemoryPagination = {
+    /** Indicates whether the store is currently loading transaction history. */
+    isLoading: boolean;
+    /** Indicates whether the last loading request ended with an error. */
+    isError: boolean;
+    /** Indicates whether more history pages are available. */
+    hasMore: boolean;
+    /** The current page number in the paginated history. */
+    currentPage: number;
+    /** Loads the next page of transaction history and appends it to the pool. */
+    fetchNextPage: (walletAddress: string) => Promise<void>;
+};
+/**
+ * The complete interface for the Pulsar transaction in-memory store.
+ * It keeps a paginated remote history in sync with a local transaction pool.
+ *
+ * @template T The transaction type.
+ */
+type ITxInMemoryStore<T extends Transaction> = {
+    /** A pool of all transactions currently being tracked and loaded from history, indexed by `txKey`. */
+    transactionsPool: TransactionPool<T>;
+    /** Loads the first page of transaction history. */
+    fetchInitial: (walletAddress: string) => Promise<void>;
+    /** Merges a local transaction pool into the in-memory store. */
+    syncWithLocalPool: (localPool: TransactionPool<T>) => void;
+} & TxInMemoryPagination;
+/**
+ * Parameters used to configure and manage an in-memory transaction store.
+ *
+ * @template T The transaction type.
+ */
+type ITxInMemoryStoreParameters<T extends Transaction> = {
+    /** A localTransactionsPool. */
+    localTransactionsPool: TransactionPool<T>;
+    /** * Callback fired when remote history is successfully fetched.
+     * Used to inject remote pending transactions into the persistent tracking store.
+     */
+    onHistoryFetched?: (remoteTxs: T[]) => void;
+    getHistory?: ({ page, walletAddress, }: {
+        /**
+         * Page number for pagination.
+         *
+         * @defaultValue `1`
+         */
+        page?: number;
+        walletAddress: string;
+    }) => Promise<{
+        /** Array of transactions for the current page. */
+        docs: T[];
+        /** Total number of transactions matching the query. */
+        totalDocs: number;
+        /** Total number of available pages. */
+        totalPages: number;
+        /** Current page number. */
+        page: number;
+        /** Indicates whether a next page exists. */
+        hasNextPage: boolean;
+        /** Indicates whether a previous page exists. */
+        hasPrevPage: boolean;
+    } | null>;
 };
 
 /**
@@ -450,6 +513,22 @@ declare const selectAllTransactionsByActiveWallet: <T extends Transaction>(trans
  */
 declare const selectPendingTransactionsByActiveWallet: <T extends Transaction>(transactionsPool: TransactionPool<T>, from: string) => T[];
 
+/**
+ * Creates an in-memory transaction store with synchronized local and remote sources.
+ *
+ * The store is designed to:
+ * - keep a local transaction pool in sync with remote history
+ * - preserve terminal transaction states
+ * - support paginated history loading
+ * - avoid duplicated merge logic across store actions
+ *
+ * @template T The transaction type.
+ * @param params Store configuration parameters.
+ * @param params.getHistory Optional remote history fetcher.
+ * @returns A Zustand vanilla store instance for in-memory transaction management.
+ */
+declare function createTxInMemoryStore<T extends Transaction>({ localTransactionsPool, getHistory, onHistoryFetched, }: ITxInMemoryStoreParameters<T>): zustand.StoreApi<ITxInMemoryStore<T>>;
+
 /**
  * Creates the main Pulsar store for transaction tracking.
  *
@@ -582,4 +661,4 @@ type PollingTrackerConfig<R, T extends Transaction> = {
  */
 declare function initializePollingTracker<R, T extends Transaction>(config: PollingTrackerConfig<R, T>): void;
 
-export { type ActionTxKey, type BaseTransaction, type CheckTxTracker, type EvmTransaction, type IInitializeTxTrackingStore, type ITxTrackingStore, type InitialTransaction, type InitialTransactionParams, type PollingFetcherParams, type PollingTrackerConfig, type PulsarAdapter, type SolanaTransaction, type StarknetTransaction, type StoreSlice, type SyncCallbacks, type TrackerCallbacks, type Transaction, type TransactionPool, TransactionStatus, TransactionTracker, type TxAdapter, type UpdatableTransactionFields, createBoundedUseStore, createPulsarStore, initializePollingTracker, initializeTxTrackingStore, selectAllTransactions, selectAllTransactionsByActiveWallet, selectPendingTransactions, selectPendingTransactionsByActiveWallet, selectTxByKey };
+export { type ActionTxKey, type BaseTransaction, type CheckTxTracker, type EvmTransaction, type IInitializeTxTrackingStore, type ITxInMemoryStore, type ITxInMemoryStoreParameters, type ITxTrackingStore, type InitialTransaction, type InitialTransactionParams, type PollingFetcherParams, type PollingTrackerConfig, type PulsarAdapter, type SolanaTransaction, type StarknetTransaction, type StoreSlice, type SyncCallbacks, type TrackerCallbacks, type Transaction, type TransactionPool, TransactionStatus, TransactionTracker, type TxAdapter, type TxInMemoryPagination, type UpdatableTransactionFields, createBoundedUseStore, createPulsarStore, createTxInMemoryStore, initializePollingTracker, initializeTxTrackingStore, selectAllTransactions, selectAllTransactionsByActiveWallet, selectPendingTransactions, selectPendingTransactionsByActiveWallet, selectTxByKey };

package/dist/index.d.ts

@@ -74,8 +74,8 @@ type BaseTransaction = {
     isTrackedModalOpen?: boolean;
     /** The local timestamp (in seconds) when the transaction was initiated by the user. */
     localTimestamp: number;
-    /** Any additional, custom data associated with the transaction. */
-    payload?: object;
+    /** Custom data (strings or numbers) to associate with the transaction. */
+    payload?: Record<string, string | number>;
     /** A flag indicating if the transaction is still awaiting on-chain confirmation. */
     pending: boolean;
     /** The final on-chain status of the transaction. */
@@ -97,6 +97,12 @@ type BaseTransaction = {
     type: string;
     /** The type of connector used to sign the transaction (e.g., 'injected', 'walletConnect'). */
     connectorType: string;
+    /** The number of confirmations required for the transaction to be considered confirmed. */
+    requiredConfirmations?: number;
+    /** The number of confirmations received. A string value indicates a confirmed transaction, while `null` means it's pending. */
+    confirmations?: number | string | null;
+    /** The RPC URL to use for the transaction. Required for Solana transactions. */
+    rpcUrl?: string;
 };
 /**
  * Represents an EVM-specific transaction, extending the base properties with EVM fields.
@@ -135,10 +141,6 @@ type SolanaTransaction = BaseTransaction & {
     recentBlockhash?: string;
     /** The slot in which the transaction was processed. */
     slot?: number;
-    /** The number of confirmations received. A string value indicates a confirmed transaction, while `null` means it's pending. */
-    confirmations?: number | string | null;
-    /** The RPC URL used to submit and track this transaction. */
-    rpcUrl?: string;
 };
 /**
  * Represents a Starknet-specific transaction, extending the base properties.
@@ -159,26 +161,16 @@ type Transaction = EvmTransaction | SolanaTransaction | StarknetTransaction;
 /**
  * Represents the parameters required to initiate a new transaction tracking flow.
  */
-type InitialTransactionParams = {
+type InitialTransactionParams = Pick<BaseTransaction, 'description' | 'title' | 'type' | 'requiredConfirmations' | 'rpcUrl' | 'payload'> & {
     /** 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. */
     actionFunction: (...args: any[]) => Promise<ActionTxKey | undefined>;
-    /** A user-facing description for the transaction. Supports state-specific descriptions. */
-    description?: string | [string, string, string, string];
     /** The target chain ID for the transaction. */
     desiredChainID: number | string;
-    /** Any custom data to associate with the transaction. */
-    payload?: object;
-    /** A user-facing title for the transaction. Supports state-specific titles. */
-    title?: string | [string, string, string, string];
-    /** The application-specific type of the transaction. */
-    type: string;
     /** If true, the detailed tracking modal will open automatically upon initiation. */
     withTrackedModal?: boolean;
-    /** The RPC URL to use for the transaction. Required for Solana transactions. */
-    rpcUrl?: string;
-    /** The transaction tracker. Required for Gelato transactions. */
+    /** The specific tracker responsible for monitoring this transaction's status. Required for Gelato tracker. */
     tracker?: TransactionTracker;
 };
 /**
@@ -318,7 +310,7 @@ type TransactionPool<T extends Transaction> = Record<string, T>;
  * on a transaction object via the `updateTxParams` action. This ensures type safety
  * and prevents accidental modification of immutable properties.
  */
-type UpdatableTransactionFields = Partial<Pick<EvmTransaction, 'to' | 'nonce' | 'txKey' | 'pending' | 'hash' | 'status' | 'replacedTxHash' | 'error' | 'finishedTimestamp' | 'isTrackedModalOpen' | 'isError' | 'maxPriorityFeePerGas' | 'maxFeePerGas' | 'input' | 'value'>> & Partial<Pick<SolanaTransaction, 'slot' | 'confirmations' | 'fee' | 'instructions' | 'recentBlockhash' | 'rpcUrl'>>;
+type UpdatableTransactionFields = Partial<Pick<EvmTransaction, 'to' | 'nonce' | 'txKey' | 'pending' | 'hash' | 'status' | 'replacedTxHash' | 'error' | 'finishedTimestamp' | 'isTrackedModalOpen' | 'isError' | 'maxPriorityFeePerGas' | 'maxFeePerGas' | 'input' | 'value' | 'confirmations' | 'requiredConfirmations'>> & Partial<Pick<SolanaTransaction, 'slot' | 'confirmations' | 'fee' | 'instructions' | 'recentBlockhash' | 'rpcUrl'>>;
 /**
  * The interface for the base transaction tracking store slice.
  * It includes the state and actions for managing the transaction lifecycle.
@@ -387,6 +379,77 @@ type ITxTrackingStore<T extends Transaction> = IInitializeTxTrackingStore<T> & {
      * This is essential for resuming tracking after a page reload or application restart.
      */
     initializeTransactionsPool: () => Promise<void>;
+    /**
+     * Cross-device synchronization bridge.
+     * Injects remote pending transactions into the local pool and starts their lifecycle trackers.
+     * Also self-heals local pending transactions if the remote DB knows they are terminal.
+     */
+    injectExternalPendingTxs: (remoteTxs: T[]) => Promise<void>;
+};
+/**
+ * Represents the structure and behavior of an in-memory pagination system
+ * for managing transaction history.
+ */
+type TxInMemoryPagination = {
+    /** Indicates whether the store is currently loading transaction history. */
+    isLoading: boolean;
+    /** Indicates whether the last loading request ended with an error. */
+    isError: boolean;
+    /** Indicates whether more history pages are available. */
+    hasMore: boolean;
+    /** The current page number in the paginated history. */
+    currentPage: number;
+    /** Loads the next page of transaction history and appends it to the pool. */
+    fetchNextPage: (walletAddress: string) => Promise<void>;
+};
+/**
+ * The complete interface for the Pulsar transaction in-memory store.
+ * It keeps a paginated remote history in sync with a local transaction pool.
+ *
+ * @template T The transaction type.
+ */
+type ITxInMemoryStore<T extends Transaction> = {
+    /** A pool of all transactions currently being tracked and loaded from history, indexed by `txKey`. */
+    transactionsPool: TransactionPool<T>;
+    /** Loads the first page of transaction history. */
+    fetchInitial: (walletAddress: string) => Promise<void>;
+    /** Merges a local transaction pool into the in-memory store. */
+    syncWithLocalPool: (localPool: TransactionPool<T>) => void;
+} & TxInMemoryPagination;
+/**
+ * Parameters used to configure and manage an in-memory transaction store.
+ *
+ * @template T The transaction type.
+ */
+type ITxInMemoryStoreParameters<T extends Transaction> = {
+    /** A localTransactionsPool. */
+    localTransactionsPool: TransactionPool<T>;
+    /** * Callback fired when remote history is successfully fetched.
+     * Used to inject remote pending transactions into the persistent tracking store.
+     */
+    onHistoryFetched?: (remoteTxs: T[]) => void;
+    getHistory?: ({ page, walletAddress, }: {
+        /**
+         * Page number for pagination.
+         *
+         * @defaultValue `1`
+         */
+        page?: number;
+        walletAddress: string;
+    }) => Promise<{
+        /** Array of transactions for the current page. */
+        docs: T[];
+        /** Total number of transactions matching the query. */
+        totalDocs: number;
+        /** Total number of available pages. */
+        totalPages: number;
+        /** Current page number. */
+        page: number;
+        /** Indicates whether a next page exists. */
+        hasNextPage: boolean;
+        /** Indicates whether a previous page exists. */
+        hasPrevPage: boolean;
+    } | null>;
 };
 
 /**
@@ -450,6 +513,22 @@ declare const selectAllTransactionsByActiveWallet: <T extends Transaction>(trans
  */
 declare const selectPendingTransactionsByActiveWallet: <T extends Transaction>(transactionsPool: TransactionPool<T>, from: string) => T[];
 
+/**
+ * Creates an in-memory transaction store with synchronized local and remote sources.
+ *
+ * The store is designed to:
+ * - keep a local transaction pool in sync with remote history
+ * - preserve terminal transaction states
+ * - support paginated history loading
+ * - avoid duplicated merge logic across store actions
+ *
+ * @template T The transaction type.
+ * @param params Store configuration parameters.
+ * @param params.getHistory Optional remote history fetcher.
+ * @returns A Zustand vanilla store instance for in-memory transaction management.
+ */
+declare function createTxInMemoryStore<T extends Transaction>({ localTransactionsPool, getHistory, onHistoryFetched, }: ITxInMemoryStoreParameters<T>): zustand.StoreApi<ITxInMemoryStore<T>>;
+
 /**
  * Creates the main Pulsar store for transaction tracking.
  *
@@ -582,4 +661,4 @@ type PollingTrackerConfig<R, T extends Transaction> = {
  */
 declare function initializePollingTracker<R, T extends Transaction>(config: PollingTrackerConfig<R, T>): void;
 
-export { type ActionTxKey, type BaseTransaction, type CheckTxTracker, type EvmTransaction, type IInitializeTxTrackingStore, type ITxTrackingStore, type InitialTransaction, type InitialTransactionParams, type PollingFetcherParams, type PollingTrackerConfig, type PulsarAdapter, type SolanaTransaction, type StarknetTransaction, type StoreSlice, type SyncCallbacks, type TrackerCallbacks, type Transaction, type TransactionPool, TransactionStatus, TransactionTracker, type TxAdapter, type UpdatableTransactionFields, createBoundedUseStore, createPulsarStore, initializePollingTracker, initializeTxTrackingStore, selectAllTransactions, selectAllTransactionsByActiveWallet, selectPendingTransactions, selectPendingTransactionsByActiveWallet, selectTxByKey };
+export { type ActionTxKey, type BaseTransaction, type CheckTxTracker, type EvmTransaction, type IInitializeTxTrackingStore, type ITxInMemoryStore, type ITxInMemoryStoreParameters, type ITxTrackingStore, type InitialTransaction, type InitialTransactionParams, type PollingFetcherParams, type PollingTrackerConfig, type PulsarAdapter, type SolanaTransaction, type StarknetTransaction, type StoreSlice, type SyncCallbacks, type TrackerCallbacks, type Transaction, type TransactionPool, TransactionStatus, TransactionTracker, type TxAdapter, type TxInMemoryPagination, type UpdatableTransactionFields, createBoundedUseStore, createPulsarStore, createTxInMemoryStore, initializePollingTracker, initializeTxTrackingStore, selectAllTransactions, selectAllTransactionsByActiveWallet, selectPendingTransactions, selectPendingTransactionsByActiveWallet, selectTxByKey };

package/dist/index.js

@@ -1 +1 @@
-'use strict';var immer=require('immer'),orbitCore=require('@tuwaio/orbit-core'),U=require('dayjs'),middleware=require('zustand/middleware'),vanilla=require('zustand/vanilla'),zustand=require('zustand');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var U__default=/*#__PURE__*/_interopDefault(U);function I({maxTransactions:n,onRemoteCreate:e}){return (a,c)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,addTxToPool:t=>{let o={...t,pending:true};a(r=>immer.produce(r,i=>{if(i.lastAddedTxKey=t.txKey,t.txKey){if(Object.keys(i.transactionsPool).length>=n){let l=Object.values(i.transactionsPool).sort((p,d)=>p.localTimestamp-d.localTimestamp);if(l.length>0){let p=l[0];delete i.transactionsPool[p.txKey];}}i.transactionsPool[t.txKey]=o;}})),e&&e(o).catch(r=>console.error("[Pulsar Sync] Create failed:",r));},updateTxParams:(t,o)=>{a(r=>immer.produce(r,i=>{let s=i.transactionsPool[t];s&&Object.assign(s,o);}));},removeTxFromPool:t=>{a(o=>immer.produce(o,r=>{delete r.transactionsPool[t];}));},closeTxTrackedModal:t=>{a(o=>immer.produce(o,r=>{if(t&&r.transactionsPool[t]){let i=r.transactionsPool[t];r.transactionsPool[t]={...i,isTrackedModalOpen:false};}r.initialTx=void 0;}));},getLastTxKey:()=>c().lastAddedTxKey})}var K=n=>Object.values(n).sort((e,a)=>Number(e.localTimestamp)-Number(a.localTimestamp)),W=n=>K(n).filter(e=>e.pending),X=(n,e)=>n[e],z=(n,e)=>K(n).filter(a=>a.from.toLowerCase()===e.toLowerCase()),q=(n,e)=>z(n,e).filter(a=>a.pending);function oe({adapter:n,maxTransactions:e=50,onRemoteCreate:a,gelatoApiKey:c,...t}){return vanilla.createStore()(middleware.persist((o,r)=>({...I({maxTransactions:e,onRemoteCreate:a})(o,r),getAdapter:()=>n,initializeTransactionsPool:async()=>{let i=Object.values(r().transactionsPool).filter(s=>s.pending);await Promise.all(i.map(s=>orbitCore.selectAdapterByKey({adapterKey:s.adapter,adapter:n})?.checkAndInitializeTrackerInStore({tx:s,gelatoApiKey:c,...r()})));},executeTxAction:async({defaultTracker:i,actionFunction:s,params:l,...p})=>{let{desiredChainID:d,tracker:g,...u}=l,{onSuccess:A,onError:x,onReplaced:F}=p,h=U__default.default().unix();o({initialTx:{...l,actionFunction:s,localTimestamp:h,isInitializing:true}});let P=orbitCore.selectAdapterByKey({adapterKey:u.adapter,adapter:n}),v=T=>{o(f=>immer.produce(f,m=>{m.initialTx&&(m.initialTx.isInitializing=false,m.initialTx.error=orbitCore.normalizeError(T));}));};if(!P){let T=new Error("No adapter found for this transaction.");throw v(T),T}try{let{connectorType:T,walletAddress:f}=P.getConnectorInfo();await P.checkChainForTx(d);let m=await s();if(!m){o({initialTx:void 0});return}let{tracker:b,txKey:k}=P.checkTransactionsTracker({actionTxKey:m,connectorType:T,tracker:g,gelatoApiKey:c}),E={...u,connectorType:T,from:f,tracker:b||i,chainId:orbitCore.setChainId(d),localTimestamp:h,txKey:k,hash:b==="ethereum"?m:void 0,pending:!1,isTrackedModalOpen:l.withTrackedModal};r().addTxToPool(E),o(O=>immer.produce(O,S=>{S.initialTx&&(S.initialTx.isInitializing=!1,S.initialTx.lastTxKey=k);}));let C=r().transactionsPool[k];await P.checkAndInitializeTrackerInStore({tx:C,onSuccess:A,onError:x,onReplaced:F,gelatoApiKey:c,...r()});}catch(T){throw v(T),T}}}),{...t}))}var G=(t=>(t.Ethereum="ethereum",t.Safe="safe",t.Gelato="gelato",t.Solana="solana",t))(G||{}),$=(c=>(c.Failed="Failed",c.Success="Success",c.Replaced="Replaced",c))($||{});var Te=(n=>e=>zustand.useStore(n,e));var D=5e3,_=10;function de(n){let{tx:e,fetcher:a,onInitialize:c,onSuccess:t,onFailure:o,onIntervalTick:r,onReplaced:i,removeTxFromPool:s,pollingInterval:l=D,maxRetries:p=_}=n;if(!e.pending)return;c?.();let d=p,g=true,u=x=>{g&&(g=false,s&&!x?.withoutRemoving&&s(e.txKey));};(async()=>{for(;g&&d>0;)try{if(await new Promise(x=>setTimeout(x,l)),!g)break;await a({tx:e,stopPolling:u,onSuccess:t,onFailure:o,onIntervalTick:r,onReplaced:i});}catch(x){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,x),d--;}d<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),o(),u());})();}exports.TransactionStatus=$;exports.TransactionTracker=G;exports.createBoundedUseStore=Te;exports.createPulsarStore=oe;exports.initializePollingTracker=de;exports.initializeTxTrackingStore=I;exports.selectAllTransactions=K;exports.selectAllTransactionsByActiveWallet=z;exports.selectPendingTransactions=W;exports.selectPendingTransactionsByActiveWallet=q;exports.selectTxByKey=X;
+'use strict';var immer=require('immer'),vanilla=require('zustand/vanilla'),orbitCore=require('@tuwaio/orbit-core'),D=require('dayjs'),middleware=require('zustand/middleware'),zustand=require('zustand');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var D__default=/*#__PURE__*/_interopDefault(D);function E({maxTransactions:o,onRemoteCreate:t}){return (s,p)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,addTxToPool:a=>{let e={...a,pending:true};s(n=>immer.produce(n,r=>{if(r.lastAddedTxKey=a.txKey,a.txKey){if(Object.keys(r.transactionsPool).length>=o){let l=Object.values(r.transactionsPool).sort((T,c)=>T.localTimestamp-c.localTimestamp);if(l.length>0){let T=l[0];delete r.transactionsPool[T.txKey];}}r.transactionsPool[a.txKey]=e;}})),t&&t(e).catch(n=>console.error("[Pulsar Sync] Create failed:",n));},updateTxParams:(a,e)=>{s(n=>immer.produce(n,r=>{let i=r.transactionsPool[a];i&&Object.assign(i,e);}));},removeTxFromPool:a=>{s(e=>immer.produce(e,n=>{delete n.transactionsPool[a];}));},closeTxTrackedModal:a=>{s(e=>immer.produce(e,n=>{if(a&&n.transactionsPool[a]){let r=n.transactionsPool[a];n.transactionsPool[a]={...r,isTrackedModalOpen:false};}n.initialTx=void 0;}));},getLastTxKey:()=>p().lastAddedTxKey})}var F=o=>Object.values(o).sort((t,s)=>Number(t.localTimestamp)-Number(s.localTimestamp)),Y=o=>F(o).filter(t=>t.pending),Z=(o,t)=>o[t],B=(o,t)=>F(o).filter(s=>s.from.toLowerCase()===t.toLowerCase()),ee=(o,t)=>B(o,t).filter(s=>s.pending);var N=(a=>(a.Ethereum="ethereum",a.Safe="safe",a.Gelato="gelato",a.Solana="solana",a))(N||{}),A=(p=>(p.Failed="Failed",p.Success="Success",p.Replaced="Replaced",p))(A||{});var $=o=>o==="Success"||o==="Replaced",M=(o,t)=>{let s=o[t.txKey];return $(s?.status)?false:(o[t.txKey]=t,true)};function Te({localTransactionsPool:o,getHistory:t,onHistoryFetched:s}){immer.setAutoFreeze(false);let p=e=>({isLoading:e,isError:false}),a=e=>e?(s&&queueMicrotask(()=>s(e.docs)),n=>immer.produce(n,r=>{let i=r.transactionsPool;for(let l of e.docs)M(i,l);r.currentPage=e.page,r.hasMore=e.hasNextPage,r.isLoading=false;})):n=>n;return vanilla.createStore()((e,n)=>({transactionsPool:o,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{e(i=>immer.produce(i,l=>{let T=l.transactionsPool;for(let c of Object.values(r))M(T,c);}));},fetchInitial:async r=>{if(!(!t||!r)){e(p(true));try{let i=await t({page:1,walletAddress:r});e(a(i));}catch(i){console.error("[Pulsar] Failed to fetch initial transaction history:",i),e({isLoading:false,isError:true});}}},fetchNextPage:async r=>{let{hasMore:i,isLoading:l,currentPage:T}=n();if(!(!t||!i||l||!r)){e(p(true));try{let c=T+1,m=await t({page:c,walletAddress:r});e(a(m));}catch(c){console.error(`[Pulsar] Failed to fetch transaction history page ${T+1}:`,c),e({isLoading:false,isError:true});}}}}))}function Ae({adapter:o,maxTransactions:t=50,onRemoteCreate:s,gelatoApiKey:p,...a}){return vanilla.createStore()(middleware.persist((e,n)=>({...E({maxTransactions:t,onRemoteCreate:s})(e,n),getAdapter:()=>o,initializeTransactionsPool:async()=>{let r=Object.values(n().transactionsPool).filter(i=>i.pending);await Promise.all(r.map(i=>orbitCore.selectAdapterByKey({adapterKey:i.adapter,adapter:o})?.checkAndInitializeTrackerInStore({tx:i,gelatoApiKey:p,...n()})));},injectExternalPendingTxs:async r=>{let l=n().getAdapter(),T=[];e(c=>immer.produce(c,m=>{let g=m.transactionsPool;r.forEach(d=>{let x=g[d.txKey];d.pending&&!x&&(g[d.txKey]=d,T.push(d));let S=d.status==="Success"||d.status==="Failed"||d.status==="Replaced";x?.pending&&S&&(x.status=d.status,x.pending=false,d.txKey&&(x.txKey=d.txKey),d.finishedTimestamp&&(x.finishedTimestamp=d.finishedTimestamp));});})),T.length>0&&await Promise.all(T.map(c=>orbitCore.selectAdapterByKey({adapterKey:c.adapter,adapter:l})?.checkAndInitializeTrackerInStore({tx:c,gelatoApiKey:p,...n()})));},executeTxAction:async({defaultTracker:r,actionFunction:i,params:l,...T})=>{let{desiredChainID:c,tracker:m,...g}=l,{onSuccess:d,onError:x,onReplaced:S}=T,K=D__default.default().unix();e({initialTx:{...l,actionFunction:i,localTimestamp:K,isInitializing:true}});let f=orbitCore.selectAdapterByKey({adapterKey:g.adapter,adapter:o}),w=u=>{e(k=>immer.produce(k,P=>{P.initialTx&&(P.initialTx.isInitializing=false,P.initialTx.error=orbitCore.normalizeError(u));}));};if(!f){let u=new Error("No adapter found for this transaction.");throw w(u),u}try{let{connectorType:u,walletAddress:k}=f.getConnectorInfo();await f.checkChainForTx(c);let P=await i();if(!P){e({initialTx:void 0});return}let{tracker:R,txKey:h}=f.checkTransactionsTracker({actionTxKey:P,connectorType:u,tracker:m,gelatoApiKey:p}),O={...g,connectorType:u,from:k,tracker:R||r,chainId:orbitCore.setChainId(c),localTimestamp:K,txKey:h,hash:R==="ethereum"?P:void 0,pending:!1,isTrackedModalOpen:l.withTrackedModal};n().addTxToPool(O),e(L=>immer.produce(L,I=>{I.initialTx&&(I.initialTx.isInitializing=!1,I.initialTx.lastTxKey=h);}));let z=n().transactionsPool[h];await f.checkAndInitializeTrackerInStore({tx:z,onSuccess:d,onError:x,onReplaced:S,gelatoApiKey:p,...n()});}catch(u){throw w(u),u}}}),{...a}))}var we=(o=>t=>zustand.useStore(o,t));var V=5e3,X=10;function Ee(o){let{tx:t,fetcher:s,onInitialize:p,onSuccess:a,onFailure:e,onIntervalTick:n,onReplaced:r,removeTxFromPool:i,pollingInterval:l=V,maxRetries:T=X}=o;if(!t.pending)return;p?.();let c=T,m=true,g=x=>{m&&(m=false,i&&!x?.withoutRemoving&&i(t.txKey));};(async()=>{for(;m&&c>0;)try{if(await new Promise(x=>setTimeout(x,l)),!m)break;await s({tx:t,stopPolling:g,onSuccess:a,onFailure:e,onIntervalTick:n,onReplaced:r});}catch(x){console.error(`Polling fetcher for txKey ${t.txKey} threw an error:`,x),c--;}c<=0&&(console.warn(`Polling for txKey ${t.txKey} stopped after reaching the maximum number of retries.`),e(),g());})();}exports.TransactionStatus=A;exports.TransactionTracker=N;exports.createBoundedUseStore=we;exports.createPulsarStore=Ae;exports.createTxInMemoryStore=Te;exports.initializePollingTracker=Ee;exports.initializeTxTrackingStore=E;exports.selectAllTransactions=F;exports.selectAllTransactionsByActiveWallet=B;exports.selectPendingTransactions=Y;exports.selectPendingTransactionsByActiveWallet=ee;exports.selectTxByKey=Z;

package/dist/index.mjs

@@ -1 +1 @@
-import {produce}from'immer';import {selectAdapterByKey,setChainId,normalizeError}from'@tuwaio/orbit-core';import U from'dayjs';import {persist}from'zustand/middleware';import {createStore}from'zustand/vanilla';import {useStore}from'zustand';function I({maxTransactions:n,onRemoteCreate:e}){return (a,c)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,addTxToPool:t=>{let o={...t,pending:true};a(r=>produce(r,i=>{if(i.lastAddedTxKey=t.txKey,t.txKey){if(Object.keys(i.transactionsPool).length>=n){let l=Object.values(i.transactionsPool).sort((p,d)=>p.localTimestamp-d.localTimestamp);if(l.length>0){let p=l[0];delete i.transactionsPool[p.txKey];}}i.transactionsPool[t.txKey]=o;}})),e&&e(o).catch(r=>console.error("[Pulsar Sync] Create failed:",r));},updateTxParams:(t,o)=>{a(r=>produce(r,i=>{let s=i.transactionsPool[t];s&&Object.assign(s,o);}));},removeTxFromPool:t=>{a(o=>produce(o,r=>{delete r.transactionsPool[t];}));},closeTxTrackedModal:t=>{a(o=>produce(o,r=>{if(t&&r.transactionsPool[t]){let i=r.transactionsPool[t];r.transactionsPool[t]={...i,isTrackedModalOpen:false};}r.initialTx=void 0;}));},getLastTxKey:()=>c().lastAddedTxKey})}var K=n=>Object.values(n).sort((e,a)=>Number(e.localTimestamp)-Number(a.localTimestamp)),W=n=>K(n).filter(e=>e.pending),X=(n,e)=>n[e],z=(n,e)=>K(n).filter(a=>a.from.toLowerCase()===e.toLowerCase()),q=(n,e)=>z(n,e).filter(a=>a.pending);function oe({adapter:n,maxTransactions:e=50,onRemoteCreate:a,gelatoApiKey:c,...t}){return createStore()(persist((o,r)=>({...I({maxTransactions:e,onRemoteCreate:a})(o,r),getAdapter:()=>n,initializeTransactionsPool:async()=>{let i=Object.values(r().transactionsPool).filter(s=>s.pending);await Promise.all(i.map(s=>selectAdapterByKey({adapterKey:s.adapter,adapter:n})?.checkAndInitializeTrackerInStore({tx:s,gelatoApiKey:c,...r()})));},executeTxAction:async({defaultTracker:i,actionFunction:s,params:l,...p})=>{let{desiredChainID:d,tracker:g,...u}=l,{onSuccess:A,onError:x,onReplaced:F}=p,h=U().unix();o({initialTx:{...l,actionFunction:s,localTimestamp:h,isInitializing:true}});let P=selectAdapterByKey({adapterKey:u.adapter,adapter:n}),v=T=>{o(f=>produce(f,m=>{m.initialTx&&(m.initialTx.isInitializing=false,m.initialTx.error=normalizeError(T));}));};if(!P){let T=new Error("No adapter found for this transaction.");throw v(T),T}try{let{connectorType:T,walletAddress:f}=P.getConnectorInfo();await P.checkChainForTx(d);let m=await s();if(!m){o({initialTx:void 0});return}let{tracker:b,txKey:k}=P.checkTransactionsTracker({actionTxKey:m,connectorType:T,tracker:g,gelatoApiKey:c}),E={...u,connectorType:T,from:f,tracker:b||i,chainId:setChainId(d),localTimestamp:h,txKey:k,hash:b==="ethereum"?m:void 0,pending:!1,isTrackedModalOpen:l.withTrackedModal};r().addTxToPool(E),o(O=>produce(O,S=>{S.initialTx&&(S.initialTx.isInitializing=!1,S.initialTx.lastTxKey=k);}));let C=r().transactionsPool[k];await P.checkAndInitializeTrackerInStore({tx:C,onSuccess:A,onError:x,onReplaced:F,gelatoApiKey:c,...r()});}catch(T){throw v(T),T}}}),{...t}))}var G=(t=>(t.Ethereum="ethereum",t.Safe="safe",t.Gelato="gelato",t.Solana="solana",t))(G||{}),$=(c=>(c.Failed="Failed",c.Success="Success",c.Replaced="Replaced",c))($||{});var Te=(n=>e=>useStore(n,e));var D=5e3,_=10;function de(n){let{tx:e,fetcher:a,onInitialize:c,onSuccess:t,onFailure:o,onIntervalTick:r,onReplaced:i,removeTxFromPool:s,pollingInterval:l=D,maxRetries:p=_}=n;if(!e.pending)return;c?.();let d=p,g=true,u=x=>{g&&(g=false,s&&!x?.withoutRemoving&&s(e.txKey));};(async()=>{for(;g&&d>0;)try{if(await new Promise(x=>setTimeout(x,l)),!g)break;await a({tx:e,stopPolling:u,onSuccess:t,onFailure:o,onIntervalTick:r,onReplaced:i});}catch(x){console.error(`Polling fetcher for txKey ${e.txKey} threw an error:`,x),d--;}d<=0&&(console.warn(`Polling for txKey ${e.txKey} stopped after reaching the maximum number of retries.`),o(),u());})();}export{$ as TransactionStatus,G as TransactionTracker,Te as createBoundedUseStore,oe as createPulsarStore,de as initializePollingTracker,I as initializeTxTrackingStore,K as selectAllTransactions,z as selectAllTransactionsByActiveWallet,W as selectPendingTransactions,q as selectPendingTransactionsByActiveWallet,X as selectTxByKey};
+import {produce,setAutoFreeze}from'immer';import {createStore}from'zustand/vanilla';import {selectAdapterByKey,setChainId,normalizeError}from'@tuwaio/orbit-core';import D from'dayjs';import {persist}from'zustand/middleware';import {useStore}from'zustand';function E({maxTransactions:o,onRemoteCreate:t}){return (s,p)=>({transactionsPool:{},lastAddedTxKey:void 0,initialTx:void 0,addTxToPool:a=>{let e={...a,pending:true};s(n=>produce(n,r=>{if(r.lastAddedTxKey=a.txKey,a.txKey){if(Object.keys(r.transactionsPool).length>=o){let l=Object.values(r.transactionsPool).sort((T,c)=>T.localTimestamp-c.localTimestamp);if(l.length>0){let T=l[0];delete r.transactionsPool[T.txKey];}}r.transactionsPool[a.txKey]=e;}})),t&&t(e).catch(n=>console.error("[Pulsar Sync] Create failed:",n));},updateTxParams:(a,e)=>{s(n=>produce(n,r=>{let i=r.transactionsPool[a];i&&Object.assign(i,e);}));},removeTxFromPool:a=>{s(e=>produce(e,n=>{delete n.transactionsPool[a];}));},closeTxTrackedModal:a=>{s(e=>produce(e,n=>{if(a&&n.transactionsPool[a]){let r=n.transactionsPool[a];n.transactionsPool[a]={...r,isTrackedModalOpen:false};}n.initialTx=void 0;}));},getLastTxKey:()=>p().lastAddedTxKey})}var F=o=>Object.values(o).sort((t,s)=>Number(t.localTimestamp)-Number(s.localTimestamp)),Y=o=>F(o).filter(t=>t.pending),Z=(o,t)=>o[t],B=(o,t)=>F(o).filter(s=>s.from.toLowerCase()===t.toLowerCase()),ee=(o,t)=>B(o,t).filter(s=>s.pending);var N=(a=>(a.Ethereum="ethereum",a.Safe="safe",a.Gelato="gelato",a.Solana="solana",a))(N||{}),A=(p=>(p.Failed="Failed",p.Success="Success",p.Replaced="Replaced",p))(A||{});var $=o=>o==="Success"||o==="Replaced",M=(o,t)=>{let s=o[t.txKey];return $(s?.status)?false:(o[t.txKey]=t,true)};function Te({localTransactionsPool:o,getHistory:t,onHistoryFetched:s}){setAutoFreeze(false);let p=e=>({isLoading:e,isError:false}),a=e=>e?(s&&queueMicrotask(()=>s(e.docs)),n=>produce(n,r=>{let i=r.transactionsPool;for(let l of e.docs)M(i,l);r.currentPage=e.page,r.hasMore=e.hasNextPage,r.isLoading=false;})):n=>n;return createStore()((e,n)=>({transactionsPool:o,isLoading:false,isError:false,hasMore:false,currentPage:1,syncWithLocalPool:r=>{e(i=>produce(i,l=>{let T=l.transactionsPool;for(let c of Object.values(r))M(T,c);}));},fetchInitial:async r=>{if(!(!t||!r)){e(p(true));try{let i=await t({page:1,walletAddress:r});e(a(i));}catch(i){console.error("[Pulsar] Failed to fetch initial transaction history:",i),e({isLoading:false,isError:true});}}},fetchNextPage:async r=>{let{hasMore:i,isLoading:l,currentPage:T}=n();if(!(!t||!i||l||!r)){e(p(true));try{let c=T+1,m=await t({page:c,walletAddress:r});e(a(m));}catch(c){console.error(`[Pulsar] Failed to fetch transaction history page ${T+1}:`,c),e({isLoading:false,isError:true});}}}}))}function Ae({adapter:o,maxTransactions:t=50,onRemoteCreate:s,gelatoApiKey:p,...a}){return createStore()(persist((e,n)=>({...E({maxTransactions:t,onRemoteCreate:s})(e,n),getAdapter:()=>o,initializeTransactionsPool:async()=>{let r=Object.values(n().transactionsPool).filter(i=>i.pending);await Promise.all(r.map(i=>selectAdapterByKey({adapterKey:i.adapter,adapter:o})?.checkAndInitializeTrackerInStore({tx:i,gelatoApiKey:p,...n()})));},injectExternalPendingTxs:async r=>{let l=n().getAdapter(),T=[];e(c=>produce(c,m=>{let g=m.transactionsPool;r.forEach(d=>{let x=g[d.txKey];d.pending&&!x&&(g[d.txKey]=d,T.push(d));let S=d.status==="Success"||d.status==="Failed"||d.status==="Replaced";x?.pending&&S&&(x.status=d.status,x.pending=false,d.txKey&&(x.txKey=d.txKey),d.finishedTimestamp&&(x.finishedTimestamp=d.finishedTimestamp));});})),T.length>0&&await Promise.all(T.map(c=>selectAdapterByKey({adapterKey:c.adapter,adapter:l})?.checkAndInitializeTrackerInStore({tx:c,gelatoApiKey:p,...n()})));},executeTxAction:async({defaultTracker:r,actionFunction:i,params:l,...T})=>{let{desiredChainID:c,tracker:m,...g}=l,{onSuccess:d,onError:x,onReplaced:S}=T,K=D().unix();e({initialTx:{...l,actionFunction:i,localTimestamp:K,isInitializing:true}});let f=selectAdapterByKey({adapterKey:g.adapter,adapter:o}),w=u=>{e(k=>produce(k,P=>{P.initialTx&&(P.initialTx.isInitializing=false,P.initialTx.error=normalizeError(u));}));};if(!f){let u=new Error("No adapter found for this transaction.");throw w(u),u}try{let{connectorType:u,walletAddress:k}=f.getConnectorInfo();await f.checkChainForTx(c);let P=await i();if(!P){e({initialTx:void 0});return}let{tracker:R,txKey:h}=f.checkTransactionsTracker({actionTxKey:P,connectorType:u,tracker:m,gelatoApiKey:p}),O={...g,connectorType:u,from:k,tracker:R||r,chainId:setChainId(c),localTimestamp:K,txKey:h,hash:R==="ethereum"?P:void 0,pending:!1,isTrackedModalOpen:l.withTrackedModal};n().addTxToPool(O),e(L=>produce(L,I=>{I.initialTx&&(I.initialTx.isInitializing=!1,I.initialTx.lastTxKey=h);}));let z=n().transactionsPool[h];await f.checkAndInitializeTrackerInStore({tx:z,onSuccess:d,onError:x,onReplaced:S,gelatoApiKey:p,...n()});}catch(u){throw w(u),u}}}),{...a}))}var we=(o=>t=>useStore(o,t));var V=5e3,X=10;function Ee(o){let{tx:t,fetcher:s,onInitialize:p,onSuccess:a,onFailure:e,onIntervalTick:n,onReplaced:r,removeTxFromPool:i,pollingInterval:l=V,maxRetries:T=X}=o;if(!t.pending)return;p?.();let c=T,m=true,g=x=>{m&&(m=false,i&&!x?.withoutRemoving&&i(t.txKey));};(async()=>{for(;m&&c>0;)try{if(await new Promise(x=>setTimeout(x,l)),!m)break;await s({tx:t,stopPolling:g,onSuccess:a,onFailure:e,onIntervalTick:n,onReplaced:r});}catch(x){console.error(`Polling fetcher for txKey ${t.txKey} threw an error:`,x),c--;}c<=0&&(console.warn(`Polling for txKey ${t.txKey} stopped after reaching the maximum number of retries.`),e(),g());})();}export{A as TransactionStatus,N as TransactionTracker,we as createBoundedUseStore,Ae as createPulsarStore,Te as createTxInMemoryStore,Ee as initializePollingTracker,E as initializeTxTrackingStore,F as selectAllTransactions,B as selectAllTransactionsByActiveWallet,Y as selectPendingTransactions,ee as selectPendingTransactionsByActiveWallet,Z as selectTxByKey};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/pulsar-core",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -40,18 +40,18 @@
     }
   ],
   "peerDependencies": {
-    "@tuwaio/orbit-core": ">=0.2.7",
+    "@tuwaio/orbit-core": ">=0.2.8",
     "dayjs": "1.x.x",
     "immer": "11.x.x",
     "zustand": "5.x.x"
   },
   "devDependencies": {
-    "@tuwaio/orbit-core": "^0.2.7",
-    "dayjs": "^1.11.19",
+    "@tuwaio/orbit-core": "^0.2.8",
+    "dayjs": "^1.11.20",
     "immer": "^11.1.4",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "zustand": "^5.0.11"
+    "typescript": "^6.0.3",
+    "zustand": "^5.0.12"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",