@stryke-xyz/premarket-sdk 1.2.2 → 1.2.4

package/dist/esm/sync/clients/base-client.js

@@ -0,0 +1,508 @@
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+import { RedisWsClient } from "../redis-ws-client.js";
+function scheduleDeferred(callback) {
+    if (typeof queueMicrotask === "function") {
+        queueMicrotask(callback);
+        return;
+    }
+    setTimeout(callback, 0);
+}
+/**
+ * Base abstract class for sync clients
+ * @template TMessage - The message type (e.g., SequencedMessage, BalanceUpdateMessage)
+ * @template TChange - The change type (e.g., OrderChange, BalanceData[])
+ * @template TData - The data type stored in the map (e.g., StoredOrder, string)
+ * @template TConfig - The config type (must have redisUrl and channel)
+ */ export var BaseSyncClient = /*#__PURE__*/ function() {
+    "use strict";
+    function BaseSyncClient(config) {
+        _class_call_check(this, BaseSyncClient);
+        _define_property(this, "wsClient", null);
+        _define_property(this, "config", void 0);
+        _define_property(this, "status", "disconnected");
+        _define_property(this, "lastSeq", 0);
+        _define_property(this, "incomingQueue", []);
+        _define_property(this, "isProcessing", false);
+        _define_property(this, "statusListeners", new Set());
+        _define_property(this, "changeListeners", new Set());
+        _define_property(this, "dataMap", new Map());
+        _define_property(this, "snapshotListeners", new Set());
+        this.config = config;
+    }
+    _create_class(BaseSyncClient, [
+        {
+            key: "connect",
+            value: /** Opens the websocket subscription, fetches a fresh snapshot, and starts replaying queued messages. */ function connect() {
+                return _async_to_generator(function() {
+                    var _this, wsUrl;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _this = this;
+                                // Disconnect existing connection if any (for restarts)
+                                return [
+                                    4,
+                                    this.disconnect()
+                                ];
+                            case 1:
+                                _state.sent();
+                                this.setStatus("connecting");
+                                // Only allow ws:// or wss:// URLs
+                                wsUrl = this.config.redisUrl;
+                                if (!wsUrl.startsWith("ws://") && !wsUrl.startsWith("wss://")) {
+                                    throw new Error("Invalid WebSocket URL: ".concat(wsUrl, ". Only ws:// and wss:// URLs are supported."));
+                                }
+                                // Set isProcessing to true to prevent queue processing until snapshot is fetched
+                                this.isProcessing = true;
+                                // Start WebSocket connection first (messages will be queued)
+                                this.wsClient = new RedisWsClient(wsUrl);
+                                this.wsClient.subscribe(this.config.channel, function(messageStr) {
+                                    try {
+                                        var message = JSON.parse(messageStr);
+                                        _this.enqueueMessage(message);
+                                    } catch (error) {
+                                        console.error("Error parsing message:", error);
+                                    }
+                                });
+                                // Wait 200ms after subscription to ensure we don't miss any updates
+                                // that might arrive immediately after subscribing
+                                return [
+                                    4,
+                                    new Promise(function(resolve) {
+                                        return setTimeout(resolve, 200);
+                                    })
+                                ];
+                            case 2:
+                                _state.sent();
+                                // Fetch snapshot while messages are being queued (but not processed)
+                                this.setStatus("syncing");
+                                return [
+                                    4,
+                                    this.fetchSnapshot()
+                                ];
+                            case 3:
+                                _state.sent();
+                                // Now allow queue processing
+                                this.isProcessing = false;
+                                this.setStatus("synced");
+                                // Start processing any queued messages
+                                this.processQueue();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "enqueueMessage",
+            value: function enqueueMessage(message) {
+                this.incomingQueue.push(message);
+                this.processQueue();
+            }
+        },
+        {
+            key: "processQueue",
+            value: function processQueue() {
+                return _async_to_generator(function() {
+                    var _this, message;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _this = this;
+                                if (this.isProcessing) return [
+                                    2
+                                ];
+                                this.isProcessing = true;
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    ,
+                                    9,
+                                    10
+                                ]);
+                                _state.label = 2;
+                            case 2:
+                                if (!(this.incomingQueue.length > 0)) return [
+                                    3,
+                                    8
+                                ];
+                                message = this.incomingQueue.shift();
+                                // Skip if we've already processed this sequence ID
+                                if (message.seq <= this.lastSeq) {
+                                    return [
+                                        3,
+                                        2
+                                    ];
+                                }
+                                if (!// Check if previousSeq matches our lastSeq (no gap)
+                                (message.previousSeq === this.lastSeq)) return [
+                                    3,
+                                    4
+                                ];
+                                // Perfect! Process this message and update lastSeq
+                                return [
+                                    4,
+                                    this.applyMessage(message)
+                                ];
+                            case 3:
+                                _state.sent();
+                                this.lastSeq = message.seq;
+                                return [
+                                    3,
+                                    7
+                                ];
+                            case 4:
+                                if (!(message.previousSeq < this.lastSeq)) return [
+                                    3,
+                                    5
+                                ];
+                                // This message is out of order (previousSeq is behind us)
+                                // This shouldn't happen in normal operation, but skip it
+                                console.warn("Out of order message: previousSeq=".concat(message.previousSeq, ", lastSeq=").concat(this.lastSeq, ", seq=").concat(message.seq));
+                                return [
+                                    3,
+                                    2
+                                ];
+                            case 5:
+                                // Gap detected: previousSeq > lastSeq
+                                // Trigger full resync instead of gap recovery
+                                console.warn("Gap detected: previousSeq=".concat(message.previousSeq, ", lastSeq=").concat(this.lastSeq, ", seq=").concat(message.seq, ". Triggering full resync."));
+                                // Clear the queue - full resync will reconnect and start fresh
+                                this.incomingQueue = [];
+                                return [
+                                    4,
+                                    this.fullResync()
+                                ];
+                            case 6:
+                                _state.sent();
+                                return [
+                                    3,
+                                    8
+                                ];
+                            case 7:
+                                return [
+                                    3,
+                                    2
+                                ];
+                            case 8:
+                                return [
+                                    3,
+                                    10
+                                ];
+                            case 9:
+                                this.isProcessing = false;
+                                if (this.incomingQueue.length > 0) {
+                                    scheduleDeferred(function() {
+                                        void _this.processQueue();
+                                    });
+                                }
+                                return [
+                                    7
+                                ];
+                            case 10:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "fullResync",
+            value: function fullResync() {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                this.setStatus("recovering");
+                                // Disconnect and reconnect to restart the flow
+                                return [
+                                    4,
+                                    this.disconnect()
+                                ];
+                            case 1:
+                                _state.sent();
+                                return [
+                                    4,
+                                    this.connect()
+                                ];
+                            case 2:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "setStatus",
+            value: function setStatus(status) {
+                if (this.status === status) return;
+                this.status = status;
+                this.statusListeners.forEach(function(listener) {
+                    try {
+                        listener(status);
+                    } catch (error) {
+                        console.error("Error in status listener:", error);
+                    }
+                });
+            }
+        },
+        {
+            /** Returns the current connection lifecycle state. */ key: "getStatus",
+            value: function getStatus() {
+                return this.status;
+            }
+        },
+        {
+            /** Returns true once the client has finished its initial snapshot sync. */ key: "isSynced",
+            value: function isSynced() {
+                return this.status === "synced";
+            }
+        },
+        {
+            /** Returns the most recent successfully applied sequence id. */ key: "getLastSequence",
+            value: function getLastSequence() {
+                return this.lastSeq;
+            }
+        },
+        {
+            /** Returns the number of queued messages waiting to be processed. */ key: "getBufferedCount",
+            value: function getBufferedCount() {
+                return this.incomingQueue.length;
+            }
+        },
+        {
+            /** Registers a listener for connection status changes. */ key: "onStatus",
+            value: function onStatus(callback) {
+                var _this = this;
+                this.statusListeners.add(callback);
+                return function() {
+                    return _this.statusListeners.delete(callback);
+                };
+            }
+        },
+        {
+            /** Registers a listener for individual applied change events. */ key: "onChange",
+            value: function onChange(callback) {
+                var _this = this;
+                this.changeListeners.add(callback);
+                return function() {
+                    return _this.changeListeners.delete(callback);
+                };
+            }
+        },
+        {
+            /** Registers a listener for full snapshot updates. */ key: "onSnapshot",
+            value: function onSnapshot(callback) {
+                var _this = this;
+                this.snapshotListeners.add(callback);
+                return function() {
+                    return _this.snapshotListeners.delete(callback);
+                };
+            }
+        },
+        {
+            key: "notifySnapshotListeners",
+            value: function notifySnapshotListeners(data) {
+                this.snapshotListeners.forEach(function(listener) {
+                    try {
+                        listener(data);
+                    } catch (error) {
+                        console.error("Error in snapshot listener:", error);
+                    }
+                });
+            }
+        },
+        {
+            key: "disconnect",
+            value: /** Closes the websocket connection and clears queued messages. */ function disconnect() {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        // Stop processing
+                        this.isProcessing = true;
+                        // Clear WebSocket connection
+                        if (this.wsClient) {
+                            this.wsClient.close();
+                            this.wsClient = null;
+                        }
+                        // Clear queue
+                        this.incomingQueue = [];
+                        this.setStatus("disconnected");
+                        return [
+                            2
+                        ];
+                    });
+                }).call(this);
+            }
+        }
+    ]);
+    return BaseSyncClient;
+} /**
+   * Abstract methods to be implemented by child classes
+   */ ();