@lenne.tech/nest-server 11.43.3 → 12.1.0

package/dist/core/common/persistence/mongo/mongoose-compat.js

@@ -0,0 +1,65 @@
+import { Inject } from '@nestjs/common';
+import { HexObjectId } from './hex-object-id.js';
+import { DeclaredSchema, declaredSchema, markRaw, recordModelDeclaration, recordPropDeclaration, } from './model-declarations.js';
+import { optionalMongoPackages, requireMongoPackages } from './mongo-packages.js';
+export const DEFAULT_CONNECTION_NAME = 'DatabaseConnection';
+export function getConnectionToken(name) {
+    return name && name !== DEFAULT_CONNECTION_NAME ? `${name}Connection` : DEFAULT_CONNECTION_NAME;
+}
+export function getModelToken(model, connectionName) {
+    return connectionName === undefined ? `${model}Model` : `${getConnectionToken(connectionName)}/${model}Model`;
+}
+export function InjectModel(model, connectionName) {
+    return Inject(getModelToken(model, connectionName));
+}
+export function InjectConnection(name) {
+    return Inject(getConnectionToken(name));
+}
+export function Schema(options) {
+    return (target) => {
+        recordModelDeclaration(target, options);
+        optionalMongoPackages()?.nestMongoose.Schema(options)(target);
+    };
+}
+export function Prop(options) {
+    return (target, propertyKey) => {
+        recordPropDeclaration(target, propertyKey, options);
+        optionalMongoPackages()?.nestMongoose.Prop(options)(target, propertyKey);
+    };
+}
+export function raw(definition) {
+    const packages = optionalMongoPackages();
+    return packages ? packages.nestMongoose.raw(definition) : markRaw(definition);
+}
+export const SchemaFactory = {
+    createForClass(target) {
+        const packages = optionalMongoPackages();
+        return packages ? packages.nestMongoose.SchemaFactory.createForClass(target) : declaredSchema(target);
+    },
+};
+export function createSchema(definition, options = {}) {
+    const packages = optionalMongoPackages();
+    return packages
+        ? new packages.mongoose.Schema(definition, options)
+        : new DeclaredSchema({ definition: { ...definition }, options: { ...options } });
+}
+export function objectIdType() {
+    return optionalMongoPackages()?.mongoose.Schema.Types.ObjectId ?? HexObjectId;
+}
+export function newObjectId(value) {
+    const packages = optionalMongoPackages();
+    return packages ? new packages.mongoose.Types.ObjectId(value) : new HexObjectId(value);
+}
+export function isValidObjectId(value) {
+    const packages = optionalMongoPackages();
+    return packages ? packages.mongoose.Types.ObjectId.isValid(value) : HexObjectId.isValid(value);
+}
+export function isMongooseQuery(value) {
+    const Query = optionalMongoPackages()?.mongoose.Query;
+    return !!Query && value instanceof Query;
+}
+export function createGridFsBucket(db, options) {
+    const { mongodb } = requireMongoPackages('GridFS (file.storage: gridfs)');
+    return new mongodb.GridFSBucket(db, options);
+}
+//# sourceMappingURL=mongoose-compat.js.map

package/dist/core/common/persistence/mongo/mongoose-compat.js.map

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

package/dist/core/common/persistence/mongo/no-mongo-connection.module.d.ts

@@ -0,0 +1,2 @@
+export declare class NoMongoConnectionModule {
+}

package/dist/core/common/persistence/mongo/no-mongo-connection.module.js

@@ -0,0 +1,19 @@
+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;
+};
+import { Global, Module } from '@nestjs/common';
+import { getConnectionToken } from './mongoose-compat.js';
+let NoMongoConnectionModule = class NoMongoConnectionModule {
+};
+NoMongoConnectionModule = __decorate([
+    Global(),
+    Module({
+        exports: [getConnectionToken()],
+        providers: [{ provide: getConnectionToken(), useValue: null }],
+    })
+], NoMongoConnectionModule);
+export { NoMongoConnectionModule };
+//# sourceMappingURL=no-mongo-connection.module.js.map

