@antelopejs/interface-core 0.0.2

package/dist/decorators.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MakeClassDecorator = MakeClassDecorator;
+exports.MakePropertyDecorator = MakePropertyDecorator;
+exports.MakePropertyAndClassDecorator = MakePropertyAndClassDecorator;
+exports.MakeMethodDecorator = MakeMethodDecorator;
+exports.MakeMethodAndClassDecorator = MakeMethodAndClassDecorator;
+exports.MakeMethodAndPropertyDecorator = MakeMethodAndPropertyDecorator;
+exports.MakeMethodAndPropertyAndClassDecorator = MakeMethodAndPropertyAndClassDecorator;
+exports.MakeParameterDecorator = MakeParameterDecorator;
+exports.MakeParameterAndClassDecorator = MakeParameterAndClassDecorator;
+exports.MakeParameterAndPropertyDecorator = MakeParameterAndPropertyDecorator;
+exports.MakeParameterAndPropertyAndClassDecorator = MakeParameterAndPropertyAndClassDecorator;
+exports.MakeParameterAndMethodDecorator = MakeParameterAndMethodDecorator;
+exports.MakeParameterAndMethodAndClassDecorator = MakeParameterAndMethodAndClassDecorator;
+exports.MakeParameterAndMethodAndPropertyDecorator = MakeParameterAndMethodAndPropertyDecorator;
+exports.MakeParameterAndMethodAndPropertyAndClassDecorator = MakeParameterAndMethodAndPropertyAndClassDecorator;
+function Decorator1(handler) {
+    return (...args) => (a) => handler(a, ...args);
+}
+function Decorator2(handler) {
+    return (...args) => (a, b) => handler(a, b, ...args);
+}
+function Decorator3(handler) {
+    return (...args) => (a, b, c) => handler(a, b, c, ...args);
+}
+/**
+ * Creates a decorator factory that can be applied on classes.
+ *
+ * The callback arguments are split in two; the first for the decorator and the rest for the factory.
+ * This allows for creating custom, parameterized class decorators with type safety.
+ *
+ * @template T - Array type representing factory parameters
+ * @param handler - Decorator callback function that receives the target class and factory parameters
+ * @returns Decorator factory function that accepts parameters and returns a class decorator
+ */
+function MakeClassDecorator(handler) {
+    return Decorator1(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on properties.
+ *
+ * The callback arguments are split in two; the first 2 for the decorator and the rest for the factory.
+ * This allows for creating custom, parameterized property decorators with type safety.
+ *
+ * @template T - Array type representing factory parameters
+ * @param handler - Decorator callback function that receives the target object, property key, and factory parameters
+ * @returns Decorator factory function that accepts parameters and returns a property decorator
+ */
+function MakePropertyDecorator(handler) {
+    return Decorator2(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on classes and properties.
+ *
+ * The callback arguments are split in two; the first 2 for the decorator and the rest for the factory.
+ * This allows for creating custom, parameterized decorators that work on both classes and properties.
+ *
+ * @template T - Array type representing factory parameters
+ * @param handler - Decorator callback function that receives the target (class or object), property key
+ *                  (if applicable), and factory parameters
+ * @returns Decorator factory function that accepts parameters and returns a class or property decorator
+ */
+function MakePropertyAndClassDecorator(handler) {
+    return Decorator2(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on methods and accessors.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeMethodDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on classes, methods, and accessors.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeMethodAndClassDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on properties, methods, and accessors.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeMethodAndPropertyDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on classes, properties, methods, and accessors.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeMethodAndPropertyAndClassDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on classes and parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterAndClassDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on properties and parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterAndPropertyDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on classes, properties, and parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterAndPropertyAndClassDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on methods, accessors, and parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterAndMethodDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on classes, methods, accessors, and parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterAndMethodAndClassDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on properties, methods, accessors, and parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterAndMethodAndPropertyDecorator(handler) {
+    return Decorator3(handler);
+}
+/**
+ * Creates a decorator factory that can be applied on classes, properties, methods, accessors, and parameters.
+ *
+ * The callback arguments are split in two; the first 3 for the decorator and the rest for the factory.
+ *
+ * @param handler Decorator callback
+ * @returns Decorator factory
+ */
+function MakeParameterAndMethodAndPropertyAndClassDecorator(handler) {
+    return Decorator3(handler);
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import "reflect-metadata";
+import type { Class } from "./decorators";
+import { EventProxy, RegisteringProxy } from "./proxies";
+export { AsyncProxy, EventProxy, GetResponsibleModule, RegisteringProxy, } from "./proxies";
+/**
+ * Gets metadata for a target object using the specified metadata class.
+ *
+ * Retrieves or creates metadata associated with a target object, with optional inheritance support.
+ * This is used for reflection-based operations throughout the framework.
+ *
+ * @param target The target object to get metadata for
+ * @param meta The metadata class with a symbol key
+ * @param inherit Whether to inherit metadata from the prototype chain
+ * @returns The metadata instance
+ */
+export declare function GetMetadata<T extends Record<string, any>, U extends Record<string, any>>(target: U, meta: Class<T, [U]> & {
+    key: symbol;
+}, inherit?: boolean): T;
+type Func<A extends any[] = any[], R = any> = (...args: A) => R;
+/**
+ * Creates an interface function proxy.
+ *
+ * Returns a function that routes calls through an AsyncProxy, allowing for module-aware
+ * asynchronous function calls that can be implemented by other modules.
+ *
+ * @returns A function that proxies calls to the implementation when available
+ */
+export declare function InterfaceFunction<T extends Func = Func, R = Awaited<ReturnType<T>>>(): (...args: Parameters<T>) => Promise<R>;
+type RID<T> = T extends (id: infer P, ...args: any[]) => void ? P : never;
+type InterfaceImplType<T> = T extends RegisteringProxy<infer P> ? {
+    register: P;
+    unregister: (id: RID<P>) => void;
+} : T extends EventProxy ? never : T extends (...args: infer A) => infer R ? (...args: A) => Awaited<R> | R : T extends Record<string, any> ? InterfaceToImpl<T> : never;
+type InterfaceToImpl<T> = T extends infer P ? {
+    [K in keyof P]?: InterfaceImplType<P[K]>;
+} : never;
+/**
+ * Implements an interface with the provided implementation.
+ *
+ * Links a declared interface with its implementation, setting up the necessary proxies
+ * and event handlers to enable cross-module communication.
+ *
+ * @param declaration The interface declaration to implement
+ * @param implementation The implementation of the interface
+ * @returns An object containing the declaration and implementation
+ */
+export declare function ImplementInterface<T extends Record<string, unknown>, T2 extends InterfaceToImpl<T>>(declaration: T, implementation: T2): {
+    declaration: T;
+    implementation: T2;
+};
+/**
+ * @deprecated Please use the non-async version of this function.
+ */
+export declare function ImplementInterface<T extends Record<string, unknown>, T2 extends InterfaceToImpl<T>>(declaration: T | Promise<T>, implementation: T2 | Promise<T2>): Promise<{
+    declaration: Awaited<T>;
+    implementation: T2;
+}>;
+interface InterfaceConnection {
+    id?: string;
+    path: string;
+}
+/**
+ * Gets all instances of a specific interface across the system.
+ *
+ * Retrieves all connections to implementations of the specified interface.
+ *
+ * @param interfaceID The ID of the interface to get instances for
+ * @returns Array of interface connections
+ */
+export declare function GetInterfaceInstances(interfaceID: string): InterfaceConnection[];
+/**
+ * Gets a specific instance of an interface by ID.
+ *
+ * Retrieves a specific connection to an implementation of the specified interface.
+ *
+ * @param interfaceID The ID of the interface to get an instance for
+ * @param connectionID The ID of the specific connection to retrieve
+ * @returns The interface connection or undefined if not found
+ */
+export declare function GetInterfaceInstance(interfaceID: string, connectionID: string): InterfaceConnection | undefined;

package/dist/index.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegisteringProxy = exports.GetResponsibleModule = exports.EventProxy = exports.AsyncProxy = void 0;
+exports.GetMetadata = GetMetadata;
+exports.InterfaceFunction = InterfaceFunction;
+exports.ImplementInterface = ImplementInterface;
+exports.GetInterfaceInstances = GetInterfaceInstances;
+exports.GetInterfaceInstance = GetInterfaceInstance;
+require("reflect-metadata");
+const internal_1 = require("./internal");
+const logging_1 = require("./logging");
+const proxies_1 = require("./proxies");
+var proxies_2 = require("./proxies");
+Object.defineProperty(exports, "AsyncProxy", { enumerable: true, get: function () { return proxies_2.AsyncProxy; } });
+Object.defineProperty(exports, "EventProxy", { enumerable: true, get: function () { return proxies_2.EventProxy; } });
+Object.defineProperty(exports, "GetResponsibleModule", { enumerable: true, get: function () { return proxies_2.GetResponsibleModule; } });
+Object.defineProperty(exports, "RegisteringProxy", { enumerable: true, get: function () { return proxies_2.RegisteringProxy; } });
+internal_1.internal.asyncContextReporter = (trace) => {
+    const lastSite = trace[trace.length - 1];
+    if (lastSite?.getFileName() !== "node:internal/timers") {
+        return;
+    }
+    const tracestr = trace
+        .filter((site) => !site.getFileName()?.startsWith("node:internal/"))
+        .map((site) => site.toString())
+        .join("\n    - ");
+    logging_1.Logging.Error("GetResponsibleModule called from within an async context, this will break hot reloading!\n    - " +
+        tracestr);
+};
+/**
+ * Gets metadata for a target object using the specified metadata class.
+ *
+ * Retrieves or creates metadata associated with a target object, with optional inheritance support.
+ * This is used for reflection-based operations throughout the framework.
+ *
+ * @param target The target object to get metadata for
+ * @param meta The metadata class with a symbol key
+ * @param inherit Whether to inherit metadata from the prototype chain
+ * @returns The metadata instance
+ */
+function GetMetadata(target, meta, inherit = true) {
+    let data = Reflect.getOwnMetadata(meta.key, target);
+    if (!data) {
+        data = new meta(target);
+        const proto = Object.getPrototypeOf(target);
+        if (inherit && proto) {
+            const parent = GetMetadata(proto, meta, true);
+            if ("inherit" in data && typeof data.inherit === "function") {
+                data.inherit(parent);
+            }
+            else {
+                for (const key of Object.getOwnPropertyNames(parent)) {
+                    if (!(key in data)) {
+                        data[key] = parent[key];
+                    }
+                }
+            }
+        }
+        Reflect.defineMetadata(meta.key, data, target);
+    }
+    return data;
+}
+/**
+ * Creates an interface function proxy.
+ *
+ * Returns a function that routes calls through an AsyncProxy, allowing for module-aware
+ * asynchronous function calls that can be implemented by other modules.
+ *
+ * @returns A function that proxies calls to the implementation when available
+ */
+function InterfaceFunction() {
+    const proxy = new proxies_1.AsyncProxy();
+    const func = (...args) => proxy.call(...args);
+    func.proxy = proxy;
+    return func;
+}
+function implement(decl, impl) {
+    for (const key in decl) {
+        if (key in impl) {
+            const val = decl[key];
+            if (val instanceof proxies_1.RegisteringProxy) {
+                val.onRegister(impl[key].register);
+                val.onUnregister(impl[key].unregister);
+            }
+            else if (typeof val === "function" && val.proxy instanceof proxies_1.AsyncProxy) {
+                val.proxy.onCall(impl[key]);
+            }
+            else if (val instanceof proxies_1.AsyncProxy) {
+                val.onCall(impl[key]);
+            }
+            else if (!(val instanceof proxies_1.EventProxy)) {
+                implement(val, impl[key]);
+            }
+        }
+    }
+}
+function ImplementInterface(declaration, implementation) {
+    if (declaration instanceof Promise || implementation instanceof Promise) {
+        return Promise.all([declaration, implementation]).then(([decl, impl]) => {
+            implement(decl, impl);
+            return { declaration: decl, implementation: impl };
+        });
+    }
+    const decl = declaration;
+    const impl = implementation;
+    implement(decl, impl);
+    return { declaration: decl, implementation: impl };
+}
+/**
+ * Gets all instances of a specific interface across the system.
+ *
+ * Retrieves all connections to implementations of the specified interface.
+ *
+ * @param interfaceID The ID of the interface to get instances for
+ * @returns Array of interface connections
+ */
+function GetInterfaceInstances(interfaceID) {
+    const module = (0, proxies_1.GetResponsibleModule)();
+    if (!module || !(module in internal_1.internal.interfaceConnections))
+        return [];
+    const connections = internal_1.internal.interfaceConnections[module];
+    return connections[interfaceID] ?? [];
+}
+/**
+ * Gets a specific instance of an interface by ID.
+ *
+ * Retrieves a specific connection to an implementation of the specified interface.
+ *
+ * @param interfaceID The ID of the interface to get an instance for
+ * @param connectionID The ID of the specific connection to retrieve
+ * @returns The interface connection or undefined if not found
+ */
+function GetInterfaceInstance(interfaceID, connectionID) {
+    const module = (0, proxies_1.GetResponsibleModule)();
+    if (!module || !(module in internal_1.internal.interfaceConnections))
+        return;
+    const connections = internal_1.internal.interfaceConnections[module];
+    return (connections[interfaceID] ?? []).find((connection) => connection.id === connectionID);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/internal.d.ts

@@ -0,0 +1,19 @@
+export interface InterfaceConnection {
+    id?: string;
+    path: string;
+}
+/** @internal */
+export declare const internal: {
+    moduleByFolder: {
+        dir: string;
+        id: string;
+    }[];
+    testStubMode: boolean;
+    knownAsync: Map<string, any[]>;
+    knownRegisters: Map<string, any[]>;
+    knownEvents: any[];
+    interfaceConnections: Record<string, Record<string, InterfaceConnection[]>>;
+    asyncContextReporter: ((trace: NodeJS.CallSite[]) => void) | undefined;
+    addAsyncProxy(module: string, proxy: any): void;
+    addRegisteringProxy(module: string, proxy: any): void;
+};

package/dist/internal.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internal = void 0;
+function addToMapArray(map, key, value) {
+    if (!map.has(key)) {
+        map.set(key, []);
+    }
+    map.get(key)?.push(value);
+}
+/** @internal */
+exports.internal = {
+    moduleByFolder: [],
+    testStubMode: false,
+    knownAsync: new Map(),
+    knownRegisters: new Map(),
+    knownEvents: [],
+    interfaceConnections: {},
+    asyncContextReporter: undefined,
+    addAsyncProxy(module, proxy) {
+        addToMapArray(exports.internal.knownAsync, module, proxy);
+    },
+    addRegisteringProxy(module, proxy) {
+        addToMapArray(exports.internal.knownRegisters, module, proxy);
+    },
+};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":";;;AAKA,SAAS,aAAa,CAAC,GAA4B,EAAE,GAAW,EAAE,KAAU;IAC1E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,gBAAgB;AACH,QAAA,QAAQ,GAAG;IACtB,cAAc,EAAE,EAAmC;IACnD,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,IAAI,GAAG,EAAsB;IACzC,cAAc,EAAE,IAAI,GAAG,EAAsB;IAC7C,WAAW,EAAE,EAAW;IACxB,oBAAoB,EAAE,EAGrB;IACD,oBAAoB,EAAE,SAET;IAEb,aAAa,CAAC,MAAc,EAAE,KAAU;QACtC,aAAa,CAAC,gBAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,mBAAmB,CAAC,MAAc,EAAE,KAAU;QAC5C,aAAa,CAAC,gBAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/logging/index.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Provides a structured logging system with multiple severity levels and channels.
+ *
+ * The Logging namespace offers standardized functions for logging at different severity levels
+ * through a unified interface. It supports multiple channels for categorizing logs and
+ * uses an event-based system for log collection and processing.
+ */
+export declare namespace Logging {
+    /**
+     * Log severity levels in descending order of importance.
+     * Higher numerical values indicate higher severity.
+     */
+    enum Level {
+        /** Critical errors that may cause application failure */
+        ERROR = 40,
+        /** Important issues that don't prevent application functioning */
+        WARN = 30,
+        /** General application information and status updates */
+        INFO = 20,
+        /** Detailed information useful for debugging */
+        DEBUG = 10,
+        /** Highly detailed tracing information */
+        TRACE = 0,
+        /** Messages without prefix for direct display */
+        NO_PREFIX = -1
+    }
+    class Channel {
+        readonly channel: string;
+        constructor(channel: string);
+        /**
+         * Write arguments to the log channel at the ERROR level.
+         *
+         * Use for critical errors that may cause application failure or require immediate attention.
+         *
+         * @param args - Values to log, which can be of any type and will be serialized appropriately
+         */
+        Error(...args: any[]): void;
+        /**
+         * Write arguments to the log channel at the WARN level.
+         *
+         * Use for important issues that don't prevent the application from functioning
+         * but should be addressed.
+         *
+         * @param args - Values to log, which can be of any type and will be serialized appropriately
+         */
+        Warn(...args: any[]): void;
+        /**
+         * Write arguments to the log channel at the INFO level.
+         *
+         * Use for general application information and status updates that are useful
+         * for understanding the normal operation of the system.
+         *
+         * @param args - Values to log, which can be of any type and will be serialized appropriately
+         */
+        Info(...args: any[]): void;
+        /**
+         * Write arguments to the log channel at the DEBUG level.
+         *
+         * Use for detailed information useful for debugging and troubleshooting issues.
+         *
+         * @param args - Values to log, which can be of any type and will be serialized appropriately
+         */
+        Debug(...args: any[]): void;
+        /**
+         * Write arguments to the log channel at the TRACE level.
+         *
+         * Use for highly detailed tracing information, typically only enabled during
+         * intensive debugging sessions.
+         *
+         * @param args - Values to log, which can be of any type and will be serialized appropriately
+         */
+        Trace(...args: any[]): void;
+        /**
+         * Write arguments to the log channel at the given severity level.
+         *
+         * This is the core logging function that all other logging functions ultimately call.
+         * It emits an event with the log entry that can be captured by registered listeners.
+         *
+         * @param levelId - Severity level of the log entry (use values from the Level enum)
+         * @param args - Values to log, which can be of any type and will be serialized appropriately
+         */
+        Write(levelId: number, ...args: any[]): void;
+    }
+    /**
+     * Write arguments to the main log channel at the ERROR level.
+     *
+     * Use for critical errors that may cause application failure or require immediate attention.
+     *
+     * @param args - Values to log, which can be of any type and will be serialized appropriately
+     */
+    const Error: (...args: any[]) => void;
+    /**
+     * Write arguments to the main log channel at the WARN level.
+     *
+     * Use for important issues that don't prevent the application from functioning
+     * but should be addressed.
+     *
+     * @param args - Values to log, which can be of any type and will be serialized appropriately
+     */
+    const Warn: (...args: any[]) => void;
+    /**
+     * Write arguments to the main log channel at the INFO level.
+     *
+     * Use for general application information and status updates that are useful
+     * for understanding the normal operation of the system.
+     *
+     * @param args - Values to log, which can be of any type and will be serialized appropriately
+     */
+    const Info: (...args: any[]) => void;
+    /**
+     * Write arguments to the main log channel at the DEBUG level.
+     *
+     * Use for detailed information useful for debugging and troubleshooting issues.
+     *
+     * @param args - Values to log, which can be of any type and will be serialized appropriately
+     */
+    const Debug: (...args: any[]) => void;
+    /**
+     * Write arguments to the main log channel at the TRACE level.
+     *
+     * Use for highly detailed tracing information, typically only enabled during
+     * intensive debugging sessions.
+     *
+     * @param args - Values to log, which can be of any type and will be serialized appropriately
+     */
+    const Trace: (...args: any[]) => void;
+    /**
+     * Write arguments to the specified log channel at the given severity level.
+     *
+     * This is the core logging function that all other logging functions ultimately call.
+     * It emits an event with the log entry that can be captured by registered listeners.
+     *
+     * @param levelId - Severity level of the log entry (use values from the Level enum)
+     * @param channel - Name of the channel to log to, useful for categorizing logs
+     * @param args - Values to log, which can be of any type and will be serialized appropriately
+     */
+    function Write(levelId: number, channel: string, ...args: any[]): void;
+}
+export default Logging;