@dumanarge/xssrv-shared-lib 1.0.3 → 1.0.4

package/dist/auth/tenant.middleware.d.ts

@@ -21,8 +21,13 @@ export declare class TenantGuard implements CanActivate {
     canActivate(context: ExecutionContext): boolean;
 }
 export declare function createPrismaTenantMiddleware(getTenantId: () => string): (params: any, next: (params: any) => Promise<any>) => Promise<any>;
-export declare function extractTenantFromGrpcMetadata(metadata: any): {
+export declare function extractTenantFromGrpcMetadata(metadata: {
+    get: (key: string) => unknown[] | undefined;
+}): {
     tenantId: string;
     userId: string | null;
     roles: string[];
+    accountId?: string;
+    email?: string;
+    requestId?: string;
 };

package/dist/auth/tenant.middleware.js

@@ -120,10 +120,17 @@ function createPrismaTenantMiddleware(getTenantId) {
     };
 }
 function extractTenantFromGrpcMetadata(metadata) {
+    const first = (key) => {
+        const raw = metadata.get(key)?.[0];
+        return raw != null && raw !== '' ? String(raw) : undefined;
+    };
     return {
-        tenantId: metadata.get('x-tenant-id')?.[0] || '',
-        userId: metadata.get('x-user-id')?.[0] || null,
-        roles: (metadata.get('x-roles')?.[0] || '').split(',').filter(Boolean),
+        tenantId: first('x-tenant-id') ?? '',
+        userId: first('x-user-id') ?? null,
+        roles: (first('x-roles') ?? '').split(',').filter(Boolean),
+        accountId: first('x-account-id'),
+        email: first('x-user-email') ?? first('x-email'),
+        requestId: first('x-request-id'),
     };
 }
 //# sourceMappingURL=tenant.middleware.js.map

package/dist/auth/tenant.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenant.middleware.js","sourceRoot":"","sources":["../../src/auth/tenant.middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tenant.middleware.js","sourceRoot":"","sources":["../../src/auth/tenant.middleware.ts"],"names":[],"mappings":"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"}

package/dist/context/index.d.ts

@@ -0,0 +1,3 @@
+export { ObservabilityContext, createHttpObservabilityContext, type ObservabilityContextData, } from './observability-context';
+export { ObservabilityMiddleware } from './observability.middleware';
+export { ObservabilityGrpcInterceptor } from './observability.interceptor';

package/dist/context/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityGrpcInterceptor = exports.ObservabilityMiddleware = exports.createHttpObservabilityContext = exports.ObservabilityContext = void 0;
+var observability_context_1 = require("./observability-context");
+Object.defineProperty(exports, "ObservabilityContext", { enumerable: true, get: function () { return observability_context_1.ObservabilityContext; } });
+Object.defineProperty(exports, "createHttpObservabilityContext", { enumerable: true, get: function () { return observability_context_1.createHttpObservabilityContext; } });
+var observability_middleware_1 = require("./observability.middleware");
+Object.defineProperty(exports, "ObservabilityMiddleware", { enumerable: true, get: function () { return observability_middleware_1.ObservabilityMiddleware; } });
+var observability_interceptor_1 = require("./observability.interceptor");
+Object.defineProperty(exports, "ObservabilityGrpcInterceptor", { enumerable: true, get: function () { return observability_interceptor_1.ObservabilityGrpcInterceptor; } });
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":";;;AAAA,iEAIiC;AAH/B,6HAAA,oBAAoB,OAAA;AACpB,uIAAA,8BAA8B,OAAA;AAGhC,uEAAqE;AAA5D,mIAAA,uBAAuB,OAAA;AAChC,yEAA2E;AAAlE,yIAAA,4BAA4B,OAAA"}

package/dist/context/observability-context.d.ts

