@xfilecom/backend-core 1.0.0

package/dist/core.module.d.ts

@@ -0,0 +1,40 @@
+import { DynamicModule } from '@nestjs/common';
+import { DatabaseConfig } from './database/database.module';
+import { LoggingInterceptorOptions } from './interceptors/logging.interceptor';
+import { ExceptionFilterOptions } from './filters/exception.filter';
+export interface CoreModuleOptions {
+    database?: {
+        auto?: boolean;
+        config?: DatabaseConfig;
+        schema?: any;
+    };
+    jwt?: {
+        secret?: string;
+        expiresIn?: string;
+        issuer?: string;
+        audience?: string;
+    };
+    response?: {
+        commonResponse?: boolean;
+    };
+    interceptors?: {
+        logging?: boolean | LoggingInterceptorOptions;
+        errorHandling?: boolean;
+        responseTransform?: boolean;
+        databaseCheck?: boolean;
+    };
+    guards?: {
+        jwt?: boolean;
+    };
+    filters?: {
+        exception?: boolean | ExceptionFilterOptions;
+        rpcException?: boolean;
+    };
+    serviceType?: 'microservice' | 'http-api' | 'hybrid';
+}
+export declare class CoreModule {
+    static forRoot(options?: CoreModuleOptions): DynamicModule;
+    static forMicroservice(options?: CoreModuleOptions): DynamicModule;
+    static forHttpApi(options?: CoreModuleOptions): DynamicModule;
+    static forHybrid(options?: CoreModuleOptions): DynamicModule;
+}

package/dist/core.module.js