package/dist/core/common/persistence/mongo/no-mongo-connection.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-mongo-connection.module.js","sourceRoot":"","sources":["../../../../../src/core/common/persistence/mongo/no-mongo-connection.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAenD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAAG,CAAA;AAA1B,uBAAuB;IALnC,MAAM,EAAE;IACR,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,kBAAkB,EAAE,CAAC;QAC/B,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC/D,CAAC;GACW,uBAAuB,CAAG"}

package/dist/core/common/persistence/mongo-lock-store.d.ts

@@ -0,0 +1,21 @@
+import type { Collection } from 'mongodb';
+import type { LockStore } from './lock-store.interface.js';
+export interface MongoLockStoreOptions {
+    keyField?: string;
+    legacyTimestamp?: {
+        field: string;
+        staleAfterMs: number;
+    };
+}
+export declare class MongoLockStore implements LockStore {
+    protected readonly collection: Collection<any>;
+    protected readonly options: MongoLockStoreOptions;
+    protected readonly keyField: string;
+    private keyIndex?;
+    constructor(collection: Collection<any>, options?: MongoLockStoreOptions);
+    release(key: string, owner: string): Promise<boolean>;
+    renew(key: string, owner: string, ttlSeconds: number): Promise<boolean>;
+    tryAcquire(key: string, owner: string, ttlSeconds: number): Promise<boolean>;
+    private legacyStamp;
+    private ensureKeyIndex;
+}

package/dist/core/common/persistence/mongo-lock-store.js

@@ -0,0 +1,72 @@
+const DUPLICATE_KEY = 11000;
+export class MongoLockStore {
+    collection;
+    options;
+    keyField;
+    keyIndex;
+    constructor(collection, options = {}) {
+        this.collection = collection;
+        this.options = options;
+        this.keyField = options.keyField ?? '_id';
+    }
+    async release(key, owner) {
+        const result = await this.collection.deleteOne({ [this.keyField]: key, owner });
+        return result.deletedCount === 1;
+    }
+    async renew(key, owner, ttlSeconds) {
+        const now = new Date();
+        const result = await this.collection.updateOne({ [this.keyField]: key, expiresAt: { $gt: now }, owner }, { $set: { ...this.legacyStamp(now), expiresAt: new Date(now.getTime() + ttlSeconds * 1000) } });
+        return result.matchedCount === 1;
+    }
+    async tryAcquire(key, owner, ttlSeconds) {
+        await this.ensureKeyIndex();
+        const now = new Date();
+        const legacy = this.options.legacyTimestamp;
+        const expired = legacy
+            ? {
+                $or: [
+                    { expiresAt: { $lte: now } },
+                    {
+                        expiresAt: { $exists: false },
+                        [legacy.field]: { $lt: new Date(now.getTime() - legacy.staleAfterMs) },
+                    },
+                ],
+            }
+            : { expiresAt: { $lte: now } };
+        try {
+            await this.collection.updateOne({ [this.keyField]: key, ...expired }, {
+                $set: {
+                    ...(this.keyField === '_id' ? {} : { [this.keyField]: key }),
+                    ...this.legacyStamp(now),
+                    acquiredAt: now,
+                    expiresAt: new Date(now.getTime() + ttlSeconds * 1000),
+                    owner,
+                },
+            }, { upsert: true });
+            return true;
+        }
+        catch (error) {
+            if (error?.code !== DUPLICATE_KEY) {
+                throw error;
+            }
+            if (legacy) {
+                await this.collection.updateOne({ [this.keyField]: key, expiresAt: { $exists: false }, [legacy.field]: { $exists: false } }, { $set: { [legacy.field]: now } });
+            }
+            return false;
+        }
+    }
+    legacyStamp(now) {
+        return this.options.legacyTimestamp ? { [this.options.legacyTimestamp.field]: now } : {};
+    }
+    async ensureKeyIndex() {
+        if (this.keyField === '_id') {
+            return;
+        }
+        this.keyIndex ??= this.collection.createIndex({ [this.keyField]: 1 }, { unique: true }).catch((error) => {
+            this.keyIndex = undefined;
+            throw error;
+        });
+        await this.keyIndex;
+    }
+}
+//# sourceMappingURL=mongo-lock-store.js.map

package/dist/core/common/persistence/mongo-lock-store.js.map

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

package/dist/core/common/persistence/mongoose-data-store.d.ts

