@rsdk/core 0.14.0

package/dist/exceptions/metadata/decorators/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./exception.decorator"), exports);
+__exportStar(require("./throws.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/exceptions/metadata/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exceptions/metadata/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,qDAAmC"}

package/dist/exceptions/metadata/decorators/throws.decorator.d.ts

@@ -0,0 +1,3 @@
+import type { Constructor } from '@rsdk/common';
+import type { PipelineException } from '../../base';
+export declare const Throws: (...ex: Constructor<PipelineException>[]) => MethodDecorator;

package/dist/exceptions/metadata/decorators/throws.decorator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Throws = void 0;
+const logging_1 = require("@rsdk/logging");
+const exceptions_registry_1 = require("../exceptions.registry");
+const logger = logging_1.LoggerFactory.create('ExceptionsRegistry');
+const Throws = (...ex) => {
+    return function (ctor, methodName) {
+        logger.debug(`Method ${ctor.constructor.name}.${methodName.toString()} throws: ${ex
+            .map((x) => x.name)
+            .join(', ')}`);
+        exceptions_registry_1.ExceptionsRegistry.getInstance().register({
+            class: ctor.constructor,
+            exceptions: ex,
+            method: methodName.toString(),
+        });
+    };
+};
+exports.Throws = Throws;
+//# sourceMappingURL=throws.decorator.js.map

package/dist/exceptions/metadata/decorators/throws.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throws.decorator.js","sourceRoot":"","sources":["../../../../src/exceptions/metadata/decorators/throws.decorator.ts"],"names":[],"mappings":";;;AACA,2CAA8C;AAG9C,gEAA4D;AAE5D,MAAM,MAAM,GAAG,uBAAa,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAEnD,MAAM,MAAM,GAAG,CACpB,GAAG,EAAoC,EACtB,EAAE;IACnB,OAAO,UAAU,IAAY,EAAE,UAA2B;QACxD,MAAM,CAAC,KAAK,CACV,UAAU,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE;aACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;QAEF,wCAAkB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC;YACxC,KAAK,EAAE,IAAI,CAAC,WAAW;YACvB,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC;AAhBW,QAAA,MAAM,UAgBjB"}

package/dist/exceptions/metadata/exceptions.registry.d.ts

@@ -0,0 +1,23 @@
+import type { Constructor } from '@rsdk/common';
+import type { PipelineException } from '../base';
+export interface ExceptionMetadata {
+    description: string;
+}
+export interface ThrowsMetadata {
+    class: Function;
+    method: string;
+    exceptions: Constructor<PipelineException>[];
+}
+export declare class ExceptionsRegistry {
+    private static _instance;
+    private exceptions;
+    private throws;
+    private constructor();
+    static getInstance(): ExceptionsRegistry;
+    register(meta: ThrowsMetadata): void;
+    register(meta: ExceptionMetadata): void;
+    getAll(): {
+        exceptions: ExceptionMetadata[];
+        throws: ThrowsMetadata[];
+    };
+}

package/dist/exceptions/metadata/exceptions.registry.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExceptionsRegistry = void 0;
+const isExceptionMeta = (arg) => !!arg.description;
+class ExceptionsRegistry {
+    static _instance;
+    exceptions = [];
+    throws = [];
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    constructor() { }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new ExceptionsRegistry();
+        }
+        return this._instance;
+    }
+    register(meta) {
+        if (isExceptionMeta(meta)) {
+            this.exceptions.push(meta);
+        }
+        else {
+            this.throws.push(meta);
+        }
+    }
+    getAll() {
+        return { exceptions: this.exceptions, throws: this.throws };
+    }
+}
+exports.ExceptionsRegistry = ExceptionsRegistry;
+//# sourceMappingURL=exceptions.registry.js.map

