@lokalise/fastify-extras 30.4.0 → 30.5.0

package/README.md

@@ -64,6 +64,24 @@ The `getRequestIdFastifyAppConfig()` method is exported and returns:
 
 Which can be passed to Fastify during instantiation.
 
+The `getFastifyAppLoggingConfig(appLogLevel, requestLoggingLevels?)` method is exported and returns Fastify configuration for request logging. It accepts:
+
+- `appLogLevel`, the application log level from your app configuration;
+- `requestLoggingLevels` (optional), an array of log levels that should enable request logging. Defaults to `['debug', 'trace', 'info']`.
+
+This method returns a `disableRequestLogging` configuration that:
+- Enables request logging only when the app log level is in `requestLoggingLevels`;
+- Automatically skips logging for service utility endpoints (`/`, `/health`, `/ready`, `/live`, `/metrics`).
+
+Example usage:
+```typescript
+import { getFastifyAppLoggingConfig } from '@lokalise/fastify-extras'
+
+const app = fastify({
+  ...getFastifyAppLoggingConfig(appConfig.logLevel),
+})
+```
+
 ### Public Healthcheck Plugin
 
 Plugin to monitor app status through public healthcheck.

package/dist/index.d.ts

@@ -38,4 +38,4 @@ export { createErrorHandler, isZodError, type ErrorResponseObject } from './erro
 export type { ErrorHandlerParams, FreeformRecord } from './errors/errorHandler.js';
 export { generateJwtToken, decodeJwtToken } from './jwt-utils/tokenUtils.js';
 export { createStaticTokenAuthPreHandler } from './route-utils/authPreHandlers.js';
-export type { AnyFastifyInstance, CommonFastifyInstance } from './plugins/pluginsCommon.js';
+export { getFastifyAppLoggingConfig, type AnyFastifyInstance, type CommonFastifyInstance, } from './plugins/pluginsCommon.js';

package/dist/index.js

@@ -21,4 +21,5 @@ export { unhandledExceptionPlugin, commonErrorObjectResolver, } from './plugins/
 export { createErrorHandler, isZodError } from './errors/errorHandler.js';
 export { generateJwtToken, decodeJwtToken } from './jwt-utils/tokenUtils.js';
 export { createStaticTokenAuthPreHandler } from './route-utils/authPreHandlers.js';
+export { getFastifyAppLoggingConfig, } from './plugins/pluginsCommon.js';
 //# sourceMappingURL=index.js.map

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,qCAAqC,EACrC,+BAA+B,GAChC,MAAM,oDAAoD,CAAA;AAG3D,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,wBAAwB,EAAE,MAAM,mDAAmD,CAAA;AAG5F,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"}
+{"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,qCAAqC,EACrC,+BAA+B,GAChC,MAAM,oDAAoD,CAAA;AAG3D,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,wBAAwB,EAAE,MAAM,mDAAmD,CAAA;AAG5F,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;AAClF,OAAO,EACL,0BAA0B,GAG3B,MAAM,4BAA4B,CAAA"}

package/dist/plugins/pluginsCommon.d.ts

@@ -1,4 +1,5 @@
-import type { CommonLogger } from '@lokalise/node-core';
-import type { FastifyInstance, FastifyTypeProviderDefault, RawReplyDefaultExpression, RawRequestDefaultExpression, RawServerDefault } from 'fastify';
+import type { AppConfig, CommonLogger } from '@lokalise/node-core';
+import type { FastifyInstance, FastifyServerOptions, FastifyTypeProviderDefault, RawReplyDefaultExpression, RawRequestDefaultExpression, RawServerDefault } from 'fastify';
 export type CommonFastifyInstance = FastifyInstance<RawServerDefault, RawRequestDefaultExpression, RawReplyDefaultExpression, CommonLogger, FastifyTypeProviderDefault>;
 export type AnyFastifyInstance = FastifyInstance<any, any, any, any, any>;
+export declare function getFastifyAppLoggingConfig(appLogLevel: AppConfig['logLevel'], requestLoggingLevels?: string[]): Pick<FastifyServerOptions, 'disableRequestLogging'>;

package/dist/plugins/pluginsCommon.js

@@ -1,2 +1,12 @@
-export {};
+// Service utility endpoints to exclude from request logging
+const REQUEST_LOGGING_SKIP_PATHS = new Set(['/', '/health', '/ready', '/live', '/metrics']);
+const REQUEST_LOGGING_LEVELS = ['debug', 'trace', 'info'];
+export function getFastifyAppLoggingConfig(appLogLevel, requestLoggingLevels = REQUEST_LOGGING_LEVELS) {
+    const enableRequestLogging = requestLoggingLevels.includes(appLogLevel);
+    return {
+        disableRequestLogging: enableRequestLogging
+            ? (req) => REQUEST_LOGGING_SKIP_PATHS.has(req.url)
+            : true,
+    };
+}
 //# sourceMappingURL=pluginsCommon.js.map

package/dist/plugins/pluginsCommon.js.map

@@ -1 +1 @@
-{"version":3,"file":"pluginsCommon.js","sourceRoot":"","sources":["../../lib/plugins/pluginsCommon.ts"],"names":[],"mappings":""}
+{"version":3,"file":"pluginsCommon.js","sourceRoot":"","sources":["../../lib/plugins/pluginsCommon.ts"],"names":[],"mappings":"AAqBA,4DAA4D;AAC5D,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;AAC3F,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AAEzD,MAAM,UAAU,0BAA0B,CACxC,WAAkC,EAClC,oBAAoB,GAAG,sBAAsB;IAE7C,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IACvE,OAAO;QACL,qBAAqB,EAAE,oBAAoB;YACzC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YAClD,CAAC,CAAC,IAAI;KACT,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lokalise/fastify-extras",
-    "version": "30.4.0",
+    "version": "30.5.0",
     "description": "Opinionated set of fastify plugins, commonly used in Lokalise",
     "author": {
         "name": "Lokalise",
@@ -52,7 +52,7 @@
         "@lokalise/node-core": ">=14.0.0",
         "@opentelemetry/api": ">=1.9.0",
         "bullmq": "^5.19.0",
-        "fastify": "^5.5.0",
+        "fastify": "^5.7.1",
         "fastify-type-provider-zod": ">=6.0.0",
         "ioredis": "^5.7.0",
         "newrelic": ">=11.13.0",
@@ -72,11 +72,11 @@
         "@types/node": "^24.7.0",
         "@vitest/coverage-v8": "^3.2.4",
         "auto-changelog": "^2.4.0",
-        "bullmq": "^5.61.0",
-        "fastify": "^5.6.1",
+        "bullmq": "^5.67.1",
+        "fastify": "^5.7.2",
         "fastify-type-provider-zod": "^6.0.0",
         "ioredis": "^5.6.1",
-        "newrelic": "13.9.2",
+        "newrelic": "13.10.0",
         "pino": "^10.0.0",
         "pino-pretty": "^13.1.1",
         "rimraf": "^6.0.1",