@digitaldefiance/node-express-suite-mongo 4.23.0

package/README.md

@@ -0,0 +1,152 @@
+# @digitaldefiance/node-express-suite-mongo
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+MongoDB/Mongoose extensions for [@digitaldefiance/node-express-suite](https://www.npmjs.com/package/@digitaldefiance/node-express-suite).
+
+This package provides the Mongoose-specific layer — documents, schemas, models, services, and plugins — that was originally part of `@digitaldefiance/node-express-suite`. If your application uses MongoDB, install this package alongside the base package.
+
+Part of [Express Suite](https://github.com/Digital-Defiance/express-suite).
+
+## Installation
+
+```bash
+npm install @digitaldefiance/node-express-suite @digitaldefiance/node-express-suite-mongo
+# or
+yarn add @digitaldefiance/node-express-suite @digitaldefiance/node-express-suite-mongo
+```
+
+### Peer Dependencies
+
+- `@digitaldefiance/node-express-suite` (base framework)
+- `mongodb`
+- `mongoose` (via `@digitaldefiance/mongoose-types`)
+
+## What's in This Package
+
+Everything MongoDB/Mongoose-specific that was extracted from the base package:
+
+| Category | Contents |
+|----------|----------|
+| Documents | `BaseDocument`, `UserDocument`, `RoleDocument`, `EmailTokenDocument`, `MnemonicDocument`, `UserRoleDocument`, `UsedDirectLoginTokenDocument` |
+| Schemas | `UserSchema`, `RoleSchema`, `EmailTokenSchema`, `MnemonicSchema`, `UserRoleSchema`, `UsedDirectLoginTokenSchema`, and `create*Schema` factory functions |
+| Models | Model factory functions for all document types |
+| Services | `UserService`, `RoleService`, `BackupCodeService`, `DatabaseInitializationService`, `MongoBaseService`, `MongoAuthenticationProvider`, `MongooseDatabase`, `MongooseCollection`, `MongooseDocumentStore`, `MongooseSessionAdapter`, `DirectLoginTokenService`, `MnemonicService`, `RequestUserService` |
+| Controllers | `UserController`, `MongoBaseController` |
+| Plugins | `MongoDatabasePlugin` |
+| Transactions | `TransactionManager`, `withTransaction` (Mongoose Connection overload) |
+| Interfaces | `IMongoApplication`, `IMongoEnvironment`, `IMongoTypedEnvironment`, `ISchema`, `IMongoErrors`, `IApiMongoValidationErrorResponse`, and more |
+| Enumerations | `BaseModelName`, `SchemaCollection` |
+| Errors | `MongooseValidationError`, `ModelNotRegisteredError`, `InvalidModelError` |
+| Types | `MongoTransactionCallback`, `SchemaMap`, Mongoose helper types |
+| Utilities | `ModelRegistry`, `MongoApplicationConcrete`, `defaultMongoUriValidator`, `isValidStringObjectId`, `sendApiMongoValidationErrorResponse` |
+| Routers | `ApiRouter` (Mongo-aware API router with UserController) |
+
+## Quick Start
+
+```typescript
+import { Application, emailServiceRegistry, DummyEmailService } from '@digitaldefiance/node-express-suite';
+import {
+  MongoDatabasePlugin,
+  DatabaseInitializationService,
+  ApiRouter,
+  getSchemaMap,
+} from '@digitaldefiance/node-express-suite-mongo';
+
+// Create your application
+const env = new Environment(join(__dirname, '.env'));
+const app = new Application(env, /* ... */);
+
+// Set up the MongoDatabasePlugin
+const mongoPlugin = new MongoDatabasePlugin({
+  schemaMapFactory: getSchemaMap,
+  databaseInitFunction: DatabaseInitializationService.initUserDb,
+  initResultHashFunction: DatabaseInitializationService.serverInitResultHash,
+  environment: env,
+  constants: myConstants,
+});
+app.useDatabasePlugin(mongoPlugin);
+
+// Register email service
+emailServiceRegistry.setService(new DummyEmailService(app));
+
+await app.start();
+```
+
+## MongoDatabasePlugin
+
+The plugin manages the full Mongoose lifecycle: connection, schema registration, model creation, and database initialization.
+
+```typescript
+const plugin = new MongoDatabasePlugin({
+  schemaMapFactory: getSchemaMap,       // Returns your SchemaMap
+  databaseInitFunction: initFn,         // Called after connection to seed data
+  initResultHashFunction: hashFn,       // Hashes init results for change detection
+  environment: env,                     // Must include env.mongo config
+  constants: myConstants,
+});
+
+// The plugin exposes:
+plugin.db;                  // Mongoose connection
+plugin.mongoApplication;    // IMongoApplication adapter
+plugin.authenticationProvider; // MongoAuthenticationProvider
+```
+
+## ModelRegistry
+
+A singleton registry for Mongoose models, allowing any service to look up models by name:
+
+```typescript
+import { ModelRegistry, BaseModelName } from '@digitaldefiance/node-express-suite-mongo';
+
+// Retrieve a typed model
+const UserModel = ModelRegistry.instance.getTypedModel<UserDocument>(BaseModelName.User);
+const user = await UserModel.findById(userId);
+```
+
+## Extending Schemas
+
+Clone and extend base schemas for your application:
+
+```typescript
+import { createUserSchema } from '@digitaldefiance/node-express-suite-mongo';
+
+const BaseUserSchema = createUserSchema(undefined, undefined, undefined, undefined, undefined, undefined, myConstants);
+const MyUserSchema = BaseUserSchema.clone();
+MyUserSchema.add({
+  organizationId: { type: String, required: true },
+});
+```
+
+## DatabaseInitializationService
+
+Seeds the database with default admin/member users, roles, and system configuration:
+
+```typescript
+import { DatabaseInitializationService } from '@digitaldefiance/node-express-suite-mongo';
+
+const result = await DatabaseInitializationService.initUserDb(mongoApp);
+if (result.success) {
+  console.log('Admin mnemonic:', result.data.adminMnemonic);
+}
+```
+
+## Convenience Re-exports
+
+For simpler imports, this package re-exports key symbols from the base package:
+
+- `Application`, `BaseController`, `DecoratorBaseController`, `BaseService`, `AppRouter`, `BaseRouter`
+- `IApplication`, `IConstants`, `IAuthenticationProvider`, `IDatabasePlugin`, `IEnvironment`
+
+## Migration from Pre-Split Versions
+
+If upgrading from `@digitaldefiance/node-express-suite` < 5.0 (before the split):
+
+1. Install this package alongside the base package
+2. Update imports: move Mongo-specific symbols to `@digitaldefiance/node-express-suite-mongo`
+3. Symbols that stay in the base package: `Application`, `BaseController`, `BaseService`, `Environment`, `AppRouter`, `BaseRouter`, decorators, middleware, utilities, i18n, validation, responses, builders
+4. Symbols that move here: documents, schemas, models, `MongoDatabasePlugin`, `DatabaseInitializationService`, `UserService`, `RoleService`, `BackupCodeService`, `UserController`, `ModelRegistry`, `TransactionManager`, `ApiRouter`, all Mongoose-specific interfaces/types/errors
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@digitaldefiance/node-express-suite-mongo",
+  "version": "4.23.0",
+  "description": "MongoDB/Mongoose extensions for @digitaldefiance/node-express-suite",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./testing": {
+      "types": "./src/testing.d.ts",
+      "default": "./src/testing.js"
+    }
+  },
+  "dependencies": {
+    "@digitaldefiance/mongoose-types": "8.20.9",
+    "mongodb": "^6.20.0",
+    "mongoose": "^8.18.2"
+  },
+  "peerDependencies": {
+    "@digitaldefiance/branded-interface": "^0.0.5",
+    "@digitaldefiance/ecies-lib": "^4.20.0",
+    "@digitaldefiance/i18n-lib": "^4.6.0",
+    "@digitaldefiance/node-ecies-lib": "^4.20.0",
+    "@digitaldefiance/node-express-suite": "^4.23.0",
+    "@digitaldefiance/suite-core-lib": "^4.22.0"
+  },
+  "devDependencies": {
+    "mongodb-memory-server": "^10.1.4"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "express",
+    "mongodb",
+    "mongoose",
+    "typescript"
+  ],
+  "author": "Digital Defiance",
+  "license": "MIT",
+  "packageManager": "yarn@4.12.0",
+  "scripts": {
+    "build": "npx nx build digitaldefiance-node-express-suite-mongo",
+    "test": "npx nx test digitaldefiance-node-express-suite-mongo"
+  },
+  "type": "commonjs"
+}

