@brightchain/brightchain-lib 0.30.1 → 0.31.0

package/src/lib/asset/formatAssetAmount.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAssetAmount = formatAssetAmount;
+const jouleConstants_1 = require("./jouleConstants");
+/**
+ * Format an asset microunit amount as a human-readable string.
+ *
+ * - For `assetId === 'joule'` the default format is `'1.234567 J'`.
+ * - For unknown assetIds the function falls back to `'<microunits> <assetId>'`
+ *   raw and never throws.
+ *
+ * No business logic SHALL parse formatted strings back into amounts; parsing
+ * occurs only on validated DTO inputs.
+ *
+ * @see asset-account-store-generalization spec, Requirements 8.1–8.4.
+ */
+function formatAssetAmount(amount, assetId, opts) {
+    if (assetId !== jouleConstants_1.JOULE_ASSET_ID) {
+        return `${amount.toString()} ${assetId}`;
+    }
+    const precision = opts?.precision !== undefined
+        ? Math.max(0, opts.precision)
+        : jouleConstants_1.JOULE_DECIMALS;
+    const negative = amount < 0n;
+    const abs = negative ? -amount : amount;
+    const integer = abs / jouleConstants_1.JOULE_MICROUNITS_PER_UNIT;
+    const fractional = abs % jouleConstants_1.JOULE_MICROUNITS_PER_UNIT;
+    // Pad fractional to JOULE_DECIMALS digits, then truncate / pad to precision.
+    let fractionalStr = fractional.toString().padStart(jouleConstants_1.JOULE_DECIMALS, '0');
+    if (precision < jouleConstants_1.JOULE_DECIMALS) {
+        fractionalStr = fractionalStr.slice(0, precision);
+    }
+    else if (precision > jouleConstants_1.JOULE_DECIMALS) {
+        fractionalStr = fractionalStr.padEnd(precision, '0');
+    }
+    let integerStr;
+    if (opts?.locale) {
+        try {
+            integerStr = new Intl.NumberFormat(opts.locale, {
+                useGrouping: true,
+                maximumFractionDigits: 0,
+            }).format(integer);
+        }
+        catch {
+            integerStr = integer.toString();
+        }
+    }
+    else {
+        integerStr = integer.toString();
+    }
+    const body = precision === 0 ? integerStr : `${integerStr}.${fractionalStr}`;
+    return `${negative ? '-' : ''}${body} ${jouleConstants_1.JOULE_SYMBOL}`;
+}
+//# sourceMappingURL=formatAssetAmount.js.map

