@zudojs/logger 0.0.1

package/dist/loggerTransport/loggerTransportGuard.js

@@ -0,0 +1,42 @@
+/**
+ * Logger transport type guards and ID generation.
+ */
+/**
+ * Creates a transport identifier.
+ */
+export function createLoggerTransportId() {
+    if (typeof crypto !== "undefined" &&
+        typeof crypto.randomUUID === "function") {
+        return `transport:${crypto.randomUUID()}`;
+    }
+    return [
+        "transport",
+        Date.now().toString(36),
+        Math.random().toString(36).slice(2),
+    ].join(":");
+}
+/**
+ * Determines whether a value is a function transport.
+ */
+export function isLoggerTransportFunction(value) {
+    return typeof value === "function";
+}
+/**
+ * Determines whether a value is a transport object.
+ */
+export function isLoggerTransportObject(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.name === "string" &&
+        candidate.name.length > 0 &&
+        typeof candidate.write === "function");
+}
+/**
+ * Checks whether a value is a valid transport.
+ */
+export function isLoggerTransport(value) {
+    return isLoggerTransportFunction(value) || isLoggerTransportObject(value);
+}
+//# sourceMappingURL=loggerTransportGuard.js.map

package/dist/loggerTransport/loggerTransportGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerTransportGuard.js","sourceRoot":"","sources":["../../src/loggerTransport/loggerTransportGuard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,IACE,OAAO,MAAM,KAAK,WAAW;QAC7B,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EACvC,CAAC;QACD,OAAO,aAAa,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,WAAW;QACX,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;KACpC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAIjB,CAAC;IAEF,OAAO,CACL,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACzB,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,CACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAc;IAEd,OAAO,yBAAyB,CAAC,KAAK,CAAC,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC"}

package/dist/loggerTransport/loggerTransportHelpers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/logger/loggerTransport/loggerTransportHelpers
+ *
+ * Transport helper functions.
+ */
+export { serializeTransportEntry, closeLoggerTransport, flushLoggerTransport, } from "./loggerTransportHelpers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/loggerTransport/loggerTransportHelpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loggerTransport/loggerTransportHelpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}

package/dist/loggerTransport/loggerTransportHelpers/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/logger/loggerTransport/loggerTransportHelpers
+ *
+ * Transport helper functions.
+ */
+export { serializeTransportEntry, closeLoggerTransport, flushLoggerTransport, } from "./loggerTransportHelpers.js";
+//# sourceMappingURL=index.js.map

package/dist/loggerTransport/loggerTransportHelpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/loggerTransport/loggerTransportHelpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}

package/dist/loggerTransport/loggerTransportHelpers/loggerTransportHelpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Logger transport helper functions.
+ */
+import type { LoggerEntry } from "../../loggerEntry/loggerEntry.type.js";
+import type { LoggerTransportLike } from "../loggerTransport.type.js";
+/**
+ * Converts a LoggerEntry into a console-friendly object.
+ */
+export declare function serializeTransportEntry(entry: LoggerEntry): Record<string, unknown>;
+/**
+ * Safely closes a transport.
+ */
+export declare function closeLoggerTransport(transport: LoggerTransportLike): Promise<void>;
+/**
+ * Flushes a transport.
+ */
+export declare function flushLoggerTransport(transport: LoggerTransportLike): Promise<void>;
+//# sourceMappingURL=loggerTransportHelpers.d.ts.map

package/dist/loggerTransport/loggerTransportHelpers/loggerTransportHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerTransportHelpers.d.ts","sourceRoot":"","sources":["../../../src/loggerTransport/loggerTransportHelpers/loggerTransportHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAItE;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4CzB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/loggerTransport/loggerTransportHelpers/loggerTransportHelpers.js

@@ -0,0 +1,60 @@
+/**
+ * Logger transport helper functions.
+ */
+import { isLoggerTransportObject } from "../loggerTransportGuard.js";
+/**
+ * Converts a LoggerEntry into a console-friendly object.
+ */
+export function serializeTransportEntry(entry) {
+    return {
+        timestamp: entry.timestamp.toISOString(),
+        level: entry.levelName,
+        message: entry.message,
+        ...(entry.logger
+            ? {
+                logger: entry.logger,
+            }
+            : {}),
+        ...(entry.context
+            ? {
+                context: entry.context,
+            }
+            : {}),
+        ...(entry.metadata
+            ? {
+                metadata: entry.metadata,
+            }
+            : {}),
+        ...(entry.source
+            ? {
+                source: entry.source,
+            }
+            : {}),
+        ...(entry.error
+            ? {
+                error: {
+                    name: entry.error.name,
+                    message: entry.error.message,
+                    stack: entry.error.stack,
+                },
+            }
+            : {}),
+    };
+}
+/**
+ * Safely closes a transport.
+ */
+export async function closeLoggerTransport(transport) {
+    if (isLoggerTransportObject(transport) && transport.close) {
+        await transport.close();
+    }
+}
+/**
+ * Flushes a transport.
+ */
+export async function flushLoggerTransport(transport) {
+    if (isLoggerTransportObject(transport) && transport.flush) {
+        await transport.flush();
+    }
+}
+//# sourceMappingURL=loggerTransportHelpers.js.map

package/dist/loggerTransport/loggerTransportHelpers/loggerTransportHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerTransportHelpers.js","sourceRoot":"","sources":["../../../src/loggerTransport/loggerTransportHelpers/loggerTransportHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAkB;IAElB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;QAExC,KAAK,EAAE,KAAK,CAAC,SAAS;QAEtB,OAAO,EAAE,KAAK,CAAC,OAAO;QAEtB,GAAG,CAAC,KAAK,CAAC,MAAM;YACd,CAAC,CAAC;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,GAAG,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC;gBACE,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,GAAG,CAAC,KAAK,CAAC,QAAQ;YAChB,CAAC,CAAC;gBACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,GAAG,CAAC,KAAK,CAAC,MAAM;YACd,CAAC,CAAC;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,GAAG,CAAC,KAAK,CAAC,KAAK;YACb,CAAC,CAAC;gBACE,KAAK,EAAE;oBACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;oBAEtB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;oBAE5B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK;iBACzB;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAA8B;IAE9B,IAAI,uBAAuB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1D,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAA8B;IAE9B,IAAI,uBAAuB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1D,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@zudojs/logger",
+  "version": "0.0.1",
+  "description": "Structured logging with transports, log levels, and context propagation for Zudojs applications.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@zudojs/errors": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "logging",
+    "structured-logs",
+    "transports"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}