@catalyst-team/poly-sdk 0.2.0 → 0.2.1

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/{src/core/types.ts → dist/core/types.d.ts}

@@ -1,9 +1,7 @@
 /**
  * Common types used across the SDK
  */
-
 import type { CacheAdapter } from '@catalyst-team/cache';
-
 /**
  * SDK Configuration Options
  *
@@ -23,53 +21,45 @@ import type { CacheAdapter } from '@catalyst-team/cache';
  * ```
  */
 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;
-  };
+    /**
+     * 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;
+    };
 }
-
-// K-Line interval types
 export type KLineInterval = '30s' | '1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '12h' | '1d';
-
-// K-Line candle data
 export interface KLineCandle {
-  timestamp: number;
-  open: number;
-  high: number;
-  low: number;
-  close: number;
-  volume: number;
-  tradeCount: number;
-  buyVolume: number;
-  sellVolume: number;
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    tradeCount: number;
+    buyVolume: number;
+    sellVolume: number;
 }
-
 /**
  * ============================================================================
  * Spread Analysis Types - Two Different Approaches
@@ -115,7 +105,6 @@ export interface KLineCandle {
  *    - 只有成交记录 (trades) 有历史
  *    - 除非你自己运行 spread-sampler 持续采样盘口
  */
-
 /**
  * 历史 Spread 分析（基于成交收盘价）
  *
@@ -131,14 +120,13 @@ export interface KLineCandle {
  * 数据来源：Polymarket Data API /trades 历史成交记录
  */
 export interface SpreadDataPoint {
-  timestamp: number;
-  yesPrice: number;      // YES 收盘价 (来自成交记录)
-  noPrice: number;       // NO 收盘价 (来自成交记录)
-  priceSum: number;      // YES + NO 收盘价之和
-  priceSpread: number;   // priceSum - 1 (偏离均衡的程度)
-  arbOpportunity: 'LONG' | 'SHORT' | '';  // 基于价格偏离的参考信号
+    timestamp: number;
+    yesPrice: number;
+    noPrice: number;
+    priceSum: number;
+    priceSpread: number;
+    arbOpportunity: 'LONG' | 'SHORT' | '';
 }
