@rapidrest/service-core 1.0.0-beta.1

package/dist/lib/database/ConnectionManager.js

@@ -0,0 +1,161 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+////////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import { ObjectDecorators } from "@rapidrest/core";
+import { Redis } from "ioredis";
+import { isSqlDataSource } from "./ConnectionKinds.js";
+import { MongoConnection } from "./MongoConnection.js";
+import { MongoSchemaSync } from "./MongoSchemaSync.js";
+const { Destroy, Logger } = ObjectDecorators;
+/**
+ * Provides database connection management.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class ConnectionManager {
+    constructor() {
+        this.connections = new Map();
+    }
+    /**
+     * Builds a compatible connection URI for the database by the provided configuration.
+     */
+    buildConnectionUri(config) {
+        // If a url is provided use that verbatim. We assume it's correct.
+        if (config.url) {
+            return config.url;
+        }
+        else {
+            if (!config.type || !config.host) {
+                throw new Error(`Invalid datastore config: ${JSON.stringify(config)}.`);
+            }
+            return `${config.protocol ? config.protocol : config.type}://${config.username && config.password ? `${config.username}:${config.password}@` : ""}${config.host}${config.port ? `:${config.port}` : ""}${config.database ? `/${config.database}` : ""}${config.options ? `?${config.options}` : ""}`;
+        }
+    }
+    /**
+     * Dynamically imports the given optional peer dependency, throwing a helpful error if it is not installed.
+     *
+     * @param pkg The name of the package to import.
+     * @param datastoreName The name of the datastore requiring the package.
+     * @param datastoreType The type of the datastore requiring the package.
+     */
+    async importOptionalDependency(pkg, datastoreName, datastoreType) {
+        try {
+            return await import(pkg);
+        }
+        catch (err) {
+            throw new Error(`Datastore '${datastoreName}' is of type '${datastoreType}' which requires the optional peer dependency '${pkg}'. Install it with: yarn add ${pkg}`);
+        }
+    }
+    /**
+     * Attempts to initiate all database connections as defined in the config.
+     *
+     * @param datastores A map of configured datastores to be passed to the underlying engine.
+     * @param models A map of model names and associated class definitions to establish database connections for.
+     */
+    async connect(datastores, models) {
+        const processedModels = new Map();
+        // Go through each datastore in the configuration and attempt to make a connection
+        for (const name in datastores) {
+            const datastore = datastores[name];
+            // It's possible that the connection was already configured during a previous run. In that case we will
+            // attempt to reconnect instead of creating a new connection.
+            let connection = this.connections.get(name);
+            if (connection && isSqlDataSource(connection) && !connection.isInitialized) {
+                this.logger.info(`Reconnecting to database ${name}...`);
+                await connection.initialize();
+            }
+            if (!connection) {
+                datastore.name = name;
+                const url = this.buildConnectionUri(datastore);
+                this.logger.info(`Connecting to database ${name} [${url.replace(datastore.username, "****").replace(datastore.password, "****")}]...`);
+                if (datastore.type === "redis") {
+                    connection = new Redis(url);
+                }
+                else {
+                    // Make an array of all entities associated with this connection
+                    const entities = [];
+                    for (const className of models.keys()) {
+                        // Get the class type
+                        const clazz = models.get(className);
+                        const ds = Reflect.getMetadata("rrst:datastore", clazz);
+                        // Search for the associated datastore with the model via either config or @Model decorator
+                        if (ds === name || (datastore.entities && datastore.entities.includes(className))) {
+                            const processedDatastore = processedModels.get(clazz.name);
+                            if (processedDatastore) {
+                                throw new Error(`Model ${clazz.name} already defined as an entity for ${processedDatastore}`);
+                            }
+                            clazz.datastore = name;
+                            entities.push(clazz);
+                            processedModels.set(clazz.name, name);
+                        }
+                    }
+                    if (datastore.type === "mongodb" || datastore.type === "mongodb+srv") {
+                        // Connect using the native MongoDB driver
+                        const { MongoClient } = await this.importOptionalDependency("mongodb", name, datastore.type);
+                        const client = new MongoClient(url, datastore.clientOptions);
+                        await client.connect();
+                        const db = client.db(datastore.database);
+                        connection = new MongoConnection(name, client, db, entities);
+                        // Perform structure synchronization when requested
+                        if (datastore.synchronize) {
+                            const schemaSync = new MongoSchemaSync(db, this.logger);
+                            await schemaSync.synchronize(entities);
+                        }
+                    }
+                    else {
+                        // Connect using TypeORM
+                        await this.importOptionalDependency("typeorm", name, datastore.type);
+                        const orm = await import("./TypeOrmSupport.js");
+                        connection = await orm.connect(name, datastore, entities, url);
+                    }
+                }
+            }
+            this.connections.set(name, connection);
+        }
+        this.logger.info(`Successfully connected to all configured databases.`);
+    }
+    /**
+     * Attempts to disconnect all active database connections.
+     */
+    async disconnect() {
+        for (const conn of this.connections.values()) {
+            if (conn) {
+                if (conn instanceof MongoConnection) {
+                    if (conn.isConnected) {
+                        await conn.close();
+                    }
+                }
+                else if (conn instanceof Redis) {
+                    if (conn.status === "ready") {
+                        conn.disconnect();
+                    }
+                }
+                else if (isSqlDataSource(conn) && conn.isInitialized) {
+                    await conn.destroy();
+                }
+            }
+        }
+        this.connections.clear();
+        this.logger.info(`Successfully disconnected from all configured databases.`);
+    }
+}
+__decorate([
+    Logger,
+    __metadata("design:type", Object)
+], ConnectionManager.prototype, "logger", void 0);
+__decorate([
+    Destroy,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConnectionManager.prototype, "disconnect", null);
+//# sourceMappingURL=ConnectionManager.js.map

package/dist/lib/database/ConnectionManager.js.map

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

package/dist/lib/database/MongoConnection.js

@@ -0,0 +1,86 @@
+import { MongoRepository } from "./MongoRepository.js";
+import { resolveCollectionName } from "./NamingUtils.js";
+/**
+ * Represents a single named connection to a MongoDB database using the native `mongodb` driver, including the
+ * registry of all model classes assigned to the connection's datastore.
+ *
+ * Note that this class only references the `mongodb` package via type-only imports and is therefore safe to load
+ * when the optional `mongodb` peer dependency is not installed.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class MongoConnection {
+    constructor(name, client, db, entities) {
+        this.connected = true;
+        this.entities = new Map();
+        this.repos = new Map();
+        this.name = name;
+        this.client = client;
+        this.db = db;
+        if (entities) {
+            for (const clazz of entities) {
+                this.entities.set(clazz.name, clazz);
+            }
+        }
+    }
+    /** Indicates whether or not the connection is currently active. */
+    get isConnected() {
+        return this.connected;
+    }
+    /** Returns the admin interface of the underlying database. */
+    admin() {
+        return this.db.admin();
+    }
+    /**
+     * Closes the connection to the database server.
+     */
+    async close() {
+        this.connected = false;
+        await this.client.close();
+    }
+    /**
+     * Returns the name of the collection that records of the given model class are stored in.
+     *
+     * @param clazz The model class to resolve the collection name for.
+     */
+    collectionNameFor(clazz) {
+        return resolveCollectionName(clazz);
+    }
+    /**
+     * Returns the list of all model classes registered with this connection.
+     */
+    get entityClasses() {
+        return Array.from(this.entities.values());
+    }
+    /**
+     * Returns a repository for performing operations against the collection associated with the given model class.
+     *
+     * @param classOrName The model class, or the name of a registered model class, to retrieve a repository for.
+     */
+    getRepository(classOrName) {
+        let clazz = classOrName;
+        if (typeof classOrName === "string") {
+            clazz = this.entities.get(classOrName);
+            if (!clazz) {
+                throw new Error(`No entity named '${classOrName}' is registered with datastore '${this.name}'.`);
+            }
+        }
+        let repo = this.repos.get(clazz);
+        if (!repo) {
+            const collectionName = this.collectionNameFor(clazz);
+            repo = new MongoRepository(this.db, this.db.collection(collectionName), clazz);
+            this.repos.set(clazz, repo);
+        }
+        return repo;
+    }
+    /**
+     * Returns a repository for performing operations against the collection associated with the given model class.
+     * This is an alias of `getRepository` provided for compatibility with TypeORM's `DataSource` interface.
+     *
+     * @param classOrName The model class, or the name of a registered model class, to retrieve a repository for.
+     */
+    getMongoRepository(classOrName) {
+        return this.getRepository(classOrName);
+    }
+}
+//# sourceMappingURL=MongoConnection.js.map

