logiscout 1.0.1 → 1.0.4

package/dist/esm/services/transporter/ServerTransporter.js

@@ -0,0 +1,27 @@
+import { LogApi } from "../../api/LogApi.js";
+import { LogPayloadType } from "../../core/enum/LogPayLoads.js";
+export class ServerTransporter {
+    transport(session) {
+        if (this.isFrontendSession(session)) {
+            this.sendSingle(session);
+            return;
+        }
+        this.sendCorrelation(session);
+    }
+    sendCorrelation(session) {
+        LogApi({
+            type: LogPayloadType.SESSION,
+            data: session,
+        });
+    }
+    sendSingle(session) {
+        LogApi({
+            type: LogPayloadType.SINGLE,
+            data: session,
+        });
+    }
+    isFrontendSession(session) {
+        // Decide ONLY based on session shape/data
+        return session.correlationId === "no-correlation-id";
+    }
+}

package/dist/esm/utils/GenerateCorrelationId.d.ts

@@ -0,0 +1,2 @@
+export declare function generateCorrelationId(projectName: string, componentName: string): string;
+//# sourceMappingURL=GenerateCorrelationId.d.ts.map

package/dist/esm/utils/GenerateCorrelationId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateCorrelationId.d.ts","sourceRoot":"","sources":["../../../src/utils/GenerateCorrelationId.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,CAER"}

package/dist/esm/utils/GenerateCorrelationId.js

@@ -0,0 +1,4 @@
+import crypto from "crypto";
+export function generateCorrelationId(projectName, componentName) {
+    return `${projectName}-${componentName}-${crypto.randomUUID()}`;
+}

package/dist/esm/validator/ValidateComponentName.d.ts

@@ -0,0 +1,2 @@
+export default function validateComponentName(componentName: string): void;
+//# sourceMappingURL=ValidateComponentName.d.ts.map

package/dist/esm/validator/ValidateComponentName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateComponentName.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateComponentName.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,aAAa,EAAC,MAAM,QAajE"}

package/dist/esm/validator/ValidateComponentName.js

@@ -0,0 +1,11 @@
+import { throwError } from "../errors/ThrowError.js";
+export default function validateComponentName(componentName) {
+    if (!componentName || typeof componentName !== "string") {
+        throwError("Logger: Component name must be a non-empty string. " +
+            "Usage: createLogger('ComponentName')");
+    }
+    if (componentName.length > 100) {
+        throwError("Logger: Component name cannot exceed 100 characters. " +
+            `Received: '${componentName.substring(0, 20)}...'`);
+    }
+}

package/dist/esm/validator/ValidateLogEntry.d.ts

@@ -0,0 +1,3 @@
+import { LogEntry } from "../core/types/LogEntry.js";
+export default function validateLogEntry(entry: LogEntry): void;
+//# sourceMappingURL=ValidateLogEntry.d.ts.map

package/dist/esm/validator/ValidateLogEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateLogEntry.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateLogEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAoB9D"}

package/dist/esm/validator/ValidateLogEntry.js

@@ -0,0 +1,15 @@
+import { throwError } from "../errors/ThrowError.js";
+export default function validateLogEntry(entry) {
+    if (!entry) {
+        throwError("[Logiscout] Log entry is undefined or null");
+    }
+    if (!entry.message || typeof entry.message !== "string") {
+        throwError("[Logiscout] Log message must be a non-empty string. " +
+            `Usage: logiscout.${entry.level}('Your message', { meta })`);
+    }
+    if (entry.message.length > 10000) {
+        console.error("[Logiscout] Log message exceeds 10000 characters. Message truncated.");
+        entry.message =
+            entry.message.substring(0, 10000) + "... [truncated]";
+    }
+}

package/dist/esm/validator/ValidateLogLevel.d.ts

@@ -0,0 +1,2 @@
+export default function validateLogLevel(logLevel: any): void;
+//# sourceMappingURL=ValidateLogLevel.d.ts.map

package/dist/esm/validator/ValidateLogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateLogLevel.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateLogLevel.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAO5D"}

package/dist/esm/validator/ValidateLogLevel.js

@@ -0,0 +1,8 @@
+import { LogLevels } from "../core/enum/LogLevels.js";
+import { throwError } from "../errors/ThrowError.js";
+export default function validateLogLevel(logLevel) {
+    if (!Object.values(LogLevels).includes(logLevel)) {
+        throwError(`Logger: Invalid log level '${logLevel}'. ` +
+            `Valid levels: ${Object.values(LogLevels).join(", ")}`);
+    }
+}

package/dist/esm/validator/ValidateLogMessage.d.ts

@@ -0,0 +1,2 @@
+export default function validateLogMessage(message: string): void;
+//# sourceMappingURL=ValidateLogMessage.d.ts.map

package/dist/esm/validator/ValidateLogMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateLogMessage.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateLogMessage.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAShE"}

package/dist/esm/validator/ValidateLogMessage.js

@@ -0,0 +1,7 @@
+import { throwError } from "../errors/ThrowError.js";
+export default function validateLogMessage(message) {
+    if (!message || typeof message !== "string") {
+        throwError(`Logger: Message must be a non-empty string. ` +
+            `Received: ${typeof message === "undefined" ? "undefined" : typeof message}`);
+    }
+}

package/dist/esm/validator/ValidateRequestContext.d.ts

@@ -0,0 +1,2 @@
+export declare function validateRequestContext(fn: () => void, correlationId: string | undefined): void;
+//# sourceMappingURL=ValidateRequestContext.d.ts.map

package/dist/esm/validator/ValidateRequestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateRequestContext.d.ts","sourceRoot":"","sources":["../../../src/validator/ValidateRequestContext.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,IAAI,EACd,aAAa,EAAE,MAAM,GAAC,SAAS,GAC9B,IAAI,CAqBN"}

package/dist/esm/validator/ValidateRequestContext.js

@@ -0,0 +1,15 @@
+import { throwError } from "../errors/ThrowError.js";
+export function validateRequestContext(fn, correlationId) {
+    if (typeof fn !== "function") {
+        throwError("RequestContext.run() requires a function as the first parameter. " +
+            "Usage: RequestContext.run(() => { ... }, correlationId?)");
+    }
+    // Validate correlationId if provided
+    if (correlationId !== undefined && typeof correlationId !== "string") {
+        throwError("RequestContext.run(): correlationId must be a string if provided. " +
+            `Received: ${typeof correlationId}`);
+    }
+    if (correlationId && correlationId.length > 100) {
+        throwError("RequestContext.run(): correlationId cannot exceed 100 characters.");
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "logiscout",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "Logiscout — a structured logger library",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
@@ -43,10 +43,12 @@
     "node": ">=18"
   },
   "dependencies": {
+    "axios": "^1.13.2",
     "winston": "^3.11.0"
   },
   "devDependencies": {
-    "typescript": "^5.3.3",
-    "@types/node": "^20.10.0"
+    "@types/node": "^20.10.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
   }
 }