@alleyboss/micropay-solana-x402-paywall 1.0.1 → 2.0.1

package/dist/pricing/index.cjs

@@ -0,0 +1,142 @@
+'use strict';
+
+// src/pricing/index.ts
+var cachedPrice = null;
+var config = {};
+var lastProviderIndex = -1;
+function configurePricing(newConfig) {
+  config = { ...config, ...newConfig };
+  cachedPrice = null;
+}
+var PROVIDERS = [
+  {
+    name: "coincap",
+    url: "https://api.coincap.io/v2/assets/solana",
+    parse: (data) => parseFloat(data.data?.priceUsd || "0")
+  },
+  {
+    name: "binance",
+    url: "https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT",
+    parse: (data) => parseFloat(data.price || "0")
+  },
+  {
+    name: "coingecko",
+    url: "https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd",
+    parse: (data) => data.solana?.usd || 0
+  },
+  {
+    name: "kraken",
+    url: "https://api.kraken.com/0/public/Ticker?pair=SOLUSD",
+    parse: (data) => parseFloat(data.result?.SOLUSD?.c?.[0] || "0")
+  }
+];
+async function fetchFromProvider(provider, timeout) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(provider.url, {
+      headers: { "Accept": "application/json" },
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    const price = provider.parse(data);
+    if (!price || price <= 0) {
+      throw new Error("Invalid price");
+    }
+    return price;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+async function getSolPrice() {
+  const cacheTTL = config.cacheTTL ?? 6e4;
+  const timeout = config.timeout ?? 5e3;
+  if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {
+    return cachedPrice;
+  }
+  if (config.customProvider) {
+    try {
+      const price = await config.customProvider();
+      if (price > 0) {
+        cachedPrice = {
+          solPrice: price,
+          fetchedAt: /* @__PURE__ */ new Date(),
+          source: "custom"
+        };
+        return cachedPrice;
+      }
+    } catch {
+    }
+  }
+  for (let i = 0; i < PROVIDERS.length; i++) {
+    const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;
+    const provider = PROVIDERS[idx];
+    try {
+      const price = await fetchFromProvider(provider, timeout);
+      lastProviderIndex = idx;
+      cachedPrice = {
+        solPrice: price,
+        fetchedAt: /* @__PURE__ */ new Date(),
+        source: provider.name
+      };
+      return cachedPrice;
+    } catch {
+      continue;
+    }
+  }
+  if (cachedPrice) {
+    return cachedPrice;
+  }
+  return {
+    solPrice: 150,
+    // Reasonable fallback
+    fetchedAt: /* @__PURE__ */ new Date(),
+    source: "fallback"
+  };
+}
+async function lamportsToUsd(lamports) {
+  const { solPrice } = await getSolPrice();
+  const sol = Number(lamports) / 1e9;
+  return sol * solPrice;
+}
+async function usdToLamports(usd) {
+  const { solPrice } = await getSolPrice();
+  const sol = usd / solPrice;
+  return BigInt(Math.floor(sol * 1e9));
+}
+async function formatPriceDisplay(lamports) {
+  const { solPrice } = await getSolPrice();
+  const sol = Number(lamports) / 1e9;
+  const usd = sol * solPrice;
+  return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;
+}
+function formatPriceSync(lamports, solPrice) {
+  const sol = Number(lamports) / 1e9;
+  const usd = sol * solPrice;
+  return {
+    sol,
+    usd,
+    formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`
+  };
+}
+function clearPriceCache() {
+  cachedPrice = null;
+  lastProviderIndex = -1;
+}
+function getProviders() {
+  return PROVIDERS.map((p) => ({ name: p.name, url: p.url }));
+}
+
+exports.clearPriceCache = clearPriceCache;
+exports.configurePricing = configurePricing;
+exports.formatPriceDisplay = formatPriceDisplay;
+exports.formatPriceSync = formatPriceSync;
+exports.getProviders = getProviders;
+exports.getSolPrice = getSolPrice;
+exports.lamportsToUsd = lamportsToUsd;
+exports.usdToLamports = usdToLamports;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/pricing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pricing/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Price Conversion Helpers\n// Multi-provider SOL price fetching with fallback rotation\n\n/**\n * Price data from API\n */\nexport interface PriceData {\n    /** SOL price in USD */\n    solPrice: number;\n    /** Timestamp of price fetch */\n    fetchedAt: Date;\n    /** Source of price data */\n    source: string;\n}\n\n/**\n * Custom price provider function type\n */\nexport type CustomPriceProvider = () => Promise<number>;\n\n/**\n * Price provider configuration\n */\nexport interface PriceConfig {\n    /** Custom price provider (if set, skips built-in providers) */\n    customProvider?: CustomPriceProvider;\n    /** Cache TTL in milliseconds (default: 60000) */\n    cacheTTL?: number;\n    /** Request timeout in milliseconds (default: 5000) */\n    timeout?: number;\n}\n\n// Cached price data\nlet cachedPrice: PriceData | null = null;\nlet config: PriceConfig = {};\nlet lastProviderIndex = -1;\n\n/**\n * Configure price fetching\n * \n * @example\n * ```typescript\n * // Use custom API\n * configurePricing({\n *   customProvider: async () => {\n *     const res = await fetch('https://my-api.com/sol-price');\n *     return (await res.json()).price;\n *   },\n * });\n * \n * // Or just adjust cache TTL\n * configurePricing({ cacheTTL: 30000 }); // 30 seconds\n * ```\n */\nexport function configurePricing(newConfig: PriceConfig): void {\n    config = { ...config, ...newConfig };\n    cachedPrice = null; // Clear cache on config change\n}\n\n/**\n * Built-in price providers with reliability rotation\n */\nconst PROVIDERS = [\n    {\n        name: 'coincap',\n        url: 'https://api.coincap.io/v2/assets/solana',\n        parse: (data: { data?: { priceUsd?: string } }) => parseFloat(data.data?.priceUsd || '0'),\n    },\n    {\n        name: 'binance',\n        url: 'https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT',\n        parse: (data: { price?: string }) => parseFloat(data.price || '0'),\n    },\n    {\n        name: 'coingecko',\n        url: 'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd',\n        parse: (data: { solana?: { usd?: number } }) => data.solana?.usd || 0,\n    },\n    {\n        name: 'kraken',\n        url: 'https://api.kraken.com/0/public/Ticker?pair=SOLUSD',\n        parse: (data: { result?: { SOLUSD?: { c?: string[] } } }) =>\n            parseFloat(data.result?.SOLUSD?.c?.[0] || '0'),\n    },\n];\n\n/**\n * Fetch price from a single provider\n */\nasync function fetchFromProvider(\n    provider: typeof PROVIDERS[0],\n    timeout: number\n): Promise<number> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    try {\n        const response = await fetch(provider.url, {\n            headers: { 'Accept': 'application/json' },\n            signal: controller.signal,\n        });\n\n        if (!response.ok) {\n            throw new Error(`HTTP ${response.status}`);\n        }\n\n        const data = await response.json() as Record<string, unknown>;\n        const price = provider.parse(data as Parameters<typeof provider.parse>[0]);\n\n        if (!price || price <= 0) {\n            throw new Error('Invalid price');\n        }\n\n        return price;\n    } finally {\n        clearTimeout(timeoutId);\n    }\n}\n\n/**\n * Get SOL price with multi-provider fallback\n * \n * Provider rotation order:\n * 1. CoinCap (primary)\n * 2. Binance (backup #1)\n * 3. CoinGecko (backup #2)\n * 4. Kraken (backup #3)\n * \n * @example\n * ```typescript\n * const { solPrice, source } = await getSolPrice();\n * console.log(`SOL is $${solPrice} (from ${source})`);\n * ```\n */\nexport async function getSolPrice(): Promise<PriceData> {\n    const cacheTTL = config.cacheTTL ?? 60000;\n    const timeout = config.timeout ?? 5000;\n\n    // Return cached price if valid\n    if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {\n        return cachedPrice;\n    }\n\n    // Try custom provider first if configured\n    if (config.customProvider) {\n        try {\n            const price = await config.customProvider();\n            if (price > 0) {\n                cachedPrice = {\n                    solPrice: price,\n                    fetchedAt: new Date(),\n                    source: 'custom',\n                };\n                return cachedPrice;\n            }\n        } catch {\n            // Fall through to built-in providers\n        }\n    }\n\n    // Try providers in rotation, starting after the last successful one\n    for (let i = 0; i < PROVIDERS.length; i++) {\n        const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;\n        const provider = PROVIDERS[idx];\n\n        try {\n            const price = await fetchFromProvider(provider, timeout);\n            lastProviderIndex = idx;\n\n            cachedPrice = {\n                solPrice: price,\n                fetchedAt: new Date(),\n                source: provider.name,\n            };\n            return cachedPrice;\n        } catch {\n            // Try next provider\n            continue;\n        }\n    }\n\n    // All providers failed, use stale cache or fallback\n    if (cachedPrice) {\n        return cachedPrice;\n    }\n\n    // Last resort fallback\n    return {\n        solPrice: 150, // Reasonable fallback\n        fetchedAt: new Date(),\n        source: 'fallback',\n    };\n}\n\n/**\n * Convert lamports to USD\n * \n * @example\n * ```typescript\n * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL\n * console.log(`$${usd.toFixed(2)}`);\n * ```\n */\nexport async function lamportsToUsd(lamports: bigint): Promise<number> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    return sol * solPrice;\n}\n\n/**\n * Convert USD to lamports\n * \n * @example\n * ```typescript\n * const lamports = await usdToLamports(1.50); // $1.50\n * console.log(`${lamports} lamports`);\n * ```\n */\nexport async function usdToLamports(usd: number): Promise<bigint> {\n    const { solPrice } = await getSolPrice();\n    const sol = usd / solPrice;\n    return BigInt(Math.floor(sol * 1_000_000_000));\n}\n\n/**\n * Format a price for display with both SOL and USD\n * \n * @example\n * ```typescript\n * const display = await formatPriceDisplay(10_000_000n);\n * // Returns: \"0.0100 SOL (~$1.50)\"\n * ```\n */\nexport async function formatPriceDisplay(lamports: bigint): Promise<string> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;\n}\n\n/**\n * Synchronous price formatting (requires pre-fetched price)\n */\nexport function formatPriceSync(lamports: bigint, solPrice: number): {\n    sol: number;\n    usd: number;\n    formatted: string;\n} {\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return {\n        sol,\n        usd,\n        formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`,\n    };\n}\n\n/**\n * Clear the price cache (for testing or manual refresh)\n */\nexport function clearPriceCache(): void {\n    cachedPrice = null;\n    lastProviderIndex = -1;\n}\n\n/**\n * Get list of available built-in providers\n */\nexport function getProviders(): { name: string; url: string }[] {\n    return PROVIDERS.map(p => ({ name: p.name, url: p.url }));\n}\n"]}

package/dist/pricing/index.d.cts

@@ -0,0 +1,111 @@
+/**
+ * Price data from API
+ */
+interface PriceData {
+    /** SOL price in USD */
+    solPrice: number;
+    /** Timestamp of price fetch */
+    fetchedAt: Date;
+    /** Source of price data */
+    source: string;
+}
+/**
+ * Custom price provider function type
+ */
+type CustomPriceProvider = () => Promise<number>;
+/**
+ * Price provider configuration
+ */
+interface PriceConfig {
+    /** Custom price provider (if set, skips built-in providers) */
+    customProvider?: CustomPriceProvider;
+    /** Cache TTL in milliseconds (default: 60000) */
+    cacheTTL?: number;
+    /** Request timeout in milliseconds (default: 5000) */
+    timeout?: number;
+}
+/**
+ * Configure price fetching
+ *
+ * @example
+ * ```typescript
+ * // Use custom API
+ * configurePricing({
+ *   customProvider: async () => {
+ *     const res = await fetch('https://my-api.com/sol-price');
+ *     return (await res.json()).price;
+ *   },
+ * });
+ *
+ * // Or just adjust cache TTL
+ * configurePricing({ cacheTTL: 30000 }); // 30 seconds
+ * ```
+ */
+declare function configurePricing(newConfig: PriceConfig): void;
+/**
+ * Get SOL price with multi-provider fallback
+ *
+ * Provider rotation order:
+ * 1. CoinCap (primary)
+ * 2. Binance (backup #1)
+ * 3. CoinGecko (backup #2)
+ * 4. Kraken (backup #3)
+ *
+ * @example
+ * ```typescript
+ * const { solPrice, source } = await getSolPrice();
+ * console.log(`SOL is $${solPrice} (from ${source})`);
+ * ```
+ */
+declare function getSolPrice(): Promise<PriceData>;
+/**
+ * Convert lamports to USD
+ *
+ * @example
+ * ```typescript
+ * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL
+ * console.log(`$${usd.toFixed(2)}`);
+ * ```
+ */
+declare function lamportsToUsd(lamports: bigint): Promise<number>;
+/**
+ * Convert USD to lamports
+ *
+ * @example
+ * ```typescript
+ * const lamports = await usdToLamports(1.50); // $1.50
+ * console.log(`${lamports} lamports`);
+ * ```
+ */
+declare function usdToLamports(usd: number): Promise<bigint>;
+/**
+ * Format a price for display with both SOL and USD
+ *
+ * @example
+ * ```typescript
+ * const display = await formatPriceDisplay(10_000_000n);
+ * // Returns: "0.0100 SOL (~$1.50)"
+ * ```
+ */
+declare function formatPriceDisplay(lamports: bigint): Promise<string>;
+/**
+ * Synchronous price formatting (requires pre-fetched price)
+ */
+declare function formatPriceSync(lamports: bigint, solPrice: number): {
+    sol: number;
+    usd: number;
+    formatted: string;
+};
+/**
+ * Clear the price cache (for testing or manual refresh)
+ */
+declare function clearPriceCache(): void;
+/**
+ * Get list of available built-in providers
+ */
+declare function getProviders(): {
+    name: string;
+    url: string;
+}[];
+
+export { type CustomPriceProvider, type PriceConfig, type PriceData, clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports };

package/dist/pricing/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Price data from API
+ */
+interface PriceData {
+    /** SOL price in USD */
+    solPrice: number;
+    /** Timestamp of price fetch */
+    fetchedAt: Date;
+    /** Source of price data */
+    source: string;
+}
+/**
+ * Custom price provider function type
+ */
+type CustomPriceProvider = () => Promise<number>;
+/**
+ * Price provider configuration
+ */
+interface PriceConfig {
+    /** Custom price provider (if set, skips built-in providers) */
+    customProvider?: CustomPriceProvider;
+    /** Cache TTL in milliseconds (default: 60000) */
+    cacheTTL?: number;
+    /** Request timeout in milliseconds (default: 5000) */
+    timeout?: number;
+}
+/**
+ * Configure price fetching
+ *
+ * @example
+ * ```typescript
+ * // Use custom API
+ * configurePricing({
+ *   customProvider: async () => {
+ *     const res = await fetch('https://my-api.com/sol-price');
+ *     return (await res.json()).price;
+ *   },
+ * });
+ *
+ * // Or just adjust cache TTL
+ * configurePricing({ cacheTTL: 30000 }); // 30 seconds
+ * ```
+ */
+declare function configurePricing(newConfig: PriceConfig): void;
+/**
+ * Get SOL price with multi-provider fallback
+ *
+ * Provider rotation order:
+ * 1. CoinCap (primary)
+ * 2. Binance (backup #1)
+ * 3. CoinGecko (backup #2)
+ * 4. Kraken (backup #3)
+ *
+ * @example
+ * ```typescript
+ * const { solPrice, source } = await getSolPrice();
+ * console.log(`SOL is $${solPrice} (from ${source})`);
+ * ```
+ */
+declare function getSolPrice(): Promise<PriceData>;
+/**
+ * Convert lamports to USD
+ *
+ * @example
+ * ```typescript
+ * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL
+ * console.log(`$${usd.toFixed(2)}`);
+ * ```
+ */
+declare function lamportsToUsd(lamports: bigint): Promise<number>;
+/**
+ * Convert USD to lamports
+ *
+ * @example
+ * ```typescript
+ * const lamports = await usdToLamports(1.50); // $1.50
+ * console.log(`${lamports} lamports`);
+ * ```
+ */
+declare function usdToLamports(usd: number): Promise<bigint>;
+/**
+ * Format a price for display with both SOL and USD
+ *
+ * @example
+ * ```typescript
+ * const display = await formatPriceDisplay(10_000_000n);
+ * // Returns: "0.0100 SOL (~$1.50)"
+ * ```
+ */
+declare function formatPriceDisplay(lamports: bigint): Promise<string>;
+/**
+ * Synchronous price formatting (requires pre-fetched price)
+ */
+declare function formatPriceSync(lamports: bigint, solPrice: number): {
+    sol: number;
+    usd: number;
+    formatted: string;
+};
+/**
+ * Clear the price cache (for testing or manual refresh)
+ */
+declare function clearPriceCache(): void;
+/**
+ * Get list of available built-in providers
+ */
+declare function getProviders(): {
+    name: string;
+    url: string;
+}[];
+
+export { type CustomPriceProvider, type PriceConfig, type PriceData, clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports };

package/dist/pricing/index.js

@@ -0,0 +1,133 @@
+// src/pricing/index.ts
+var cachedPrice = null;
+var config = {};
+var lastProviderIndex = -1;
+function configurePricing(newConfig) {
+  config = { ...config, ...newConfig };
+  cachedPrice = null;
+}
+var PROVIDERS = [
+  {
+    name: "coincap",
+    url: "https://api.coincap.io/v2/assets/solana",
+    parse: (data) => parseFloat(data.data?.priceUsd || "0")
+  },
+  {
+    name: "binance",
+    url: "https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT",
+    parse: (data) => parseFloat(data.price || "0")
+  },
+  {
+    name: "coingecko",
+    url: "https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd",
+    parse: (data) => data.solana?.usd || 0
+  },
+  {
+    name: "kraken",
+    url: "https://api.kraken.com/0/public/Ticker?pair=SOLUSD",
+    parse: (data) => parseFloat(data.result?.SOLUSD?.c?.[0] || "0")
+  }
+];
+async function fetchFromProvider(provider, timeout) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(provider.url, {
+      headers: { "Accept": "application/json" },
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    const price = provider.parse(data);
+    if (!price || price <= 0) {
+      throw new Error("Invalid price");
+    }
+    return price;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+async function getSolPrice() {
+  const cacheTTL = config.cacheTTL ?? 6e4;
+  const timeout = config.timeout ?? 5e3;
+  if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {
+    return cachedPrice;
+  }
+  if (config.customProvider) {
+    try {
+      const price = await config.customProvider();
+      if (price > 0) {
+        cachedPrice = {
+          solPrice: price,
+          fetchedAt: /* @__PURE__ */ new Date(),
+          source: "custom"
+        };
+        return cachedPrice;
+      }
+    } catch {
+    }
+  }
+  for (let i = 0; i < PROVIDERS.length; i++) {
+    const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;
+    const provider = PROVIDERS[idx];
+    try {
+      const price = await fetchFromProvider(provider, timeout);
+      lastProviderIndex = idx;
+      cachedPrice = {
+        solPrice: price,
+        fetchedAt: /* @__PURE__ */ new Date(),
+        source: provider.name
+      };
+      return cachedPrice;
+    } catch {
+      continue;
+    }
+  }
+  if (cachedPrice) {
+    return cachedPrice;
+  }
+  return {
+    solPrice: 150,
+    // Reasonable fallback
+    fetchedAt: /* @__PURE__ */ new Date(),
+    source: "fallback"
+  };
+}
+async function lamportsToUsd(lamports) {
+  const { solPrice } = await getSolPrice();
+  const sol = Number(lamports) / 1e9;
+  return sol * solPrice;
+}
+async function usdToLamports(usd) {
+  const { solPrice } = await getSolPrice();
+  const sol = usd / solPrice;
+  return BigInt(Math.floor(sol * 1e9));
+}
+async function formatPriceDisplay(lamports) {
+  const { solPrice } = await getSolPrice();
+  const sol = Number(lamports) / 1e9;
+  const usd = sol * solPrice;
+  return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;
+}
+function formatPriceSync(lamports, solPrice) {
+  const sol = Number(lamports) / 1e9;
+  const usd = sol * solPrice;
+  return {
+    sol,
+    usd,
+    formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`
+  };
+}
+function clearPriceCache() {
+  cachedPrice = null;
+  lastProviderIndex = -1;
+}
+function getProviders() {
+  return PROVIDERS.map((p) => ({ name: p.name, url: p.url }));
+}
+
+export { clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pricing/index.ts"],"names":[],"mappings":";AAiCA,IAAI,WAAA,GAAgC,IAAA;AACpC,IAAI,SAAsB,EAAC;AAC3B,IAAI,iBAAA,GAAoB,EAAA;AAmBjB,SAAS,iBAAiB,SAAA,EAA8B;AAC3D,EAAA,MAAA,GAAS,EAAE,GAAG,MAAA,EAAQ,GAAG,SAAA,EAAU;AACnC,EAAA,WAAA,GAAc,IAAA;AAClB;AAKA,IAAM,SAAA,GAAY;AAAA,EACd;AAAA,IACI,IAAA,EAAM,SAAA;AAAA,IACN,GAAA,EAAK,yCAAA;AAAA,IACL,OAAO,CAAC,IAAA,KAA2C,WAAW,IAAA,CAAK,IAAA,EAAM,YAAY,GAAG;AAAA,GAC5F;AAAA,EACA;AAAA,IACI,IAAA,EAAM,SAAA;AAAA,IACN,GAAA,EAAK,4DAAA;AAAA,IACL,OAAO,CAAC,IAAA,KAA6B,UAAA,CAAW,IAAA,CAAK,SAAS,GAAG;AAAA,GACrE;AAAA,EACA;AAAA,IACI,IAAA,EAAM,WAAA;AAAA,IACN,GAAA,EAAK,4EAAA;AAAA,IACL,KAAA,EAAO,CAAC,IAAA,KAAwC,IAAA,CAAK,QAAQ,GAAA,IAAO;AAAA,GACxE;AAAA,EACA;AAAA,IACI,IAAA,EAAM,QAAA;AAAA,IACN,GAAA,EAAK,oDAAA;AAAA,IACL,KAAA,EAAO,CAAC,IAAA,KACJ,UAAA,CAAW,IAAA,CAAK,QAAQ,MAAA,EAAQ,CAAA,GAAI,CAAC,CAAA,IAAK,GAAG;AAAA;AAEzD,CAAA;AAKA,eAAe,iBAAA,CACX,UACA,OAAA,EACe;AACf,EAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,EAAA,MAAM,YAAY,UAAA,CAAW,MAAM,UAAA,CAAW,KAAA,IAAS,OAAO,CAAA;AAE9D,EAAA,IAAI;AACA,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,QAAA,CAAS,GAAA,EAAK;AAAA,MACvC,OAAA,EAAS,EAAE,QAAA,EAAU,kBAAA,EAAmB;AAAA,MACxC,QAAQ,UAAA,CAAW;AAAA,KACtB,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,IAC7C;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AACjC,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,IAA4C,CAAA;AAEzE,IAAA,IAAI,CAAC,KAAA,IAAS,KAAA,IAAS,CAAA,EAAG;AACtB,MAAA,MAAM,IAAI,MAAM,eAAe,CAAA;AAAA,IACnC;AAEA,IAAA,OAAO,KAAA;AAAA,EACX,CAAA,SAAE;AACE,IAAA,YAAA,CAAa,SAAS,CAAA;AAAA,EAC1B;AACJ;AAiBA,eAAsB,WAAA,GAAkC;AACpD,EAAA,MAAM,QAAA,GAAW,OAAO,QAAA,IAAY,GAAA;AACpC,EAAA,MAAM,OAAA,GAAU,OAAO,OAAA,IAAW,GAAA;AAGlC,EAAA,IAAI,WAAA,IAAe,KAAK,GAAA,EAAI,GAAI,YAAY,SAAA,CAAU,OAAA,KAAY,QAAA,EAAU;AACxE,IAAA,OAAO,WAAA;AAAA,EACX;AAGA,EAAA,IAAI,OAAO,cAAA,EAAgB;AACvB,IAAA,IAAI;AACA,MAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,cAAA,EAAe;AAC1C,MAAA,IAAI,QAAQ,CAAA,EAAG;AACX,QAAA,WAAA,GAAc;AAAA,UACV,QAAA,EAAU,KAAA;AAAA,UACV,SAAA,sBAAe,IAAA,EAAK;AAAA,UACpB,MAAA,EAAQ;AAAA,SACZ;AACA,QAAA,OAAO,WAAA;AAAA,MACX;AAAA,IACJ,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACJ;AAGA,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,SAAA,CAAU,QAAQ,CAAA,EAAA,EAAK;AACvC,IAAA,MAAM,GAAA,GAAA,CAAO,iBAAA,GAAoB,CAAA,GAAI,CAAA,IAAK,SAAA,CAAU,MAAA;AACpD,IAAA,MAAM,QAAA,GAAW,UAAU,GAAG,CAAA;AAE9B,IAAA,IAAI;AACA,MAAA,MAAM,KAAA,GAAQ,MAAM,iBAAA,CAAkB,QAAA,EAAU,OAAO,CAAA;AACvD,MAAA,iBAAA,GAAoB,GAAA;AAEpB,MAAA,WAAA,GAAc;AAAA,QACV,QAAA,EAAU,KAAA;AAAA,QACV,SAAA,sBAAe,IAAA,EAAK;AAAA,QACpB,QAAQ,QAAA,CAAS;AAAA,OACrB;AACA,MAAA,OAAO,WAAA;AAAA,IACX,CAAA,CAAA,MAAQ;AAEJ,MAAA;AAAA,IACJ;AAAA,EACJ;AAGA,EAAA,IAAI,WAAA,EAAa;AACb,IAAA,OAAO,WAAA;AAAA,EACX;AAGA,EAAA,OAAO;AAAA,IACH,QAAA,EAAU,GAAA;AAAA;AAAA,IACV,SAAA,sBAAe,IAAA,EAAK;AAAA,IACpB,MAAA,EAAQ;AAAA,GACZ;AACJ;AAWA,eAAsB,cAAc,QAAA,EAAmC;AACnE,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,OAAO,GAAA,GAAM,QAAA;AACjB;AAWA,eAAsB,cAAc,GAAA,EAA8B;AAC9D,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAClB,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,GAAa,CAAC,CAAA;AACjD;AAWA,eAAsB,mBAAmB,QAAA,EAAmC;AACxE,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAElB,EAAA,OAAO,CAAA,EAAG,IAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,QAAA,EAAW,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AACrD;AAKO,SAAS,eAAA,CAAgB,UAAkB,QAAA,EAIhD;AACE,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAElB,EAAA,OAAO;AAAA,IACH,GAAA;AAAA,IACA,GAAA;AAAA,IACA,SAAA,EAAW,CAAA,EAAG,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,QAAA,EAAW,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA;AAAA,GACzD;AACJ;AAKO,SAAS,eAAA,GAAwB;AACpC,EAAA,WAAA,GAAc,IAAA;AACd,EAAA,iBAAA,GAAoB,EAAA;AACxB;AAKO,SAAS,YAAA,GAAgD;AAC5D,EAAA,OAAO,SAAA,CAAU,GAAA,CAAI,CAAA,CAAA,MAAM,EAAE,IAAA,EAAM,EAAE,IAAA,EAAM,GAAA,EAAK,CAAA,CAAE,GAAA,EAAI,CAAE,CAAA;AAC5D","file":"index.js","sourcesContent":["// Price Conversion Helpers\n// Multi-provider SOL price fetching with fallback rotation\n\n/**\n * Price data from API\n */\nexport interface PriceData {\n    /** SOL price in USD */\n    solPrice: number;\n    /** Timestamp of price fetch */\n    fetchedAt: Date;\n    /** Source of price data */\n    source: string;\n}\n\n/**\n * Custom price provider function type\n */\nexport type CustomPriceProvider = () => Promise<number>;\n\n/**\n * Price provider configuration\n */\nexport interface PriceConfig {\n    /** Custom price provider (if set, skips built-in providers) */\n    customProvider?: CustomPriceProvider;\n    /** Cache TTL in milliseconds (default: 60000) */\n    cacheTTL?: number;\n    /** Request timeout in milliseconds (default: 5000) */\n    timeout?: number;\n}\n\n// Cached price data\nlet cachedPrice: PriceData | null = null;\nlet config: PriceConfig = {};\nlet lastProviderIndex = -1;\n\n/**\n * Configure price fetching\n * \n * @example\n * ```typescript\n * // Use custom API\n * configurePricing({\n *   customProvider: async () => {\n *     const res = await fetch('https://my-api.com/sol-price');\n *     return (await res.json()).price;\n *   },\n * });\n * \n * // Or just adjust cache TTL\n * configurePricing({ cacheTTL: 30000 }); // 30 seconds\n * ```\n */\nexport function configurePricing(newConfig: PriceConfig): void {\n    config = { ...config, ...newConfig };\n    cachedPrice = null; // Clear cache on config change\n}\n\n/**\n * Built-in price providers with reliability rotation\n */\nconst PROVIDERS = [\n    {\n        name: 'coincap',\n        url: 'https://api.coincap.io/v2/assets/solana',\n        parse: (data: { data?: { priceUsd?: string } }) => parseFloat(data.data?.priceUsd || '0'),\n    },\n    {\n        name: 'binance',\n        url: 'https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT',\n        parse: (data: { price?: string }) => parseFloat(data.price || '0'),\n    },\n    {\n        name: 'coingecko',\n        url: 'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd',\n        parse: (data: { solana?: { usd?: number } }) => data.solana?.usd || 0,\n    },\n    {\n        name: 'kraken',\n        url: 'https://api.kraken.com/0/public/Ticker?pair=SOLUSD',\n        parse: (data: { result?: { SOLUSD?: { c?: string[] } } }) =>\n            parseFloat(data.result?.SOLUSD?.c?.[0] || '0'),\n    },\n];\n\n/**\n * Fetch price from a single provider\n */\nasync function fetchFromProvider(\n    provider: typeof PROVIDERS[0],\n    timeout: number\n): Promise<number> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    try {\n        const response = await fetch(provider.url, {\n            headers: { 'Accept': 'application/json' },\n            signal: controller.signal,\n        });\n\n        if (!response.ok) {\n            throw new Error(`HTTP ${response.status}`);\n        }\n\n        const data = await response.json() as Record<string, unknown>;\n        const price = provider.parse(data as Parameters<typeof provider.parse>[0]);\n\n        if (!price || price <= 0) {\n            throw new Error('Invalid price');\n        }\n\n        return price;\n    } finally {\n        clearTimeout(timeoutId);\n    }\n}\n\n/**\n * Get SOL price with multi-provider fallback\n * \n * Provider rotation order:\n * 1. CoinCap (primary)\n * 2. Binance (backup #1)\n * 3. CoinGecko (backup #2)\n * 4. Kraken (backup #3)\n * \n * @example\n * ```typescript\n * const { solPrice, source } = await getSolPrice();\n * console.log(`SOL is $${solPrice} (from ${source})`);\n * ```\n */\nexport async function getSolPrice(): Promise<PriceData> {\n    const cacheTTL = config.cacheTTL ?? 60000;\n    const timeout = config.timeout ?? 5000;\n\n    // Return cached price if valid\n    if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {\n        return cachedPrice;\n    }\n\n    // Try custom provider first if configured\n    if (config.customProvider) {\n        try {\n            const price = await config.customProvider();\n            if (price > 0) {\n                cachedPrice = {\n                    solPrice: price,\n                    fetchedAt: new Date(),\n                    source: 'custom',\n                };\n                return cachedPrice;\n            }\n        } catch {\n            // Fall through to built-in providers\n        }\n    }\n\n    // Try providers in rotation, starting after the last successful one\n    for (let i = 0; i < PROVIDERS.length; i++) {\n        const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;\n        const provider = PROVIDERS[idx];\n\n        try {\n            const price = await fetchFromProvider(provider, timeout);\n            lastProviderIndex = idx;\n\n            cachedPrice = {\n                solPrice: price,\n                fetchedAt: new Date(),\n                source: provider.name,\n            };\n            return cachedPrice;\n        } catch {\n            // Try next provider\n            continue;\n        }\n    }\n\n    // All providers failed, use stale cache or fallback\n    if (cachedPrice) {\n        return cachedPrice;\n    }\n\n    // Last resort fallback\n    return {\n        solPrice: 150, // Reasonable fallback\n        fetchedAt: new Date(),\n        source: 'fallback',\n    };\n}\n\n/**\n * Convert lamports to USD\n * \n * @example\n * ```typescript\n * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL\n * console.log(`$${usd.toFixed(2)}`);\n * ```\n */\nexport async function lamportsToUsd(lamports: bigint): Promise<number> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    return sol * solPrice;\n}\n\n/**\n * Convert USD to lamports\n * \n * @example\n * ```typescript\n * const lamports = await usdToLamports(1.50); // $1.50\n * console.log(`${lamports} lamports`);\n * ```\n */\nexport async function usdToLamports(usd: number): Promise<bigint> {\n    const { solPrice } = await getSolPrice();\n    const sol = usd / solPrice;\n    return BigInt(Math.floor(sol * 1_000_000_000));\n}\n\n/**\n * Format a price for display with both SOL and USD\n * \n * @example\n * ```typescript\n * const display = await formatPriceDisplay(10_000_000n);\n * // Returns: \"0.0100 SOL (~$1.50)\"\n * ```\n */\nexport async function formatPriceDisplay(lamports: bigint): Promise<string> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;\n}\n\n/**\n * Synchronous price formatting (requires pre-fetched price)\n */\nexport function formatPriceSync(lamports: bigint, solPrice: number): {\n    sol: number;\n    usd: number;\n    formatted: string;\n} {\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return {\n        sol,\n        usd,\n        formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`,\n    };\n}\n\n/**\n * Clear the price cache (for testing or manual refresh)\n */\nexport function clearPriceCache(): void {\n    cachedPrice = null;\n    lastProviderIndex = -1;\n}\n\n/**\n * Get list of available built-in providers\n */\nexport function getProviders(): { name: string; url: string }[] {\n    return PROVIDERS.map(p => ({ name: p.name, url: p.url }));\n}\n"]}

package/dist/session/index.d.cts

@@ -1 +1,29 @@
-export { e as addArticleToSession, d as createSession, i as isArticleUnlocked, v as validateSession } from '../index-uxMb72hH.cjs';
+import { a as SessionConfig, S as SessionData, b as SessionValidation } from '../session-D2IoWAWV.cjs';
+
+/**
+ * Create a new session after successful payment
+ * SECURITY: Validates inputs, enforces limits
+ */
+declare function createSession(walletAddress: string, articleId: string, config: SessionConfig, siteWide?: boolean): Promise<{
+    token: string;
+    session: SessionData;
+}>;
+/**
+ * Validate an existing session token
+ * SECURITY: jose library handles timing-safe comparison internally
+ */
+declare function validateSession(token: string, secret: string): Promise<SessionValidation>;
+/**
+ * Add an article to an existing session
+ * SECURITY: Enforces article limit to prevent token bloat
+ */
+declare function addArticleToSession(token: string, articleId: string, secret: string): Promise<{
+    token: string;
+    session: SessionData;
+} | null>;
+/**
+ * Check if an article is unlocked for a session
+ */
+declare function isArticleUnlocked(token: string, articleId: string, secret: string): Promise<boolean>;
+
+export { addArticleToSession, createSession, isArticleUnlocked, validateSession };

package/dist/session/index.d.ts

@@ -1 +1,29 @@
-export { e as addArticleToSession, d as createSession, i as isArticleUnlocked, v as validateSession } from '../index-uxMb72hH.js';
+import { a as SessionConfig, S as SessionData, b as SessionValidation } from '../session-D2IoWAWV.js';
+
+/**
+ * Create a new session after successful payment
+ * SECURITY: Validates inputs, enforces limits
+ */
+declare function createSession(walletAddress: string, articleId: string, config: SessionConfig, siteWide?: boolean): Promise<{
+    token: string;
+    session: SessionData;
+}>;
+/**
+ * Validate an existing session token
+ * SECURITY: jose library handles timing-safe comparison internally
+ */
+declare function validateSession(token: string, secret: string): Promise<SessionValidation>;
+/**
+ * Add an article to an existing session
+ * SECURITY: Enforces article limit to prevent token bloat
+ */
+declare function addArticleToSession(token: string, articleId: string, secret: string): Promise<{
+    token: string;
+    session: SessionData;
+} | null>;
+/**
+ * Check if an article is unlocked for a session
+ */
+declare function isArticleUnlocked(token: string, articleId: string, secret: string): Promise<boolean>;
+
+export { addArticleToSession, createSession, isArticleUnlocked, validateSession };

package/dist/{index-uxMb72hH.d.cts → session-D2IoWAWV.d.cts}

@@ -45,30 +45,4 @@ interface SessionJWTPayload {
     exp: number;
 }
 
-/**
- * Create a new session after successful payment
- * SECURITY: Validates inputs, enforces limits
- */
-declare function createSession(walletAddress: string, articleId: string, config: SessionConfig, siteWide?: boolean): Promise<{
-    token: string;
-    session: SessionData;
-}>;
-/**
- * Validate an existing session token
- * SECURITY: jose library handles timing-safe comparison internally
- */
-declare function validateSession(token: string, secret: string): Promise<SessionValidation>;
-/**
- * Add an article to an existing session
- * SECURITY: Enforces article limit to prevent token bloat
- */
-declare function addArticleToSession(token: string, articleId: string, secret: string): Promise<{
-    token: string;
-    session: SessionData;
-} | null>;
-/**
- * Check if an article is unlocked for a session
- */
-declare function isArticleUnlocked(token: string, articleId: string, secret: string): Promise<boolean>;
-
-export { type SessionData as S, type SessionConfig as a, type SessionValidation as b, type SessionJWTPayload as c, createSession as d, addArticleToSession as e, isArticleUnlocked as i, validateSession as v };
+export type { SessionData as S, SessionConfig as a, SessionValidation as b, SessionJWTPayload as c };

package/dist/{index-uxMb72hH.d.ts → session-D2IoWAWV.d.ts}

@@ -45,30 +45,4 @@ interface SessionJWTPayload {
     exp: number;
 }
 
-/**
- * Create a new session after successful payment
- * SECURITY: Validates inputs, enforces limits
- */
-declare function createSession(walletAddress: string, articleId: string, config: SessionConfig, siteWide?: boolean): Promise<{
-    token: string;
-    session: SessionData;
-}>;
-/**
- * Validate an existing session token
- * SECURITY: jose library handles timing-safe comparison internally
- */
-declare function validateSession(token: string, secret: string): Promise<SessionValidation>;
-/**
- * Add an article to an existing session
- * SECURITY: Enforces article limit to prevent token bloat
- */
-declare function addArticleToSession(token: string, articleId: string, secret: string): Promise<{
-    token: string;
-    session: SessionData;
-} | null>;
-/**
- * Check if an article is unlocked for a session
- */
-declare function isArticleUnlocked(token: string, articleId: string, secret: string): Promise<boolean>;
-
-export { type SessionData as S, type SessionConfig as a, type SessionValidation as b, type SessionJWTPayload as c, createSession as d, addArticleToSession as e, isArticleUnlocked as i, validateSession as v };
+export type { SessionData as S, SessionConfig as a, SessionValidation as b, SessionJWTPayload as c };