@decaf-ts/transactional-decorators 0.1.4 → 0.2.0

package/lib/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./interfaces";
 export * from "./locks";
+export * from "./overrides";
 export * from "./constants";
+export * from "./errors";
 export * from "./decorators";
 export * from "./Transaction";
 export * from "./types";
@@ -15,4 +17,5 @@ export * from "./types";
  * @const VERSION
  * @memberOf module:transactions
  */
-export declare const VERSION = "0.1.3";
+export declare const VERSION = "0.1.5";
+export declare const PACKAGE_NAME = "@decaf-ts/transactional-decorators";

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,yDAA6B;AAC7B,oDAAwB;AACxB,kDAA4B;AAC5B,mDAA6B;AAC7B,oDAA8B;AAC9B,8CAAwB;AAExB;;;;GAIG;AAEH;;;;;GAKG;AACU,QAAA,OAAO,GAAG,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qDAAgD;AAEhD,yDAA6B;AAC7B,oDAAwB;AACxB,wDAA4B;AAC5B,kDAA4B;AAC5B,+CAAyB;AACzB,mDAA6B;AAC7B,oDAA8B;AAC9B,8CAAwB;AAExB;;;;GAIG;AAEH;;;;;GAKG;AACU,QAAA,OAAO,GAAG,aAAa,CAAC;AAExB,QAAA,YAAY,GAAG,aAAa,CAAC;AAE1C,qBAAQ,CAAC,eAAe,CAAC,oBAAY,EAAE,eAAO,CAAC,CAAC"}

package/lib/interfaces/TransactionLock.d.ts

