@lokalise/fastify-extras 29.0.1 → 30.1.0

package/README.md

@@ -7,6 +7,8 @@ Reusable plugins for Fastify.
 
   - [RequestContext Provider Plugin](#requestcontext-provider-plugin)
   - [Public Healthcheck Plugin](#public-healthcheck-plugin)
+  - [Common Healthcheck Plugin](#common-healthcheck-plugin)
+  - [Common Sync Healthcheck Plugin](#common-sync-healthcheck-plugin)
   - [Split IO Plugin](#split-io-plugin)
   - [BugSnag Plugin](#bugsnag-plugin)
   - [Metrics Plugin](#metrics-plugin)
@@ -72,7 +74,7 @@ Your Fastify app will reply with the status of the app when hitting the `GET /`
 
 ### Common Healthcheck Plugin
 
-Plugin to monitor app status through public and private healthchecks.
+Plugin to monitor app status through public and private healthchecks using asynchronous checks.
 
 Add the plugin to your Fastify instance by registering it with the following options:
 
@@ -89,8 +91,6 @@ Your Fastify app will reply with the status of the app when hitting the `GET /`
 }
 ```
 
-
-
 Your Fastify app will reply with the status of the app when hitting the `GET /health` private route with detailed results from healthchecks provided, example:
 ```json
 {
@@ -103,6 +103,55 @@ Your Fastify app will reply with the status of the app when hitting the `GET /he
 }
 ```
 
+### Common Sync Healthcheck Plugin
+
+Plugin to monitor app status through public and private healthchecks using synchronous checks. **This plugin is recommended when you have healthchecks that run synchronously or are executed in the background**, as it provides better performance for such use cases.
+
+Add the plugin to your Fastify instance by registering it with the following options:
+
+- `healthChecks`, an array of synchronous healthcheck objects, each containing:
+  - `name`, the identifier for the healthcheck;
+  - `isMandatory`, boolean indicating if this healthcheck is critical for service health;
+  - `checker`, a synchronous function that returns `null` on success or an `Error` on failure;
+- `responsePayload` (optional), the response payload that the healthcheck should return;
+- `logLevel` (optional), the log level for the healthcheck routes ('fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace' | 'silent'), defaults to 'info';
+- `infoProviders` (optional), an array of info providers to include additional metadata in the `/health` response;
+- `isRootRouteEnabled` (optional), whether to enable the public `/` route, defaults to `true`.
+
+Example usage:
+```typescript
+import { commonSyncHealthcheckPlugin } from '@lokalise/fastify-extras'
+
+app.register(commonSyncHealthcheckPlugin, {
+  healthChecks: [
+    {
+      name: 'database',
+      isMandatory: true,
+      checker: (app) => {
+        // Synchronous check - returns null if healthy, Error if not
+        return isDatabaseConnected() ? null : new Error('Database disconnected')
+      }
+    },
+    {
+      name: 'cache',
+      isMandatory: false,  // Optional dependency
+      checker: (app) => {
+        return isCacheAvailable() ? null : new Error('Cache unavailable')
+      }
+    }
+  ]
+})
+```
+
+The plugin exposes the same routes as the async Common Healthcheck Plugin:
+- `GET /` - Public route returning aggregated health status
+- `GET /health` - Private route with detailed healthcheck results
+
+The key differences from the async version:
+- Uses synchronous healthcheck functions instead of promises
+- Better suited for checks that are already running in the background or are inherently synchronous
+- Supports mandatory vs optional healthchecks (optional failures result in `PARTIALLY_HEALTHY` status)
+
 ### Split IO Plugin
 
 Plugin to handle feature flags in Split IO.

package/dist/index.d.ts

@@ -18,9 +18,11 @@ export type { ErrorObjectResolver, MetricsPluginOptions, } from './plugins/metri
 export { publicHealthcheckPlugin } from './plugins/healthcheck/publicHealthcheckPlugin.js';
 export type { PublicHealthcheckPluginOptions, HealthCheck, InfoProvider, } from './plugins/healthcheck/publicHealthcheckPlugin.js';
 export { wrapHealthCheck } from './plugins/healthcheck/healthcheckCommons.js';
-export type { HealthChecker } from './plugins/healthcheck/healthcheckCommons.js';
+export type { HealthChecker, HealthCheckerSync } from './plugins/healthcheck/healthcheckCommons.js';
 export { commonHealthcheckPlugin } from './plugins/healthcheck/commonHealthcheckPlugin.js';
 export type { CommonHealthcheckPluginOptions } from './plugins/healthcheck/commonHealthcheckPlugin.js';
+export { commonSyncHealthcheckPlugin } from './plugins/healthcheck/commonSyncHealthcheckPlugin.ts';
+export type { CommonSyncHealthcheckPluginOptions } from './plugins/healthcheck/commonSyncHealthcheckPlugin.ts';
 export { amplitudePlugin, type AmplitudeConfig, type CreateApiTrackingEventFn, } from './plugins/amplitude/amplitudePlugin.js';
 export { Amplitude } from './plugins/amplitude/Amplitude.js';
 export { AmplitudeAdapter, AMPLITUDE_BASE_MESSAGE_SCHEMA, type AmplitudeMessage, type AmplitudeAdapterDependencies, } from './plugins/amplitude/AmplitudeAdapter.js';

package/dist/index.js

@@ -10,6 +10,7 @@ export { metricsPlugin } from './plugins/metricsPlugin.js';
 export { publicHealthcheckPlugin } from './plugins/healthcheck/publicHealthcheckPlugin.js';
 export { wrapHealthCheck } from './plugins/healthcheck/healthcheckCommons.js';
 export { commonHealthcheckPlugin } from './plugins/healthcheck/commonHealthcheckPlugin.js';
+export { commonSyncHealthcheckPlugin } from "./plugins/healthcheck/commonSyncHealthcheckPlugin.js";
 export { amplitudePlugin, } from './plugins/amplitude/amplitudePlugin.js';
 export { Amplitude } from './plugins/amplitude/Amplitude.js';
 export { AmplitudeAdapter, AMPLITUDE_BASE_MESSAGE_SCHEMA, } from './plugins/amplitude/AmplitudeAdapter.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,GACf,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,2CAA2C,CAAA;AAGlD,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,+CAA+C,CAAA;AAGtD,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,0CAA0C,CAAA;AAGjD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,mDAAmD,CAAA;AAO1D,OAAO,EAAE,mCAAmC,EAAE,MAAM,6DAA6D,CAAA;AAEjH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,EACL,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,+CAA+C,CAAA;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAM1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAA;AAO1F,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAA;AAG1F,OAAO,EACL,eAAe,GAGhB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAC5D,OAAO,EACL,gBAAgB,EAChB,6BAA6B,GAG9B,MAAM,yCAAyC,CAAA;AAIhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAEhF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,uCAAuC,CAAA;AAG9C,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAA4B,MAAM,0BAA0B,CAAA;AAGnG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE5E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,GACf,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,2CAA2C,CAAA;AAGlD,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,+CAA+C,CAAA;AAGtD,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,0CAA0C,CAAA;AAGjD,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,mDAAmD,CAAA;AAO1D,OAAO,EAAE,mCAAmC,EAAE,MAAM,6DAA6D,CAAA;AAEjH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,EACL,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,+CAA+C,CAAA;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAM1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAA;AAO1F,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAA;AAG1F,OAAO,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAA;AAGlG,OAAO,EACL,eAAe,GAGhB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAC5D,OAAO,EACL,gBAAgB,EAChB,6BAA6B,GAG9B,MAAM,yCAAyC,CAAA;AAIhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAEhF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,uCAAuC,CAAA;AAG9C,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAA4B,MAAM,0BAA0B,CAAA;AAGnG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE5E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAA"}

package/dist/plugins/healthcheck/commonSyncHealthcheckPlugin.d.ts

@@ -0,0 +1,19 @@
+import type { FastifyPluginCallback } from 'fastify';
+import type { HealthCheckerSync } from './healthcheckCommons.js';
+export interface CommonSyncHealthcheckPluginOptions {
+    responsePayload?: Record<string, unknown>;
+    logLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace' | 'silent';
+    healthChecks: readonly HealthCheckSync[];
+    infoProviders?: readonly InfoProvider[];
+    isRootRouteEnabled?: boolean;
+}
+export type InfoProvider = {
+    name: string;
+    dataResolver: () => Record<string, unknown>;
+};
+export type HealthCheckSync = {
+    name: string;
+    isMandatory: boolean;
+    checker: HealthCheckerSync;
+};
+export declare const commonSyncHealthcheckPlugin: FastifyPluginCallback<CommonSyncHealthcheckPluginOptions>;

package/dist/plugins/healthcheck/commonSyncHealthcheckPlugin.js

@@ -0,0 +1,97 @@
+import fp from 'fastify-plugin';
+function resolveHealthcheckResults(results, opts) {
+    const healthChecks = {};
+    let isFullyHealthy = true;
+    let isPartiallyHealthy = false;
+    // Return detailed healthcheck results
+    for (let i = 0; i < results.length; i++) {
+        const entry = results[i];
+        if (!entry)
+            continue;
+        healthChecks[entry.name] = entry.healthcheckError ? 'FAIL' : 'HEALTHY';
+        if (entry.healthcheckError && opts.healthChecks[i]?.isMandatory) {
+            isFullyHealthy = false;
+            isPartiallyHealthy = false;
+        }
+        // Check if we are only partially healthy (only optional dependencies are failing)
+        if (isFullyHealthy && entry.healthcheckError && !opts.healthChecks[i]?.isMandatory) {
+            isFullyHealthy = false;
+            isPartiallyHealthy = true;
+        }
+    }
+    return {
+        isFullyHealthy,
+        isPartiallyHealthy,
+        healthChecks,
+    };
+}
+function addRoute(app, opts, routeOpts) {
+    const responsePayload = opts.responsePayload ?? {};
+    app.route({
+        url: routeOpts.url,
+        method: 'GET',
+        logLevel: opts.logLevel ?? 'info',
+        schema: {
+            // hide route from swagger plugins
+            hide: true,
+        },
+        handler: (_, reply) => {
+            let isFullyHealthy = true;
+            let isPartiallyHealthy = false;
+            let healthChecks = {};
+            if (opts.healthChecks.length) {
+                const results = opts.healthChecks.map((healthcheck) => {
+                    const healthcheckError = healthcheck.checker(app);
+                    if (healthcheckError) {
+                        app.log.error(healthcheckError, `${healthcheck.name} healthcheck has failed`);
+                    }
+                    return {
+                        name: healthcheck.name,
+                        healthcheckError,
+                        isMandatory: healthcheck.isMandatory,
+                    };
+                });
+                const resolvedHealthcheckResponse = resolveHealthcheckResults(results, opts);
+                healthChecks = resolvedHealthcheckResponse.healthChecks;
+                isFullyHealthy = resolvedHealthcheckResponse.isFullyHealthy;
+                isPartiallyHealthy = resolvedHealthcheckResponse.isPartiallyHealthy;
+            }
+            const extraInfo = opts.infoProviders?.map((infoProvider) => ({
+                name: infoProvider.name,
+                value: infoProvider.dataResolver(),
+            }));
+            const heartbeat = isFullyHealthy
+                ? 'HEALTHY'
+                : isPartiallyHealthy
+                    ? 'PARTIALLY_HEALTHY'
+                    : 'FAIL';
+            const response = {
+                ...responsePayload,
+                heartbeat,
+                ...(routeOpts.isPublicRoute
+                    ? {}
+                    : { checks: healthChecks, ...(extraInfo && { extraInfo }) }),
+            };
+            return reply.status(isFullyHealthy || isPartiallyHealthy ? 200 : 500).send(response);
+        },
+    });
+}
+const plugin = (app, opts, done) => {
+    const isRootRouteEnabled = opts.isRootRouteEnabled ?? true;
+    if (isRootRouteEnabled) {
+        addRoute(app, opts, {
+            url: '/',
+            isPublicRoute: true,
+        });
+    }
+    addRoute(app, opts, {
+        url: '/health',
+        isPublicRoute: false,
+    });
+    done();
+};
+export const commonSyncHealthcheckPlugin = fp(plugin, {
+    fastify: '5.x',
+    name: 'common-sync-healthcheck-plugin',
+});
+//# sourceMappingURL=commonSyncHealthcheckPlugin.js.map

package/dist/plugins/healthcheck/commonSyncHealthcheckPlugin.js.map

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

package/dist/plugins/healthcheck/healthcheckCommons.d.ts

@@ -1,6 +1,10 @@
 import type { Either } from '@lokalise/node-core';
 import type { AnyFastifyInstance } from '../pluginsCommon.js';
 export type HealthChecker = (app: AnyFastifyInstance) => Promise<Either<Error, true>>;
+/**
+ * Returns error (if fail) or null (if pass)
+ */
+export type HealthCheckerSync = (app: AnyFastifyInstance) => Error | null;
 /**
  * Return a function which executes healthcheck and throws an error if it fails
  */

package/dist/plugins/healthcheck/healthcheckCommons.js.map

@@ -1 +1 @@
-{"version":3,"file":"healthcheckCommons.js","sourceRoot":"","sources":["../../../lib/plugins/healthcheck/healthcheckCommons.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAuB,EAAE,WAA0B,EAAE,EAAE;IACrF,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,QAAQ,CAAC,KAAK,CAAA;QACtB,CAAC;IACH,CAAC,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"healthcheckCommons.js","sourceRoot":"","sources":["../../../lib/plugins/healthcheck/healthcheckCommons.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAuB,EAAE,WAA0B,EAAE,EAAE;IACrF,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,QAAQ,CAAC,KAAK,CAAA;QACtB,CAAC;IACH,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/plugins/healthcheck/publicHealthcheckPlugin.d.ts

@@ -16,4 +16,7 @@ export type HealthCheck = {
     isMandatory: boolean;
     checker: HealthChecker;
 };
+/**
+ * @deprecated use commonSyncHealthcheckPlugin instead
+ */
 export declare const publicHealthcheckPlugin: FastifyPluginCallback<PublicHealthcheckPluginOptions>;

package/dist/plugins/healthcheck/publicHealthcheckPlugin.js

@@ -61,6 +61,9 @@ function plugin(app, opts, done) {
     });
     done();
 }
+/**
+ * @deprecated use commonSyncHealthcheckPlugin instead
+ */
 export const publicHealthcheckPlugin = fp(plugin, {
     fastify: '5.x',
     name: 'public-healthcheck-plugin',

package/dist/plugins/healthcheck/publicHealthcheckPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"publicHealthcheckPlugin.js","sourceRoot":"","sources":["../../../lib/plugins/healthcheck/publicHealthcheckPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAuB/B,SAAS,MAAM,CACb,GAAuB,EACvB,IAAoC,EACpC,IAAgB;IAEhB,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,EAAE,CAAA;IAClD,GAAG,CAAC,KAAK,CAAC;QACR,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,SAAS;QAC1B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;QACjC,MAAM,EAAE;YACN,kCAAkC;YAClC,IAAI,EAAE,IAAI;SACX;QAED,6EAA6E;QAC7E,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE;YAC1B,IAAI,cAAc,GAAG,IAAI,CAAA;YACzB,IAAI,kBAAkB,GAAG,KAAK,CAAA;YAC9B,MAAM,YAAY,GAA4B,EAAE,CAAA;YAEhD,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;oBACpC,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;wBAC9C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;4BACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,WAAW,CAAC,IAAI,yBAAyB,CAAC,CAAA;wBAC3E,CAAC;wBACD,OAAO;4BACL,IAAI,EAAE,WAAW,CAAC,IAAI;4BACtB,MAAM;4BACN,WAAW,EAAE,WAAW,CAAC,WAAW;yBACrC,CAAA;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC,CAAC,CACH,CAAA;gBAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;oBACxB,IAAI,CAAC,KAAK;wBAAE,SAAQ;oBAEpB,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;oBAClE,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;wBAC5D,cAAc,GAAG,KAAK,CAAA;wBACtB,kBAAkB,GAAG,KAAK,CAAA;oBAC5B,CAAC;oBAED,kFAAkF;oBAClF,IAAI,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;wBAC/E,cAAc,GAAG,KAAK,CAAA;wBACtB,kBAAkB,GAAG,IAAI,CAAA;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa;gBAClC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;oBACtC,OAAO;wBACL,IAAI,EAAE,YAAY,CAAC,IAAI;wBACvB,KAAK,EAAE,YAAY,CAAC,YAAY,EAAE;qBACnC,CAAA;gBACH,CAAC,CAAC;gBACJ,CAAC,CAAC,SAAS,CAAA;YAEb,OAAO,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACzE,GAAG,eAAe;gBAClB,MAAM,EAAE,YAAY;gBACpB,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC/B,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM;aAC1F,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;IACF,IAAI,EAAE,CAAA;AACR,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAA0D,EAAE,CAC9F,MAAM,EACN;IACE,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,2BAA2B;CAClC,CACF,CAAA"}
+{"version":3,"file":"publicHealthcheckPlugin.js","sourceRoot":"","sources":["../../../lib/plugins/healthcheck/publicHealthcheckPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAuB/B,SAAS,MAAM,CACb,GAAuB,EACvB,IAAoC,EACpC,IAAgB;IAEhB,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,EAAE,CAAA;IAClD,GAAG,CAAC,KAAK,CAAC;QACR,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,SAAS;QAC1B,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;QACjC,MAAM,EAAE;YACN,kCAAkC;YAClC,IAAI,EAAE,IAAI;SACX;QAED,6EAA6E;QAC7E,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE;YAC1B,IAAI,cAAc,GAAG,IAAI,CAAA;YACzB,IAAI,kBAAkB,GAAG,KAAK,CAAA;YAC9B,MAAM,YAAY,GAA4B,EAAE,CAAA;YAEhD,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;oBACpC,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;wBAC9C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;4BACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,WAAW,CAAC,IAAI,yBAAyB,CAAC,CAAA;wBAC3E,CAAC;wBACD,OAAO;4BACL,IAAI,EAAE,WAAW,CAAC,IAAI;4BACtB,MAAM;4BACN,WAAW,EAAE,WAAW,CAAC,WAAW;yBACrC,CAAA;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC,CAAC,CACH,CAAA;gBAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;oBACxB,IAAI,CAAC,KAAK;wBAAE,SAAQ;oBAEpB,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;oBAClE,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;wBAC5D,cAAc,GAAG,KAAK,CAAA;wBACtB,kBAAkB,GAAG,KAAK,CAAA;oBAC5B,CAAC;oBAED,kFAAkF;oBAClF,IAAI,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;wBAC/E,cAAc,GAAG,KAAK,CAAA;wBACtB,kBAAkB,GAAG,IAAI,CAAA;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa;gBAClC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;oBACtC,OAAO;wBACL,IAAI,EAAE,YAAY,CAAC,IAAI;wBACvB,KAAK,EAAE,YAAY,CAAC,YAAY,EAAE;qBACnC,CAAA;gBACH,CAAC,CAAC;gBACJ,CAAC,CAAC,SAAS,CAAA;YAEb,OAAO,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACzE,GAAG,eAAe;gBAClB,MAAM,EAAE,YAAY;gBACpB,GAAG,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC/B,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM;aAC1F,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;IACF,IAAI,EAAE,CAAA;AACR,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA0D,EAAE,CAC9F,MAAM,EACN;IACE,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,2BAA2B;CAClC,CACF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lokalise/fastify-extras",
-    "version": "29.0.1",
+    "version": "30.1.0",
     "description": "Opinionated set of fastify plugins, commonly used in Lokalise",
     "author": {
         "name": "Lokalise",
@@ -35,52 +35,52 @@
         "version": "auto-changelog -p && git add CHANGELOG.md && biome check --write package.json && git add package.json"
     },
     "dependencies": {
-        "@amplitude/analytics-node": "^1.4.1",
+        "@amplitude/analytics-node": "^1.5.7",
         "@bugsnag/js": "^8.4.0",
         "@lokalise/error-utils": "^3.0.0",
         "@splitsoftware/splitio": "^11.4.1",
         "@supercharge/promise-pool": "^3.2.0",
         "fastify-metrics": "^12.1.0",
         "fastify-plugin": "^5.0.1",
-        "fastify-type-provider-zod": "^5.0.2",
         "prom-client": "^15.1.3",
         "toad-cache": "^3.7.0"
     },
     "peerDependencies": {
         "@fastify/jwt": ">=9.1.0",
         "@lokalise/api-contracts": ">=5.0.0",
-        "@lokalise/background-jobs-common": ">=8.0.0",
-        "@lokalise/node-core": ">=13.3.0",
+        "@lokalise/background-jobs-common": ">=12.0.0",
+        "@lokalise/node-core": ">=14.0.0",
         "bullmq": "^5.19.0",
-        "fastify": "^5.0.0",
-        "ioredis": "^5.6.1",
+        "fastify": "^5.5.0",
+        "fastify-type-provider-zod": ">=6.0.0",
+        "ioredis": "^5.7.0",
         "newrelic": ">=11.13.0",
-        "pino": "^9.7.0",
-        "zod": ">=3.25.76"
+        "pino": "^9.9.0",
+        "zod": ">=4.1.5"
     },
     "devDependencies": {
-        "@amplitude/analytics-types": "^2.9.2",
+        "@amplitude/analytics-types": "^2.10.0",
         "@biomejs/biome": "^1.9.4",
         "@lokalise/backend-http-client": "^7.0.0",
         "@lokalise/background-jobs-common": "^14.0.2",
         "@lokalise/biome-config": "^2.0.0",
-        "@lokalise/node-core": "^14.1.0",
-        "@lokalise/tsconfig": "^2.0.0",
+        "@lokalise/node-core": "^14.4.1",
+        "@lokalise/tsconfig": "^3.0.0",
         "@types/newrelic": "^9.14.8",
-        "@types/node": "^22.16.5",
-        "@vitest/coverage-v8": "^3.2.3",
+        "@types/node": "^22.18.0",
+        "@vitest/coverage-v8": "^3.2.4",
         "auto-changelog": "^2.4.0",
-        "bullmq": "^5.56.5",
-        "fastify": "^5.4.0",
-        "fastify-type-provider-zod": "^5.0.1",
+        "bullmq": "^5.58.4",
+        "fastify": "^5.5.0",
+        "fastify-type-provider-zod": "^6.0.0",
         "ioredis": "^5.6.1",
-        "newrelic": "13.2.1",
-        "pino": "^9.7.0",
-        "pino-pretty": "^13.0.0",
+        "newrelic": "13.3.2",
+        "pino": "^9.9.0",
+        "pino-pretty": "^13.1.1",
         "rimraf": "^6.0.1",
-        "typescript": "^5.8.3",
-        "vitest": "^3.2.3",
-        "zod": "^4.0.5"
+        "typescript": "^5.9.2",
+        "vitest": "^3.2.4",
+        "zod": "^4.1.5"
     },
     "engines": {
         "node": ">=20"