@brightchain/node-express-suite 0.25.0

package/src/lib/interfaces/bright-db-application.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview BrightDB-specific application interface.
+ * Extends the base IApplication with BrightDB-specific capabilities.
+ * Parallel to upstream's IMongoApplication.
+ *
+ * Use this interface in controllers, services, and middlewares that require
+ * direct access to the BrightDB document store or BrightDB configuration.
+ *
+ * @module interfaces/bright-db-application
+ */
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { IApplication } from '@digitaldefiance/node-express-suite';
+import type { DocumentStore, DocumentCollection, DocumentRecord } from '../datastore/document-store';
+import type { BrightDbEnvironment } from '../environment';
+/**
+ * BrightDB-specific application interface.
+ * Extends IApplication with the BrightDB document store and collection access.
+ *
+ * Use this interface when your code needs:
+ *  - `application.db` (the BrightDB-backed document store)
+ *  - `application.getModel<T>(name)` (BrightDB collection lookup)
+ *  - `application.environment` typed as BrightDbEnvironment
+ *
+ * Non-BrightDB applications should use the base IApplication.
+ */
+export interface IBrightDbApplication<TID extends PlatformID = Buffer> extends IApplication<TID> {
+    /** The BrightDB-backed document store */
+    readonly db: DocumentStore;
+    /** Retrieve a BrightDB collection by name */
+    getModel<U extends DocumentRecord>(modelName: string): DocumentCollection<U>;
+    /** The BrightDB environment */
+    readonly environment: BrightDbEnvironment<TID>;
+}
+//# sourceMappingURL=bright-db-application.d.ts.map

package/src/lib/interfaces/bright-db-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-application.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/interfaces/bright-db-application.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB,CACnC,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,YAAY,CAAC,GAAG,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,CAAC,SAAS,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC7E,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC;CAChD"}

package/src/lib/interfaces/bright-db-application.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @fileoverview BrightDB-specific application interface.
+ * Extends the base IApplication with BrightDB-specific capabilities.
+ * Parallel to upstream's IMongoApplication.
+ *
+ * Use this interface in controllers, services, and middlewares that require
+ * direct access to the BrightDB document store or BrightDB configuration.
+ *
+ * @module interfaces/bright-db-application
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=bright-db-application.js.map

package/src/lib/interfaces/bright-db-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-application.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/interfaces/bright-db-application.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/src/lib/interfaces/environment.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview BrightDB-specific cloud block store configuration interfaces.
+ *
+ * Extracted from brightchain-api-lib so that BrightDbEnvironment can reference
+ * them without depending on api-lib.
+ *
+ * @module interfaces/environment
+ */
+import { ICloudBlockStoreConfig } from '@brightchain/brightchain-lib';
+/**
+ * Azure-specific cloud block store configuration fields.
+ * Extends ICloudBlockStoreConfig with Azure Blob Storage auth options.
+ * Defined here (not in brightchain-azure-store) so consumers
+ * stay free of static cloud SDK dependencies.
+ */
+export interface IAzureEnvironmentConfig extends ICloudBlockStoreConfig {
+    connectionString?: string;
+    accountName?: string;
+    accountKey?: string;
+    useManagedIdentity?: boolean;
+}
+/**
+ * S3-specific cloud block store configuration fields.
+ * Extends ICloudBlockStoreConfig with S3 auth options.
+ * Defined here (not in brightchain-s3-store) so consumers
+ * stay free of static cloud SDK dependencies.
+ */
+export interface IS3EnvironmentConfig extends ICloudBlockStoreConfig {
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    useIamRole?: boolean;
+    endpoint?: string;
+}
+//# sourceMappingURL=environment.d.ts.map

package/src/lib/interfaces/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/interfaces/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/src/lib/interfaces/environment.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * @fileoverview BrightDB-specific cloud block store configuration interfaces.
+ *
+ * Extracted from brightchain-api-lib so that BrightDbEnvironment can reference
+ * them without depending on api-lib.
+ *
+ * @module interfaces/environment
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=environment.js.map

package/src/lib/interfaces/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/interfaces/environment.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/src/lib/middleware/index.d.ts

