@skmtc/core 0.0.684 → 0.0.685

package/esm/deps/jsr.io/@std/log/0.224.14/base_handler.d.ts

@@ -0,0 +1,326 @@
+import { type LevelName, type LogLevel } from "./levels.js";
+import type { LogRecord } from "./logger.js";
+export type { LevelName, LogLevel, LogRecord };
+/**
+ * A function type that defines the structure of a formatter function.
+ *
+ * @param logRecord The log record that needs to be formatted.
+ * @returns A string representation of the log record.
+ */
+export type FormatterFunction = (logRecord: LogRecord) => string;
+/** Options for {@linkcode BaseHandler}. */
+export interface BaseHandlerOptions {
+    /** A function that formats log records. */
+    formatter?: FormatterFunction;
+}
+/**
+ * A base class for all log handlers.
+ *
+ * This class is abstract and should not be instantiated directly. Instead, it
+ * should be extended by other classes that implement the `log` method.
+ *
+ * @example Usage
+ * ```ts
+ * import { BaseHandler } from "@std/log/base-handler";
+ * import { assertInstanceOf } from "@std/assert/instance-of";
+ *
+ * class MyHandler extends BaseHandler {
+ *   log(msg: string) {
+ *     console.log(msg);
+ *   }
+ * }
+ *
+ * const handler = new MyHandler("INFO");
+ * assertInstanceOf(handler, BaseHandler);
+ * ```
+ */
+export declare abstract class BaseHandler {
+    #private;
+    /**
+     * The function that formats log records.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogRecord } from "@std/log/logger";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *  log(msg: string) {
+     *   console.log(msg);
+     * }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * const record = new LogRecord({
+     *   msg: "Hello, world!",
+     *   args: ["foo", "bar"],
+     *   level: LogLevels.INFO,
+     *   loggerName: "example",
+     * });
+     * const formatted = handler.formatter(record);
+     * assertEquals(formatted, "INFO Hello, world!");
+     * ```
+     */
+    formatter: FormatterFunction;
+    /**
+     * Constructs a new instance.
+     *
+     * @param levelName The name of the log level to handle.
+     * @param options Options for the handler.
+     */
+    constructor(levelName: LevelName, options?: BaseHandlerOptions);
+    /**
+     * Getter for the log level that this handler will handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * assertEquals(handler.level, LogLevels.INFO);
+     * ```
+     *
+     * @returns The log level to handle.
+     */
+    get level(): LogLevel;
+    /**
+     * Setter for the log level that this handler will handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.level = LogLevels.DEBUG;
+     * assertEquals(handler.level, LogLevels.DEBUG);
+     * ```
+     *
+     * @param level The log level to handle.
+     */
+    set level(level: LogLevel);
+    /**
+     * Getter for the name of the log level that this handler will handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * assertEquals(handler.levelName, "INFO");
+     * ```
+     *
+     * @returns The name of the log level to handle.
+     */
+    get levelName(): LevelName;
+    /**
+     * Setter for the name of the log level that this handler will handle.
+     *
+     * @param levelName The name of the log level to handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.levelName = "DEBUG";
+     * assertEquals(handler.levelName, "DEBUG");
+     * ```
+     */
+    set levelName(levelName: LevelName);
+    /**
+     * Handles a log record.
+     *
+     * @param logRecord The log record to handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogRecord } from "@std/log/logger";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * const record = new LogRecord({
+     *   msg: "Hello, world!",
+     *   args: ["foo", "bar"],
+     *   level: LogLevels.INFO,
+     *   loggerName: "example",
+     * });
+     * handler.handle(record);
+     *
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    handle(logRecord: LogRecord): void;
+    /**
+     * Formats a log record.
+     *
+     * @param logRecord The log record to format.
+     * @returns A string representation of the log record.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogRecord } from "@std/log/logger";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * const record = new LogRecord({
+     *   msg: "Hello, world!",
+     *   args: ["foo", "bar"],
+     *   level: LogLevels.INFO,
+     *   loggerName: "example",
+     * });
+     * const formatted = handler.format(record);
+     * assertEquals(formatted, "INFO Hello, world!");
+     * ```
+     */
+    format(logRecord: LogRecord): string;
+    /**
+     * Logs a message.
+     *
+     * This method should be implemented by subclasses to handle the log record.
+     *
+     * @param msg The message to log.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.log("Hello, world!"); // Prints "Hello, world!"
+     *
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    abstract log(msg: string): void;
+    /**
+     * Initializes the handler.
+     *
+     * This method is called when the handler is added to a logger. It can be
+     * used to perform any setup that is required by the handler.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     *
+     *   override setup() {
+     *     console.log("Handler setup!");
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.setup(); // Prints "Handler setup!"
+     *
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    setup(): void;
+    /**
+     * Destroys the handler, performing any cleanup that is required.
+     *
+     * This method is called when the handler is removed from a logger. It can be
+     * used to perform any cleanup that is required by the handler.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     *
+     *   override destroy() {
+     *     console.log("Handler destroyed!");
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.destroy(); // Prints "Handler destroyed!"
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    destroy(): void;
+    /**
+     * Automatically disposes of the handler when instantiated with the `using`
+     * keyword by calling the {@linkcode BaseHandler.destroy} method.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogRecord } from "@std/log/logger";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * using handler = new MyHandler("INFO");
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=base_handler.d.ts.map

package/esm/deps/jsr.io/@std/log/0.224.14/base_handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_handler.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/log/0.224.14/base_handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,SAAS,KAAK,MAAM,CAAC;AAIjE,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,WAAW;;IAG/B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,EAAE,iBAAiB,CAAC;IAE7B;;;;;OAKG;gBAED,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,kBAAkB;IAQ9B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,KAAK,CAAC,KAAK,EAAE,QAAQ,EAGxB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,SAAS,CAAC,SAAS,EAAE,SAAS,EAGjC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS;IAO3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIpC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,KAAK;IAEL;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO;IAEP;;;;;;;;;;;;;;;;;;;OAmBG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;CAGjB"}

package/esm/deps/jsr.io/@std/log/0.224.14/base_handler.js

@@ -0,0 +1,331 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _BaseHandler_levelName, _BaseHandler_level;
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { getLevelByName, getLevelName, } from "./levels.js";
+const DEFAULT_FORMATTER = ({ levelName, msg }) => `${levelName} ${msg}`;
+/**
+ * A base class for all log handlers.
+ *
+ * This class is abstract and should not be instantiated directly. Instead, it
+ * should be extended by other classes that implement the `log` method.
+ *
+ * @example Usage
+ * ```ts
+ * import { BaseHandler } from "@std/log/base-handler";
+ * import { assertInstanceOf } from "@std/assert/instance-of";
+ *
+ * class MyHandler extends BaseHandler {
+ *   log(msg: string) {
+ *     console.log(msg);
+ *   }
+ * }
+ *
+ * const handler = new MyHandler("INFO");
+ * assertInstanceOf(handler, BaseHandler);
+ * ```
+ */
+export class BaseHandler {
+    /**
+     * Constructs a new instance.
+     *
+     * @param levelName The name of the log level to handle.
+     * @param options Options for the handler.
+     */
+    constructor(levelName, options) {
+        _BaseHandler_levelName.set(this, void 0);
+        _BaseHandler_level.set(this, void 0);
+        /**
+         * The function that formats log records.
+         *
+         * @example Usage
+         * ```ts
+         * import { BaseHandler } from "@std/log/base-handler";
+         * import { LogRecord } from "@std/log/logger";
+         * import { LogLevels } from "@std/log/levels";
+         * import { assertEquals } from "@std/assert/equals";
+         *
+         * class MyHandler extends BaseHandler {
+         *  log(msg: string) {
+         *   console.log(msg);
+         * }
+         * }
+         *
+         * const handler = new MyHandler("INFO");
+         * const record = new LogRecord({
+         *   msg: "Hello, world!",
+         *   args: ["foo", "bar"],
+         *   level: LogLevels.INFO,
+         *   loggerName: "example",
+         * });
+         * const formatted = handler.formatter(record);
+         * assertEquals(formatted, "INFO Hello, world!");
+         * ```
+         */
+        Object.defineProperty(this, "formatter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        const { formatter = DEFAULT_FORMATTER } = options ?? {};
+        __classPrivateFieldSet(this, _BaseHandler_levelName, levelName, "f");
+        __classPrivateFieldSet(this, _BaseHandler_level, getLevelByName(levelName), "f");
+        this.formatter = formatter;
+    }
+    /**
+     * Getter for the log level that this handler will handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * assertEquals(handler.level, LogLevels.INFO);
+     * ```
+     *
+     * @returns The log level to handle.
+     */
+    get level() {
+        return __classPrivateFieldGet(this, _BaseHandler_level, "f");
+    }
+    /**
+     * Setter for the log level that this handler will handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.level = LogLevels.DEBUG;
+     * assertEquals(handler.level, LogLevels.DEBUG);
+     * ```
+     *
+     * @param level The log level to handle.
+     */
+    set level(level) {
+        __classPrivateFieldSet(this, _BaseHandler_level, level, "f");
+        __classPrivateFieldSet(this, _BaseHandler_levelName, getLevelName(level), "f");
+    }
+    /**
+     * Getter for the name of the log level that this handler will handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * assertEquals(handler.levelName, "INFO");
+     * ```
+     *
+     * @returns The name of the log level to handle.
+     */
+    get levelName() {
+        return __classPrivateFieldGet(this, _BaseHandler_levelName, "f");
+    }
+    /**
+     * Setter for the name of the log level that this handler will handle.
+     *
+     * @param levelName The name of the log level to handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.levelName = "DEBUG";
+     * assertEquals(handler.levelName, "DEBUG");
+     * ```
+     */
+    set levelName(levelName) {
+        __classPrivateFieldSet(this, _BaseHandler_levelName, levelName, "f");
+        __classPrivateFieldSet(this, _BaseHandler_level, getLevelByName(levelName), "f");
+    }
+    /**
+     * Handles a log record.
+     *
+     * @param logRecord The log record to handle.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogRecord } from "@std/log/logger";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * const record = new LogRecord({
+     *   msg: "Hello, world!",
+     *   args: ["foo", "bar"],
+     *   level: LogLevels.INFO,
+     *   loggerName: "example",
+     * });
+     * handler.handle(record);
+     *
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    handle(logRecord) {
+        if (this.level > logRecord.level)
+            return;
+        const msg = this.format(logRecord);
+        this.log(msg);
+    }
+    /**
+     * Formats a log record.
+     *
+     * @param logRecord The log record to format.
+     * @returns A string representation of the log record.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogRecord } from "@std/log/logger";
+     * import { LogLevels } from "@std/log/levels";
+     * import { assertEquals } from "@std/assert/equals";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * const record = new LogRecord({
+     *   msg: "Hello, world!",
+     *   args: ["foo", "bar"],
+     *   level: LogLevels.INFO,
+     *   loggerName: "example",
+     * });
+     * const formatted = handler.format(record);
+     * assertEquals(formatted, "INFO Hello, world!");
+     * ```
+     */
+    format(logRecord) {
+        return this.formatter(logRecord);
+    }
+    /**
+     * Initializes the handler.
+     *
+     * This method is called when the handler is added to a logger. It can be
+     * used to perform any setup that is required by the handler.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     *
+     *   override setup() {
+     *     console.log("Handler setup!");
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.setup(); // Prints "Handler setup!"
+     *
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    setup() { }
+    /**
+     * Destroys the handler, performing any cleanup that is required.
+     *
+     * This method is called when the handler is removed from a logger. It can be
+     * used to perform any cleanup that is required by the handler.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     *
+     *   override destroy() {
+     *     console.log("Handler destroyed!");
+     *   }
+     * }
+     *
+     * const handler = new MyHandler("INFO");
+     * handler.destroy(); // Prints "Handler destroyed!"
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    destroy() { }
+    /**
+     * Automatically disposes of the handler when instantiated with the `using`
+     * keyword by calling the {@linkcode BaseHandler.destroy} method.
+     *
+     * @example Usage
+     * ```ts
+     * import { BaseHandler } from "@std/log/base-handler";
+     * import { LogRecord } from "@std/log/logger";
+     * import { assertInstanceOf } from "@std/assert/instance-of";
+     *
+     * class MyHandler extends BaseHandler {
+     *   log(msg: string) {
+     *     console.log(msg);
+     *   }
+     * }
+     *
+     * using handler = new MyHandler("INFO");
+     * assertInstanceOf(handler, BaseHandler);
+     * ```
+     */
+    [(_BaseHandler_levelName = new WeakMap(), _BaseHandler_level = new WeakMap(), Symbol.dispose)]() {
+        this.destroy();
+    }
+}