@@ -10,14 +10,14 @@ export interface TransactionLock {
      * @description Current active transaction reference
      * @summary Stores a reference to the currently executing transaction, allowing access to the active transaction context
      */
-    currentTransaction?: Transaction;
+    currentTransaction?: Transaction<any>;
     /**
      * @description Submits a transaction for processing
      * @summary Adds a transaction to the processing queue and handles its execution according to the lock's concurrency rules
      * @param {Transaction} transaction - The transaction to be processed
      * @return {void}
      */
-    submit(transaction: Transaction): void;
+    submit<R>(transaction: Transaction<R>): Promise<R>;
     /**
      * @description Releases the transaction lock
      * @summary Releases the lock after the conclusion of a transaction, allowing the next transaction to proceed, and handles any errors that occurred

package/lib/locks/SynchronousLock.cjs

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SynchronousLock = void 0;
+const Transaction_1 = require("./../Transaction.cjs");
+const Lock_1 = require("./Lock.cjs");
+const logging_1 = require("@decaf-ts/logging");
+/**
+ * @summary Simple Synchronous Lock implementation
+ * @description for transaction management
+ * adapted from {@link https://www.talkinghightech.com/en/creating-a-js-lock-for-a-resource/}
+ *
+ * @param {number} [counter] the number of simultaneous transactions allowed. defaults to 1
+ * @param {Function} [onBegin] to be called at the start of the transaction
+ * @param {Function} [onEnd] to be called at the conclusion of the transaction
+ *
+ * @class SynchronousLock
+ * @implements TransactionLock
+ */
+class SynchronousLock extends logging_1.LoggedClass {
+    get log() {
+        if (!this["_log"]) {
+            this["_log"] = Transaction_1.Transaction["log"].for(this);
+        }
+        return this["_log"];
+    }
+    logger(method) {
+        if (!this.loggerCache.has(method)) {
+            this.loggerCache.set(method, this.log.for(this[method]));
+        }
+        return this.loggerCache.get(method);
+    }
+    constructor(counter = 1, onBegin, onEnd) {
+        super();
+        this.counter = counter;
+        this.onBegin = onBegin;
+        this.onEnd = onEnd;
+        this.pendingTransactions = [];
+        this.currentTransaction = undefined;
+        this.loggerCache = new Map();
+        this.lock = new Lock_1.Lock();
+    }
+    /**
+     * @summary Submits a transaction to be processed
+     * @param {Transaction} transaction
+     */
+    async submit(transaction) {
+        const log = this.logger("submit");
+        await this.lock.acquire();
+        log.silly(`Lock acquired to submit transaction ${transaction.id}`);
+        if (this.currentTransaction &&
+            this.currentTransaction.id === transaction.id) {
+            this.lock.release();
+            log.silly(`Released lock for re-entrant transaction ${transaction.id}`);
+            return transaction.fire();
+        }
+        let resultPromise;
+        if (this.counter > 0) {
+            this.counter--;
+            this.lock.release();
+            log.silly(`Released lock for transaction ${transaction.id}`);
+            resultPromise = this.fireTransaction(transaction);
+        }
+        else {
+            log.debug(`Pushing transaction ${transaction.id} to the queue`);
+            this.pendingTransactions.push(transaction);
+            resultPromise = transaction.wait();
+            this.lock.release();
+            log.silly(`Released lock after queuing transaction ${transaction.id}`);
+        }
+        return resultPromise;
+    }
+    /**
+     * @summary Executes a transaction
+     *
+     * @param {Transaction} transaction
+     * @private
+     */
+    async fireTransaction(transaction) {
+        const log = this.logger("fireTransaction");
+        await this.lock.acquire();
+        log.silly(`Lock acquired obtain transaction ${transaction.id}`);
+        this.currentTransaction = transaction;
+        this.lock.release();
+        log.silly(`Released lock after obtaining ${transaction.id}`);
+        if (this.onBegin) {
+            log.verbose(`Calling onBegin for transaction ${transaction.id}`);
+            await this.onBegin();
+        }
+        log.info(`Starting transaction ${transaction.id}. ${this.pendingTransactions.length} remaining...`);
+        return transaction.fire();
+    }
+    /**
+     * @summary Releases The lock after the conclusion of a transaction
+     */
+    async release(err) {
+        const log = this.logger("release");
+        await this.lock.acquire();
+        if (!this.currentTransaction)
+            log.warn("Trying to release an unexisting transaction. should never happen...");
+        log.verbose(`Releasing transaction ${this.currentTransaction?.toString(true, true)}`);
+        const id = this.currentTransaction?.id;
+        this.currentTransaction = undefined;
+        this.lock.release();
+        log.silly(`Released lock after clearing transaction ${id}`);
+        if (this.onEnd) {
+            log.verbose(`Calling onEnd for transaction ${id}`);
+            await this.onEnd(err);
+        }
+        await this.lock.acquire();
+        log.silly(`Acquired lock after completing transaction ${id} for pending transaction verification`);
+        if (this.pendingTransactions.length > 0) {
+            const transaction = this.pendingTransactions.shift();
+            const cb = () => {
+                return this.fireTransaction.call(this, transaction).catch((err) => {
+                    this.log.for(this.fireTransaction).error(err);
+                });
+            };
+            log.silly(`Marking ${transaction.id} for execution`);
+            if (!(0, logging_1.isBrowser)()) {
+                globalThis.process.nextTick(cb); // if you are on node
+            }
+            else {
+                setTimeout(cb, 0);
+            } // if you are in the browser
+        }
+        else {
+            log.debug(`No pending transactions. Incrementing counter.`);
+            this.counter++;
+        }
+        this.lock.release();
+        log.silly(`Released lock after completing transaction ${id}`);
+    }
+}
+exports.SynchronousLock = SynchronousLock;
+//# sourceMappingURL=SynchronousLock.js.map

package/lib/locks/{SyncronousLock.d.ts → SynchronousLock.d.ts}

@@ -1,5 +1,6 @@
 import { Transaction } from "../Transaction";
 import { TransactionLock } from "../interfaces/TransactionLock";
+import { LoggedClass } from "@decaf-ts/logging";
 /**
  * @summary Simple Synchronous Lock implementation
  * @description for transaction management
@@ -9,22 +10,25 @@ import { TransactionLock } from "../interfaces/TransactionLock";
  * @param {Function} [onBegin] to be called at the start of the transaction
  * @param {Function} [onEnd] to be called at the conclusion of the transaction
  *
- * @class SyncronousLock
+ * @class SynchronousLock
  * @implements TransactionLock
  */
-export declare class SyncronousLock implements TransactionLock {
+export declare class SynchronousLock extends LoggedClass implements TransactionLock {
     private counter;
-    private pendingTransactions;
-    currentTransaction?: Transaction;
     private readonly onBegin?;
     private readonly onEnd?;
+    private pendingTransactions;
+    currentTransaction?: Transaction<any>;
+    private readonly loggerCache;
+    get log(): any;
+    private logger;
     private readonly lock;
-    constructor(counter?: number, onBegin?: () => Promise<void>, onEnd?: (err?: Error) => Promise<void>);
+    constructor(counter?: number, onBegin?: (() => Promise<void>) | undefined, onEnd?: ((err?: Error) => Promise<void>) | undefined);
     /**
      * @summary Submits a transaction to be processed
      * @param {Transaction} transaction
      */
-    submit(transaction: Transaction): void;
+    submit<R>(transaction: Transaction<R>): Promise<R>;
     /**
      * @summary Executes a transaction
      *

package/lib/locks/SynchronousLock.js.map

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

package/lib/locks/index.cjs

@@ -20,5 +20,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Lock.cjs"), exports);
-__exportStar(require("./SyncronousLock.cjs"), exports);
+__exportStar(require("./SynchronousLock.cjs"), exports);
 //# sourceMappingURL=index.js.map

package/lib/locks/index.d.ts

@@ -4,4 +4,4 @@
  * @module transactions/locks
  */
 export * from "./Lock";
-export * from "./SyncronousLock";
+export * from "./SynchronousLock";

package/lib/locks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/locks/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,6CAAuB;AACvB,uDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/locks/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,6CAAuB;AACvB,wDAAkC"}

package/lib/overrides/Metadata.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("@decaf-ts/decoration");
+//# sourceMappingURL=Metadata.js.map

package/lib/overrides/Metadata.d.ts

@@ -0,0 +1,8 @@
+import "@decaf-ts/decoration";
+import { Constructor } from "@decaf-ts/decorator-validation";
+declare module "@decaf-ts/decoration" {
+    namespace Metadata {
+        function transactionals<T>(obj: Constructor<T>): (keyof T)[];
+        function isTransactional<T>(obj: Constructor<T>): boolean;
+    }
+}

package/lib/overrides/Metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metadata.js","sourceRoot":"","sources":["../../src/overrides/Metadata.ts"],"names":[],"mappings":";;AAAA,gCAA8B"}

package/lib/overrides/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Metadata.cjs"), exports);
+__exportStar(require("./overrides.cjs"), exports);
+//# sourceMappingURL=index.js.map

package/lib/overrides/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./Metadata";
+export * from "./overrides";

package/lib/overrides/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/overrides/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA2B;AAC3B,kDAA4B"}

package/lib/overrides/overrides.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const decoration_1 = require("@decaf-ts/decoration");
+const constants_1 = require("./../constants.cjs");
+decoration_1.Metadata.transactionals = function (obj) {
+    const meta = decoration_1.Metadata.get(obj, constants_1.TransactionalKeys.TRANSACTIONAL);
+    if (!meta)
+        return [];
+    return Object.keys(meta);
+};
+decoration_1.Metadata.isTransactional = function (obj) {
+    return !!decoration_1.Metadata.get(obj, constants_1.TransactionalKeys.TRANSACTIONAL);
+};
+//# sourceMappingURL=overrides.js.map

package/lib/overrides/overrides.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/overrides/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../../src/overrides/overrides.ts"],"names":[],"mappings":";;AAAA,qDAAgD;AAChD,kDAAiD;AAGhD,qBAAgB,CAAC,cAAc,GAAG,UACjC,GAAmB;IAEnB,MAAM,IAAI,GAAG,qBAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,6BAAiB,CAAC,aAAa,CAAC,CAAC;IAChE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAgB,CAAC;AAC1C,CAAC,CAAC;AAED,qBAAgB,CAAC,eAAe,GAAG,UAAa,GAAmB;IAClE,OAAO,CAAC,CAAC,qBAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,6BAAiB,CAAC,aAAa,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/lib/types.cjs

@@ -1,3 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//
+// /**
+//  * @description Standard callback function type for asynchronous operations
+//  * @summary Defines a Node.js-style callback function that receives an optional error as the first parameter and optional result and additional arguments
+//  * @typedef {Function} Callback
+//  * @param {Error} [err] - Optional error object if the operation failed
+//  * @param {any} [result] - Optional result of the operation if successful
+//  * @param {...any} [args] - Additional arguments that may be passed to the callback
+//  * @memberOf module:transactions
+//  */
+// export type Callback = (err?: Error, result?: any, ...args: any[]) => void;
 //# sourceMappingURL=types.js.map

package/lib/types.d.ts

@@ -5,13 +5,3 @@
  * @memberOf module:transactions
  */
 export type LockCallable = (value?: void | PromiseLike<void>) => void;
-/**
- * @description Standard callback function type for asynchronous operations
- * @summary Defines a Node.js-style callback function that receives an optional error as the first parameter and optional result and additional arguments
- * @typedef {Function} Callback
- * @param {Error} [err] - Optional error object if the operation failed
- * @param {any} [result] - Optional result of the operation if successful
- * @param {...any} [args] - Additional arguments that may be passed to the callback
- * @memberOf module:transactions
- */
-export type Callback = (err?: Error, result?: any, ...args: any[]) => void;

package/lib/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;AAOA,EAAE;AACF,MAAM;AACN,8EAA8E;AAC9E,4JAA4J;AAC5J,kCAAkC;AAClC,0EAA0E;AAC1E,4EAA4E;AAC5E,sFAAsF;AACtF,mCAAmC;AACnC,MAAM;AACN,8EAA8E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/transactional-decorators",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Locking and transactions",
   "type": "module",
   "exports": {
@@ -23,7 +23,7 @@
     "test:integration": "jest --testPathPattern=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
     "test:all": "jest --testPathPattern=\"/tests\" --passWithNoTests --detectOpenHandles",
     "test:circular": "dpdm -T --no-warning --no-tree ./src/index.ts",
-    "coverage": "rimraf ./workdocs/reports/data/*.json && npm run test:all -- --coverage --config=./workdocs/reports/jest.coverage.config.ts",
+    "coverage": "rimraf ./workdocs/reports/data/*.json && npm run test:all -- --runInBand --coverage --config=./workdocs/reports/jest.coverage.config.ts",
     "lint": "eslint .",
     "lint-fix": "eslint --fix .",
     "prepare-pr": "npm run lint-fix && npm run build:prod && npm run coverage && npm run docs",
@@ -44,7 +44,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/decaf-ts/ts-workspace.git"
+    "url": "git+https://github.com/decaf-ts/transactional-decorators.git"
   },
   "engines": {
     "node": ">=20.0.0",
@@ -69,43 +69,18 @@
   "author": "Tiago Venceslau and Contributors",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/decaf-ts/ts-workspace/issues"
+    "url": "https://github.com/decaf-ts/transactional-decorators/issues"
   },
-  "homepage": "https://github.com/decaf-ts/ts-workspace#readme",
+  "homepage": "https://github.com/decaf-ts/transactional-decorators#readme",
   "devDependencies": {
     "@decaf-ts/logging": "latest",
-    "@decaf-ts/utils": "latest",
-    "@eslint/js": "^9.25.1",
-    "@stylistic/eslint-plugin": "^4.2.0",
-    "@types/jest": "^29.5.14",
-    "clean-publish": "^5.1.0",
-    "dpdm": "^3.14.0",
-    "eslint": "^9.25.1",
-    "eslint-config-prettier": "^10.1.2",
-    "eslint-plugin-prettier": "^5.2.6",
-    "globals": "^16.0.0",
-    "jest": "^29.7.0",
-    "jest-html-reporters": "^3.1.7",
-    "jest-junit": "^16.0.0",
-    "jsdoc": "^4.0.4",
-    "jsdoc-mermaid": "^1.0.0",
-    "markdown-include": "^0.4.3",
-    "minimist": "^1.2.8",
-    "nodemon": "^3.1.9",
-    "npm-check-updates": "^18.0.0",
-    "prettier": "3.5.3",
-    "rimraf": "^6.0.1",
-    "ts-jest": "^29.3.2",
-    "ts-loader": "^9.5.2",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.31.0"
+    "@decaf-ts/utils": "latest"
   },
   "peerDependencies": {
     "@decaf-ts/db-decorators": "latest",
     "@decaf-ts/decoration": "latest",
     "@decaf-ts/decorator-validation": "latest",
-    "@decaf-ts/reflection": "latest",
+    "@decaf-ts/injectable-decorators": "latest",
     "reflect-metadata": "^0.2.1"
   }
 }

package/lib/esm/locks/SyncronousLock.js

@@ -1,128 +0,0 @@
-import { Lock } from "./Lock.js";
-/**
- * @summary Simple Synchronous Lock implementation
- * @description for transaction management
- * adapted from {@link https://www.talkinghightech.com/en/creating-a-js-lock-for-a-resource/}
- *
- * @param {number} [counter] the number of simultaneous transactions allowed. defaults to 1
- * @param {Function} [onBegin] to be called at the start of the transaction
- * @param {Function} [onEnd] to be called at the conclusion of the transaction
- *
- * @class SyncronousLock
- * @implements TransactionLock
- */
-export class SyncronousLock {
-    constructor(counter = 1, onBegin, onEnd) {
-        this.currentTransaction = undefined;
-        this.lock = new Lock();
-        this.counter = counter;
-        this.pendingTransactions = [];
-        this.onBegin = onBegin;
-        this.onEnd = onEnd;
-    }
-    /**
-     * @summary Submits a transaction to be processed
-     * @param {Transaction} transaction
-     */
-    submit(transaction) {
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        const self = this;
-        self.lock.acquire().then(() => {
-            if (self.currentTransaction &&
-                self.currentTransaction.id === transaction.id) {
-                self.lock.release();
-                return transaction.fire();
-            }
-            if (self.counter > 0) {
-                self.counter--;
-                self.lock.release();
-                return self.fireTransaction(transaction);
-            }
-            else {
-                self.pendingTransactions.push(transaction);
-                self.lock.release();
-            }
-        });
-    }
-    /**
-     * @summary Executes a transaction
-     *
-     * @param {Transaction} transaction
-     * @private
-     */
-    fireTransaction(transaction) {
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        const self = this;
-        self.lock.acquire().then(() => {
-            self.currentTransaction = transaction;
-            self.lock.release();
-            if (self.onBegin)
-                self.onBegin().then(() => {
-                    // all.call(
-                    //   self,
-                    //   `Firing transaction {0}. {1} remaining...`,
-                    //   transaction.id,
-                    //   this.pendingTransactions.length,
-                    // );
-                    transaction.fire();
-                });
-            else {
-                // all.call(
-                //   self,
-                //   `Firing transaction {0}. {1} remaining...`,
-                //   transaction.id,
-                //   this.pendingTransactions.length,
-                // );
-                transaction.fire();
-            }
-        });
-    }
-    /**
-     * @summary Releases The lock after the conclusion of a transaction
-     */
-    async release(err) {
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        const self = this;
-        return new Promise((resolve) => {
-            self.lock.acquire().then(() => {
-                if (!self.currentTransaction)
-                    console.warn("Trying to release an unexisting transaction. should never happen...");
-                // debug.call(
-                //   self,
-                //   "Releasing transaction: {0}",
-                //   self.currentTransaction?.toString(true, true),
-                // );
-                self.currentTransaction = undefined;
-                self.lock.release();
-                const afterConclusionCB = () => {
-                    self.lock.acquire().then(() => {
-                        if (self.pendingTransactions.length > 0) {
-                            const transaction = self.pendingTransactions.shift();
-                            const cb = () => self.fireTransaction(transaction);
-                            //
-                            // all(
-                            //   `Releasing Transaction Lock on transaction {0}`,
-                            //   transaction.id,
-                            // );
-                            if (typeof globalThis.window ===
-                                "undefined")
-                                globalThis.process.nextTick(cb); // if you are on node
-                            else
-                                setTimeout(cb, 0); // if you are in the browser
-                        }
-                        else {
-                            self.counter++;
-                        }
-                        self.lock.release();
-                        resolve();
-                    });
-                };
-                if (self.onEnd)
-                    self.onEnd(err).then(() => afterConclusionCB());
-                else
-                    afterConclusionCB();
-            });
-        });
-    }
-}
-//# sourceMappingURL=SyncronousLock.js.map

package/lib/esm/locks/SyncronousLock.js.map

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

package/lib/esm/utils.d.ts

@@ -1 +0,0 @@
-export declare function getObjectName(obj: any): string | undefined;

package/lib/esm/utils.js

@@ -1,14 +0,0 @@
-export function getObjectName(obj) {
-    if (!obj)
-        return;
-    if (typeof obj === "string")
-        return obj;
-    if (obj.constructor &&
-        obj.constructor.name &&
-        ["Function", "Object"].indexOf(obj.constructor.name) === -1)
-        return obj.constructor.name;
-    if (typeof obj === "function" && obj.name)
-        return obj.name;
-    return obj.toString();
-}
-//# sourceMappingURL=utils.js.map

package/lib/esm/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IACE,GAAG,CAAC,WAAW;QACf,GAAG,CAAC,WAAW,CAAC,IAAI;QACpB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE3D,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC;IAC9B,IAAI,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC3D,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}