package/src/__tests__/fixtures/index.d.ts

@@ -0,0 +1,2 @@
+export * from './model-mocks.mock';
+//# sourceMappingURL=index.d.ts.map

package/src/__tests__/fixtures/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/fixtures/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/src/__tests__/fixtures/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./model-mocks.mock"), exports);
+//# sourceMappingURL=index.js.map

package/src/__tests__/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/fixtures/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC"}

package/src/__tests__/fixtures/model-mocks.mock.d.ts

@@ -0,0 +1,12 @@
+interface MockModel {
+    find: any;
+    findOne: any;
+    create: any;
+}
+export declare const mockFunctions: (jest: typeof import('@jest/globals').jest) => {
+    makeRoleModel: (doc?: unknown) => MockModel;
+    makeUserModel: (doc?: unknown) => MockModel;
+    makeUserRoleModel: (docs?: unknown[] | null) => MockModel;
+};
+export {};
+//# sourceMappingURL=model-mocks.mock.d.ts.map

package/src/__tests__/fixtures/model-mocks.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-mocks.mock.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/fixtures/model-mocks.mock.ts"],"names":[],"mappings":"AAaA,UAAU,SAAS;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,EAAE,GAAG,CAAC;CACb;AAED,eAAO,MAAM,aAAa,EAAE,CAAC,IAAI,EAAE,cAAc,eAAe,EAAE,IAAI,KAAK;IACzE,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,SAAS,CAAC;IAC5C,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,SAAS,CAAC;IAC5C,iBAAiB,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,KAAK,SAAS,CAAC;CA6I3D,CAAC"}

