@antelopejs/interface-core 0.0.2

package/dist/proxies.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventProxy = exports.RegisteringProxy = exports.AsyncProxy = void 0;
+exports.GetResponsibleModule = GetResponsibleModule;
+const internal_1 = require("./internal");
+const STUB_NOT_IMPLEMENTED = "Interface function called without implementation in test environment. " +
+    "Ensure the required module is loaded in your test config.";
+/**
+ * Proxy for an asynchronous function.
+ *
+ * Queues up calls while unattached, automatically unattaches when the source module is unloaded.
+ * Provides a mechanism for delayed execution and module-aware function binding.
+ */
+class AsyncProxy {
+    callback;
+    queue = [];
+    /**
+     * Attaches a callback to the proxy
+     *
+     * Automatically detached if the module calling this function gets unloaded and manualDetach is not set to true.
+     * When attached, any queued calls will be executed immediately.
+     *
+     * @param callback Function to attach
+     * @param manualDetach Don't detach automatically when module is unloaded
+     */
+    onCall(callback, manualDetach) {
+        this.callback = callback;
+        if (!manualDetach) {
+            const caller = GetResponsibleModule();
+            if (caller) {
+                internal_1.internal.addAsyncProxy(caller, this);
+            }
+        }
+        if (this.queue.length > 0) {
+            this.queue.forEach(({ args, resolve, reject }) => {
+                try {
+                    resolve(callback(...args));
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+            this.queue.splice(0, this.queue.length);
+        }
+    }
+    /**
+     * Manually detach the callback on this proxy.
+     */
+    detach() {
+        this.callback = undefined;
+    }
+    /**
+     * Call the function attached to this proxy.
+     *
+     * If a callback has not been attached yet, the call is queued up for later.
+     */
+    call(...args) {
+        if (this.callback) {
+            return Promise.resolve(this.callback(...args));
+        }
+        if (internal_1.internal.testStubMode) {
+            return Promise.reject(new Error(STUB_NOT_IMPLEMENTED));
+        }
+        return new Promise((resolve, reject) => this.queue.push({ args, resolve, reject }));
+    }
+}
+exports.AsyncProxy = AsyncProxy;
+/**
+ * Proxy for a pair of register/unregister functions.
+ *
+ * Manages registration of handlers and ensures proper cleanup when modules are unloaded.
+ * This allows for module-aware event registration with automatic cleanup.
+ */
+class RegisteringProxy {
+    registerCallback;
+    unregisterCallback;
+    registered = new Map();
+    /**
+     * Attaches a register callback to the proxy
+     *
+     * Automatically detached if the module calling this function gets unloaded and manualDetach is not set to true.
+     *
+     * @param callback Function to attach as the register callback
+     * @param manualDetach Don't detach automatically
+     */
+    onRegister(callback, manualDetach) {
+        this.registerCallback = callback;
+        if (!manualDetach) {
+            const caller = GetResponsibleModule();
+            if (caller) {
+                internal_1.internal.addRegisteringProxy(caller, this);
+            }
+        }
+        for (const [id, { args }] of this.registered) {
+            callback(id, ...args);
+        }
+    }
+    /**
+     * Attaches an unregister callback to the proxy
+     *
+     * Detached at the same time as the register callback.
+     *
+     * @param callback Function to attach as the unregister callback
+     */
+    onUnregister(callback) {
+        this.unregisterCallback = callback;
+    }
+    /**
+     * Manually detach the callbacks on this proxy.
+     */
+    detach() {
+        this.registerCallback = undefined;
+        this.unregisterCallback = undefined;
+    }
+    /**
+     * Call the register callback attached to this proxy.
+     *
+     * If a callback has not been attached yet, the call is queued up for later.
+     *
+     * @param id Unique identifier used to unregister
+     * @param args Extra arguments
+     */
+    register(id, ...args) {
+        if (!this.registerCallback && internal_1.internal.testStubMode) {
+            throw new Error(STUB_NOT_IMPLEMENTED);
+        }
+        const module = GetResponsibleModule();
+        this.registered.set(id, { module, args });
+        if (this.registerCallback) {
+            this.registerCallback(id, ...args);
+        }
+    }
+    /**
+     * Call the unregister callback attached to this proxy.
+     *
+     * @param id Unique identifier to unregister
+     */
+    unregister(id) {
+        if (this.registered.has(id)) {
+            if (this.unregisterCallback) {
+                this.unregisterCallback(id);
+            }
+            this.registered.delete(id);
+        }
+    }
+    /**
+     * Unregister all entries created by the given module
+     * @internal
+     *
+     * @param mod Module ID
+     */
+    unregisterModule(mod) {
+        for (const [id, { module }] of this.registered) {
+            if (module === mod) {
+                if (this.unregisterCallback) {
+                    this.unregisterCallback(id);
+                }
+                this.registered.delete(id);
+            }
+        }
+    }
+}
+exports.RegisteringProxy = RegisteringProxy;
+/**
+ * Event handler list that automatically removes handlers from unloaded modules.
+ *
+ * Provides a module-aware event system that cleans up event handlers when modules are unloaded,
+ * preventing memory leaks and ensuring proper modularity.
+ */
+class EventProxy {
+    registered = [];
+    constructor() {
+        internal_1.internal.knownEvents.push(this);
+    }
+    /**
+     * Call all the event handlers with the specified arguments.
+     *
+     * @param args Arguments
+     */
+    emit(...args) {
+        for (const { func } of this.registered) {
+            func(...args);
+        }
+    }
+    /**
+     * Register a new handler for this event.
+     *
+     * @param func Handler
+     */
+    register(func) {
+        if (this.registered.some((existing) => existing.func === func)) {
+            return;
+        }
+        const module = GetResponsibleModule();
+        this.registered.push({ module, func });
+    }
+    /**
+     * Unregister a handler on this event.
+     *
+     * @param fn The handler that was passed to {@link register}
+     */
+    unregister(fn) {
+        this.registered = this.registered.filter(({ func }) => func !== fn);
+    }
+    /**
+     * Unregister all handlers created by the given module.
+     * @internal
+     *
+     * @param mod Module ID
+     */
+    unregisterModule(mod) {
+        this.registered = this.registered.filter(({ module }) => module !== mod);
+    }
+}
+exports.EventProxy = EventProxy;
+function captureCallStack(startFrame = 0) {
+    const oldHandler = Error.prepareStackTrace;
+    const oldLimit = Error.stackTraceLimit;
+    Error.stackTraceLimit = Infinity;
+    Error.prepareStackTrace = (_, trace) => trace;
+    const errObj = {};
+    Error.captureStackTrace(errObj, GetResponsibleModule);
+    const trace = errObj.stack;
+    Error.prepareStackTrace = oldHandler;
+    Error.stackTraceLimit = oldLimit;
+    return trace.slice(startFrame);
+}
+function findResponsibleFile(trace) {
+    let currentFound = "";
+    const lastInterface = "";
+    let currentBestMatch = 0;
+    for (const site of trace) {
+        const fileName = site.getFileName();
+        if (!fileName ||
+            fileName.startsWith("node:internal/") ||
+            fileName.match(/[/\\]node_modules[/\\]/)) {
+            continue;
+        }
+        for (const { dir, id } of internal_1.internal.moduleByFolder) {
+            if (fileName.startsWith(dir) && dir.length > currentBestMatch) {
+                currentFound = id;
+                currentBestMatch = dir.length;
+            }
+        }
+        if (currentFound) {
+            return { module: currentFound, lastInterface };
+        }
+        if (!site.getFunctionName() && site.getTypeName()) {
+            break;
+        }
+    }
+    return { lastInterface };
+}
+/**
+ * Gets the responsible module for the current execution context.
+ *
+ * Determines which module is responsible for the current code execution by analyzing the call stack.
+ * This is used for automatic proxy detachment and event handler cleanup.
+ *
+ * @param startFrame The starting frame in the stack trace to analyze
+ * @returns The module ID or undefined if no module is found
+ */
+function GetResponsibleModule(startFrame = 0) {
+    const trace = captureCallStack(startFrame);
+    const responsible = findResponsibleFile(trace);
+    if (responsible.module) {
+        return responsible.module;
+    }
+    internal_1.internal.asyncContextReporter?.(trace);
+    return responsible.lastInterface;
+}
+//# sourceMappingURL=proxies.js.map

package/dist/proxies.js.map

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

package/dist/tests/modules.test.d.ts

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

package/dist/tests/modules.test.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const __1 = require("..");
+const internal_1 = require("../internal");
+const modules_1 = require("../modules");
+describe("ModuleDestroyed cleanup", () => {
+    beforeEach(() => {
+        internal_1.internal.knownAsync.clear();
+        internal_1.internal.knownRegisters.clear();
+    });
+    it("should remove module from knownAsync after destroy", () => {
+        const proxy = new __1.AsyncProxy();
+        internal_1.internal.addAsyncProxy("testModule", proxy);
+        (0, chai_1.expect)(internal_1.internal.knownAsync.has("testModule")).to.equal(true);
+        modules_1.Events.ModuleDestroyed.emit("testModule");
+        (0, chai_1.expect)(internal_1.internal.knownAsync.has("testModule")).to.equal(false);
+    });
+    it("should remove module from knownRegisters after destroy", () => {
+        const proxy = new __1.RegisteringProxy();
+        internal_1.internal.addRegisteringProxy("testModule", proxy);
+        (0, chai_1.expect)(internal_1.internal.knownRegisters.has("testModule")).to.equal(true);
+        modules_1.Events.ModuleDestroyed.emit("testModule");
+        (0, chai_1.expect)(internal_1.internal.knownRegisters.has("testModule")).to.equal(false);
+    });
+});
+//# sourceMappingURL=modules.test.js.map

package/dist/tests/modules.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.test.js","sourceRoot":"","sources":["../../src/tests/modules.test.ts"],"names":[],"mappings":";;AAAA,+BAA8B;AAC9B,0BAAkD;AAClD,0CAAuC;AACvC,wCAAoC;AAEpC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,UAAU,CAAC,GAAG,EAAE;QACd,mBAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC5B,mBAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG,IAAI,cAAU,EAAE,CAAC;QAC/B,mBAAQ,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAE5C,IAAA,aAAM,EAAC,mBAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7D,gBAAM,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE1C,IAAA,aAAM,EAAC,mBAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,KAAK,GAAG,IAAI,oBAAgB,EAAE,CAAC;QACrC,mBAAQ,CAAC,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAElD,IAAA,aAAM,EAAC,mBAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjE,gBAAM,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE1C,IAAA,aAAM,EAAC,mBAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/stub-mode.test.d.ts

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

package/dist/tests/stub-mode.test.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const __1 = require("..");
+const internal_1 = require("../internal");
+describe("test stub mode", () => {
+    afterEach(() => {
+        internal_1.internal.testStubMode = false;
+    });
+    describe("AsyncProxy", () => {
+        it("rejects with error when called without callback in stub mode", async () => {
+            internal_1.internal.testStubMode = true;
+            const proxy = new __1.AsyncProxy();
+            let thrown;
+            try {
+                await proxy.call();
+            }
+            catch (error) {
+                thrown = error;
+            }
+            (0, chai_1.expect)(thrown).to.be.instanceOf(Error);
+            (0, chai_1.expect)(thrown.message).to.include("without implementation");
+        });
+        it("still queues calls when stub mode is off", () => {
+            const proxy = new __1.AsyncProxy();
+            const promise = proxy.call("arg");
+            (0, chai_1.expect)(promise).to.be.instanceOf(Promise);
+        });
+        it("calls callback normally when attached in stub mode", async () => {
+            internal_1.internal.testStubMode = true;
+            const proxy = new __1.AsyncProxy();
+            proxy.onCall((value) => value.toUpperCase(), true);
+            const result = await proxy.call("hello");
+            (0, chai_1.expect)(result).to.equal("HELLO");
+        });
+    });
+    describe("RegisteringProxy", () => {
+        it("throws when registering without callback in stub mode", () => {
+            internal_1.internal.testStubMode = true;
+            const proxy = new __1.RegisteringProxy();
+            (0, chai_1.expect)(() => proxy.register("id1")).to.throw("without implementation");
+        });
+        it("still queues registration when stub mode is off", () => {
+            const proxy = new __1.RegisteringProxy();
+            proxy.register("id1");
+        });
+        it("registers normally when callback attached in stub mode", () => {
+            internal_1.internal.testStubMode = true;
+            const proxy = new __1.RegisteringProxy();
+            const registered = [];
+            proxy.onRegister((id) => registered.push(id), true);
+            proxy.register("id1");
+            (0, chai_1.expect)(registered).to.deep.equal(["id1"]);
+        });
+    });
+});
+//# sourceMappingURL=stub-mode.test.js.map

package/dist/tests/stub-mode.test.js.map

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

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@antelopejs/interface-core",
+  "version": "0.0.2",
+  "description": "AntelopeJS core interface primitives - proxies, decorators, interface functions, and logging",
+  "keywords": [
+    "antelopejs",
+    "interface",
+    "core"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AntelopeJS/interface-core.git"
+  },
+  "license": "Apache-2.0",
+  "packageManager": "pnpm@10.6.5",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./logging": {
+      "types": "./dist/logging/index.d.ts",
+      "default": "./dist/logging/index.js"
+    },
+    "./logging/*": {
+      "types": "./dist/logging/*.d.ts",
+      "default": "./dist/logging/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "decorators": [
+        "dist/decorators.d.ts"
+      ],
+      "modules": [
+        "dist/modules.d.ts"
+      ],
+      "proxies": [
+        "dist/proxies.d.ts"
+      ],
+      "internal": [
+        "dist/internal.d.ts"
+      ],
+      "config": [
+        "dist/config.d.ts"
+      ],
+      "logging": [
+        "dist/logging/index.d.ts"
+      ],
+      "logging/*": [
+        "dist/logging/*.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "format": "biome format --write .",
+    "lint:fix": "biome check --write .",
+    "lint": "biome check .",
+    "prepack": "pnpm run build",
+    "release": "pnpm run lint && pnpm run prepack && release-it",
+    "test": "pnpm run build && ajs module test ."
+  },
+  "antelopeJs": {
+    "test": "src/antelope.test.ts"
+  },
+  "dependencies": {
+    "reflect-metadata": "^0.2.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.2",
+    "@types/chai": "^4.3.20",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.14.1",
+    "chai": "^4.5.0",
+    "release-it": "^19.0.2",
+    "release-it-changelogen": "^0.1.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}