@datum-cloud/strapi-revalidate 0.1.2 → 0.2.0

package/dist/cache/manager.d.ts

@@ -5,8 +5,8 @@
  *  - 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.
+ *  - `getWithFallback()` for resilient read paths: primary hit → fetcher →
+ *    fallback, with a single cache write on fresh data.
  *
  * Drivers themselves stay storage-only; tag accounting lives here.
  */
@@ -36,6 +36,19 @@ export declare class CacheManager {
     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>;
+    /**
+     * Full read path with outage resilience:
+     * 1. Return the primary cache value if present.
+     * 2. Call `fetcher()` to get fresh data.
+     * 3. On success, write to both primary and fallback caches, then return.
+     * 4. On failure (`null`), return whatever the fallback cache holds.
+     *
+     * @param key     Cache key.
+     * @param fetcher Async function that fetches fresh data. Return `null` to
+     *                signal failure and trigger the fallback read.
+     * @param options TTL and tag options forwarded to `set()` on a fresh write.
+     */
+    getWithFallback<T>(key: string, fetcher: () => Promise<T | null>, options?: CacheSetOptions): 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.

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

@@ -1 +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"}
+{"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;;;;;;;;;;;OAWG;IACG,eAAe,CAAC,CAAC,EACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,EAChC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgBpB;;;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

@@ -5,8 +5,8 @@
  *  - 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.
+ *  - `getWithFallback()` for resilient read paths: primary hit → fetcher →
+ *    fallback, with a single cache write on fresh data.
  *
  * Drivers themselves stay storage-only; tag accounting lives here.
  */
@@ -37,6 +37,32 @@ export class CacheManager {
     async getFallback(key) {
         return this.fallback.get(key);
     }
+    /**
+     * Full read path with outage resilience:
+     * 1. Return the primary cache value if present.
+     * 2. Call `fetcher()` to get fresh data.
+     * 3. On success, write to both primary and fallback caches, then return.
+     * 4. On failure (`null`), return whatever the fallback cache holds.
+     *
+     * @param key     Cache key.
+     * @param fetcher Async function that fetches fresh data. Return `null` to
+     *                signal failure and trigger the fallback read.
+     * @param options TTL and tag options forwarded to `set()` on a fresh write.
+     */
+    async getWithFallback(key, fetcher, options = {}) {
+        const cached = await this.get(key);
+        if (cached !== null)
+            return cached;
+        const fresh = await fetcher();
+        if (fresh !== null) {
+            await this.set(key, fresh, options);
+            return fresh;
+        }
+        if (this.debug) {
+            console.debug(`[strapi-revalidate] fetcher returned null, reading fallback → ${key}`);
+        }
+        return this.getFallback(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.

package/dist/cache/manager.js.map

@@ -1 +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","sourcesContent":["/**\n * CacheManager — the composition layer the public API talks to.\n *\n * Responsibilities:\n *  - Track tag membership across writes so `invalidate(tag)` is O(tagged keys).\n *  - Mirror every successful `set()` to a persistent fallback driver with no\n *    TTL, so Strapi outages don't take the site down.\n *  - Provide `getWithFallback()` for read paths: short-TTL hit > fetch >\n *    long-lived fallback hit.\n *\n * Drivers themselves stay storage-only; tag accounting lives here.\n */\n\nimport type { CacheDriver, CacheSetOptions } from './types.js';\n\n/** Options for instantiating a `CacheManager`. */\nexport interface CacheManagerOptions {\n  /** Primary driver — honours TTL, serves hot reads. */\n  primary: CacheDriver;\n  /** Persistent fallback driver — never expires, written on every successful set. */\n  fallback: CacheDriver;\n  /** Default TTL (seconds) applied when `set` is called without one. */\n  defaultTtl?: number;\n  /** When true, hits/misses are logged via `console.debug`. */\n  debug?: boolean;\n}\n\n/**\n * Cache facade. All content fetchers and the webhook handler talk to this,\n * not to a driver directly.\n */\nexport class CacheManager {\n  private readonly primary: CacheDriver;\n  private readonly fallback: CacheDriver;\n  private readonly defaultTtl: number;\n  private readonly debug: boolean;\n\n  constructor(options: CacheManagerOptions) {\n    this.primary = options.primary;\n    this.fallback = options.fallback;\n    this.defaultTtl = options.defaultTtl ?? 3600;\n    this.debug = options.debug ?? false;\n  }\n\n  /** Read from the primary cache. Returns `null` on miss or expiry. */\n  async get<T>(key: string): Promise<T | null> {\n    const value = await this.primary.get<T>(key);\n    if (this.debug) {\n      console.debug(`[strapi-revalidate] cache ${value === null ? 'MISS' : 'HIT'} → ${key}`);\n    }\n    return value;\n  }\n\n  /** Read from the persistent fallback cache. Returns `null` if never populated. */\n  async getFallback<T>(key: string): Promise<T | null> {\n    return this.fallback.get<T>(key);\n  }\n\n  /**\n   * Write to both the primary cache (with TTL + tags) and the fallback cache\n   * (no TTL, no tags). Tag accounting happens at the driver level.\n   */\n  async set<T>(key: string, data: T, options: CacheSetOptions = {}): Promise<void> {\n    const ttl = options.ttl ?? this.defaultTtl;\n    await this.primary.set(key, data, { ttl, tags: options.tags });\n    // Fallback: no TTL, no tag indexing — it exists purely to survive outages.\n    await this.fallback.set(key, data);\n  }\n\n  /** Remove a single key from the primary cache. Fallback is preserved by design. */\n  async delete(key: string): Promise<void> {\n    await this.primary.delete(key);\n  }\n\n  /**\n   * Invalidate every primary-cache key associated with `tag`. The fallback\n   * cache is intentionally untouched — if the upcoming refetch fails, stale\n   * data should still serve.\n   */\n  async invalidate(tag: string): Promise<void> {\n    await this.primary.deleteByTag(tag);\n    if (this.debug) {\n      console.debug(`[strapi-revalidate] invalidated tag → ${tag}`);\n    }\n  }\n\n  /** Invalidate all primary-cache entries. Fallback is preserved. */\n  async invalidateAll(): Promise<void> {\n    await this.primary.clear();\n    if (this.debug) {\n      console.debug('[strapi-revalidate] invalidated all');\n    }\n  }\n}\n"]}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CacheManager — the composition layer the public API talks to.\n *\n * Responsibilities:\n *  - Track tag membership across writes so `invalidate(tag)` is O(tagged keys).\n *  - Mirror every successful `set()` to a persistent fallback driver with no\n *    TTL, so Strapi outages don't take the site down.\n *  - `getWithFallback()` for resilient read paths: primary hit → fetcher →\n *    fallback, with a single cache write on fresh data.\n *\n * Drivers themselves stay storage-only; tag accounting lives here.\n */\n\nimport type { CacheDriver, CacheSetOptions } from './types.js';\n\n/** Options for instantiating a `CacheManager`. */\nexport interface CacheManagerOptions {\n  /** Primary driver — honours TTL, serves hot reads. */\n  primary: CacheDriver;\n  /** Persistent fallback driver — never expires, written on every successful set. */\n  fallback: CacheDriver;\n  /** Default TTL (seconds) applied when `set` is called without one. */\n  defaultTtl?: number;\n  /** When true, hits/misses are logged via `console.debug`. */\n  debug?: boolean;\n}\n\n/**\n * Cache facade. All content fetchers and the webhook handler talk to this,\n * not to a driver directly.\n */\nexport class CacheManager {\n  private readonly primary: CacheDriver;\n  private readonly fallback: CacheDriver;\n  private readonly defaultTtl: number;\n  private readonly debug: boolean;\n\n  constructor(options: CacheManagerOptions) {\n    this.primary = options.primary;\n    this.fallback = options.fallback;\n    this.defaultTtl = options.defaultTtl ?? 3600;\n    this.debug = options.debug ?? false;\n  }\n\n  /** Read from the primary cache. Returns `null` on miss or expiry. */\n  async get<T>(key: string): Promise<T | null> {\n    const value = await this.primary.get<T>(key);\n    if (this.debug) {\n      console.debug(`[strapi-revalidate] cache ${value === null ? 'MISS' : 'HIT'} → ${key}`);\n    }\n    return value;\n  }\n\n  /** Read from the persistent fallback cache. Returns `null` if never populated. */\n  async getFallback<T>(key: string): Promise<T | null> {\n    return this.fallback.get<T>(key);\n  }\n\n  /**\n   * Full read path with outage resilience:\n   * 1. Return the primary cache value if present.\n   * 2. Call `fetcher()` to get fresh data.\n   * 3. On success, write to both primary and fallback caches, then return.\n   * 4. On failure (`null`), return whatever the fallback cache holds.\n   *\n   * @param key     Cache key.\n   * @param fetcher Async function that fetches fresh data. Return `null` to\n   *                signal failure and trigger the fallback read.\n   * @param options TTL and tag options forwarded to `set()` on a fresh write.\n   */\n  async getWithFallback<T>(\n    key: string,\n    fetcher: () => Promise<T | null>,\n    options: CacheSetOptions = {}\n  ): Promise<T | null> {\n    const cached = await this.get<T>(key);\n    if (cached !== null) return cached;\n\n    const fresh = await fetcher();\n    if (fresh !== null) {\n      await this.set(key, fresh, options);\n      return fresh;\n    }\n\n    if (this.debug) {\n      console.debug(`[strapi-revalidate] fetcher returned null, reading fallback → ${key}`);\n    }\n    return this.getFallback<T>(key);\n  }\n\n  /**\n   * Write to both the primary cache (with TTL + tags) and the fallback cache\n   * (no TTL, no tags). Tag accounting happens at the driver level.\n   */\n  async set<T>(key: string, data: T, options: CacheSetOptions = {}): Promise<void> {\n    const ttl = options.ttl ?? this.defaultTtl;\n    await this.primary.set(key, data, { ttl, tags: options.tags });\n    // Fallback: no TTL, no tag indexing — it exists purely to survive outages.\n    await this.fallback.set(key, data);\n  }\n\n  /** Remove a single key from the primary cache. Fallback is preserved by design. */\n  async delete(key: string): Promise<void> {\n    await this.primary.delete(key);\n  }\n\n  /**\n   * Invalidate every primary-cache key associated with `tag`. The fallback\n   * cache is intentionally untouched — if the upcoming refetch fails, stale\n   * data should still serve.\n   */\n  async invalidate(tag: string): Promise<void> {\n    await this.primary.deleteByTag(tag);\n    if (this.debug) {\n      console.debug(`[strapi-revalidate] invalidated tag → ${tag}`);\n    }\n  }\n\n  /** Invalidate all primary-cache entries. Fallback is preserved. */\n  async invalidateAll(): Promise<void> {\n    await this.primary.clear();\n    if (this.debug) {\n      console.debug('[strapi-revalidate] invalidated all');\n    }\n  }\n}\n"]}

package/dist/client/graphql.d.ts

@@ -16,8 +16,11 @@ export interface GraphQLResponse<T> {
 export interface GraphQLClientOptions {
     /** Strapi base URL (no trailing `/graphql`). */
     url: string;
-    /** Strapi API token. Sent as `Authorization: Bearer <token>`. */
-    token: string;
+    /**
+     * Strapi API token. Sent as `Authorization: Bearer <token>` when present.
+     * Omit for Strapi instances where the queried content is publicly readable.
+     */
+    token?: string;
     /** Per-request timeout in **milliseconds**. */
     timeout: number;
     /** Number of retries on transport failure (timeout, network, 5xx). 0 disables retry. */

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

@@ -1 +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"}
+{"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;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+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

@@ -60,7 +60,7 @@ export class GraphQLStrapiClient {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
-                    Authorization: `Bearer ${this.options.token}`,
+                    ...(this.options.token ? { Authorization: `Bearer ${this.options.token}` } : {}),
                 },
                 body: JSON.stringify({ query, variables }),
                 signal: controller.signal,

package/dist/client/graphql.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../src/client/graphql.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * GraphQL transport for Strapi v5.\n *\n * Adapted from datum.net's `graphqlQuery()` with two additions: configurable\n * retry with exponential backoff, and a structured `StrapiClient` surface so\n * the same instance is reused across fetchers (no module-level state).\n */\n\n/** Generic Strapi GraphQL response envelope. */\nexport interface GraphQLResponse<T> {\n  data: T;\n  errors?: Array<{ message: string }>;\n}\n\n/** Configuration for a `GraphQLStrapiClient`. */\nexport interface GraphQLClientOptions {\n  /** Strapi base URL (no trailing `/graphql`). */\n  url: string;\n  /** Strapi API token. Sent as `Authorization: Bearer <token>`. */\n  token: string;\n  /** Per-request timeout in **milliseconds**. */\n  timeout: number;\n  /** Number of retries on transport failure (timeout, network, 5xx). 0 disables retry. */\n  retry: number;\n  /** When true, logs request lifecycle via `console.debug`. */\n  debug?: boolean;\n}\n\n/**\n * Strapi GraphQL client.\n *\n * `query<T>()` returns the unwrapped `data` payload or `null` on failure;\n * callers are expected to treat `null` as \"Strapi unreachable / invalid\"\n * and fall back to stale cache.\n */\nexport class GraphQLStrapiClient {\n  private readonly options: GraphQLClientOptions;\n\n  constructor(options: GraphQLClientOptions) {\n    this.options = options;\n  }\n\n  /**\n   * Execute a GraphQL operation. Returns the `data` payload on success,\n   * `null` if the server returns an error envelope, a non-2xx status,\n   * times out, or all retries are exhausted.\n   */\n  async query<T>(query: string, variables: Record<string, unknown> = {}): Promise<T | null> {\n    const { retry } = this.options;\n    let lastError: unknown = null;\n\n    for (let attempt = 0; attempt <= retry; attempt++) {\n      try {\n        const result = await this.executeOnce<T>(query, variables);\n        if (result !== null) return result;\n        // result === null means a structured Strapi error (4xx / GraphQL errors).\n        // Don't retry those — they won't get better.\n        return null;\n      } catch (err) {\n        lastError = err;\n        if (this.options.debug) {\n          console.debug(\n            `[strapi-revalidate] graphql attempt ${attempt + 1}/${retry + 1} failed:`,\n            err\n          );\n        }\n        if (attempt < retry) {\n          await sleep(backoffMs(attempt));\n        }\n      }\n    }\n\n    if (lastError instanceof Error && lastError.name === 'AbortError') {\n      console.error(`Strapi request timed out after ${this.options.timeout}ms`);\n    } else if (lastError) {\n      console.error('Error fetching from Strapi:', lastError);\n    }\n    return null;\n  }\n\n  private async executeOnce<T>(\n    query: string,\n    variables: Record<string, unknown>\n  ): Promise<T | null> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);\n\n    try {\n      const response = await fetch(`${this.options.url.replace(/\\/$/, '')}/graphql`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${this.options.token}`,\n        },\n        body: JSON.stringify({ query, variables }),\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const text = await response.text();\n        console.error(`Strapi GraphQL error: ${response.status} ${response.statusText}`, text);\n        // 5xx is retryable — surface as a thrown error so the retry loop fires.\n        if (response.status >= 500) {\n          throw new Error(`Strapi ${response.status} ${response.statusText}`);\n        }\n        return null;\n      }\n\n      const result = (await response.json()) as GraphQLResponse<T>;\n\n      if (result.errors && result.errors.length > 0) {\n        console.error('Strapi GraphQL errors:', result.errors);\n        return null;\n      }\n\n      return result.data;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Exponential backoff with a sane cap. Attempt is 0-indexed. */\nfunction backoffMs(attempt: number): number {\n  const base = 200 * 2 ** attempt;\n  return Math.min(base, 2000);\n}\n"]}
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../src/client/graphql.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAAuB;IAE/C,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAI,KAAa,EAAE,YAAqC,EAAE;QACnE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/B,IAAI,SAAS,GAAY,IAAI,CAAC;QAE9B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAI,KAAK,EAAE,SAAS,CAAC,CAAC;gBAC3D,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,MAAM,CAAC;gBACnC,0EAA0E;gBAC1E,6CAA6C;gBAC7C,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,CAAC;gBAChB,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACvB,OAAO,CAAC,KAAK,CACX,uCAAuC,OAAO,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,UAAU,EACzE,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC;oBACpB,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,SAAS,YAAY,KAAK,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,SAAS,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,KAAa,EACb,SAAkC;QAElC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,EAAE;gBAC7E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjF;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;gBAC1C,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;gBACvF,wEAAwE;gBACxE,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBACtE,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAC;YAE7D,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACvD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,iEAAiE;AACjE,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["/**\n * GraphQL transport for Strapi v5.\n *\n * Adapted from datum.net's `graphqlQuery()` with two additions: configurable\n * retry with exponential backoff, and a structured `StrapiClient` surface so\n * the same instance is reused across fetchers (no module-level state).\n */\n\n/** Generic Strapi GraphQL response envelope. */\nexport interface GraphQLResponse<T> {\n  data: T;\n  errors?: Array<{ message: string }>;\n}\n\n/** Configuration for a `GraphQLStrapiClient`. */\nexport interface GraphQLClientOptions {\n  /** Strapi base URL (no trailing `/graphql`). */\n  url: string;\n  /**\n   * Strapi API token. Sent as `Authorization: Bearer <token>` when present.\n   * Omit for Strapi instances where the queried content is publicly readable.\n   */\n  token?: string;\n  /** Per-request timeout in **milliseconds**. */\n  timeout: number;\n  /** Number of retries on transport failure (timeout, network, 5xx). 0 disables retry. */\n  retry: number;\n  /** When true, logs request lifecycle via `console.debug`. */\n  debug?: boolean;\n}\n\n/**\n * Strapi GraphQL client.\n *\n * `query<T>()` returns the unwrapped `data` payload or `null` on failure;\n * callers are expected to treat `null` as \"Strapi unreachable / invalid\"\n * and fall back to stale cache.\n */\nexport class GraphQLStrapiClient {\n  private readonly options: GraphQLClientOptions;\n\n  constructor(options: GraphQLClientOptions) {\n    this.options = options;\n  }\n\n  /**\n   * Execute a GraphQL operation. Returns the `data` payload on success,\n   * `null` if the server returns an error envelope, a non-2xx status,\n   * times out, or all retries are exhausted.\n   */\n  async query<T>(query: string, variables: Record<string, unknown> = {}): Promise<T | null> {\n    const { retry } = this.options;\n    let lastError: unknown = null;\n\n    for (let attempt = 0; attempt <= retry; attempt++) {\n      try {\n        const result = await this.executeOnce<T>(query, variables);\n        if (result !== null) return result;\n        // result === null means a structured Strapi error (4xx / GraphQL errors).\n        // Don't retry those — they won't get better.\n        return null;\n      } catch (err) {\n        lastError = err;\n        if (this.options.debug) {\n          console.debug(\n            `[strapi-revalidate] graphql attempt ${attempt + 1}/${retry + 1} failed:`,\n            err\n          );\n        }\n        if (attempt < retry) {\n          await sleep(backoffMs(attempt));\n        }\n      }\n    }\n\n    if (lastError instanceof Error && lastError.name === 'AbortError') {\n      console.error(`Strapi request timed out after ${this.options.timeout}ms`);\n    } else if (lastError) {\n      console.error('Error fetching from Strapi:', lastError);\n    }\n    return null;\n  }\n\n  private async executeOnce<T>(\n    query: string,\n    variables: Record<string, unknown>\n  ): Promise<T | null> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);\n\n    try {\n      const response = await fetch(`${this.options.url.replace(/\\/$/, '')}/graphql`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...(this.options.token ? { Authorization: `Bearer ${this.options.token}` } : {}),\n        },\n        body: JSON.stringify({ query, variables }),\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const text = await response.text();\n        console.error(`Strapi GraphQL error: ${response.status} ${response.statusText}`, text);\n        // 5xx is retryable — surface as a thrown error so the retry loop fires.\n        if (response.status >= 500) {\n          throw new Error(`Strapi ${response.status} ${response.statusText}`);\n        }\n        return null;\n      }\n\n      const result = (await response.json()) as GraphQLResponse<T>;\n\n      if (result.errors && result.errors.length > 0) {\n        console.error('Strapi GraphQL errors:', result.errors);\n        return null;\n      }\n\n      return result.data;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Exponential backoff with a sane cap. Attempt is 0-indexed. */\nfunction backoffMs(attempt: number): number {\n  const base = 200 * 2 ** attempt;\n  return Math.min(base, 2000);\n}\n"]}

package/dist/client/rest.d.ts

@@ -8,7 +8,7 @@
 /** Configuration for the (not-yet-implemented) REST client. */
 export interface RestClientOptions {
     url: string;
-    token: string;
+    token?: string;
     timeout: number;
     retry: number;
 }

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

@@ -1 +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"}
+{"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,CAAC,EAAE,MAAM,CAAC;IACf,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.map

@@ -1 +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","sourcesContent":["/**\n * REST transport for Strapi — STUB.\n *\n * The interface is exported for forward compatibility; runtime usage throws\n * a clear error. v0.1.0 only ships the GraphQL transport because every\n * built-in content fetcher uses GraphQL.\n */\n\n/** Configuration for the (not-yet-implemented) REST client. */\nexport interface RestClientOptions {\n  url: string;\n  token: string;\n  timeout: number;\n  retry: number;\n}\n\nconst NOT_IMPLEMENTED_MESSAGE =\n  'REST transport not yet implemented. Use transport: \"graphql\" or pin to a future v1.x release.';\n\n/** Stubbed REST client. Constructor is callable so config typing works; all reads throw. */\nexport class RestStrapiClient {\n  // Stored to keep strict property init quiet and document intent.\n  private readonly options: RestClientOptions;\n\n  constructor(options: RestClientOptions) {\n    this.options = options;\n  }\n\n  async get<T>(_path: string, _params?: Record<string, unknown>): Promise<T | null> {\n    void this.options;\n    throw new Error(NOT_IMPLEMENTED_MESSAGE);\n  }\n}\n\n/** Factory that mirrors `createStrapiClient` shape. Throws on first use. */\nexport function createRestClient(_options: RestClientOptions): RestStrapiClient {\n  throw new Error(NOT_IMPLEMENTED_MESSAGE);\n}\n"]}
+{"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","sourcesContent":["/**\n * REST transport for Strapi — STUB.\n *\n * The interface is exported for forward compatibility; runtime usage throws\n * a clear error. v0.1.0 only ships the GraphQL transport because every\n * built-in content fetcher uses GraphQL.\n */\n\n/** Configuration for the (not-yet-implemented) REST client. */\nexport interface RestClientOptions {\n  url: string;\n  token?: string;\n  timeout: number;\n  retry: number;\n}\n\nconst NOT_IMPLEMENTED_MESSAGE =\n  'REST transport not yet implemented. Use transport: \"graphql\" or pin to a future v1.x release.';\n\n/** Stubbed REST client. Constructor is callable so config typing works; all reads throw. */\nexport class RestStrapiClient {\n  // Stored to keep strict property init quiet and document intent.\n  private readonly options: RestClientOptions;\n\n  constructor(options: RestClientOptions) {\n    this.options = options;\n  }\n\n  async get<T>(_path: string, _params?: Record<string, unknown>): Promise<T | null> {\n    void this.options;\n    throw new Error(NOT_IMPLEMENTED_MESSAGE);\n  }\n}\n\n/** Factory that mirrors `createStrapiClient` shape. Throws on first use. */\nexport function createRestClient(_options: RestClientOptions): RestStrapiClient {\n  throw new Error(NOT_IMPLEMENTED_MESSAGE);\n}\n"]}

package/dist/types/config.d.ts

@@ -20,7 +20,7 @@ export type TransportName = z.infer<typeof transportNameSchema>;
  */
 export declare const revalidateConfigSchema: z.ZodObject<{
     url: z.ZodString;
-    token: z.ZodString;
+    token: z.ZodOptional<z.ZodString>;
     webhook: z.ZodOptional<z.ZodObject<{
         secret: z.ZodOptional<z.ZodString>;
         tagMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
@@ -62,7 +62,6 @@ export declare const revalidateConfigSchema: z.ZodObject<{
     debug: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     url: string;
-    token: string;
     cache: {
         driver: "file" | "memory" | "redis";
         ttl: number;
@@ -75,6 +74,7 @@ export declare const revalidateConfigSchema: z.ZodObject<{
     timeout: number;
     retry: number;
     debug: boolean;
+    token?: string | undefined;
     webhook?: {
         secret?: string | undefined;
         tagMap?: Record<string, string[]> | undefined;
@@ -82,7 +82,7 @@ export declare const revalidateConfigSchema: z.ZodObject<{
     } | undefined;
 }, {
     url: string;
-    token: string;
+    token?: string | undefined;
     webhook?: {
         secret?: string | undefined;
         tagMap?: Record<string, string[]> | undefined;

package/dist/types/config.js

@@ -40,7 +40,7 @@ const webhookConfigSchema = z
  */
 export const revalidateConfigSchema = z.object({
     url: z.string().url(),
-    token: z.string().min(1),
+    token: z.string().min(1).optional(),
     webhook: webhookConfigSchema,
     cache: cacheConfigSchema,
     transport: transportNameSchema.default('graphql'),

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAGzE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAG/D,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,OAAO,CAAC,EAAE,CAAC,CAAC;AAEf,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,6EAA6E;IAC7E,+EAA+E;IAC/E,+EAA+E;IAC/E,iEAAiE;IACjE,YAAY,EAAE,CAAC;SACZ,MAAM,CACL,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,UAAU,CACnC;SACA,QAAQ,EAAE;CACd,CAAC;KACD,QAAQ,EAAE,CAAC;AAEd;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,mBAAmB;IAC5B,KAAK,EAAE,iBAAiB;IACxB,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAClC,CAAC,CAAC","sourcesContent":["/**\n * Runtime configuration schema for strapi-revalidate.\n *\n * Validated with zod so misconfigurations surface at startup rather than\n * at the first cache miss or webhook delivery.\n */\n\nimport { z } from 'zod';\nimport type { WebhookEvent } from '../webhook/types.js';\n\n/** Supported cache driver identifiers. */\nexport const cacheDriverNameSchema = z.enum(['file', 'memory', 'redis']);\nexport type CacheDriverName = z.infer<typeof cacheDriverNameSchema>;\n\n/** Supported transport identifiers for the Strapi client. */\nexport const transportNameSchema = z.enum(['graphql', 'rest']);\nexport type TransportName = z.infer<typeof transportNameSchema>;\n\nconst cacheConfigSchema = z\n  .object({\n    driver: cacheDriverNameSchema.default('file'),\n    ttl: z.number().int().positive().default(3600),\n    dir: z.string().default('.cache/strapi-revalidate'),\n    fallbackDir: z.string().default('.cache/strapi-fallback'),\n    redisUrl: z.string().url().optional(),\n    keyPrefix: z.string().optional(),\n  })\n  .default({});\n\nconst webhookConfigSchema = z\n  .object({\n    secret: z.string().optional(),\n    tagMap: z.record(z.array(z.string())).optional(),\n    // `z.function().args(...).returns(...)` is a zod v3-only chain — v4 reshaped\n    // the function schema API and removed it. Use `z.custom` instead so the schema\n    // loads under either major version. Runtime validation still ensures the value\n    // is a function; the TS-level signature carries the typed shape.\n    onRevalidate: z\n      .custom<(event: WebhookEvent) => void | Promise<void>>(\n        (val) => typeof val === 'function'\n      )\n      .optional(),\n  })\n  .optional();\n\n/**\n * Full runtime configuration schema.\n *\n * Use `revalidateConfigSchema.parse(input)` to validate user input and\n * apply defaults in one step.\n */\nexport const revalidateConfigSchema = z.object({\n  url: z.string().url(),\n  token: z.string().min(1),\n  webhook: webhookConfigSchema,\n  cache: cacheConfigSchema,\n  transport: transportNameSchema.default('graphql'),\n  timeout: z.number().int().positive().default(3000),\n  retry: z.number().int().min(0).default(2),\n  debug: z.boolean().default(false),\n});\n\n/** User-supplied configuration (pre-validation). */\nexport type RevalidateConfigInput = z.input<typeof revalidateConfigSchema>;\n\n/** Validated, defaults-applied configuration. */\nexport type RevalidateConfig = z.output<typeof revalidateConfigSchema>;\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAGzE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAG/D,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,OAAO,CAAC,EAAE,CAAC,CAAC;AAEf,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,6EAA6E;IAC7E,+EAA+E;IAC/E,+EAA+E;IAC/E,iEAAiE;IACjE,YAAY,EAAE,CAAC;SACZ,MAAM,CACL,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,UAAU,CACnC;SACA,QAAQ,EAAE;CACd,CAAC;KACD,QAAQ,EAAE,CAAC;AAEd;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,mBAAmB;IAC5B,KAAK,EAAE,iBAAiB;IACxB,SAAS,EAAE,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAClC,CAAC,CAAC","sourcesContent":["/**\n * Runtime configuration schema for strapi-revalidate.\n *\n * Validated with zod so misconfigurations surface at startup rather than\n * at the first cache miss or webhook delivery.\n */\n\nimport { z } from 'zod';\nimport type { WebhookEvent } from '../webhook/types.js';\n\n/** Supported cache driver identifiers. */\nexport const cacheDriverNameSchema = z.enum(['file', 'memory', 'redis']);\nexport type CacheDriverName = z.infer<typeof cacheDriverNameSchema>;\n\n/** Supported transport identifiers for the Strapi client. */\nexport const transportNameSchema = z.enum(['graphql', 'rest']);\nexport type TransportName = z.infer<typeof transportNameSchema>;\n\nconst cacheConfigSchema = z\n  .object({\n    driver: cacheDriverNameSchema.default('file'),\n    ttl: z.number().int().positive().default(3600),\n    dir: z.string().default('.cache/strapi-revalidate'),\n    fallbackDir: z.string().default('.cache/strapi-fallback'),\n    redisUrl: z.string().url().optional(),\n    keyPrefix: z.string().optional(),\n  })\n  .default({});\n\nconst webhookConfigSchema = z\n  .object({\n    secret: z.string().optional(),\n    tagMap: z.record(z.array(z.string())).optional(),\n    // `z.function().args(...).returns(...)` is a zod v3-only chain — v4 reshaped\n    // the function schema API and removed it. Use `z.custom` instead so the schema\n    // loads under either major version. Runtime validation still ensures the value\n    // is a function; the TS-level signature carries the typed shape.\n    onRevalidate: z\n      .custom<(event: WebhookEvent) => void | Promise<void>>(\n        (val) => typeof val === 'function'\n      )\n      .optional(),\n  })\n  .optional();\n\n/**\n * Full runtime configuration schema.\n *\n * Use `revalidateConfigSchema.parse(input)` to validate user input and\n * apply defaults in one step.\n */\nexport const revalidateConfigSchema = z.object({\n  url: z.string().url(),\n  token: z.string().min(1).optional(),\n  webhook: webhookConfigSchema,\n  cache: cacheConfigSchema,\n  transport: transportNameSchema.default('graphql'),\n  timeout: z.number().int().positive().default(3000),\n  retry: z.number().int().min(0).default(2),\n  debug: z.boolean().default(false),\n});\n\n/** User-supplied configuration (pre-validation). */\nexport type RevalidateConfigInput = z.input<typeof revalidateConfigSchema>;\n\n/** Validated, defaults-applied configuration. */\nexport type RevalidateConfig = z.output<typeof revalidateConfigSchema>;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datum-cloud/strapi-revalidate",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Framework-agnostic runtime cache invalidation for Strapi v5 in SSR frontends. Receives Strapi publish webhooks, clears affected cache tags, next request serves fresh data.",
   "keywords": [
     "strapi",