@fastrack/starter-actuator 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fastrack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @fastrack/starter-actuator
+
+Endpoints: `/live` (process alive), `/ready` (readiness + contributors), `/health` (full health), `/info` (version/build/env), `/metrics` (Prometheus). Other starters register health contributors.
+
+See [docs/starters.md](../../docs/starters.md).

package/dist/health.d.ts

@@ -0,0 +1,19 @@
+import type { FastifyInstance } from "fastify";
+export interface HealthContributor {
+    name: string;
+    check(): Promise<{
+        ok: boolean;
+        status?: "up" | "down";
+        details?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Register a health contributor with the app (call from starters that have dependencies).
+ * The app must have been created with createApp so that _fastrackContext and _healthContributors exist.
+ */
+export declare function registerHealthContributor(app: FastifyInstance, name: string, check: () => Promise<{
+    ok: boolean;
+    status?: "up" | "down";
+    details?: Record<string, unknown>;
+}>): void;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC9F;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAC/F,IAAI,CAKN"}

package/dist/health.js

@@ -0,0 +1,12 @@
+import { getFastrackContext } from "@fastrack/core";
+/**
+ * Register a health contributor with the app (call from starters that have dependencies).
+ * The app must have been created with createApp so that _fastrackContext and _healthContributors exist.
+ */
+export function registerHealthContributor(app, name, check) {
+    const ctx = getFastrackContext(app);
+    if (ctx?.registerHealthContributor) {
+        ctx.registerHealthContributor(name, check);
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAOpD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAoB,EACpB,IAAY,EACZ,KAAgG;IAEhG,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,GAAG,EAAE,yBAAyB,EAAE,CAAC;QACnC,GAAG,CAAC,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fastrack/starter-actuator — /live, /ready, /health, /info, /metrics.
+ */
+export { actuatorStarter } from "./plugin.js";
+export { registerHealthContributor, type HealthContributor } from "./health.js";
+export type { ActuatorStarterConfig } from "./plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fastrack/starter-actuator — /live, /ready, /health, /info, /metrics.
+ */
+export { actuatorStarter } from "./plugin.js";
+export { registerHealthContributor } from "./health.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAA0B,MAAM,aAAa,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,13 @@
+import { type Static } from "@sinclair/typebox";
+import type { FastrackStarter } from "@fastrack/core";
+export declare const ActuatorStarterConfigSchema: import("@sinclair/typebox").TObject<{
+    pathPrefix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    enableLive: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    enableReady: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    enableHealth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    enableInfo: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    enableMetrics: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type ActuatorStarterConfig = Static<typeof ActuatorStarterConfigSchema>;
+export declare const actuatorStarter: FastrackStarter<ActuatorStarterConfig>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,gBAAgB,CAAC;AAGvE,eAAO,MAAM,2BAA2B;;;;;;;EAOtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,qBAAqB,CA8ElE,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,88 @@
+import { Type } from "@sinclair/typebox";
+import { getHealthContributors } from "@fastrack/core";
+export const ActuatorStarterConfigSchema = Type.Object({
+    pathPrefix: Type.Optional(Type.String({ default: "" })),
+    enableLive: Type.Optional(Type.Boolean({ default: true })),
+    enableReady: Type.Optional(Type.Boolean({ default: true })),
+    enableHealth: Type.Optional(Type.Boolean({ default: true })),
+    enableInfo: Type.Optional(Type.Boolean({ default: true })),
+    enableMetrics: Type.Optional(Type.Boolean({ default: true })),
+});
+export const actuatorStarter = {
+    name: "actuator",
+    configSchema: ActuatorStarterConfigSchema,
+    defaults: {
+        pathPrefix: "",
+        enableLive: true,
+        enableReady: true,
+        enableHealth: true,
+        enableInfo: true,
+        enableMetrics: true,
+    },
+    register(app, ctx, config) {
+        const p = config.pathPrefix ?? "";
+        if (config.enableLive !== false) {
+            app.get(`${p}/live`, async (_request, reply) => {
+                return reply.status(200).send({ status: "up" });
+            });
+        }
+        if (config.enableReady !== false) {
+            app.get(`${p}/ready`, async (_request, reply) => {
+                const ready = ctx.getReadiness?.() ?? true;
+                const contributors = getHealthContributors(app);
+                const details = {};
+                if (contributors) {
+                    for (const [name, check] of contributors) {
+                        try {
+                            const result = await check();
+                            details[name] = result.ok ? "up" : "down";
+                        }
+                        catch {
+                            details[name] = "down";
+                        }
+                    }
+                }
+                const allUp = ready && Object.values(details).every((v) => v === "up");
+                return reply.status(allUp ? 200 : 503).send({ status: allUp ? "up" : "down", details });
+            });
+        }
+        if (config.enableHealth !== false) {
+            app.get(`${p}/health`, async (_request, reply) => {
+                const contributors = getHealthContributors(app);
+                const details = {};
+                let ok = true;
+                if (contributors) {
+                    for (const [name, check] of contributors) {
+                        try {
+                            const result = await check();
+                            details[name] = result.details ?? (result.ok ? "up" : "down");
+                            if (!result.ok)
+                                ok = false;
+                        }
+                        catch (e) {
+                            details[name] = "down";
+                            ok = false;
+                        }
+                    }
+                }
+                return reply.status(ok ? 200 : 503).send({ status: ok ? "up" : "down", details });
+            });
+        }
+        if (config.enableInfo !== false) {
+            app.get(`${p}/info`, async (_request, reply) => {
+                return reply.send({
+                    version: process.env.npm_package_version ?? "0.0.0",
+                    env: process.env.NODE_ENV ?? "development",
+                    node: process.version,
+                });
+            });
+        }
+        if (config.enableMetrics !== false) {
+            app.get(`${p}/metrics`, async (_request, reply) => {
+                reply.header("Content-Type", "text/plain; charset=utf-8");
+                return reply.send("# Fastrack metrics placeholder\n# Add Prometheus metrics here.\n");
+            });
+        }
+    },
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@fastrack/starter-actuator",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.34",
+    "fastify": "^5.1.0",
+    "@fastrack/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "lint": "echo ok",
+    "test": "echo ok"
+  }
+}

package/src/health.ts

@@ -0,0 +1,22 @@
+import type { FastifyInstance } from "fastify";
+import { getFastrackContext } from "@fastrack/core";
+
+export interface HealthContributor {
+  name: string;
+  check(): Promise<{ ok: boolean; status?: "up" | "down"; details?: Record<string, unknown> }>;
+}
+
+/**
+ * Register a health contributor with the app (call from starters that have dependencies).
+ * The app must have been created with createApp so that _fastrackContext and _healthContributors exist.
+ */
+export function registerHealthContributor(
+  app: FastifyInstance,
+  name: string,
+  check: () => Promise<{ ok: boolean; status?: "up" | "down"; details?: Record<string, unknown> }>
+): void {
+  const ctx = getFastrackContext(app);
+  if (ctx?.registerHealthContributor) {
+    ctx.registerHealthContributor(name, check);
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * @fastrack/starter-actuator — /live, /ready, /health, /info, /metrics.
+ */
+export { actuatorStarter } from "./plugin.js";
+export { registerHealthContributor, type HealthContributor } from "./health.js";
+export type { ActuatorStarterConfig } from "./plugin.js";

package/src/plugin.ts

@@ -0,0 +1,95 @@
+import { Type, type Static } from "@sinclair/typebox";
+import type { FastifyInstance } from "fastify";
+import type { FastrackStarter, FastrackContext } from "@fastrack/core";
+import { getHealthContributors } from "@fastrack/core";
+
+export const ActuatorStarterConfigSchema = Type.Object({
+  pathPrefix: Type.Optional(Type.String({ default: "" })),
+  enableLive: Type.Optional(Type.Boolean({ default: true })),
+  enableReady: Type.Optional(Type.Boolean({ default: true })),
+  enableHealth: Type.Optional(Type.Boolean({ default: true })),
+  enableInfo: Type.Optional(Type.Boolean({ default: true })),
+  enableMetrics: Type.Optional(Type.Boolean({ default: true })),
+});
+
+export type ActuatorStarterConfig = Static<typeof ActuatorStarterConfigSchema>;
+
+export const actuatorStarter: FastrackStarter<ActuatorStarterConfig> = {
+  name: "actuator",
+  configSchema: ActuatorStarterConfigSchema,
+  defaults: {
+    pathPrefix: "",
+    enableLive: true,
+    enableReady: true,
+    enableHealth: true,
+    enableInfo: true,
+    enableMetrics: true,
+  },
+  register(app: FastifyInstance, ctx: FastrackContext, config: ActuatorStarterConfig) {
+    const p = config.pathPrefix ?? "";
+
+    if (config.enableLive !== false) {
+      app.get(`${p}/live`, async (_request, reply) => {
+        return reply.status(200).send({ status: "up" });
+      });
+    }
+
+    if (config.enableReady !== false) {
+      app.get(`${p}/ready`, async (_request, reply) => {
+        const ready = ctx.getReadiness?.() ?? true;
+        const contributors = getHealthContributors(app);
+        const details: Record<string, unknown> = {};
+        if (contributors) {
+          for (const [name, check] of contributors) {
+            try {
+              const result = await check();
+              details[name] = result.ok ? "up" : "down";
+            } catch {
+              details[name] = "down";
+            }
+          }
+        }
+        const allUp = ready && Object.values(details).every((v) => v === "up");
+        return reply.status(allUp ? 200 : 503).send({ status: allUp ? "up" : "down", details });
+      });
+    }
+
+    if (config.enableHealth !== false) {
+      app.get(`${p}/health`, async (_request, reply) => {
+        const contributors = getHealthContributors(app);
+        const details: Record<string, unknown> = {};
+        let ok = true;
+        if (contributors) {
+          for (const [name, check] of contributors) {
+            try {
+              const result = await check();
+              details[name] = result.details ?? (result.ok ? "up" : "down");
+              if (!result.ok) ok = false;
+            } catch (e) {
+              details[name] = "down";
+              ok = false;
+            }
+          }
+        }
+        return reply.status(ok ? 200 : 503).send({ status: ok ? "up" : "down", details });
+      });
+    }
+
+    if (config.enableInfo !== false) {
+      app.get(`${p}/info`, async (_request, reply) => {
+        return reply.send({
+          version: process.env.npm_package_version ?? "0.0.0",
+          env: process.env.NODE_ENV ?? "development",
+          node: process.version,
+        });
+      });
+    }
+
+    if (config.enableMetrics !== false) {
+      app.get(`${p}/metrics`, async (_request, reply) => {
+        reply.header("Content-Type", "text/plain; charset=utf-8");
+        return reply.send("# Fastrack metrics placeholder\n# Add Prometheus metrics here.\n");
+      });
+    }
+  },
+};

package/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "outDir": "dist", "rootDir": "src" },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}