@datum-cloud/strapi-revalidate 0.1.0

package/.env.example

@@ -0,0 +1,5 @@
+STRAPI_URL=https://your-project.strapiapp.com
+STRAPI_TOKEN=your_api_token_here
+STRAPI_WEBHOOK_SECRET=your_webhook_secret_here
+STRAPI_CACHE_TTL=3600
+STRAPI_TIMEOUT=3

package/LICENSE

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display,
+     communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+     likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+     subject to the limitations in paragraph 4(a), below;
+  v. rights protecting the extraction, dissemination, use and reuse of data
+     in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+     European Parliament and of the Council of 11 March 1996 on the legal
+     protection of databases, and under any national implementation
+     thereof, including any amended or successor version of such
+     directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+     world based on applicable law or treaty, and any national
+     implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+    surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+    warranties of any kind concerning the Work, express, implied,
+    statutory or otherwise, including without limitation warranties of
+    title, merchantability, fitness for a particular purpose, non
+    infringement, or the absence of latent or other defects, accuracy, or
+    the present or absence of errors, whether or not discoverable, all to
+    the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of other persons
+    that may apply to the Work or any use thereof, including without
+    limitation any person's Copyright and Related Rights in the Work.
+    Further, Affirmer disclaims responsibility for obtaining any necessary
+    consents, permissions or other rights required for any use of the
+    Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+    party to this document and has no duty or obligation with respect to
+    this CC0 or use of the Work.

package/README.md

@@ -0,0 +1,227 @@
+# strapi-revalidate
+
+Keep your SSR frontend in sync with Strapi content — automatically.
+
+[![npm version](https://img.shields.io/npm/v/@datum-cloud/strapi-revalidate.svg)](https://www.npmjs.com/package/@datum-cloud/strapi-revalidate)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
+
+`strapi-revalidate` is a framework-agnostic Node.js library for SSR frontends using Strapi v5 as a headless CMS. It caches Strapi content locally (file, memory, or Redis), receives Strapi publish webhooks, and invalidates only the affected cache entries — so the next request always serves fresh data without a full rebuild or manual intervention. Battle-tested in production at [datum.net](https://datum.net).
+
+## How this differs from Strapi-side cache plugins
+
+**strapi-revalidate** solves a different problem than `strapi-cache`, `strapi-plugin-rest-cache`, and the dozens of similar Strapi plugins on npm and GitHub.
+
+Those are **Strapi plugins** — they install into `config/plugins.js`, run inside the Strapi server process, and cache Strapi's own API responses before they leave the server. They have no awareness of your frontend at all.
+
+**strapi-revalidate** lives in your **frontend SSR process** — Astro, Next.js, SvelteKit, Nuxt, Express, whatever. It caches the data your frontend fetches *from* Strapi, and invalidates that cache the moment Strapi publishes new content via webhook.
+
+The two approaches are complementary. If you're already running `strapi-cache` on your Strapi instance, keep it — `strapi-revalidate` works alongside it without conflict.
+
+## Install
+
+```bash
+npm install @datum-cloud/strapi-revalidate
+```
+
+## Quickstart
+
+Each snippet below is a complete, copy-pasteable example. Pick your framework.
+
+### Astro
+
+```ts
+// src/lib/strapi.ts
+import { createStrapiRevalidate } from '@datum-cloud/strapi-revalidate';
+
+export const { client, cache, webhook } = createStrapiRevalidate({
+  url: import.meta.env.STRAPI_URL,
+  token: import.meta.env.STRAPI_TOKEN,
+  webhook: { secret: import.meta.env.STRAPI_WEBHOOK_SECRET },
+});
+```
+
+```astro
+---
+// src/pages/blog/index.astro
+import { fetchArticles } from '@datum-cloud/strapi-revalidate/content';
+import { client, cache } from '../../lib/strapi';
+
+const articles = await fetchArticles({ client, cache });
+---
+<ul>
+  {articles.map((a) => <li><a href={`/blog/${a.slug}`}>{a.title}</a></li>)}
+</ul>
+```
+
+```ts
+// src/pages/api/strapi-webhook.ts
+import type { APIRoute } from 'astro';
+import { webhook } from '../../lib/strapi';
+
+export const POST: APIRoute = async ({ request }) => {
+  let status = 200;
+  let body: unknown = {};
+  await webhook(request, {
+    status: (code) => {
+      status = code;
+    },
+    json: (value) => {
+      body = value;
+    },
+  });
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  });
+};
+```
+
+### Next.js (App Router)
+
+```ts
+// lib/strapi.ts
+import { createStrapiRevalidate } from '@datum-cloud/strapi-revalidate';
+
+export const { client, cache, webhook } = createStrapiRevalidate({
+  url: process.env.STRAPI_URL!,
+  token: process.env.STRAPI_TOKEN!,
+  webhook: { secret: process.env.STRAPI_WEBHOOK_SECRET },
+});
+```
+
+```tsx
+// app/blog/page.tsx
+import { fetchArticles } from '@datum-cloud/strapi-revalidate/content';
+import { client, cache } from '@/lib/strapi';
+
+export default async function BlogPage() {
+  const articles = await fetchArticles({ client, cache });
+  return (
+    <ul>
+      {articles.map((a) => (
+        <li key={a.documentId}>
+          <a href={`/blog/${a.slug}`}>{a.title}</a>
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
+```ts
+// app/api/strapi-webhook/route.ts
+import { NextResponse } from 'next/server';
+import { webhook } from '@/lib/strapi';
+
+export async function POST(request: Request) {
+  let status = 200;
+  let body: unknown = {};
+  await webhook(request, {
+    status: (code) => {
+      status = code;
+    },
+    json: (value) => {
+      body = value;
+    },
+  });
+  return NextResponse.json(body, { status });
+}
+```
+
+### SvelteKit
+
+```ts
+// src/lib/strapi.ts
+import { createStrapiRevalidate } from '@datum-cloud/strapi-revalidate';
+import { env } from '$env/dynamic/private';
+
+export const { client, cache, webhook } = createStrapiRevalidate({
+  url: env.STRAPI_URL,
+  token: env.STRAPI_TOKEN,
+  webhook: { secret: env.STRAPI_WEBHOOK_SECRET },
+});
+```
+
+```ts
+// src/routes/blog/+page.server.ts
+import { fetchArticles } from '@datum-cloud/strapi-revalidate/content';
+import { client, cache } from '$lib/strapi';
+
+export const load = async () => {
+  const articles = await fetchArticles({ client, cache });
+  return { articles };
+};
+```
+
+```ts
+// src/routes/api/strapi-webhook/+server.ts
+import { json } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { webhook } from '$lib/strapi';
+
+export const POST: RequestHandler = async ({ request }) => {
+  let status = 200;
+  let body: unknown = {};
+  await webhook(request, {
+    status: (code) => {
+      status = code;
+    },
+    json: (value) => {
+      body = value;
+    },
+  });
+  return json(body, { status });
+};
+```
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `STRAPI_URL` | Yes | — | Your Strapi Cloud base URL |
+| `STRAPI_TOKEN` | Yes | — | Strapi API token (Settings → API Tokens) |
+| `STRAPI_WEBHOOK_SECRET` | Recommended | — | Secret set in Strapi webhook config |
+| `STRAPI_CACHE_TTL` | No | `3600` | Cache TTL in seconds |
+| `STRAPI_TIMEOUT` | No | `3` | Request timeout in seconds |
+
+## Strapi webhook setup
+
+1. In your Strapi Cloud admin, open **Settings → Webhooks → Add new webhook**.
+2. **Name**: `strapi-revalidate` (or whatever you like).
+3. **URL**: the public URL of the API route you mounted in the quickstart, e.g. `https://example.com/api/strapi-webhook`.
+4. **Headers**: add `Authorization: Bearer <STRAPI_WEBHOOK_SECRET>` so the handler can verify the source. The handler also accepts `X-Strapi-Signature` or `strapi-webhook-secret` headers if you'd rather not use `Authorization`.
+5. **Events**: enable at minimum `entry.publish`, `entry.unpublish`, and `entry.update`. Add `entry.delete` if you want deletions to clear cache too.
+6. Save the webhook. Publish any entry — within seconds, the matching cache tags are cleared and the next request serves fresh data.
+
+<!-- screenshot: strapi-webhook-config -->
+
+## Cache drivers
+
+| Driver | Default | Use case |
+|---|---|---|
+| `file` | ✓ | Single-instance servers. Survives process restarts. |
+| `memory` | | Dev and testing. Fast, lost on restart. |
+| `redis` | | Multi-instance / edge deploys. Requires `ioredis`. Coming v1.x. |
+
+Select a driver via `cache.driver` in config:
+
+```ts
+createStrapiRevalidate({
+  url: process.env.STRAPI_URL!,
+  token: process.env.STRAPI_TOKEN!,
+  cache: { driver: 'memory' },
+});
+```
+
+## How the fallback cache works
+
+Every successful Strapi fetch writes to **two** caches: the primary TTL cache (configurable expiry, cleared by webhook) and a persistent fallback cache (no expiry, file-backed). If Strapi is unreachable on a future fetch, the fallback serves stale data instead of throwing or returning empty — keeping your site online during Strapi outages or deploys. The fallback is on by default and cannot be disabled.
+
+## Contributing
+
+Issues and PRs welcome at [github.com/datum-cloud/strapi-revalidate](https://github.com/datum-cloud/strapi-revalidate/issues). This library was extracted from production code at [datum.net](https://datum.net); contributions that keep the public surface small and the dependencies few are especially appreciated.
+
+## License
+
+MIT

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

@@ -0,0 +1,37 @@
+/**
+ * Filesystem cache driver.
+ *
+ * Adapted from datum.net's production `Cache` class. Preserves the original
+ * behaviour:
+ *  - one `.json` payload file per key
+ *  - sibling `.expires` file storing the absolute expiry timestamp (ms)
+ *  - empty-file guard: a zero-length cache file is auto-cleared
+ *  - ENOENT is silent; other read errors clear the corrupt entry
+ *
+ * Tag membership is persisted alongside the payload in a sidecar `.tags` file
+ * so `deleteByTag` survives process restarts.
+ */
+import type { CacheDriver, CacheSetOptions } from '../types.js';
+/** Configuration for the file driver. */
+export interface FileDriverOptions {
+    /** Directory where cache files live. Created on first write. */
+    dir: string;
+}
+/** Filesystem-backed `CacheDriver`. */
+export declare class FileCacheDriver implements CacheDriver {
+    private readonly dir;
+    constructor(options: FileDriverOptions);
+    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[]>;
+    private payloadPath;
+    private expiresPath;
+    private tagsPath;
+    private ensureDir;
+    private readTags;
+    private silentUnlink;
+}
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMhE,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,uCAAuC;AACvC,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,EAAE,iBAAiB;IAIhC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAsCtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB1E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe9C,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;YAIF,SAAS;YAIT,QAAQ;YAUR,YAAY;CAO3B"}

package/dist/cache/drivers/file.js

@@ -0,0 +1,151 @@
+/**
+ * Filesystem cache driver.
+ *
+ * Adapted from datum.net's production `Cache` class. Preserves the original
+ * behaviour:
+ *  - one `.json` payload file per key
+ *  - sibling `.expires` file storing the absolute expiry timestamp (ms)
+ *  - empty-file guard: a zero-length cache file is auto-cleared
+ *  - ENOENT is silent; other read errors clear the corrupt entry
+ *
+ * Tag membership is persisted alongside the payload in a sidecar `.tags` file
+ * so `deleteByTag` survives process restarts.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const PAYLOAD_EXT = '.json';
+const EXPIRES_EXT = '.expires';
+const TAGS_EXT = '.tags';
+/** Filesystem-backed `CacheDriver`. */
+export class FileCacheDriver {
+    dir;
+    constructor(options) {
+        this.dir = options.dir;
+    }
+    async get(key) {
+        const filePath = this.payloadPath(key);
+        const expiresPath = this.expiresPath(key);
+        try {
+            const data = await fs.readFile(filePath, 'utf-8');
+            // Empty-file guard preserved from datum.net Cache.
+            if (!data.trim()) {
+                console.warn(`Cache file for key "${key}" is empty, clearing cache`);
+                await this.delete(key);
+                return null;
+            }
+            let expirationTime = null;
+            try {
+                const expiresData = await fs.readFile(expiresPath, 'utf-8');
+                expirationTime = JSON.parse(expiresData);
+            }
+            catch {
+                // No expires file — treat as no expiry.
+            }
+            if (expirationTime !== null && Date.now() > expirationTime) {
+                await this.delete(key);
+                return null;
+            }
+            return JSON.parse(data);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            console.warn(`Failed to read cache file for key "${key}":`, err);
+            await this.delete(key);
+            return null;
+        }
+    }
+    async set(key, data, options = {}) {
+        await this.ensureDir();
+        const filePath = this.payloadPath(key);
+        await fs.writeFile(filePath, JSON.stringify(data), 'utf-8');
+        if (typeof options.ttl === 'number' && options.ttl > 0) {
+            const expirationTime = Date.now() + options.ttl * 1000;
+            await fs.writeFile(this.expiresPath(key), JSON.stringify(expirationTime), 'utf-8');
+        }
+        else {
+            // If a previous entry had an expiry, remove it so the new entry is treated as permanent.
+            await this.silentUnlink(this.expiresPath(key));
+        }
+        if (options.tags && options.tags.length > 0) {
+            await fs.writeFile(this.tagsPath(key), JSON.stringify(options.tags), 'utf-8');
+        }
+        else {
+            await this.silentUnlink(this.tagsPath(key));
+        }
+    }
+    async delete(key) {
+        await Promise.all([
+            this.silentUnlink(this.payloadPath(key)),
+            this.silentUnlink(this.expiresPath(key)),
+            this.silentUnlink(this.tagsPath(key)),
+        ]);
+    }
+    async deleteByTag(tag) {
+        const keys = await this.keys();
+        await Promise.all(keys.map(async (key) => {
+            const tags = await this.readTags(key);
+            if (tags.includes(tag)) {
+                await this.delete(key);
+            }
+        }));
+    }
+    async clear() {
+        try {
+            const files = await fs.readdir(this.dir);
+            await Promise.all(files.map((file) => this.silentUnlink(path.join(this.dir, file))));
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+    }
+    async keys(prefix) {
+        try {
+            const files = await fs.readdir(this.dir);
+            const keys = files
+                .filter((file) => file.endsWith(PAYLOAD_EXT))
+                .map((file) => path.basename(file, PAYLOAD_EXT));
+            return prefix ? keys.filter((k) => k.startsWith(prefix)) : keys;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return [];
+            }
+            throw err;
+        }
+    }
+    payloadPath(key) {
+        return path.join(this.dir, `${key}${PAYLOAD_EXT}`);
+    }
+    expiresPath(key) {
+        return path.join(this.dir, `${key}${EXPIRES_EXT}`);
+    }
+    tagsPath(key) {
+        return path.join(this.dir, `${key}${TAGS_EXT}`);
+    }
+    async ensureDir() {
+        await fs.mkdir(this.dir, { recursive: true });
+    }
+    async readTags(key) {
+        try {
+            const raw = await fs.readFile(this.tagsPath(key), 'utf-8');
+            const parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed.filter((t) => typeof t === 'string') : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    async silentUnlink(filePath) {
+        try {
+            await fs.unlink(filePath);
+        }
+        catch {
+            // ENOENT and similar — ignore.
+        }
+    }
+}
+//# sourceMappingURL=file.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * In-memory cache driver.
+ *
+ * Intended for development, testing, and short-lived serverless functions
+ * where process restarts naturally evict the cache. Not suitable for
+ * multi-instance deployments — use the redis driver for that.
+ */
+import type { CacheDriver, CacheSetOptions } from '../types.js';
+/** Map-based in-memory `CacheDriver`. */
+export declare class MemoryCacheDriver implements CacheDriver {
+    private readonly store;
+    private readonly tagIndex;
+    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=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWhE,yCAAyC;AACzC,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAErD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAYtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAI/C"}

package/dist/cache/drivers/memory.js

@@ -0,0 +1,76 @@
+/**
+ * In-memory cache driver.
+ *
+ * Intended for development, testing, and short-lived serverless functions
+ * where process restarts naturally evict the cache. Not suitable for
+ * multi-instance deployments — use the redis driver for that.
+ */
+/** Map-based in-memory `CacheDriver`. */
+export class MemoryCacheDriver {
+    store = new Map();
+    tagIndex = new Map();
+    async get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        if (entry.expiresAt !== null && Date.now() > entry.expiresAt) {
+            await this.delete(key);
+            return null;
+        }
+        return entry.data;
+    }
+    async set(key, data, options = {}) {
+        // Detach old tags first so reassignments don't leak.
+        const previous = this.store.get(key);
+        if (previous) {
+            for (const tag of previous.tags) {
+                this.tagIndex.get(tag)?.delete(key);
+            }
+        }
+        const expiresAt = typeof options.ttl === 'number' && options.ttl > 0 ? Date.now() + options.ttl * 1000 : null;
+        const tags = new Set(options.tags ?? []);
+        this.store.set(key, { data, expiresAt, tags });
+        for (const tag of tags) {
+            let bucket = this.tagIndex.get(tag);
+            if (!bucket) {
+                bucket = new Set();
+                this.tagIndex.set(tag, bucket);
+            }
+            bucket.add(key);
+        }
+    }
+    async delete(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return;
+        for (const tag of entry.tags) {
+            const bucket = this.tagIndex.get(tag);
+            if (bucket) {
+                bucket.delete(key);
+                if (bucket.size === 0) {
+                    this.tagIndex.delete(tag);
+                }
+            }
+        }
+        this.store.delete(key);
+    }
+    async deleteByTag(tag) {
+        const bucket = this.tagIndex.get(tag);
+        if (!bucket)
+            return;
+        // Materialize before iterating — delete() mutates the bucket.
+        const keys = Array.from(bucket);
+        for (const key of keys) {
+            await this.delete(key);
+        }
+    }
+    async clear() {
+        this.store.clear();
+        this.tagIndex.clear();
+    }
+    async keys(prefix) {
+        const keys = Array.from(this.store.keys());
+        return prefix ? keys.filter((k) => k.startsWith(prefix)) : keys;
+    }
+}
+//# sourceMappingURL=memory.js.map

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

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