@actsecurity/log 0.1.60

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, log, StandardLogger, type StandardLoggerOptions, type Logger, type LogLevel, LogLevels, normalizeArgs, type NormalizedLogArgs, setLogger, getLogger } from './log.js';
+//# 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,EACL,UAAU,EACV,GAAG,EACH,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,SAAS,EACT,aAAa,EACb,KAAK,iBAAiB,EACtB,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAA"}

package/dist/cjs/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogger = exports.setLogger = exports.normalizeArgs = exports.LogLevels = exports.StandardLogger = exports.log = exports.isLogLevel = void 0;
+var log_js_1 = require("./log.js");
+Object.defineProperty(exports, "isLogLevel", { enumerable: true, get: function () { return log_js_1.isLogLevel; } });
+Object.defineProperty(exports, "log", { enumerable: true, get: function () { return log_js_1.log; } });
+Object.defineProperty(exports, "StandardLogger", { enumerable: true, get: function () { return log_js_1.StandardLogger; } });
+Object.defineProperty(exports, "LogLevels", { enumerable: true, get: function () { return log_js_1.LogLevels; } });
+Object.defineProperty(exports, "normalizeArgs", { enumerable: true, get: function () { return log_js_1.normalizeArgs; } });
+Object.defineProperty(exports, "setLogger", { enumerable: true, get: function () { return log_js_1.setLogger; } });
+Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return log_js_1.getLogger; } });
+//# 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,mCAYiB;AAXf,oGAAA,UAAU,OAAA;AACV,6FAAA,GAAG,OAAA;AACH,wGAAA,cAAc,OAAA;AAId,mGAAA,SAAS,OAAA;AACT,uGAAA,aAAa,OAAA;AAEb,mGAAA,SAAS,OAAA;AACT,mGAAA,SAAS,OAAA"}

package/dist/cjs/log.d.ts

