@furkanogutcu/nest-common 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Furkan Ogutcu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+# NestJS Common
+
+[![npm version](https://img.shields.io/npm/v/@furkanogutcu/nest-common.svg)](https://www.npmjs.com/package/@furkanogutcu/nest-common)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A module containing common structures and utilities for NestJS projects.
+
+## Contents
+
+This package is designed to standardize structures you repeatedly use in your NestJS projects and to accelerate the development process.
+
+- [Installation](#installation)
+- [Features](#features)
+  - [Exceptions](#1-exceptions)
+- [Development](#development)
+- [License](#license)
+
+## Installation
+
+```bash
+npm install @furkanogutcu/nest-common
+```
+
+or
+
+```bash
+yarn add @furkanogutcu/nest-common
+```
+
+## Features
+
+### 1. Exceptions
+
+#### Installation
+
+No additional installation steps are needed beyond installing the package.
+
+#### Features
+
+- **Custom Exception Classes**: Comprehensive set of HTTP-based exception classes for consistent error responses.
+
+  | Exception Class | HTTP Status | Description |
+  |-----------------|-------------|-------------|
+  | `AppException` | - | Base exception class for all custom exceptions |
+  | `AppBadRequestException` | 400 | For invalid input, malformed requests |
+  | `AppUnauthorizedException` | 401 | For authentication failures |
+  | `AppForbiddenException` | 403 | For authorization failures |
+  | `AppNotFoundException` | 404 | For resources that couldn't be found |
+  | `AppConflictException` | 409 | For conflicting requests (e.g., duplicate entries) |
+  | `AppUnprocessableEntityException` | 422 | For semantically incorrect requests |
+  | `AppInternalException` | 500 | For server-side errors |
+  | `AppTooManyRequestException` | 429 | For rate limiting scenarios |
+  | `AppValidationException` | 400 | Specifically for input validation errors |
+
+- **Global Exception Filter**: Automatically catches and transforms exceptions throughout your application.
+  - Centralized error handling logic
+  - Consistent error response format
+  - Easy to configure through NestJS's dependency injection
+
+- **Exception Transformers**: Converts various error types to standardized app exceptions.
+  - NestJS built-in exception transformer
+  - TypeORM exception transformer
+
+- **Structured Error Responses**: All exceptions follow a consistent JSON structure for frontend consumption.
+  - Consistent error format across your entire API
+  - Detailed validation error information
+  - Type-safe error codes for easy client-side handling
+
+#### Usage
+
+##### Setup
+
+To use the exception handling system globally in your NestJS application, you need to configure the `GlobalExceptionFilter` in your main module (e.g., `app.module.ts`):
+
+```typescript
+import { Module } from '@nestjs/common';
+import { APP_FILTER } from '@nestjs/core';
+import { GlobalExceptionFilter } from '@furkanogutcu/nest-common';
+
+@Module({
+  imports: [
+    // Your other modules
+  ],
+  controllers: [
+    // Your controllers
+  ],
+  providers: [
+    // Your other providers
+    {
+      provide: APP_FILTER,
+      useClass: GlobalExceptionFilter,
+    },
+  ],
+})
+export class AppModule {}
+```
+
+##### Exception Example
+
+```typescript
+import { AppBadRequestException } from '@furkanogutcu/nest-common';
+
+throw new AppBadRequestException({
+  message: 'Invalid request parameter',
+  code: 'BAD_REQUEST',
+});
+```
+
+##### JSON Error Response Example
+
+When an exception is thrown, the NestJS global exception filter can convert it to a JSON response using the `toJSON()` method. Here's an example of the JSON structure returned:
+
+```json
+{
+  "error": {
+    "code": "invalid_request",
+    "message": "Invalid request parameter"
+  }
+}
+```
+
+For validation errors, additional details are provided:
+
+```json
+{
+  "error": {
+    "code": "validation_failed",
+    "message": "Validation failed",
+    "details": [
+      {
+        "type": "invalid",
+        "path": "email",
+        "message": "Email must be a valid email address"
+      },
+      {
+        "type": "missing_field",
+        "path": "password",
+        "message": "Password is required"
+      }
+    ]
+  }
+}
+```
+
+The `type` field in validation error details can have the following values:
+
+| Type Value       | Description                                                   |
+| ---------------- | ------------------------------------------------------------- |
+| `already_exists` | When a field value already exists (e.g., duplicate email)     |
+| `invalid`        | When a field value is not valid according to validation rules |
+| `missing_field`  | When a required field is missing                              |
+| `unrecognized`   | When a field is not recognized or not allowed                 |
+
+##### Additional Components
+
+For more detailed information about the filters, transformers, and interfaces included in the exceptions package, please check the source code.
+
+## Development
+
+### Requirements
+
+- Node.js 18+
+- npm or yarn
+
+### Getting Started
+
+```bash
+# Clone the repository
+git clone https://github.com/furkanogutcu/nest-common.git
+
+# Install dependencies
+npm install
+
+# Start in development mode
+npm run start:dev
+```
+
+### Commands
+
+- `npm run build`: Compiles the project
+- `npm run format`: Formats the code
+- `npm run lint`: Checks code quality
+- `npm run test`: Runs tests
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

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

@@ -0,0 +1,13 @@
+import { HttpStatus } from '@nestjs/common';
+import { IErrorResponse } from './interfaces/error-response.interface';
+import { IValidationErrorDetails } from './interfaces/validation-error-detail.interface';
+import { ExceptionCode } from './reference/exception-code.reference';
+export declare class AppException extends Error {
+    readonly code: ExceptionCode;
+    readonly httpCode: HttpStatus;
+    readonly details?: IValidationErrorDetails[];
+    constructor({ message, httpCode, code, details }: IErrorResponse['error'] & {
+        httpCode: HttpStatus;
+    });
+    toJSON(): IErrorResponse;
+}

package/dist/exceptions/app.exception.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppException = void 0;
+class AppException extends Error {
+    constructor({ message, httpCode, code, details }) {
+        super(message);
+        this.httpCode = httpCode;
+        this.code = code;
+        this.details = details;
+    }
+    toJSON() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                details: this.details,
+            },
+        };
+    }
+}
+exports.AppException = AppException;
+//# sourceMappingURL=app.exception.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.exception.js","sourceRoot":"","sources":["../../src/exceptions/app.exception.ts"],"names":[],"mappings":";;;AAMA,MAAa,YAAa,SAAQ,KAAK;IAKrC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAsD;QAClG,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;SACF,CAAC;IACJ,CAAC;CACF;AAtBD,oCAsBC"}

package/dist/exceptions/bad-request.exception.d.ts

@@ -0,0 +1,8 @@
+import { AppException } from './app.exception';
+import { ExceptionCode } from './reference/exception-code.reference';
+export declare class AppBadRequestException extends AppException {
+    constructor({ message, code }: {
+        message: string;
+        code: ExceptionCode;
+    });
+}

package/dist/exceptions/bad-request.exception.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppBadRequestException = void 0;
+const common_1 = require("@nestjs/common");
+const app_exception_1 = require("./app.exception");
+class AppBadRequestException extends app_exception_1.AppException {
+    constructor({ message, code }) {
+        super({
+            message,
+            code,
+            httpCode: common_1.HttpStatus.BAD_REQUEST,
+        });
+    }
+}
+exports.AppBadRequestException = AppBadRequestException;
+//# sourceMappingURL=bad-request.exception.js.map

package/dist/exceptions/bad-request.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bad-request.exception.js","sourceRoot":"","sources":["../../src/exceptions/bad-request.exception.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAE5C,mDAA+C;AAG/C,MAAa,sBAAuB,SAAQ,4BAAY;IACtD,YAAY,EAAE,OAAO,EAAE,IAAI,EAA4C;QACrE,KAAK,CAAC;YACJ,OAAO;YACP,IAAI;YACJ,QAAQ,EAAE,mBAAU,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;CACF;AARD,wDAQC"}

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

@@ -0,0 +1,8 @@
+import { AppException } from './app.exception';
+export declare class AppConflictException extends AppException {
+    readonly conflictedFields: string[];
+    constructor({ conflictedFields }: {
+        conflictedFields: string[];
+    });
+    private static buildDetails;
+}

package/dist/exceptions/conflict.exception.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppConflictException = void 0;
+const common_1 = require("@nestjs/common");
+const app_exception_1 = require("./app.exception");
+const exception_code_reference_1 = require("./reference/exception-code.reference");
+const validation_error_type_reference_1 = require("./reference/validation-error-type.reference");
+class AppConflictException extends app_exception_1.AppException {
+    constructor({ conflictedFields }) {
+        super({
+            message: 'Some fields already exists.',
+            code: exception_code_reference_1.ExceptionCode.SomeFieldsAlreadyExists,
+            httpCode: common_1.HttpStatus.CONFLICT,
+            details: AppConflictException.buildDetails(conflictedFields),
+        });
+        this.conflictedFields = conflictedFields;
+    }
+    static buildDetails(conflictedFields) {
+        return conflictedFields.map((field) => {
+            return {
+                type: validation_error_type_reference_1.ValidationErrorType.AlreadyExists,
+                path: field,
+                message: `${field} already exists`,
+            };
+        });
+    }
+}
+exports.AppConflictException = AppConflictException;
+//# sourceMappingURL=conflict.exception.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.exception.js","sourceRoot":"","sources":["../../src/exceptions/conflict.exception.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAE5C,mDAA+C;AAE/C,mFAAqE;AACrE,iGAAkF;AAElF,MAAa,oBAAqB,SAAQ,4BAAY;IAGpD,YAAY,EAAE,gBAAgB,EAAkC;QAC9D,KAAK,CAAC;YACJ,OAAO,EAAE,6BAA6B;YACtC,IAAI,EAAE,wCAAa,CAAC,uBAAuB;YAC3C,QAAQ,EAAE,mBAAU,CAAC,QAAQ;YAC7B,OAAO,EAAE,oBAAoB,CAAC,YAAY,CAAC,gBAAgB,CAAC;SAC7D,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IAEO,MAAM,CAAC,YAAY,CAAC,gBAA0B;QACpD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAA2B,EAAE;YAC7D,OAAO;gBACL,IAAI,EAAE,qDAAmB,CAAC,aAAa;gBACvC,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,GAAG,KAAK,iBAAiB;aACnC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAvBD,oDAuBC"}

package/dist/exceptions/filters/global.exception-filter.d.ts

@@ -0,0 +1,5 @@
+import { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
+export declare class GlobalExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    catch(exception: any, host: ArgumentsHost): any;
+}

package/dist/exceptions/filters/global.exception-filter.js

@@ -0,0 +1,60 @@
+"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 GlobalExceptionFilter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("typeorm");
+const zod_1 = require("zod");
+const app_exception_1 = require("../app.exception");
+const internal_exception_1 = require("../internal.exception");
+const nestjs_exception_transformer_1 = require("../transformers/nestjs.exception-transformer");
+const typeorm_exception_transformer_1 = require("../transformers/typeorm.exception-transformer");
+const validation_exception_1 = require("../validation.exception");
+let GlobalExceptionFilter = GlobalExceptionFilter_1 = class GlobalExceptionFilter {
+    constructor() {
+        this.logger = new common_1.Logger(GlobalExceptionFilter_1.name);
+    }
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        try {
+            if (exception instanceof app_exception_1.AppException) {
+                if (exception instanceof internal_exception_1.AppInternalException)
+                    this.logger.error(exception);
+                return response.status(exception.httpCode).json(exception.toJSON());
+            }
+            let appException;
+            if (exception instanceof zod_1.ZodError) {
+                appException = new validation_exception_1.AppValidationException(exception);
+            }
+            else if (exception instanceof typeorm_1.TypeORMError) {
+                appException = typeorm_exception_transformer_1.TypeORMExceptionTransformer.transform(exception);
+            }
+            else if (exception instanceof common_1.HttpException) {
+                appException = nestjs_exception_transformer_1.NestJSExceptionTransformer.transform(exception);
+            }
+            if (!appException) {
+                appException = new internal_exception_1.AppInternalException({ error: exception });
+            }
+            if (appException instanceof internal_exception_1.AppInternalException)
+                this.logger.error(appException);
+            return response.status(appException.httpCode).json(appException.toJSON());
+        }
+        catch (error) {
+            const err = new internal_exception_1.AppInternalException({ error });
+            this.logger.error(err);
+            return response.status(err.httpCode).json(err.toJSON());
+        }
+    }
+};
+exports.GlobalExceptionFilter = GlobalExceptionFilter;
+exports.GlobalExceptionFilter = GlobalExceptionFilter = GlobalExceptionFilter_1 = __decorate([
+    (0, common_1.Catch)()
+], GlobalExceptionFilter);
+//# sourceMappingURL=global.exception-filter.js.map

package/dist/exceptions/filters/global.exception-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.exception-filter.js","sourceRoot":"","sources":["../../../src/exceptions/filters/global.exception-filter.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA8F;AAC9F,qCAAuC;AACvC,6BAA+B;AAE/B,oDAAgD;AAChD,8DAA6D;AAC7D,+FAA0F;AAC1F,iGAA4F;AAC5F,kEAAiE;AAG1D,IAAM,qBAAqB,6BAA3B,MAAM,qBAAqB;IAA3B;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,CAAC;IAsCnE,CAAC;IApCC,KAAK,CAAC,SAAc,EAAE,IAAmB;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAEnC,IAAI,CAAC;YACH,IAAI,SAAS,YAAY,4BAAY,EAAE,CAAC;gBACtC,IAAI,SAAS,YAAY,yCAAoB;oBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAE5E,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,IAAI,YAAsC,CAAC;YAE3C,IAAI,SAAS,YAAY,cAAQ,EAAE,CAAC;gBAClC,YAAY,GAAG,IAAI,6CAAsB,CAAC,SAAS,CAAC,CAAC;YACvD,CAAC;iBAAM,IAAI,SAAS,YAAY,sBAAY,EAAE,CAAC;gBAC7C,YAAY,GAAG,2DAA2B,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAClE,CAAC;iBAAM,IAAI,SAAS,YAAY,sBAAa,EAAE,CAAC;gBAC9C,YAAY,GAAG,yDAA0B,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,YAAY,GAAG,IAAI,yCAAoB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAChE,CAAC;YAED,IAAI,YAAY,YAAY,yCAAoB;gBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAElF,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,IAAI,yCAAoB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAEhD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEvB,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF,CAAA;AAvCY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,cAAK,GAAE;GACK,qBAAqB,CAuCjC"}

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

@@ -0,0 +1 @@
+export * from './global.exception-filter';

package/dist/exceptions/filters/index.js

@@ -0,0 +1,18 @@
+"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.exception-filter"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,8 @@
+import { AppException } from './app.exception';
+import { ExceptionCode } from './reference/exception-code.reference';
+export declare class AppForbiddenException extends AppException {
+    constructor({ message, code, }?: {
+        message?: string;
+        code?: ExceptionCode;
+    });
+}

package/dist/exceptions/forbidden.exception.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppForbiddenException = void 0;
+const common_1 = require("@nestjs/common");
+const app_exception_1 = require("./app.exception");
+const exception_code_reference_1 = require("./reference/exception-code.reference");
+class AppForbiddenException extends app_exception_1.AppException {
+    constructor({ message = 'You do not have permission to access this resource.', code = exception_code_reference_1.ExceptionCode.InsufficientPermissions, } = {}) {
+        super({
+            message,
+            code,
+            httpCode: common_1.HttpStatus.FORBIDDEN,
+        });
+    }
+}
+exports.AppForbiddenException = AppForbiddenException;
+//# sourceMappingURL=forbidden.exception.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden.exception.js","sourceRoot":"","sources":["../../src/exceptions/forbidden.exception.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAE5C,mDAA+C;AAC/C,mFAAqE;AAErE,MAAa,qBAAsB,SAAQ,4BAAY;IACrD,YAAY,EACV,OAAO,GAAG,qDAAqD,EAC/D,IAAI,GAAG,wCAAa,CAAC,uBAAuB,MACE,EAAE;QAChD,KAAK,CAAC;YACJ,OAAO;YACP,IAAI;YACJ,QAAQ,EAAE,mBAAU,CAAC,SAAS;SAC/B,CAAC,CAAC;IACL,CAAC;CACF;AAXD,sDAWC"}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,14 @@
+export * from './app.exception';
+export * from './bad-request.exception';
+export * from './conflict.exception';
+export * from './forbidden.exception';
+export * from './internal.exception';
+export * from './not-found.exception';
+export * from './too-many-request.exception';
+export * from './unauthorized.exception';
+export * from './unprocessable-entity.exception';
+export * from './validation.exception';
+export * from './filters';
+export * from './interfaces';
+export * from './reference';
+export * from './transformers';

package/dist/exceptions/index.js

@@ -0,0 +1,31 @@
+"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("./app.exception"), exports);
+__exportStar(require("./bad-request.exception"), exports);
+__exportStar(require("./conflict.exception"), exports);
+__exportStar(require("./forbidden.exception"), exports);
+__exportStar(require("./internal.exception"), exports);
+__exportStar(require("./not-found.exception"), exports);
+__exportStar(require("./too-many-request.exception"), exports);
+__exportStar(require("./unauthorized.exception"), exports);
+__exportStar(require("./unprocessable-entity.exception"), exports);
+__exportStar(require("./validation.exception"), exports);
+__exportStar(require("./filters"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./reference"), exports);
+__exportStar(require("./transformers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,kDAAgC;AAChC,0DAAwC;AACxC,uDAAqC;AACrC,wDAAsC;AACtC,uDAAqC;AACrC,wDAAsC;AACtC,+DAA6C;AAC7C,2DAAyC;AACzC,mEAAiD;AACjD,yDAAuC;AAGvC,4CAA0B;AAC1B,+CAA6B;AAC7B,8CAA4B;AAC5B,iDAA+B"}

package/dist/exceptions/interfaces/error-response.interface.d.ts

@@ -0,0 +1,9 @@
+import { ExceptionCode } from '../reference/exception-code.reference';
+import { IValidationErrorDetails } from './validation-error-detail.interface';
+export interface IErrorResponse {
+    error: {
+        code: ExceptionCode;
+        message: string;
+        details?: IValidationErrorDetails[];
+    };
+}

package/dist/exceptions/interfaces/error-response.interface.js

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

package/dist/exceptions/interfaces/error-response.interface.js.map

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

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

@@ -0,0 +1,2 @@
+export * from './error-response.interface';
+export * from './validation-error-detail.interface';

package/dist/exceptions/interfaces/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("./error-response.interface"), exports);
+__exportStar(require("./validation-error-detail.interface"), exports);
+//# sourceMappingURL=index.js.map

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

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

package/dist/exceptions/interfaces/validation-error-detail.interface.d.ts

@@ -0,0 +1,6 @@
+import { ValidationErrorType } from '../reference/validation-error-type.reference';
+export interface IValidationErrorDetails {
+    type: ValidationErrorType;
+    path: string;
+    message: string;
+}

package/dist/exceptions/interfaces/validation-error-detail.interface.js

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

package/dist/exceptions/interfaces/validation-error-detail.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error-detail.interface.js","sourceRoot":"","sources":["../../../src/exceptions/interfaces/validation-error-detail.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,10 @@
+import { AppException } from './app.exception';
+import { ExceptionCode } from './reference/exception-code.reference';
+export declare class AppInternalException extends AppException {
+    readonly originalError?: Error;
+    constructor({ message, code, error, }?: {
+        message?: string;
+        code?: ExceptionCode;
+        error?: Error;
+    });
+}

package/dist/exceptions/internal.exception.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppInternalException = void 0;
+const common_1 = require("@nestjs/common");
+const app_exception_1 = require("./app.exception");
+const exception_code_reference_1 = require("./reference/exception-code.reference");
+class AppInternalException extends app_exception_1.AppException {
+    constructor({ message = 'An unexpected error occurred.', code, error, } = {}) {
+        super({
+            message,
+            code: code || exception_code_reference_1.ExceptionCode.UnexpectedError,
+            httpCode: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+        });
+        this.originalError = error;
+    }
+}
+exports.AppInternalException = AppInternalException;
+//# sourceMappingURL=internal.exception.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.exception.js","sourceRoot":"","sources":["../../src/exceptions/internal.exception.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAE5C,mDAA+C;AAC/C,mFAAqE;AAErE,MAAa,oBAAqB,SAAQ,4BAAY;IAGpD,YAAY,EACV,OAAO,GAAG,+BAA+B,EACzC,IAAI,EACJ,KAAK,MACwD,EAAE;QAC/D,KAAK,CAAC;YACJ,OAAO;YACP,IAAI,EAAE,IAAI,IAAI,wCAAa,CAAC,eAAe;YAC3C,QAAQ,EAAE,mBAAU,CAAC,qBAAqB;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;CACF;AAhBD,oDAgBC"}

package/dist/exceptions/not-found.exception.d.ts

@@ -0,0 +1,8 @@
+import { AppException } from './app.exception';
+export declare class AppNotFoundException extends AppException {
+    readonly resourceName: string;
+    constructor({ resourceName, message }?: {
+        resourceName?: string;
+        message?: string;
+    });
+}

package/dist/exceptions/not-found.exception.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppNotFoundException = void 0;
+const common_1 = require("@nestjs/common");
+const app_exception_1 = require("./app.exception");
+const exception_code_reference_1 = require("./reference/exception-code.reference");
+class AppNotFoundException extends app_exception_1.AppException {
+    constructor({ resourceName = 'Resource', message } = {}) {
+        super({
+            message: message || `${resourceName} not found.`,
+            code: exception_code_reference_1.ExceptionCode.ResourceNotFound,
+            httpCode: common_1.HttpStatus.NOT_FOUND,
+        });
+        this.resourceName = resourceName;
+    }
+}
+exports.AppNotFoundException = AppNotFoundException;
+//# sourceMappingURL=not-found.exception.js.map

package/dist/exceptions/not-found.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.exception.js","sourceRoot":"","sources":["../../src/exceptions/not-found.exception.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAE5C,mDAA+C;AAC/C,mFAAqE;AAErE,MAAa,oBAAqB,SAAQ,4BAAY;IAGpD,YAAY,EAAE,YAAY,GAAG,UAAU,EAAE,OAAO,KAAkD,EAAE;QAClG,KAAK,CAAC;YACJ,OAAO,EAAE,OAAO,IAAI,GAAG,YAAY,aAAa;YAChD,IAAI,EAAE,wCAAa,CAAC,gBAAgB;YACpC,QAAQ,EAAE,mBAAU,CAAC,SAAS;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAZD,oDAYC"}