@brightchain/node-express-suite 0.25.0

package/MIGRATION.md

@@ -0,0 +1,131 @@
+# MERN → BERN Migration Guide
+
+Migrate from `@digitaldefiance/node-express-suite` (Mongoose/MongoDB) to `@brightchain/node-express-suite` (BrightDB).
+
+## Quick Reference
+
+| Upstream (MERN) | Suite (BERN) |
+|---|---|
+| `MongoBaseService` | `BrightDbBaseService` |
+| `MongooseCollection` | `BrightDbCollection` |
+| `MongooseDocumentStore` | `BlockDocumentStore` |
+| `MongooseSessionAdapter` | `BrightChainSessionAdapter` |
+| `MongoDatabasePlugin` | `BrightDbDatabasePlugin` |
+| `MongoAuthenticationProvider` | `BrightDbAuthenticationProvider` |
+| `ModelRegistry` | `BrightDbModelRegistry` |
+| `TransactionManager` | `BrightDbTransactionManager` |
+| `IMongoApplication` | `IBrightDbApplication` |
+| `MongoApplicationConcrete` | `BrightDbApplication` |
+| `BaseEnvironment` + `.mongo` | `BrightDbEnvironment` |
+
+## Step-by-Step
+
+### 1. Update dependencies
+
+```json
+{
+  "dependencies": {
+-   "@digitaldefiance/node-express-suite": "...",
++   "@brightchain/node-express-suite": "..."
+  },
+  "peerDependencies": {
++   "@brightchain/brightchain-lib": "...",
++   "@brightchain/db": "..."
+  }
+}
+```
+
+### 2. Replace imports
+
+```typescript
+// Before
+import { MongoBaseService, MongoDatabasePlugin } from '@digitaldefiance/node-express-suite';
+
+// After
+import { BrightDbBaseService, BrightDbDatabasePlugin } from '@brightchain/node-express-suite';
+```
+
+### 3. Replace database plugin
+
+```typescript
+// Before
+const plugin = new MongoDatabasePlugin(environment);
+await plugin.connect(mongoUri);
+
+// After
+const plugin = new BrightDbDatabasePlugin(environment);
+await plugin.connect(); // No URI needed — uses blockstore config from environment
+```
+
+### 4. Replace services
+
+```typescript
+// Before
+class MyService extends MongoBaseService {
+  async getUsers() {
+    const model = this.application.getModel('users');
+    return model.find({}).exec();
+  }
+}
+
+// After
+class MyService extends BrightDbBaseService {
+  async getUsers() {
+    const model = this.application.getModel('users');
+    return model.find({}).exec();
+  }
+}
+```
+
+### 5. Replace document store
+
+```typescript
+// Before
+const store = new MongooseDocumentStore(connection);
+const users = store.collection('users');
+
+// After
+const store = new BlockDocumentStore(blockStore);
+const users = store.collection('users');
+```
+
+### 6. Replace transactions
+
+```typescript
+// Before
+const txMgr = new TransactionManager(connection, true);
+await txMgr.execute(async (session) => { ... });
+
+// After
+const txMgr = new BrightDbTransactionManager(db, true);
+await txMgr.execute(async (session) => { ... });
+```
+
+### 7. Update environment config
+
+Remove MongoDB URI configuration, add BrightDB blockstore config:
+
+```env
+# Remove
+# MONGO_URI=mongodb://localhost:27017/mydb
+
+# Add
+BRIGHTCHAIN_BLOCKSTORE_PATH=/data/blocks
+BRIGHTCHAIN_BLOCKSIZE_BYTES=1024
+BRIGHTCHAIN_BLOCKSTORE_TYPE=disk
+USE_MEMORY_DOCSTORE=false
+```
+
+## Behavioral Differences
+
+| Feature | Mongoose/MongoDB | BrightDB |
+|---|---|---|
+| Change streams | `collection.watch()` supported | `watch()` supported (in-memory listeners) |
+| Transactions | Multi-document ACID via replica set | Session-based with journal replay |
+| Estimated count | O(1) via collection metadata | Delegates to `countDocuments()` |
+| Text search | Native `$text` operator | In-memory tokenization via text indexes |
+| Aggregation | Full MongoDB aggregation pipeline | Subset: `$match`, `$group`, `$sort`, `$limit`, `$skip`, `$project`, `$unwind`, `$lookup`, `$count`, `$addFields`, `$facet` |
+| Query operators | Full MongoDB query language | Core operators: `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$regex`, `$exists`, `$and`, `$or`, `$not`, `$nor`, `$elemMatch` |
+| Indexes | B-tree, compound, TTL, geospatial | In-memory indexes with TTL support |
+| Storage | Disk-based with WiredTiger | Content-addressable block store |
+| Schema validation | Mongoose schemas | `CollectionSchema` with field-level validation |

