@logickernel/logger 0.2.0

package/README.md

@@ -0,0 +1,149 @@
+## @logickernel/logger
+
+Lightweight Node.js logger that automatically routes logs to **Google Cloud Logging** (when available) or the **local console**. Designed for small services and tools where you want structured logs in GCP without wiring up a full logging stack.
+
+```ts
+import logger from "@logickernel/logger";
+
+logger.info("server started", { port: 3000 });
+logger.debug("user action", { userId: "123", action: "login" });
+logger.error(new Error("something went wrong"));
+logger.warning("disk space low", { used: "92%", mount: "/data" });
+```
+
+> Your code never has to care whether it’s running on Cloud Run / GCP or locally – the logger picks the right backend at startup.
+
+---
+
+## 1. Introduction
+
+- **What it is**: A tiny logging helper with the full GCP severity ladder and a smart backend:
+  - In **GCP** (or when `SYSTEM_LOGS=gcp`): writes to Google Cloud Logging with proper severities and structured `jsonPayload` when a context object is provided.
+  - Otherwise: writes to the local console with emoji prefixes, a local timestamp, and the context object inlined as compact JSON.
+- **Why it exists**: To avoid sprinkling environment-specific logging logic across your codebase. You import one `logger` and use it everywhere.
+
+**Key features**
+
+- **Zero config in GCP**: Uses `K_SERVICE` and `GCP_PROJECT` from the environment.
+- **Auto backend selection**: GCP vs console decided once at module load.
+- **Full severity ladder**: `debug`, `info`, `notice`, `warning`, `error`, `critical`, `alert`, `emergency`.
+- **Structured context**: Pass a plain object as the last argument — it becomes a `jsonPayload` in GCP (queryable by field) and compact inline JSON in the console.
+- **Tiny API**: One default export (`logger`) plus a `formatMessage` helper if you need it.
+
+---
+
+## 2. Local Setup (Development)
+
+### Prerequisites
+
+- **Node.js**: v18+ recommended (any actively supported LTS should work).
+- **npm** (or compatible package manager).
+
+### Clone and install
+
+```bash
+git clone https://github.com/logickernel/logger.git
+cd logger
+npm install
+```
+
+### Useful scripts
+
+```bash
+# Run tests
+npm test
+
+# Type-check
+npm run typecheck
+
+# Build the library
+npm run build
+```
+
+---
+
+## 3. Installation & Usage (as a Library)
+
+### Install from npm
+
+```bash
+npm install @logickernel/logger
+```
+
+### Basic usage
+
+```ts
+import logger from "@logickernel/logger";
+
+logger.info("server started", { port: 3000 });
+logger.debug("user action", { userId: "123", action: "login" });
+logger.warning("disk space low", { used: "92%", mount: "/data" });
+logger.error(new Error("oops"));
+logger.critical("primary db unreachable", { host: "db-1" });
+```
+
+The default export is a **singleton** whose backend is chosen at module load:
+
+- **GCP backend** is used when:
+  - `SYSTEM_LOGS=gcp`, or
+  - `K_SERVICE` is set (e.g. Cloud Run)
+- Otherwise, the **console backend** is used.
+
+### Severity methods
+
+| Method | GCP severity | Console emoji |
+|---|---|---|
+| `debug` | `DEBUG` | 🐞 |
+| `info` | `INFO` | ℹ️ |
+| `notice` | `NOTICE` | *️⃣ |
+| `warning` | `WARNING` | ⚠️ |
+| `error` | `ERROR` | ⛔️ |
+| `critical` | `CRITICAL` | ❗️ |
+| `alert` | `ALERT` | ‼️ |
+| `emergency` | `EMERGENCY` | 🚨 |
+
+### Structured context
+
+Pass a plain object as the last argument to attach structured data to a log entry:
+
+```ts
+logger.info("request complete", { method: "GET", path: "/api/users", status: 200, ms: 42 });
+```
+
+- **GCP backend**: written as `jsonPayload` — fields are indexed and queryable in Cloud Logging.
+- **Console backend**: inlined as compact JSON on the same line.
+
+### Console format
+
+```
+🐞 2026-02-26 13:04:22.341 user action { "userId": "123", "action": "login" }
+⚠️ 2026-02-26 13:04:22.512 disk space low { "used": "92%", "mount": "/data" }
+```
+
+### Environment variables
+
+- `SYSTEM_LOGS=gcp`
+  Force GCP logging even if `K_SERVICE` is not set.
+
+- `K_SERVICE`
+  Used as the log name in Google Cloud Logging. If not set, `"app"` is used.
+
+- `GCP_PROJECT`
+  Project ID for Google Cloud Logging. Required when using the GCP backend.
+
+### Named exports
+
+```ts
+import logger, { Logger, formatMessage } from "@logickernel/logger";
+
+const myLogger: Logger = logger;
+const message = formatMessage(["hello", { id: 1 }]); // "hello {"id":1}"
+```
+
+---
+
+## 4. Additional Resources
+
+- **Package**: `@logickernel/logger` on npm.
+- **License**: MIT (see `LICENSE` in this repository).
+- **Contributions**: Feel free to open issues or pull requests if you’d like improvements (extra transports, richer metadata, etc.).

