@metamask-previews/perps-controller 0.0.0-preview-ce3ee897a → 0.0.0-preview-e4aa1532

package/dist/providers/index.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperLiquidProvider = exports.AggregatedPerpsProvider = void 0;
+/**
+ * Provider module exports
+ */
+var AggregatedPerpsProvider_1 = require("./AggregatedPerpsProvider.cjs");
+Object.defineProperty(exports, "AggregatedPerpsProvider", { enumerable: true, get: function () { return AggregatedPerpsProvider_1.AggregatedPerpsProvider; } });
+var HyperLiquidProvider_1 = require("./HyperLiquidProvider.cjs");
+Object.defineProperty(exports, "HyperLiquidProvider", { enumerable: true, get: function () { return HyperLiquidProvider_1.HyperLiquidProvider; } });
+//# sourceMappingURL=index.cjs.map

package/dist/providers/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,yEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,iEAA4D;AAAnD,0HAAA,mBAAmB,OAAA","sourcesContent":["/**\n * Provider module exports\n */\nexport { AggregatedPerpsProvider } from './AggregatedPerpsProvider';\nexport { HyperLiquidProvider } from './HyperLiquidProvider';\n"]}

package/dist/providers/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Provider module exports
+ */
+export { AggregatedPerpsProvider } from "./AggregatedPerpsProvider.cjs";
+export { HyperLiquidProvider } from "./HyperLiquidProvider.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/providers/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AACpE,OAAO,EAAE,mBAAmB,EAAE,kCAA8B"}

package/dist/providers/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Provider module exports
+ */
+export { AggregatedPerpsProvider } from "./AggregatedPerpsProvider.mjs";
+export { HyperLiquidProvider } from "./HyperLiquidProvider.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/providers/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AACpE,OAAO,EAAE,mBAAmB,EAAE,kCAA8B"}

package/dist/providers/index.mjs

@@ -0,0 +1,6 @@
+/**
+ * Provider module exports
+ */
+export { AggregatedPerpsProvider } from "./AggregatedPerpsProvider.mjs";
+export { HyperLiquidProvider } from "./HyperLiquidProvider.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/providers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AACpE,OAAO,EAAE,mBAAmB,EAAE,kCAA8B","sourcesContent":["/**\n * Provider module exports\n */\nexport { AggregatedPerpsProvider } from './AggregatedPerpsProvider';\nexport { HyperLiquidProvider } from './HyperLiquidProvider';\n"]}

package/dist/routing/ProviderRouter.cjs

@@ -0,0 +1,148 @@
+"use strict";
+/* eslint-disable no-restricted-syntax */
+// TODO: Fix ESLint errors in this file - tracked for Phase 6 cleanup
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRouter = void 0;
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+class ProviderRouter {
+    /**
+     * Create a new ProviderRouter instance.
+     *
+     * @param options - Router configuration options
+     * @param options.defaultProvider - Default provider for operations without explicit providerId
+     * @param options.strategy - Routing strategy (Phase 1: only 'default_provider' supported)
+     */
+    constructor(options) {
+        /** Current routing strategy (Phase 1: only 'default_provider' supported) */
+        this.strategy = 'default_provider';
+        /** Map of provider ID to the markets it supports */
+        this.providerMarkets = new Map();
+        this.defaultProvider = options.defaultProvider;
+        if (options.strategy) {
+            this.strategy = options.strategy;
+        }
+    }
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params) {
+        // Phase 1: explicit providerId always wins
+        if (params.providerId) {
+            return params.providerId;
+        }
+        // Fall back to default provider
+        return this.defaultProvider;
+    }
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol) {
+        const providers = [];
+        this.providerMarkets.forEach((markets, providerId) => {
+            if (markets.has(symbol)) {
+                providers.push(providerId);
+            }
+        });
+        return providers;
+    }
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId, markets) {
+        this.providerMarkets.set(providerId, new Set(markets));
+    }
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId) {
+        this.providerMarkets.delete(providerId);
+    }
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId) {
+        this.defaultProvider = providerId;
+    }
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider() {
+        return this.defaultProvider;
+    }
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy() {
+        return this.strategy;
+    }
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId, symbol) {
+        const markets = this.providerMarkets.get(providerId);
+        return markets?.has(symbol) ?? false;
+    }
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders() {
+        return Array.from(this.providerMarkets.keys());
+    }
+}
+exports.ProviderRouter = ProviderRouter;
+//# sourceMappingURL=ProviderRouter.cjs.map