package/README.md

@@ -0,0 +1,11 @@
+# brightchain-node-express-suite
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build brightchain-node-express-suite` to build the library.
+
+## Running unit tests
+
+Run `nx test brightchain-node-express-suite` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@brightchain/node-express-suite",
+  "version": "0.25.0",
+  "private": false,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@digitaldefiance/branded-interface": "^0.0.5",
+    "@digitaldefiance/node-ecies-lib": "^4.20.0",
+    "@digitaldefiance/node-express-suite": "^4.20.1",
+    "@brightchain/brightchain-lib": "^0.25.0",
+    "@brightchain/db": "^0.25.0"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @brightchain/node-express-suite
+ *
+ * Generic BrightDB-backed Express infrastructure extracted from brightchain-api-lib.
+ * This library sits between @digitaldefiance/node-express-suite (upstream) and
+ * @brightchain/brightchain-api-lib (domain-specific).
+ */
+export type { GuidV4Buffer, SignatureBuffer, ClientSession, DefaultBackendIdType, IBlockStorageSchema, IBlockStorageModel, IBlockStorageSchemaEntry, SchemaMap, } from './lib/shared-types';
+export type { DefaultBackendIdType as DefaultBackendIdType_ } from './lib/types/backend-id';
+export type { CreateDocumentOptions, RetrieveDocumentOptions, } from './lib/datastore/block-document-store';
+export { BlockDocumentStore, CollectionHeadRegistry } from './lib/datastore/block-document-store';
+export * from './lib/datastore/block-document-store-factory';
+export * from './lib/datastore/document-store';
+export { MemoryDocumentStore } from './lib/datastore/memory-document-store';
+export type { IValidationError, IValidationResult } from './lib/validation/userValidation';
+export { validateRegistration, validateLogin, validatePasswordChange, validateRecovery, } from './lib/validation/userValidation';
+export { validateBody } from './lib/middleware/validateBody';
+export type { ISessionDocument } from './lib/services/sessionAdapter';
+export { BrightChainSessionAdapter } from './lib/services/sessionAdapter';
+export type { IDatabaseInitEnvironment, IGenericInitData } from './lib/databaseInit';
+export { brightchainDatabaseInit } from './lib/databaseInit';
+export { BlockStoreFactory } from './lib/factories/blockStoreFactory';
+export { BrightDbEnvironment } from './lib/environment';
+export type { IAzureEnvironmentConfig, IS3EnvironmentConfig } from './lib/interfaces/environment';
+export { BrightDbDatabasePlugin } from './lib/plugins/bright-db-database-plugin';
+export type { IBrightDbDatabasePluginOptions } from './lib/plugins/bright-db-database-plugin';
+export { BrightDbApplication } from './lib/application';
+export type { IBrightDbApplication } from './lib/interfaces/bright-db-application';
+export { configureBrightDbApp } from './lib/plugins/configure-bright-db-app';
+export type { ConfigureBrightDbAppResult } from './lib/plugins/configure-bright-db-app';
+export { BrightDbAuthenticationProvider } from './lib/services/bright-db-authentication-provider';
+export { BrightDbConstants } from './lib/constants';
+export { BrightDbMiddlewares } from './lib/middlewares';
+export * from './lib/upstream';
+export * from './lib/brightdb';
+export * from './lib/brightchain-lib';
+export { createTestApp } from './lib/create-test-app';
+export type { CreateTestAppResult } from './lib/create-test-app';
+export { BrightDbCollection } from './lib/services/bright-db-collection';
+export { BrightDbBaseService } from './lib/services/bright-db-base-service';
+export { BrightDbModelRegistry } from './lib/bright-db-model-registry';
+export type { BrightDbModelRegistration } from './lib/bright-db-model-registry';
+export { BrightDbTransactionManager } from './lib/transactions/bright-db-transaction-manager';
+export type { BrightDbTransactionOptions } from './lib/transactions/bright-db-transaction-manager';
+export type { IBrightDbDocumentStore } from './lib/datastore/document-store';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../brightchain-node-express-suite/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,oBAAoB,IAAI,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG5F,YAAY,EACV,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAClG,cAAc,8CAA8C,CAAC;AAC7D,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAG5E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAG1E,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGlG,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,YAAY,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAG9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAGnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAGxF,OAAO,EAAE,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AAGlG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAC9F,YAAY,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAGnG,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC"}

package/src/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * @brightchain/node-express-suite
+ *
+ * Generic BrightDB-backed Express infrastructure extracted from brightchain-api-lib.
+ * This library sits between @digitaldefiance/node-express-suite (upstream) and
+ * @brightchain/brightchain-api-lib (domain-specific).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbTransactionManager = exports.BrightDbModelRegistry = exports.BrightDbBaseService = exports.BrightDbCollection = exports.createTestApp = exports.BrightDbMiddlewares = exports.BrightDbConstants = exports.BrightDbAuthenticationProvider = exports.configureBrightDbApp = exports.BrightDbApplication = exports.BrightDbDatabasePlugin = exports.BrightDbEnvironment = exports.BlockStoreFactory = exports.brightchainDatabaseInit = exports.BrightChainSessionAdapter = exports.validateBody = exports.validateRecovery = exports.validatePasswordChange = exports.validateLogin = exports.validateRegistration = exports.MemoryDocumentStore = exports.CollectionHeadRegistry = exports.BlockDocumentStore = void 0;
+const tslib_1 = require("tslib");
+var block_document_store_1 = require("./lib/datastore/block-document-store");
+Object.defineProperty(exports, "BlockDocumentStore", { enumerable: true, get: function () { return block_document_store_1.BlockDocumentStore; } });
+Object.defineProperty(exports, "CollectionHeadRegistry", { enumerable: true, get: function () { return block_document_store_1.CollectionHeadRegistry; } });
+tslib_1.__exportStar(require("./lib/datastore/block-document-store-factory"), exports);
+tslib_1.__exportStar(require("./lib/datastore/document-store"), exports);
+var memory_document_store_1 = require("./lib/datastore/memory-document-store");
+Object.defineProperty(exports, "MemoryDocumentStore", { enumerable: true, get: function () { return memory_document_store_1.MemoryDocumentStore; } });
+var userValidation_1 = require("./lib/validation/userValidation");
+Object.defineProperty(exports, "validateRegistration", { enumerable: true, get: function () { return userValidation_1.validateRegistration; } });
+Object.defineProperty(exports, "validateLogin", { enumerable: true, get: function () { return userValidation_1.validateLogin; } });
+Object.defineProperty(exports, "validatePasswordChange", { enumerable: true, get: function () { return userValidation_1.validatePasswordChange; } });
+Object.defineProperty(exports, "validateRecovery", { enumerable: true, get: function () { return userValidation_1.validateRecovery; } });
+// Middleware
+var validateBody_1 = require("./lib/middleware/validateBody");
+Object.defineProperty(exports, "validateBody", { enumerable: true, get: function () { return validateBody_1.validateBody; } });
+var sessionAdapter_1 = require("./lib/services/sessionAdapter");
+Object.defineProperty(exports, "BrightChainSessionAdapter", { enumerable: true, get: function () { return sessionAdapter_1.BrightChainSessionAdapter; } });
+var databaseInit_1 = require("./lib/databaseInit");
+Object.defineProperty(exports, "brightchainDatabaseInit", { enumerable: true, get: function () { return databaseInit_1.brightchainDatabaseInit; } });
+// Factories
+var blockStoreFactory_1 = require("./lib/factories/blockStoreFactory");
+Object.defineProperty(exports, "BlockStoreFactory", { enumerable: true, get: function () { return blockStoreFactory_1.BlockStoreFactory; } });
+// Environment
+var environment_1 = require("./lib/environment");
+Object.defineProperty(exports, "BrightDbEnvironment", { enumerable: true, get: function () { return environment_1.BrightDbEnvironment; } });
+// Plugins
+var bright_db_database_plugin_1 = require("./lib/plugins/bright-db-database-plugin");
+Object.defineProperty(exports, "BrightDbDatabasePlugin", { enumerable: true, get: function () { return bright_db_database_plugin_1.BrightDbDatabasePlugin; } });
+// Application
+var application_1 = require("./lib/application");
+Object.defineProperty(exports, "BrightDbApplication", { enumerable: true, get: function () { return application_1.BrightDbApplication; } });
+// Configure App Helper
+var configure_bright_db_app_1 = require("./lib/plugins/configure-bright-db-app");
+Object.defineProperty(exports, "configureBrightDbApp", { enumerable: true, get: function () { return configure_bright_db_app_1.configureBrightDbApp; } });
+// Authentication Provider
+var bright_db_authentication_provider_1 = require("./lib/services/bright-db-authentication-provider");
+Object.defineProperty(exports, "BrightDbAuthenticationProvider", { enumerable: true, get: function () { return bright_db_authentication_provider_1.BrightDbAuthenticationProvider; } });
+// Constants
+var constants_1 = require("./lib/constants");
+Object.defineProperty(exports, "BrightDbConstants", { enumerable: true, get: function () { return constants_1.BrightDbConstants; } });
+// Middlewares
+var middlewares_1 = require("./lib/middlewares");
+Object.defineProperty(exports, "BrightDbMiddlewares", { enumerable: true, get: function () { return middlewares_1.BrightDbMiddlewares; } });
+// Upstream re-exports
+tslib_1.__exportStar(require("./lib/upstream"), exports);
+// BrightDB re-exports
+tslib_1.__exportStar(require("./lib/brightdb"), exports);
+// BrightChain-lib re-exports
+tslib_1.__exportStar(require("./lib/brightchain-lib"), exports);
+// Test utilities
+var create_test_app_1 = require("./lib/create-test-app");
+Object.defineProperty(exports, "createTestApp", { enumerable: true, get: function () { return create_test_app_1.createTestApp; } });
+// MERN→BERN Parity Classes
+var bright_db_collection_1 = require("./lib/services/bright-db-collection");
+Object.defineProperty(exports, "BrightDbCollection", { enumerable: true, get: function () { return bright_db_collection_1.BrightDbCollection; } });
+var bright_db_base_service_1 = require("./lib/services/bright-db-base-service");
+Object.defineProperty(exports, "BrightDbBaseService", { enumerable: true, get: function () { return bright_db_base_service_1.BrightDbBaseService; } });
+var bright_db_model_registry_1 = require("./lib/bright-db-model-registry");
+Object.defineProperty(exports, "BrightDbModelRegistry", { enumerable: true, get: function () { return bright_db_model_registry_1.BrightDbModelRegistry; } });
+var bright_db_transaction_manager_1 = require("./lib/transactions/bright-db-transaction-manager");
+Object.defineProperty(exports, "BrightDbTransactionManager", { enumerable: true, get: function () { return bright_db_transaction_manager_1.BrightDbTransactionManager; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../brightchain-node-express-suite/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AAsBH,6EAAkG;AAAzF,0HAAA,kBAAkB,OAAA;AAAE,8HAAA,sBAAsB,OAAA;AACnD,uFAA6D;AAC7D,yEAA+C;AAC/C,+EAA4E;AAAnE,4HAAA,mBAAmB,OAAA;AAI5B,kEAKyC;AAJvC,sHAAA,oBAAoB,OAAA;AACpB,+GAAA,aAAa,OAAA;AACb,wHAAA,sBAAsB,OAAA;AACtB,kHAAA,gBAAgB,OAAA;AAGlB,aAAa;AACb,8DAA6D;AAApD,4GAAA,YAAY,OAAA;AAIrB,gEAA0E;AAAjE,2HAAA,yBAAyB,OAAA;AAIlC,mDAA6D;AAApD,uHAAA,uBAAuB,OAAA;AAEhC,YAAY;AACZ,uEAAsE;AAA7D,sHAAA,iBAAiB,OAAA;AAE1B,cAAc;AACd,iDAAwD;AAA/C,kHAAA,mBAAmB,OAAA;AAG5B,UAAU;AACV,qFAAiF;AAAxE,mIAAA,sBAAsB,OAAA;AAG/B,cAAc;AACd,iDAAwD;AAA/C,kHAAA,mBAAmB,OAAA;AAG5B,uBAAuB;AACvB,iFAA6E;AAApE,+HAAA,oBAAoB,OAAA;AAG7B,0BAA0B;AAC1B,sGAAkG;AAAzF,mJAAA,8BAA8B,OAAA;AAEvC,YAAY;AACZ,6CAAoD;AAA3C,8GAAA,iBAAiB,OAAA;AAE1B,cAAc;AACd,iDAAwD;AAA/C,kHAAA,mBAAmB,OAAA;AAE5B,sBAAsB;AACtB,yDAA+B;AAE/B,sBAAsB;AACtB,yDAA+B;AAE/B,6BAA6B;AAC7B,gEAAsC;AAEtC,iBAAiB;AACjB,yDAAsD;AAA7C,gHAAA,aAAa,OAAA;AAGtB,2BAA2B;AAC3B,4EAAyE;AAAhE,0HAAA,kBAAkB,OAAA;AAC3B,gFAA4E;AAAnE,6HAAA,mBAAmB,OAAA;AAC5B,2EAAuE;AAA9D,iIAAA,qBAAqB,OAAA;AAE9B,kGAA8F;AAArF,2IAAA,0BAA0B,OAAA"}

package/src/lib/application.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview BrightDbApplication — generic BrightDB-backed application base class.
+ *
+ * Extends the upstream Application with:
+ * - HTTP server capture during start()
+ *
+ * Domain-specific service wiring stays in the consuming library's App subclass.
+ *
+ * @module application
+ */
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import { Application as UpstreamApplication, AppRouter, type IConstants } from '@digitaldefiance/node-express-suite';
+import type { Server } from 'http';
+import type { BrightDbEnvironment } from './environment';
+/**
+ * Generic BrightDB-backed application base class.
+ *
+ * Extends the upstream Application with:
+ * - HTTP server capture during start()
+ *
+ * Domain-specific service wiring stays in the consuming library's App subclass.
+ */
+export declare class BrightDbApplication<TID extends PlatformID, TEnvironment extends BrightDbEnvironment<TID> = BrightDbEnvironment<TID>, TConstants extends IConstants = IConstants, TAppRouter extends AppRouter<TID> = AppRouter<TID>> extends UpstreamApplication<TID, TEnvironment, TConstants, TAppRouter> {
+    /**
+     * Captured HTTP server reference.
+     * The upstream Application stores the server as a private field,
+     * so subclasses intercept expressApp.listen() to capture it here.
+     */
+    protected _httpServer: Server | null;
+    /**
+     * Get the HTTP server instance (available after start()).
+     */
+    get httpServer(): Server | null;
+}
+//# sourceMappingURL=application.d.ts.map

package/src/lib/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/application.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EACL,WAAW,IAAI,mBAAmB,EAClC,SAAS,EACT,KAAK,UAAU,EAChB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD;;;;;;;GAOG;AACH,qBAAa,mBAAmB,CAC9B,GAAG,SAAS,UAAU,EACtB,YAAY,SAAS,mBAAmB,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,EACxE,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1C,UAAU,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAClD,SAAQ,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC;IACtE;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5C;;OAEG;IACH,IAAW,UAAU,IAAI,MAAM,GAAG,IAAI,CAErC;CACF"}

package/src/lib/application.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * @fileoverview BrightDbApplication — generic BrightDB-backed application base class.
+ *
+ * Extends the upstream Application with:
+ * - HTTP server capture during start()
+ *
+ * Domain-specific service wiring stays in the consuming library's App subclass.
+ *
+ * @module application
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbApplication = void 0;
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+/**
+ * Generic BrightDB-backed application base class.
+ *
+ * Extends the upstream Application with:
+ * - HTTP server capture during start()
+ *
+ * Domain-specific service wiring stays in the consuming library's App subclass.
+ */
+class BrightDbApplication extends node_express_suite_1.Application {
+    /**
+     * Captured HTTP server reference.
+     * The upstream Application stores the server as a private field,
+     * so subclasses intercept expressApp.listen() to capture it here.
+     */
+    _httpServer = null;
+    /**
+     * Get the HTTP server instance (available after start()).
+     */
+    get httpServer() {
+        return this._httpServer;
+    }
+}
+exports.BrightDbApplication = BrightDbApplication;
+//# sourceMappingURL=application.js.map

package/src/lib/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/application.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAGH,4EAI6C;AAI7C;;;;;;;GAOG;AACH,MAAa,mBAKX,SAAQ,gCAA8D;IACtE;;;;OAIG;IACO,WAAW,GAAkB,IAAI,CAAC;IAE5C;;OAEG;IACH,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAnBD,kDAmBC"}

package/src/lib/bright-db-model-registry.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview BrightDB model registry — singleton for managing BrightDB
+ * collection registrations. Parallel to upstream's ModelRegistry.
+ *
+ * @module bright-db-model-registry
+ */
+import type { CollectionSchema } from '@digitaldefiance/suite-core-lib';
+import type { BrightDbCollection } from './services/bright-db-collection';
+/**
+ * Registration entry for a BrightDB collection.
+ */
+export interface BrightDbModelRegistration {
+    collectionName: string;
+    schema?: CollectionSchema;
+    collection: BrightDbCollection;
+}
+/**
+ * Singleton registry for BrightDB collections.
+ * Manages collection registration and retrieval across the application.
+ * Parallel to upstream's ModelRegistry for Mongoose models.
+ */
+export declare class BrightDbModelRegistry {
+    private static _instance;
+    private readonly _models;
+    private constructor();
+    /**
+     * Gets the singleton instance of BrightDbModelRegistry.
+     */
+    static get instance(): BrightDbModelRegistry;
+    /**
+     * Creates an isolated registry instance (useful for testing).
+     */
+    static createIsolated(): BrightDbModelRegistry;
+    /**
+     * Registers a collection with the registry.
+     */
+    register(registration: BrightDbModelRegistration): void;
+    /**
+     * Retrieves a collection registration by name.
+     * @throws {Error} If the collection is not registered.
+     */
+    get(modelName: string): BrightDbModelRegistration;
+    /**
+     * Checks if a collection is registered.
+     */
+    has(modelName: string): boolean;
+    /**
+     * Lists all registered collection names.
+     */
+    list(): string[];
+    /**
+     * Clears all registrations (useful for testing).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=bright-db-model-registry.d.ts.map

package/src/lib/bright-db-model-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-model-registry.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/bright-db-model-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IAExE,OAAO;IAEP;;OAEG;IACH,MAAM,KAAK,QAAQ,IAAI,qBAAqB,CAK3C;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,qBAAqB;IAI9C;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,yBAAyB,GAAG,IAAI;IAIvD;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB;IAUjD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/src/lib/bright-db-model-registry.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * @fileoverview BrightDB model registry — singleton for managing BrightDB
+ * collection registrations. Parallel to upstream's ModelRegistry.
+ *
+ * @module bright-db-model-registry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbModelRegistry = void 0;
+/**
+ * Singleton registry for BrightDB collections.
+ * Manages collection registration and retrieval across the application.
+ * Parallel to upstream's ModelRegistry for Mongoose models.
+ */
+class BrightDbModelRegistry {
+    static _instance;
+    _models = new Map();
+    constructor() { }
+    /**
+     * Gets the singleton instance of BrightDbModelRegistry.
+     */
+    static get instance() {
+        if (!BrightDbModelRegistry._instance) {
+            BrightDbModelRegistry._instance = new BrightDbModelRegistry();
+        }
+        return BrightDbModelRegistry._instance;
+    }
+    /**
+     * Creates an isolated registry instance (useful for testing).
+     */
+    static createIsolated() {
+        return new BrightDbModelRegistry();
+    }
+    /**
+     * Registers a collection with the registry.
+     */
+    register(registration) {
+        this._models.set(registration.collectionName, registration);
+    }
+    /**
+     * Retrieves a collection registration by name.
+     * @throws {Error} If the collection is not registered.
+     */
+    get(modelName) {
+        const reg = this._models.get(modelName);
+        if (!reg) {
+            throw new Error(`Model '${modelName}' is not registered in BrightDbModelRegistry.`);
+        }
+        return reg;
+    }
+    /**
+     * Checks if a collection is registered.
+     */
+    has(modelName) {
+        return this._models.has(modelName);
+    }
+    /**
+     * Lists all registered collection names.
+     */
+    list() {
+        return Array.from(this._models.keys());
+    }
+    /**
+     * Clears all registrations (useful for testing).
+     */
+    clear() {
+        this._models.clear();
+    }
+}
+exports.BrightDbModelRegistry = BrightDbModelRegistry;
+//# sourceMappingURL=bright-db-model-registry.js.map

package/src/lib/bright-db-model-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-model-registry.js","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/bright-db-model-registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAcH;;;;GAIG;AACH,MAAa,qBAAqB;IACxB,MAAM,CAAC,SAAS,CAAwB;IAC/B,OAAO,GAAG,IAAI,GAAG,EAAqC,CAAC;IAExE,gBAAuB,CAAC;IAExB;;OAEG;IACH,MAAM,KAAK,QAAQ;QACjB,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,CAAC;YACrC,qBAAqB,CAAC,SAAS,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAChE,CAAC;QACD,OAAO,qBAAqB,CAAC,SAAS,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO,IAAI,qBAAqB,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,YAAuC;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,SAAiB;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,UAAU,SAAS,+CAA+C,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAhED,sDAgEC"}

package/src/lib/brightchain-lib.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports from @brightchain/brightchain-lib.
+ * Only generic infrastructure symbols — NO domain-specific modules.
+ */
+export { BlockSize, BlockStoreType, validBlockSizes, } from '@brightchain/brightchain-lib';
+export type { IBlockStore, IInitResult, } from '@brightchain/brightchain-lib';
+//# sourceMappingURL=brightchain-lib.d.ts.map

package/src/lib/brightchain-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brightchain-lib.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/brightchain-lib.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,WAAW,EACX,WAAW,GACZ,MAAM,8BAA8B,CAAC"}

package/src/lib/brightchain-lib.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validBlockSizes = exports.BlockStoreType = exports.BlockSize = void 0;
+/**
+ * Re-exports from @brightchain/brightchain-lib.
+ * Only generic infrastructure symbols — NO domain-specific modules.
+ */
+var brightchain_lib_1 = require("@brightchain/brightchain-lib");
+Object.defineProperty(exports, "BlockSize", { enumerable: true, get: function () { return brightchain_lib_1.BlockSize; } });
+Object.defineProperty(exports, "BlockStoreType", { enumerable: true, get: function () { return brightchain_lib_1.BlockStoreType; } });
+Object.defineProperty(exports, "validBlockSizes", { enumerable: true, get: function () { return brightchain_lib_1.validBlockSizes; } });
+//# sourceMappingURL=brightchain-lib.js.map

package/src/lib/brightchain-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brightchain-lib.js","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/brightchain-lib.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,gEAIsC;AAHpC,4GAAA,SAAS,OAAA;AACT,iHAAA,cAAc,OAAA;AACd,kHAAA,eAAe,OAAA"}

package/src/lib/brightdb.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports from @brightchain/db.
+ * Consumers can import these through @brightchain/node-express-suite.
+ */
+export { BrightDb, Collection } from '@brightchain/db';
+export type { BsonDocument } from '@brightchain/db';
+//# sourceMappingURL=brightdb.d.ts.map

package/src/lib/brightdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brightdb.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/brightdb.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/src/lib/brightdb.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Collection = exports.BrightDb = void 0;
+/**
+ * Re-exports from @brightchain/db.
+ * Consumers can import these through @brightchain/node-express-suite.
+ */
+var db_1 = require("@brightchain/db");
+Object.defineProperty(exports, "BrightDb", { enumerable: true, get: function () { return db_1.BrightDb; } });
+Object.defineProperty(exports, "Collection", { enumerable: true, get: function () { return db_1.Collection; } });
+//# sourceMappingURL=brightdb.js.map

package/src/lib/brightdb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brightdb.js","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/brightdb.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,sCAAuD;AAA9C,8FAAA,QAAQ,OAAA;AAAE,gGAAA,UAAU,OAAA"}

package/src/lib/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generic BrightDB constants using createExpressConstants with minimal defaults.
+ * Domain-specific constants (site name, tagline, etc.) are set by consuming libraries.
+ */
+export declare const BrightDbConstants: import("@digitaldefiance/node-express-suite").IConstants;
+//# sourceMappingURL=constants.d.ts.map

package/src/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/constants.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,0DAE5B,CAAC"}

package/src/lib/constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbConstants = void 0;
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+/**
+ * Generic BrightDB constants using createExpressConstants with minimal defaults.
+ * Domain-specific constants (site name, tagline, etc.) are set by consuming libraries.
+ */
+exports.BrightDbConstants = (0, node_express_suite_1.createExpressConstants)('localhost', 'localhost', {
+    Site: 'BrightDB',
+});
+//# sourceMappingURL=constants.js.map

package/src/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/constants.ts"],"names":[],"mappings":";;;AAAA,4EAA6E;AAE7E;;;GAGG;AACU,QAAA,iBAAiB,GAAG,IAAA,2CAAsB,EAAC,WAAW,EAAE,WAAW,EAAE;IAChF,IAAI,EAAE,UAAU;CACjB,CAAC,CAAC"}

package/src/lib/create-test-app.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Test utility for creating an in-memory BrightDB plugin instance.
+ *
+ * Useful for integration tests that need a connected BrightDB instance
+ * without requiring a real block store on disk.
+ *
+ * @module create-test-app
+ */
+import { BrightDbDatabasePlugin } from './plugins/bright-db-database-plugin';
+import { BrightDbEnvironment } from './environment';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+export interface CreateTestAppResult<TID extends PlatformID> {
+    plugin: BrightDbDatabasePlugin<TID>;
+    environment: BrightDbEnvironment<TID>;
+    teardown: () => Promise<void>;
+}
+/**
+ * Create a test-friendly BrightDB plugin with in-memory configuration.
+ * Useful for integration tests that need a connected BrightDB instance.
+ */
+export declare function createTestApp<TID extends PlatformID>(envOverrides?: Record<string, string>): Promise<CreateTestAppResult<TID>>;
+//# sourceMappingURL=create-test-app.d.ts.map

package/src/lib/create-test-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-app.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/create-test-app.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,WAAW,mBAAmB,CAAC,GAAG,SAAS,UAAU;IACzD,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACpC,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,SAAS,UAAU,EACxD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAmCnC"}