package/src/__tests__/fixtures/model-mocks.mock.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockFunctions = void 0;
+const mockFunctions = (jest) => {
+    return {
+        makeRoleModel: (doc) => {
+            const chainable = {
+                session: jest.fn().mockReturnThis(),
+                lean: jest.fn().mockReturnThis(),
+                exec: jest.fn().mockResolvedValue(doc ?? null),
+            };
+            chainable.then = jest
+                .fn()
+                .mockImplementation((onFulfilled, onRejected) => Promise.resolve(doc ?? null).then(onFulfilled, onRejected));
+            chainable.catch = jest
+                .fn()
+                .mockImplementation((onRejected) => Promise.resolve(doc ?? null).catch(onRejected));
+            chainable.finally = jest
+                .fn()
+                .mockImplementation((onFinally) => Promise.resolve(doc ?? null).finally(onFinally));
+            // For getUserRoles which uses find().session() and expects array
+            const findChainable = {
+                session: jest
+                    .fn()
+                    .mockResolvedValue(doc ? [doc] : []),
+            };
+            return {
+                find: jest.fn().mockReturnValue(findChainable),
+                findOne: jest.fn().mockReturnValue(chainable),
+                create: jest.fn(),
+            };
+        },
+        makeUserModel: (doc) => {
+            const chainable = {
+                session: jest.fn().mockReturnThis(),
+                collation: jest.fn().mockReturnThis(),
+                select: jest.fn().mockReturnThis(),
+                lean: jest.fn().mockReturnThis(),
+                exec: jest.fn().mockResolvedValue(doc ?? null),
+            };
+            chainable.then = jest
+                .fn()
+                .mockImplementation((onFulfilled, onRejected) => Promise.resolve(doc ?? null).then(onFulfilled, onRejected));
+            chainable.catch = jest
+                .fn()
+                .mockImplementation((onRejected) => Promise.resolve(doc ?? null).catch(onRejected));
+            chainable.finally = jest
+                .fn()
+                .mockImplementation((onFinally) => Promise.resolve(doc ?? null).finally(onFinally));
+            // For loginWithMnemonic which uses .lean().session() without .exec()
+            chainable.lean.mockReturnValue({
+                session: jest
+                    .fn()
+                    .mockResolvedValue(doc ?? null),
+            });
+            return {
+                find: jest.fn().mockReturnValue(chainable),
+                findOne: jest.fn().mockReturnValue(chainable),
+                create: jest.fn(),
+            };
+        },
+        makeUserRoleModel: (docs) => {
+            const chainable = {
+                session: jest.fn().mockReturnThis(),
+                populate: jest.fn().mockReturnThis(),
+                lean: jest.fn().mockReturnThis(),
+                select: jest.fn().mockReturnThis(),
+                exec: jest.fn().mockResolvedValue(docs ?? []),
+            };
+            chainable.then = jest
+                .fn()
+                .mockImplementation((onFulfilled, onRejected) => Promise.resolve(docs ?? []).then(onFulfilled, onRejected));
+            chainable.catch = jest
+                .fn()
+                .mockImplementation((onRejected) => Promise.resolve(docs ?? []).catch(onRejected));
+            chainable.finally = jest
+                .fn()
+                .mockImplementation((onFinally) => Promise.resolve(docs ?? []).finally(onFinally));
+            // For getUserRoles which uses .select().session() - should return the docs array
+            chainable.select.mockImplementation(() => ({
+                session: jest
+                    .fn()
+                    .mockResolvedValue(docs ?? []),
+            }));
+            // For getUserRoles which uses .populate().lean().exec()
+            chainable.populate.mockReturnValue({
+                lean: jest.fn().mockReturnValue({
+                    exec: jest
+                        .fn()
+                        .mockResolvedValue(docs ?? []),
+                }),
+            });
+            return {
+                find: jest.fn().mockReturnValue(chainable),
+                findOne: jest.fn().mockReturnValue(chainable),
+                create: jest.fn(),
+            };
+        },
+    };
+};
+exports.mockFunctions = mockFunctions;
+//# sourceMappingURL=model-mocks.mock.js.map

