@lokalise/fastify-extras 16.0.0 → 16.1.0

package/dist/errors/errorHandler.d.ts

@@ -0,0 +1,18 @@
+import type { ErrorReporter } from '@lokalise/node-core';
+import type { FastifyRequest, FastifyReply, FastifyInstance } from 'fastify';
+export type FreeformRecord = Record<string, any>;
+type ResponseObject = {
+    statusCode: number;
+    payload: {
+        message: string;
+        errorCode: string;
+        details?: FreeformRecord;
+    };
+};
+export type ErrorHandlerParams = {
+    errorReporter: ErrorReporter;
+    resolveResponseObject?: (error: FreeformRecord) => ResponseObject | undefined;
+    resolveLogObject?: (error: unknown) => FreeformRecord | undefined;
+};
+export declare function createErrorHandler(params: ErrorHandlerParams): (this: FastifyInstance, error: FreeformRecord, request: FastifyRequest, reply: FastifyReply) => void;
+export {};

package/dist/errors/errorHandler.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorHandler = void 0;
+const tslib_1 = require("tslib");
+const node_core_1 = require("@lokalise/node-core");
+const pino_1 = tslib_1.__importDefault(require("pino"));
+const zod_1 = require("zod");
+const knownAuthErrors = new Set([
+    'FST_JWT_NO_AUTHORIZATION_IN_HEADER',
+    'FST_JWT_AUTHORIZATION_TOKEN_EXPIRED',
+    'FST_JWT_AUTHORIZATION_TOKEN_INVALID',
+]);
+function resolveLogObject(error) {
+    if ((0, node_core_1.isInternalError)(error)) {
+        return {
+            message: error.message,
+            code: error.errorCode,
+            details: error.details ? JSON.stringify(error.details) : undefined,
+            error: pino_1.default.stdSerializers.err({
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            }),
+        };
+    }
+    return {
+        message: (0, node_core_1.isObject)(error) ? error.message : JSON.stringify(error),
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        error: error instanceof Error ? pino_1.default.stdSerializers.err(error) : error,
+    };
+}
+function resolveResponseObject(error) {
+    if ((0, node_core_1.isPublicNonRecoverableError)(error)) {
+        return {
+            statusCode: error.httpStatusCode ?? 500,
+            payload: {
+                message: error.message,
+                errorCode: error.errorCode,
+                details: error.details,
+            },
+        };
+    }
+    if (error instanceof zod_1.ZodError) {
+        return {
+            statusCode: 400,
+            payload: {
+                message: 'Invalid params',
+                errorCode: 'VALIDATION_ERROR',
+                details: {
+                    error: error.issues,
+                },
+            },
+        };
+    }
+    if ((0, node_core_1.isStandardizedError)(error)) {
+        if (knownAuthErrors.has(error.code)) {
+            const message = error.code === 'FST_JWT_AUTHORIZATION_TOKEN_INVALID'
+                ? 'Authorization token is invalid'
+                : error.message;
+            return {
+                statusCode: 401,
+                payload: {
+                    message,
+                    errorCode: 'AUTH_FAILED',
+                },
+            };
+        }
+    }
+    return {
+        statusCode: 500,
+        payload: {
+            message: 'Internal server error',
+            errorCode: 'INTERNAL_SERVER_ERROR',
+        },
+    };
+}
+function createErrorHandler(params) {
+    return function errorHandler(error, request, reply) {
+        const logObject = params.resolveLogObject?.(error) ?? resolveLogObject(error);
+        if ((0, node_core_1.isInternalError)(error)) {
+            params.errorReporter.report({ error });
+        }
+        const responseObject = params.resolveResponseObject?.(error) ?? resolveResponseObject(error);
+        if (responseObject.statusCode >= 500) {
+            request.log.error(logObject);
+        }
+        void reply.status(responseObject.statusCode).send(responseObject.payload);
+    };
+}
+exports.createErrorHandler = createErrorHandler;
+//# sourceMappingURL=errorHandler.js.map

package/dist/errors/errorHandler.js.map

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

