grm-shared-library 1.1.37 → 1.1.38

package/dist/cjs/constants/http-headers.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTP_HEADERS = void 0;
+/**
+ * Standard HTTP headers used across microservices for user context
+ */
+exports.HTTP_HEADERS = {
+    USER_CONTEXT: 'X-User-Context',
+    USER_ID: 'X-User-Id',
+    ACCESS_SCOPE: 'X-Access-Scope',
+    ORGANIZATION_ID: 'X-Organization-Id',
+    CONTROL_CENTRE_ID: 'X-Control-Centre-Id',
+    USER_ROLES: 'X-User-Roles'
+};
+//# sourceMappingURL=http-headers.js.map

package/dist/cjs/constants/http-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-headers.js","sourceRoot":"","sources":["../../../src/constants/http-headers.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,YAAY,GAAG;IACxB,YAAY,EAAE,gBAAgB;IAC9B,OAAO,EAAE,WAAW;IACpB,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,mBAAmB;IACpC,iBAAiB,EAAE,qBAAqB;IACxC,UAAU,EAAE,cAAc;CACpB,CAAC"}

package/dist/cjs/index.js

@@ -33,10 +33,13 @@ __exportStar(require("./interfaces/i-request-with-user"), exports);
 __exportStar(require("./interfaces/validated-user"), exports);
 __exportStar(require("./interfaces/jwt-payload"), exports);
 __exportStar(require("./interfaces/pagination"), exports);
+// Constants
+__exportStar(require("./constants/http-headers"), exports);
 // Kafka
 __exportStar(require("./kafka/index"), exports);
 // Utilities
 __exportStar(require("./decorators/case-decorators"), exports);