package/dist/index.cjs

@@ -0,0 +1,120 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default,
+  formatMessage: () => formatMessage,
+  logger: () => logger
+});
+module.exports = __toCommonJS(index_exports);
+var import_logging = require("@google-cloud/logging");
+function formatMessage(args) {
+  return args.map((arg) => {
+    if (typeof arg === "string") return arg;
+    if (arg instanceof Error) return arg.message + (arg.stack ? `
+${arg.stack}` : "");
+    try {
+      return JSON.stringify(arg);
+    } catch {
+      return String(arg);
+    }
+  }).join(" ");
+}
+var USE_GCP = process.env.SYSTEM_LOGS === "gcp" || !!process.env.K_SERVICE;
+var noop = () => {
+};
+function gcpPayload(args) {
+  const last = args[args.length - 1];
+  if (args.length >= 2 && last !== null && typeof last === "object" && !Array.isArray(last) && !(last instanceof Error)) {
+    return { message: formatMessage(args.slice(0, -1)), ...last };
+  }
+  return formatMessage(args);
+}
+var gcpLog = null;
+if (USE_GCP) {
+  try {
+    const logName = process.env.K_SERVICE ?? "app";
+    gcpLog = new import_logging.Logging({ projectId: process.env.GCP_PROJECT }).log(logName);
+  } catch {
+  }
+}
+var logger = gcpLog ? /* @__PURE__ */ (() => {
+  const g = gcpLog;
+  return {
+    debug: (...args) => {
+      const mapped = args.map((a) => typeof a === "string" ? a.replace(/\n/g, " ") : a);
+      g.write(g.entry({ severity: "DEBUG" }, gcpPayload(mapped))).catch(noop);
+    },
+    info: (...args) => {
+      g.write(g.entry({ severity: "INFO" }, gcpPayload(args))).catch(noop);
+    },
+    notice: (...args) => {
+      g.write(g.entry({ severity: "NOTICE" }, gcpPayload(args))).catch(noop);
+    },
+    warning: (...args) => {
+      g.write(g.entry({ severity: "WARNING" }, gcpPayload(args))).catch(noop);
+    },
+    error: (...args) => {
+      g.write(g.entry({ severity: "ERROR" }, gcpPayload(args))).catch(noop);
+    },
+    critical: (...args) => {
+      g.write(g.entry({ severity: "CRITICAL" }, gcpPayload(args))).catch(noop);
+    },
+    alert: (...args) => {
+      g.write(g.entry({ severity: "ALERT" }, gcpPayload(args))).catch(noop);
+    },
+    emergency: (...args) => {
+      g.write(g.entry({ severity: "EMERGENCY" }, gcpPayload(args))).catch(noop);
+    }
+  };
+})() : {
+  debug: (...args) => {
+    console.log("[DEBUG]", ...args.map((a) => typeof a === "string" ? a.replace(/\n/g, " ") : a));
+  },
+  info: (...args) => {
+    console.log("[INFO]", ...args);
+  },
+  notice: (...args) => {
+    console.log("[NOTICE]", ...args);
+  },
+  warning: (...args) => {
+    console.log("[WARNING]", ...args);
+  },
+  error: (...args) => {
+    console.log("[ERROR]", ...args);
+  },
+  critical: (...args) => {
+    console.log("[CRITICAL]", ...args);
+  },
+  alert: (...args) => {
+    console.log("[ALERT]", ...args);
+  },
+  emergency: (...args) => {
+    console.log("[EMERGENCY]", ...args);
+  }
+};
+var index_default = logger;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatMessage,
+  logger
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Logging } from \"@google-cloud/logging\";\n\nexport interface Logger {\n  debug: (...args: unknown[]) => void;\n  info: (...args: unknown[]) => void;\n  notice: (...args: unknown[]) => void;\n  warning: (...args: unknown[]) => void;\n  error: (...args: unknown[]) => void;\n  critical: (...args: unknown[]) => void;\n  alert: (...args: unknown[]) => void;\n  emergency: (...args: unknown[]) => void;\n}\n\nexport function formatMessage(args: unknown[]): string {\n  return args.map(arg => {\n    if (typeof arg === \"string\") return arg;\n    if (arg instanceof Error) return arg.message + (arg.stack ? `\\n${arg.stack}` : \"\");\n    try {\n      return JSON.stringify(arg);\n    } catch {\n      return String(arg);\n    }\n  }).join(\" \");\n}\n\n// Resolved once at module load — no per-call branching.\nconst USE_GCP = process.env.SYSTEM_LOGS === \"gcp\" || !!process.env.K_SERVICE;\nconst noop = (): void => {};\n\n// If the last arg is a plain object, return a jsonPayload so Cloud Logging\n// indexes its fields. Otherwise return a plain string (textPayload).\nfunction gcpPayload(args: unknown[]): string | Record<string, unknown> {\n  const last = args[args.length - 1];\n  if (\n    args.length >= 2 &&\n    last !== null &&\n    typeof last === \"object\" &&\n    !Array.isArray(last) &&\n    !(last instanceof Error)\n  ) {\n    return { message: formatMessage(args.slice(0, -1)), ...(last as Record<string, unknown>) };\n  }\n  return formatMessage(args);\n}\n\nlet gcpLog: ReturnType<Logging[\"log\"]> | null = null;\nif (USE_GCP) {\n  try {\n    const logName = process.env.K_SERVICE ?? \"app\";\n    gcpLog = new Logging({ projectId: process.env.GCP_PROJECT }).log(logName);\n  } catch {\n    // GCP init failed; fall back to console\n  }\n}\n\nexport const logger: Logger = gcpLog\n  ? (() => {\n      const g = gcpLog!;\n      return {\n        debug: (...args: unknown[]): void => {\n          const mapped = args.map(a => typeof a === \"string\" ? a.replace(/\\n/g, \" \") : a);\n          g.write(g.entry({ severity: \"DEBUG\" }, gcpPayload(mapped))).catch(noop);\n        },\n        info: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"INFO\" }, gcpPayload(args))).catch(noop);\n        },\n        notice: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"NOTICE\" }, gcpPayload(args))).catch(noop);\n        },\n        warning: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"WARNING\" }, gcpPayload(args))).catch(noop);\n        },\n        error: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"ERROR\" }, gcpPayload(args))).catch(noop);\n        },\n        critical: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"CRITICAL\" }, gcpPayload(args))).catch(noop);\n        },\n        alert: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"ALERT\" }, gcpPayload(args))).catch(noop);\n        },\n        emergency: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"EMERGENCY\" }, gcpPayload(args))).catch(noop);\n        },\n      };\n    })()\n  : {\n      debug: (...args: unknown[]): void => {\n        console.log(\"[DEBUG]\", ...args.map(a => typeof a === \"string\" ? a.replace(/\\n/g, \" \") : a));\n      },\n      info: (...args: unknown[]): void => {\n        console.log(\"[INFO]\", ...args);\n      },\n      notice: (...args: unknown[]): void => {\n        console.log(\"[NOTICE]\", ...args);\n      },\n      warning: (...args: unknown[]): void => {\n        console.log(\"[WARNING]\", ...args);\n      },\n      error: (...args: unknown[]): void => {\n        console.log(\"[ERROR]\", ...args);\n      },\n      critical: (...args: unknown[]): void => {\n        console.log(\"[CRITICAL]\", ...args);\n      },\n      alert: (...args: unknown[]): void => {\n        console.log(\"[ALERT]\", ...args);\n      },\n      emergency: (...args: unknown[]): void => {\n        console.log(\"[EMERGENCY]\", ...args);\n      },\n    };\n\nexport default logger;\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+interface Logger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    notice: (...args: unknown[]) => void;
+    warning: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    critical: (...args: unknown[]) => void;
+    alert: (...args: unknown[]) => void;
+    emergency: (...args: unknown[]) => void;
+}
+declare function formatMessage(args: unknown[]): string;
+declare const logger: Logger;
+
+export { type Logger, logger as default, formatMessage, logger };

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+interface Logger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    notice: (...args: unknown[]) => void;
+    warning: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    critical: (...args: unknown[]) => void;
+    alert: (...args: unknown[]) => void;
+    emergency: (...args: unknown[]) => void;
+}
+declare function formatMessage(args: unknown[]): string;
+declare const logger: Logger;
+
+export { type Logger, logger as default, formatMessage, logger };