package/dist/lib/database/MongoConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoConnection.js","sourceRoot":"","sources":["../../../src/database/MongoConnection.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAYxB,YAAY,IAAY,EAAE,MAAmB,EAAE,EAAM,EAAE,QAAwB;QAJvE,cAAS,GAAY,IAAI,CAAC;QAC1B,aAAQ,GAAqB,IAAI,GAAG,EAAE,CAAC;QACvC,UAAK,GAAmC,IAAI,GAAG,EAAE,CAAC;QAGtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QAEb,IAAI,QAAQ,EAAE,CAAC;YACX,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,8DAA8D;IACvD,KAAK;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,iBAAiB,CAAC,KAAU;QAC/B,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAW,aAAa;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAyB,WAAyB;QAClE,IAAI,KAAK,GAAQ,WAAW,CAAC;QAC7B,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YAClC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,WAAW,mCAAmC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YACrG,CAAC;QACL,CAAC;QAED,IAAI,IAAI,GAAqC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,cAAc,GAAW,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,GAAG,IAAI,eAAe,CAAM,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC;YACpF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,IAA0B,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CAAyB,WAAyB;QACvE,OAAO,IAAI,CAAC,aAAa,CAAI,WAAW,CAAC,CAAC;IAC9C,CAAC;CACJ"}

