@nubisco/openbridge-logger 0.29.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nubisco Lda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @nubisco/openbridge-logger
+
+Structured logger with an in-memory ring buffer and WebSocket streaming, used by the OpenBridge daemon and by plugins.
+
+Part of [OpenBridge](https://github.com/nubisco/openbridge), a local-first home automation bridge for developers.
+
+## Install
+
+```sh
+npm install @nubisco/openbridge-logger
+```
+
+Requires Node.js >= 20.
+
+## Documentation
+
+See the [OpenBridge documentation](https://github.com/nubisco/openbridge#readme). This package is published from the OpenBridge monorepo and versioned in lockstep with the `openbridge` daemon.
+
+## License
+
+MIT (c) Jose Silva

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { LogLevel, LogEntry, LogListener } from './types.js';
+export { Logger } from './logger.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,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { Logger } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,18 @@
+import type { LogLevel, LogEntry, LogListener } from './types.js';
+export declare class Logger {
+    private static listeners;
+    private static minLevel;
+    private static maxEntries;
+    private static entries;
+    static setLevel(level: LogLevel): void;
+    static subscribe(listener: LogListener): () => void;
+    static getEntries(plugin?: string, limit?: number): LogEntry[];
+    static clear(): void;
+    static create(plugin: string): {
+        debug: (message: string, ...args: unknown[]) => void;
+        info: (message: string, ...args: unknown[]) => void;
+        warn: (message: string, ...args: unknown[]) => void;
+        error: (message: string, ...args: unknown[]) => void;
+    };
+}
+//# 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":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAIjE,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoB;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAO;IAChC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAiB;IAEvC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAI/B,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW;IAOtC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,QAAQ,EAAE;IAK3D,MAAM,CAAC,KAAK;IAIZ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM;yBA8BP,MAAM,WAAW,OAAO,EAAE;wBAC3B,MAAM,WAAW,OAAO,EAAE;wBAC1B,MAAM,WAAW,OAAO,EAAE;yBACzB,MAAM,WAAW,OAAO,EAAE;;CAGhD"}

package/dist/logger.js

@@ -0,0 +1,56 @@
+import { format } from 'util';
+const LEVEL_ORDER = { debug: 0, info: 1, warn: 2, error: 3 };
+export class Logger {
+    static listeners = [];
+    static minLevel = 'info';
+    static maxEntries = 1000;
+    static entries = [];
+    static setLevel(level) {
+        this.minLevel = level;
+    }
+    static subscribe(listener) {
+        this.listeners.push(listener);
+        return () => {
+            this.listeners = this.listeners.filter((l) => l !== listener);
+        };
+    }
+    static getEntries(plugin, limit = 200) {
+        const filtered = plugin ? this.entries.filter((e) => e.plugin === plugin) : this.entries;
+        return filtered.slice(-limit);
+    }
+    static clear() {
+        this.entries = [];
+    }
+    static create(plugin) {
+        const log = (level, message, args) => {
+            if (LEVEL_ORDER[level] < LEVEL_ORDER[Logger.minLevel])
+                return;
+            // Resolve printf-style placeholders (%s, %d, %o) used by Homebridge plugins
+            const formatted = args.length > 0 ? format(message, ...args) : message;
+            const entry = {
+                timestamp: new Date().toISOString(),
+                level,
+                plugin,
+                message: formatted,
+            };
+            Logger.entries.push(entry);
+            if (Logger.entries.length > Logger.maxEntries) {
+                Logger.entries.shift();
+            }
+            Logger.listeners.forEach((l) => l(entry));
+            // Also write to stdout with color
+            const color = { debug: '\x1b[90m', info: '\x1b[36m', warn: '\x1b[33m', error: '\x1b[31m' }[level];
+            const reset = '\x1b[0m';
+            const pluginTag = plugin !== 'system' ? `\x1b[35m[${plugin}]\x1b[0m ` : '';
+            const levelTag = `${color}[${level.toUpperCase()}]${reset}`;
+            console.log(`${entry.timestamp} ${levelTag} ${pluginTag}${formatted}`);
+        };
+        return {
+            debug: (message, ...args) => log('debug', message, args),
+            info: (message, ...args) => log('info', message, args),
+            warn: (message, ...args) => log('warn', message, args),
+            error: (message, ...args) => log('error', message, args),
+        };
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    plugin: string;
+    message: string;
+    args?: unknown[];
+}
+export type LogListener = (entry: LogEntry) => 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,CAAA;AAE1D,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# 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,51 @@
+{
+  "name": "@nubisco/openbridge-logger",
+  "version": "0.29.0",
+  "description": "Structured logger with in-memory buffer and WebSocket streaming for OpenBridge",
+  "author": "José Silva <jose@nubisco.io>",
+  "license": "MIT",
+  "homepage": "https://github.com/nubisco/openbridge#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nubisco/openbridge.git",
+    "directory": "packages/logger"
+  },
+  "bugs": {
+    "url": "https://github.com/nubisco/openbridge/issues"
+  },
+  "keywords": [
+    "logger",
+    "structured-logging",
+    "typescript",
+    "openbridge"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}