@@ -0,0 +1,33 @@
+import { Logger } from '@nestjs/common';
+import type { Model } from 'mongoose';
+import type { DataStore, DataStoreUpdate, FindOptions, PushOptions, StoreCapabilities, StoredRecord, UpdateOptions, Where } from './data-store.interface.js';
+export declare const MONGOOSE_STORE_CAPABILITIES: Readonly<StoreCapabilities>;
+export declare class MongooseDataStore<T = Record<string, any>> implements DataStore<T> {
+    protected readonly model: Model<any>;
+    readonly capabilities: Readonly<StoreCapabilities>;
+    readonly driver = "mongodb";
+    protected readonly logger: Logger;
+    constructor(model: Model<any>);
+    get modelName(): string;
+    count(where?: Where<T>): Promise<number>;
+    sum(field: string, where?: Where<T>): Promise<{
+        count: number;
+        sum: number;
+    }>;
+    deleteById(id: string): Promise<null | StoredRecord<T>>;
+    deleteMany(where: Where<T>): Promise<number>;
+    deleteOne(where: Where<T>): Promise<null | StoredRecord<T>>;
+    distinct(field: string, where?: Where<T>): Promise<unknown[]>;
+    find(where?: Where<T>, options?: FindOptions): Promise<StoredRecord<T>[]>;
+    findById(id: string, options?: Pick<FindOptions, 'exclude' | 'select'>): Promise<null | StoredRecord<T>>;
+    findOne(where: Where<T>, options?: Omit<FindOptions, 'limit' | 'skip'>): Promise<null | StoredRecord<T>>;
+    insert(record: Partial<T>): Promise<StoredRecord<T>>;
+    native<N = unknown>(reason: string): N;
+    pullFromArray(id: string, field: string, condition: unknown): Promise<void>;
+    pushToArray(id: string, field: string, items: readonly unknown[], options?: PushOptions): Promise<void>;
+    raw<N = unknown>(reason: string): N;
+    updateById(id: string, update: DataStoreUpdate<T>, options?: UpdateOptions): Promise<null | StoredRecord<T>>;
+    updateMany(where: Where<T>, update: DataStoreUpdate<T>): Promise<number>;
+    updateOne(where: Where<T>, update: DataStoreUpdate<T>): Promise<null | StoredRecord<T>>;
+}
+export declare function toMongoFilter(where: undefined | Where<any>): Record<string, any>;

package/dist/core/common/persistence/mongoose-data-store.js