@@ -0,0 +1,119 @@
+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;
+/**
+ * A structured logger that outputs JSON log entries to the console.
+ * Accepts variadic arguments of mixed types: strings are joined as the message,
+ * objects are merged as context, and Errors are serialized into the entry.
+ */
+export interface Logger {
+    /** Log at error level. */
+    error: (...args: unknown[]) => void;
+    /** Log at warn level. */
+    warn: (...args: unknown[]) => void;
+    /** Log at info level. */
+    info: (...args: unknown[]) => void;
+    /** Log at debug level. */
+    debug: (...args: unknown[]) => void;
+    /** Log at trace level. */
+    trace: (...args: unknown[]) => void;
+}
+/**
+ * Options for constructing a StandardLogger.
+ */
+export interface StandardLoggerOptions {
+    /** The initial log level. Defaults to 'warn'. */
+    logLevel?: LogLevel;
+    /**
+     * When true, outputs raw objects instead of JSON.stringify for environments
+     * like CloudWatch Logs where each log line is expected to be a JSON object.
+     * Defaults to false.
+     */
+    rawJsonLogs?: boolean;
+}
+/**
+ * A logger that outputs structured JSON to the console.
+ * Supports configurable log levels, raw JSON output for CloudWatch,
+ * and variadic arguments with mixed types.
+ */
+export declare class StandardLogger implements Logger {
+    private logLevel;
+    private rawJsonLogs;
+    /**
+     * Create a new StandardLogger.
+     *
+     * @param initialLogLevel - The initial log level (backward-compatible positional form)
+     */
+    constructor(initialLogLevel?: LogLevel);
+    /**
+     * Create a new StandardLogger with options.
+     *
+     * @param options - Configuration options for the logger
+     */
+    constructor(options: StandardLoggerOptions);
+    /**
+     * Update the log level.
+     *
+     * @param level - The new log level to set
+     * @throws Error if the provided level is not a valid log level
+     */
+    setLogLevel(level: LogLevel): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    trace(...args: unknown[]): void;
+}
+/**
+ * The result of normalizing variadic log arguments into structured parts.
+ */
+export interface NormalizedLogArgs {
+    /** All string arguments joined with spaces. */
+    message: string;
+    /** All non-Error object arguments merged together. */
+    context: Record<string, unknown>;
+    /** All Error arguments, normalized to a consistent shape. */
+    errors: {
+        name: string;
+        message: string;
+        stack?: string;
+        code?: unknown;
+    }[];
+}
+/**
+ * Normalize variadic log arguments into structured parts.
+ * Separates string args (joined as message), Error args (serialized), and object args (merged as context).
+ * This is useful for adapters that need to convert cloud-copilot's variadic log calls
+ * into structured `(message, context)` calls for other logging frameworks.
+ *
+ * @param args - The variadic arguments passed to a log method
+ * @returns The normalized parts: message, context, and errors
+ */
+export declare function normalizeArgs(args: unknown[]): NormalizedLogArgs;
+/**
+ * Replace the current module-level logger with a custom implementation.
+ * Call this at application startup to inject your own logger (e.g. an adapter
+ * that bridges to another logging framework).
+ *
+ * @param logger - The logger implementation to use
+ */
+export declare function setLogger(logger: Logger): void;
+/**
+ * Get the current module-level logger.
+ *
+ * @returns The current logger instance (default: StandardLogger)
+ */
+export declare function getLogger(): Logger;
+/**
+ * A proxy object that delegates all log calls to the current module-level logger.
+ * Use this for convenient access: `log.info('message', { context })`.
+ * The underlying logger can be swapped at runtime via `setLogger()`.
+ */
+export declare const log: Logger;
+//# 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;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,0BAA0B;IAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,yBAAyB;IACzB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,yBAAyB;IACzB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,0BAA0B;IAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,0BAA0B;IAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;GAIG;AACH,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACS,eAAe,CAAC,EAAE,QAAQ;IACtC;;;;OAIG;gBACS,OAAO,EAAE,qBAAqB;IAe1C;;;;;OAKG;IACH,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;AAeD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,6DAA6D;IAC7D,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAC5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,iBAAiB,CAehE;AA4FD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;GAIG;AACH,eAAO,MAAM,GAAG,EAAE,MAMjB,CAAA"}

