@decaf-ts/transactional-decorators 0.1.5 → 0.2.1

package/lib/Transaction.d.ts

@@ -1,5 +1,7 @@
 import { TransactionLock } from "./interfaces/TransactionLock";
-import { Callback } from "./types";
+import "./overrides";
+import { LoggedClass } from "@decaf-ts/logging";
+type TransactionRunnable<R, C = unknown> = (this: C) => R | Promise<R>;
 /**
  * @description Core transaction management class
  * @summary Manages transaction lifecycle, including creation, execution, and cleanup. Provides mechanisms for binding transactions to objects and methods, ensuring proper transaction context propagation.
@@ -44,24 +46,37 @@ import { Callback } from "./types";
  *   T->>L: release(error?)
  *   L-->>C: Return result/error
  */
-export declare class Transaction {
+export declare class Transaction<R> extends LoggedClass {
+    static debug: boolean;
+    static globalTimeout: number;
+    private static readonly metadataCache;
+    private static log;
+    get log(): any;
     readonly id: number;
-    protected action?: () => any;
+    protected action?: () => Promise<R>;
     readonly method?: string;
     readonly source?: string;
-    readonly log: string[];
+    readonly logs: string[];
     private readonly metadata?;
+    private readonly completion;
+    private resolveCompletion?;
+    private rejectCompletion?;
+    private initialFireDispatched;
+    private released;
     private static lock;
-    constructor(source: string, method?: string, action?: () => any, metadata?: any[]);
+    private static readonly contexts;
+    constructor(source: string, method?: string, action?: () => Promise<R>, metadata?: any[]);
     /**
      * @description Queues a transaction for execution
      * @summary Pushes a transaction to the queue and waits for its resolution. Creates a new transaction with the provided issuer and callback method, then submits it to the transaction lock.
      * @param {any} issuer - Any class instance that will be used as 'this' when calling the callbackMethod
-     * @param {Function} callbackMethod - Callback function containing the transaction logic, will be called with the issuer as 'this'
+     * @param {Function} method - function containing the transaction logic, will be called with the issuer as 'this'
      * @param {any[]} args - Arguments to pass to the method. Last one must be the callback function
      * @return {void}
      */
-    static push(issuer: any, callbackMethod: (...argzz: (any | Callback)[]) => void, ...args: (any | Callback)[]): void;
+    static push<R>(issuer: any, method: (...argzz: any[]) => Promise<R>, ...args: any[]): Promise<R>;
+    static run<R, C = unknown>(runnable: TransactionRunnable<R, C>, metadata?: any[]): Promise<R>;
+    static run<R, C = unknown>(context: C, runnable: TransactionRunnable<R, C>, metadata?: any[]): Promise<R>;
     /**
      * @description Configures the transaction lock implementation
      * @summary Sets the lock implementation to be used for transaction management, allowing customization of the transaction behavior
@@ -81,7 +96,7 @@ export declare class Transaction {
      * @param {Transaction} transaction - The transaction to submit for processing
      * @return {void}
      */
-    static submit(transaction: Transaction): void;
+    static submit<R>(transaction: Transaction<R>): Promise<R>;
     /**
      * @description Releases the transaction lock
      * @summary Releases the current transaction lock, optionally with an error, allowing the next transaction to proceed
@@ -89,19 +104,27 @@ export declare class Transaction {
      * @return {Promise<void>} A promise that resolves when the lock has been released
      */
     static release(err?: Error): Promise<void>;
+    /**
+     * @description Releases the transaction instance once
+     * @summary Ensures the underlying lock is released at most a single time for the transaction
+     * @param {Error} [err] - Optional error to propagate to the lock implementation
+     * @return {Promise<void>} Resolves once the lock release call finishes or immediately when already released
+     */
+    release(err?: Error): Promise<void>;
     /**
      * @description Retrieves transaction metadata
      * @summary Returns a copy of the metadata associated with this transaction, ensuring the original metadata remains unmodified
      * @return {any[] | undefined} A copy of the transaction metadata or undefined if no metadata exists
      */
     getMetadata(): any[] | undefined;
+    private static getTransactionalMetadata;
     /**
      * @description Links a new transaction to the current one
      * @summary Binds a new transaction operation to the current transaction, transferring logs and binding methods to maintain transaction context
      * @param {Transaction} nextTransaction - The new transaction to bind to the current one
      * @return {void}
      */
-    bindTransaction(nextTransaction: Transaction): void;
+    bindTransaction(nextTransaction: Transaction<any>): void;
     /**
      * @description Binds an object to the current transaction context
      * @summary Binds a transactional decorated object to the transaction by ensuring all transactional methods automatically receive the current transaction as their first argument
@@ -109,12 +132,19 @@ export declare class Transaction {
      * @return {any} The bound object with transaction-aware method wrappers
      */
     bindToTransaction(obj: any): any;
+    /**
+     * @description Applies the global timeout to the provided Promise, if configured
+     * @param {Promise<R>} execution - Transaction execution promise
+     * @return {Promise<R>} Promise that respects the configured global timeout
+     * @private
+     */
+    private applyGlobalTimeout;
     /**
      * @description Executes the transaction action
      * @summary Fires the transaction by executing its associated action function, throwing an error if no action is defined
      * @return {any} The result of the transaction action
      */
-    fire(): any;
+    fire(): Promise<R>;
     /**
      * @description Provides a string representation of the transaction
      * @summary Overrides the default toString method to provide a formatted string representation of the transaction, optionally including the transaction ID and log
@@ -123,12 +153,8 @@ export declare class Transaction {
      * @return {string} A string representation of the transaction
      */
     toString(withId?: boolean, withLog?: boolean): string;
-    /**
-     * @description Generates a reflection metadata key for transactions
-     * @summary Creates a prefixed reflection key for transaction-related metadata, ensuring proper namespacing
-     * @param {string} key - The base key to prefix with the transaction reflection namespace
-     * @return {string} The complete reflection key for transaction metadata
-     * @function key
-     */
-    static key(key: string): string;
+    static contextTransaction(context: any): Transaction<any> | undefined;
+    wait(): Promise<R>;
+    private static describeTarget;
 }
+export {};

package/lib/Transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"Transaction.js","sourceRoot":"","sources":["../src/Transaction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Transaction.js","sourceRoot":"","sources":["../src/Transaction.ts"],"names":[],"mappings":"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"}

package/lib/constants.cjs

@@ -15,7 +15,6 @@ exports.TransactionalKeys = void 0;
  * @memberOf module:transactions
  */
 exports.TransactionalKeys = {
-    REFLECT: "model.transactional.",
     TRANSACTIONAL: "transactional",
 };
 //# sourceMappingURL=constants.js.map

package/lib/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;GAMG;AACU,QAAA,iBAAiB,GAA2B;IACvD,OAAO,EAAE,sBAAsB;IAC/B,aAAa,EAAE,eAAe;CAC/B,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;GAMG;AACU,QAAA,iBAAiB,GAA2B;IACvD,aAAa,EAAE,eAAe;CAC/B,CAAC"}

package/lib/decorators.cjs

@@ -1,9 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.transactional = transactional;
-exports.transactionalSuperCall = transactionalSuperCall;
 const constants_1 = require("./constants.cjs");
-const reflection_1 = require("@decaf-ts/reflection");
+const decoration_1 = require("@decaf-ts/decoration");
 const Transaction_1 = require("./Transaction.cjs");
 const db_decorators_1 = require("@decaf-ts/db-decorators");
 /**
@@ -41,151 +40,66 @@ const db_decorators_1 = require("@decaf-ts/db-decorators");
 function transactional(...data) {
     return function (target, propertyKey, descriptor) {
         if (!descriptor)
-            throw new db_decorators_1.InternalError("Missing descriptor. Should be impossible");
-        (0, reflection_1.metadata)(Transaction_1.Transaction.key(constants_1.TransactionalKeys.TRANSACTIONAL), data)(target, propertyKey);
-        const originalMethod = descriptor.value;
-        const methodWrapper = function (...args) {
-            // eslint-disable-next-line @typescript-eslint/no-this-alias
-            const self = this;
-            return new Promise((resolve, reject) => {
-                const cb = (err, result) => {
-                    Transaction_1.Transaction.release(err).then(() => {
-                        if (err)
-                            return reject(err);
-                        resolve(result);
-                    });
-                };
-                let transaction = args.shift();
-                if (transaction instanceof Transaction_1.Transaction) {
-                    const updatedTransaction = new Transaction_1.Transaction(this.constructor.name, propertyKey, async () => {
-                        originalMethod
-                            .call(updatedTransaction.bindToTransaction(self), ...args)
-                            .then(resolve)
-                            .catch(reject);
-                    }, data.length ? data : undefined);
-                    transaction.bindTransaction(updatedTransaction);
-                    transaction.fire();
-                }
-                else {
-                    args.unshift(transaction);
-                    transaction = new Transaction_1.Transaction(this.constructor.name, propertyKey, () => {
-                        originalMethod
-                            .call(transaction.bindToTransaction(self), ...args)
-                            .then((result) => cb(undefined, result))
-                            .catch(cb);
-                    }, data.length ? data : undefined);
-                    Transaction_1.Transaction.submit(transaction);
-                }
-            });
-        };
-        Object.defineProperty(methodWrapper, "name", {
-            value: propertyKey,
+            throw new db_decorators_1.InternalError("This decorator only applies to methods");
+        (0, decoration_1.method)()(target, propertyKey, descriptor);
+        decoration_1.Metadata.set(target.constructor, decoration_1.Metadata.key(constants_1.TransactionalKeys.TRANSACTIONAL, propertyKey), {
+            data: data,
         });
-        descriptor.value = methodWrapper;
+        descriptor.value = new Proxy(descriptor.value, {
+            async apply(obj, thisArg, argArray) {
+                return new Promise((resolve, reject) => {
+                    async function exitFunction(transaction, err, result) {
+                        if (err && !(err instanceof Error) && !result) {
+                            result = err;
+                            err = undefined;
+                        }
+                        await transaction.release(err);
+                        return err
+                            ? reject(err)
+                            : resolve(result);
+                    }
+                    const candidate = argArray[0];
+                    const transactionPrefixLength = (() => {
+                        let count = 0;
+                        while (count < argArray.length &&
+                            argArray[count] instanceof Transaction_1.Transaction) {
+                            count++;
+                        }
+                        return count;
+                    })();
+                    const invocationArgs = transactionPrefixLength > 0
+                        ? argArray.slice(transactionPrefixLength)
+                        : argArray;
+                    const activeTransaction = candidate instanceof Transaction_1.Transaction
+                        ? candidate
+                        : Transaction_1.Transaction.contextTransaction(thisArg);
+                    if (activeTransaction) {
+                        const updatedTransaction = new Transaction_1.Transaction(target.name, propertyKey, async () => {
+                            try {
+                                return resolve(await Reflect.apply(obj, updatedTransaction.bindToTransaction(thisArg), invocationArgs));
+                            }
+                            catch (e) {
+                                return reject(e);
+                            }
+                        }, data.length ? data : undefined);
+                        activeTransaction.bindTransaction(updatedTransaction);
+                        activeTransaction.fire();
+                    }
+                    else {
+                        const newTransaction = new Transaction_1.Transaction(target.name, propertyKey, async () => {
+                            try {
+                                return exitFunction(newTransaction, undefined, await Reflect.apply(obj, newTransaction.bindToTransaction(thisArg), invocationArgs));
+                            }
+                            catch (e) {
+                                return exitFunction(newTransaction, e);
+                            }
+                        }, data.length ? data : undefined);
+                        Transaction_1.Transaction.submit(newTransaction);
+                    }
+                });
+            },
+        });
+        return descriptor;
     };
 }
-//
-// /**
-//  * @summary Sets a class Async method as transactional
-//  *
-//  * @param {any[]}  [metadata] option metadata available to the {@link TransactionLock}
-//  *
-//  * @function transactionalAsync
-//  *
-//  * @memberOf module:db-decorators.Decorators.transactions
-//  */
-// export function transactionalAsync(...metadata: any[]) {
-//   return function (
-//     target: any,
-//     propertyKey: string,
-//     descriptor: PropertyDescriptor,
-//   ) {
-//     metadasta(getTransactionalKey(TransactionalKeys.TRANSACTIONAL))
-//     Reflect.defineMetadata(
-//       ,
-//       {
-//         type: "async",
-//         metadata: metadata.length ? metadata : undefined,
-//       } as TransactionalMetadata,
-//       target,
-//       propertyKey,
-//     );
-//
-//     const originalMethod = descriptor.value;
-//
-//     const methodWrapper = function (this: any, ...args: any[]) {
-//       const callback: Callback = args.pop();
-//       if (!callback || typeof callback !== "function")
-//         throw new CriticalError(`Missing Callback`);
-//
-//       const cb = (err?: Err, ...args: any[]) => {
-//         Transaction.release(err).then((_) => callback(err, ...args));
-//       };
-//
-//       const self = this;
-//
-//       let transaction = args.shift();
-//       if (transaction instanceof Transaction) {
-//         const updatedTransaction: Transaction = new Transaction(
-//           this.constructor.name,
-//           propertyKey,
-//           () => {
-//             try {
-//               return originalMethod.call(
-//                 updatedTransaction.bindToTransaction(self),
-//                 ...args,
-//                 callback,
-//               );
-//             } catch (e: any) {
-//               return callback(e);
-//             }
-//           },
-//           metadata.length ? metadata : undefined,
-//         );
-//
-//         transaction.bindTransaction(updatedTransaction);
-//         transaction.fire();
-//       } else {
-//         args.unshift(transaction);
-//         transaction = undefined;
-//         transaction = new Transaction(
-//           this.constructor.name,
-//           propertyKey,
-//           () => {
-//             try {
-//               return originalMethod.call(
-//                 transaction.bindToTransaction(self),
-//                 ...args,
-//                 cb,
-//               );
-//             } catch (e: any) {
-//               return cb(e);
-//             }
-//           },
-//           metadata.length ? metadata : undefined,
-//         );
-//         Transaction.submit(transaction);
-//       }
-//     };
-//
-//     Object.defineProperty(methodWrapper, "name", {
-//       value: propertyKey,
-//     });
-//     descriptor.value = methodWrapper;
-//   };
-// }
-/**
- * @description Utility for handling super calls in transactional methods
- * @summary Wraps super method calls with the current transaction context when the super's method is also transactional, ensuring transaction continuity through the inheritance chain
- * @param {Function} method - The super method (must be bound to the proper this), e.g., super.create.bind(this)
- * @param {any[]} args - The arguments to call the method with
- * @return {any} The result of the super method call
- * @function transactionalSuperCall
- * @memberOf module:transactions
- */
-function transactionalSuperCall(method, ...args) {
-    const lock = Transaction_1.Transaction.getLock();
-    const currentTransaction = lock.currentTransaction;
-    return method(currentTransaction, ...args);
-}
 //# sourceMappingURL=decorators.js.map

package/lib/decorators.d.ts

@@ -30,14 +30,4 @@
  *   T-->>C: Return result/error
  * @category Decorators
  */
-export declare function transactional(...data: any[]): (target: any, propertyKey?: any, descriptor?: PropertyDescriptor) => void;
-/**
- * @description Utility for handling super calls in transactional methods
- * @summary Wraps super method calls with the current transaction context when the super's method is also transactional, ensuring transaction continuity through the inheritance chain
- * @param {Function} method - The super method (must be bound to the proper this), e.g., super.create.bind(this)
- * @param {any[]} args - The arguments to call the method with
- * @return {any} The result of the super method call
- * @function transactionalSuperCall
- * @memberOf module:transactions
- */
-export declare function transactionalSuperCall(method: any, ...args: any): any;
+export declare function transactional(...data: any[]): (target: any, propertyKey?: any, descriptor?: any) => any;

package/lib/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"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"}

