@tanngo11/log 0.3.0

package/dist/chunk-QMC6BWGK.js

@@ -0,0 +1,203 @@
+// src/context.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+// src/global.ts
+function globalSingleton(name, make) {
+  const key = /* @__PURE__ */ Symbol.for(`@tanngo11/log.${name}`);
+  const g = globalThis;
+  let value = g[key];
+  if (value === void 0) {
+    value = make();
+    g[key] = value;
+  }
+  return value;
+}
+
+// src/context.ts
+var als = globalSingleton("als", () => new AsyncLocalStorage());
+var STORE_KEY = /* @__PURE__ */ Symbol.for("@tanngo11/log.store");
+function runWithStore(fields, fn) {
+  const parent = als.getStore();
+  const store = { fields: { ...parent?.fields, ...fields }, parent };
+  return als.run(store, () => fn(store));
+}
+function withContext(fields, fn) {
+  return runWithStore(fields, () => fn());
+}
+function currentStore() {
+  return als.getStore();
+}
+function getContext() {
+  return als.getStore()?.fields ?? {};
+}
+function addContext(fields) {
+  for (let s = als.getStore(); s; s = s.parent) Object.assign(s.fields, fields);
+}
+function recordErrorIn(store, err) {
+  store.error = err;
+  for (let s = store.parent; s; s = s.parent) if (s.error === void 0) s.error = err;
+}
+function recordError(err) {
+  const store = als.getStore();
+  if (store) recordErrorIn(store, err);
+}
+function attachStore(target, store) {
+  target[STORE_KEY] = store;
+}
+function storeOf(target) {
+  if (typeof target !== "object" || target === null) return void 0;
+  return target[STORE_KEY];
+}
+
+// src/redact.ts
+var DEFAULT_REDACT_KEYS = [
+  "password",
+  "passwd",
+  "pwd",
+  "passphrase",
+  "secret",
+  "client_secret",
+  "token",
+  "access_token",
+  "refresh_token",
+  "id_token",
+  "auth_token",
+  "api_key",
+  "apikey",
+  "access_key",
+  "secret_key",
+  "private_key",
+  "authorization",
+  "cookie",
+  "set_cookie",
+  "session_id",
+  "sessionid",
+  "credential",
+  "credentials",
+  "dsn",
+  "connection_string",
+  "conn_string",
+  "jwt",
+  "bearer"
+];
+var REDACT_PATTERNS = {
+  /** Vietnamese mobile numbers: 0912345678, +84912345678, 84912345678. */
+  phoneVN: /(?<![\d+])(?:\+?84|0)[35789]\d{8}(?!\d)/g,
+  /** Visa, Mastercard, Amex, Discover-like card numbers, with optional spaces or dashes. */
+  paymentCard: /(?<!\d)(?:4\d{3}|5[1-5]\d{2}|2[2-7]\d{2}|3[47]\d{2}|6(?:011|5\d{2}))(?:[ -]?\d{4}){2}[ -]?\d{1,4}(?!\d)/g,
+  /** IPv4 addresses. */
+  ipv4: /(?<![\d.])(?:\d{1,3}\.){3}\d{1,3}(?![\d.])/g
+};
+var SAFE_SUFFIXES = ["_count", "_type", "_length", "_expires_at", "_expires_in", "_ttl", "_at", "_ms", "_enabled"];
+var REDACTED = "[REDACTED]";
+function toSnakeCase(key) {
+  return key.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/[^A-Za-z0-9_]+/g, "_").toLowerCase();
+}
+var URL_CREDENTIALS_RE = /([a-z][a-z0-9+.-]*:\/\/)[^\s/@:"']+:[^\s/@"']+@/gi;
+var BEARER_RE = /\bBearer\s+[A-Za-z0-9._~+/=-]+/gi;
+var JWT_RE = /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g;
+var EMAIL_RE = /[A-Za-z0-9._%+-]+@([A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,})/g;
+function globalize(re) {
+  return re.flags.includes("g") ? new RegExp(re.source, re.flags) : new RegExp(re.source, `${re.flags}g`);
+}
+function createRedactor(opts = {}) {
+  const words = [...DEFAULT_REDACT_KEYS];
+  const keyPatterns = [];
+  for (const k of opts.keys ?? []) {
+    if (typeof k === "string") words.push(toSnakeCase(k));
+    else keyPatterns.push(new RegExp(k.source, k.flags.replace("g", "")));
+  }
+  const valuePatterns = (opts.values ?? []).map(globalize);
+  const isSensitive = (key) => {
+    const k = toSnakeCase(key);
+    if (keyPatterns.some((re) => re.test(k))) return true;
+    if (!words.includes(k) && SAFE_SUFFIXES.some((s) => k.endsWith(s))) return false;
+    return words.some((w) => k === w || k.startsWith(`${w}_`) || k.endsWith(`_${w}`) || k.includes(`_${w}_`));
+  };
+  const scrub = (s) => {
+    let out = s.replace(URL_CREDENTIALS_RE, `$1${REDACTED}@`).replace(BEARER_RE, `Bearer ${REDACTED}`).replace(JWT_RE, "[REDACTED_JWT]").replace(EMAIL_RE, "***@$1");
+    for (const re of valuePatterns) out = out.replace(re, REDACTED);
+    return out;
+  };
+  const json = (value) => {
+    if (typeof value === "string") return value;
+    try {
+      const text = JSON.stringify(value, (key, val) => {
+        if (key && val !== null && val !== void 0 && isSensitive(key)) return REDACTED;
+        if (typeof val === "bigint") return val.toString();
+        if (val instanceof Error) return { name: val.name, message: val.message };
+        return val;
+      });
+      return text ?? String(value);
+    } catch {
+      return String(value);
+    }
+  };
+  return { isSensitive, scrub, json };
+}
+var defaultRedactor = createRedactor();
+
+// src/error.ts
+var MAX_CAUSE_DEPTH = 5;
+function isErrorLike(v) {
+  if (v instanceof Error) return true;
+  return typeof v === "object" && v !== null && typeof v.message === "string" && ("stack" in v || "name" in v);
+}
+function errorType(e) {
+  if (e.name && e.name !== "Error") return e.name;
+  const ctor = e.constructor?.name;
+  return ctor && ctor !== "Object" ? ctor : "Error";
+}
+function serializeError(err) {
+  if (!isErrorLike(err)) {
+    if (typeof err === "string") return { err_type: "string", err_message: err };
+    return { err_type: typeof err, err_message: defaultRedactor.json(err) };
+  }
+  const e = err;
+  const out = { err_type: errorType(e), err_message: String(e.message ?? "") };
+  if (e.code !== void 0 && e.code !== null) out.err_code = String(e.code);
+  if (typeof e.stack === "string") out.err_stack = e.stack;
+  const causes = [];
+  let cause = e.cause;
+  while (cause !== void 0 && cause !== null && causes.length < MAX_CAUSE_DEPTH) {
+    if (isErrorLike(cause)) {
+      causes.push(`${errorType(cause)}: ${cause.message}`);
+      cause = cause.cause;
+    } else {
+      causes.push(defaultRedactor.json(cause));
+      cause = void 0;
+    }
+  }
+  if (causes.length > 0) out.err_cause = causes.join(" <- ");
+  return out;
+}
+var logged = globalSingleton("logged", () => /* @__PURE__ */ new WeakSet());
+function markLogged(err) {
+  if (typeof err === "object" && err !== null) logged.add(err);
+}
+function isLogged(err) {
+  return typeof err === "object" && err !== null && logged.has(err);
+}
+
+export {
+  globalSingleton,
+  runWithStore,
+  withContext,
+  currentStore,
+  getContext,
+  addContext,
+  recordErrorIn,
+  recordError,
+  attachStore,
+  storeOf,
+  REDACT_PATTERNS,
+  REDACTED,
+  toSnakeCase,
+  createRedactor,
+  defaultRedactor,
+  isErrorLike,
+  serializeError,
+  markLogged,
+  isLogged
+};
+//# sourceMappingURL=chunk-QMC6BWGK.js.map

package/dist/chunk-QMC6BWGK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/global.ts","../src/redact.ts","../src/error.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { globalSingleton } from \"./global\";\nimport type { Fields } from \"./normalize\";\n\nexport interface ContextStore {\n  fields: Fields;\n  error?: unknown;\n  /** Route template captured while the router still knew it (Express error path). */\n  route?: string;\n  parent?: ContextStore;\n}\n\nconst als = globalSingleton(\"als\", () => new AsyncLocalStorage<ContextStore>());\n\nexport const STORE_KEY: symbol = Symbol.for(\"@tanngo11/log.store\");\n\nexport function runWithStore<T>(fields: Fields, fn: (store: ContextStore) => T): T {\n  const parent = als.getStore();\n  const store: ContextStore = { fields: { ...parent?.fields, ...fields }, parent };\n  return als.run(store, () => fn(store));\n}\n\nexport function withContext<T>(fields: Fields, fn: () => T): T {\n  return runWithStore(fields, () => fn());\n}\n\nexport function currentStore(): ContextStore | undefined {\n  return als.getStore();\n}\n\nexport function getContext(): Fields {\n  return als.getStore()?.fields ?? {};\n}\n\n// Applies to the current context and every enclosing one, so a field added inside a nested\n// withContext/runJob still reaches the request's http.request line.\nexport function addContext(fields: Fields): void {\n  for (let s = als.getStore(); s; s = s.parent) Object.assign(s.fields, fields);\n}\n\n// Sets the error on the store and on enclosing stores that have none yet.\nexport function recordErrorIn(store: ContextStore, err: unknown): void {\n  store.error = err;\n  for (let s = store.parent; s; s = s.parent) if (s.error === undefined) s.error = err;\n}\n\n// Marks the error that the current request/job summary line should carry. Does not write a line.\nexport function recordError(err: unknown): void {\n  const store = als.getStore();\n  if (store) recordErrorIn(store, err);\n}\n\nexport function attachStore(target: object, store: ContextStore): void {\n  (target as Record<symbol, ContextStore>)[STORE_KEY] = store;\n}\n\nexport function storeOf(target: unknown): ContextStore | undefined {\n  if (typeof target !== \"object\" || target === null) return undefined;\n  return (target as Record<symbol, ContextStore | undefined>)[STORE_KEY];\n}\n","// Singletons shared by every copy of this package loaded in the process (ESM and CJS builds,\n// or duplicated installs), so context and dedupe state never split.\nexport function globalSingleton<T>(name: string, make: () => T): T {\n  const key = Symbol.for(`@tanngo11/log.${name}`);\n  const g = globalThis as unknown as Record<symbol, T | undefined>;\n  let value = g[key];\n  if (value === undefined) {\n    value = make();\n    g[key] = value;\n  }\n  return value;\n}\n","// Redaction shared by the logger and the error serializer. The collector redacts again,\n// but it cannot see secrets inside JSON-encoded strings, so the app side must catch them.\n\nexport const DEFAULT_REDACT_KEYS = [\n  \"password\", \"passwd\", \"pwd\", \"passphrase\", \"secret\", \"client_secret\",\n  \"token\", \"access_token\", \"refresh_token\", \"id_token\", \"auth_token\",\n  \"api_key\", \"apikey\", \"access_key\", \"secret_key\", \"private_key\",\n  \"authorization\", \"cookie\", \"set_cookie\", \"session_id\", \"sessionid\",\n  \"credential\", \"credentials\", \"dsn\", \"connection_string\", \"conn_string\", \"jwt\", \"bearer\",\n];\n\n/** Opt-in value patterns for `redactValues`. Not on by default: they can hit ordinary numbers. */\nexport const REDACT_PATTERNS = {\n  /** Vietnamese mobile numbers: 0912345678, +84912345678, 84912345678. */\n  phoneVN: /(?<![\\d+])(?:\\+?84|0)[35789]\\d{8}(?!\\d)/g,\n  /** Visa, Mastercard, Amex, Discover-like card numbers, with optional spaces or dashes. */\n  paymentCard: /(?<!\\d)(?:4\\d{3}|5[1-5]\\d{2}|2[2-7]\\d{2}|3[47]\\d{2}|6(?:011|5\\d{2}))(?:[ -]?\\d{4}){2}[ -]?\\d{1,4}(?!\\d)/g,\n  /** IPv4 addresses. */\n  ipv4: /(?<![\\d.])(?:\\d{1,3}\\.){3}\\d{1,3}(?![\\d.])/g,\n} as const;\n\n// Keys that only describe a secret (count, type, timestamps, flags) stay readable.\nconst SAFE_SUFFIXES = [\"_count\", \"_type\", \"_length\", \"_expires_at\", \"_expires_in\", \"_ttl\", \"_at\", \"_ms\", \"_enabled\"];\n\nexport const REDACTED = \"[REDACTED]\";\n\nexport function toSnakeCase(key: string): string {\n  return key\n    .replace(/([a-z0-9])([A-Z])/g, \"$1_$2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1_$2\")\n    .replace(/[^A-Za-z0-9_]+/g, \"_\")\n    .toLowerCase();\n}\n\nconst URL_CREDENTIALS_RE = /([a-z][a-z0-9+.-]*:\\/\\/)[^\\s/@:\"']+:[^\\s/@\"']+@/gi;\nconst BEARER_RE = /\\bBearer\\s+[A-Za-z0-9._~+/=-]+/gi;\nconst JWT_RE = /\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+/g;\nconst EMAIL_RE = /[A-Za-z0-9._%+-]+@([A-Za-z0-9-]+(?:\\.[A-Za-z0-9-]+)*\\.[A-Za-z]{2,})/g;\n\nexport type KeyPattern = string | RegExp;\n\nexport interface RedactorOptions {\n  /** Extra sensitive keys: names (matched like the defaults) or patterns tested on the snake_case key. */\n  keys?: readonly KeyPattern[];\n  /** Extra value patterns; every match inside any string becomes [REDACTED]. */\n  values?: readonly RegExp[];\n}\n\nexport interface Redactor {\n  isSensitive(key: string): boolean;\n  /** Masks secrets and emails that appear inside free text. */\n  scrub(s: string): string;\n  /** JSON.stringify that redacts sensitive keys at any depth and never throws. */\n  json(value: unknown): string;\n}\n\nfunction globalize(re: RegExp): RegExp {\n  return re.flags.includes(\"g\") ? new RegExp(re.source, re.flags) : new RegExp(re.source, `${re.flags}g`);\n}\n\nexport function createRedactor(opts: RedactorOptions = {}): Redactor {\n  const words = [...DEFAULT_REDACT_KEYS];\n  const keyPatterns: RegExp[] = [];\n  for (const k of opts.keys ?? []) {\n    if (typeof k === \"string\") words.push(toSnakeCase(k));\n    else keyPatterns.push(new RegExp(k.source, k.flags.replace(\"g\", \"\")));\n  }\n  const valuePatterns = (opts.values ?? []).map(globalize);\n\n  const isSensitive = (key: string): boolean => {\n    const k = toSnakeCase(key);\n    if (keyPatterns.some((re) => re.test(k))) return true;\n    if (!words.includes(k) && SAFE_SUFFIXES.some((s) => k.endsWith(s))) return false;\n    return words.some((w) => k === w || k.startsWith(`${w}_`) || k.endsWith(`_${w}`) || k.includes(`_${w}_`));\n  };\n\n  const scrub = (s: string): string => {\n    let out = s\n      .replace(URL_CREDENTIALS_RE, `$1${REDACTED}@`)\n      .replace(BEARER_RE, `Bearer ${REDACTED}`)\n      .replace(JWT_RE, \"[REDACTED_JWT]\")\n      .replace(EMAIL_RE, \"***@$1\");\n    for (const re of valuePatterns) out = out.replace(re, REDACTED);\n    return out;\n  };\n\n  const json = (value: unknown): string => {\n    if (typeof value === \"string\") return value;\n    try {\n      const text = JSON.stringify(value, (key, val: unknown) => {\n        if (key && val !== null && val !== undefined && isSensitive(key)) return REDACTED;\n        if (typeof val === \"bigint\") return val.toString();\n        if (val instanceof Error) return { name: val.name, message: val.message };\n        return val;\n      });\n      return text ?? String(value);\n    } catch {\n      return String(value);\n    }\n  };\n\n  return { isSensitive, scrub, json };\n}\n\nexport const defaultRedactor: Redactor = createRedactor();\n","import { globalSingleton } from \"./global\";\nimport { defaultRedactor } from \"./redact\";\n\nexport interface ErrFields {\n  err_type?: string;\n  err_message?: string;\n  err_code?: string;\n  err_stack?: string;\n  err_cause?: string;\n}\n\nconst MAX_CAUSE_DEPTH = 5;\n\nexport function isErrorLike(v: unknown): v is Error {\n  if (v instanceof Error) return true;\n  return (\n    typeof v === \"object\" &&\n    v !== null &&\n    typeof (v as { message?: unknown }).message === \"string\" &&\n    (\"stack\" in v || \"name\" in v)\n  );\n}\n\nfunction errorType(e: Error): string {\n  if (e.name && e.name !== \"Error\") return e.name;\n  const ctor = (e as { constructor?: { name?: string } }).constructor?.name;\n  return ctor && ctor !== \"Object\" ? ctor : \"Error\";\n}\n\nexport function serializeError(err: unknown): ErrFields {\n  if (!isErrorLike(err)) {\n    if (typeof err === \"string\") return { err_type: \"string\", err_message: err };\n    return { err_type: typeof err, err_message: defaultRedactor.json(err) };\n  }\n  const e = err as Error & { code?: unknown; cause?: unknown };\n  const out: ErrFields = { err_type: errorType(e), err_message: String(e.message ?? \"\") };\n  if (e.code !== undefined && e.code !== null) out.err_code = String(e.code);\n  if (typeof e.stack === \"string\") out.err_stack = e.stack;\n\n  const causes: string[] = [];\n  let cause = e.cause;\n  while (cause !== undefined && cause !== null && causes.length < MAX_CAUSE_DEPTH) {\n    if (isErrorLike(cause)) {\n      causes.push(`${errorType(cause)}: ${cause.message}`);\n      cause = (cause as { cause?: unknown }).cause;\n    } else {\n      causes.push(defaultRedactor.json(cause));\n      cause = undefined;\n    }\n  }\n  if (causes.length > 0) out.err_cause = causes.join(\" <- \");\n  return out;\n}\n\nconst logged = globalSingleton(\"logged\", () => new WeakSet<object>());\n\n// Marks an error as already written, so a later boundary (e.g. Next's onRequestError)\n// does not log it a second time.\nexport function markLogged(err: unknown): void {\n  if (typeof err === \"object\" && err !== null) logged.add(err);\n}\n\nexport function isLogged(err: unknown): boolean {\n  return typeof err === \"object\" && err !== null && logged.has(err);\n}\n"],"mappings":";AAAA,SAAS,yBAAyB;;;ACE3B,SAAS,gBAAmB,MAAc,MAAkB;AACjE,QAAM,MAAM,uBAAO,IAAI,iBAAiB,IAAI,EAAE;AAC9C,QAAM,IAAI;AACV,MAAI,QAAQ,EAAE,GAAG;AACjB,MAAI,UAAU,QAAW;AACvB,YAAQ,KAAK;AACb,MAAE,GAAG,IAAI;AAAA,EACX;AACA,SAAO;AACT;;;ADCA,IAAM,MAAM,gBAAgB,OAAO,MAAM,IAAI,kBAAgC,CAAC;AAEvE,IAAM,YAAoB,uBAAO,IAAI,qBAAqB;AAE1D,SAAS,aAAgB,QAAgB,IAAmC;AACjF,QAAM,SAAS,IAAI,SAAS;AAC5B,QAAM,QAAsB,EAAE,QAAQ,EAAE,GAAG,QAAQ,QAAQ,GAAG,OAAO,GAAG,OAAO;AAC/E,SAAO,IAAI,IAAI,OAAO,MAAM,GAAG,KAAK,CAAC;AACvC;AAEO,SAAS,YAAe,QAAgB,IAAgB;AAC7D,SAAO,aAAa,QAAQ,MAAM,GAAG,CAAC;AACxC;AAEO,SAAS,eAAyC;AACvD,SAAO,IAAI,SAAS;AACtB;AAEO,SAAS,aAAqB;AACnC,SAAO,IAAI,SAAS,GAAG,UAAU,CAAC;AACpC;AAIO,SAAS,WAAW,QAAsB;AAC/C,WAAS,IAAI,IAAI,SAAS,GAAG,GAAG,IAAI,EAAE,OAAQ,QAAO,OAAO,EAAE,QAAQ,MAAM;AAC9E;AAGO,SAAS,cAAc,OAAqB,KAAoB;AACrE,QAAM,QAAQ;AACd,WAAS,IAAI,MAAM,QAAQ,GAAG,IAAI,EAAE,OAAQ,KAAI,EAAE,UAAU,OAAW,GAAE,QAAQ;AACnF;AAGO,SAAS,YAAY,KAAoB;AAC9C,QAAM,QAAQ,IAAI,SAAS;AAC3B,MAAI,MAAO,eAAc,OAAO,GAAG;AACrC;AAEO,SAAS,YAAY,QAAgB,OAA2B;AACrE,EAAC,OAAwC,SAAS,IAAI;AACxD;AAEO,SAAS,QAAQ,QAA2C;AACjE,MAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO;AAC1D,SAAQ,OAAoD,SAAS;AACvE;;;AExDO,IAAM,sBAAsB;AAAA,EACjC;AAAA,EAAY;AAAA,EAAU;AAAA,EAAO;AAAA,EAAc;AAAA,EAAU;AAAA,EACrD;AAAA,EAAS;AAAA,EAAgB;AAAA,EAAiB;AAAA,EAAY;AAAA,EACtD;AAAA,EAAW;AAAA,EAAU;AAAA,EAAc;AAAA,EAAc;AAAA,EACjD;AAAA,EAAiB;AAAA,EAAU;AAAA,EAAc;AAAA,EAAc;AAAA,EACvD;AAAA,EAAc;AAAA,EAAe;AAAA,EAAO;AAAA,EAAqB;AAAA,EAAe;AAAA,EAAO;AACjF;AAGO,IAAM,kBAAkB;AAAA;AAAA,EAE7B,SAAS;AAAA;AAAA,EAET,aAAa;AAAA;AAAA,EAEb,MAAM;AACR;AAGA,IAAM,gBAAgB,CAAC,UAAU,SAAS,WAAW,eAAe,eAAe,QAAQ,OAAO,OAAO,UAAU;AAE5G,IAAM,WAAW;AAEjB,SAAS,YAAY,KAAqB;AAC/C,SAAO,IACJ,QAAQ,sBAAsB,OAAO,EACrC,QAAQ,yBAAyB,OAAO,EACxC,QAAQ,mBAAmB,GAAG,EAC9B,YAAY;AACjB;AAEA,IAAM,qBAAqB;AAC3B,IAAM,YAAY;AAClB,IAAM,SAAS;AACf,IAAM,WAAW;AAmBjB,SAAS,UAAU,IAAoB;AACrC,SAAO,GAAG,MAAM,SAAS,GAAG,IAAI,IAAI,OAAO,GAAG,QAAQ,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,QAAQ,GAAG,GAAG,KAAK,GAAG;AACxG;AAEO,SAAS,eAAe,OAAwB,CAAC,GAAa;AACnE,QAAM,QAAQ,CAAC,GAAG,mBAAmB;AACrC,QAAM,cAAwB,CAAC;AAC/B,aAAW,KAAK,KAAK,QAAQ,CAAC,GAAG;AAC/B,QAAI,OAAO,MAAM,SAAU,OAAM,KAAK,YAAY,CAAC,CAAC;AAAA,QAC/C,aAAY,KAAK,IAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,KAAK,EAAE,CAAC,CAAC;AAAA,EACtE;AACA,QAAM,iBAAiB,KAAK,UAAU,CAAC,GAAG,IAAI,SAAS;AAEvD,QAAM,cAAc,CAAC,QAAyB;AAC5C,UAAM,IAAI,YAAY,GAAG;AACzB,QAAI,YAAY,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,EAAG,QAAO;AACjD,QAAI,CAAC,MAAM,SAAS,CAAC,KAAK,cAAc,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAAG,QAAO;AAC3E,WAAO,MAAM,KAAK,CAAC,MAAM,MAAM,KAAK,EAAE,WAAW,GAAG,CAAC,GAAG,KAAK,EAAE,SAAS,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,IAAI,CAAC,GAAG,CAAC;AAAA,EAC1G;AAEA,QAAM,QAAQ,CAAC,MAAsB;AACnC,QAAI,MAAM,EACP,QAAQ,oBAAoB,KAAK,QAAQ,GAAG,EAC5C,QAAQ,WAAW,UAAU,QAAQ,EAAE,EACvC,QAAQ,QAAQ,gBAAgB,EAChC,QAAQ,UAAU,QAAQ;AAC7B,eAAW,MAAM,cAAe,OAAM,IAAI,QAAQ,IAAI,QAAQ;AAC9D,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,CAAC,UAA2B;AACvC,QAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAI;AACF,YAAM,OAAO,KAAK,UAAU,OAAO,CAAC,KAAK,QAAiB;AACxD,YAAI,OAAO,QAAQ,QAAQ,QAAQ,UAAa,YAAY,GAAG,EAAG,QAAO;AACzE,YAAI,OAAO,QAAQ,SAAU,QAAO,IAAI,SAAS;AACjD,YAAI,eAAe,MAAO,QAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ;AACxE,eAAO;AAAA,MACT,CAAC;AACD,aAAO,QAAQ,OAAO,KAAK;AAAA,IAC7B,QAAQ;AACN,aAAO,OAAO,KAAK;AAAA,IACrB;AAAA,EACF;AAEA,SAAO,EAAE,aAAa,OAAO,KAAK;AACpC;AAEO,IAAM,kBAA4B,eAAe;;;AC7FxD,IAAM,kBAAkB;AAEjB,SAAS,YAAY,GAAwB;AAClD,MAAI,aAAa,MAAO,QAAO;AAC/B,SACE,OAAO,MAAM,YACb,MAAM,QACN,OAAQ,EAA4B,YAAY,aAC/C,WAAW,KAAK,UAAU;AAE/B;AAEA,SAAS,UAAU,GAAkB;AACnC,MAAI,EAAE,QAAQ,EAAE,SAAS,QAAS,QAAO,EAAE;AAC3C,QAAM,OAAQ,EAA0C,aAAa;AACrE,SAAO,QAAQ,SAAS,WAAW,OAAO;AAC5C;AAEO,SAAS,eAAe,KAAyB;AACtD,MAAI,CAAC,YAAY,GAAG,GAAG;AACrB,QAAI,OAAO,QAAQ,SAAU,QAAO,EAAE,UAAU,UAAU,aAAa,IAAI;AAC3E,WAAO,EAAE,UAAU,OAAO,KAAK,aAAa,gBAAgB,KAAK,GAAG,EAAE;AAAA,EACxE;AACA,QAAM,IAAI;AACV,QAAM,MAAiB,EAAE,UAAU,UAAU,CAAC,GAAG,aAAa,OAAO,EAAE,WAAW,EAAE,EAAE;AACtF,MAAI,EAAE,SAAS,UAAa,EAAE,SAAS,KAAM,KAAI,WAAW,OAAO,EAAE,IAAI;AACzE,MAAI,OAAO,EAAE,UAAU,SAAU,KAAI,YAAY,EAAE;AAEnD,QAAM,SAAmB,CAAC;AAC1B,MAAI,QAAQ,EAAE;AACd,SAAO,UAAU,UAAa,UAAU,QAAQ,OAAO,SAAS,iBAAiB;AAC/E,QAAI,YAAY,KAAK,GAAG;AACtB,aAAO,KAAK,GAAG,UAAU,KAAK,CAAC,KAAK,MAAM,OAAO,EAAE;AACnD,cAAS,MAA8B;AAAA,IACzC,OAAO;AACL,aAAO,KAAK,gBAAgB,KAAK,KAAK,CAAC;AACvC,cAAQ;AAAA,IACV;AAAA,EACF;AACA,MAAI,OAAO,SAAS,EAAG,KAAI,YAAY,OAAO,KAAK,MAAM;AACzD,SAAO;AACT;AAEA,IAAM,SAAS,gBAAgB,UAAU,MAAM,oBAAI,QAAgB,CAAC;AAI7D,SAAS,WAAW,KAAoB;AAC7C,MAAI,OAAO,QAAQ,YAAY,QAAQ,KAAM,QAAO,IAAI,GAAG;AAC7D;AAEO,SAAS,SAAS,KAAuB;AAC9C,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,IAAI,GAAG;AAClE;","names":[]}

