@decaf-ts/for-fabric 0.0.2

package/lib/client/FabricClientDispatch.d.ts

@@ -0,0 +1,125 @@
+import { Dispatch } from "@decaf-ts/core";
+import { Client } from "@grpc/grpc-js";
+import { FabricClientAdapter } from "./FabricClientAdapter";
+/**
+ * @description Event dispatcher for Hyperledger Fabric chaincode events
+ * @summary Listens for and processes events emitted by Fabric chaincode, dispatching them to registered observers
+ * @template PeerConfig - Configuration type for connecting to a Fabric peer
+ * @param client - gRPC client for connecting to the Fabric network
+ * @class FabricClientDispatch
+ * @example
+ * ```typescript
+ * // Create a new FabricDispatch instance
+ * const client = await FabricAdapter.getClient(peerConfig);
+ * const dispatch = new FabricDispatch(client);
+ *
+ * // Configure the dispatch with peer configuration
+ * dispatch.configure(peerConfig);
+ *
+ * // Register an observer for a specific table and event
+ * dispatch.observe('users', 'create', (id) => {
+ *   console.log(`User created: ${id}`);
+ * });
+ *
+ * // Start listening for events
+ * await dispatch.start();
+ * ```
+ * @mermaid
+ * sequenceDiagram
+ *   participant Client
+ *   participant FabricDispatch
+ *   participant Gateway
+ *   participant Network
+ *   participant Chaincode
+ *
+ *   Client->>FabricDispatch: new FabricDispatch(client)
+ *   Client->>FabricDispatch: configure(peerConfig)
+ *   Client->>FabricDispatch: observe(table, event, callback)
+ *   Client->>FabricDispatch: start()
+ *   FabricDispatch->>FabricDispatch: initialize()
+ *   FabricDispatch->>Gateway: getGateway(config, client)
+ *   Gateway->>Network: getNetwork(channel)
+ *   Network->>Network: getChaincodeEvents(chaincodeName)
+ *   FabricDispatch->>FabricDispatch: handleEvents()
+ *   loop For each event
+ *     Chaincode-->>FabricDispatch: ChaincodeEvent
+ *     FabricDispatch->>FabricDispatch: parseEventName(eventName)
+ *     FabricDispatch->>FabricDispatch: parsePayload(payload)
+ *     FabricDispatch->>FabricDispatch: updateObservers(table, event, id)
+ *     FabricDispatch-->>Client: callback(id)
+ *   end
+ */
+export declare class FabricClientDispatch extends Dispatch {
+    protected client: Client;
+    /**
+     * @description Event listening stack for chaincode events
+     */
+    private listeningStack?;
+    /**
+     * @description Text decoder for converting event payloads from bytes to strings
+     */
+    private decoder;
+    /**
+     * @description Creates a new FabricDispatch instance
+     * @summary Initializes a dispatcher for Fabric chaincode events
+     * @param {Client} client - gRPC client for connecting to the Fabric network
+     */
+    constructor(client: Client);
+    /**
+     * @description Closes the event listening connection
+     * @summary Stops listening for chaincode events and releases resources
+     * @return {Promise<void>} Promise that resolves when the connection is closed
+     */
+    close(): Promise<void>;
+    /**
+     * @description Parses event payload from binary format
+     * @summary Converts a Uint8Array containing JSON to an object with an id property
+     * @param {Uint8Array} jsonBytes - The binary payload from the chaincode event
+     * @return {{ id: string }} The parsed payload containing the record ID
+     */
+    private parsePayload;
+    /**
+     * @description Starts observing an adapter
+     * @summary Connects this dispatch to an adapter to monitor its operations
+     * @param {Adapter<any, any, any, any>} observer - The adapter to observe
+     * @return {void}
+     */
+    observe(observer: FabricClientAdapter): void;
+    /**
+     * @description Updates observers about a database event
+     * @summary Notifies observers about a change in the database
+     * @param {string} table - The name of the table where the change occurred
+     * @param {OperationKeys|BulkCrudOperationKeys|string} event - The type of operation that occurred
+     * @param {any} payload - The event payload
+     * @return {Promise<void>} A promise that resolves when all observers have been notified
+     */
+    updateObservers(table: string, event: string, payload: any): Promise<void>;
+    /**
+     * @description Processes incoming chaincode events
+     * @summary Listens for events from the chaincode and dispatches them to registered observers
+     * @return {Promise<void>} Promise that resolves when event handling stops
+     * @mermaid
+     * sequenceDiagram
+     *   participant FabricDispatch
+     *   participant EventStack
+     *   participant EventParser
+     *   participant Observers
+     *
+     *   FabricDispatch->>FabricDispatch: handleEvents()
+     *   FabricDispatch->>EventStack: for await (const evt of listeningStack)
+     *   EventStack-->>FabricDispatch: ChaincodeEvent
+     *   FabricDispatch->>EventParser: parseEventName(evt.eventName)
+     *   EventParser-->>FabricDispatch: { table, event, owner }
+     *   FabricDispatch->>FabricDispatch: Check if event is for this MSP
+     *   FabricDispatch->>FabricDispatch: parsePayload(evt.payload)
+     *   FabricDispatch->>Observers: updateObservers(table, event, payload.id)
+     *   Observers-->>FabricDispatch: Callbacks executed
+     */
+    protected handleEvents(): Promise<void>;
+    /**
+     * @description Initializes the event listener
+     * @summary Sets up the connection to the Fabric network and starts listening for chaincode events
+     * @return {Promise<void>} Promise that resolves when initialization is complete
+     */
+    protected initialize(): Promise<void>;
+}