package/dist/routing/ProviderRouter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.cjs","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,qEAAqE;AACrE;;;;;;;;;GASG;;;AAcH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,cAAc;IAWzB;;;;;;OAMG;IACH,YAAY,OAKX;QAnBD,4EAA4E;QAC3D,aAAQ,GAAoB,kBAAkB,CAAC;QAEhE,oDAAoD;QACnC,oBAAe,GAC9B,IAAI,GAAG,EAAE,CAAC;QAeV,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,MAA0B;QACvC,2CAA2C;QAC3C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QAED,gCAAgC;QAChC,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,MAAc;QAClC,MAAM,SAAS,GAAwB,EAAE,CAAC;QAC1C,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE;YACnD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CACnB,UAA6B,EAC7B,OAAiB;QAEjB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,UAA6B;QAChD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,UAA6B;QAC9C,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CACpB,UAA6B,EAC7B,MAAc;QAEd,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,OAAO,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AA1ID,wCA0IC","sourcesContent":["/* eslint-disable no-restricted-syntax */\n// TODO: Fix ESLint errors in this file - tracked for Phase 6 cleanup\n/**\n * ProviderRouter - Simple routing logic for multi-provider order routing\n *\n * Phase 1 implementation: Uses simple routing strategy where:\n * - Explicit providerId always wins\n * - Falls back to default provider otherwise\n *\n * Advanced routing strategies (best_price, user_preference per market, lowest_fee)\n * are deferred to Phase 3.\n */\n\nimport type { PerpsProviderType, RoutingStrategy } from '../types';\n\n/**\n * Parameters for selecting a provider for an operation.\n */\nexport type RouterSelectParams = {\n  /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */\n  symbol?: string;\n  /** Explicit provider override - if provided, always used */\n  providerId?: PerpsProviderType;\n};\n\n/**\n * ProviderRouter handles routing decisions for write operations\n * in multi-provider scenarios.\n *\n * Phase 1 routing logic is simple:\n * 1. If explicit providerId is passed, use it\n * 2. Otherwise, use the default provider\n *\n * @example\n * ```typescript\n * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });\n *\n * // With explicit provider\n * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'\n *\n * // Without explicit provider\n * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)\n * ```\n */\nexport class ProviderRouter {\n  /** Default provider to use when no explicit providerId is specified */\n  private defaultProvider: PerpsProviderType;\n\n  /** Current routing strategy (Phase 1: only 'default_provider' supported) */\n  private readonly strategy: RoutingStrategy = 'default_provider';\n\n  /** Map of provider ID to the markets it supports */\n  private readonly providerMarkets: Map<PerpsProviderType, Set<string>> =\n    new Map();\n\n  /**\n   * Create a new ProviderRouter instance.\n   *\n   * @param options - Router configuration options\n   * @param options.defaultProvider - Default provider for operations without explicit providerId\n   * @param options.strategy - Routing strategy (Phase 1: only 'default_provider' supported)\n   */\n  constructor(options: {\n    /** Default provider for operations without explicit providerId */\n    defaultProvider: PerpsProviderType;\n    /** Routing strategy (Phase 1: only 'default_provider' supported) */\n    strategy?: RoutingStrategy;\n  }) {\n    this.defaultProvider = options.defaultProvider;\n    if (options.strategy) {\n      this.strategy = options.strategy;\n    }\n  }\n\n  /**\n   * Select the provider to use for an operation.\n   *\n   * Phase 1 logic:\n   * - Explicit providerId > defaultProvider\n   *\n   * @param params - Selection parameters\n   * @returns The provider ID to use\n   */\n  selectProvider(params: RouterSelectParams): PerpsProviderType {\n    // Phase 1: explicit providerId always wins\n    if (params.providerId) {\n      return params.providerId;\n    }\n\n    // Fall back to default provider\n    return this.defaultProvider;\n  }\n\n  /**\n   * Get all providers that support a specific market.\n   *\n   * @param symbol - Market symbol (e.g., 'BTC', 'ETH')\n   * @returns Array of provider IDs that support this market\n   */\n  getProvidersForMarket(symbol: string): PerpsProviderType[] {\n    const providers: PerpsProviderType[] = [];\n    this.providerMarkets.forEach((markets, providerId) => {\n      if (markets.has(symbol)) {\n        providers.push(providerId);\n      }\n    });\n    return providers;\n  }\n\n  /**\n   * Update the markets supported by a provider.\n   * Called during provider initialization or market refresh.\n   *\n   * @param providerId - Provider to update\n   * @param markets - Array of market symbols the provider supports\n   */\n  updateProviderMarkets(\n    providerId: PerpsProviderType,\n    markets: string[],\n  ): void {\n    this.providerMarkets.set(providerId, new Set(markets));\n  }\n\n  /**\n   * Clear markets for a provider (e.g., on disconnect).\n   *\n   * @param providerId - Provider to clear\n   */\n  clearProviderMarkets(providerId: PerpsProviderType): void {\n    this.providerMarkets.delete(providerId);\n  }\n\n  /**\n   * Set the default provider for routing.\n   *\n   * @param providerId - New default provider\n   */\n  setDefaultProvider(providerId: PerpsProviderType): void {\n    this.defaultProvider = providerId;\n  }\n\n  /**\n   * Get the current default provider.\n   *\n   * @returns Current default provider ID\n   */\n  getDefaultProvider(): PerpsProviderType {\n    return this.defaultProvider;\n  }\n\n  /**\n   * Get the current routing strategy.\n   *\n   * @returns Current routing strategy\n   */\n  getStrategy(): RoutingStrategy {\n    return this.strategy;\n  }\n\n  /**\n   * Check if a provider supports a specific market.\n   *\n   * @param providerId - Provider to check\n   * @param symbol - Market symbol\n   * @returns true if provider supports the market\n   */\n  providerSupportsMarket(\n    providerId: PerpsProviderType,\n    symbol: string,\n  ): boolean {\n    const markets = this.providerMarkets.get(providerId);\n    return markets?.has(symbol) ?? false;\n  }\n\n  /**\n   * Get all registered provider IDs.\n   *\n   * @returns Array of all provider IDs with registered markets\n   */\n  getRegisteredProviders(): PerpsProviderType[] {\n    return Array.from(this.providerMarkets.keys());\n  }\n}\n"]}

