@decaf-ts/for-fabric 0.0.2

package/lib/shared/math.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @description Overflow-safe addition operation
+ * @summary Adds two numbers and verifies no overflow by reverse-checking the operands
+ * @param {number} a - First operand
+ * @param {number} b - Second operand
+ * @return {number} The sum of a and b
+ * @function add
+ * @throws {OverflowError} on addition overflow
+ * @memberOf module:for-fabric.shared
+ */
+export declare function add(a: number, b: number): number;
+/**
+ * @description Overflow-safe subtraction operation
+ * @summary Subtracts b from a and validates no overflow by reverse-checking the operands
+ * @param {number} a - Minuend
+ * @param {number} b - Subtrahend
+ * @return {number} The difference a - b
+ * @function sub
+ * @throws {OverflowError} on subtaction overflow
+ * @memberOf module:for-fabric.shared
+ */
+export declare function sub(a: number, b: number): number;
+/**
+ * @summary Safe Integer Parse
+ *
+ * @param {string} string
+ *
+ * @function safeParseInt
+ *
+ * @throws {ValidationError} if parseInt returns NaN
+ *
+ * @memberOf module:for-fabric.shared
+ */
+export declare function safeParseInt(string: string): number;

package/lib/shared/model/Identity.cjs

@@ -0,0 +1,81 @@
+"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.Identity = void 0;
+const core_1 = require("@decaf-ts/core");
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const IdentityCredentials_1 = require("./IdentityCredentials.cjs");
+const constants_1 = require("./../constants.cjs");
+/**
+ * @description Identity model representing a Fabric wallet entry
+ * @summary Encapsulates an identity stored in a Fabric wallet, including its MSP identifier, credential linkage, and type information. Built on BaseModel for integration with Decaf validation and persistence.
+ * @param {ModelArg<Identity>} [arg] - Optional initialization object used to populate model fields
+ * @class Identity
+ * @example
+ * // Create a new identity referencing existing credentials
+ * const id = new Identity({ id: "user1", mspId: "Org1MSP", type: IdentityType.X509 });
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Model as Identity
+ *   App->>Model: new Identity({ id, mspId, type })
+ *   Model-->>App: instance
+ */
+let Identity = class Identity extends core_1.BaseModel {
+    constructor(arg) {
+        super(arg);
+        /**
+         * @description Unique identifier of the identity in the wallet
+         * @summary Primary key used to reference this identity record
+         */
+        this.id = undefined;
+        /**
+         * @description Link to the identity credentials stored separately
+         * @summary One-to-one relationship to the credentials entity; cascades on update and delete
+         */
+        this.credentials = undefined;
+        /**
+         * @description Membership Service Provider identifier
+         * @summary The MSP ID corresponding to the organization that issued this identity
+         */
+        this.mspId = undefined;
+        /**
+         * @description Type of identity
+         * @summary Indicates the identity encoding/format; defaults to X.509
+         */
+        this.type = constants_1.IdentityType.X509;
+    }
+};
+exports.Identity = Identity;
+__decorate([
+    (0, core_1.pk)(),
+    __metadata("design:type", String)
+], Identity.prototype, "id", void 0);
+__decorate([
+    (0, core_1.oneToOne)(IdentityCredentials_1.IdentityCredentials, {
+        update: core_1.Cascade.CASCADE,
+        delete: core_1.Cascade.CASCADE,
+    }),
+    __metadata("design:type", IdentityCredentials_1.IdentityCredentials)
+], Identity.prototype, "credentials", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    __metadata("design:type", String)
+], Identity.prototype, "mspId", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    __metadata("design:type", String)
+], Identity.prototype, "type", void 0);
+exports.Identity = Identity = __decorate([
+    (0, decorator_validation_1.model)(),
+    __metadata("design:paramtypes", [Object])
+], Identity);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSWRlbnRpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2hhcmVkL21vZGVsL0lkZW50aXR5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7OztBQUFBLHlDQUFrRTtBQUNsRSx5RUFBZ0Y7QUFDaEYsbUVBQTREO0FBQzVELGtEQUE0QztBQUU1Qzs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUVJLElBQU0sUUFBUSxHQUFkLE1BQU0sUUFBUyxTQUFRLGdCQUFTO0lBZ0NyQyxZQUFZLEdBQXVCO1FBQ2pDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQztRQWhDYjs7O1dBR0c7UUFFSCxPQUFFLEdBQVksU0FBUyxDQUFDO1FBRXhCOzs7V0FHRztRQUtILGdCQUFXLEdBQXlCLFNBQVMsQ0FBQztRQUU5Qzs7O1dBR0c7UUFFSCxVQUFLLEdBQVksU0FBUyxDQUFDO1FBRTNCOzs7V0FHRztRQUVILFNBQUksR0FBa0Isd0JBQVksQ0FBQyxJQUFJLENBQUM7SUFJeEMsQ0FBQztDQUNGLENBQUE7QUFuQ1ksNEJBQVE7QUFNbkI7SUFEQyxJQUFBLFNBQUUsR0FBRTs7b0NBQ21CO0FBVXhCO0lBSkMsSUFBQSxlQUFRLEVBQUMseUNBQW1CLEVBQUU7UUFDN0IsTUFBTSxFQUFFLGNBQU8sQ0FBQyxPQUFPO1FBQ3ZCLE1BQU0sRUFBRSxjQUFPLENBQUMsT0FBTztLQUN4QixDQUFDOzhCQUNZLHlDQUFtQjs2Q0FBYTtBQU85QztJQURDLElBQUEsK0JBQVEsR0FBRTs7dUNBQ2dCO0FBTzNCO0lBREMsSUFBQSwrQkFBUSxHQUFFOztzQ0FDNkI7bUJBOUI3QixRQUFRO0lBRHBCLElBQUEsNEJBQUssR0FBRTs7R0FDSyxRQUFRLENBbUNwQiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEJhc2VNb2RlbCwgQ2FzY2FkZSwgb25lVG9PbmUsIHBrIH0gZnJvbSBcIkBkZWNhZi10cy9jb3JlXCI7XG5pbXBvcnQgeyBtb2RlbCwgdHlwZSBNb2RlbEFyZywgcmVxdWlyZWQgfSBmcm9tIFwiQGRlY2FmLXRzL2RlY29yYXRvci12YWxpZGF0aW9uXCI7XG5pbXBvcnQgeyBJZGVudGl0eUNyZWRlbnRpYWxzIH0gZnJvbSBcIi4vSWRlbnRpdHlDcmVkZW50aWFsc1wiO1xuaW1wb3J0IHsgSWRlbnRpdHlUeXBlIH0gZnJvbSBcIi4uL2NvbnN0YW50c1wiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBJZGVudGl0eSBtb2RlbCByZXByZXNlbnRpbmcgYSBGYWJyaWMgd2FsbGV0IGVudHJ5XG4gKiBAc3VtbWFyeSBFbmNhcHN1bGF0ZXMgYW4gaWRlbnRpdHkgc3RvcmVkIGluIGEgRmFicmljIHdhbGxldCwgaW5jbHVkaW5nIGl0cyBNU1AgaWRlbnRpZmllciwgY3JlZGVudGlhbCBsaW5rYWdlLCBhbmQgdHlwZSBpbmZvcm1hdGlvbi4gQnVpbHQgb24gQmFzZU1vZGVsIGZvciBpbnRlZ3JhdGlvbiB3aXRoIERlY2FmIHZhbGlkYXRpb24gYW5kIHBlcnNpc3RlbmNlLlxuICogQHBhcmFtIHtNb2RlbEFyZzxJZGVudGl0eT59IFthcmddIC0gT3B0aW9uYWwgaW5pdGlhbGl6YXRpb24gb2JqZWN0IHVzZWQgdG8gcG9wdWxhdGUgbW9kZWwgZmllbGRzXG4gKiBAY2xhc3MgSWRlbnRpdHlcbiAqIEBleGFtcGxlXG4gKiAvLyBDcmVhdGUgYSBuZXcgaWRlbnRpdHkgcmVmZXJlbmNpbmcgZXhpc3RpbmcgY3JlZGVudGlhbHNcbiAqIGNvbnN0IGlkID0gbmV3IElkZW50aXR5KHsgaWQ6IFwidXNlcjFcIiwgbXNwSWQ6IFwiT3JnMU1TUFwiLCB0eXBlOiBJZGVudGl0eVR5cGUuWDUwOSB9KTtcbiAqIEBtZXJtYWlkXG4gKiBzZXF1ZW5jZURpYWdyYW1cbiAqICAgcGFydGljaXBhbnQgQXBwXG4gKiAgIHBhcnRpY2lwYW50IE1vZGVsIGFzIElkZW50aXR5XG4gKiAgIEFwcC0+Pk1vZGVsOiBuZXcgSWRlbnRpdHkoeyBpZCwgbXNwSWQsIHR5cGUgfSlcbiAqICAgTW9kZWwtLT4+QXBwOiBpbnN0YW5jZVxuICovXG5AbW9kZWwoKVxuZXhwb3J0IGNsYXNzIElkZW50aXR5IGV4dGVuZHMgQmFzZU1vZGVsIHtcbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBVbmlxdWUgaWRlbnRpZmllciBvZiB0aGUgaWRlbnRpdHkgaW4gdGhlIHdhbGxldFxuICAgKiBAc3VtbWFyeSBQcmltYXJ5IGtleSB1c2VkIHRvIHJlZmVyZW5jZSB0aGlzIGlkZW50aXR5IHJlY29yZFxuICAgKi9cbiAgQHBrKClcbiAgaWQ/OiBzdHJpbmcgPSB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBMaW5rIHRvIHRoZSBpZGVudGl0eSBjcmVkZW50aWFscyBzdG9yZWQgc2VwYXJhdGVseVxuICAgKiBAc3VtbWFyeSBPbmUtdG8tb25lIHJlbGF0aW9uc2hpcCB0byB0aGUgY3JlZGVudGlhbHMgZW50aXR5OyBjYXNjYWRlcyBvbiB1cGRhdGUgYW5kIGRlbGV0ZVxuICAgKi9cbiAgQG9uZVRvT25lKElkZW50aXR5Q3JlZGVudGlhbHMsIHtcbiAgICB1cGRhdGU6IENhc2NhZGUuQ0FTQ0FERSxcbiAgICBkZWxldGU6IENhc2NhZGUuQ0FTQ0FERSxcbiAgfSlcbiAgY3JlZGVudGlhbHM/OiBJZGVudGl0eUNyZWRlbnRpYWxzID0gdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gTWVtYmVyc2hpcCBTZXJ2aWNlIFByb3ZpZGVyIGlkZW50aWZpZXJcbiAgICogQHN1bW1hcnkgVGhlIE1TUCBJRCBjb3JyZXNwb25kaW5nIHRvIHRoZSBvcmdhbml6YXRpb24gdGhhdCBpc3N1ZWQgdGhpcyBpZGVudGl0eVxuICAgKi9cbiAgQHJlcXVpcmVkKClcbiAgbXNwSWQ/OiBzdHJpbmcgPSB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBUeXBlIG9mIGlkZW50aXR5XG4gICAqIEBzdW1tYXJ5IEluZGljYXRlcyB0aGUgaWRlbnRpdHkgZW5jb2RpbmcvZm9ybWF0OyBkZWZhdWx0cyB0byBYLjUwOVxuICAgKi9cbiAgQHJlcXVpcmVkKClcbiAgdHlwZT86IElkZW50aXR5VHlwZSA9IElkZW50aXR5VHlwZS5YNTA5O1xuXG4gIGNvbnN0cnVjdG9yKGFyZzogTW9kZWxBcmc8SWRlbnRpdHk+KSB7XG4gICAgc3VwZXIoYXJnKTtcbiAgfVxufVxuIl19

