@objectstack/plugin-audit 9.6.0 → 9.8.0

package/dist/index.mjs

@@ -1189,6 +1189,34 @@ var SysActivity = ObjectSchema2.create({
       description: "Display label of the target record at write time",
       group: "Target"
     }),
+    // ── Source pointer (ADR-0052 §5 — ActivityPointer model) ─────────
+    // `object_name`/`record_id` say WHICH record this activity belongs to (the
+    // "regarding" record, e.g. the contact). `source_object`/`source_id` point
+    // to the RICH ENTITY this activity was derived from — the email row in
+    // `sys_email`, the call/meeting in a task object, the `sys_comment` — so the
+    // timeline can drill from a one-line summary to the full record. This is the
+    // queryable, structured equivalent of cramming an id into `metadata`
+    // (cf. Dataverse ActivityPointer → Email/PhoneCall/Appointment subtypes,
+    // Salesforce ActivityTimeline → EmailMessage/Task/Event). Optional: most
+    // CRUD activities have no distinct source (the record IS the source).
+    source_object: Field2.text({
+      label: "Source Object",
+      required: false,
+      readonly: true,
+      searchable: true,
+      maxLength: 255,
+      description: 'Object name of the rich source entity this activity was derived from (e.g. "sys_email"). Null when the activity is about the target record itself.',
+      group: "Target"
+    }),
+    source_id: Field2.text({
+      label: "Source ID",
+      required: false,
+      readonly: true,
+      searchable: true,
+      maxLength: 255,
+      description: "Record id of the rich source entity (paired with source_object) \u2014 lets the timeline drill to the full email/call/meeting record.",
+      group: "Target"
+    }),
     url: Field2.url({
       label: "URL",
       required: false,
@@ -1357,7 +1385,7 @@ var SysComment = ObjectSchema3.create({
 });
 
 // src/audit-plugin.ts
-import { SysNotification, SysAttachment } from "@objectstack/platform-objects/audit";
+import { SysNotification } from "@objectstack/platform-objects/audit";
 
 // src/audit-writers.ts
 var SKIP_OBJECTS = /* @__PURE__ */ new Set([
@@ -1417,6 +1445,50 @@ function safeStringify(v) {
     return String(v);
   }
 }
+function displayFieldValue(field, value) {
+  if (value === null || value === void 0 || value === "") return "\u2205";
+  const options = field?.options;
+  if (Array.isArray(options)) {
+    for (const o of options) {
+      const ov = o && typeof o === "object" ? o.value ?? o.name ?? o.label : o;
+      if (ov === value) {
+        const ol = o && typeof o === "object" ? o.label ?? o.name ?? ov : o;
+        return String(ol);
+      }
+    }
+  }
+  return String(value);
+}
+function renderTrackedChangeSummary(fields, oldVals, newVals) {
+  if (!fields || !newVals) return null;
+  const parts = [];
+  for (const key of Object.keys(newVals)) {
+    const field = fields[key];
+    if (!field || field.trackHistory !== true) continue;
+    const label = typeof field.label === "string" && field.label || key;
+    const from = displayFieldValue(field, oldVals ? oldVals[key] : void 0);
+    const to = displayFieldValue(field, newVals[key]);
+    parts.push(`${label}: ${from} \u2192 ${to}`);
+  }
+  return parts.length > 0 ? parts.join("; ") : null;
+}
+function matchMilestone(objectDef, fields, before, after) {
+  const milestones = objectDef && Array.isArray(objectDef.activityMilestones) ? objectDef.activityMilestones : null;
+  if (!milestones || !after || !before) return null;
+  for (const m of milestones) {
+    if (!m || typeof m.field !== "string" || typeof m.summary !== "string") continue;
+    if (after[m.field] === m.value && before[m.field] !== m.value) {
+      const summary = m.summary.replace(/\{(\w+)\}/g, (_match, key) => {
+        const v = after[key];
+        if (v === null || v === void 0 || v === "") return "";
+        const field = fields ? fields[key] : void 0;
+        return field ? displayFieldValue(field, v) : String(v);
+      });
+      return { summary, type: typeof m.type === "string" ? m.type : void 0 };
+    }
+  }
+  return null;
+}
 function installAuditWriters(engine, packageId = "com.objectstack.audit", opts = {}) {
   if (!engine || typeof engine.registerHook !== "function") return;
   const getMessaging = opts.getMessaging ?? (() => void 0);
@@ -1442,6 +1514,30 @@ function installAuditWriters(engine, packageId = "com.objectstack.audit", opts =
     }
     return set != null && set.has(field);
   };
+  const fieldDefsCache = /* @__PURE__ */ new Map();
+  const getFieldDefs = (objectName) => {
+    if (fieldDefsCache.has(objectName)) return fieldDefsCache.get(objectName) ?? null;
+    let defs = null;
+    try {
+      const schema = typeof engine.getSchema === "function" ? engine.getSchema(objectName) : null;
+      const fields = schema?.fields;
+      if (fields && typeof fields === "object" && !Array.isArray(fields)) defs = fields;
+    } catch {
+    }
+    fieldDefsCache.set(objectName, defs);
+    return defs;
+  };
+  const objectDefCache = /* @__PURE__ */ new Map();
+  const getObjectDef = (objectName) => {
+    if (objectDefCache.has(objectName)) return objectDefCache.get(objectName);
+    let def = null;
+    try {
+      def = typeof engine.getSchema === "function" ? engine.getSchema(objectName) : null;
+    } catch {
+    }
+    objectDefCache.set(objectName, def);
+    return def;
+  };
   const captureBefore = async (ctx) => {
     if (SKIP_OBJECTS.has(ctx.object)) return;
     const id = ctx.input?.id;
@@ -1506,9 +1602,23 @@ function installAuditWriters(engine, packageId = "com.objectstack.audit", opts =
       auditRow.organization_id = tenantId ?? null;
     }
     const label = recordLabel(after ?? before, recordId ?? "");
-    const summary = action === "create" ? `Created ${ctx.object} "${label}"` : action === "update" ? `Updated ${ctx.object} "${label}"` : `Deleted ${ctx.object} "${label}"`;
+    let summary;
+    let activityType = activityTypeFor(action);
+    if (action === "create") {
+      summary = `Created ${ctx.object} "${label}"`;
+    } else if (action === "delete") {
+      summary = `Deleted ${ctx.object} "${label}"`;
+    } else {
+      const milestone = matchMilestone(getObjectDef(ctx.object), getFieldDefs(ctx.object), before, after);
+      if (milestone) {
+        summary = milestone.summary;
+        if (milestone.type) activityType = milestone.type;
+      } else {
+        summary = renderTrackedChangeSummary(getFieldDefs(ctx.object), oldValue, newValue) ?? `Updated ${ctx.object} "${label}"`;
+      }
+    }
     const activityRow = {
-      type: activityTypeFor(action),
+      type: activityType,
       // Explicit ISO timestamp — `defaultValue: 'NOW()'` on the column
       // isn't resolved by every driver and would otherwise leak the
       // literal string "NOW()" into the row.
@@ -1653,7 +1763,7 @@ var AuditPlugin = class {
       scope: "system",
       defaultDatasource: "cloud",
       namespace: "sys",
-      objects: [SysAuditLog, SysActivity, SysComment, SysAttachment, SysNotification],
+      objects: [SysAuditLog, SysActivity, SysComment, SysNotification],
       // ADR-0029 D7 — contribute the Audit Logs entry into the Setup app's
       // `group_diagnostics` slot. The plugin owns sys_audit_log (K2).
       navigationContributions: [