package/dist/cjs/log.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = exports.StandardLogger = exports.LogLevels = void 0;
+exports.isLogLevel = isLogLevel;
+exports.normalizeArgs = normalizeArgs;
+exports.setLogger = setLogger;
+exports.getLogger = getLogger;
+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);
+}
+/**
+ * A logger that outputs structured JSON to the console.
+ * Supports configurable log levels, raw JSON output for CloudWatch,
+ * and variadic arguments with mixed types.
+ */
+class StandardLogger {
+    logLevel;
+    rawJsonLogs;
+    constructor(arg) {
+        const envRawJsonLogs = typeof process !== 'undefined' &&
+            process.env?.IAM_COLLECT_RAW_JSON_LOGS?.toLowerCase() === 'true';
+        if (typeof arg === 'object' && arg !== null) {
+            this.logLevel = arg.logLevel && isLogLevel(arg.logLevel) ? arg.logLevel : 'warn';
+            this.rawJsonLogs = arg.rawJsonLogs ?? envRawJsonLogs;
+        }
+        else {
+            this.logLevel = arg && isLogLevel(arg) ? arg : 'warn';
+            this.rawJsonLogs = envRawJsonLogs;
+        }
+    }
+    /**
+     * Update the log level.
+     *
+     * @param level - The new log level to set
+     * @throws Error if the provided level is not a valid log level
+     */
+    setLogLevel(level) {
+        if (!isLogLevel(level)) {
+            throw new Error(`Invalid log level: ${level}`);
+        }
+        this.logLevel = level;
+    }
+    error(...args) {
+        logAt(this.logLevel, 'error', args, this.rawJsonLogs);
+    }
+    warn(...args) {
+        logAt(this.logLevel, 'warn', args, this.rawJsonLogs);
+    }
+    info(...args) {
+        logAt(this.logLevel, 'info', args, this.rawJsonLogs);
+    }
+    debug(...args) {
+        logAt(this.logLevel, 'debug', args, this.rawJsonLogs);
+    }
+    trace(...args) {
+        logAt(this.logLevel, 'trace', args, this.rawJsonLogs);
+    }
+}
+exports.StandardLogger = StandardLogger;
+/**
+ * Check if an object is an Error or Error-like (has name and message properties).
+ *
+ * @param obj - The object to check
+ * @returns true if the object is an Error or Error-like
+ */
+function isError(obj) {
+    return (obj instanceof Error ||
+        (typeof obj === 'object' && obj !== null && 'message' in obj && 'name' in obj));
+}
+/**
+ * Normalize variadic log arguments into structured parts.
+ * Separates string args (joined as message), Error args (serialized), and object args (merged as context).
+ * This is useful for adapters that need to convert cloud-copilot's variadic log calls
+ * into structured `(message, context)` calls for other logging frameworks.
+ *
+ * @param args - The variadic arguments passed to a log method
+ * @returns The normalized parts: message, context, and errors
+ */
+function normalizeArgs(args) {
+    const messageArgs = args.filter((a) => typeof a !== 'object' || a === null);
+    const objectArgs = args.filter((a) => typeof a === 'object' && a !== null && !isError(a));
+    const errorArgs = args.filter(isError);
+    const context = {};
+    for (const obj of objectArgs) {
+        Object.assign(context, obj);
+    }
+    return {
+        message: serializeArgs(messageArgs),
+        context,
+        errors: errorArgs.map(mapError)
+    };
+}
+// 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(' ');
+}
+/**
+ * Map an Error object to a consistent shape.
+ *
+ * @param e The error object to map
+ * @returns A normalized error object
+ */
+function mapError(e) {
+    // Normalize anything Error-like to a consistent shape
+    const { name, message, stack, code } = e;
+    return {
+        name: typeof name === 'string' ? name : 'Error',
+        message: typeof message === 'string' ? message : String(message ?? ''),
+        stack: typeof stack === 'string' ? stack : undefined,
+        ...(code !== undefined ? { code } : {})
+    };
+}
+// core log function: level check → prefix → JSON output
+function logAt(currentLevel, level, args, rawJsonLogs) {
+    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.error = mapError(errorArgs[0]);
+        entry.error_count = errorArgs.length;
+        if (errorArgs.length > 1) {
+            entry.errors = errorArgs.map(mapError);
+        }
+    }
+    /**
+     * Raw JSON logging is great for things like CloudWatch Logs where each log line
+     * is expected to be a single JSON object for easier parsing and querying.
+     *
+     * The default is JSON.stringify for each log line as a single line for processing
+     * with bash and other command-line tools.
+     */
+    const line = rawJsonLogs ? entry : 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);
+    }
+}
+// ── Module-level logger singleton ──────────────────────────────────────────────
+let currentLogger = new StandardLogger();
+/**
+ * Replace the current module-level logger with a custom implementation.
+ * Call this at application startup to inject your own logger (e.g. an adapter
+ * that bridges to another logging framework).
+ *
+ * @param logger - The logger implementation to use
+ */
+function setLogger(logger) {
+    currentLogger = logger;
+}
+/**
+ * Get the current module-level logger.
+ *
+ * @returns The current logger instance (default: StandardLogger)
+ */
+function getLogger() {
+    return currentLogger;
+}
+/**
+ * A proxy object that delegates all log calls to the current module-level logger.
+ * Use this for convenient access: `log.info('message', { context })`.
+ * The underlying logger can be swapped at runtime via `setLogger()`.
+ */
+exports.log = {
+    error: (...args) => currentLogger.error(...args),
+    warn: (...args) => currentLogger.warn(...args),
+    info: (...args) => currentLogger.info(...args),
+    debug: (...args) => currentLogger.debug(...args),
+    trace: (...args) => currentLogger.trace(...args)
+};
+//# 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, log, StandardLogger, type StandardLoggerOptions, type Logger, type LogLevel, LogLevels, normalizeArgs, type NormalizedLogArgs, setLogger, getLogger } from './log.js';
+//# 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,EACL,UAAU,EACV,GAAG,EACH,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,SAAS,EACT,aAAa,EACb,KAAK,iBAAiB,EACtB,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { isLogLevel, log, StandardLogger, LogLevels, normalizeArgs, setLogger, getLogger } from './log.js';
+//# 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,EACL,UAAU,EACV,GAAG,EACH,cAAc,EAId,SAAS,EACT,aAAa,EAEb,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAA"}