package/dist/exceptions/metadata/exceptions.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.registry.js","sourceRoot":"","sources":["../../../src/exceptions/metadata/exceptions.registry.ts"],"names":[],"mappings":";;;AAeA,MAAM,eAAe,GAAG,CACtB,GAAuC,EACb,EAAE,CAAC,CAAC,CAAE,GAAW,CAAC,WAAW,CAAC;AAE1D,MAAa,kBAAkB;IACrB,MAAM,CAAC,SAAS,CAAqB;IAErC,UAAU,GAAwB,EAAE,CAAC;IACrC,MAAM,GAAqB,EAAE,CAAC;IAEtC,gEAAgE;IAChE,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACnB,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;SAC3C;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAID,QAAQ,CAAC,IAAwC;QAC/C,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE;YACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC5B;aAAM;YACL,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACxB;IACH,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;CACF;AA9BD,gDA8BC"}

package/dist/exceptions/metadata/index.d.ts

@@ -0,0 +1,2 @@
+export * from './decorators';
+export * from './exceptions.registry';

package/dist/exceptions/metadata/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./exceptions.registry"), exports);
+//# sourceMappingURL=index.js.map

package/dist/exceptions/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/exceptions/metadata/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,wDAAsC"}

package/dist/exceptions/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Kind helps exception handlers to map exception
+ * to transport-specific one. For example InputException
+ * probably will result 400 HTTP status, while InternalException
+ * - 500
+ */
+export declare enum ExceptionKind {
+    INPUT = 0,
+    CONFLICT = 1,
+    DUPLICATION = 2,
+    AUTHENTICATION = 3,
+    NOT_ALLOWED = 4,
+    NOT_FOUND = 5,
+    INTERNAL = 6,
+    TIMEOUT = 7,
+    UNAVAILABLE = 8,
+    UNKNOWN = 9
+}

package/dist/exceptions/types.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExceptionKind = void 0;
+/**
+ * Kind helps exception handlers to map exception
+ * to transport-specific one. For example InputException
+ * probably will result 400 HTTP status, while InternalException
+ * - 500
+ */
+var ExceptionKind;
+(function (ExceptionKind) {
+    ExceptionKind[ExceptionKind["INPUT"] = 0] = "INPUT";
+    ExceptionKind[ExceptionKind["CONFLICT"] = 1] = "CONFLICT";
+    ExceptionKind[ExceptionKind["DUPLICATION"] = 2] = "DUPLICATION";
+    ExceptionKind[ExceptionKind["AUTHENTICATION"] = 3] = "AUTHENTICATION";
+    ExceptionKind[ExceptionKind["NOT_ALLOWED"] = 4] = "NOT_ALLOWED";
+    ExceptionKind[ExceptionKind["NOT_FOUND"] = 5] = "NOT_FOUND";
+    ExceptionKind[ExceptionKind["INTERNAL"] = 6] = "INTERNAL";
+    ExceptionKind[ExceptionKind["TIMEOUT"] = 7] = "TIMEOUT";
+    ExceptionKind[ExceptionKind["UNAVAILABLE"] = 8] = "UNAVAILABLE";
+    ExceptionKind[ExceptionKind["UNKNOWN"] = 9] = "UNKNOWN";
+})(ExceptionKind = exports.ExceptionKind || (exports.ExceptionKind = {}));
+//# sourceMappingURL=types.js.map

package/dist/exceptions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/exceptions/types.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,mDAAS,CAAA;IACT,yDAAY,CAAA;IACZ,+DAAe,CAAA;IACf,qEAAkB,CAAA;IAClB,+DAAe,CAAA;IACf,2DAAa,CAAA;IACb,yDAAY,CAAA;IACZ,uDAAW,CAAA;IACX,+DAAe,CAAA;IACf,uDAAW,CAAA;AACb,CAAC,EAXW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAWxB"}

package/dist/exceptions/validation/exception.d.ts

@@ -0,0 +1,4 @@
+import { InputException } from '../implementations';
+export declare class ValidateException extends InputException {
+    constructor(details: unknown);
+}

package/dist/exceptions/validation/exception.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidateException = void 0;
+const implementations_1 = require("../implementations");
+class ValidateException extends implementations_1.InputException {
+    constructor(details) {
+        super('Validation failed', {
+            details,
+        });
+    }
+}
+exports.ValidateException = ValidateException;
+//# sourceMappingURL=exception.js.map