@@ -0,0 +1,2 @@
+export { validateBody } from './validateBody';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/src/lib/middleware/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBody = void 0;
+var validateBody_1 = require("./validateBody");
+Object.defineProperty(exports, "validateBody", { enumerable: true, get: function () { return validateBody_1.validateBody; } });
+//# sourceMappingURL=index.js.map

package/src/lib/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/middleware/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}

package/src/lib/middleware/validateBody.d.ts

@@ -0,0 +1,13 @@
+import { BrandedInterfaceDefinition } from '@digitaldefiance/branded-interface';
+import type { NextFunction, Request, Response } from 'express';
+/**
+ * Express middleware factory that validates the request body against a
+ * BrandedInterfaceDefinition using safeParseInterface().
+ *
+ * On success: attaches the branded instance to `req.brandedBody` and calls `next()`.
+ * On failure: responds with HTTP 400 and a JSON error body.
+ *
+ * Requirements: 6.1, 6.2, 6.3, 6.4, 6.5
+ */
+export declare function validateBody<T extends Record<string, unknown>>(definition: BrandedInterfaceDefinition<T>): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=validateBody.d.ts.map

package/src/lib/middleware/validateBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateBody.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/middleware/validateBody.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAE3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,UAAU,EAAE,0BAA0B,CAAC,CAAC,CAAC,IAEjC,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAmB/D"}

package/src/lib/middleware/validateBody.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBody = validateBody;
+const branded_interface_1 = require("@digitaldefiance/branded-interface");
+/**
+ * Express middleware factory that validates the request body against a
+ * BrandedInterfaceDefinition using safeParseInterface().
+ *
+ * On success: attaches the branded instance to `req.brandedBody` and calls `next()`.
+ * On failure: responds with HTTP 400 and a JSON error body.
+ *
+ * Requirements: 6.1, 6.2, 6.3, 6.4, 6.5
+ */
+function validateBody(definition) {
+    return (req, res, next) => {
+        if (!req.body || typeof req.body !== 'object' || Array.isArray(req.body)) {
+            res
+                .status(400)
+                .json({ error: 'Request body is missing or not an object' });
+            return;
+        }
+        const result = (0, branded_interface_1.safeParseInterface)(req.body, definition);
+        if (!result.success) {
+            res.status(400).json({
+                error: result.error.message,
+                code: result.error.code,
+                fieldErrors: result.error.fieldErrors ?? [],
+            });
+            return;
+        }
+        req.brandedBody = result.value;
+        next();
+    };
+}
+//# sourceMappingURL=validateBody.js.map

package/src/lib/middleware/validateBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateBody.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/middleware/validateBody.ts"],"names":[],"mappings":";;AAeA,oCAsBC;AArCD,0EAG4C;AAG5C;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAC1B,UAAyC;IAEzC,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzE,GAAG;iBACA,MAAM,CAAC,GAAG,CAAC;iBACX,IAAI,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,IAAA,sCAAkB,EAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;gBAC3B,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBACvB,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE;aAC5C,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACA,GAA0C,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;QACvE,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/middlewares.d.ts

@@ -0,0 +1,9 @@
+import { Application } from 'express';
+/**
+ * Generic BrightDB middleware initialization.
+ * Provides standard Express security middleware without domain-specific CSP.
+ */
+export declare class BrightDbMiddlewares {
+    static init(app: Application): void;
+}
+//# sourceMappingURL=middlewares.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middlewares.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/middlewares.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAoB,MAAM,SAAS,CAAC;AAGxD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAMpC"}

package/src/lib/middlewares.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbMiddlewares = void 0;
+const tslib_1 = require("tslib");
+const cors_1 = tslib_1.__importDefault(require("cors"));
+const express_1 = require("express");
+const helmet_1 = tslib_1.__importDefault(require("helmet"));
+/**
+ * Generic BrightDB middleware initialization.
+ * Provides standard Express security middleware without domain-specific CSP.
+ */
+class BrightDbMiddlewares {
+    static init(app) {
+        app.use((0, helmet_1.default)());
+        app.use((0, cors_1.default)());
+        app.use((0, express_1.json)());
+        app.use((0, express_1.urlencoded)({ extended: true }));
+    }
+}
+exports.BrightDbMiddlewares = BrightDbMiddlewares;
+//# sourceMappingURL=middlewares.js.map

