@decaf-ts/for-fabric 0.0.2

package/lib/esm/shared/erc20/erc20-constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Enum representing the events emitted by an ERC20 contract.
+ *
+ * @remarks
+ * This enum is used to identify the specific events that can be emitted by an ERC20 contract.
+ * The events are named according to the EIP-20 standard.
+ */
+export declare enum ERC20Events {
+    /**
+     * Emitted when a `transfer` function is called successfully.
+     *
+     * @param from - The address of the sender.
+     * @param to - The address of the recipient.
+     * @param value - The amount of tokens transferred.
+     */
+    TRANSFER = " Transfer",
+    /**
+     * Emitted when an `approve` function is called successfully.
+     *
+     * @param owner - The address of the token owner.
+     * @param spender - The address of the approved spender.
+     * @param value - The amount of tokens approved for the spender.
+     */
+    APPROVAL = "Approval"
+}

package/lib/esm/shared/erc20/erc20-constants.js

@@ -0,0 +1,27 @@
+/**
+ * Enum representing the events emitted by an ERC20 contract.
+ *
+ * @remarks
+ * This enum is used to identify the specific events that can be emitted by an ERC20 contract.
+ * The events are named according to the EIP-20 standard.
+ */
+export var ERC20Events;
+(function (ERC20Events) {
+    /**
+     * Emitted when a `transfer` function is called successfully.
+     *
+     * @param from - The address of the sender.
+     * @param to - The address of the recipient.
+     * @param value - The amount of tokens transferred.
+     */
+    ERC20Events["TRANSFER"] = " Transfer";
+    /**
+     * Emitted when an `approve` function is called successfully.
+     *
+     * @param owner - The address of the token owner.
+     * @param spender - The address of the approved spender.
+     * @param value - The amount of tokens approved for the spender.
+     */
+    ERC20Events["APPROVAL"] = "Approval";
+})(ERC20Events || (ERC20Events = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJjMjAtY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3NoYXJlZC9lcmMyMC9lcmMyMC1jb25zdGFudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7OztHQU1HO0FBQ0gsTUFBTSxDQUFOLElBQVksV0FrQlg7QUFsQkQsV0FBWSxXQUFXO0lBQ3JCOzs7Ozs7T0FNRztJQUNILHFDQUFzQixDQUFBO0lBRXRCOzs7Ozs7T0FNRztJQUNILG9DQUFxQixDQUFBO0FBQ3ZCLENBQUMsRUFsQlcsV0FBVyxLQUFYLFdBQVcsUUFrQnRCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBFbnVtIHJlcHJlc2VudGluZyB0aGUgZXZlbnRzIGVtaXR0ZWQgYnkgYW4gRVJDMjAgY29udHJhY3QuXG4gKlxuICogQHJlbWFya3NcbiAqIFRoaXMgZW51bSBpcyB1c2VkIHRvIGlkZW50aWZ5IHRoZSBzcGVjaWZpYyBldmVudHMgdGhhdCBjYW4gYmUgZW1pdHRlZCBieSBhbiBFUkMyMCBjb250cmFjdC5cbiAqIFRoZSBldmVudHMgYXJlIG5hbWVkIGFjY29yZGluZyB0byB0aGUgRUlQLTIwIHN0YW5kYXJkLlxuICovXG5leHBvcnQgZW51bSBFUkMyMEV2ZW50cyB7XG4gIC8qKlxuICAgKiBFbWl0dGVkIHdoZW4gYSBgdHJhbnNmZXJgIGZ1bmN0aW9uIGlzIGNhbGxlZCBzdWNjZXNzZnVsbHkuXG4gICAqXG4gICAqIEBwYXJhbSBmcm9tIC0gVGhlIGFkZHJlc3Mgb2YgdGhlIHNlbmRlci5cbiAgICogQHBhcmFtIHRvIC0gVGhlIGFkZHJlc3Mgb2YgdGhlIHJlY2lwaWVudC5cbiAgICogQHBhcmFtIHZhbHVlIC0gVGhlIGFtb3VudCBvZiB0b2tlbnMgdHJhbnNmZXJyZWQuXG4gICAqL1xuICBUUkFOU0ZFUiA9IFwiIFRyYW5zZmVyXCIsXG5cbiAgLyoqXG4gICAqIEVtaXR0ZWQgd2hlbiBhbiBgYXBwcm92ZWAgZnVuY3Rpb24gaXMgY2FsbGVkIHN1Y2Nlc3NmdWxseS5cbiAgICpcbiAgICogQHBhcmFtIG93bmVyIC0gVGhlIGFkZHJlc3Mgb2YgdGhlIHRva2VuIG93bmVyLlxuICAgKiBAcGFyYW0gc3BlbmRlciAtIFRoZSBhZGRyZXNzIG9mIHRoZSBhcHByb3ZlZCBzcGVuZGVyLlxuICAgKiBAcGFyYW0gdmFsdWUgLSBUaGUgYW1vdW50IG9mIHRva2VucyBhcHByb3ZlZCBmb3IgdGhlIHNwZW5kZXIuXG4gICAqL1xuICBBUFBST1ZBTCA9IFwiQXBwcm92YWxcIixcbn1cbiJdfQ==

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

@@ -0,0 +1,116 @@
+import { BaseError, InternalError } from "@decaf-ts/db-decorators";
+import { AuthorizationError } from "@decaf-ts/core";
+/**
+ * @summary Represents an overflow error in arithmetic operations in Smart Contracts
+ *
+ * @param {string} msg the error message
+ *
+ * @class OverflowError
+ * @extends InternalError
+ *
+ * @category Errors
+ */
+export declare class OverflowError extends InternalError {
+    constructor(msg: string | Error);
+}
+/**
+ * @summary Represents a failure in balance to perform a transaction in Smart Contracts
+ *
+ * @param {string} msg the error message
+ *
+ * @class BalanceError
+ * @extends InternalError
+ *
+ * @category Errors
+ */
+export declare class BalanceError extends InternalError {
+    constructor(msg: string | Error);
+}
+/**
+ * @summary Represents a failure in balance to perform a transaction in Smart Contracts
+ *
+ * @param {string} msg the error message
+ *
+ * @class BalanceError
+ * @extends InternalError
+ *
+ * @category Errors
+ */
+export declare class AllowanceError extends InternalError {
+    constructor(msg: string | Error);
+}
+/**
+ * @summary Represents a failure registrating new entities
+ *
+ * @param {string} msg the error message
+ *
+ * @class RegistrationError
+ *
+ * @categort Errors
+ */
+export declare class RegistrationError extends AuthorizationError {
+    constructor(msg: string | Error);
+}
+/**
+ * @description Error thrown when an unsupported operation is attempted
+ * @summary This error is thrown when an operation is requested that is not supported by the current
+ * persistence adapter or configuration. It extends the BaseError class and sets a 500 status code.
+ * @param {string|Error} msg - The error message or an Error object to wrap
+ * @class UnsupportedError
+ * @example
+ * ```typescript
+ * // Throwing an UnsupportedError
+ * if (!adapter.supportsTransactions()) {
+ *   throw new UnsupportedError('Transactions are not supported by this adapter');
+ * }
+ *
+ * // Catching an UnsupportedError
+ * try {
+ *   await adapter.beginTransaction();
+ * } catch (error) {
+ *   if (error instanceof UnsupportedError) {
+ *     console.error('Operation not supported:', error.message);
+ *   }
+ * }
+ * ```
+ *
+ * @category Errors
+ */
+export declare class MissingContextError extends InternalError {
+    constructor(msg: string | Error);
+}
+export declare class UnauthorizedPrivateDataAccess extends BaseError {
+    constructor(msg?: string | Error);
+}
+/**
+ * Represents an error that occurs when a required initialization step is not performed.
+ *
+ * @class NotInitializedError
+ * @extends BaseError
+ *
+ * @category Errors
+ *
+ * @param {string | Error} msg - The error message or an Error object to wrap.
+ *
+ * @throws {NotInitializedError} - Throws an error when a required initialization step is not performed.
+ *
+ * @example
+ * ```typescript
+ * // Initialize the application
+ * if (!isInitialized) {
+ *   throw new NotInitializedError('Application is not initialized');
+ * }
+ *
+ * // Catching an NotInitializedError
+ * try {
+ *   // Perform operations that require initialization
+ * } catch (error) {
+ *   if (error instanceof NotInitializedError) {
+ *     console.error('Initialization error:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class NotInitializedError extends BaseError {
+    constructor(msg: string | Error);
+}

package/lib/esm/shared/errors.js

@@ -0,0 +1,132 @@
+import { BaseError, InternalError } from "@decaf-ts/db-decorators";
+import { AuthorizationError } from "@decaf-ts/core";
+import { MISSING_PRIVATE_DATA_ERROR_MESSAGE } from "./../contracts/private-data.js";
+/**
+ * @summary Represents an overflow error in arithmetic operations in Smart Contracts
+ *
+ * @param {string} msg the error message
+ *
+ * @class OverflowError
+ * @extends InternalError
+ *
+ * @category Errors
+ */
+export class OverflowError extends InternalError {
+    constructor(msg) {
+        super(msg, OverflowError.name);
+    }
+}
+/**
+ * @summary Represents a failure in balance to perform a transaction in Smart Contracts
+ *
+ * @param {string} msg the error message
+ *
+ * @class BalanceError
+ * @extends InternalError
+ *
+ * @category Errors
+ */
+export class BalanceError extends InternalError {
+    constructor(msg) {
+        super(msg, BalanceError.name);
+    }
+}
+/**
+ * @summary Represents a failure in balance to perform a transaction in Smart Contracts
+ *
+ * @param {string} msg the error message
+ *
+ * @class BalanceError
+ * @extends InternalError
+ *
+ * @category Errors
+ */
+export class AllowanceError extends InternalError {
+    constructor(msg) {
+        super(msg, AllowanceError.name);
+    }
+}
+/**
+ * @summary Represents a failure registrating new entities
+ *
+ * @param {string} msg the error message
+ *
+ * @class RegistrationError
+ *
+ * @categort Errors
+ */
+export class RegistrationError extends AuthorizationError {
+    constructor(msg) {
+        super(msg, RegistrationError.name);
+    }
+}
+/**
+ * @description Error thrown when an unsupported operation is attempted
+ * @summary This error is thrown when an operation is requested that is not supported by the current
+ * persistence adapter or configuration. It extends the BaseError class and sets a 500 status code.
+ * @param {string|Error} msg - The error message or an Error object to wrap
+ * @class UnsupportedError
+ * @example
+ * ```typescript
+ * // Throwing an UnsupportedError
+ * if (!adapter.supportsTransactions()) {
+ *   throw new UnsupportedError('Transactions are not supported by this adapter');
+ * }
+ *
+ * // Catching an UnsupportedError
+ * try {
+ *   await adapter.beginTransaction();
+ * } catch (error) {
+ *   if (error instanceof UnsupportedError) {
+ *     console.error('Operation not supported:', error.message);
+ *   }
+ * }
+ * ```
+ *
+ * @category Errors
+ */
+export class MissingContextError extends InternalError {
+    constructor(msg) {
+        super(msg, MissingContextError.name, 500);
+    }
+}
+export class UnauthorizedPrivateDataAccess extends BaseError {
+    constructor(msg = MISSING_PRIVATE_DATA_ERROR_MESSAGE) {
+        super(UnauthorizedPrivateDataAccess.name, msg, 403);
+    }
+}
+/**
+ * Represents an error that occurs when a required initialization step is not performed.
+ *
+ * @class NotInitializedError
+ * @extends BaseError
+ *
+ * @category Errors
+ *
+ * @param {string | Error} msg - The error message or an Error object to wrap.
+ *
+ * @throws {NotInitializedError} - Throws an error when a required initialization step is not performed.
+ *
+ * @example
+ * ```typescript
+ * // Initialize the application
+ * if (!isInitialized) {
+ *   throw new NotInitializedError('Application is not initialized');
+ * }
+ *
+ * // Catching an NotInitializedError
+ * try {
+ *   // Perform operations that require initialization
+ * } catch (error) {
+ *   if (error instanceof NotInitializedError) {
+ *     console.error('Initialization error:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export class NotInitializedError extends BaseError {
+    constructor(msg) {
+        super(NotInitializedError.name, msg, 409);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NoYXJlZC9lcnJvcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFNBQVMsRUFBRSxhQUFhLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNuRSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNwRCxPQUFPLEVBQUUsa0NBQWtDLEVBQUUsdUNBQWtDO0FBQy9FOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sT0FBTyxhQUFjLFNBQVEsYUFBYTtJQUM5QyxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsYUFBYSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ2pDLENBQUM7Q0FDRjtBQUVEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sT0FBTyxZQUFhLFNBQVEsYUFBYTtJQUM3QyxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsWUFBWSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ2hDLENBQUM7Q0FDRjtBQUVEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sT0FBTyxjQUFlLFNBQVEsYUFBYTtJQUMvQyxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsY0FBYyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ2xDLENBQUM7Q0FDRjtBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsTUFBTSxPQUFPLGlCQUFrQixTQUFRLGtCQUFrQjtJQUN2RCxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsaUJBQWlCLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDckMsQ0FBQztDQUNGO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXdCRztBQUNILE1BQU0sT0FBTyxtQkFBb0IsU0FBUSxhQUFhO0lBQ3BELFlBQVksR0FBbUI7UUFDN0IsS0FBSyxDQUFDLEdBQUcsRUFBRSxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDNUMsQ0FBQztDQUNGO0FBRUQsTUFBTSxPQUFPLDZCQUE4QixTQUFRLFNBQVM7SUFDMUQsWUFBWSxNQUFzQixrQ0FBa0M7UUFDbEUsS0FBSyxDQUFDLDZCQUE2QixDQUFDLElBQUksRUFBRSxHQUFHLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDdEQsQ0FBQztDQUNGO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E0Qkc7QUFDSCxNQUFNLE9BQU8sbUJBQW9CLFNBQVEsU0FBUztJQUNoRCxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsR0FBRyxFQUFFLEdBQUcsQ0FBQyxDQUFDO0lBQzVDLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEJhc2VFcnJvciwgSW50ZXJuYWxFcnJvciB9IGZyb20gXCJAZGVjYWYtdHMvZGItZGVjb3JhdG9yc1wiO1xuaW1wb3J0IHsgQXV0aG9yaXphdGlvbkVycm9yIH0gZnJvbSBcIkBkZWNhZi10cy9jb3JlXCI7XG5pbXBvcnQgeyBNSVNTSU5HX1BSSVZBVEVfREFUQV9FUlJPUl9NRVNTQUdFIH0gZnJvbSBcIi4uL2NvbnRyYWN0cy9wcml2YXRlLWRhdGFcIjtcbi8qKlxuICogQHN1bW1hcnkgUmVwcmVzZW50cyBhbiBvdmVyZmxvdyBlcnJvciBpbiBhcml0aG1ldGljIG9wZXJhdGlvbnMgaW4gU21hcnQgQ29udHJhY3RzXG4gKlxuICogQHBhcmFtIHtzdHJpbmd9IG1zZyB0aGUgZXJyb3IgbWVzc2FnZVxuICpcbiAqIEBjbGFzcyBPdmVyZmxvd0Vycm9yXG4gKiBAZXh0ZW5kcyBJbnRlcm5hbEVycm9yXG4gKlxuICogQGNhdGVnb3J5IEVycm9yc1xuICovXG5leHBvcnQgY2xhc3MgT3ZlcmZsb3dFcnJvciBleHRlbmRzIEludGVybmFsRXJyb3Ige1xuICBjb25zdHJ1Y3Rvcihtc2c6IHN0cmluZyB8IEVycm9yKSB7XG4gICAgc3VwZXIobXNnLCBPdmVyZmxvd0Vycm9yLm5hbWUpO1xuICB9XG59XG5cbi8qKlxuICogQHN1bW1hcnkgUmVwcmVzZW50cyBhIGZhaWx1cmUgaW4gYmFsYW5jZSB0byBwZXJmb3JtIGEgdHJhbnNhY3Rpb24gaW4gU21hcnQgQ29udHJhY3RzXG4gKlxuICogQHBhcmFtIHtzdHJpbmd9IG1zZyB0aGUgZXJyb3IgbWVzc2FnZVxuICpcbiAqIEBjbGFzcyBCYWxhbmNlRXJyb3JcbiAqIEBleHRlbmRzIEludGVybmFsRXJyb3JcbiAqXG4gKiBAY2F0ZWdvcnkgRXJyb3JzXG4gKi9cbmV4cG9ydCBjbGFzcyBCYWxhbmNlRXJyb3IgZXh0ZW5kcyBJbnRlcm5hbEVycm9yIHtcbiAgY29uc3RydWN0b3IobXNnOiBzdHJpbmcgfCBFcnJvcikge1xuICAgIHN1cGVyKG1zZywgQmFsYW5jZUVycm9yLm5hbWUpO1xuICB9XG59XG5cbi8qKlxuICogQHN1bW1hcnkgUmVwcmVzZW50cyBhIGZhaWx1cmUgaW4gYmFsYW5jZSB0byBwZXJmb3JtIGEgdHJhbnNhY3Rpb24gaW4gU21hcnQgQ29udHJhY3RzXG4gKlxuICogQHBhcmFtIHtzdHJpbmd9IG1zZyB0aGUgZXJyb3IgbWVzc2FnZVxuICpcbiAqIEBjbGFzcyBCYWxhbmNlRXJyb3JcbiAqIEBleHRlbmRzIEludGVybmFsRXJyb3JcbiAqXG4gKiBAY2F0ZWdvcnkgRXJyb3JzXG4gKi9cbmV4cG9ydCBjbGFzcyBBbGxvd2FuY2VFcnJvciBleHRlbmRzIEludGVybmFsRXJyb3Ige1xuICBjb25zdHJ1Y3Rvcihtc2c6IHN0cmluZyB8IEVycm9yKSB7XG4gICAgc3VwZXIobXNnLCBBbGxvd2FuY2VFcnJvci5uYW1lKTtcbiAgfVxufVxuXG4vKipcbiAqIEBzdW1tYXJ5IFJlcHJlc2VudHMgYSBmYWlsdXJlIHJlZ2lzdHJhdGluZyBuZXcgZW50aXRpZXNcbiAqXG4gKiBAcGFyYW0ge3N0cmluZ30gbXNnIHRoZSBlcnJvciBtZXNzYWdlXG4gKlxuICogQGNsYXNzIFJlZ2lzdHJhdGlvbkVycm9yXG4gKlxuICogQGNhdGVnb3J0IEVycm9yc1xuICovXG5leHBvcnQgY2xhc3MgUmVnaXN0cmF0aW9uRXJyb3IgZXh0ZW5kcyBBdXRob3JpemF0aW9uRXJyb3Ige1xuICBjb25zdHJ1Y3Rvcihtc2c6IHN0cmluZyB8IEVycm9yKSB7XG4gICAgc3VwZXIobXNnLCBSZWdpc3RyYXRpb25FcnJvci5uYW1lKTtcbiAgfVxufVxuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBFcnJvciB0aHJvd24gd2hlbiBhbiB1bnN1cHBvcnRlZCBvcGVyYXRpb24gaXMgYXR0ZW1wdGVkXG4gKiBAc3VtbWFyeSBUaGlzIGVycm9yIGlzIHRocm93biB3aGVuIGFuIG9wZXJhdGlvbiBpcyByZXF1ZXN0ZWQgdGhhdCBpcyBub3Qgc3VwcG9ydGVkIGJ5IHRoZSBjdXJyZW50XG4gKiBwZXJzaXN0ZW5jZSBhZGFwdGVyIG9yIGNvbmZpZ3VyYXRpb24uIEl0IGV4dGVuZHMgdGhlIEJhc2VFcnJvciBjbGFzcyBhbmQgc2V0cyBhIDUwMCBzdGF0dXMgY29kZS5cbiAqIEBwYXJhbSB7c3RyaW5nfEVycm9yfSBtc2cgLSBUaGUgZXJyb3IgbWVzc2FnZSBvciBhbiBFcnJvciBvYmplY3QgdG8gd3JhcFxuICogQGNsYXNzIFVuc3VwcG9ydGVkRXJyb3JcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiAvLyBUaHJvd2luZyBhbiBVbnN1cHBvcnRlZEVycm9yXG4gKiBpZiAoIWFkYXB0ZXIuc3VwcG9ydHNUcmFuc2FjdGlvbnMoKSkge1xuICogICB0aHJvdyBuZXcgVW5zdXBwb3J0ZWRFcnJvcignVHJhbnNhY3Rpb25zIGFyZSBub3Qgc3VwcG9ydGVkIGJ5IHRoaXMgYWRhcHRlcicpO1xuICogfVxuICpcbiAqIC8vIENhdGNoaW5nIGFuIFVuc3VwcG9ydGVkRXJyb3JcbiAqIHRyeSB7XG4gKiAgIGF3YWl0IGFkYXB0ZXIuYmVnaW5UcmFuc2FjdGlvbigpO1xuICogfSBjYXRjaCAoZXJyb3IpIHtcbiAqICAgaWYgKGVycm9yIGluc3RhbmNlb2YgVW5zdXBwb3J0ZWRFcnJvcikge1xuICogICAgIGNvbnNvbGUuZXJyb3IoJ09wZXJhdGlvbiBub3Qgc3VwcG9ydGVkOicsIGVycm9yLm1lc3NhZ2UpO1xuICogICB9XG4gKiB9XG4gKiBgYGBcbiAqXG4gKiBAY2F0ZWdvcnkgRXJyb3JzXG4gKi9cbmV4cG9ydCBjbGFzcyBNaXNzaW5nQ29udGV4dEVycm9yIGV4dGVuZHMgSW50ZXJuYWxFcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1zZzogc3RyaW5nIHwgRXJyb3IpIHtcbiAgICBzdXBlcihtc2csIE1pc3NpbmdDb250ZXh0RXJyb3IubmFtZSwgNTAwKTtcbiAgfVxufVxuXG5leHBvcnQgY2xhc3MgVW5hdXRob3JpemVkUHJpdmF0ZURhdGFBY2Nlc3MgZXh0ZW5kcyBCYXNlRXJyb3Ige1xuICBjb25zdHJ1Y3Rvcihtc2c6IHN0cmluZyB8IEVycm9yID0gTUlTU0lOR19QUklWQVRFX0RBVEFfRVJST1JfTUVTU0FHRSkge1xuICAgIHN1cGVyKFVuYXV0aG9yaXplZFByaXZhdGVEYXRhQWNjZXNzLm5hbWUsIG1zZywgNDAzKTtcbiAgfVxufVxuXG4vKipcbiAqIFJlcHJlc2VudHMgYW4gZXJyb3IgdGhhdCBvY2N1cnMgd2hlbiBhIHJlcXVpcmVkIGluaXRpYWxpemF0aW9uIHN0ZXAgaXMgbm90IHBlcmZvcm1lZC5cbiAqXG4gKiBAY2xhc3MgTm90SW5pdGlhbGl6ZWRFcnJvclxuICogQGV4dGVuZHMgQmFzZUVycm9yXG4gKlxuICogQGNhdGVnb3J5IEVycm9yc1xuICpcbiAqIEBwYXJhbSB7c3RyaW5nIHwgRXJyb3J9IG1zZyAtIFRoZSBlcnJvciBtZXNzYWdlIG9yIGFuIEVycm9yIG9iamVjdCB0byB3cmFwLlxuICpcbiAqIEB0aHJvd3Mge05vdEluaXRpYWxpemVkRXJyb3J9IC0gVGhyb3dzIGFuIGVycm9yIHdoZW4gYSByZXF1aXJlZCBpbml0aWFsaXphdGlvbiBzdGVwIGlzIG5vdCBwZXJmb3JtZWQuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIC8vIEluaXRpYWxpemUgdGhlIGFwcGxpY2F0aW9uXG4gKiBpZiAoIWlzSW5pdGlhbGl6ZWQpIHtcbiAqICAgdGhyb3cgbmV3IE5vdEluaXRpYWxpemVkRXJyb3IoJ0FwcGxpY2F0aW9uIGlzIG5vdCBpbml0aWFsaXplZCcpO1xuICogfVxuICpcbiAqIC8vIENhdGNoaW5nIGFuIE5vdEluaXRpYWxpemVkRXJyb3JcbiAqIHRyeSB7XG4gKiAgIC8vIFBlcmZvcm0gb3BlcmF0aW9ucyB0aGF0IHJlcXVpcmUgaW5pdGlhbGl6YXRpb25cbiAqIH0gY2F0Y2ggKGVycm9yKSB7XG4gKiAgIGlmIChlcnJvciBpbnN0YW5jZW9mIE5vdEluaXRpYWxpemVkRXJyb3IpIHtcbiAqICAgICBjb25zb2xlLmVycm9yKCdJbml0aWFsaXphdGlvbiBlcnJvcjonLCBlcnJvci5tZXNzYWdlKTtcbiAqICAgfVxuICogfVxuICogYGBgXG4gKi9cbmV4cG9ydCBjbGFzcyBOb3RJbml0aWFsaXplZEVycm9yIGV4dGVuZHMgQmFzZUVycm9yIHtcbiAgY29uc3RydWN0b3IobXNnOiBzdHJpbmcgfCBFcnJvcikge1xuICAgIHN1cGVyKE5vdEluaXRpYWxpemVkRXJyb3IubmFtZSwgbXNnLCA0MDkpO1xuICB9XG59XG4iXX0=

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

@@ -0,0 +1,39 @@
+import { BulkCrudOperationKeys, OperationKeys } from "@decaf-ts/db-decorators";
+/**
+ * @description Generates a Fabric event name from components
+ * @summary Creates a standardized event name by joining table, event, and optional owner with underscores
+ * @param {string} table - The table/collection name
+ * @param {OperationKeys | BulkCrudOperationKeys | string} event - The event type
+ * @param {string} [owner] - Optional owner identifier
+ * @return {string} The generated event name in format "table_event" or "table_event_owner"
+ * @function generateFabricEventName
+ * @memberOf module:for-fabric.shared
+ */
+export declare function generateFabricEventName(table: string, event: OperationKeys | BulkCrudOperationKeys | string, owner?: string): string;
+/**
+ * @description Parses a Fabric event name into its components
+ * @summary Splits an event name by underscores and extracts table, event, and optional owner
+ * @param {string} name - The event name to parse
+ * @return {{table: string, event: OperationKeys | BulkCrudOperationKeys | string, owner: string}} The parsed components as a structured object
+ * @throws {InternalError} If the event name format is invalid
+ * @function parseEventName
+ * @mermaid
+ * sequenceDiagram
+ *   participant Caller
+ *   participant Parser as parseEventName
+ *   Caller->>Parser: parseEventName(name)
+ *   Parser->>Parser: split name by "_"
+ *   alt parts length invalid
+ *     Parser-->>Caller: throw InternalError
+ *   else
+ *     Parser-->>Caller: { table, event, owner? }
+ *   end
+ * @memberOf module:for-fabric.shared
+ */
+export declare function parseEventName(name: string): {
+    table: string;
+    event: OperationKeys | BulkCrudOperationKeys | string;
+    owner?: string;
+} | {
+    event: string;
+};

package/lib/esm/shared/events.js

@@ -0,0 +1,47 @@
+/**
+ * @description Generates a Fabric event name from components
+ * @summary Creates a standardized event name by joining table, event, and optional owner with underscores
+ * @param {string} table - The table/collection name
+ * @param {OperationKeys | BulkCrudOperationKeys | string} event - The event type
+ * @param {string} [owner] - Optional owner identifier
+ * @return {string} The generated event name in format "table_event" or "table_event_owner"
+ * @function generateFabricEventName
+ * @memberOf module:for-fabric.shared
+ */
+export function generateFabricEventName(table, event, owner) {
+    const params = [table, event];
+    if (owner)
+        params.push(owner);
+    return params.join("_");
+}
+/**
+ * @description Parses a Fabric event name into its components
+ * @summary Splits an event name by underscores and extracts table, event, and optional owner
+ * @param {string} name - The event name to parse
+ * @return {{table: string, event: OperationKeys | BulkCrudOperationKeys | string, owner: string}} The parsed components as a structured object
+ * @throws {InternalError} If the event name format is invalid
+ * @function parseEventName
+ * @mermaid
+ * sequenceDiagram
+ *   participant Caller
+ *   participant Parser as parseEventName
+ *   Caller->>Parser: parseEventName(name)
+ *   Parser->>Parser: split name by "_"
+ *   alt parts length invalid
+ *     Parser-->>Caller: throw InternalError
+ *   else
+ *     Parser-->>Caller: { table, event, owner? }
+ *   end
+ * @memberOf module:for-fabric.shared
+ */
+export function parseEventName(name) {
+    const parts = name.split("_");
+    if (parts.length < 2 || parts.length > 3)
+        return { event: name };
+    return {
+        table: parts[0],
+        event: parts[1],
+        owner: parts[2],
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXZlbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NoYXJlZC9ldmVudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBT0E7Ozs7Ozs7OztHQVNHO0FBQ0gsTUFBTSxVQUFVLHVCQUF1QixDQUNyQyxLQUFhLEVBQ2IsS0FBcUQsRUFDckQsS0FBYztJQUVkLE1BQU0sTUFBTSxHQUFHLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDO0lBQzlCLElBQUksS0FBSztRQUFFLE1BQU0sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDOUIsT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0FBQzFCLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNILE1BQU0sVUFBVSxjQUFjLENBQUMsSUFBWTtJQUN6QyxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzlCLElBQUksS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLElBQUksS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDO1FBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQztJQUNqRSxPQUFPO1FBQ0wsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUM7UUFDZixLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUMsQ0FBQztRQUNmLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDO0tBS2hCLENBQUM7QUFDSixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHtcbiAgQnVsa0NydWRPcGVyYXRpb25LZXlzLFxuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVudXNlZC12YXJzXG4gIEludGVybmFsRXJyb3IsXG4gIE9wZXJhdGlvbktleXMsXG59IGZyb20gXCJAZGVjYWYtdHMvZGItZGVjb3JhdG9yc1wiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBHZW5lcmF0ZXMgYSBGYWJyaWMgZXZlbnQgbmFtZSBmcm9tIGNvbXBvbmVudHNcbiAqIEBzdW1tYXJ5IENyZWF0ZXMgYSBzdGFuZGFyZGl6ZWQgZXZlbnQgbmFtZSBieSBqb2luaW5nIHRhYmxlLCBldmVudCwgYW5kIG9wdGlvbmFsIG93bmVyIHdpdGggdW5kZXJzY29yZXNcbiAqIEBwYXJhbSB7c3RyaW5nfSB0YWJsZSAtIFRoZSB0YWJsZS9jb2xsZWN0aW9uIG5hbWVcbiAqIEBwYXJhbSB7T3BlcmF0aW9uS2V5cyB8IEJ1bGtDcnVkT3BlcmF0aW9uS2V5cyB8IHN0cmluZ30gZXZlbnQgLSBUaGUgZXZlbnQgdHlwZVxuICogQHBhcmFtIHtzdHJpbmd9IFtvd25lcl0gLSBPcHRpb25hbCBvd25lciBpZGVudGlmaWVyXG4gKiBAcmV0dXJuIHtzdHJpbmd9IFRoZSBnZW5lcmF0ZWQgZXZlbnQgbmFtZSBpbiBmb3JtYXQgXCJ0YWJsZV9ldmVudFwiIG9yIFwidGFibGVfZXZlbnRfb3duZXJcIlxuICogQGZ1bmN0aW9uIGdlbmVyYXRlRmFicmljRXZlbnROYW1lXG4gKiBAbWVtYmVyT2YgbW9kdWxlOmZvci1mYWJyaWMuc2hhcmVkXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZW5lcmF0ZUZhYnJpY0V2ZW50TmFtZShcbiAgdGFibGU6IHN0cmluZyxcbiAgZXZlbnQ6IE9wZXJhdGlvbktleXMgfCBCdWxrQ3J1ZE9wZXJhdGlvbktleXMgfCBzdHJpbmcsXG4gIG93bmVyPzogc3RyaW5nXG4pIHtcbiAgY29uc3QgcGFyYW1zID0gW3RhYmxlLCBldmVudF07XG4gIGlmIChvd25lcikgcGFyYW1zLnB1c2gob3duZXIpO1xuICByZXR1cm4gcGFyYW1zLmpvaW4oXCJfXCIpO1xufVxuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBQYXJzZXMgYSBGYWJyaWMgZXZlbnQgbmFtZSBpbnRvIGl0cyBjb21wb25lbnRzXG4gKiBAc3VtbWFyeSBTcGxpdHMgYW4gZXZlbnQgbmFtZSBieSB1bmRlcnNjb3JlcyBhbmQgZXh0cmFjdHMgdGFibGUsIGV2ZW50LCBhbmQgb3B0aW9uYWwgb3duZXJcbiAqIEBwYXJhbSB7c3RyaW5nfSBuYW1lIC0gVGhlIGV2ZW50IG5hbWUgdG8gcGFyc2VcbiAqIEByZXR1cm4ge3t0YWJsZTogc3RyaW5nLCBldmVudDogT3BlcmF0aW9uS2V5cyB8IEJ1bGtDcnVkT3BlcmF0aW9uS2V5cyB8IHN0cmluZywgb3duZXI6IHN0cmluZ319IFRoZSBwYXJzZWQgY29tcG9uZW50cyBhcyBhIHN0cnVjdHVyZWQgb2JqZWN0XG4gKiBAdGhyb3dzIHtJbnRlcm5hbEVycm9yfSBJZiB0aGUgZXZlbnQgbmFtZSBmb3JtYXQgaXMgaW52YWxpZFxuICogQGZ1bmN0aW9uIHBhcnNlRXZlbnROYW1lXG4gKiBAbWVybWFpZFxuICogc2VxdWVuY2VEaWFncmFtXG4gKiAgIHBhcnRpY2lwYW50IENhbGxlclxuICogICBwYXJ0aWNpcGFudCBQYXJzZXIgYXMgcGFyc2VFdmVudE5hbWVcbiAqICAgQ2FsbGVyLT4+UGFyc2VyOiBwYXJzZUV2ZW50TmFtZShuYW1lKVxuICogICBQYXJzZXItPj5QYXJzZXI6IHNwbGl0IG5hbWUgYnkgXCJfXCJcbiAqICAgYWx0IHBhcnRzIGxlbmd0aCBpbnZhbGlkXG4gKiAgICAgUGFyc2VyLS0+PkNhbGxlcjogdGhyb3cgSW50ZXJuYWxFcnJvclxuICogICBlbHNlXG4gKiAgICAgUGFyc2VyLS0+PkNhbGxlcjogeyB0YWJsZSwgZXZlbnQsIG93bmVyPyB9XG4gKiAgIGVuZFxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VFdmVudE5hbWUobmFtZTogc3RyaW5nKSB7XG4gIGNvbnN0IHBhcnRzID0gbmFtZS5zcGxpdChcIl9cIik7XG4gIGlmIChwYXJ0cy5sZW5ndGggPCAyIHx8IHBhcnRzLmxlbmd0aCA+IDMpIHJldHVybiB7IGV2ZW50OiBuYW1lIH07XG4gIHJldHVybiB7XG4gICAgdGFibGU6IHBhcnRzWzBdLFxuICAgIGV2ZW50OiBwYXJ0c1sxXSxcbiAgICBvd25lcjogcGFydHNbMl0sXG4gIH0gYXMge1xuICAgIHRhYmxlOiBzdHJpbmc7XG4gICAgZXZlbnQ6IE9wZXJhdGlvbktleXMgfCBCdWxrQ3J1ZE9wZXJhdGlvbktleXMgfCBzdHJpbmc7XG4gICAgb3duZXI/OiBzdHJpbmc7XG4gIH07XG59XG4iXX0=

package/lib/esm/shared/fabric-types.d.ts

@@ -0,0 +1,33 @@
+import "reflect-metadata";
+export type GetCertificatesRequest = {
+    id?: string;
+    aki?: string;
+    serial?: string;
+    revoked_start?: string;
+    revoked_end?: string;
+    expired_start?: string;
+    expired_end?: string;
+    notrevoked?: boolean;
+    notexpired?: boolean;
+    ca?: string;
+};
+export type CertificateResponse = {
+    caname: string;
+    certs: {
+        PEM: string;
+    }[];
+};
+export type FabricIdentity = {
+    id: string;
+    type: string;
+    affiliation: string;
+    attrs: {
+        name: string;
+        value: string;
+    }[];
+    max_enrollments: number;
+};
+export type IdentityResponse = {
+    caname: string;
+    identities: FabricIdentity[];
+};

package/lib/esm/shared/fabric-types.js

@@ -0,0 +1,2 @@
+import "reflect-metadata";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFicmljLXR5cGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NoYXJlZC9mYWJyaWMtdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxrQkFBa0IsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBcInJlZmxlY3QtbWV0YWRhdGFcIjtcblxuZXhwb3J0IHR5cGUgR2V0Q2VydGlmaWNhdGVzUmVxdWVzdCA9IHtcbiAgaWQ/OiBzdHJpbmc7XG4gIGFraT86IHN0cmluZztcbiAgc2VyaWFsPzogc3RyaW5nO1xuICByZXZva2VkX3N0YXJ0Pzogc3RyaW5nO1xuICByZXZva2VkX2VuZD86IHN0cmluZztcbiAgZXhwaXJlZF9zdGFydD86IHN0cmluZztcbiAgZXhwaXJlZF9lbmQ/OiBzdHJpbmc7XG4gIG5vdHJldm9rZWQ/OiBib29sZWFuO1xuICBub3RleHBpcmVkPzogYm9vbGVhbjtcbiAgY2E/OiBzdHJpbmc7XG59O1xuXG5leHBvcnQgdHlwZSBDZXJ0aWZpY2F0ZVJlc3BvbnNlID0ge1xuICBjYW5hbWU6IHN0cmluZztcbiAgY2VydHM6IHsgUEVNOiBzdHJpbmcgfVtdO1xufTtcblxuZXhwb3J0IHR5cGUgRmFicmljSWRlbnRpdHkgPSB7XG4gIGlkOiBzdHJpbmc7XG4gIHR5cGU6IHN0cmluZztcbiAgYWZmaWxpYXRpb246IHN0cmluZztcbiAgYXR0cnM6IHsgbmFtZTogc3RyaW5nOyB2YWx1ZTogc3RyaW5nIH1bXTtcbiAgbWF4X2Vucm9sbG1lbnRzOiBudW1iZXI7XG59O1xuXG5leHBvcnQgdHlwZSBJZGVudGl0eVJlc3BvbnNlID0ge1xuICBjYW5hbWU6IHN0cmluZztcbiAgaWRlbnRpdGllczogRmFicmljSWRlbnRpdHlbXTtcbn07XG4iXX0=

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

@@ -0,0 +1,13 @@
+/**
+ * @description Hyperledger Fabric Shared Module for Decaf-ts
+ * @summary This module provides common logic to the client and contract sides of Hyperledger Fabric
+ * @namespace shared
+ * @memberOf module:for-fabric
+ */
+export * from "./events";
+export * from "./utils";
+export * from "./types";
+export * from "../client/services";
+export * from "./model";
+export * from "./decorators";
+export * from "./constants";

package/lib/esm/shared/index.js

@@ -0,0 +1,14 @@
+/**
+ * @description Hyperledger Fabric Shared Module for Decaf-ts
+ * @summary This module provides common logic to the client and contract sides of Hyperledger Fabric
+ * @namespace shared
+ * @memberOf module:for-fabric
+ */
+export * from "./events.js";
+export * from "./utils.js";
+export * from "./types.js";
+export * from "./../client/services/index.js";
+export * from "./model/index.js";
+export * from "./decorators.js";
+export * from "./constants.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2hhcmVkL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7OztHQUtHO0FBRUgsNEJBQXlCO0FBQ3pCLDJCQUF3QjtBQUN4QiwyQkFBd0I7QUFDeEIsOENBQW1DO0FBQ25DLGlDQUF3QjtBQUN4QixnQ0FBNkI7QUFDN0IsK0JBQTRCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZGVzY3JpcHRpb24gSHlwZXJsZWRnZXIgRmFicmljIFNoYXJlZCBNb2R1bGUgZm9yIERlY2FmLXRzXG4gKiBAc3VtbWFyeSBUaGlzIG1vZHVsZSBwcm92aWRlcyBjb21tb24gbG9naWMgdG8gdGhlIGNsaWVudCBhbmQgY29udHJhY3Qgc2lkZXMgb2YgSHlwZXJsZWRnZXIgRmFicmljXG4gKiBAbmFtZXNwYWNlIHNoYXJlZFxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljXG4gKi9cblxuZXhwb3J0ICogZnJvbSBcIi4vZXZlbnRzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi91dGlsc1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vdHlwZXNcIjtcbmV4cG9ydCAqIGZyb20gXCIuLi9jbGllbnQvc2VydmljZXNcIjtcbmV4cG9ydCAqIGZyb20gXCIuL21vZGVsXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9kZWNvcmF0b3JzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9jb25zdGFudHNcIjtcbiJdfQ==

package/lib/esm/shared/interfaces/Checkable.d.ts

@@ -0,0 +1,21 @@
+import { Context } from "fabric-contract-api";
+/**
+ * @description Interface for health-check capable contracts/services
+ * @summary Provides a standard healthcheck method signature to probe liveness/readiness of Fabric contracts or services using a Fabric context
+ * @param {Context} ctx - Fabric transaction context used for performing the health check
+ * @return {Promise<string|boolean>} A message describing health or a boolean status
+ * @interface Checkable
+ * @memberOf module:for-fabric.shared
+ */
+export interface Checkable {
+    /**
+     * @description Perform a health check using the Fabric transaction context
+     * @summary Allows implementers to report readiness/liveness information that can be a textual message or a boolean status
+     * @param {Context} ctx - Fabric transaction context reference used during the check
+     * @return {Promise<string|boolean>} A string message describing health or a boolean indicating healthy/unhealthy
+     */
+    healthcheck(ctx: Context): Promise<string | healthcheck>;
+}
+export type healthcheck = {
+    healthcheck: boolean;
+};

package/lib/esm/shared/interfaces/Checkable.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2hlY2thYmxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3NoYXJlZC9pbnRlcmZhY2VzL0NoZWNrYWJsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQ29udGV4dCB9IGZyb20gXCJmYWJyaWMtY29udHJhY3QtYXBpXCI7XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIEludGVyZmFjZSBmb3IgaGVhbHRoLWNoZWNrIGNhcGFibGUgY29udHJhY3RzL3NlcnZpY2VzXG4gKiBAc3VtbWFyeSBQcm92aWRlcyBhIHN0YW5kYXJkIGhlYWx0aGNoZWNrIG1ldGhvZCBzaWduYXR1cmUgdG8gcHJvYmUgbGl2ZW5lc3MvcmVhZGluZXNzIG9mIEZhYnJpYyBjb250cmFjdHMgb3Igc2VydmljZXMgdXNpbmcgYSBGYWJyaWMgY29udGV4dFxuICogQHBhcmFtIHtDb250ZXh0fSBjdHggLSBGYWJyaWMgdHJhbnNhY3Rpb24gY29udGV4dCB1c2VkIGZvciBwZXJmb3JtaW5nIHRoZSBoZWFsdGggY2hlY2tcbiAqIEByZXR1cm4ge1Byb21pc2U8c3RyaW5nfGJvb2xlYW4+fSBBIG1lc3NhZ2UgZGVzY3JpYmluZyBoZWFsdGggb3IgYSBib29sZWFuIHN0YXR1c1xuICogQGludGVyZmFjZSBDaGVja2FibGVcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDaGVja2FibGUge1xuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFBlcmZvcm0gYSBoZWFsdGggY2hlY2sgdXNpbmcgdGhlIEZhYnJpYyB0cmFuc2FjdGlvbiBjb250ZXh0XG4gICAqIEBzdW1tYXJ5IEFsbG93cyBpbXBsZW1lbnRlcnMgdG8gcmVwb3J0IHJlYWRpbmVzcy9saXZlbmVzcyBpbmZvcm1hdGlvbiB0aGF0IGNhbiBiZSBhIHRleHR1YWwgbWVzc2FnZSBvciBhIGJvb2xlYW4gc3RhdHVzXG4gICAqIEBwYXJhbSB7Q29udGV4dH0gY3R4IC0gRmFicmljIHRyYW5zYWN0aW9uIGNvbnRleHQgcmVmZXJlbmNlIHVzZWQgZHVyaW5nIHRoZSBjaGVja1xuICAgKiBAcmV0dXJuIHtQcm9taXNlPHN0cmluZ3xib29sZWFuPn0gQSBzdHJpbmcgbWVzc2FnZSBkZXNjcmliaW5nIGhlYWx0aCBvciBhIGJvb2xlYW4gaW5kaWNhdGluZyBoZWFsdGh5L3VuaGVhbHRoeVxuICAgKi9cbiAgaGVhbHRoY2hlY2soY3R4OiBDb250ZXh0KTogUHJvbWlzZTxzdHJpbmcgfCBoZWFsdGhjaGVjaz47XG59XG5cbmV4cG9ydCB0eXBlIGhlYWx0aGNoZWNrID0geyBoZWFsdGhjaGVjazogYm9vbGVhbiB9O1xuIl19

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

@@ -0,0 +1,61 @@
+import { stringFormat } from "@decaf-ts/decorator-validation";
+import { OverflowError } from "./errors.js";
+import { ValidationError } from "@decaf-ts/db-decorators";
+/**
+ * @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 function add(a, b) {
+    const c = a + b;
+    if (a !== c - b || b !== c - a) {
+        throw new OverflowError(`Addition overflow: ${a} + ${b}`);
+    }
+    return c;
+}
+/**
+ * @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 function sub(a, b) {
+    const c = a - b;
+    if (a !== c + b || b !== a - c) {
+        throw new OverflowError(`Subtraction overflow: ${a} - ${b}`);
+    }
+    return c;
+}
+/**
+ * @summary Safe Integer Parse
+ *
+ * @param {string} string
+ *
+ * @function safeParseInt
+ *
+ * @throws {ValidationError} if parseInt returns NaN
+ *
+ * @memberOf module:for-fabric.shared
+ */
+export function safeParseInt(string) {
+    // Regular expression to check if string only have digits
+    const digitRegex = /^\d+$/;
+    if (!digitRegex.test(string)) {
+        throw new ValidationError(stringFormat("Failed to parse: {0}", "string contains digits"));
+    }
+    const parsedint = parseInt(string);
+    if (isNaN(parsedint)) {
+        throw new ValidationError(stringFormat("Failed to parse: {0}", "string is not a parsable integer"));
+    }
+    return parsedint;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWF0aC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zaGFyZWQvbWF0aC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDOUQsT0FBTyxFQUFFLGFBQWEsRUFBRSxvQkFBaUI7QUFDekMsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRTFEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sVUFBVSxHQUFHLENBQUMsQ0FBUyxFQUFFLENBQVM7SUFDdEMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUNoQixJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDL0IsTUFBTSxJQUFJLGFBQWEsQ0FBQyxzQkFBc0IsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLENBQUM7SUFDNUQsQ0FBQztJQUNELE9BQU8sQ0FBQyxDQUFDO0FBQ1gsQ0FBQztBQUVEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sVUFBVSxHQUFHLENBQUMsQ0FBUyxFQUFFLENBQVM7SUFDdEMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUNoQixJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDL0IsTUFBTSxJQUFJLGFBQWEsQ0FBQyx5QkFBeUIsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLENBQUM7SUFDL0QsQ0FBQztJQUNELE9BQU8sQ0FBQyxDQUFDO0FBQ1gsQ0FBQztBQUVEOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFNLFVBQVUsWUFBWSxDQUFDLE1BQWM7SUFDekMseURBQXlEO0lBQ3pELE1BQU0sVUFBVSxHQUFHLE9BQU8sQ0FBQztJQUMzQixJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1FBQzdCLE1BQU0sSUFBSSxlQUFlLENBQ3ZCLFlBQVksQ0FBQyxzQkFBc0IsRUFBRSx3QkFBd0IsQ0FBQyxDQUMvRCxDQUFDO0lBQ0osQ0FBQztJQUNELE1BQU0sU0FBUyxHQUFHLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNuQyxJQUFJLEtBQUssQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO1FBQ3JCLE1BQU0sSUFBSSxlQUFlLENBQ3ZCLFlBQVksQ0FBQyxzQkFBc0IsRUFBRSxrQ0FBa0MsQ0FBQyxDQUN6RSxDQUFDO0lBQ0osQ0FBQztJQUNELE9BQU8sU0FBUyxDQUFDO0FBQ25CLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBzdHJpbmdGb3JtYXQgfSBmcm9tIFwiQGRlY2FmLXRzL2RlY29yYXRvci12YWxpZGF0aW9uXCI7XG5pbXBvcnQgeyBPdmVyZmxvd0Vycm9yIH0gZnJvbSBcIi4vZXJyb3JzXCI7XG5pbXBvcnQgeyBWYWxpZGF0aW9uRXJyb3IgfSBmcm9tIFwiQGRlY2FmLXRzL2RiLWRlY29yYXRvcnNcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gT3ZlcmZsb3ctc2FmZSBhZGRpdGlvbiBvcGVyYXRpb25cbiAqIEBzdW1tYXJ5IEFkZHMgdHdvIG51bWJlcnMgYW5kIHZlcmlmaWVzIG5vIG92ZXJmbG93IGJ5IHJldmVyc2UtY2hlY2tpbmcgdGhlIG9wZXJhbmRzXG4gKiBAcGFyYW0ge251bWJlcn0gYSAtIEZpcnN0IG9wZXJhbmRcbiAqIEBwYXJhbSB7bnVtYmVyfSBiIC0gU2Vjb25kIG9wZXJhbmRcbiAqIEByZXR1cm4ge251bWJlcn0gVGhlIHN1bSBvZiBhIGFuZCBiXG4gKiBAZnVuY3Rpb24gYWRkXG4gKiBAdGhyb3dzIHtPdmVyZmxvd0Vycm9yfSBvbiBhZGRpdGlvbiBvdmVyZmxvd1xuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gYWRkKGE6IG51bWJlciwgYjogbnVtYmVyKTogbnVtYmVyIHtcbiAgY29uc3QgYyA9IGEgKyBiO1xuICBpZiAoYSAhPT0gYyAtIGIgfHwgYiAhPT0gYyAtIGEpIHtcbiAgICB0aHJvdyBuZXcgT3ZlcmZsb3dFcnJvcihgQWRkaXRpb24gb3ZlcmZsb3c6ICR7YX0gKyAke2J9YCk7XG4gIH1cbiAgcmV0dXJuIGM7XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIE92ZXJmbG93LXNhZmUgc3VidHJhY3Rpb24gb3BlcmF0aW9uXG4gKiBAc3VtbWFyeSBTdWJ0cmFjdHMgYiBmcm9tIGEgYW5kIHZhbGlkYXRlcyBubyBvdmVyZmxvdyBieSByZXZlcnNlLWNoZWNraW5nIHRoZSBvcGVyYW5kc1xuICogQHBhcmFtIHtudW1iZXJ9IGEgLSBNaW51ZW5kXG4gKiBAcGFyYW0ge251bWJlcn0gYiAtIFN1YnRyYWhlbmRcbiAqIEByZXR1cm4ge251bWJlcn0gVGhlIGRpZmZlcmVuY2UgYSAtIGJcbiAqIEBmdW5jdGlvbiBzdWJcbiAqIEB0aHJvd3Mge092ZXJmbG93RXJyb3J9IG9uIHN1YnRhY3Rpb24gb3ZlcmZsb3dcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHN1YihhOiBudW1iZXIsIGI6IG51bWJlcik6IG51bWJlciB7XG4gIGNvbnN0IGMgPSBhIC0gYjtcbiAgaWYgKGEgIT09IGMgKyBiIHx8IGIgIT09IGEgLSBjKSB7XG4gICAgdGhyb3cgbmV3IE92ZXJmbG93RXJyb3IoYFN1YnRyYWN0aW9uIG92ZXJmbG93OiAke2F9IC0gJHtifWApO1xuICB9XG4gIHJldHVybiBjO1xufVxuXG4vKipcbiAqIEBzdW1tYXJ5IFNhZmUgSW50ZWdlciBQYXJzZVxuICpcbiAqIEBwYXJhbSB7c3RyaW5nfSBzdHJpbmdcbiAqXG4gKiBAZnVuY3Rpb24gc2FmZVBhcnNlSW50XG4gKlxuICogQHRocm93cyB7VmFsaWRhdGlvbkVycm9yfSBpZiBwYXJzZUludCByZXR1cm5zIE5hTlxuICpcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHNhZmVQYXJzZUludChzdHJpbmc6IHN0cmluZyk6IG51bWJlciB7XG4gIC8vIFJlZ3VsYXIgZXhwcmVzc2lvbiB0byBjaGVjayBpZiBzdHJpbmcgb25seSBoYXZlIGRpZ2l0c1xuICBjb25zdCBkaWdpdFJlZ2V4ID0gL15cXGQrJC87XG4gIGlmICghZGlnaXRSZWdleC50ZXN0KHN0cmluZykpIHtcbiAgICB0aHJvdyBuZXcgVmFsaWRhdGlvbkVycm9yKFxuICAgICAgc3RyaW5nRm9ybWF0KFwiRmFpbGVkIHRvIHBhcnNlOiB7MH1cIiwgXCJzdHJpbmcgY29udGFpbnMgZGlnaXRzXCIpXG4gICAgKTtcbiAgfVxuICBjb25zdCBwYXJzZWRpbnQgPSBwYXJzZUludChzdHJpbmcpO1xuICBpZiAoaXNOYU4ocGFyc2VkaW50KSkge1xuICAgIHRocm93IG5ldyBWYWxpZGF0aW9uRXJyb3IoXG4gICAgICBzdHJpbmdGb3JtYXQoXCJGYWlsZWQgdG8gcGFyc2U6IHswfVwiLCBcInN0cmluZyBpcyBub3QgYSBwYXJzYWJsZSBpbnRlZ2VyXCIpXG4gICAgKTtcbiAgfVxuICByZXR1cm4gcGFyc2VkaW50O1xufVxuIl19

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