@nexpress/core 0.1.0

package/dist/chunk-CTSQ7BRI.js

@@ -0,0 +1,175 @@
+import {
+  NpNotFoundError,
+  NpValidationError
+} from "./chunk-ZCINJSS4.js";
+import {
+  getDb
+} from "./chunk-XANPEOJC.js";
+import {
+  npMembers
+} from "./chunk-M43PGOQY.js";
+
+// src/community/notification-prefs.ts
+import { eq } from "drizzle-orm";
+var builtinKinds = [
+  {
+    kind: "comment.reply",
+    label: "Replies",
+    description: "Someone replied to one of your comments."
+  },
+  {
+    kind: "comment.mention",
+    label: "Mentions in comments",
+    description: "Someone @-mentioned you in a comment."
+  },
+  {
+    kind: "document.mention",
+    label: "Mentions in discussions",
+    description: "Someone @-mentioned you in a discussion / thread."
+  },
+  {
+    kind: "reaction.received",
+    label: "Reactions",
+    description: "Someone reacted to your comment or document."
+  },
+  {
+    kind: "follow.received",
+    label: "New followers",
+    description: "Someone started following you."
+  }
+];
+var dynamicKinds = [];
+function registerNotificationKind(meta) {
+  if (builtinKinds.some((k) => k.kind === meta.kind)) return;
+  const idx = dynamicKinds.findIndex((k) => k.kind === meta.kind);
+  if (idx >= 0) {
+    dynamicKinds[idx] = meta;
+  } else {
+    dynamicKinds.push(meta);
+  }
+}
+function listNotificationKinds() {
+  return [...builtinKinds, ...dynamicKinds];
+}
+var DIGEST_CADENCES = ["off", "daily", "weekly"];
+var EMPTY_PREFS = {
+  disabled: [],
+  digest: "off",
+  lastDigestAt: null,
+  lastDigestAtBySite: {}
+};
+function normalizeDigest(raw) {
+  return DIGEST_CADENCES.includes(raw) ? raw : "off";
+}
+function normalizeLastDigestAt(raw) {
+  return typeof raw === "string" && raw.length > 0 ? raw : null;
+}
+function normalizeLastDigestBySite(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
+  const out = {};
+  for (const [siteId, value] of Object.entries(raw)) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) continue;
+    const inner = {};
+    for (const [cadence, ts] of Object.entries(value)) {
+      if (!DIGEST_CADENCES.includes(cadence)) continue;
+      if (typeof ts === "string" && ts.length > 0) {
+        inner[cadence] = ts;
+      }
+    }
+    if (Object.keys(inner).length > 0) out[siteId] = inner;
+  }
+  return out;
+}
+function normalizePrefs(raw) {
+  if (!raw || typeof raw !== "object") return { ...EMPTY_PREFS, lastDigestAtBySite: {} };
+  const obj = raw;
+  const disabled = Array.isArray(obj.disabled) ? obj.disabled.filter((k) => typeof k === "string") : [];
+  return {
+    disabled,
+    digest: normalizeDigest(obj.digest),
+    lastDigestAt: normalizeLastDigestAt(obj.lastDigestAt),
+    lastDigestAtBySite: normalizeLastDigestBySite(obj.lastDigestAtBySite)
+  };
+}
+async function getMemberNotificationPrefs(memberId) {
+  const db = getDb();
+  const [row] = await db.select({ prefs: npMembers.notificationPrefs }).from(npMembers).where(eq(npMembers.id, memberId)).limit(1);
+  if (!row) throw new NpNotFoundError("member", memberId);
+  return normalizePrefs(row.prefs);
+}
+async function setMemberNotificationPrefs(input) {
+  const known = new Set(listNotificationKinds().map((k) => k.kind));
+  let cleanedDisabled;
+  if (input.disabled !== void 0) {
+    cleanedDisabled = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const raw of input.disabled) {
+      if (typeof raw !== "string") {
+        throw new NpValidationError("Invalid input", [
+          { field: "disabled", message: "Each entry must be a string" }
+        ]);
+      }
+      if (!known.has(raw)) {
+        throw new NpValidationError("Invalid input", [
+          { field: "disabled", message: `Unknown notification kind: ${raw}` }
+        ]);
+      }
+      if (seen.has(raw)) continue;
+      seen.add(raw);
+      cleanedDisabled.push(raw);
+    }
+  }
+  if (input.digest !== void 0 && !DIGEST_CADENCES.includes(input.digest)) {
+    throw new NpValidationError("Invalid input", [
+      {
+        field: "digest",
+        message: `digest must be one of: ${DIGEST_CADENCES.join(", ")}`
+      }
+    ]);
+  }
+  const db = getDb();
+  const [existing] = await db.select({ prefs: npMembers.notificationPrefs }).from(npMembers).where(eq(npMembers.id, input.memberId)).limit(1);
+  if (!existing) throw new NpNotFoundError("member", input.memberId);
+  const merged = { ...existing.prefs ?? {} };
+  if (cleanedDisabled !== void 0) merged.disabled = cleanedDisabled;
+  if (input.digest !== void 0) merged.digest = input.digest;
+  await db.update(npMembers).set({ notificationPrefs: merged, updatedAt: /* @__PURE__ */ new Date() }).where(eq(npMembers.id, input.memberId));
+  return normalizePrefs(merged);
+}
+async function recordDigestSent(memberId, sentAt, scope) {
+  const db = getDb();
+  const [existing] = await db.select({ prefs: npMembers.notificationPrefs }).from(npMembers).where(eq(npMembers.id, memberId)).limit(1);
+  if (!existing) return;
+  const prior = existing.prefs ?? {};
+  const merged = {
+    ...prior,
+    lastDigestAt: sentAt.toISOString()
+  };
+  if (scope) {
+    const priorBySite = normalizeLastDigestBySite(
+      prior.lastDigestAtBySite
+    );
+    const siteSlot = { ...priorBySite[scope.siteId] ?? {} };
+    siteSlot[scope.cadence] = sentAt.toISOString();
+    merged.lastDigestAtBySite = { ...priorBySite, [scope.siteId]: siteSlot };
+  }
+  await db.update(npMembers).set({ notificationPrefs: merged, updatedAt: /* @__PURE__ */ new Date() }).where(eq(npMembers.id, memberId));
+}
+async function isNotificationKindEnabled(memberId, kind) {
+  try {
+    const prefs = await getMemberNotificationPrefs(memberId);
+    return !prefs.disabled.includes(kind);
+  } catch {
+    return true;
+  }
+}
+
+export {
+  registerNotificationKind,
+  listNotificationKinds,
+  getMemberNotificationPrefs,
+  setMemberNotificationPrefs,
+  recordDigestSent,
+  isNotificationKindEnabled
+};
+//# sourceMappingURL=chunk-CTSQ7BRI.js.map