@@ -0,0 +1,195 @@
+"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 CoreModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const database_module_1 = require("./database/database.module");
+const logging_interceptor_1 = require("./interceptors/logging.interceptor");
+const error_handling_interceptor_1 = require("./interceptors/error-handling.interceptor");
+const response_transform_interceptor_1 = require("./interceptors/response-transform.interceptor");
+const database_check_interceptor_1 = require("./interceptors/database-check.interceptor");
+const exception_filter_1 = require("./filters/exception.filter");
+const rpc_response_exception_filter_1 = require("./filters/rpc-response-exception.filter");
+const jwt_auth_guard_1 = require("./guards/jwt-auth.guard");
+const roles_guard_1 = require("./guards/roles.guard");
+const controller_helpers_1 = require("./utils/controller.helpers");
+const service_helpers_1 = require("./utils/service.helpers");
+const error_utils_1 = require("./utils/error.utils");
+const auth_helpers_1 = require("./utils/auth.helpers");
+const logger_helpers_1 = require("./utils/logger.helpers");
+const logging_config_1 = require("./utils/logging.config");
+const defaultTrue = (v) => v !== false;
+let CoreModule = CoreModule_1 = class CoreModule {
+    static forRoot(options = {}) {
+        const modules = [];
+        const providers = [];
+        const exports = [];
+        if (defaultTrue(options.database?.auto)) {
+            try {
+                if (options.database?.config && options.database?.schema) {
+                    modules.push(database_module_1.DatabaseModule.forRoot({
+                        config: options.database.config,
+                        schema: options.database.schema,
+                    }));
+                }
+                else if (options.database?.schema) {
+                    modules.push(database_module_1.DatabaseModule.forRootFromEnv(options.database.schema));
+                }
+            }
+            catch (e) {
+                console.warn('[CoreModule] Database module initialization failed:', e.message);
+            }
+        }
+        const interceptors = options.interceptors || {};
+        const useLogging = interceptors.logging !== false;
+        const useErrorHandling = defaultTrue(interceptors.errorHandling);
+        const useCommonResponse = defaultTrue(options.response?.commonResponse ?? interceptors.responseTransform);
+        const useDatabaseCheck = defaultTrue(interceptors.databaseCheck);
+        if (useLogging) {
+            const { loggerOptions, interceptorOptions: envInterceptorOptions } = (0, logging_config_1.getLoggingConfigFromEnv)();
+            const loggingOptions = typeof interceptors.logging === 'object'
+                ? { ...envInterceptorOptions, ...interceptors.logging }
+                : envInterceptorOptions;
+            const loggerHelpers = new logger_helpers_1.LoggerHelpers('Request', undefined, undefined, loggerOptions);
+            providers.push({
+                provide: core_1.APP_INTERCEPTOR,
+                useValue: new logging_interceptor_1.LoggingInterceptor(loggerHelpers, loggingOptions),
+            });
+        }
+        if (useErrorHandling) {
+            providers.push({
+                provide: core_1.APP_INTERCEPTOR,
+                useClass: error_handling_interceptor_1.ErrorHandlingInterceptor,
+            });
+        }
+        if (useCommonResponse &&
+            (options.serviceType === 'http-api' || options.serviceType === 'hybrid')) {
+            providers.push({
+                provide: core_1.APP_INTERCEPTOR,
+                useClass: response_transform_interceptor_1.ResponseTransformInterceptor,
+            });
+        }
+        if (useDatabaseCheck) {
+            providers.push({
+                provide: core_1.APP_INTERCEPTOR,
+                useClass: database_check_interceptor_1.DatabaseCheckInterceptor,
+            });
+        }
+        const useExceptionFilter = options.filters?.exception !== false;
+        if (useExceptionFilter) {
+            const filterOptions = typeof options.filters.exception === 'object'
+                ? options.filters.exception
+                : {};
+            providers.push({
+                provide: core_1.APP_FILTER,
+                useValue: new exception_filter_1.AllExceptionsFilter(filterOptions),
+            });
+        }
+        if (options.filters?.rpcException === true) {
+            providers.push({
+                provide: core_1.APP_FILTER,
+                useClass: rpc_response_exception_filter_1.RpcResponseExceptionFilter,
+            });
+        }
+        if (options.guards?.jwt === true) {
+            try {
+                const { ConfigValidator } = require('./utils/config.validator');
+                ConfigValidator.validateJwtConfig(false, options.jwt);
+            }
+            catch (e) {
+            }
+            providers.push({
+                provide: core_1.APP_GUARD,
+                useClass: jwt_auth_guard_1.JwtAuthGuard,
+            });
+        }
+        providers.push(core_1.Reflector);
+        const jwtSecret = options.jwt?.secret || process.env.JWT_SECRET || 'your-secret-key';
+        const jwtExpiresIn = options.jwt?.expiresIn || process.env.JWT_EXPIRES_IN || '7d';
+        const saltRounds = parseInt(process.env.BCRYPT_SALT_ROUNDS || '10', 10);
+        providers.push({
+            provide: 'JWT_SECRET',
+            useValue: jwtSecret,
+        });
+        providers.push({
+            provide: 'JWT_EXPIRES_IN',
+            useValue: jwtExpiresIn,
+        });
+        providers.push({
+            provide: 'BCRYPT_SALT_ROUNDS',
+            useValue: saltRounds,
+        });
+        providers.push(controller_helpers_1.ControllerHelpers, service_helpers_1.ServiceHelpers, error_utils_1.ErrorUtils, auth_helpers_1.AuthHelpers, roles_guard_1.RolesGuard);
+        exports.push(controller_helpers_1.ControllerHelpers, service_helpers_1.ServiceHelpers, error_utils_1.ErrorUtils, auth_helpers_1.AuthHelpers, roles_guard_1.RolesGuard);
+        return {
+            module: CoreModule_1,
+            imports: modules,
+            providers,
+            exports,
+        };
+    }
+    static forMicroservice(options = {}) {
+        return CoreModule_1.forRoot({
+            serviceType: 'microservice',
+            interceptors: {
+                logging: true,
+                errorHandling: true,
+                databaseCheck: true,
+                responseTransform: false,
+                ...options.interceptors,
+            },
+            response: { commonResponse: false, ...options.response },
+            guards: { jwt: false, ...options.guards },
+            filters: { exception: false, rpcException: true, ...options.filters },
+            database: options.database,
+            jwt: options.jwt,
+        });
+    }
+    static forHttpApi(options = {}) {
+        return CoreModule_1.forRoot({
+            serviceType: 'http-api',
+            interceptors: {
+                logging: true,
+                errorHandling: true,
+                responseTransform: true,
+                databaseCheck: true,
+                ...options.interceptors,
+            },
+            response: { commonResponse: true, ...options.response },
+            guards: { jwt: true, ...options.guards },
+            filters: { exception: true, ...options.filters },
+            database: options.database,
+            jwt: options.jwt,
+        });
+    }
+    static forHybrid(options = {}) {
+        return CoreModule_1.forRoot({
+            serviceType: 'hybrid',
+            interceptors: {
+                logging: true,
+                errorHandling: true,
+                responseTransform: true,
+                databaseCheck: true,
+                ...options.interceptors,
+            },
+            response: { commonResponse: true, ...options.response },
+            guards: { jwt: true, ...options.guards },
+            filters: { exception: true, ...options.filters },
+            database: options.database,
+            jwt: options.jwt,
+        });
+    }
+};
+exports.CoreModule = CoreModule;
+exports.CoreModule = CoreModule = CoreModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], CoreModule);
+//# sourceMappingURL=core.module.js.map