package/dist/exceptions/validation/exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.js","sourceRoot":"","sources":["../../../src/exceptions/validation/exception.ts"],"names":[],"mappings":";;;AAAA,wDAAoD;AAEpD,MAAa,iBAAkB,SAAQ,gCAAc;IACnD,YAAY,OAAgB;QAC1B,KAAK,CAAC,mBAAmB,EAAE;YACzB,OAAO;SACR,CAAC,CAAC;IACL,CAAC;CACF;AAND,8CAMC"}

package/dist/exceptions.handling/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const FORMATTERS: unique symbol;
+export declare const TRANSFORMERS: unique symbol;
+export declare const SENDERS: unique symbol;

package/dist/exceptions.handling/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SENDERS = exports.TRANSFORMERS = exports.FORMATTERS = void 0;
+exports.FORMATTERS = Symbol('FORMATTERS_TOKEN');
+exports.TRANSFORMERS = Symbol('TRANSFORMERS_TOKEN');
+exports.SENDERS = Symbol('SENDERS_TOKEN');
+//# sourceMappingURL=constants.js.map

package/dist/exceptions.handling/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/exceptions.handling/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AACxC,QAAA,YAAY,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC5C,QAAA,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC"}

package/dist/exceptions.handling/global-exceptions.config.d.ts

@@ -0,0 +1,4 @@
+import { Config } from '../config';
+export declare class GlobalExceptionsConfig extends Config {
+    readonly verbose: boolean;
+}

package/dist/exceptions.handling/global-exceptions.config.js

@@ -0,0 +1,32 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalExceptionsConfig = void 0;
+const common_1 = require("@rsdk/common");
+const config_1 = require("../config");
+let GlobalExceptionsConfig = class GlobalExceptionsConfig extends config_1.Config {
+    verbose;
+};
+__decorate([
+    (0, config_1.Property)('VERBOSE_ERRORS', new config_1.BoolParser(), {
+        defaultValue: true,
+        description: (0, common_1.text) `
+      If set "true" all exception messages will be returned to client.
+      If false, only 4XX will contain messages, others - just status codes.
+    `,
+    }),
+    __metadata("design:type", Boolean)
+], GlobalExceptionsConfig.prototype, "verbose", void 0);
+GlobalExceptionsConfig = __decorate([
+    (0, config_1.ConfigSection)()
+], GlobalExceptionsConfig);
+exports.GlobalExceptionsConfig = GlobalExceptionsConfig;
+//# sourceMappingURL=global-exceptions.config.js.map

package/dist/exceptions.handling/global-exceptions.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-exceptions.config.js","sourceRoot":"","sources":["../../src/exceptions.handling/global-exceptions.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAoC;AAEpC,sCAAwE;AAGjE,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,eAAM;IAQvC,OAAO,CAAW;CAC5B,CAAA;AARC;IAAC,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,IAAI,mBAAU,EAAE,EAAE;QAC5C,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,IAAA,aAAI,EAAA;;;KAGhB;KACF,CAAC;;uDACyB;AARhB,sBAAsB;IADlC,IAAA,sBAAa,GAAE;GACH,sBAAsB,CASlC;AATY,wDAAsB"}

package/dist/exceptions.handling/global-exceptions.filter.d.ts

@@ -0,0 +1,17 @@
+import type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+import { ILogger } from '@rsdk/logging';
+import type { Observable } from 'rxjs';
+import { GlobalExceptionsConfig } from './global-exceptions.config';
+import type { IErrorsFormatter, IErrorsSender, IErrorsTransformer } from './types';
+export declare class GlobalExceptionsFilter implements ExceptionFilter {
+    private readonly formatters;
+    private readonly transformers;
+    private readonly senders;
+    private readonly logger;
+    private readonly config;
+    constructor(formatters: IErrorsFormatter[], transformers: IErrorsTransformer[], senders: IErrorsSender[], logger: ILogger, config: GlobalExceptionsConfig);
+    catch(ex: any, host: ArgumentsHost): Observable<any>;
+    private transform;
+    private format;
+    private send;
+}

