playlist-data-engine 1.1.1 → 1.3.0

package/dist/utils/arweaveGatewayManager.d.ts

@@ -15,6 +15,15 @@
  * @module utils/arweaveGatewayManager
  */
 import type { GatewayConfig } from './arweaveUtils.js';
+/**
+ * Options for resolveUrl()
+ */
+export interface ResolveUrlOptions {
+    /** Optional AbortSignal to cancel in-flight gateway checks */
+    signal?: AbortSignal;
+    /** Skip arweave.net in the resolution chain — go persisted → fallbacks → Wayfinder */
+    bypassArweaveNet?: boolean;
+}
 /**
  * Configuration for the gateway cache entry
  */
@@ -167,6 +176,28 @@ export interface HealthCheckOptions {
     /** Maximum response time to consider a gateway "fast" in ms (default: 2000) */
     fastThreshold?: number;
 }
+/**
+ * Diagnostic snapshot of the gateway manager's current state
+ */
+export interface GatewayDiagnostics {
+    /** Currently active gateway host, or null */
+    activeGateway: string | null;
+    /** Milliseconds since the active gateway was set, or null */
+    activeGatewayAge: number | null;
+    /** Available gateway hosts in priority order */
+    availableGateways: string[];
+    /** Timing of the most recent real fetch (ms) */
+    lastFetchTiming: number;
+    /** Number of consecutive slow responses from the active gateway */
+    consecutiveSlowResponses: number;
+    /** Per-gateway health summary */
+    healthSummary: {
+        host: string;
+        avgMs: number;
+        successRate: number;
+        checks: number;
+    }[];
+}
 /**
  * ArweaveGatewayManager class
  *
@@ -197,6 +228,8 @@ export declare class ArweaveGatewayManager {
     private originalPriorities;
     /** Maximum number of response time records to keep per gateway */
     private readonly MAX_HEALTH_RECORDS;
+    /** In-flight resolveUrl requests keyed by txId, for request deduplication */
+    private inflightResolves;
     /** AR.IO Wayfinder client for dynamic routing */
     private wayfinder;
     /** The currently active dynamic gateway. Used globally to prevent constant switching. */