@@ -0,0 +1,187 @@
+import { Logger } from '@nestjs/common';
+import { getStringIds } from '../helpers/id.helper.js';
+import { assertAccessReason, assertArrayField, assertProjection, assertSampleSize, assertSelectFields, } from './store-guards.js';
+export const MONGOOSE_STORE_CAPABILITIES = Object.freeze({
+    aggregatePipeline: true,
+    changeFeed: false,
+    gridfs: true,
+    idType: 'objectId',
+    mongoosePopulate: true,
+    rawFilterArm: true,
+    rls: false,
+    textSearch: true,
+    transactions: false,
+});
+export class MongooseDataStore {
+    model;
+    capabilities = MONGOOSE_STORE_CAPABILITIES;
+    driver = 'mongodb';
+    logger = new Logger(MongooseDataStore.name);
+    constructor(model) {
+        this.model = model;
+    }
+    get modelName() {
+        return this.model.modelName;
+    }
+    async count(where) {
+        return this.model.countDocuments(toMongoFilter(where)).exec();
+    }
+    async sum(field, where) {
+        assertSelectFields([field]);
+        const match = this.model.find().cast(this.model, toMongoFilter(where));
+        const [row] = await this.model
+            .aggregate([
+            { $match: match },
+            { $group: { _id: null, count: { $sum: 1 }, sum: { $sum: { $ifNull: [`$${field}`, 0] } } } },
+        ])
+            .exec();
+        return { count: row?.count ?? 0, sum: row?.sum ?? 0 };
+    }
+    async deleteById(id) {
+        return toRecord(await this.model.findByIdAndDelete(id).lean().exec());
+    }
+    async deleteMany(where) {
+        const result = await this.model.deleteMany(toMongoFilter(where)).exec();
+        return result.deletedCount;
+    }
+    async deleteOne(where) {
+        return toRecord(await this.model.findOneAndDelete(toMongoFilter(where)).lean().exec());
+    }
+    async distinct(field, where) {
+        return this.model.distinct(field, toMongoFilter(where)).exec();
+    }
+    async find(where, options = {}) {
+        const sample = options.sample === undefined ? undefined : assertSampleSize(options.sample);
+        let query = this.model.find(toMongoFilter(where));
+        if (options.select || options.exclude)
+            query = query.select(toProjection(options));
+        if (options.sort)
+            query = query.sort(options.sort);
+        if (options.skip !== undefined)
+            query = query.skip(options.skip);
+        if (options.limit !== undefined)
+            query = query.limit(options.limit);
+        if (options.collation)
+            query = query.collation(options.collation);
+        const docs = await query.lean().exec();
+        const records = docs.map((doc) => toRecord(doc));
+        return sample === undefined ? records : randomSample(records, sample);
+    }
+    async findById(id, options = {}) {
+        let query = this.model.findById(id);
+        if (options.select || options.exclude)
+            query = query.select(toProjection(options));
+        return toRecord(await query.lean().exec());
+    }
+    async findOne(where, options = {}) {
+        let query = this.model.findOne(toMongoFilter(where));
+        if (options.select || options.exclude)
+            query = query.select(toProjection(options));
+        if (options.sort)
+            query = query.sort(options.sort);
+        if (options.collation)
+            query = query.collation(options.collation);
+        return toRecord(await query.lean().exec());
+    }
+    async insert(record) {
+        const created = await this.model.create(record);
+        return toRecord(created.toObject());
+    }
+    native(reason) {
+        assertAccessReason(reason, 'native');
+        this.logger.debug(`Native model access: ${reason} (Model: ${this.modelName})`);
+        return this.model;
+    }
+    async pullFromArray(id, field, condition) {
+        assertArrayField(field, 'pullFromArray');
+        await this.model
+            .findByIdAndUpdate(id, { $pull: { [field]: condition } })
+            .lean()
+            .exec();
+    }
+    async pushToArray(id, field, items, options = {}) {
+        assertArrayField(field, 'pushToArray');
+        if (!items.length) {
+            return;
+        }
+        const push = { $each: [...items] };
+        if (options.slice !== undefined)
+            push.$slice = options.slice;
+        if (options.position !== undefined)
+            push.$position = options.position;
+        if (options.sort)
+            push.$sort = options.sort;
+        await this.model
+            .findByIdAndUpdate(id, { $push: { [field]: push } })
+            .lean()
+            .exec();
+    }
+    raw(reason) {
+        assertAccessReason(reason, 'raw');
+        this.logger.warn(`[SECURITY] Native collection access: ${reason} (Model: ${this.modelName})`);
+        return this.model.collection;
+    }
+    async updateById(id, update, options = {}) {
+        const updated = await this.model
+            .findByIdAndUpdate(id, update, {
+            returnDocument: 'after',
+            ...(options.timestamps === false ? { timestamps: false } : {}),
+        })
+            .lean()
+            .exec();
+        return toRecord(updated);
+    }
+    async updateMany(where, update) {
+        const result = await this.model.updateMany(toMongoFilter(where), update).exec();
+        return result.matchedCount;
+    }
+    async updateOne(where, update) {
+        const updated = await this.model
+            .findOneAndUpdate(toMongoFilter(where), update, { returnDocument: 'after' })
+            .lean()
+            .exec();
+        return toRecord(updated);
+    }
+}
+export function toMongoFilter(where) {
+    if (!where) {
+        return {};
+    }
+    const filter = {};
+    for (const [key, value] of Object.entries(where)) {
+        if (key === 'id') {
+            filter._id = value;
+        }
+        else if ((key === '$and' || key === '$or' || key === '$nor') && Array.isArray(value)) {
+            filter[key] = value.map((entry) => toMongoFilter(entry));
+        }
+        else {
+            filter[key] = value;
+        }
+    }
+    return filter;
+}
+function toRecord(doc) {
+    if (!doc) {
+        return null;
+    }
+    const { __v: _version, _id, ...fields } = doc;
+    return { ...fields, id: _id === undefined ? fields.id : getStringIds(_id) };
+}
+function toProjection(options) {
+    assertProjection(options);
+    if (options.exclude?.length) {
+        return options.exclude.map((field) => `-${field}`).join(' ');
+    }
+    return (options.select ?? []).map((field) => (field === 'id' ? '_id' : field)).join(' ');
+}
+function randomSample(items, size) {
+    const pool = [...items];
+    const count = Math.min(size, pool.length);
+    for (let index = 0; index < count; index++) {
+        const pick = index + Math.floor(Math.random() * (pool.length - index));
+        [pool[index], pool[pick]] = [pool[pick], pool[index]];
+    }
+    return pool.slice(0, count);
+}
+//# sourceMappingURL=mongoose-data-store.js.map