package/dist/esm/log.d.ts

@@ -0,0 +1,119 @@
+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;
+/**
+ * A structured logger that outputs JSON log entries to the console.
+ * Accepts variadic arguments of mixed types: strings are joined as the message,
+ * objects are merged as context, and Errors are serialized into the entry.
+ */
+export interface Logger {
+    /** Log at error level. */
+    error: (...args: unknown[]) => void;
+    /** Log at warn level. */
+    warn: (...args: unknown[]) => void;
+    /** Log at info level. */
+    info: (...args: unknown[]) => void;
+    /** Log at debug level. */
+    debug: (...args: unknown[]) => void;
+    /** Log at trace level. */
+    trace: (...args: unknown[]) => void;
+}
+/**
+ * Options for constructing a StandardLogger.
+ */
+export interface StandardLoggerOptions {
+    /** The initial log level. Defaults to 'warn'. */
+    logLevel?: LogLevel;
+    /**
+     * When true, outputs raw objects instead of JSON.stringify for environments
+     * like CloudWatch Logs where each log line is expected to be a JSON object.
+     * Defaults to false.
+     */
+    rawJsonLogs?: boolean;
+}
+/**
+ * A logger that outputs structured JSON to the console.
+ * Supports configurable log levels, raw JSON output for CloudWatch,
+ * and variadic arguments with mixed types.
+ */
+export declare class StandardLogger implements Logger {
+    private logLevel;
+    private rawJsonLogs;
+    /**
+     * Create a new StandardLogger.
+     *
+     * @param initialLogLevel - The initial log level (backward-compatible positional form)
+     */
+    constructor(initialLogLevel?: LogLevel);
+    /**
+     * Create a new StandardLogger with options.
+     *
+     * @param options - Configuration options for the logger
+     */
+    constructor(options: StandardLoggerOptions);
+    /**
+     * Update the log level.
+     *
+     * @param level - The new log level to set
+     * @throws Error if the provided level is not a valid log level
+     */
+    setLogLevel(level: LogLevel): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    trace(...args: unknown[]): void;
+}
+/**
+ * The result of normalizing variadic log arguments into structured parts.
+ */
+export interface NormalizedLogArgs {
+    /** All string arguments joined with spaces. */
+    message: string;
+    /** All non-Error object arguments merged together. */
+    context: Record<string, unknown>;
+    /** All Error arguments, normalized to a consistent shape. */
+    errors: {
+        name: string;
+        message: string;
+        stack?: string;
+        code?: unknown;
+    }[];
+}
+/**
+ * Normalize variadic log arguments into structured parts.
+ * Separates string args (joined as message), Error args (serialized), and object args (merged as context).
+ * This is useful for adapters that need to convert cloud-copilot's variadic log calls
+ * into structured `(message, context)` calls for other logging frameworks.
+ *
+ * @param args - The variadic arguments passed to a log method
+ * @returns The normalized parts: message, context, and errors
+ */
+export declare function normalizeArgs(args: unknown[]): NormalizedLogArgs;
+/**
+ * Replace the current module-level logger with a custom implementation.
+ * Call this at application startup to inject your own logger (e.g. an adapter
+ * that bridges to another logging framework).
+ *
+ * @param logger - The logger implementation to use
+ */
+export declare function setLogger(logger: Logger): void;
+/**
+ * Get the current module-level logger.
+ *
+ * @returns The current logger instance (default: StandardLogger)
+ */
+export declare function getLogger(): Logger;
+/**
+ * A proxy object that delegates all log calls to the current module-level logger.
+ * Use this for convenient access: `log.info('message', { context })`.
+ * The underlying logger can be swapped at runtime via `setLogger()`.
+ */
+export declare const log: Logger;
+//# 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;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,0BAA0B;IAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,yBAAyB;IACzB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,yBAAyB;IACzB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAClC,0BAA0B;IAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,0BAA0B;IAC1B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;GAIG;AACH,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACS,eAAe,CAAC,EAAE,QAAQ;IACtC;;;;OAIG;gBACS,OAAO,EAAE,qBAAqB;IAe1C;;;;;OAKG;IACH,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;AAeD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,6DAA6D;IAC7D,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAC5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,iBAAiB,CAehE;AA4FD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;GAIG;AACH,eAAO,MAAM,GAAG,EAAE,MAMjB,CAAA"}