package/dist/routing/ProviderRouter.d.cts

@@ -0,0 +1,124 @@
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+import type { PerpsProviderType, RoutingStrategy } from "../types/index.cjs";
+/**
+ * Parameters for selecting a provider for an operation.
+ */
+export type RouterSelectParams = {
+    /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */
+    symbol?: string;
+    /** Explicit provider override - if provided, always used */
+    providerId?: PerpsProviderType;
+};
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+export declare class ProviderRouter {
+    /** Default provider to use when no explicit providerId is specified */
+    private defaultProvider;
+    /** Current routing strategy (Phase 1: only 'default_provider' supported) */
+    private readonly strategy;
+    /** Map of provider ID to the markets it supports */
+    private readonly providerMarkets;
+    /**
+     * Create a new ProviderRouter instance.
+     *
+     * @param options - Router configuration options
+     * @param options.defaultProvider - Default provider for operations without explicit providerId
+     * @param options.strategy - Routing strategy (Phase 1: only 'default_provider' supported)
+     */
+    constructor(options: {
+        /** Default provider for operations without explicit providerId */
+        defaultProvider: PerpsProviderType;
+        /** Routing strategy (Phase 1: only 'default_provider' supported) */
+        strategy?: RoutingStrategy;
+    });
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params: RouterSelectParams): PerpsProviderType;
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol: string): PerpsProviderType[];
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId: PerpsProviderType, markets: string[]): void;
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId: PerpsProviderType): void;
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId: PerpsProviderType): void;
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider(): PerpsProviderType;
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy(): RoutingStrategy;
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId: PerpsProviderType, symbol: string): boolean;
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders(): PerpsProviderType[];
+}
+//# sourceMappingURL=ProviderRouter.d.cts.map