package/lib/shared/model/Identity.d.ts

@@ -0,0 +1,42 @@
+import { BaseModel } from "@decaf-ts/core";
+import { type ModelArg } from "@decaf-ts/decorator-validation";
+import { IdentityCredentials } from "./IdentityCredentials";
+import { IdentityType } from "../constants";
+/**
+ * @description Identity model representing a Fabric wallet entry
+ * @summary Encapsulates an identity stored in a Fabric wallet, including its MSP identifier, credential linkage, and type information. Built on BaseModel for integration with Decaf validation and persistence.
+ * @param {ModelArg<Identity>} [arg] - Optional initialization object used to populate model fields
+ * @class Identity
+ * @example
+ * // Create a new identity referencing existing credentials
+ * const id = new Identity({ id: "user1", mspId: "Org1MSP", type: IdentityType.X509 });
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Model as Identity
+ *   App->>Model: new Identity({ id, mspId, type })
+ *   Model-->>App: instance
+ */
+export declare class Identity extends BaseModel {
+    /**
+     * @description Unique identifier of the identity in the wallet
+     * @summary Primary key used to reference this identity record
+     */
+    id?: string;
+    /**
+     * @description Link to the identity credentials stored separately
+     * @summary One-to-one relationship to the credentials entity; cascades on update and delete
+     */
+    credentials?: IdentityCredentials;
+    /**
+     * @description Membership Service Provider identifier
+     * @summary The MSP ID corresponding to the organization that issued this identity
+     */
+    mspId?: string;
+    /**
+     * @description Type of identity
+     * @summary Indicates the identity encoding/format; defaults to X.509
+     */
+    type?: IdentityType;
+    constructor(arg: ModelArg<Identity>);
+}

package/lib/shared/model/IdentityCredentials.cjs