package/dist/core/common/persistence/mongoose-data-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-data-store.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/mongoose-data-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAa3B,MAAM,CAAC,MAAM,2BAA2B,GAAgC,MAAM,CAAC,MAAM,CAAC;IACpF,iBAAiB,EAAE,IAAI;IACvB,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,UAAU;IAClB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,GAAG,EAAE,KAAK;IACV,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,KAAK;CACpB,CAAC,CAAC;AAUH,MAAM,OAAO,iBAAiB;IAKG;IAJtB,YAAY,GAAG,2BAA2B,CAAC;IAC3C,MAAM,GAAG,SAAS,CAAC;IACT,MAAM,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE/D,YAA+B,KAAiB;QAAjB,UAAK,GAAL,KAAK,CAAY;IAAG,CAAC;IAEpD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAgB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,KAAgB;QACvC,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK;aAC3B,SAAS,CAAiC;YACzC,EAAE,MAAM,EAAE,KAAK,EAAE;YACjB,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;SAC5F,CAAC;aACD,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,QAAQ,CAAI,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxE,OAAO,MAAM,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAe;QAC7B,OAAO,QAAQ,CAAI,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,KAAgB;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAgB,EAAE,UAAuB,EAAE;QACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3F,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACnF,IAAI,OAAO,CAAC,IAAI;YAAE,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,OAAO,CAAC,SAAS;YAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,SAAgB,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,OAAO,GAAI,IAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAI,GAAG,CAAC,CAAC,CAAC;QAGnE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,UAAmD,EAAE;QAC9E,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACnF,OAAO,QAAQ,CAAI,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAe,EAAE,UAA+C,EAAE;QAC9E,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACnF,IAAI,OAAO,CAAC,IAAI;YAAE,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,SAAS;YAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,SAAgB,CAAC,CAAC;QACzE,OAAO,QAAQ,CAAI,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAkB;QAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAc,MAAc;QAChC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,YAAY,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,KAAqB,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAU,EAAE,KAAa,EAAE,SAAkB;QAC/D,gBAAgB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,KAAK;aACb,iBAAiB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,EAAS,CAAC;aAC/D,IAAI,EAAE;aACN,IAAI,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,KAAa,EAAE,KAAyB,EAAE,UAAuB,EAAE;QAC/F,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;QAC5D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7D,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;QACtE,IAAI,OAAO,CAAC,IAAI;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;QAC5C,MAAM,IAAI,CAAC,KAAK;aACb,iBAAiB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAS,CAAC;aAC1D,IAAI,EAAE;aACN,IAAI,EAAE,CAAC;IACZ,CAAC;IAED,GAAG,CAAc,MAAc;QAC7B,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,MAAM,YAAY,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,KAAK,CAAC,UAA0B,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,UAAU,CACd,EAAU,EACV,MAA0B,EAC1B,UAAyB,EAAE;QAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;aAC7B,iBAAiB,CAAC,EAAE,EAAE,MAAa,EAAE;YACpC,cAAc,EAAE,OAAO;YACvB,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC;aACD,IAAI,EAAE;aACN,IAAI,EAAE,CAAC;QACV,OAAO,QAAQ,CAAI,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe,EAAE,MAA0B;QAC1D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,MAAa,CAAC,CAAC,IAAI,EAAE,CAAC;QACvF,OAAO,MAAM,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAe,EAAE,MAA0B;QACzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;aAC7B,gBAAgB,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,MAAa,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;aAClF,IAAI,EAAE;aACN,IAAI,EAAE,CAAC;QACV,OAAO,QAAQ,CAAI,OAAO,CAAC,CAAC;IAC9B,CAAC;CACF;AAGD,MAAM,UAAU,aAAa,CAAC,KAA6B;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvF,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,SAAS,QAAQ,CAAI,GAAY;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,GAA0B,CAAC;IACrE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAqB,CAAC;AACjG,CAAC;AAED,SAAS,YAAY,CAAC,OAAgD;IACpE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3F,CAAC;AAGD,SAAS,YAAY,CAAI,KAAU,EAAE,IAAY;IAC/C,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/core/common/persistence/neutral-populate.d.ts