package/dist/routing/ProviderRouter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.d.cts","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,2BAAiB;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc;IACzB,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAAoB;IAE3C,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CACpB;IAEZ;;;;;;OAMG;gBACS,OAAO,EAAE;QACnB,kEAAkE;QAClE,eAAe,EAAE,iBAAiB,CAAC;QACnC,oEAAoE;QACpE,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B;IAOD;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB;IAU7D;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAU1D;;;;;;OAMG;IACH,qBAAqB,CACnB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI;IAIP;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIzD;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIvD;;;;OAIG;IACH,kBAAkB,IAAI,iBAAiB;IAIvC;;;;OAIG;IACH,WAAW,IAAI,eAAe;IAI9B;;;;;;OAMG;IACH,sBAAsB,CACpB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO;IAKV;;;;OAIG;IACH,sBAAsB,IAAI,iBAAiB,EAAE;CAG9C"}

package/dist/routing/ProviderRouter.d.mts

@@ -0,0 +1,124 @@
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+import type { PerpsProviderType, RoutingStrategy } from "../types/index.mjs";
+/**
+ * Parameters for selecting a provider for an operation.
+ */
+export type RouterSelectParams = {
+    /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */
+    symbol?: string;
+    /** Explicit provider override - if provided, always used */
+    providerId?: PerpsProviderType;
+};
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+export declare class ProviderRouter {
+    /** Default provider to use when no explicit providerId is specified */
+    private defaultProvider;
+    /** Current routing strategy (Phase 1: only 'default_provider' supported) */
+    private readonly strategy;
+    /** Map of provider ID to the markets it supports */
+    private readonly providerMarkets;
+    /**
+     * Create a new ProviderRouter instance.
+     *
+     * @param options - Router configuration options
+     * @param options.defaultProvider - Default provider for operations without explicit providerId
+     * @param options.strategy - Routing strategy (Phase 1: only 'default_provider' supported)
+     */
+    constructor(options: {
+        /** Default provider for operations without explicit providerId */
+        defaultProvider: PerpsProviderType;
+        /** Routing strategy (Phase 1: only 'default_provider' supported) */
+        strategy?: RoutingStrategy;
+    });
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params: RouterSelectParams): PerpsProviderType;
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol: string): PerpsProviderType[];
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId: PerpsProviderType, markets: string[]): void;
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId: PerpsProviderType): void;
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId: PerpsProviderType): void;
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider(): PerpsProviderType;
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy(): RoutingStrategy;
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId: PerpsProviderType, symbol: string): boolean;
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders(): PerpsProviderType[];
+}
+//# sourceMappingURL=ProviderRouter.d.mts.map

package/dist/routing/ProviderRouter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.d.mts","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,2BAAiB;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc;IACzB,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAAoB;IAE3C,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAEhE,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CACpB;IAEZ;;;;;;OAMG;gBACS,OAAO,EAAE;QACnB,kEAAkE;QAClE,eAAe,EAAE,iBAAiB,CAAC;QACnC,oEAAoE;QACpE,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B;IAOD;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB;IAU7D;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAU1D;;;;;;OAMG;IACH,qBAAqB,CACnB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI;IAIP;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIzD;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIvD;;;;OAIG;IACH,kBAAkB,IAAI,iBAAiB;IAIvC;;;;OAIG;IACH,WAAW,IAAI,eAAe;IAI9B;;;;;;OAMG;IACH,sBAAsB,CACpB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,GACb,OAAO;IAKV;;;;OAIG;IACH,sBAAsB,IAAI,iBAAiB,EAAE;CAG9C"}