package/dist/chunk-UXKPPF4G.js

@@ -0,0 +1,41 @@
+import {
+  getContext,
+  markLogged,
+  withContext
+} from "./chunk-QMC6BWGK.js";
+
+// src/job.ts
+async function runJob(log, info, fn) {
+  const ctx = { ...info.fields, job_name: info.job_name };
+  if (info.job_id !== void 0) ctx.job_id = String(info.job_id);
+  if (info.job_attempt !== void 0) ctx.job_attempt = info.job_attempt;
+  if (info.request_id !== void 0) ctx.request_id = info.request_id;
+  return withContext(ctx, async () => {
+    const start = performance.now();
+    try {
+      const result = await fn();
+      log.info("job completed", { event: "job.completed", duration_ms: Math.round(performance.now() - start) });
+      return result;
+    } catch (err) {
+      const final = typeof info.final_attempt === "function" ? info.final_attempt(err) : info.final_attempt ?? true;
+      log[final ? "error" : "warn"]("job failed", {
+        event: "job.failed",
+        duration_ms: Math.round(performance.now() - start),
+        err
+      });
+      markLogged(err);
+      throw err;
+    }
+  });
+}
+function jobData(data) {
+  const requestId = getContext().request_id;
+  if (typeof requestId !== "string" || data.request_id !== void 0) return data;
+  return { ...data, request_id: requestId };
+}
+
+export {
+  runJob,
+  jobData
+};
+//# sourceMappingURL=chunk-UXKPPF4G.js.map

