superjs-core 0.3.3 → 0.3.4

package/dist/logger/index.d.ts

@@ -0,0 +1 @@
+export { h as LogFn, L as LogLevel, a as Logger, i as LoggerOptions, T as Transport, c as consoleTransport, b as createBufferedTransport, d as createConsoleTransport, e as createFileTransport, f as createJsonTransport, l as logger } from '../index-BgG21uJC.js';

package/dist/logger/index.js

@@ -0,0 +1,214 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/logger/logger.ts
+var LEVEL_ORDER = { debug: 0, info: 1, warn: 2, error: 3 };
+var Logger = class _Logger {
+  _level;
+  _name;
+  _transport;
+  _extraMeta;
+  constructor(options) {
+    this._level = options?.level ?? "info";
+    this._name = options?.name;
+    this._transport = options?.transport ?? consoleTransport;
+    this._extraMeta = /* @__PURE__ */ Object.create(null);
+  }
+  _shouldLog(target) {
+    return LEVEL_ORDER[this._level] <= LEVEL_ORDER[target];
+  }
+  _log(level, message, meta) {
+    if (level !== "error" && !this._shouldLog(level)) return;
+    const merged = /* @__PURE__ */ Object.create(null);
+    for (const key of Object.keys(this._extraMeta)) {
+      merged[key] = this._extraMeta[key];
+    }
+    if (meta !== void 0) {
+      for (const key of Object.keys(meta)) {
+        merged[key] = meta[key];
+      }
+    }
+    const label = this._name !== void 0 ? `[${this._name}] ${message}` : message;
+    const finalMeta = Object.keys(merged).length > 0 ? merged : void 0;
+    this._transport.log(level, label, finalMeta);
+  }
+  /** Log at `debug` level. Only emitted when the current level is `'debug'`. */
+  debug = (message, meta) => this._log("debug", message, meta);
+  /** Log at `info` level. Emitted when level is `'debug'` or `'info'`. */
+  info = (message, meta) => this._log("info", message, meta);
+  /** Log at `warn` level. Emitted when level is `'debug'`, `'info'`, or `'warn'`. */
+  warn = (message, meta) => this._log("warn", message, meta);
+  /** Log at `error` level. Always emitted regardless of current level. */
+  error = (message, meta) => this._log("error", message, meta);
+  /**
+   * Creates a child logger that inherits the parent's level, name, and transport,
+   * but merges `extraMeta` into every log call. Child metadata is shallow-merged
+   * on top of the parent's inherited metadata.
+   *
+   * @param extraMeta - Additional context to include in every log entry.
+   */
+  child(extraMeta) {
+    const child = new _Logger({
+      level: this._level,
+      name: this._name,
+      transport: this._transport
+    });
+    const inherited = /* @__PURE__ */ Object.create(null);
+    for (const key of Object.keys(this._extraMeta)) {
+      inherited[key] = this._extraMeta[key];
+    }
+    for (const key of Object.keys(extraMeta)) {
+      inherited[key] = extraMeta[key];
+    }
+    child._extraMeta = inherited;
+    return child;
+  }
+  /** Updates the minimum log level for this instance. */
+  setLevel(level) {
+    this._level = level;
+  }
+  /** Returns the current minimum log level. */
+  getLevel() {
+    return this._level;
+  }
+  /**
+   * Creates a new named Logger.
+   * Convenience shorthand for `new Logger({ ...options, name })`.
+   *
+   * @param name - The name tag shown in log output.
+   * @param options - Additional configuration.
+   */
+  static create(name, options) {
+    return new _Logger({ ...options, name });
+  }
+};
+var consoleTransport = {
+  log(level, message, meta) {
+    const metaStr = meta !== void 0 && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+    console.log(`[${level.toUpperCase()}] ${message}${metaStr}`);
+  }
+};
+var logger = new Logger();
+
+// src/logger/transports.ts
+var LEVEL_COLORS = {
+  debug: "\x1B[90m",
+  info: "\x1B[34m",
+  warn: "\x1B[33m",
+  error: "\x1B[31m"
+};
+var RESET = "\x1B[0m";
+function createConsoleTransport(options) {
+  const useColors = options?.colors !== false;
+  const showTimestamp = options?.timestamp ?? false;
+  return {
+    log(level, message, meta) {
+      const parts = [];
+      if (showTimestamp) {
+        parts.push((/* @__PURE__ */ new Date()).toISOString());
+      }
+      if (useColors) {
+        const color = LEVEL_COLORS[level];
+        parts.push(`${color}[${level.toUpperCase()}]${RESET}`);
+      } else {
+        parts.push(`[${level.toUpperCase()}]`);
+      }
+      parts.push(message);
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        parts.push(JSON.stringify(meta));
+      }
+      console.log(parts.join(" "));
+    }
+  };
+}
+function createJsonTransport(options) {
+  const writeStream = options?.stream ?? (typeof process !== "undefined" && typeof process.stdout !== "undefined" && typeof process.stdout.write === "function" ? process.stdout : void 0);
+  return {
+    log(level, message, meta) {
+      const entry = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        level,
+        message
+      };
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        entry.meta = meta;
+      }
+      const line = JSON.stringify(entry);
+      if (writeStream !== void 0) {
+        writeStream.write(line + "\n");
+      } else {
+        console.log(line);
+      }
+    }
+  };
+}
+function createFileTransport(filename, _options) {
+  let fs = null;
+  try {
+    if (typeof process !== "undefined" && process.versions?.node) {
+      const m = __require("fs");
+      fs = m;
+    }
+  } catch {
+  }
+  return {
+    log(level, message, meta) {
+      if (fs === null) return;
+      const metaStr = meta !== void 0 && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+      const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}
+`;
+      try {
+        fs.appendFileSync(filename, line);
+      } catch {
+      }
+    }
+  };
+}
+function createBufferedTransport(transport, options) {
+  const maxSize = options?.maxSize ?? 100;
+  const flushIntervalMs = options?.flushIntervalMs ?? 5e3;
+  const buffer = [];
+  let timer;
+  function flush() {
+    if (timer !== void 0) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    for (let i = 0; i < buffer.length; i++) {
+      const entry = buffer[i];
+      transport.log(entry.level, entry.message, entry.meta);
+    }
+    buffer.length = 0;
+  }
+  function scheduleFlush() {
+    if (timer !== void 0 || flushIntervalMs <= 0) return;
+    timer = setTimeout(() => {
+      timer = void 0;
+      flush();
+    }, flushIntervalMs);
+  }
+  return {
+    log(level, message, meta) {
+      buffer.push({ level, message, meta });
+      if (buffer.length >= maxSize) {
+        flush();
+      } else {
+        scheduleFlush();
+      }
+    }
+  };
+}
+export {
+  Logger,
+  consoleTransport,
+  createBufferedTransport,
+  createConsoleTransport,
+  createFileTransport,
+  createJsonTransport,
+  logger
+};
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger/logger.ts","../../src/logger/transports.ts"],"sourcesContent":["/**\n * Represents the severity level of a log entry.\n * Ordered from least to most severe: debug < info < warn < error.\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error'\n\n/**\n * Log function signature bound to a specific severity level.\n */\nexport type LogFn = (message: string, meta?: Record<string, unknown>) => void\n\n/**\n * Configuration options for creating a Logger instance.\n */\nexport interface LoggerOptions {\n  /** Minimum log level to output (default: 'info'). */\n  level?: LogLevel\n  /** Optional name tag prepended to every message as `[name]`. */\n  name?: string\n  /** Custom transport; defaults to {@link consoleTransport}. */\n  transport?: Transport\n}\n\n/**\n * A transport handles the formatted output of log entries.\n * Implementations write to stdout, files, buffers, or remote services.\n */\nexport interface Transport {\n  log(level: LogLevel, message: string, meta?: Record<string, unknown>): void\n}\n\nconst LEVEL_ORDER: Record<LogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 }\n\n/**\n * Structured logger with level filtering, child loggers, and pluggable transport.\n *\n * @example\n * ```ts\n * const log = new Logger({ level: 'debug', name: 'app' })\n * log.info('server started', { port: 3000 })\n *\n * const child = log.child({ requestId: 'abc-123' })\n * child.warn('slow query', { durationMs: 450 })\n * ```\n */\nexport class Logger {\n  private _level: LogLevel\n  private _name?: string\n  private _transport: Transport\n  private _extraMeta: Record<string, unknown>\n\n  constructor(options?: LoggerOptions) {\n    this._level = options?.level ?? 'info'\n    this._name = options?.name\n    this._transport = options?.transport ?? consoleTransport\n    this._extraMeta = Object.create(null)\n  }\n\n  private _shouldLog(target: LogLevel): boolean {\n    return LEVEL_ORDER[this._level] <= LEVEL_ORDER[target]\n  }\n\n  private _log(level: LogLevel, message: string, meta?: Record<string, unknown>): void {\n    if (level !== 'error' && !this._shouldLog(level)) return\n\n    const merged: Record<string, unknown> = Object.create(null)\n    for (const key of Object.keys(this._extraMeta)) {\n      merged[key] = (this._extraMeta as Record<string, unknown>)[key]!\n    }\n    if (meta !== undefined) {\n      for (const key of Object.keys(meta)) {\n        merged[key] = meta[key]!\n      }\n    }\n\n    const label = this._name !== undefined ? `[${this._name}] ${message}` : message\n    const finalMeta = Object.keys(merged).length > 0 ? merged : undefined\n    this._transport.log(level, label, finalMeta)\n  }\n\n  /** Log at `debug` level. Only emitted when the current level is `'debug'`. */\n  debug: LogFn = (message, meta?) => this._log('debug', message, meta)\n\n  /** Log at `info` level. Emitted when level is `'debug'` or `'info'`. */\n  info: LogFn = (message, meta?) => this._log('info', message, meta)\n\n  /** Log at `warn` level. Emitted when level is `'debug'`, `'info'`, or `'warn'`. */\n  warn: LogFn = (message, meta?) => this._log('warn', message, meta)\n\n  /** Log at `error` level. Always emitted regardless of current level. */\n  error: LogFn = (message, meta?) => this._log('error', message, meta)\n\n  /**\n   * Creates a child logger that inherits the parent's level, name, and transport,\n   * but merges `extraMeta` into every log call. Child metadata is shallow-merged\n   * on top of the parent's inherited metadata.\n   *\n   * @param extraMeta - Additional context to include in every log entry.\n   */\n  child(extraMeta: Record<string, unknown>): Logger {\n    const child = new Logger({\n      level: this._level,\n      name: this._name,\n      transport: this._transport,\n    })\n    const inherited: Record<string, unknown> = Object.create(null)\n    for (const key of Object.keys(this._extraMeta)) {\n      inherited[key] = (this._extraMeta as Record<string, unknown>)[key]!\n    }\n    for (const key of Object.keys(extraMeta)) {\n      inherited[key] = extraMeta[key]!\n    }\n    child._extraMeta = inherited\n    return child\n  }\n\n  /** Updates the minimum log level for this instance. */\n  setLevel(level: LogLevel): void {\n    this._level = level\n  }\n\n  /** Returns the current minimum log level. */\n  getLevel(): LogLevel {\n    return this._level\n  }\n\n  /**\n   * Creates a new named Logger.\n   * Convenience shorthand for `new Logger({ ...options, name })`.\n   *\n   * @param name - The name tag shown in log output.\n   * @param options - Additional configuration.\n   */\n  static create(name: string, options?: LoggerOptions): Logger {\n    return new Logger({ ...options, name })\n  }\n}\n\n/**\n * Default transport that writes formatted log lines to `console.log`.\n *\n * Output format: `[LEVEL] message {meta}`\n *\n * When a logger has a name, the format becomes: `[LEVEL] [name] message {meta}`\n */\nexport const consoleTransport: Transport = {\n  log(level, message, meta) {\n    const metaStr =\n      meta !== undefined && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : ''\n    console.log(`[${level.toUpperCase()}] ${message}${metaStr}`)\n  },\n}\n\n/**\n * Default logger instance at `'info'` level with no name.\n */\nexport const logger: Logger = new Logger()\n","import type { LogLevel } from './logger.js'\n\n/**\n * A transport handles the formatted output of log entries.\n */\nexport interface Transport {\n  log(level: LogLevel, message: string, meta?: Record<string, unknown>): void\n}\n\nconst LEVEL_COLORS: Record<LogLevel, string> = {\n  debug: '\\x1b[90m',\n  info: '\\x1b[34m',\n  warn: '\\x1b[33m',\n  error: '\\x1b[31m',\n}\n\nconst RESET = '\\x1b[0m'\n\n/**\n * Creates a console transport that writes formatted log lines to `console.log`.\n *\n * The level prefix is optionally colored using ANSI escape codes:\n * - `debug` → gray\n * - `info`  → blue\n * - `warn`  → yellow\n * - `error` → red\n *\n * @param options - Configuration for the console transport.\n * @param options.colors - Enable ANSI color output (default: `true`).\n * @param options.timestamp - Prepend an ISO-8601 timestamp (default: `false`).\n */\nexport function createConsoleTransport(options?: {\n  colors?: boolean\n  timestamp?: boolean\n}): Transport {\n  const useColors = options?.colors !== false\n  const showTimestamp = options?.timestamp ?? false\n\n  return {\n    log(level, message, meta) {\n      const parts: string[] = []\n\n      if (showTimestamp) {\n        parts.push(new Date().toISOString())\n      }\n\n      if (useColors) {\n        const color = LEVEL_COLORS[level]\n        parts.push(`${color}[${level.toUpperCase()}]${RESET}`)\n      } else {\n        parts.push(`[${level.toUpperCase()}]`)\n      }\n\n      parts.push(message)\n\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        parts.push(JSON.stringify(meta))\n      }\n\n      console.log(parts.join(' '))\n    },\n  }\n}\n\n/**\n * Creates a transport that outputs structured JSON lines.\n *\n * Each log entry is serialized as a single JSON object with\n * `timestamp`, `level`, `message`, and optional `meta` fields.\n *\n * @param options - Configuration for the JSON transport.\n * @param options.stream - A writable stream (e.g. `process.stdout`).\n *                         Defaults to `process.stdout` in Node.js, falls\n *                         back to `console.log` in browsers.\n */\nexport function createJsonTransport(options?: {\n  stream?: { write(data: string): void }\n}): Transport {\n  const writeStream =\n    options?.stream ??\n    (typeof process !== 'undefined' &&\n    typeof process.stdout !== 'undefined' &&\n    typeof process.stdout.write === 'function'\n      ? (process.stdout as { write(data: string): void })\n      : undefined)\n\n  return {\n    log(level, message, meta) {\n      const entry: Record<string, unknown> = {\n        timestamp: new Date().toISOString(),\n        level,\n        message,\n      }\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        entry.meta = meta\n      }\n      const line = JSON.stringify(entry)\n      if (writeStream !== undefined) {\n        writeStream.write(line + '\\n')\n      } else {\n        console.log(line)\n      }\n    },\n  }\n}\n\n/**\n * Creates a transport that appends log entries to a file.\n *\n * Each line is formatted as: `[timestamp] [LEVEL] message {meta}`\n *\n * ⚠️ Node.js only. Silently discards log entries when `fs` is unavailable\n * (browsers, Deno, Bun — though Bun supports `fs`).\n *\n * @param filename - Path to the log file.\n * @param options - Configuration for the file transport.\n * @param options.maxSize - Maximum file size in bytes before rotation\n *                          (default: 10 MB). **Note:** rotation is not\n *                          yet implemented; this is reserved for future use.\n */\nexport function createFileTransport(\n  filename: string,\n  _options?: { maxSize?: number },\n): Transport {\n  // Try to resolve fs synchronously at construction time\n  // Uses process.versions.node as a heuristic for Node.js environment\n  let fs: { appendFileSync: (path: string, data: string) => void } | null = null\n  try {\n    if (typeof process !== 'undefined' && process.versions?.node) {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const m = require('fs') as { appendFileSync: (path: string, data: string) => void }\n      fs = m\n    }\n  } catch {\n    // fs unavailable (browser, edge runtime)\n  }\n\n  return {\n    log(level, message, meta) {\n      if (fs === null) return\n\n      const metaStr =\n        meta !== undefined && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : ''\n      const line = `[${new Date().toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}\\n`\n\n      try {\n        fs.appendFileSync(filename, line)\n      } catch {\n        // Silently drop if write fails (disk full, permissions, etc.)\n      }\n    },\n  }\n}\n\n/**\n * Creates a buffered transport that batches log entries and flushes them\n * to the underlying transport when either the buffer size or flush interval\n * is reached (whichever comes first).\n *\n * Useful for reducing I/O pressure in high-throughput scenarios.\n *\n * @param transport - The underlying transport to flush to.\n * @param options - Configuration for the buffer.\n * @param options.maxSize - Maximum number of entries before forced flush\n *                          (default: 100).\n * @param options.flushIntervalMs - How often to auto-flush in milliseconds\n *                                  (default: 5000). Set to `0` to disable\n *                                  interval flushing.\n */\nexport function createBufferedTransport(\n  transport: Transport,\n  options?: { maxSize?: number; flushIntervalMs?: number },\n): Transport {\n  const maxSize = options?.maxSize ?? 100\n  const flushIntervalMs = options?.flushIntervalMs ?? 5000\n\n  const buffer: Array<{\n    level: LogLevel\n    message: string\n    meta?: Record<string, unknown>\n  }> = []\n\n  let timer: ReturnType<typeof setTimeout> | undefined\n\n  function flush(): void {\n    if (timer !== undefined) {\n      clearTimeout(timer)\n      timer = undefined\n    }\n    for (let i = 0; i < buffer.length; i++) {\n      const entry = buffer[i]!\n      transport.log(entry.level, entry.message, entry.meta)\n    }\n    buffer.length = 0\n  }\n\n  function scheduleFlush(): void {\n    if (timer !== undefined || flushIntervalMs <= 0) return\n    timer = setTimeout((): void => {\n      timer = undefined\n      flush()\n    }, flushIntervalMs)\n  }\n\n  return {\n    log(level, message, meta) {\n      buffer.push({ level, message, meta })\n      if (buffer.length >= maxSize) {\n        flush()\n      } else {\n        scheduleFlush()\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/logger/transports.d.ts

@@ -0,0 +1 @@
+export { g as Transport, b as createBufferedTransport, d as createConsoleTransport, e as createFileTransport, f as createJsonTransport } from '../index-BgG21uJC.js';

package/dist/logger/transports.js

@@ -0,0 +1,122 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/logger/transports.ts
+var LEVEL_COLORS = {
+  debug: "\x1B[90m",
+  info: "\x1B[34m",
+  warn: "\x1B[33m",
+  error: "\x1B[31m"
+};
+var RESET = "\x1B[0m";
+function createConsoleTransport(options) {
+  const useColors = options?.colors !== false;
+  const showTimestamp = options?.timestamp ?? false;
+  return {
+    log(level, message, meta) {
+      const parts = [];
+      if (showTimestamp) {
+        parts.push((/* @__PURE__ */ new Date()).toISOString());
+      }
+      if (useColors) {
+        const color = LEVEL_COLORS[level];
+        parts.push(`${color}[${level.toUpperCase()}]${RESET}`);
+      } else {
+        parts.push(`[${level.toUpperCase()}]`);
+      }
+      parts.push(message);
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        parts.push(JSON.stringify(meta));
+      }
+      console.log(parts.join(" "));
+    }
+  };
+}
+function createJsonTransport(options) {
+  const writeStream = options?.stream ?? (typeof process !== "undefined" && typeof process.stdout !== "undefined" && typeof process.stdout.write === "function" ? process.stdout : void 0);
+  return {
+    log(level, message, meta) {
+      const entry = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        level,
+        message
+      };
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        entry.meta = meta;
+      }
+      const line = JSON.stringify(entry);
+      if (writeStream !== void 0) {
+        writeStream.write(line + "\n");
+      } else {
+        console.log(line);
+      }
+    }
+  };
+}
+function createFileTransport(filename, _options) {
+  let fs = null;
+  try {
+    if (typeof process !== "undefined" && process.versions?.node) {
+      const m = __require("fs");
+      fs = m;
+    }
+  } catch {
+  }
+  return {
+    log(level, message, meta) {
+      if (fs === null) return;
+      const metaStr = meta !== void 0 && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+      const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}
+`;
+      try {
+        fs.appendFileSync(filename, line);
+      } catch {
+      }
+    }
+  };
+}
+function createBufferedTransport(transport, options) {
+  const maxSize = options?.maxSize ?? 100;
+  const flushIntervalMs = options?.flushIntervalMs ?? 5e3;
+  const buffer = [];
+  let timer;
+  function flush() {
+    if (timer !== void 0) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    for (let i = 0; i < buffer.length; i++) {
+      const entry = buffer[i];
+      transport.log(entry.level, entry.message, entry.meta);
+    }
+    buffer.length = 0;
+  }
+  function scheduleFlush() {
+    if (timer !== void 0 || flushIntervalMs <= 0) return;
+    timer = setTimeout(() => {
+      timer = void 0;
+      flush();
+    }, flushIntervalMs);
+  }
+  return {
+    log(level, message, meta) {
+      buffer.push({ level, message, meta });
+      if (buffer.length >= maxSize) {
+        flush();
+      } else {
+        scheduleFlush();
+      }
+    }
+  };
+}
+export {
+  createBufferedTransport,
+  createConsoleTransport,
+  createFileTransport,
+  createJsonTransport
+};
+//# sourceMappingURL=transports.js.map