package/dist/routing/ProviderRouter.mjs

@@ -0,0 +1,144 @@
+/* eslint-disable no-restricted-syntax */
+// TODO: Fix ESLint errors in this file - tracked for Phase 6 cleanup
+/**
+ * ProviderRouter - Simple routing logic for multi-provider order routing
+ *
+ * Phase 1 implementation: Uses simple routing strategy where:
+ * - Explicit providerId always wins
+ * - Falls back to default provider otherwise
+ *
+ * Advanced routing strategies (best_price, user_preference per market, lowest_fee)
+ * are deferred to Phase 3.
+ */
+/**
+ * ProviderRouter handles routing decisions for write operations
+ * in multi-provider scenarios.
+ *
+ * Phase 1 routing logic is simple:
+ * 1. If explicit providerId is passed, use it
+ * 2. Otherwise, use the default provider
+ *
+ * @example
+ * ```typescript
+ * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });
+ *
+ * // With explicit provider
+ * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'
+ *
+ * // Without explicit provider
+ * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)
+ * ```
+ */
+export class ProviderRouter {
+    /**
+     * Create a new ProviderRouter instance.
+     *
+     * @param options - Router configuration options
+     * @param options.defaultProvider - Default provider for operations without explicit providerId
+     * @param options.strategy - Routing strategy (Phase 1: only 'default_provider' supported)
+     */
+    constructor(options) {
+        /** Current routing strategy (Phase 1: only 'default_provider' supported) */
+        this.strategy = 'default_provider';
+        /** Map of provider ID to the markets it supports */
+        this.providerMarkets = new Map();
+        this.defaultProvider = options.defaultProvider;
+        if (options.strategy) {
+            this.strategy = options.strategy;
+        }
+    }
+    /**
+     * Select the provider to use for an operation.
+     *
+     * Phase 1 logic:
+     * - Explicit providerId > defaultProvider
+     *
+     * @param params - Selection parameters
+     * @returns The provider ID to use
+     */
+    selectProvider(params) {
+        // Phase 1: explicit providerId always wins
+        if (params.providerId) {
+            return params.providerId;
+        }
+        // Fall back to default provider
+        return this.defaultProvider;
+    }
+    /**
+     * Get all providers that support a specific market.
+     *
+     * @param symbol - Market symbol (e.g., 'BTC', 'ETH')
+     * @returns Array of provider IDs that support this market
+     */
+    getProvidersForMarket(symbol) {
+        const providers = [];
+        this.providerMarkets.forEach((markets, providerId) => {
+            if (markets.has(symbol)) {
+                providers.push(providerId);
+            }
+        });
+        return providers;
+    }
+    /**
+     * Update the markets supported by a provider.
+     * Called during provider initialization or market refresh.
+     *
+     * @param providerId - Provider to update
+     * @param markets - Array of market symbols the provider supports
+     */
+    updateProviderMarkets(providerId, markets) {
+        this.providerMarkets.set(providerId, new Set(markets));
+    }
+    /**
+     * Clear markets for a provider (e.g., on disconnect).
+     *
+     * @param providerId - Provider to clear
+     */
+    clearProviderMarkets(providerId) {
+        this.providerMarkets.delete(providerId);
+    }
+    /**
+     * Set the default provider for routing.
+     *
+     * @param providerId - New default provider
+     */
+    setDefaultProvider(providerId) {
+        this.defaultProvider = providerId;
+    }
+    /**
+     * Get the current default provider.
+     *
+     * @returns Current default provider ID
+     */
+    getDefaultProvider() {
+        return this.defaultProvider;
+    }
+    /**
+     * Get the current routing strategy.
+     *
+     * @returns Current routing strategy
+     */
+    getStrategy() {
+        return this.strategy;
+    }
+    /**
+     * Check if a provider supports a specific market.
+     *
+     * @param providerId - Provider to check
+     * @param symbol - Market symbol
+     * @returns true if provider supports the market
+     */
+    providerSupportsMarket(providerId, symbol) {
+        const markets = this.providerMarkets.get(providerId);
+        return markets?.has(symbol) ?? false;
+    }
+    /**
+     * Get all registered provider IDs.
+     *
+     * @returns Array of all provider IDs with registered markets
+     */
+    getRegisteredProviders() {
+        return Array.from(this.providerMarkets.keys());
+    }
+}
+//# sourceMappingURL=ProviderRouter.mjs.map

