@ovineko/spa-guard-fastify 0.0.1-alpha-24 → 0.0.1-alpha-25

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { FastifyPluginAsync, FastifyReply, FastifyRequest } from "fastify";
+import type { CreateHtmlCacheOptions, HtmlCache } from "@ovineko/spa-guard-node";
 import type { BeaconSchema } from "@ovineko/spa-guard/schema";
 export { BeaconError } from "@ovineko/spa-guard";
 export interface BeaconHandlerResult {
@@ -31,3 +32,10 @@ export interface FastifySPAGuardOptions {
     path: string;
 }
 export declare const fastifySPAGuard: FastifyPluginAsync<FastifySPAGuardOptions>;
+export interface SpaGuardHandlerOptions {
+    /** @internal Promise used to deduplicate concurrent lazy cache creation */
+    _cachePromise?: Promise<HtmlCache>;
+    cache?: HtmlCache;
+    getHtml?: (() => CreateHtmlCacheOptions) | (() => Promise<CreateHtmlCacheOptions>);
+}
+export declare function spaGuardFastifyHandler(request: FastifyRequest, reply: FastifyReply, options: SpaGuardHandlerOptions): Promise<FastifyReply>;

package/dist/index.js

@@ -1,4 +1,5 @@
 // src/index.ts
+import { createHtmlCache } from "@ovineko/spa-guard-node";
 import fp from "fastify-plugin";
 import { BeaconError } from "@ovineko/spa-guard";
 import { logMessage } from "@ovineko/spa-guard/_internal";
@@ -82,7 +83,32 @@ var fastifySPAGuard = fp(fastifySPAGuardPlugin, {
   fastify: "5.x || 4.x",
   name: `${name}/fastify`
 });
+async function spaGuardFastifyHandler(request, reply, options) {
+  const { getHtml } = options;
+  if (!options.cache && !getHtml) {
+    throw new Error("spaGuardFastifyHandler requires either 'cache' or 'getHtml' option");
+  }
+  if (!options.cache && getHtml) {
+    options._cachePromise ??= (async () => createHtmlCache(await getHtml()))().catch(
+      (error) => {
+        options._cachePromise = void 0;
+        throw error;
+      }
+    );
+    options.cache = await options._cachePromise;
+  }
+  const cache = options.cache;
+  const acceptEncoding = request.headers["accept-encoding"];
+  const acceptLanguage = request.headers["accept-language"];
+  const ifNoneMatch = request.headers["if-none-match"];
+  const response = cache.get({ acceptEncoding, acceptLanguage, ifNoneMatch });
+  for (const [key, value] of Object.entries(response.headers)) {
+    reply.header(key, value);
+  }
+  return reply.status(response.statusCode).send(response.body);
+}
 export {
   BeaconError,
-  fastifySPAGuard
+  fastifySPAGuard,
+  spaGuardFastifyHandler
 };

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@ovineko/spa-guard-fastify",
-  "version": "0.0.1-alpha-24",
-  "description": "Fastify plugin for spa-guard beacon endpoint",
+  "version": "0.0.1-alpha-25",
+  "description": "Fastify plugin for spa-guard beacon endpoint and HTML cache handler with ETag/304",
   "keywords": [
     "spa",
     "fastify",
     "beacon",
-    "monitoring"
+    "monitoring",
+    "etag",
+    "cache",
+    "html"
   ],
   "homepage": "https://github.com/ovineko/ovineko/tree/main/spa-guard/fastify",
   "bugs": {
@@ -31,11 +34,12 @@
     "dist"
   ],
   "dependencies": {
-    "@ovineko/spa-guard": "0.0.1-alpha-24"
+    "@ovineko/spa-guard": "0.0.1-alpha-25"
   },
   "peerDependencies": {
     "fastify": "^5 || ^4",
-    "fastify-plugin": "^5 || ^4"
+    "fastify-plugin": "^5 || ^4",
+    "@ovineko/spa-guard-node": "0.0.1-alpha-25"
   },
   "engines": {
     "node": ">=22.15.0"