package/lib/errors.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = void 0;
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+class TimeoutError extends db_decorators_1.InternalError {
+    constructor(message = "Transaction timed out") {
+        super(message, TimeoutError.name, 500);
+    }
+}
+exports.TimeoutError = TimeoutError;
+//# sourceMappingURL=errors.js.map

package/lib/errors.d.ts

@@ -0,0 +1,4 @@
+import { InternalError } from "@decaf-ts/db-decorators";
+export declare class TimeoutError extends InternalError {
+    constructor(message?: string | Error);
+}

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,2DAAwD;AAExD,MAAa,YAAa,SAAQ,6BAAa;IAC7C,YAAY,UAA0B,uBAAuB;QAC3D,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;CACF;AAJD,oCAIC"}

package/lib/esm/Transaction.d.ts

@@ -1,5 +1,7 @@
 import { TransactionLock } from "./interfaces/TransactionLock";
-import { Callback } from "./types";
+import "./overrides";
+import { LoggedClass } from "@decaf-ts/logging";
+type TransactionRunnable<R, C = unknown> = (this: C) => R | Promise<R>;
 /**
  * @description Core transaction management class
  * @summary Manages transaction lifecycle, including creation, execution, and cleanup. Provides mechanisms for binding transactions to objects and methods, ensuring proper transaction context propagation.
@@ -44,24 +46,37 @@ import { Callback } from "./types";
  *   T->>L: release(error?)
  *   L-->>C: Return result/error
  */