package/dist/routing/ProviderRouter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRouter.mjs","sourceRoot":"","sources":["../../src/routing/ProviderRouter.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,qEAAqE;AACrE;;;;;;;;;GASG;AAcH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,cAAc;IAWzB;;;;;;OAMG;IACH,YAAY,OAKX;QAnBD,4EAA4E;QAC3D,aAAQ,GAAoB,kBAAkB,CAAC;QAEhE,oDAAoD;QACnC,oBAAe,GAC9B,IAAI,GAAG,EAAE,CAAC;QAeV,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,MAA0B;QACvC,2CAA2C;QAC3C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QAED,gCAAgC;QAChC,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,MAAc;QAClC,MAAM,SAAS,GAAwB,EAAE,CAAC;QAC1C,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE;YACnD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CACnB,UAA6B,EAC7B,OAAiB;QAEjB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,UAA6B;QAChD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,UAA6B;QAC9C,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CACpB,UAA6B,EAC7B,MAAc;QAEd,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,OAAO,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;CACF","sourcesContent":["/* eslint-disable no-restricted-syntax */\n// TODO: Fix ESLint errors in this file - tracked for Phase 6 cleanup\n/**\n * ProviderRouter - Simple routing logic for multi-provider order routing\n *\n * Phase 1 implementation: Uses simple routing strategy where:\n * - Explicit providerId always wins\n * - Falls back to default provider otherwise\n *\n * Advanced routing strategies (best_price, user_preference per market, lowest_fee)\n * are deferred to Phase 3.\n */\n\nimport type { PerpsProviderType, RoutingStrategy } from '../types';\n\n/**\n * Parameters for selecting a provider for an operation.\n */\nexport type RouterSelectParams = {\n  /** Asset identifier (e.g., 'BTC', 'ETH', 'xyz:TSLA') */\n  symbol?: string;\n  /** Explicit provider override - if provided, always used */\n  providerId?: PerpsProviderType;\n};\n\n/**\n * ProviderRouter handles routing decisions for write operations\n * in multi-provider scenarios.\n *\n * Phase 1 routing logic is simple:\n * 1. If explicit providerId is passed, use it\n * 2. Otherwise, use the default provider\n *\n * @example\n * ```typescript\n * const router = new ProviderRouter({ defaultProvider: 'hyperliquid' });\n *\n * // With explicit provider\n * router.selectProvider({ providerId: 'myx' }); // Returns 'myx'\n *\n * // Without explicit provider\n * router.selectProvider({ symbol: 'BTC' }); // Returns 'hyperliquid' (default)\n * ```\n */\nexport class ProviderRouter {\n  /** Default provider to use when no explicit providerId is specified */\n  private defaultProvider: PerpsProviderType;\n\n  /** Current routing strategy (Phase 1: only 'default_provider' supported) */\n  private readonly strategy: RoutingStrategy = 'default_provider';\n\n  /** Map of provider ID to the markets it supports */\n  private readonly providerMarkets: Map<PerpsProviderType, Set<string>> =\n    new Map();\n\n  /**\n   * Create a new ProviderRouter instance.\n   *\n   * @param options - Router configuration options\n   * @param options.defaultProvider - Default provider for operations without explicit providerId\n   * @param options.strategy - Routing strategy (Phase 1: only 'default_provider' supported)\n   */\n  constructor(options: {\n    /** Default provider for operations without explicit providerId */\n    defaultProvider: PerpsProviderType;\n    /** Routing strategy (Phase 1: only 'default_provider' supported) */\n    strategy?: RoutingStrategy;\n  }) {\n    this.defaultProvider = options.defaultProvider;\n    if (options.strategy) {\n      this.strategy = options.strategy;\n    }\n  }\n\n  /**\n   * Select the provider to use for an operation.\n   *\n   * Phase 1 logic:\n   * - Explicit providerId > defaultProvider\n   *\n   * @param params - Selection parameters\n   * @returns The provider ID to use\n   */\n  selectProvider(params: RouterSelectParams): PerpsProviderType {\n    // Phase 1: explicit providerId always wins\n    if (params.providerId) {\n      return params.providerId;\n    }\n\n    // Fall back to default provider\n    return this.defaultProvider;\n  }\n\n  /**\n   * Get all providers that support a specific market.\n   *\n   * @param symbol - Market symbol (e.g., 'BTC', 'ETH')\n   * @returns Array of provider IDs that support this market\n   */\n  getProvidersForMarket(symbol: string): PerpsProviderType[] {\n    const providers: PerpsProviderType[] = [];\n    this.providerMarkets.forEach((markets, providerId) => {\n      if (markets.has(symbol)) {\n        providers.push(providerId);\n      }\n    });\n    return providers;\n  }\n\n  /**\n   * Update the markets supported by a provider.\n   * Called during provider initialization or market refresh.\n   *\n   * @param providerId - Provider to update\n   * @param markets - Array of market symbols the provider supports\n   */\n  updateProviderMarkets(\n    providerId: PerpsProviderType,\n    markets: string[],\n  ): void {\n    this.providerMarkets.set(providerId, new Set(markets));\n  }\n\n  /**\n   * Clear markets for a provider (e.g., on disconnect).\n   *\n   * @param providerId - Provider to clear\n   */\n  clearProviderMarkets(providerId: PerpsProviderType): void {\n    this.providerMarkets.delete(providerId);\n  }\n\n  /**\n   * Set the default provider for routing.\n   *\n   * @param providerId - New default provider\n   */\n  setDefaultProvider(providerId: PerpsProviderType): void {\n    this.defaultProvider = providerId;\n  }\n\n  /**\n   * Get the current default provider.\n   *\n   * @returns Current default provider ID\n   */\n  getDefaultProvider(): PerpsProviderType {\n    return this.defaultProvider;\n  }\n\n  /**\n   * Get the current routing strategy.\n   *\n   * @returns Current routing strategy\n   */\n  getStrategy(): RoutingStrategy {\n    return this.strategy;\n  }\n\n  /**\n   * Check if a provider supports a specific market.\n   *\n   * @param providerId - Provider to check\n   * @param symbol - Market symbol\n   * @returns true if provider supports the market\n   */\n  providerSupportsMarket(\n    providerId: PerpsProviderType,\n    symbol: string,\n  ): boolean {\n    const markets = this.providerMarkets.get(providerId);\n    return markets?.has(symbol) ?? false;\n  }\n\n  /**\n   * Get all registered provider IDs.\n   *\n   * @returns Array of all provider IDs with registered markets\n   */\n  getRegisteredProviders(): PerpsProviderType[] {\n    return Array.from(this.providerMarkets.keys());\n  }\n}\n"]}

package/dist/routing/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRouter = void 0;
+/**
+ * Provider routing module exports
+ */
+var ProviderRouter_1 = require("./ProviderRouter.cjs");
+Object.defineProperty(exports, "ProviderRouter", { enumerable: true, get: function () { return ProviderRouter_1.ProviderRouter; } });
+//# sourceMappingURL=index.cjs.map

package/dist/routing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,uDAAkD;AAAzC,gHAAA,cAAc,OAAA","sourcesContent":["/**\n * Provider routing module exports\n */\nexport { ProviderRouter } from './ProviderRouter';\nexport type { RouterSelectParams } from './ProviderRouter';\n"]}

package/dist/routing/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Provider routing module exports
+ */
+export { ProviderRouter } from "./ProviderRouter.cjs";
+export type { RouterSelectParams } from "./ProviderRouter.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/routing/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,YAAY,EAAE,kBAAkB,EAAE,6BAAyB"}