@brightchain/brightchain-api-lib 0.15.0 → 0.17.0

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@brightchain/brightchain-api-lib",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "dependencies": {
     "@aws-sdk/client-ses": "^3.859.0",
-    "@brightchain/brightchain-lib": "0.15.0",
+    "@brightchain/brightchain-lib": "0.17.0",
     "@digitaldefiance/branded-enum": "^0.0.7",
     "@digitaldefiance/enclave-bridge-client": "^1.1.0",
-    "@digitaldefiance/i18n-lib": "^4.5.0",
-    "@digitaldefiance/node-ecies-lib": "^4.18.0",
+    "@digitaldefiance/i18n-lib": "^4.6.3",
+    "@digitaldefiance/node-ecies-lib": "^4.19.4",
     "@ethereumjs/wallet": "^10.0.0",
     "bip39": "^3.1.0",
     "buffer": "^6.0.3",

package/src/browser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser-safe exports from brightchain-api-lib
+ *
+ * This file exports only the types and constants that are safe to use
+ * in browser environments, excluding Node.js-specific implementations.
+ */
+export * from './lib/constants';
+export * from './lib/enumerations';
+export * from './lib/errors';
+export type { IApiConstants } from './lib/interfaces/api-constants';
+export type { ClientSession, DefaultBackendIdType, SchemaMap, } from './lib/shared-types';
+export * from './lib/browserKeyring';
+//# sourceMappingURL=browser.d.ts.map

package/src/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../brightchain-api-lib/src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAG7B,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAG5B,cAAc,sBAAsB,CAAC"}

package/src/browser.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Browser-safe exports from brightchain-api-lib
+ *
+ * This file exports only the types and constants that are safe to use
+ * in browser environments, excluding Node.js-specific implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// Export only constants and types, no Node.js implementations
+tslib_1.__exportStar(require("./lib/constants"), exports);
+tslib_1.__exportStar(require("./lib/enumerations"), exports);
+tslib_1.__exportStar(require("./lib/errors"), exports);
+// Export browser-safe keyring
+tslib_1.__exportStar(require("./lib/browserKeyring"), exports);
+//# sourceMappingURL=browser.js.map

package/src/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../brightchain-api-lib/src/browser.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,8DAA8D;AAC9D,0DAAgC;AAChC,6DAAmC;AACnC,uDAA6B;AAU7B,8BAA8B;AAC9B,+DAAqC"}

package/src/index.d.ts

@@ -1,22 +1,26 @@
 export * from './lib/stores';
 export * from './lib/transforms';
 export * from './lib/services';
+export * from './lib/adapters/brightChainDbDocumentStoreAdapter';
+export * from './lib/databaseInit';
 export * from './lib/appConstants';
 export * from './lib/application';
-export * from './lib/application-base';
 export * from './lib/constants';
 export * from './lib/controllers';
+export * from './lib/upstream-stubs';
 export * from './lib/enumerations';
 export * from './lib/environment';
 export * from './lib/errors';
 export * from './lib/interfaces';
 export * from './lib/datastore';
+export * from './lib/middleware';
 export * from './lib/middlewares';
 export * from './lib/routers';
 export * from './lib/availability';
 export * from './lib/blockFetch';
 export * from './lib/utils/errorResponse';
 export * from './lib/utils/type-converters';
+export * from './lib/validation/userValidation';
 export type { ClientSession, DefaultBackendIdType, SchemaMap, } from './lib/shared-types';
 export * from './lib/auth';
 export * from './lib/encryption';

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../brightchain-api-lib/src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAElC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAKjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAG9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAE5C,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../brightchain-api-lib/src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kDAAkD,CAAC;AACjE,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AAErC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAKjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAG9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAG5C,cAAc,iCAAiC,CAAC;AAEhD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC"}

package/src/index.js

@@ -6,12 +6,15 @@ tslib_1.__exportStar(require("./lib/stores"), exports);
 tslib_1.__exportStar(require("./lib/transforms"), exports);
 // Export Node.js specific services
 tslib_1.__exportStar(require("./lib/services"), exports);
+// Database initialization
+tslib_1.__exportStar(require("./lib/adapters/brightChainDbDocumentStoreAdapter"), exports);
+tslib_1.__exportStar(require("./lib/databaseInit"), exports);
 // API lib exports
 tslib_1.__exportStar(require("./lib/appConstants"), exports);
 tslib_1.__exportStar(require("./lib/application"), exports);
