@lenne.tech/nest-server 12.0.0 → 12.1.0

package/dist/core/common/persistence/data-source.runtime.js

@@ -0,0 +1,278 @@
+import { Logger } from '@nestjs/common';
+import { ConfigService } from '../services/config.service.js';
+import { RequestContext } from '../services/request-context.service.js';
+import { expiredRecordsFilter } from './expiry-sweep.js';
+import { redactUrl, resolveModelSource, } from './data-source.config.js';
+import { getModelDescriptor } from './model-metadata.registry.js';
+import { MongooseDataStore } from './mongoose-data-store.js';
+import { getPersistedModels, } from './persistence-runtime.registry.js';
+import { grantStatement } from './sql/postgres/postgres-schema.compiler.js';
+import { assertSafeApplicationRole, SCHEMA_LOCK_SQL } from './sql/postgres/postgres-schema.migrator.js';
+import { sqlDialect } from './sql/sql-dialect.js';
+import { createSqlExecutor } from './sql/sql-executor.factory.js';
+import { LOCK_MODEL, tableName } from './sql/sql-schema.shared.js';
+export class DataSourceRuntime {
+    resolved;
+    logger = new Logger('DataSources');
+    bootReleased = false;
+    dialects = new Map();
+    executors = new Map();
+    isolationReported = new Set();
+    lockStore;
+    owners = new Map();
+    stores = new Map();
+    constructor(resolved) {
+        this.resolved = resolved;
+    }
+    async close() {
+        const executors = [...this.executors.values()];
+        this.executors.clear();
+        this.lockStore = undefined;
+        this.stores.clear();
+        await Promise.all([this.releaseBootConnections(), ...executors.map(closeExecutor)]);
+    }
+    defaultLockStore() {
+        this.lockStore ??= this.openLockStore();
+        return this.lockStore;
+    }
+    async releaseBootConnections() {
+        this.bootReleased = true;
+        const owners = [...this.owners.values()];
+        this.owners.clear();
+        await Promise.all(owners.map(closeExecutor));
+    }
+    async resolveStore(name, mongoModel) {
+        const source = this.sourceOf(name);
+        if (!source || source.driver === 'mongodb') {
+            return new MongooseDataStore(mongoModel);
+        }
+        let store = this.stores.get(name);
+        if (!store) {
+            store = this.openStore(source, name);
+            this.stores.set(name, store);
+        }
+        return store;
+    }
+    defaultSqlSource() {
+        const name = this.resolved.defaultSource;
+        const source = name ? this.resolved.sources[name] : undefined;
+        return source && source.driver !== 'mongodb'
+            ? { engine: source.sqlEngine, ownerUrl: source.ownerUrl, url: source.url }
+            : undefined;
+    }
+    describe() {
+        return {
+            defaultSource: this.resolved.defaultSource,
+            models: getPersistedModels().map((model) => ({
+                name: model.name,
+                source: resolveModelSource(this.resolved, model.name, model.declaredSource),
+            })),
+            sources: Object.values(this.resolved.sources).map((source) => ({
+                driver: source.driver,
+                engine: source.sqlEngine,
+                host: redactUrl(source.url),
+                name: source.name,
+                ownerConfigured: !!source.ownerUrl,
+            })),
+        };
+    }
+    async iamStorage() {
+        const registration = getPersistedModels().find((model) => {
+            const descriptor = getModelDescriptor(model.name);
+            return !!descriptor && tableName(descriptor) === USERS_TABLE;
+        });
+        const source = registration ? this.sourceOf(registration.name) : undefined;
+        if (!registration || !source || source.driver === 'mongodb') {
+            return undefined;
+        }
+        if (source.driver !== 'postgres') {
+            throw new Error(`Better-Auth cannot run on ${this.dialect(source).label} yet: the user model (table ${USERS_TABLE}) is routed to ` +
+                `the source "${source.name}". Keep the user model on PostgreSQL or MongoDB (database.models), or switch Better-Auth off.`);
+        }
+        const users = await this.resolveStore(registration.name, undefined);
+        const app = await this.executor(source);
+        return {
+            applySchema: (migrate, tables) => this.applyForeignSchema(source, app, migrate, tables),
+            pool: app.driverPool,
+            source: source.name,
+            users,
+        };
+    }
+    async sweepExpired(now = new Date()) {
+        const swept = [];
+        const failed = [];
+        for (const [name, pending] of this.stores) {
+            const descriptor = getModelDescriptor(name);
+            const expired = descriptor ? expiredRecordsFilter(descriptor, now) : undefined;
+            if (!expired) {
+                continue;
+            }
+            try {
+                const store = await pending;
+                const deleted = await RequestContext.runWithBypassTenantGuard(() => store.deleteMany(expired));
+                swept.push({ deleted, model: name });
+            }
+            catch (error) {
+                failed.push(`${name}: ${error?.message ?? error}`);
+            }
+        }
+        if (failed.length) {
+            throw new Error(failed.join('; '));
+        }
+        return swept;
+    }
+    sqlSources() {
+        return Object.values(this.resolved.sources)
+            .filter((source) => source.driver !== 'mongodb')
+            .map((source) => ({
+            name: source.name,
+            ping: async () => {
+                await (await this.executor(source)).run({ params: [], text: 'SELECT 1' }, { kind: 'system' });
+            },
+        }));
+    }
+    isTenantIsolated(model) {
+        const multiTenancy = ConfigService.configFastButReadOnly?.multiTenancy;
+        return (!!multiTenancy &&
+            multiTenancy.enabled !== false &&
+            model.tenantScoped &&
+            !multiTenancy.excludeSchemas?.includes(model.name));
+    }
+    sourceOf(name) {
+        const registration = getPersistedModels().find((model) => model.name === name);
+        const source = resolveModelSource(this.resolved, name, registration?.declaredSource);
+        return source ? this.resolved.sources[source] : undefined;
+    }
+    async openStore(source, name) {
+        const model = getModelDescriptor(name);
+        if (!model) {
+            throw new Error(`No descriptor for model "${name}" — register it with CorePersistenceModule.forFeature()`);
+        }
+        const app = await this.executor(source);
+        const dialect = this.dialect(source);
+        let changes;
+        if (source.ownerUrl) {
+            changes = await dialect.applySchema(await this.owner(source), app, [model]);
+        }
+        else {
+            changes = await dialect.verifySchema(app, [model]);
+        }
+        for (const change of changes) {
+            if (change.kind === 'automatic') {
+                this.logger.log(`[${source.name}] ${change.description}`);
+            }
+            else if (change.kind === 'notice') {
+                this.logger.warn(`[${source.name}] ${change.description}`);
+            }
+        }
+        await dialect.assertSafeApplication(app, [tableName(model), tableName(LOCK_MODEL)]);
+        const isolated = this.isTenantIsolated(model);
+        if (isolated && source.driver !== 'postgres' && !this.isolationReported.has(source.name)) {
+            this.isolationReported.add(source.name);
+            this.logger.warn(`[${source.name}] ${dialect.label} has no row-level security: tenant isolation of ${source.name} is enforced by ` +
+                'the application only. A query on a tenant table through store.native(), store.raw() or a connection of your ' +
+                'own must filter by tenantId itself — nothing in the database stops it.');
+        }
+        this.logger.log(`${name} → ${source.name} → ${source.driver} ${redactUrl(source.url)} → ${source.sqlEngine}${dialect.isolation(isolated)}`);
+        const registration = getPersistedModels().find((entry) => entry.name === name);
+        return dialect.createStore(app, model, { schema: registration?.schema });
+    }
+    async openLockStore() {
+        const name = this.resolved.defaultSource;
+        const source = name ? this.resolved.sources[name] : undefined;
+        if (!source || source.driver === 'mongodb') {
+            return undefined;
+        }
+        const app = await this.executor(source);
+        const dialect = this.dialect(source);
+        if (!source.ownerUrl) {
+            await dialect.verifySchema(app, []);
+        }
+        else if (this.bootReleased) {
+            const owner = await createSqlExecutor({
+                applicationName: 'nest-server-schema',
+                engine: source.sqlEngine,
+                maxConnections: 1,
+                url: source.ownerUrl,
+            });
+            try {
+                await dialect.applySchema(owner, app, []);
+            }
+            finally {
+                await owner.close();
+            }
+        }
+        else {
+            await dialect.applySchema(await this.owner(source), app, []);
+        }
+        await dialect.assertSafeApplication(app, [tableName(LOCK_MODEL)]);
+        return dialect.createLockStore(app);
+    }
+    async applyForeignSchema(source, app, migrate, tables) {
+        if (!source.ownerUrl) {
+            await migrate(app.driverPool, false);
+        }
+        else {
+            const connect = (maxConnections) => createSqlExecutor({
+                applicationName: 'nest-server-schema',
+                engine: source.sqlEngine,
+                maxConnections,
+                url: source.ownerUrl,
+            });
+            const [lock, migrator] = await Promise.all([connect(1), connect(2)]);
+            const appRole = decodeURIComponent(new URL(source.url).username);
+            try {
+                await lock.transaction(async (tx) => {
+                    await tx.run({ params: [], text: SCHEMA_LOCK_SQL }, SYSTEM);
+                    await migrate(migrator.driverPool, true);
+                    for (const table of tables) {
+                        await tx.run({ params: [], text: grantStatement(table, appRole) }, SYSTEM);
+                    }
+                });
+            }
+            finally {
+                await Promise.all([lock.close(), migrator.close()]);
+            }
+        }
+        await assertSafeApplicationRole(app, tables);
+    }
+    dialect(source) {
+        let dialect = this.dialects.get(source.name);
+        if (!dialect) {
+            dialect = sqlDialect({
+                appRole: decodeURIComponent(new URL(source.url).username),
+                driver: source.driver,
+                isTenantIsolated: (candidate) => this.isTenantIsolated(candidate),
+            });
+            this.dialects.set(source.name, dialect);
+        }
+        return dialect;
+    }
+    owner(source) {
+        let pending = this.owners.get(source.name);
+        if (!pending) {
+            pending = createSqlExecutor({
+                applicationName: 'nest-server-schema',
+                engine: source.sqlEngine,
+                maxConnections: 1,
+                url: source.ownerUrl,
+            });
+            this.owners.set(source.name, pending);
+        }
+        return pending;
+    }
+    executor(source) {
+        let pending = this.executors.get(source.name);
+        if (!pending) {
+            pending = createSqlExecutor({ applicationName: 'nest-server', engine: source.sqlEngine, url: source.url });
+            this.executors.set(source.name, pending);
+        }
+        return pending;
+    }
+}
+const USERS_TABLE = 'users';
+const SYSTEM = { kind: 'system' };
+async function closeExecutor(pending) {
+    await (await pending.catch(() => undefined))?.close();
+}
+//# sourceMappingURL=data-source.runtime.js.map