-export declare class Transaction {
+export declare class Transaction<R> extends LoggedClass {
+    static debug: boolean;
+    static globalTimeout: number;
+    private static readonly metadataCache;
+    private static log;
+    get log(): any;
     readonly id: number;
-    protected action?: () => any;
+    protected action?: () => Promise<R>;
     readonly method?: string;
     readonly source?: string;
-    readonly log: string[];
+    readonly logs: string[];
     private readonly metadata?;
+    private readonly completion;
+    private resolveCompletion?;
+    private rejectCompletion?;
+    private initialFireDispatched;
+    private released;
     private static lock;
-    constructor(source: string, method?: string, action?: () => any, metadata?: any[]);
+    private static readonly contexts;
+    constructor(source: string, method?: string, action?: () => Promise<R>, metadata?: any[]);
     /**
      * @description Queues a transaction for execution
      * @summary Pushes a transaction to the queue and waits for its resolution. Creates a new transaction with the provided issuer and callback method, then submits it to the transaction lock.
      * @param {any} issuer - Any class instance that will be used as 'this' when calling the callbackMethod
-     * @param {Function} callbackMethod - Callback function containing the transaction logic, will be called with the issuer as 'this'
+     * @param {Function} method - function containing the transaction logic, will be called with the issuer as 'this'
      * @param {any[]} args - Arguments to pass to the method. Last one must be the callback function
      * @return {void}
      */
-    static push(issuer: any, callbackMethod: (...argzz: (any | Callback)[]) => void, ...args: (any | Callback)[]): void;
+    static push<R>(issuer: any, method: (...argzz: any[]) => Promise<R>, ...args: any[]): Promise<R>;
+    static run<R, C = unknown>(runnable: TransactionRunnable<R, C>, metadata?: any[]): Promise<R>;
+    static run<R, C = unknown>(context: C, runnable: TransactionRunnable<R, C>, metadata?: any[]): Promise<R>;
     /**
      * @description Configures the transaction lock implementation
      * @summary Sets the lock implementation to be used for transaction management, allowing customization of the transaction behavior
@@ -81,7 +96,7 @@ export declare class Transaction {
      * @param {Transaction} transaction - The transaction to submit for processing
      * @return {void}
      */
-    static submit(transaction: Transaction): void;
+    static submit<R>(transaction: Transaction<R>): Promise<R>;
     /**
      * @description Releases the transaction lock
      * @summary Releases the current transaction lock, optionally with an error, allowing the next transaction to proceed
@@ -89,19 +104,27 @@ export declare class Transaction {
      * @return {Promise<void>} A promise that resolves when the lock has been released
      */
     static release(err?: Error): Promise<void>;
+    /**
+     * @description Releases the transaction instance once
+     * @summary Ensures the underlying lock is released at most a single time for the transaction
+     * @param {Error} [err] - Optional error to propagate to the lock implementation
+     * @return {Promise<void>} Resolves once the lock release call finishes or immediately when already released
+     */
+    release(err?: Error): Promise<void>;
     /**
      * @description Retrieves transaction metadata
      * @summary Returns a copy of the metadata associated with this transaction, ensuring the original metadata remains unmodified
      * @return {any[] | undefined} A copy of the transaction metadata or undefined if no metadata exists
      */
     getMetadata(): any[] | undefined;
+    private static getTransactionalMetadata;
     /**
      * @description Links a new transaction to the current one
      * @summary Binds a new transaction operation to the current transaction, transferring logs and binding methods to maintain transaction context
      * @param {Transaction} nextTransaction - The new transaction to bind to the current one
      * @return {void}
      */
-    bindTransaction(nextTransaction: Transaction): void;
+    bindTransaction(nextTransaction: Transaction<any>): void;
     /**
      * @description Binds an object to the current transaction context
      * @summary Binds a transactional decorated object to the transaction by ensuring all transactional methods automatically receive the current transaction as their first argument
@@ -109,12 +132,19 @@ export declare class Transaction {
      * @return {any} The bound object with transaction-aware method wrappers
      */
     bindToTransaction(obj: any): any;
+    /**
+     * @description Applies the global timeout to the provided Promise, if configured
+     * @param {Promise<R>} execution - Transaction execution promise
+     * @return {Promise<R>} Promise that respects the configured global timeout
+     * @private
+     */
+    private applyGlobalTimeout;
     /**
      * @description Executes the transaction action
      * @summary Fires the transaction by executing its associated action function, throwing an error if no action is defined
      * @return {any} The result of the transaction action
      */
-    fire(): any;
+    fire(): Promise<R>;
     /**
      * @description Provides a string representation of the transaction
      * @summary Overrides the default toString method to provide a formatted string representation of the transaction, optionally including the transaction ID and log
@@ -123,12 +153,8 @@ export declare class Transaction {
      * @return {string} A string representation of the transaction
      */
     toString(withId?: boolean, withLog?: boolean): string;
-    /**
-     * @description Generates a reflection metadata key for transactions
-     * @summary Creates a prefixed reflection key for transaction-related metadata, ensuring proper namespacing
-     * @param {string} key - The base key to prefix with the transaction reflection namespace
-     * @return {string} The complete reflection key for transaction metadata
-     * @function key
-     */
-    static key(key: string): string;
+    static contextTransaction(context: any): Transaction<any> | undefined;
+    wait(): Promise<R>;
+    private static describeTarget;
 }
+export {};