package/lib/client/FabricClientRepository.cjs

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FabricClientRepository = void 0;
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+/**
+ * @description Repository implementation for Fabric client operations
+ * @summary Extends the generic Repository to prepare context and arguments for CRUD operations executed via a Fabric client Adapter, wiring RepositoryFlags and Fabric-specific overrides.
+ * @template M extends Model - The model type handled by this repository
+ * @param {Adapter<any, MangoQuery, FabricFlags, Context<FabricFlags>>} [adapter] - Optional adapter instance used to execute operations
+ * @param {Constructor<M>} [clazz] - Optional model constructor used by the repository
+ * @return {void}
+ * @class FabricClientRepository
+ * @example
+ * import { Repository } from "@decaf-ts/core";
+ * import { FabricClientRepository } from "@decaf-ts/for-fabric";
+ *
+ * class User extends Model { id!: string; name!: string; }
+ * const repo = new FabricClientRepository<User>();
+ * const created = await repo.create(new User({ id: "1", name: "Alice" }));
+ * const loaded = await repo.read("1");
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Repo as FabricClientRepository
+ *   participant Adapter
+ *   App->>Repo: create(model)
+ *   Repo->>Repo: createPrefix(model, ...args)
+ *   Repo->>Adapter: create(table, id, model, flags)
+ *   Adapter-->>Repo: result
+ *   Repo-->>App: model
+ */
+class FabricClientRepository extends core_1.Repository {
+    constructor(adapter, clazz) {
+        super(adapter, clazz);
+    }
+    /**
+     * @description Prepare arguments and context for create
+     * @summary Builds repository context and ensures the model is instantiated with the repository's class before delegating to the adapter
+     * @param {M} model - The model instance to create
+     * @param {...any[]} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the prepared model and the processed arguments
+     */
+    async createPrefix(model, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.CREATE, this.class, args, this.adapter, this._overrides || {});
+        model = new this.class(model);
+        return [model, ...contextArgs.args];
+    }
+    /**
+     * @description Prepare arguments and context for bulk create
+     * @summary Resolves repository context for a createAll operation passing through models and processed arguments
+     * @param {M[]} models - Array of model instances to create
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the models array and processed arguments
+     */
+    async createAllPrefix(models, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.CREATE, this.class, args, this.adapter, this._overrides || {});
+        return [models, ...contextArgs.args];
+    }
+    /**
+     * @description Prepare arguments and context for read
+     * @summary Resolves repository context for a read operation and forwards the key and processed arguments
+     * @param {string} key - The model primary key to read
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the key and processed arguments
+     */
+    async readPrefix(key, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.READ, this.class, args, this.adapter, this._overrides || {});
+        return [key, ...contextArgs.args];
+    }
+    /**
+     * @description Prepare arguments and context for bulk read
+     * @summary Resolves repository context for a readAll operation and forwards the keys and processed arguments
+     * @param {(string[]|number[])} keys - Array of model primary keys to read
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the keys and processed arguments
+     */
+    async readAllPrefix(keys, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.READ, this.class, args, this.adapter, this._overrides || {});
+        return [keys, ...contextArgs.args];
+    }
+    /**
+     * @description Prepare arguments and context for update
+     * @summary Resolves repository context for an update operation and forwards the model and processed arguments
+     * @param {M} model - The model instance to update
+     * @param {...any[]} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the model and processed arguments
+     */
+    async updatePrefix(model, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.UPDATE, this.class, args, this.adapter, this._overrides || {});
+        return [model, ...contextArgs.args];
+    }
+    /**
+     * @description Prepare arguments and context for bulk update
+     * @summary Resolves repository context for an updateAll operation and forwards the models and processed arguments
+     * @param {M[]} models - The model instances to update
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the models and processed arguments
+     */
+    async updateAllPrefix(models, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.UPDATE, this.class, args, this.adapter, this._overrides || {});
+        return [models, ...contextArgs.args];
+    }
+    /**
+     * @description Prepare arguments and context for delete
+     * @summary Resolves repository context for a delete operation, ensures the target exists via read, then forwards key and processed arguments
+     * @param {string|number} key - The model primary key to delete
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the key and processed arguments
+     */
+    async deletePrefix(key, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.DELETE, this.class, args, this.adapter, this._overrides || {});
+        await this.read(key, ...contextArgs.args);
+        return [key, ...contextArgs.args];
+    }
+    /**
+     * @description Prepare arguments and context for bulk delete
+     * @summary Resolves repository context for a deleteAll operation, validates existence via readAll, then forwards keys and processed arguments
+     * @param {(string[]|number[])} keys - The model primary keys to delete
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the keys and processed arguments
+     */
+    async deleteAllPrefix(keys, ...args) {
+        const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.DELETE, this.class, args, this.adapter, this._overrides || {});
+        await this.readAll(keys, ...contextArgs.args);
+        return [keys, ...contextArgs.args];
+    }
+}
+exports.FabricClientRepository = FabricClientRepository;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRmFicmljQ2xpZW50UmVwb3NpdG9yeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jbGllbnQvRmFicmljQ2xpZW50UmVwb3NpdG9yeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSx5Q0FBcUQ7QUFHckQsMkRBSWlDO0FBR2pDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0EyQkc7QUFDSCxNQUFhLHNCQUF3QyxTQUFRLGlCQUk1RDtJQUNDLFlBQ0UsT0FBMEUsRUFDMUUsS0FBc0I7UUFFdEIsS0FBSyxDQUFDLE9BQU8sRUFBRSxLQUFLLENBQUMsQ0FBQztJQUN4QixDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ2dCLEtBQUssQ0FBQyxZQUFZLENBQ25DLEtBQVEsRUFDUixHQUFHLElBQVc7UUFFZCxNQUFNLFdBQVcsR0FBRyxNQUFNLHVCQUFPLENBQUMsSUFBSSxDQUtwQyw2QkFBYSxDQUFDLE1BQU0sRUFDcEIsSUFBSSxDQUFDLEtBQUssRUFDVixJQUFJLEVBQ0osSUFBSSxDQUFDLE9BQU8sRUFDWixJQUFJLENBQUMsVUFBVSxJQUFJLEVBQUUsQ0FDdEIsQ0FBQztRQUNGLEtBQUssR0FBRyxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDOUIsT0FBTyxDQUFDLEtBQUssRUFBRSxHQUFHLFdBQVcsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ2dCLEtBQUssQ0FBQyxlQUFlLENBQUMsTUFBVyxFQUFFLEdBQUcsSUFBVztRQUNsRSxNQUFNLFdBQVcsR0FBRyxNQUFNLHVCQUFPLENBQUMsSUFBSSxDQUNwQyw2QkFBYSxDQUFDLE1BQU0sRUFDcEIsSUFBSSxDQUFDLEtBQUssRUFDVixJQUFJLEVBQ0osSUFBSSxDQUFDLE9BQU8sRUFDWixJQUFJLENBQUMsVUFBVSxJQUFJLEVBQUUsQ0FDdEIsQ0FBQztRQUNGLE9BQU8sQ0FBQyxNQUFNLEVBQUUs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QUMsSUFBSSxDQUFDLENBQUM7UUFDOUMsT0FBTyxDQUFDLElBQUksRUFBRSxHQUFHLFdBQVcsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNyQyxDQUFDO0NBQ0Y7QUFqTEQsd0RBaUxDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQWRhcHRlciwgUmVwb3NpdG9yeSB9IGZyb20gXCJAZGVjYWYtdHMvY29yZVwiO1xuaW1wb3J0IHsgQ29uc3RydWN0b3IsIE1vZGVsIH0gZnJvbSBcIkBkZWNhZi10cy9kZWNvcmF0b3ItdmFsaWRhdGlvblwiO1xuaW1wb3J0IHsgTWFuZ29RdWVyeSB9IGZyb20gXCJAZGVjYWYtdHMvZm9yLWNvdWNoZGJcIjtcbmltcG9ydCB7XG4gIENvbnRleHQsXG4gIE9wZXJhdGlvbktleXMsXG4gIFJlcG9zaXRvcnlGbGFncyxcbn0gZnJvbSBcIkBkZWNhZi10cy9kYi1kZWNvcmF0b3JzXCI7XG5pbXBvcnQgeyBGYWJyaWNGbGFncyB9IGZyb20gXCIuLi9zaGFyZWRcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gUmVwb3NpdG9yeSBpbXBsZW1lbnRhdGlvbiBmb3IgRmFicmljIGNsaWVudCBvcGVyYXRpb25zXG4gKiBAc3VtbWFyeSBFeHRlbmRzIHRoZSBnZW5lcmljIFJlcG9zaXRvcnkgdG8gcHJlcGFyZSBjb250ZXh0IGFuZCBhcmd1bWVudHMgZm9yIENSVUQgb3BlcmF0aW9ucyBleGVjdXRlZCB2aWEgYSBGYWJyaWMgY2xpZW50IEFkYXB0ZXIsIHdpcmluZyBSZXBvc2l0b3J5RmxhZ3MgYW5kIEZhYnJpYy1zcGVjaWZpYyBvdmVycmlkZXMuXG4gKiBAdGVtcGxhdGUgTSBleHRlbmRzIE1vZGVsIC0gVGhlIG1vZGVsIHR5cGUgaGFuZGxlZCBieSB0aGlzIHJlcG9zaXRvcnlcbiAqIEBwYXJhbSB7QWRhcHRlcjxhbnksIE1hbmdvUXVlcnksIEZhYnJpY0ZsYWdzLCBDb250ZXh0PEZhYnJpY0ZsYWdzPj59IFthZGFwdGVyXSAtIE9wdGlvbmFsIGFkYXB0ZXIgaW5zdGFuY2UgdXNlZCB0byBleGVjdXRlIG9wZXJhdGlvbnNcbiAqIEBwYXJhbSB7Q29uc3RydWN0b3I8TT59IFtjbGF6el0gLSBPcHRpb25hbCBtb2RlbCBjb25zdHJ1Y3RvciB1c2VkIGJ5IHRoZSByZXBvc2l0b3J5XG4gKiBAcmV0dXJuIHt2b2lkfVxuICogQGNsYXNzIEZhYnJpY0NsaWVudFJlcG9zaXRvcnlcbiAqIEBleGFtcGxlXG4gKiBpbXBvcnQgeyBSZXBvc2l0b3J5IH0gZnJvbSBcIkBkZWNhZi10cy9jb3JlXCI7XG4gKiBpbXBvcnQgeyBGYWJyaWNDbGllbnRSZXBvc2l0b3J5IH0gZnJvbSBcIkBkZWNhZi10cy9mb3ItZmFicmljXCI7XG4gKlxuICogY2xhc3MgVXNlciBleHRlbmRzIE1vZGVsIHsgaWQhOiBzdHJpbmc7IG5hbWUhOiBzdHJpbmc7IH1cbiAqIGNvbnN0IHJlcG8gPSBuZXcgRmFicmljQ2xpZW50UmVwb3NpdG9yeTxVc2VyPigpO1xuICogY29uc3QgY3JlYXRlZCA9IGF3YWl0IHJlcG8uY3JlYXRlKG5ldyBVc2VyKHsgaWQ6IFwiMVwiLCBuYW1lOiBcIkFsaWNlXCIgfSkpO1xuICogY29uc3QgbG9hZGVkID0gYXdhaXQgcmVwby5yZWFkKFwiMVwiKTtcbiAqXG4gKiBAbWVybWFpZFxuICogc2VxdWVuY2VEaWFncmFtXG4gKiAgIHBhcnRpY2lwYW50IEFwcFxuICogICBwYXJ0aWNpcGFudCBSZXBvIGFzIEZhYnJpY0NsaWVudFJlcG9zaXRvcnlcbiAqICAgcGFydGljaXBhbnQgQWRhcHRlclxuICogICBBcHAtPj5SZXBvOiBjcmVhdGUobW9kZWwpXG4gKiAgIFJlcG8tPj5SZXBvOiBjcmVhdGVQcmVmaXgobW9kZWwsIC4uLmFyZ3MpXG4gKiAgIFJlcG8tPj5BZGFwdGVyOiBjcmVhdGUodGFibGUsIGlkLCBtb2RlbCwgZmxhZ3MpXG4gKiAgIEFkYXB0ZXItLT4+UmVwbzogcmVzdWx0XG4gKiAgIFJlcG8tLT4+QXBwOiBtb2RlbFxuICovXG5leHBvcnQgY2xhc3MgRmFicmljQ2xpZW50UmVwb3NpdG9yeTxNIGV4dGVuZHMgTW9kZWw+IGV4dGVuZHMgUmVwb3NpdG9yeTxcbiAgTSxcbiAgTWFuZ29RdWVyeSxcbiAgQWRhcHRlcjxhbnksIGFueSwgTWFuZ29RdWVyeSwgRmFicmljRmxhZ3MsIENvbnRleHQ8RmFicmljRmxhZ3M+PlxuPiB7XG4gIGNvbnN0cnVjdG9yKFxuICAgIGFkYXB0ZXI/OiBBZGFwdGVyPGFueSwgYW55LCBNYW5nb1F1ZXJ5LCBGYWJyaWNGbGFncywgQ29udGV4dDxGYWJyaWNGbGFncz4+LFxuICAgIGNsYXp6PzogQ29uc3RydWN0b3I8TT5cbiAgKSB7XG4gICAgc3VwZXIoYWRhcHRlciwgY2xhenopO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBQcmVwYXJlIGFyZ3VtZW50cyBhbmQgY29udGV4dCBmb3IgY3JlYXRlXG4gICAqIEBzdW1tYXJ5IEJ1aWxkcyByZXBvc2l0b3J5IGNvbnRleHQgYW5kIGVuc3VyZXMgdGhlIG1vZGVsIGlzIGluc3RhbnRpYXRlZCB3aXRoIHRoZSByZXBvc2l0b3J5J3MgY2xhc3MgYmVmb3JlIGRlbGVnYXRpbmcgdG8gdGhlIGFkYXB0ZXJcbiAgICogQHBhcmFtIHtNfSBtb2RlbCAtIFRoZSBtb2RlbCBpbnN0YW5jZSB0byBjcmVhdGVcbiAgICogQHBhcmFtIHsuLi5hbnlbXX0gYXJncyAtIEFkZGl0aW9uYWwgb3BlcmF0aW9uIGFyZ3VtZW50cyBhbmQgZmxhZ3NcbiAgICogQHJldHVybiB7Li4uYW55W119IFR1cGxlIGNvbnRhaW5pbmcgdGhlIHByZXBhcmVkIG1vZGVsIGFuZCB0aGUgcHJvY2Vzc2VkIGFyZ3VtZW50c1xuICAgKi9cbiAgcHJvdGVjdGVkIG92ZXJyaWRlIGFzeW5jIGNyZWF0ZVByZWZpeChcbiAgICBtb2RlbDogTSxcbiAgICAuLi5hcmdzOiBhbnlbXVxuICApOiBQcm9taXNlPFtNLCAuLi5hbnlbXV0+IHtcbiAgICBjb25zdCBjb250ZXh0QXJncyA9IGF3YWl0IENvbnRleHQuYXJnczxcbiAgICAgIE0sXG4gICAgICBDb250ZXh0PFJlcG9zaXRvcnlGbGFncz4sXG4gICAgICBSZXBvc2l0b3J5RmxhZ3NcbiAgICA+KFxuICAgICAgT3BlcmF0aW9uS2V5cy5DUkVBVEUsXG4gICAgICB0aGlzLmNsYXNzLFxuICAgICAgYXJncyxcbiAgICAgIHRoaXMuYWRhcHRlcixcbiAgICAgIHRoaXMuX292ZXJyaWRlcyB8fCB7fVxuICAgICk7XG4gICAgbW9kZWwgPSBuZXcgdGhpcy5jbGFzcyhtb2RlbCk7XG4gICAgcmV0dXJuIFttb2RlbCwgLi4uY29udGV4dEFyZ3MuYXJnc107XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFByZXBhcmUgYXJndW1lbnRzIGFuZCBjb250ZXh0IGZvciBidWxrIGNyZWF0ZVxuICAgKiBAc3VtbWFyeSBSZXNvbHZlcyByZXBvc2l0b3J5IGNvbnRleHQgZm9yIGEgY3JlYXRlQWxsIG9wZXJhdGlvbiBwYXNzaW5nIHRocm91Z2ggbW9kZWxzIGFuZCBwcm9jZXNzZWQgYXJndW1lbnRzXG4gICAqIEBwYXJhbSB7TVtdfSBtb2RlbHMgLSBBcnJheSBvZiBtb2RlbCBpbnN0YW5jZXMgdG8gY3JlYXRlXG4gICAqIEBwYXJhbSB7Li4uYW55fSBhcmdzIC0gQWRkaXRpb25hbCBvcGVyYXRpb24gYXJndW1lbnRzIGFuZCBmbGFnc1xuICAgKiBAcmV0dXJuIHsuLi5hbnlbXX0gVHVwbGUgY29udGFpbmluZyB0aGUgbW9kZWxzIGFycmF5IGFuZCBwcm9jZXNzZWQgYXJndW1lbnRzXG4gICAqL1xuICBwcm90ZWN0ZWQgb3ZlcnJpZGUgYXN5bmMgY3JlYXRlQWxsUHJlZml4KG1vZGVsczogTVtdLCAuLi5hcmdzOiBhbnlbXSkge1xuICAgIGNvbnN0IGNvbnRleHRBcmdzID0gYXdhaXQgQ29udGV4dC5hcmdzKFxuICAgICAgT3BlcmF0aW9uS2V5cy5DUkVBVEUsXG4gICAgICB0aGlzLmNsYXNzLFxuICAgICAgYXJncyxcbiAgICAgIHRoaXMuYWRhcHRlcixcbiAgICAgIHRoaXMuX292ZXJyaWRlcyB8fCB7fVxuICAgICk7XG4gICAgcmV0dXJuIFttb2RlbHMsIC4uLmNvbnRleHRBcmdzLmFyZ3NdO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBQcmVwYXJlIGFyZ3VtZW50cyBhbmQgY29udGV4dCBmb3IgcmVhZFxuICAgKiBAc3VtbWFyeSBSZXNvbHZlcyByZXBvc2l0b3J5IGNvbnRleHQgZm9yIGEgcmVhZCBvcGVyYXRpb24gYW5kIGZvcndhcmRzIHRoZSBrZXkgYW5kIHByb2Nlc3NlZCBhcmd1bWVudHNcbiAgICogQHBhcmFtIHtzdHJpbmd9IGtleSAtIFRoZSBtb2RlbCBwcmltYXJ5IGtleSB0byByZWFkXG4gICAqIEBwYXJhbSB7Li4uYW55fSBhcmdzIC0gQWRkaXRpb25hbCBvcGVyYXRpb24gYXJndW1lbnRzIGFuZCBmbGFnc1xuICAgKiBAcmV0dXJuIHsuLi5hbnlbXX0gVHVwbGUgY29udGFpbmluZyB0aGUga2V5IGFuZCBwcm9jZXNzZWQgYXJndW1lbnRzXG4gICAqL1xuICBwcm90ZWN0ZWQgb3ZlcnJpZGUgYXN5bmMgcmVhZFByZWZpeChrZXk6IHN0cmluZywgLi4uYXJnczogYW55W10pIHtcbiAgICBjb25zdCBjb250ZXh0QXJncyA9IGF3YWl0IENvbnRleHQuYXJncyhcbiAgICAgIE9wZXJhdGlvbktleXMuUkVBRCxcbiAgICAgIHRoaXMuY2xhc3MsXG4gICAgICBhcmdzLFxuICAgICAgdGhpcy5hZGFwdGVyLFxuICAgICAgdGhpcy5fb3ZlcnJpZGVzIHx8IHt9XG4gICAgKTtcbiAgICByZXR1cm4gW2tleSwgLi4uY29udGV4dEFyZ3MuYXJnc107XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFByZXBhcmUgYXJndW1lbnRzIGFuZCBjb250ZXh0IGZvciBidWxrIHJlYWRcbiAgICogQHN1bW1hcnkgUmVzb2x2ZXMgcmVwb3NpdG9yeSBjb250ZXh0IGZvciBhIHJlYWRBbGwgb3BlcmF0aW9uIGFuZCBmb3J3YXJkcyB0aGUga2V5cyBhbmQgcHJvY2Vzc2VkIGFyZ3VtZW50c1xuICAgKiBAcGFyYW0geyhzdHJpbmdbXXxudW1iZXJbXSl9IGtleXMgLSBBcnJheSBvZiBtb2RlbCBwcmltYXJ5IGtleXMgdG8gcmVhZFxuICAgKiBAcGFyYW0gey4uLmFueX0gYXJncyAtIEFkZGl0aW9uYWwgb3BlcmF0aW9uIGFyZ3VtZW50cyBhbmQgZmxhZ3NcbiAgICogQHJldHVybiB7Li4uYW55W119IFR1cGxlIGNvbnRhaW5pbmcgdGhlIGtleXMgYW5kIHByb2Nlc3NlZCBhcmd1bWVudHNcbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBhc3luYyByZWFkQWxsUHJlZml4KFxuICAgIGtleXM6IHN0cmluZ1tdIHwgbnVtYmVyW10sXG4gICAgLi4uYXJnczogYW55W11cbiAgKSB7XG4gICAgY29uc3QgY29udGV4dEFyZ3MgPSBhd2FpdCBDb250ZXh0LmFyZ3MoXG4gICAgICBPcGVyYXRpb25LZXlzLlJFQUQsXG4gICAgICB0aGlzLmNsYXNzLFxuICAgICAgYXJncyxcbiAgICAgIHRoaXMuYWRhcHRlcixcbiAgICAgIHRoaXMuX292ZXJyaWRlcyB8fCB7fVxuICAgICk7XG4gICAgcmV0dXJuIFtrZXlzLCAuLi5jb250ZXh0QXJncy5hcmdzXTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gUHJlcGFyZSBhcmd1bWVudHMgYW5kIGNvbnRleHQgZm9yIHVwZGF0ZVxuICAgKiBAc3VtbWFyeSBSZXNvbHZlcyByZXBvc2l0b3J5IGNvbnRleHQgZm9yIGFuIHVwZGF0ZSBvcGVyYXRpb24gYW5kIGZvcndhcmRzIHRoZSBtb2RlbCBhbmQgcHJvY2Vzc2VkIGFyZ3VtZW50c1xuICAgKiBAcGFyYW0ge019IG1vZGVsIC0gVGhlIG1vZGVsIGluc3RhbmNlIHRvIHVwZGF0ZVxuICAgKiBAcGFyYW0gey4uLmFueVtdfSBhcmdzIC0gQWRkaXRpb25hbCBvcGVyYXRpb24gYXJndW1lbnRzIGFuZCBmbGFnc1xuICAgKiBAcmV0dXJuIHsuLi5hbnlbXX0gVHVwbGUgY29udGFpbmluZyB0aGUgbW9kZWwgYW5kIHByb2Nlc3NlZCBhcmd1bWVudHNcbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBhc3luYyB1cGRhdGVQcmVmaXgoXG4gICAgbW9kZWw6IE0sXG4gICAgLi4uYXJnczogYW55W11cbiAgKTogUHJvbWlzZTxbTSwgLi4uYXJnczogYW55W11dPiB7XG4gICAgY29uc3QgY29udGV4dEFyZ3MgPSBhd2FpdCBDb250ZXh0LmFyZ3MoXG4gICAgICBPcGVyYXRpb25LZXlzLlVQREFURSxcbiAgICAgIHRoaXMuY2xhc3MsXG4gICAgICBhcmdzLFxuICAgICAgdGhpcy5hZGFwdGVyLFxuICAgICAgdGhpcy5fb3ZlcnJpZGVzIHx8IHt9XG4gICAgKTtcbiAgICByZXR1cm4gW21vZGVsLCAuLi5jb250ZXh0QXJncy5hcmdzXTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gUHJlcGFyZSBhcmd1bWVudHMgYW5kIGNvbnRleHQgZm9yIGJ1bGsgdXBkYXRlXG4gICAqIEBzdW1tYXJ5IFJlc29sdmVzIHJlcG9zaXRvcnkgY29udGV4dCBmb3IgYW4gdXBkYXRlQWxsIG9wZXJhdGlvbiBhbmQgZm9yd2FyZHMgdGhlIG1vZGVscyBhbmQgcHJvY2Vzc2VkIGFyZ3VtZW50c1xuICAgKiBAcGFyYW0ge01bXX0gbW9kZWxzIC0gVGhlIG1vZGVsIGluc3RhbmNlcyB0byB1cGRhdGVcbiAgICogQHBhcmFtIHsuLi5hbnl9IGFyZ3MgLSBBZGRpdGlvbmFsIG9wZXJhdGlvbiBhcmd1bWVudHMgYW5kIGZsYWdzXG4gICAqIEByZXR1cm4gey4uLmFueVtdfSBUdXBsZSBjb250YWluaW5nIHRoZSBtb2RlbHMgYW5kIHByb2Nlc3NlZCBhcmd1bWVudHNcbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBhc3luYyB1cGRhdGVBbGxQcmVmaXgoXG4gICAgbW9kZWxzOiBNW10sXG4gICAgLi4uYXJnczogYW55W11cbiAgKTogUHJvbWlzZTxhbnlbXT4ge1xuICAgIGNvbnN0IGNvbnRleHRBcmdzID0gYXdhaXQgQ29udGV4dC5hcmdzKFxuICAgICAgT3BlcmF0aW9uS2V5cy5VUERBVEUsXG4gICAgICB0aGlzLmNsYXNzLFxuICAgICAgYXJncyxcbiAgICAgIHRoaXMuYWRhcHRlcixcbiAgICAgIHRoaXMuX292ZXJyaWRlcyB8fCB7fVxuICAgICk7XG4gICAgcmV0dXJuIFttb2RlbHMsIC4uLmNvbnRleHRBcmdzLmFyZ3NdO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBQcmVwYXJlIGFyZ3VtZW50cyBhbmQgY29udGV4dCBmb3IgZGVsZXRlXG4gICAqIEBzdW1tYXJ5IFJlc29sdmVzIHJlcG9zaXRvcnkgY29udGV4dCBmb3IgYSBkZWxldGUgb3BlcmF0aW9uLCBlbnN1cmVzIHRoZSB0YXJnZXQgZXhpc3RzIHZpYSByZWFkLCB0aGVuIGZvcndhcmRzIGtleSBhbmQgcHJvY2Vzc2VkIGFyZ3VtZW50c1xuICAgKiBAcGFyYW0ge3N0cmluZ3xudW1iZXJ9IGtleSAtIFRoZSBtb2RlbCBwcmltYXJ5IGtleSB0byBkZWxldGVcbiAgICogQHBhcmFtIHsuLi5hbnl9IGFyZ3MgLSBBZGRpdGlvbmFsIG9wZXJhdGlvbiBhcmd1bWVudHMgYW5kIGZsYWdzXG4gICAqIEByZXR1cm4gey4uLmFueVtdfSBUdXBsZSBjb250YWluaW5nIHRoZSBrZXkgYW5kIHByb2Nlc3NlZCBhcmd1bWVudHNcbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBhc3luYyBkZWxldGVQcmVmaXgoa2V5OiBhbnksIC4uLmFyZ3M6IGFueVtdKSB7XG4gICAgY29uc3QgY29udGV4dEFyZ3MgPSBhd2FpdCBDb250ZXh0LmFyZ3MoXG4gICAgICBPcGVyYXRpb25LZXlzLkRFTEVURSxcbiAgICAgIHRoaXMuY2xhc3MsXG4gICAgICBhcmdzLFxuICAgICAgdGhpcy5hZGFwdGVyLFxuICAgICAgdGhpcy5fb3ZlcnJpZGVzIHx8IHt9XG4gICAgKTtcbiAgICBhd2FpdCB0aGlzLnJlYWQoa2V5LCAuLi5jb250ZXh0QXJncy5hcmdzKTtcbiAgICByZXR1cm4gW2tleSwgLi4uY29udGV4dEFyZ3MuYXJnc107XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFByZXBhcmUgYXJndW1lbnRzIGFuZCBjb250ZXh0IGZvciBidWxrIGRlbGV0ZVxuICAgKiBAc3VtbWFyeSBSZXNvbHZlcyByZXBvc2l0b3J5IGNvbnRleHQgZm9yIGEgZGVsZXRlQWxsIG9wZXJhdGlvbiwgdmFsaWRhdGVzIGV4aXN0ZW5jZSB2aWEgcmVhZEFsbCwgdGhlbiBmb3J3YXJkcyBrZXlzIGFuZCBwcm9jZXNzZWQgYXJndW1lbnRzXG4gICAqIEBwYXJhbSB7KHN0cmluZ1tdfG51bWJlcltdKX0ga2V5cyAtIFRoZSBtb2RlbCBwcmltYXJ5IGtleXMgdG8gZGVsZXRlXG4gICAqIEBwYXJhbSB7Li4uYW55fSBhcmdzIC0gQWRkaXRpb25hbCBvcGVyYXRpb24gYXJndW1lbnRzIGFuZCBmbGFnc1xuICAgKiBAcmV0dXJuIHsuLi5hbnlbXX0gVHVwbGUgY29udGFpbmluZyB0aGUga2V5cyBhbmQgcHJvY2Vzc2VkIGFyZ3VtZW50c1xuICAgKi9cbiAgcHJvdGVjdGVkIG92ZXJyaWRlIGFzeW5jIGRlbGV0ZUFsbFByZWZpeChcbiAgICBrZXlzOiBzdHJpbmdbXSB8IG51bWJlcltdLFxuICAgIC4uLmFyZ3M6IGFueVtdXG4gICkge1xuICAgIGNvbnN0IGNvbnRleHRBcmdzID0gYXdhaXQgQ29udGV4dC5hcmdzKFxuICAgICAgT3BlcmF0aW9uS2V5cy5ERUxFVEUsXG4gICAgICB0aGlzLmNsYXNzLFxuICAgICAgYXJncyxcbiAgICAgIHRoaXMuYWRhcHRlcixcbiAgICAgIHRoaXMuX292ZXJyaWRlcyB8fCB7fVxuICAgICk7XG4gICAgYXdhaXQgdGhpcy5yZWFkQWxsKGtleXMsIC4uLmNvbnRleHRBcmdzLmFyZ3MpO1xuICAgIHJldHVybiBba2V5cywgLi4uY29udGV4dEFyZ3MuYXJnc107XG4gIH1cbn1cbiJdfQ==