package/src/__tests__/fixtures/model-mocks.mock.js.map

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

package/src/__tests__/helpers/application.mock.d.ts

@@ -0,0 +1,4 @@
+import { Environment } from '@digitaldefiance/node-express-suite';
+import { IMongoApplication } from '../../interfaces/mongo-application';
+export declare function createApplicationMock(overrides?: Partial<IMongoApplication>, envOverrides?: Partial<Environment>): IMongoApplication;
+//# sourceMappingURL=application.mock.d.ts.map

package/src/__tests__/helpers/application.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.mock.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/helpers/application.mock.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,WAAW,EAEZ,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACtC,YAAY,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAClC,iBAAiB,CA+BnB"}

package/src/__tests__/helpers/application.mock.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApplicationMock = createApplicationMock;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+function createApplicationMock(overrides, envOverrides) {
+    const mockEnvironment = {
+        jwtSecret: new ecies_lib_1.SecureString('test-jwt-secret'),
+        mnemonicHmacSecret: new ecies_lib_1.SecureString('test-hmac-secret'),
+        mnemonicEncryptionKey: new ecies_lib_1.SecureString('test-encryption-key'),
+        timezone: { value: 'UTC' },
+        mongo: { useTransactions: false },
+        disableEmailSend: true,
+        devDatabase: true,
+        ...overrides?.environment,
+        ...envOverrides,
+    };
+    const defaultGetModel = (name) => ({});
+    return {
+        environment: mockEnvironment,
+        constants: node_express_suite_1.LocalhostConstants,
+        disableEmailSend: true,
+        db: overrides?.db || {},
+        database: overrides?.database ?? undefined,
+        authProvider: overrides?.authProvider ?? undefined,
+        ready: true,
+        async start() {
+            /* noop */
+        },
+        getModel: overrides?.getModel || defaultGetModel,
+        services: new node_express_suite_1.ServiceContainer(),
+        plugins: new node_express_suite_1.PluginManager(),
+    };
+}
+//# sourceMappingURL=application.mock.js.map