package/dist/index.js

@@ -0,0 +1,94 @@
+// src/index.ts
+import { Logging } from "@google-cloud/logging";
+function formatMessage(args) {
+  return args.map((arg) => {
+    if (typeof arg === "string") return arg;
+    if (arg instanceof Error) return arg.message + (arg.stack ? `
+${arg.stack}` : "");
+    try {
+      return JSON.stringify(arg);
+    } catch {
+      return String(arg);
+    }
+  }).join(" ");
+}
+var USE_GCP = process.env.SYSTEM_LOGS === "gcp" || !!process.env.K_SERVICE;
+var noop = () => {
+};
+function gcpPayload(args) {
+  const last = args[args.length - 1];
+  if (args.length >= 2 && last !== null && typeof last === "object" && !Array.isArray(last) && !(last instanceof Error)) {
+    return { message: formatMessage(args.slice(0, -1)), ...last };
+  }
+  return formatMessage(args);
+}
+var gcpLog = null;
+if (USE_GCP) {
+  try {
+    const logName = process.env.K_SERVICE ?? "app";
+    gcpLog = new Logging({ projectId: process.env.GCP_PROJECT }).log(logName);
+  } catch {
+  }
+}
+var logger = gcpLog ? /* @__PURE__ */ (() => {
+  const g = gcpLog;
+  return {
+    debug: (...args) => {
+      const mapped = args.map((a) => typeof a === "string" ? a.replace(/\n/g, " ") : a);
+      g.write(g.entry({ severity: "DEBUG" }, gcpPayload(mapped))).catch(noop);
+    },
+    info: (...args) => {
+      g.write(g.entry({ severity: "INFO" }, gcpPayload(args))).catch(noop);
+    },
+    notice: (...args) => {
+      g.write(g.entry({ severity: "NOTICE" }, gcpPayload(args))).catch(noop);
+    },
+    warning: (...args) => {
+      g.write(g.entry({ severity: "WARNING" }, gcpPayload(args))).catch(noop);
+    },
+    error: (...args) => {
+      g.write(g.entry({ severity: "ERROR" }, gcpPayload(args))).catch(noop);
+    },
+    critical: (...args) => {
+      g.write(g.entry({ severity: "CRITICAL" }, gcpPayload(args))).catch(noop);
+    },
+    alert: (...args) => {
+      g.write(g.entry({ severity: "ALERT" }, gcpPayload(args))).catch(noop);
+    },
+    emergency: (...args) => {
+      g.write(g.entry({ severity: "EMERGENCY" }, gcpPayload(args))).catch(noop);
+    }
+  };
+})() : {
+  debug: (...args) => {
+    console.log("[DEBUG]", ...args.map((a) => typeof a === "string" ? a.replace(/\n/g, " ") : a));
+  },
+  info: (...args) => {
+    console.log("[INFO]", ...args);
+  },
+  notice: (...args) => {
+    console.log("[NOTICE]", ...args);
+  },
+  warning: (...args) => {
+    console.log("[WARNING]", ...args);
+  },
+  error: (...args) => {
+    console.log("[ERROR]", ...args);
+  },
+  critical: (...args) => {
+    console.log("[CRITICAL]", ...args);
+  },
+  alert: (...args) => {
+    console.log("[ALERT]", ...args);
+  },
+  emergency: (...args) => {
+    console.log("[EMERGENCY]", ...args);
+  }
+};
+var index_default = logger;
+export {
+  index_default as default,
+  formatMessage,
+  logger
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Logging } from \"@google-cloud/logging\";\n\nexport interface Logger {\n  debug: (...args: unknown[]) => void;\n  info: (...args: unknown[]) => void;\n  notice: (...args: unknown[]) => void;\n  warning: (...args: unknown[]) => void;\n  error: (...args: unknown[]) => void;\n  critical: (...args: unknown[]) => void;\n  alert: (...args: unknown[]) => void;\n  emergency: (...args: unknown[]) => void;\n}\n\nexport function formatMessage(args: unknown[]): string {\n  return args.map(arg => {\n    if (typeof arg === \"string\") return arg;\n    if (arg instanceof Error) return arg.message + (arg.stack ? `\\n${arg.stack}` : \"\");\n    try {\n      return JSON.stringify(arg);\n    } catch {\n      return String(arg);\n    }\n  }).join(\" \");\n}\n\n// Resolved once at module load — no per-call branching.\nconst USE_GCP = process.env.SYSTEM_LOGS === \"gcp\" || !!process.env.K_SERVICE;\nconst noop = (): void => {};\n\n// If the last arg is a plain object, return a jsonPayload so Cloud Logging\n// indexes its fields. Otherwise return a plain string (textPayload).\nfunction gcpPayload(args: unknown[]): string | Record<string, unknown> {\n  const last = args[args.length - 1];\n  if (\n    args.length >= 2 &&\n    last !== null &&\n    typeof last === \"object\" &&\n    !Array.isArray(last) &&\n    !(last instanceof Error)\n  ) {\n    return { message: formatMessage(args.slice(0, -1)), ...(last as Record<string, unknown>) };\n  }\n  return formatMessage(args);\n}\n\nlet gcpLog: ReturnType<Logging[\"log\"]> | null = null;\nif (USE_GCP) {\n  try {\n    const logName = process.env.K_SERVICE ?? \"app\";\n    gcpLog = new Logging({ projectId: process.env.GCP_PROJECT }).log(logName);\n  } catch {\n    // GCP init failed; fall back to console\n  }\n}\n\nexport const logger: Logger = gcpLog\n  ? (() => {\n      const g = gcpLog!;\n      return {\n        debug: (...args: unknown[]): void => {\n          const mapped = args.map(a => typeof a === \"string\" ? a.replace(/\\n/g, \" \") : a);\n          g.write(g.entry({ severity: \"DEBUG\" }, gcpPayload(mapped))).catch(noop);\n        },\n        info: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"INFO\" }, gcpPayload(args))).catch(noop);\n        },\n        notice: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"NOTICE\" }, gcpPayload(args))).catch(noop);\n        },\n        warning: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"WARNING\" }, gcpPayload(args))).catch(noop);\n        },\n        error: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"ERROR\" }, gcpPayload(args))).catch(noop);\n        },\n        critical: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"CRITICAL\" }, gcpPayload(args))).catch(noop);\n        },\n        alert: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"ALERT\" }, gcpPayload(args))).catch(noop);\n        },\n        emergency: (...args: unknown[]): void => {\n          g.write(g.entry({ severity: \"EMERGENCY\" }, gcpPayload(args))).catch(noop);\n        },\n      };\n    })()\n  : {\n      debug: (...args: unknown[]): void => {\n        console.log(\"[DEBUG]\", ...args.map(a => typeof a === \"string\" ? a.replace(/\\n/g, \" \") : a));\n      },\n      info: (...args: unknown[]): void => {\n        console.log(\"[INFO]\", ...args);\n      },\n      notice: (...args: unknown[]): void => {\n        console.log(\"[NOTICE]\", ...args);\n      },\n      warning: (...args: unknown[]): void => {\n        console.log(\"[WARNING]\", ...args);\n      },\n      error: (...args: unknown[]): void => {\n        console.log(\"[ERROR]\", ...args);\n      },\n      critical: (...args: unknown[]): void => {\n        console.log(\"[CRITICAL]\", ...args);\n      },\n      alert: (...args: unknown[]): void => {\n        console.log(\"[ALERT]\", ...args);\n      },\n      emergency: (...args: unknown[]): void => {\n        console.log(\"[EMERGENCY]\", ...args);\n      },\n    };\n\nexport default logger;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@logickernel/logger",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run src/index.test.ts",
+    "test:integration": "vitest run src/index.integration.test.ts",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@google-cloud/logging": "^11"
+  },
+  "devDependencies": {
+    "tsup": "^8",
+    "typescript": "^5",
+    "vitest": "^3"
+  }
+}