package/dist/lib/database/MongoRepository.js

@@ -0,0 +1,136 @@
+/**
+ * Provides a lightweight repository for performing common operations against a single MongoDB collection using the
+ * native `mongodb` driver. Instances of this class are obtained via `MongoConnection.getRepository`.
+ *
+ * Note that this class only references the `mongodb` package via type-only imports and is therefore safe to load
+ * when the optional `mongodb` peer dependency is not installed.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class MongoRepository {
+    constructor(db, collection, modelClass) {
+        this.db = db;
+        this.collection = collection;
+        this.modelClass = modelClass;
+    }
+    /** The name of the underlying MongoDB collection. */
+    get collectionName() {
+        return this.collection.collectionName;
+    }
+    /**
+     * Executes the given aggregation pipeline against the collection and returns the resulting cursor.
+     *
+     * @param pipeline The aggregation pipeline stages to execute.
+     */
+    aggregate(pipeline) {
+        return this.collection.aggregate(pipeline);
+    }
+    /**
+     * Drops the entire collection from the database, removing all documents and indexes. Does nothing if the
+     * collection does not exist.
+     */
+    async clear() {
+        try {
+            await this.collection.drop();
+        }
+        catch (err) {
+            // Ignore "ns not found" errors for collections that don't exist yet
+            if (err.codeName !== "NamespaceNotFound" && !String(err.message).includes("ns not found")) {
+                throw err;
+            }
+        }
+    }
+    /**
+     * Returns the number of documents matching the given filter.
+     *
+     * @param filter The query filter to match documents against.
+     */
+    async count(filter) {
+        return this.collection.countDocuments(filter ?? {});
+    }
+    /**
+     * Deletes all documents matching the given filter.
+     *
+     * @param filter The query filter to match documents against.
+     */
+    async deleteMany(filter) {
+        return this.collection.deleteMany(filter);
+    }
+    /**
+     * Deletes the first document matching the given filter.
+     *
+     * @param filter The query filter to match documents against.
+     */
+    async deleteOne(filter) {
+        return this.collection.deleteOne(filter);
+    }
+    /**
+     * Returns the list of distinct values of the given field for all documents matching the given filter.
+     *
+     * @param field The name of the document field to return distinct values of.
+     * @param filter The query filter to match documents against.
+     */
+    async distinct(field, filter) {
+        return this.collection.distinct(field, filter ?? {});
+    }
+    /**
+     * Returns all documents matching the given filter.
+     *
+     * @param filter The query filter to match documents against.
+     */
+    async find(filter) {
+        return this.collection.find(filter ?? {}).toArray();
+    }
+    /**
+     * Returns the first document matching the given filter.
+     *
+     * @param filter The query filter to match documents against.
+     */
+    async findOne(filter) {
+        return this.collection.findOne(filter);
+    }
+    /**
+     * Saves the given document to the collection. If the document has an existing `_id` the stored document is
+     * replaced (inserting if missing), otherwise the document is inserted and its newly assigned `_id` is set on
+     * the returned object.
+     *
+     * @param doc The document to save.
+     * @returns The saved document.
+     */
+    async save(doc) {
+        const copy = { ...doc };
+        // Strip any undefined properties so they are omitted from the stored document
+        for (const key of Object.keys(copy)) {
+            if (copy[key] === undefined) {
+                delete copy[key];
+            }
+        }
+        if (doc._id !== undefined && doc._id !== null) {
+            await this.collection.replaceOne({ _id: doc._id }, copy, { upsert: true });
+        }
+        else {
+            const result = await this.collection.insertOne(copy);
+            doc._id = result.insertedId;
+        }
+        return doc;
+    }
+    /**
+     * Updates all documents matching the given filter with the provided update operations.
+     *
+     * @param filter The query filter to match documents against.
+     * @param update The update operations (e.g. `$set`) to apply.
+     */
+    async updateMany(filter, update) {
+        return this.collection.updateMany(filter, update);
+    }
+    /**
+     * Updates the first document matching the given filter with the provided update operations.
+     *
+     * @param filter The query filter to match documents against.
+     * @param update The update operations (e.g. `$set`) to apply.
+     */
+    async updateOne(filter, update) {
+        return this.collection.updateOne(filter, update);
+    }
+}
+//# sourceMappingURL=MongoRepository.js.map

