@decaf-ts/for-fabric 0.12.7 → 0.12.8

package/README.md

@@ -1,11 +1,11 @@
 ![Banner](./workdocs/assets/decaf-logo.svg)
+
 ## Hyperledger Fabric Contracts for DECAF
 
 Chaincode-side building blocks for Hyperledger Fabric written in TypeScript. This module provides repositories, CRUD contracts (object and serialized JSON), an ERC20 sample contract, Fabric-backed sequences, event emission, and context-aware logging. It adapts DECAF’s data-access patterns to Fabric’s world-state so you can write smart contracts with the same Repository/Model abstractions used elsewhere in DECAF.
 
 > Release docs refreshed on 2025-11-26. See [workdocs/reports/RELEASE_NOTES.md](./workdocs/reports/RELEASE_NOTES.md) for ticket summaries.
 
-
 ![Licence](https://img.shields.io/github/license/decaf-ts/for-fabric.svg?style=plastic)
 ![GitHub language count](https://img.shields.io/github/languages/count/decaf-ts/for-fabric?style=plastic)
 ![GitHub top language](https://img.shields.io/github/languages/top/decaf-ts/for-fabric?style=plastic)
@@ -34,6 +34,7 @@ Documentation available [here](https://decaf-ts.github.io/for-fabric/)
 This module focuses on the chaincode (contracts) side of @decaf-ts/for-fabric. It adapts DECAF’s Repository/Model/Adapter abstractions to Hyperledger Fabric’s world state and execution context so you can implement smart contracts with familiar patterns and minimal boilerplate.
 
 Key ideas:
+
 - Keep your domain models as annotated classes (using @decaf-ts/decorator-validation).
 - Use a Repository to persist/read/query models through a Fabric-aware Adapter.
 - Compose reusable CRUD contracts and utilities instead of hand-writing stub calls.
@@ -42,31 +43,38 @@ Key ideas:
 
 Contracts building blocks identified in src/contracts:
 
-1) Core context and types
+1. Core context and types
+
 - FabricContractContext: Extends the generic Context to expose Fabric-specific properties (stub, clientIdentity, logger) and timestamp resolution from the ledger.
 - FabricContractFlags: Interface extending RepositoryFlags with stub, clientIdentity and logger for contract calls.
 
-2) Logging
+2. Logging
+
 - ContractLogger: MiniLogger-compatible logger bound to the Fabric contract Context. It honors log levels and forwards to the underlying Fabric logger.
 
-3) Adapter and repository
+3. Adapter and repository
+
 - FabricContractAdapter: Chaincode-side Adapter that implements CRUD, bulk operations, raw Mango queries, result iteration, model preparation/reversion, composite-key prefixes, and sequence creation. Bridges DECAF abstractions to Fabric (ChaincodeStub, ClientIdentity) and CouchDB-style queries.
 - FabricContractRepository<M>: Repository for models inside chaincode. Supports create, update, createAll, updateAll, read/readAll, raw queries (Mango), select projections, prefix-based bulk ops, and event emission through an ObserverHandler.
 - FabricContractRepositoryObservableHandler: ObserverHandler that emits Fabric events via stub.setEvent using names generated by generateFabricEventName.
 
-4) Sequences
+4. Sequences
+
 - FabricContractDBSequence: Fabric-backed implementation of Sequence with current, next and range. Stores values in the world state via FabricContractRepository and supports Number or BigInt sequences with configurable startWith and incrementBy.
 
-5) CRUD contracts
+5. CRUD contracts
+
 - FabricCrudContract<M>: Base smart contract exposing CRUD endpoints (create, read, update, delete, createAll, readAll, updateAll, deleteAll, raw, init, healthcheck) for a model type. Uses DeterministicSerializer and the FabricContractAdapter/Repository behind the scenes and provides logFor(ctx).
 - SerializedCrudContract<M>: Same endpoints as FabricCrudContract but takes/returns JSON strings (de)serialized to the model class. This simplifies client interactions and is used in tests.
 
-6) ERC20 sample
+6. ERC20 sample
+
 - ERC20Token, ERC20Wallet, Allowance: Sample domain models for an ERC20-like token, wallets and allowances.
 - FabricStatement<M,R>: A CouchDBStatement bridge that runs Mango queries through FabricContractAdapter, handling primary key projection when needed.
