@brightchain/node-express-suite 0.25.0

package/src/lib/services/bright-db-authentication-provider.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbAuthenticationProvider = void 0;
+const jsonwebtoken_1 = require("jsonwebtoken");
+/**
+ * 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.
+ */
+class BrightDbAuthenticationProvider {
+    db;
+    jwtSecret;
+    constructor(db, jwtSecret) {
+        this.db = db;
+        this.jwtSecret = jwtSecret;
+    }
+    /**
+     * Find a user by ID from the `users` collection.
+     * Subclasses override to try MemberStore first.
+     */
+    async findUserById(userId) {
+        try {
+            const usersCol = this.db.collection('users');
+            const userDoc = await usersCol.findOne({ _id: userId });
+            if (!userDoc)
+                return null;
+            return {
+                id: userId,
+                accountStatus: userDoc.accountStatus ?? 'Active',
+                email: userDoc.email ?? '',
+                siteLanguage: userDoc.siteLanguage,
+                timezone: userDoc.timezone ?? 'UTC',
+                lastLogin: userDoc.lastLogin,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Build a request user DTO from the `users` collection.
+     * Subclasses override to try MemberStore first.
+     */
+    async buildRequestUserDTO(userId) {
+        try {
+            const usersCol = this.db.collection('users');
+            const userDoc = await usersCol.findOne({ _id: userId });
+            if (!userDoc)
+                return null;
+            if (userDoc.accountStatus && userDoc.accountStatus !== 'Active') {
+                return null;
+            }
+            return {
+                id: userId,
+                email: userDoc.email ?? '',
+                username: userDoc.username ?? '',
+                roles: [],
+                rolePrivileges: { admin: false, member: true, child: false, system: false },
+                emailVerified: userDoc.emailVerified ?? true,
+                timezone: userDoc.timezone ?? 'UTC',
+                siteLanguage: userDoc.siteLanguage ?? 'en',
+                darkMode: userDoc.darkMode ?? false,
+                currency: userDoc.currency ?? 'USD',
+                directChallenge: userDoc.directChallenge ?? false,
+                lastLogin: userDoc.lastLogin,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Verify a JWT token and return the decoded user.
+     */
+    async verifyToken(token) {
+        try {
+            const decoded = (0, jsonwebtoken_1.verify)(token, this.jwtSecret);
+            return {
+                userId: (decoded['memberId'] ?? decoded['userId'] ?? decoded['sub']),
+                roles: (decoded['roles'] ?? []),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.BrightDbAuthenticationProvider = BrightDbAuthenticationProvider;
+//# sourceMappingURL=bright-db-authentication-provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-authentication-provider.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/services/bright-db-authentication-provider.ts"],"names":[],"mappings":";;;AAUA,+CAAsC;AAEtC;;;;;;GAMG;AACH,MAAa,8BAA8B;IAMpB;IACA;IAFrB,YACqB,EAAY,EACZ,SAAiB;QADjB,OAAE,GAAF,EAAE,CAAU;QACZ,cAAS,GAAT,SAAS,CAAQ;IACnC,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,MAAc;QAEd,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAOhC,OAAO,CAAC,CAAC;YAEZ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAW,CAAC,CAAC;YACjE,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAE1B,OAAO;gBACL,EAAE,EAAE,MAAM;gBACV,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,QAAQ;gBAChD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,YAAY,EAAE,OAAO,CAAC,YAAqC;gBAC3D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBACnC,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,MAAc;QACtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAYhC,OAAO,CAAC,CAAC;YAEZ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAW,CAAC,CAAC;YACjE,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAE1B,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;gBAChE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO;gBACL,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;gBAChC,KAAK,EAAE,EAAE;gBACT,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;gBAC3E,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;gBAC5C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBACnC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;gBAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBACnC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;gBACjD,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,KAAa;QAEb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,qBAAM,EAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAA4B,CAAC;YACzE,OAAO;gBACL,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAW;gBAC9E,KAAK,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAwB;aAC3B,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAzGD,wEAyGC"}

package/src/lib/services/bright-db-base-service.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview BrightDB-specific base service extending the database-agnostic
+ * BaseService. Constrains TApplication to IBrightDbApplication so subclasses
+ * get type-safe access to .db, .getModel(), and .environment.
+ * Parallel to upstream's MongoBaseService.
+ *
+ * @module services/bright-db-base-service
+ */
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import { BaseService } from '@digitaldefiance/node-express-suite';
+import type { IBrightDbApplication } from '../interfaces/bright-db-application';
+/**
+ * BrightDB-specific base service.
+ * Extends BaseService with TApplication constrained to IBrightDbApplication.
+ *
+ * Use this for services that need BrightDB-specific access (application.db,
+ * application.getModel, application.environment). Services that are
+ * database-agnostic should extend BaseService directly.
+ *
+ * @template TID - Platform ID type (defaults to Buffer)
+ * @template TApplication - Must extend IBrightDbApplication
+ */
+export declare class BrightDbBaseService<TID extends PlatformID = Buffer, TApplication extends IBrightDbApplication<TID> = IBrightDbApplication<TID>> extends BaseService<TID, TApplication> {
+    constructor(application: TApplication);
+}
+//# sourceMappingURL=bright-db-base-service.d.ts.map

package/src/lib/services/bright-db-base-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-base-service.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/services/bright-db-base-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB,CAC9B,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,YAAY,SAAS,oBAAoB,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAC1E,SAAQ,WAAW,CAAC,GAAG,EAAE,YAAY,CAAC;gBAC1B,WAAW,EAAE,YAAY;CAGtC"}

package/src/lib/services/bright-db-base-service.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * @fileoverview BrightDB-specific base service extending the database-agnostic
+ * BaseService. Constrains TApplication to IBrightDbApplication so subclasses
+ * get type-safe access to .db, .getModel(), and .environment.
+ * Parallel to upstream's MongoBaseService.
+ *
+ * @module services/bright-db-base-service
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbBaseService = void 0;
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+/**
+ * BrightDB-specific base service.
+ * Extends BaseService with TApplication constrained to IBrightDbApplication.
+ *
+ * Use this for services that need BrightDB-specific access (application.db,
+ * application.getModel, application.environment). Services that are
+ * database-agnostic should extend BaseService directly.
+ *
+ * @template TID - Platform ID type (defaults to Buffer)
+ * @template TApplication - Must extend IBrightDbApplication
+ */
+class BrightDbBaseService extends node_express_suite_1.BaseService {
+    constructor(application) {
+        super(application);
+    }
+}
+exports.BrightDbBaseService = BrightDbBaseService;
+//# sourceMappingURL=bright-db-base-service.js.map

package/src/lib/services/bright-db-base-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-base-service.js","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/services/bright-db-base-service.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,4EAAkE;AAGlE;;;;;;;;;;GAUG;AACH,MAAa,mBAGX,SAAQ,gCAA8B;IACtC,YAAY,WAAyB;QACnC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;CACF;AAPD,kDAOC"}

package/src/lib/services/bright-db-collection.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview BrightDB collection adapter implementing ICollection.
+ * Wraps a @brightchain/db Collection to conform to the shared ICollection
+ * interface from @digitaldefiance/suite-core-lib.
+ * Parallel to upstream's MongooseCollection.
+ *
+ * @module services/bright-db-collection
+ */
+import type { Collection } from '@brightchain/db';
+import type { AggregationStage, BsonDocument, BulkWriteOperation, BulkWriteOptions, BulkWriteResult, ChangeListener, CollectionSchema, DeleteResult, DocumentId, FilterQuery, FindOptions, ICollection, IndexOptions, IndexSpec, InsertManyResult, InsertOneResult, ReadPreference, ReplaceResult, TextIndexOptions, UpdateOptions, UpdateQuery, UpdateResult, ValidationFieldError, WriteConcern, WriteOptions } from '@digitaldefiance/suite-core-lib';
+/**
+ * Adapts a @brightchain/db Collection to the ICollection<T> interface.
+ * Delegates all operations to the underlying BrightDB collection.
+ */
+export declare class BrightDbCollection<T extends BsonDocument = BsonDocument> implements ICollection<T> {
+    private readonly _collection;
+    constructor(_collection: Collection<T>);
+    insertOne(doc: T, options?: WriteOptions): Promise<InsertOneResult>;
+    insertMany(docs: T[], options?: WriteOptions): Promise<InsertManyResult>;
+    findOne(filter?: FilterQuery<T>, options?: FindOptions<T>): Promise<T | null>;
+    find(filter?: FilterQuery<T>, options?: FindOptions<T>): T[] | PromiseLike<T[]>;
+    findById(id: DocumentId): Promise<T | null>;
+    updateOne(filter: FilterQuery<T>, update: UpdateQuery<T>, options?: UpdateOptions): Promise<UpdateResult>;
+    updateMany(filter: FilterQuery<T>, update: UpdateQuery<T>, options?: UpdateOptions): Promise<UpdateResult>;
+    deleteOne(filter: FilterQuery<T>, options?: WriteOptions): Promise<DeleteResult>;
+    deleteMany(filter: FilterQuery<T>, options?: WriteOptions): Promise<DeleteResult>;
+    replaceOne(filter: FilterQuery<T>, doc: T, options?: UpdateOptions): Promise<ReplaceResult>;
+    countDocuments(filter?: FilterQuery<T>): Promise<number>;
+    estimatedDocumentCount(): Promise<number>;
+    distinct<K extends keyof T>(field: K, filter?: FilterQuery<T>): Promise<Array<T[K]>>;
+    aggregate(pipeline: AggregationStage[]): Promise<BsonDocument[]>;
+    createIndex(spec: IndexSpec, options?: IndexOptions): Promise<string>;
+    dropIndex(name: string): Promise<void>;
+    listIndexes(): string[];
+    bulkWrite(operations: BulkWriteOperation<T>[], options?: BulkWriteOptions): Promise<BulkWriteResult>;
+    watch(listener: ChangeListener<T>): () => void;
+    setSchema(schema: CollectionSchema): void;
+    getSchema(): CollectionSchema | undefined;
+    removeSchema(): void;
+    validateDoc(doc: T): ValidationFieldError[];
+    getWriteConcern(): WriteConcern;
+    setWriteConcern(wc: WriteConcern): void;
+    getReadPreference(): ReadPreference;
+    setReadPreference(rp: ReadPreference): void;
+    createTextIndex(options: TextIndexOptions): string;
+    dropTextIndex(): void;
+    hasTextIndex(): boolean;
+    drop(): Promise<void>;
+}
+//# sourceMappingURL=bright-db-collection.d.ts.map

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

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

package/src/lib/services/bright-db-collection.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * @fileoverview BrightDB collection adapter implementing ICollection.
+ * Wraps a @brightchain/db Collection to conform to the shared ICollection
+ * interface from @digitaldefiance/suite-core-lib.
+ * Parallel to upstream's MongooseCollection.
+ *
+ * @module services/bright-db-collection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightDbCollection = void 0;
+/**
+ * Adapts a @brightchain/db Collection to the ICollection<T> interface.
+ * Delegates all operations to the underlying BrightDB collection.
+ */
+class BrightDbCollection {
+    _collection;
+    constructor(_collection) {
+        this._collection = _collection;
+    }
+    async insertOne(doc, options) {
+        return this._collection.insertOne(doc, options);
+    }
+    async insertMany(docs, options) {
+        return this._collection.insertMany(docs, options);
+    }
+    async findOne(filter, options) {
+        return this._collection.findOne(filter, options);
+    }
+    find(filter, options) {
+        return this._collection.find(filter, options);
+    }
+    async findById(id) {
+        return this._collection.findById(id);
+    }
+    async updateOne(filter, update, options) {
+        return this._collection.updateOne(filter, update, options);
+    }
+    async updateMany(filter, update, options) {
+        return this._collection.updateMany(filter, update, options);
+    }
+    async deleteOne(filter, options) {
+        return this._collection.deleteOne(filter, options);
+    }
+    async deleteMany(filter, options) {
+        return this._collection.deleteMany(filter, options);
+    }
+    async replaceOne(filter, doc, options) {
+        return this._collection.replaceOne(filter, doc, options);
+    }
+    async countDocuments(filter) {
+        return this._collection.countDocuments(filter);
+    }
+    async estimatedDocumentCount() {
+        return this._collection.estimatedDocumentCount();
+    }
+    async distinct(field, filter) {
+        return this._collection.distinct(field, filter);
+    }
+    async aggregate(pipeline) {
+        return this._collection.aggregate(pipeline);
+    }
+    async createIndex(spec, options) {
+        return this._collection.createIndex(spec, options);
+    }
+    async dropIndex(name) {
+        return this._collection.dropIndex(name);
+    }
+    listIndexes() {
+        return this._collection.listIndexes();
+    }
+    async bulkWrite(operations, options) {
+        return this._collection.bulkWrite(operations, options);
+    }
+    watch(listener) {
+        return this._collection.watch(listener);
+    }
+    setSchema(schema) {
+        this._collection.setSchema(schema);
+    }
+    getSchema() {
+        return this._collection.getSchema();
+    }
+    removeSchema() {
+        this._collection.removeSchema();
+    }
+    validateDoc(doc) {
+        return this._collection.validateDoc(doc);
+    }
+    getWriteConcern() {
+        return this._collection.getWriteConcern();
+    }
+    setWriteConcern(wc) {
+        this._collection.setWriteConcern(wc);
+    }
+    getReadPreference() {
+        return this._collection.getReadPreference();
+    }
+    setReadPreference(rp) {
+        this._collection.setReadPreference(rp);
+    }
+    createTextIndex(options) {
+        return this._collection.createTextIndex(options);
+    }
+    dropTextIndex() {
+        this._collection.dropTextIndex();
+    }
+    hasTextIndex() {
+        return this._collection.hasTextIndex();
+    }
+    async drop() {
+        return this._collection.drop();
+    }
+}
+exports.BrightDbCollection = BrightDbCollection;
+//# sourceMappingURL=bright-db-collection.js.map

package/src/lib/services/bright-db-collection.js.map

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

package/src/lib/services/sessionAdapter.d.ts

@@ -0,0 +1,62 @@
+import type { BrightDb } from '@brightchain/db';
+/**
+ * Shape of a session document stored in BrightDB.
+ * Exported so consumers (tests, controllers) can reference the type.
+ */
+export interface ISessionDocument {
+    /** UUID v4 identifying this session. */
+    sessionId: string;
+    /** Hex-encoded member ID. */
+    memberId: string;
+    /** SHA-256 hex digest of the JWT token. */
+    tokenHash: string;
+    /** Epoch-ms when the session was created. */
+    createdAt: number;
+    /** Epoch-ms when the session expires. */
+    expiresAt: number;
+}
+/**
+ * Manages user sessions backed by a BrightDB `sessions` collection.
+ *
+ * Token hashes use SHA-256 (not bcrypt) so that `validateToken` can
+ * query by hash without a per-row compare.
+ */
+export declare class BrightChainSessionAdapter {
+    private readonly db;
+    constructor(db: BrightDb);
+    /**
+     * Create a new session for the given member.
+     *
+     * @param memberId  Hex string of the member's ID.
+     * @param token     The raw JWT token (will be SHA-256 hashed for storage).
+     * @param ttlMs     Time-to-live in milliseconds.
+     * @returns The generated UUID session ID.
+     */
+    createSession(memberId: string, token: string, ttlMs: number): Promise<string>;
+    /**
+     * Retrieve a session by its ID.
+     *
+     * @returns The session document, or `null` if not found or expired.
+     */
+    getSession(sessionId: string): Promise<ISessionDocument | null>;
+    /**
+     * Validate a raw JWT token against stored sessions.
+     *
+     * Hashes the token with SHA-256, looks up the matching session,
+     * and checks expiration.
+     *
+     * @returns The session document, or `null` if invalid / expired / missing.
+     */
+    validateToken(token: string): Promise<ISessionDocument | null>;
+    /**
+     * Delete a session by its ID.
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Remove all expired sessions.
+     *
+     * @returns The number of sessions removed.
+     */
+    cleanExpired(): Promise<number>;
+}
+//# sourceMappingURL=sessionAdapter.d.ts.map

package/src/lib/services/sessionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionAdapter.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/services/sessionAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,iBAAiB,CAAC;AAI9D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAmBD;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAElB,EAAE,EAAE,QAAQ;IAIxB;;;;;;;OAOG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC;IAkBlB;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAQrE;;;;;;;OAOG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IASpE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CAQtC"}

package/src/lib/services/sessionAdapter.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrightChainSessionAdapter = void 0;
+const crypto_1 = require("crypto");
+const COLLECTION_SESSIONS = 'sessions';
+/** Compute the SHA-256 hex digest of a string. */
+function sha256Hex(value) {
+    return (0, crypto_1.createHash)('sha256').update(value).digest('hex');
+}
+/**
+ * Manages user sessions backed by a BrightDB `sessions` collection.
+ *
+ * Token hashes use SHA-256 (not bcrypt) so that `validateToken` can
+ * query by hash without a per-row compare.
+ */
+class BrightChainSessionAdapter {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Create a new session for the given member.
+     *
+     * @param memberId  Hex string of the member's ID.
+     * @param token     The raw JWT token (will be SHA-256 hashed for storage).
+     * @param ttlMs     Time-to-live in milliseconds.
+     * @returns The generated UUID session ID.
+     */
+    async createSession(memberId, token, ttlMs) {
+        const sessionId = (0, crypto_1.randomUUID)();
+        const now = Date.now();
+        const doc = {
+            sessionId,
+            memberId,
+            tokenHash: sha256Hex(token),
+            createdAt: now,
+            expiresAt: now + ttlMs,
+        };
+        const col = this.db.collection(COLLECTION_SESSIONS);
+        await col.insertOne(doc);
+        return sessionId;
+    }
+    /**
+     * Retrieve a session by its ID.
+     *
+     * @returns The session document, or `null` if not found or expired.
+     */
+    async getSession(sessionId) {
+        const col = this.db.collection(COLLECTION_SESSIONS);
+        const doc = await col.findOne({ sessionId });
+        if (!doc)
+            return null;
+        if (doc.expiresAt < Date.now())
+            return null;
+        return toSessionDocument(doc);
+    }
+    /**
+     * Validate a raw JWT token against stored sessions.
+     *
+     * Hashes the token with SHA-256, looks up the matching session,
+     * and checks expiration.
+     *
+     * @returns The session document, or `null` if invalid / expired / missing.
+     */
+    async validateToken(token) {
+        const tokenHash = sha256Hex(token);
+        const col = this.db.collection(COLLECTION_SESSIONS);
+        const doc = await col.findOne({ tokenHash });
+        if (!doc)
+            return null;
+        if (doc.expiresAt < Date.now())
+            return null;
+        return toSessionDocument(doc);
+    }
+    /**
+     * Delete a session by its ID.
+     */
+    async deleteSession(sessionId) {
+        const col = this.db.collection(COLLECTION_SESSIONS);
+        await col.deleteOne({ sessionId });
+    }
+    /**
+     * Remove all expired sessions.
+     *
+     * @returns The number of sessions removed.
+     */
+    async cleanExpired() {
+        const col = this.db.collection(COLLECTION_SESSIONS);
+        const now = Date.now();
+        // BrightDB's filter engine supports $lt on numeric fields.
+        const result = await col.deleteMany({ expiresAt: { $lt: now } });
+        return result.deletedCount;
+    }
+}
+exports.BrightChainSessionAdapter = BrightChainSessionAdapter;
+/** Map a stored SessionDoc to the public ISessionDocument shape. */
+function toSessionDocument(doc) {
+    return {
+        sessionId: doc.sessionId,
+        memberId: doc.memberId,
+        tokenHash: doc.tokenHash,
+        createdAt: doc.createdAt,
+        expiresAt: doc.expiresAt,
+    };
+}
+//# sourceMappingURL=sessionAdapter.js.map

package/src/lib/services/sessionAdapter.js.map

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

package/src/lib/shared-types.d.ts

@@ -0,0 +1,41 @@
+export type { GuidV4Buffer, SignatureBuffer, } from '@digitaldefiance/node-ecies-lib';
+export type ClientSession = any;
+import type { DefaultBackendIdType as DefaultBackendIdType_ } from './types/backend-id';
+export type DefaultBackendIdType = DefaultBackendIdType_;
+/**
+ * Block storage schema definition (replaces Mongoose Schema)
+ * Uses generic string for model name to avoid domain-specific enum dependency.
+ * Consumers can narrow the type with their own enum (e.g., ModelName from api-lib).
+ */
+export interface IBlockStorageSchema<T> {
+    name: string;
+    fields: Record<string, unknown>;
+    indexes?: Array<{
+        fields: Record<string, number | undefined>;
+        options?: Record<string, unknown>;
+    }>;
+    validate?: (doc: Partial<T>) => void;
+}
+/**
+ * Block storage model definition (replaces Mongoose Model)
+ * Uses generic string for model name to avoid domain-specific enum dependency.
+ */
+export interface IBlockStorageModel<T> {
+    readonly modelName: string;
+    readonly schema: IBlockStorageSchema<T>;
+}
+/**
+ * Block storage schema entry (replaces ISchema from node-express-suite)
+ * Uses generic strings for collection and model name to avoid domain-specific enum dependencies.
+ */
+export interface IBlockStorageSchemaEntry<T> {
+    collection: string;
+    model: IBlockStorageModel<T>;
+    modelName: string;
+    schema: IBlockStorageSchema<T>;
+}
+/**
+ * Schema map type for validation schemas
+ */
+export type SchemaMap = Record<string, IBlockStorageSchemaEntry<any>>;
+//# sourceMappingURL=shared-types.d.ts.map

package/src/lib/shared-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.d.ts","sourceRoot":"","sources":["../../../../brightchain-node-express-suite/src/lib/shared-types.ts"],"names":[],"mappings":"AACA,YAAY,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,iCAAiC,CAAC;AAIzC,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAKhC,OAAO,KAAK,EAAE,oBAAoB,IAAI,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACxF,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;QAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;CAChC;AAED;;GAEG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/src/lib/shared-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=shared-types.js.map

package/src/lib/shared-types.js.map

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

package/src/lib/transactions/bright-db-transaction-manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview BrightDB transaction manager.
+ * Manages transaction lifecycle with retry logic and timeout support.
+ * Parallel to upstream's TransactionManager (which wraps Mongoose sessions).
+ *
+ * @module transactions/bright-db-transaction-manager
+ */
+import type { BrightDb } from '@brightchain/db';
+import type { IClientSession } from '@digitaldefiance/suite-core-lib';
+/**
+ * Options for transaction execution.
+ */
+export interface BrightDbTransactionOptions {
+    /** Transaction timeout in milliseconds */
+    timeoutMs?: number;
+    /** Maximum number of retry attempts (default: 0 = no retries) */
+    maxRetries?: number;
+}
+/**
+ * Manager for BrightDB transactions.
+ * Wraps @brightchain/db's session-based transaction support.
+ *
+ * When `useTransactions` is false, the callback is executed directly
+ * without a session (passthrough mode).
+ */
+export declare class BrightDbTransactionManager {
+    private readonly db;
+    private readonly useTransactions;
+    constructor(db: BrightDb, useTransactions: boolean);
+    /**
+     * Executes a callback within a transaction.
+     *
+     * When transactions are enabled, creates a session, starts a transaction,
+     * and commits on success or aborts on failure. Supports retry logic.
+     *
+     * When transactions are disabled, runs the callback directly with
+     * `undefined` as the session parameter.
+     *
+     * @template T - Return type
+     * @param callback - Function to execute, receives session or undefined
+     * @param options - Transaction options (timeout, retries)
+     * @returns Result of callback execution
+     */
+    execute<T>(callback: (session: IClientSession | undefined) => Promise<T>, options?: BrightDbTransactionOptions): Promise<T>;
+}
+//# sourceMappingURL=bright-db-transaction-manager.d.ts.map

package/src/lib/transactions/bright-db-transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bright-db-transaction-manager.d.ts","sourceRoot":"","sources":["../../../../../brightchain-node-express-suite/src/lib/transactions/bright-db-transaction-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADf,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,OAAO;IAG3C;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,CAAC,EACb,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7D,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,CAAC,CAAC;CAgDd"}