package/dist/core/common/persistence/data-source.runtime.js.map

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

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

@@ -0,0 +1,73 @@
+export type Where<T = Record<string, any>> = {
+    [K in keyof T]?: any;
+} & {
+    [path: string]: any;
+    $and?: Where<T>[];
+    $nor?: Where<T>[];
+    $or?: Where<T>[];
+};
+export type DataStoreUpdate<T = Record<string, any>> = Partial<T> | {
+    $addToSet?: Record<string, unknown>;
+    $inc?: Record<string, number>;
+    $pull?: Record<string, unknown>;
+    $push?: Record<string, unknown>;
+    $set?: Partial<T> & Record<string, unknown>;
+    $setOnInsert?: Partial<T> & Record<string, unknown>;
+    $unset?: Record<string, '' | 1 | true>;
+};
+export type StoredRecord<T = Record<string, any>> = T & {
+    id: string;
+};
+export interface FindOptions {
+    collation?: Record<string, unknown>;
+    limit?: number;
+    sample?: number;
+    exclude?: readonly string[];
+    select?: readonly string[];
+    skip?: number;
+    sort?: Record<string, -1 | 1>;
+}
+export interface UpdateOptions {
+    timestamps?: boolean;
+}
+export interface PushOptions {
+    position?: number;
+    slice?: number;
+    sort?: Record<string, -1 | 1>;
+}
+export interface StoreCapabilities {
+    aggregatePipeline: boolean;
+    changeFeed: boolean;
+    gridfs: boolean;
+    mongoosePopulate: boolean;
+    rawFilterArm: boolean;
+    rls: boolean;
+    textSearch: boolean;
+    transactions: boolean;
+    idType: 'objectId';
+}
+export interface DataStore<T = Record<string, any>> {
+    readonly capabilities: StoreCapabilities;
+    readonly driver: string;
+    readonly modelName: string;
+    count(where?: Where<T>): Promise<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;
+    sum(field: string, where?: Where<T>): Promise<{
+        count: number;
+        sum: number;
+    }>;
+    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>>;
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data-store.interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-store.interface.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/data-store.interface.ts"],"names":[],"mappings":""}

package/dist/core/common/persistence/expiry-sweep.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from '@nestjs/common';
+import type { ModelDescriptor } from './model-descriptor.interface.js';
+export declare const EXPIRY_SWEEP_INTERVAL_MS: number;
+export declare function expiredRecordsFilter(model: ModelDescriptor, now: Date): Record<string, unknown> | undefined;
+export interface ExpirySweep {
+    runNow(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function scheduleExpirySweep(key: string, sweep: () => Promise<void>, options: {
+    intervalMs?: number;
+    logger: Logger;
+}): ExpirySweep;

package/dist/core/common/persistence/expiry-sweep.js

@@ -0,0 +1,55 @@
+import { defaultSqlLockStore } from './infrastructure-locks.js';
+export const EXPIRY_SWEEP_INTERVAL_MS = 15 * 60_000;
+export function expiredRecordsFilter(model, now) {
+    const conditions = Object.values(model.fields)
+        .filter((field) => field.kind === 'date' &&
+        !field.isArray &&
+        Number.isFinite(field.expiresAfterSeconds) &&
+        field.expiresAfterSeconds >= 0)
+        .map((field) => {
+        const expired = { [field.name]: { $lt: new Date(now.getTime() - field.expiresAfterSeconds * 1000) } };
+        const ttlIndex = model.indexes.find((index) => Object.keys(index.fields).length === 1 && field.name in index.fields && 'expireAfterSeconds' in index.options);
+        const partial = ttlIndex?.options.partialFilterExpression;
+        return partial ? { $and: [expired, partial] } : expired;
+    });
+    if (!conditions.length) {
+        return undefined;
+    }
+    return conditions.length === 1 ? conditions[0] : { $or: conditions };
+}
+export function scheduleExpirySweep(key, sweep, options) {
+    const intervalMs = options.intervalMs ?? EXPIRY_SWEEP_INTERVAL_MS;
+    const owner = `expiry-sweep:${process.pid}:${Math.random().toString(36).slice(2)}`;
+    let running;
+    const tick = async () => {
+        try {
+            const locks = await defaultSqlLockStore('expiry-sweep');
+            if (locks && !(await locks.tryAcquire(key, owner, Math.max(1, Math.floor(intervalMs / 1000))))) {
+                return;
+            }
+            await sweep();
+        }
+        catch (error) {
+            options.logger.warn(`Expiry sweep "${key}" failed, trying again in ${Math.max(1, Math.round(intervalMs / 60_000))} min: ${error?.message ?? error}`);
+        }
+    };
+    const run = () => {
+        running ??= tick().finally(() => {
+            running = undefined;
+        });
+    };
+    run();
+    const timer = setInterval(run, intervalMs);
+    timer.unref();
+    return {
+        runNow: async () => {
+            await running;
+            await sweep();
+        },
+        stop: async () => {
+            clearInterval(timer);
+            await running;
+        },
+    };
+}
+//# sourceMappingURL=expiry-sweep.js.map

package/dist/core/common/persistence/expiry-sweep.js.map

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

package/dist/core/common/persistence/id-format.d.ts

@@ -0,0 +1,3 @@
+export { isObjectIdLike } from '../helpers/id.helper.js';
+export declare function isWellFormedId(value: unknown): boolean;
+export declare function generateId(): string;

package/dist/core/common/persistence/id-format.js

@@ -0,0 +1,21 @@
+import { randomBytes } from 'node:crypto';
+import { isObjectIdLike } from '../helpers/id.helper.js';
+export { isObjectIdLike } from '../helpers/id.helper.js';
+const STORED_ID = /^[0-9a-f]{24}$/i;
+export function isWellFormedId(value) {
+    if (typeof value === 'string') {
+        return STORED_ID.test(value);
+    }
+    return isObjectIdLike(value);
+}
+const PROCESS_UNIQUE = randomBytes(5);
+let counter = randomBytes(3).readUIntBE(0, 3);
+export function generateId() {
+    const bytes = Buffer.alloc(12);
+    bytes.writeUInt32BE(Math.floor(Date.now() / 1000) >>> 0, 0);
+    PROCESS_UNIQUE.copy(bytes, 4);
+    counter = (counter + 1) % 0x1000000;
+    bytes.writeUIntBE(counter, 9, 3);
+    return bytes.toString('hex');
+}
+//# sourceMappingURL=id-format.js.map

package/dist/core/common/persistence/id-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-format.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/id-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAOzD,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAUpC,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AACtC,IAAI,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAM9C,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/B,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/common/persistence/infrastructure-locks.d.ts

@@ -0,0 +1,13 @@
+import type { Collection } from 'mongodb';
+import type { LockStore } from './lock-store.interface.js';
+export declare const CRON_LOCK_COLLECTION = "cron-locks";
+export declare const SYSTEM_SETUP_LOCK_COLLECTION = "system-setup-locks";
+export declare const SYSTEM_SETUP_LOCK_KEY = "initial-admin";
+export declare const SYSTEM_SETUP_CLAIM_STALE_AFTER_MS: number;
+export declare const MIGRATION_LOCK_KEY = "lock";
+export declare const MIGRATION_LOCK_STALE_AFTER_MS = 60000;
+export declare function cronMongoLocks(collection: Collection<any>): LockStore;
+export declare function systemSetupMongoLocks(collection: Collection<any>): LockStore;
+export declare function migrationMongoLocks(collection: Collection<any>): LockStore;
+export declare function defaultSqlLockStore(namespace: string): Promise<LockStore | undefined>;
+export declare function namespacedLocks(locks: LockStore, namespace: string): LockStore;

package/dist/core/common/persistence/infrastructure-locks.js

@@ -0,0 +1,35 @@
+import { MongoLockStore } from './mongo-lock-store.js';
+import { getPersistenceRuntime } from './persistence-runtime.registry.js';
+export const CRON_LOCK_COLLECTION = 'cron-locks';
+export const SYSTEM_SETUP_LOCK_COLLECTION = 'system-setup-locks';
+export const SYSTEM_SETUP_LOCK_KEY = 'initial-admin';
+export const SYSTEM_SETUP_CLAIM_STALE_AFTER_MS = 5 * 60_000;
+export const MIGRATION_LOCK_KEY = 'lock';
+export const MIGRATION_LOCK_STALE_AFTER_MS = 60_000;
+export function cronMongoLocks(collection) {
+    return new MongoLockStore(collection);
+}
+export function systemSetupMongoLocks(collection) {
+    return new MongoLockStore(collection, {
+        legacyTimestamp: { field: 'claimedAt', staleAfterMs: SYSTEM_SETUP_CLAIM_STALE_AFTER_MS },
+    });
+}
+export function migrationMongoLocks(collection) {
+    return new MongoLockStore(collection, {
+        keyField: 'lock',
+        legacyTimestamp: { field: 'acquiredAt', staleAfterMs: MIGRATION_LOCK_STALE_AFTER_MS },
+    });
+}
+export async function defaultSqlLockStore(namespace) {
+    const locks = await getPersistenceRuntime()?.defaultLockStore();
+    return locks ? namespacedLocks(locks, namespace) : undefined;
+}
+export function namespacedLocks(locks, namespace) {
+    const key = (name) => `${namespace}:${name}`;
+    return {
+        release: (name, owner) => locks.release(key(name), owner),
+        renew: (name, owner, ttlSeconds) => locks.renew(key(name), owner, ttlSeconds),
+        tryAcquire: (name, owner, ttlSeconds) => locks.tryAcquire(key(name), owner, ttlSeconds),
+    };
+}
+//# sourceMappingURL=infrastructure-locks.js.map

package/dist/core/common/persistence/infrastructure-locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-locks.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/infrastructure-locks.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAY1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEjD,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,GAAG,MAAM,CAAC;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AAEpD,MAAM,UAAU,cAAc,CAAC,UAA2B;IACxD,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAGD,MAAM,UAAU,qBAAqB,CAAC,UAA2B;IAC/D,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE;QACpC,eAAe,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iCAAiC,EAAE;KACzF,CAAC,CAAC;AACL,CAAC;AAMD,MAAM,UAAU,mBAAmB,CAAC,UAA2B;IAC7D,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE;QACpC,QAAQ,EAAE,MAAM;QAChB,eAAe,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,6BAA6B,EAAE;KACtF,CAAC,CAAC;AACL,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,SAAiB;IACzD,MAAM,KAAK,GAAG,MAAM,qBAAqB,EAAE,EAAE,gBAAgB,EAAE,CAAC;IAChE,OAAO,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,SAAiB;IACjE,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC;IACrD,OAAO;QACL,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;QACzD,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC;QAC7E,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC;KACxF,CAAC;AACJ,CAAC"}

package/dist/core/common/persistence/inject-store.decorator.d.ts

@@ -0,0 +1 @@
+export declare function InjectStore(model: Function | string): ParameterDecorator & PropertyDecorator;

package/dist/core/common/persistence/inject-store.decorator.js

@@ -0,0 +1,6 @@
+import { Inject } from '@nestjs/common';
+import { getStoreToken } from './persistence.tokens.js';
+export function InjectStore(model) {
+    return Inject(getStoreToken(typeof model === 'string' ? model : model.name));
+}
+//# sourceMappingURL=inject-store.decorator.js.map

package/dist/core/common/persistence/inject-store.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-store.decorator.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/inject-store.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAWxD,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC"}

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

@@ -0,0 +1,5 @@
+export interface LockStore {
+    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>;
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lock-store.interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock-store.interface.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/lock-store.interface.ts"],"names":[],"mappings":""}

package/dist/core/common/persistence/model-descriptor.interface.d.ts

@@ -0,0 +1,36 @@
+export type FieldKind = 'bigint' | 'boolean' | 'buffer' | 'date' | 'decimal' | 'enum' | 'id' | 'json' | 'number' | 'object' | 'ref' | 'string' | 'uuid';
+export interface FieldDescriptor {
+    default?: unknown;
+    enumBase?: 'number' | 'string';
+    enumValues?: readonly unknown[];
+    expiresAfterSeconds?: number;
+    hasDefault: boolean;
+    index: boolean;
+    isArray: boolean;
+    kind: FieldKind;
+    lowercase: boolean;
+    name: string;
+    nested?: Record<string, FieldDescriptor>;
+    ref?: string;
+    renamedFrom?: string;
+    required: boolean;
+    select: boolean;
+    sparse: boolean;
+    trim: boolean;
+    unique: boolean;
+}
+export interface IndexDescriptor {
+    fields: Record<string, number | string>;
+    options: Record<string, unknown>;
+}
+export interface ModelDescriptor {
+    collection?: string;
+    fields: Record<string, FieldDescriptor>;
+    indexes: IndexDescriptor[];
+    name: string;
+    tenantScoped: boolean;
+    timestamps: boolean | {
+        createdAt: false | string;
+        updatedAt: false | string;
+    };
+}

package/dist/core/common/persistence/model-descriptor.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-descriptor.interface.js.map

package/dist/core/common/persistence/model-descriptor.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-descriptor.interface.js","sourceRoot":"","sources":["../../../../src/core/common/persistence/model-descriptor.interface.ts"],"names":[],"mappings":""}

package/dist/core/common/persistence/model-metadata.registry.d.ts

@@ -0,0 +1,14 @@
+import type { ModelDescriptor } from './model-descriptor.interface.js';
+import { type DeclaredSchema } from './mongo/model-declarations.js';
+interface SchemaLike {
+    eachPath(fn: (path: string, schemaType: any) => void): unknown;
+    get(key: string): unknown;
+    indexes(): Array<[Record<string, number | string>, Record<string, unknown>?]>;
+    path(path: string): unknown;
+}
+export declare function describeSchema(name: string, given: DeclaredSchema | SchemaLike): ModelDescriptor;
+export declare function describeModelClass(modelClass: abstract new (...args: any[]) => any): ModelDescriptor;
+export declare function registerModelSchema(name: string, schema: DeclaredSchema | SchemaLike): ModelDescriptor;
+export declare function getModelDescriptor(name: string): ModelDescriptor | undefined;
+export declare function getModelDescriptors(): ReadonlyMap<string, ModelDescriptor>;
+export {};