@catalyst-team/poly-sdk 0.1.0

package/dist/core/rate-limiter.js

@@ -0,0 +1,70 @@
+/**
+ * Rate Limiter for Polymarket APIs
+ * - Data API: 100ms minimum interval
+ * - Gamma API: 10 req/s
+ * - CLOB API: 10 req/s
+ */
+import Bottleneck from 'bottleneck';
+export var ApiType;
+(function (ApiType) {
+    ApiType["DATA_API"] = "data-api";
+    ApiType["GAMMA_API"] = "gamma-api";
+    ApiType["CLOB_API"] = "clob-api";
+})(ApiType || (ApiType = {}));
+const API_LIMITS = {
+    [ApiType.DATA_API]: {
+        minTime: 100, // 100ms minimum interval
+        maxConcurrent: 5,
+    },
+    [ApiType.GAMMA_API]: {
+        reservoir: 10,
+        reservoirRefreshAmount: 10,
+        reservoirRefreshInterval: 1000,
+    },
+    [ApiType.CLOB_API]: {
+        reservoir: 10,
+        reservoirRefreshAmount: 10,
+        reservoirRefreshInterval: 1000,
+    },
+};
+export class RateLimiter {
+    limiters = new Map();
+    constructor() {
+        for (const [type, config] of Object.entries(API_LIMITS)) {
+            this.limiters.set(type, new Bottleneck(config));
+        }
+    }
+    /**
+     * Execute a function with rate limiting
+     */
+    async execute(api, fn) {
+        const limiter = this.limiters.get(api);
+        if (!limiter)
+            throw new Error(`Unknown API type: ${api}`);
+        return limiter.schedule(fn);
+    }
+    /**
+     * Execute multiple functions in order with rate limiting
+     */
+    async executeBatch(api, fns) {
+        const results = [];
+        for (const fn of fns) {
+            results.push(await this.execute(api, fn));
+        }
+        return results;
+    }
+    /**
+     * Get current limiter statistics
+     */
+    getStats(api) {
+        const limiter = this.limiters.get(api);
+        if (!limiter)
+            return null;
+        const counts = limiter.counts();
+        return {
+            running: counts.RUNNING,
+            queued: counts.QUEUED,
+        };
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/core/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/core/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,MAAM,CAAN,IAAY,OAIX;AAJD,WAAY,OAAO;IACjB,gCAAqB,CAAA;IACrB,kCAAuB,CAAA;IACvB,gCAAqB,CAAA;AACvB,CAAC,EAJW,OAAO,KAAP,OAAO,QAIlB;AAED,MAAM,UAAU,GAAmD;IACjE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAClB,OAAO,EAAE,GAAG,EAAE,yBAAyB;QACvC,aAAa,EAAE,CAAC;KACjB;IACD,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QACnB,SAAS,EAAE,EAAE;QACb,sBAAsB,EAAE,EAAE;QAC1B,wBAAwB,EAAE,IAAI;KAC/B;IACD,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAClB,SAAS,EAAE,EAAE;QACb,sBAAsB,EAAE,EAAE;QAC1B,wBAAwB,EAAE,IAAI;KAC/B;CACF,CAAC;AAEF,MAAM,OAAO,WAAW;IACd,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEvD;QACE,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAe,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAI,GAAY,EAAE,EAAoB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QAC1D,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAI,GAAY,EAAE,GAAyB;QAC3D,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAY;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/core/types.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Common types used across the SDK
+ */
+import type { CacheAdapter } from '@prediction-router/cache';
+/**
+ * SDK Configuration Options
+ *
+ * Allows dependency injection of cache adapters for API response caching.
+ *
+ * @example
+ * ```typescript
+ * import { createMemoryCache } from '@prediction-router/cache';
+ * import { PolymarketSDK } from '@prediction-router/poly-sdk';
+ *
+ * // Use external cache adapter
+ * const cache = createMemoryCache({ defaultTTL: 120 });
+ * const sdk = new PolymarketSDK({ cache });
+ *
+ * // Or use default internal cache
+ * const sdk2 = new PolymarketSDK();
+ * ```
+ */
+export interface PolySDKOptions {
+    /**
+     * Optional external cache adapter for API response caching.
+     * If not provided, the SDK will use its internal memory cache.
+     *
+     * Benefits of external cache:
+     * - Can use Redis for multi-instance cache sharing
+     * - Can configure custom TTL settings
+     * - Can track cache hit/miss statistics
+     */
+    cache?: CacheAdapter;
+    /**
+     * Blockchain chain ID (default: 137 for Polygon mainnet)
+     */
+    chainId?: number;
+    /**
+     * Ethereum signer for trading operations
+     */
+    signer?: unknown;
+    /**
+     * API credentials for trading
+     */
+    creds?: {
+        key: string;
+        secret: string;
+        passphrase: string;
+    };
+}
+export type KLineInterval = '30s' | '1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '12h' | '1d';
+export interface KLineCandle {
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    tradeCount: number;
+    buyVolume: number;
+    sellVolume: number;
+}
+/**
+ * ============================================================================
+ * Spread Analysis Types - Two Different Approaches
+ * ============================================================================
+ *
+ * Polymarket 双代币模型：YES + NO = 1 USDC
+ * 理想状态下，YES_price + NO_price = 1.0
+ * 偏离 1.0 时可能存在套利机会
+ *
+ * 我们提供两种 Spread 分析方式，各有优劣：
+ *
+ * ┌─────────────────────────────────────────────────────────────────────────┐
+ * │  SpreadDataPoint (历史分析)          │  RealtimeSpreadAnalysis (实时分析) │
+ * ├─────────────────────────────────────────────────────────────────────────┤
+ * │  数据源: 成交记录的收盘价              │  数据源: 订单簿的最优 bid/ask      │
+ * │  YES_close + NO_close                │  YES_ask + NO_ask (买入成本)       │
+ * │                                      │  YES_bid + NO_bid (卖出收入)       │
+ * ├─────────────────────────────────────────────────────────────────────────┤
+ * │  ✅ 可构建历史曲线                    │  ❌ 无法构建历史曲线*               │
+ * │  ✅ Polymarket 保留成交历史           │  ❌ Polymarket 不保留盘口历史       │
+ * │  ✅ 适合回测、模式识别                │  ✅ 适合实盘交易、套利执行          │
+ * │  ⚠️ 反映已成交价格，非当前可成交价    │  ✅ 反映当前可立即成交的价格        │
+ * │  ⚠️ 套利信号仅供参考                  │  ✅ 套利利润计算准确                │
+ * └─────────────────────────────────────────────────────────────────────────┘
+ *
+ * * 如需构建实时 Spread 的历史曲线，必须自行存储盘口快照数据
+ *   参考: apps/api/src/services/spread-sampler.ts
+ *
+ * 核心区别说明：
+ *
+ * 1. 成交价 vs 盘口价
+ *    - 成交价 (close): 过去某时刻实际成交的价格
+ *    - 盘口价 (bid/ask): 当前市场上的最优挂单价格
+ *    - 例: YES 最后成交 0.52，但当前 bid=0.50, ask=0.54
+ *
+ * 2. 为什么套利计算用盘口价更准确？
+ *    - 套利需要同时买入 YES 和 NO
+ *    - 必须用 ask 价（卖方挂单）计算买入成本
+ *    - 成交价可能是 bid 方成交，不代表你能以该价买入
+ *
+ * 3. 为什么历史分析只能用成交价？
+ *    - Polymarket CLOB API 不保存历史盘口数据
+ *    - 只有成交记录 (trades) 有历史
+ *    - 除非你自己运行 spread-sampler 持续采样盘口
+ */
+/**
+ * 历史 Spread 分析（基于成交收盘价）
+ *
+ * 用途：
+ * - 历史趋势分析、回测
+ * - 识别价格偏离模式
+ * - 当盘口数据不可用时的替代方案
+ *
+ * 局限：
+ * - priceSpread 仅反映成交价偏离，非实际可套利空间
+ * - arbOpportunity 仅为参考信号，实际套利需查看盘口
+ *
+ * 数据来源：Polymarket Data API /trades 历史成交记录
+ */
+export interface SpreadDataPoint {
+    timestamp: number;
+    yesPrice: number;
+    noPrice: number;
+    priceSum: number;
+    priceSpread: number;
+    arbOpportunity: 'LONG' | 'SHORT' | '';
+}
+/**
+ * 实时 Spread 分析（基于订单簿 bid/ask）
+ *
+ * 用途：
+ * - 实盘套利决策
+ * - 精确计算套利利润
+ * - 监控当前市场状态
+ *
+ * 局限：
+ * - ❌ 无法构建历史曲线 - Polymarket 不保存盘口历史
+ * - 如需历史数据，必须自行运行采样服务持续存储盘口快照
+ *   参考实现: apps/api/src/services/spread-sampler.ts
+ *
+ * 数据来源：Polymarket CLOB API /book 实时订单簿
+ *
+ * 套利逻辑：
+ * - Long Arb (多头套利): askSum < 1 时，买入 YES + NO 成本 < 1 USDC
+ *   利润 = 1 - askSum，因为最终一方会 resolve 为 1 USDC
+ *
+ * - Short Arb (空头套利): bidSum > 1 时，卖出 YES + NO 收入 > 1 USDC
+ *   利润 = bidSum - 1，需要先铸造代币对（成本 1 USDC）
+ */
+export interface RealtimeSpreadAnalysis {
+    timestamp: number;
+    yesBid: number;
+    yesAsk: number;
+    noBid: number;
+    noAsk: number;
+    askSum: number;
+    bidSum: number;
+    askSpread: number;
+    bidSpread: number;
+    longArbProfit: number;
+    shortArbProfit: number;
+    arbOpportunity: 'LONG' | 'SHORT' | '';
+    arbProfitPercent: number;
+}
+/**
+ * 双代币 K 线数据（YES + NO）
+ *
+ * 包含两种 Spread 分析：
+ * - spreadAnalysis: 历史曲线（基于成交价），可回溯
+ * - realtimeSpread: 实时快照（基于盘口），仅当前时刻
+ */
+export interface DualKLineData {
+    conditionId: string;
+    interval: KLineInterval;
+    market?: UnifiedMarket;
+    yes: KLineCandle[];
+    no: KLineCandle[];
+    /**
+     * 历史 Spread 分析（SpreadDataPoint[]）
+     *
+     * ✅ 可构建历史曲线 - 每个 K 线周期一个数据点
+     * ⚠️ 基于成交价，套利信号仅供参考
+     *
+     * 用于：图表展示、趋势分析、回测
+     */
+    spreadAnalysis?: SpreadDataPoint[];
+    /**
+     * 实时 Spread 分析（RealtimeSpreadAnalysis）
+     *
+     * ✅ 套利计算准确 - 基于当前盘口 bid/ask
+     * ❌ 仅当前时刻快照，无法构建历史曲线
+     *
+     * 如需实时 Spread 历史曲线，必须：
+     * 1. 运行 spread-sampler 服务持续采样盘口
+     * 2. 将快照存储到数据库
+     * 3. 从数据库读取构建曲线
+     *
+     * 用于：实盘套利决策、当前市场状态展示
+     */
+    realtimeSpread?: RealtimeSpreadAnalysis;
+    /** 完整订单簿数据（如需更多细节） */
+    currentOrderbook?: ProcessedOrderbook;
+}
+/**
+ * 有效价格（考虑镜像订单）
+ *
+ * Polymarket 的关键特性：买 YES @ P = 卖 NO @ (1-P)
+ * 因此同一订单会在两个订单簿中出现
+ *
+ * 有效价格是考虑镜像后的最优价格：
+ * - effectiveBuyYes = min(YES.ask, 1 - NO.bid)
+ * - effectiveBuyNo = min(NO.ask, 1 - YES.bid)
+ * - effectiveSellYes = max(YES.bid, 1 - NO.ask)
+ * - effectiveSellNo = max(NO.bid, 1 - YES.ask)
+ */
+export interface EffectivePrices {
+    effectiveBuyYes: number;
+    effectiveBuyNo: number;
+    effectiveSellYes: number;
+    effectiveSellNo: number;
+}
+export interface ProcessedOrderbook {
+    yes: {
+        bid: number;
+        ask: number;
+        bidSize: number;
+        askSize: number;
+        bidDepth: number;
+        askDepth: number;
+        spread: number;
+        tokenId?: string;
+    };
+    no: {
+        bid: number;
+        ask: number;
+        bidSize: number;
+        askSize: number;
+        bidDepth: number;
+        askDepth: number;
+        spread: number;
+        tokenId?: string;
+    };
+    summary: {
+        askSum: number;
+        bidSum: number;
+        effectivePrices: EffectivePrices;
+        effectiveLongCost: number;
+        effectiveShortRevenue: number;
+        longArbProfit: number;
+        shortArbProfit: number;
+        totalBidDepth: number;
+        totalAskDepth: number;
+        imbalanceRatio: number;
+        yesSpread: number;
+    };
+}
+export interface ArbitrageOpportunity {
+    type: 'long' | 'short';
+    profit: number;
+    action: string;
+    expectedProfit: number;
+}
+export interface PriceUpdate {
+    assetId: string;
+    price: number;
+    midpoint: number;
+    spread: number;
+    timestamp: number;
+}
+export interface BookUpdate {
+    assetId: string;
+    bids: Array<{
+        price: number;
+        size: number;
+    }>;
+    asks: Array<{
+        price: number;
+        size: number;
+    }>;
+    timestamp: number;
+}
+export interface UnifiedMarket {
+    conditionId: string;
+    slug: string;
+    question: string;
+    description?: string;
+    tokens: {
+        yes: {
+            tokenId: string;
+            price: number;
+        };
+        no: {
+            tokenId: string;
+            price: number;
+        };
+    };
+    volume: number;
+    volume24hr?: number;
+    liquidity: number;
+    spread?: number;
+    /** 1-day price change (from Gamma API) */
+    oneDayPriceChange?: number;
+    /** 1-week price change (from Gamma API) */
+    oneWeekPriceChange?: number;
+    active: boolean;
+    closed: boolean;
+    acceptingOrders: boolean;
+    endDate: Date;
+    source: 'gamma' | 'clob' | 'merged';
+}
+export declare function getIntervalMs(interval: KLineInterval): number;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,19 @@
+/**
+ * Common types used across the SDK
+ */
+// Helper to convert interval to milliseconds
+export function getIntervalMs(interval) {
+    const map = {
+        '30s': 30 * 1000,
+        '1m': 60 * 1000,
+        '5m': 5 * 60 * 1000,
+        '15m': 15 * 60 * 1000,
+        '30m': 30 * 60 * 1000,
+        '1h': 60 * 60 * 1000,
+        '4h': 4 * 60 * 60 * 1000,
+        '12h': 12 * 60 * 60 * 1000,
+        '1d': 24 * 60 * 60 * 1000,
+    };
+    return map[interval];
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuVH,6CAA6C;AAC7C,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,MAAM,GAAG,GAAkC;QACzC,KAAK,EAAE,EAAE,GAAG,IAAI;QAChB,IAAI,EAAE,EAAE,GAAG,IAAI;QACf,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QACnB,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACrB,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACrB,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACpB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QACxB,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QAC1B,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;KAC1B,CAAC;IACF,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC;AACvB,CAAC"}

package/dist/core/unified-cache.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Unified cache interface for poly-sdk
+ *
+ * Bridges between:
+ * 1. Legacy internal Cache (synchronous get/set with millisecond TTL)
+ * 2. New CacheAdapter interface (async with second TTL)
+ *
+ * This allows the SDK to accept external cache adapters while maintaining
+ * backward compatibility with existing code.
+ */
+import type { CacheAdapter } from '@prediction-router/cache';
+import { Cache, CACHE_TTL } from './cache.js';
+/**
+ * Unified cache interface that works with both legacy Cache and CacheAdapter
+ *
+ * Key features:
+ * - Async API (compatible with CacheAdapter)
+ * - Millisecond TTL (compatible with existing SDK code)
+ * - getOrSet helper for cache-aside pattern
+ */
+export interface UnifiedCache {
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    getOrSet<T>(key: string, ttlMs: number, factory: () => Promise<T>): Promise<T>;
+    invalidate(pattern: string): Promise<void>;
+    clear(): void;
+}
+/**
+ * Wraps the legacy Cache class to provide async interface
+ */
+export declare class LegacyCacheWrapper implements UnifiedCache {
+    private cache;
+    constructor(cache: Cache);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    getOrSet<T>(key: string, ttlMs: number, factory: () => Promise<T>): Promise<T>;
+    invalidate(pattern: string): Promise<void>;
+    clear(): void;
+}
+/**
+ * Wraps a CacheAdapter to provide legacy-compatible interface
+ *
+ * Main differences:
+ * - Converts milliseconds to seconds for TTL
+ * - Returns undefined instead of null for missing keys
+ * - Implements getOrSet helper
+ * - Implements pattern-based invalidation (limited support)
+ */
+export declare class CacheAdapterWrapper implements UnifiedCache {
+    private adapter;
+    constructor(adapter: CacheAdapter);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    getOrSet<T>(key: string, ttlMs: number, factory: () => Promise<T>): Promise<T>;
+    invalidate(pattern: string): Promise<void>;
+    clear(): void;
+}
+/**
+ * Create a UnifiedCache from either legacy Cache or CacheAdapter
+ */
+export declare function createUnifiedCache(cache?: CacheAdapter | Cache): UnifiedCache;
+export { CACHE_TTL };
+//# sourceMappingURL=unified-cache.d.ts.map

package/dist/core/unified-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-cache.d.ts","sourceRoot":"","sources":["../../src/core/unified-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACzC,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAE1B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAI3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,QAAQ,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAIP,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IAC1C,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAEnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAK3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D,QAAQ,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAkBP,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,YAAY,GAAG,KAAK,GAC3B,YAAY,CAiBd;AAGD,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/core/unified-cache.js

@@ -0,0 +1,114 @@
+/**
+ * Unified cache interface for poly-sdk
+ *
+ * Bridges between:
+ * 1. Legacy internal Cache (synchronous get/set with millisecond TTL)
+ * 2. New CacheAdapter interface (async with second TTL)
+ *
+ * This allows the SDK to accept external cache adapters while maintaining
+ * backward compatibility with existing code.
+ */
+import { Cache, CACHE_TTL } from './cache.js';
+/**
+ * Wraps the legacy Cache class to provide async interface
+ */
+export class LegacyCacheWrapper {
+    cache;
+    constructor(cache) {
+        this.cache = cache;
+    }
+    async get(key) {
+        return this.cache.get(key);
+    }
+    async set(key, value, ttlMs) {
+        this.cache.set(key, value, ttlMs);
+    }
+    async getOrSet(key, ttlMs, factory) {
+        return this.cache.getOrSet(key, ttlMs, factory);
+    }
+    async invalidate(pattern) {
+        this.cache.invalidate(pattern);
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
+/**
+ * Wraps a CacheAdapter to provide legacy-compatible interface
+ *
+ * Main differences:
+ * - Converts milliseconds to seconds for TTL
+ * - Returns undefined instead of null for missing keys
+ * - Implements getOrSet helper
+ * - Implements pattern-based invalidation (limited support)
+ */
+export class CacheAdapterWrapper {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async get(key) {
+        const value = await this.adapter.get(key);
+        return value ?? undefined;
+    }
+    async set(key, value, ttlMs) {
+        // Convert milliseconds to seconds
+        const ttlSeconds = Math.ceil(ttlMs / 1000);
+        // Check if this is a CacheManager (has getStats method)
+        if ('getStats' in this.adapter) {
+            // This is a CacheManager - use CacheSetOptions signature
+            await this.adapter.set(key, value, { ttl: ttlSeconds });
+        }
+        else {
+            // This is a regular CacheAdapter - use simple signature
+            await this.adapter.set(key, value, ttlSeconds);
+        }
+    }
+    async getOrSet(key, ttlMs, factory) {
+        const cached = await this.adapter.get(key);
+        if (cached !== null)
+            return cached;
+        const value = await factory();
+        const ttlSeconds = Math.ceil(ttlMs / 1000);
+        // Check if this is a CacheManager
+        if ('getStats' in this.adapter) {
+            // This is a CacheManager
+            await this.adapter.set(key, value, { ttl: ttlSeconds });
+        }
+        else {
+            // This is a regular CacheAdapter
+            await this.adapter.set(key, value, ttlSeconds);
+        }
+        return value;
+    }
+    async invalidate(pattern) {
+        // CacheAdapter doesn't have pattern matching
+        // Best we can do is warn - this is a limitation
+        console.warn(`invalidate(pattern="${pattern}") not fully supported with external cache adapter`);
+    }
+    clear() {
+        void this.adapter.clear?.();
+    }
+}
+/**
+ * Create a UnifiedCache from either legacy Cache or CacheAdapter
+ */
+export function createUnifiedCache(cache) {
+    if (!cache) {
+        // No cache provided, create default legacy cache
+        return new LegacyCacheWrapper(new Cache());
+    }
+    // Check if it's a CacheAdapter (has async get method)
+    if ('get' in cache && typeof cache.get === 'function') {
+        const testResult = cache.get('test');
+        if (testResult instanceof Promise) {
+            // It's a CacheAdapter
+            return new CacheAdapterWrapper(cache);
+        }
+    }
+    // It's a legacy Cache
+    return new LegacyCacheWrapper(cache);
+}
+// Re-export CACHE_TTL for convenience
+export { CACHE_TTL };
+//# sourceMappingURL=unified-cache.js.map

package/dist/core/unified-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-cache.js","sourceRoot":"","sources":["../../src/core/unified-cache.ts"],"names":[],"mappings":"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"}