@classytic/arc 2.3.0 → 2.4.2

package/dist/plugins/index.mjs

@@ -1,75 +1,191 @@
-import { p as MUTATION_OPERATIONS } from "../constants-DdXFXQtN.mjs";
-import { r as getOrgId } from "../types-Beqn1Un7.mjs";
-import { t as HookSystem } from "../HookSystem-BsGV-j2l.mjs";
-import { t as hasEvents } from "../typeGuards-DwxA1t_L.mjs";
-import { t as requestContext } from "../requestContext-xi6OKBL-.mjs";
-import { t as ResourceRegistry } from "../ResourceRegistry-7Ic20ZMw.mjs";
-import { t as errorHandlerPlugin } from "../errorHandler-C3GY3_ow.mjs";
-import { n as caching_default, t as cachingPlugin } from "../caching-GSDJcA6-.mjs";
-import { n as sse_default, t as ssePlugin } from "../sse-DkqQ1uxb.mjs";
+import { p as MUTATION_OPERATIONS } from "../constants-Cxde4rpC.mjs";
+import { r as getOrgId } from "../types-C6TQjtdi.mjs";
+import { t as requestContext } from "../requestContext-DYtmNpm5.mjs";
+import { t as hasEvents } from "../typeGuards-Cj5Rgvlg.mjs";
+import { t as HookSystem } from "../HookSystem-COkyWztM.mjs";
+import { t as ResourceRegistry } from "../ResourceRegistry-DeCIFlix.mjs";
+import { n as caching_default, t as cachingPlugin } from "../caching-BSXB-Xr7.mjs";
+import { t as errorHandlerPlugin } from "../errorHandler--zp54tGc.mjs";
+import { n as metrics_default, t as metricsPlugin } from "../metrics-Csh4nsvv.mjs";
+import { n as sse_default, t as ssePlugin } from "../sse-BkViJPlT.mjs";
+import { n as versioning_default, t as versioningPlugin } from "../versioning-BzfeHmhj.mjs";
+import { randomUUID } from "node:crypto";
 import fp from "fastify-plugin";