package/dist/core.module.js.map

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

package/dist/database/database.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DATABASE_CONFIG = "DATABASE_CONFIG";
+export declare const DATABASE_SCHEMA = "DATABASE_SCHEMA";

package/dist/database/database.constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATABASE_SCHEMA = exports.DATABASE_CONFIG = void 0;
+exports.DATABASE_CONFIG = 'DATABASE_CONFIG';
+exports.DATABASE_SCHEMA = 'DATABASE_SCHEMA';
+//# sourceMappingURL=database.constants.js.map

package/dist/database/database.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.constants.js","sourceRoot":"","sources":["../../src/database/database.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG,iBAAiB,CAAC;AACpC,QAAA,eAAe,GAAG,iBAAiB,CAAC"}

package/dist/database/database.module.d.ts

@@ -0,0 +1,19 @@
+import { DynamicModule } from '@nestjs/common';
+export interface DatabaseConfig {
+    type: 'mysql';
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    ssl?: boolean;
+    connectionLimit?: number;
+}
+export interface DatabaseModuleOptions {
+    config: DatabaseConfig;
+    schema: any;
+}
+export declare class DatabaseModule {
+    static forRoot(options: DatabaseModuleOptions): DynamicModule;
+    static forRootFromEnv(schema: any): DynamicModule;
+}

package/dist/database/database.module.js

@@ -0,0 +1,56 @@
+"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 DatabaseModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseModule = void 0;
+const common_1 = require("@nestjs/common");
+const database_service_1 = require("./database.service");
+const database_query_1 = require("./database.query");
+const database_constants_1 = require("./database.constants");
+let DatabaseModule = DatabaseModule_1 = class DatabaseModule {
+    static forRoot(options) {
+        return {
+            module: DatabaseModule_1,
+            providers: [
+                {
+                    provide: database_constants_1.DATABASE_CONFIG,
+                    useValue: options.config,
+                },
+                {
+                    provide: database_constants_1.DATABASE_SCHEMA,
+                    useValue: options.schema,
+                },
+                database_service_1.DatabaseService,
+                database_query_1.DatabaseQuery,
+            ],
+            exports: [database_service_1.DatabaseService, database_query_1.DatabaseQuery],
+        };
+    }
+    static forRootFromEnv(schema) {
+        const { ConfigValidator } = require('../utils/config.validator');
+        ConfigValidator.validateDatabaseConfig(false);
+        const password = process.env.DB_PASSWORD;
+        const config = {
+            type: 'mysql',
+            host: process.env.DB_HOST || 'localhost',
+            port: ConfigValidator.validatePort(process.env.DB_PORT, 3306),
+            user: process.env.DB_USER || 'root',
+            password: password !== undefined ? password : undefined,
+            database: process.env.DB_NAME || process.env.DB_DATABASE || 'test',
+            ssl: ConfigValidator.parseBoolean(process.env.DB_SSL, false),
+            connectionLimit: ConfigValidator.parseNumber(process.env.DB_CONNECTION_LIMIT, 10, 1, 100),
+        };
+        return DatabaseModule_1.forRoot({ config, schema });
+    }
+};
+exports.DatabaseModule = DatabaseModule;
+exports.DatabaseModule = DatabaseModule = DatabaseModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], DatabaseModule);
+//# sourceMappingURL=database.module.js.map

