@shetty4l/core 0.1.26 → 0.1.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shetty4l/core",
-  "version": "0.1.26",
+  "version": "0.1.29",
   "description": "Shared infrastructure primitives for Bun/TypeScript services",
   "repository": {
     "type": "git",
@@ -17,7 +17,8 @@
     "./cli": "./src/cli.ts",
     "./daemon": "./src/daemon.ts",
     "./db": "./src/db.ts",
-    "./http": "./src/http.ts"
+    "./http": "./src/http.ts",
+    "./log": "./src/log.ts"
   },
   "files": [
     "src/",

package/src/cli.ts

@@ -81,7 +81,9 @@ export function createLogsCommand(opts: LogsCommandOpts): CommandHandler {
       return 0;
     }
 
-    const text = await file.text();
+    const raw = await file.text();
+    // Strip null bytes that can appear from historical Bun.file() corruption
+    const text = raw.replaceAll("\0", "");
     const allLines = text.split("\n").filter((l) => l.length > 0);
 
     if (allLines.length === 0) {

package/src/daemon.ts

@@ -13,6 +13,7 @@ import {
   mkdirSync,
   openSync,
   readFileSync,
+  renameSync,
   unlinkSync,
 } from "fs";
 import { join } from "path";
@@ -160,10 +161,20 @@ export function createDaemonManager(opts: DaemonManagerOpts): DaemonManager {
         mkdirSync(configDir, { recursive: true });
       }
 
-      // Open log file in append mode so previous content is preserved
-      // and ongoing console.error output from the child is captured.
+      // Rotate previous log file so it doesn't grow unbounded.
+      // Keep one generation: service.log -> service.log.old
+      if (existsSync(logFile)) {
+        try {
+          renameSync(logFile, `${logFile}.old`);
+        } catch {
+          // Best-effort — if rotation fails, append to existing file
+        }
+      }
+
+      // Open log file in append mode so ongoing console.error output
+      // from the child is captured.
       // Bun.file() opens with O_WRONLY|O_CREAT (no append, no truncate)
-      // which writes from offset 0 and corrupts logs.
+      // which writes from offset 0 and corrupts logs — always use openSync("a").
       const logFd = openSync(logFile, "a");
 
       const proc = Bun.spawn(["bun", "run", cliPath, serveCommand], {

package/src/http.ts

@@ -81,6 +81,17 @@ export interface ServerOpts {
     req: Request,
     url: URL,
   ) => Response | Promise<Response> | null | Promise<Response | null>;
+  /**
+   * Optional custom health endpoint handler.
+   * When provided, called instead of the default healthResponse().
+   * Return a full Response to control both body and HTTP status
+   * (e.g. 503 for degraded state). Use healthResponse() inside
+   * the handler for the standard healthy case.
+   */
+  onHealth?: (
+    version: string,
+    startTime: number,
+  ) => Response | Promise<Response>;
 }
 
 export interface HttpServer {
@@ -100,7 +111,7 @@ export interface HttpServer {
  *   4. If onRequest returns null -> 404
  */
 export function createServer(opts: ServerOpts): HttpServer {
-  const { port, host = "127.0.0.1", version, onRequest, name } = opts;
+  const { port, host = "127.0.0.1", version, onRequest, onHealth, name } = opts;
   const startTime = Date.now();
   const prefix = name ? `${name}: ` : "";
 
@@ -115,7 +126,9 @@ export function createServer(opts: ServerOpts): HttpServer {
       }
 
       if (url.pathname === "/health" && req.method === "GET") {
-        return healthResponse(version, startTime);
+        return onHealth
+          ? onHealth(version, startTime)
+          : healthResponse(version, startTime);
       }
 
       try {

package/src/index.ts

@@ -4,7 +4,7 @@
  * Shared infrastructure primitives for Bun/TypeScript services.
  *
  * Import from the root for convenience, or from sub-paths for specificity:
- *   import { config, http } from "@shetty4l/core"
+ *   import { config, http, log } from "@shetty4l/core"
  *   import { parsePort } from "@shetty4l/core/config"
  */
 
@@ -14,6 +14,7 @@ export * as config from "./config";
 export * as daemon from "./daemon";
 export * as db from "./db";
 export * as http from "./http";
+export * as log from "./log";
 export type { Err, Ok, Port, Result } from "./result";
 export { err, ok } from "./result";
 export type { ShutdownOpts } from "./signals";

package/src/log.ts

@@ -0,0 +1,29 @@
+/**
+ * Lightweight structured logger for all services.
+ *
+ * Each service creates a named logger via `createLogger("serviceName")`.
+ * Output format: `[ISO timestamp] name: message`
+ * All output goes to stderr via console.error so stdout stays clean for
+ * structured CLI output (--json).
+ */
+
+export type Logger = (msg: string) => void;
+
+/**
+ * Create a prefixed logger that writes to stderr.
+ *
+ * @param name - Service or module name (e.g. "cortex", "synapse")
+ * @returns A function that logs `[timestamp] name: msg` to stderr
+ *
+ * @example
+ * ```ts
+ * const log = createLogger("cortex");
+ * log("processing loop started");
+ * // => [2026-02-20T11:36:00.000Z] cortex: processing loop started
+ * ```
+ */
+export function createLogger(name: string): Logger {
+  return (msg: string) => {
+    console.error(`[${new Date().toISOString()}] ${name}: ${msg}`);
+  };
+}