package/src/__tests__/helpers/application.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.mock.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/helpers/application.mock.ts"],"names":[],"mappings":";;AAUA,sDAkCC;AA5CD,0DAA0D;AAE1D,4EAK6C;AAG7C,SAAgB,qBAAqB,CACnC,SAAsC,EACtC,YAAmC;IAEnC,MAAM,eAAe,GAAG;QACtB,SAAS,EAAE,IAAI,wBAAY,CAAC,iBAAiB,CAAC;QAC9C,kBAAkB,EAAE,IAAI,wBAAY,CAAC,kBAAkB,CAAC;QACxD,qBAAqB,EAAE,IAAI,wBAAY,CAAC,qBAAqB,CAAC;QAC9D,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;QAC1B,KAAK,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;QACjC,gBAAgB,EAAE,IAAI;QACtB,WAAW,EAAE,IAAI;QACjB,GAAG,SAAS,EAAE,WAAW;QACzB,GAAG,YAAY;KACD,CAAC;IAEjB,MAAM,eAAe,GAAG,CAAqB,IAAY,EAAY,EAAE,CACrE,CAAC,EAAE,CAAa,CAAC;IAEnB,OAAO;QACL,WAAW,EAAE,eAAe;QAC5B,SAAS,EAAE,uCAAkB;QAC7B,gBAAgB,EAAE,IAAI;QACtB,EAAE,EAAE,SAAS,EAAE,EAAE,IAAK,EAAsB;QAC5C,QAAQ,EAAG,SAAiB,EAAE,QAAQ,IAAI,SAAS;QACnD,YAAY,EAAG,SAAiB,EAAE,YAAY,IAAI,SAAS;QAC3D,KAAK,EAAE,IAAI;QACX,KAAK,CAAC,KAAK;YACT,UAAU;QACZ,CAAC;QACD,QAAQ,EAAE,SAAS,EAAE,QAAQ,IAAI,eAAe;QAChD,QAAQ,EAAE,IAAI,qCAAgB,EAAE;QAChC,OAAO,EAAE,IAAI,kCAAa,EAAE;KACG,CAAC;AACpC,CAAC"}

package/src/__tests__/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export * from '../fixtures/model-mocks.mock';
+export * from './application.mock';
+export * from './setup-test-env';
+export * from './mongoose-memory';
+//# sourceMappingURL=index.d.ts.map

package/src/__tests__/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/src/__tests__/helpers/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("../fixtures/model-mocks.mock"), exports);
+tslib_1.__exportStar(require("./application.mock"), exports);
+tslib_1.__exportStar(require("./setup-test-env"), exports);
+tslib_1.__exportStar(require("./mongoose-memory"), exports);
+//# sourceMappingURL=index.js.map

package/src/__tests__/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/helpers/index.ts"],"names":[],"mappings":";;;AAAA,uEAA6C;AAC7C,6DAAmC;AACnC,2DAAiC;AACjC,4DAAkC"}

package/src/__tests__/helpers/mongoose-memory.d.ts

@@ -0,0 +1,14 @@
+import { Connection } from '@digitaldefiance/mongoose-types';
+/**
+ * Connect to in-memory MongoDB for testing
+ */
+export declare function connectMemoryDB(): Promise<Connection>;
+/**
+ * Drop all collections and disconnect
+ */
+export declare function disconnectMemoryDB(): Promise<void>;
+/**
+ * Clear all collections without disconnecting
+ */
+export declare function clearMemoryDB(): Promise<void>;
+//# sourceMappingURL=mongoose-memory.d.ts.map

package/src/__tests__/helpers/mongoose-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-memory.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/helpers/mongoose-memory.ts"],"names":[],"mappings":"AAAA,OAAiB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAMvE;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAY3D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWxD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAOnD"}

package/src/__tests__/helpers/mongoose-memory.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectMemoryDB = connectMemoryDB;
+exports.disconnectMemoryDB = disconnectMemoryDB;
+exports.clearMemoryDB = clearMemoryDB;
+const tslib_1 = require("tslib");
+const mongoose_types_1 = tslib_1.__importDefault(require("@digitaldefiance/mongoose-types"));
+const mongodb_memory_server_1 = require("mongodb-memory-server");
+let mongoServer;
+let connection;
+/**
+ * Connect to in-memory MongoDB for testing
+ */
+async function connectMemoryDB() {
+    if (connection && connection.readyState === 1) {
+        return connection;
+    }
+    mongoServer = await mongodb_memory_server_1.MongoMemoryServer.create();
+    const uri = mongoServer.getUri();
+    await mongoose_types_1.default.connect(uri);
+    connection = mongoose_types_1.default.connection;
+    return connection;
+}
+/**
+ * Drop all collections and disconnect
+ */
+async function disconnectMemoryDB() {
+    if (connection) {
+        await connection.dropDatabase();
+        await mongoose_types_1.default.disconnect();
+        connection = undefined;
+    }
+    if (mongoServer) {
+        await mongoServer.stop();
+        mongoServer = undefined;
+    }
+}
+/**
+ * Clear all collections without disconnecting
+ */
+async function clearMemoryDB() {
+    if (connection) {
+        const collections = connection.collections;
+        for (const key in collections) {
+            await collections[key].deleteMany({});
+        }
+    }
+}
+//# sourceMappingURL=mongoose-memory.js.map