package/dist/lib/database/MongoRepository.js.map

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

package/dist/lib/database/MongoSchemaSync.js

@@ -0,0 +1,136 @@
+import { getIndexMetadata } from "../decorators/PersistenceDecorators.js";
+import { resolveCollectionName } from "./NamingUtils.js";
+/**
+ * Performs structure synchronization of MongoDB collections based on the persistence metadata of model classes.
+ *
+ * For each collection associated with a model class the following operations are performed:
+ * - The collection is created if it does not already exist.
+ * - Indexes declared via the `@Index` and `@Unique` decorators are created if missing.
+ * - Existing declared indexes whose definition has changed are dropped and re-created.
+ *
+ * The synchronization process never drops collections or data, never modifies the built-in `_id_` index, and never
+ * drops indexes that are not declared by the model class (e.g. shard keys or manually created indexes).
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class MongoSchemaSync {
+    constructor(db, logger) {
+        this.db = db;
+        this.logger = logger;
+    }
+    /**
+     * Synchronizes the structure of all collections associated with the given model classes.
+     *
+     * @param entities The list of model classes to synchronize collections for.
+     */
+    async synchronize(entities) {
+        // Group the model classes by their resolved collection name so that all classes stored in the same
+        // collection (e.g. @ChildEntity subclasses) contribute their indexes to a single specification.
+        const collections = new Map();
+        for (const clazz of entities) {
+            const name = resolveCollectionName(clazz);
+            const group = collections.get(name) ?? [];
+            group.push(clazz);
+            collections.set(name, group);
+        }
+        for (const [name, classes] of collections.entries()) {
+            await this.syncCollection(name, classes);
+        }
+    }
+    /**
+     * Synchronizes the structure of a single collection.
+     *
+     * @param name The name of the collection to synchronize.
+     * @param classes The list of model classes whose records are stored in the collection.
+     */
+    async syncCollection(name, classes) {
+        // Create the collection if it doesn't already exist
+        const existing = await this.db.listCollections({ name }, { nameOnly: true }).toArray();
+        if (existing.length === 0) {
+            try {
+                await this.db.createCollection(name);
+                this.logger?.info(`Created collection: ${name}`);
+            }
+            catch (err) {
+                // Tolerate concurrent creation races
+                if (err.codeName !== "NamespaceExists") {
+                    throw err;
+                }
+            }
+        }
+        // Build the merged set of desired indexes from all classes stored in this collection
+        const desired = new Map();
+        for (const clazz of classes) {
+            for (const index of getIndexMetadata(clazz)) {
+                const spec = this.toDesiredIndex(index);
+                desired.set(JSON.stringify(spec.key), spec);
+            }
+        }
+        // Retrieve the collection's current indexes
+        const collection = this.db.collection(name);
+        let currentIndexes = [];
+        try {
+            currentIndexes = await collection.listIndexes().toArray();
+        }
+        catch (err) {
+            if (err.codeName !== "NamespaceNotFound") {
+                throw err;
+            }
+        }
+        // Reconcile the desired indexes against the current state
+        for (const spec of desired.values()) {
+            const current = currentIndexes.find((idx) => JSON.stringify(idx.key) === JSON.stringify(spec.key));
+            if (current) {
+                if (this.optionsMatch(spec, current)) {
+                    continue;
+                }
+                // The index definition has changed. Drop and re-create it.
+                this.logger?.info(`Re-creating index ${current.name} on collection ${name} due to changed definition.`);
+                await collection.dropIndex(current.name);
+            }
+            else {
+                // If an unrelated index already uses the desired name it must be dropped first to avoid a conflict
+                const conflict = currentIndexes.find((idx) => idx.name === spec.name);
+                if (conflict) {
+                    this.logger?.info(`Dropping index ${spec.name} on collection ${name} due to changed key.`);
+                    await collection.dropIndex(spec.name);
+                }
+                this.logger?.info(`Creating index ${spec.name} on collection ${name}.`);
+            }
+            await collection.createIndex(spec.key, {
+                name: spec.name,
+                unique: spec.unique,
+                sparse: spec.sparse,
+                ...(spec.background !== undefined ? { background: spec.background } : {}),
+                ...(spec.expireAfterSeconds !== undefined ? { expireAfterSeconds: spec.expireAfterSeconds } : {}),
+            });
+        }
+    }
+    /**
+     * Converts declared index metadata into a desired index specification.
+     */
+    toDesiredIndex(index) {
+        const key = {};
+        for (const column of index.columns) {
+            key[column] = 1;
+        }
+        return {
+            name: index.name ?? index.columns.map((c) => `${c}_1`).join("_"),
+            key,
+            unique: index.options.unique ?? false,
+            sparse: index.options.sparse ?? false,
+            background: index.options.background,
+            expireAfterSeconds: index.options.expireAfterSeconds,
+        };
+    }
+    /**
+     * Determines whether an existing index satisfies the desired index specification. The `background` option is
+     * a build-time hint and is intentionally excluded from the comparison.
+     */
+    optionsMatch(spec, current) {
+        return (spec.unique === (current.unique ?? false) &&
+            spec.sparse === (current.sparse ?? false) &&
+            spec.expireAfterSeconds === (current.expireAfterSeconds ?? undefined));
+    }
+}
+//# sourceMappingURL=MongoSchemaSync.js.map