-tslib_1.__exportStar(require("./lib/application-base"), exports);
 tslib_1.__exportStar(require("./lib/constants"), exports);
 tslib_1.__exportStar(require("./lib/controllers"), exports);
+tslib_1.__exportStar(require("./lib/upstream-stubs"), exports);
 // Note: UserController is exported from controllers/api, not controllers/user (which is the legacy location)
 tslib_1.__exportStar(require("./lib/enumerations"), exports);
 tslib_1.__exportStar(require("./lib/environment"), exports);
@@ -21,6 +24,7 @@ tslib_1.__exportStar(require("./lib/interfaces"), exports);
 // Duplicate with brightchain-lib: export * from './lib/interfaces/token-user';
 // Duplicate with brightchain-lib: export * from './lib/interfaces/wallet-seed';
 tslib_1.__exportStar(require("./lib/datastore"), exports);
+tslib_1.__exportStar(require("./lib/middleware"), exports);
 tslib_1.__exportStar(require("./lib/middlewares"), exports);
 tslib_1.__exportStar(require("./lib/routers"), exports);
 // Note: FEC types (ParityData, FecRecoveryResult, IFecService) are re-exported from brightchain-lib
@@ -29,6 +33,8 @@ tslib_1.__exportStar(require("./lib/availability"), exports);
 tslib_1.__exportStar(require("./lib/blockFetch"), exports);
 tslib_1.__exportStar(require("./lib/utils/errorResponse"), exports);
 tslib_1.__exportStar(require("./lib/utils/type-converters"), exports);
+// Validation utilities
+tslib_1.__exportStar(require("./lib/validation/userValidation"), exports);
 // Auth exports
 tslib_1.__exportStar(require("./lib/auth"), exports);
 // Encryption exports

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../brightchain-api-lib/src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACrC,uDAA6B;AAC7B,2DAAiC;AAEjC,mCAAmC;AACnC,yDAA+B;AAE/B,kBAAkB;AAClB,6DAAmC;AACnC,4DAAkC;AAClC,iEAAuC;AACvC,0DAAgC;AAChC,4DAAkC;AAClC,6GAA6G;AAC7G,6DAAmC;AACnC,4DAAkC;AAClC,uDAA6B;AAC7B,2DAAiC;AACjC,iGAAiG;AACjG,+EAA+E;AAC/E,gFAAgF;AAEhF,0DAAgC;AAChC,4DAAkC;AAClC,wDAA8B;AAC9B,oGAAoG;AACpG,kFAAkF;AAClF,6DAAmC;AACnC,2DAAiC;AACjC,oEAA0C;AAC1C,sEAA4C;AAQ5C,eAAe;AACf,qDAA2B;AAE3B,qBAAqB;AACrB,2DAAiC;AAEjC,kBAAkB;AAClB,+DAAqC;AACrC,4DAAkC;AAClC,qEAA2C;AAC3C,8DAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../brightchain-api-lib/src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACrC,uDAA6B;AAC7B,2DAAiC;AAEjC,mCAAmC;AACnC,yDAA+B;AAE/B,0BAA0B;AAC1B,2FAAiE;AACjE,6DAAmC;AAEnC,kBAAkB;AAClB,6DAAmC;AACnC,4DAAkC;AAClC,0DAAgC;AAChC,4DAAkC;AAClC,+DAAqC;AACrC,6GAA6G;AAC7G,6DAAmC;AACnC,4DAAkC;AAClC,uDAA6B;AAC7B,2DAAiC;AACjC,iGAAiG;AACjG,+EAA+E;AAC/E,gFAAgF;AAEhF,0DAAgC;AAChC,2DAAiC;AACjC,4DAAkC;AAClC,wDAA8B;AAC9B,oGAAoG;AACpG,kFAAkF;AAClF,6DAAmC;AACnC,2DAAiC;AACjC,oEAA0C;AAC1C,sEAA4C;AAE5C,uBAAuB;AACvB,0EAAgD;AAQhD,eAAe;AACf,qDAA2B;AAE3B,qBAAqB;AACrB,2DAAiC;AAEjC,kBAAkB;AAClB,+DAAqC;AACrC,4DAAkC;AAClC,qEAA2C;AAC3C,8DAAoC"}