package/src/__tests__/helpers/mongoose-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-memory.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/helpers/mongoose-memory.ts"],"names":[],"mappings":";;AASA,0CAYC;AAKD,gDAWC;AAKD,sCAOC;;AAjDD,6FAAuE;AACvE,iEAA0D;AAE1D,IAAI,WAA0C,CAAC;AAC/C,IAAI,UAAkC,CAAC;AAEvC;;GAEG;AACI,KAAK,UAAU,eAAe;IACnC,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,WAAW,GAAG,MAAM,yCAAiB,CAAC,MAAM,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;IAEjC,MAAM,wBAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,UAAU,GAAG,wBAAQ,CAAC,UAAU,CAAC;IAEjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB;IACtC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC;QAChC,MAAM,wBAAQ,CAAC,UAAU,EAAE,CAAC;QAC5B,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;QACzB,WAAW,GAAG,SAAS,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,aAAa;IACjC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC"}

package/src/__tests__/helpers/setup-test-env.d.ts

@@ -0,0 +1,13 @@
+import { Connection } from '@digitaldefiance/mongoose-types';
+import { IFailableResult } from '@digitaldefiance/suite-core-lib';
+import { HelmetOptions } from 'helmet';
+import { AppRouter, BaseRouter, initMiddleware } from '@digitaldefiance/node-express-suite';
+import type { IApplication, IConstants, ICSPConfig, IFlexibleCSP } from '@digitaldefiance/node-express-suite';
+import { IServerInitResult } from '../../interfaces/server-init-result';
+import { BaseDocument } from '../../documents';
+import { IMongoApplication } from '../../interfaces/mongo-application';
+import { ITestEnvironment } from '../../interfaces/test-environment';
+import { SchemaMap } from '../../types';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+export declare function setupTestEnvironment<TID extends PlatformID = Buffer, TModelDocs extends Record<string, BaseDocument<never, TID>> = Record<string, BaseDocument<never, TID>>, TConstants extends IConstants = IConstants, TAppRouter extends AppRouter<TID> = AppRouter<TID>>(constants: TConstants, apiRouterFactory: (app: IApplication<TID>) => BaseRouter<TID>, schemaMapFactory: (connection: Connection) => SchemaMap<TID, TModelDocs>, appRouterFactory?: (apiRouter: BaseRouter<TID>) => TAppRouter, customInitMiddleware?: typeof initMiddleware, envLocation?: string, databaseInitFunction?: (application: IMongoApplication<TID>) => Promise<IFailableResult<IServerInitResult<TID>>>, initResultHashFunction?: (initResults: IServerInitResult<TID>) => string, cspConfig?: ICSPConfig | HelmetOptions | IFlexibleCSP): Promise<ITestEnvironment<TID>>;
+//# sourceMappingURL=setup-test-env.d.ts.map

package/src/__tests__/helpers/setup-test-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-test-env.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/helpers/setup-test-env.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAGL,SAAS,EACT,UAAU,EACV,cAAc,EACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACb,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,wBAAsB,oBAAoB,CACxC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAClE,MAAM,EACN,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CACzB,EACD,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1C,UAAU,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,EAElD,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAC7D,gBAAgB,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,EACxE,gBAAgB,GAAE,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,UACV,EACxC,oBAAoB,GAAE,OAAO,cAA+B,EAC5D,WAAW,CAAC,EAAE,MAAM,EACpB,oBAAoB,CAAC,EAAE,CACrB,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAChC,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EACrD,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAAK,MAAM,EACxE,SAAS,GAAE,UAAU,GAAG,aAAa,GAAG,YAWvC,GACA,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAoKhC"}