pi-extension-utils 0.3.3 → 0.4.0

package/dist/src/index.d.ts

@@ -1,6 +1,6 @@
 export { connect, type FullscreenComponentFactory, type FullscreenLease, type RemindersClient, type UtilsClient, type UtilsClientOptions, type WidgetSetOptions } from "./client/index.ts";
 export { defineConfig, type DeepPartial, type DefinedConfig, type DefineConfigOptions } from "./config/index.ts";
-export { createLogger, LOG_LEVELS, loggerLevelSchema, loggingConfigSchema, type Logger, type LoggerLevel, type LoggerOptions, type LoggingConfig, type LogLevel } from "./logger/index.ts";
+export { createLogger, LOG_LEVELS, loggerLevelSchema, loggingConfigSchema, type Logger, type LoggerLevel, type LoggerOptions, type LoggerRecord, type LoggingConfig, type LogLevel } from "./logger/index.ts";
 export { utilsConfigSchema, type UtilsConfig } from "./utils-config.ts";
 export * from "./pane/key-dispatch.ts";
 export * from "./pane/state.ts";

package/dist/src/logger/index.d.ts

@@ -3,7 +3,7 @@ export { LOG_LEVELS, loggerLevelSchema, loggingConfigSchema, type LoggerLevel, t
 export interface LoggerOptions {
     dir?: string;
     maxBytes?: number;
-    /** Number of rotated files to retain: name.log.1, name.log.2, ... */
+    /** Number of rotated files to retain: name.jsonl.1, name.jsonl.2, ... */
     maxFiles?: number;
     /** Minimum level to write. Defaults to utilsConfig.logging.level. */
     level?: LoggerLevel;
@@ -17,4 +17,9 @@ export interface Logger {
     setLevel(level: LoggerLevel): void;
     isEnabled(level: LogLevel): boolean;
 }
+export interface LoggerRecord {
+    ts: string;
+    level: LogLevel;
+    message: string;
+}
 export declare function createLogger(name: string, opts?: LoggerOptions): Logger;

package/dist/src/logger/index.js

@@ -21,7 +21,7 @@ export function createLogger(name, opts = {}) {
     const maxBytes = Math.max(0, Math.floor(opts.maxBytes ?? configured?.maxBytes ?? 1024 * 1024));
     const maxFiles = Math.max(0, Math.floor(opts.maxFiles ?? configured?.maxFiles ?? 3));
     let level = opts.level ?? configured?.level ?? "info";
-    const file = join(dir, `${name}.log`);
+    const file = join(dir, `${name}.jsonl`);
     mkdirSync(dirname(file), { recursive: true });
     function rotateIfNeeded(nextBytes) {
         if (maxBytes <= 0 || !existsSync(file))
@@ -49,7 +49,7 @@ export function createLogger(name, opts = {}) {
     function log(candidate, message) {
         if (!isEnabled(candidate))
             return;
-        const line = `${new Date().toISOString()} ${candidate} ${message}\n`;
+        const line = `${JSON.stringify({ ts: new Date().toISOString(), level: candidate, message })}\n`;
         mkdirSync(dirname(file), { recursive: true });
         rotateIfNeeded(Buffer.byteLength(line));
         appendFileSync(file, line);

package/docs/client.md

@@ -82,7 +82,7 @@ log.warn("slow path");
 log.error("failed");
 ```
 
-`createLogger(name)` writes to `getAgentDir()/log/<name>.log` by default. `level` is typed as `"debug" | "info" | "warn" | "error" | "silent"`; `maxFiles` controls retained rotations (`.1`, `.2`, ...). If `level`, `maxFiles`, or `maxBytes` are omitted, the value comes from `getAgentDir()/config/utils.jsonc` `logging` defaults. Explicit options always win.
+`createLogger(name)` writes JSONL to `getAgentDir()/log/<name>.jsonl` by default. Each line is `{"ts":"...","level":"info","message":"started"}`. `level` is typed as `"debug" | "info" | "warn" | "error" | "silent"`; `maxFiles` controls retained rotations (`.1`, `.2`, ...). If `level`, `maxFiles`, or `maxBytes` are omitted, the value comes from `getAgentDir()/config/utils.jsonc` `logging` defaults. Explicit options always win.
 
 Override when needed:
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-extension-utils",
-	"version": "0.3.3",
+	"version": "0.4.0",
 	"description": "Shared Pi extension utilities for coordinated widgets, fullscreen leases, and logging.",
 	"type": "module",
 	"main": "./dist/src/index.js",