@digitaldefiance/node-express-suite 3.18.3 → 4.0.0

package/src/mongo-application-base.js

@@ -1,216 +0,0 @@
-"use strict";
-/**
- * @fileoverview MongoDB/Mongoose-specific application base class.
- * Extends BaseApplication with IDocumentStore support, Mongoose model access,
- * schema maps, and dev database management.
- * @module mongo-application-base
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MongoApplicationBase = void 0;
-const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
-const application_base_1 = require("./application-base");
-const mongoose_document_store_1 = require("./services/mongoose-document-store");
-const mongo_authentication_provider_1 = require("./services/mongo-authentication-provider");
-/**
- * Duck-typing check to determine if a value conforms to the IDatabase interface.
- * Checks for the key methods that distinguish IDatabase from IDocumentStore.
- */
-function isIDatabase(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        'collection' in value &&
-        'startSession' in value &&
-        typeof value['collection'] === 'function' &&
-        typeof value['startSession'] === 'function');
-}
-/**
- * MongoDB/Mongoose-specific application base class.
- * Extends BaseApplication with legacy IDocumentStore support for backward
- * compatibility. Provides Mongoose-specific accessors: db, schemaMap,
- * devDatabase, getModel().
- *
- * Accepts either an IDatabase or an IDocumentStore in the constructor.
- * When an IDocumentStore is provided, a no-op IDatabase adapter is used
- * for the parent class, and the document store handles all database operations.
- */
-class MongoApplicationBase extends application_base_1.BaseApplication {
-    /**
-     * The injected document store handling all database operations.
-     * Set when a legacy IDocumentStore is passed to the constructor.
-     * @deprecated Prefer IDatabase for new code.
-     */
-    _documentStore;
-    /**
-     * Whether the constructor received an IDocumentStore (legacy path).
-     */
-    _isLegacyDocumentStore;
-    /**
-     * Schema map for all models, delegated to the document store.
-     * Only available when a legacy IDocumentStore is used.
-     */
-    get schemaMap() {
-        if (!this._documentStore) {
-            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_SchemaMapIsNotLoadedYet);
-        }
-        const map = this._documentStore.schemaMap;
-        if (!map) {
-            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_SchemaMapIsNotLoadedYet);
-        }
-        return map;
-    }
-    /**
-     * Get the connected MongoDB database instance.
-     * @deprecated Use database (IDatabase) or getCollection instead for storage-agnostic access.
-     */
-    get db() {
-        if (this._documentStore instanceof mongoose_document_store_1.MongooseDocumentStore) {
-            return this._documentStore.db;
-        }
-        throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_DatabaseNotConnectedYet);
-    }
-    /**
-     * Get the injected document store.
-     * @deprecated Prefer database (IDatabase) for new code.
-     */
-    get documentStore() {
-        return this._documentStore;
-    }
-    /**
-     * Get the in-memory MongoDB instance (if any), delegated to the document store.
-     * Only available when a legacy IDocumentStore is used.
-     */
-    get devDatabase() {
-        return this._documentStore?.devDatabase;
-    }
-    constructor(environment, databaseOrStore, constants = suite_core_lib_1.Constants) {
-        if (isIDatabase(databaseOrStore)) {
-            // IDatabase path — pass directly to parent
-            super(environment, databaseOrStore, constants);
-            this._documentStore = undefined;
-            this._isLegacyDocumentStore = false;
-        }
-        else {
-            // Legacy IDocumentStore path — create a no-op IDatabase for the parent
-            // since the document store manages its own connection lifecycle.
-            super(environment, createNoOpDatabase(), constants);
-            this._documentStore = databaseOrStore;
-            this._isLegacyDocumentStore = true;
-        }
-    }
-    /**
-     * Start the application.
-     * When using a legacy IDocumentStore, handles dev database setup and
-     * delegates connection to the document store.
-     * When using IDatabase, delegates to the parent class.
-     */
-    async start(mongoUri, delayReady) {
-        if (this._isLegacyDocumentStore && this._documentStore) {
-            // Legacy IDocumentStore path
-            if (this._ready) {
-                console.error('Failed to start the application:', 'Application is already running');
-                const err = new Error('Application is already running');
-                if (process.env['NODE_ENV'] === 'test') {
-                    throw err;
-                }
-                process.exit(1);
-            }
-            // Handle dev database setup
-            if (this.environment.devDatabase && !this._documentStore.devDatabase) {
-                if (this._documentStore.setupDevStore) {
-                    mongoUri = (await this._documentStore.setupDevStore());
-                }
-            }
-            try {
-                const uri = mongoUri ?? this.environment.mongo?.uri;
-                await this._documentStore.connect(uri);
-                // Wire up the Mongoose-backed authentication provider
-                if (!this.authProvider) {
-                    this.authProvider = new mongo_authentication_provider_1.MongoAuthenticationProvider(this);
-                }
-                // Initialize plugins
-                await this.plugins.initAll(this);
-            }
-            catch (err) {
-                const sanitizedErr = err instanceof Error
-                    ? err.message.replace(/[\r\n]/g, ' ')
-                    : String(err).replace(/[\r\n]/g, ' ');
-                console.error('Failed to start the application:', sanitizedErr);
-                if (process.env['NODE_ENV'] === 'test') {
-                    throw err;
-                }
-                process.exit(1);
-            }
-            this._ready = delayReady ? false : true;
-        }
-        else {
-            // IDatabase path — delegate to parent
-            await super.start(mongoUri, delayReady);
-        }
-    }
-    /**
-     * Stop the application.
-     * When using a legacy IDocumentStore, delegates disconnection to the store.
-     * When using IDatabase, delegates to the parent class.
-     */
-    async stop() {
-        if (this._isLegacyDocumentStore && this._documentStore) {
-            // Legacy IDocumentStore path
-            await this.plugins.stopAll();
-            await this._documentStore.disconnect();
-            if (this._documentStore.devDatabase) {
-                await this._documentStore.devDatabase.stop();
-            }
-            this._ready = false;
-        }
-        else {
-            // IDatabase path — delegate to parent
-            await super.stop();
-        }
-    }
-    /**
-     * Get a model by name, delegated to the legacy document store.
-     * @deprecated Use getCollection<T>(name) with IDatabase instead.
-     * @param modelName Name of the model
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getModel(modelName) {
-        if (!this._documentStore) {
-            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_DatabaseNotConnectedYet);
-        }
-        return this._documentStore.getModel(modelName);
-    }
-}
-exports.MongoApplicationBase = MongoApplicationBase;
-/**
- * Creates a no-op IDatabase that does nothing.
- * Used when a legacy IDocumentStore manages its own connection lifecycle.
- */
-function createNoOpDatabase() {
-    return {
-        collection() {
-            throw new Error('No-op IDatabase: use the document store for collection access');
-        },
-        startSession() {
-            throw new Error('No-op IDatabase: use the document store for session management');
-        },
-        withTransaction() {
-            throw new Error('No-op IDatabase: use the document store for transactions');
-        },
-        listCollections() {
-            return [];
-        },
-        async dropCollection() {
-            return false;
-        },
-        async connect() {
-            // no-op — document store manages connection
-        },
-        async disconnect() {
-            // no-op — document store manages disconnection
-        },
-        isConnected() {
-            return false;
-        },
-    };
-}
-//# sourceMappingURL=mongo-application-base.js.map

package/src/mongo-application-base.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mongo-application-base.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-express-suite/src/mongo-application-base.ts"],"names":[],"mappings":"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"}