package/dist/chunk-CTSQ7BRI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/community/notification-prefs.ts"],"sourcesContent":["import { eq } from \"drizzle-orm\";\nimport type { NodePgDatabase } from \"drizzle-orm/node-postgres\";\n\nimport { getDb } from \"../db/runtime.js\";\nimport { npMembers } from \"../db/schema/community.js\";\nimport { NpNotFoundError, NpValidationError } from \"../errors.js\";\n\n/**\n * Phase 16.3 — per-member notification preferences.\n *\n * The persisted shape is a JSONB blob on `np_members.notification_prefs`\n * so adding fields (digest cadence in 16.4, channel toggles later)\n * stays a typescript-only change. Today we honor:\n *\n *   - `disabled: string[]` — kinds the member opted out of. The\n *     `createNotification` gate consults this and silently drops\n *     the row. Default empty (= every kind enabled).\n *\n * The vocabulary of `kinds` is defined here so the UI has a single\n * source of truth — settings page renders a toggle for each entry,\n * and the API only accepts kinds that appear in the list (so a\n * forged client can't disable arbitrary strings to bloat the JSONB).\n */\n\nexport interface NpNotificationKindMeta {\n  kind: string;\n  /** Short human label. */\n  label: string;\n  /** Description rendered next to the toggle. */\n  description: string;\n}\n\n/**\n * Closed vocabulary of toggle-able kinds. New notification kinds\n * land here when they ship; plugins that want their own\n * preferences register entries via `registerNotificationKind`.\n */\nconst builtinKinds: NpNotificationKindMeta[] = [\n  {\n    kind: \"comment.reply\",\n    label: \"Replies\",\n    description: \"Someone replied to one of your comments.\",\n  },\n  {\n    kind: \"comment.mention\",\n    label: \"Mentions in comments\",\n    description: \"Someone @-mentioned you in a comment.\",\n  },\n  {\n    kind: \"document.mention\",\n    label: \"Mentions in discussions\",\n    description: \"Someone @-mentioned you in a discussion / thread.\",\n  },\n  {\n    kind: \"reaction.received\",\n    label: \"Reactions\",\n    description: \"Someone reacted to your comment or document.\",\n  },\n  {\n    kind: \"follow.received\",\n    label: \"New followers\",\n    description: \"Someone started following you.\",\n  },\n];\n\nconst dynamicKinds: NpNotificationKindMeta[] = [];\n\n/** Plugin-extensible registration. Idempotent on `kind`. */\nexport function registerNotificationKind(meta: NpNotificationKindMeta): void {\n  if (builtinKinds.some((k) => k.kind === meta.kind)) return;\n  const idx = dynamicKinds.findIndex((k) => k.kind === meta.kind);\n  if (idx >= 0) {\n    dynamicKinds[idx] = meta;\n  } else {\n    dynamicKinds.push(meta);\n  }\n}\n\n/** Returns the union of builtin + plugin-registered kinds. */\nexport function listNotificationKinds(): NpNotificationKindMeta[] {\n  return [...builtinKinds, ...dynamicKinds];\n}\n\nexport type NpDigestCadence = \"off\" | \"daily\" | \"weekly\";\n\nconst DIGEST_CADENCES: readonly NpDigestCadence[] = [\"off\", \"daily\", \"weekly\"] as const;\n\nexport interface NpNotificationPrefs {\n  /** Kinds the member opted out of. Empty / missing = all kinds enabled. */\n  disabled: string[];\n  /**\n   * Phase 16.4 — email digest cadence. `off` (default) disables\n   * the digest. `daily` and `weekly` opt the member into a\n   * batched email of unread notifications, scheduled by the\n   * `notifications:sendDigest` recurring job.\n   */\n  digest: NpDigestCadence;\n  /**\n   * Set when the digest sweep last sent an email to this member.\n   * Used to scope each digest to \"unread since the last send\" so\n   * members aren't repeatedly emailed about the same row. Stored\n   * as ISO-8601 string in the JSONB blob; `null` for accounts\n   * that have never received a digest.\n   *\n   * Issue #218 — superseded by `lastDigestAtBySite` once a member\n   * receives a digest under the per-site fan-out path. The legacy\n   * field is preserved for forward-compat reads (single-site\n   * deploys still see + write it via the fallback chain) and as\n   * a \"any digest, ever?\" marker for analytics.\n   */\n  lastDigestAt: string | null;\n  /**\n   * Issue #218 — per-(site, cadence) timestamp map. Replaces the\n   * single `lastDigestAt` for multi-site deployments. Empty when\n   * the member has never received a digest under the site-scoped\n   * sweep.\n   */\n  lastDigestAtBySite: Record<string, Partial<Record<NpDigestCadence, string>>>;\n}\n\nconst EMPTY_PREFS: NpNotificationPrefs = {\n  disabled: [],\n  digest: \"off\",\n  lastDigestAt: null,\n  lastDigestAtBySite: {},\n};\n\nfunction normalizeDigest(raw: unknown): NpDigestCadence {\n  return DIGEST_CADENCES.includes(raw as NpDigestCadence) ? (raw as NpDigestCadence) : \"off\";\n}\n\nfunction normalizeLastDigestAt(raw: unknown): string | null {\n  return typeof raw === \"string\" && raw.length > 0 ? raw : null;\n}\n\nfunction normalizeLastDigestBySite(\n  raw: unknown,\n): Record<string, Partial<Record<NpDigestCadence, string>>> {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return {};\n  const out: Record<string, Partial<Record<NpDigestCadence, string>>> = {};\n  for (const [siteId, value] of Object.entries(raw as Record<string, unknown>)) {\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) continue;\n    const inner: Partial<Record<NpDigestCadence, string>> = {};\n    for (const [cadence, ts] of Object.entries(value as Record<string, unknown>)) {\n      if (!DIGEST_CADENCES.includes(cadence as NpDigestCadence)) continue;\n      if (typeof ts === \"string\" && ts.length > 0) {\n        inner[cadence as NpDigestCadence] = ts;\n      }\n    }\n    if (Object.keys(inner).length > 0) out[siteId] = inner;\n  }\n  return out;\n}\n\nfunction normalizePrefs(raw: unknown): NpNotificationPrefs {\n  if (!raw || typeof raw !== \"object\") return { ...EMPTY_PREFS, lastDigestAtBySite: {} };\n  const obj = raw as Record<string, unknown>;\n  const disabled = Array.isArray(obj.disabled)\n    ? obj.disabled.filter((k): k is string => typeof k === \"string\")\n    : [];\n  return {\n    disabled,\n    digest: normalizeDigest(obj.digest),\n    lastDigestAt: normalizeLastDigestAt(obj.lastDigestAt),\n    lastDigestAtBySite: normalizeLastDigestBySite(obj.lastDigestAtBySite),\n  };\n}\n\nexport async function getMemberNotificationPrefs(memberId: string): Promise<NpNotificationPrefs> {\n  const db = getDb() as unknown as NodePgDatabase<Record<string, unknown>>;\n  const [row] = (await db\n    .select({ prefs: npMembers.notificationPrefs })\n    .from(npMembers)\n    .where(eq(npMembers.id, memberId))\n    .limit(1)) as Array<{ prefs: Record<string, unknown> }>;\n  if (!row) throw new NpNotFoundError(\"member\", memberId);\n  return normalizePrefs(row.prefs);\n}\n\nexport interface SetMemberNotificationPrefsInput {\n  memberId: string;\n  /**\n   * Replacement deny-list. Only kinds listed in\n   * `listNotificationKinds()` are accepted; unknown strings\n   * raise NpValidationError so a forged client can't bloat the\n   * JSONB or hide future framework kinds via a stale list.\n   * Optional — when omitted the existing list is preserved.\n   */\n  disabled?: string[];\n  /**\n   * Phase 16.4 — email digest cadence. Optional; when omitted\n   * the existing setting is preserved. `off` clears the\n   * member's enrollment.\n   */\n  digest?: NpDigestCadence;\n}\n\nexport async function setMemberNotificationPrefs(\n  input: SetMemberNotificationPrefsInput,\n): Promise<NpNotificationPrefs> {\n  const known = new Set(listNotificationKinds().map((k) => k.kind));\n  let cleanedDisabled: string[] | undefined;\n  if (input.disabled !== undefined) {\n    cleanedDisabled = [];\n    const seen = new Set<string>();\n    for (const raw of input.disabled) {\n      if (typeof raw !== \"string\") {\n        throw new NpValidationError(\"Invalid input\", [\n          { field: \"disabled\", message: \"Each entry must be a string\" },\n        ]);\n      }\n      if (!known.has(raw)) {\n        throw new NpValidationError(\"Invalid input\", [\n          { field: \"disabled\", message: `Unknown notification kind: ${raw}` },\n        ]);\n      }\n      if (seen.has(raw)) continue;\n      seen.add(raw);\n      cleanedDisabled.push(raw);\n    }\n  }\n  if (input.digest !== undefined && !DIGEST_CADENCES.includes(input.digest)) {\n    throw new NpValidationError(\"Invalid input\", [\n      {\n        field: \"digest\",\n        message: `digest must be one of: ${DIGEST_CADENCES.join(\", \")}`,\n      },\n    ]);\n  }\n  const db = getDb() as unknown as NodePgDatabase<Record<string, unknown>>;\n\n  // Read-then-merge so we don't clobber other JSONB keys\n  // (lastDigestAt, future channel toggles, etc.).\n  const [existing] = (await db\n    .select({ prefs: npMembers.notificationPrefs })\n    .from(npMembers)\n    .where(eq(npMembers.id, input.memberId))\n    .limit(1)) as Array<{ prefs: Record<string, unknown> }>;\n  if (!existing) throw new NpNotFoundError(\"member\", input.memberId);\n\n  const merged: Record<string, unknown> = { ...(existing.prefs ?? {}) };\n  if (cleanedDisabled !== undefined) merged.disabled = cleanedDisabled;\n  if (input.digest !== undefined) merged.digest = input.digest;\n\n  await db\n    .update(npMembers)\n    .set({ notificationPrefs: merged, updatedAt: new Date() })\n    .where(eq(npMembers.id, input.memberId));\n\n  return normalizePrefs(merged);\n}\n\n/**\n * Phase 16.4 — bookkeeping helper called by the digest sweep\n * after a successful email send. Stamps `lastDigestAt` so the\n * next run scopes its query to the correct window. Read-merge\n * to preserve other JSONB keys.\n *\n * Issue #218 — when a `siteId` + `cadence` pair is supplied,\n * the per-site / per-cadence map is updated so the next sweep\n * for that tenant scopes to the correct \"since\" window. The\n * legacy single `lastDigestAt` field is also stamped for\n * forward-compat with single-site deploys (and as a \"received\n * any digest, ever?\" marker for analytics).\n */\nexport async function recordDigestSent(\n  memberId: string,\n  sentAt: Date,\n  scope?: { siteId: string; cadence: NpDigestCadence },\n): Promise<void> {\n  const db = getDb() as unknown as NodePgDatabase<Record<string, unknown>>;\n  const [existing] = (await db\n    .select({ prefs: npMembers.notificationPrefs })\n    .from(npMembers)\n    .where(eq(npMembers.id, memberId))\n    .limit(1)) as Array<{ prefs: Record<string, unknown> }>;\n  if (!existing) return;\n  const prior = existing.prefs ?? {};\n  const merged: Record<string, unknown> = {\n    ...prior,\n    lastDigestAt: sentAt.toISOString(),\n  };\n  if (scope) {\n    const priorBySite = normalizeLastDigestBySite(\n      (prior as { lastDigestAtBySite?: unknown }).lastDigestAtBySite,\n    );\n    const siteSlot = { ...(priorBySite[scope.siteId] ?? {}) };\n    siteSlot[scope.cadence] = sentAt.toISOString();\n    merged.lastDigestAtBySite = { ...priorBySite, [scope.siteId]: siteSlot };\n  }\n  await db\n    .update(npMembers)\n    .set({ notificationPrefs: merged, updatedAt: new Date() })\n    .where(eq(npMembers.id, memberId));\n}\n\n/**\n * Inbox-side gate consulted by `createNotification`. Returns\n * `false` when the recipient explicitly opted out of `kind`.\n * Errors fail-open (return `true`) so a transient DB blip\n * doesn't silently swallow notifications.\n */\nexport async function isNotificationKindEnabled(memberId: string, kind: string): Promise<boolean> {\n  try {\n    const prefs = await getMemberNotificationPrefs(memberId);\n    return !prefs.disabled.includes(kind);\n  } catch {\n    return true;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-DK2JBJH7.js