@@ -0,0 +1,6 @@
+export interface NeutralPopulateOption {
+    model?: unknown;
+    path: string;
+    populate?: unknown;
+}
+export declare function populateNeutral(data: unknown, options: ReadonlyArray<NeutralPopulateOption | string>, modelName: string): Promise<void>;

package/dist/core/common/persistence/neutral-populate.js

@@ -0,0 +1,72 @@
+import { Logger } from '@nestjs/common';
+import { isObjectIdLike } from '../helpers/id.helper.js';
+import { getModelDescriptor } from './model-metadata.registry.js';
+import { getRegisteredDataStore } from './persistence-runtime.registry.js';
+const logger = new Logger('NeutralPopulate');
+export async function populateNeutral(data, options, modelName) {
+    const records = (Array.isArray(data) ? data : [data]).filter((record) => !!record && typeof record === 'object');
+    if (!records.length || !options.length) {
+        return;
+    }
+    const descriptor = getModelDescriptor(modelName);
+    for (const option of options) {
+        const entry = typeof option === 'string' ? { path: option } : option;
+        for (const path of String(entry.path ?? '')
+            .split(/\s+/)
+            .filter(Boolean)) {
+            const field = descriptor?.fields[path];
+            const target = typeof entry.model === 'string' ? entry.model : field?.ref;
+            if (!field || field.kind !== 'ref' || !target) {
+                continue;
+            }
+            const store = getRegisteredDataStore(target);
+            if (!store) {
+                logger.debug(`${modelName}.${path}: no store is registered for "${target}", the reference stays an id`);
+                continue;
+            }
+            const ids = new Set();
+            for (const record of records) {
+                for (const id of idsOf(record[path])) {
+                    ids.add(id);
+                }
+            }
+            if (!ids.size) {
+                continue;
+            }
+            const loaded = await store.find({ id: { $in: [...ids] } });
+            if (entry.populate) {
+                await populateNeutral(loaded, toList(entry.populate), target);
+            }
+            const byId = new Map(loaded.map((item) => [String(item.id), item]));
+            for (const record of records) {
+                const value = record[path];
+                if (Array.isArray(value)) {
+                    record[path] = value.map((item) => byId.get(idOf(item))).filter((item) => item !== undefined);
+                }
+                else if (value !== undefined && value !== null) {
+                    record[path] = byId.get(idOf(value)) ?? null;
+                }
+            }
+        }
+    }
+}
+function toList(populate) {
+    return (Array.isArray(populate) ? populate : [populate]);
+}
+function idOf(value) {
+    if (isObjectIdLike(value)) {
+        return value.toHexString();
+    }
+    if (value && typeof value === 'object') {
+        const nested = value.id ?? value._id;
+        return String(nested ?? value);
+    }
+    return String(value);
+}
+function idsOf(value) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    return (Array.isArray(value) ? value : [value]).filter((item) => item !== undefined && item !== null).map(idOf);
+}
+//# sourceMappingURL=neutral-populate.js.map

package/dist/core/common/persistence/neutral-populate.js.map

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

package/dist/core/common/persistence/persisted-model.decorator.d.ts

@@ -0,0 +1,6 @@
+export interface PersistedModelOptions {
+    dataSource?: string;
+}
+export declare function PersistedModel(options: PersistedModelOptions): ClassDecorator;
+export declare function getPersistedModelOptions(target: Function): PersistedModelOptions | undefined;
+export declare function getPersistedModelOptionsByName(name: string): PersistedModelOptions | undefined;

package/dist/core/common/persistence/persisted-model.decorator.js

