@lenne.tech/nest-server 12.1.0 → 12.2.0

package/dist/core/common/persistence/sql/sql-errors.d.ts

@@ -11,7 +11,8 @@ export declare class QueryCastError extends Error {
 }
 export declare class DuplicateKeyError extends BadRequestException {
     readonly model: string;
+    readonly primaryKey: boolean;
     readonly name = "DuplicateKeyError";
     readonly code = 11000;
-    constructor(model: string);
+    constructor(model: string, primaryKey?: boolean);
 }

package/dist/core/common/persistence/sql/sql-errors.js

@@ -15,11 +15,13 @@ export class QueryCastError extends Error {
 }
 export class DuplicateKeyError extends BadRequestException {
     model;
+    primaryKey;
     name = 'DuplicateKeyError';
     code = 11000;
-    constructor(model) {
+    constructor(model, primaryKey = false) {
         super(`E11000 duplicate key error: a unique value of ${model} already exists`);
         this.model = model;
+        this.primaryKey = primaryKey;
     }
 }
 //# sourceMappingURL=sql-errors.js.map

package/dist/core/common/persistence/sql/sql-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"sql-errors.js","sourceRoot":"","sources":["../../../../../src/core/common/persistence/sql/sql-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAarD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5B,IAAI,GAAG,uBAAuB,CAAC;CAClD;AAMD,MAAM,OAAO,cAAe,SAAQ,KAAK;IAO5B;IACA;IAPO,IAAI,GAAG,gBAAgB,CAAC;IAK1C,YACW,IAAY,EACZ,IAAY,EACrB,KAAe;QAEf,KAAK,CAAC,WAAW,IAAI,oBAAoB,IAAI,GAAG,CAAC,CAAC;QAJzC,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAQ;QAIrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAMD,MAAM,OAAO,iBAAkB,SAAQ,mBAAmB;IAInC;IAHH,IAAI,GAAG,mBAAmB,CAAC;IACpC,IAAI,GAAG,KAAK,CAAC;IAEtB,YAAqB,KAAa;QAChC,KAAK,CAAC,iDAAiD,KAAK,iBAAiB,CAAC,CAAC;QAD5D,UAAK,GAAL,KAAK,CAAQ;IAElC,CAAC;CACF"}
+{"version":3,"file":"sql-errors.js","sourceRoot":"","sources":["../../../../../src/core/common/persistence/sql/sql-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAarD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5B,IAAI,GAAG,uBAAuB,CAAC;CAClD;AAMD,MAAM,OAAO,cAAe,SAAQ,KAAK;IAO5B;IACA;IAPO,IAAI,GAAG,gBAAgB,CAAC;IAK1C,YACW,IAAY,EACZ,IAAY,EACrB,KAAe;QAEf,KAAK,CAAC,WAAW,IAAI,oBAAoB,IAAI,GAAG,CAAC,CAAC;QAJzC,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAQ;QAIrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAMD,MAAM,OAAO,iBAAkB,SAAQ,mBAAmB;IAM7C;IACA;IANO,IAAI,GAAG,mBAAmB,CAAC;IACpC,IAAI,GAAG,KAAK,CAAC;IAGtB,YACW,KAAa,EACb,aAAa,KAAK;QAE3B,KAAK,CAAC,iDAAiD,KAAK,iBAAiB,CAAC,CAAC;QAHtE,UAAK,GAAL,KAAK,CAAQ;QACb,eAAU,GAAV,UAAU,CAAQ;IAG7B,CAAC;CACF"}

package/dist/core/common/persistence/sync-access.registry.d.ts

@@ -0,0 +1,17 @@
+export interface SyncRecordMove {
+    model: string;
+    tenantId?: string;
+    tenantChanged: boolean;
+    usersLost: string[];
+}
+export interface SyncRecordChange {
+    model: string;
+    tenantIds: string[];
+}
+export interface SyncAccessListener {
+    recordChanged?(change: SyncRecordChange): void;
+    recordMoved(move: SyncRecordMove): Promise<void>;
+    tenantInvalidated(tenantId: string): Promise<void>;
+}
+export declare function setSyncAccessListener(value: SyncAccessListener | undefined): void;
+export declare function getSyncAccessListener(): SyncAccessListener | undefined;

package/dist/core/common/persistence/sync-access.registry.js

@@ -0,0 +1,8 @@
+let listener;
+export function setSyncAccessListener(value) {
+    listener = value;
+}
+export function getSyncAccessListener() {
+    return listener;
+}
+//# sourceMappingURL=sync-access.registry.js.map

package/dist/core/common/persistence/sync-access.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-access.registry.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/sync-access.registry.ts"],"names":[],"mappings":"AAwCA,IAAI,QAAwC,CAAC;AAG7C,MAAM,UAAU,qBAAqB,CAAC,KAAqC;IACzE,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/common/persistence/sync-model.d.ts

@@ -0,0 +1,29 @@
+import type { IndexDescriptor, ModelDescriptor, SyncDescriptor, SyncIdFormat } from './model-descriptor.interface.js';
+export type { SyncDescriptor, SyncIdFormat } from './model-descriptor.interface.js';
+export type SyncConflictStrategy = 'custom' | 'lww' | 'merge' | 'reject';
+export interface SyncOperationRoles {
+    create?: string[];
+    delete?: string[];
+    pull?: string[];
+    update?: string[];
+}
+export interface SyncModelOptions {
+    idFormat?: SyncIdFormat;
+    roles?: SyncOperationRoles;
+    scope?: string[];
+    strategy?: SyncConflictStrategy;
+}
+export declare const SYNC_VERSION_FIELD = "version";
+export declare const SYNC_DELETED_FIELD = "deletedAt";
+export declare const SYNC_CLOCK_FIELD = "syncAt";
+export declare const SYNC_SEQUENCE_FIELD = "syncSeq";
+export declare const SYNC_SEQUENCE_PENDING = -1;
+export declare const SYNC_SYSTEM_FIELDS: readonly string[];
+export declare function liveFilter(): {
+    deletedAt: null;
+};
+export declare function resolveSyncOptions(value: boolean | SyncModelOptions | undefined, model: string): SyncDescriptor | undefined;
+export declare function withSyncDescriptor(descriptor: ModelDescriptor, sync: SyncDescriptor): ModelDescriptor;
+export declare function liveUniqueIndex(index: IndexDescriptor): IndexDescriptor;
+export declare function withSequenceField(descriptor: ModelDescriptor): ModelDescriptor;
+export declare function isLiveFilter(filter: unknown): boolean;

package/dist/core/common/persistence/sync-model.js

@@ -0,0 +1,138 @@
+const SYNC_STRATEGIES = ['custom', 'lww', 'merge', 'reject'];
+const SYNC_OPERATIONS = ['create', 'delete', 'pull', 'update'];
+export const SYNC_VERSION_FIELD = 'version';
+export const SYNC_DELETED_FIELD = 'deletedAt';
+export const SYNC_CLOCK_FIELD = 'syncAt';
+export const SYNC_SEQUENCE_FIELD = 'syncSeq';
+export const SYNC_SEQUENCE_PENDING = -1;
+export const SYNC_SYSTEM_FIELDS = Object.freeze([
+    SYNC_VERSION_FIELD,
+    SYNC_DELETED_FIELD,
+    SYNC_CLOCK_FIELD,
+    SYNC_SEQUENCE_FIELD,
+]);
+export function liveFilter() {
+    return { [SYNC_DELETED_FIELD]: null };
+}
+export function resolveSyncOptions(value, model) {
+    if (value === undefined || value === false) {
+        return undefined;
+    }
+    const options = value === true ? {} : value;
+    if (!options || typeof options !== 'object') {
+        throw new Error(`@PersistedModel(${model}): sync must be true or an options object`);
+    }
+    const idFormat = options.idFormat ?? 'objectId';
+    if (idFormat !== 'objectId' && idFormat !== 'uuidv7') {
+        throw new Error(`@PersistedModel(${model}): sync.idFormat must be 'objectId' or 'uuidv7', got ${JSON.stringify(idFormat)}`);
+    }
+    const scope = options.scope ?? [];
+    if (!Array.isArray(scope) || scope.some((field) => typeof field !== 'string' || !field)) {
+        throw new Error(`@PersistedModel(${model}): sync.scope must be a list of field names`);
+    }
+    if (options.strategy !== undefined && !SYNC_STRATEGIES.includes(options.strategy)) {
+        throw new Error(`@PersistedModel(${model}): sync.strategy must be one of ${SYNC_STRATEGIES.join(', ')}, got ${JSON.stringify(options.strategy)}`);
+    }
+    if (options.roles !== undefined) {
+        const roles = options.roles;
+        const invalid = !roles ||
+            typeof roles !== 'object' ||
+            Object.entries(roles).some(([operation, list]) => !SYNC_OPERATIONS.includes(operation) ||
+                !Array.isArray(list) ||
+                list.some((role) => typeof role !== 'string' || !role));
+        if (invalid) {
+            throw new Error(`@PersistedModel(${model}): sync.roles maps ${SYNC_OPERATIONS.join(', ')} to lists of role names`);
+        }
+    }
+    return { idFormat, scope: Object.freeze([...scope]) };
+}
+export function withSyncDescriptor(descriptor, sync) {
+    const name = descriptor.name;
+    for (const field of SYNC_SYSTEM_FIELDS) {
+        if (descriptor.fields[field]) {
+            throw new Error(`${name}: "${field}" is reserved on a synchronized model — rename the field`);
+        }
+    }
+    for (const field of sync.scope) {
+        if (!descriptor.fields[field]) {
+            throw new Error(`${name}: sync.scope names "${field}", which the model does not declare`);
+        }
+    }
+    const nestedUnique = descriptor.indexes.find((index) => index.options.unique === true && Object.keys(index.fields).some((path) => path.includes('.')));
+    if (nestedUnique) {
+        throw new Error(`${name}: a unique index inside an embedded object (${JSON.stringify(nestedUnique.fields)}) is not supported on a ` +
+            'synchronized model — declare the unique field on the model itself');
+    }
+    if (descriptor.indexes.some((index) => 'expireAfterSeconds' in index.options) ||
+        Object.values(descriptor.fields).some((field) => field.expiresAfterSeconds !== undefined)) {
+        throw new Error(`${name}: a synchronized model cannot expire records (TTL) — an expired record disappears without a tombstone, ` +
+            'and every client keeps it');
+    }
+    const fields = { ...descriptor.fields };
+    if (sync.idFormat === 'uuidv7' && fields._id) {
+        fields._id = { ...fields._id, kind: 'uuid' };
+    }
+    fields[SYNC_VERSION_FIELD] = systemField(SYNC_VERSION_FIELD, 'number', 1);
+    fields[SYNC_DELETED_FIELD] = systemField(SYNC_DELETED_FIELD, 'date', null);
+    return {
+        ...descriptor,
+        fields,
+        indexes: descriptor.indexes.map((index) => liveUniqueIndex(index)),
+        sync,
+    };
+}
+export function liveUniqueIndex(index) {
+    if (index.options.unique !== true) {
+        return index;
+    }
+    const { sparse, ...options } = index.options;
+    const existing = options.partialFilterExpression ?? {};
+    const exists = sparse === true ? Object.fromEntries(Object.keys(index.fields).map((path) => [path, { $exists: true }])) : {};
+    return {
+        fields: { ...index.fields },
+        options: { ...options, partialFilterExpression: { ...existing, ...exists, ...liveFilter() } },
+    };
+}
+export function withSequenceField(descriptor) {
+    if (!descriptor.sync || descriptor.fields[SYNC_SEQUENCE_FIELD]) {
+        return descriptor;
+    }
+    const field = systemField(SYNC_SEQUENCE_FIELD, 'bigint', undefined);
+    return {
+        ...descriptor,
+        fields: { ...descriptor.fields, [SYNC_SEQUENCE_FIELD]: field },
+        indexes: [
+            ...descriptor.indexes,
+            {
+                fields: descriptor.tenantScoped ? { tenantId: 1, [SYNC_SEQUENCE_FIELD]: 1 } : { [SYNC_SEQUENCE_FIELD]: 1 },
+                options: {},
+            },
+        ],
+    };
+}
+export function isLiveFilter(filter) {
+    if (!filter || typeof filter !== 'object') {
+        return false;
+    }
+    const keys = Object.keys(filter);
+    return (keys.length === 1 &&
+        keys[0] === SYNC_DELETED_FIELD &&
+        filter[SYNC_DELETED_FIELD] === null);
+}
+function systemField(name, kind, value) {
+    return {
+        ...(value === undefined ? {} : { default: value }),
+        hasDefault: value !== undefined,
+        index: false,
+        isArray: false,
+        kind,
+        lowercase: false,
+        name,
+        required: false,
+        select: true,
+        sparse: false,
+        trim: false,
+        unique: false,
+    };
+}
+//# sourceMappingURL=sync-model.js.map

package/dist/core/common/persistence/sync-model.js.map

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

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

@@ -1,8 +1,10 @@
 import { OnApplicationBootstrap, OnApplicationShutdown } from '@nestjs/common';
 import { CronExpression, SchedulerRegistry } from '@nestjs/schedule';
+import { CronJob } from 'cron';
 import { CronJobConfigWithTimeZone } from '../interfaces/cron-job-config-with-time-zone.interface.js';
 import { CronJobConfigWithUtcOffset } from '../interfaces/cron-job-config-with-utc-offset.interface.js';
 import { Falsy } from '../types/falsy.type.js';
+import type { LockStore } from '../persistence/lock-store.interface.js';
 import type { CoreRedisService } from './core-redis.service.js';
 import type { Redis } from 'ioredis';
 import type { Connection } from 'mongoose';
@@ -20,12 +22,19 @@ export declare abstract class CoreCronJobs implements OnApplicationBootstrap, On
         log: boolean;
     };
     runningJobs: Record<string, Date[]>;
+    protected bullJobOptions: Record<string, unknown>;
     protected bullQueue?: any;
+    protected bullQueueConnection?: any;
+    protected bullScheduledJobs: Set<string>;
+    protected bullSchedulerCheck?: Promise<void>;
+    protected bullSchedulerCheckIntervalMs: number;
+    protected bullSchedulerCheckTimer?: ReturnType<typeof setInterval>;
     protected bullWorker?: any;
     protected dedupWarned: boolean;
     protected jobConfigs: Record<string, CronJobConfigWithTimeZone>;
     protected leaseIndexReady?: Promise<void>;
     protected readonly leaseOwner: string;
+    protected readonly onBullQueueReady: () => void;
     protected constructor(schedulerRegistry: SchedulerRegistry, cronJobs: Record<string, CronExpression | CronJobConfigWithTimeZone | CronJobConfigWithUtcOffset | Date | Falsy | string>, options?: CoreCronJobsOptions);
     onApplicationBootstrap(): Promise<void>;
     onApplicationShutdown(): Promise<void>;
@@ -38,13 +47,31 @@ export declare abstract class CoreCronJobs implements OnApplicationBootstrap, On
     protected importBullMq(): Promise<any>;
     protected initBullMq(): Promise<boolean>;
     protected drainRunningJobs(timeoutMs?: number): Promise<void>;
+    protected trimBullJobBacklog(): Promise<void>;
     protected removeStaleBullSchedulers(active: Set<string>): Promise<void>;
+    protected restoreBullSchedulers(): Promise<void>;
+    protected listBullSchedulerKeys(): Promise<Set<string> | undefined>;
+    protected bullSchedulerRemovedKey(name: string): string | undefined;
+    protected isBullSchedulerRemoved(name: string): Promise<boolean>;
+    protected markBullSchedulerRemoved(name: string): Promise<void>;
+    protected startBullSchedulerCheck(): void;
+    protected stopBullSchedulerCheck(): void;
     protected startBullWorker(): void;
     protected logSkippedTick(leaseKey: string): void;
     protected registerBullJob(name: string, config: CronJobConfigWithTimeZone): Promise<void>;
+    protected upsertBullScheduler(name: string, config: CronJobConfigWithTimeZone): Promise<unknown>;
     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 runsExclusively(config: CronJobConfigWithTimeZone): boolean;
+    protected acquireRunningLease(name: string): Promise<false | {
+        release: () => Promise<void>;
+    }>;
+    protected leaseStore(): Promise<LockStore | undefined>;
+    protected redisLeaseStore(redis: Redis): LockStore;
+    protected currentScheduledInstant(job: CronJob, remembered: number, fired: number): number;
+    protected nextScheduledInstant(job: CronJob): number | undefined;
+    protected logLocalJobsHint(names: string[]): void;
     protected warnDedupInactive(): void;
 }