package/dist/logger/transports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger/transports.ts"],"sourcesContent":["import type { LogLevel } from './logger.js'\n\n/**\n * A transport handles the formatted output of log entries.\n */\nexport interface Transport {\n  log(level: LogLevel, message: string, meta?: Record<string, unknown>): void\n}\n\nconst LEVEL_COLORS: Record<LogLevel, string> = {\n  debug: '\\x1b[90m',\n  info: '\\x1b[34m',\n  warn: '\\x1b[33m',\n  error: '\\x1b[31m',\n}\n\nconst RESET = '\\x1b[0m'\n\n/**\n * Creates a console transport that writes formatted log lines to `console.log`.\n *\n * The level prefix is optionally colored using ANSI escape codes:\n * - `debug` → gray\n * - `info`  → blue\n * - `warn`  → yellow\n * - `error` → red\n *\n * @param options - Configuration for the console transport.\n * @param options.colors - Enable ANSI color output (default: `true`).\n * @param options.timestamp - Prepend an ISO-8601 timestamp (default: `false`).\n */\nexport function createConsoleTransport(options?: {\n  colors?: boolean\n  timestamp?: boolean\n}): Transport {\n  const useColors = options?.colors !== false\n  const showTimestamp = options?.timestamp ?? false\n\n  return {\n    log(level, message, meta) {\n      const parts: string[] = []\n\n      if (showTimestamp) {\n        parts.push(new Date().toISOString())\n      }\n\n      if (useColors) {\n        const color = LEVEL_COLORS[level]\n        parts.push(`${color}[${level.toUpperCase()}]${RESET}`)\n      } else {\n        parts.push(`[${level.toUpperCase()}]`)\n      }\n\n      parts.push(message)\n\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        parts.push(JSON.stringify(meta))\n      }\n\n      console.log(parts.join(' '))\n    },\n  }\n}\n\n/**\n * Creates a transport that outputs structured JSON lines.\n *\n * Each log entry is serialized as a single JSON object with\n * `timestamp`, `level`, `message`, and optional `meta` fields.\n *\n * @param options - Configuration for the JSON transport.\n * @param options.stream - A writable stream (e.g. `process.stdout`).\n *                         Defaults to `process.stdout` in Node.js, falls\n *                         back to `console.log` in browsers.\n */\nexport function createJsonTransport(options?: {\n  stream?: { write(data: string): void }\n}): Transport {\n  const writeStream =\n    options?.stream ??\n    (typeof process !== 'undefined' &&\n    typeof process.stdout !== 'undefined' &&\n    typeof process.stdout.write === 'function'\n      ? (process.stdout as { write(data: string): void })\n      : undefined)\n\n  return {\n    log(level, message, meta) {\n      const entry: Record<string, unknown> = {\n        timestamp: new Date().toISOString(),\n        level,\n        message,\n      }\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        entry.meta = meta\n      }\n      const line = JSON.stringify(entry)\n      if (writeStream !== undefined) {\n        writeStream.write(line + '\\n')\n      } else {\n        console.log(line)\n      }\n    },\n  }\n}\n\n/**\n * Creates a transport that appends log entries to a file.\n *\n * Each line is formatted as: `[timestamp] [LEVEL] message {meta}`\n *\n * ⚠️ Node.js only. Silently discards log entries when `fs` is unavailable\n * (browsers, Deno, Bun — though Bun supports `fs`).\n *\n * @param filename - Path to the log file.\n * @param options - Configuration for the file transport.\n * @param options.maxSize - Maximum file size in bytes before rotation\n *                          (default: 10 MB). **Note:** rotation is not\n *                          yet implemented; this is reserved for future use.\n */\nexport function createFileTransport(\n  filename: string,\n  _options?: { maxSize?: number },\n): Transport {\n  // Try to resolve fs synchronously at construction time\n  // Uses process.versions.node as a heuristic for Node.js environment\n  let fs: { appendFileSync: (path: string, data: string) => void } | null = null\n  try {\n    if (typeof process !== 'undefined' && process.versions?.node) {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const m = require('fs') as { appendFileSync: (path: string, data: string) => void }\n      fs = m\n    }\n  } catch {\n    // fs unavailable (browser, edge runtime)\n  }\n\n  return {\n    log(level, message, meta) {\n      if (fs === null) return\n\n      const metaStr =\n        meta !== undefined && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : ''\n      const line = `[${new Date().toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}\\n`\n\n      try {\n        fs.appendFileSync(filename, line)\n      } catch {\n        // Silently drop if write fails (disk full, permissions, etc.)\n      }\n    },\n  }\n}\n\n/**\n * Creates a buffered transport that batches log entries and flushes them\n * to the underlying transport when either the buffer size or flush interval\n * is reached (whichever comes first).\n *\n * Useful for reducing I/O pressure in high-throughput scenarios.\n *\n * @param transport - The underlying transport to flush to.\n * @param options - Configuration for the buffer.\n * @param options.maxSize - Maximum number of entries before forced flush\n *                          (default: 100).\n * @param options.flushIntervalMs - How often to auto-flush in milliseconds\n *                                  (default: 5000). Set to `0` to disable\n *                                  interval flushing.\n */\nexport function createBufferedTransport(\n  transport: Transport,\n  options?: { maxSize?: number; flushIntervalMs?: number },\n): Transport {\n  const maxSize = options?.maxSize ?? 100\n  const flushIntervalMs = options?.flushIntervalMs ?? 5000\n\n  const buffer: Array<{\n    level: LogLevel\n    message: string\n    meta?: Record<string, unknown>\n  }> = []\n\n  let timer: ReturnType<typeof setTimeout> | undefined\n\n  function flush(): void {\n    if (timer !== undefined) {\n      clearTimeout(timer)\n      timer = undefined\n    }\n    for (let i = 0; i < buffer.length; i++) {\n      const entry = buffer[i]!\n      transport.log(entry.level, entry.message, entry.meta)\n    }\n    buffer.length = 0\n  }\n\n  function scheduleFlush(): void {\n    if (timer !== undefined || flushIntervalMs <= 0) return\n    timer = setTimeout((): void => {\n      timer = undefined\n      flush()\n    }, flushIntervalMs)\n  }\n\n  return {\n    log(level, message, meta) {\n      buffer.push({ level, message, meta })\n      if (buffer.length >= maxSize) {\n        flush()\n      } else {\n        scheduleFlush()\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/validation/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Validates an Indonesian NIK (Nomor Induk Kependudukan / Resident Identity Number).
+ *
+ * A valid NIK:
+ * - Must be exactly 16 digits
+ * - Structure: PP CC DD DDMMYY SSSS
+ *   - PP: Province code (2 digits)
+ *   - CC: City code (2 digits)
+ *   - DD: District code (2 digits)
+ *   - DDMMYY: Birth date (6 digits; for women the day is incremented by 40)
+ *   - SSSS: Serial number (4 digits)
+ * - The birth date must correspond to a valid calendar date
+ *
+ * @param value - The NIK string (digits only or with dots)
+ * @returns `true` if the value is a valid NIK
+ *
+ * @example isNIK('3201010203940001') // => true (male, born 2 March 1994)
+ * @example isNIK('3201015203940001') // => true (female, born 12 March 1994)
+ * @example isNIK('1234567890123456') // => false (invalid birth date)
+ * @example isNIK('320101')          // => false (too short)
+ */
+declare function isNIK(value: string): boolean;
+
+/**
+ * Validates an Indonesian NPWP (Nomor Pokok Wajib Pajak / Tax Identification Number).
+ *
+ * A valid NPWP:
+ * - Must be 15 or 16 digits (formatted: `XX.XXX.XXX.X-XXX.XXX` or plain digits)
+ * - The last digit is a checksum computed from the preceding digits
+ *
+ * The checksum uses a weighted-sum algorithm with a repeating weight pattern of
+ * `[3, 7, 1]`. The computed checksum must equal the last digit.
+ *
+ * @param value - The NPWP string (formatted with dots & dash, or plain digits)
+ * @returns `true` if the value is a valid NPWP
+ *
+ * @example isNPWP('12.345.678.9-012.344') // => true
+ * @example isNPWP('123456789012344')      // => true (plain digits)
+ * @example isNPWP('12.345.678.9-012.345') // => false (invalid checksum)
+ */
+declare function isNPWP(value: string): boolean;
+
+/**
+ * Validates a phone number.
+ *
+ * For Indonesian numbers (`country = 'id'`):
+ * - Accepted formats: `08xx…`, `+628xx…`, `628xx…`
+ * - Must start with a valid operator prefix:
+ *   0811-0819, 0821-0829, 0851-0859, 0877-0879, 0895-0899
+ * - 10–13 digits after the country code
+ *
+ * For generic numbers (`country = 'any'`):
+ * - Any string with 10–15 digits is accepted
+ *
+ * @param value - The phone number string
+ * @param country - Country to validate against (`'id'` or `'any'`; default `'id'`)
+ * @returns `true` if the value is a valid phone number
+ *
+ * @example isPhone('08123456789')       // => true
+ * @example isPhone('+628123456789')     // => true
+ * @example isPhone('628123456789')      // => true
+ * @example isPhone('081234567')         // => false (too short)
+ * @example isPhone('089123456789')      // => false (invalid prefix 91)
+ */
+declare function isPhone(value: string, country?: 'id' | 'any'): boolean;
+
+/**
+ * RFC‑compliant email address validation.
+ *
+ * Validation rules:
+ * - Total length ≤ 254 characters
+ * - Local part ≤ 64 characters; supports quoted strings (including escaped
+ *   characters), unquoted letters / digits / `!#$%&'*+/=?^_`{|}~-`, and dots
+ *   (no leading, trailing, or consecutive dots)
+ * - Domain part ≤ 255 characters; valid DNS labels separated by dots, each
+ *   label ≤ 63 characters, no leading/trailing hyphens, at least two labels
+ *
+ * @param value - The email address string
+ * @returns `true` if the value is a syntactically valid email address
+ *
+ * @example isEmail('user@example.com')              // => true
+ * @example isEmail('user.name+tag@example.co.id')   // => true
+ * @example isEmail('"quoted@local"@example.com')    // => true
+ * @example isEmail('not-an-email')                  // => false
+ */
+declare function isEmail(value: string): boolean;
+
+/**
+ * Validates a URL.
+ *
+ * A valid URL:
+ * - Must use the `http` or `https` protocol
+ * - Must have a valid hostname (DNS name, IPv4, IPv6 literal, or `localhost`)
+ * - May include an optional port, path, query string, and fragment
+ *
+ * @param value - The URL string
+ * @returns `true` if the value is a valid http/https URL
+ *
+ * @example isURL('https://example.com')                 // => true
+ * @example isURL('http://example.com:8080/path?q=1#f')  // => true
+ * @example isURL('ftp://example.com')                   // => false
+ * @example isURL('not-a-url')                           // => false
+ */
+declare function isURL(value: string): boolean;
+
+export { isEmail, isNIK, isNPWP, isPhone, isURL };