package/lib/client/FabricClientRepository.d.ts

@@ -0,0 +1,100 @@
+import { Adapter, Repository } from "@decaf-ts/core";
+import { Constructor, Model } from "@decaf-ts/decorator-validation";
+import { MangoQuery } from "@decaf-ts/for-couchdb";
+import { Context } from "@decaf-ts/db-decorators";
+import { FabricFlags } from "../shared";
+/**
+ * @description Repository implementation for Fabric client operations
+ * @summary Extends the generic Repository to prepare context and arguments for CRUD operations executed via a Fabric client Adapter, wiring RepositoryFlags and Fabric-specific overrides.
+ * @template M extends Model - The model type handled by this repository
+ * @param {Adapter<any, MangoQuery, FabricFlags, Context<FabricFlags>>} [adapter] - Optional adapter instance used to execute operations
+ * @param {Constructor<M>} [clazz] - Optional model constructor used by the repository
+ * @return {void}
+ * @class FabricClientRepository
+ * @example
+ * import { Repository } from "@decaf-ts/core";
+ * import { FabricClientRepository } from "@decaf-ts/for-fabric";
+ *
+ * class User extends Model { id!: string; name!: string; }
+ * const repo = new FabricClientRepository<User>();
+ * const created = await repo.create(new User({ id: "1", name: "Alice" }));
+ * const loaded = await repo.read("1");
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Repo as FabricClientRepository
+ *   participant Adapter
+ *   App->>Repo: create(model)
+ *   Repo->>Repo: createPrefix(model, ...args)
+ *   Repo->>Adapter: create(table, id, model, flags)
+ *   Adapter-->>Repo: result
+ *   Repo-->>App: model
+ */
+export declare class FabricClientRepository<M extends Model> extends Repository<M, MangoQuery, Adapter<any, any, MangoQuery, FabricFlags, Context<FabricFlags>>> {
+    constructor(adapter?: Adapter<any, any, MangoQuery, FabricFlags, Context<FabricFlags>>, clazz?: Constructor<M>);
+    /**
+     * @description Prepare arguments and context for create
+     * @summary Builds repository context and ensures the model is instantiated with the repository's class before delegating to the adapter
+     * @param {M} model - The model instance to create
+     * @param {...any[]} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the prepared model and the processed arguments
+     */
+    protected createPrefix(model: M, ...args: any[]): Promise<[M, ...any[]]>;
+    /**
+     * @description Prepare arguments and context for bulk create
+     * @summary Resolves repository context for a createAll operation passing through models and processed arguments
+     * @param {M[]} models - Array of model instances to create
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the models array and processed arguments
+     */
+    protected createAllPrefix(models: M[], ...args: any[]): Promise<any[]>;
+    /**
+     * @description Prepare arguments and context for read
+     * @summary Resolves repository context for a read operation and forwards the key and processed arguments
+     * @param {string} key - The model primary key to read
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the key and processed arguments
+     */
+    protected readPrefix(key: string, ...args: any[]): Promise<any[]>;
+    /**
+     * @description Prepare arguments and context for bulk read
+     * @summary Resolves repository context for a readAll operation and forwards the keys and processed arguments
+     * @param {(string[]|number[])} keys - Array of model primary keys to read
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the keys and processed arguments
+     */
+    protected readAllPrefix(keys: string[] | number[], ...args: any[]): Promise<any[]>;
+    /**
+     * @description Prepare arguments and context for update
+     * @summary Resolves repository context for an update operation and forwards the model and processed arguments
+     * @param {M} model - The model instance to update
+     * @param {...any[]} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the model and processed arguments
+     */
+    protected updatePrefix(model: M, ...args: any[]): Promise<[M, ...args: any[]]>;
+    /**
+     * @description Prepare arguments and context for bulk update
+     * @summary Resolves repository context for an updateAll operation and forwards the models and processed arguments
+     * @param {M[]} models - The model instances to update
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the models and processed arguments
+     */
+    protected updateAllPrefix(models: M[], ...args: any[]): Promise<any[]>;
+    /**
+     * @description Prepare arguments and context for delete
+     * @summary Resolves repository context for a delete operation, ensures the target exists via read, then forwards key and processed arguments
+     * @param {string|number} key - The model primary key to delete
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the key and processed arguments
+     */
+    protected deletePrefix(key: any, ...args: any[]): Promise<any[]>;
+    /**
+     * @description Prepare arguments and context for bulk delete
+     * @summary Resolves repository context for a deleteAll operation, validates existence via readAll, then forwards keys and processed arguments
+     * @param {(string[]|number[])} keys - The model primary keys to delete
+     * @param {...any} args - Additional operation arguments and flags
+     * @return {...any[]} Tuple containing the keys and processed arguments
+     */
+    protected deleteAllPrefix(keys: string[] | number[], ...args: any[]): Promise<any[]>;
+}