package/src/lib/middlewares.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewares.js","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/middlewares.ts"],"names":[],"mappings":";;;;AAAA,wDAAwB;AACxB,qCAAwD;AACxD,4DAA4B;AAE5B;;;GAGG;AACH,MAAa,mBAAmB;IAC9B,MAAM,CAAC,IAAI,CAAC,GAAgB;QAC1B,GAAG,CAAC,GAAG,CAAC,IAAA,gBAAM,GAAE,CAAC,CAAC;QAClB,GAAG,CAAC,GAAG,CAAC,IAAA,cAAI,GAAE,CAAC,CAAC;QAChB,GAAG,CAAC,GAAG,CAAC,IAAA,cAAI,GAAE,CAAC,CAAC;QAChB,GAAG,CAAC,GAAG,CAAC,IAAA,oBAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;CACF;AAPD,kDAOC"}

package/src/lib/plugins/bright-db-database-plugin.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Generic BrightDB database plugin for the express-suite plugin architecture.
+ *
+ * Implements IDatabasePlugin<TID> to encapsulate the generic BrightDB database
+ * lifecycle: block stores, BrightDb connection/disconnection, and typed accessors.
+ * Domain-specific stores (MemberStore, EnergyAccountStore, etc.) are added by
+ * subclasses in consuming libraries.
+ *
+ * @module plugins/bright-db-database-plugin
+ */
+import type { IBlockStore } from '@brightchain/brightchain-lib';
+import type { BrightDb } from '@brightchain/db';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { IApplication, IAuthenticationProvider, IDatabasePlugin } from '@digitaldefiance/node-express-suite';
+import type { IDatabase } from '@digitaldefiance/suite-core-lib';
+import type { BrightDbEnvironment } from '../environment';
+export interface IBrightDbDatabasePluginOptions {
+    skipAutoSeed?: boolean;
+}
+export declare class BrightDbDatabasePlugin<TID extends PlatformID> implements IDatabasePlugin<TID> {
+    readonly name: string;
+    readonly version: string;
+    protected readonly _environment: BrightDbEnvironment<TID>;
+    protected readonly _skipAutoSeed: boolean;
+    protected _connected: boolean;
+    protected _blockStore: IBlockStore | null;
+    protected _brightDb: BrightDb | null;
+    protected _authProvider: IAuthenticationProvider<TID> | null;
+    constructor(environment: BrightDbEnvironment<TID>, options?: IBrightDbDatabasePluginOptions);
+    /**
+     * The IDatabase instance this plugin manages.
+     * BrightDb implements IDatabase directly, so no adapter is needed.
+     * @throws Error if the plugin is not connected.
+     */
+    get database(): IDatabase;
+    /**
+     * Authentication provider created during init().
+     * Returns undefined before init() is called.
+     */
+    get authenticationProvider(): IAuthenticationProvider<TID> | undefined;
+    /**
+     * Connect the BrightDB database stack.
+     *
+     * Calls brightchainDatabaseInit(environment) and stores the resulting
+     * backend references (blockStore, BrightDb).
+     *
+     * @param _uri - Ignored; BrightDB uses environment-based configuration.
+     * @throws Error if brightchainDatabaseInit() returns a failure result.
+     */
+    connect(_uri?: string): Promise<void>;
+    /**
+     * Disconnect and release all backend references.
+     * Idempotent — calling when already disconnected completes without error.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Whether the database is currently connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Initialize the plugin after connection.
+     * Subclasses override to create domain-specific auth providers.
+     */
+    init(_app: IApplication<TID>): Promise<void>;
+    /**
+     * Stop the plugin. Delegates to disconnect() for cleanup.
+     */
+    stop(): Promise<void>;
+    /**
+     * Provision an ephemeral dev/test block store.
+     * BrightChain doesn't use connection URIs — returns empty string.
+     */
+    setupDevStore(): Promise<string>;
+    /**
+     * Tear down the ephemeral dev/test block store.
+     * disconnect() handles all cleanup — nothing extra needed.
+     */
+    teardownDevStore(): Promise<void>;
+    /**
+     * Seed the dev database after connection.
+     * Subclasses override with domain-specific seeding.
+     */
+    initializeDevStore(): Promise<unknown>;
+    /**
+     * The block store backing the BrightDB database.
+     * @throws Error if the plugin is not connected.
+     */
+    get blockStore(): IBlockStore;
+    /**
+     * The BrightDb instance (implements IDatabase).
+     * @throws Error if the plugin is not connected.
+     */
+    get brightDb(): BrightDb;
+}
+//# sourceMappingURL=bright-db-database-plugin.d.ts.map

