@easyoref/monitoring 1.21.1

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * 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,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * 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":"AAAA,cAAc,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * EasyOref Logger
+ *
+ * Dual-output: console (always) + Better Stack Logtail (if token set).
+ * Token source: config.yaml `observability.betterstack_token` or LOGTAIL_TOKEN env.
+ * Live Tail: https://logs.betterstack.com → your source → "Live Tail"
+ */
+export declare function info(message: string, ctx?: Record<string, unknown>): void;
+export declare function warn(message: string, ctx?: Record<string, unknown>): void;
+export declare function error(message: string, ctx?: Record<string, unknown>): void;
+export declare function debug(message: string, ctx?: Record<string, unknown>): void;
+/** Call before process.exit() — flushes Logtail buffer */
+export declare function flush(): Promise<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":"AAAA;;;;;;GAMG;AAuBH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGzE;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGzE;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG1E;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK1E;AAED,0DAA0D;AAC1D,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C"}

package/dist/logger.js

@@ -0,0 +1,45 @@
+/**
+ * EasyOref Logger
+ *
+ * Dual-output: console (always) + Better Stack Logtail (if token set).
+ * Token source: config.yaml `observability.betterstack_token` or LOGTAIL_TOKEN env.
+ * Live Tail: https://logs.betterstack.com → your source → "Live Tail"
+ */
+import { Logtail } from "@logtail/node";
+import { config } from "@easyoref/shared";
+const token = config.logtailToken;
+const logtail = token ? new Logtail(token) : null;
+const base = {
+    service: "easyoref",
+    env: process.env.NODE_ENV ?? "production",
+};
+if (logtail) {
+    console.log("📡 Better Stack Logtail enabled — live tail at logs.betterstack.com");
+}
+else {
+    console.log("📟 LOGTAIL_TOKEN not set — logging to console only");
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+export function info(message, ctx) {
+    console.log(message, ctx ?? "");
+    logtail?.info(message, { ...base, ...ctx });
+}
+export function warn(message, ctx) {
+    console.warn(message, ctx ?? "");
+    logtail?.warn(message, { ...base, ...ctx });
+}
+export function error(message, ctx) {
+    console.error(message, ctx ?? "");
+    logtail?.error(message, { ...base, ...ctx });
+}
+export function debug(message, ctx) {
+    if (process.env.LOG_LEVEL === "debug") {
+        console.debug(message, ctx ?? "");
+    }
+    logtail?.debug(message, { ...base, ...ctx });
+}
+/** Call before process.exit() — flushes Logtail buffer */
+export async function flush() {
+    await logtail?.flush();
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC;AAClC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAElD,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,UAAU;IACnB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,YAAY;CAC1C,CAAC;AAEF,IAAI,OAAO,EAAE,CAAC;IACZ,OAAO,CAAC,GAAG,CACT,qEAAqE,CACtE,CAAC;AACJ,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;AACpE,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,GAA6B;IACjE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAChC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,GAA6B;IACjE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAA6B;IAClE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAClC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,GAA6B;IAClE,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@easyoref/monitoring",
+  "version": "1.21.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@logtail/node": "^0.5.6",
+    "chalk": "^5.3.0",
+    "@easyoref/shared": "*",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./logger.js";

package/src/logger.ts

@@ -0,0 +1,55 @@
+/**
+ * EasyOref Logger
+ *
+ * Dual-output: console (always) + Better Stack Logtail (if token set).
+ * Token source: config.yaml `observability.betterstack_token` or LOGTAIL_TOKEN env.
+ * Live Tail: https://logs.betterstack.com → your source → "Live Tail"
+ */
+
+import { Logtail } from "@logtail/node";
+import { config } from "@easyoref/shared";
+
+const token = config.logtailToken;
+const logtail = token ? new Logtail(token) : null;
+
+const base = {
+  service: "easyoref",
+  env: process.env.NODE_ENV ?? "production",
+};
+
+if (logtail) {
+  console.log(
+    "📡 Better Stack Logtail enabled — live tail at logs.betterstack.com",
+  );
+} else {
+  console.log("📟 LOGTAIL_TOKEN not set — logging to console only");
+}
+
+// ── Public API ────────────────────────────────────────────────────────────────
+
+export function info(message: string, ctx?: Record<string, unknown>): void {
+  console.log(message, ctx ?? "");
+  logtail?.info(message, { ...base, ...ctx });
+}
+
+export function warn(message: string, ctx?: Record<string, unknown>): void {
+  console.warn(message, ctx ?? "");
+  logtail?.warn(message, { ...base, ...ctx });
+}
+
+export function error(message: string, ctx?: Record<string, unknown>): void {
+  console.error(message, ctx ?? "");
+  logtail?.error(message, { ...base, ...ctx });
+}
+
+export function debug(message: string, ctx?: Record<string, unknown>): void {
+  if (process.env.LOG_LEVEL === "debug") {
+    console.debug(message, ctx ?? "");
+  }
+  logtail?.debug(message, { ...base, ...ctx });
+}
+
+/** Call before process.exit() — flushes Logtail buffer */
+export async function flush(): Promise<void> {
+  await logtail?.flush();
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "references": [{ "path": "../shared" }],
+  "include": ["src/**/*"]
+}