@decaf-ts/for-fabric 0.0.2

package/lib/esm/shared/model/Identity.js

@@ -0,0 +1,78 @@
+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);
+};
+import { BaseModel, Cascade, oneToOne, pk } from "@decaf-ts/core";
+import { model, required } from "@decaf-ts/decorator-validation";
+import { IdentityCredentials } from "./IdentityCredentials.js";
+import { IdentityType } from "./../constants.js";
+/**
+ * @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 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 = IdentityType.X509;
+    }
+};
+__decorate([
+    pk(),
+    __metadata("design:type", String)
+], Identity.prototype, "id", void 0);
+__decorate([
+    oneToOne(IdentityCredentials, {
+        update: Cascade.CASCADE,
+        delete: Cascade.CASCADE,
+    }),
+    __metadata("design:type", IdentityCredentials)
+], Identity.prototype, "credentials", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", String)
+], Identity.prototype, "mspId", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", String)
+], Identity.prototype, "type", void 0);
+Identity = __decorate([
+    model(),
+    __metadata("design:paramtypes", [Object])
+], Identity);
+export { Identity };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSWRlbnRpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvc2hhcmVkL21vZGVsL0lkZW50aXR5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLE9BQU8sRUFBRSxTQUFTLEVBQUUsT0FBTyxFQUFFLFFBQVEsRUFBRSxFQUFFLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNsRSxPQUFPLEVBQUUsS0FBSyxFQUFpQixRQUFRLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNoRixPQUFPLEVBQUUsbUJBQW1CLEVBQUUsaUNBQThCO0FBQzVELE9BQU8sRUFBRSxZQUFZLEVBQUUsMEJBQXFCO0FBRTVDOzs7Ozs7Ozs7Ozs7OztHQWNHO0FBRUksSUFBTSxRQUFRLEdBQWQsTUFBTSxRQUFTLFNBQVEsU0FBUztJQWdDckMsWUFBWSxHQUF1QjtRQUNqQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUM7UUFoQ2I7OztXQUdHO1FBRUgsT0FBRSxHQUFZLFNBQVMsQ0FBQztRQUV4Qjs7O1dBR0c7UUFLSCxnQkFBVyxHQUF5QixTQUFTLENBQUM7UUFFOUM7OztXQUdHO1FBRUgsVUFBSyxHQUFZLFNBQVMsQ0FBQztRQUUzQjs7O1dBR0c7UUFFSCxTQUFJLEdBQWtCLFlBQVksQ0FBQyxJQUFJLENBQUM7SUFJeEMsQ0FBQztDQUNGLENBQUE7QUE3QkM7SUFEQyxFQUFFLEVBQUU7O29DQUNtQjtBQVV4QjtJQUpDLFFBQVEsQ0FBQyxtQkFBbUIsRUFBRTtRQUM3QixNQUFNLEVBQUUsT0FBTyxDQUFDLE9BQU87UUFDdkIsTUFBTSxFQUFFLE9BQU8sQ0FBQyxPQUFPO0tBQ3hCLENBQUM7OEJBQ1ksbUJBQW1COzZDQUFhO0FBTzlDO0lBREMsUUFBUSxFQUFFOzt1Q0FDZ0I7QUFPM0I7SUFEQyxRQUFRLEVBQUU7O3NDQUM2QjtBQTlCN0IsUUFBUTtJQURwQixLQUFLLEVBQUU7O0dBQ0ssUUFBUSxDQW1DcEIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBCYXNlTW9kZWwsIENhc2NhZGUsIG9uZVRvT25lLCBwayB9IGZyb20gXCJAZGVjYWYtdHMvY29yZVwiO1xuaW1wb3J0IHsgbW9kZWwsIHR5cGUgTW9kZWxBcmcsIHJlcXVpcmVkIH0gZnJvbSBcIkBkZWNhZi10cy9kZWNvcmF0b3ItdmFsaWRhdGlvblwiO1xuaW1wb3J0IHsgSWRlbnRpdHlDcmVkZW50aWFscyB9IGZyb20gXCIuL0lkZW50aXR5Q3JlZGVudGlhbHNcIjtcbmltcG9ydCB7IElkZW50aXR5VHlwZSB9IGZyb20gXCIuLi9jb25zdGFudHNcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSWRlbnRpdHkgbW9kZWwgcmVwcmVzZW50aW5nIGEgRmFicmljIHdhbGxldCBlbnRyeVxuICogQHN1bW1hcnkgRW5jYXBzdWxhdGVzIGFuIGlkZW50aXR5IHN0b3JlZCBpbiBhIEZhYnJpYyB3YWxsZXQsIGluY2x1ZGluZyBpdHMgTVNQIGlkZW50aWZpZXIsIGNyZWRlbnRpYWwgbGlua2FnZSwgYW5kIHR5cGUgaW5mb3JtYXRpb24uIEJ1aWx0IG9uIEJhc2VNb2RlbCBmb3IgaW50ZWdyYXRpb24gd2l0aCBEZWNhZiB2YWxpZGF0aW9uIGFuZCBwZXJzaXN0ZW5jZS5cbiAqIEBwYXJhbSB7TW9kZWxBcmc8SWRlbnRpdHk+fSBbYXJnXSAtIE9wdGlvbmFsIGluaXRpYWxpemF0aW9uIG9iamVjdCB1c2VkIHRvIHBvcHVsYXRlIG1vZGVsIGZpZWxkc1xuICogQGNsYXNzIElkZW50aXR5XG4gKiBAZXhhbXBsZVxuICogLy8gQ3JlYXRlIGEgbmV3IGlkZW50aXR5IHJlZmVyZW5jaW5nIGV4aXN0aW5nIGNyZWRlbnRpYWxzXG4gKiBjb25zdCBpZCA9IG5ldyBJZGVudGl0eSh7IGlkOiBcInVzZXIxXCIsIG1zcElkOiBcIk9yZzFNU1BcIiwgdHlwZTogSWRlbnRpdHlUeXBlLlg1MDkgfSk7XG4gKiBAbWVybWFpZFxuICogc2VxdWVuY2VEaWFncmFtXG4gKiAgIHBhcnRpY2lwYW50IEFwcFxuICogICBwYXJ0aWNpcGFudCBNb2RlbCBhcyBJZGVudGl0eVxuICogICBBcHAtPj5Nb2RlbDogbmV3IElkZW50aXR5KHsgaWQsIG1zcElkLCB0eXBlIH0pXG4gKiAgIE1vZGVsLS0+PkFwcDogaW5zdGFuY2VcbiAqL1xuQG1vZGVsKClcbmV4cG9ydCBjbGFzcyBJZGVudGl0eSBleHRlbmRzIEJhc2VNb2RlbCB7XG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gVW5pcXVlIGlkZW50aWZpZXIgb2YgdGhlIGlkZW50aXR5IGluIHRoZSB3YWxsZXRcbiAgICogQHN1bW1hcnkgUHJpbWFyeSBrZXkgdXNlZCB0byByZWZlcmVuY2UgdGhpcyBpZGVudGl0eSByZWNvcmRcbiAgICovXG4gIEBwaygpXG4gIGlkPzogc3RyaW5nID0gdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gTGluayB0byB0aGUgaWRlbnRpdHkgY3JlZGVudGlhbHMgc3RvcmVkIHNlcGFyYXRlbHlcbiAgICogQHN1bW1hcnkgT25lLXRvLW9uZSByZWxhdGlvbnNoaXAgdG8gdGhlIGNyZWRlbnRpYWxzIGVudGl0eTsgY2FzY2FkZXMgb24gdXBkYXRlIGFuZCBkZWxldGVcbiAgICovXG4gIEBvbmVUb09uZShJZGVudGl0eUNyZWRlbnRpYWxzLCB7XG4gICAgdXBkYXRlOiBDYXNjYWRlLkNBU0NBREUsXG4gICAgZGVsZXRlOiBDYXNjYWRlLkNBU0NBREUsXG4gIH0pXG4gIGNyZWRlbnRpYWxzPzogSWRlbnRpdHlDcmVkZW50aWFscyA9IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIE1lbWJlcnNoaXAgU2VydmljZSBQcm92aWRlciBpZGVudGlmaWVyXG4gICAqIEBzdW1tYXJ5IFRoZSBNU1AgSUQgY29ycmVzcG9uZGluZyB0byB0aGUgb3JnYW5pemF0aW9uIHRoYXQgaXNzdWVkIHRoaXMgaWRlbnRpdHlcbiAgICovXG4gIEByZXF1aXJlZCgpXG4gIG1zcElkPzogc3RyaW5nID0gdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gVHlwZSBvZiBpZGVudGl0eVxuICAgKiBAc3VtbWFyeSBJbmRpY2F0ZXMgdGhlIGlkZW50aXR5IGVuY29kaW5nL2Zvcm1hdDsgZGVmYXVsdHMgdG8gWC41MDlcbiAgICovXG4gIEByZXF1aXJlZCgpXG4gIHR5cGU/OiBJZGVudGl0eVR5cGUgPSBJZGVudGl0eVR5cGUuWDUwOTtcblxuICBjb25zdHJ1Y3Rvcihhcmc6IE1vZGVsQXJnPElkZW50aXR5Pikge1xuICAgIHN1cGVyKGFyZyk7XG4gIH1cbn1cbiJdfQ==

package/lib/esm/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/esm/shared/model/IdentityCredentials.js

@@ -0,0 +1,74 @@
+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);
+};
+import { BaseModel, pk } from "@decaf-ts/core";
+import { model, required } 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
+ */
+let IdentityCredentials = class IdentityCredentials extends 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;
+    }
+};
+__decorate([
+    pk(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "id", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "certificate", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "rootCertificate", void 0);
+__decorate([
+    required(),
+    __metadata("design:type", String)
+], IdentityCredentials.prototype, "privateKey", void 0);
+IdentityCredentials = __decorate([
+    model(),
+    __metadata("design:paramtypes", [Object])
+], IdentityCredentials);
+export { IdentityCredentials };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSWRlbnRpdHlDcmVkZW50aWFscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9zaGFyZWQvbW9kZWwvSWRlbnRpdHlDcmVkZW50aWFscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7QUFBQSxPQUFPLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQy9DLE9BQU8sRUFBRSxLQUFLLEVBQWlCLFFBQVEsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRWhGOzs7Ozs7Ozs7Ozs7Ozs7R0FlRztBQUVJLElBQU0sbUJBQW1CLEdBQXpCLE1BQU0sbUJBQW9CLFNBQVEsU0FBUztJQTZCaEQsWUFBWSxHQUFtQztRQUM3QyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUM7UUE3QmI7OztXQUdHO1FBRUgsT0FBRSxHQUFZLFNBQVMsQ0FBQztRQUV4Qjs7O1dBR0c7UUFFSCxnQkFBVyxHQUFZLFNBQVMsQ0FBQztRQUVqQzs7O1dBR0c7UUFFSCxvQkFBZSxHQUFZLFNBQVMsQ0FBQztRQUVyQzs7O1dBR0c7UUFFSCxlQUFVLEdBQVksU0FBUyxDQUFDO0lBSWhDLENBQUM7Q0FDRixDQUFBO0FBMUJDO0lBREMsRUFBRSxFQUFFOzsrQ0FDbUI7QUFPeEI7SUFEQyxRQUFRLEVBQUU7O3dEQUNzQjtBQU9qQztJQURDLFFBQVEsRUFBRTs7NERBQzBCO0FBT3JDO0lBREMsUUFBUSxFQUFFOzt1REFDcUI7QUEzQnJCLG1CQUFtQjtJQUQvQixLQUFLLEVBQUU7O0dBQ0ssbUJBQW1CLENBZ0MvQiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEJhc2VNb2RlbCwgcGsgfSBmcm9tIFwiQGRlY2FmLXRzL2NvcmVcIjtcbmltcG9ydCB7IG1vZGVsLCB0eXBlIE1vZGVsQXJnLCByZXF1aXJlZCB9IGZyb20gXCJAZGVjYWYtdHMvZGVjb3JhdG9yLXZhbGlkYXRpb25cIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gSWRlbnRpdHkgY3JlZGVudGlhbCBtb2RlbCBzdG9yaW5nIGNyeXB0b2dyYXBoaWMgbWF0ZXJpYWxzXG4gKiBAc3VtbWFyeSBIb2xkcyBjZXJ0aWZpY2F0ZSBjaGFpbiBhbmQgcHJpdmF0ZSBrZXkgaW5mb3JtYXRpb24gZm9yIGEgRmFicmljIGlkZW50aXR5LCBtYW5hZ2VkIGFzIGEgc2VwYXJhdGUgZW50aXR5IGxpbmtlZCBmcm9tIElkZW50aXR5XG4gKiBAcGFyYW0ge01vZGVsQXJnPElkZW50aXR5Q3JlZGVudGlhbHM+fSBbYXJnXSAtIE9wdGlvbmFsIGluaXRpYWxpemF0aW9uIG9iamVjdCB1c2VkIHRvIHBvcHVsYXRlIG1vZGVsIGZpZWxkc1xuICogQGNsYXNzIElkZW50aXR5Q3JlZGVudGlhbHNcbiAqIEBleGFtcGxlXG4gKiAvLyBDcmVhdGUgY3JlZGVudGlhbHMgZW50cnlcbiAqIGNvbnN0IGNyZWRzID0gbmV3IElkZW50aXR5Q3JlZGVudGlhbHMoeyBpZDogXCJjcmVkczFcIiwgY2VydGlmaWNhdGU6IFwiLi4uXCIsIHJvb3RDZXJ0aWZpY2F0ZTogXCIuLi5cIiwgcHJpdmF0ZUtleTogXCIuLi5cIiB9KTtcbiAqIEBtZXJtYWlkXG4gKiBzZXF1ZW5jZURpYWdyYW1cbiAqICAgcGFydGljaXBhbnQgQXBwXG4gKiAgIHBhcnRpY2lwYW50IE1vZGVsIGFzIElkZW50aXR5Q3JlZGVudGlhbHNcbiAqICAgQXBwLT4+TW9kZWw6IG5ldyBJZGVudGl0eUNyZWRlbnRpYWxzKHsgaWQsIGNlcnRpZmljYXRlLCByb290Q2VydGlmaWNhdGUsIHByaXZhdGVLZXkgfSlcbiAqICAgTW9kZWwtLT4+QXBwOiBpbnN0YW5jZVxuICogQHNlZSBtb2RlbFxuICovXG5AbW9kZWwoKVxuZXhwb3J0IGNsYXNzIElkZW50aXR5Q3JlZGVudGlhbHMgZXh0ZW5kcyBCYXNlTW9kZWwge1xuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFVuaXF1ZSBpZGVudGlmaWVyIG9mIHRoZSBjcmVkZW50aWFscyByZWNvcmRcbiAgICogQHN1bW1hcnkgUHJpbWFyeSBrZXkgZm9yIHJlZmVyZW5jaW5nIHRoaXMgY3JlZGVudGlhbHMgZW50cnlcbiAgICovXG4gIEBwaygpXG4gIGlkPzogc3RyaW5nID0gdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gUEVNLWVuY29kZWQgWC41MDkgY2VydGlmaWNhdGUgZm9yIHRoZSBpZGVudGl0eVxuICAgKiBAc3VtbWFyeSBMZWFmIGNlcnRpZmljYXRlIGFzc29jaWF0ZWQgd2l0aCB0aGUgaWRlbnRpdHlcbiAgICovXG4gIEByZXF1aXJlZCgpXG4gIGNlcnRpZmljYXRlPzogc3RyaW5nID0gdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gUEVNLWVuY29kZWQgcm9vdCBvciBpbnRlcm1lZGlhdGUgY2VydGlmaWNhdGVcbiAgICogQHN1bW1hcnkgUm9vdCBvZiB0cnVzdCB1c2VkIHRvIHZhbGlkYXRlIHRoZSBsZWFmIGNlcnRpZmljYXRlXG4gICAqL1xuICBAcmVxdWlyZWQoKVxuICByb290Q2VydGlmaWNhdGU/OiBzdHJpbmcgPSB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBQRU0tZW5jb2RlZCBwcml2YXRlIGtleSBtYXRlcmlhbFxuICAgKiBAc3VtbWFyeSBQcml2YXRlIGtleSBjb3JyZXNwb25kaW5nIHRvIHRoZSBpZGVudGl0eSBjZXJ0aWZpY2F0ZVxuICAgKi9cbiAgQHJlcXVpcmVkKClcbiAgcHJpdmF0ZUtleT86IHN0cmluZyA9IHVuZGVmaW5lZDtcblxuICBjb25zdHJ1Y3Rvcihhcmc/OiBNb2RlbEFyZzxJZGVudGl0eUNyZWRlbnRpYWxzPikge1xuICAgIHN1cGVyKGFyZyk7XG4gIH1cbn1cbiJdfQ==

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

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

package/lib/esm/shared/model/index.js

@@ -0,0 +1,2 @@
+export * from "./Identity.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvc2hhcmVkL21vZGVsL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLDhCQUEyQiIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gXCIuL0lkZW50aXR5XCI7XG4iXX0=

package/lib/esm/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/esm/shared/model/utils.js

@@ -0,0 +1,108 @@
+import { Model } from "@decaf-ts/decorator-validation";
+import { getFabricModelKey } from "./../decorators.js";
+import { FabricModelKeys } from "./../constants.js";
+import { getAllPropertyDecoratorsRecursive, SerializationError, } from "@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
+ */
+export 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
+ */
+export function getClassPrivateDataMetadata(model) {
+    let metadata = Reflect.getMetadata(getFabricModelKey(FabricModelKeys.PRIVATE), model);
+    metadata =
+        metadata ||
+            Reflect.getMetadata(getFabricModelKey(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
+ */
+export 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
+ */
+export function modelToPrivate(model) {
+    if (!hasPrivateData(model))
+        return { model: model };
+    const decs = getAllPropertyDecoratorsRecursive(model, undefined, getFabricModelKey(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 SerializationError(`Failed to serialize private property ${k}: ${e}`);
+                }
+            }
+        }
+        else {
+            accum.model = accum.model || {};
+            accum.model[k] = model[k];
+        }
+        return accum;
+    }, {});
+    result.model = Model.build(result.model, model.constructor.name);
+    return result;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvc2hhcmVkL21vZGVsL3V0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN2RCxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsMkJBQXNCO0FBQ2xELE9BQU8sRUFBRSxlQUFlLEVBQUUsMEJBQXFCO0FBQy9DLE9BQU8sRUFDTCxpQ0FBaUMsRUFDakMsa0JBQWtCLEdBQ25CLE1BQU0seUJBQXlCLENBQUM7QUFFakM7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLFVBQVUsY0FBYyxDQUFrQixLQUFRO0lBQ3RELE1BQU0sUUFBUSxHQUFHLDJCQUEyQixDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ3BELElBQUksQ0FBQyxRQUFRO1FBQUUsT0FBTyxLQUFLLENBQUM7SUFDNUIsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLFVBQVUsMkJBQTJCLENBQ3pDLEtBQVE7SUFFUixJQUFJLFFBQVEsR0FBRyxPQUFPLENBQUMsV0FBVyxDQUNoQyxpQkFBaUIsQ0FBQyxlQUFlLENBQUMsT0FBTyxDQUFDLEVBQzFDLEtBQUssQ0FDTixDQUFDO0lBRUYsUUFBUTtRQUNOLFFBQVE7WUFDUixPQUFPLENBQUMsV0FBVyxDQUNqQixpQkFBaUIsQ0FBQyxlQUFlLENBQUMsT0FBTyxDQUFDLEVBQzFDLEtBQUssQ0FBQyxXQUFXLENBQ2xCLENBQUM7SUFFSixPQUFPLFFBQVEsQ0FBQztBQUNsQixDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLFVBQVUsY0FBYyxDQUFrQixLQUFRO0lBQ3RELE1BQU0sUUFBUSxHQUFHLDJCQUEyQixDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ3BELElBQUksQ0FBQyxRQUFRLElBQUksUUFBUSxDQUFDLFNBQVMsS0FBSyxTQUFTO1FBQUUsT0FBTyxLQUFLLENBQUM7SUFDaEUsT0FBTyxRQUFRLENBQUMsU0FBUyxDQUFDO0FBQzVCLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBd0JHO0FBQ0gsTUFBTSxVQUFVLGNBQWMsQ0FDNUIsS0FBUTtJQUVSLElBQUksQ0FBQyxjQUFjLENBQUMsS0FBSyxDQUFDO1FBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsQ0FBQztJQUNwRCxNQUFNLElBQUksR0FBMEIsaUNBQWlDLENBQ25FLEtBQUssRUFDTCxTQUFTLEVBQ1QsaUJBQWlCLENBQUMsZUFBZSxDQUFDLE9BQU8sQ0FBQyxDQUNsQixDQUFDO0lBRTNCLE1BQU0sU0FBUyxHQUFHLGNBQWMsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN4QyxNQUFNLGdCQUFnQixHQUNwQiwyQkFBMkIsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUVyQyxNQUFNLE1BQU0sR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sQ0FDeEMsQ0FDRSxLQUFvRSxFQUNwRSxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsRUFDUixFQUFFO1FBQ0YsTUFBTSxXQUFXLEdBQUcsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUMsRUFBRSxDQUFDLEdBQUcsS0FBSyxFQUFFLENBQUMsQ0FBQztRQUVwRCxJQUFJLFdBQVcsSUFBSSxTQUFTLEVBQUUsQ0FBQztZQUM3QixNQUFNLFdBQVcsR0FBRyxTQUFTO2dCQUMzQixDQUFDLENBQUMsZ0JBQWdCLENBQUMsV0FBVztnQkFDOUIsQ0FBQyxDQUFDLFdBQVcsQ0FBQyxLQUFLLENBQUMsV0FBVyxDQUFDO1lBQ2xDLEtBQUssQ0FBQyxPQUFPLEdBQUcsS0FBSyxDQUFDLE9BQU8sSUFBSSxFQUFFLENBQUM7WUFFcEMsS0FBSyxNQUFNLFVBQVUsSUFBSSxXQUFXLEVBQUUsQ0FBQztnQkFDckMsSUFBSSxDQUFDO29CQUNILEtBQUssQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUM7b0JBQzVELEtBQUssQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsS0FBSyxDQUFDLENBQVksQ0FBQyxDQUFDO2dCQUNyRCxDQUFDO2dCQUFDLE9BQU8sQ0FBVSxFQUFFLENBQUM7b0JBQ3BCLE1BQU0sSUFBSSxrQkFBa0IsQ0FDMUIsd0NBQXdDLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FDbEQsQ0FBQztnQkFDSixDQUFDO1lBQ0gsQ0FBQztRQUNILENBQUM7YUFBTSxDQUFDO1lBQ04sS0FBSyxDQUFDLEtBQUssR0FBRyxLQUFLLENBQUMsS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUNoQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFJLEtBQTZCLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDckQsQ0FBQztRQUNELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQyxFQUNELEVBQW1FLENBQ3BFLENBQUM7SUFDRixNQUFNLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ2pFLE9BQU8sTUFBcUUsQ0FBQztBQUMvRSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgTW9kZWwgfSBmcm9tIFwiQGRlY2FmLXRzL2RlY29yYXRvci12YWxpZGF0aW9uXCI7XG5pbXBvcnQgeyBnZXRGYWJyaWNNb2RlbEtleSB9IGZyb20gXCIuLi9kZWNvcmF0b3JzXCI7XG5pbXBvcnQgeyBGYWJyaWNNb2RlbEtleXMgfSBmcm9tIFwiLi4vY29uc3RhbnRzXCI7XG5pbXBvcnQge1xuICBnZXRBbGxQcm9wZXJ0eURlY29yYXRvcnNSZWN1cnNpdmUsXG4gIFNlcmlhbGl6YXRpb25FcnJvcixcbn0gZnJvbSBcIkBkZWNhZi10cy9kYi1kZWNvcmF0b3JzXCI7XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIENoZWNrcyB3aGV0aGVyIGEgbW9kZWwgb3IgaXRzIGNsYXNzIGhhcyBwcml2YXRlIGRhdGEgbWV0YWRhdGFcbiAqIEBzdW1tYXJ5IFVzZXMgcmVmbGVjdGlvbiBtZXRhZGF0YSB0byBkZXRlcm1pbmUgaWYgdGhlIGdpdmVuIERlY2FmIG1vZGVsIGluY2x1ZGVzIEZhYnJpYyBwcml2YXRlIGRhdGEgYW5ub3RhdGlvbnMgYXQgaW5zdGFuY2Ugb3IgY29uc3RydWN0b3IgbGV2ZWxcbiAqIEB0ZW1wbGF0ZSBNIGV4dGVuZHMgTW9kZWxcbiAqIEBwYXJhbSB7TX0gbW9kZWwgLSBUaGUgbW9kZWwgaW5zdGFuY2UgdG8gaW5zcGVjdCBmb3IgcHJpdmF0ZSBkYXRhIG1ldGFkYXRhXG4gKiBAcmV0dXJuIHtib29sZWFufSBUcnVlIGlmIHByaXZhdGUgZGF0YSBtZXRhZGF0YSBpcyBwcmVzZW50OyBvdGhlcndpc2UgZmFsc2VcbiAqIEBmdW5jdGlvbiBoYXNQcml2YXRlRGF0YVxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gaGFzUHJpdmF0ZURhdGE8TSBleHRlbmRzIE1vZGVsPihtb2RlbDogTSkge1xuICBjb25zdCBtZXRhZGF0YSA9IGdldENsYXNzUHJpdmF0ZURhdGFNZXRhZGF0YShtb2RlbCk7XG4gIGlmICghbWV0YWRhdGEpIHJldHVybiBmYWxzZTtcbiAgcmV0dXJuIHRydWU7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIFJldHJpZXZlcyB0aGUgRmFicmljIHByaXZhdGUgZGF0YSBtZXRhZGF0YSBmb3IgYSBtb2RlbFxuICogQHN1bW1hcnkgTG9va3MgdXAgdGhlIG1ldGFkYXRhIGtleSBvbiB0aGUgaW5zdGFuY2UgZmlyc3QgYW5kIHRoZW4gb24gdGhlIGNvbnN0cnVjdG9yIHRvIHN1cHBvcnQgYm90aCBpbnN0YW5jZSBhbmQgc3RhdGljIGRlY29yYXRvciBwbGFjZW1lbnRcbiAqIEB0ZW1wbGF0ZSBNIGV4dGVuZHMgTW9kZWxcbiAqIEBwYXJhbSB7TX0gbW9kZWwgLSBUaGUgbW9kZWwgd2hvc2UgRmFicmljIHByaXZhdGUgZGF0YSBtZXRhZGF0YSBzaG91bGQgYmUgcmV0cmlldmVkXG4gKiBAcmV0dXJuIHtSZWNvcmQ8c3RyaW5nLCBhbnk+fSBUaGUgbWV0YWRhdGEgb2JqZWN0IGlmIHByZXNlbnQsIG90aGVyd2lzZSB1bmRlZmluZWQtbGlrZSB2YWx1ZVxuICogQGZ1bmN0aW9uIGdldENsYXNzUHJpdmF0ZURhdGFNZXRhZGF0YVxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0Q2xhc3NQcml2YXRlRGF0YU1ldGFkYXRhPE0gZXh0ZW5kcyBNb2RlbD4oXG4gIG1vZGVsOiBNXG4pOiBSZWNvcmQ8c3RyaW5nLCBhbnk+IHtcbiAgbGV0IG1ldGFkYXRhID0gUmVmbGVjdC5nZXRNZXRhZGF0YShcbiAgICBnZXRGYWJyaWNNb2RlbEtleShGYWJyaWNNb2RlbEtleXMuUFJJVkFURSksXG4gICAgbW9kZWxcbiAgKTtcblxuICBtZXRhZGF0YSA9XG4gICAgbWV0YWRhdGEgfHxcbiAgICBSZWZsZWN0LmdldE1ldGFkYXRhKFxuICAgICAgZ2V0RmFicmljTW9kZWxLZXkoRmFicmljTW9kZWxLZXlzLlBSSVZBVEUpLFxuICAgICAgbW9kZWwuY29uc3RydWN0b3JcbiAgICApO1xuXG4gIHJldHVybiBtZXRhZGF0YTtcbn1cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gRGV0ZXJtaW5lcyBpZiBhIG1vZGVsIHNob3VsZCBiZSBmdWxseSB0cmVhdGVkIGFzIHByaXZhdGVcbiAqIEBzdW1tYXJ5IFJlYWRzIHRoZSBtZXRhZGF0YSBmbGFnIGlzUHJpdmF0ZSBmcm9tIHRoZSBtb2RlbCdzIEZhYnJpYyBwcml2YXRlIGRhdGEgbWV0YWRhdGEgYW5kIHJldHVybnMgaXRzIGJvb2xlYW4gdmFsdWVcbiAqIEB0ZW1wbGF0ZSBNIGV4dGVuZHMgTW9kZWxcbiAqIEBwYXJhbSB7TX0gbW9kZWwgLSBUaGUgbW9kZWwgaW5zdGFuY2UgdG8gY2hlY2tcbiAqIEByZXR1cm4ge2Jvb2xlYW59IFRydWUgd2hlbiBtb2RlbCBpcyBtYXJrZWQgYXMgcHJpdmF0ZTsgb3RoZXJ3aXNlIGZhbHNlXG4gKiBAZnVuY3Rpb24gaXNNb2RlbFByaXZhdGVcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzTW9kZWxQcml2YXRlPE0gZXh0ZW5kcyBNb2RlbD4obW9kZWw6IE0pOiBib29sZWFuIHtcbiAgY29uc3QgbWV0YWRhdGEgPSBnZXRDbGFzc1ByaXZhdGVEYXRhTWV0YWRhdGEobW9kZWwpO1xuICBpZiAoIW1ldGFkYXRhIHx8IG1ldGFkYXRhLmlzUHJpdmF0ZSA9PT0gdW5kZWZpbmVkKSByZXR1cm4gZmFsc2U7XG4gIHJldHVybiBtZXRhZGF0YS5pc1ByaXZhdGU7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIFNwbGl0cyBhIG1vZGVsIGludG8gcHVibGljIGFuZCBGYWJyaWMgcHJpdmF0ZSBkYXRhIGNvbGxlY3Rpb25zXG4gKiBAc3VtbWFyeSBJdGVyYXRlcyBvdmVyIHByb3BlcnR5IGRlY29yYXRvcnMgdG8gY29sbGVjdCBhdHRyaWJ1dGVzIGRlc3RpbmVkIGZvciBwcml2YXRlIGRhdGEgY29sbGVjdGlvbnMgd2hpbGUga2VlcGluZyBwdWJsaWMgZmllbGRzLCByZXR1cm5pbmcgYSBzdHJ1Y3R1cmUgY29udGFpbmluZyB0aGUgcmVidWlsdCBwdWJsaWMgbW9kZWwgYW5kIGEgbWFwIG9mIGNvbGxlY3Rpb24tbmFtZSB0byBwcml2YXRlIGF0dHJpYnV0ZXNcbiAqIEB0ZW1wbGF0ZSBNIGV4dGVuZHMgTW9kZWxcbiAqIEBwYXJhbSB7TX0gbW9kZWwgLSBUaGUgbW9kZWwgaW5zdGFuY2UgdG8gdHJhbnNmb3JtIGludG8gcHVibGljIGFuZCBwcml2YXRlIHBhcnRzXG4gKiBAcmV0dXJuIHt7IG1vZGVsOiBNLCBwcml2YXRlOiBSZWNvcmQ8c3RyaW5nLCBSZWNvcmQ8c3RyaW5nLCBhbnk+PiB9fSBBbiBvYmplY3Qgd2l0aCB0aGUgcmVidWlsdCBwdWJsaWMgbW9kZWwgYW5kIG9wdGlvbmFsIHByaXZhdGUgY29sbGVjdGlvbiBtYXBzXG4gKiBAZnVuY3Rpb24gbW9kZWxUb1ByaXZhdGVcbiAqIEBtZXJtYWlkXG4gKiBzZXF1ZW5jZURpYWdyYW1cbiAqICAgcGFydGljaXBhbnQgQ2FsbGVyXG4gKiAgIHBhcnRpY2lwYW50IFV0aWxzIGFzIG1vZGVsVG9Qcml2YXRlXG4gKiAgIHBhcnRpY2lwYW50IE1ldGEgYXMgTWV0YWRhdGFcbiAqICAgQ2FsbGVyLT4+VXRpbHM6IG1vZGVsVG9Qcml2YXRlKG1vZGVsKVxuICogICBVdGlscy0+Pk1ldGE6IGdldEFsbFByb3BlcnR5RGVjb3JhdG9yc1JlY3Vyc2l2ZShtb2RlbCwgUFJJVkFURSlcbiAqICAgVXRpbHMtPj5NZXRhOiBpc01vZGVsUHJpdmF0ZShtb2RlbClcbiAqICAgYWx0IG1vZGVsIGlzIHByaXZhdGUgb3IgaGFzIHByaXZhdGUgcHJvcHNcbiAqICAgICBVdGlscy0+PlV0aWxzOiBncm91cCBwcm9wZXJ0aWVzIGJ5IGNvbGxlY3Rpb25cbiAqICAgZWxzZVxuICogICAgIFV0aWxzLT4+VXRpbHM6IGtlZXAgcHJvcGVydHkgaW4gcHVibGljIG1vZGVsXG4gKiAgIGVuZFxuICogICBVdGlscy0+Pk1ldGE6IGdldENsYXNzUHJpdmF0ZURhdGFNZXRhZGF0YShtb2RlbClcbiAqICAgVXRpbHMtPj5VdGlsczogTW9kZWwuYnVpbGQocHVibGljLCBhbmNob3IpXG4gKiAgIFV0aWxzLS0+PkNhbGxlcjogeyBtb2RlbCwgcHJpdmF0ZSB9XG4gKiBAbWVtYmVyT2YgbW9kdWxlOmZvci1mYWJyaWMuc2hhcmVkXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBtb2RlbFRvUHJpdmF0ZTxNIGV4dGVuZHMgTW9kZWw+KFxuICBtb2RlbDogTVxuKTogeyBtb2RlbDogTTsgcHJpdmF0ZT86IFJlY29yZDxzdHJpbmcsIFJlY29yZDxzdHJpbmcsIGFueT4+IH0ge1xuICBpZiAoIWhhc1ByaXZhdGVEYXRhKG1vZGVsKSkgcmV0dXJuIHsgbW9kZWw6IG1vZGVsIH07XG4gIGNvbnN0IGRlY3M6IFJlY29yZDxzdHJpbmcsIGFueVtdPiA9IGdldEFsbFByb3BlcnR5RGVjb3JhdG9yc1JlY3Vyc2l2ZShcbiAgICBtb2RlbCxcbiAgICB1bmRlZmluZWQsXG4gICAgZ2V0RmFicmljTW9kZWxLZXkoRmFicmljTW9kZWxLZXlzLlBSSVZBVEUpXG4gICkgYXMgUmVjb3JkPHN0cmluZywgYW55W10+O1xuXG4gIGNvbnN0IGlzUHJpdmF0ZSA9IGlzTW9kZWxQcml2YXRlKG1vZGVsKTtcbiAgY29uc3QgbW9kZWxDb2xsZWN0aW9uczogUmVjb3JkPHN0cmluZywgYW55PiA9XG4gICAgZ2V0Q2xhc3NQcml2YXRlRGF0YU1ldGFkYXRhKG1vZGVsKTtcblxuICBjb25zdCByZXN1bHQgPSBPYmplY3QuZW50cmllcyhkZWNzKS5yZWR1Y2UoXG4gICAgKFxuICAgICAgYWNjdW06IHsgbW9kZWw6IFJlY29yZDxzdHJpbmcsIGFueT47IHByaXZhdGU/OiBSZWNvcmQ8c3RyaW5nLCBhbnk+IH0sXG4gICAgICBbaywgdmFsXVxuICAgICkgPT4ge1xuICAgICAgY29uc3QgcHJpdmF0ZURhdGEgPSB2YWwuZmluZCgoZWwpID0+IGVsLmtleSA9PT0gXCJcIik7XG5cbiAgICAgIGlmIChwcml2YXRlRGF0YSB8fCBpc1ByaXZhdGUpIHtcbiAgICAgICAgY29uc3QgY29sbGVjdGlvbnMgPSBpc1ByaXZhdGVcbiAgICAgICAgICA/IG1vZGVsQ29sbGVjdGlvbnMuY29sbGVjdGlvbnNcbiAgICAgICAgICA6IHByaXZhdGVEYXRhLnByb3BzLmNvbGxlY3Rpb25zO1xuICAgICAgICBhY2N1bS5wcml2YXRlID0gYWNjdW0ucHJpdmF0ZSB8fCB7fTtcblxuICAgICAgICBmb3IgKGNvbnN0IGNvbGxlY3Rpb24gb2YgY29sbGVjdGlvbnMpIHtcbiAgICAgICAgICB0cnkge1xuICAgICAgICAgICAgYWNjdW0ucHJpdmF0ZVtjb2xsZWN0aW9uXSA9IGFjY3VtLnByaXZhdGVbY29sbGVjdGlvbl0gfHwge307XG4gICAgICAgICAgICBhY2N1bS5wcml2YXRlW2NvbGxlY3Rpb25dW2tdID0gbW9kZWxbayBhcyBrZXlvZiBNXTtcbiAgICAgICAgICB9IGNhdGNoIChlOiB1bmtub3duKSB7XG4gICAgICAgICAgICB0aHJvdyBuZXcgU2VyaWFsaXphdGlvbkVycm9yKFxuICAgICAgICAgICAgICBgRmFpbGVkIHRvIHNlcmlhbGl6ZSBwcml2YXRlIHByb3BlcnR5ICR7a306ICR7ZX1gXG4gICAgICAgICAgICApO1xuICAgICAgICAgIH1cbiAgICAgICAgfVxuICAgICAgfSBlbHNlIHtcbiAgICAgICAgYWNjdW0ubW9kZWwgPSBhY2N1bS5tb2RlbCB8fCB7fTtcbiAgICAgICAgYWNjdW0ubW9kZWxba10gPSAobW9kZWwgYXMgUmVjb3JkPHN0cmluZywgYW55Pilba107XG4gICAgICB9XG4gICAgICByZXR1cm4gYWNjdW07XG4gICAgfSxcbiAgICB7fSBhcyB7IG1vZGVsOiBSZWNvcmQ8c3RyaW5nLCBhbnk+OyBwcml2YXRlPzogUmVjb3JkPHN0cmluZywgYW55PiB9XG4gICk7XG4gIHJlc3VsdC5tb2RlbCA9IE1vZGVsLmJ1aWxkKHJlc3VsdC5tb2RlbCwgbW9kZWwuY29uc3RydWN0b3IubmFtZSk7XG4gIHJldHVybiByZXN1bHQgYXMgeyBtb2RlbDogTTsgcHJpdmF0ZT86IFJlY29yZDxzdHJpbmcsIFJlY29yZDxzdHJpbmcsIGFueT4+IH07XG59XG4iXX0=

package/lib/esm/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;
+}

package/lib/esm/shared/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2hhcmVkL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBSZXBvc2l0b3J5RmxhZ3MgfSBmcm9tIFwiQGRlY2FmLXRzL2RiLWRlY29yYXRvcnNcIjtcbmltcG9ydCB7IFRMU09wdGlvbnMgfSBmcm9tIFwiZmFicmljLWNhLWNsaWVudFwiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBDb25maWd1cmF0aW9uIGZvciBjb25uZWN0aW5nIHRvIGEgSHlwZXJsZWRnZXIgRmFicmljIHBlZXJcbiAqIEBzdW1tYXJ5IENvbnRhaW5zIGFsbCB0aGUgbmVjZXNzYXJ5IHBhcmFtZXRlcnMgdG8gZXN0YWJsaXNoIGEgY29ubmVjdGlvbiB0byBhIEZhYnJpYyBwZWVyIGFuZCBpbnRlcmFjdCB3aXRoIGNoYWluY29kZVxuICogQHR5cGVkZWYge09iamVjdH0gUGVlckNvbmZpZ1xuICogQHByb3BlcnR5IHtzdHJpbmd9IGNyeXB0b1BhdGggLSBQYXRoIHRvIHRoZSBjcnlwdG8gbWF0ZXJpYWxzXG4gKiBAcHJvcGVydHkge3N0cmluZ30ga2V5Q2VydE9yRGlyZWN0b3J5UGF0aCAtIEtleSBmaWxlIGNvbnRlbnRzIG9yIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIHByaXZhdGUga2V5c1xuICogQHByb3BlcnR5IHtzdHJpbmd9IGNlcnRDZXJ0T3JEaXJlY3RvcnlQYXRoIC0gQ2VydCBmaWxlIGNvbnRlbnRzIG9yIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIGNlcnRpZmljYXRlc1xuICogQHByb3BlcnR5IHtzdHJpbmd9IHRsc0NlcnQgLSBQYXRoIHRvIHRoZSBUTFMgY2VydGlmaWNhdGVcbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBwZWVyRW5kcG9pbnQgLSBFbmRwb2ludCBVUkwgZm9yIHRoZSBwZWVyXG4gKiBAcHJvcGVydHkge3N0cmluZ30gcGVlckhvc3RBbGlhcyAtIEhvc3QgYWxpYXMgZm9yIHRoZSBwZWVyXG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2FFbmRwb2ludCAtIEVuZHBvaW50IFVSTCBmb3IgdGhlIGNlcnRpZmljYXRlIGF1dGhvcml0eVxuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhVGxzQ2VydGlmaWNhdGUgLSBUTFMgY2VydGlmaWNhdGUgZm9yIHRoZSBjZXJ0aWZpY2F0ZSBhdXRob3JpdHlcbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBjYUNlcnQgLSBDZXJ0aWZpY2F0ZSBmb3IgdGhlIGNlcnRpZmljYXRlIGF1dGhvcml0eVxuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhS2V5IC0gS2V5IGZvciB0aGUgY2VydGlmaWNhdGUgYXV0aG9yaXR5XG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2hhaW5jb2RlTmFtZSAtIE5hbWUgb2YgdGhlIGNoYWluY29kZSB0byBpbnRlcmFjdCB3aXRoXG4gKiBAcHJvcGVydHkge3N0cmluZ30gW2NvbnRyYWN0TmFtZV0gLSBPcHRpb25hbCBuYW1lIG9mIHRoZSBzcGVjaWZpYyBjb250cmFjdCB3aXRoaW4gdGhlIGNoYWluY29kZVxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtjYV0gLSBPcHRpb25hbCBjZXJ0aWZpY2F0ZSBhdXRob3JpdHkgbmFtZVxuICogQHByb3BlcnR5IHtzdHJpbmd9IG1zcElkIC0gTWVtYmVyc2hpcCBTZXJ2aWNlIFByb3ZpZGVyIElEXG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2hhbm5lbCAtIENoYW5uZWwgbmFtZVxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgdHlwZSBQZWVyQ29uZmlnID0ge1xuICBjcnlwdG9QYXRoOiBzdHJpbmc7XG4gIGtleUNlcnRPckRpcmVjdG9yeVBhdGg6IHN0cmluZztcbiAgY2VydENlcnRPckRpcmVjdG9yeVBhdGg6IHN0cmluZztcbiAgdGxzQ2VydDogc3RyaW5nIHwgQnVmZmVyO1xuICBwZWVyRW5kcG9pbnQ6IHN0cmluZztcbiAgcGVlckhvc3RBbGlhczogc3RyaW5nO1xuICBjYUVuZHBvaW50Pzogc3RyaW5nO1xuICBjYVRsc0NlcnRpZmljYXRlPzogc3RyaW5nO1xuICBjYUNlcnQ/OiBzdHJpbmc7XG4gIGNhS2V5Pzogc3RyaW5nO1xuICBjaGFpbmNvZGVOYW1lOiBzdHJpbmc7XG4gIGNvbnRyYWN0TmFtZT86IHN0cmluZztcbiAgY2E/OiBzdHJpbmc7XG4gIG1zcElkOiBzdHJpbmc7XG4gIGNoYW5uZWw6IHN0cmluZztcbn07XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIEZsYWdzIGZvciBGYWJyaWMgb3BlcmF0aW9uc1xuICogQHN1bW1hcnkgQ29tYmluZXMgcmVwb3NpdG9yeSBmbGFncyB3aXRoIHBlZXIgY29uZmlndXJhdGlvbiBvdmVycmlkZXNcbiAqIEBpbnRlcmZhY2UgRmFicmljRmxhZ3NcbiAqIEBleHRlbmRzIHtSZXBvc2l0b3J5RmxhZ3N9XG4gKiBAbWVtYmVyT2YgbW9kdWxlOmZvci1mYWJyaWMuc2hhcmVkXG4gKi9cbmV4cG9ydCB0eXBlIEZhYnJpY0ZsYWdzID0gUmVwb3NpdG9yeUZsYWdzO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBDb25maWd1cmF0aW9uIGZvciBjb25uZWN0aW5nIHRvIGEgSHlwZXJsZWRnZXIgRmFicmljIHBlZXJcbiAqIEBzdW1tYXJ5IENvbnRhaW5zIGFsbCB0aGUgbmVjZXNzYXJ5IHBhcmFtZXRlcnMgdG8gZXN0YWJsaXNoIGEgY29ubmVjdGlvbiB0byBhIEZhYnJpYyBwZWVyIGFuZCBpbnRlcmFjdCB3aXRoIGNoYWluY29kZVxuICogQHR5cGVkZWYge09iamVjdH0gQ0FDb25maWdcbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSB1cmwgLSBQYXRoIHRvIHRoZSBjcnlwdG8gbWF0ZXJpYWxzXG4gKiBAcHJvcGVydHkge1RMU09wdGlvbnN9IHRscyAtIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIHByaXZhdGUga2V5c1xuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhTmFtZSAtIFBhdGggdG8gdGhlIGRpcmVjdG9yeSBjb250YWluaW5nIGNlcnRpZmljYXRlc1xuICogQHByb3BlcnR5IHtzdHJpbmd9IHRsc0NlcnRQYXRoIC0gUGF0aCB0byB0aGUgVExTIGNlcnRpZmljYXRlXG4gKiBAcHJvcGVydHkge3N0cmluZ30gY2FDZXJ0IC0gRW5kcG9pbnQgVVJMIGZvciB0aGUgcGVlclxuICogQHByb3BlcnR5IHtzdHJpbmd9IGNhS2V5IC0gSG9zdCBhbGlhcyBmb3IgdGhlIHBlZXJcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IHR5cGUgQ0FDb25maWcgPSB7XG4gIHVybDogc3RyaW5nO1xuICB0bHM/OiBUTFNPcHRpb25zO1xuICBjYU5hbWU6IHN0cmluZztcbiAgY2FDZXJ0OiBzdHJpbmc7XG4gIGNhS2V5OiBzdHJpbmc7XG59O1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBVc2VyIGNyZWRlbnRpYWxzIGZvciBDQSBlbnJvbGxtZW50IG9yIGFjY2Vzc1xuICogQHN1bW1hcnkgT3B0aW9uYWwgdXNlcm5hbWUvcGFzc3dvcmQgcGFpciB1c2VkIHdoZW4gZW5yb2xsaW5nIHdpdGggYSBGYWJyaWMgQ0Egb3IgYXV0aGVudGljYXRpbmcgaW4gY2xpZW50IHV0aWxpdGllc1xuICogQGludGVyZmFjZSBDcmVkZW50aWFsc1xuICogQHByb3BlcnR5IHtzdHJpbmd9IFt1c2VyTmFtZV0gLSBPcHRpb25hbCB1c2VybmFtZVxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtwYXNzd29yZF0gLSBPcHRpb25hbCBwYXNzd29yZFxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgaW50ZXJmYWNlIENyZWRlbnRpYWxzIHtcbiAgdXNlck5hbWU/OiBzdHJpbmc7XG4gIHBhc3N3b3JkPzogc3RyaW5nO1xufVxuIl19

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

@@ -0,0 +1,55 @@
+import { Identity, Signer } from "@hyperledger/fabric-gateway";
+import { User } from "fabric-common";
+/**
+ * @description Core utilities for interacting with files, crypto identities, and Fabric SDK helpers
+ * @summary Provides static helper methods to read credentials and keys from disk or raw content, construct Fabric gateway Identities and Signers, and perform common filesystem operations used by the Fabric client tooling.
+ * @class CoreUtils
+ * @example
+ * // Read an identity and signer from directories
+ * const identity = await CoreUtils.getIdentity('Org1MSP', '/msp/signcerts');
+ * const signer = await CoreUtils.getSigner('/msp/keystore');
+ * // Build a CA user
+ * const user = await CoreUtils.getCAUser('appUser', pemKey, pemCert, 'Org1MSP');
+ */
+export declare class CoreUtils {
+    private static logger;
+    private constructor();
+    /**
+     * @description Resolve file content from a path or return provided raw content
+     * @summary If the input is a Uint8Array or PEM content, returns it as-is; otherwise uses a provided async fileReader to load the content from disk.
+     * @param {string|Uint8Array} contentOrPath - Either a raw content buffer/string or a filesystem path
+     * @param {function(string): Promise<string|Uint8Array|Buffer>} fileReader - Async function to read file content when a path is provided
+     * @return {Promise<string|Uint8Array|Buffer>} The content to be used downstream
+     */
+    private static contentOfLoadFile;
+    /**
+     * @description Read file content from a path or return provided Buffer
+     * @summary Convenience wrapper that loads a file using fs.promises when a path string is provided; otherwise returns the given Buffer directly.
+     * @param {string|Buffer} contentOrPath - Path to a file on disk or an already-loaded Buffer
+     * @return {Promise<string|Uint8Array|Buffer>} The file content as a Buffer/string depending on reader
+     */
+    static readFile(contentOrPath: string | Buffer): Promise<Buffer<ArrayBufferLike>>;
+    /**
+     * @description Create a Fabric CA User object with enrollment
+     * @summary Constructs a fabric-common User, sets a crypto suite, imports the provided private key, and sets enrollment with certificate and MSP ID.
+     * @param {string} userName - The user name for the CA user
+     * @param {string} privateKey - PEM-encoded private key
+     * @param {string} certificate - PEM-encoded X.509 certificate
+     * @param {string} mspId - Membership Service Provider identifier
+     * @return {Promise<User>} The enrolled Fabric User instance
+     */
+    static getCAUser(userName: string, privateKey: string, certificate: string, mspId: string): Promise<User>;
+    /**
+     * @description Build a Fabric Gateway Identity from an MSP ID and certificate
+     * @summary Reads a certificate from a directory path or accepts raw content and returns an Identity object suitable for the Fabric Gateway.
+     * @param {string} mspId - Membership Service Provider ID
+     * @param {string} certDirectoryPath - Path to a directory containing the certificate file, or PEM content
+     * @return {Promise<Identity>} The identity containing mspId and certificate credentials
+     */
+    static getIdentity(mspId: string, certDirectoryPath: string): Promise<Identity>;
+    static getFirstDirFileName(dirPath: string): Promise<string>;
+    static getFirstDirFileNameContent(dirPath: string): Promise<string>;
+    static getFileContent(filePath: string): Promise<string>;
+    static getSigner(keyDirectoryPath: string): Promise<Signer>;
+    private static extractPrivateKey;
+}