-- FabricERC20Contract: A full ERC20 smart contract showcasing repository-based persistence and arithmetic helpers. Implements Initialize, CheckInitialized, TokenName, Symbol, Decimals, TotalSupply, BalanceOf, Transfer, TransferFrom, Approve, Allowance, Mint, Burn, BurnFrom, ClientAccountBalance, ClientAccountID and an internal _transfer helper.
+- FabricERC20Contract: A full ERC20 smart contract showcasing repository-based persistence and arithmetic helpers. Implements Initialize, CheckInitialized, TokenName, Symbol, Decimals, TotalSupply, BalanceOf, Transfer, TransferFrom, Approve, Allowance, Mint, Burn, BurnFrom, ClientAccountBalance, ClientAccountID and an internal \_transfer helper.
 
 Design notes:
+
 - Deterministic serialization is used to ensure stable bytes for world-state writes.
 - onCreate/onCreateUpdate hooks from db-decorators are leveraged by the adapter to set primary keys and creator/owner metadata.
 - Mango queries (CouchDB) are used for rich queries via getQueryResultWithPagination.
@@ -74,7 +82,6 @@ Design notes:
 
 With these components you can build robust chaincode while keeping code concise, testable, and aligned with DECAF’s architecture.
 
-
 ### How to Use
 
 ## Installation
@@ -88,55 +95,55 @@ npm install @decaf-ts/for-fabric
 ### Connecting to a Fabric Network
 
 ```typescript
-import { FabricAdapter, PeerConfig } from '@decaf-ts/for-fabric';
+import { FabricAdapter, PeerConfig } from "@decaf-ts/for-fabric";
 
 // Configure connection to a Fabric peer
 const config: PeerConfig = {
-  mspId: 'Org1MSP',
-  peerEndpoint: 'localhost:7051',
-  channelName: 'mychannel',
-  chaincodeName: 'mycc',
-  contractName: 'mycontract',
-  tlsCertPath: '/path/to/tls/cert',
-  certDirectoryPath: '/path/to/cert/dir',
-  keyDirectoryPath: '/path/to/key/dir',
-  cryptoPath: '/path/to/crypto',
-  peerHostAlias: 'peer0.org1.example.com',
-  caEndpoint: 'localhost:7054',
-  caTlsCertificate: '/path/to/ca/tls/cert',
-  caCert: '/path/to/ca/cert',
-  caKey: '/path/to/ca/key',
-  ca: 'ca.org1.example.com'
+  mspId: "Org1MSP",
+  peerEndpoint: "localhost:7051",
+  channelName: "mychannel",
+  chaincodeName: "mycc",
+  contractName: "mycontract",
+  tlsCertPath: "/path/to/tls/cert",
+  certDirectoryPath: "/path/to/cert/dir",
+  keyDirectoryPath: "/path/to/key/dir",
+  cryptoPath: "/path/to/crypto",
+  peerHostAlias: "peer0.org1.example.com",
+  caEndpoint: "localhost:7054",
+  caTlsCertificate: "/path/to/ca/tls/cert",
+  caCert: "/path/to/ca/cert",
+  caKey: "/path/to/ca/key",
+  ca: "ca.org1.example.com",
 };
 
 // Create an adapter instance
-const adapter = new FabricAdapter(config, 'org1-adapter');
+const adapter = new FabricAdapter(config, "org1-adapter");
 
 // Use the adapter to interact with the Fabric network
 async function createAsset() {
-  const asset = { id: 'asset1', value: 'Asset 1 Value' };
-  return await adapter.create('assets', 'asset1', asset, {}, mySerializer);
+  const asset = { id: "asset1", value: "Asset 1 Value" };
+  return await adapter.create("assets", "asset1", asset, {}, mySerializer);
 }
 
 async function readAsset(id: string) {
-  return await adapter.read('assets', id, mySerializer);
+  return await adapter.read("assets", id, mySerializer);
 }
 
 async function updateAsset(id: string, newValue: string) {
   const asset = await readAsset(id);
   asset.value = newValue;
-  return await adapter.update('assets', id, asset, {}, mySerializer);
+  return await adapter.update("assets", id, asset, {}, mySerializer);
 }
 
 async function deleteAsset(id: string) {
-  return await adapter.delete('assets', id, mySerializer);
+  return await adapter.delete("assets", id, mySerializer);
 }
 
 async function queryAssets(owner: string) {
   const query = {
     selector: {
-      owner: owner
-    }
+      owner: owner,
+    },
   };
   return await adapter.raw(query, true);
 }
@@ -145,7 +152,7 @@ async function queryAssets(owner: string) {
 ### Listening for Chaincode Events
 
 ```typescript
