@decaf-ts/for-fabric 0.5.7 → 0.7.1

package/lib/cjs/contracts/erc20/models.cjs

@@ -0,0 +1,209 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Allowance = exports.ERC20Wallet = exports.ERC20Token = void 0;
+const core_1 = require("@decaf-ts/core");
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+/**
+ * @description ERC20 token metadata model
+ * @summary Represents an ERC20 token definition within the Fabric ERC20 sample, including name, symbol, decimals, and the owning identity. Used to define the unique token managed by the contract.
+ * @param {ModelArg<ERC20Token>} [m] - Optional partial data or another instance to initialize the model
+ * @return {void}
+ * @class ERC20Token
+ * @example
+ * const token = new ERC20Token({ name: "MyToken", symbol: "MTK", decimals: 18, owner: "x509::..." });
+ * // Persist through a repository: await repo.create(token, ctx)
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Repo
+ *   participant Adapter
+ *   App->>Repo: create(new ERC20Token({...}), ctx)
+ *   Repo->>Adapter: create(table, id=name, record, flags)
+ *   Adapter-->>Repo: stored
+ *   Repo-->>App: model
+ */
+let ERC20Token = class ERC20Token extends core_1.BaseModel {
+    constructor(m) {
+        super(m);
+    }
+};
+exports.ERC20Token = ERC20Token;
+__decorate([
+    (0, core_1.pk)({ type: String })
+    /**
+     * @description Token unique name
+     * @summary Serves as the primary key for the ERC20 token definition; typically a human-readable identifier
+     */
+    ,
+    __metadata("design:type", String)
+], ERC20Token.prototype, "name", void 0);
+__decorate([
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Owning identity of the token
+     * @summary X.509 subject or MSP identity string that denotes who owns/controls the token definition
+     */
+    ,
+    __metadata("design:type", String)
+], ERC20Token.prototype, "owner", void 0);
+__decorate([
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Token symbol
+     * @summary Short ticker-like symbol used to represent the token (e.g., MTK)
+     */
+    ,
+    __metadata("design:type", String)
+], ERC20Token.prototype, "symbol", void 0);
+__decorate([
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Decimal precision for token amounts
+     * @summary Number of digits after the decimal separator used when formatting token balances
+     */
+    ,
+    __metadata("design:type", Number)
+], ERC20Token.prototype, "decimals", void 0);
+exports.ERC20Token = ERC20Token = __decorate([
+    (0, core_1.table)("erc20_tokens"),
+    (0, decorator_validation_1.model)(),
+    __metadata("design:paramtypes", [Object])
+], ERC20Token);
+/**
+ * @description ERC20 wallet model
+ * @summary Represents a holder account for an ERC20 token within the Fabric network, tracking balance and token association.
+ * @param {ModelArg<ERC20Wallet>} [m] - Optional partial data or another instance to initialize the model
+ * @return {void}
+ * @class ERC20Wallet
+ * @example
+ * const wallet = new ERC20Wallet({ id: "acct1", token: "MyToken", balance: 1000 });
+ * // Update balance via repository: await repo.update(wallet, ctx)
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Repo
+ *   App->>Repo: read("acct1", ctx)
+ *   Repo-->>App: ERC20Wallet
+ */
+let ERC20Wallet = class ERC20Wallet extends core_1.BaseModel {
+    constructor(m) {
+        super(m);
+    }
+};
+exports.ERC20Wallet = ERC20Wallet;
+__decorate([
+    (0, core_1.pk)({ type: String })
+    /**
+     * @description Wallet unique identifier
+     * @summary Primary key for the wallet; commonly references an account or identity
+     */
+    ,
+    __metadata("design:type", String)
+], ERC20Wallet.prototype, "id", void 0);
+__decorate([
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Associated token name
+     * @summary References the ERC20Token this wallet holds; maintained as a relationship for cascading updates/deletes
+     */
+    ,
+    __metadata("design:type", String)
+], ERC20Wallet.prototype, "token", void 0);
+__decorate([
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Token balance for this wallet
+     * @summary Current amount of the associated token held by this wallet
+     */
+    ,
+    __metadata("design:type", Number)
+], ERC20Wallet.prototype, "balance", void 0);
+__decorate([
+    (0, core_1.column)()
+    /**
+     * @description Captive flag or identifier
+     * @summary Optional field used by some flows to mark non-transferable funds or managed custody
+     */
+    ,
+    __metadata("design:type", String)
+], ERC20Wallet.prototype, "captive", void 0);
+exports.ERC20Wallet = ERC20Wallet = __decorate([
+    (0, core_1.table)("erc20_wallets"),
+    (0, decorator_validation_1.model)(),
+    __metadata("design:paramtypes", [Object])
+], ERC20Wallet);
+/**
+ * @description ERC20 allowance model
+ * @summary Captures an approval relationship where an owner allows a spender to transfer up to a certain value from the owner's wallet.
+ * @param {ModelArg<Allowance>} [m] - Optional partial data or another instance to initialize the model
+ * @return {void}
+ * @class Allowance
+ * @example
+ * const allowance = new Allowance({ owner: "acct1", spender: "acct2", value: 50 });
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   App->>App: new Allowance({ owner, spender, value })
+ */
+let Allowance = class Allowance extends core_1.BaseModel {
+    constructor(m) {
+        super(m);
+    }
+};
+exports.Allowance = Allowance;
+__decorate([
+    (0, core_1.pk)({ type: String })
+    /**
+     * @description Allowance unique identifier
+     * @summary Primary key for the allowance; typically a unique identifier for the approval relationship
+     */
+    ,
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Owner wallet identifier
+     * @summary Wallet that authorizes the allowance
+     */
+    ,
+    __metadata("design:type", String)
+], Allowance.prototype, "owner", void 0);
+__decorate([
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Spender wallet identifier
+     * @summary Wallet allowed to spend up to the approved value from the owner
+     */
+    ,
+    __metadata("design:type", String)
+], Allowance.prototype, "spender", void 0);
+__decorate([
+    (0, core_1.column)(),
+    (0, decorator_validation_1.required)()
+    /**
+     * @description Approved value
+     * @summary Maximum token amount the spender may transfer on behalf of the owner
+     */
+    ,
+    __metadata("design:type", Number)
+], Allowance.prototype, "value", void 0);
+exports.Allowance = Allowance = __decorate([
+    (0, core_1.table)("erc20_allowances"),
+    (0, decorator_validation_1.model)(),
+    __metadata("design:paramtypes", [Object])
+], Allowance);
+//# sourceMappingURL=models.js.map

