@hardlydifficult/logger 1.0.0

package/README.md

@@ -0,0 +1,117 @@
+# @hardlydifficult/logger
+
+Plugin-based structured logger with Console, Discord, and File output plugins.
+
+## Installation
+
+```bash
+npm install @hardlydifficult/logger
+```
+
+## Usage
+
+```typescript
+import { Logger, ConsolePlugin, FilePlugin, DiscordPlugin } from "@hardlydifficult/logger";
+
+const discord = new DiscordPlugin();
+
+const logger = new Logger("info")
+  .use(new ConsolePlugin())
+  .use(new FilePlugin("/var/log/app.log"))
+  .use(discord);
+
+// Wire up Discord sender once the bot is ready
+discord.setSender((msg) => channel.send(msg));
+
+logger.info("Server started", { port: 3000 });
+logger.warn("High memory usage", { usage: "85%" });
+logger.error("Request failed", { url: "/api/data", status: 500 });
+
+// Out-of-band notification (goes to plugins that support notify)
+logger.notify("Deployment complete");
+```
+
+## API
+
+### `Logger`
+
+```typescript
+new Logger(minLevel?: LogLevel) // default: "info"
+```
+
+| Method | Description |
+|--------|-------------|
+| `use(plugin)` | Register a plugin (returns `this` for chaining) |
+| `debug(message, context?)` | Log at debug level |
+| `info(message, context?)` | Log at info level |
+| `warn(message, context?)` | Log at warn level |
+| `error(message, context?)` | Log at error level |
+| `notify(message)` | Send out-of-band notification to plugins that support it |
+
+Log levels: `debug` < `info` < `warn` < `error`. Entries below `minLevel` are filtered out.
+
+### Plugins
+
+#### `ConsolePlugin`
+
+Logs to `console.log`/`console.warn`/`console.error` with formatted timestamps.
+
+```typescript
+new ConsolePlugin()
+```
+
+#### `FilePlugin`
+
+Appends JSON log entries to a file (one entry per line). Creates the directory if needed.
+
+```typescript
+new FilePlugin(filePath: string)
+```
+
+#### `DiscordPlugin`
+
+Sends warn/error logs and notifications to Discord. The sender is set lazily since the Discord connection may not be ready at logger creation time.
+
+```typescript
+const discord = new DiscordPlugin();
+discord.setSender((msg) => channel.send(msg));
+```
+
+### Custom Plugins
+
+Implement the `LoggerPlugin` interface:
+
+```typescript
+import type { LoggerPlugin, LogEntry } from "@hardlydifficult/logger";
+
+class MyPlugin implements LoggerPlugin {
+  log(entry: LogEntry): void {
+    // Handle log entry
+  }
+
+  // Optional: handle notify() calls
+  notify?(message: string): void {
+    // Handle notification
+  }
+}
+
+logger.use(new MyPlugin());
+```
+
+### Types
+
+```typescript
+type LogLevel = "debug" | "info" | "warn" | "error";
+
+interface LogEntry {
+  readonly level: LogLevel;
+  readonly message: string;
+  readonly timestamp: string;
+  readonly context?: Readonly<Record<string, unknown>>;
+}
+
+interface LoggerPlugin {
+  log(entry: LogEntry): void;
+  notify?(message: string): void;
+}
+```

package/dist/Logger.d.ts