@@ -211,22 +244,46 @@ export declare class ArweaveGatewayManager {
     private readonly maxSlowResponses;
     constructor(config?: ArweaveGatewayManagerConfig);
     /**
-     * Resolve an Arweave URL to a working gateway URL
+     * Wrap a promise with a timeout to prevent hanging indefinitely.
+     * Useful for third-party calls (e.g., Wayfinder) that have no built-in timeout.
+     */
+    private withTimeout;
+    /**
+     * Resolve an Arweave URL to a gateway URL using the active gateway, with no network checks.
      *
-     * If the URL is not an Arweave URL, returns it unchanged.
-     * If cached, returns the cached working URL.
-     * Otherwise, tries each gateway in priority order until one works.
-     * If all gateways fail, returns the original URL.
+     * This is the fast path — it returns instantly by reusing the current active gateway
+     * (or arweave.net if none is set). Use this for the hot path where latency matters.
+     * When real fetches fail, call {@link reportGatewayFailure} to trigger gateway rotation.
      *
      * @param url - The URL to resolve
-     * @returns A working URL (or original URL if all gateways fail)
+     * @returns A gateway URL constructed from the active gateway, or the original URL if not Arweave
      */
-    resolveUrlOld(url: string): Promise<string>;
+    resolveUrlSimple(url: string): string;
     /**
-     * Wrap a promise with a timeout to prevent hanging indefinitely.
-     * Useful for third-party calls (e.g., Wayfinder) that have no built-in timeout.
+     * Set a preferred gateway by host name.
+     *
+     * If the host is in the known gateways list, it becomes the active gateway
+     * and is persisted to localStorage. Returns true on success.
+     *
+     * @param host - Gateway hostname (e.g. 'ardrive.net')
+     * @returns True if the gateway was found and set, false otherwise
      */
-    private withTimeout;
+    setPreferredGateway(host: string): boolean;
+    /**
+     * Clear the preferred/active gateway.
+     *
+     * Removes the active gateway, clears the persisted gateway from localStorage,
+     * and clears the cache. The next resolveUrl() call will re-discover the best gateway.
+     */
+    clearPreferredGateway(): void;
+    /**
+     * Get a diagnostic snapshot of the gateway manager's current state.
+     *
+     * Useful for debugging and console inspection.
+     *
+     * @returns Current gateway manager diagnostics
+     */
+    getDiagnostics(): GatewayDiagnostics;
     /**
      * Resolve an Arweave URL to a working gateway URL.
      *
@@ -234,10 +291,16 @@ export declare class ArweaveGatewayManager {
      * fall back to Wayfinder only if all static gateways fail.
      *
      * @param url - The URL to resolve
-     * @param signal - Optional AbortSignal to cancel in-flight gateway checks
+     * @param options - Optional resolve options (signal, bypassArweaveNet, monitorArweaveNet)
      * @returns A working URL (or original URL if all gateways fail or signal is aborted)
      */
-    resolveUrl(url: string, signal?: AbortSignal): Promise<string>;
+    resolveUrl(url: string, options?: ResolveUrlOptions): Promise<string>;
+    /**
+     * The actual gateway fallback chain. Extracted from resolveUrl() for
+     * request deduplication — concurrent callers for the same txId share
+     * one instance of this chain.
+     */
+    private resolveGatewayChain;
     /**
      * Report that the active gateway failed a real fetch.
      *
@@ -273,7 +336,7 @@ export declare class ArweaveGatewayManager {
      */
     private checkAndSetGateway;
     /**
-     * Try remaining fallback gateways (everything except arweave.net).
+     * Try remaining fallback gateways (everything except arweave.net) in parallel.
      * Returns the URL of the first gateway that responds, or null if all fail.
      */
     private tryFallbackGateways;
@@ -329,6 +392,12 @@ export declare class ArweaveGatewayManager {
      * Clear all cached gateway entries
      */
     clearCache(): void;
+    /**
+     * Invalidate the cached gateway for a specific URL's transaction ID.
+     * Also clears the active gateway and persisted gateway so that resolveUrl()
+     * runs the full fallback chain instead of short-circuiting.
+     */
+    invalidateCacheForUrl(url: string): void;
     /**
      * Prefetch and cache gateways for multiple URLs in parallel
      *

package/dist/utils/arweaveGatewayManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arweaveGatewayManager.d.ts","sourceRoot":"","sources":["../../src/utils/arweaveGatewayManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA+BvD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,cAAc,EAAE,aAAa,CAAC;IAC9B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,EAAE,aAAa,CAAC;IACvB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8CAA8C;IAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mDAAmD;IACnD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oFAAoF;IACpF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AA6BD;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,MAAM,CAAgC;IAC9C,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAa;IAC7B,wCAAwC;IACxC,OAAO,CAAC,SAAS,CAAa;IAC9B,4DAA4D;IAC5D,OAAO,CAAC,UAAU,CAAgD;IAClE,wDAAwD;IACxD,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IACzC,iDAAiD;IACjD,OAAO,CAAC,SAAS,CAA0B;IAC3C,yFAAyF;IACzF,OAAO,CAAC,aAAa,CAA8B;IACnD,mFAAmF;IACnF,OAAO,CAAC,eAAe,CAAa;IACpC,yEAAyE;IACzE,OAAO,CAAC,wBAAwB,CAAa;IAC7C,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,MAAM,CAAC,EAAE,2BAA2B;IA4EhD;;;;;;;;;;OAUG;IAEG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2DjD;;;OAGG;IACH,OAAO,CAAC,WAAW;IAUnB;;;;;;;;;OASG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IA+DpE;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1H,OAAO,CAAC,MAAM,CAAC;IAwDlB;;;;;;;;OAQG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAuB1C;;;OAGG;YACW,kBAAkB;IAmBhC;;;OAGG;YACW,mBAAmB;IAmCjC;;;OAGG;YACW,YAAY;IA2C1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,GAAE,MAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAkEzH;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAepD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAWpD;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;;;;;;;;;;;;;;;;;OAkBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAqHtF;;;;;;;;;;OAUG;IACH,aAAa,IAAI,UAAU;IAkB3B;;;;OAIG;IACH,eAAe,IAAI,YAAY,EAAE;IAIjC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAMpB;;;;;;OAMG;IACH;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,sBAAsB;IAM9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAKzE;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAoD9D;;;;OAIG;IACH,mBAAmB,IAAI,kBAAkB,EAAE;IAI3C;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,OAAO,CAAC,EAAE;QAC9B,sEAAsE;QACtE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iEAAiE;QACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B,GAAG,aAAa,EAAE;IAyEnB;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0G9E;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAqB9B;;OAEG;IACH,eAAe,IAAI,IAAI;CAI1B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}
+{"version":3,"file":"arweaveGatewayManager.d.ts","sourceRoot":"","sources":["../../src/utils/arweaveGatewayManager.ts"],"names":[],"mappings":"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"}

package/dist/utils/arweaveUtils.d.ts

@@ -35,7 +35,7 @@ export declare const DEFAULT_GATEWAYS: GatewayConfig[];
 /**
  * Known Arweave gateway hosts for URL detection
  */
-export declare const KNOWN_GATEWAY_HOSTS: readonly ["arweave.net", "ar.io", "ardrive.net", "turbo-gateway.com"];
+export declare const KNOWN_GATEWAY_HOSTS: readonly ["arweave.net", "arweave.dev", "www.arweave.net", "ardrive.net", "turbo-gateway.com", "irys.xyz", "ar-io.dev", "ar-io.net", "arweave.rocks", "g8way.io"];
 /**
  * Check if a URL is an Arweave URL
  *

package/dist/utils/arweaveUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arweaveUtils.d.ts","sourceRoot":"","sources":["../../src/utils/arweaveUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAK3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,uEAKtB,CAAC;AAQX;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAajD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA8DlE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,GAAE,MAAW,GAAG,MAAM,CAGzG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,aAAa,EAAqB,EAC5C,UAAU,GAAE,MAAW,GACxB,MAAM,EAAE,CAIV"}
+{"version":3,"file":"arweaveUtils.d.ts","sourceRoot":"","sources":["../../src/utils/arweaveUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAI3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,mKAWtB,CAAC;AAQX;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAsBjD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAuElE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,GAAE,MAAW,GAAG,MAAM,CAGzG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,aAAa,EAAqB,EAC5C,UAAU,GAAE,MAAW,GACxB,MAAM,EAAE,CAIV"}

package/dist/utils/ipfsUtils.d.ts

@@ -0,0 +1,76 @@
+/**
+ * IPFS URL utility functions for detecting, extracting, and resolving IPFS links.
+ *
+ * @module utils/ipfsUtils
+ */
+/**
+ * Known IPFS HTTP gateway host prefixes.
+ * Each entry is checked with hostname matching (exact or subdomain).
+ * All known gateway hosts — extend this array to add new gateways.
+ */
+export declare const KNOWN_IPFS_GATEWAY_HOSTS: readonly ["ipfs.io", "cloudflare-ipfs.com", "dweb.link", "gateway.pinata.cloud", "ipfs.infura.io", "nftstorage.link", "web3-music-pipeline.mypinata.cloud", "soundxyz.mypinata.cloud", "gold-broad-gibbon-29.mypinata.cloud", "bonfire.mypinata.cloud", "spinamp.mypinata.cloud", "catalogworks.b-cdn.net"];
+/** Default gateway used by resolveIPFSLink */
+export declare const DEFAULT_IPFS_GATEWAY = "ipfs.io";
+/**
+ * Extract the IPFS CID and optional path from any IPFS URL.
+ * Returns null if the URL isn't a recognized IPFS URL.
+ *
+ * Handles:
+ * - `ipfs://ipfs/{cid}/path` — native scheme (double ipfs)
+ * - `ipfs://{cid}/path` — native scheme
+ * - `https://gateway/ipfs/{cid}/path` — standard gateway format
+ * - `https://{cid}.ipfs.dweb.link` — subdomain format
+ *
+ * @param url - The URL to extract from
+ * @returns The CID + path (e.g. "QmXxx/file.jpg"), or null
+ */
+export declare function extractIPFSPath(url: string): string | null;
+/**
+ * Check if a URL is an IPFS URL.
+ *
+ * Detects:
+ * - `ipfs://` protocol URLs (native scheme)
+ * - URLs on known IPFS gateway hosts with `/ipfs/` path segment
+ * - Subdomain format: `{cid}.ipfs.dweb.link`
+ *
+ * @param url - The URL to check
+ * @returns True if the URL is an IPFS URL
+ *
+ * @example
+ * ```ts
+ * isIPFS('ipfs://ipfs/QmXxx'); // true
+ * isIPFS('ipfs://QmXxx'); // true
+ * isIPFS('https://ipfs.io/ipfs/QmXxx'); // true
+ * isIPFS('https://cloudflare-ipfs.com/ipfs/QmXxx'); // true
+ * isIPFS('https://dweb.link/ipfs/QmXxx'); // true
+ * isIPFS('https://gateway.pinata.cloud/ipfs/QmXxx'); // true
+ * isIPFS('https://soundxyz.mypinata.cloud/ipfs/QmXxx'); // true
+ * isIPFS('https://nftstorage.link/ipfs/QmXxx'); // true
+ * isIPFS('https://QmXxx.ipfs.dweb.link'); // true
+ * isIPFS('https://example.com/image.png'); // false
+ * isIPFS(undefined); // false
+ * ```
+ */
+export declare function isIPFS(url: string | undefined): boolean;
+/**
+ * Resolve an IPFS URL to a specific gateway.
+ *
+ * Extracts the IPFS CID/path from any recognized IPFS URL format and
+ * reconstructs it with the specified gateway host.
+ *
+ * @param url - The IPFS URL to resolve
+ * @param gatewayHost - Gateway host to resolve to (default: ipfs.io)
+ * @returns The resolved URL, or the original URL if not IPFS
+ *
+ * @example
+ * ```ts
+ * resolveIPFSLink('ipfs://QmXxx'); // 'https://ipfs.io/ipfs/QmXxx'
+ * resolveIPFSLink('ipfs://QmXxx', 'cloudflare-ipfs.com'); // 'https://cloudflare-ipfs.com/ipfs/QmXxx'
+ * resolveIPFSLink('https://soundxyz.mypinata.cloud/ipfs/QmXxx'); // 'https://ipfs.io/ipfs/QmXxx'
+ * resolveIPFSLink('https://QmXxx.ipfs.dweb.link'); // 'https://ipfs.io/ipfs/QmXxx'
+ * resolveIPFSLink('https://example.com/file.png'); // 'https://example.com/file.png'
+ * resolveIPFSLink(undefined); // undefined
+ * ```
+ */
+export declare function resolveIPFSLink(url: string | undefined, gatewayHost?: string): string | undefined;
+//# sourceMappingURL=ipfsUtils.d.ts.map

package/dist/utils/ipfsUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfsUtils.d.ts","sourceRoot":"","sources":["../../src/utils/ipfsUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,6SAa3B,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAI9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAwBvD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC3B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,WAAW,GAAE,MAA6B,GAC3C,MAAM,GAAG,SAAS,CASpB"}

package/dist/utils/modelCache.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ModelCache — Persistent localForage cache for TensorFlow.js model artifacts.
+ *
+ * After the first successful download, model artifacts (model.json manifest +
+ * weight shard ArrayBuffers) are stored in IndexedDB via localForage. Subsequent
+ * loads read from cache without any network requests or gateway resolution.
+ *
+ * Supports two loading strategies:
+ * - `getOrFetchGraphModel()` — loads via custom TF.js IOHandler (for tf.loadGraphModel)
+ * - `getOrFetchBlobUrl()` — returns a blob URL (for Essentia TensorflowMusiCNN/VGGish)
+ */
+import type * as tf from '@tensorflow/tfjs';
+export interface ModelCacheEntry {
+    manifest: string;
+    weights: Record<string, ArrayBuffer>;
+    savedAt: number;
+    originalUrl: string;
+}
+export interface ModelCacheOptions {
+    /** Optional custom localForage instance name. @default 'playlist-data-engine-models' */
+    storeName?: string;
+    /** Optional description for the IndexedDB database. */
+    description?: string;
+}
+export interface ModelCacheFetchOptions {
+    /** Optional callback to resolve URLs (e.g., arweaveGatewayManager). */
+    resolveUrl?: (url: string) => Promise<string>;
+    /** Optional callback to invalidate cached gateway for a URL after a fetch failure. */
+    invalidateUrlCache?: (url: string) => void;
+    /** Maximum download retries. @default 3 */
+    maxRetries?: number;
+    /** Base delay for exponential backoff in ms. @default 1000 */
+    baseDelayMs?: number;
+}
+export declare class ModelCache {
+    private store;
+    constructor(options?: ModelCacheOptions);
+    /**
+     * Check if a model is cached.
+     */
+    has(modelUrl: string): Promise<boolean>;
+    /**
+     * Get cache metadata for a model (without loading it).
+     */
+    getCacheInfo(modelUrl: string): Promise<{
+        cached: boolean;
+        savedAt?: number;
+        size?: number;
+    } | null>;
+    /**
+     * Load a GraphModel from cache (no network). Throws if not cached.
+     */
+    loadFromCache(tfModule: typeof tf, modelUrl: string): Promise<tf.GraphModel>;
+    /**
+     * Get or fetch a GraphModel with caching.
+     *
+     * - Cache hit: loads directly from IndexedDB (no network)
+     * - Cache miss: resolves URL, fetches with retry, caches artifacts, then loads
+     */
+    getOrFetchGraphModel(tfModule: typeof tf, modelUrl: string, options?: ModelCacheFetchOptions): Promise<tf.GraphModel>;
+    /**
+     * Get or fetch a model for use with Essentia constructors (TensorflowMusiCNN/VGGish).
+     *
+     * Uses tf.io.registerLoadRouter to register a custom IOHandler for `cached://`
+     * URLs. When Essentia internally calls tf.loadGraphModel(cachedUrl), TF.js routes
+     * to our handler which serves artifacts from localForage — zero network calls.
+     *
+     * On cache hit: returns `cached://` URL, zero network during Essentia init.
+     * On cache miss: fetches with gateway fallback, caches, returns `cached://` URL.
+     */
+    getOrFetchEssentiaUrl(modelUrl: string, options?: ModelCacheFetchOptions): Promise<string>;
+    /**
+     * Clear the cache for a specific model or all models.
+     */
+    clear(modelUrl?: string): Promise<void>;
+    /**
+     * List all cached model URLs.
+     */
+    listCachedModels(): Promise<string[]>;
+    /**
+     * Get total cache size in bytes.
+     */
+    totalCacheSize(): Promise<number>;
+}
+/** Singleton model cache instance used by default across the engine. */
+export declare const modelCache: ModelCache;
+//# sourceMappingURL=modelCache.d.ts.map

package/dist/utils/modelCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCache.d.ts","sourceRoot":"","sources":["../../src/utils/modelCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAM5C,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACnC,uEAAuE;IACvE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAwOD,qBAAa,UAAU;IACnB,OAAO,CAAC,KAAK,CAAc;gBAEf,OAAO,GAAE,iBAAsB;IAO3C;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7C;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IAgBT;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC;IAQlF;;;;;OAKG;IACG,oBAAoB,CACtB,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACrC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC;IAiCzB;;;;;;;;;OASG;IACG,qBAAqB,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACrC,OAAO,CAAC,MAAM,CAAC;IA2BlB;;OAEG;IACG,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAO3C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAY1C;AAED,wEAAwE;AACxE,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/package.json

@@ -6,7 +6,7 @@
     "type": "git",
     "url": "git+https://github.com/jasondesante/playlist-data-engine.git"
   },
-  "version": "1.1.1",
+  "version": "1.3.0",
   "type": "module",
   "main": "./dist/playlist-data-engine.js",
   "module": "./dist/playlist-data-engine.mjs",
@@ -22,24 +22,28 @@
     "dist"
   ],
   "keywords": [
-    "d&d",
-    "character-generation",
-    "audio-analysis",
-    "progression-system",
-    "rpg",
+    "arweave",
+    "ethereum",
+    "music-nfts",
+    "web3-music",
+    "decentralized-music",
+    "serverless-playlists",
+    "permaweb",
+    "ario-wayfinder",
+    "decentralized-playlists",
+    "gamified-music",
+    "music-gamification",
+    "rhythm-game-engine",
+    "rpg-character-generator",
+    "dnd-5e",
+    "xp-system",
     "beat-detection",
-    "rhythm-game",
-    "audio-processing",
-    "character-sheet",
+    "audio-analysis",
+    "music-classification",
+    "pitch-detection",
     "combat-simulator",
-    "dnd-5e",
-    "typescript",
-    "game-engine",
-    "music-analysis",
-    "ethereum",
-    "arweave",
-    "nfts",
-    "decentralized-music-infrastructure"
+    "sensor-integration",
+    "rhythm-game"
   ],
   "scripts": {
     "dev": "vite",
@@ -58,6 +62,7 @@
     "@ar.io/wayfinder-core": "^1.9.1",
     "@tensorflow/tfjs": "^4.22.0",
     "essentia.js": "^0.1.3",
+    "localforage": "^1.10.0",
     "murmurhash-v3": "^1.0.2",
     "uuid": "^13.0.0",
     "zod": "^4.1.13"
@@ -72,9 +77,9 @@
   "devDependencies": {
     "@eslint/js": "^9.39.1",
     "@types/node": "^24.10.1",
-    "@types/uuid": "^10.0.0",
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",
+    "@types/uuid": "^10.0.0",
     "@vitejs/plugin-react": "^5.1.1",
     "@vitest/coverage-v8": "^4.0.14",
     "@vitest/ui": "^4.0.14",