@decaf-ts/for-fabric 0.0.2

package/lib/shared/decorators.d.ts

@@ -0,0 +1,24 @@
+import { Repo } from "@decaf-ts/core";
+import { Context, RepositoryFlags } from "@decaf-ts/db-decorators";
+import { Model } from "@decaf-ts/decorator-validation";
+/**
+ * Decorator for marking methods that require ownership authorization.
+ * Checks the owner of the token before allowing the method to be executed.
+ *
+ * @example
+ * ```typescript
+ * class TokenContract extends Contract {
+ *   @Owner()
+ *   async Mint(ctx: Context, amount: number) {
+ *     // Mint token logic
+ *   }
+ * }
+ * ```
+ *
+ * @returns {MethodDecorator} A method decorator that checks ownership authorization.
+ */
+export declare function Owner(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function ownedByOnCreate<M extends Model, R extends Repo<M, F, C>, V, F extends RepositoryFlags, C extends Context<F>>(this: R, context: Context<F>, data: V, key: keyof M, model: M): Promise<void>;
+export declare function OwnedBy(): (target: any, propertyKey?: any, descriptor?: TypedPropertyDescriptor<any>) => any;
+export declare function getFabricModelKey(key: string): string;
+export declare function privateData(collection?: string): (model: any, attribute?: any) => void;

package/lib/shared/erc20/erc20-constants.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERC20Events = void 0;
+/**
+ * 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.
+ */
+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 || (exports.ERC20Events = ERC20Events = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJjMjAtY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NoYXJlZC9lcmMyMC9lcmMyMC1jb25zdGFudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUE7Ozs7OztHQU1HO0FBQ0gsSUFBWSxXQWtCWDtBQWxCRCxXQUFZLFdBQVc7SUFDckI7Ozs7OztPQU1HO0lBQ0gscUNBQXNCLENBQUE7SUFFdEI7Ozs7OztPQU1HO0lBQ0gsb0NBQXFCLENBQUE7QUFDdkIsQ0FBQyxFQWxCVyxXQUFXLDJCQUFYLFdBQVcsUUFrQnRCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBFbnVtIHJlcHJlc2VudGluZyB0aGUgZXZlbnRzIGVtaXR0ZWQgYnkgYW4gRVJDMjAgY29udHJhY3QuXG4gKlxuICogQHJlbWFya3NcbiAqIFRoaXMgZW51bSBpcyB1c2VkIHRvIGlkZW50aWZ5IHRoZSBzcGVjaWZpYyBldmVudHMgdGhhdCBjYW4gYmUgZW1pdHRlZCBieSBhbiBFUkMyMCBjb250cmFjdC5cbiAqIFRoZSBldmVudHMgYXJlIG5hbWVkIGFjY29yZGluZyB0byB0aGUgRUlQLTIwIHN0YW5kYXJkLlxuICovXG5leHBvcnQgZW51bSBFUkMyMEV2ZW50cyB7XG4gIC8qKlxuICAgKiBFbWl0dGVkIHdoZW4gYSBgdHJhbnNmZXJgIGZ1bmN0aW9uIGlzIGNhbGxlZCBzdWNjZXNzZnVsbHkuXG4gICAqXG4gICAqIEBwYXJhbSBmcm9tIC0gVGhlIGFkZHJlc3Mgb2YgdGhlIHNlbmRlci5cbiAgICogQHBhcmFtIHRvIC0gVGhlIGFkZHJlc3Mgb2YgdGhlIHJlY2lwaWVudC5cbiAgICogQHBhcmFtIHZhbHVlIC0gVGhlIGFtb3VudCBvZiB0b2tlbnMgdHJhbnNmZXJyZWQuXG4gICAqL1xuICBUUkFOU0ZFUiA9IFwiIFRyYW5zZmVyXCIsXG5cbiAgLyoqXG4gICAqIEVtaXR0ZWQgd2hlbiBhbiBgYXBwcm92ZWAgZnVuY3Rpb24gaXMgY2FsbGVkIHN1Y2Nlc3NmdWxseS5cbiAgICpcbiAgICogQHBhcmFtIG93bmVyIC0gVGhlIGFkZHJlc3Mgb2YgdGhlIHRva2VuIG93bmVyLlxuICAgKiBAcGFyYW0gc3BlbmRlciAtIFRoZSBhZGRyZXNzIG9mIHRoZSBhcHByb3ZlZCBzcGVuZGVyLlxuICAgKiBAcGFyYW0gdmFsdWUgLSBUaGUgYW1vdW50IG9mIHRva2VucyBhcHByb3ZlZCBmb3IgdGhlIHNwZW5kZXIuXG4gICAqL1xuICBBUFBST1ZBTCA9IFwiQXBwcm92YWxcIixcbn1cbiJdfQ==

package/lib/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/shared/errors.cjs

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotInitializedError = exports.UnauthorizedPrivateDataAccess = exports.MissingContextError = exports.RegistrationError = exports.AllowanceError = exports.BalanceError = exports.OverflowError = void 0;
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const core_1 = require("@decaf-ts/core");
+const private_data_1 = require("./../contracts/private-data.cjs");
+/**
+ * @summary Represents an overflow error in arithmetic operations in Smart Contracts
+ *
+ * @param {string} msg the error message
+ *
+ * @class OverflowError
+ * @extends InternalError
+ *
+ * @category Errors
+ */
+class OverflowError extends db_decorators_1.InternalError {
+    constructor(msg) {
+        super(msg, OverflowError.name);
+    }
+}
+exports.OverflowError = OverflowError;
+/**
+ * @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
+ */
+class BalanceError extends db_decorators_1.InternalError {
+    constructor(msg) {
+        super(msg, BalanceError.name);
+    }
+}
+exports.BalanceError = BalanceError;
+/**
+ * @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
+ */
+class AllowanceError extends db_decorators_1.InternalError {
+    constructor(msg) {
+        super(msg, AllowanceError.name);
+    }
+}
+exports.AllowanceError = AllowanceError;
+/**
+ * @summary Represents a failure registrating new entities
+ *
+ * @param {string} msg the error message
+ *
+ * @class RegistrationError
+ *
+ * @categort Errors
+ */
+class RegistrationError extends core_1.AuthorizationError {
+    constructor(msg) {
+        super(msg, RegistrationError.name);
+    }
+}
+exports.RegistrationError = RegistrationError;
+/**
+ * @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
+ */
+class MissingContextError extends db_decorators_1.InternalError {
+    constructor(msg) {
+        super(msg, MissingContextError.name, 500);
+    }
+}
+exports.MissingContextError = MissingContextError;
+class UnauthorizedPrivateDataAccess extends db_decorators_1.BaseError {
+    constructor(msg = private_data_1.MISSING_PRIVATE_DATA_ERROR_MESSAGE) {
+        super(UnauthorizedPrivateDataAccess.name, msg, 403);
+    }
+}
+exports.UnauthorizedPrivateDataAccess = UnauthorizedPrivateDataAccess;
+/**
+ * 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);
+ *   }
+ * }
+ * ```
+ */
+class NotInitializedError extends db_decorators_1.BaseError {
+    constructor(msg) {
+        super(NotInitializedError.name, msg, 409);
+    }
+}
+exports.NotInitializedError = NotInitializedError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NoYXJlZC9lcnJvcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsMkRBQW1FO0FBQ25FLHlDQUFvRDtBQUNwRCxrRUFBK0U7QUFDL0U7Ozs7Ozs7OztHQVNHO0FBQ0gsTUFBYSxhQUFjLFNBQVEsNkJBQWE7SUFDOUMsWUFBWSxHQUFtQjtRQUM3QixLQUFLLENBQUMsR0FBRyxFQUFFLGFBQWEsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNqQyxDQUFDO0NBQ0Y7QUFKRCxzQ0FJQztBQUVEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQWEsWUFBYSxTQUFRLDZCQUFhO0lBQzdDLFlBQVksR0FBbUI7UUFDN0IsS0FBSyxDQUFDLEdBQUcsRUFBRSxZQUFZLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDaEMsQ0FBQztDQUNGO0FBSkQsb0NBSUM7QUFFRDs7Ozs7Ozs7O0dBU0c7QUFDSCxNQUFhLGNBQWUsU0FBUSw2QkFBYTtJQUMvQyxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsY0FBYyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ2xDLENBQUM7Q0FDRjtBQUpELHdDQUlDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFhLGlCQUFrQixTQUFRLHlCQUFrQjtJQUN2RCxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsaUJBQWlCLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDckMsQ0FBQztDQUNGO0FBSkQsOENBSUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBd0JHO0FBQ0gsTUFBYSxtQkFBb0IsU0FBUSw2QkFBYTtJQUNwRCxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsbUJBQW1CLENBQUMsSUFBSSxFQUFFLEdBQUcsQ0FBQyxDQUFDO0lBQzVDLENBQUM7Q0FDRjtBQUpELGtEQUlDO0FBRUQsTUFBYSw2QkFBOEIsU0FBUSx5QkFBUztJQUMxRCxZQUFZLE1BQXNCLGlEQUFrQztRQUNsRSxLQUFLLENBQUMsNkJBQTZCLENBQUMsSUFBSSxFQUFFLEdBQUcsRUFBRSxHQUFHLENBQUMsQ0FBQztJQUN0RCxDQUFDO0NBQ0Y7QUFKRCxzRUFJQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBNEJHO0FBQ0gsTUFBYSxtQkFBb0IsU0FBUSx5QkFBUztJQUNoRCxZQUFZLEdBQW1CO1FBQzdCLEtBQUssQ0FBQyxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsR0FBRyxFQUFFLEdBQUcsQ0FBQyxDQUFDO0lBQzVDLENBQUM7Q0FDRjtBQUpELGtEQUlDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQmFzZUVycm9yLCBJbnRlcm5hbEVycm9yIH0gZnJvbSBcIkBkZWNhZi10cy9kYi1kZWNvcmF0b3JzXCI7XG5pbXBvcnQgeyBBdXRob3JpemF0aW9uRXJyb3IgfSBmcm9tIFwiQGRlY2FmLXRzL2NvcmVcIjtcbmltcG9ydCB7IE1JU1NJTkdfUFJJVkFURV9EQVRBX0VSUk9SX01FU1NBR0UgfSBmcm9tIFwiLi4vY29udHJhY3RzL3ByaXZhdGUtZGF0YVwiO1xuLyoqXG4gKiBAc3VtbWFyeSBSZXByZXNlbnRzIGFuIG92ZXJmbG93IGVycm9yIGluIGFyaXRobWV0aWMgb3BlcmF0aW9ucyBpbiBTbWFydCBDb250cmFjdHNcbiAqXG4gKiBAcGFyYW0ge3N0cmluZ30gbXNnIHRoZSBlcnJvciBtZXNzYWdlXG4gKlxuICogQGNsYXNzIE92ZXJmbG93RXJyb3JcbiAqIEBleHRlbmRzIEludGVybmFsRXJyb3JcbiAqXG4gKiBAY2F0ZWdvcnkgRXJyb3JzXG4gKi9cbmV4cG9ydCBjbGFzcyBPdmVyZmxvd0Vycm9yIGV4dGVuZHMgSW50ZXJuYWxFcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1zZzogc3RyaW5nIHwgRXJyb3IpIHtcbiAgICBzdXBlcihtc2csIE92ZXJmbG93RXJyb3IubmFtZSk7XG4gIH1cbn1cblxuLyoqXG4gKiBAc3VtbWFyeSBSZXByZXNlbnRzIGEgZmFpbHVyZSBpbiBiYWxhbmNlIHRvIHBlcmZvcm0gYSB0cmFuc2FjdGlvbiBpbiBTbWFydCBDb250cmFjdHNcbiAqXG4gKiBAcGFyYW0ge3N0cmluZ30gbXNnIHRoZSBlcnJvciBtZXNzYWdlXG4gKlxuICogQGNsYXNzIEJhbGFuY2VFcnJvclxuICogQGV4dGVuZHMgSW50ZXJuYWxFcnJvclxuICpcbiAqIEBjYXRlZ29yeSBFcnJvcnNcbiAqL1xuZXhwb3J0IGNsYXNzIEJhbGFuY2VFcnJvciBleHRlbmRzIEludGVybmFsRXJyb3Ige1xuICBjb25zdHJ1Y3Rvcihtc2c6IHN0cmluZyB8IEVycm9yKSB7XG4gICAgc3VwZXIobXNnLCBCYWxhbmNlRXJyb3IubmFtZSk7XG4gIH1cbn1cblxuLyoqXG4gKiBAc3VtbWFyeSBSZXByZXNlbnRzIGEgZmFpbHVyZSBpbiBiYWxhbmNlIHRvIHBlcmZvcm0gYSB0cmFuc2FjdGlvbiBpbiBTbWFydCBDb250cmFjdHNcbiAqXG4gKiBAcGFyYW0ge3N0cmluZ30gbXNnIHRoZSBlcnJvciBtZXNzYWdlXG4gKlxuICogQGNsYXNzIEJhbGFuY2VFcnJvclxuICogQGV4dGVuZHMgSW50ZXJuYWxFcnJvclxuICpcbiAqIEBjYXRlZ29yeSBFcnJvcnNcbiAqL1xuZXhwb3J0IGNsYXNzIEFsbG93YW5jZUVycm9yIGV4dGVuZHMgSW50ZXJuYWxFcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1zZzogc3RyaW5nIHwgRXJyb3IpIHtcbiAgICBzdXBlcihtc2csIEFsbG93YW5jZUVycm9yLm5hbWUpO1xuICB9XG59XG5cbi8qKlxuICogQHN1bW1hcnkgUmVwcmVzZW50cyBhIGZhaWx1cmUgcmVnaXN0cmF0aW5nIG5ldyBlbnRpdGllc1xuICpcbiAqIEBwYXJhbSB7c3RyaW5nfSBtc2cgdGhlIGVycm9yIG1lc3NhZ2VcbiAqXG4gKiBAY2xhc3MgUmVnaXN0cmF0aW9uRXJyb3JcbiAqXG4gKiBAY2F0ZWdvcnQgRXJyb3JzXG4gKi9cbmV4cG9ydCBjbGFzcyBSZWdpc3RyYXRpb25FcnJvciBleHRlbmRzIEF1dGhvcml6YXRpb25FcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1zZzogc3RyaW5nIHwgRXJyb3IpIHtcbiAgICBzdXBlcihtc2csIFJlZ2lzdHJhdGlvbkVycm9yLm5hbWUpO1xuICB9XG59XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIEVycm9yIHRocm93biB3aGVuIGFuIHVuc3VwcG9ydGVkIG9wZXJhdGlvbiBpcyBhdHRlbXB0ZWRcbiAqIEBzdW1tYXJ5IFRoaXMgZXJyb3IgaXMgdGhyb3duIHdoZW4gYW4gb3BlcmF0aW9uIGlzIHJlcXVlc3RlZCB0aGF0IGlzIG5vdCBzdXBwb3J0ZWQgYnkgdGhlIGN1cnJlbnRcbiAqIHBlcnNpc3RlbmNlIGFkYXB0ZXIgb3IgY29uZmlndXJhdGlvbi4gSXQgZXh0ZW5kcyB0aGUgQmFzZUVycm9yIGNsYXNzIGFuZCBzZXRzIGEgNTAwIHN0YXR1cyBjb2RlLlxuICogQHBhcmFtIHtzdHJpbmd8RXJyb3J9IG1zZyAtIFRoZSBlcnJvciBtZXNzYWdlIG9yIGFuIEVycm9yIG9iamVjdCB0byB3cmFwXG4gKiBAY2xhc3MgVW5zdXBwb3J0ZWRFcnJvclxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIC8vIFRocm93aW5nIGFuIFVuc3VwcG9ydGVkRXJyb3JcbiAqIGlmICghYWRhcHRlci5zdXBwb3J0c1RyYW5zYWN0aW9ucygpKSB7XG4gKiAgIHRocm93IG5ldyBVbnN1cHBvcnRlZEVycm9yKCdUcmFuc2FjdGlvbnMgYXJlIG5vdCBzdXBwb3J0ZWQgYnkgdGhpcyBhZGFwdGVyJyk7XG4gKiB9XG4gKlxuICogLy8gQ2F0Y2hpbmcgYW4gVW5zdXBwb3J0ZWRFcnJvclxuICogdHJ5IHtcbiAqICAgYXdhaXQgYWRhcHRlci5iZWdpblRyYW5zYWN0aW9uKCk7XG4gKiB9IGNhdGNoIChlcnJvcikge1xuICogICBpZiAoZXJyb3IgaW5zdGFuY2VvZiBVbnN1cHBvcnRlZEVycm9yKSB7XG4gKiAgICAgY29uc29sZS5lcnJvcignT3BlcmF0aW9uIG5vdCBzdXBwb3J0ZWQ6JywgZXJyb3IubWVzc2FnZSk7XG4gKiAgIH1cbiAqIH1cbiAqIGBgYFxuICpcbiAqIEBjYXRlZ29yeSBFcnJvcnNcbiAqL1xuZXhwb3J0IGNsYXNzIE1pc3NpbmdDb250ZXh0RXJyb3IgZXh0ZW5kcyBJbnRlcm5hbEVycm9yIHtcbiAgY29uc3RydWN0b3IobXNnOiBzdHJpbmcgfCBFcnJvcikge1xuICAgIHN1cGVyKG1zZywgTWlzc2luZ0NvbnRleHRFcnJvci5uYW1lLCA1MDApO1xuICB9XG59XG5cbmV4cG9ydCBjbGFzcyBVbmF1dGhvcml6ZWRQcml2YXRlRGF0YUFjY2VzcyBleHRlbmRzIEJhc2VFcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1zZzogc3RyaW5nIHwgRXJyb3IgPSBNSVNTSU5HX1BSSVZBVEVfREFUQV9FUlJPUl9NRVNTQUdFKSB7XG4gICAgc3VwZXIoVW5hdXRob3JpemVkUHJpdmF0ZURhdGFBY2Nlc3MubmFtZSwgbXNnLCA0MDMpO1xuICB9XG59XG5cbi8qKlxuICogUmVwcmVzZW50cyBhbiBlcnJvciB0aGF0IG9jY3VycyB3aGVuIGEgcmVxdWlyZWQgaW5pdGlhbGl6YXRpb24gc3RlcCBpcyBub3QgcGVyZm9ybWVkLlxuICpcbiAqIEBjbGFzcyBOb3RJbml0aWFsaXplZEVycm9yXG4gKiBAZXh0ZW5kcyBCYXNlRXJyb3JcbiAqXG4gKiBAY2F0ZWdvcnkgRXJyb3JzXG4gKlxuICogQHBhcmFtIHtzdHJpbmcgfCBFcnJvcn0gbXNnIC0gVGhlIGVycm9yIG1lc3NhZ2Ugb3IgYW4gRXJyb3Igb2JqZWN0IHRvIHdyYXAuXG4gKlxuICogQHRocm93cyB7Tm90SW5pdGlhbGl6ZWRFcnJvcn0gLSBUaHJvd3MgYW4gZXJyb3Igd2hlbiBhIHJlcXVpcmVkIGluaXRpYWxpemF0aW9uIHN0ZXAgaXMgbm90IHBlcmZvcm1lZC5cbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogLy8gSW5pdGlhbGl6ZSB0aGUgYXBwbGljYXRpb25cbiAqIGlmICghaXNJbml0aWFsaXplZCkge1xuICogICB0aHJvdyBuZXcgTm90SW5pdGlhbGl6ZWRFcnJvcignQXBwbGljYXRpb24gaXMgbm90IGluaXRpYWxpemVkJyk7XG4gKiB9XG4gKlxuICogLy8gQ2F0Y2hpbmcgYW4gTm90SW5pdGlhbGl6ZWRFcnJvclxuICogdHJ5IHtcbiAqICAgLy8gUGVyZm9ybSBvcGVyYXRpb25zIHRoYXQgcmVxdWlyZSBpbml0aWFsaXphdGlvblxuICogfSBjYXRjaCAoZXJyb3IpIHtcbiAqICAgaWYgKGVycm9yIGluc3RhbmNlb2YgTm90SW5pdGlhbGl6ZWRFcnJvcikge1xuICogICAgIGNvbnNvbGUuZXJyb3IoJ0luaXRpYWxpemF0aW9uIGVycm9yOicsIGVycm9yLm1lc3NhZ2UpO1xuICogICB9XG4gKiB9XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGNsYXNzIE5vdEluaXRpYWxpemVkRXJyb3IgZXh0ZW5kcyBCYXNlRXJyb3Ige1xuICBjb25zdHJ1Y3Rvcihtc2c6IHN0cmluZyB8IEVycm9yKSB7XG4gICAgc3VwZXIoTm90SW5pdGlhbGl6ZWRFcnJvci5uYW1lLCBtc2csIDQwOSk7XG4gIH1cbn1cbiJdfQ==

package/lib/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/shared/events.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFabricEventName = generateFabricEventName;
+exports.parseEventName = parseEventName;
+/**
+ * @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
+ */
+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
+ */
+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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXZlbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NoYXJlZC9ldmVudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFpQkEsMERBUUM7QUFzQkQsd0NBWUM7QUFwREQ7Ozs7Ozs7OztHQVNHO0FBQ0gsU0FBZ0IsdUJBQXVCLENBQ3JDLEtBQWEsRUFDYixLQUFxRCxFQUNyRCxLQUFjO0lBRWQsTUFBTSxNQUFNLEdBQUcsQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDOUIsSUFBSSxLQUFLO1FBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUM5QixPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7QUFDMUIsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBbUJHO0FBQ0gsU0FBZ0IsY0FBYyxDQUFDLElBQVk7SUFDekMsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUM5QixJQUFJLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQyxJQUFJLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQztRQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUM7SUFDakUsT0FBTztRQUNMLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBQ2YsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUM7UUFDZixLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUMsQ0FBQztLQUtoQixDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7XG4gIEJ1bGtDcnVkT3BlcmF0aW9uS2V5cyxcbiAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFyc1xuICBJbnRlcm5hbEVycm9yLFxuICBPcGVyYXRpb25LZXlzLFxufSBmcm9tIFwiQGRlY2FmLXRzL2RiLWRlY29yYXRvcnNcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gR2VuZXJhdGVzIGEgRmFicmljIGV2ZW50IG5hbWUgZnJvbSBjb21wb25lbnRzXG4gKiBAc3VtbWFyeSBDcmVhdGVzIGEgc3RhbmRhcmRpemVkIGV2ZW50IG5hbWUgYnkgam9pbmluZyB0YWJsZSwgZXZlbnQsIGFuZCBvcHRpb25hbCBvd25lciB3aXRoIHVuZGVyc2NvcmVzXG4gKiBAcGFyYW0ge3N0cmluZ30gdGFibGUgLSBUaGUgdGFibGUvY29sbGVjdGlvbiBuYW1lXG4gKiBAcGFyYW0ge09wZXJhdGlvbktleXMgfCBCdWxrQ3J1ZE9wZXJhdGlvbktleXMgfCBzdHJpbmd9IGV2ZW50IC0gVGhlIGV2ZW50IHR5cGVcbiAqIEBwYXJhbSB7c3RyaW5nfSBbb3duZXJdIC0gT3B0aW9uYWwgb3duZXIgaWRlbnRpZmllclxuICogQHJldHVybiB7c3RyaW5nfSBUaGUgZ2VuZXJhdGVkIGV2ZW50IG5hbWUgaW4gZm9ybWF0IFwidGFibGVfZXZlbnRcIiBvciBcInRhYmxlX2V2ZW50X293bmVyXCJcbiAqIEBmdW5jdGlvbiBnZW5lcmF0ZUZhYnJpY0V2ZW50TmFtZVxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2VuZXJhdGVGYWJyaWNFdmVudE5hbWUoXG4gIHRhYmxlOiBzdHJpbmcsXG4gIGV2ZW50OiBPcGVyYXRpb25LZXlzIHwgQnVsa0NydWRPcGVyYXRpb25LZXlzIHwgc3RyaW5nLFxuICBvd25lcj86IHN0cmluZ1xuKSB7XG4gIGNvbnN0IHBhcmFtcyA9IFt0YWJsZSwgZXZlbnRdO1xuICBpZiAob3duZXIpIHBhcmFtcy5wdXNoKG93bmVyKTtcbiAgcmV0dXJuIHBhcmFtcy5qb2luKFwiX1wiKTtcbn1cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gUGFyc2VzIGEgRmFicmljIGV2ZW50IG5hbWUgaW50byBpdHMgY29tcG9uZW50c1xuICogQHN1bW1hcnkgU3BsaXRzIGFuIGV2ZW50IG5hbWUgYnkgdW5kZXJzY29yZXMgYW5kIGV4dHJhY3RzIHRhYmxlLCBldmVudCwgYW5kIG9wdGlvbmFsIG93bmVyXG4gKiBAcGFyYW0ge3N0cmluZ30gbmFtZSAtIFRoZSBldmVudCBuYW1lIHRvIHBhcnNlXG4gKiBAcmV0dXJuIHt7dGFibGU6IHN0cmluZywgZXZlbnQ6IE9wZXJhdGlvbktleXMgfCBCdWxrQ3J1ZE9wZXJhdGlvbktleXMgfCBzdHJpbmcsIG93bmVyOiBzdHJpbmd9fSBUaGUgcGFyc2VkIGNvbXBvbmVudHMgYXMgYSBzdHJ1Y3R1cmVkIG9iamVjdFxuICogQHRocm93cyB7SW50ZXJuYWxFcnJvcn0gSWYgdGhlIGV2ZW50IG5hbWUgZm9ybWF0IGlzIGludmFsaWRcbiAqIEBmdW5jdGlvbiBwYXJzZUV2ZW50TmFtZVxuICogQG1lcm1haWRcbiAqIHNlcXVlbmNlRGlhZ3JhbVxuICogICBwYXJ0aWNpcGFudCBDYWxsZXJcbiAqICAgcGFydGljaXBhbnQgUGFyc2VyIGFzIHBhcnNlRXZlbnROYW1lXG4gKiAgIENhbGxlci0+PlBhcnNlcjogcGFyc2VFdmVudE5hbWUobmFtZSlcbiAqICAgUGFyc2VyLT4+UGFyc2VyOiBzcGxpdCBuYW1lIGJ5IFwiX1wiXG4gKiAgIGFsdCBwYXJ0cyBsZW5ndGggaW52YWxpZFxuICogICAgIFBhcnNlci0tPj5DYWxsZXI6IHRocm93IEludGVybmFsRXJyb3JcbiAqICAgZWxzZVxuICogICAgIFBhcnNlci0tPj5DYWxsZXI6IHsgdGFibGUsIGV2ZW50LCBvd25lcj8gfVxuICogICBlbmRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpYy5zaGFyZWRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlRXZlbnROYW1lKG5hbWU6IHN0cmluZykge1xuICBjb25zdCBwYXJ0cyA9IG5hbWUuc3BsaXQoXCJfXCIpO1xuICBpZiAocGFydHMubGVuZ3RoIDwgMiB8fCBwYXJ0cy5sZW5ndGggPiAzKSByZXR1cm4geyBldmVudDogbmFtZSB9O1xuICByZXR1cm4ge1xuICAgIHRhYmxlOiBwYXJ0c1swXSxcbiAgICBldmVudDogcGFydHNbMV0sXG4gICAgb3duZXI6IHBhcnRzWzJdLFxuICB9IGFzIHtcbiAgICB0YWJsZTogc3RyaW5nO1xuICAgIGV2ZW50OiBPcGVyYXRpb25LZXlzIHwgQnVsa0NydWRPcGVyYXRpb25LZXlzIHwgc3RyaW5nO1xuICAgIG93bmVyPzogc3RyaW5nO1xuICB9O1xufVxuIl19

package/lib/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/shared/fabric-types.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFicmljLXR5cGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NoYXJlZC9mYWJyaWMtdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSw0QkFBMEIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgXCJyZWZsZWN0LW1ldGFkYXRhXCI7XG5cbmV4cG9ydCB0eXBlIEdldENlcnRpZmljYXRlc1JlcXVlc3QgPSB7XG4gIGlkPzogc3RyaW5nO1xuICBha2k/OiBzdHJpbmc7XG4gIHNlcmlhbD86IHN0cmluZztcbiAgcmV2b2tlZF9zdGFydD86IHN0cmluZztcbiAgcmV2b2tlZF9lbmQ/OiBzdHJpbmc7XG4gIGV4cGlyZWRfc3RhcnQ/OiBzdHJpbmc7XG4gIGV4cGlyZWRfZW5kPzogc3RyaW5nO1xuICBub3RyZXZva2VkPzogYm9vbGVhbjtcbiAgbm90ZXhwaXJlZD86IGJvb2xlYW47XG4gIGNhPzogc3RyaW5nO1xufTtcblxuZXhwb3J0IHR5cGUgQ2VydGlmaWNhdGVSZXNwb25zZSA9IHtcbiAgY2FuYW1lOiBzdHJpbmc7XG4gIGNlcnRzOiB7IFBFTTogc3RyaW5nIH1bXTtcbn07XG5cbmV4cG9ydCB0eXBlIEZhYnJpY0lkZW50aXR5ID0ge1xuICBpZDogc3RyaW5nO1xuICB0eXBlOiBzdHJpbmc7XG4gIGFmZmlsaWF0aW9uOiBzdHJpbmc7XG4gIGF0dHJzOiB7IG5hbWU6IHN0cmluZzsgdmFsdWU6IHN0cmluZyB9W107XG4gIG1heF9lbnJvbGxtZW50czogbnVtYmVyO1xufTtcblxuZXhwb3J0IHR5cGUgSWRlbnRpdHlSZXNwb25zZSA9IHtcbiAgY2FuYW1lOiBzdHJpbmc7XG4gIGlkZW50aXRpZXM6IEZhYnJpY0lkZW50aXR5W107XG59O1xuIl19

package/lib/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/shared/index.cjs

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * @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
+ */
+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("./events.cjs"), exports);
+__exportStar(require("./utils.cjs"), exports);
+__exportStar(require("./types.cjs"), exports);
+__exportStar(require("./../client/services/index.cjs"), exports);
+__exportStar(require("./model/index.cjs"), exports);
+__exportStar(require("./decorators.cjs"), exports);
+__exportStar(require("./constants.cjs"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2hhcmVkL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7R0FLRzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILCtDQUF5QjtBQUN6Qiw4Q0FBd0I7QUFDeEIsOENBQXdCO0FBQ3hCLGlFQUFtQztBQUNuQyxvREFBd0I7QUFDeEIsbURBQTZCO0FBQzdCLGtEQUE0QiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGRlc2NyaXB0aW9uIEh5cGVybGVkZ2VyIEZhYnJpYyBTaGFyZWQgTW9kdWxlIGZvciBEZWNhZi10c1xuICogQHN1bW1hcnkgVGhpcyBtb2R1bGUgcHJvdmlkZXMgY29tbW9uIGxvZ2ljIHRvIHRoZSBjbGllbnQgYW5kIGNvbnRyYWN0IHNpZGVzIG9mIEh5cGVybGVkZ2VyIEZhYnJpY1xuICogQG5hbWVzcGFjZSBzaGFyZWRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6Zm9yLWZhYnJpY1xuICovXG5cbmV4cG9ydCAqIGZyb20gXCIuL2V2ZW50c1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vdXRpbHNcIjtcbmV4cG9ydCAqIGZyb20gXCIuL3R5cGVzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi4vY2xpZW50L3NlcnZpY2VzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9tb2RlbFwiO1xuZXhwb3J0ICogZnJvbSBcIi4vZGVjb3JhdG9yc1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vY29uc3RhbnRzXCI7XG4iXX0=

package/lib/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/shared/interfaces/Checkable.cjs

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

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

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.add = add;
+exports.sub = sub;
+exports.safeParseInt = safeParseInt;
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const errors_1 = require("./errors.cjs");
+const db_decorators_1 = require("@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
+ */
+function add(a, b) {
+    const c = a + b;
+    if (a !== c - b || b !== c - a) {
+        throw new errors_1.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
+ */
+function sub(a, b) {
+    const c = a - b;
+    if (a !== c + b || b !== a - c) {
+        throw new errors_1.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
+ */
+function safeParseInt(string) {
+    // Regular expression to check if string only have digits
+    const digitRegex = /^\d+$/;
+    if (!digitRegex.test(string)) {
+        throw new db_decorators_1.ValidationError((0, decorator_validation_1.stringFormat)("Failed to parse: {0}", "string contains digits"));
+    }
+    const parsedint = parseInt(string);
+    if (isNaN(parsedint)) {
+        throw new db_decorators_1.ValidationError((0, decorator_validation_1.stringFormat)("Failed to parse: {0}", "string is not a parsable integer"));
+    }
+    return parsedint;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWF0aC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zaGFyZWQvbWF0aC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQWNBLGtCQU1DO0FBWUQsa0JBTUM7QUFhRCxvQ0FlQztBQWxFRCx5RUFBOEQ7QUFDOUQseUNBQXlDO0FBQ3pDLDJEQUEwRDtBQUUxRDs7Ozs7Ozs7O0dBU0c7QUFDSCxTQUFnQixHQUFHLENBQUMsQ0FBUyxFQUFFLENBQVM7SUFDdEMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUNoQixJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDL0IsTUFBTSxJQUFJLHNCQUFhLENBQUMsc0JBQXNCLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQzVELENBQUM7SUFDRCxPQUFPLENBQUMsQ0FBQztBQUNYLENBQUM7QUFFRDs7Ozs7Ozs7O0dBU0c7QUFDSCxTQUFnQixHQUFHLENBQUMsQ0FBUyxFQUFFLENBQVM7SUFDdEMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUNoQixJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDL0IsTUFBTSxJQUFJLHNCQUFhLENBQUMseUJBQXlCLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQy9ELENBQUM7SUFDRCxPQUFPLENBQUMsQ0FBQztBQUNYLENBQUM7QUFFRDs7Ozs7Ozs7OztHQVVHO0FBQ0gsU0FBZ0IsWUFBWSxDQUFDLE1BQWM7SUFDekMseURBQXlEO0lBQ3pELE1BQU0sVUFBVSxHQUFHLE9BQU8sQ0FBQztJQUMzQixJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1FBQzdCLE1BQU0sSUFBSSwrQkFBZSxDQUN2QixJQUFBLG1DQUFZLEVBQUMsc0JBQXNCLEVBQUUsd0JBQXdCLENBQUMsQ0FDL0QsQ0FBQztJQUNKLENBQUM7SUFDRCxNQUFNLFNBQVMsR0FBRyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDbkMsSUFBSSxLQUFLLENBQUMsU0FBUyxDQUFDLEVBQUUsQ0FBQztRQUNyQixNQUFNLElBQUksK0JBQWUsQ0FDdkIsSUFBQSxtQ0FBWSxFQUFDLHNCQUFzQixFQUFFLGtDQUFrQyxDQUFDLENBQ3pFLENBQUM7SUFDSixDQUFDO0lBQ0QsT0FBTyxTQUFTLENBQUM7QUFDbkIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IHN0cmluZ0Zvcm1hdCB9IGZyb20gXCJAZGVjYWYtdHMvZGVjb3JhdG9yLXZhbGlkYXRpb25cIjtcbmltcG9ydCB7IE92ZXJmbG93RXJyb3IgfSBmcm9tIFwiLi9lcnJvcnNcIjtcbmltcG9ydCB7IFZhbGlkYXRpb25FcnJvciB9IGZyb20gXCJAZGVjYWYtdHMvZGItZGVjb3JhdG9yc1wiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBPdmVyZmxvdy1zYWZlIGFkZGl0aW9uIG9wZXJhdGlvblxuICogQHN1bW1hcnkgQWRkcyB0d28gbnVtYmVycyBhbmQgdmVyaWZpZXMgbm8gb3ZlcmZsb3cgYnkgcmV2ZXJzZS1jaGVja2luZyB0aGUgb3BlcmFuZHNcbiAqIEBwYXJhbSB7bnVtYmVyfSBhIC0gRmlyc3Qgb3BlcmFuZFxuICogQHBhcmFtIHtudW1iZXJ9IGIgLSBTZWNvbmQgb3BlcmFuZFxuICogQHJldHVybiB7bnVtYmVyfSBUaGUgc3VtIG9mIGEgYW5kIGJcbiAqIEBmdW5jdGlvbiBhZGRcbiAqIEB0aHJvd3Mge092ZXJmbG93RXJyb3J9IG9uIGFkZGl0aW9uIG92ZXJmbG93XG4gKiBAbWVtYmVyT2YgbW9kdWxlOmZvci1mYWJyaWMuc2hhcmVkXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBhZGQoYTogbnVtYmVyLCBiOiBudW1iZXIpOiBudW1iZXIge1xuICBjb25zdCBjID0gYSArIGI7XG4gIGlmIChhICE9PSBjIC0gYiB8fCBiICE9PSBjIC0gYSkge1xuICAgIHRocm93IG5ldyBPdmVyZmxvd0Vycm9yKGBBZGRpdGlvbiBvdmVyZmxvdzogJHthfSArICR7Yn1gKTtcbiAgfVxuICByZXR1cm4gYztcbn1cblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gT3ZlcmZsb3ctc2FmZSBzdWJ0cmFjdGlvbiBvcGVyYXRpb25cbiAqIEBzdW1tYXJ5IFN1YnRyYWN0cyBiIGZyb20gYSBhbmQgdmFsaWRhdGVzIG5vIG92ZXJmbG93IGJ5IHJldmVyc2UtY2hlY2tpbmcgdGhlIG9wZXJhbmRzXG4gKiBAcGFyYW0ge251bWJlcn0gYSAtIE1pbnVlbmRcbiAqIEBwYXJhbSB7bnVtYmVyfSBiIC0gU3VidHJhaGVuZFxuICogQHJldHVybiB7bnVtYmVyfSBUaGUgZGlmZmVyZW5jZSBhIC0gYlxuICogQGZ1bmN0aW9uIHN1YlxuICogQHRocm93cyB7T3ZlcmZsb3dFcnJvcn0gb24gc3VidGFjdGlvbiBvdmVyZmxvd1xuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gc3ViKGE6IG51bWJlciwgYjogbnVtYmVyKTogbnVtYmVyIHtcbiAgY29uc3QgYyA9IGEgLSBiO1xuICBpZiAoYSAhPT0gYyArIGIgfHwgYiAhPT0gYSAtIGMpIHtcbiAgICB0aHJvdyBuZXcgT3ZlcmZsb3dFcnJvcihgU3VidHJhY3Rpb24gb3ZlcmZsb3c6ICR7YX0gLSAke2J9YCk7XG4gIH1cbiAgcmV0dXJuIGM7XG59XG5cbi8qKlxuICogQHN1bW1hcnkgU2FmZSBJbnRlZ2VyIFBhcnNlXG4gKlxuICogQHBhcmFtIHtzdHJpbmd9IHN0cmluZ1xuICpcbiAqIEBmdW5jdGlvbiBzYWZlUGFyc2VJbnRcbiAqXG4gKiBAdGhyb3dzIHtWYWxpZGF0aW9uRXJyb3J9IGlmIHBhcnNlSW50IHJldHVybnMgTmFOXG4gKlxuICogQG1lbWJlck9mIG1vZHVsZTpmb3ItZmFicmljLnNoYXJlZFxuICovXG5leHBvcnQgZnVuY3Rpb24gc2FmZVBhcnNlSW50KHN0cmluZzogc3RyaW5nKTogbnVtYmVyIHtcbiAgLy8gUmVndWxhciBleHByZXNzaW9uIHRvIGNoZWNrIGlmIHN0cmluZyBvbmx5IGhhdmUgZGlnaXRzXG4gIGNvbnN0IGRpZ2l0UmVnZXggPSAvXlxcZCskLztcbiAgaWYgKCFkaWdpdFJlZ2V4LnRlc3Qoc3RyaW5nKSkge1xuICAgIHRocm93IG5ldyBWYWxpZGF0aW9uRXJyb3IoXG4gICAgICBzdHJpbmdGb3JtYXQoXCJGYWlsZWQgdG8gcGFyc2U6IHswfVwiLCBcInN0cmluZyBjb250YWlucyBkaWdpdHNcIilcbiAgICApO1xuICB9XG4gIGNvbnN0IHBhcnNlZGludCA9IHBhcnNlSW50KHN0cmluZyk7XG4gIGlmIChpc05hTihwYXJzZWRpbnQpKSB7XG4gICAgdGhyb3cgbmV3IFZhbGlkYXRpb25FcnJvcihcbiAgICAgIHN0cmluZ0Zvcm1hdChcIkZhaWxlZCB0byBwYXJzZTogezB9XCIsIFwic3RyaW5nIGlzIG5vdCBhIHBhcnNhYmxlIGludGVnZXJcIilcbiAgICApO1xuICB9XG4gIHJldHVybiBwYXJzZWRpbnQ7XG59XG4iXX0=