@@ -0,0 +1,15 @@
+import type { LoggerPlugin, LogLevel } from "./types.js";
+export declare class Logger {
+    private readonly minLevel;
+    private readonly plugins;
+    constructor(minLevel?: LogLevel);
+    use(plugin: LoggerPlugin): this;
+    debug(message: string, context?: Readonly<Record<string, unknown>>): void;
+    info(message: string, context?: Readonly<Record<string, unknown>>): void;
+    warn(message: string, context?: Readonly<Record<string, unknown>>): void;
+    error(message: string, context?: Readonly<Record<string, unknown>>): void;
+    notify(message: string): void;
+    private shouldLog;
+    private log;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AASnE,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAElC,QAAQ,GAAE,QAAiB;IAIvC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAK/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAIzE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAIxE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAIxE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAIzE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAY7B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,GAAG;CAsBZ"}

package/dist/Logger.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+class Logger {
+    minLevel;
+    plugins = [];
+    constructor(minLevel = "info") {
+        this.minLevel = minLevel;
+    }
+    use(plugin) {
+        this.plugins.push(plugin);
+        return this;
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    notify(message) {
+        for (const plugin of this.plugins) {
+            if (plugin.notify) {
+                try {
+                    plugin.notify(message);
+                }
+                catch {
+                    /* swallow */
+                }
+            }
+        }
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.minLevel];
+    }
+    log(level, message, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = context !== undefined
+            ? { level, message, timestamp: new Date().toISOString(), context }
+            : { level, message, timestamp: new Date().toISOString() };
+        for (const plugin of this.plugins) {
+            try {
+                plugin.log(entry);
+            }
+            catch {
+                /* swallow */
+            }
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=Logger.js.map

package/dist/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":";;;AAEA,MAAM,UAAU,GAAuC;IACrD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAa,MAAM;IACA,QAAQ,CAAW;IACnB,OAAO,GAAmB,EAAE,CAAC;IAE9C,YAAY,WAAqB,MAAM;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,MAAoB;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAA2C;QAChE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAA2C;QAC/D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAA2C;QAC/D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAA2C;QAChE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,aAAa;gBACf,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAEO,GAAG,CACT,KAAe,EACf,OAAe,EACf,OAA2C;QAE3C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GACT,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE;YAClE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAE9D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa;YACf,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnED,wBAmEC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Logger } from "./Logger.js";
+export { ConsolePlugin, formatEntry } from "./plugins/ConsolePlugin.js";
+export { DiscordPlugin, type DiscordSender } from "./plugins/DiscordPlugin.js";
+export { FilePlugin } from "./plugins/FilePlugin.js";
+export type { LogLevel, LogEntry, LoggerPlugin } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilePlugin = exports.DiscordPlugin = exports.formatEntry = exports.ConsolePlugin = exports.Logger = void 0;
+var Logger_js_1 = require("./Logger.js");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_js_1.Logger; } });
+var ConsolePlugin_js_1 = require("./plugins/ConsolePlugin.js");
+Object.defineProperty(exports, "ConsolePlugin", { enumerable: true, get: function () { return ConsolePlugin_js_1.ConsolePlugin; } });
+Object.defineProperty(exports, "formatEntry", { enumerable: true, get: function () { return ConsolePlugin_js_1.formatEntry; } });
+var DiscordPlugin_js_1 = require("./plugins/DiscordPlugin.js");
+Object.defineProperty(exports, "DiscordPlugin", { enumerable: true, get: function () { return DiscordPlugin_js_1.DiscordPlugin; } });
+var FilePlugin_js_1 = require("./plugins/FilePlugin.js");
+Object.defineProperty(exports, "FilePlugin", { enumerable: true, get: function () { return FilePlugin_js_1.FilePlugin; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,+DAAwE;AAA/D,iHAAA,aAAa,OAAA;AAAE,+GAAA,WAAW,OAAA;AACnC,+DAA+E;AAAtE,iHAAA,aAAa,OAAA;AACtB,yDAAqD;AAA5C,2GAAA,UAAU,OAAA"}

package/dist/plugins/ConsolePlugin.d.ts

@@ -0,0 +1,6 @@
+import type { LogEntry, LoggerPlugin } from "../types.js";
+export declare function formatEntry(entry: LogEntry): string;
+export declare class ConsolePlugin implements LoggerPlugin {
+    log(entry: LogEntry): void;
+}
+//# sourceMappingURL=ConsolePlugin.d.ts.map

package/dist/plugins/ConsolePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsolePlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/ConsolePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAMnD;AAED,qBAAa,aAAc,YAAW,YAAY;IAChD,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAmB3B"}

package/dist/plugins/ConsolePlugin.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsolePlugin = void 0;
+exports.formatEntry = formatEntry;
+function formatEntry(entry) {
+    const base = `[${entry.timestamp}] ${entry.level.toUpperCase()}: ${entry.message}`;
+    if (entry.context && Object.keys(entry.context).length > 0) {
+        return `${base} ${JSON.stringify(entry.context)}`;
+    }
+    return base;
+}
+class ConsolePlugin {
+    log(entry) {
+        const formatted = formatEntry(entry);
+        switch (entry.level) {
+            case "debug":
+            case "info":
+                // eslint-disable-next-line no-console
+                console.log(formatted);
+                break;
+            case "warn":
+                console.warn(formatted);
+                break;
+            case "error":
+                console.error(formatted);
+                break;
+            default:
+                console.warn(formatted);
+                break;
+        }
+    }
+}
+exports.ConsolePlugin = ConsolePlugin;
+//# sourceMappingURL=ConsolePlugin.js.map

package/dist/plugins/ConsolePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsolePlugin.js","sourceRoot":"","sources":["../../src/plugins/ConsolePlugin.ts"],"names":[],"mappings":";;;AAEA,kCAMC;AAND,SAAgB,WAAW,CAAC,KAAe;IACzC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACnF,IAAI,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAa,aAAa;IACxB,GAAG,CAAC,KAAe;QACjB,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACrC,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,KAAK,OAAO,CAAC;YACb,KAAK,MAAM;gBACT,sCAAsC;gBACtC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACzB,MAAM;YACR;gBACE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,MAAM;QACV,CAAC;IACH,CAAC;CACF;AApBD,sCAoBC"}

package/dist/plugins/DiscordPlugin.d.ts

@@ -0,0 +1,9 @@
+import type { LogEntry, LoggerPlugin } from "../types.js";
+export type DiscordSender = (message: string) => void;
+export declare class DiscordPlugin implements LoggerPlugin {
+    private sender;
+    setSender(sender: DiscordSender): void;
+    log(entry: LogEntry): void;
+    notify(message: string): void;
+}
+//# sourceMappingURL=DiscordPlugin.d.ts.map

package/dist/plugins/DiscordPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscordPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/DiscordPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtD,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,MAAM,CAA8B;IAE5C,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAItC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAqB1B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAU9B"}

package/dist/plugins/DiscordPlugin.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscordPlugin = void 0;
+class DiscordPlugin {
+    sender = null;
+    setSender(sender) {
+        this.sender = sender;
+    }
+    log(entry) {
+        if (!this.sender) {
+            return;
+        }
+        if (entry.level !== "warn" && entry.level !== "error") {
+            return;
+        }
+        const prefix = entry.level === "error" ? "\u{1f6a8}" : "\u{26a0}\u{fe0f}";
+        const discordMessage = entry.context && Object.keys(entry.context).length > 0
+            ? `${prefix} **${entry.level.toUpperCase()}**: ${entry.message}\n\`\`\`json\n${JSON.stringify(entry.context, null, 2)}\n\`\`\``
+            : `${prefix} **${entry.level.toUpperCase()}**: ${entry.message}`;
+        try {
+            this.sender(discordMessage);
+        }
+        catch {
+            /* swallow */
+        }
+    }
+    notify(message) {
+        if (!this.sender) {
+            return;
+        }
+        try {
+            this.sender(message);
+        }
+        catch {
+            /* swallow */
+        }
+    }
+}
+exports.DiscordPlugin = DiscordPlugin;
+//# sourceMappingURL=DiscordPlugin.js.map

package/dist/plugins/DiscordPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscordPlugin.js","sourceRoot":"","sources":["../../src/plugins/DiscordPlugin.ts"],"names":[],"mappings":";;;AAIA,MAAa,aAAa;IAChB,MAAM,GAAyB,IAAI,CAAC;IAE5C,SAAS,CAAC,MAAqB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,KAAe;QACjB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAC1E,MAAM,cAAc,GAClB,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;YACpD,CAAC,CAAC,GAAG,MAAM,MAAM,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,KAAK,CAAC,OAAO,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU;YAC/H,CAAC,CAAC,GAAG,MAAM,MAAM,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;QAErE,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;CACF;AAtCD,sCAsCC"}

package/dist/plugins/FilePlugin.d.ts

@@ -0,0 +1,7 @@
+import type { LogEntry, LoggerPlugin } from "../types.js";
+export declare class FilePlugin implements LoggerPlugin {
+    private readonly filePath;
+    constructor(filePath: string);
+    log(entry: LogEntry): void;
+}
+//# sourceMappingURL=FilePlugin.d.ts.map

package/dist/plugins/FilePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/FilePlugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,qBAAa,UAAW,YAAW,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAK5B,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAQ3B"}

package/dist/plugins/FilePlugin.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilePlugin = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+class FilePlugin {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(filePath), { recursive: true });
+    }
+    log(entry) {
+        const line = `${JSON.stringify(entry)}\n`;
+        try {
+            (0, node_fs_1.appendFileSync)(this.filePath, line);
+        }
+        catch {
+            /* swallow */
+        }
+    }
+}
+exports.FilePlugin = FilePlugin;
+//# sourceMappingURL=FilePlugin.js.map

package/dist/plugins/FilePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePlugin.js","sourceRoot":"","sources":["../../src/plugins/FilePlugin.ts"],"names":[],"mappings":";;;AAAA,qCAAoD;AACpD,yCAAoC;AAIpC,MAAa,UAAU;IACJ,QAAQ,CAAS;IAElC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,GAAG,CAAC,KAAe;QACjB,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;QAC1C,IAAI,CAAC;YACH,IAAA,wBAAc,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;CACF;AAhBD,gCAgBC"}

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogEntry {
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly timestamp: string;
+    readonly context?: Readonly<Record<string, unknown>>;
+}
+export interface LoggerPlugin {
+    /** Called for each log entry that passes the level filter. */
+    log(entry: LogEntry): void;
+    /** Called for notify() — out-of-band notifications. Optional. */
+    notify?(message: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@hardlydifficult/logger",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.31",
+    "typescript": "5.8.3",
+    "vitest": "1.6.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}