@cryptexlabs/codex-nodejs-common 0.15.5 → 0.16.1

package/lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cryptexlabs/codex-nodejs-common",
-    "version": "0.15.5",
+    "version": "0.16.1",
     "description": "Common code for Codex framework",
     "main": "lib/src/index.js",
     "type": "commonjs",

package/lib/src/decorator/api-meta-headers.d.ts

@@ -1 +1 @@
-export declare function ApiMetaHeaders(): <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare function ApiMetaHeaders(required?: boolean): <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/lib/src/decorator/api-meta-headers.js

@@ -4,18 +4,22 @@ exports.ApiMetaHeaders = ApiMetaHeaders;
 const swagger_1 = require("@nestjs/swagger");
 const common_1 = require("@nestjs/common");
 const uuid_1 = require("uuid");
-function ApiMetaHeaders() {
+function ApiMetaHeaders(required = undefined) {
     return (0, common_1.applyDecorators)(...[
         (0, swagger_1.ApiHeader)({
             name: "X-Correlation-Id",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: (0, uuid_1.v4)(),
             },
         }),
         (0, swagger_1.ApiHeader)({
             name: "Accept-Language",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: "en-US",
             },
@@ -23,7 +27,9 @@ function ApiMetaHeaders() {
         (0, swagger_1.ApiHeader)({
             name: "X-Started",
             description: "The time that the very first user initiated or time initiated event that eventually lead to this api being called was created",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: new Date().toISOString(),
             },
@@ -31,7 +37,9 @@ function ApiMetaHeaders() {
         (0, swagger_1.ApiHeader)({
             name: "X-Context-Category",
             description: "A category for the context of the request. For example 'test' or 'performance test'",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: "default",
             },
@@ -39,7 +47,9 @@ function ApiMetaHeaders() {
         (0, swagger_1.ApiHeader)({
             name: "X-Context-Id",
             description: "A unique context identifier used for correlating logs and metrics usually for performance or experimental testing",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: "none",
             },
@@ -47,7 +57,9 @@ function ApiMetaHeaders() {
         (0, swagger_1.ApiHeader)({
             name: "X-Client-Id",
             description: "A unique identifier for the client to help identify exactly which application or third party is making the requests",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {},
             examples: {
                 UUIDV4: {
@@ -61,7 +73,9 @@ function ApiMetaHeaders() {
         (0, swagger_1.ApiHeader)({
             name: "X-Client-Name",
             description: "The name of the client",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: "swagger",
             },
@@ -70,7 +84,9 @@ function ApiMetaHeaders() {
             name: "X-Client-Version",
             description: "The version of the client. If the client is making bad requests this helps " +
                 "identify which version of the client is making the bad requests",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: "0.3.6",
             },
@@ -78,7 +94,9 @@ function ApiMetaHeaders() {
         (0, swagger_1.ApiHeader)({
             name: "X-Client-Variant",
             description: "Usually an environment or build type such as dev, test, or prod",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: "dev",
             },
@@ -86,7 +104,9 @@ function ApiMetaHeaders() {
         (0, swagger_1.ApiHeader)({
             name: "X-Created",
             description: "The time the client initiated the http request",
-            required: true,
+            required: required !== undefined
+                ? required
+                : process.env.X_META_HEADERS_REQUIRED !== "false",
             schema: {
                 example: new Date().toISOString(),
             },

package/lib/src/decorator/api-meta-headers.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-meta-headers.js","sourceRoot":"","sources":["../../../src/decorator/api-meta-headers.ts"],"names":[],"mappings":";;AAIA,wCAiHC;AArHD,6CAA4C;AAC5C,2CAAiD;AACjD,+BAAoC;AAEpC,SAAgB,cAAc;IAC5B,OAAO,IAAA,wBAAe,EACpB,GAAG;QACD,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,kBAAkB;YACxB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,IAAA,SAAM,GAAE;aAClB;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,OAAO;aACjB;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,+HAA+H;YACjI,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAClC;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,qFAAqF;YACvF,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,SAAS;aACnB;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,mHAAmH;YACrH,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,MAAM;aAChB;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,qHAAqH;YACvH,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE;gBACR,MAAM,EAAE;oBACN,KAAK,EAAE,sCAAsC;iBAC9C;gBACD,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC;iBACT;aACF;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,SAAS;aACnB;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,6EAA6E;gBAC7E,iEAAiE;YACnE,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,OAAO;aACjB;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,iEAAiE;YACnE,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;aACf;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAClC;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAClC;SACF,CAAC;QACF,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,yEAAyE;YAC3E,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE;gBACN,OAAO,EAAE,iBAAiB;aAC3B;SACF,CAAC;KACH,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"api-meta-headers.js","sourceRoot":"","sources":["../../../src/decorator/api-meta-headers.ts"],"names":[],"mappings":"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"}

package/lib/src/response/strip-meta.response.interceptor.d.ts

@@ -0,0 +1,5 @@
+import { CallHandler, ExecutionContext, NestInterceptor } from "@nestjs/common";
+import { Observable } from "rxjs";
+export declare class StripMetaResponseInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}

package/lib/src/response/strip-meta.response.interceptor.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripMetaResponseInterceptor = void 0;
+const rxjs_1 = require("rxjs");
+class StripMetaResponseInterceptor {
+    intercept(context, next) {
+        var _a;
+        if (context.getType() !== "http") {
+            return next.handle();
+        }
+        const request = context.switchToHttp().getRequest();
+        const headerValue = (_a = request === null || request === void 0 ? void 0 : request.headers) === null || _a === void 0 ? void 0 : _a["x-include-meta"];
+        const headerString = Array.isArray(headerValue)
+            ? headerValue[0]
+            : headerValue;
+        const headerWantsMeta = (headerString !== null && headerString !== void 0 ? headerString : "").toString().toLowerCase() === "true";
+        const envSaysStripByDefault = process.env.X_INCLUDE_META_DEFAULT === "false";
+        const headerIsUnset = headerString === undefined || headerString === "false";
+        const shouldStrip = !headerWantsMeta && envSaysStripByDefault && headerIsUnset;
+        if (!shouldStrip) {
+            return next.handle();
+        }
+        return next.handle().pipe((0, rxjs_1.map)((value) => {
+            if (value &&
+                typeof value === "object" &&
+                "data" in value) {
+                return value.data;
+            }
+            return value;
+        }));
+    }
+}
+exports.StripMetaResponseInterceptor = StripMetaResponseInterceptor;
+//# sourceMappingURL=strip-meta.response.interceptor.js.map

package/lib/src/response/strip-meta.response.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-meta.response.interceptor.js","sourceRoot":"","sources":["../../../src/response/strip-meta.response.interceptor.ts"],"names":[],"mappings":";;;AACA,+BAAuC;AAEvC,MAAa,4BAA4B;IACvC,SAAS,CAAC,OAAyB,EAAE,IAAiB;;QAEpD,IAAI,OAAO,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,0CAAG,gBAAgB,CAG1C,CAAC;QAGd,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC7C,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;YAChB,CAAC,CAAC,WAAW,CAAC;QAGhB,MAAM,eAAe,GACnB,CAAC,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QAG3D,MAAM,qBAAqB,GACzB,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,OAAO,CAAC;QACjD,MAAM,aAAa,GACjB,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,OAAO,CAAC;QAEzD,MAAM,WAAW,GACf,CAAC,eAAe,IAAI,qBAAqB,IAAI,aAAa,CAAC;QAE7D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAGD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CACvB,IAAA,UAAG,EAAC,CAAC,KAAc,EAAE,EAAE;YACrB,IACE,KAAK;gBACL,OAAO,KAAK,KAAK,QAAQ;gBACzB,MAAM,IAAK,KAAiC,EAC5C,CAAC;gBACD,OAAQ,KAA2B,CAAC,IAAI,CAAC;YAC3C,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AAjDD,oEAiDC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cryptexlabs/codex-nodejs-common",
-  "version": "0.15.5",
+  "version": "0.16.1",
   "description": "Common code for Codex framework",
   "main": "lib/src/index.js",
   "type": "commonjs",

package/src/decorator/api-meta-headers.ts

@@ -2,19 +2,25 @@ import { ApiHeader } from "@nestjs/swagger";
 import { applyDecorators } from "@nestjs/common";
 import { v4 as uuidV4 } from "uuid";
 
-export function ApiMetaHeaders() {
+export function ApiMetaHeaders(required: boolean = undefined) {
   return applyDecorators(
     ...[
       ApiHeader({
         name: "X-Correlation-Id",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: uuidV4(),
         },
       }),
       ApiHeader({
         name: "Accept-Language",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: "en-US",
         },
@@ -23,7 +29,10 @@ export function ApiMetaHeaders() {
         name: "X-Started",
         description:
           "The time that the very first user initiated or time initiated event that eventually lead to this api being called was created",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: new Date().toISOString(),
         },
@@ -32,7 +41,10 @@ export function ApiMetaHeaders() {
         name: "X-Context-Category",
         description:
           "A category for the context of the request. For example 'test' or 'performance test'",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: "default",
         },
@@ -41,7 +53,10 @@ export function ApiMetaHeaders() {
         name: "X-Context-Id",
         description:
           "A unique context identifier used for correlating logs and metrics usually for performance or experimental testing",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: "none",
         },
@@ -50,7 +65,10 @@ export function ApiMetaHeaders() {
         name: "X-Client-Id",
         description:
           "A unique identifier for the client to help identify exactly which application or third party is making the requests",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {},
         examples: {
           UUIDV4: {
@@ -64,7 +82,10 @@ export function ApiMetaHeaders() {
       ApiHeader({
         name: "X-Client-Name",
         description: "The name of the client",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: "swagger",
         },
@@ -74,7 +95,10 @@ export function ApiMetaHeaders() {
         description:
           "The version of the client. If the client is making bad requests this helps " +
           "identify which version of the client is making the bad requests",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: "0.3.6",
         },
@@ -83,7 +107,10 @@ export function ApiMetaHeaders() {
         name: "X-Client-Variant",
         description:
           "Usually an environment or build type such as dev, test, or prod",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: "dev",
         },
@@ -91,7 +118,10 @@ export function ApiMetaHeaders() {
       ApiHeader({
         name: "X-Created",
         description: "The time the client initiated the http request",
-        required: true,
+        required:
+          required !== undefined
+            ? required
+            : process.env.X_META_HEADERS_REQUIRED !== "false",
         schema: {
           example: new Date().toISOString(),
         },

package/src/response/strip-meta.response.interceptor.ts

@@ -0,0 +1,53 @@
+import { CallHandler, ExecutionContext, NestInterceptor } from "@nestjs/common";
+import { map, Observable } from "rxjs";
+
+export class StripMetaResponseInterceptor implements NestInterceptor {
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
+    // Only applicable to HTTP requests (headers)
+    if (context.getType() !== "http") {
+      return next.handle();
+    }
+
+    const request = context.switchToHttp().getRequest();
+    const headerValue = request?.headers?.["x-include-meta"] as
+      | string
+      | string[]
+      | undefined;
+
+    // Normalize header to a single string (or undefined)
+    const headerString = Array.isArray(headerValue)
+      ? headerValue[0]
+      : headerValue;
+
+    // If header explicitly says "true", always include meta
+    const headerWantsMeta =
+      (headerString ?? "").toString().toLowerCase() === "true";
+
+    // Only strip when env is explicitly false AND header is not set at all
+    const envSaysStripByDefault =
+      process.env.X_INCLUDE_META_DEFAULT === "false";
+    const headerIsUnset =
+      headerString === undefined || headerString === "false";
+
+    const shouldStrip =
+      !headerWantsMeta && envSaysStripByDefault && headerIsUnset;
+
+    if (!shouldStrip) {
+      return next.handle();
+    }
+
+    // Strip to value.data when present; otherwise leave as-is
+    return next.handle().pipe(
+      map((value: unknown) => {
+        if (
+          value &&
+          typeof value === "object" &&
+          "data" in (value as Record<string, unknown>)
+        ) {
+          return (value as { data: unknown }).data;
+        }
+        return value;
+      })
+    );
+  }
+}