-import { randomUUID } from "crypto";
-
-//#region src/plugins/requestId.ts
+//#region src/core/arcCorePlugin.ts
+const arcCorePlugin = async (fastify, opts = {}) => {
+	const { emitEvents = true, hookSystem, registry } = opts;
+	const actualHookSystem = hookSystem ?? new HookSystem();
+	const actualRegistry = registry ?? new ResourceRegistry();
+	fastify.decorate("arc", {
+		hooks: actualHookSystem,
+		registry: actualRegistry,
+		emitEvents,
+		externalOpenApiPaths: [],
+		plugins: /* @__PURE__ */ new Map()
+	});
+	fastify.addHook("onRequest", (request, _reply, done) => {
+		const store = {
+			requestId: request.id,
+			startTime: performance.now()
+		};
+		requestContext.storage.run(store, done);
+	});
+	fastify.addHook("preHandler", (request, _reply, done) => {
+		const store = requestContext.get();
+		if (store) {
+			store.user = request.user ?? null;
+			store.organizationId = request.scope?.kind === "member" ? request.scope.organizationId : request.scope?.kind === "elevated" ? request.scope.organizationId : void 0;
+		}
+		done();
+	});
+	if (emitEvents) {
+		const eventOperations = MUTATION_OPERATIONS;
+		for (const operation of eventOperations) actualHookSystem.after("*", operation, async (ctx) => {
+			if (!hasEvents(fastify)) return;
+			const store = requestContext.get();
+			const eventType = `${ctx.resource}.${operation}d`;
+			const userId = ctx.user?.id ?? ctx.user?._id;
+			const organizationId = ctx.context?._scope ? getOrgId(ctx.context._scope) : void 0;
+			const payload = {
+				resource: ctx.resource,
+				operation: ctx.operation,
+				data: ctx.result,
+				userId,
+				organizationId,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			};
+			try {
+				await fastify.events.publish(eventType, payload, {
+					correlationId: store?.requestId,
+					resource: ctx.resource,
+					resourceId: extractId(ctx.result),
+					userId: userId ? String(userId) : void 0,
+					organizationId
+				});
+			} catch (error) {
+				fastify.log?.warn?.({
+					eventType,
+					error
+				}, "Failed to emit event");
+			}
+		});
+	}
+	fastify.addHook("onReady", async () => {
+		if (!hasEvents(fastify)) return;
+		try {
+			await fastify.events.publish("arc.ready", {
+				resources: actualRegistry.getAll().length,
+				hooks: actualHookSystem.getAll().length,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString()
+			});
+		} catch {}
+	});
+	fastify.addHook("onClose", async () => {
+		actualHookSystem.clear();
+		actualRegistry._clear();
+	});
+	fastify.log?.debug?.("Arc core plugin enabled (instance-scoped hooks & registry)");
+};
+/** Extract document ID from a result (handles Mongoose docs and plain objects) */
+function extractId(doc) {
+	if (!doc || typeof doc !== "object") return void 0;
+	const d = doc;
+	const rawId = d._id ?? d.id;
+	return rawId ? String(rawId) : void 0;
+}
+var arcCorePlugin_default = fp(arcCorePlugin, {
+	name: "arc-core",
+	fastify: "5.x"
+});
+//#endregion
+//#region src/plugins/createPlugin.ts
 /**
-* Request ID Plugin
-*
-* Propagates request IDs for distributed tracing.
-* - Accepts incoming x-request-id header
-* - Generates UUID if not provided
-* - Attaches to request.id and response header
-*
-* @example
-* import { requestIdPlugin } from '@classytic/arc';
-*
-* await fastify.register(requestIdPlugin);
+* Create a structured plugin with forRoot (global) and forResource (per-resource) support.
 *
-* // In handlers, access via request.id
-* fastify.get('/', async (request) => {
-*   console.log(request.id); // UUID
-* });
+* @param name - Plugin name (used for Fastify registration and debugging)
+* @param definition - Plugin setup functions
+* @returns ArcPlugin with forRoot() and forResource() methods
 */