-import { FabricAdapter, FabricDispatch } from '@decaf-ts/for-fabric';
+import { FabricAdapter, FabricDispatch } from "@decaf-ts/for-fabric";
 
 async function setupEventListener(config: PeerConfig) {
   // Create a client
@@ -158,7 +165,7 @@ async function setupEventListener(config: PeerConfig) {
   dispatch.configure(config);
 
   // Register an observer for a specific table and event
-  dispatch.observe('assets', 'create', (id) => {
+  dispatch.observe("assets", "create", (id) => {
     console.log(`Asset created: ${id}`);
     // Fetch the new asset or update UI
   });
@@ -174,29 +181,29 @@ async function setupEventListener(config: PeerConfig) {
 ### Working with Identities and Certificates
 
 ```typescript
-import { 
-  getIdentity, 
-  getSigner, 
-  readFile, 
-  getCAUser 
-} from '@decaf-ts/for-fabric';
+import {
+  getIdentity,
+  getSigner,
+  readFile,
+  getCAUser,
+} from "@decaf-ts/for-fabric";
 
 async function setupIdentity() {
   // Read a certificate file
-  const tlsCert = await readFile('/path/to/tls/cert');
+  const tlsCert = await readFile("/path/to/tls/cert");
 
   // Get an identity from a certificate directory
-  const identity = await getIdentity('Org1MSP', '/path/to/cert/dir');
+  const identity = await getIdentity("Org1MSP", "/path/to/cert/dir");
 
   // Get a signer from a key directory
-  const signer = await getSigner('/path/to/key/dir');
+  const signer = await getSigner("/path/to/key/dir");
 
   // Create a CA user
   const user = await getCAUser(
-    'user1', 
-    privateKeyPem, 
-    certificatePem, 
-    'Org1MSP'
+    "user1",
+    privateKeyPem,
+    certificatePem,
+    "Org1MSP"
   );
 
   return { identity, signer, user };
@@ -208,9 +215,9 @@ async function setupIdentity() {
 ### Creating a Model
 
 ```typescript
-import { Model, id, property, table } from '@decaf-ts/decorator-validation';
+import { Model, id, property, table } from "@decaf-ts/decorator-validation";
 
-@table('assets')
+@table("assets")
 export class Asset extends Model {
   @id()
   id: string;
@@ -229,14 +236,17 @@ export class Asset extends Model {
 ### Creating a CRUD Contract
 
 ```typescript
-import { FabricCrudContract } from '@decaf-ts/for-fabric';
-import { Context, Contract, Info, Transaction } from 'fabric-contract-api';
-import { Asset } from './asset';
-
-@Info({ title: 'AssetContract', description: 'Smart contract for trading assets' })
+import { FabricCrudContract } from "@decaf-ts/for-fabric";
+import { Context, Contract, Info, Transaction } from "fabric-contract-api";
+import { Asset } from "./asset";
+
+@Info({
+  title: "AssetContract",
+  description: "Smart contract for trading assets",
+})
 export class AssetContract extends FabricCrudContract<Asset> {
   constructor() {
-    super('AssetContract', Asset);
+    super("AssetContract", Asset);
   }
 
   // The base class already provides standard CRUD operations:
@@ -256,7 +266,7 @@ export class AssetContract extends FabricCrudContract<Asset> {
       results.push({
         txId: value.txId,
         timestamp: value.timestamp,
-        value: JSON.parse(value.value.toString('utf8'))
+        value: JSON.parse(value.value.toString("utf8")),
       });
 
       result = await iterator.next();
@@ -267,7 +277,11 @@ export class AssetContract extends FabricCrudContract<Asset> {
   }
 
   @Transaction()
-  async transferAsset(ctx: Context, id: string, newOwner: string): Promise<Asset> {
+  async transferAsset(
+    ctx: Context,
+    id: string,
+    newOwner: string
+  ): Promise<Asset> {
     const asset = await this.read(ctx, id);
     asset.owner = newOwner;
     return await this.update(ctx, asset);
@@ -278,14 +292,14 @@ export class AssetContract extends FabricCrudContract<Asset> {
 ### Using the Contract Adapter Directly
 
 ```typescript
-import { FabricContractAdapter } from '@decaf-ts/for-fabric';
-import { Context, Contract, Transaction } from 'fabric-contract-api';
+import { FabricContractAdapter } from "@decaf-ts/for-fabric";
+import { Context, Contract, Transaction } from "fabric-contract-api";
 
 export class CustomContract extends Contract {
   private adapter: FabricContractAdapter;
 
   constructor() {
-    super('CustomContract');
+    super("CustomContract");
     this.adapter = new FabricContractAdapter();
   }
 
@@ -293,7 +307,7 @@ export class CustomContract extends Contract {
   async createRecord(ctx: Context, id: string, data: string): Promise<any> {
     const record = { id, data, timestamp: Date.now() };
     return await this.adapter.create(
-      'records',
+      "records",
       id,
       record,
       {},
@@ -305,15 +319,14 @@ export class CustomContract extends Contract {
   async queryRecords(ctx: Context, owner: string): Promise<any[]> {
     const query = {
       selector: {
-        owner: owner
-      }
+        owner: owner,
+      },
     };
 
-    return await this.adapter.raw(
-      query,
-      true,
-      { stub: ctx.stub, logger: ctx.logging }
-    );
+    return await this.adapter.raw(query, true, {
+      stub: ctx.stub,
+      logger: ctx.logging,
+    });
   }
 }
 ```
@@ -321,26 +334,22 @@ export class CustomContract extends Contract {
 ### Emitting and Handling Events
 
 ```typescript
-import { 
+import {
   FabricContractRepositoryObservableHandler,
   generateFabricEventName,
-  parseEventName
-} from '@decaf-ts/for-fabric';
-import { Context } from 'fabric-contract-api';
-import { OperationKeys } from '@decaf-ts/db-decorators';
+  parseEventName,
+} from "@decaf-ts/for-fabric";
+import { Context } from "fabric-contract-api";
+import { OperationKeys } from "@decaf-ts/db-decorators";
 
 // In chaincode: Emit an event
 async function emitEvent(ctx: Context, tableName: string, id: string) {
   const handler = new FabricContractRepositoryObservableHandler();
-  const logger = ctx.logging.getLogger('EventHandler');
+  const logger = ctx.logging.getLogger("EventHandler");
 
-  await handler.updateObservers(
-    logger,
-    tableName,
-    OperationKeys.CREATE,
-    id,
-    { stub: ctx.stub }
-  );
+  await handler.updateObservers(logger, tableName, OperationKeys.CREATE, id, {
+    stub: ctx.stub,
+  });
 }
 
 // In client: Parse an event name
@@ -357,7 +366,6 @@ function handleEvent(eventName: string, payload: Buffer) {
 
 For more detailed examples and API documentation, refer to the [API Reference](./docs/api/index.html).
 
-
 ## Contracts APIs (Chaincode)
 
 The following examples are based on the contracts in for-fabric/src/contracts and reflect the patterns used by the unit/integration tests.
@@ -367,29 +375,31 @@ The following examples are based on the contracts in for-fabric/src/contracts an
 Description: Base contract exposing CRUD endpoints for a model class. It uses Repository and DeterministicSerializer under the hood.
 
 ```typescript
-import { Context, Transaction, Contract } from 'fabric-contract-api';
-import { model, ModelArg, required } from '@decaf-ts/decorator-validation';
-import { BaseModel, pk } from '@decaf-ts/core';
-import { FabricCrudContract } from '@decaf-ts/for-fabric/contracts';
+import { Context, Transaction, Contract } from "fabric-contract-api";
+import { model, ModelArg, required } from "@decaf-ts/decorator-validation";
+import { BaseModel, pk } from "@decaf-ts/core";
+import { FabricCrudContract } from "@decaf-ts/for-fabric/contracts";
 
 @model()
 class Person extends BaseModel {
-  @pk({ type: 'Number' })
+  @pk({ type: "Number" })
   id!: number;
   @required() name!: string;
-  constructor(arg?: ModelArg<Person>) { super(arg); }
+  constructor(arg?: ModelArg<Person>) {
+    super(arg);
+  }
 }
 
 export class PersonContract extends FabricCrudContract<Person> {
   constructor() {
-    super('PersonContract', Person);
+    super("PersonContract", Person);
   }
 
   @Transaction(false)
   async ping(ctx: Context): Promise<string> {
     // Uses FabricCrudContract.logFor
-    this.logFor(ctx).info('ping');
-    return 'pong';
+    this.logFor(ctx).info("ping");
+    return "pong";
   }
 }
 ```
@@ -401,28 +411,33 @@ Usage in tests: see tests/unit/contracts.test.ts pattern where a SerializedCrudC
 Description: Same endpoints as FabricCrudContract but takes and returns JSON strings. Useful for simple clients. Based on tests/unit/contracts.test.ts.
 
 ```typescript
-import { Context } from 'fabric-contract-api';
-import { model, ModelArg, required } from '@decaf-ts/decorator-validation';
-import { BaseModel, pk } from '@decaf-ts/core';
-import { SerializedCrudContract } from '@decaf-ts/for-fabric/contracts';
+import { Context } from "fabric-contract-api";
+import { model, ModelArg, required } from "@decaf-ts/decorator-validation";
+import { BaseModel, pk } from "@decaf-ts/core";
+import { SerializedCrudContract } from "@decaf-ts/for-fabric/contracts";
 
 @model()
 class TestModel extends BaseModel {
-  @pk({ type: 'Number' }) id!: number;
+  @pk({ type: "Number" }) id!: number;
   @required() name!: string;
   @required() nif!: string;
-  constructor(arg?: ModelArg<TestModel>) { super(arg); }
+  constructor(arg?: ModelArg<TestModel>) {
+    super(arg);
+  }
 }
 
 export class TestModelContract extends SerializedCrudContract<TestModel> {
   constructor() {
-    super('TestModelContract', TestModel);
+    super("TestModelContract", TestModel);
   }
 }
 
 // Example invocation (mirrors unit test usage)
 async function createExample(contract: TestModelContract, ctx: Context) {
-  const payload = new TestModel({ name: 'Alice', nif: '123456789' }).serialize();
+  const payload = new TestModel({
+    name: "Alice",
+    nif: "123456789",
+  }).serialize();
   const resultJson = await contract.create(ctx, payload);
   const created = new TestModel(JSON.parse(resultJson));
   return created;
@@ -434,24 +449,29 @@ async function createExample(contract: TestModelContract, ctx: Context) {
 Description: Chaincode-side repository used inside contract methods to persist and query models.
 
 ```typescript
-import { Context } from 'fabric-contract-api';
-import { Repo } from '@decaf-ts/core';
-import { model, required, ModelArg } from '@decaf-ts/decorator-validation';
-import { BaseModel, pk } from '@decaf-ts/core';
-import { FabricContractRepository } from '@decaf-ts/for-fabric/contracts';
+import { Context } from "fabric-contract-api";
+import { Repo } from "@decaf-ts/core";
+import { model, required, ModelArg } from "@decaf-ts/decorator-validation";
+import { BaseModel, pk } from "@decaf-ts/core";
+import { FabricContractRepository } from "@decaf-ts/for-fabric/contracts";
 
 @model()
 class Asset extends BaseModel {
   @pk() id!: string;
   @required() owner!: string;
-  constructor(arg?: ModelArg<Asset>) { super(arg); }
+  constructor(arg?: ModelArg<Asset>) {
+    super(arg);
+  }
 }
 
 export class AssetContract extends Contract {
   private repo: Repo<Asset, any, any, any, any>;
   constructor() {
-    super('AssetContract');
-    this.repo = new FabricContractRepository<Asset>(new (require('@decaf-ts/for-fabric').contracts.FabricContractAdapter)(), Asset);
+    super("AssetContract");
+    this.repo = new FabricContractRepository<Asset>(
+      new (require("@decaf-ts/for-fabric").contracts.FabricContractAdapter)(),
+      Asset
+    );
   }
 
   @Transaction()
@@ -477,19 +497,22 @@ export class AssetContract extends Contract {
 Description: World-state backed sequences for generating incremental values.
 
 ```typescript
-import { Context } from 'fabric-contract-api';
-import { FabricContractDBSequence } from '@decaf-ts/for-fabric/contracts';
-import { FabricContractAdapter } from '@decaf-ts/for-fabric/contracts';
+import { Context } from "fabric-contract-api";
+import { FabricContractDBSequence } from "@decaf-ts/for-fabric/contracts";
+import { FabricContractAdapter } from "@decaf-ts/for-fabric/contracts";
 
 const adapter = new FabricContractAdapter();
 
 export class OrderContract extends Contract {
-  private orderSeq = new FabricContractDBSequence({
-    name: 'orderSeq',
-    type: 'Number',
-    startWith: 1,
-    incrementBy: 1,
-  }, adapter);
+  private orderSeq = new FabricContractDBSequence(
+    {
+      name: "orderSeq",
+      type: "Number",
+      startWith: 1,
+      incrementBy: 1,
+    },
+    adapter
+  );
 
   @Transaction()
   async CreateOrder(ctx: Context): Promise<number> {
@@ -510,11 +533,11 @@ export class OrderContract extends Contract {
 Description: Bridge to run Mango queries through the Fabric adapter and get typed models back; used internally by repositories and also directly in advanced cases. See tests/unit/erc20conttract.test.ts mocking CouchDBStatement processing.
 
 ```typescript
-import { FabricStatement } from '@decaf-ts/for-fabric/contracts';
-import { FabricContractAdapter } from '@decaf-ts/for-fabric/contracts';
-import { FabricContractContext } from '@decaf-ts/for-fabric/contracts';
-import { MangoQuery } from '@decaf-ts/for-couchdb';
-import { Model } from '@decaf-ts/decorator-validation';
+import { FabricStatement } from "@decaf-ts/for-fabric/contracts";
+import { FabricContractAdapter } from "@decaf-ts/for-fabric/contracts";
+import { FabricContractContext } from "@decaf-ts/for-fabric/contracts";
+import { MangoQuery } from "@decaf-ts/for-couchdb";
+import { Model } from "@decaf-ts/decorator-validation";
 
 class MyModel extends Model {}
 
@@ -522,7 +545,9 @@ const adapter = new FabricContractAdapter();
 
 async function query(ctx: FabricContractContext) {
   const stmt = new FabricStatement<MyModel, MyModel[]>(adapter, ctx);
-  const models = await stmt.raw<MyModel[]>({ selector: { type: 'MyModel' } } as MangoQuery);
+  const models = await stmt.raw<MyModel[]>({
+    selector: { type: "MyModel" },
+  } as MangoQuery);
   return models;
 }
 ```
@@ -532,17 +557,21 @@ async function query(ctx: FabricContractContext) {
 Description: Context-aware logger bound to Fabric’s Context, honoring log levels.
 
 ```typescript
-import { Context, Transaction } from 'fabric-contract-api';
-import { Contract } from 'fabric-contract-api';
-import { ContractLogger } from '@decaf-ts/for-fabric/contracts';
+import { Context, Transaction } from "fabric-contract-api";
+import { Contract } from "fabric-contract-api";
+import { ContractLogger } from "@decaf-ts/for-fabric/contracts";
 
 export class LoggableContract extends Contract {
   @Transaction()
   async DoWork(ctx: Context): Promise<void> {
-    const log = new ContractLogger('LoggableContract', { level: 'info' }, ctx as any);
-    log.info('Starting work');
+    const log = new ContractLogger(
+      "LoggableContract",
+      { level: "info" },
+      ctx as any
+    );
+    log.info("Starting work");
     // ... work ...
-    log.debug('Finished');
+    log.debug("Finished");
   }
 }
 ```
@@ -552,15 +581,21 @@ export class LoggableContract extends Contract {
 Description: Emits Fabric events for repository operations. You can also use it directly to emit a custom event.
 
 ```typescript
-import { FabricContractRepositoryObservableHandler } from '@decaf-ts/for-fabric/contracts';
-import { OperationKeys } from '@decaf-ts/db-decorators';
-import { FabricContractContext } from '@decaf-ts/for-fabric/contracts';
-import { MiniLogger } from '@decaf-ts/logging';
+import { FabricContractRepositoryObservableHandler } from "@decaf-ts/for-fabric/contracts";
+import { OperationKeys } from "@decaf-ts/db-decorators";
+import { FabricContractContext } from "@decaf-ts/for-fabric/contracts";
+import { MiniLogger } from "@decaf-ts/logging";
 
 async function emitExample(ctx: FabricContractContext) {
   const handler = new FabricContractRepositoryObservableHandler();
-  const log = new MiniLogger('obs');
-  await handler.updateObservers(log as any, 'assets', OperationKeys.CREATE, 'asset1', ctx);
+  const log = new MiniLogger("obs");
+  await handler.updateObservers(
+    log as any,
+    "assets",
+    OperationKeys.CREATE,
+    "asset1",
+    ctx
+  );
 }
 ```
 
@@ -569,7 +604,7 @@ async function emitExample(ctx: FabricContractContext) {
 Description: Access Fabric-specific context inside contracts.
 
 ```typescript
-import { FabricContractContext } from '@decaf-ts/for-fabric/contracts';
+import { FabricContractContext } from "@decaf-ts/for-fabric/contracts";
 
 function readContext(ctx: FabricContractContext) {
   const ts = ctx.timestamp; // Date from stub.getDateTimestamp()
@@ -583,19 +618,19 @@ function readContext(ctx: FabricContractContext) {
 Description: Full ERC20 implementation used in tests (see tests/unit/erc20conttract.test.ts).
 
 ```typescript
-import { FabricERC20Contract } from '@decaf-ts/for-fabric/contracts';
-import { FabricContractContext } from '@decaf-ts/for-fabric/contracts';
+import { FabricERC20Contract } from "@decaf-ts/for-fabric/contracts";
+import { FabricContractContext } from "@decaf-ts/for-fabric/contracts";
 
-const contract = new FabricERC20Contract('TestToken');
+const contract = new FabricERC20Contract("TestToken");
 
 async function initAndRead(ctx: FabricContractContext) {
-  const created = await contract.Initialize(ctx, 'TestToken', 'TT', 18);
+  const created = await contract.Initialize(ctx, "TestToken", "TT", 18);
   if (created) {
     const name = await contract.TokenName(ctx);
     const decimals = await contract.Decimals(ctx);
     return { name, decimals };
   }
-  throw new Error('Init failed');
+  throw new Error("Init failed");
 }
 ```
 
@@ -607,7 +642,6 @@ async function initAndRead(ctx: FabricContractContext) {
 
 These patterns are mirrored in the examples above to ensure correctness and consistency with the repository’s test suite.
 
-
 ## Coding Principles
 
 - group similar functionality in folders (analog to namespaces but without any namespace declaration)
@@ -626,8 +660,8 @@ These patterns are mirrored in the examples above to ensure correctness and cons
   - etc;
 
 ## Release Documentation Hooks
-Stay aligned with the automated release pipeline by reviewing [Release Notes](./workdocs/reports/RELEASE_NOTES.md) and [Dependencies](./workdocs/reports/DEPENDENCIES.md) after trying these recipes (updated on 2025-11-26).
 
+Stay aligned with the automated release pipeline by reviewing [Release Notes](./workdocs/reports/RELEASE_NOTES.md) and [Dependencies](./workdocs/reports/DEPENDENCIES.md) after trying these recipes (updated on 2025-11-26).
 
 ### Related
 
@@ -637,9 +671,6 @@ Stay aligned with the automated release pipeline by reviewing [Release Notes](./
 
 [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/decaf-ts/)
 
-
-
-
 #### Languages
 
 ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)