package/dist/exceptions.handling/global-exceptions.filter.js

@@ -0,0 +1,83 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var GlobalExceptionsFilter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalExceptionsFilter = void 0;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@rsdk/common");
+const rxjs_1 = require("rxjs");
+const exceptions_1 = require("../exceptions");
+const logging_1 = require("../logging");
+const constants_1 = require("./constants");
+const global_exceptions_config_1 = require("./global-exceptions.config");
+let GlobalExceptionsFilter = GlobalExceptionsFilter_1 = class GlobalExceptionsFilter {
+    formatters;
+    transformers;
+    senders;
+    logger;
+    config;
+    constructor(formatters, transformers, senders, logger, config) {
+        this.formatters = formatters;
+        this.transformers = transformers;
+        this.senders = senders;
+        this.logger = logger;
+        this.config = config;
+    }
+    catch(ex, host) {
+        const transformed = ex instanceof exceptions_1.PipelineException ? ex : this.transform(ex);
+        // Error is transformed to standard PipelineException
+        this.logger.error(transformed);
+        const formatted = this.format(host, transformed);
+        return this.send(host, formatted);
+    }
+    transform(ex) {
+        const transformer = this.transformers.find((x) => x.match(ex));
+        if (transformer) {
+            return transformer.transform(ex);
+        }
+        const err = new exceptions_1.InternalException(ex.message ?? 'UNKNOWN ERROR', ex);
+        err.stack = ex.stack;
+        return err;
+    }
+    format(host, ex) {
+        const formatter = this.formatters.find((x) => x.match(host, ex));
+        if (formatter) {
+            this.logger.trace(`Found formatter: ${formatter.constructor.name}`);
+            return formatter.format(ex, this.config.verbose);
+        }
+        this.logger.trace('No formatter for error!');
+        if (this.config.verbose) {
+            return (0, common_2.normalizer)()(ex, {
+                // This means stacktrace will never be sent to user
+                filterKeys: ['stack'],
+                sortKeys: common_2.sortErrorKeys,
+            });
+        }
+        return { message: 'NO FORMATTER' };
+    }
+    send(host, ex) {
+        const sender = this.senders.find((x) => x.match(host));
+        return sender?.send(host, ex) ?? (0, rxjs_1.throwError)(() => ex);
+    }
+};
+GlobalExceptionsFilter = GlobalExceptionsFilter_1 = __decorate([
+    (0, common_1.Catch)(),
+    __param(0, (0, common_1.Inject)(constants_1.FORMATTERS)),
+    __param(1, (0, common_1.Inject)(constants_1.TRANSFORMERS)),
+    __param(2, (0, common_1.Inject)(constants_1.SENDERS)),
+    __param(3, (0, logging_1.InjectLogger)(GlobalExceptionsFilter_1)),
+    __metadata("design:paramtypes", [Array, Array, Array, Object, global_exceptions_config_1.GlobalExceptionsConfig])
+], GlobalExceptionsFilter);
+exports.GlobalExceptionsFilter = GlobalExceptionsFilter;
+//# sourceMappingURL=global-exceptions.filter.js.map

package/dist/exceptions.handling/global-exceptions.filter.js.map

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

package/dist/exceptions.handling/global-exceptions.module.d.ts

@@ -0,0 +1,26 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { IErrorsFormatter, IErrorsSender, IErrorsTransformer } from './types';
+export interface GlobalExceptionModuleOptions {
+    /**
+     * Formatters are used to transform exceptions to transport specific
+     * final implementations. Usually formatter expects transport agnostic
+     * subclasses of BaseException.
+     */
+    formatters: IErrorsFormatter[];
+    /**
+     * Senders are used to actually respond to client (algorithm
+     * is transport specific)
+     */
+    senders: IErrorsSender[];
+    /**
+     * Sometimes application throws a lot of unconventional
+     * (not inheriting BaseExceptions). Usually they are throw by
+     * libraries: typeorm, axios, etc. Transformers are used to
+     * catch them and convert to any subtype of BaseException which
+     * will be processed further by transport specific formatters.
+     */
+    transformers?: IErrorsTransformer[];
+}
+export declare class GlobalExceptionsModule {
+    static forRoot(options: GlobalExceptionModuleOptions): DynamicModule;
+}