-const requestIdPlugin = async (fastify, opts = {}) => {
-	const { header = "x-request-id", generator = randomUUID, setResponseHeader = true } = opts;
-	if (!fastify.hasRequestDecorator("requestId")) fastify.decorateRequest("requestId", "");
-	fastify.addHook("onRequest", async (request) => {
-		const incomingId = request.headers[header];
-		const sanitized = typeof incomingId === "string" ? incomingId.trim() : "";
-		const requestId = sanitized.length > 0 && sanitized.length <= 128 && /^[\w.:-]+$/.test(sanitized) ? sanitized : generator();
-		request.id = requestId;
-		request.requestId = requestId;
+function createPlugin(name, definition) {
+	return {
+		name,
+		forRoot(opts) {
+			const plugin = async (fastify, pluginOpts) => {
+				const mergedOpts = {
+					...opts,
+					...pluginOpts
+				};
+				if (definition.forRoot) await definition.forRoot(fastify, mergedOpts);
+			};
+			return fp(plugin, {
+				name: `arc-plugin-${name}`,
+				fastify: "5.x"
+			});
+		},
+		forResource(opts) {
+			if (!definition.forResource) return {};
+			return definition.forResource({}, opts ?? {});
+		}
+	};
+}
+//#endregion
+//#region src/plugins/gracefulShutdown.ts
+const gracefulShutdownPlugin = async (fastify, opts = {}) => {
+	const { timeout = 3e4, onShutdown, signals = ["SIGTERM", "SIGINT"], logEvents = true, onForceExit = () => process.exit(1) } = opts;
+	let isShuttingDown = false;
+	const signalHandlers = /* @__PURE__ */ new Map();
+	const shutdown = async (signal) => {
+		if (isShuttingDown) {
+			if (logEvents) fastify.log?.warn?.({ signal }, "Shutdown already in progress, ignoring signal");
+			return;
+		}
+		isShuttingDown = true;
+		if (logEvents) fastify.log?.info?.({
+			signal,
+			timeout
+		}, "Shutdown signal received, starting graceful shutdown");
+		const forceExitTimer = setTimeout(() => {
+			if (logEvents) fastify.log?.error?.("Graceful shutdown timeout exceeded, forcing exit");
+			onForceExit("timeout");
+		}, timeout);
+		forceExitTimer.unref();
+		try {
+			if (logEvents) fastify.log?.info?.("Closing server to new connections");
+			await fastify.close();
+			if (onShutdown) {
+				if (logEvents) fastify.log?.info?.("Running custom shutdown handler");
+				await onShutdown();
+			}
+			if (logEvents) fastify.log?.info?.("Graceful shutdown complete");
+			clearTimeout(forceExitTimer);
+		} catch (err) {
+			if (logEvents) fastify.log?.error?.({ error: err.message }, "Error during shutdown");
+			clearTimeout(forceExitTimer);
+			onForceExit("error");
+		}
+	};
+	for (const signal of signals) {
+		const handler = () => {
+			shutdown(signal);
+		};
+		signalHandlers.set(signal, handler);
+		process.on(signal, handler);
+	}
+	fastify.addHook("onClose", async () => {
+		for (const [signal, handler] of signalHandlers) process.removeListener(signal, handler);
+		signalHandlers.clear();
 	});
-	if (setResponseHeader) fastify.addHook("onSend", async (request, reply) => {
-		reply.header(header, request.requestId);
+	fastify.decorate("shutdown", async () => {
+		await shutdown("MANUAL");
 	});
-	fastify.log?.debug?.("Request ID plugin registered");
+	if (logEvents) fastify.log?.debug?.({ signals }, "Graceful shutdown plugin registered");
 };
-var requestId_default = fp(requestIdPlugin, {
-	name: "arc-request-id",
+var gracefulShutdown_default = fp(gracefulShutdownPlugin, {
+	name: "arc-graceful-shutdown",
 	fastify: "5.x"
 });
-
 //#endregion
 //#region src/plugins/health.ts
-/**
-* Health Check Plugin
-*
-* Kubernetes-ready health endpoints:
-* - /health/live  - Liveness probe (is the process alive?)
-* - /health/ready - Readiness probe (can we serve traffic?)
-* - /health/metrics - Prometheus metrics (optional)
-*
-* @example
-* import { healthPlugin } from '@classytic/arc';
-*
-* await fastify.register(healthPlugin, {
-*   prefix: '/_health',
-*   checks: [
-*     { name: 'mongodb', check: async () => mongoose.connection.readyState === 1 },
-*     { name: 'redis', check: async () => redis.ping() === 'PONG' },
-*   ],
-* });
-*/
 function createHttpMetrics() {
 	return {
 		requestsTotal: {},
@@ -253,270 +369,44 @@ var health_default = fp(healthPlugin, {
 	name: "arc-health",
 	fastify: "5.x"
 });
-
 //#endregion
-//#region src/plugins/gracefulShutdown.ts
-/**
-* Graceful Shutdown Plugin
-*
-* Handles SIGTERM and SIGINT signals for clean shutdown:
-* - Stops accepting new connections
-* - Waits for in-flight requests to complete
-* - Closes database connections
-* - Exits cleanly
-*
-* Essential for Kubernetes deployments.
-*
-* @example
-* import { gracefulShutdownPlugin } from '@classytic/arc';
-*
-* // Production
-* await fastify.register(gracefulShutdownPlugin, {
-*   timeout: 30000, // 30 seconds max
-*   onShutdown: async () => {
-*     await mongoose.disconnect();
-*     await redis.quit();
-*   },
-* });
-*
-* // Tests — prevent process.exit from killing the runner
-* await fastify.register(gracefulShutdownPlugin, {
-*   onForceExit: () => {},
-* });
-*/
-const gracefulShutdownPlugin = async (fastify, opts = {}) => {
-	const { timeout = 3e4, onShutdown, signals = ["SIGTERM", "SIGINT"], logEvents = true, onForceExit = () => process.exit(1) } = opts;
-	let isShuttingDown = false;
-	const signalHandlers = /* @__PURE__ */ new Map();
-	const shutdown = async (signal) => {
-		if (isShuttingDown) {
-			if (logEvents) fastify.log?.warn?.({ signal }, "Shutdown already in progress, ignoring signal");
-			return;
-		}
-		isShuttingDown = true;
-		if (logEvents) fastify.log?.info?.({
-			signal,
-			timeout
-		}, "Shutdown signal received, starting graceful shutdown");
-		const forceExitTimer = setTimeout(() => {
-			if (logEvents) fastify.log?.error?.("Graceful shutdown timeout exceeded, forcing exit");
-			onForceExit("timeout");
-		}, timeout);
-		forceExitTimer.unref();
-		try {
-			if (logEvents) fastify.log?.info?.("Closing server to new connections");
-			await fastify.close();
-			if (onShutdown) {
-				if (logEvents) fastify.log?.info?.("Running custom shutdown handler");
-				await onShutdown();
-			}
-			if (logEvents) fastify.log?.info?.("Graceful shutdown complete");
-			clearTimeout(forceExitTimer);
-		} catch (err) {
-			if (logEvents) fastify.log?.error?.({ error: err.message }, "Error during shutdown");
-			clearTimeout(forceExitTimer);
-			onForceExit("error");
-		}
-	};
-	for (const signal of signals) {
-		const handler = () => {
-			shutdown(signal);
-		};
-		signalHandlers.set(signal, handler);
-		process.on(signal, handler);
-	}
-	fastify.addHook("onClose", async () => {
-		for (const [signal, handler] of signalHandlers) process.removeListener(signal, handler);
-		signalHandlers.clear();
-	});
-	fastify.decorate("shutdown", async () => {
-		await shutdown("MANUAL");
-	});
-	if (logEvents) fastify.log?.debug?.({ signals }, "Graceful shutdown plugin registered");
-};
-var gracefulShutdown_default = fp(gracefulShutdownPlugin, {
-	name: "arc-graceful-shutdown",
-	fastify: "5.x"
-});
-
-//#endregion
-//#region src/plugins/createPlugin.ts
-/**
-* createPlugin() — forRoot/forFeature Pattern
-*
-* Standard pattern for plugins that need both global setup and per-resource configuration.
-* Inspired by NestJS forRoot/forFeature but simpler — plain functions, no decorators.
-*
-* @example
-* ```typescript
-* // Define a plugin with global + per-resource config
-* const analytics = createPlugin('analytics', {
-*   forRoot: async (fastify, opts) => {
-*     // Global setup: connect to analytics service, add decorators
-*     const client = new AnalyticsClient(opts.apiKey);
-*     fastify.decorate('analytics', client);
-*   },
-*   forResource: (resourceConfig, opts) => {
-*     // Per-resource: return hooks, middleware, or routes
-*     return {
-*       hooks: [{
-*         operation: 'create', phase: 'after', priority: 100,
-*         handler: (ctx) => client.track('created', ctx.result),
-*       }],
-*     };
-*   },
-* });
-*
-* // Usage — register globally once
-* await app.register(analytics.forRoot({ apiKey: 'xxx' }));
-*
-* // Then apply per-resource
-* const productResource = defineResource({
-*   name: 'product',
-*   adapter: productAdapter,
-*   ...analytics.forResource({ trackEvents: true }),
-* });
-* ```
-*/
-/**
-* Create a structured plugin with forRoot (global) and forResource (per-resource) support.
-*
-* @param name - Plugin name (used for Fastify registration and debugging)
-* @param definition - Plugin setup functions
-* @returns ArcPlugin with forRoot() and forResource() methods
-*/
-function createPlugin(name, definition) {
-	return {
-		name,
-		forRoot(opts) {
-			const plugin = async (fastify, pluginOpts) => {
-				const mergedOpts = {
-					...opts,
-					...pluginOpts
-				};
-				if (definition.forRoot) await definition.forRoot(fastify, mergedOpts);
-			};
-			return fp(plugin, {
-				name: `arc-plugin-${name}`,
-				fastify: "5.x"
-			});
-		},
-		forResource(opts) {
-			if (!definition.forResource) return {};
-			return definition.forResource({}, opts ?? {});
-		}
-	};
-}
-
-//#endregion
-//#region src/core/arcCorePlugin.ts
+//#region src/plugins/requestId.ts
 /**
-* Arc Core Plugin
-*
-* Sets up instance-scoped Arc systems:
-* - HookSystem: Lifecycle hooks per app instance
-* - ResourceRegistry: Resource tracking per app instance
-* - Event integration: Wires CRUD operations to fastify.events
+* Request ID Plugin
 *
-* This solves the global singleton leak problem where multiple
-* app instances (e.g., in tests) would share state.
+* Propagates request IDs for distributed tracing.
+* - Accepts incoming x-request-id header
+* - Generates UUID if not provided
+* - Attaches to request.id and response header
 *
 * @example
-* import { arcCorePlugin } from '@classytic/arc';
+* import { requestIdPlugin } from '@classytic/arc';
 *
-* const app = Fastify();
-* await app.register(arcCorePlugin);
+* await fastify.register(requestIdPlugin);
 *
-* // Now use instance-scoped hooks
-* app.arc.hooks.before('product', 'create', async (ctx) => {
-*   ctx.data.slug = slugify(ctx.data.name);
+* // In handlers, access via request.id
+* fastify.get('/', async (request) => {
+*   console.log(request.id); // UUID
 * });
 */
-const arcCorePlugin = async (fastify, opts = {}) => {
-	const { emitEvents = true, hookSystem, registry } = opts;
-	const actualHookSystem = hookSystem ?? new HookSystem();
-	const actualRegistry = registry ?? new ResourceRegistry();
-	fastify.decorate("arc", {
-		hooks: actualHookSystem,
-		registry: actualRegistry,
-		emitEvents,
-		externalOpenApiPaths: [],
-		plugins: /* @__PURE__ */ new Map()
-	});
-	fastify.addHook("onRequest", (request, _reply, done) => {
-		const store = {
-			requestId: request.id,
-			startTime: performance.now()
-		};
-		requestContext.storage.run(store, done);
-	});
-	fastify.addHook("preHandler", (request, _reply, done) => {
-		const store = requestContext.get();
-		if (store) {
-			store.user = request.user ?? null;
-			store.organizationId = request.scope?.kind === "member" ? request.scope.organizationId : request.scope?.kind === "elevated" ? request.scope.organizationId : void 0;
-		}
-		done();
-	});
-	if (emitEvents) {
-		const eventOperations = MUTATION_OPERATIONS;
-		for (const operation of eventOperations) actualHookSystem.after("*", operation, async (ctx) => {
-			if (!hasEvents(fastify)) return;
-			const store = requestContext.get();
-			const eventType = `${ctx.resource}.${operation}d`;
-			const userId = ctx.user?.id ?? ctx.user?._id;
-			const organizationId = ctx.context?._scope ? getOrgId(ctx.context._scope) : void 0;
-			const payload = {
-				resource: ctx.resource,
-				operation: ctx.operation,
-				data: ctx.result,
-				userId,
-				organizationId,
-				timestamp: (/* @__PURE__ */ new Date()).toISOString()
-			};
-			try {
-				await fastify.events.publish(eventType, payload, {
-					correlationId: store?.requestId,
-					resource: ctx.resource,
-					resourceId: extractId(ctx.result),
-					userId: userId ? String(userId) : void 0,
-					organizationId
-				});
-			} catch (error) {
-				fastify.log?.warn?.({
-					eventType,
-					error
-				}, "Failed to emit event");
-			}
-		});
-	}
-	fastify.addHook("onReady", async () => {
-		if (!hasEvents(fastify)) return;
-		try {
-			await fastify.events.publish("arc.ready", {
-				resources: actualRegistry.getAll().length,
-				hooks: actualHookSystem.getAll().length,
-				timestamp: (/* @__PURE__ */ new Date()).toISOString()
-			});
-		} catch {}
+const requestIdPlugin = async (fastify, opts = {}) => {
+	const { header = "x-request-id", generator = randomUUID, setResponseHeader = true } = opts;
+	if (!fastify.hasRequestDecorator("requestId")) fastify.decorateRequest("requestId", "");
+	fastify.addHook("onRequest", async (request) => {
+		const incomingId = request.headers[header];
+		const sanitized = typeof incomingId === "string" ? incomingId.trim() : "";
+		const requestId = sanitized.length > 0 && sanitized.length <= 128 && /^[\w.:-]+$/.test(sanitized) ? sanitized : generator();
+		request.id = requestId;
+		request.requestId = requestId;
 	});
-	fastify.addHook("onClose", async () => {
-		actualHookSystem.clear();
-		actualRegistry._clear();
+	if (setResponseHeader) fastify.addHook("onSend", async (request, reply) => {
+		reply.header(header, request.requestId);
 	});
-	fastify.log?.debug?.("Arc core plugin enabled (instance-scoped hooks & registry)");
+	fastify.log?.debug?.("Request ID plugin registered");
 };
-/** Extract document ID from a result (handles Mongoose docs and plain objects) */
-function extractId(doc) {
-	if (!doc || typeof doc !== "object") return void 0;
-	const d = doc;
-	const rawId = d._id ?? d.id;
-	return rawId ? String(rawId) : void 0;
-}
-var arcCorePlugin_default = fp(arcCorePlugin, {
-	name: "arc-core",
+var requestId_default = fp(requestIdPlugin, {
+	name: "arc-request-id",
 	fastify: "5.x"
 });
-
 //#endregion
-export { arcCorePlugin_default as arcCorePlugin, arcCorePlugin as arcCorePluginFn, caching_default as cachingPlugin, cachingPlugin as cachingPluginFn, createPlugin, errorHandlerPlugin, errorHandlerPlugin as errorHandlerPluginFn, gracefulShutdown_default as gracefulShutdownPlugin, gracefulShutdownPlugin as gracefulShutdownPluginFn, health_default as healthPlugin, healthPlugin as healthPluginFn, requestId_default as requestIdPlugin, requestIdPlugin as requestIdPluginFn, sse_default as ssePlugin, ssePlugin as ssePluginFn };
+export { arcCorePlugin_default as arcCorePlugin, arcCorePlugin as arcCorePluginFn, caching_default as cachingPlugin, cachingPlugin as cachingPluginFn, createPlugin, errorHandlerPlugin, errorHandlerPlugin as errorHandlerPluginFn, gracefulShutdown_default as gracefulShutdownPlugin, gracefulShutdownPlugin as gracefulShutdownPluginFn, health_default as healthPlugin, healthPlugin as healthPluginFn, metrics_default as metricsPlugin, metricsPlugin as metricsPluginFn, requestId_default as requestIdPlugin, requestIdPlugin as requestIdPluginFn, sse_default as ssePlugin, ssePlugin as ssePluginFn, versioning_default as versioningPlugin, versioningPlugin as versioningPluginFn };

package/dist/plugins/response-cache.mjs

@@ -1,71 +1,7 @@
-import { t as hasEvents } from "../typeGuards-DwxA1t_L.mjs";
+import { t as hasEvents } from "../typeGuards-Cj5Rgvlg.mjs";
 import fp from "fastify-plugin";
-
 //#region src/plugins/response-cache.ts
 /**
-* Response Cache Plugin for Arc
-*
-* In-memory LRU/TTL response cache that sits in front of your database.
-* Caches serialized responses for GET requests, dramatically reducing DB load
-* for frequently accessed resources.
-*
-* Features:
-* - LRU eviction with configurable max entries
-* - Per-route TTL configuration
-* - Automatic invalidation on mutations (POST/PUT/PATCH/DELETE)
-* - Manual invalidation via `fastify.responseCache.invalidate()`
-* - Cache stats endpoint for monitoring
-* - Zero external deps — pure in-memory, serverless-safe
-*
-* NOTE: This cache is per-instance (in-memory). In multi-instance deployments,
-* each instance maintains its own cache. For cross-instance invalidation,
-* wire `fastify.responseCache.invalidate()` to your event bus manually.
-*
-* ## Auth Safety
-*
-* The cache check runs as a **route-level middleware** (`responseCache.middleware`)
-* that must be wired AFTER authentication in the preHandler chain. Arc's
-* `createCrudRouter` does this automatically. For custom routes, wire it
-* manually:
-*
-* ```typescript
-* fastify.get('/data', {
-*   preHandler: [fastify.authenticate, fastify.responseCache.middleware],
-* }, handler);
-* ```
-*
-* This ensures cached responses are never served before auth validates the
-* caller's identity. The default cache key includes `userId` and `orgId`
-* to prevent cross-caller data leaks.
-*
-* This is a SEPARATE subpath import — only loaded when explicitly used:
-*   import { responseCachePlugin } from '@classytic/arc/plugins/response-cache';
-*
-* @example
-* ```typescript
-* import { responseCachePlugin } from '@classytic/arc/plugins/response-cache';
-*
-* await fastify.register(responseCachePlugin, {
-*   maxEntries: 1000,
-*   defaultTTL: 30,       // 30 seconds
-*   rules: [
-*     { match: '/api/products', ttl: 120 },         // 2 min for products
-*     { match: '/api/categories', ttl: 300 },        // 5 min for categories
-*     { match: '/api/users', ttl: 0 },               // never cache users
-*   ],
-*   invalidateOn: ['POST', 'PUT', 'PATCH', 'DELETE'],
-* });
-*
-* // Manual invalidation
-* fastify.responseCache.invalidate('/api/products');
-* fastify.responseCache.invalidateAll();
-*
-* // Stats
-* const stats = fastify.responseCache.stats();
-* // { entries: 42, hits: 1250, misses: 180, hitRate: 0.87, evictions: 5 }
-* ```
-*/
-/**
 * Simple LRU cache using Map iteration order.
 * Map in JS preserves insertion order — we re-insert on access to make it LRU.
 */
@@ -191,7 +127,7 @@ const responseCachePluginImpl = async (fastify, opts = {}) => {
 		const segments = path.split("/").filter(Boolean);
 		const lastSegment = segments[segments.length - 1];
 		if (segments.length >= 2 && lastSegment != null && /^[0-9a-f]{8,}$|^\d+$/.test(lastSegment)) {
-			const resourceRoot = "/" + segments.slice(0, -1).join("/");
+			const resourceRoot = `/${segments.slice(0, -1).join("/")}`;
 			cache.invalidatePrefix(resourceRoot);
 			cache.invalidatePrefix(path);
 		} else cache.invalidatePrefix(path);
@@ -227,7 +163,7 @@ const responseCachePluginImpl = async (fastify, opts = {}) => {
 		const contentType = reply.getHeader("content-type");
 		if (contentType) headers["content-type"] = String(contentType);
 		const etag = reply.getHeader("etag");
-		if (etag) headers["etag"] = String(etag);
+		if (etag) headers.etag = String(etag);
 		cache.set(key, {
 			body,
 			statusCode,
@@ -278,6 +214,5 @@ const responseCachePlugin = fp(responseCachePluginImpl, {
 	name: "arc-response-cache",
 	fastify: "5.x"
 });
-
 //#endregion
-export { responseCachePlugin as default, responseCachePlugin };
+export { responseCachePlugin as default, responseCachePlugin };

package/dist/plugins/tracing-entry.d.mts

@@ -1,2 +1,2 @@
-import { a as traced, i as isTracingAvailable, n as _default, r as createSpan, t as TracingOptions } from "../tracing-8CEbhF0w.mjs";
+import { a as traced, i as isTracingAvailable, n as _default, r as createSpan, t as TracingOptions } from "../tracing-bz_U4EM1.mjs";
 export { type TracingOptions, createSpan, isTracingAvailable, traced, _default as tracingPlugin };