package/src/lib/asset/formatAssetAmount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatAssetAmount.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/formatAssetAmount.ts"],"names":[],"mappings":";;AAoCA,8CA4CC;AAhFD,qDAK0B;AAmB1B;;;;;;;;;;;GAWG;AACH,SAAgB,iBAAiB,CAC/B,MAAc,EACd,OAAe,EACf,IAAgC;IAEhC,IAAI,OAAO,KAAK,+BAAc,EAAE,CAAC;QAC/B,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,SAAS,GACb,IAAI,EAAE,SAAS,KAAK,SAAS;QAC3B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;QAC7B,CAAC,CAAC,+BAAc,CAAC;IAErB,MAAM,QAAQ,GAAG,MAAM,GAAG,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAExC,MAAM,OAAO,GAAG,GAAG,GAAG,0CAAyB,CAAC;IAChD,MAAM,UAAU,GAAG,GAAG,GAAG,0CAAyB,CAAC;IAEnD,6EAA6E;IAC7E,IAAI,aAAa,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAAc,EAAE,GAAG,CAAC,CAAC;IACxE,IAAI,SAAS,GAAG,+BAAc,EAAE,CAAC;QAC/B,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,SAAS,GAAG,+BAAc,EAAE,CAAC;QACtC,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,UAAkB,CAAC;IACvB,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE;gBAC9C,WAAW,EAAE,IAAI;gBACjB,qBAAqB,EAAE,CAAC;aACzB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC;IAC7E,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,6BAAY,EAAE,CAAC;AACzD,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Asset-account primitives.
+ *
+ * Introduced by the `asset-account-store-generalization` spec as the
+ * generalized base for joule and any future metered asset.
+ */
+export * from './assetAccount';
+export * from './formatAssetAmount';
+export * from './jouleConstants';
+export * from './microunits';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/src/lib/asset/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * Asset-account primitives.
+ *
+ * Introduced by the `asset-account-store-generalization` spec as the
+ * generalized base for joule and any future metered asset.
+ */
+tslib_1.__exportStar(require("./assetAccount"), exports);
+tslib_1.__exportStar(require("./formatAssetAmount"), exports);
+tslib_1.__exportStar(require("./jouleConstants"), exports);
+tslib_1.__exportStar(require("./microunits"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,yDAA+B;AAC/B,8DAAoC;AACpC,2DAAiC;AACjC,uDAA6B"}

package/src/lib/asset/jouleConstants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Joule resource-credit constants.
+ *
+ * Joule is BrightChain's first-class metered asset. All ledger and
+ * operational-tier arithmetic is performed in microjoules (`bigint`) to
+ * eliminate floating-point rounding from charge / credit paths.
+ *
+ * @see asset-account-store-generalization spec, Requirement 1.2
+ */
+/** Microjoules per joule. 1 J = 1_000_000 µJ. */
+export declare const JOULE_MICROUNITS_PER_UNIT = 1000000n;
+/**
+ * Number of fractional decimal digits a joule amount renders with by default.
+ * Tied to {@link JOULE_MICROUNITS_PER_UNIT}: 10^6 microunits => 6 decimals.
+ */
+export declare const JOULE_DECIMALS = 6;
+/** Display symbol for the joule asset. */
+export declare const JOULE_SYMBOL = "J";
+/** Canonical assetId string for the joule asset. */
+export declare const JOULE_ASSET_ID = "joule";
+//# sourceMappingURL=jouleConstants.d.ts.map

package/src/lib/asset/jouleConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jouleConstants.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/jouleConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iDAAiD;AACjD,eAAO,MAAM,yBAAyB,WAAa,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,0CAA0C;AAC1C,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC,oDAAoD;AACpD,eAAO,MAAM,cAAc,UAAU,CAAC"}

package/src/lib/asset/jouleConstants.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Joule resource-credit constants.
+ *
+ * Joule is BrightChain's first-class metered asset. All ledger and
+ * operational-tier arithmetic is performed in microjoules (`bigint`) to
+ * eliminate floating-point rounding from charge / credit paths.
+ *
+ * @see asset-account-store-generalization spec, Requirement 1.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JOULE_ASSET_ID = exports.JOULE_SYMBOL = exports.JOULE_DECIMALS = exports.JOULE_MICROUNITS_PER_UNIT = void 0;
+/** Microjoules per joule. 1 J = 1_000_000 µJ. */
+exports.JOULE_MICROUNITS_PER_UNIT = 1000000n;
+/**
+ * Number of fractional decimal digits a joule amount renders with by default.
+ * Tied to {@link JOULE_MICROUNITS_PER_UNIT}: 10^6 microunits => 6 decimals.
+ */
+exports.JOULE_DECIMALS = 6;
+/** Display symbol for the joule asset. */
+exports.JOULE_SYMBOL = 'J';
+/** Canonical assetId string for the joule asset. */
+exports.JOULE_ASSET_ID = 'joule';
+//# sourceMappingURL=jouleConstants.js.map

package/src/lib/asset/jouleConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jouleConstants.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/jouleConstants.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,iDAAiD;AACpC,QAAA,yBAAyB,GAAG,QAAU,CAAC;AAEpD;;;GAGG;AACU,QAAA,cAAc,GAAG,CAAC,CAAC;AAEhC,0CAA0C;AAC7B,QAAA,YAAY,GAAG,GAAG,CAAC;AAEhC,oDAAoD;AACvC,QAAA,cAAc,GAAG,OAAO,CAAC"}

package/src/lib/asset/microunits.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Convert a joule value (display-tier `number`) into microjoule microunits
+ * (`bigint`). Use only at trust boundaries (rate tables, user input, legacy
+ * DTO hydration). Internal arithmetic SHALL stay in `bigint` microunits.
+ *
+ * @throws {InvalidAmountError} If the input is non-finite or negative.
+ *
+ * @see asset-account-store-generalization spec, Requirement 1.2.
+ */
+export declare function joulesToMicrojoules(joules: number): bigint;
+/**
+ * Convert microjoule microunits (`bigint`) back into a joule `number` for
+ * display only. This conversion may lose precision above
+ * `Number.MAX_SAFE_INTEGER`; do **not** round-trip arithmetic through it.
+ *
+ * @see asset-account-store-generalization spec, Requirement 1.2.
+ */
+export declare function microjoulesToJoules(microjoules: bigint): number;
+//# sourceMappingURL=microunits.d.ts.map

package/src/lib/asset/microunits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microunits.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/microunits.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAY1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/src/lib/asset/microunits.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joulesToMicrojoules = joulesToMicrojoules;
+exports.microjoulesToJoules = microjoulesToJoules;
+const invalidAmountError_1 = require("../errors/asset/invalidAmountError");
+const jouleConstants_1 = require("./jouleConstants");
+/**
+ * Convert a joule value (display-tier `number`) into microjoule microunits
+ * (`bigint`). Use only at trust boundaries (rate tables, user input, legacy
+ * DTO hydration). Internal arithmetic SHALL stay in `bigint` microunits.
+ *
+ * @throws {InvalidAmountError} If the input is non-finite or negative.
+ *
+ * @see asset-account-store-generalization spec, Requirement 1.2.
+ */
+function joulesToMicrojoules(joules) {
+    if (typeof joules !== 'number' || !Number.isFinite(joules) || joules < 0) {
+        throw new invalidAmountError_1.InvalidAmountError('joulesToMicrojoules expects a finite, non-negative number.', joules);
+    }
+    // Multiply in number space, round, then promote to bigint.
+    // Display-tier inputs are bounded by Number.MAX_SAFE_INTEGER / 1e6
+    // (~9e9 J) which is far above any expected request budget.
+    const microunits = Math.round(joules * Number(jouleConstants_1.JOULE_MICROUNITS_PER_UNIT));
+    return BigInt(microunits);
+}
+/**
+ * Convert microjoule microunits (`bigint`) back into a joule `number` for
+ * display only. This conversion may lose precision above
+ * `Number.MAX_SAFE_INTEGER`; do **not** round-trip arithmetic through it.
+ *
+ * @see asset-account-store-generalization spec, Requirement 1.2.
+ */
+function microjoulesToJoules(microjoules) {
+    return Number(microjoules) / Number(jouleConstants_1.JOULE_MICROUNITS_PER_UNIT);
+}
+//# sourceMappingURL=microunits.js.map

package/src/lib/asset/microunits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microunits.js","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/asset/microunits.ts"],"names":[],"mappings":";;AAYA,kDAYC;AASD,kDAEC;AAnCD,2EAAwE;AACxE,qDAA6D;AAE7D;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,uCAAkB,CAC1B,4DAA4D,EAC5D,MAAM,CACP,CAAC;IACJ,CAAC;IACD,2DAA2D;IAC3D,mEAAmE;IACnE,2DAA2D;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,0CAAyB,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,0CAAyB,CAAC,CAAC;AACjE,CAAC"}

package/src/lib/constants.d.ts

@@ -9,7 +9,7 @@
  * @module constants
  */
 import { IConstants as ISuiteCoreConstants } from '@digitaldefiance/suite-core-lib';
-import { IBCFECConsts, IBlockHeaderConsts, ICBLConsts, IConstants, ISealingConsts, ISiteConsts, IThemeColors, ITupleConsts } from './interfaces/constants';
+import { IBCFECConsts, IBlockHeaderConsts, ICBLConsts, IConstants, IFontawesomePickerConstants, ISealingConsts, ISiteConsts, IThemeColors, ITupleConsts } from './interfaces/constants';
 /**
  * Site-specific constants for BrightChain
  */
@@ -81,6 +81,8 @@ export declare const VALIDATION: {
     readonly VAULT_NAME_MAX_LENGTH: 50;
     readonly PASSWORD_MIN_LENGTH: 12;
 };
+export declare const BRIGHTHUB: IFontawesomePickerConstants;
+export declare const BRIGHTCHAT: IFontawesomePickerConstants;
 /**
  * BrightChain constants object extending base constants from @digitaldefiance/ecies-lib.
  * Only includes BrightChain-specific constants not provided by upstream.

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,UAAU,IAAI,mBAAmB,EAElC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,WAOT,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAajB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,kBAYjB,CAAC;AAEX;;;GAGG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,GAAG,IAAO;IAEV;;OAEG;IACH,QAAQ,IAAO;IAEf;;OAEG;IACH,WAAW,IAAO;IAElB;;OAEG;IACH,UAAU,IAAO;IAEjB;;OAEG;IACH,QAAQ,IAAO;IAEf;;OAEG;IACH,UAAU,IAAO;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,UA+BjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,YAQX,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,YAkBV,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,cAIZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,UAWvB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;CAKzB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,mBACI,CAAC;AAEjC,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,eAAe,SAAS,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../brightchain-lib/src/lib/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,UAAU,IAAI,mBAAmB,EAElC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,2BAA2B,EAC3B,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,WAOT,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAajB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,kBAYjB,CAAC;AAEX;;;GAGG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,GAAG,IAAO;IAEV;;OAEG;IACH,QAAQ,IAAO;IAEf;;OAEG;IACH,WAAW,IAAO;IAElB;;OAEG;IACH,UAAU,IAAO;IAEjB;;OAEG;IACH,QAAQ,IAAO;IAEf;;OAEG;IACH,UAAU,IAAO;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,UA+BjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,YAQX,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,YAkBV,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,cAIZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,eAAO,MAAM,SAAS,EAAE,2BAUvB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,2BAUxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,UAavB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;CAKzB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,mBACI,CAAC;AAEjC,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,eAAe,SAAS,CAAC"}

package/src/lib/constants.js

@@ -10,7 +10,7 @@
  * @module constants
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CoreConstants = exports.CoreOverrides = exports.CONSTANTS = exports.VALIDATION = exports.SEALING = exports.TUPLE = exports.BC_FEC = exports.OFFS_CACHE_PERCENTAGE = exports.CBL = exports.StructuredBlockType = exports.BLOCK_HEADER = exports.THEME_COLORS = exports.SITE = void 0;
+exports.CoreConstants = exports.CoreOverrides = exports.CONSTANTS = exports.BRIGHTCHAT = exports.BRIGHTHUB = exports.VALIDATION = exports.SEALING = exports.TUPLE = exports.BC_FEC = exports.OFFS_CACHE_PERCENTAGE = exports.CBL = exports.StructuredBlockType = exports.BLOCK_HEADER = exports.THEME_COLORS = exports.SITE = void 0;
 const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
 const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
 /**
@@ -167,6 +167,26 @@ exports.VALIDATION = {
     VAULT_NAME_MAX_LENGTH: 50,
     PASSWORD_MIN_LENGTH: 12,
 };
+exports.BRIGHTHUB = {
+    /**
+     * Max icons to show in the grid at once
+     */
+    FONTAWESOME_MAX_DISPLAY: 120,
+    /**
+     * Grid item size (width and height) in pixels for the icon grid.
+     */
+    FONTAWESOME_ICON_GRID_SIZE: 40,
+};
+exports.BRIGHTCHAT = {
+    /**
+     * Max icons to show in the grid at once
+     */
+    FONTAWESOME_MAX_DISPLAY: 120,
+    /**
+     * Grid item size (width and height) in pixels for the icon grid.
+     */
+    FONTAWESOME_ICON_GRID_SIZE: 40,
+};
 /**
  * BrightChain constants object extending base constants from @digitaldefiance/ecies-lib.
  * Only includes BrightChain-specific constants not provided by upstream.
@@ -182,6 +202,8 @@ exports.CONSTANTS = {
     VALIDATION: exports.VALIDATION,
     SITE: exports.SITE,
     THEME_COLORS: exports.THEME_COLORS,
+    BRIGHTHUB: exports.BRIGHTHUB,
+    BRIGHTCHAT: exports.BRIGHTCHAT,
 };
 exports.CoreOverrides = {
     Site: 'BrightChain',

package/src/lib/constants.js.map

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

package/src/lib/db/driverBackedHeadRegistry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * DriverBackedHeadRegistry — IHeadRegistry implemented on top of IHeadRegistryDriver.
+ *
+ * Holds an in-memory cache for reads (getHead is synchronous per the interface).
+ * Every mutation writes only the affected key via the driver (O(1) per write).
+ * load() hydrates the cache by listing all keys and reading each one.
+ *
+ * This replaces both PersistentHeadRegistry (single-JSON-file on disk) and
+ * CloudHeadRegistry (single-JSON-blob in cloud), which both did a full
+ * serialize-all-heads rewrite on every mutation.
+ */
+import type { IWriteProof } from '../interfaces/auth/writeProof';
+import type { DeferredHeadUpdate, IHeadRegistry } from '../interfaces/storage/headRegistry';
+import type { HeadRecord, IHeadRegistryDriver } from '../interfaces/storage/headRegistryDriver';
+export declare class DriverBackedHeadRegistry implements IHeadRegistry {
+    private readonly heads;
+    private readonly timestamps;
+    private readonly deferred;
+    private readonly changeListeners;
+    protected readonly driver: IHeadRegistryDriver;
+    constructor(driver: IHeadRegistryDriver);
+    private makeKey;
+    getHead(dbName: string, collectionName: string): string | undefined;
+    setHead(dbName: string, collectionName: string, blockId: string, _writeProof?: IWriteProof): Promise<void>;
+    removeHead(dbName: string, collectionName: string, _writeProof?: IWriteProof): Promise<void>;
+    clear(): Promise<void>;
+    load(): Promise<void>;
+    getAllHeads(): Map<string, string>;
+    getHeadTimestamp(dbName: string, collectionName: string): Date | undefined;
+    mergeHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date): Promise<boolean>;
+    private notifyHeadChange;
+    onHeadChange(dbName: string, collectionName: string, callback: (blockId: string) => void): () => void;
+    deferHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date): Promise<void>;
+    applyDeferredUpdates(blockId: string): Promise<number>;
+    getDeferredUpdates(): DeferredHeadUpdate[];
+    exportSnapshot(): ReadonlyMap<string, HeadRecord>;
+    mergeSnapshot(snapshot: Iterable<readonly [string, HeadRecord]>): Promise<{
+        merged: number;
+        skipped: number;
+    }>;
+}
+//# sourceMappingURL=driverBackedHeadRegistry.d.ts.map