package/dist/esm/log.js

@@ -0,0 +1,204 @@
+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);
+}
+/**
+ * A logger that outputs structured JSON to the console.
+ * Supports configurable log levels, raw JSON output for CloudWatch,
+ * and variadic arguments with mixed types.
+ */
+export class StandardLogger {
+    constructor(arg) {
+        const envRawJsonLogs = typeof process !== 'undefined' &&
+            process.env?.IAM_COLLECT_RAW_JSON_LOGS?.toLowerCase() === 'true';
+        if (typeof arg === 'object' && arg !== null) {
+            this.logLevel = arg.logLevel && isLogLevel(arg.logLevel) ? arg.logLevel : 'warn';
+            this.rawJsonLogs = arg.rawJsonLogs ?? envRawJsonLogs;
+        }
+        else {
+            this.logLevel = arg && isLogLevel(arg) ? arg : 'warn';
+            this.rawJsonLogs = envRawJsonLogs;
+        }
+    }
+    /**
+     * Update the log level.
+     *
+     * @param level - The new log level to set
+     * @throws Error if the provided level is not a valid log level
+     */
+    setLogLevel(level) {
+        if (!isLogLevel(level)) {
+            throw new Error(`Invalid log level: ${level}`);
+        }
+        this.logLevel = level;
+    }
+    error(...args) {
+        logAt(this.logLevel, 'error', args, this.rawJsonLogs);
+    }
+    warn(...args) {
+        logAt(this.logLevel, 'warn', args, this.rawJsonLogs);
+    }
+    info(...args) {
+        logAt(this.logLevel, 'info', args, this.rawJsonLogs);
+    }
+    debug(...args) {
+        logAt(this.logLevel, 'debug', args, this.rawJsonLogs);
+    }
+    trace(...args) {
+        logAt(this.logLevel, 'trace', args, this.rawJsonLogs);
+    }
+}
+/**
+ * Check if an object is an Error or Error-like (has name and message properties).
+ *
+ * @param obj - The object to check
+ * @returns true if the object is an Error or Error-like
+ */
+function isError(obj) {
+    return (obj instanceof Error ||
+        (typeof obj === 'object' && obj !== null && 'message' in obj && 'name' in obj));
+}
+/**
+ * Normalize variadic log arguments into structured parts.
+ * Separates string args (joined as message), Error args (serialized), and object args (merged as context).
+ * This is useful for adapters that need to convert cloud-copilot's variadic log calls
+ * into structured `(message, context)` calls for other logging frameworks.
+ *
+ * @param args - The variadic arguments passed to a log method
+ * @returns The normalized parts: message, context, and errors
+ */
+export function normalizeArgs(args) {
+    const messageArgs = args.filter((a) => typeof a !== 'object' || a === null);
+    const objectArgs = args.filter((a) => typeof a === 'object' && a !== null && !isError(a));
+    const errorArgs = args.filter(isError);
+    const context = {};
+    for (const obj of objectArgs) {
+        Object.assign(context, obj);
+    }
+    return {
+        message: serializeArgs(messageArgs),
+        context,
+        errors: errorArgs.map(mapError)
+    };
+}
+// 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(' ');
+}
+/**
+ * Map an Error object to a consistent shape.
+ *
+ * @param e The error object to map
+ * @returns A normalized error object
+ */
+function mapError(e) {
+    // Normalize anything Error-like to a consistent shape
+    const { name, message, stack, code } = e;
+    return {
+        name: typeof name === 'string' ? name : 'Error',
+        message: typeof message === 'string' ? message : String(message ?? ''),
+        stack: typeof stack === 'string' ? stack : undefined,
+        ...(code !== undefined ? { code } : {})
+    };
+}
+// core log function: level check → prefix → JSON output
+function logAt(currentLevel, level, args, rawJsonLogs) {
+    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.error = mapError(errorArgs[0]);
+        entry.error_count = errorArgs.length;
+        if (errorArgs.length > 1) {
+            entry.errors = errorArgs.map(mapError);
+        }
+    }
+    /**
+     * Raw JSON logging is great for things like CloudWatch Logs where each log line
+     * is expected to be a single JSON object for easier parsing and querying.
+     *
+     * The default is JSON.stringify for each log line as a single line for processing
+     * with bash and other command-line tools.
+     */
+    const line = rawJsonLogs ? entry : 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);
+    }
+}
+// ── Module-level logger singleton ──────────────────────────────────────────────
+let currentLogger = new StandardLogger();
+/**
+ * Replace the current module-level logger with a custom implementation.
+ * Call this at application startup to inject your own logger (e.g. an adapter
+ * that bridges to another logging framework).
+ *
+ * @param logger - The logger implementation to use
+ */
+export function setLogger(logger) {
+    currentLogger = logger;
+}
+/**
+ * Get the current module-level logger.
+ *
+ * @returns The current logger instance (default: StandardLogger)
+ */
+export function getLogger() {
+    return currentLogger;
+}
+/**
+ * A proxy object that delegates all log calls to the current module-level logger.
+ * Use this for convenient access: `log.info('message', { context })`.
+ * The underlying logger can be swapped at runtime via `setLogger()`.
+ */
+export const log = {
+    error: (...args) => currentLogger.error(...args),
+    warn: (...args) => currentLogger.warn(...args),
+    info: (...args) => currentLogger.info(...args),
+    debug: (...args) => currentLogger.debug(...args),
+    trace: (...args) => currentLogger.trace(...args)
+};
+//# 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":"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"}