package/src/lib/plugins/bright-db-database-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-database-plugin.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/plugins/bright-db-database-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACvB,eAAe,EAChB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,8BAA8B;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,sBAAsB,CAAC,GAAG,SAAS,UAAU,CACxD,YAAW,eAAe,CAAC,GAAG,CAAC;IAE/B,SAAgB,IAAI,EAAE,MAAM,CAAc;IAC1C,SAAgB,OAAO,EAAE,MAAM,CAAW;IAE1C,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC1D,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAC1C,SAAS,CAAC,UAAU,UAAS;IAC7B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAQ;IACjD,SAAS,CAAC,SAAS,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC5C,SAAS,CAAC,aAAa,EAAE,uBAAuB,CAAC,GAAG,CAAC,GAAG,IAAI,CAAQ;gBAGlE,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,EACrC,OAAO,GAAE,8BAAmC;IAQ9C;;;;OAIG;IACH,IAAI,QAAQ,IAAI,SAAS,CAOxB;IAED;;;OAGG;IACH,IAAI,sBAAsB,IAAI,uBAAuB,CAAC,GAAG,CAAC,GAAG,SAAS,CAErE;IAED;;;;;;;;OAQG;IACG,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAO5C;;;OAGG;IACH,IAAI,UAAU,IAAI,WAAW,CAO5B;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAOvB;CACF"}

package/src/lib/plugins/bright-db-database-plugin.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * @fileoverview Generic BrightDB database plugin for the express-suite plugin architecture.
+ *
+ * Implements IDatabasePlugin<TID> to encapsulate the generic BrightDB database
+ * lifecycle: block stores, BrightDb connection/disconnection, and typed accessors.
+ * Domain-specific stores (MemberStore, EnergyAccountStore, etc.) are added by
+ * subclasses in consuming libraries.
+ *
+ * @module plugins/bright-db-database-plugin
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbDatabasePlugin = void 0;
+const databaseInit_1 = require("../databaseInit");
+class BrightDbDatabasePlugin {
+    name = 'brightdb';
+    version = '1.0.0';
+    _environment;
+    _skipAutoSeed;
+    _connected = false;
+    _blockStore = null;
+    _brightDb = null;
+    _authProvider = null;
+    constructor(environment, options = {}) {
+        this._environment = environment;
+        this._skipAutoSeed = options.skipAutoSeed ?? false;
+    }
+    // ── IDatabasePlugin contract ──────────────────────────────────────
+    /**
+     * The IDatabase instance this plugin manages.
+     * BrightDb implements IDatabase directly, so no adapter is needed.
+     * @throws Error if the plugin is not connected.
+     */
+    get database() {
+        if (!this._brightDb) {
+            throw new Error('BrightDbDatabasePlugin: cannot access "database" — plugin is not connected. Call connect() first.');
+        }
+        return this._brightDb;
+    }
+    /**
+     * Authentication provider created during init().
+     * Returns undefined before init() is called.
+     */
+    get authenticationProvider() {
+        return this._authProvider ?? undefined;
+    }
+    /**
+     * Connect the BrightDB database stack.
+     *
+     * Calls brightchainDatabaseInit(environment) and stores the resulting
+     * backend references (blockStore, BrightDb).
+     *
+     * @param _uri - Ignored; BrightDB uses environment-based configuration.
+     * @throws Error if brightchainDatabaseInit() returns a failure result.
+     */
+    async connect(_uri) {
+        const initResult = await (0, databaseInit_1.brightchainDatabaseInit)(this._environment);
+        if (!initResult.success || !initResult.backend) {
+            throw new Error(`BrightDB database initialization failed: ${initResult.error ?? 'unknown error'}`);
+        }
+        this._blockStore = initResult.backend.blockStore;
+        this._brightDb = initResult.backend.db;
+        this._connected = true;
+    }
+    /**
+     * Disconnect and release all backend references.
+     * Idempotent — calling when already disconnected completes without error.
+     */
+    async disconnect() {
+        if (!this._connected)
+            return;
+        this._blockStore = null;
+        this._brightDb = null;
+        this._authProvider = null;
+        this._connected = false;
+    }
+    /**
+     * Whether the database is currently connected.
+     */
+    isConnected() {
+        return this._connected;
+    }
+    /**
+     * Initialize the plugin after connection.
+     * Subclasses override to create domain-specific auth providers.
+     */
+    async init(_app) {
+        // Subclasses override to create domain-specific auth providers
+    }
+    /**
+     * Stop the plugin. Delegates to disconnect() for cleanup.
+     */
+    async stop() {
+        await this.disconnect();
+    }
+    // ── Dev store lifecycle hooks ─────────────────────────────────────
+    /**
+     * Provision an ephemeral dev/test block store.
+     * BrightChain doesn't use connection URIs — returns empty string.
+     */
+    async setupDevStore() {
+        console.log('[BrightDB] Dev database mode — using ephemeral MemoryBlockStore.');
+        return '';
+    }
+    /**
+     * Tear down the ephemeral dev/test block store.
+     * disconnect() handles all cleanup — nothing extra needed.
+     */
+    async teardownDevStore() {
+        // disconnect() handles cleanup
+    }
+    /**
+     * Seed the dev database after connection.
+     * Subclasses override with domain-specific seeding.
+     */
+    async initializeDevStore() {
+        // Subclasses override with domain-specific seeding
+        return {};
+    }
+    // ── Typed accessors ───────────────────────────────────────────────
+    /**
+     * The block store backing the BrightDB database.
+     * @throws Error if the plugin is not connected.
+     */
+    get blockStore() {
+        if (!this._blockStore) {
+            throw new Error('BrightDbDatabasePlugin: cannot access "blockStore" — plugin is not connected. Call connect() first.');
+        }
+        return this._blockStore;
+    }
+    /**
+     * The BrightDb instance (implements IDatabase).
+     * @throws Error if the plugin is not connected.
+     */
+    get brightDb() {
+        if (!this._brightDb) {
+            throw new Error('BrightDbDatabasePlugin: cannot access "brightDb" — plugin is not connected. Call connect() first.');
+        }
+        return this._brightDb;
+    }
+}
+exports.BrightDbDatabasePlugin = BrightDbDatabasePlugin;
+//# sourceMappingURL=bright-db-database-plugin.js.map