package/src/lib/db/driverBackedHeadRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driverBackedHeadRegistry.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/db/driverBackedHeadRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACpB,MAAM,0CAA0C,CAAC;AAElD,qBAAa,wBAAyB,YAAW,aAAa;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG5B;IACJ,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;gBAEnC,MAAM,EAAE,mBAAmB;IAIvC,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7D,OAAO,CACX,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC;IAWV,UAAU,CACd,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC;IAOV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIlC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIpE,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,IAAI,GACd,OAAO,CAAC,OAAO,CAAC;IAgBnB,OAAO,CAAC,gBAAgB;IASxB,YAAY,CACV,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,MAAM,IAAI;IAYP,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,IAAI,GACd,OAAO,CAAC,IAAI,CAAC;IAIV,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB5D,kBAAkB,IAAI,kBAAkB,EAAE;IAI1C,cAAc,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC;IAY3C,aAAa,CACjB,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAChD,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAqBhD"}

package/src/lib/db/driverBackedHeadRegistry.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriverBackedHeadRegistry = void 0;
+class DriverBackedHeadRegistry {
+    heads = new Map();
+    timestamps = new Map();
+    deferred = [];
+    changeListeners = new Map();
+    driver;
+    constructor(driver) {
+        this.driver = driver;
+    }
+    makeKey(dbName, collectionName) {
+        return `${dbName}:${collectionName}`;
+    }
+    getHead(dbName, collectionName) {
+        return this.heads.get(this.makeKey(dbName, collectionName));
+    }
+    async setHead(dbName, collectionName, blockId, _writeProof) {
+        const key = this.makeKey(dbName, collectionName);
+        const ts = new Date();
+        this.heads.set(key, blockId);
+        this.timestamps.set(key, ts);
+        await this.driver.writeRecord(key, {
+            blockId,
+            timestamp: ts.toISOString(),
+        });
+    }
+    async removeHead(dbName, collectionName, _writeProof) {
+        const key = this.makeKey(dbName, collectionName);
+        this.heads.delete(key);
+        this.timestamps.delete(key);
+        await this.driver.deleteRecord(key);
+    }
+    async clear() {
+        const keys = await this.driver.listKeys();
+        // Delete all persisted records in parallel
+        await Promise.all(keys.map((k) => this.driver.deleteRecord(k)));
+        this.heads.clear();
+        this.timestamps.clear();
+        this.deferred.length = 0;
+    }
+    async load() {
+        this.heads.clear();
+        this.timestamps.clear();
+        const keys = await this.driver.listKeys();
+        const records = await Promise.all(keys.map((k) => this.driver.readRecord(k).then((r) => ({ k, r }))));
+        for (const { k, r } of records) {
+            if (r) {
+                this.heads.set(k, r.blockId);
+                this.timestamps.set(k, new Date(r.timestamp));
+            }
+        }
+    }
+    getAllHeads() {
+        return new Map(this.heads);
+    }
+    getHeadTimestamp(dbName, collectionName) {
+        return this.timestamps.get(this.makeKey(dbName, collectionName));
+    }
+    async mergeHeadUpdate(dbName, collectionName, blockId, timestamp) {
+        const key = this.makeKey(dbName, collectionName);
+        const localTs = this.timestamps.get(key);
+        if (!localTs || timestamp.getTime() > localTs.getTime()) {
+            this.heads.set(key, blockId);
+            this.timestamps.set(key, timestamp);
+            await this.driver.writeRecord(key, {
+                blockId,
+                timestamp: timestamp.toISOString(),
+            });
+            this.notifyHeadChange(key, blockId);
+            return true;
+        }
+        return false;
+    }
+    notifyHeadChange(key, blockId) {
+        const listeners = this.changeListeners.get(key);
+        if (listeners) {
+            for (const cb of listeners) {
+                cb(blockId);
+            }
+        }
+    }
+    onHeadChange(dbName, collectionName, callback) {
+        const key = this.makeKey(dbName, collectionName);
+        if (!this.changeListeners.has(key)) {
+            this.changeListeners.set(key, new Set());
+        }
+        this.changeListeners.get(key).add(callback);
+        return () => {
+            this.changeListeners.get(key)?.delete(callback);
+        };
+    }
+    async deferHeadUpdate(dbName, collectionName, blockId, timestamp) {
+        this.deferred.push({ dbName, collectionName, blockId, timestamp });
+    }
+    async applyDeferredUpdates(blockId) {
+        let applied = 0;
+        const remaining = [];
+        for (const update of this.deferred) {
+            if (update.blockId === blockId) {
+                await this.mergeHeadUpdate(update.dbName, update.collectionName, update.blockId, update.timestamp);
+                applied++;
+            }
+            else {
+                remaining.push(update);
+            }
+        }
+        this.deferred.length = 0;
+        this.deferred.push(...remaining);
+        return applied;
+    }
+    getDeferredUpdates() {
+        return [...this.deferred];
+    }
+    exportSnapshot() {
+        const result = new Map();
+        for (const [key, blockId] of this.heads) {
+            const ts = this.timestamps.get(key);
+            result.set(key, {
+                blockId,
+                timestamp: ts ? ts.toISOString() : new Date(0).toISOString(),
+            });
+        }
+        return result;
+    }
+    async mergeSnapshot(snapshot) {
+        let merged = 0;
+        let skipped = 0;
+        for (const [key, record] of snapshot) {
+            const colon = key.indexOf(':');
+            const dbName = colon === -1 ? key : key.slice(0, colon);
+            const collectionName = colon === -1 ? '' : key.slice(colon + 1);
+            const applied = await this.mergeHeadUpdate(dbName, collectionName, record.blockId, new Date(record.timestamp));
+            if (applied) {
+                merged++;
+            }
+            else {
+                skipped++;
+            }
+        }
+        return { merged, skipped };
+    }
+}
+exports.DriverBackedHeadRegistry = DriverBackedHeadRegistry;
+//# sourceMappingURL=driverBackedHeadRegistry.js.map