package/dist/esm/package.json

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

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@actsecurity/log",
+  "version": "0.1.60",
+  "description": "A lightweight JSON logger",
+  "keywords": [
+    "typescript",
+    "logging"
+  ],
+  "homepage": "https://github.com/act-security-labs/log#readme",
+  "bugs": {
+    "url": "https://github.com/act-security-labs/log/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/act-security-labs/log.git"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "types": "dist/cjs/index.d.ts",
+  "license": "MIT",
+  "author": "Act Security",
+  "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": {
+    "@actsecurity/prettier-config": "^0.1.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/npm": "^13.1.4",
+    "@semantic-release/release-notes-generator": "^14.0.3",
+    "@types/node": "^22.5.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "semantic-release": "^25.0.3",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "prettier": "@actsecurity/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/exec",
+        {
+          "successCmd": "echo published=true >> $GITHUB_OUTPUT && echo version=${nextRelease.version} >> $GITHUB_OUTPUT && echo package_name=$(node -p \"require('./package.json').name\") >> $GITHUB_OUTPUT"
+        }
+      ],
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json",
+            "package-lock.json",
+            "CHANGELOG.md"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]"
+        }
+      ],
+      [
+        "@semantic-release/github",
+        {
+          "assets": []
+        }
+      ]
+    ]
+  }
+}