@cloud-copilot/log 0.1.0

package/README.md

@@ -0,0 +1,214 @@
+# Log
+
+[![NPM Version](https://img.shields.io/npm/v/@cloud-copilot/log.svg?logo=nodedotjs)](https://www.npmjs.com/package/@cloud-copilot/log) [![MIT](https://img.shields.io/github/license/cloud-copilot/log)](LICENSE.txt) [![GuardDog](https://github.com/cloud-copilot/log/actions/workflows/guarddog.yml/badge.svg)](https://github.com/cloud-copilot/log/actions/workflows/guarddog.yml) [![Known Vulnerabilities](https://snyk.io/test/github/cloud-copilot/log/badge.svg?targetFile=package.json&style=flat-square)](https://snyk.io/test/github/cloud-copilot/log?targetFile=package.json)
+
+A lightweight logger to output JSON structured logs for Typescript.
+
+## Installation
+
+```bash
+npm install @cloud-copilot/log
+```
+
+## Basic Usage
+
+```typescript
+import { StandardLogger } from '@cloud-copilot/log'
+
+// Create a logger with default log level (warn)
+const logger = new StandardLogger()
+
+// Or specify an initial log level
+const logger = new StandardLogger('info')
+
+// Log messages at different levels
+logger.error('Something went wrong')
+logger.warn('This is a warning')
+logger.info('Information message')
+logger.debug('Debug information')
+logger.trace('Trace information')
+```
+
+## Log Levels
+
+The logger supports five log levels in order of priority:
+
+- `error` (0) - Highest priority
+- `warn` (1)
+- `info` (2)
+- `debug` (3)
+- `trace` (4) - Lowest priority
+
+Only messages at or above the current log level will be output. For example, if the log level is set to `info`, then `error`, `warn`, and `info` messages will be logged, but `debug` and `trace` will be filtered out.
+
+```typescript
+const logger = new StandardLogger('info')
+
+logger.error('This will be logged') // ✓
+logger.warn('This will be logged') // ✓
+logger.info('This will be logged') // ✓
+logger.debug('This will be filtered') // ✗
+logger.trace('This will be filtered') // ✗
+```
+
+## Changing Log Level
+
+```typescript
+const logger = new StandardLogger('error')
+
+// Change the log level at runtime
+logger.setLogLevel('debug')
+
+// Invalid log levels throw an error
+logger.setLogLevel('invalid') // throws Error: Invalid log level: invalid
+```
+
+## Structured Logging
+
+The logger automatically creates structured JSON output with timestamps:
+
+```typescript
+const logger = new StandardLogger('info')
+
+logger.info('User logged in')
+// Output: {"timestamp":"2023-10-01T12:00:00.000Z","level":"info","message":"User logged in"}
+```
+
+## Object Merging
+
+Objects passed as arguments are merged into the log entry:
+
+```typescript
+logger.info('User action', {
+  userId: 123,
+  action: 'login',
+  ip: '192.168.1.1'
+})
+// Output: {"timestamp":"2023-10-01T12:00:00.000Z","level":"info","message":"User action","userId":123,"action":"login","ip":"192.168.1.1"}
+```
+
+## Error Handling
+
+Error objects are specially handled and added to an `errors` array:
+
+```typescript
+const error = new Error('Database connection failed')
+
+logger.error('Operation failed', error, { userId: 123 })
+// Output: {
+//   "timestamp": "2023-10-01T12:00:00.000Z",
+//   "level": "error",
+//   "message": "Operation failed",
+//   "userId": 123,
+//   "errors": [{
+//     "name": "Error",
+//     "message": "Database connection failed",
+//     "stack": "Error: Database connection failed\n    at ..."
+//   }]
+// }
+```
+
+## Mixed Arguments
+
+The logger handles mixed argument types intelligently:
+
+```typescript
+logger.warn(
+  'Processing user', // string message
+  { userId: 123 }, // object (merged)
+  'with status', // string message
+  { status: 'active' }, // object (merged)
+  new Error('Minor issue') // error (in errors array)
+)
+// Output: {
+//   "timestamp": "2023-10-01T12:00:00.000Z",
+//   "level": "warn",
+//   "message": "Processing user with status",
+//   "userId": 123,
+//   "status": "active",
+//   "errors": [{"name": "Error", "message": "Minor issue", "stack": "..."}]
+// }
+```
+
+## Advanced Examples
+
+### Application Logging
+
+```typescript
+import { StandardLogger } from '@cloud-copilot/log'
+
+class UserService {
+  private logger = new StandardLogger('info')
+
+  async createUser(userData: any) {
+    this.logger.info('Creating user', {
+      operation: 'createUser',
+      email: userData.email
+    })
+
+    try {
+      // ... user creation logic
+      this.logger.info('User created successfully', {
+        userId: newUser.id,
+        email: newUser.email
+      })
+    } catch (error) {
+      this.logger.error('Failed to create user', error, {
+        email: userData.email
+      })
+      throw error
+    }
+  }
+}
+```
+
+### Environment-based Log Levels
+
+```typescript
+const logLevel = process.env.LOG_LEVEL || 'warn'
+const logger = new StandardLogger(logLevel as LogLevel)
+
+// In production: LOG_LEVEL=error (only errors)
+// In development: LOG_LEVEL=debug (detailed logging)
+```
+
+### Validating Log Levels
+
+Use the `isLogLevel` utility function to validate log level strings:
+
+```typescript
+import { isLogLevel } from '@cloud-copilot/log'
+
+// Validate user input
+const userInput = 'debug'
+if (isLogLevel(userInput)) {
+  const logger = new StandardLogger(userInput)
+} else {
+  console.error('Invalid log level provided')
+}
+
+// Safe environment variable parsing
+const envLogLevel = process.env.LOG_LEVEL
+const logLevel = isLogLevel(envLogLevel) ? envLogLevel : 'warn'
+const logger = new StandardLogger(logLevel)
+
+// Type guard in functions
+function createLoggerFromConfig(config: { logLevel?: string }) {
+  if (config.logLevel && isLogLevel(config.logLevel)) {
+    return new StandardLogger(config.logLevel)
+  }
+  return new StandardLogger() // defaults to 'warn'
+}
+```
+
+## TypeScript Support
+
+Full TypeScript support with proper type definitions:
+
+```typescript
+import { StandardLogger, LogLevel, LogLevels, isLogLevel } from '@cloud-copilot/log'
+
+const logger: StandardLogger = new StandardLogger()
+const level: LogLevel = 'info'
+const isValid: boolean = isLogLevel('debug') // true
+```

package/dist/cjs/index.d.ts

@@ -0,0 +1,2 @@
+export { isLogLevel, StandardLogger, type LogLevel } from './log';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAA"}

package/dist/cjs/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardLogger = exports.isLogLevel = void 0;
+var log_1 = require("./log");
+Object.defineProperty(exports, "isLogLevel", { enumerable: true, get: function () { return log_1.isLogLevel; } });
+Object.defineProperty(exports, "StandardLogger", { enumerable: true, get: function () { return log_1.StandardLogger; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,6BAAiE;AAAxD,iGAAA,UAAU,OAAA;AAAE,qGAAA,cAAc,OAAA"}

package/dist/cjs/log.d.ts

@@ -0,0 +1,28 @@
+export declare const LogLevels: readonly ["error", "warn", "info", "debug", "trace"];
+export type LogLevel = (typeof LogLevels)[number];
+/**
+ * Determine if a string is a valid log level.
+ *
+ * @param level the log level string to check
+ * @returns true if the string is a valid log level, false otherwise
+ */
+export declare function isLogLevel(level: string | LogLevel): level is LogLevel;
+interface Logger {
+    error: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+    trace: (...args: unknown[]) => void;
+}
+export declare class StandardLogger implements Logger {
+    private logLevel;
+    constructor(initialLogLevel?: LogLevel);
+    setLogLevel(level: LogLevel): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    trace(...args: unknown[]): void;
+}
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/cjs/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,sDAAuD,CAAA;AAE7E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;AAUjD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,IAAI,QAAQ,CAEtE;AAED,UAAU,MAAM;IACd,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,QAAQ,CAAU;gBAEd,eAAe,CAAC,EAAE,QAAQ;IAQtC,WAAW,CAAC,KAAK,EAAE,QAAQ;IAO3B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGxB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGvB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGxB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;CAGzB"}

package/dist/cjs/log.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardLogger = exports.LogLevels = void 0;
+exports.isLogLevel = isLogLevel;
+exports.LogLevels = ['error', 'warn', 'info', 'debug', 'trace'];
+const LEVELS = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+    trace: 4
+};
+/**
+ * Determine if a string is a valid log level.
+ *
+ * @param level the log level string to check
+ * @returns true if the string is a valid log level, false otherwise
+ */
+function isLogLevel(level) {
+    return level !== undefined && LEVELS.hasOwnProperty(level);
+}
+class StandardLogger {
+    logLevel;
+    constructor(initialLogLevel) {
+        if (initialLogLevel && isLogLevel(initialLogLevel)) {
+            this.logLevel = initialLogLevel;
+        }
+        else {
+            this.logLevel = 'warn';
+        }
+    }
+    setLogLevel(level) {
+        if (!isLogLevel(level)) {
+            throw new Error(`Invalid log level: ${level}`);
+        }
+        this.logLevel = level;
+    }
+    error(...args) {
+        logAt(this.logLevel, 'error', args);
+    }
+    warn(...args) {
+        logAt(this.logLevel, 'warn', args);
+    }
+    info(...args) {
+        logAt(this.logLevel, 'info', args);
+    }
+    debug(...args) {
+        logAt(this.logLevel, 'debug', args);
+    }
+    trace(...args) {
+        logAt(this.logLevel, 'trace', args);
+    }
+}
+exports.StandardLogger = StandardLogger;
+// helper to serialize non-object args into a single string
+function serializeArgs(args) {
+    return args
+        .map((a) => typeof a === 'string'
+        ? a
+        : a instanceof Error
+            ? a.stack || a.message
+            : a === undefined
+                ? 'undefined'
+                : JSON.stringify(a))
+        .join(' ');
+}
+function isError(obj) {
+    return (obj instanceof Error ||
+        (typeof obj === 'object' && obj !== null && 'message' in obj && 'name' in obj));
+}
+// core log function: level check → prefix → JSON output
+function logAt(currentLevel, level, args) {
+    if (LEVELS[level] > LEVELS[currentLevel])
+        return;
+    // Base log entry
+    const entry = {
+        timestamp: new Date().toISOString(),
+        level
+    };
+    // Separate object args and message args
+    const objectArgs = args.filter((a) => typeof a === 'object' && a !== null && !isError(a));
+    const messageArgs = args.filter((a) => typeof a !== 'object' || a === null);
+    const errorArgs = args.filter(isError);
+    // Merge all object arguments into the entry
+    for (const obj of objectArgs) {
+        Object.assign(entry, obj);
+    }
+    const msg = serializeArgs(messageArgs);
+    if (msg) {
+        entry.message = msg;
+    }
+    if (errorArgs.length > 0) {
+        entry.errors = errorArgs.map((e) => ({
+            name: e.name,
+            message: e.message,
+            stack: e.stack
+        }));
+    }
+    const line = JSON.stringify(entry);
+    switch (level) {
+        case 'error':
+            return console.error(line);
+        case 'warn':
+            return console.warn(line);
+        case 'info':
+            return console.info(line);
+        default:
+            return console.log(line);
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/cjs/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"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"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "commonjs"
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,2 @@
+export { isLogLevel, StandardLogger, type LogLevel } from './log';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { isLogLevel, StandardLogger } from './log';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAiB,MAAM,OAAO,CAAA"}

package/dist/esm/log.d.ts

@@ -0,0 +1,28 @@
+export declare const LogLevels: readonly ["error", "warn", "info", "debug", "trace"];
+export type LogLevel = (typeof LogLevels)[number];
+/**
+ * Determine if a string is a valid log level.
+ *
+ * @param level the log level string to check
+ * @returns true if the string is a valid log level, false otherwise
+ */
+export declare function isLogLevel(level: string | LogLevel): level is LogLevel;
+interface Logger {
+    error: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+    trace: (...args: unknown[]) => void;
+}
+export declare class StandardLogger implements Logger {
+    private logLevel;
+    constructor(initialLogLevel?: LogLevel);
+    setLogLevel(level: LogLevel): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    trace(...args: unknown[]): void;
+}
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/esm/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,sDAAuD,CAAA;AAE7E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;AAUjD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,IAAI,QAAQ,CAEtE;AAED,UAAU,MAAM;IACd,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,QAAQ,CAAU;gBAEd,eAAe,CAAC,EAAE,QAAQ;IAQtC,WAAW,CAAC,KAAK,EAAE,QAAQ;IAO3B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGxB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGvB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAGxB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;CAGzB"}

package/dist/esm/log.js

@@ -0,0 +1,105 @@
+export const LogLevels = ['error', 'warn', 'info', 'debug', 'trace'];
+const LEVELS = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+    trace: 4
+};
+/**
+ * Determine if a string is a valid log level.
+ *
+ * @param level the log level string to check
+ * @returns true if the string is a valid log level, false otherwise
+ */
+export function isLogLevel(level) {
+    return level !== undefined && LEVELS.hasOwnProperty(level);
+}
+export class StandardLogger {
+    constructor(initialLogLevel) {
+        if (initialLogLevel && isLogLevel(initialLogLevel)) {
+            this.logLevel = initialLogLevel;
+        }
+        else {
+            this.logLevel = 'warn';
+        }
+    }
+    setLogLevel(level) {
+        if (!isLogLevel(level)) {
+            throw new Error(`Invalid log level: ${level}`);
+        }
+        this.logLevel = level;
+    }
+    error(...args) {
+        logAt(this.logLevel, 'error', args);
+    }
+    warn(...args) {
+        logAt(this.logLevel, 'warn', args);
+    }
+    info(...args) {
+        logAt(this.logLevel, 'info', args);
+    }
+    debug(...args) {
+        logAt(this.logLevel, 'debug', args);
+    }
+    trace(...args) {
+        logAt(this.logLevel, 'trace', args);
+    }
+}
+// helper to serialize non-object args into a single string
+function serializeArgs(args) {
+    return args
+        .map((a) => typeof a === 'string'
+        ? a
+        : a instanceof Error
+            ? a.stack || a.message
+            : a === undefined
+                ? 'undefined'
+                : JSON.stringify(a))
+        .join(' ');
+}
+function isError(obj) {
+    return (obj instanceof Error ||
+        (typeof obj === 'object' && obj !== null && 'message' in obj && 'name' in obj));
+}
+// core log function: level check → prefix → JSON output
+function logAt(currentLevel, level, args) {
+    if (LEVELS[level] > LEVELS[currentLevel])
+        return;
+    // Base log entry
+    const entry = {
+        timestamp: new Date().toISOString(),
+        level
+    };
+    // Separate object args and message args
+    const objectArgs = args.filter((a) => typeof a === 'object' && a !== null && !isError(a));
+    const messageArgs = args.filter((a) => typeof a !== 'object' || a === null);
+    const errorArgs = args.filter(isError);
+    // Merge all object arguments into the entry
+    for (const obj of objectArgs) {
+        Object.assign(entry, obj);
+    }
+    const msg = serializeArgs(messageArgs);
+    if (msg) {
+        entry.message = msg;
+    }
+    if (errorArgs.length > 0) {
+        entry.errors = errorArgs.map((e) => ({
+            name: e.name,
+            message: e.message,
+            stack: e.stack
+        }));
+    }
+    const line = JSON.stringify(entry);
+    switch (level) {
+        case 'error':
+            return console.error(line);
+        case 'warn':
+            return console.warn(line);
+        case 'info':
+            return console.info(line);
+        default:
+            return console.log(line);
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/esm/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAA;AAI7E,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;CACT,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;AAC5D,CAAC;AAUD,MAAM,OAAO,cAAc;IAGzB,YAAY,eAA0B;QACpC,IAAI,eAAe,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAA;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAA;QACxB,CAAC;IACH,CAAC;IAED,WAAW,CAAC,KAAe;QACzB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAA;QAChD,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;IACD,IAAI,CAAC,GAAG,IAAe;QACrB,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC;IACD,IAAI,CAAC,GAAG,IAAe;QACrB,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;CACF;AAED,2DAA2D;AAC3D,SAAS,aAAa,CAAC,IAAe;IACpC,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,OAAO,CAAC,KAAK,QAAQ;QACnB,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,CAAC,YAAY,KAAK;YAClB,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO;YACtB,CAAC,CAAC,CAAC,KAAK,SAAS;gBACf,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAC1B;SACA,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,OAAO,CACL,GAAG,YAAY,KAAK;QACpB,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,CAC/E,CAAA;AACH,CAAC;AAED,wDAAwD;AACxD,SAAS,KAAK,CAAC,YAAsB,EAAE,KAAe,EAAE,IAAe;IACrE,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;QAAE,OAAM;IAEhD,iBAAiB;IACjB,MAAM,KAAK,GAAwB;QACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;KACN,CAAA;IAED,wCAAwC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IACzF,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAA;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEtC,4CAA4C;IAC5C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;IACtC,IAAI,GAAG,EAAE,CAAC;QACR,KAAK,CAAC,OAAO,GAAG,GAAG,CAAA;IACrB,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CAAA;IACL,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAElC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC5B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B;YACE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "module"
+}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@cloud-copilot/log",
+  "version": "0.1.0",
+  "description": "A lightweight JSON logger",
+  "keywords": [
+    "typescript",
+    "logging"
+  ],
+  "homepage": "https://github.com/cloud-copilot/log#readme",
+  "bugs": {
+    "url": "https://github.com/cloud-copilot/log/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloud-copilot/log.git"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "types": "dist/cjs/index.d.ts",
+  "license": "MIT",
+  "author": "David Kerber <dave@cloudcopilot.io>",
+  "main": "dist/esm/index.js",
+  "scripts": {
+    "build": "npx tsc -p tsconfig.cjs.json && npx tsc -p tsconfig.esm.json && ./postbuild.sh",
+    "clean": "rm -rf dist",
+    "test": "npx vitest --run --coverage",
+    "release": "npm install && npm run clean && npm run build && npm test && npm run format-check && npm publish",
+    "format": "npx prettier --write src/",
+    "format-check": "npx prettier --check src/"
+  },
+  "devDependencies": {
+    "@cloud-copilot/prettier-config": "^0.1.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.1",
+    "@semantic-release/npm": "^12.0.1",
+    "@semantic-release/release-notes-generator": "^14.0.3",
+    "@types/node": "^22.5.0",
+    "@vitest/coverage-v8": "^3.0.7",
+    "semantic-release": "^24.2.1",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.7"
+  },
+  "prettier": "@cloud-copilot/prettier-config",
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "releaseRules": [
+            {
+              "type": "feat",
+              "release": "patch"
+            },
+            {
+              "type": "fix",
+              "release": "patch"
+            },
+            {
+              "breaking": true,
+              "release": "patch"
+            },
+            {
+              "type": "*",
+              "release": "patch"
+            }
+          ]
+        }
+      ],
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/changelog",
+      [
+        "@semantic-release/npm",
+        {
+          "npmPublish": true
+        }
+      ],
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json",
+            "package-lock.json",
+            "CHANGELOG.md"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]"
+        }
+      ],
+      [
+        "@semantic-release/github",
+        {
+          "assets": []
+        }
+      ]
+    ]
+  }
+}