package/src/lib/plugins/bright-db-database-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-database-plugin.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/plugins/bright-db-database-plugin.ts"],"names":[],"mappings":"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"}

package/src/lib/plugins/configure-bright-db-app.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Generic BrightDB application configuration helper.
+ *
+ * Creates a BrightDbDatabasePlugin and registers it on the application.
+ * Domain-specific setup (GUID provider, constants, initializeBrightChain)
+ * is handled by the consuming library's configureBrightChainApp.
+ *
+ * @module plugins/configure-bright-db-app
+ */
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { IApplication } from '@digitaldefiance/node-express-suite';
+import { BrightDbDatabasePlugin, type IBrightDbDatabasePluginOptions } from './bright-db-database-plugin';
+import type { BrightDbEnvironment } from '../environment';
+export interface ConfigureBrightDbAppResult<TID extends PlatformID> {
+    plugin: BrightDbDatabasePlugin<TID>;
+}
+/**
+ * Configure a generic BrightDB application with the database plugin.
+ *
+ * Creates a BrightDbDatabasePlugin and registers it on the application.
+ * Domain-specific setup (GUID provider, constants, initializeBrightChain)
+ * is handled by the consuming library's configureBrightChainApp.
+ */
+export declare function configureBrightDbApp<TID extends PlatformID>(app: IApplication<TID>, environment: BrightDbEnvironment<TID>, pluginOptions?: IBrightDbDatabasePluginOptions): ConfigureBrightDbAppResult<TID>;
+//# sourceMappingURL=configure-bright-db-app.d.ts.map

package/src/lib/plugins/configure-bright-db-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-bright-db-app.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/plugins/configure-bright-db-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,KAAK,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,0BAA0B,CAAC,GAAG,SAAS,UAAU;IAChE,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,UAAU,EACzD,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,EACtB,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,EACrC,aAAa,GAAE,8BAAmC,GACjD,0BAA0B,CAAC,GAAG,CAAC,CAUjC"}