package/dist/database/database.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.module.js","sourceRoot":"","sources":["../../src/database/database.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+D;AAC/D,yDAAqD;AACrD,qDAAiD;AACjD,6DAAwE;AAoBjE,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,OAA8B;QAC3C,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,oCAAe;oBACxB,QAAQ,EAAE,OAAO,CAAC,MAAM;iBACzB;gBACD;oBACE,OAAO,EAAE,oCAAe;oBACxB,QAAQ,EAAE,OAAO,CAAC,MAAM;iBACzB;gBACD,kCAAe;gBACf,8BAAa;aACd;YACD,OAAO,EAAE,CAAC,kCAAe,EAAE,8BAAa,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,MAAW;QAE/B,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;QAGjE,eAAe,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAE9C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAGzC,MAAM,MAAM,GAAmB;YAC7B,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,WAAW;YACxC,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;YAC7D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,MAAM;YACnC,QAAQ,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACvD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM;YAClE,GAAG,EAAE,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;YAC5D,eAAe,EAAE,eAAe,CAAC,WAAW,CAC1C,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAC/B,EAAE,EACF,CAAC,EACD,GAAG,CACJ;SACF,CAAC;QAEF,OAAO,gBAAc,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAA;AAhDY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CAgD1B"}

package/dist/database/database.query.d.ts

@@ -0,0 +1,103 @@
+import { SQL } from 'drizzle-orm';
+import { DatabaseService } from './database.service';
+export interface SearchOption {
+    keyword: string;
+    fields: string[];
+}
+export interface SortOption {
+    field: string;
+    order: 'asc' | 'desc';
+}
+export interface PaginationOption {
+    page: number;
+    limit: number;
+}
+export type WhereClause = SQL | Record<string, any>;
+export interface QueryOptions {
+    values?: Record<string, any>;
+    sort?: SortOption[];
+    pagination?: PaginationOption;
+    search?: SearchOption[];
+    where?: WhereClause;
+}
+export interface UnifiedQueryOptions {
+    table: string;
+    fields?: string[];
+    sort?: SortOption[];
+    pagination?: PaginationOption;
+    search?: SearchOption[];
+    where?: WhereClause;
+}
+export interface SelectOptions {
+    table: string;
+    fields?: string[];
+    sort?: SortOption[];
+    pagination?: PaginationOption;
+    search?: SearchOption[];
+    where?: WhereClause;
+}
+export interface UnifiedInsertOptions {
+    table: string;
+    fields?: string[];
+    values: Record<string, any>;
+}
+export interface UnifiedUpdateOptions {
+    table: string;
+    fields?: string[];
+    values: Record<string, any>;
+    where: WhereClause;
+}
+export interface UnifiedDeleteOptions {
+    table: string;
+    where: WhereClause;
+}
+export interface FindOneOptions {
+    where?: WhereClause;
+    fields?: string[];
+    sort?: SortOption[];
+    search?: SearchOption[];
+}
+export interface QueryResult<T = any> {
+    data: T[];
+    pagination?: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+export declare class DatabaseQuery {
+    private readonly databaseService;
+    private readonly schema;
+    constructor(databaseService: DatabaseService, schema: any);
+    private getDb;
+    private getTable;
+    private selectFields;
+    private buildSearchCondition;
+    private isPlainObjectWhere;
+    private buildWhereFromObject;
+    private normalizeWhere;
+    private buildSortCondition;
+    private getTableIdColumn;
+    findOne<T = any>(table: string, options?: FindOneOptions): Promise<T | undefined>;
+    findById<T = any>(table: string, id: string | number, options?: {
+        idField?: string;
+        fields?: string[];
+    }): Promise<T | undefined>;
+    count(table: string, options?: {
+        where?: WhereClause;
+    }): Promise<number>;
+    exists(table: string, options?: {
+        where?: WhereClause;
+    }): Promise<boolean>;
+    query<T = any>(options: UnifiedQueryOptions): Promise<QueryResult<T>>;
+    select<T = any>(tableOrOptions: string | SelectOptions, fields?: string[], options?: QueryOptions): Promise<QueryResult<T>>;
+    insertOne<T = any>(options: UnifiedInsertOptions): Promise<T[]>;
+    insert<T = any>(table: string, fields: string[], options?: QueryOptions): Promise<T[]>;
+    updateOne<T = any>(options: UnifiedUpdateOptions): Promise<T[]>;
+    update<T = any>(table: string, fields: string[], options?: QueryOptions): Promise<T[]>;
+    deleteOne<T = any>(options: UnifiedDeleteOptions): Promise<T[]>;
+    delete<T = any>(table: string, fields: string[], options?: QueryOptions): Promise<T[]>;
+}