@ovineko/spa-guard-fastify 0.0.1-alpha-18

package/dist/fastify/index.d.ts

@@ -0,0 +1,33 @@
+import type { FastifyPluginAsync, FastifyReply, FastifyRequest } from "fastify";
+import type { BeaconSchema } from "@ovineko/spa-guard/schema";
+export { BeaconError } from "@ovineko/spa-guard";
+export interface BeaconHandlerResult {
+    /**
+     * If true, skips default logging behavior
+     */
+    skipDefaultLog?: boolean;
+}
+export interface FastifySPAGuardOptions {
+    /**
+     * Custom handler for beacon data
+     * @param beacon - Parsed beacon data
+     * @param request - Fastify request object
+     * @param reply - Fastify reply object
+     * @returns Object with options to control default behavior
+     */
+    onBeacon?: (beacon: BeaconSchema, request: FastifyRequest, reply: FastifyReply) => BeaconHandlerResult | Promise<BeaconHandlerResult | void> | void;
+    /**
+     * Custom handler for invalid/unknown beacon data
+     * @param body - Raw body data
+     * @param request - Fastify request object
+     * @param reply - Fastify reply object
+     * @returns Object with options to control default behavior
+     */
+    onUnknownBeacon?: (body: unknown, request: FastifyRequest, reply: FastifyReply) => BeaconHandlerResult | Promise<BeaconHandlerResult | void> | void;
+    /**
+     * The route path for the beacon endpoint
+     * @example "/api/beacon"
+     */
+    path: string;
+}
+export declare const fastifySPAGuard: FastifyPluginAsync<FastifySPAGuardOptions>;

package/dist/index.js

@@ -0,0 +1,75 @@
+// src/fastify/index.ts
+import fp from "fastify-plugin";
+import { BeaconError } from "@ovineko/spa-guard";
+import { logMessage } from "@ovineko/spa-guard/_internal";
+import { parseBeacon } from "@ovineko/spa-guard/schema/parse";
+
+// package.json
+var name = "@ovineko/spa-guard-fastify";
+
+// src/fastify/index.ts
+var parseStringBody = (body) => {
+  try {
+    return JSON.parse(body);
+  } catch {
+    return body;
+  }
+};
+var handleBeaconRequest = async (params) => {
+  const { body, options, reply, request } = params;
+  let beacon;
+  try {
+    beacon = parseBeacon(body);
+  } catch {
+    if (options.onUnknownBeacon) {
+      const result = await options.onUnknownBeacon(body, request, reply);
+      if (!result?.skipDefaultLog) {
+        request.log.warn({ bodyType: typeof body }, logMessage("Unknown beacon format"));
+      }
+    } else {
+      request.log.warn({ bodyType: typeof body }, logMessage("Unknown beacon format"));
+    }
+    return;
+  }
+  const logPayload = {
+    ...beacon.appName && { appName: beacon.appName },
+    errorMessage: beacon.errorMessage,
+    eventMessage: beacon.eventMessage,
+    eventName: beacon.eventName,
+    serialized: beacon.serialized
+  };
+  if (options.onBeacon) {
+    const result = await options.onBeacon(beacon, request, reply);
+    if (!result?.skipDefaultLog) {
+      request.log.info(logPayload, logMessage("Beacon received"));
+    }
+  } else {
+    request.log.info(logPayload, logMessage("Beacon received"));
+  }
+};
+var fastifySPAGuardPlugin = async (fastify, options) => {
+  const { onBeacon, onUnknownBeacon, path } = options;
+  fastify.post(path, async (request, reply) => {
+    if (typeof request.body !== "string") {
+      request.log.warn(
+        { bodyType: typeof request.body },
+        logMessage("Invalid beacon body type, expected string")
+      );
+      return reply.status(400).send({ error: "Invalid body type" });
+    }
+    const body = parseStringBody(request.body);
+    await handleBeaconRequest({ body, options: { onBeacon, onUnknownBeacon }, reply, request });
+    if (!reply.sent) {
+      return reply.status(200).send({ success: true });
+    }
+    return reply;
+  });
+};
+var fastifySPAGuard = fp(fastifySPAGuardPlugin, {
+  fastify: "5.x || 4.x",
+  name: `${name}/fastify`
+});
+export {
+  BeaconError,
+  fastifySPAGuard
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ovineko/spa-guard-fastify",
+  "version": "0.0.1-alpha-18",
+  "description": "Fastify plugin for spa-guard beacon endpoint",
+  "keywords": [
+    "spa",
+    "fastify",
+    "beacon",
+    "monitoring"
+  ],
+  "homepage": "https://github.com/ovineko/ovineko/tree/main/spa-guard/fastify",
+  "bugs": {
+    "url": "https://github.com/ovineko/ovineko/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ovineko/ovineko.git",
+    "directory": "spa-guard/fastify"
+  },
+  "license": "MIT",
+  "author": "Alexander Svinarev <shibanet0@gmail.com> (shibanet0.com)",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/fastify/index.d.ts",
+      "default": "./dist/fastify/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@ovineko/spa-guard": "0.0.1-alpha-18"
+  },
+  "peerDependencies": {
+    "fastify": "^5 || ^4",
+    "fastify-plugin": "^5 || ^4"
+  },
+  "engines": {
+    "node": ">=22.15.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}