package/dist/chunk-UXKPPF4G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/job.ts"],"sourcesContent":["import { getContext, withContext } from \"./context\";\nimport { markLogged } from \"./error\";\nimport type { Logger } from \"./logger\";\nimport type { Fields } from \"./normalize\";\n\nexport interface JobInfo {\n  job_name: string;\n  job_id?: string | number;\n  job_attempt?: number;\n  /** No retries left after this attempt (or decided per error). Defaults to true when unknown. */\n  final_attempt?: boolean | ((err: unknown) => boolean);\n  request_id?: string;\n  fields?: Fields;\n}\n\nexport async function runJob<T>(log: Logger, info: JobInfo, fn: () => T | Promise<T>): Promise<T> {\n  const ctx: Fields = { ...info.fields, job_name: info.job_name };\n  if (info.job_id !== undefined) ctx.job_id = String(info.job_id);\n  if (info.job_attempt !== undefined) ctx.job_attempt = info.job_attempt;\n  if (info.request_id !== undefined) ctx.request_id = info.request_id;\n\n  return withContext(ctx, async () => {\n    const start = performance.now();\n    try {\n      const result = await fn();\n      log.info(\"job completed\", { event: \"job.completed\", duration_ms: Math.round(performance.now() - start) });\n      return result;\n    } catch (err) {\n      const final = typeof info.final_attempt === \"function\" ? info.final_attempt(err) : (info.final_attempt ?? true);\n      log[final ? \"error\" : \"warn\"](\"job failed\", {\n        event: \"job.failed\",\n        duration_ms: Math.round(performance.now() - start),\n        err,\n      });\n      markLogged(err);\n      throw err;\n    }\n  });\n}\n\n/** Adds the current request_id to a job payload, so the job's logs link back to the request. */\nexport function jobData<T extends Record<string, unknown>>(data: T): T & { request_id?: string } {\n  const requestId = getContext().request_id;\n  if (typeof requestId !== \"string\" || data.request_id !== undefined) return data;\n  return { ...data, request_id: requestId };\n}\n"],"mappings":";;;;;;;AAeA,eAAsB,OAAU,KAAa,MAAe,IAAsC;AAChG,QAAM,MAAc,EAAE,GAAG,KAAK,QAAQ,UAAU,KAAK,SAAS;AAC9D,MAAI,KAAK,WAAW,OAAW,KAAI,SAAS,OAAO,KAAK,MAAM;AAC9D,MAAI,KAAK,gBAAgB,OAAW,KAAI,cAAc,KAAK;AAC3D,MAAI,KAAK,eAAe,OAAW,KAAI,aAAa,KAAK;AAEzD,SAAO,YAAY,KAAK,YAAY;AAClC,UAAM,QAAQ,YAAY,IAAI;AAC9B,QAAI;AACF,YAAM,SAAS,MAAM,GAAG;AACxB,UAAI,KAAK,iBAAiB,EAAE,OAAO,iBAAiB,aAAa,KAAK,MAAM,YAAY,IAAI,IAAI,KAAK,EAAE,CAAC;AACxG,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,YAAM,QAAQ,OAAO,KAAK,kBAAkB,aAAa,KAAK,cAAc,GAAG,IAAK,KAAK,iBAAiB;AAC1G,UAAI,QAAQ,UAAU,MAAM,EAAE,cAAc;AAAA,QAC1C,OAAO;AAAA,QACP,aAAa,KAAK,MAAM,YAAY,IAAI,IAAI,KAAK;AAAA,QACjD;AAAA,MACF,CAAC;AACD,iBAAW,GAAG;AACd,YAAM;AAAA,IACR;AAAA,EACF,CAAC;AACH;AAGO,SAAS,QAA2C,MAAsC;AAC/F,QAAM,YAAY,WAAW,EAAE;AAC/B,MAAI,OAAO,cAAc,YAAY,KAAK,eAAe,OAAW,QAAO;AAC3E,SAAO,EAAE,GAAG,MAAM,YAAY,UAAU;AAC1C;","names":[]}

