@lucaapp/service-utils 1.56.4 → 1.56.6

package/dist/lib/api/endpoint.js

@@ -9,6 +9,9 @@ const assert_1 = __importDefault(require("assert"));
 const http_1 = require("./types/http");
 const libphonenumber_js_1 = require("libphonenumber-js");
 const busboy_1 = __importDefault(require("busboy"));
+const isRawResponse = (response) => {
+    return response.isRawResponseEnd === true;
+};
 const sendBadContextError = (response, error, debug) => {
     response.err = error;
     return response.status(500).send({
@@ -120,9 +123,12 @@ const isTypedError = (error) => {
 };
 const validateAndSendResponse = async (expressResponse, response, validResponses, debug) => {
     try {
+        if (isRawResponse(response)) {
+            expressResponse.end();
+            return;
+        }
         (0, assert_1.default)(typeof response.status === 'number');
-        // get schema respective to status code
-        const responseSchema = validResponses.find(responseSchema => responseSchema.status === response.status);
+        const responseSchema = validResponses.find(r => r.status === response.status);
         const schema = responseSchema?.schema;
         (0, assert_1.default)(schema);
         if (response.headers) {
@@ -130,10 +136,16 @@ const validateAndSendResponse = async (expressResponse, response, validResponses
                 expressResponse.set(header, value);
             });
         }
-        // validate response schema
-        const validatedResponseBody = await schema.parseAsync(response.body);
+        const validatedResponseBody = await schema
+            .parseAsync(response.body)
+            .catch(error => {
+            if (debug || process.env.NODE_ENV !== 'production') {
+                throw error;
+            }
+            console.error('Response schema validation failed:', error);
+            return response.body; // Return original body in production
+        });
         if (validatedResponseBody === undefined) {
-            // No Content Response
             expressResponse.status(response.status).end();
             return;
         }
@@ -300,7 +312,7 @@ const mountEndpoint = (router, method, path, options, handler, debug) => {
             }
             await handler(handlerRequest, ctx, async (controllerResponse) => {
                 await validateAndSendResponse(response, controllerResponse, options.responses, debug);
-            });
+            }, response);
         }
         catch (error) {
             sendErrorResponse(response, error, options.errors, debug);

package/dist/lib/api/response.d.ts

@@ -15,4 +15,10 @@ export declare const noContentResponse: () => {
     description: string;
     schema: typeof noContentSchema;
 };
+export declare const rawResponseEnd: () => {
+    status: number;
+    isRawResponseEnd: true;
+    description: string;
+    schema: typeof noContentSchema;
+};
 export {};

package/dist/lib/api/response.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.noContentResponse = exports.createdResponse = exports.okResponse = void 0;
+exports.rawResponseEnd = exports.noContentResponse = exports.createdResponse = exports.okResponse = void 0;
 const zod_to_openapi_1 = require("@asteasolutions/zod-to-openapi");
 const zod_1 = require("zod");
 (0, zod_to_openapi_1.extendZodWithOpenApi)(zod_1.z);
@@ -25,3 +25,10 @@ const noContentResponse = () => ({
     schema: noContentSchema,
 });
 exports.noContentResponse = noContentResponse;
+const rawResponseEnd = () => ({
+    status: 0,
+    isRawResponseEnd: true,
+    description: 'rawEnd',
+    schema: noContentSchema,
+});
+exports.rawResponseEnd = rawResponseEnd;

package/dist/lib/api/send.d.ts

@@ -13,3 +13,11 @@ export declare const noContent: <T>(headers?: T | undefined) => {
     body: void;
     headers?: T | undefined;
 };
+/**
+ * Specifies that the response is a raw response.
+ *
+ * `response.end()` is called in the handler function.
+ */
+export declare const rawEnd: () => {
+    isRawResponseEnd: true;
+};

package/dist/lib/api/send.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.noContent = exports.created = exports.ok = void 0;
+exports.rawEnd = exports.noContent = exports.created = exports.ok = void 0;
 const ok = (body, headers) => ({
     status: 200,
     body: body,
@@ -19,3 +19,12 @@ const noContent = (headers) => ({
     headers: headers,
 });
 exports.noContent = noContent;
+/**
+ * Specifies that the response is a raw response.
+ *
+ * `response.end()` is called in the handler function.
+ */
+const rawEnd = () => ({
+    isRawResponseEnd: true,
+});
+exports.rawEnd = rawEnd;

package/dist/lib/api/types/endpoint.d.ts

@@ -1,11 +1,15 @@
+import { Response } from 'express';
 import { Middleware, EndpointResponseSchema } from './middleware';
 import { ArrayToUnion, ExtractZodOutput, ExtractZodOutputFromMiddleware, Always, Merge, ZodSchemaOuput } from './utils';
+export type RawResponseEnd = {
+    isRawResponseEnd: boolean;
+};
 export type EndpointHandler<TResponse, TRequestBodySchema, TRequestParamsSchema, TRequestQuerySchema, TRequestHeadersSchema, TMiddlewares> = (request: {
     body: ZodSchemaOuput<TRequestBodySchema>;
     params: ZodSchemaOuput<TRequestParamsSchema>;
     query: ZodSchemaOuput<TRequestQuerySchema>;
     headers: ZodSchemaOuput<TRequestHeadersSchema>;
-}, context: Merge<Always<ExtractZodOutputFromMiddleware<ArrayToUnion<TMiddlewares>>>>, send: (response: ExtractZodOutput<ArrayToUnion<TResponse>>) => void) => Promise<void>;
+}, context: Merge<Always<ExtractZodOutputFromMiddleware<ArrayToUnion<TMiddlewares>>>>, send: (response: ExtractZodOutput<ArrayToUnion<TResponse>> | RawResponseEnd) => void, rawResponse: Response) => Promise<void>;
 export type EndpointOptions<TResponseSchemas extends ReadonlyArray<EndpointResponseSchema>, TRequestBodySchema, TRequestParamsSchema, TRequestQuerySchema, TRequestHeadersSchema, TMiddlewares extends ReadonlyArray<Middleware<any, any, any, any, any, any>> | undefined> = {
     schemas?: {
         body?: TRequestBodySchema;

package/dist/lib/api/types/middleware.d.ts

@@ -6,6 +6,7 @@ export type EndpointResponseSchema = {
     description: string;
     schema: z.ZodSchema<any> | z.ZodVoid;
     headers?: Record<string, string>;
+    isRawResponseEnd?: boolean;
 };
 export type FileUpload = {
     buffer: Buffer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaapp/service-utils",
-  "version": "1.56.4",
+  "version": "1.56.6",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [