@datum-cloud/strapi-revalidate 0.1.0

package/dist/cache/drivers/redis.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Redis cache driver — STUB.
+ *
+ * The interface is exported so config typing and exports stay stable.
+ * Actual ioredis-backed implementation is planned for v1.x; consumers
+ * that try to instantiate this driver will get a clear runtime error.
+ */
+import type { CacheDriver, CacheSetOptions } from '../types.js';
+/** Configuration for the (not-yet-implemented) Redis driver. */
+export interface RedisDriverOptions {
+    redisUrl: string;
+    keyPrefix?: string;
+}
+/** Stubbed Redis `CacheDriver`. Every method throws. */
+export declare class RedisCacheDriver implements CacheDriver {
+    private readonly options;
+    constructor(options: RedisDriverOptions);
+    get<T>(_key: string): Promise<T | null>;
+    set<T>(_key: string, _data: T, _options?: CacheSetOptions): Promise<void>;
+    delete(_key: string): Promise<void>;
+    deleteByTag(_tag: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(_prefix?: string): Promise<string[]>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/cache/drivers/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/redis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wDAAwD;AACxD,qBAAa,gBAAiB,YAAW,WAAW;IAElD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,kBAAkB;IAIjC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAGhD"}

package/dist/cache/drivers/redis.js

@@ -0,0 +1,36 @@
+/**
+ * Redis cache driver — STUB.
+ *
+ * The interface is exported so config typing and exports stay stable.
+ * Actual ioredis-backed implementation is planned for v1.x; consumers
+ * that try to instantiate this driver will get a clear runtime error.
+ */
+const NOT_IMPLEMENTED_MESSAGE = 'Redis driver: not implemented in v0.1.0. Install ioredis and use file/memory driver, or wait for v1.x.';
+/** Stubbed Redis `CacheDriver`. Every method throws. */
+export class RedisCacheDriver {
+    // Stored to satisfy strict property init while keeping the stub honest.
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async get(_key) {
+        void this.options;
+        throw new Error(NOT_IMPLEMENTED_MESSAGE);
+    }
+    async set(_key, _data, _options) {
+        throw new Error(NOT_IMPLEMENTED_MESSAGE);
+    }
+    async delete(_key) {
+        throw new Error(NOT_IMPLEMENTED_MESSAGE);
+    }
+    async deleteByTag(_tag) {
+        throw new Error(NOT_IMPLEMENTED_MESSAGE);
+    }
+    async clear() {
+        throw new Error(NOT_IMPLEMENTED_MESSAGE);
+    }
+    async keys(_prefix) {
+        throw new Error(NOT_IMPLEMENTED_MESSAGE);
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/cache/drivers/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../src/cache/drivers/redis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,uBAAuB,GAC3B,wGAAwG,CAAC;AAE3G,wDAAwD;AACxD,MAAM,OAAO,gBAAgB;IAC3B,wEAAwE;IACvD,OAAO,CAAqB;IAE7C,YAAY,OAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY;QACvB,KAAK,IAAI,CAAC,OAAO,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,KAAQ,EAAE,QAA0B;QAC7D,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAgB;QACzB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/cache/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Public cache surface.
+ *
+ * `createCache(config)` is the factory most users want — it builds primary
+ * and fallback drivers from a `RevalidateConfig` and wraps them in a
+ * `CacheManager`. Driver classes and the `CacheDriver` interface are
+ * re-exported for users who want to hand-wire a custom topology.
+ */
+import type { RevalidateConfig } from '../types/config.js';
+import { CacheManager } from './manager.js';
+export type { CacheDriver, CacheSetOptions } from './types.js';
+export { CacheManager } from './manager.js';
+export type { CacheManagerOptions } from './manager.js';
+export { FileCacheDriver } from './drivers/file.js';
+export type { FileDriverOptions } from './drivers/file.js';
+export { MemoryCacheDriver } from './drivers/memory.js';
+export { RedisCacheDriver } from './drivers/redis.js';
+export type { RedisDriverOptions } from './drivers/redis.js';
+/**
+ * Build a `CacheManager` from a validated `RevalidateConfig`.
+ *
+ * The primary driver is whichever was configured (`file` by default); the
+ * fallback driver is always a file-backed cache pointed at
+ * `config.cache.fallbackDir` so persistence survives process restarts even
+ * when the primary is in-memory.
+ */
+export declare function createCache(config: RevalidateConfig): CacheManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CASlE"}

package/dist/cache/index.js

@@ -0,0 +1,54 @@
+/**
+ * Public cache surface.
+ *
+ * `createCache(config)` is the factory most users want — it builds primary
+ * and fallback drivers from a `RevalidateConfig` and wraps them in a
+ * `CacheManager`. Driver classes and the `CacheDriver` interface are
+ * re-exported for users who want to hand-wire a custom topology.
+ */
+import { FileCacheDriver } from './drivers/file.js';
+import { MemoryCacheDriver } from './drivers/memory.js';
+import { RedisCacheDriver } from './drivers/redis.js';
+import { CacheManager } from './manager.js';
+export { CacheManager } from './manager.js';
+export { FileCacheDriver } from './drivers/file.js';
+export { MemoryCacheDriver } from './drivers/memory.js';
+export { RedisCacheDriver } from './drivers/redis.js';
+/**
+ * Build a `CacheManager` from a validated `RevalidateConfig`.
+ *
+ * The primary driver is whichever was configured (`file` by default); the
+ * fallback driver is always a file-backed cache pointed at
+ * `config.cache.fallbackDir` so persistence survives process restarts even
+ * when the primary is in-memory.
+ */
+export function createCache(config) {
+    const primary = buildDriver(config);
+    const fallback = new FileCacheDriver({ dir: config.cache.fallbackDir });
+    return new CacheManager({
+        primary,
+        fallback,
+        defaultTtl: config.cache.ttl,
+        debug: config.debug,
+    });
+}
+function buildDriver(config) {
+    const { driver } = config.cache;
+    switch (driver) {
+        case 'file':
+            return new FileCacheDriver({ dir: config.cache.dir });
+        case 'memory':
+            return new MemoryCacheDriver();
+        case 'redis': {
+            const redisUrl = config.cache.redisUrl;
+            if (!redisUrl) {
+                throw new Error('Redis driver requires `cache.redisUrl` to be set.');
+            }
+            return new RedisCacheDriver({
+                redisUrl,
+                keyPrefix: config.cache.keyPrefix,
+            });
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACxE,OAAO,IAAI,YAAY,CAAC;QACtB,OAAO;QACP,QAAQ;QACR,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG;QAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,MAAwB;IAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IAChC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACvE,CAAC;YACD,OAAO,IAAI,gBAAgB,CAAC;gBAC1B,QAAQ;gBACR,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;aAClC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cache/manager.d.ts

@@ -0,0 +1,55 @@
+/**
+ * CacheManager — the composition layer the public API talks to.
+ *
+ * Responsibilities:
+ *  - Track tag membership across writes so `invalidate(tag)` is O(tagged keys).
+ *  - Mirror every successful `set()` to a persistent fallback driver with no
+ *    TTL, so Strapi outages don't take the site down.
+ *  - Provide `getWithFallback()` for read paths: short-TTL hit > fetch >
+ *    long-lived fallback hit.
+ *
+ * Drivers themselves stay storage-only; tag accounting lives here.
+ */
+import type { CacheDriver, CacheSetOptions } from './types.js';
+/** Options for instantiating a `CacheManager`. */
+export interface CacheManagerOptions {
+    /** Primary driver — honours TTL, serves hot reads. */
+    primary: CacheDriver;
+    /** Persistent fallback driver — never expires, written on every successful set. */
+    fallback: CacheDriver;
+    /** Default TTL (seconds) applied when `set` is called without one. */
+    defaultTtl?: number;
+    /** When true, hits/misses are logged via `console.debug`. */
+    debug?: boolean;
+}
+/**
+ * Cache facade. All content fetchers and the webhook handler talk to this,
+ * not to a driver directly.
+ */
+export declare class CacheManager {
+    private readonly primary;
+    private readonly fallback;
+    private readonly defaultTtl;
+    private readonly debug;
+    constructor(options: CacheManagerOptions);
+    /** Read from the primary cache. Returns `null` on miss or expiry. */
+    get<T>(key: string): Promise<T | null>;
+    /** Read from the persistent fallback cache. Returns `null` if never populated. */
+    getFallback<T>(key: string): Promise<T | null>;
+    /**
+     * Write to both the primary cache (with TTL + tags) and the fallback cache
+     * (no TTL, no tags). Tag accounting happens at the driver level.
+     */
+    set<T>(key: string, data: T, options?: CacheSetOptions): Promise<void>;
+    /** Remove a single key from the primary cache. Fallback is preserved by design. */
+    delete(key: string): Promise<void>;
+    /**
+     * Invalidate every primary-cache key associated with `tag`. The fallback
+     * cache is intentionally untouched — if the upcoming refetch fails, stale
+     * data should still serve.
+     */
+    invalidate(tag: string): Promise<void>;
+    /** Invalidate all primary-cache entries. Fallback is preserved. */
+    invalidateAll(): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/cache/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/D,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,OAAO,EAAE,WAAW,CAAC;IACrB,mFAAmF;IACnF,QAAQ,EAAE,WAAW,CAAC;IACtB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,OAAO,EAAE,mBAAmB;IAOxC,qEAAqE;IAC/D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAQ5C,kFAAkF;IAC5E,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIpD;;;OAGG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhF,mFAAmF;IAC7E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,mEAAmE;IAC7D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAMrC"}

package/dist/cache/manager.js

@@ -0,0 +1,73 @@
+/**
+ * CacheManager — the composition layer the public API talks to.
+ *
+ * Responsibilities:
+ *  - Track tag membership across writes so `invalidate(tag)` is O(tagged keys).
+ *  - Mirror every successful `set()` to a persistent fallback driver with no
+ *    TTL, so Strapi outages don't take the site down.
+ *  - Provide `getWithFallback()` for read paths: short-TTL hit > fetch >
+ *    long-lived fallback hit.
+ *
+ * Drivers themselves stay storage-only; tag accounting lives here.
+ */
+/**
+ * Cache facade. All content fetchers and the webhook handler talk to this,
+ * not to a driver directly.
+ */
+export class CacheManager {
+    primary;
+    fallback;
+    defaultTtl;
+    debug;
+    constructor(options) {
+        this.primary = options.primary;
+        this.fallback = options.fallback;
+        this.defaultTtl = options.defaultTtl ?? 3600;
+        this.debug = options.debug ?? false;
+    }
+    /** Read from the primary cache. Returns `null` on miss or expiry. */
+    async get(key) {
+        const value = await this.primary.get(key);
+        if (this.debug) {
+            console.debug(`[strapi-revalidate] cache ${value === null ? 'MISS' : 'HIT'} → ${key}`);
+        }
+        return value;
+    }
+    /** Read from the persistent fallback cache. Returns `null` if never populated. */
+    async getFallback(key) {
+        return this.fallback.get(key);
+    }
+    /**
+     * Write to both the primary cache (with TTL + tags) and the fallback cache
+     * (no TTL, no tags). Tag accounting happens at the driver level.
+     */
+    async set(key, data, options = {}) {
+        const ttl = options.ttl ?? this.defaultTtl;
+        await this.primary.set(key, data, { ttl, tags: options.tags });
+        // Fallback: no TTL, no tag indexing — it exists purely to survive outages.
+        await this.fallback.set(key, data);
+    }
+    /** Remove a single key from the primary cache. Fallback is preserved by design. */
+    async delete(key) {
+        await this.primary.delete(key);
+    }
+    /**
+     * Invalidate every primary-cache key associated with `tag`. The fallback
+     * cache is intentionally untouched — if the upcoming refetch fails, stale
+     * data should still serve.
+     */
+    async invalidate(tag) {
+        await this.primary.deleteByTag(tag);
+        if (this.debug) {
+            console.debug(`[strapi-revalidate] invalidated tag → ${tag}`);
+        }
+    }
+    /** Invalidate all primary-cache entries. Fallback is preserved. */
+    async invalidateAll() {
+        await this.primary.clear();
+        if (this.debug) {
+            console.debug('[strapi-revalidate] invalidated all');
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/cache/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH;;;GAGG;AACH,MAAM,OAAO,YAAY;IACN,OAAO,CAAc;IACrB,QAAQ,CAAc;IACtB,UAAU,CAAS;IACnB,KAAK,CAAU;IAEhC,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACtC,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,WAAW,CAAI,GAAW;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,UAA2B,EAAE;QAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC;QAC3C,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,2EAA2E;QAC3E,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yCAAyC,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/cache/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Cache driver contract.
+ *
+ * Implementations are responsible for storage details (filesystem, in-memory
+ * Map, Redis, etc.). The `CacheManager` layered above provides tag tracking
+ * and fallback semantics so drivers stay simple.
+ */
+/** Options accepted by `CacheDriver.set`. */
+export interface CacheSetOptions {
+    /** Time-to-live in **seconds**. Omit for no expiry. */
+    ttl?: number;
+    /** Tag names associated with this key. Drivers may persist these to support `deleteByTag`. */
+    tags?: string[];
+}
+/**
+ * Storage-agnostic cache contract. All public cache APIs accept anything
+ * that satisfies this interface.
+ */
+export interface CacheDriver {
+    /** Returns the cached value for `key`, or `null` if missing or expired. */
+    get<T>(key: string): Promise<T | null>;
+    /** Stores `data` under `key` with optional ttl (seconds) and tag list. */
+    set<T>(key: string, data: T, options?: CacheSetOptions): Promise<void>;
+    /** Removes a single key. No-op if absent. */
+    delete(key: string): Promise<void>;
+    /** Removes every key associated with `tag`. */
+    deleteByTag(tag: string): Promise<void>;
+    /** Removes every key managed by this driver. */
+    clear(): Promise<void>;
+    /** Lists all keys, optionally filtered by a string prefix. */
+    keys(prefix?: string): Promise<string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC,0EAA0E;IAC1E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE,6CAA6C;IAC7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,+CAA+C;IAC/C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,gDAAgD;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,8DAA8D;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C"}

package/dist/cache/types.js

@@ -0,0 +1,9 @@
+/**
+ * Cache driver contract.
+ *
+ * Implementations are responsible for storage details (filesystem, in-memory
+ * Map, Redis, etc.). The `CacheManager` layered above provides tag tracking
+ * and fallback semantics so drivers stay simple.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/client/graphql.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GraphQL transport for Strapi v5.
+ *
+ * Adapted from datum.net's `graphqlQuery()` with two additions: configurable
+ * retry with exponential backoff, and a structured `StrapiClient` surface so
+ * the same instance is reused across fetchers (no module-level state).
+ */
+/** Generic Strapi GraphQL response envelope. */
+export interface GraphQLResponse<T> {
+    data: T;
+    errors?: Array<{
+        message: string;
+    }>;
+}
+/** Configuration for a `GraphQLStrapiClient`. */
+export interface GraphQLClientOptions {
+    /** Strapi base URL (no trailing `/graphql`). */
+    url: string;
+    /** Strapi API token. Sent as `Authorization: Bearer <token>`. */
+    token: string;
+    /** Per-request timeout in **milliseconds**. */
+    timeout: number;
+    /** Number of retries on transport failure (timeout, network, 5xx). 0 disables retry. */
+    retry: number;
+    /** When true, logs request lifecycle via `console.debug`. */
+    debug?: boolean;
+}
+/**
+ * Strapi GraphQL client.
+ *
+ * `query<T>()` returns the unwrapped `data` payload or `null` on failure;
+ * callers are expected to treat `null` as "Strapi unreachable / invalid"
+ * and fall back to stale cache.
+ */
+export declare class GraphQLStrapiClient {
+    private readonly options;
+    constructor(options: GraphQLClientOptions);
+    /**
+     * Execute a GraphQL operation. Returns the `data` payload on success,
+     * `null` if the server returns an error envelope, a non-2xx status,
+     * times out, or all retries are exhausted.
+     */
+    query<T>(query: string, variables?: Record<string, unknown>): Promise<T | null>;
+    private executeOnce;
+}
+//# sourceMappingURL=graphql.d.ts.map

package/dist/client/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../src/client/graphql.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gDAAgD;AAChD,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAEnC,OAAO,EAAE,oBAAoB;IAIzC;;;;OAIG;IACG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;YAiC3E,WAAW;CAwC1B"}

package/dist/client/graphql.js

@@ -0,0 +1,97 @@
+/**
+ * GraphQL transport for Strapi v5.
+ *
+ * Adapted from datum.net's `graphqlQuery()` with two additions: configurable
+ * retry with exponential backoff, and a structured `StrapiClient` surface so
+ * the same instance is reused across fetchers (no module-level state).
+ */
+/**
+ * Strapi GraphQL client.
+ *
+ * `query<T>()` returns the unwrapped `data` payload or `null` on failure;
+ * callers are expected to treat `null` as "Strapi unreachable / invalid"
+ * and fall back to stale cache.
+ */
+export class GraphQLStrapiClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Execute a GraphQL operation. Returns the `data` payload on success,
+     * `null` if the server returns an error envelope, a non-2xx status,
+     * times out, or all retries are exhausted.
+     */
+    async query(query, variables = {}) {
+        const { retry } = this.options;
+        let lastError = null;
+        for (let attempt = 0; attempt <= retry; attempt++) {
+            try {
+                const result = await this.executeOnce(query, variables);
+                if (result !== null)
+                    return result;
+                // result === null means a structured Strapi error (4xx / GraphQL errors).
+                // Don't retry those — they won't get better.
+                return null;
+            }
+            catch (err) {
+                lastError = err;
+                if (this.options.debug) {
+                    console.debug(`[strapi-revalidate] graphql attempt ${attempt + 1}/${retry + 1} failed:`, err);
+                }
+                if (attempt < retry) {
+                    await sleep(backoffMs(attempt));
+                }
+            }
+        }
+        if (lastError instanceof Error && lastError.name === 'AbortError') {
+            console.error(`Strapi request timed out after ${this.options.timeout}ms`);
+        }
+        else if (lastError) {
+            console.error('Error fetching from Strapi:', lastError);
+        }
+        return null;
+    }
+    async executeOnce(query, variables) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);
+        try {
+            const response = await fetch(`${this.options.url.replace(/\/$/, '')}/graphql`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.options.token}`,
+                },
+                body: JSON.stringify({ query, variables }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                console.error(`Strapi GraphQL error: ${response.status} ${response.statusText}`, text);
+                // 5xx is retryable — surface as a thrown error so the retry loop fires.
+                if (response.status >= 500) {
+                    throw new Error(`Strapi ${response.status} ${response.statusText}`);
+                }
+                return null;
+            }
+            const result = (await response.json());
+            if (result.errors && result.errors.length > 0) {
+                console.error('Strapi GraphQL errors:', result.errors);
+                return null;
+            }
+            return result.data;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Exponential backoff with a sane cap. Attempt is 0-indexed. */
+function backoffMs(attempt) {
+    const base = 200 * 2 ** attempt;
+    return Math.min(base, 2000);
+}
+//# sourceMappingURL=graphql.js.map

package/dist/client/graphql.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Public client surface.
+ *
+ * `createStrapiClient(config)` picks the right transport (graphql today,
+ * rest later) and returns a unified `StrapiClient`. All built-in content
+ * fetchers receive a client through their `fetch*` helpers rather than
+ * instantiating one themselves — so the same connection, timeout, and
+ * retry policy applies across the package.
+ */
+import type { RevalidateConfig } from '../types/config.js';
+import { GraphQLStrapiClient } from './graphql.js';
+export { GraphQLStrapiClient } from './graphql.js';
+export type { GraphQLClientOptions, GraphQLResponse } from './graphql.js';
+export { createRestClient, RestStrapiClient } from './rest.js';
+export type { RestClientOptions } from './rest.js';
+/**
+ * Anything the package's content fetchers know how to talk to.
+ *
+ * Today this is exclusively the GraphQL client; the REST stub is planned
+ * to satisfy the same shape via a `query`-style adapter in a future release.
+ */
+export type StrapiClient = GraphQLStrapiClient;
+/**
+ * Build a `StrapiClient` from a validated `RevalidateConfig`. Throws
+ * `Error` if the configured transport isn't implemented yet (REST).
+ */
+export declare function createStrapiClient(config: RevalidateConfig): StrapiClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAoBzE"}

package/dist/client/index.js

@@ -0,0 +1,38 @@
+/**
+ * Public client surface.
+ *
+ * `createStrapiClient(config)` picks the right transport (graphql today,
+ * rest later) and returns a unified `StrapiClient`. All built-in content
+ * fetchers receive a client through their `fetch*` helpers rather than
+ * instantiating one themselves — so the same connection, timeout, and
+ * retry policy applies across the package.
+ */
+import { GraphQLStrapiClient } from './graphql.js';
+import { createRestClient } from './rest.js';
+export { GraphQLStrapiClient } from './graphql.js';
+export { createRestClient, RestStrapiClient } from './rest.js';
+/**
+ * Build a `StrapiClient` from a validated `RevalidateConfig`. Throws
+ * `Error` if the configured transport isn't implemented yet (REST).
+ */
+export function createStrapiClient(config) {
+    if (config.transport === 'rest') {
+        // Surfaced via the stub for a consistent error message.
+        createRestClient({
+            url: config.url,
+            token: config.token,
+            timeout: config.timeout,
+            retry: config.retry,
+        });
+        // Unreachable — createRestClient throws — but keeps the return type honest.
+        throw new Error('REST transport not yet implemented');
+    }
+    return new GraphQLStrapiClient({
+        url: config.url,
+        token: config.token,
+        timeout: config.timeout,
+        retry: config.retry,
+        debug: config.debug,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAW/D;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAChC,wDAAwD;QACxD,gBAAgB,CAAC;YACf,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QACH,4EAA4E;QAC5E,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,mBAAmB,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/client/rest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * REST transport for Strapi — STUB.
+ *
+ * The interface is exported for forward compatibility; runtime usage throws
+ * a clear error. v0.1.0 only ships the GraphQL transport because every
+ * built-in content fetcher uses GraphQL.
+ */
+/** Configuration for the (not-yet-implemented) REST client. */
+export interface RestClientOptions {
+    url: string;
+    token: string;
+    timeout: number;
+    retry: number;
+}
+/** Stubbed REST client. Constructor is callable so config typing works; all reads throw. */
+export declare class RestStrapiClient {
+    private readonly options;
+    constructor(options: RestClientOptions);
+    get<T>(_path: string, _params?: Record<string, unknown>): Promise<T | null>;
+}
+/** Factory that mirrors `createStrapiClient` shape. Throws on first use. */
+export declare function createRestClient(_options: RestClientOptions): RestStrapiClient;
+//# sourceMappingURL=rest.d.ts.map

package/dist/client/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../src/client/rest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,4FAA4F;AAC5F,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,EAAE,iBAAiB;IAIhC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAIlF;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,CAE9E"}

package/dist/client/rest.js

@@ -0,0 +1,25 @@
+/**
+ * REST transport for Strapi — STUB.
+ *
+ * The interface is exported for forward compatibility; runtime usage throws
+ * a clear error. v0.1.0 only ships the GraphQL transport because every
+ * built-in content fetcher uses GraphQL.
+ */
+const NOT_IMPLEMENTED_MESSAGE = 'REST transport not yet implemented. Use transport: "graphql" or pin to a future v1.x release.';
+/** Stubbed REST client. Constructor is callable so config typing works; all reads throw. */
+export class RestStrapiClient {
+    // Stored to keep strict property init quiet and document intent.
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async get(_path, _params) {
+        void this.options;
+        throw new Error(NOT_IMPLEMENTED_MESSAGE);
+    }
+}
+/** Factory that mirrors `createStrapiClient` shape. Throws on first use. */
+export function createRestClient(_options) {
+    throw new Error(NOT_IMPLEMENTED_MESSAGE);
+}
+//# sourceMappingURL=rest.js.map

package/dist/client/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../../src/client/rest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,uBAAuB,GAC3B,+FAA+F,CAAC;AAElG,4FAA4F;AAC5F,MAAM,OAAO,gBAAgB;IAC3B,iEAAiE;IAChD,OAAO,CAAoB;IAE5C,YAAY,OAA0B;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,KAAa,EAAE,OAAiC;QAC3D,KAAK,IAAI,CAAC,OAAO,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,QAA2B;IAC1D,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAC3C,CAAC"}