package/dist/exceptions.handling/global-exceptions.module.js

@@ -0,0 +1,47 @@
+"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;
+};
+var GlobalExceptionsModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalExceptionsModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const config_1 = require("../config");
+const constants_1 = require("./constants");
+const global_exceptions_config_1 = require("./global-exceptions.config");
+const global_exceptions_filter_1 = require("./global-exceptions.filter");
+let GlobalExceptionsModule = GlobalExceptionsModule_1 = class GlobalExceptionsModule {
+    static forRoot(options) {
+        return {
+            module: GlobalExceptionsModule_1,
+            imports: [config_1.PlatformConfigModule.forFeature(global_exceptions_config_1.GlobalExceptionsConfig)],
+            providers: [
+                {
+                    provide: core_1.APP_FILTER,
+                    useClass: global_exceptions_filter_1.GlobalExceptionsFilter,
+                },
+                {
+                    provide: constants_1.FORMATTERS,
+                    useValue: options.formatters,
+                },
+                {
+                    provide: constants_1.SENDERS,
+                    useValue: options.senders,
+                },
+                {
+                    provide: constants_1.TRANSFORMERS,
+                    useValue: options.transformers || [],
+                },
+            ],
+        };
+    }
+};
+GlobalExceptionsModule = GlobalExceptionsModule_1 = __decorate([
+    (0, common_1.Module)({})
+], GlobalExceptionsModule);
+exports.GlobalExceptionsModule = GlobalExceptionsModule;
+//# sourceMappingURL=global-exceptions.module.js.map

package/dist/exceptions.handling/global-exceptions.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-exceptions.module.js","sourceRoot":"","sources":["../../src/exceptions.handling/global-exceptions.module.ts"],"names":[],"mappings":";;;;;;;;;;AACA,2CAAwC;AACxC,uCAA0C;AAE1C,sCAAiD;AAEjD,2CAAgE;AAChE,yEAAoE;AACpE,yEAAoE;AAgC7D,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IACjC,MAAM,CAAC,OAAO,CAAC,OAAqC;QAClD,OAAO;YACL,MAAM,EAAE,wBAAsB;YAE9B,OAAO,EAAE,CAAC,6BAAoB,CAAC,UAAU,CAAC,iDAAsB,CAAC,CAAC;YAClE,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,iBAAU;oBACnB,QAAQ,EAAE,iDAAsB;iBACjC;gBACD;oBACE,OAAO,EAAE,sBAAU;oBACnB,QAAQ,EAAE,OAAO,CAAC,UAAU;iBAC7B;gBACD;oBACE,OAAO,EAAE,mBAAO;oBAChB,QAAQ,EAAE,OAAO,CAAC,OAAO;iBAC1B;gBACD;oBACE,OAAO,EAAE,wBAAY;oBACrB,QAAQ,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA1BY,sBAAsB;IADlC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,sBAAsB,CA0BlC;AA1BY,wDAAsB"}

package/dist/exceptions.handling/index.d.ts

@@ -0,0 +1,2 @@
+export * from './global-exceptions.module';
+export * from './types';

package/dist/exceptions.handling/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./global-exceptions.module"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/exceptions.handling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exceptions.handling/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,0CAAwB"}

package/dist/exceptions.handling/types.d.ts