package/src/lib/adapters/brightChainDbDocumentStoreAdapter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Adapter that wraps BrightChainDb as an IDocumentStore.
+ *
+ * BrightChainDb's Collection.find() returns a Cursor synchronously, while
+ * IDocumentStore expects find() to return Promise<IDocumentCursor<T>>.
+ * This thin adapter bridges the structural mismatch so that
+ * EnergyAccountStore (in brightchain-lib) can use BrightChainDb for
+ * persistence without depending on brightchain-db directly.
+ *
+ * @module adapters/brightChainDbDocumentStoreAdapter
+ */
+import type { IDocumentCollection, IDocumentStore } from '@brightchain/brightchain-lib';
+import type { BrightChainDb } from '@brightchain/db';
+/**
+ * Wraps a BrightChainDb instance to satisfy the IDocumentStore interface.
+ */
+export declare class BrightChainDbDocumentStoreAdapter implements IDocumentStore {
+    private readonly db;
+    constructor(db: BrightChainDb);
+    collection<T>(name: string): IDocumentCollection<T>;
+    connect(uri?: string): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=brightChainDbDocumentStoreAdapter.d.ts.map

package/src/lib/adapters/brightChainDbDocumentStoreAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brightChainDbDocumentStoreAdapter.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/adapters/brightChainDbDocumentStoreAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,iBAAiB,CAAC;AAEnE;;GAEG;AACH,qBAAa,iCAAkC,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAE9C,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC;IAgC7C,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,WAAW,IAAI,OAAO;CAGvB"}

package/src/lib/adapters/brightChainDbDocumentStoreAdapter.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * @fileoverview Adapter that wraps BrightChainDb as an IDocumentStore.
+ *
+ * BrightChainDb's Collection.find() returns a Cursor synchronously, while
+ * IDocumentStore expects find() to return Promise<IDocumentCursor<T>>.
+ * This thin adapter bridges the structural mismatch so that
+ * EnergyAccountStore (in brightchain-lib) can use BrightChainDb for
+ * persistence without depending on brightchain-db directly.
+ *
+ * @module adapters/brightChainDbDocumentStoreAdapter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightChainDbDocumentStoreAdapter = void 0;
+/**
+ * Wraps a BrightChainDb instance to satisfy the IDocumentStore interface.
+ */
+class BrightChainDbDocumentStoreAdapter {
+    constructor(db) {
+        this.db = db;
+    }
+    collection(name) {
+        const coll = this.db.collection(name);
+        return {
+            async find(filter) {
+                // Collection.find() returns a Cursor synchronously; wrap it
+                // as a Promise<IDocumentCursor<T>> by resolving immediately.
+                const cursor = coll.find(filter);
+                return {
+                    async toArray() {
+                        const docs = await cursor.toArray();
+                        return docs;
+                    },
+                };
+            },
+            async replaceOne(filter, doc, options) {
+                await coll.replaceOne(filter, doc, options);
+            },
+            async deleteOne(filter) {
+                const result = await coll.deleteOne(filter);
+                return result.deletedCount > 0;
+            },
+        };
+    }
+    async connect(uri) {
+        await this.db.connect(uri);
+    }
+    isConnected() {
+        return this.db.isConnected();
+    }
+}
+exports.BrightChainDbDocumentStoreAdapter = BrightChainDbDocumentStoreAdapter;
+//# sourceMappingURL=brightChainDbDocumentStoreAdapter.js.map

package/src/lib/adapters/brightChainDbDocumentStoreAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brightChainDbDocumentStoreAdapter.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/adapters/brightChainDbDocumentStoreAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AASH;;GAEG;AACH,MAAa,iCAAiC;IAC5C,YAA6B,EAAiB;QAAjB,OAAE,GAAF,EAAE,CAAe;IAAG,CAAC;IAElD,UAAU,CAAI,IAAY;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAe,IAAI,CAAC,CAAC;QACpD,OAAO;YACL,KAAK,CAAC,IAAI,CAAC,MAAkB;gBAC3B,4DAA4D;gBAC5D,6DAA6D;gBAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAA+B,CAAC,CAAC;gBAC1D,OAAO;oBACL,KAAK,CAAC,OAAO;wBACX,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;wBACpC,OAAO,IAAW,CAAC;oBACrB,CAAC;iBACF,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,UAAU,CACd,MAAkB,EAClB,GAAM,EACN,OAA8B;gBAE9B,MAAM,IAAI,CAAC,UAAU,CACnB,MAA+B,EAC/B,GAAmB,EACnB,OAAO,CACR,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,SAAS,CAAC,MAAkB;gBAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAA+B,CAAC,CAAC;gBACrE,OAAO,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;YACjC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAY;QACxB,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC;CACF;AA1CD,8EA0CC"}

package/src/lib/application-base.d.ts

@@ -1,40 +1,11 @@
-import { PlatformID } from '@digitaldefiance/node-ecies-lib';
-import { IApplication, IBaseDocument, IConstants, PluginManager, ServiceContainer } from '@digitaldefiance/node-express-suite';
-import { DocumentStore } from './datastore/document-store';
-import { Environment } from './environment';
-import type { DefaultBackendIdType } from './shared-types';
 /**
- * Base Application class with core functionality
+ * @deprecated This file is no longer used.
+ *
+ * The local BaseApplication class has been removed as part of the upstream
+ * Application refactor. BrightChain's App<TID> now extends the upstream
+ * Application from @digitaldefiance/node-express-suite directly, and
+ * manages DocumentStore/BlockDocumentStore internally.
+ *
+ * See: brightchain-api-lib/src/lib/application.ts
  */
-export declare class BaseApplication<TID extends PlatformID = DefaultBackendIdType> implements IApplication<TID> {
-    private _environment;
-    get environment(): Environment<TID>;
-    get constants(): IConstants;
-    get db(): any;
-    private _services;
-    get services(): ServiceContainer;
-    private _plugins;
-    get plugins(): PluginManager<TID>;
-    getModel<U extends IBaseDocument<any, any>>(modelName: string): U;
-    reloadEnvironment(path?: string, override?: boolean): void;
-    static get distDir(): string;
-    /**
-     * Flag indicating whether the application is ready to handle requests
-     */
-    protected _ready: boolean;
-    /**
-     * Get whether the application is ready to handle requests
-     */
-    get ready(): boolean;
-    constructor(environment: Environment<TID>, documentStore?: DocumentStore);
-    private readonly documentStore;
-    /**
-     * Start the application and connect to the database
-     */
-    start(delayReady?: boolean): Promise<void>;
-    /**
-     * Stop the application
-     */
-    stop(): Promise<void>;
-}
 //# sourceMappingURL=application-base.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"application-base.d.ts","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/application-base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EACjB,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,qBAAa,eAAe,CAC1B,GAAG,SAAS,UAAU,GAAG,oBAAoB,CAC7C,YAAW,YAAY,CAAC,GAAG,CAAC;IAC5B,OAAO,CAAC,YAAY,CAAmB;IACvC,IAAW,WAAW,IAAI,WAAW,CAAC,GAAG,CAAC,CAEzC;IAED,IAAW,SAAS,IAAI,UAAU,CAEjC;IAED,IAAW,EAAE,IAAI,GAAG,CAEnB;IAED,OAAO,CAAC,SAAS,CAA+B;IAChD,IAAW,QAAQ,IAAI,gBAAgB,CAKtC;IAED,OAAO,CAAC,QAAQ,CAAiC;IACjD,IAAW,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,CAKvC;IAEM,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC;IAMjE,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI;IAI9D,WAAkB,OAAO,IAAI,MAAM,CAIlC;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,IAAW,KAAK,IAAI,OAAO,CAE1B;gBAEW,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,EAAE,aAAa;IAQxE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C;;OAEG;IACU,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAevD;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}
+{"version":3,"file":"application-base.d.ts","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/application-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/src/lib/application-base.js

@@ -1,84 +1,12 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseApplication = void 0;
-/* eslint-disable @typescript-eslint/no-explicit-any */
-const brightchain_lib_1 = require("@brightchain/brightchain-lib");
-const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
-const path_1 = require("path");
-const appConstants_1 = require("./appConstants");
-const block_document_store_1 = require("./datastore/block-document-store");
-const environment_1 = require("./environment");
 /**
- * Base Application class with core functionality
+ * @deprecated This file is no longer used.
+ *
+ * The local BaseApplication class has been removed as part of the upstream
+ * Application refactor. BrightChain's App<TID> now extends the upstream
+ * Application from @digitaldefiance/node-express-suite directly, and
+ * manages DocumentStore/BlockDocumentStore internally.
+ *
+ * See: brightchain-api-lib/src/lib/application.ts
  */
-class BaseApplication {
-    get environment() {
-        return this._environment;
-    }
-    get constants() {
-        return appConstants_1.AppConstants;
-    }
-    get db() {
-        return this.documentStore;
-    }
-    get services() {
-        if (!this._services) {
-            this._services = new node_express_suite_1.ServiceContainer();
-        }
-        return this._services;
-    }
-    get plugins() {
-        if (!this._plugins) {
-            this._plugins = new node_express_suite_1.PluginManager();
-        }
-        return this._plugins;
-    }
-    getModel(modelName) {
-        // Get a collection from the in-memory document store
-        const collection = this.documentStore.collection(modelName);
-        return collection;
-    }
-    reloadEnvironment(path, override = true) {
-        this._environment = new environment_1.Environment(path, false, override);
-    }
-    static get distDir() {
-        const cwd = process.cwd();
-        const distPath = (0, path_1.join)(cwd, 'dist');
-        return distPath;
-    }
-    /**
-     * Get whether the application is ready to handle requests
-     */
-    get ready() {
-        return this._ready;
-    }
-    constructor(environment, documentStore) {
-        this._ready = false;
-        this._environment = environment;
-        this.documentStore =
-            documentStore ??
-                new block_document_store_1.BlockDocumentStore(new brightchain_lib_1.MemoryBlockStore(brightchain_lib_1.BlockSize.Small));
-    }
-    /**
-     * Start the application and connect to the database
-     */
-    async start(delayReady) {
-        if (this._ready) {
-            console.error('Failed to start the application:', 'Application is already running');
-            const err = new Error('Application is already running');
-            if (process.env['NODE_ENV'] === 'test') {
-                throw err;
-            }
-            process.exit(1);
-        }
-        this._ready = delayReady ? false : true;
-    }
-    /**
-     * Stop the application
-     */
-    async stop() {
-        this._ready = false;
-    }
-}
-exports.BaseApplication = BaseApplication;
 //# sourceMappingURL=application-base.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"application-base.js","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/application-base.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,kEAA2E;AAE3E,4EAM6C;AAC7C,+BAA4B;AAC5B,iDAA8C;AAC9C,2EAAsE;AAEtE,+CAA4C;AAG5C;;GAEG;AACH,MAAa,eAAe;IAI1B,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAW,SAAS;QAClB,OAAO,2BAAY,CAAC;IACtB,CAAC;IAED,IAAW,EAAE;QACX,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAGD,IAAW,QAAQ;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,qCAAgB,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAGD,IAAW,OAAO;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,kCAAa,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEM,QAAQ,CAAoC,SAAiB;QAClE,qDAAqD;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO,UAA0B,CAAC;IACpC,CAAC;IAEM,iBAAiB,CAAC,IAAa,EAAE,QAAQ,GAAG,IAAI;QACrD,IAAI,CAAC,YAAY,GAAG,IAAI,yBAAW,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAEM,MAAM,KAAK,OAAO;QACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAOD;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,YAAY,WAA6B,EAAE,aAA6B;QACtE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,aAAa;YAChB,aAAa;gBACb,IAAI,yCAAkB,CAAC,IAAI,kCAAgB,CAAC,2BAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,CAAC;IAID;;OAEG;IACI,KAAK,CAAC,KAAK,CAAC,UAAoB;QACrC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CACX,kCAAkC,EAClC,gCAAgC,CACjC,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACxD,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC;gBACvC,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;CACF;AA9FD,0CA8FC"}
+{"version":3,"file":"application-base.js","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/application-base.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/src/lib/application.d.ts

@@ -1,27 +1,60 @@
 import { IAvailabilityService, IDiscoveryProtocol, IReconciliationService } from '@brightchain/brightchain-lib';
 import { PlatformID } from '@digitaldefiance/node-ecies-lib';
-import { Application } from 'express';
-import { BaseApplication } from './application-base';
+import { IConstants, Application as UpstreamApplication } from '@digitaldefiance/node-express-suite';
+import { GossipService } from './availability/gossipService';
+import { PoolDiscoveryService } from './availability/poolDiscoveryService';
+import { DocumentCollection, DocumentRecord, DocumentStore } from './datastore/document-store';
 import { Environment } from './environment';
+import { IBrightChainInitResult } from './interfaces/brightchain-init-result';
 import { ApiRouter } from './routers/api';
+import { AppRouter } from './routers/app';
+import { ClientWebSocketServer } from './services/clientWebSocketServer';
 import { EventNotificationSystem } from './services/eventNotificationSystem';
 import { MessagePassingService } from './services/messagePassingService';
 import { WebSocketMessageServer } from './services/webSocketMessageServer';
 /**
- * Application class
+ * Application class for BrightChain.
+ *
+ * Extends the upstream Application from @digitaldefiance/node-express-suite,
+ * inheriting HTTP/HTTPS server lifecycle, greenlock/Let's Encrypt support,
+ * middleware initialization, and graceful shutdown.
+ *
+ * BrightChain-specific concerns (services, WebSocket, UPnP, EventNotificationSystem)
+ * are initialized after the upstream start() completes.
+ *
+ * Mongoose-related upstream parameters are satisfied with no-op stubs since
+ * BrightChain uses DocumentStore/BlockDocumentStore instead.
  */
-export declare class App<TID extends PlatformID> extends BaseApplication<TID> {
-    readonly expressApp: Application;
-    private server;
+export declare class App<TID extends PlatformID> extends UpstreamApplication<IBrightChainInitResult<TID>, Record<string, never>, TID, Environment<TID>, IConstants, AppRouter<TID>> {
     private controllers;
     private readonly keyStorage;
+    private readonly _brightchainDocumentStore;
     private apiRouter;
     private eventSystem;
     private wsServer;
+    private clientWsServer;
     private messagePassingService;
     private upnpManager;
+    /**
+     * Captured HTTP server reference for WebSocket attachment.
+     * The upstream Application stores the server as a private field,
+     * so we intercept expressApp.listen() to capture it here.
+     */
+    private _httpServer;
     constructor(environment: Environment<TID>);
-    start(): Promise<void>;
+    /**
+     * Get the BrightChain document store.
+     * Overrides the upstream mongoose-based `db` getter since BrightChain
+     * uses its own BlockDocumentStore instead of mongoose.
+     */
+    get db(): DocumentStore;
+    /**
+     * Get a collection from the BrightChain document store by name.
+     * Overrides the upstream mongoose-based `getModel()` to delegate
+     * to the BlockDocumentStore's collection() method.
+     */
+    getModel<U extends DocumentRecord>(modelName: string): DocumentCollection<U>;
+    start(mongoUri?: string): Promise<void>;
     stop(): Promise<void>;
     getController<T = unknown>(name: string): T;
     setController(name: string, controller: unknown): void;
@@ -40,6 +73,12 @@ export declare class App<TID extends PlatformID> extends BaseApplication<TID> {
      * Useful for sending messages to connected nodes.
      */
     getWebSocketServer(): WebSocketMessageServer | null;
+    /**
+     * Get the ClientWebSocketServer instance.
+     * Used for Lumen client protocol connections.
+     * @see Requirements 9.6, 11.3
+     */
+    getClientWebSocketServer(): ClientWebSocketServer | null;
     /**
      * Set the MessagePassingService for the application.
      * This should be called after the application is started and
@@ -68,5 +107,15 @@ export declare class App<TID extends PlatformID> extends BaseApplication<TID> {
      * @requirements 4.4
      */
     setReconciliationService(service: IReconciliationService): void;
+    /**
+     * Set the PoolDiscoveryService and wire gossip handlers.
+     * Registers the service, connects GossipService pool announcement/removal
+     * handlers, and passes the service to the IntrospectionController via ApiRouter.
+     *
+     * @param poolDiscoveryService - The pool discovery service instance
+     * @param gossipService - The gossip service to wire pool announcement handlers to
+     * @see Requirements 7.1, 8.3
+     */
+    setPoolDiscoveryService(poolDiscoveryService: PoolDiscoveryService, gossipService: GossipService): void;
 }
 //# sourceMappingURL=application.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EAGvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAY7D,OAAgB,EAAE,WAAW,EAAmC,MAAM,SAAS,CAAC;AAKhF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E;;GAEG;AACH,qBAAa,GAAG,CAAC,GAAG,SAAS,UAAU,CAAE,SAAQ,eAAe,CAAC,GAAG,CAAC;IACnE,SAAgB,UAAU,EAAE,WAAW,CAAC;IACxC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,qBAAqB,CAAsC;IACnE,OAAO,CAAC,WAAW,CAA4B;gBAEnC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;IAcnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiLtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDpC,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAI3C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAI7D;;;OAGG;IACI,YAAY,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IAI5C;;;OAGG;IACI,cAAc,IAAI,uBAAuB,GAAG,IAAI;IAIvD;;;OAGG;IACI,kBAAkB,IAAI,sBAAsB,GAAG,IAAI;IAI1D;;;;;OAKG;IACI,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAQrE;;;;;OAKG;IACI,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAO/D;;;;;OAKG;IACI,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAQlE;;;;;OAKG;IACI,wBAAwB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;CAMvE"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/application.ts"],"names":[],"mappings":"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"}