+__exportStar(require("./utilities/user-context-header.service"), exports);
 // Exceptions
 __exportStar(require("./exceptions/index"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,wDAAsC;AACtC,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AAEpC,aAAa;AACb,8DAA4C;AAC5C,mEAAiD;AACjD,8DAA4C;AAC5C,2DAAyC;AACzC,0DAAwC;AAExC,QAAQ;AACR,gDAA8B;AAE9B,YAAY;AACZ,+DAA6C;AAE7C,aAAa;AACb,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,wDAAsC;AACtC,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AAEpC,aAAa;AACb,8DAA4C;AAC5C,mEAAiD;AACjD,8DAA4C;AAC5C,2DAAyC;AACzC,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,QAAQ;AACR,gDAA8B;AAE9B,YAAY;AACZ,+DAA6C;AAC7C,0EAAwD;AAExD,aAAa;AACb,qDAAmC"}

package/dist/cjs/utilities/user-context-header.service.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserContextHeaderService = void 0;
+const http_headers_1 = require("../constants/http-headers");
+/**
+ * Utility service for handling user context via HTTP headers
+ * This provides a consistent way to pass user context between API Gateway and microservices
+ */
+class UserContextHeaderService {
+    /**
+     * Convert UserContext to HTTP headers for microservice communication
+     */
+    static buildHeaders(userContext) {
+        const headers = {};
+        headers[http_headers_1.HTTP_HEADERS.USER_ID] = userContext.userId.toString();
+        headers[http_headers_1.HTTP_HEADERS.USER_ROLES] = JSON.stringify(userContext.roles);
+        headers[http_headers_1.HTTP_HEADERS.ACCESS_SCOPE] = JSON.stringify(userContext.accessScope);
+        if (userContext.organizationId) {
+            headers[http_headers_1.HTTP_HEADERS.ORGANIZATION_ID] = userContext.organizationId.toString();
+        }
+        if (userContext.controlCentreId) {
+            headers[http_headers_1.HTTP_HEADERS.CONTROL_CENTRE_ID] = userContext.controlCentreId.toString();
+        }
+        // Also provide full context as single header for convenience
+        headers[http_headers_1.HTTP_HEADERS.USER_CONTEXT] = JSON.stringify(userContext);
+        return headers;
+    }
+    /**
+     * Extract UserContext from HTTP headers in microservices
+     */
+    static extractFromHeaders(headers) {
+        try {
+            // First try to get full context from single header
+            const fullContextHeader = this.getHeaderValue(headers, http_headers_1.HTTP_HEADERS.USER_CONTEXT);
+            if (fullContextHeader) {
+                return JSON.parse(fullContextHeader);
+            }
+            // Fallback: reconstruct from individual headers
+            const userIdHeader = this.getHeaderValue(headers, http_headers_1.HTTP_HEADERS.USER_ID);
+            const rolesHeader = this.getHeaderValue(headers, http_headers_1.HTTP_HEADERS.USER_ROLES);
+            const accessScopeHeader = this.getHeaderValue(headers, http_headers_1.HTTP_HEADERS.ACCESS_SCOPE);
+            if (!userIdHeader || !rolesHeader || !accessScopeHeader) {
+                return null;
+            }
+            const userId = parseInt(userIdHeader);
+            const roles = JSON.parse(rolesHeader);
+            const accessScope = JSON.parse(accessScopeHeader);
+            const organizationIdHeader = this.getHeaderValue(headers, http_headers_1.HTTP_HEADERS.ORGANIZATION_ID);
+            const controlCentreIdHeader = this.getHeaderValue(headers, http_headers_1.HTTP_HEADERS.CONTROL_CENTRE_ID);
+            return {
+                userId,
+                roles,
+                accessScope,
+                organizationId: organizationIdHeader ? parseInt(organizationIdHeader) : undefined,
+                controlCentreId: controlCentreIdHeader ? parseInt(controlCentreIdHeader) : undefined
+            };
+        }
+        catch (error) {
+            console.error('Error extracting user context from headers:', error);
+            return null;
+        }
+    }
+    /**
+     * Helper to get header value (handles string | string[] types)
+     */
+    static getHeaderValue(headers, key) {
+        const value = headers[key.toLowerCase()] || headers[key];
+        if (!value)
+            return null;
+        return Array.isArray(value) ? value[0] : value;
+    }
+}
+exports.UserContextHeaderService = UserContextHeaderService;
+//# sourceMappingURL=user-context-header.service.js.map

package/dist/cjs/utilities/user-context-header.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context-header.service.js","sourceRoot":"","sources":["../../../src/utilities/user-context-header.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/constants/http-headers.js

@@ -0,0 +1,12 @@
+/**
+ * Standard HTTP headers used across microservices for user context
+ */
+export const HTTP_HEADERS = {
+    USER_CONTEXT: 'X-User-Context',
+    USER_ID: 'X-User-Id',
+    ACCESS_SCOPE: 'X-Access-Scope',
+    ORGANIZATION_ID: 'X-Organization-Id',
+    CONTROL_CENTRE_ID: 'X-Control-Centre-Id',
+    USER_ROLES: 'X-User-Roles'
+};
+//# sourceMappingURL=http-headers.js.map

package/dist/esm/constants/http-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-headers.js","sourceRoot":"","sources":["../../../src/constants/http-headers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,YAAY,EAAE,gBAAgB;IAC9B,OAAO,EAAE,WAAW;IACpB,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,mBAAmB;IACpC,iBAAiB,EAAE,qBAAqB;IACxC,UAAU,EAAE,cAAc;CACpB,CAAC"}

package/dist/esm/index.js

@@ -17,10 +17,13 @@ export * from './interfaces/i-request-with-user';
 export * from './interfaces/validated-user';
 export * from './interfaces/jwt-payload';
 export * from './interfaces/pagination';
+// Constants
+export * from './constants/http-headers';
 // Kafka
 export * from './kafka/index';
 // Utilities
 export * from './decorators/case-decorators';
+export * from './utilities/user-context-header.service';
 // Exceptions
 export * from './exceptions/index';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAEpC,aAAa;AACb,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,QAAQ;AACR,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,8BAA8B,CAAC;AAE7C,aAAa;AACb,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAEpC,aAAa;AACb,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,QAAQ;AACR,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AAExD,aAAa;AACb,cAAc,oBAAoB,CAAC"}

package/dist/esm/utilities/user-context-header.service.js

@@ -0,0 +1,70 @@
+import { HTTP_HEADERS } from '../constants/http-headers';
+/**
+ * Utility service for handling user context via HTTP headers
+ * This provides a consistent way to pass user context between API Gateway and microservices
+ */
+export class UserContextHeaderService {
+    /**
+     * Convert UserContext to HTTP headers for microservice communication
+     */
+    static buildHeaders(userContext) {
+        const headers = {};
+        headers[HTTP_HEADERS.USER_ID] = userContext.userId.toString();
+        headers[HTTP_HEADERS.USER_ROLES] = JSON.stringify(userContext.roles);
+        headers[HTTP_HEADERS.ACCESS_SCOPE] = JSON.stringify(userContext.accessScope);
+        if (userContext.organizationId) {
+            headers[HTTP_HEADERS.ORGANIZATION_ID] = userContext.organizationId.toString();
+        }
+        if (userContext.controlCentreId) {
+            headers[HTTP_HEADERS.CONTROL_CENTRE_ID] = userContext.controlCentreId.toString();
+        }
+        // Also provide full context as single header for convenience
+        headers[HTTP_HEADERS.USER_CONTEXT] = JSON.stringify(userContext);
+        return headers;
+    }
+    /**
+     * Extract UserContext from HTTP headers in microservices
+     */
+    static extractFromHeaders(headers) {
+        try {
+            // First try to get full context from single header
+            const fullContextHeader = this.getHeaderValue(headers, HTTP_HEADERS.USER_CONTEXT);
+            if (fullContextHeader) {
+                return JSON.parse(fullContextHeader);
+            }
+            // Fallback: reconstruct from individual headers
+            const userIdHeader = this.getHeaderValue(headers, HTTP_HEADERS.USER_ID);
+            const rolesHeader = this.getHeaderValue(headers, HTTP_HEADERS.USER_ROLES);
+            const accessScopeHeader = this.getHeaderValue(headers, HTTP_HEADERS.ACCESS_SCOPE);
+            if (!userIdHeader || !rolesHeader || !accessScopeHeader) {
+                return null;
+            }
+            const userId = parseInt(userIdHeader);
+            const roles = JSON.parse(rolesHeader);
+            const accessScope = JSON.parse(accessScopeHeader);
+            const organizationIdHeader = this.getHeaderValue(headers, HTTP_HEADERS.ORGANIZATION_ID);
+            const controlCentreIdHeader = this.getHeaderValue(headers, HTTP_HEADERS.CONTROL_CENTRE_ID);
+            return {
+                userId,
+                roles,
+                accessScope,
+                organizationId: organizationIdHeader ? parseInt(organizationIdHeader) : undefined,
+                controlCentreId: controlCentreIdHeader ? parseInt(controlCentreIdHeader) : undefined
+            };
+        }
+        catch (error) {
+            console.error('Error extracting user context from headers:', error);
+            return null;
+        }
+    }
+    /**
+     * Helper to get header value (handles string | string[] types)
+     */
+    static getHeaderValue(headers, key) {
+        const value = headers[key.toLowerCase()] || headers[key];
+        if (!value)
+            return null;
+        return Array.isArray(value) ? value[0] : value;
+    }
+}
+//# sourceMappingURL=user-context-header.service.js.map

package/dist/esm/utilities/user-context-header.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context-header.service.js","sourceRoot":"","sources":["../../../src/utilities/user-context-header.service.ts"],"names":[],"mappings":"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"}

package/dist/types/constants/http-headers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Standard HTTP headers used across microservices for user context
+ */
+export declare const HTTP_HEADERS: {
+    readonly USER_CONTEXT: "X-User-Context";
+    readonly USER_ID: "X-User-Id";
+    readonly ACCESS_SCOPE: "X-Access-Scope";
+    readonly ORGANIZATION_ID: "X-Organization-Id";
+    readonly CONTROL_CENTRE_ID: "X-Control-Centre-Id";
+    readonly USER_ROLES: "X-User-Roles";
+};
+export type HttpHeaders = typeof HTTP_HEADERS[keyof typeof HTTP_HEADERS];

package/dist/types/index.d.ts

@@ -15,6 +15,8 @@ export * from './interfaces/i-request-with-user';
 export * from './interfaces/validated-user';
 export * from './interfaces/jwt-payload';
 export * from './interfaces/pagination';
+export * from './constants/http-headers';
 export * from './kafka/index';
 export * from './decorators/case-decorators';
+export * from './utilities/user-context-header.service';
 export * from './exceptions/index';

package/dist/types/utilities/user-context-header.service.d.ts

@@ -0,0 +1,19 @@
+import { UserContext } from '../modules/user/interfaces/user-context';
+/**
+ * Utility service for handling user context via HTTP headers
+ * This provides a consistent way to pass user context between API Gateway and microservices
+ */
+export declare class UserContextHeaderService {
+    /**
+     * Convert UserContext to HTTP headers for microservice communication
+     */
+    static buildHeaders(userContext: UserContext): Record<string, string>;
+    /**
+     * Extract UserContext from HTTP headers in microservices
+     */
+    static extractFromHeaders(headers: Record<string, string | string[]>): UserContext | null;
+    /**
+     * Helper to get header value (handles string | string[] types)
+     */
+    private static getHeaderValue;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grm-shared-library",
-  "version": "1.1.37",
+  "version": "1.1.38",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",