-
 /**
  * 实时 Spread 分析（基于订单簿 bid/ask）
  *
@@ -162,27 +150,20 @@ export interface SpreadDataPoint {
  *   利润 = bidSum - 1，需要先铸造代币对（成本 1 USDC）
  */
 export interface RealtimeSpreadAnalysis {
-  timestamp: number;
-
-  // ===== 订单簿价格 =====
-  yesBid: number;        // YES 最优买价 (你能卖出的价格)
-  yesAsk: number;        // YES 最优卖价 (你能买入的价格)
-  noBid: number;         // NO 最优买价
-  noAsk: number;         // NO 最优卖价
-
-  // ===== Spread 指标 =====
-  askSum: number;        // YES_ask + NO_ask = 买入双边的总成本
-  bidSum: number;        // YES_bid + NO_bid = 卖出双边的总收入
-  askSpread: number;     // askSum - 1 (负值 = 多头套利空间)
-  bidSpread: number;     // bidSum - 1 (正值 = 空头套利空间)
-
-  // ===== 套利分析 =====
-  longArbProfit: number;   // 1 - askSum，> 0 表示多头套利机会
-  shortArbProfit: number;  // bidSum - 1，> 0 表示空头套利机会
-  arbOpportunity: 'LONG' | 'SHORT' | '';  // 当前套利方向
-  arbProfitPercent: number;  // 套利利润百分比
+    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）
  *
@@ -191,41 +172,37 @@ export interface RealtimeSpreadAnalysis {
  * - realtimeSpread: 实时快照（基于盘口），仅当前时刻
  */
 export interface DualKLineData {
-  conditionId: string;
-  interval: KLineInterval;
-  market?: UnifiedMarket;
-  yes: KLineCandle[];    // YES 代币 K 线
-  no: KLineCandle[];     // NO 代币 K 线
-
-  /**
-   * 历史 Spread 分析（SpreadDataPoint[]）
-   *
-   * ✅ 可构建历史曲线 - 每个 K 线周期一个数据点
-   * ⚠️ 基于成交价，套利信号仅供参考
-   *
-   * 用于：图表展示、趋势分析、回测
-   */
-  spreadAnalysis?: SpreadDataPoint[];
-
-  /**
-   * 实时 Spread 分析（RealtimeSpreadAnalysis）
-   *
-   * ✅ 套利计算准确 - 基于当前盘口 bid/ask
-   * ❌ 仅当前时刻快照，无法构建历史曲线
-   *
-   * 如需实时 Spread 历史曲线，必须：
-   * 1. 运行 spread-sampler 服务持续采样盘口
-   * 2. 将快照存储到数据库
-   * 3. 从数据库读取构建曲线
-   *
-   * 用于：实盘套利决策、当前市场状态展示
-   */
-  realtimeSpread?: RealtimeSpreadAnalysis;
-
-  /** 完整订单簿数据（如需更多细节） */
-  currentOrderbook?: ProcessedOrderbook;
+    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;
 }
-
 /**
  * 有效价格（考虑镜像订单）
  *
@@ -239,122 +216,99 @@ export interface DualKLineData {
  * - effectiveSellNo = max(NO.bid, 1 - YES.ask)
  */
 export interface EffectivePrices {
-  effectiveBuyYes: number;   // 买 YES 的最低成本
-  effectiveBuyNo: number;    // 买 NO 的最低成本
-  effectiveSellYes: number;  // 卖 YES 的最高收入
-  effectiveSellNo: number;   // 卖 NO 的最高收入
+    effectiveBuyYes: number;
+    effectiveBuyNo: number;
+    effectiveSellYes: number;
+    effectiveSellNo: number;
 }
-
-// Processed orderbook with analysis
 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;   // effectiveBuyYes + effectiveBuyNo
-    effectiveShortRevenue: number; // effectiveSellYes + effectiveSellNo
-
-    // 套利利润（基于有效价格）
-    longArbProfit: number;   // 1 - effectiveLongCost，> 0 = 有套利
-    shortArbProfit: number;  // effectiveShortRevenue - 1，> 0 = 有套利
-
-    // 其他指标
-    totalBidDepth: number;
-    totalAskDepth: number;
-    imbalanceRatio: number;
-
-    // YES token 的 spread（由于镜像，这也反映了 NO 的情况）
-    yesSpread: number;
-  };
+    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;
+    };
 }
-
-// Arbitrage opportunity
 export interface ArbitrageOpportunity {
-  type: 'long' | 'short';
-  profit: number;
-  action: string;
-  expectedProfit: number;
+    type: 'long' | 'short';
+    profit: number;
+    action: string;
+    expectedProfit: number;
 }
-
-// Price update from WebSocket
 export interface PriceUpdate {
-  assetId: string;
-  price: number;
-  midpoint: number;
-  spread: number;
-  timestamp: number;
+    assetId: string;
+    price: number;
+    midpoint: number;
+    spread: number;
+    timestamp: number;
 }
-
-// Book update from WebSocket
 export interface BookUpdate {
-  assetId: string;
-  bids: Array<{ price: number; size: number }>;
-  asks: Array<{ price: number; size: number }>;
-  timestamp: number;
+    assetId: string;
+    bids: Array<{
+        price: number;
+        size: number;
+    }>;
+    asks: Array<{
+        price: number;
+        size: number;
+    }>;
+    timestamp: number;
 }
-
-// Unified market type (merged from Gamma and CLOB)
 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';
-}
-
-// Helper to convert interval to milliseconds
-export function getIntervalMs(interval: KLineInterval): number {
-  const map: Record<KLineInterval, number> = {
-    '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];
+    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 '@catalyst-team/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,sBAAsB,CAAC;AACzD,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"}