@@ -0,0 +1,81 @@
+import {
+  readEnvPositiveInt
+} from "./chunk-OROPGO65.js";
+import {
+  getLogger
+} from "./chunk-JJL74ZPK.js";
+import {
+  getDb
+} from "./chunk-XANPEOJC.js";
+import {
+  npJobLogs
+} from "./chunk-M43PGOQY.js";
+
+// src/jobs/job-log.ts
+import { AsyncLocalStorage } from "async_hooks";
+import { and, asc, eq, gte, lt } from "drizzle-orm";
+var jobLogStorage = new AsyncLocalStorage();
+function runInJobContext(jobId, fn) {
+  return jobLogStorage.run({ jobId }, fn);
+}
+function getCurrentJobId() {
+  const store = jobLogStorage.getStore();
+  return store?.jobId ?? null;
+}
+async function recordJobLog(level, message, context) {
+  const jobId = getCurrentJobId();
+  if (!jobId) return;
+  try {
+    const db = getDb();
+    await db.insert(npJobLogs).values({
+      jobId,
+      level,
+      message,
+      context: context ?? null
+    });
+  } catch (err) {
+    getLogger().warn("recordJobLog failed", {
+      jobId,
+      level,
+      message,
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
+}
+async function listJobLogs(jobId, options = {}) {
+  const limit = Math.min(Math.max(1, options.limit ?? 200), 1e3);
+  const offset = Math.max(0, options.offset ?? 0);
+  const db = getDb();
+  const rows = await db.select().from(npJobLogs).where(eq(npJobLogs.jobId, jobId)).orderBy(asc(npJobLogs.createdAt)).limit(limit).offset(offset);
+  return rows.map((row) => ({
+    id: row.id,
+    jobId: row.jobId,
+    level: row.level,
+    message: row.message,
+    context: row.context,
+    createdAt: row.createdAt
+  }));
+}
+var DEFAULT_JOB_LOG_RETENTION_MS = readEnvPositiveInt("NP_JOB_LOG_RETENTION_DAYS", 14) * 24 * 60 * 60 * 1e3;
+async function pruneJobLogsOlderThan(cutoff) {
+  const db = getDb();
+  const deleted = await db.delete(npJobLogs).where(lt(npJobLogs.createdAt, cutoff)).returning({ id: npJobLogs.id });
+  return deleted.length;
+}
+async function countJobLogs(jobId, sinceCreatedAt) {
+  const db = getDb();
+  const where = sinceCreatedAt ? and(eq(npJobLogs.jobId, jobId), gte(npJobLogs.createdAt, sinceCreatedAt)) : eq(npJobLogs.jobId, jobId);
+  const rows = await db.select({ id: npJobLogs.id }).from(npJobLogs).where(where);
+  return rows.length;
+}
+
+export {
+  runInJobContext,
+  getCurrentJobId,
+  recordJobLog,
+  listJobLogs,
+  DEFAULT_JOB_LOG_RETENTION_MS,
+  pruneJobLogsOlderThan,
+  countJobLogs
+};
+//# sourceMappingURL=chunk-DK2JBJH7.js.map

package/dist/chunk-DK2JBJH7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jobs/job-log.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport { and, asc, eq, gte, lt } from \"drizzle-orm\";\nimport type { NodePgDatabase } from \"drizzle-orm/node-postgres\";\n\nimport { getDb } from \"../db/runtime.js\";\nimport { readEnvPositiveInt } from \"../config/env.js\";\nimport { npJobLogs } from \"../db/schema/system.js\";\nimport { type NpLogLevel, getLogger } from \"../observability/logger.js\";\n\n/**\n * Phase 20.3 — per-job log capture.\n *\n * Each handler invocation runs inside an AsyncLocalStorage context\n * keyed on the pg-boss job id. While inside the context,\n * `recordJobLog()` writes to `np_job_logs` stamped with that id;\n * outside the context it no-ops, so the helper is safe to import\n * from non-handler code (and from plugins that don't know whether\n * they're inside a handler).\n *\n * The framework's pg-boss adapter sets the context automatically\n * (see `pg-boss-adapter.ts` — every `boss.work()` callback is\n * wrapped in `runInJobContext`). Handlers don't have to do\n * anything to opt in — calls to `recordJobLog()` just work.\n */\n\ninterface JobLogContext {\n  jobId: string;\n}\n\nconst jobLogStorage = new AsyncLocalStorage<JobLogContext>();\n\nexport function runInJobContext<T>(jobId: string, fn: () => Promise<T> | T): Promise<T> | T {\n  return jobLogStorage.run({ jobId }, fn);\n}\n\nexport function getCurrentJobId(): string | null {\n  const store = jobLogStorage.getStore();\n  return store?.jobId ?? null;\n}\n\n/**\n * Record one log entry for the currently-running job. Async because\n * it writes to Postgres; callers can `void` the promise if they\n * don't need to wait. No-ops outside a job context (returns\n * immediately without touching the DB).\n *\n * Errors writing to the log table are swallowed via the framework\n * logger at `warn` — a logging failure must never cascade into a\n * job failure or shutdown loop.\n */\nexport async function recordJobLog(\n  level: NpLogLevel,\n  message: string,\n  context?: Record<string, unknown>,\n): Promise<void> {\n  const jobId = getCurrentJobId();\n  if (!jobId) return;\n\n  try {\n    const db = getDb();\n    await db.insert(npJobLogs).values({\n      jobId,\n      level,\n      message,\n      context: context ?? null,\n    });\n  } catch (err) {\n    // Don't throw from a logging path — just surface to whatever\n    // sink the framework logger is wired to.\n    getLogger().warn(\"recordJobLog failed\", {\n      jobId,\n      level,\n      message,\n      error: err instanceof Error ? err.message : String(err),\n    });\n  }\n}\n\nexport interface NpJobLogEntry {\n  id: string;\n  jobId: string;\n  level: NpLogLevel;\n  message: string;\n  context: Record<string, unknown> | null;\n  createdAt: Date;\n}\n\nexport interface ListJobLogsOptions {\n  /** Cap on rows returned. Default 200, max 1000 to keep the admin UI snappy. */\n  limit?: number;\n  /** Skip this many rows for pagination. */\n  offset?: number;\n}\n\n/**\n * Fetch log entries for one job in chronological order. Paged so\n * a runaway handler doesn't blow up the admin UI.\n */\nexport async function listJobLogs(\n  jobId: string,\n  options: ListJobLogsOptions = {},\n): Promise<NpJobLogEntry[]> {\n  const limit = Math.min(Math.max(1, options.limit ?? 200), 1000);\n  const offset = Math.max(0, options.offset ?? 0);\n  const db = getDb() as unknown as NodePgDatabase<Record<string, unknown>>;\n\n  const rows = (await db\n    .select()\n    .from(npJobLogs)\n    .where(eq(npJobLogs.jobId, jobId))\n    .orderBy(asc(npJobLogs.createdAt))\n    .limit(limit)\n    .offset(offset)) as Array<{\n    id: string;\n    jobId: string;\n    level: string;\n    message: string;\n    context: Record<string, unknown> | null;\n    createdAt: Date;\n  }>;\n\n  return rows.map((row) => ({\n    id: row.id,\n    jobId: row.jobId,\n    level: row.level as NpLogLevel,\n    message: row.message,\n    context: row.context,\n    createdAt: row.createdAt,\n  }));\n}\n\n/**\n * How long per-job log rows survive before the cleanup handler\n * deletes them. Compliance regimes (GDPR, SOX) frequently dictate\n * a specific window — override via `NP_JOB_LOG_RETENTION_DAYS`.\n */\nexport const DEFAULT_JOB_LOG_RETENTION_MS =\n  readEnvPositiveInt(\"NP_JOB_LOG_RETENTION_DAYS\", 14) * 24 * 60 * 60 * 1000;\n\n/**\n * Delete log rows older than the cutoff. Safe to call from a\n * scheduled handler — does not touch logs for active or recent\n * jobs unless they pre-date the cutoff.\n *\n * Returns the row count deleted so the cron handler can log a\n * useful retention summary.\n */\nexport async function pruneJobLogsOlderThan(cutoff: Date): Promise<number> {\n  const db = getDb() as unknown as NodePgDatabase<Record<string, unknown>>;\n  const deleted = (await db\n    .delete(npJobLogs)\n    .where(lt(npJobLogs.createdAt, cutoff))\n    .returning({ id: npJobLogs.id })) as Array<{ id: string }>;\n  return deleted.length;\n}\n\n/**\n * Count entries for a job — drives the admin badge \"37 log lines\"\n * without paying for the page payload until the operator expands.\n */\nexport async function countJobLogs(jobId: string, sinceCreatedAt?: Date): Promise<number> {\n  const db = getDb() as unknown as NodePgDatabase<Record<string, unknown>>;\n  const where = sinceCreatedAt\n    ? and(eq(npJobLogs.jobId, jobId), gte(npJobLogs.createdAt, sinceCreatedAt))\n    : eq(npJobLogs.jobId, jobId);\n  const rows = (await db.select({ id: npJobLogs.id }).from(npJobLogs).where(where)) as Array<{\n    id: string;\n  }>;\n  return rows.length;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA,SAAS,yBAAyB;AAElC,SAAS,KAAK,KAAK,IAAI,KAAK,UAAU;AA4BtC,IAAM,gBAAgB,IAAI,kBAAiC;AAEpD,SAAS,gBAAmB,OAAe,IAA0C;AAC1F,SAAO,cAAc,IAAI,EAAE,MAAM,GAAG,EAAE;AACxC;AAEO,SAAS,kBAAiC;AAC/C,QAAM,QAAQ,cAAc,SAAS;AACrC,SAAO,OAAO,SAAS;AACzB;AAYA,eAAsB,aACpB,OACA,SACA,SACe;AACf,QAAM,QAAQ,gBAAgB;AAC9B,MAAI,CAAC,MAAO;AAEZ,MAAI;AACF,UAAM,KAAK,MAAM;AACjB,UAAM,GAAG,OAAO,SAAS,EAAE,OAAO;AAAA,MAChC;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS,WAAW;AAAA,IACtB,CAAC;AAAA,EACH,SAAS,KAAK;AAGZ,cAAU,EAAE,KAAK,uBAAuB;AAAA,MACtC;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IACxD,CAAC;AAAA,EACH;AACF;AAsBA,eAAsB,YACpB,OACA,UAA8B,CAAC,GACL;AAC1B,QAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,QAAQ,SAAS,GAAG,GAAG,GAAI;AAC9D,QAAM,SAAS,KAAK,IAAI,GAAG,QAAQ,UAAU,CAAC;AAC9C,QAAM,KAAK,MAAM;AAEjB,QAAM,OAAQ,MAAM,GACjB,OAAO,EACP,KAAK,SAAS,EACd,MAAM,GAAG,UAAU,OAAO,KAAK,CAAC,EAChC,QAAQ,IAAI,UAAU,SAAS,CAAC,EAChC,MAAM,KAAK,EACX,OAAO,MAAM;AAShB,SAAO,KAAK,IAAI,CAAC,SAAS;AAAA,IACxB,IAAI,IAAI;AAAA,IACR,OAAO,IAAI;AAAA,IACX,OAAO,IAAI;AAAA,IACX,SAAS,IAAI;AAAA,IACb,SAAS,IAAI;AAAA,IACb,WAAW,IAAI;AAAA,EACjB,EAAE;AACJ;AAOO,IAAM,+BACX,mBAAmB,6BAA6B,EAAE,IAAI,KAAK,KAAK,KAAK;AAUvE,eAAsB,sBAAsB,QAA+B;AACzE,QAAM,KAAK,MAAM;AACjB,QAAM,UAAW,MAAM,GACpB,OAAO,SAAS,EAChB,MAAM,GAAG,UAAU,WAAW,MAAM,CAAC,EACrC,UAAU,EAAE,IAAI,UAAU,GAAG,CAAC;AACjC,SAAO,QAAQ;AACjB;AAMA,eAAsB,aAAa,OAAe,gBAAwC;AACxF,QAAM,KAAK,MAAM;AACjB,QAAM,QAAQ,iBACV,IAAI,GAAG,UAAU,OAAO,KAAK,GAAG,IAAI,UAAU,WAAW,cAAc,CAAC,IACxE,GAAG,UAAU,OAAO,KAAK;AAC7B,QAAM,OAAQ,MAAM,GAAG,OAAO,EAAE,IAAI,UAAU,GAAG,CAAC,EAAE,KAAK,SAAS,EAAE,MAAM,KAAK;AAG/E,SAAO,KAAK;AACd;","names":[]}