package/src/lib/db/driverBackedHeadRegistry.js.map

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

package/src/lib/db/headRegistryGossipTransport.d.ts

@@ -0,0 +1,74 @@
+/**
+ * HeadRegistryGossipTransport — Gossip-aware decorator for IHeadRegistry.
+ *
+ * Wraps any IHeadRegistry and wires it to an IGossipService so that:
+ *   1. Outbound: after every successful setHead(), the update is announced
+ *      to peers via gossip.
+ *   2. Inbound: incoming 'head_update' gossip announcements are merged into
+ *      the wrapped registry using last-writer-wins semantics.
+ *   3. Anti-entropy: an optional periodic timer re-announces all known head
+ *      pointers so that nodes that missed earlier announcements can converge.
+ *
+ * Usage:
+ *   const transport = new HeadRegistryGossipTransport(inner, gossipService);
+ *   transport.start(30_000); // optional anti-entropy every 30 s
+ *   // … use transport as an IHeadRegistry …
+ *   await transport.stop();
+ *
+ * @see Requirements 2.1, 7.1, 7.2
+ */
+import type { IWriteProof } from '../interfaces/auth/writeProof';
+import type { IGossipService } from '../interfaces/availability/gossipService';
+import type { DeferredHeadUpdate, IHeadRegistry } from '../interfaces/storage/headRegistry';
+import type { HeadRecord } from '../interfaces/storage/headRegistryDriver';
+export declare class HeadRegistryGossipTransport implements IHeadRegistry {
+    private readonly inner;
+    private readonly gossip;
+    private readonly announcementHandler;
+    private antiEntropyTimer?;
+    constructor(inner: IHeadRegistry, gossip: IGossipService);
+    /**
+     * Start the optional anti-entropy timer.
+     * When `antiEntropyIntervalMs` is provided and > 0, the transport will
+     * periodically re-announce all known head pointers so that peers that
+     * joined late (or missed earlier announcements) can converge.
+     *
+     * @param antiEntropyIntervalMs - Interval in milliseconds between anti-entropy
+     *   passes.  Pass 0 or omit to disable.
+     */
+    start(antiEntropyIntervalMs?: number): void;
+    /**
+     * Stop the anti-entropy timer and unregister the inbound handler.
+     * Should be called when the transport is no longer needed.
+     */
+    stop(): Promise<void>;
+    /**
+     * Re-announce every known head pointer via gossip.
+     * Used by the anti-entropy timer and can also be called manually to
+     * trigger an immediate convergence pass.
+     */
+    pushSnapshot(): Promise<void>;
+    /**
+     * Set the head pointer locally and announce the update to peers.
+     * Gossip announcement is best-effort: a failure does not roll back the
+     * local write.
+     */
+    setHead(dbName: string, collectionName: string, blockId: string, writeProof?: IWriteProof): Promise<void>;
+    getHead(dbName: string, collectionName: string): string | undefined;
+    removeHead(dbName: string, collectionName: string, writeProof?: IWriteProof): Promise<void>;
+    clear(): Promise<void>;
+    load(): Promise<void>;
+    getAllHeads(): Map<string, string>;
+    getHeadTimestamp(dbName: string, collectionName: string): Date | undefined;
+    mergeHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date, writeProof?: IWriteProof): Promise<boolean>;
+    deferHeadUpdate(dbName: string, collectionName: string, blockId: string, timestamp: Date): Promise<void>;
+    applyDeferredUpdates(blockId: string): Promise<number>;
+    getDeferredUpdates(): DeferredHeadUpdate[];
+    exportSnapshot(): ReadonlyMap<string, HeadRecord>;
+    mergeSnapshot(snapshot: Iterable<readonly [string, HeadRecord]>): Promise<{
+        merged: number;
+        skipped: number;
+    }>;
+    onHeadChange(dbName: string, collectionName: string, callback: (blockId: string) => void): () => void;
+}
+//# sourceMappingURL=headRegistryGossipTransport.d.ts.map

package/src/lib/db/headRegistryGossipTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headRegistryGossipTransport.d.ts","sourceRoot":"","sources":["../../../../../brightchain-lib/src/lib/db/headRegistryGossipTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAE3E,qBAAa,2BAA4B,YAAW,aAAa;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,gBAAgB,CAAC,CAAiC;gBAE9C,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc;IAwBxD;;;;;;;;OAQG;IACH,KAAK,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBnC;;;;OAIG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC;IAiBhB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7D,UAAU,CACd,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC;IAIV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIlC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIpE,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,IAAI,EACf,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC,OAAO,CAAC;IAUb,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,IAAI,GACd,OAAO,CAAC,IAAI,CAAC;IASV,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5D,kBAAkB,IAAI,kBAAkB,EAAE;IAI1C,cAAc,IAAI,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC;IAI3C,aAAa,CACjB,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAChD,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/C,YAAY,CACV,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,MAAM,IAAI;CAGd"}