@@ -0,0 +1,23 @@
+export interface ObservabilityContextData {
+    requestId: string;
+    correlationId: string;
+    traceId?: string;
+    spanId?: string;
+    tenantId?: string;
+    userId?: string;
+    accountId?: string;
+    userEmail?: string;
+    userRoles?: string[];
+    origin?: 'http' | 'grpc' | 'rabbitmq' | 'cron' | 'system';
+    operation?: string;
+}
+export declare const ObservabilityContext: {
+    run<T>(data: ObservabilityContextData, fn: () => T): T;
+    get(): ObservabilityContextData | undefined;
+    set(patch: Partial<ObservabilityContextData>): void;
+    toLogMeta(): Record<string, unknown>;
+};
+export declare function createHttpObservabilityContext(req: {
+    headers?: Record<string, unknown>;
+    id?: string | number;
+}): ObservabilityContextData;

package/dist/context/observability-context.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityContext = void 0;
+exports.createHttpObservabilityContext = createHttpObservabilityContext;
+const async_hooks_1 = require("async_hooks");
+const crypto_1 = require("crypto");
+const storage = new async_hooks_1.AsyncLocalStorage();
+function readHeader(headers, key) {
+    const raw = headers?.[key];
+    if (Array.isArray(raw)) {
+        return raw[0] ? String(raw[0]) : undefined;
+    }
+    if (typeof raw === 'string') {
+        return raw;
+    }
+    return undefined;
+}
+function readRoles(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    return raw
+        .split(',')
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+exports.ObservabilityContext = {
+    run(data, fn) {
+        return storage.run(data, fn);
+    },
+    get() {
+        return storage.getStore();
+    },
+    set(patch) {
+        const current = storage.getStore();
+        if (!current) {
+            return;
+        }
+        Object.assign(current, patch);
+    },
+    toLogMeta() {
+        const context = storage.getStore();
+        return {
+            requestId: context?.requestId,
+            correlationId: context?.correlationId,
+            traceId: context?.traceId,
+            spanId: context?.spanId,
+            tenantId: context?.tenantId,
+            userId: context?.userId,
+            accountId: context?.accountId,
+            userEmail: context?.userEmail,
+            origin: context?.origin,
+            operation: context?.operation,
+        };
+    },
+};
+function createHttpObservabilityContext(req) {
+    const requestId = readHeader(req.headers, 'x-request-id') ?? (req.id ? String(req.id) : (0, crypto_1.randomUUID)());
+    const correlationId = readHeader(req.headers, 'x-correlation-id') ?? requestId;
+    return {
+        requestId,
+        correlationId,
+        tenantId: readHeader(req.headers, 'x-tenant-id'),
+        userId: readHeader(req.headers, 'x-user-id'),
+        accountId: readHeader(req.headers, 'x-account-id'),
+        userEmail: readHeader(req.headers, 'x-user-email') ?? readHeader(req.headers, 'x-email'),
+        userRoles: readRoles(readHeader(req.headers, 'x-roles')),
+        origin: 'http',
+    };
+}
+//# sourceMappingURL=observability-context.js.map

package/dist/context/observability-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-context.js","sourceRoot":"","sources":["../../src/context/observability-context.ts"],"names":[],"mappings":";;;AA0EA,wEAiBC;AA3FD,6CAAgD;AAChD,mCAAoC;AAgBpC,MAAM,OAAO,GAAG,IAAI,+BAAiB,EAA4B,CAAC;AAElE,SAAS,UAAU,CACjB,OAA4C,EAC5C,GAAW;IAEX,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,GAAuB;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAEY,QAAA,oBAAoB,GAAG;IAClC,GAAG,CAAI,IAA8B,EAAE,EAAW;QAChD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,GAAG;QACD,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,GAAG,CAAC,KAAwC;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,SAAS;QACP,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO;YACL,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,aAAa,EAAE,OAAO,EAAE,aAAa;YACrC,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,SAAS,EAAE,OAAO,EAAE,SAAS;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAgB,8BAA8B,CAAC,GAG9C;IACC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAA,mBAAU,GAAE,CAAC,CAAC;IACtG,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;IAE/E,OAAO;QACL,SAAS;QACT,aAAa;QACb,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC;QAChD,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC;QAC5C,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC;QAClD,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC;QACxF,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC"}

package/dist/context/observability.interceptor.d.ts

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

package/dist/context/observability.interceptor.js

@@ -0,0 +1,72 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityGrpcInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+const crypto_1 = require("crypto");
+const observability_context_1 = require("./observability-context");
+function metadataValue(metadata, key) {
+    const values = metadata.get(key);
+    if (!values?.length) {
+        return undefined;
+    }
+    const value = values[0];
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (value instanceof Uint8Array) {
+        return Buffer.from(value).toString('utf8');
+    }
+    return undefined;
+}
+let ObservabilityGrpcInterceptor = class ObservabilityGrpcInterceptor {
+    intercept(context, next) {
+        if (context.getType() !== 'rpc') {
+            return next.handle();
+        }
+        const rpcContext = context
+            .switchToRpc()
+            .getContext();
+        const metadata = rpcContext && typeof rpcContext.get === 'function'
+            ? rpcContext
+            : rpcContext?.metadata;
+        if (!metadata) {
+            return next.handle();
+        }
+        const requestId = metadataValue(metadata, 'x-request-id') ?? (0, crypto_1.randomUUID)();
+        const correlationId = metadataValue(metadata, 'x-correlation-id') ?? requestId;
+        const contextData = {
+            requestId,
+            correlationId,
+            tenantId: metadataValue(metadata, 'x-tenant-id'),
+            userId: metadataValue(metadata, 'x-user-id'),
+            accountId: metadataValue(metadata, 'x-account-id'),
+            userEmail: metadataValue(metadata, 'x-user-email'),
+            userRoles: (metadataValue(metadata, 'x-roles') ?? '')
+                .split(',')
+                .map((role) => role.trim())
+                .filter(Boolean),
+            origin: 'grpc',
+        };
+        return new rxjs_1.Observable((subscriber) => {
+            observability_context_1.ObservabilityContext.run(contextData, () => {
+                next.handle().subscribe({
+                    next: (value) => subscriber.next(value),
+                    error: (error) => subscriber.error(error),
+                    complete: () => subscriber.complete(),
+                });
+            });
+        });
+    }
+};
+exports.ObservabilityGrpcInterceptor = ObservabilityGrpcInterceptor;
+exports.ObservabilityGrpcInterceptor = ObservabilityGrpcInterceptor = __decorate([
+    (0, common_1.Injectable)()
+], ObservabilityGrpcInterceptor);
+//# sourceMappingURL=observability.interceptor.js.map

package/dist/context/observability.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.interceptor.js","sourceRoot":"","sources":["../../src/context/observability.interceptor.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAKwB;AACxB,+BAAkC;AAClC,mCAAoC;AACpC,mEAA8F;AAM9F,SAAS,aAAa,CAAC,QAA0B,EAAE,GAAW;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAGM,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACvC,SAAS,CAAC,OAAyB,EAAE,IAAiB;QACpD,IAAI,OAAO,CAAC,OAAO,EAAE,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,UAAU,GAAG,OAAO;aACvB,WAAW,EAAE;aACb,UAAU,EAAsD,CAAC;QACpE,MAAM,QAAQ,GACZ,UAAU,IAAI,OAAQ,UAA+B,CAAC,GAAG,KAAK,UAAU;YACtE,CAAC,CAAE,UAA+B;YAClC,CAAC,CAAE,UAA8C,EAAE,QAAQ,CAAC;QAEhE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,IAAA,mBAAU,GAAE,CAAC;QAC1E,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;QAC/E,MAAM,WAAW,GAA6B;YAC5C,SAAS;YACT,aAAa;YACb,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC;YAChD,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC;YAC5C,SAAS,EAAE,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC;YAClD,SAAS,EAAE,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC;YAClD,SAAS,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;iBAClD,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;iBAC1B,MAAM,CAAC,OAAO,CAAC;YAClB,MAAM,EAAE,MAAM;SACf,CAAC;QAEF,OAAO,IAAI,iBAAU,CAAC,CAAC,UAAU,EAAE,EAAE;YACnC,4CAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE;gBACzC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC;oBACtB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;oBACvC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;oBACzC,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;iBACtC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA5CY,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,mBAAU,GAAE;GACA,4BAA4B,CA4CxC"}

package/dist/context/observability.middleware.d.ts

@@ -0,0 +1,5 @@
+import { NestMiddleware } from '@nestjs/common';
+import { NextFunction, Request, Response } from 'express';
+export declare class ObservabilityMiddleware implements NestMiddleware {
+    use(req: Request, res: Response, next: NextFunction): void;
+}

package/dist/context/observability.middleware.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityMiddleware = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const observability_context_1 = require("./observability-context");
+let ObservabilityMiddleware = class ObservabilityMiddleware {
+    use(req, res, next) {
+        const context = (0, observability_context_1.createHttpObservabilityContext)({
+            headers: req.headers,
+            id: req.id ? String(req.id) : undefined,
+        });
+        if (!context.requestId) {
+            context.requestId = (0, crypto_1.randomUUID)();
+        }
+        if (!context.correlationId) {
+            context.correlationId = context.requestId;
+        }
+        req.headers['x-request-id'] = context.requestId;
+        req.headers['x-correlation-id'] = context.correlationId;
+        res.setHeader('x-request-id', context.requestId);
+        res.setHeader('x-correlation-id', context.correlationId);
+        observability_context_1.ObservabilityContext.run(context, next);
+    }
+};
+exports.ObservabilityMiddleware = ObservabilityMiddleware;
+exports.ObservabilityMiddleware = ObservabilityMiddleware = __decorate([
+    (0, common_1.Injectable)()
+], ObservabilityMiddleware);
+//# sourceMappingURL=observability.middleware.js.map

package/dist/context/observability.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.middleware.js","sourceRoot":"","sources":["../../src/context/observability.middleware.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4D;AAC5D,mCAAoC;AAEpC,mEAGiC;AAG1B,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,GAAG,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;QACjD,MAAM,OAAO,GAAG,IAAA,sDAA8B,EAAC;YAC7C,OAAO,EAAE,GAAG,CAAC,OAAkC;YAC/C,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,SAAS,GAAG,IAAA,mBAAU,GAAE,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;QAC5C,CAAC;QAED,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;QAExD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACjD,GAAG,CAAC,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAEzD,4CAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF,CAAA;AAvBY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;GACA,uBAAuB,CAuBnC"}

package/dist/errors/app-error.d.ts

@@ -0,0 +1,22 @@
+import { AppErrorDefinition, AppErrorOptions, AppErrorPayload, AppErrorStatus, AppFieldError } from './app-error.types';
+import { ErrorCategory } from './error-category';
+import { ErrorSeverity } from './error-category';
+export declare class AppError extends Error {
+    readonly code: string;
+    readonly messageKey?: string;
+    readonly category: ErrorCategory;
+    readonly severity?: ErrorSeverity;
+    readonly retryable: boolean;
+    readonly status: AppErrorStatus;
+    readonly requestId?: string;
+    readonly correlationId?: string;
+    readonly details?: Record<string, unknown>;
+    readonly fields?: AppFieldError[];
+    readonly timestamp: string;
+    readonly service?: string;
+    constructor(definition: AppErrorDefinition, options?: AppErrorOptions);
+    toPayload(): AppErrorPayload;
+    static fromDefinition(definition: AppErrorDefinition, options?: AppErrorOptions): AppError;
+    static fromKey(code: string, options?: AppErrorOptions): AppError;
+    static internal(options?: AppErrorOptions): AppError;
+}

package/dist/errors/app-error.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppError = void 0;
+const error_category_1 = require("./error-category");
+const error_registry_1 = require("./error-registry");
+const DEFAULT_INTERNAL_STATUS = {
+    http: 500,
+    grpc: 13,
+};
+function normalizeCause(cause) {
+    if (!cause) {
+        return undefined;
+    }
+    if (cause instanceof Error) {
+        return cause;
+    }
+    return new Error(typeof cause === 'string' ? cause : 'Unknown cause');
+}
+class AppError extends Error {
+    code;
+    messageKey;
+    category;
+    severity;
+    retryable;
+    status;
+    requestId;
+    correlationId;
+    details;
+    fields;
+    timestamp;
+    service;
+    constructor(definition, options = {}) {
+        super(definition.message, { cause: normalizeCause(options.cause) });
+        this.name = 'AppError';
+        this.code = definition.code;
+        this.messageKey = definition.messageKey;
+        this.category = definition.category;
+        this.severity = definition.severity;
+        this.retryable = Boolean(definition.retryable);
+        this.status = definition.status;
+        this.requestId = options.requestId;
+        this.correlationId = options.correlationId;
+        this.details = options.details;
+        this.fields = options.fields;
+        this.timestamp = options.timestamp ?? new Date().toISOString();
+        this.service = options.service;
+    }
+    toPayload() {
+        return {
+            code: this.code,
+            message: this.message,
+            messageKey: this.messageKey,
+            category: this.category,
+            severity: this.severity,
+            retryable: this.retryable,
+            status: this.status,
+            requestId: this.requestId,
+            correlationId: this.correlationId,
+            details: this.details,
+            fields: this.fields,
+            timestamp: this.timestamp,
+            service: this.service,
+        };
+    }
+    static fromDefinition(definition, options = {}) {
+        return new AppError(definition, options);
+    }
+    static fromKey(code, options = {}) {
+        const definition = (0, error_registry_1.resolveAppErrorDefinition)(code);
+        if (!definition) {
+            return AppError.internal({
+                ...options,
+                details: {
+                    ...(options.details ?? {}),
+                    missingErrorCode: code,
+                },
+            });
+        }
+        return new AppError(definition, options);
+    }
+    static internal(options = {}) {
+        return new AppError({
+            code: 'COMMON.INTERNAL',
+            category: error_category_1.ERROR_CATEGORIES.INTERNAL,
+            message: 'Internal server error',
+            messageKey: 'errors.common.internal',
+            severity: 'error',
+            retryable: false,
+            status: DEFAULT_INTERNAL_STATUS,
+        }, options);
+    }
+}
+exports.AppError = AppError;
+//# sourceMappingURL=app-error.js.map

package/dist/errors/app-error.js.map

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

package/dist/errors/app-error.types.d.ts

@@ -0,0 +1,44 @@
+import { ErrorCategory } from './error-category';
+import { ErrorSeverity } from './error-category';
+export interface AppFieldError {
+    field: string;
+    code?: string;
+    message?: string;
+}
+export interface AppErrorStatus {
+    http: number;
+    grpc?: number;
+}
+export interface AppErrorDefinition {
+    code: string;
+    category: ErrorCategory;
+    message: string;
+    messageKey?: string;
+    severity?: ErrorSeverity;
+    retryable?: boolean;
+    status: AppErrorStatus;
+}
+export interface AppErrorPayload {
+    code: string;
+    message: string;
+    messageKey?: string;
+    category: ErrorCategory;
+    severity?: ErrorSeverity;
+    retryable: boolean;
+    status: AppErrorStatus;
+    requestId?: string;
+    correlationId?: string;
+    details?: Record<string, unknown>;
+    fields?: AppFieldError[];
+    timestamp: string;
+    service?: string;
+}
+export interface AppErrorOptions {
+    service?: string;
+    requestId?: string;
+    correlationId?: string;
+    details?: Record<string, unknown>;
+    fields?: AppFieldError[];
+    cause?: unknown;
+    timestamp?: string;
+}

package/dist/errors/app-error.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=app-error.types.js.map

package/dist/errors/app-error.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.types.js","sourceRoot":"","sources":["../../src/errors/app-error.types.ts"],"names":[],"mappings":""}

package/dist/errors/error-category.d.ts

@@ -0,0 +1,22 @@
+export declare const ERROR_CATEGORIES: {
+    readonly VALIDATION: "VALIDATION";
+    readonly AUTH: "AUTH";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly CONFLICT: "CONFLICT";
+    readonly RATE_LIMIT: "RATE_LIMIT";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly UNAVAILABLE: "UNAVAILABLE";
+    readonly DEPENDENCY: "DEPENDENCY";
+    readonly ROLE: "ROLE";
+    readonly SPACE: "SPACE";
+    readonly ACCOUNT: "ACCOUNT";
+    readonly DEVICE: "DEVICE";
+    readonly NOTIFICATION: "NOTIFICATION";
+    readonly INTEGRATION: "INTEGRATION";
+    readonly INFRASTRUCTURE: "INFRASTRUCTURE";
+    readonly INTERNAL: "INTERNAL";
+};
+export type ErrorCategory = (typeof ERROR_CATEGORIES)[keyof typeof ERROR_CATEGORIES];
+export type ErrorSeverity = 'info' | 'warn' | 'error' | 'fatal';
+export declare const categorySeverityMap: Record<ErrorCategory, ErrorSeverity>;

package/dist/errors/error-category.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categorySeverityMap = exports.ERROR_CATEGORIES = void 0;
+exports.ERROR_CATEGORIES = {
+    VALIDATION: 'VALIDATION',
+    AUTH: 'AUTH',
+    FORBIDDEN: 'FORBIDDEN',
+    NOT_FOUND: 'NOT_FOUND',
+    CONFLICT: 'CONFLICT',
+    RATE_LIMIT: 'RATE_LIMIT',
+    TIMEOUT: 'TIMEOUT',
+    UNAVAILABLE: 'UNAVAILABLE',
+    DEPENDENCY: 'DEPENDENCY',
+    ROLE: 'ROLE',
+    SPACE: 'SPACE',
+    ACCOUNT: 'ACCOUNT',
+    DEVICE: 'DEVICE',
+    NOTIFICATION: 'NOTIFICATION',
+    INTEGRATION: 'INTEGRATION',
+    INFRASTRUCTURE: 'INFRASTRUCTURE',
+    INTERNAL: 'INTERNAL',
+};
+exports.categorySeverityMap = {
+    VALIDATION: 'info',
+    AUTH: 'warn',
+    FORBIDDEN: 'warn',
+    NOT_FOUND: 'info',
+    CONFLICT: 'warn',
+    RATE_LIMIT: 'warn',
+    TIMEOUT: 'warn',
+    UNAVAILABLE: 'error',
+    DEPENDENCY: 'error',
+    ROLE: 'warn',
+    SPACE: 'warn',
+    ACCOUNT: 'error',
+    DEVICE: 'error',
+    NOTIFICATION: 'error',
+    INTEGRATION: 'error',
+    INFRASTRUCTURE: 'error',
+    INTERNAL: 'error',
+};
+//# sourceMappingURL=error-category.js.map

package/dist/errors/error-category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-category.js","sourceRoot":"","sources":["../../src/errors/error-category.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG;IAC9B,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKE,QAAA,mBAAmB,GAAyC;IACvE,UAAU,EAAE,MAAM;IAClB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,OAAO;IACpB,UAAU,EAAE,OAAO;IACnB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;IACf,YAAY,EAAE,OAAO;IACrB,WAAW,EAAE,OAAO;IACpB,cAAc,EAAE,OAAO;IACvB,QAAQ,EAAE,OAAO;CAClB,CAAC"}

package/dist/errors/error-registry.d.ts

@@ -0,0 +1,5 @@
+import { AppErrorDefinition } from './app-error.types';
+export declare function registerErrorDefinitions(definitions: Record<string, AppErrorDefinition> | AppErrorDefinition[]): void;
+export declare function resolveAppErrorDefinition(code: string): AppErrorDefinition | undefined;
+export declare function getRegisteredErrorDefinitions(): AppErrorDefinition[];
+export declare function clearErrorDefinitions(): void;

package/dist/errors/error-registry.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerErrorDefinitions = registerErrorDefinitions;
+exports.resolveAppErrorDefinition = resolveAppErrorDefinition;
+exports.getRegisteredErrorDefinitions = getRegisteredErrorDefinitions;
+exports.clearErrorDefinitions = clearErrorDefinitions;
+const registry = new Map();
+function registerErrorDefinitions(definitions) {
+    const entries = Array.isArray(definitions)
+        ? definitions.map((item) => [item.code, item])
+        : Object.entries(definitions).map(([key, value]) => [key, value]);
+    for (const [key, value] of entries) {
+        const normalized = value.code ? value : { ...value, code: key };
+        registry.set(normalized.code, normalized);
+    }
+}
+function resolveAppErrorDefinition(code) {
+    return registry.get(code);
+}
+function getRegisteredErrorDefinitions() {
+    return Array.from(registry.values());
+}
+function clearErrorDefinitions() {
+    registry.clear();
+}
+//# sourceMappingURL=error-registry.js.map

package/dist/errors/error-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-registry.js","sourceRoot":"","sources":["../../src/errors/error-registry.ts"],"names":[],"mappings":";;AAMA,4DAWC;AAED,8DAEC;AAED,sEAEC;AAED,sDAEC;AAzBD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;AAEvD,SAAgB,wBAAwB,CACtC,WAAsE;IAEtE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;QACvD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC,CAAC;IAE7E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAChE,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAgB,yBAAyB,CAAC,IAAY;IACpD,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,SAAgB,6BAA6B;IAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,qBAAqB;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,4 @@
+export { ERROR_CATEGORIES, categorySeverityMap, type ErrorCategory, type ErrorSeverity, } from './error-category';
+export { type AppFieldError, type AppErrorStatus, type AppErrorDefinition, type AppErrorPayload, type AppErrorOptions, } from './app-error.types';
+export { AppError } from './app-error';
+export { registerErrorDefinitions, resolveAppErrorDefinition, getRegisteredErrorDefinitions, clearErrorDefinitions, } from './error-registry';

package/dist/errors/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearErrorDefinitions = exports.getRegisteredErrorDefinitions = exports.resolveAppErrorDefinition = exports.registerErrorDefinitions = exports.AppError = exports.categorySeverityMap = exports.ERROR_CATEGORIES = void 0;
+var error_category_1 = require("./error-category");
+Object.defineProperty(exports, "ERROR_CATEGORIES", { enumerable: true, get: function () { return error_category_1.ERROR_CATEGORIES; } });
+Object.defineProperty(exports, "categorySeverityMap", { enumerable: true, get: function () { return error_category_1.categorySeverityMap; } });
+var app_error_1 = require("./app-error");
+Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return app_error_1.AppError; } });
+var error_registry_1 = require("./error-registry");
+Object.defineProperty(exports, "registerErrorDefinitions", { enumerable: true, get: function () { return error_registry_1.registerErrorDefinitions; } });
+Object.defineProperty(exports, "resolveAppErrorDefinition", { enumerable: true, get: function () { return error_registry_1.resolveAppErrorDefinition; } });
+Object.defineProperty(exports, "getRegisteredErrorDefinitions", { enumerable: true, get: function () { return error_registry_1.getRegisteredErrorDefinitions; } });
+Object.defineProperty(exports, "clearErrorDefinitions", { enumerable: true, get: function () { return error_registry_1.clearErrorDefinitions; } });
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,mDAK0B;AAJxB,kHAAA,gBAAgB,OAAA;AAChB,qHAAA,mBAAmB,OAAA;AAWrB,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,mDAK0B;AAJxB,0HAAA,wBAAwB,OAAA;AACxB,2HAAA,yBAAyB,OAAA;AACzB,+HAAA,6BAA6B,OAAA;AAC7B,uHAAA,qBAAqB,OAAA"}