package/dist/errors/errorHandler.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/errors/errorHandler.spec.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const node_core_1 = require("@lokalise/node-core");
+const fastify_1 = tslib_1.__importDefault(require("fastify"));
+const vitest_1 = require("vitest");
+const zod_1 = require("zod");
+const errorHandler_1 = require("./errorHandler");
+async function initApp(routeHandler, errorHandlerParams = {}, awaitApp = true) {
+    const app = (0, fastify_1.default)({
+        logger: true,
+    });
+    app.setErrorHandler((0, errorHandler_1.createErrorHandler)({
+        errorReporter: {
+            report: () => { },
+        },
+        ...errorHandlerParams,
+    }));
+    app.route({
+        method: 'GET',
+        url: '/',
+        handler: routeHandler,
+    });
+    if (awaitApp) {
+        await app.ready();
+    }
+    return app;
+}
+describe('errorHandler', () => {
+    let app;
+    afterAll(async () => {
+        await app.close();
+    });
+    it('returns 500 internal error by default', async () => {
+        app = await initApp(() => {
+            throw new Error('Generic error');
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(500);
+        expect(response.json()).toEqual({
+            errorCode: 'INTERNAL_SERVER_ERROR',
+            message: 'Internal server error',
+        });
+    });
+    it('can override response resolution', async () => {
+        app = await initApp(() => {
+            throw new node_core_1.PublicNonRecoverableError({
+                message: 'Auth failed',
+                errorCode: 'AUTH_FAILED',
+                httpStatusCode: 401,
+                details: { someDetails: 'details' },
+            });
+        }, {
+            resolveResponseObject: (error) => {
+                return {
+                    statusCode: 502,
+                    payload: {
+                        message: error.message + '1',
+                        errorCode: 'TEST_ERR',
+                        details: {
+                            someValues: 1,
+                        },
+                    },
+                };
+            },
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(502);
+        expect(response.json()).toEqual({
+            details: {
+                someValues: 1,
+            },
+            errorCode: 'TEST_ERR',
+            message: 'Auth failed1',
+        });
+    });
+    it('can override logged object resolution', async () => {
+        let logSpy;
+        app = await initApp((req) => {
+            logSpy = vitest_1.vitest.spyOn(req.log, 'error');
+            throw new node_core_1.InternalError({
+                message: 'Internal error',
+                errorCode: 'INTERNAL',
+            });
+        }, {
+            resolveLogObject: (error) => {
+                return {
+                    message: error.message + '22',
+                };
+            },
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(500);
+        expect(logSpy.mock.calls).toHaveLength(1);
+        expect(logSpy.mock.calls[0]).toEqual([
+            {
+                message: 'Internal error22',
+            },
+        ]);
+    });
+    it('sends error to the reporter', async () => {
+        const logs = [];
+        app = await initApp(() => {
+            throw new node_core_1.InternalError({
+                message: 'Internal error',
+                errorCode: 'INTERNAL',
+            });
+        }, {
+            errorReporter: {
+                report: (err) => {
+                    logs.push(err);
+                },
+            },
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(500);
+        expect(logs).toHaveLength(1);
+        expect(logs[0].error).toMatchObject({
+            message: 'Internal error',
+            errorCode: 'INTERNAL',
+        });
+    });
+    it('responds with AUTH_FAILED in case of internal auth failed error', async () => {
+        app = await initApp(() => {
+            throw new node_core_1.PublicNonRecoverableError({
+                message: 'Auth failed',
+                errorCode: 'AUTH_FAILED',
+                httpStatusCode: 401,
+                details: { someDetails: 'details' },
+            });
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(401);
+        expect(response.json()).toEqual({
+            message: 'Auth failed',
+            errorCode: 'AUTH_FAILED',
+            details: { someDetails: 'details' },
+        });
+    });
+    it('responds with 401 for standardized token error with invalid token', async () => {
+        app = await initApp(() => {
+            const err = new Error('Auth failed');
+            // @ts-expect-error
+            err.code = 'FST_JWT_AUTHORIZATION_TOKEN_INVALID';
+            throw err;
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(401);
+        expect(response.json()).toEqual({
+            message: 'Authorization token is invalid',
+            errorCode: 'AUTH_FAILED',
+        });
+    });
+    it('responds with 401 for standardized token error with expired token', async () => {
+        app = await initApp(() => {
+            const err = new Error('Auth failed');
+            // @ts-expect-error
+            err.code = 'FST_JWT_NO_AUTHORIZATION_IN_HEADER';
+            throw err;
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(401);
+        expect(response.json()).toEqual({
+            message: 'Auth failed',
+            errorCode: 'AUTH_FAILED',
+        });
+    });
+    it('returns 500 for InternalError', async () => {
+        app = await initApp(() => {
+            throw new node_core_1.InternalError({
+                message: 'Auth failed',
+                details: { userId: 4 },
+                errorCode: 'INT_ERR',
+            });
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(500);
+        expect(response.json()).toEqual({
+            errorCode: 'INTERNAL_SERVER_ERROR',
+            message: 'Internal server error',
+        });
+    });
+    it('returns 400 for Zod errors', async () => {
+        app = await initApp(() => {
+            zod_1.z.string().parse(45);
+        });
+        const response = await app.inject().get('/').end();
+        expect(response.statusCode).toBe(400);
+        expect(response.json()).toEqual({
+            errorCode: 'VALIDATION_ERROR',
+            message: 'Invalid params',
+            details: {
+                error: [
+                    {
+                        code: 'invalid_type',
+                        expected: 'string',
+                        message: 'Expected string, received number',
+                        path: [],
+                        received: 'number',
+                    },
+                ],
+            },
+        });
+    });
+});
+//# sourceMappingURL=errorHandler.spec.js.map

package/dist/errors/errorHandler.spec.js.map

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

package/dist/index.d.ts

@@ -20,3 +20,5 @@ export { amplitudePlugin, Amplitude, type AmplitudeConfig, type CreateApiTrackin
 export type { FastifyReplyWithPayload } from './types';
 export { unhandledExceptionPlugin } from './plugins/unhandledExceptionPlugin';
 export type { UnhandledExceptionPluginOptions } from './plugins/unhandledExceptionPlugin';
+export { createErrorHandler } from './errors/errorHandler';
+export type { ErrorHandlerParams, FreeformRecord } from './errors/errorHandler';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.unhandledExceptionPlugin = exports.Amplitude = exports.amplitudePlugin = exports.wrapHealthCheck = exports.publicHealthcheckPlugin = exports.prismaOtelTracingPlugin = exports.metricsPlugin = exports.wrapHealthCheckForPrometheus = exports.healthcheckMetricsPlugin = exports.SplitIOFeatureManager = exports.splitIOFeatureManagerPlugin = exports.NewRelicTransactionManager = exports.newrelicTransactionManagerPlugin = exports.REQUEST_ID_STORE_KEY = exports.getRequestIdFastifyAppConfig = exports.requestContextProviderPlugin = exports.reportErrorToBugsnag = exports.bugsnagPlugin = void 0;
+exports.createErrorHandler = exports.unhandledExceptionPlugin = exports.Amplitude = exports.amplitudePlugin = exports.wrapHealthCheck = exports.publicHealthcheckPlugin = exports.prismaOtelTracingPlugin = exports.metricsPlugin = exports.wrapHealthCheckForPrometheus = exports.healthcheckMetricsPlugin = exports.SplitIOFeatureManager = exports.splitIOFeatureManagerPlugin = exports.NewRelicTransactionManager = exports.newrelicTransactionManagerPlugin = exports.REQUEST_ID_STORE_KEY = exports.getRequestIdFastifyAppConfig = exports.requestContextProviderPlugin = exports.reportErrorToBugsnag = exports.bugsnagPlugin = void 0;
 var bugsnagPlugin_1 = require("./plugins/bugsnagPlugin");
 Object.defineProperty(exports, "bugsnagPlugin", { enumerable: true, get: function () { return bugsnagPlugin_1.bugsnagPlugin; } });
 Object.defineProperty(exports, "reportErrorToBugsnag", { enumerable: true, get: function () { return bugsnagPlugin_1.reportErrorToBugsnag; } });
@@ -30,4 +30,6 @@ Object.defineProperty(exports, "amplitudePlugin", { enumerable: true, get: funct
 Object.defineProperty(exports, "Amplitude", { enumerable: true, get: function () { return amplitudePlugin_1.Amplitude; } });
 var unhandledExceptionPlugin_1 = require("./plugins/unhandledExceptionPlugin");
 Object.defineProperty(exports, "unhandledExceptionPlugin", { enumerable: true, get: function () { return unhandledExceptionPlugin_1.unhandledExceptionPlugin; } });
+var errorHandler_1 = require("./errors/errorHandler");
+Object.defineProperty(exports, "createErrorHandler", { enumerable: true, get: function () { return errorHandler_1.createErrorHandler; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":";;;AAAA,yDAA6E;AAApE,8GAAA,aAAa,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAG5C,uFAI+C;AAH7C,4IAAA,4BAA4B,OAAA;AAC5B,4IAAA,4BAA4B,OAAA;AAC5B,oIAAA,oBAAoB,OAAA;AAItB,+FAGmD;AAFjD,oJAAA,gCAAgC,OAAA;AAChC,8IAAA,0BAA0B,OAAA;AAI5B,qFAG8C;AAF5C,0IAAA,2BAA2B,OAAA;AAC3B,oIAAA,qBAAqB,OAAA;AAIvB,2FAGuD;AAFrD,oIAAA,wBAAwB,OAAA;AACxB,wIAAA,4BAA4B,OAAA;AAQ9B,yDAAuD;AAA9C,8GAAA,aAAa,OAAA;AAGtB,2FAAyF;AAAhF,kIAAA,uBAAuB,OAAA;AAGhC,yFAAuF;AAA9E,kIAAA,uBAAuB,OAAA;AAMhC,+EAA0E;AAAjE,qHAAA,eAAe,OAAA;AAGxB,6DAKkC;AAJhC,kHAAA,eAAe,OAAA;AACf,4GAAA,SAAS,OAAA;AAOX,+EAA6E;AAApE,oIAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":";;;AAAA,yDAA6E;AAApE,8GAAA,aAAa,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAG5C,uFAI+C;AAH7C,4IAAA,4BAA4B,OAAA;AAC5B,4IAAA,4BAA4B,OAAA;AAC5B,oIAAA,oBAAoB,OAAA;AAItB,+FAGmD;AAFjD,oJAAA,gCAAgC,OAAA;AAChC,8IAAA,0BAA0B,OAAA;AAI5B,qFAG8C;AAF5C,0IAAA,2BAA2B,OAAA;AAC3B,oIAAA,qBAAqB,OAAA;AAIvB,2FAGuD;AAFrD,oIAAA,wBAAwB,OAAA;AACxB,wIAAA,4BAA4B,OAAA;AAQ9B,yDAAuD;AAA9C,8GAAA,aAAa,OAAA;AAGtB,2FAAyF;AAAhF,kIAAA,uBAAuB,OAAA;AAGhC,yFAAuF;AAA9E,kIAAA,uBAAuB,OAAA;AAMhC,+EAA0E;AAAjE,qHAAA,eAAe,OAAA;AAGxB,6DAKkC;AAJhC,kHAAA,eAAe,OAAA;AACf,4GAAA,SAAS,OAAA;AAOX,+EAA6E;AAApE,oIAAA,wBAAwB,OAAA;AAGjC,sDAA0D;AAAjD,kHAAA,kBAAkB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokalise/fastify-extras",
-  "version": "16.0.0",
+  "version": "16.1.0",
   "description": "Opinionated set of fastify plugins, commonly used in Lokalise",
   "author": {
     "name": "Lokalise",
@@ -62,7 +62,8 @@
     "@fastify/request-context": "^5.0.0",
     "fastify": "^4.24.3",
     "newrelic": "^11.0.0",
-    "pino": "^8.16.2"
+    "pino": "^8.16.2",
+    "zod": "^3.22.4"
   },
   "devDependencies": {
     "@fastify/request-context": "^5.0.0",
@@ -87,7 +88,8 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.3.2",
     "vitest": "^0.34.6",
-    "vite": "4.5.0"
+    "vite": "4.5.0",
+    "zod": "^3.22.4"
   },
   "engines": {
     "node": ">=18"