package/dist/lib/database/MongoSchemaSync.js.map

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

package/dist/lib/database/NamingUtils.js

@@ -0,0 +1,52 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+///////////////////////////////////////////////////////////////////////////////
+import "reflect-metadata";
+/**
+ * Converts a string into snake_case.
+ *
+ * Note: This function is intentionally identical in behavior to TypeORM's `snakeCase` utility so that
+ * collection/table names derived from class names remain stable for existing deployments.
+ *
+ * @param str The string to convert.
+ */
+export function snakeCase(str) {
+    return (str
+        // ABc -> a_bc
+        .replace(/([A-Z])([A-Z])([a-z])/g, "$1_$2$3")
+        // aC -> a_c
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .toLowerCase());
+}
+/**
+ * Resolves the name of the database collection (or table) that records of the given model class are stored in.
+ *
+ * The name is resolved using the following rules:
+ * 1. The nearest class in the inheritance chain (starting with `clazz` itself) that specifies an explicit
+ * entity name via the `@Entity(name)` decorator.
+ * 2. Otherwise, the most ancestral class in the inheritance chain that declares its own `@DataStore` binding.
+ * This ensures that `@ChildEntity` subclasses are stored in the same collection as their parent entity
+ * (single collection inheritance).
+ * 3. Otherwise, the snake_case form of the class name.
+ *
+ * @param clazz The model class to resolve the collection name for.
+ */
+export function resolveCollectionName(clazz) {
+    // Rule 1: nearest explicit entity name
+    for (let c = clazz; c && c !== Function.prototype; c = Object.getPrototypeOf(c)) {
+        const entityName = Reflect.getOwnMetadata("rrst:entityName", c);
+        if (entityName) {
+            return entityName;
+        }
+    }
+    // Rule 2: most ancestral class owning a datastore binding
+    let owner = undefined;
+    for (let c = clazz; c && c !== Function.prototype; c = Object.getPrototypeOf(c)) {
+        if (Reflect.getOwnMetadata("rrst:datastore", c)) {
+            owner = c;
+        }
+    }
+    // Rule 3: fall back to the class itself
+    return snakeCase((owner ?? clazz).name);
+}
+//# sourceMappingURL=NamingUtils.js.map

package/dist/lib/database/NamingUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamingUtils.js","sourceRoot":"","sources":["../../../src/database/NamingUtils.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E;AAC/E,OAAO,kBAAkB,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACjC,OAAO,CACH,GAAG;QACC,cAAc;SACb,OAAO,CAAC,wBAAwB,EAAE,SAAS,CAAC;QAC7C,YAAY;SACX,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE,CACrB,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAU;IAC5C,uCAAuC;IACvC,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,UAAU,GAAuB,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACpF,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,UAAU,CAAC;QACtB,CAAC;IACL,CAAC;IAED,0DAA0D;IAC1D,IAAI,KAAK,GAAQ,SAAS,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,IAAI,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9C,KAAK,GAAG,CAAC,CAAC;QACd,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,OAAO,SAAS,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}