@@ -0,0 +1,81 @@
+import type { ArgumentsHost } from '@nestjs/common';
+import type { EMPTY, Observable } from 'rxjs';
+import type { PipelineException } from '../exceptions/base';
+/**
+ * Errors formatter is used to map transport-agnostic
+ * buisiness exception to transport-specific on (with appropriate
+ * status code and other attributes)
+ *
+ * @implementme Implement this interface if you need to create a
+ * custom transport.
+ */
+export interface IErrorsFormatter {
+    /**
+     * Matcher returns true if exception should be processed with
+     * this formatter. Most common use is match by context type.
+     *
+     * @param host ArgumentsHost - nest.js wrapper over request context
+     * @param exception Exception itself
+     */
+    match(host: ArgumentsHost, exception?: unknown): boolean;
+    /**
+     * Formatting algorithm that should match received exception with
+     * transport-specific one and map one into another.
+     *
+     * @param exception Exception itself
+     * @param verbose True - means that all exception data can be exposed
+     * in response. False - indicates that service is probably working in
+     * production and all extra data shouldn't be sent back to client.
+     */
+    format(exception: unknown, verbose: boolean): unknown;
+}
+/**
+ * Different transports need to return errors in different ways.
+ *
+ * @implementme
+ */
+export interface IErrorsSender {
+    /**
+     * Matcher returns true if exception should be processed with
+     * this formatter. Most common use is match by context type.
+     *
+     * @param host ArgumentsHost - nest.js wrapper over request context
+     */
+    match(host: ArgumentsHost): boolean;
+    /**
+     * Implementation of sending error back to the client
+     *
+     * @param host ArgumentsHost - nest.js wrapper over request context
+     * @param exception Exception itself
+     */
+    send(host: ArgumentsHost, ex: unknown): Observable<any> | typeof EMPTY;
+}
+/**
+ * Not all exceptions that can be thrown when handling request
+ * are created in application code. And library authors have no
+ * idea about PipelineExceptions and our conventions. Hence they
+ * throw their own errors of any possible type.
+ *
+ * Aim of transformers is to catch those "unconventional" errors and
+ * map them into instances of PipelineException which then will be
+ * mapped correctly to responses.
+ *
+ * @implementme Implement this interface if you use some library that
+ * can throw (let's say axios) and don't want to wrap each call of this
+ * library into try/catch block
+ */
+export interface IErrorsTransformer {
+    /**
+     * Matcher returns true if exception should be processed with
+     * this transformer
+     *
+     * @param ex Exception to transform
+     */
+    match(ex: any): boolean;
+    /**
+     * Transformating algorithm
+     *
+     * @param ex Exception itself
+     */
+    transform(ex: any): PipelineException;
+}

package/dist/exceptions.handling/types.js

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

package/dist/exceptions.handling/types.js.map

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

package/dist/health/exceptions/health-check.exception.d.ts

@@ -0,0 +1,5 @@
+import { PipelineException } from '../../exceptions';
+import type { CheckResult } from '../helpers';
+export declare class HealthCheckException extends PipelineException {
+    constructor(details: Record<string, CheckResult>);
+}

package/dist/health/exceptions/health-check.exception.js

@@ -0,0 +1,24 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthCheckException = void 0;
+const exceptions_1 = require("../../exceptions");
+let HealthCheckException = class HealthCheckException extends exceptions_1.PipelineException {
+    constructor(details) {
+        super(exceptions_1.ExceptionKind.UNAVAILABLE, 'Health check failed!', { details });
+    }
+};
+HealthCheckException = __decorate([
+    (0, exceptions_1.Exception)({ description: 'Service is unavailable' }),
+    __metadata("design:paramtypes", [Object])
+], HealthCheckException);
+exports.HealthCheckException = HealthCheckException;
+//# sourceMappingURL=health-check.exception.js.map

package/dist/health/exceptions/health-check.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.exception.js","sourceRoot":"","sources":["../../../src/health/exceptions/health-check.exception.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iDAA+E;AAIxE,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,8BAAiB;IACzD,YAAY,OAAoC;QAC9C,KAAK,CAAC,0BAAa,CAAC,WAAW,EAAE,sBAAsB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;CACF,CAAA;AAJY,oBAAoB;IADhC,IAAA,sBAAS,EAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;;GACxC,oBAAoB,CAIhC;AAJY,oDAAoB"}

package/dist/health/exceptions/index.d.ts

@@ -0,0 +1 @@
+export * from './health-check.exception';