package/dist/express.cjs

@@ -0,0 +1,316 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/express.ts
+var express_exports = {};
+__export(express_exports, {
+  errorRecorder: () => errorRecorder,
+  requestLogger: () => requestLogger
+});
+module.exports = __toCommonJS(express_exports);
+
+// src/context.ts
+var import_node_async_hooks = require("async_hooks");
+
+// src/global.ts
+function globalSingleton(name, make) {
+  const key = /* @__PURE__ */ Symbol.for(`@tanngo11/log.${name}`);
+  const g = globalThis;
+  let value = g[key];
+  if (value === void 0) {
+    value = make();
+    g[key] = value;
+  }
+  return value;
+}
+
+// src/context.ts
+var als = globalSingleton("als", () => new import_node_async_hooks.AsyncLocalStorage());
+var STORE_KEY = /* @__PURE__ */ Symbol.for("@tanngo11/log.store");
+function runWithStore(fields, fn) {
+  const parent = als.getStore();
+  const store = { fields: { ...parent?.fields, ...fields }, parent };
+  return als.run(store, () => fn(store));
+}
+function recordErrorIn(store, err) {
+  store.error = err;
+  for (let s = store.parent; s; s = s.parent) if (s.error === void 0) s.error = err;
+}
+function attachStore(target, store) {
+  target[STORE_KEY] = store;
+}
+function storeOf(target) {
+  if (typeof target !== "object" || target === null) return void 0;
+  return target[STORE_KEY];
+}
+
+// src/redact.ts
+var DEFAULT_REDACT_KEYS = [
+  "password",
+  "passwd",
+  "pwd",
+  "passphrase",
+  "secret",
+  "client_secret",
+  "token",
+  "access_token",
+  "refresh_token",
+  "id_token",
+  "auth_token",
+  "api_key",
+  "apikey",
+  "access_key",
+  "secret_key",
+  "private_key",
+  "authorization",
+  "cookie",
+  "set_cookie",
+  "session_id",
+  "sessionid",
+  "credential",
+  "credentials",
+  "dsn",
+  "connection_string",
+  "conn_string",
+  "jwt",
+  "bearer"
+];
+var SAFE_SUFFIXES = ["_count", "_type", "_length", "_expires_at", "_expires_in", "_ttl", "_at", "_ms", "_enabled"];
+var REDACTED = "[REDACTED]";
+function toSnakeCase(key) {
+  return key.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/[^A-Za-z0-9_]+/g, "_").toLowerCase();
+}
+var URL_CREDENTIALS_RE = /([a-z][a-z0-9+.-]*:\/\/)[^\s/@:"']+:[^\s/@"']+@/gi;
+var BEARER_RE = /\bBearer\s+[A-Za-z0-9._~+/=-]+/gi;
+var JWT_RE = /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g;
+var EMAIL_RE = /[A-Za-z0-9._%+-]+@([A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,})/g;
+function globalize(re) {
+  return re.flags.includes("g") ? new RegExp(re.source, re.flags) : new RegExp(re.source, `${re.flags}g`);
+}
+function createRedactor(opts = {}) {
+  const words = [...DEFAULT_REDACT_KEYS];
+  const keyPatterns = [];
+  for (const k of opts.keys ?? []) {
+    if (typeof k === "string") words.push(toSnakeCase(k));
+    else keyPatterns.push(new RegExp(k.source, k.flags.replace("g", "")));
+  }
+  const valuePatterns = (opts.values ?? []).map(globalize);
+  const isSensitive = (key) => {
+    const k = toSnakeCase(key);
+    if (keyPatterns.some((re) => re.test(k))) return true;
+    if (!words.includes(k) && SAFE_SUFFIXES.some((s) => k.endsWith(s))) return false;
+    return words.some((w) => k === w || k.startsWith(`${w}_`) || k.endsWith(`_${w}`) || k.includes(`_${w}_`));
+  };
+  const scrub = (s) => {
+    let out = s.replace(URL_CREDENTIALS_RE, `$1${REDACTED}@`).replace(BEARER_RE, `Bearer ${REDACTED}`).replace(JWT_RE, "[REDACTED_JWT]").replace(EMAIL_RE, "***@$1");
+    for (const re of valuePatterns) out = out.replace(re, REDACTED);
+    return out;
+  };
+  const json = (value) => {
+    if (typeof value === "string") return value;
+    try {
+      const text = JSON.stringify(value, (key, val) => {
+        if (key && val !== null && val !== void 0 && isSensitive(key)) return REDACTED;
+        if (typeof val === "bigint") return val.toString();
+        if (val instanceof Error) return { name: val.name, message: val.message };
+        return val;
+      });
+      return text ?? String(value);
+    } catch {
+      return String(value);
+    }
+  };
+  return { isSensitive, scrub, json };
+}
+var defaultRedactor = createRedactor();
+
+// src/error.ts
+var MAX_CAUSE_DEPTH = 5;
+function isErrorLike(v) {
+  if (v instanceof Error) return true;
+  return typeof v === "object" && v !== null && typeof v.message === "string" && ("stack" in v || "name" in v);
+}
+function errorType(e) {
+  if (e.name && e.name !== "Error") return e.name;
+  const ctor = e.constructor?.name;
+  return ctor && ctor !== "Object" ? ctor : "Error";
+}
+function serializeError(err) {
+  if (!isErrorLike(err)) {
+    if (typeof err === "string") return { err_type: "string", err_message: err };
+    return { err_type: typeof err, err_message: defaultRedactor.json(err) };
+  }
+  const e = err;
+  const out = { err_type: errorType(e), err_message: String(e.message ?? "") };
+  if (e.code !== void 0 && e.code !== null) out.err_code = String(e.code);
+  if (typeof e.stack === "string") out.err_stack = e.stack;
+  const causes = [];
+  let cause = e.cause;
+  while (cause !== void 0 && cause !== null && causes.length < MAX_CAUSE_DEPTH) {
+    if (isErrorLike(cause)) {
+      causes.push(`${errorType(cause)}: ${cause.message}`);
+      cause = cause.cause;
+    } else {
+      causes.push(defaultRedactor.json(cause));
+      cause = void 0;
+    }
+  }
+  if (causes.length > 0) out.err_cause = causes.join(" <- ");
+  return out;
+}
+var logged = globalSingleton("logged", () => /* @__PURE__ */ new WeakSet());
+function markLogged(err) {
+  if (typeof err === "object" && err !== null) logged.add(err);
+}
+
+// src/normalize.ts
+function stripUrl(url) {
+  const noQuery = url.split(/[?#]/, 1)[0] ?? "";
+  return noQuery.replace(/^([a-z][a-z0-9+.-]*:\/\/)[^/@\s]*@/i, "$1");
+}
+
+// src/request-id.ts
+var REQUEST_ID_RE = /^[A-Za-z0-9._-]{1,64}$/;
+var TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+function newRequestId() {
+  return globalThis.crypto.randomUUID();
+}
+function first(header2) {
+  return Array.isArray(header2) ? header2[0] : header2 ?? void 0;
+}
+function resolveRequestId(header2) {
+  const value = first(header2);
+  return value && REQUEST_ID_RE.test(value) ? value : newRequestId();
+}
+function parseTraceparent(header2) {
+  const value = first(header2)?.trim().toLowerCase();
+  const m = value ? TRACEPARENT_RE.exec(value) : null;
+  if (!m) return void 0;
+  const [, version, traceId, spanId] = m;
+  if (version === "ff" || /^0+$/.test(traceId) || /^0+$/.test(spanId)) return void 0;
+  return { trace_id: traceId, span_id: spanId };
+}
+
+// src/http.ts
+function header(headers, name) {
+  if (typeof headers.get === "function") return headers.get(name) ?? void 0;
+  return headers[name];
+}
+function requestContextFields(headers) {
+  const out = {
+    request_id: resolveRequestId(header(headers, "x-request-id"))
+  };
+  const tp = parseTraceparent(header(headers, "traceparent"));
+  if (tp) Object.assign(out, tp);
+  return out;
+}
+var DEFAULT_SKIP_PATHS = [
+  /^\/(health|healthz|ready|readyz|livez)\/?$/,
+  "/favicon.ico",
+  /^\/_next\/static\//
+];
+function shouldSkip(method, path, skipPaths = DEFAULT_SKIP_PATHS) {
+  if (method.toUpperCase() === "OPTIONS") return true;
+  const p = stripUrl(path);
+  return skipPaths.some((s) => typeof s === "string" ? p === s : s.test(p));
+}
+function logHttpRequest(log, info, opts = {}) {
+  if (shouldSkip(info.method, info.path, opts.skipPaths)) return;
+  const level = info.status >= 500 ? "error" : info.status >= 400 ? "warn" : "info";
+  const path = stripUrl(info.path);
+  const errFields = {};
+  if (info.err !== void 0 && info.err !== null) {
+    Object.assign(errFields, serializeError(info.err));
+    if (info.status < 500) delete errFields.err_stack;
+    markLogged(info.err);
+  }
+  const message = info.route ? `${info.method} ${info.route} ${info.status}` : `${info.method} ${info.status}`;
+  log[level](message, {
+    ...info.fields,
+    event: "http.request",
+    http_method: info.method,
+    http_route: info.route,
+    http_path: path,
+    http_status: info.status,
+    duration_ms: info.duration_ms === void 0 ? void 0 : Math.round(info.duration_ms),
+    ...errFields
+  });
+}
+
+// src/express.ts
+function joinRoute(baseUrl, path) {
+  return `${baseUrl ?? ""}${String(path)}` || "/";
+}
+function captureRoute(req, store) {
+  let value;
+  Object.defineProperty(req, "route", {
+    configurable: true,
+    enumerable: true,
+    get: () => value,
+    set: (route) => {
+      value = route;
+      if (route?.path !== void 0) store.route = joinRoute(req.baseUrl, route.path);
+    }
+  });
+}
+function requestLogger(log, opts = {}) {
+  return (req, res, next) => {
+    const ctx = requestContextFields(req.headers);
+    res.setHeader("x-request-id", ctx.request_id);
+    const start = performance.now();
+    runWithStore(ctx, (store) => {
+      attachStore(res, store);
+      captureRoute(req, store);
+      let done = false;
+      const finish = () => {
+        if (done) return;
+        done = true;
+        logHttpRequest(
+          log,
+          {
+            method: req.method,
+            route: store.route,
+            path: req.originalUrl,
+            status: res.writableFinished || res.headersSent ? res.statusCode : 499,
+            duration_ms: performance.now() - start,
+            err: store.error,
+            fields: store.fields
+          },
+          opts
+        );
+      };
+      res.once("finish", finish);
+      res.once("close", finish);
+      next();
+    });
+  };
+}
+function errorRecorder() {
+  return (err, _req, res, next) => {
+    const store = storeOf(res);
+    if (store) recordErrorIn(store, err);
+    next(err);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  errorRecorder,
+  requestLogger
+});
+//# sourceMappingURL=express.cjs.map