@@ -0,0 +1,77 @@
+"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.IdentityCredentials = void 0;
+const core_1 = require("@decaf-ts/core");
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+/**
+ * @description Identity credential model storing cryptographic materials
+ * @summary Holds certificate chain and private key information for a Fabric identity, managed as a separate entity linked from Identity
+ * @param {ModelArg<IdentityCredentials>} [arg] - Optional initialization object used to populate model fields
+ * @class IdentityCredentials
+ * @example
+ * // Create credentials entry
+ * const creds = new IdentityCredentials({ id: "creds1", certificate: "...", rootCertificate: "...", privateKey: "..." });
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Model as IdentityCredentials
+ *   App->>Model: new IdentityCredentials({ id, certificate, rootCertificate, privateKey })
+ *   Model-->>App: instance
+ * @see model
+ */
+let IdentityCredentials = class IdentityCredentials extends core_1.BaseModel {
+    constructor(arg) {
+        super(arg);
+        /**
+         * @description Unique identifier of the credentials record
+         * @summary Primary key for referencing this credentials entry
+         */
+        this.id = undefined;
+        /**
+         * @description PEM-encoded X.509 certificate for the identity
+         * @summary Leaf certificate associated with the identity
+         */
+        this.certificate = undefined;
+        /**
+         * @description PEM-encoded root or intermediate certificate
+         * @summary Root of trust used to validate the leaf certificate
+         */
+        this.rootCertificate = undefined;
+        /**
+         * @description PEM-encoded private key material
+         * @summary Private key corresponding to the identity certificate
+         */
+        this.privateKey = undefined;
+    }
+};
+exports.IdentityCredentials = IdentityCredentials;
+__decorate([
+    (0, core_1.pk)(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "id", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "certificate", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "rootCertificate", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "privateKey", void 0);
+exports.IdentityCredentials = IdentityCredentials = __decorate([
+    (0, decorator_validation_1.model)(),
+    __metadata("design:paramtypes", [Object])
+], IdentityCredentials);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSWRlbnRpdHlDcmVkZW50aWFscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zaGFyZWQvbW9kZWwvSWRlbnRpdHlDcmVkZW50aWFscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7QUFBQSx5Q0FBK0M7QUFDL0MseUVBQWdGO0FBRWhGOzs7Ozs7Ozs7Ozs7Ozs7R0FlRztBQUVJLElBQU0sbUJBQW1CLEdBQXpCLE1BQU0sbUJBQW9CLFNBQVEsZ0JBQVM7SUE2QmhELFlBQVksR0FBbUM7UUFDN0MsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBN0JiOzs7V0FHRztRQUVILE9BQUUsR0FBWSxTQUFTLENBQUM7UUFFeEI7OztXQUdHO1FBRUgsZ0JBQVcsR0FBWSxTQUFTLENBQUM7UUFFakM7OztXQUdHO1FBRUgsb0JBQWUsR0FBWSxTQUFTLENBQUM7UUFFckM7OztXQUdHO1FBRUgsZUFBVSxHQUFZLFNBQVMsQ0FBQztJQUloQyxDQUFDO0NBQ0YsQ0FBQTtBQWhDWSxrREFBbUI7QUFNOUI7SUFEQyxJQUFBLFNBQUUsR0FBRTs7K0NBQ21CO0FBT3hCO0lBREMsSUFBQSwrQkFBUSxHQUFFOzt3REFDc0I7QUFPakM7SUFEQyxJQUFBLCtCQUFRLEdBQUU7OzREQUMwQjtBQU9yQztJQURDLElBQUEsK0JBQVEsR0FBRTs7dURBQ3FCOzhCQTNCckIsbUJBQW1CO0lBRC9CLElBQUEsNEJBQUssR0FBRTs7R0FDSyxtQkFBbUIsQ0FnQy9CIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQmFzZU1vZGVsLCBwayB9IGZyb20gXCJAZGVjYWYtdHMvY29yZVwiO1xuaW1wb3J0IHsgbW9kZWwsIHR5cGUgTW9kZWxBcmcsIHJlcXVpcmVkIH0gZnJvbSBcIkBkZWNhZi10cy9kZWNvcmF0b3ItdmFsaWRhdGlvblwiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBJZGVudGl0eSBjcmVkZW50aWFsIG1vZGVsIHN0b3JpbmcgY3J5cHRvZ3JhcGhpYyBtYXRlcmlhbHNcbiAqIEBzdW1tYXJ5IEhvbGRzIGNlcnRpZmljYXRlIGNoYWluIGFuZCBwcml2YXRlIGtleSBpbmZvcm1hdGlvbiBmb3IgYSBGYWJyaWMgaWRlbnRpdHksIG1hbmFnZWQgYXMgYSBzZXBhcmF0ZSBlbnRpdHkgbGlua2VkIGZyb20gSWRlbnRpdHlcbiAqIEBwYXJhbSB7TW9kZWxBcmc8SWRlbnRpdHlDcmVkZW50aWFscz59IFthcmddIC0gT3B0aW9uYWwgaW5pdGlhbGl6YXRpb24gb2JqZWN0IHVzZWQgdG8gcG9wdWxhdGUgbW9kZWwgZmllbGRzXG4gKiBAY2xhc3MgSWRlbnRpdHlDcmVkZW50aWFsc1xuICogQGV4YW1wbGVcbiAqIC8vIENyZWF0ZSBjcmVkZW50aWFscyBlbnRyeVxuICogY29uc3QgY3JlZHMgPSBuZXcgSWRlbnRpdHlDcmVkZW50aWFscyh7IGlkOiBcImNyZWRzMVwiLCBjZXJ0aWZpY2F0ZTogXCIuLi5cIiwgcm9vdENlcnRpZmljYXRlOiBcIi4uLlwiLCBwcml2YXRlS2V5OiBcIi4uLlwiIH0pO1xuICogQG1lcm1haWRcbiAqIHNlcXVlbmNlRGlhZ3JhbVxuICogICBwYXJ0aWNpcGFudCBBcHBcbiAqICAgcGFydGljaXBhbnQgTW9kZWwgYXMgSWRlbnRpdHlDcmVkZW50aWFsc1xuICogICBBcHAtPj5Nb2RlbDogbmV3IElkZW50aXR5Q3JlZGVudGlhbHMoeyBpZCwgY2VydGlmaWNhdGUsIHJvb3RDZXJ0aWZpY2F0ZSwgcHJpdmF0ZUtleSB9KVxuICogICBNb2RlbC0tPj5BcHA6IGluc3RhbmNlXG4gKiBAc2VlIG1vZGVsXG4gKi9cbkBtb2RlbCgpXG5leHBvcnQgY2xhc3MgSWRlbnRpdHlDcmVkZW50aWFscyBleHRlbmRzIEJhc2VNb2RlbCB7XG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gVW5pcXVlIGlkZW50aWZpZXIgb2YgdGhlIGNyZWRlbnRpYWxzIHJlY29yZFxuICAgKiBAc3VtbWFyeSBQcmltYXJ5IGtleSBmb3IgcmVmZXJlbmNpbmcgdGhpcyBjcmVkZW50aWFscyBlbnRyeVxuICAgKi9cbiAgQHBrKClcbiAgaWQ/OiBzdHJpbmcgPSB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBQRU0tZW5jb2RlZCBYLjUwOSBjZXJ0aWZpY2F0ZSBmb3IgdGhlIGlkZW50aXR5XG4gICAqIEBzdW1tYXJ5IExlYWYgY2VydGlmaWNhdGUgYXNzb2NpYXRlZCB3aXRoIHRoZSBpZGVudGl0eVxuICAgKi9cbiAgQHJlcXVpcmVkKClcbiAgY2VydGlmaWNhdGU/OiBzdHJpbmcgPSB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBQRU0tZW5jb2RlZCByb290IG9yIGludGVybWVkaWF0ZSBjZXJ0aWZpY2F0ZVxuICAgKiBAc3VtbWFyeSBSb290IG9mIHRydXN0IHVzZWQgdG8gdmFsaWRhdGUgdGhlIGxlYWYgY2VydGlmaWNhdGVcbiAgICovXG4gIEByZXF1aXJlZCgpXG4gIHJvb3RDZXJ0aWZpY2F0ZT86IHN0cmluZyA9IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFBFTS1lbmNvZGVkIHByaXZhdGUga2V5IG1hdGVyaWFsXG4gICAqIEBzdW1tYXJ5IFByaXZhdGUga2V5IGNvcnJlc3BvbmRpbmcgdG8gdGhlIGlkZW50aXR5IGNlcnRpZmljYXRlXG4gICAqL1xuICBAcmVxdWlyZWQoKVxuICBwcml2YXRlS2V5Pzogc3RyaW5nID0gdW5kZWZpbmVkO1xuXG4gIGNvbnN0cnVjdG9yKGFyZz86IE1vZGVsQXJnPElkZW50aXR5Q3JlZGVudGlhbHM+KSB7XG4gICAgc3VwZXIoYXJnKTtcbiAgfVxufVxuIl19

package/lib/shared/model/IdentityCredentials.d.ts

@@ -0,0 +1,41 @@
+import { BaseModel } from "@decaf-ts/core";
+import { type ModelArg } from "@decaf-ts/decorator-validation";
+/**
+ * @description Identity credential model storing cryptographic materials
+ * @summary Holds certificate chain and private key information for a Fabric identity, managed as a separate entity linked from Identity
+ * @param {ModelArg<IdentityCredentials>} [arg] - Optional initialization object used to populate model fields
+ * @class IdentityCredentials
+ * @example
+ * // Create credentials entry
+ * const creds = new IdentityCredentials({ id: "creds1", certificate: "...", rootCertificate: "...", privateKey: "..." });
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Model as IdentityCredentials
+ *   App->>Model: new IdentityCredentials({ id, certificate, rootCertificate, privateKey })
+ *   Model-->>App: instance
+ * @see model
+ */
+export declare class IdentityCredentials extends BaseModel {
+    /**
+     * @description Unique identifier of the credentials record
+     * @summary Primary key for referencing this credentials entry
+     */
+    id?: string;
+    /**
+     * @description PEM-encoded X.509 certificate for the identity
+     * @summary Leaf certificate associated with the identity
+     */
+    certificate?: string;
+    /**
+     * @description PEM-encoded root or intermediate certificate
+     * @summary Root of trust used to validate the leaf certificate
+     */
+    rootCertificate?: string;
+    /**
+     * @description PEM-encoded private key material
+     * @summary Private key corresponding to the identity certificate
+     */
+    privateKey?: string;
+    constructor(arg?: ModelArg<IdentityCredentials>);
+}

package/lib/shared/model/index.cjs

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Identity.cjs"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2hhcmVkL21vZGVsL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxpREFBMkIiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tIFwiLi9JZGVudGl0eVwiO1xuIl19

package/lib/shared/model/index.d.ts

@@ -0,0 +1 @@
+export * from "./Identity";

package/lib/shared/model/utils.cjs

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasPrivateData = hasPrivateData;
+exports.getClassPrivateDataMetadata = getClassPrivateDataMetadata;
+exports.isModelPrivate = isModelPrivate;
+exports.modelToPrivate = modelToPrivate;
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const decorators_1 = require("./../decorators.cjs");
+const constants_1 = require("./../constants.cjs");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+/**
+ * @description Checks whether a model or its class has private data metadata
+ * @summary Uses reflection metadata to determine if the given Decaf model includes Fabric private data annotations at instance or constructor level
+ * @template M extends Model
+ * @param {M} model - The model instance to inspect for private data metadata
+ * @return {boolean} True if private data metadata is present; otherwise false
+ * @function hasPrivateData
+ * @memberOf module:for-fabric.shared
+ */
+function hasPrivateData(model) {
+    const metadata = getClassPrivateDataMetadata(model);
+    if (!metadata)
+        return false;
+    return true;
+}
+/**
+ * @description Retrieves the Fabric private data metadata for a model
+ * @summary Looks up the metadata key on the instance first and then on the constructor to support both instance and static decorator placement
+ * @template M extends Model
+ * @param {M} model - The model whose Fabric private data metadata should be retrieved
+ * @return {Record<string, any>} The metadata object if present, otherwise undefined-like value
+ * @function getClassPrivateDataMetadata
+ * @memberOf module:for-fabric.shared
+ */
+function getClassPrivateDataMetadata(model) {
+    let metadata = Reflect.getMetadata((0, decorators_1.getFabricModelKey)(constants_1.FabricModelKeys.PRIVATE), model);
+    metadata =
+        metadata ||
+            Reflect.getMetadata((0, decorators_1.getFabricModelKey)(constants_1.FabricModelKeys.PRIVATE), model.constructor);
+    return metadata;
+}
+/**
+ * @description Determines if a model should be fully treated as private
+ * @summary Reads the metadata flag isPrivate from the model's Fabric private data metadata and returns its boolean value
+ * @template M extends Model
+ * @param {M} model - The model instance to check
+ * @return {boolean} True when model is marked as private; otherwise false
+ * @function isModelPrivate
+ * @memberOf module:for-fabric.shared
+ */
+function isModelPrivate(model) {
+    const metadata = getClassPrivateDataMetadata(model);
+    if (!metadata || metadata.isPrivate === undefined)
+        return false;
+    return metadata.isPrivate;
+}
+/**
+ * @description Splits a model into public and Fabric private data collections
+ * @summary Iterates over property decorators to collect attributes destined for private data collections while keeping public fields, returning a structure containing the rebuilt public model and a map of collection-name to private attributes
+ * @template M extends Model
+ * @param {M} model - The model instance to transform into public and private parts
+ * @return {{ model: M, private: Record<string, Record<string, any>> }} An object with the rebuilt public model and optional private collection maps
+ * @function modelToPrivate
+ * @mermaid
+ * sequenceDiagram
+ *   participant Caller
+ *   participant Utils as modelToPrivate
+ *   participant Meta as Metadata
+ *   Caller->>Utils: modelToPrivate(model)
+ *   Utils->>Meta: getAllPropertyDecoratorsRecursive(model, PRIVATE)
+ *   Utils->>Meta: isModelPrivate(model)
+ *   alt model is private or has private props
+ *     Utils->>Utils: group properties by collection
+ *   else
+ *     Utils->>Utils: keep property in public model
+ *   end
+ *   Utils->>Meta: getClassPrivateDataMetadata(model)
+ *   Utils->>Utils: Model.build(public, anchor)
+ *   Utils-->>Caller: { model, private }
+ * @memberOf module:for-fabric.shared
+ */
+function modelToPrivate(model) {
+    if (!hasPrivateData(model))
+        return { model: model };
+    const decs = (0, db_decorators_1.getAllPropertyDecoratorsRecursive)(model, undefined, (0, decorators_1.getFabricModelKey)(constants_1.FabricModelKeys.PRIVATE));
+    const isPrivate = isModelPrivate(model);
+    const modelCollections = getClassPrivateDataMetadata(model);
+    const result = Object.entries(decs).reduce((accum, [k, val]) => {
+        const privateData = val.find((el) => el.key === "");
+        if (privateData || isPrivate) {
+            const collections = isPrivate
+                ? modelCollections.collections
+                : privateData.props.collections;
+            accum.private = accum.private || {};
+            for (const collection of collections) {
+                try {
+                    accum.private[collection] = accum.private[collection] || {};
+                    accum.private[collection][k] = model[k];
+                }
+                catch (e) {
+                    throw new db_decorators_1.SerializationError(`Failed to serialize private property ${k}: ${e}`);
+                }
+            }
+        }
+        else {
+            accum.model = accum.model || {};
+            accum.model[k] = model[k];
+        }
+        return accum;
+    }, {});
+    result.model = decorator_validation_1.Model.build(result.model, model.constructor.name);
+    return result;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2hhcmVkL21vZGVsL3V0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBaUJBLHdDQUlDO0FBV0Qsa0VBZ0JDO0FBV0Qsd0NBSUM7QUEyQkQsd0NBK0NDO0FBeklELHlFQUF1RDtBQUN2RCxvREFBa0Q7QUFDbEQsa0RBQStDO0FBQy9DLDJEQUdpQztBQUVqQzs7Ozs7Ozs7R0FRRztBQUNILFNBQWdCLGNBQWMsQ0FBa0IsS0FBUTtJQUN0RCxNQUFNLFFBQVEsR0FBRywyQkFBMkIsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUNwRCxJQUFJLENBQUMsUUFBUTtRQUFFLE9BQU8sS0FBSyxDQUFDO0lBQzVCLE9BQU8sSUFBSSxDQUFDO0FBQ2QsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBZ0IsMkJBQTJCLENBQ3pDLEtBQVE7SUFFUixJQUFJLFFBQVEsR0FBRyxPQUFPLENBQUMsV0FBVyxDQUNoQyxJQUFBLDhCQUFpQixFQUFDLDJCQUFlLENBQUMsT0FBTyxDQUFDLEVBQzFDLEtBQUssQ0FDTixDQUFDO0lBRUYsUUFBUTtRQUNOLFFBQVE7WUFDUixPQUFPLENBQUMsV0FBVyxDQUNqQixJQUFBLDhCQUFpQixFQUFDLDJCQUFlLENBQUMsT0FBTyxDQUFDLEVBQzFDLEtBQUssQ0FBQyxXQUFXLENBQ2xCLENBQUM7SUFFSixPQUFPLFFBQVEsQ0FBQztBQUNsQixDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxTQUFnQixjQUFjLENBQWtCLEtBQVE7SUFDdEQsTUFBTSxRQUFRLEdBQUcsMkJBQTJCLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDcEQsSUFBSSxDQUFDLFFBQVEsSUFBSSxRQUFRLENBQUMsU0FBUyxLQUFLLFNBQVM7UUFBRSxPQUFPLEtBQUssQ0FBQztJQUNoRSxPQUFPLFFBQVEsQ0FBQyxTQUFTLENBQUM7QUFDNUIsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F3Qkc7QUFDSCxTQUFnQixjQUFjLENBQzVCLEtBQVE7SUFFUixJQUFJLENBQUMsY0FBYyxDQUFDLEtBQUssQ0FBQztRQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLENBQUM7SUFDcEQsTUFBTSxJQUFJLEdBQTBCLElBQUEsaURBQWlDLEVBQ25FLEtBQUssRUFDTCxTQUFTLEVBQ1QsSUFBQSw4QkFBaUIsRUFBQywyQkFBZSxDQUFDLE9BQU8sQ0FBQyxDQUNsQixDQUFDO0lBRTNCLE1BQU0sU0FBUyxHQUFHLGNBQWMsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN4QyxNQUFNLGdCQUFnQixHQUNwQiwyQkFBMkIsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUVyQyxNQUFNLE1BQU0sR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sQ0FDeEMsQ0FDRSxLQUFvRSxFQUNwRSxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsRUFDUixFQUFFO1FBQ0YsTUFBTSxXQUFXLEdBQUcsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUMsRUFBRSxDQUFDLEdBQUcsS0FBSyxFQUFFLENBQUMsQ0FBQztRQUVwRCxJQUFJLFdBQVcsSUFBSSxTQUFTLEVBQUUsQ0FBQztZQUM3QixNQUFNLFdBQVcsR0FBRyxTQUFTO2dCQUMzQixDQUFDLENBQUMsZ0JBQWdCLENBQUMsV0FBVztnQkFDOUIsQ0FBQyxDQUFDLFdBQVcsQ0FBQyxLQUFLLENBQUMsV0FBVyxDQUFDO1lBQ2xDLEtBQUssQ0FBQyxPQUFPLEdBQUcsS0FBSyxDQUFDLE9BQU8sSUFBSSxFQUFFLENBQUM7WUFFcEMsS0FBSyxNQUFNLFVBQVUsSUFBSSxXQUFXLEVBQUUsQ0FBQztnQkFDckMsSUFBSSxDQUFDO29CQUNILEtBQUssQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUM7b0JBQzVELEtBQUssQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsS0FBSyxDQUFDLENBQVksQ0FBQyxDQUFDO2dCQUNyRCxDQUFDO2dCQUFDLE9BQU8sQ0FBVSxFQUFFLENBQUM7b0JBQ3BCLE1BQU0sSUFBSSxrQ0FBa0IsQ0FDMUIsd0NBQXdDLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FDbEQsQ0FBQztnQkFDSixDQUFDO1lBQ0gsQ0FBQztRQUNILENBQUM7YUFBTSxDQUFDO1lBQ04sS0FBSyxDQUFDLEtBQUssR0FBRyxLQUFLLENBQUMsS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUNoQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFJLEtBQTZCLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDckQsQ0FBQztRQUNELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQyxFQUNELEVBQW1FLENBQ3BFLENBQUM7SUFDRixNQUFNLENBQUMsS0FBSyxHQUFHLDRCQUFLLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNqRSxPQUFPLE1BQXFFLENBQUM7QUFDL0UsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IE1vZGVsIH0gZnJvbSBcIkBkZWNhZi10cy9kZWNvcmF0b3ItdmFsaWRhdGlvblwiO1xuaW1wb3J0IHsgZ2V0RmFicmljTW9kZWxLZXkgfSBmcm9tIFwiLi4vZGVjb3JhdG9yc1wiO1xuaW1wb3J0IHsgRmFicmljTW9kZWxLZXlzIH0gZnJvbSBcIi4uL2NvbnN0YW50c1wiO1xuaW1wb3J0IHtcbiAgZ2V0QWxsUHJvcGVydHlEZWNvcmF0b3JzUmVjdXJzaXZlLFxuICBTZXJpYWxpemF0aW9uRXJyb3IsXG59IGZyb20gXCJAZGVjYWYtdHMvZGItZGVjb3JhdG9yc1wiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBDaGVja3Mgd2hldGhlciBhIG1vZGVsIG9yIGl0cyBjbGFzcyBoYXMgcHJpdmF0ZSBkYXRhIG1ldGFkYXRhXG4gKiBAc3VtbWFyeSBVc2VzIHJlZmxlY3Rpb24gbWV0YWRhdGEgdG8gZGV0ZXJtaW5lIGlmIHRoZSBnaXZlbiBEZWNhZiBtb2RlbCBpbmNsdWRlcyBGYWJyaWMgcHJpdmF0ZSBkYXRhIGFubm90YXRpb25zIGF0IGluc3RhbmNlIG9yIGNvbnN0cnVjdG9yIGxldmVsXG4gKiBAdGVtcGxhdGUgTSBleHRlbmRzIE1vZGVsXG4gKiBAcGFyYW0ge019IG1vZGVsIC0gVGhlIG1vZGVsIGluc3RhbmNlIHRvIGluc3BlY3QgZm9yIHByaXZhdGUgZGF0YSBtZXRhZGF0YVxuICogQHJldHVybiB7Ym9vbGVhbn0gVHJ1ZSBpZiBwcml2YXRlIGRhdGEgbWV0YWRhdGEgaXMgcHJlc2VudDsgb3RoZXJ3aXNlIGZhbHNlXG4gKiBAZnVuY3Rpb24gaGFzUHJpdmF0ZURhdGFcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGhhc1ByaXZhdGVEYXRhPE0gZXh0ZW5kcyBNb2RlbD4obW9kZWw6IE0pIHtcbiAgY29uc3QgbWV0YWRhdGEgPSBnZXRDbGFzc1ByaXZhdGVEYXRhTWV0YWRhdGEobW9kZWwpO1xuICBpZiAoIW1ldGFkYXRhKSByZXR1cm4gZmFsc2U7XG4gIHJldHVybiB0cnVlO1xufVxuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBSZXRyaWV2ZXMgdGhlIEZhYnJpYyBwcml2YXRlIGRhdGEgbWV0YWRhdGEgZm9yIGEgbW9kZWxcbiAqIEBzdW1tYXJ5IExvb2tzIHVwIHRoZSBtZXRhZGF0YSBrZXkgb24gdGhlIGluc3RhbmNlIGZpcnN0IGFuZCB0aGVuIG9uIHRoZSBjb25zdHJ1Y3RvciB0byBzdXBwb3J0IGJvdGggaW5zdGFuY2UgYW5kIHN0YXRpYyBkZWNvcmF0b3IgcGxhY2VtZW50XG4gKiBAdGVtcGxhdGUgTSBleHRlbmRzIE1vZGVsXG4gKiBAcGFyYW0ge019IG1vZGVsIC0gVGhlIG1vZGVsIHdob3NlIEZhYnJpYyBwcml2YXRlIGRhdGEgbWV0YWRhdGEgc2hvdWxkIGJlIHJldHJpZXZlZFxuICogQHJldHVybiB7UmVjb3JkPHN0cmluZywgYW55Pn0gVGhlIG1ldGFkYXRhIG9iamVjdCBpZiBwcmVzZW50LCBvdGhlcndpc2UgdW5kZWZpbmVkLWxpa2UgdmFsdWVcbiAqIEBmdW5jdGlvbiBnZXRDbGFzc1ByaXZhdGVEYXRhTWV0YWRhdGFcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldENsYXNzUHJpdmF0ZURhdGFNZXRhZGF0YTxNIGV4dGVuZHMgTW9kZWw+KFxuICBtb2RlbDogTVxuKTogUmVjb3JkPHN0cmluZywgYW55PiB7XG4gIGxldCBtZXRhZGF0YSA9IFJlZmxlY3QuZ2V0TWV0YWRhdGEoXG4gICAgZ2V0RmFicmljTW9kZWxLZXkoRmFicmljTW9kZWxLZXlzLlBSSVZBVEUpLFxuICAgIG1vZGVsXG4gICk7XG5cbiAgbWV0YWRhdGEgPVxuICAgIG1ldGFkYXRhIHx8XG4gICAgUmVmbGVjdC5nZXRNZXRhZGF0YShcbiAgICAgIGdldEZhYnJpY01vZGVsS2V5KEZhYnJpY01vZGVsS2V5cy5QUklWQVRFKSxcbiAgICAgIG1vZGVsLmNvbnN0cnVjdG9yXG4gICAgKTtcblxuICByZXR1cm4gbWV0YWRhdGE7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIERldGVybWluZXMgaWYgYSBtb2RlbCBzaG91bGQgYmUgZnVsbHkgdHJlYXRlZCBhcyBwcml2YXRlXG4gKiBAc3VtbWFyeSBSZWFkcyB0aGUgbWV0YWRhdGEgZmxhZyBpc1ByaXZhdGUgZnJvbSB0aGUgbW9kZWwncyBGYWJyaWMgcHJpdmF0ZSBkYXRhIG1ldGFkYXRhIGFuZCByZXR1cm5zIGl0cyBib29sZWFuIHZhbHVlXG4gKiBAdGVtcGxhdGUgTSBleHRlbmRzIE1vZGVsXG4gKiBAcGFyYW0ge019IG1vZGVsIC0gVGhlIG1vZGVsIGluc3RhbmNlIHRvIGNoZWNrXG4gKiBAcmV0dXJuIHtib29sZWFufSBUcnVlIHdoZW4gbW9kZWwgaXMgbWFya2VkIGFzIHByaXZhdGU7IG90aGVyd2lzZSBmYWxzZVxuICogQGZ1bmN0aW9uIGlzTW9kZWxQcml2YXRlXG4gKiBAbWVtYmVyT2YgbW9kdWxlOmZvci1mYWJyaWMuc2hhcmVkXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc01vZGVsUHJpdmF0ZTxNIGV4dGVuZHMgTW9kZWw+KG1vZGVsOiBNKTogYm9vbGVhbiB7XG4gIGNvbnN0IG1ldGFkYXRhID0gZ2V0Q2xhc3NQcml2YXRlRGF0YU1ldGFkYXRhKG1vZGVsKTtcbiAgaWYgKCFtZXRhZGF0YSB8fCBtZXRhZGF0YS5pc1ByaXZhdGUgPT09IHVuZGVmaW5lZCkgcmV0dXJuIGZhbHNlO1xuICByZXR1cm4gbWV0YWRhdGEuaXNQcml2YXRlO1xufVxuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBTcGxpdHMgYSBtb2RlbCBpbnRvIHB1YmxpYyBhbmQgRmFicmljIHByaXZhdGUgZGF0YSBjb2xsZWN0aW9uc1xuICogQHN1bW1hcnkgSXRlcmF0ZXMgb3ZlciBwcm9wZXJ0eSBkZWNvcmF0b3JzIHRvIGNvbGxlY3QgYXR0cmlidXRlcyBkZXN0aW5lZCBmb3IgcHJpdmF0ZSBkYXRhIGNvbGxlY3Rpb25zIHdoaWxlIGtlZXBpbmcgcHVibGljIGZpZWxkcywgcmV0dXJuaW5nIGEgc3RydWN0dXJlIGNvbnRhaW5pbmcgdGhlIHJlYnVpbHQgcHVibGljIG1vZGVsIGFuZCBhIG1hcCBvZiBjb2xsZWN0aW9uLW5hbWUgdG8gcHJpdmF0ZSBhdHRyaWJ1dGVzXG4gKiBAdGVtcGxhdGUgTSBleHRlbmRzIE1vZGVsXG4gKiBAcGFyYW0ge019IG1vZGVsIC0gVGhlIG1vZGVsIGluc3RhbmNlIHRvIHRyYW5zZm9ybSBpbnRvIHB1YmxpYyBhbmQgcHJpdmF0ZSBwYXJ0c1xuICogQHJldHVybiB7eyBtb2RlbDogTSwgcHJpdmF0ZTogUmVjb3JkPHN0cmluZywgUmVjb3JkPHN0cmluZywgYW55Pj4gfX0gQW4gb2JqZWN0IHdpdGggdGhlIHJlYnVpbHQgcHVibGljIG1vZGVsIGFuZCBvcHRpb25hbCBwcml2YXRlIGNvbGxlY3Rpb24gbWFwc1xuICogQGZ1bmN0aW9uIG1vZGVsVG9Qcml2YXRlXG4gKiBAbWVybWFpZFxuICogc2VxdWVuY2VEaWFncmFtXG4gKiAgIHBhcnRpY2lwYW50IENhbGxlclxuICogICBwYXJ0aWNpcGFudCBVdGlscyBhcyBtb2RlbFRvUHJpdmF0ZVxuICogICBwYXJ0aWNpcGFudCBNZXRhIGFzIE1ldGFkYXRhXG4gKiAgIENhbGxlci0+PlV0aWxzOiBtb2RlbFRvUHJpdmF0ZShtb2RlbClcbiAqICAgVXRpbHMtPj5NZXRhOiBnZXRBbGxQcm9wZXJ0eURlY29yYXRvcnNSZWN1cnNpdmUobW9kZWwsIFBSSVZBVEUpXG4gKiAgIFV0aWxzLT4+TWV0YTogaXNNb2RlbFByaXZhdGUobW9kZWwpXG4gKiAgIGFsdCBtb2RlbCBpcyBwcml2YXRlIG9yIGhhcyBwcml2YXRlIHByb3BzXG4gKiAgICAgVXRpbHMtPj5VdGlsczogZ3JvdXAgcHJvcGVydGllcyBieSBjb2xsZWN0aW9uXG4gKiAgIGVsc2VcbiAqICAgICBVdGlscy0+PlV0aWxzOiBrZWVwIHByb3BlcnR5IGluIHB1YmxpYyBtb2RlbFxuICogICBlbmRcbiAqICAgVXRpbHMtPj5NZXRhOiBnZXRDbGFzc1ByaXZhdGVEYXRhTWV0YWRhdGEobW9kZWwpXG4gKiAgIFV0aWxzLT4+VXRpbHM6IE1vZGVsLmJ1aWxkKHB1YmxpYywgYW5jaG9yKVxuICogICBVdGlscy0tPj5DYWxsZXI6IHsgbW9kZWwsIHByaXZhdGUgfVxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gbW9kZWxUb1ByaXZhdGU8TSBleHRlbmRzIE1vZGVsPihcbiAgbW9kZWw6IE1cbik6IHsgbW9kZWw6IE07IHByaXZhdGU/OiBSZWNvcmQ8c3RyaW5nLCBSZWNvcmQ8c3RyaW5nLCBhbnk+PiB9IHtcbiAgaWYgKCFoYXNQcml2YXRlRGF0YShtb2RlbCkpIHJldHVybiB7IG1vZGVsOiBtb2RlbCB9O1xuICBjb25zdCBkZWNzOiBSZWNvcmQ8c3RyaW5nLCBhbnlbXT4gPSBnZXRBbGxQcm9wZXJ0eURlY29yYXRvcnNSZWN1cnNpdmUoXG4gICAgbW9kZWwsXG4gICAgdW5kZWZpbmVkLFxuICAgIGdldEZhYnJpY01vZGVsS2V5KEZhYnJpY01vZGVsS2V5cy5QUklWQVRFKVxuICApIGFzIFJlY29yZDxzdHJpbmcsIGFueVtdPjtcblxuICBjb25zdCBpc1ByaXZhdGUgPSBpc01vZGVsUHJpdmF0ZShtb2RlbCk7XG4gIGNvbnN0IG1vZGVsQ29sbGVjdGlvbnM6IFJlY29yZDxzdHJpbmcsIGFueT4gPVxuICAgIGdldENsYXNzUHJpdmF0ZURhdGFNZXRhZGF0YShtb2RlbCk7XG5cbiAgY29uc3QgcmVzdWx0ID0gT2JqZWN0LmVudHJpZXMoZGVjcykucmVkdWNlKFxuICAgIChcbiAgICAgIGFjY3VtOiB7IG1vZGVsOiBSZWNvcmQ8c3RyaW5nLCBhbnk+OyBwcml2YXRlPzogUmVjb3JkPHN0cmluZywgYW55PiB9LFxuICAgICAgW2ssIHZhbF1cbiAgICApID0+IHtcbiAgICAgIGNvbnN0IHByaXZhdGVEYXRhID0gdmFsLmZpbmQoKGVsKSA9PiBlbC5rZXkgPT09IFwiXCIpO1xuXG4gICAgICBpZiAocHJpdmF0ZURhdGEgfHwgaXNQcml2YXRlKSB7XG4gICAgICAgIGNvbnN0IGNvbGxlY3Rpb25zID0gaXNQcml2YXRlXG4gICAgICAgICAgPyBtb2RlbENvbGxlY3Rpb25zLmNvbGxlY3Rpb25zXG4gICAgICAgICAgOiBwcml2YXRlRGF0YS5wcm9wcy5jb2xsZWN0aW9ucztcbiAgICAgICAgYWNjdW0ucHJpdmF0ZSA9IGFjY3VtLnByaXZhdGUgfHwge307XG5cbiAgICAgICAgZm9yIChjb25zdCBjb2xsZWN0aW9uIG9mIGNvbGxlY3Rpb25zKSB7XG4gICAgICAgICAgdHJ5IHtcbiAgICAgICAgICAgIGFjY3VtLnByaXZhdGVbY29sbGVjdGlvbl0gPSBhY2N1bS5wcml2YXRlW2NvbGxlY3Rpb25dIHx8IHt9O1xuICAgICAgICAgICAgYWNjdW0ucHJpdmF0ZVtjb2xsZWN0aW9uXVtrXSA9IG1vZGVsW2sgYXMga2V5b2YgTV07XG4gICAgICAgICAgfSBjYXRjaCAoZTogdW5rbm93bikge1xuICAgICAgICAgICAgdGhyb3cgbmV3IFNlcmlhbGl6YXRpb25FcnJvcihcbiAgICAgICAgICAgICAgYEZhaWxlZCB0byBzZXJpYWxpemUgcHJpdmF0ZSBwcm9wZXJ0eSAke2t9OiAke2V9YFxuICAgICAgICAgICAgKTtcbiAgICAgICAgICB9XG4gICAgICAgIH1cbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIGFjY3VtLm1vZGVsID0gYWNjdW0ubW9kZWwgfHwge307XG4gICAgICAgIGFjY3VtLm1vZGVsW2tdID0gKG1vZGVsIGFzIFJlY29yZDxzdHJpbmcsIGFueT4pW2tdO1xuICAgICAgfVxuICAgICAgcmV0dXJuIGFjY3VtO1xuICAgIH0sXG4gICAge30gYXMgeyBtb2RlbDogUmVjb3JkPHN0cmluZywgYW55PjsgcHJpdmF0ZT86IFJlY29yZDxzdHJpbmcsIGFueT4gfVxuICApO1xuICByZXN1bHQubW9kZWwgPSBNb2RlbC5idWlsZChyZXN1bHQubW9kZWwsIG1vZGVsLmNvbnN0cnVjdG9yLm5hbWUpO1xuICByZXR1cm4gcmVzdWx0IGFzIHsgbW9kZWw6IE07IHByaXZhdGU/OiBSZWNvcmQ8c3RyaW5nLCBSZWNvcmQ8c3RyaW5nLCBhbnk+PiB9O1xufVxuIl19

package/lib/shared/model/utils.d.ts

@@ -0,0 +1,60 @@
+import { Model } from "@decaf-ts/decorator-validation";
+/**
+ * @description Checks whether a model or its class has private data metadata
+ * @summary Uses reflection metadata to determine if the given Decaf model includes Fabric private data annotations at instance or constructor level
+ * @template M extends Model
+ * @param {M} model - The model instance to inspect for private data metadata
+ * @return {boolean} True if private data metadata is present; otherwise false
+ * @function hasPrivateData
+ * @memberOf module:for-fabric.shared
+ */
+export declare function hasPrivateData<M extends Model>(model: M): boolean;
+/**
+ * @description Retrieves the Fabric private data metadata for a model
+ * @summary Looks up the metadata key on the instance first and then on the constructor to support both instance and static decorator placement
+ * @template M extends Model
+ * @param {M} model - The model whose Fabric private data metadata should be retrieved
+ * @return {Record<string, any>} The metadata object if present, otherwise undefined-like value
+ * @function getClassPrivateDataMetadata
+ * @memberOf module:for-fabric.shared
+ */
+export declare function getClassPrivateDataMetadata<M extends Model>(model: M): Record<string, any>;
+/**
+ * @description Determines if a model should be fully treated as private
+ * @summary Reads the metadata flag isPrivate from the model's Fabric private data metadata and returns its boolean value
+ * @template M extends Model
+ * @param {M} model - The model instance to check
+ * @return {boolean} True when model is marked as private; otherwise false
+ * @function isModelPrivate
+ * @memberOf module:for-fabric.shared
+ */
+export declare function isModelPrivate<M extends Model>(model: M): boolean;
+/**
+ * @description Splits a model into public and Fabric private data collections
+ * @summary Iterates over property decorators to collect attributes destined for private data collections while keeping public fields, returning a structure containing the rebuilt public model and a map of collection-name to private attributes
+ * @template M extends Model
+ * @param {M} model - The model instance to transform into public and private parts
+ * @return {{ model: M, private: Record<string, Record<string, any>> }} An object with the rebuilt public model and optional private collection maps
+ * @function modelToPrivate
+ * @mermaid
+ * sequenceDiagram
+ *   participant Caller
+ *   participant Utils as modelToPrivate
+ *   participant Meta as Metadata
+ *   Caller->>Utils: modelToPrivate(model)
+ *   Utils->>Meta: getAllPropertyDecoratorsRecursive(model, PRIVATE)
+ *   Utils->>Meta: isModelPrivate(model)
+ *   alt model is private or has private props
+ *     Utils->>Utils: group properties by collection
+ *   else
+ *     Utils->>Utils: keep property in public model
+ *   end
+ *   Utils->>Meta: getClassPrivateDataMetadata(model)
+ *   Utils->>Utils: Model.build(public, anchor)
+ *   Utils-->>Caller: { model, private }
+ * @memberOf module:for-fabric.shared
+ */
+export declare function modelToPrivate<M extends Model>(model: M): {
+    model: M;
+    private?: Record<string, Record<string, any>>;
+};

package/lib/shared/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2hhcmVkL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBSZXBvc2l0b3J5RmxhZ3MgfSBmcm9tIFwiQGRlY2FmLXRzL2RiLWRlY29yYXRvcnNcIjtcbmltcG9ydCB7IFRMU09wdGlvbnMgfSBmcm9tIFwiZmFicmljLWNhLWNsaWVudFwiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBDb25maWd1cmF0aW9uIGZvciBjb25uZWN0aW5nIHRvIGEgSHlwZXJsZWRnZXIgRmFicmljIHBlZXJcbiAqIEBzdW1tYXJ5IENvbnRhaW5zIGFsbCB0aGUgbmVjZXNzYXJ5IHBhcmFtZXRlcnMgdG8gZXN0YWJsaXNoIGEgY29ubmVjdGlvbiB0byBhIEZhYnJpYyBwZWVyIGFuZCBpbnRlcmFjdCB3aXRoIGNoYWluY29kZVxuICogQHR5cGVkZWYge09iamVjdH0gUGVlckNvbmZpZ1xuICogQHByb3BlcnR5IHtzdHJpbmd9IGNyeXB0b1BhdGggLSBQYXRoIHRvIHRoZSBjcnlwdG8gbWF0ZXJpYWxzXG4gKiBAcHJvcGVydHkge3N0cmluZ30ga2V5Q2VydE9yRGlyZWN0b3J5UGF0aCAtIEtleSBmaWxlIGNvbnRlbnRzIG9yIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIHByaXZhdGUga2V5c1xuICogQHByb3BlcnR5IHtzdHJpbmd9IGNlcnRDZXJ0T3JEaXJlY3RvcnlQYXRoIC0gQ2VydCBmaWxlIGNvbnRlbnRzIG9yIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIGNlcnRpZmljYXRlc1xuICogQHByb3BlcnR5IHtzdHJpbmd9IHRsc0NlcnQgLSBQYXRoIHRvIHRoZSBUTFMgY2VydGlmaWNhdGVcbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBwZWVyRW5kcG9pbnQgLSBFbmRwb2ludCBVUkwgZm9yIHRoZSBwZWVyXG4gKiBAcHJvcGVydHkge3N0cmluZ30gcGVlckhvc3RBbGlhcyAtIEhvc3QgYWxpYXMgZm9yIHRoZSBwZWVyXG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2FFbmRwb2ludCAtIEVuZHBvaW50IFVSTCBmb3IgdGhlIGNlcnRpZmljYXRlIGF1dGhvcml0eVxuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhVGxzQ2VydGlmaWNhdGUgLSBUTFMgY2VydGlmaWNhdGUgZm9yIHRoZSBjZXJ0aWZpY2F0ZSBhdXRob3JpdHlcbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBjYUNlcnQgLSBDZXJ0aWZpY2F0ZSBmb3IgdGhlIGNlcnRpZmljYXRlIGF1dGhvcml0eVxuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhS2V5IC0gS2V5IGZvciB0aGUgY2VydGlmaWNhdGUgYXV0aG9yaXR5XG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2hhaW5jb2RlTmFtZSAtIE5hbWUgb2YgdGhlIGNoYWluY29kZSB0byBpbnRlcmFjdCB3aXRoXG4gKiBAcHJvcGVydHkge3N0cmluZ30gW2NvbnRyYWN0TmFtZV0gLSBPcHRpb25hbCBuYW1lIG9mIHRoZSBzcGVjaWZpYyBjb250cmFjdCB3aXRoaW4gdGhlIGNoYWluY29kZVxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtjYV0gLSBPcHRpb25hbCBjZXJ0aWZpY2F0ZSBhdXRob3JpdHkgbmFtZVxuICogQHByb3BlcnR5IHtzdHJpbmd9IG1zcElkIC0gTWVtYmVyc2hpcCBTZXJ2aWNlIFByb3ZpZGVyIElEXG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2hhbm5lbCAtIENoYW5uZWwgbmFtZVxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgdHlwZSBQZWVyQ29uZmlnID0ge1xuICBjcnlwdG9QYXRoOiBzdHJpbmc7XG4gIGtleUNlcnRPckRpcmVjdG9yeVBhdGg6IHN0cmluZztcbiAgY2VydENlcnRPckRpcmVjdG9yeVBhdGg6IHN0cmluZztcbiAgdGxzQ2VydDogc3RyaW5nIHwgQnVmZmVyO1xuICBwZWVyRW5kcG9pbnQ6IHN0cmluZztcbiAgcGVlckhvc3RBbGlhczogc3RyaW5nO1xuICBjYUVuZHBvaW50Pzogc3RyaW5nO1xuICBjYVRsc0NlcnRpZmljYXRlPzogc3RyaW5nO1xuICBjYUNlcnQ/OiBzdHJpbmc7XG4gIGNhS2V5Pzogc3RyaW5nO1xuICBjaGFpbmNvZGVOYW1lOiBzdHJpbmc7XG4gIGNvbnRyYWN0TmFtZT86IHN0cmluZztcbiAgY2E/OiBzdHJpbmc7XG4gIG1zcElkOiBzdHJpbmc7XG4gIGNoYW5uZWw6IHN0cmluZztcbn07XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIEZsYWdzIGZvciBGYWJyaWMgb3BlcmF0aW9uc1xuICogQHN1bW1hcnkgQ29tYmluZXMgcmVwb3NpdG9yeSBmbGFncyB3aXRoIHBlZXIgY29uZmlndXJhdGlvbiBvdmVycmlkZXNcbiAqIEBpbnRlcmZhY2UgRmFicmljRmxhZ3NcbiAqIEBleHRlbmRzIHtSZXBvc2l0b3J5RmxhZ3N9XG4gKiBAbWVtYmVyT2YgbW9kdWxlOmZvci1mYWJyaWMuc2hhcmVkXG4gKi9cbmV4cG9ydCB0eXBlIEZhYnJpY0ZsYWdzID0gUmVwb3NpdG9yeUZsYWdzO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBDb25maWd1cmF0aW9uIGZvciBjb25uZWN0aW5nIHRvIGEgSHlwZXJsZWRnZXIgRmFicmljIHBlZXJcbiAqIEBzdW1tYXJ5IENvbnRhaW5zIGFsbCB0aGUgbmVjZXNzYXJ5IHBhcmFtZXRlcnMgdG8gZXN0YWJsaXNoIGEgY29ubmVjdGlvbiB0byBhIEZhYnJpYyBwZWVyIGFuZCBpbnRlcmFjdCB3aXRoIGNoYWluY29kZVxuICogQHR5cGVkZWYge09iamVjdH0gQ0FDb25maWdcbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSB1cmwgLSBQYXRoIHRvIHRoZSBjcnlwdG8gbWF0ZXJpYWxzXG4gKiBAcHJvcGVydHkge1RMU09wdGlvbnN9IHRscyAtIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIHByaXZhdGUga2V5c1xuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhTmFtZSAtIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIGNlcnRpZmljYXRlc1xuICogQHByb3BlcnR5IHtzdHJpbmd9IHRsc0NlcnRQYXRoIC0gUGF0aCB0byB0aGUgVExTIGNlcnRpZmljYXRlXG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2FDZXJ0IC0gRW5kcG9pbnQgVVJMIGZvciB0aGUgcGVlclxuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhS2V5IC0gSG9zdCBhbGlhcyBmb3IgdGhlIHBlZXJcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IHR5cGUgQ0FDb25maWcgPSB7XG4gIHVybDogc3RyaW5nO1xuICB0bHM/OiBUTFNPcHRpb25zO1xuICBjYU5hbWU6IHN0cmluZztcbiAgY2FDZXJ0OiBzdHJpbmc7XG4gIGNhS2V5OiBzdHJpbmc7XG59O1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBVc2VyIGNyZWRlbnRpYWxzIGZvciBDQSBlbnJvbGxtZW50IG9yIGFjY2Vzc1xuICogQHN1bW1hcnkgT3B0aW9uYWwgdXNlcm5hbWUvcGFzc3dvcmQgcGFpciB1c2VkIHdoZW4gZW5yb2xsaW5nIHdpdGggYSBGYWJyaWMgQ0Egb3IgYXV0aGVudGljYXRpbmcgaW4gY2xpZW50IHV0aWxpdGllc1xuICogQGludGVyZmFjZSBDcmVkZW50aWFsc1xuICogQHByb3BlcnR5IHtzdHJpbmd9IFt1c2VyTmFtZV0gLSBPcHRpb25hbCB1c2VybmFtZVxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtwYXNzd29yZF0gLSBPcHRpb25hbCBwYXNzd29yZFxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgaW50ZXJmYWNlIENyZWRlbnRpYWxzIHtcbiAgdXNlck5hbWU/OiBzdHJpbmc7XG4gIHBhc3N3b3JkPzogc3RyaW5nO1xufVxuIl19

package/lib/shared/types.d.ts

@@ -0,0 +1,79 @@
+import { RepositoryFlags } from "@decaf-ts/db-decorators";
+import { TLSOptions } from "fabric-ca-client";
+/**
+ * @description Configuration for connecting to a Hyperledger Fabric peer
+ * @summary Contains all the necessary parameters to establish a connection to a Fabric peer and interact with chaincode
+ * @typedef {Object} PeerConfig
+ * @property {string} cryptoPath - Path to the crypto materials
+ * @property {string} keyCertOrDirectoryPath - Key file contents or Path to the directory containing private keys
+ * @property {string} certCertOrDirectoryPath - Cert file contents or Path to the directory containing certificates
+ * @property {string} tlsCert - Path to the TLS certificate
+ * @property {string} peerEndpoint - Endpoint URL for the peer
+ * @property {string} peerHostAlias - Host alias for the peer
+ * @property {string} caEndpoint - Endpoint URL for the certificate authority
+ * @property {string} caTlsCertificate - TLS certificate for the certificate authority
+ * @property {string} caCert - Certificate for the certificate authority
+ * @property {string} caKey - Key for the certificate authority
+ * @property {string} chaincodeName - Name of the chaincode to interact with
+ * @property {string} [contractName] - Optional name of the specific contract within the chaincode
+ * @property {string} [ca] - Optional certificate authority name
+ * @property {string} mspId - Membership Service Provider ID
+ * @property {string} channel - Channel name
+ * @memberOf module:for-fabric.shared
+ */
+export type PeerConfig = {
+    cryptoPath: string;
+    keyCertOrDirectoryPath: string;
+    certCertOrDirectoryPath: string;
+    tlsCert: string | Buffer;
+    peerEndpoint: string;
+    peerHostAlias: string;
+    caEndpoint?: string;
+    caTlsCertificate?: string;
+    caCert?: string;
+    caKey?: string;
+    chaincodeName: string;
+    contractName?: string;
+    ca?: string;
+    mspId: string;
+    channel: string;
+};
+/**
+ * @description Flags for Fabric operations
+ * @summary Combines repository flags with peer configuration overrides
+ * @interface FabricFlags
+ * @extends {RepositoryFlags}
+ * @memberOf module:for-fabric.shared
+ */
+export type FabricFlags = RepositoryFlags;
+/**
+ * @description Configuration for connecting to a Hyperledger Fabric peer
+ * @summary Contains all the necessary parameters to establish a connection to a Fabric peer and interact with chaincode
+ * @typedef {Object} CAConfig
+ * @property {string} url - Path to the crypto materials
+ * @property {TLSOptions} tls - Path to the directory containing private keys
+ * @property {string} caName - Path to the directory containing certificates
+ * @property {string} tlsCertPath - Path to the TLS certificate
+ * @property {string} caCert - Endpoint URL for the peer
+ * @property {string} caKey - Host alias for the peer
+ * @memberOf module:for-fabric.shared
+ */
+export type CAConfig = {
+    url: string;
+    tls?: TLSOptions;
+    caName: string;
+    caCert: string;
+    caKey: string;
+};
+/**
+ * @description User credentials for CA enrollment or access
+ * @summary Optional username/password pair used when enrolling with a Fabric CA or authenticating in client utilities
+ * @interface Credentials
+ * @property {string} [userName] - Optional username
+ * @property {string} [password] - Optional password
+ * @memberOf module:for-fabric.shared
+ */
+export interface Credentials {
+    userName?: string;
+    password?: string;
+}