package/lib/cjs/contracts/erc20/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/contracts/erc20/models.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAA8D;AAC9D,yEAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AAGI,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,gBAAS;IA8BvC,YAAY,CAAyB;QACnC,KAAK,CAAC,CAAC,CAAC,CAAC;IACX,CAAC;CACF,CAAA;AAjCY,gCAAU;AAMrB;IALC,IAAA,SAAE,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;;;wCACW;AAQd;IANC,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;yCACY;AAOf;IANC,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;0CACa;AAOhB;IANC,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;4CACe;qBA5BP,UAAU;IAFtB,IAAA,YAAK,EAAC,cAAc,CAAC;IACrB,IAAA,4BAAK,GAAE;;GACK,UAAU,CAiCtB;AAED;;;;;;;;;;;;;;;GAeG;AAGI,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,gBAAS;IA+BxC,YAAY,CAAyB;QACnC,KAAK,CAAC,CAAC,CAAC,CAAC;IACX,CAAC;CACF,CAAA;AAlCY,kCAAW;AAMtB;IALC,IAAA,SAAE,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;;;uCACS;AAQZ;IANC,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;0CACY;AAQf;IANC,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;4CACc;AAOjB;IALC,IAAA,aAAM,GAAE;IACT;;;OAGG;;;4CACc;sBA7BN,WAAW;IAFvB,IAAA,YAAK,EAAC,eAAe,CAAC;IACtB,IAAA,4BAAK,GAAE;;GACK,WAAW,CAkCvB;AAED;;;;;;;;;;;;GAYG;AAGI,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,gBAAS;IA8BtC,YAAY,CAAuB;QACjC,KAAK,CAAC,CAAC,CAAC,CAAC;IACX,CAAC;CACF,CAAA;AAjCY,8BAAS;AAYpB;IAXC,IAAA,SAAE,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;;IACF,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;wCACY;AAQf;IANC,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;0CACc;AAQjB;IANC,IAAA,aAAM,GAAE;IACR,IAAA,+BAAQ,GAAE;IACX;;;OAGG;;;wCACY;oBA5BJ,SAAS;IAFrB,IAAA,YAAK,EAAC,kBAAkB,CAAC;IACzB,IAAA,4BAAK,GAAE;;GACK,SAAS,CAiCrB"}