@@ -0,0 +1,24 @@
+const PERSISTED_MODEL_OPTIONS = Symbol('PERSISTED_MODEL_OPTIONS');
+const declaredByName = new Map();
+export function PersistedModel(options) {
+    return (target) => {
+        Reflect.defineMetadata(PERSISTED_MODEL_OPTIONS, { ...options }, target);
+        const classes = declaredByName.get(target.name) ?? [];
+        if (!classes.includes(target)) {
+            declaredByName.set(target.name, [...classes, target]);
+        }
+    };
+}
+export function getPersistedModelOptions(target) {
+    return Reflect.getMetadata(PERSISTED_MODEL_OPTIONS, target);
+}
+export function getPersistedModelOptionsByName(name) {
+    const classes = declaredByName.get(name) ?? [];
+    const sources = new Set(classes.map((target) => getPersistedModelOptions(target)?.dataSource));
+    if (sources.size > 1) {
+        throw new Error(`@PersistedModel: ${classes.length} classes named "${name}" declare different data sources; pass \`model\` ` +
+            `(or \`dataSource\`) in CorePersistenceModule.forFeature() to say which one this model is`);
+    }
+    return classes.length ? getPersistedModelOptions(classes[0]) : undefined;
+}
+//# sourceMappingURL=persisted-model.decorator.js.map

package/dist/core/common/persistence/persisted-model.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted-model.decorator.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/persisted-model.decorator.ts"],"names":[],"mappings":"AAYA,MAAM,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAMlE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAsB,CAAC;AAYrD,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,wBAAwB,CAAC,MAAgB;IACvD,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAOD,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAC/F,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,CAAC,MAAM,mBAAmB,IAAI,mDAAmD;YAC1G,0FAA0F,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

package/dist/core/common/persistence/persistence-runtime.registry.d.ts

@@ -0,0 +1,61 @@
+import type { DataStore } from './data-store.interface.js';
+import type { LockStore } from './lock-store.interface.js';
+export interface PersistedModelRegistration {
+    declaredSource?: string;
+    name: string;
+    schema: unknown;
+}
+export interface PersistenceRuntime {
+    close(): Promise<void>;
+    defaultLockStore(): Promise<LockStore | undefined>;
+    releaseBootConnections(): Promise<void>;
+    resolveStore(name: string, mongoModel: unknown): Promise<DataStore<any>>;
+    sqlSources(): {
+        name: string;
+        ping: () => Promise<void>;
+    }[];
+    defaultSqlSource(): undefined | {
+        engine?: string;
+        ownerUrl?: string;
+        url: string;
+    };
+    describe(): PersistenceOverview;
+    sweepExpired(now?: Date): Promise<{
+        deleted: number;
+        model: string;
+    }[]>;
+    iamStorage(): Promise<IamSqlStorage | undefined>;
+}
+export interface IamSqlStorage {
+    applySchema(migrate: (pool: unknown, asOwner: boolean) => Promise<void>, tables: string[]): Promise<void>;
+    pool: unknown;
+    source: string;
+    users: DataStore<any>;
+}
+export interface PersistenceOverview {
+    defaultSource?: string;
+    models: {
+        name: string;
+        source?: string;
+    }[];
+    sources: {
+        driver: string;
+        engine?: string;
+        host: string;
+        name: string;
+        ownerConfigured: boolean;
+    }[];
+}
+export declare function registerPersistedModel(registration: PersistedModelRegistration): void;
+export declare function getPersistedModels(): PersistedModelRegistration[];
+export declare function registerForeignColumns(table: string, columns: readonly string[]): void;
+export declare function isForeignColumn(table: string, column: string): boolean;
+export declare function registerDataStore(name: string, store: DataStore<any>): void;
+export declare function getRegisteredDataStore(name: string): DataStore<any> | undefined;
+export declare function getModelStore(connection: {
+    models?: Record<string, unknown>;
+} | null | undefined, name: string): DataStore<any> | undefined;
+export declare function bindStoreToModel(model: unknown, store: DataStore<any>): void;
+export declare function getStoreForModel(model: unknown): DataStore<any> | undefined;
+export declare function setPersistenceRuntime(value: PersistenceRuntime | undefined): void;
+export declare function getPersistenceRuntime(): PersistenceRuntime | undefined;