@lenne.tech/nest-server 11.43.3 → 12.1.0

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

@@ -0,0 +1,151 @@
+export class DataSourceConfigError extends Error {
+    constructor(message) {
+        super(`[database] ${message}`);
+        this.name = 'DataSourceConfigError';
+    }
+}
+export const DEFAULT_SOURCE = 'default';
+export const MONGOOSE_SOURCE = 'mongoose';
+export const DEFAULT_SQL_ENGINE = 'typeorm';
+const SQL_ENGINES = ['drizzle', 'kysely', 'typeorm'];
+const SOURCE_NAME = /^[A-Za-z][\w-]*$/;
+const DRIVERS = {
+    'mariadb:': 'mariadb',
+    'mongodb+srv:': 'mongodb',
+    'mongodb:': 'mongodb',
+    'mysql:': 'mysql',
+    'postgres:': 'postgres',
+    'postgresql:': 'postgres',
+};
+export function driverFromUrl(url) {
+    const scheme = /^[a-z][a-z0-9+.-]*:/i.exec(url)?.[0]?.toLowerCase();
+    const driver = scheme ? DRIVERS[scheme] : undefined;
+    if (!driver) {
+        throw new DataSourceConfigError(`Unsupported connection URL ${redactUrl(url)} — use mongodb://, mongodb+srv://, postgres://, postgresql://, mysql:// or mariadb://`);
+    }
+    return driver;
+}
+export function redactUrl(url) {
+    if (typeof url !== 'string') {
+        return `<${typeof url}>`;
+    }
+    const scheme = /^([a-z][a-z0-9+.-]*:)\/\//i.exec(url);
+    if (!scheme) {
+        return '<unparsable URL>';
+    }
+    const authority = url.slice(scheme[0].length).split(/[/?#]/, 1)[0];
+    return `${scheme[1]}//${authority.slice(authority.lastIndexOf('@') + 1)}`;
+}
+export function resolveDataSources(input) {
+    const { database, explicitMongoose, mongooseUri } = input;
+    if (database === false) {
+        return { defaultSource: undefined, disabled: true, modelSources: {}, sources: {} };
+    }
+    const config = typeof database === 'string' ? { url: database } : (database ?? {});
+    if (typeof config !== 'object' || Array.isArray(config)) {
+        throw new DataSourceConfigError('`database` must be a URL, an object or false');
+    }
+    if (config.ownerUrl !== undefined && config.url === undefined) {
+        throw new DataSourceConfigError('database.ownerUrl is set but database.url is not. A NSC__DATABASE__* variable replaces a `database` given as a ' +
+            'URL string; write `database: { url: … }` in the configuration (or set NSC__DATABASE__URL as well)');
+    }
+    const topEngine = config.sqlEngine === undefined ? undefined : checkEngine(config.sqlEngine, 'database.sqlEngine');
+    const sources = {};
+    if (config.url !== undefined) {
+        sources[DEFAULT_SOURCE] = buildSource(DEFAULT_SOURCE, { ownerUrl: config.ownerUrl, url: config.url }, topEngine, 'database.url');
+        if (explicitMongoose && mongooseUri) {
+            sources[MONGOOSE_SOURCE] = buildSource(MONGOOSE_SOURCE, { url: mongooseUri }, undefined, 'mongoose.uri');
+        }
+    }
+    else if (mongooseUri) {
+        sources[DEFAULT_SOURCE] = buildSource(DEFAULT_SOURCE, { url: mongooseUri }, undefined, 'mongoose.uri');
+    }
+    for (const [name, value] of Object.entries(config.sources ?? {})) {
+        if (name === DEFAULT_SOURCE || name === MONGOOSE_SOURCE) {
+            throw new DataSourceConfigError(`database.sources: the source name "${name}" is reserved`);
+        }
+        if (!SOURCE_NAME.test(name)) {
+            throw new DataSourceConfigError(`database.sources: invalid source name "${name}" — use letters, digits, "_" and "-", starting with a letter`);
+        }
+        const source = typeof value === 'string' ? { url: value } : value;
+        sources[name] = buildSource(name, source, topEngine, `database.sources.${name}`);
+    }
+    const modelSources = {};
+    for (const [model, source] of Object.entries(config.models ?? {})) {
+        if (typeof source !== 'string' || !sources[source]) {
+            throw new DataSourceConfigError(`database.models.${model} names the source "${String(source)}", which is not configured (known: ${knownSources(sources)})`);
+        }
+        modelSources[model] = source;
+    }
+    return {
+        defaultSource: sources[DEFAULT_SOURCE] ? DEFAULT_SOURCE : undefined,
+        disabled: false,
+        modelSources,
+        sources,
+    };
+}
+export function resolveModelSource(resolved, modelName, declaredSource) {
+    if (resolved.disabled) {
+        return undefined;
+    }
+    const configured = resolved.modelSources[modelName];
+    if (configured) {
+        return configured;
+    }
+    if (declaredSource !== undefined) {
+        if (!resolved.sources[declaredSource]) {
+            throw new DataSourceConfigError(`@PersistedModel on ${modelName} names the source "${declaredSource}", which is not configured (known: ${knownSources(resolved.sources)})`);
+        }
+        return declaredSource;
+    }
+    return resolved.defaultSource;
+}
+export function assertDataSourcesSupported(resolved) {
+    for (const source of Object.values(resolved.sources)) {
+        if (source.driver === 'mongodb' && source.name !== DEFAULT_SOURCE && source.name !== MONGOOSE_SOURCE) {
+            throw new DataSourceConfigError(`The additional MongoDB source "${source.name}" (${redactUrl(source.url)}) is not supported by this version yet — one MongoDB connection only`);
+        }
+    }
+}
+export function usesMongoDb(resolved) {
+    return Object.values(resolved.sources).some((source) => source.driver === 'mongodb');
+}
+export function hasSqlSource(resolved) {
+    return Object.values(resolved.sources).some((source) => source.driver !== 'mongodb');
+}
+function buildSource(name, source, fallbackEngine, path) {
+    if (!source || typeof source !== 'object' || typeof source.url !== 'string' || !source.url) {
+        throw new DataSourceConfigError(`${path}: the url must be a non-empty string`);
+    }
+    const driver = driverFromUrl(source.url);
+    if (driver === 'mongodb') {
+        if (source.ownerUrl !== undefined) {
+            throw new DataSourceConfigError(`${path}: ownerUrl applies to SQL sources only, not to ${redactUrl(source.url)}`);
+        }
+        if (source.sqlEngine !== undefined) {
+            throw new DataSourceConfigError(`${path}: sqlEngine applies to SQL sources only, not to ${redactUrl(source.url)}`);
+        }
+        return { driver, name, url: source.url };
+    }
+    const engine = source.sqlEngine === undefined
+        ? (fallbackEngine ?? DEFAULT_SQL_ENGINE)
+        : checkEngine(source.sqlEngine, `${path}.sqlEngine`);
+    if (source.ownerUrl !== undefined) {
+        if (typeof source.ownerUrl !== 'string' || !source.ownerUrl || driverFromUrl(source.ownerUrl) !== driver) {
+            throw new DataSourceConfigError(`${path}: ownerUrl must be a ${driver} URL of the same database`);
+        }
+        return { driver, name, ownerUrl: source.ownerUrl, sqlEngine: engine, url: source.url };
+    }
+    return { driver, name, sqlEngine: engine, url: source.url };
+}
+function checkEngine(value, path) {
+    if (!SQL_ENGINES.includes(value)) {
+        throw new DataSourceConfigError(`${path}: "${String(value)}" is not a known sqlEngine (${SQL_ENGINES.join(', ')})`);
+    }
+    return value;
+}
+function knownSources(sources) {
+    const names = Object.keys(sources);
+    return names.length ? names.join(', ') : 'none';
+}
+//# sourceMappingURL=data-source.config.js.map

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

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

package/dist/core/common/persistence/data-source.runtime.d.ts

@@ -0,0 +1,45 @@
+import { Logger } from '@nestjs/common';
+import type { DataStore } from './data-store.interface.js';
+import type { LockStore } from './lock-store.interface.js';
+import { type ResolvedDataSource, type ResolvedDataSources } from './data-source.config.js';
+import type { ModelDescriptor } from './model-descriptor.interface.js';
+import { type IamSqlStorage, type PersistenceOverview, type PersistenceRuntime } from './persistence-runtime.registry.js';
+export declare class DataSourceRuntime implements PersistenceRuntime {
+    protected readonly resolved: ResolvedDataSources;
+    protected readonly logger: Logger;
+    private bootReleased;
+    private readonly dialects;
+    private readonly executors;
+    private readonly isolationReported;
+    private lockStore?;
+    private readonly owners;
+    private readonly stores;
+    constructor(resolved: ResolvedDataSources);
+    close(): Promise<void>;
+    defaultLockStore(): Promise<LockStore | undefined>;
+    releaseBootConnections(): Promise<void>;
+    resolveStore(name: string, mongoModel: unknown): Promise<DataStore<any>>;
+    defaultSqlSource(): undefined | {
+        engine?: string;
+        ownerUrl?: string;
+        url: string;
+    };
+    describe(): PersistenceOverview;
+    iamStorage(): Promise<IamSqlStorage | undefined>;
+    sweepExpired(now?: Date): Promise<{
+        deleted: number;
+        model: string;
+    }[]>;
+    sqlSources(): {
+        name: string;
+        ping: () => Promise<void>;
+    }[];
+    isTenantIsolated(model: ModelDescriptor): boolean;
+    protected sourceOf(name: string): ResolvedDataSource | undefined;
+    private openStore;
+    private openLockStore;
+    private applyForeignSchema;
+    private dialect;
+    private owner;
+    private executor;
+}

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