package/lib/{contracts → cjs/contracts}/index.cjs

@@ -33,4 +33,4 @@ __exportStar(require("./FabricContractRepositoryObservableHandler.cjs"), exports
 __exportStar(require("./logging.cjs"), exports);
 __exportStar(require("./types.cjs"), exports);
 __exportStar(require("./MigrationContract.cjs"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29udHJhY3RzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTs7Ozs7R0FLRztBQUNILGtEQUE0QixDQUFDLHVCQUF1QjtBQUNwRCxtREFBdUI7QUFDdkIsbURBQXVCO0FBQ3ZCLG9EQUF3QjtBQUN4Qix3REFBa0M7QUFDbEMsd0RBQWtDO0FBQ2xDLCtEQUF5QztBQUN6QyxnRUFBMEM7QUFDMUMsaUVBQTJDO0FBQzNDLGtGQUE0RDtBQUM1RCxnREFBMEI7QUFDMUIsOENBQXdCO0FBQ3hCLDBEQUFvQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGRlc2NyaXB0aW9uIENvbnRyYWN0cyBzdWJtb2R1bGUgZm9yIEh5cGVybGVkZ2VyIEZhYnJpYyBpbnRlZ3JhdGlvblxuICogQHN1bW1hcnkgQWdncmVnYXRlcyBjaGFpbmNvZGUtc2lkZSBidWlsZGluZyBibG9ja3MgaW5jbHVkaW5nIHJlcG9zaXRvcmllcywgc2VxdWVuY2VzLCBhZGFwdGVycywgYW5kIEVSQzIwIGhlbHBlcnMuIFRoaXMgZW50cnlwb2ludCByZS1leHBvcnRzIGNvbnRyYWN0LXJlbGF0ZWQgZWxlbWVudHMgc3VjaCBhcyB7QGxpbmsgRmFicmljQ29udHJhY3RSZXBvc2l0b3J5fSwsIGFuZCBDUlVEL0VSQzIwIHV0aWxpdGllcyBmb3IgY29tcG9zaW5nIEZhYnJpYyBjb250cmFjdHMuXG4gKiBAbmFtZXNwYWNlIGNvbnRyYWN0c1xuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljXG4gKi9cbmV4cG9ydCAqIGZyb20gXCIuL292ZXJyaWRlc1wiOyAvLyBmaXJzdCBvbmUgb24gcHVycG9zZVxuZXhwb3J0ICogZnJvbSBcIi4vYXV0aFwiO1xuZXhwb3J0ICogZnJvbSBcIi4vY3J1ZFwiO1xuZXhwb3J0ICogZnJvbSBcIi4vZXJjMjBcIjtcbmV4cG9ydCAqIGZyb20gXCIuL0NvbnRyYWN0QWRhcHRlclwiO1xuZXhwb3J0ICogZnJvbSBcIi4vQ29udHJhY3RDb250ZXh0XCI7XG5leHBvcnQgKiBmcm9tIFwiLi9GYWJyaWNDb250cmFjdERpc3BhdGNoXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9GYWJyaWNDb250cmFjdFBhZ2luYXRvclwiO1xuZXhwb3J0ICogZnJvbSBcIi4vRmFicmljQ29udHJhY3RSZXBvc2l0b3J5XCI7XG5leHBvcnQgKiBmcm9tIFwiLi9GYWJyaWNDb250cmFjdFJlcG9zaXRvcnlPYnNlcnZhYmxlSGFuZGxlclwiO1xuZXhwb3J0ICogZnJvbSBcIi4vbG9nZ2luZ1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vdHlwZXNcIjtcbmV4cG9ydCAqIGZyb20gXCIuL01pZ3JhdGlvbkNvbnRyYWN0XCI7XG4iXX0=
+//# sourceMappingURL=index.js.map

package/lib/cjs/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,kDAA4B,CAAC,uBAAuB;AACpD,mDAAuB;AACvB,mDAAuB;AACvB,oDAAwB;AACxB,wDAAkC;AAClC,wDAAkC;AAClC,+DAAyC;AACzC,gEAA0C;AAC1C,iEAA2C;AAC3C,kFAA4D;AAC5D,gDAA0B;AAC1B,8CAAwB;AACxB,0DAAoC"}

package/lib/cjs/contracts/logging.cjs

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractLogger = void 0;
+const logging_1 = require("@decaf-ts/logging");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const logging_context_1 = require("./../contract/logging-context.cjs");
+(0, logging_context_1.ensureContractLogFieldRegistration)();
+/**
+ * @description Logger implementation for Fabric chaincode contracts
+ * @summary Adapts the standard logging interface to work with Fabric's chaincode context
+ *
+ * @param {string} context - The logging context name
+ * @param {Partial<LoggingConfig> | undefined} conf - Optional logging configuration
+ * @param {Ctx} ctx - The Fabric chaincode context
+ *
+ * @class ContractLogger
+ * @extends {MiniLogger}
+ * @example
+ * ```typescript
+ * // In a Fabric chaincode contract
+ * import { ContractLogger } from '@decaf-ts/for-fabric';
+ *
+ * export class MyContract extends Contract {
+ *   @Transaction()
+ *   async myFunction(ctx: Context): Promise<void> {
+ *     const logger = new ContractLogger('MyContract', { level: 'info' }, ctx);
+ *
+ *     logger.info('Processing transaction');
+ *     logger.debug('Transaction details:', { ... });
+ *
+ *     // Do something
+ *
+ *     logger.info('Transaction complete');
+ *   }
+ * }
+ * ```
+ */
+class ContractLogger extends logging_1.MiniLogger {
+    constructor(context, conf, ctx) {
+        const normalizedConfig = (0, logging_context_1.enrichContractLoggingConfig)(conf, ctx);
+        super(context, normalizedConfig);
+        if (!ctx) {
+            this.sink = {
+                info: (msg) => console.log(msg),
+                verbose: (msg) => console.log(msg),
+                debug: (msg) => console.debug(msg),
+                error: (msg) => console.error(msg),
+                trace: (msg) => console.trace(msg),
+                warn: (msg) => console.warn(msg),
+                silly: (msg) => console.debug(msg),
+            };
+        }
+        else {
+            this.sink = ctx.logging.getLogger(context);
+            ctx.logging.setLevel(normalizedConfig?.level || logging_1.Logging.getConfig().level);
+        }
+    }
+    /**
+     * @description Logs a message at the specified level
+     * @summary Overrides the base log method to use the Fabric context's logger
+     * @param {LogLevel} level - The log level
+     * @param {StringLike | Error} msg - The message to log
+     * @param {Error} [stack] - Optional stack trace for errors
+     * @return {void}
+     */
+    log(level, msg, error, meta) {
+        if (logging_1.NumericLogLevels[this.config("level")] <
+            logging_1.NumericLogLevels[level])
+            return;
+        let method;
+        switch (level) {
+            case logging_1.LogLevel.benchmark:
+                method = this.sink.verbose;
+                break;
+            case logging_1.LogLevel.info:
+                method = this.sink.info;
+                break;
+            case logging_1.LogLevel.verbose:
+                method = this.sink.verbose;
+                break;
+            case logging_1.LogLevel.debug:
+                method = this.sink.debug;
+                break;
+            case logging_1.LogLevel.error:
+                method = this.sink.error;
+                break;
+            case logging_1.LogLevel.trace:
+                method = this.sink.trace;
+                break;
+            case logging_1.LogLevel.warn:
+                method = this.sink.warn;
+                break;
+            case logging_1.LogLevel.silly:
+                method = this.sink.silly;
+                break;
+            default:
+                throw new db_decorators_1.InternalError("Invalid log level");
+        }
+        method.call(this.sink, this.createLog(level, msg, error, meta));
+    }
+}
+exports.ContractLogger = ContractLogger;
+/**
+ * @description Factory function for creating ContractLogger instances
+ * @summary Creates a new ContractLogger with the given context, config, and Fabric context
+ * @param {string} object - The logging context name
+ * @param {Partial<LoggingConfig> | undefined} config - Optional logging configuration
+ * @param {Ctx} ctx - The Fabric chaincode context
+ * @return {ContractLogger} A new ContractLogger instance
+ * @function factory
+ * @memberOf module:fabric.contracts
+ */
+const factory = (object, config, ctx) => {
+    return new ContractLogger(object || ContractLogger.name, config || {}, ctx);
+};
+// Set the factory as the default logger factory
+logging_1.Logging.setFactory(factory);
+//# sourceMappingURL=logging.js.map

package/lib/cjs/contracts/logging.js.map

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

package/lib/cjs/contracts/overrides.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@decaf-ts/core");
+const uuid_1 = require("./uuid.cjs");
+core_1.UUID.prototype.generate = function generate(seed) {
+    return (0, uuid_1.uuidFromSeed)(seed);
+};
+//# sourceMappingURL=overrides.js.map

package/lib/cjs/contracts/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../../../src/contracts/overrides.ts"],"names":[],"mappings":";;AAAA,yCAAsC;AACtC,qCAAsC;AAEtC,WAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,QAAQ,CAAC,IAAY;IACtD,OAAO,IAAA,mBAAY,EAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC"}

package/lib/cjs/contracts/types.cjs

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

package/lib/cjs/contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/contracts/types.ts"],"names":[],"mappings":""}

package/lib/cjs/contracts/uuid.cjs

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bytesToUuidV5Style = bytesToUuidV5Style;
+exports.uuidFromSeed = uuidFromSeed;
+const encoder = new TextEncoder();
+function bytesToUuidV5Style(bytes16) {
+    const b = bytes16.slice(0, 16);
+    // Set version to 5 (0101xxxx) to signal deterministic hashing
+    b[6] = (b[6] & 0x0f) | 0x50;
+    // Set variant to RFC 4122 (10xxxxxx)
+    b[8] = (b[8] & 0x3f) | 0x80;
+    const hex = [...b].map((x) => x.toString(16).padStart(2, "0")).join("");
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20, 32),
+    ].join("-");
+}
+async function uuidFromSeed(seed) {
+    // Browser / any runtime with WebCrypto
+    if (globalThis.crypto?.subtle) {
+        const data = encoder.encode(seed);
+        const digest = await globalThis.crypto.subtle.digest("SHA-256", data);
+        return bytesToUuidV5Style(new Uint8Array(digest).slice(0, 16));
+    }
+    // Node fallback: dynamic import avoids bundling node:crypto into browser
+    const nodeCrypto = await Promise.resolve().then(() => __importStar(require("crypto")));
+    const { createHash, webcrypto } = nodeCrypto;
+    if (webcrypto?.subtle) {
+        const data = encoder.encode(seed);
+        const digest = await webcrypto.subtle.digest("SHA-256", data);
+        return bytesToUuidV5Style(new Uint8Array(digest).slice(0, 16));
+    }
+    const hex = createHash("sha256").update(seed).digest("hex");
+    const bytes = new Uint8Array(16);
+    for (let i = 0; i < 16; i++)
+        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    return bytesToUuidV5Style(bytes);
+}
+//# sourceMappingURL=uuid.js.map

package/lib/cjs/contracts/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/contracts/uuid.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,gDAkBC;AAED,oCAuBC;AA7CD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,SAAgB,kBAAkB,CAAC,OAAmB;IACpD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/B,8DAA8D;IAC9D,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE5B,qCAAqC;IACrC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE5B,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExE,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAChB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;KAClB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,uCAAuC;IACvC,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACtE,OAAO,kBAAkB,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,yEAAyE;IACzE,MAAM,UAAU,GAAG,wDAAa,QAAQ,GAAC,CAAC;IAC1C,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;IAE7C,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC9D,OAAO,kBAAkB,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QACzB,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/lib/{index.cjs → cjs/index.cjs}

@@ -23,4 +23,4 @@ __exportStar(require("./client/index.cjs"), exports);
 // export * from "./contracts";
 __exportStar(require("./shared/index.cjs"), exports);
 __exportStar(require("./version.cjs"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7O0dBSUc7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFSCxxREFBeUI7QUFDekIsK0JBQStCO0FBQy9CLHFEQUF5QjtBQUN6QixnREFBMEIiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBkZXNjcmlwdGlvbiBIeXBlcmxlZGdlciBGYWJyaWMgTW9kdWxlIGZvciBEZWNhZi10c1xuICogQHN1bW1hcnkgUHJvdmlkZXMgY2xpZW50LXNpZGUgYW5kIGNoYWluY29kZS1zaWRlIHRvb2xpbmcgZm9yIGJ1aWxkaW5nIEh5cGVybGVkZ2VyIEZhYnJpYyBhcHBsaWNhdGlvbnMgd2l0aCBEZWNhZi10cy4gRXhwb3NlcyBjbGllbnQgYWRhcHRlcnMsIHJlcG9zaXRvcmllcywgY29udHJhY3QgYWRhcHRlcnMsIHNlcXVlbmNlcywgdXRpbGl0aWVzLCBhbmQgc2hhcmVkIHR5cGVzIHRvIHN0cmVhbWxpbmUgZGV2ZWxvcG1lbnQgYW5kIGludGVyYWN0aW9uIHdpdGggRmFicmljIG5ldHdvcmtzLiBTZWUge0BsaW5rIG1vZHVsZTpmYWJyaWMuY2xpZW50fSwge0BsaW5rIG1vZHVsZTpmYWJyaWMuY29udHJhY3RzfSwgYW5kIHtAbGluayBtb2R1bGU6ZmFicmljLnNoYXJlZH0gZm9yIGdyb3VwZWQgZXhwb3J0cy5cbiAqIEBtb2R1bGUgZm9yLWZhYnJpY1xuICovXG5cbmV4cG9ydCAqIGZyb20gXCIuL2NsaWVudFwiO1xuLy8gZXhwb3J0ICogZnJvbSBcIi4vY29udHJhY3RzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9zaGFyZWRcIjtcbmV4cG9ydCAqIGZyb20gXCIuL3ZlcnNpb25cIjtcbiJdfQ==
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,qDAAyB;AACzB,+BAA+B;AAC/B,qDAAyB;AACzB,gDAA0B"}

package/lib/{shared/ClientSerializer.d.ts → cjs/shared/ClientSerializer.cjs}

@@ -1,4 +1,9 @@
-import { JSONSerializer, Model } from "@decaf-ts/decorator-validation";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientSerializer = void 0;
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const decoration_1 = require("@decaf-ts/decoration");
 /**
  * @description Client-side JSON serializer for Decaf models targeting Hyperledger Fabric
  * @summary Extends the base JSONSerializer to embed model metadata (anchor) required to reconstruct instances on the client, and to safely serialize/deserialize Fabric-bound models.
@@ -23,8 +28,10 @@ import { JSONSerializer, Model } from "@decaf-ts/decorator-validation";
  *   Serializer->>Model: Model.build(parsed, anchor)
  *   Model-->>App: instance
  */
-export declare class ClientSerializer<M extends Model> extends JSONSerializer<M> {
-    constructor();
+class ClientSerializer extends decorator_validation_1.JSONSerializer {
+    constructor() {
+        super();
+    }
     /**
      * @description Prepare a model for JSON serialization embedding class anchor
      * @summary Clones the model and injects the class metadata anchor so it can be reconstructed during deserialization. Falls back to provided table name if metadata is not available.
@@ -33,14 +40,32 @@ export declare class ClientSerializer<M extends Model> extends JSONSerializer<M>
      * @param {string} [modelName] - Optional table name to use when metadata cannot be derived
      * @return {Record<string, any>} A plain object ready to be JSON.stringify'd
      */
-    protected preSerialize(model: M, modelName?: string): Record<string, any>;
+    preSerialize(model, modelName) {
+        // TODO: nested preserialization (so increase performance when deserializing)
+        const toSerialize = Object.assign({}, model);
+        let metadata = decoration_1.Metadata.modelName(model.constructor);
+        if (!metadata || metadata === "Object")
+            if (modelName)
+                metadata = modelName;
+            else
+                throw new db_decorators_1.SerializationError(`Could not find metadata for ${model.constructor.name}`);
+        toSerialize[decorator_validation_1.ModelKeys.ANCHOR] = metadata;
+        return toSerialize;
+    }
     /**
      * @description Rebuilds a model from its JSON serialization
      * @summary Parses the JSON string, retrieves the embedded model anchor, and uses Model.build to reconstruct the original instance
      * @param {string} str - The JSON string previously produced by serialize
      * @return {M} The reconstructed model instance
      */
-    deserialize(str: string): M;
+    deserialize(str) {
+        const deserialization = JSON.parse(str);
+        const className = deserialization[decorator_validation_1.ModelKeys.ANCHOR];
+        if (!className)
+            throw new Error("Could not find class reference in serialized model");
+        const model = decorator_validation_1.Model.build(deserialization, className);
+        return model;
+    }
     /**
      * @description Serializes a model to a JSON string
      * @summary Prepares the model via preSerialize, embedding metadata needed for reconstruction, and returns a JSON string representation
@@ -48,5 +73,9 @@ export declare class ClientSerializer<M extends Model> extends JSONSerializer<M>
      * @param {string} [table] - Optional table name to include as anchor when metadata is unavailable
      * @return {string} A JSON string containing the serialized model with anchor metadata
      */
-    serialize(model: M, modelName?: string): string;
+    serialize(model, modelName) {
+        return JSON.stringify(this.preSerialize(model, modelName));
+    }
 }
+exports.ClientSerializer = ClientSerializer;
+//# sourceMappingURL=ClientSerializer.js.map

package/lib/cjs/shared/ClientSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientSerializer.js","sourceRoot":"","sources":["../../../src/shared/ClientSerializer.ts"],"names":[],"mappings":";;;AAAA,yEAIwC;AACxC,2DAA6D;AAC7D,qDAA6D;AAE7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,gBAAkC,SAAQ,qCAAiB;IACtE;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IACD;;;;;;;OAOG;IACgB,YAAY,CAAC,KAAQ,EAAE,SAAkB;QAC1D,6EAA6E;QAC7E,MAAM,WAAW,GAAwB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,QAAQ,GAAG,qBAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,WAA6B,CAAC,CAAC;QAEvE,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ;YACpC,IAAI,SAAS;gBAAE,QAAQ,GAAG,SAAS,CAAC;;gBAElC,MAAM,IAAI,kCAAkB,CAC1B,+BAA+B,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CACxD,CAAC;QACN,WAAW,CAAC,gCAAS,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;QACzC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACM,WAAW,CAAC,GAAW;QAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,eAAe,CAAC,gCAAS,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS;YACZ,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,MAAM,KAAK,GAAM,4BAAK,CAAC,KAAK,CAAC,eAAe,EAAE,SAAS,CAAiB,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACM,SAAS,CAAC,KAAQ,EAAE,SAAkB;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7D,CAAC;CACF;AApDD,4CAoDC"}

package/lib/cjs/shared/DeterministicSerializer.cjs

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeterministicSerializer = void 0;
+exports.sortKeysOnlyRecursive = sortKeysOnlyRecursive;
+/* eslint-disable @typescript-eslint/no-require-imports */
+const decoration_1 = require("@decaf-ts/decoration");
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+/**
+ * @description Recursively sorts object keys without reordering arrays
+ * @param {any} obj - The value to process
+ * @return {any} A copy with sorted object keys but preserved array order
+ */
+function sortKeysOnlyRecursive(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(sortKeysOnlyRecursive);
+    if (obj.constructor !== Object)
+        return obj;
+    return Object.keys(obj)
+        .sort()
+        .reduce((acc, key) => {
+        acc[key] = sortKeysOnlyRecursive(obj[key]);
+        return acc;
+    }, {});
+}
+/**
+ * @description Deterministic JSON serializer for Fabric models
+ * @summary Ensures stable, deterministic JSON output by sorting object keys recursively before stringification, which is important for Fabric endorsement and hashing. Extends JSONSerializer to plug into existing Decaf model serialization flow.
+ * @template M - The Decaf Model subtype serialized by this instance
+ * @param {void} [constructor] No public constructor arguments
+ * @class DeterministicSerializer
+ * @example
+ * const serializer = new DeterministicSerializer<MyModel>();
+ * const json = serializer.serialize(model);
+ * const rebuilt = serializer.deserialize(json);
+ * @mermaid
+ * sequenceDiagram
+ *   participant Caller
+ *   participant DS as DeterministicSerializer
+ *   Caller->>DS: serialize(model)
+ *   DS->>DS: preSerialize(model)
+ *   DS->>DS: sort-keys-recursive
+ *   DS->>DS: json-stringify-deterministic
+ *   DS-->>Caller: string
+ *   Caller->>DS: deserialize(string)
+ *   DS-->>Caller: model
+ */
+class DeterministicSerializer extends decorator_validation_1.JSONSerializer {
+    constructor() {
+        super();
+    }
+    preSerialize(model) {
+        // TODO: nested preserialization (so increase performance when deserializing)
+        // TODO: Verify why there is no metadata
+        const toSerialize = Object.assign({}, model);
+        let metadata;
+        try {
+            metadata = decoration_1.Metadata.modelName(model.constructor);
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (error) {
+            metadata = undefined;
+        }
+        toSerialize[decorator_validation_1.ModelKeys.ANCHOR] = metadata || model.constructor.name;
+        const preSerialize = function preSerialize(obj) {
+            // eslint-disable-next-line @typescript-eslint/no-this-alias
+            const self = this;
+            if (typeof obj !== "object")
+                return obj;
+            if (Array.isArray(obj))
+                return obj.map((o) => preSerialize.call(self, o));
+            return this.preSerialize.call(this, obj);
+        }.bind(this);
+        decorator_validation_1.Model.relations(model).forEach((r) => {
+            toSerialize[r] = preSerialize(toSerialize[r]);
+        });
+        return toSerialize;
+    }
+    /**
+     * @summary Rebuilds a model from a serialization
+     * @param {string} str
+     *
+     * @throws {Error} If it fails to parse the string, or to build the model
+     */
+    deserialize(str) {
+        const deserialization = JSON.parse(str);
+        const className = deserialization[decorator_validation_1.ModelKeys.ANCHOR];
+        if (!className)
+            throw new Error("Could not find class reference in serialized model");
+        const model = decorator_validation_1.Model.build(deserialization, className);
+        return model;
+    }
+    /**
+     * @description Serialize a model into a deterministic JSON string
+     * @summary Prepares the model with preSerialize, sorts keys recursively, and stringifies deterministically for stable ordering
+     * @param {M} model - The model instance to serialize
+     * @return {string} Deterministic JSON representation of the model
+     */
+    serialize(model) {
+        const stringify = require("json-stringify-deterministic");
+        return stringify(sortKeysOnlyRecursive(this.preSerialize(model)));
+    }
+}
+exports.DeterministicSerializer = DeterministicSerializer;
+//# sourceMappingURL=DeterministicSerializer.js.map

package/lib/cjs/shared/DeterministicSerializer.js.map

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