@lenne.tech/nest-server 11.32.3 → 11.33.0

package/dist/core/common/helpers/graceful-shutdown.helper.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installGracefulShutdown = installGracefulShutdown;
+const common_1 = require("@nestjs/common");
+const config_service_1 = require("../services/config.service");
+const SHUTDOWN_SIGNALS = ['SIGTERM', 'SIGINT'];
+const MAX_SHUTDOWN_DELAY_MS = 60_000;
+const SHUTDOWN_DELAY_ADVISORY_MS = 10_000;
+function installGracefulShutdown(app) {
+    const logger = new common_1.Logger('GracefulShutdown');
+    const configured = config_service_1.ConfigService.getFastButReadOnly('shutdownDelayMs');
+    const delayMs = typeof configured === 'number' && configured > 0 ? configured : 0;
+    if (!delayMs) {
+        app.enableShutdownHooks();
+        return app;
+    }
+    if (delayMs > MAX_SHUTDOWN_DELAY_MS) {
+        logger.warn(`shutdownDelayMs is ${delayMs}ms, which exceeds the ${MAX_SHUTDOWN_DELAY_MS}ms cap and is longer than a typical ` +
+            `orchestrator grace period — capping it, since a longer wait only ends in SIGKILL.`);
+    }
+    else if (delayMs > SHUTDOWN_DELAY_ADVISORY_MS) {
+        logger.warn(`shutdownDelayMs is ${delayMs}ms. Keep it well below your orchestrator's grace period AND leave room for the ` +
+            'drain that follows it — Docker/Compose stop_grace_period defaults to 10s, Kubernetes ' +
+            'terminationGracePeriodSeconds to 30s, and installProcessDiagnostics() force-exits after 30s. Exceeding any ' +
+            'of them means the process is killed mid-wait and no shutdown hook runs at all.');
+    }
+    const effectiveDelayMs = Math.min(delayMs, MAX_SHUTDOWN_DELAY_MS);
+    let shuttingDown = false;
+    let timer;
+    const handle = (signal) => {
+        if (shuttingDown) {
+            logger.warn(`${signal} received again — closing immediately`);
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            void app.close();
+            return;
+        }
+        shuttingDown = true;
+        logger.log(`${signal} received — staying healthy for ${effectiveDelayMs}ms so the load balancer can deregister`);
+        timer = setTimeout(() => {
+            app
+                .close()
+                .then(() => logger.log('Shutdown complete'))
+                .catch((error) => logger.error(`Shutdown failed: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        }, effectiveDelayMs);
+        timer.unref?.();
+    };
+    for (const signal of SHUTDOWN_SIGNALS) {
+        process.on(signal, handle);
+    }
+    return app;
+}
+//# sourceMappingURL=graceful-shutdown.helper.js.map

package/dist/core/common/helpers/graceful-shutdown.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.helper.js","sourceRoot":"","sources":["../../../../src/core/common/helpers/graceful-shutdown.helper.ts"],"names":[],"mappings":";;AAoDA,0DA+DC;AAnHD,2CAA0D;AAE1D,+DAA2D;AAG3D,MAAM,gBAAgB,GAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAOjE,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAerC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAyB1C,SAAgB,uBAAuB,CAA6B,GAAM;IACxE,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,kBAAkB,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,8BAAa,CAAC,kBAAkB,CAAqB,iBAAiB,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF,IAAI,CAAC,OAAO,EAAE,CAAC;QAEb,GAAG,CAAC,mBAAmB,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CACT,sBAAsB,OAAO,yBAAyB,qBAAqB,sCAAsC;YAC/G,mFAAmF,CACtF,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,GAAG,0BAA0B,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CACT,sBAAsB,OAAO,iFAAiF;YAC5G,uFAAuF;YACvF,6GAA6G;YAC7G,gFAAgF,CACnF,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAIlE,IAAI,YAAY,GAAG,KAAK,CAAC;IAIzB,IAAI,KAAiC,CAAC;IAEtC,MAAM,MAAM,GAAG,CAAC,MAAsB,EAAQ,EAAE;QAC9C,IAAI,YAAY,EAAE,CAAC;YAEjB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,uCAAuC,CAAC,CAAC;YAC9D,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;YACD,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,YAAY,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,mCAAmC,gBAAgB,wCAAwC,CAAC,CAAC;QAEjH,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,GAAG;iBACA,KAAK,EAAE;iBACP,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;iBAC3C,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QACpH,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAErB,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAClB,CAAC,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/common/helpers/project-name.helper.d.ts

@@ -0,0 +1,2 @@
+export declare function getProjectSlug(): string;
+export declare function resetProjectSlugCache(): void;

package/dist/core/common/helpers/project-name.helper.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectSlug = getProjectSlug;
+exports.resetProjectSlugCache = resetProjectSlugCache;
+const fs = require("fs");
+const path = require("path");
+let cachedProjectSlug;
+const FALLBACK_SLUG = 'nest-server';
+function getProjectSlug() {
+    if (cachedProjectSlug !== undefined) {
+        return cachedProjectSlug;
+    }
+    cachedProjectSlug = FALLBACK_SLUG;
+    try {
+        const raw = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
+        if (raw?.name && typeof raw.name === 'string') {
+            const slug = slugify(raw.name);
+            if (slug) {
+                cachedProjectSlug = slug;
+            }
+        }
+    }
+    catch {
+    }
+    return cachedProjectSlug;
+}
+function resetProjectSlugCache() {
+    cachedProjectSlug = undefined;
+}
+function slugify(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/^@/, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=project-name.helper.js.map

package/dist/core/common/helpers/project-name.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-name.helper.js","sourceRoot":"","sources":["../../../../src/core/common/helpers/project-name.helper.ts"],"names":[],"mappings":";;AA6BA,wCAqBC;AAGD,sDAEC;AAvDD,yBAAyB;AACzB,6BAA6B;AAO7B,IAAI,iBAAqC,CAAC;AAG1C,MAAM,aAAa,GAAG,aAAa,CAAC;AAkBpC,SAAgB,cAAc;IAC5B,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,iBAAiB,GAAG,aAAa,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3F,IAAI,GAAG,EAAE,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,EAAE,CAAC;gBACT,iBAAiB,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;IAGT,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAGD,SAAgB,qBAAqB;IACnC,iBAAiB,GAAG,SAAS,CAAC;AAChC,CAAC;AAQD,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/core/common/interfaces/cron-job-config.interface.d.ts

@@ -3,6 +3,7 @@ export interface CronJobConfig<OC extends CronOnCompleteCommand | null = null, C
     context?: CronJobParams<OC, C>['context'];
     cronTime: CronJobParams<OC, C>['cronTime'];
     disabled?: boolean;
+    distributed?: boolean;
     onComplete?: CronJobParams<OC, C>['onComplete'];
     runOnInit?: CronJobParams<OC, C>['runOnInit'];
     runParallel?: boolean | number;

package/dist/core/common/interfaces/server-options.interface.d.ts

@@ -108,6 +108,13 @@ export interface IErrorCode {
     }>;
     autoRegister?: boolean;
 }
+export interface IFileConfig {
+    deleteRoles?: string[];
+    downloadRoles?: string[];
+    storage?: 'filesystem' | 'gridfs' | 's3';
+    storageDir?: string;
+    uploadRoles?: string[];
+}
 export interface IJwt {
     privateKey?: string;
     publicKey?: string;
@@ -243,6 +250,7 @@ export interface IServerOptions {
     version?: string;
     errorCode?: IErrorCode;
     execAfterInit?: string;
+    file?: IFileConfig;
     filter?: {
         maxLimit?: number;
     };
@@ -301,6 +309,8 @@ export interface IServerOptions {
     multiTenancy?: IMultiTenancy;
     permissions?: boolean | IPermissions;
     port?: number;
+    redis?: boolean | IRedisConfig;
+    s3?: IS3Config;
     security?: {
         checkResponseInterceptor?: boolean | {
             checkObjectItself?: boolean;
@@ -334,6 +344,7 @@ export interface IServerOptions {
         secretFields?: string[];
     };
     sha256?: boolean;
+    shutdownDelayMs?: number;
     staticAssets?: {
         options?: ServeStaticOptions;
         path?: string;
@@ -343,8 +354,34 @@ export interface IServerOptions {
         engine?: string;
         path?: string;
     };
+    trustProxy?: boolean | number | string | string[];
     tus?: boolean | ITusConfig;
 }
+export interface IRedisConfig {
+    db?: number;
+    enabled?: boolean;
+    host?: string;
+    keyPrefix?: string;
+    options?: Record<string, unknown>;
+    password?: string;
+    port?: number;
+    url?: string;
+    username?: string;
+}
+export interface IS3Config {
+    accessKeyId?: string;
+    autoCreateBucket?: boolean;
+    bucket: string;
+    enabled?: boolean;
+    endpoint?: string;
+    forcePathStyle?: boolean;
+    presignedDownloads?: boolean | {
+        expiresInSeconds?: number;
+    };
+    region?: string;
+    secretAccessKey?: string;
+    stagingBucket?: string;
+}
 export interface ISystemSetup {
     enabled?: boolean;
     initialAdmin?: ISystemSetupInitialAdmin;
@@ -365,6 +402,8 @@ export interface ITusConfig {
     expiration?: boolean | ITusExpirationConfig;
     maxSize?: number;
     path?: string;
+    roles?: string[];
+    s3Staging?: boolean;
     termination?: boolean;
     uploadDir?: string;
 }

package/dist/core/common/services/core-cron-jobs.initializer.d.ts

@@ -0,0 +1,10 @@
+import { OnApplicationShutdown, OnModuleInit } from '@nestjs/common';
+import { Connection } from 'mongoose';
+import { CoreRedisService } from './core-redis.service';
+export declare class CoreCronJobsInitializer implements OnApplicationShutdown, OnModuleInit {
+    protected readonly connection: Connection;
+    protected readonly redisService?: CoreRedisService;
+    constructor(connection: Connection, redisService?: CoreRedisService);
+    onModuleInit(): void;
+    onApplicationShutdown(): void;
+}

package/dist/core/common/services/core-cron-jobs.initializer.js

@@ -0,0 +1,46 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreCronJobsInitializer = void 0;
+const common_1 = require("@nestjs/common");
+const mongoose_1 = require("@nestjs/mongoose");
+const mongoose_2 = require("mongoose");
+const core_cron_jobs_registry_1 = require("./core-cron-jobs.registry");
+const core_redis_service_1 = require("./core-redis.service");
+let CoreCronJobsInitializer = class CoreCronJobsInitializer {
+    connection;
+    redisService;
+    constructor(connection, redisService) {
+        this.connection = connection;
+        this.redisService = redisService;
+    }
+    onModuleInit() {
+        (0, core_cron_jobs_registry_1.setCronJobsInfrastructure)({
+            connection: this.connection,
+            redisService: this.redisService?.enabled ? this.redisService : undefined,
+        });
+    }
+    onApplicationShutdown() {
+        (0, core_cron_jobs_registry_1.setCronJobsInfrastructure)({});
+    }
+};
+exports.CoreCronJobsInitializer = CoreCronJobsInitializer;
+exports.CoreCronJobsInitializer = CoreCronJobsInitializer = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, mongoose_1.InjectConnection)()),
+    __param(1, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [mongoose_2.Connection,
+        core_redis_service_1.CoreRedisService])
+], CoreCronJobsInitializer);
+//# sourceMappingURL=core-cron-jobs.initializer.js.map

package/dist/core/common/services/core-cron-jobs.initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-cron-jobs.initializer.js","sourceRoot":"","sources":["../../../../src/core/common/services/core-cron-jobs.initializer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA2F;AAC3F,+CAAoD;AACpD,uCAAsC;AAEtC,uEAAsE;AACtE,6DAAwD;AAUjD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAEO;IACR;IAFjC,YACyC,UAAsB,EAC9B,YAA+B;QADvB,eAAU,GAAV,UAAU,CAAY;QAC9B,iBAAY,GAAZ,YAAY,CAAmB;IAC7D,CAAC;IAEJ,YAAY;QACV,IAAA,mDAAyB,EAAC;YACxB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SACzE,CAAC,CAAC;IACL,CAAC;IASD,qBAAqB;QACnB,IAAA,mDAAyB,EAAC,EAAE,CAAC,CAAC;IAChC,CAAC;CACF,CAAA;AAvBY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,2BAAgB,GAAE,CAAA;IAClB,WAAA,IAAA,iBAAQ,GAAE,CAAA;qCADwC,qBAAU;QACf,qCAAgB;GAHrD,uBAAuB,CAuBnC"}

package/dist/core/common/services/core-cron-jobs.registry.d.ts

@@ -0,0 +1,8 @@
+import type { CoreRedisService } from './core-redis.service';
+import type { Connection } from 'mongoose';
+export interface CronJobsInfrastructure {
+    connection?: Connection;
+    redisService?: CoreRedisService;
+}
+export declare function getCronJobsInfrastructure(): CronJobsInfrastructure;
+export declare function setCronJobsInfrastructure(value: CronJobsInfrastructure): void;

package/dist/core/common/services/core-cron-jobs.registry.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCronJobsInfrastructure = getCronJobsInfrastructure;
+exports.setCronJobsInfrastructure = setCronJobsInfrastructure;
+let infrastructure = {};
+function getCronJobsInfrastructure() {
+    return infrastructure;
+}
+function setCronJobsInfrastructure(value) {
+    infrastructure = value ?? {};
+}
+//# sourceMappingURL=core-cron-jobs.registry.js.map

package/dist/core/common/services/core-cron-jobs.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-cron-jobs.registry.js","sourceRoot":"","sources":["../../../../src/core/common/services/core-cron-jobs.registry.ts"],"names":[],"mappings":";;AAkCA,8DAEC;AAMD,8DAEC;AAfD,IAAI,cAAc,GAA2B,EAAE,CAAC;AAKhD,SAAgB,yBAAyB;IACvC,OAAO,cAAc,CAAC;AACxB,CAAC;AAMD,SAAgB,yBAAyB,CAAC,KAA6B;IACrE,cAAc,GAAG,KAAK,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/core/common/services/core-cron-jobs.service.d.ts

@@ -1,19 +1,49 @@
-import { OnApplicationBootstrap } from '@nestjs/common';
+import { OnApplicationBootstrap, OnApplicationShutdown } from '@nestjs/common';
 import { CronExpression, SchedulerRegistry } from '@nestjs/schedule';
 import { CronJobConfigWithTimeZone } from '../interfaces/cron-job-config-with-time-zone.interface';
 import { CronJobConfigWithUtcOffset } from '../interfaces/cron-job-config-with-utc-offset.interface';
 import { Falsy } from '../types/falsy.type';
-export declare abstract class CoreCronJobs implements OnApplicationBootstrap {
+import type { CoreRedisService } from './core-redis.service';
+import type { Redis } from 'ioredis';
+import type { Connection } from 'mongoose';
+export interface CoreCronJobsOptions {
+    connection?: Connection;
+    log?: boolean;
+    redisService?: CoreRedisService;
+}
+export declare abstract class CoreCronJobs implements OnApplicationBootstrap, OnApplicationShutdown {
     protected schedulerRegistry: SchedulerRegistry;
     protected cronJobs: Record<string, CronExpression | CronJobConfigWithTimeZone | CronJobConfigWithUtcOffset | Date | Falsy | string>;
+    protected readonly options?: CoreCronJobsOptions;
     config: {
         [key: string]: any;
         log: boolean;
     };
     runningJobs: Record<string, Date[]>;
-    protected constructor(schedulerRegistry: SchedulerRegistry, cronJobs: Record<string, CronExpression | CronJobConfigWithTimeZone | CronJobConfigWithUtcOffset | Date | Falsy | string>, options?: {
-        log?: boolean;
-    });
-    onApplicationBootstrap(): void;
-    protected initCronJobs(): void;
+    protected bullQueue?: any;
+    protected bullWorker?: any;
+    protected dedupWarned: boolean;
+    protected jobConfigs: Record<string, CronJobConfigWithTimeZone>;
+    protected leaseIndexReady?: Promise<void>;
+    protected constructor(schedulerRegistry: SchedulerRegistry, cronJobs: Record<string, CronExpression | CronJobConfigWithTimeZone | CronJobConfigWithUtcOffset | Date | Falsy | string>, options?: CoreCronJobsOptions);
+    onApplicationBootstrap(): Promise<void>;
+    onApplicationShutdown(): Promise<void>;
+    protected initCronJobs(): Promise<void>;
+    protected acquireLease(name: string, fireTime: Date | 'init' | 'manual'): Promise<boolean>;
+    protected ensureLeaseIndex(connection: Connection): Promise<void>;
+    protected getConnection(): Connection | undefined;
+    protected getRedisClient(): Redis | undefined;
+    protected getRedisService(): CoreRedisService | undefined;
+    protected importBullMq(): Promise<any>;
+    protected initBullMq(): Promise<boolean>;
+    protected drainRunningJobs(timeoutMs?: number): Promise<void>;
+    protected removeStaleBullSchedulers(active: Set<string>): Promise<void>;
+    protected startBullWorker(): void;
+    protected logSkippedTick(leaseKey: string): void;
+    protected registerBullJob(name: string, config: CronJobConfigWithTimeZone): Promise<void>;
+    protected registerLocalJob(name: string, config: CronJobConfigWithTimeZone, distributed: boolean): void;
+    protected runDistributedTick(name: string, fireTime: Date | 'init' | 'manual'): Promise<void>;
+    protected runInitTick(name: string): void;
+    protected runTick(name: string): Promise<void>;
+    protected warnDedupInactive(): void;
 }