package/src/lib/plugins/configure-bright-db-app.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * @fileoverview Generic BrightDB application configuration helper.
+ *
+ * Creates a BrightDbDatabasePlugin and registers it on the application.
+ * Domain-specific setup (GUID provider, constants, initializeBrightChain)
+ * is handled by the consuming library's configureBrightChainApp.
+ *
+ * @module plugins/configure-bright-db-app
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureBrightDbApp = configureBrightDbApp;
+const bright_db_database_plugin_1 = require("./bright-db-database-plugin");
+/**
+ * Configure a generic BrightDB application with the database plugin.
+ *
+ * Creates a BrightDbDatabasePlugin and registers it on the application.
+ * Domain-specific setup (GUID provider, constants, initializeBrightChain)
+ * is handled by the consuming library's configureBrightChainApp.
+ */
+function configureBrightDbApp(app, environment, pluginOptions = {}) {
+    const plugin = new bright_db_database_plugin_1.BrightDbDatabasePlugin(environment, pluginOptions);
+    if ('useDatabasePlugin' in app && typeof app.useDatabasePlugin === 'function') {
+        app.useDatabasePlugin(plugin);
+    }
+    else {
+        app.plugins.register(plugin);
+    }
+    return { plugin };
+}
+//# sourceMappingURL=configure-bright-db-app.js.map

package/src/lib/plugins/configure-bright-db-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-bright-db-app.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/plugins/configure-bright-db-app.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAkBH,oDAcC;AA5BD,2EAA0G;AAO1G;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,GAAsB,EACtB,WAAqC,EACrC,gBAAgD,EAAE;IAElD,MAAM,MAAM,GAAG,IAAI,kDAAsB,CAAM,WAAW,EAAE,aAAa,CAAC,CAAC;IAE3E,IAAI,mBAAmB,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAC9E,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/src/lib/services/bright-db-authentication-provider.d.ts

@@ -0,0 +1,31 @@
+import type { BrightDb } from '@brightchain/db';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { IAuthenticatedUser, IAuthenticationProvider } from '@digitaldefiance/node-express-suite';
+import type { IRequestUserDTO, ITokenUser } from '@digitaldefiance/suite-core-lib';
+/**
+ * Generic BrightDB-backed authentication provider.
+ *
+ * Provides basic user lookup from BrightDB `users` collection and JWT
+ * token verification. Domain-specific auth (MemberStore, mnemonic auth,
+ * password auth) is added by subclasses.
+ */
+export declare class BrightDbAuthenticationProvider<TID extends PlatformID = Buffer, TLanguage extends string = string> implements IAuthenticationProvider<TID, TLanguage> {
+    protected readonly db: BrightDb;
+    protected readonly jwtSecret: string;
+    constructor(db: BrightDb, jwtSecret: string);
+    /**
+     * Find a user by ID from the `users` collection.
+     * Subclasses override to try MemberStore first.
+     */
+    findUserById(userId: string): Promise<IAuthenticatedUser<TLanguage> | null>;
+    /**
+     * Build a request user DTO from the `users` collection.
+     * Subclasses override to try MemberStore first.
+     */
+    buildRequestUserDTO(userId: string): Promise<IRequestUserDTO | null>;
+    /**
+     * Verify a JWT token and return the decoded user.
+     */
+    verifyToken<TTokenUser extends ITokenUser = ITokenUser>(token: string): Promise<TTokenUser | null>;
+}
+//# sourceMappingURL=bright-db-authentication-provider.d.ts.map

package/src/lib/services/bright-db-authentication-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-authentication-provider.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/services/bright-db-authentication-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACX,MAAM,iCAAiC,CAAC;AAGzC;;;;;;GAMG;AACH,qBAAa,8BAA8B,CACzC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,SAAS,SAAS,MAAM,GAAG,MAAM,CACjC,YAAW,uBAAuB,CAAC,GAAG,EAAE,SAAS,CAAC;IAGhD,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ;IAC/B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;gBADjB,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM;IAGtC;;;OAGG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IA2BhD;;;OAGG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0C1E;;OAEG;IACG,WAAW,CAAC,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1D,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAW9B"}