npm - @x12i/memorix-service - Versions diffs - 3.7.1 → 3.7.6 - Mend

@x12i/memorix-service 3.7.1 → 3.7.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (140) hide show

package/dist/activity-ring.d.ts +169 -0
package/dist/activity-ring.d.ts.map +1 -0
package/dist/activity-ring.js +234 -0
package/dist/activity-ring.js.map +1 -0
package/dist/activity-routes.d.ts +3 -0
package/dist/activity-routes.d.ts.map +1 -0
package/dist/activity-routes.js +41 -0
package/dist/activity-routes.js.map +1 -0
package/dist/activity-ui.d.ts +3 -0
package/dist/activity-ui.d.ts.map +1 -0
package/dist/activity-ui.js +899 -0
package/dist/activity-ui.js.map +1 -0
package/dist/app.d.ts.map +1 -1
package/dist/app.js +14 -2
package/dist/app.js.map +1 -1
package/dist/caller-identity.d.ts +3 -2
package/dist/caller-identity.d.ts.map +1 -1
package/dist/caller-identity.js.map +1 -1
package/dist/catalog-bridge.js +1 -1
package/dist/catalog-bridge.js.map +1 -1
package/dist/cli.d.ts.map +1 -1
package/dist/cli.js +4 -0
package/dist/cli.js.map +1 -1
package/dist/connector-catalog.d.ts +1 -1
package/dist/connector-ops/attempt-store.d.ts.map +1 -1
package/dist/connector-ops/attempt-store.js +1 -3
package/dist/connector-ops/attempt-store.js.map +1 -1
package/dist/connector-ops/checkpoint-store.d.ts.map +1 -1
package/dist/connector-ops/checkpoint-store.js +1 -3
package/dist/connector-ops/checkpoint-store.js.map +1 -1
package/dist/connector-ops/override-store.d.ts.map +1 -1
package/dist/connector-ops/override-store.js +1 -3
package/dist/connector-ops/override-store.js.map +1 -1
package/dist/connector-ops/run-store.d.ts.map +1 -1
package/dist/connector-ops/run-store.js +1 -3
package/dist/connector-ops/run-store.js.map +1 -1
package/dist/connector-ops/schedule-lease-store.d.ts.map +1 -1
package/dist/connector-ops/schedule-lease-store.js +1 -3
package/dist/connector-ops/schedule-lease-store.js.map +1 -1
package/dist/data-changes-routes.d.ts +7 -0
package/dist/data-changes-routes.d.ts.map +1 -0
package/dist/data-changes-routes.js +27 -0
package/dist/data-changes-routes.js.map +1 -0
package/dist/data-changes-ui.d.ts +3 -0
package/dist/data-changes-ui.d.ts.map +1 -0
package/dist/data-changes-ui.js +239 -0
package/dist/data-changes-ui.js.map +1 -0
package/dist/data-changes.d.ts +51 -0
package/dist/data-changes.d.ts.map +1 -0
package/dist/data-changes.js +218 -0
package/dist/data-changes.js.map +1 -0
package/dist/errors.d.ts +3 -0
package/dist/errors.d.ts.map +1 -1
package/dist/errors.js +36 -3
package/dist/errors.js.map +1 -1
package/dist/identity-alias.d.ts +12 -0
package/dist/identity-alias.d.ts.map +1 -0
package/dist/identity-alias.js +22 -0
package/dist/identity-alias.js.map +1 -0
package/dist/incremental-state/state-store.d.ts.map +1 -1
package/dist/incremental-state/state-store.js +1 -3
package/dist/incremental-state/state-store.js.map +1 -1
package/dist/integrations/instance-store.d.ts.map +1 -1
package/dist/integrations/instance-store.js +1 -3
package/dist/integrations/instance-store.js.map +1 -1
package/dist/isolation.d.ts.map +1 -1
package/dist/isolation.js +3 -2
package/dist/isolation.js.map +1 -1
package/dist/land-v2-guards.d.ts +22 -0
package/dist/land-v2-guards.d.ts.map +1 -0
package/dist/land-v2-guards.js +57 -0
package/dist/land-v2-guards.js.map +1 -0
package/dist/live.d.ts.map +1 -1
package/dist/nexum-analysis/backfill.d.ts +59 -0
package/dist/nexum-analysis/backfill.d.ts.map +1 -0
package/dist/nexum-analysis/backfill.js +199 -0
package/dist/nexum-analysis/backfill.js.map +1 -0
package/dist/nexum-analysis/enqueue.d.ts +29 -0
package/dist/nexum-analysis/enqueue.d.ts.map +1 -0
package/dist/nexum-analysis/enqueue.js +190 -0
package/dist/nexum-analysis/enqueue.js.map +1 -0
package/dist/nexum-analysis/outbox.d.ts +44 -0
package/dist/nexum-analysis/outbox.d.ts.map +1 -0
package/dist/nexum-analysis/outbox.js +176 -0
package/dist/nexum-analysis/outbox.js.map +1 -0
package/dist/nexum-analysis/policy.d.ts +48 -0
package/dist/nexum-analysis/policy.d.ts.map +1 -0
package/dist/nexum-analysis/policy.js +165 -0
package/dist/nexum-analysis/policy.js.map +1 -0
package/dist/nexum-analysis/reconcile.d.ts +8 -0
package/dist/nexum-analysis/reconcile.d.ts.map +1 -0
package/dist/nexum-analysis/reconcile.js +37 -0
package/dist/nexum-analysis/reconcile.js.map +1 -0
package/dist/openapi/openapi.json +591 -4
package/dist/operational-db.d.ts +6 -0
package/dist/operational-db.d.ts.map +1 -0
package/dist/operational-db.js +22 -0
package/dist/operational-db.js.map +1 -0
package/dist/platform.d.ts +4 -1
package/dist/platform.d.ts.map +1 -1
package/dist/platform.js +67 -14
package/dist/platform.js.map +1 -1
package/dist/request-countex.d.ts +25 -0
package/dist/request-countex.d.ts.map +1 -1
package/dist/request-countex.js +103 -18
package/dist/request-countex.js.map +1 -1
package/dist/restricted-store/object-store.d.ts.map +1 -1
package/dist/restricted-store/object-store.js +1 -3
package/dist/restricted-store/object-store.js.map +1 -1
package/dist/routes/connector-invocations.d.ts.map +1 -1
package/dist/routes/connector-invocations.js +7 -1
package/dist/routes/connector-invocations.js.map +1 -1
package/dist/routes/data.d.ts.map +1 -1
package/dist/routes/data.js +105 -12
package/dist/routes/data.js.map +1 -1
package/dist/routes/knowledge.d.ts +8 -0
package/dist/routes/knowledge.d.ts.map +1 -0
package/dist/routes/knowledge.js +114 -0
package/dist/routes/knowledge.js.map +1 -0
package/dist/routes/memory.d.ts.map +1 -1
package/dist/routes/memory.js +33 -9
package/dist/routes/memory.js.map +1 -1
package/dist/routes/metadata.d.ts.map +1 -1
package/dist/routes/metadata.js +102 -1
package/dist/routes/metadata.js.map +1 -1
package/dist/routes/mgc-landing.d.ts.map +1 -1
package/dist/routes/mgc-landing.js +90 -1
package/dist/routes/mgc-landing.js.map +1 -1
package/dist/routes/operations.d.ts.map +1 -1
package/dist/routes/operations.js +39 -2
package/dist/routes/operations.js.map +1 -1
package/dist/routes/publications.d.ts +4 -0
package/dist/routes/publications.d.ts.map +1 -0
package/dist/routes/publications.js +111 -0
package/dist/routes/publications.js.map +1 -0
package/dist/routes/workflow.d.ts.map +1 -1
package/dist/routes/workflow.js +18 -9
package/dist/routes/workflow.js.map +1 -1
package/openapi/openapi.json +591 -4
package/package.json +5 -5

package/dist/data-changes-ui.js ADDED Viewed

@@ -0,0 +1,239 @@
+/** HTML for GET /_live/changes — OT×CT change matrix by collection target. */
+export function dataChangesHtml() {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Memorix · Data changes</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com" />
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
+  <style>
+    :root {
+      --bg: #0a0c10; --bg-elev: #10141b; --bg-row: #141922; --line: #242b38;
+      --text: #e8ebe6; --muted: #8a9288; --dim: #5c645c;
+      --ok: #3dba7a; --accent: #c8f082; --accent-ink: #0a0c10;
+      --sans: "IBM Plex Sans", system-ui, sans-serif;
+      --mono: "IBM Plex Mono", ui-monospace, monospace;
+    }
+    * { box-sizing: border-box; }
+    html, body { height: 100%; margin: 0; }
+    body {
+      font-family: var(--sans);
+      background:
+        radial-gradient(1200px 600px at 10% -10%, #1a2214 0%, transparent 55%),
+        radial-gradient(900px 500px at 100% 0%, #121820 0%, transparent 50%),
+        var(--bg);
+      color: var(--text); font-size: 14px; line-height: 1.45;
+    }
+    a { color: var(--accent); }
+    .shell { max-width: 1200px; margin: 0 auto; padding: 36px 28px 64px; }
+    header {
+      display: flex; align-items: flex-end; justify-content: space-between; gap: 24px;
+      margin-bottom: 22px; padding-bottom: 18px; border-bottom: 1px solid var(--line);
+    }
+    .brand { font-size: 26px; font-weight: 700; letter-spacing: -0.03em; }
+    .brand span { color: var(--accent); }
+    .sub { margin-top: 8px; color: var(--muted); font-size: 13px; max-width: 62ch; }
+    .meta { text-align: right; font-family: var(--mono); font-size: 11px; color: var(--dim); display: grid; gap: 4px; }
+    .toolbar {
+      display: flex; flex-wrap: wrap; gap: 10px; align-items: center;
+      margin-bottom: 16px;
+    }
+    .tabs { display: flex; gap: 6px; flex-wrap: wrap; }
+    .tab, .btn, select, input {
+      appearance: none; border: 1px solid var(--line); background: var(--bg-row); color: var(--text);
+      font: 500 12px/1 var(--sans); padding: 10px 14px; border-radius: 2px;
+    }
+    .tab { cursor: pointer; text-transform: uppercase; letter-spacing: 0.04em; color: var(--muted); background: transparent; }
+    .tab[aria-selected="true"] {
+      background: var(--accent); color: var(--accent-ink); border-color: var(--accent);
+    }
+    .btn { cursor: pointer; }
+    .btn:hover { border-color: var(--accent); }
+    input, select { min-width: 140px; }
+    .summary {
+      display: flex; flex-wrap: wrap; gap: 16px; margin-bottom: 14px;
+      font-family: var(--mono); font-size: 12px; color: var(--muted);
+    }
+    .summary strong { color: var(--text); font-weight: 500; }
+    table { width: 100%; border-collapse: collapse; background: var(--bg-elev); border: 1px solid var(--line); }
+    th, td { text-align: left; padding: 10px 12px; border-bottom: 1px solid var(--line); vertical-align: top; }
+    th {
+      font-family: var(--mono); font-size: 10px; letter-spacing: 0.08em; text-transform: uppercase;
+      color: var(--dim); font-weight: 500; background: #0d1016; position: sticky; top: 0;
+    }
+    tr:last-child td { border-bottom: 0; }
+    tr:hover td { background: var(--bg-row); }
+    .mono { font-family: var(--mono); font-size: 12px; color: var(--muted); }
+    .num { font-family: var(--mono); font-size: 12px; text-align: right; white-space: nowrap; }
+    .db { color: var(--accent); }
+    .muted { color: var(--muted); }
+    .err { color: #e25a5a; margin: 12px 0; }
+    .group-head td {
+      background: #0d1016; font-family: var(--mono); font-size: 11px;
+      color: var(--dim); letter-spacing: 0.04em; text-transform: uppercase;
+    }
+    footer { margin-top: 28px; color: var(--dim); font-size: 12px; }
+  </style>
+</head>
+<body>
+  <div class="shell">
+    <header>
+      <div>
+        <div class="brand">Memorix <span>data changes</span></div>
+        <p class="sub">Records touched per collection <strong>target</strong> (database × objectType × contentType), from <span class="mono">_system.modifiedAt</span> / <span class="mono">createdAt</span>.</p>
+      </div>
+      <div class="meta">
+        <div><strong>UI</strong> /_live/changes</div>
+        <div><strong>API</strong> /_live/api/data-changes</div>
+        <div><a href="/_live">← live view</a> · <a href="/_live/activity">activity</a></div>
+      </div>
+    </header>
+    <div class="toolbar">
+      <nav class="tabs" role="tablist">
+        <button class="tab" role="tab" aria-selected="true" data-window="1h">Last hour</button>
+        <button class="tab" role="tab" aria-selected="false" data-window="24h">Last 24 hours</button>
+      </nav>
+      <label class="muted">Org
+        <select id="org"></select>
+      </label>
+      <label class="muted" style="display:flex;align-items:center;gap:6px">
+        <input type="checkbox" id="zeros" /> include zeros
+      </label>
+      <button class="btn" id="refresh" type="button">Refresh</button>
+    </div>
+    <div class="summary" id="summary"></div>
+    <div id="error" class="err" hidden></div>
+    <div id="table-wrap"></div>
+    <footer>Counts are live Mongo scans · windows are rolling from request time · reserved collections skipped</footer>
+  </div>
+  <script>
+    const $ = (id) => document.getElementById(id);
+    let report = null;
+    let activeWindow = "1h";
+    document.querySelectorAll(".tab").forEach((tab) => {
+      tab.addEventListener("click", () => {
+        document.querySelectorAll(".tab").forEach((t) => t.setAttribute("aria-selected", "false"));
+        tab.setAttribute("aria-selected", "true");
+        activeWindow = tab.dataset.window;
+        render();
+      });
+    });
+    $("refresh").onclick = () => load({ forceOrg: true });
+    $("org").onchange = () => load();
+    $("zeros").onchange = () => load();
+    function fmt(n) {
+      return new Intl.NumberFormat().format(n ?? 0);
+    }
+    function escapeHtml(s) {
+      return String(s ?? "").replace(/[&<>"']/g, (c) => ({
+        "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;"
+      })[c]);
+    }
+    async function load(opts = {}) {
+      $("error").hidden = true;
+      $("summary").textContent = "Scanning…";
+      $("table-wrap").innerHTML = "";
+      const params = new URLSearchParams();
+      const org = $("org").value;
+      if (org && org !== "*") params.set("orgId", org);
+      if ($("zeros").checked) params.set("includeZeros", "1");
+      try {
+        const res = await fetch("/_live/api/data-changes?" + params.toString());
+        const body = await res.json();
+        if (!res.ok || body.ok === false) {
+          throw new Error(body?.error?.message || ("HTTP " + res.status));
+        }
+        report = body;
+        if (opts.forceOrg || $("org").options.length <= 1) {
+          fillOrgs(body.orgIds || [], org);
+        }
+        render();
+      } catch (e) {
+        $("summary").textContent = "";
+        $("error").hidden = false;
+        $("error").textContent = e.message || String(e);
+      }
+    }
+    function fillOrgs(orgIds, selected) {
+      const sel = $("org");
+      const keep = selected || sel.value || "*";
+      sel.innerHTML = "";
+      const all = document.createElement("option");
+      all.value = "*";
+      all.textContent = "All orgs";
+      sel.appendChild(all);
+      for (const id of orgIds) {
+        const o = document.createElement("option");
+        o.value = id;
+        o.textContent = id;
+        sel.appendChild(o);
+      }
+      sel.value = [...sel.options].some((o) => o.value === keep) ? keep : "*";
+    }
+    function render() {
+      if (!report) return;
+      const win = report.windows?.[activeWindow];
+      if (!win) {
+        $("summary").textContent = "No window data";
+        return;
+      }
+      $("summary").innerHTML =
+        "<span>since <strong>" + escapeHtml(win.since) + "</strong></span>" +
+        "<span>collections <strong>" + fmt(win.totals.collections) + "</strong></span>" +
+        "<span>with changes <strong>" + fmt(win.totals.changedCollections) + "</strong></span>" +
+        "<span>modified <strong>" + fmt(win.totals.changed) + "</strong></span>" +
+        "<span>created <strong>" + fmt(win.totals.created) + "</strong></span>" +
+        "<span>generated <strong>" + escapeHtml(report.generatedAt) + "</strong></span>";
+      const rows = win.rows || [];
+      if (!rows.length) {
+        $("table-wrap").innerHTML = "<p class='muted'>No matching content targets in this window.</p>";
+        return;
+      }
+      let html = "<table><thead><tr>" +
+        "<th>Org</th><th>Database</th><th>Kind</th><th>Object type</th><th>Content type</th>" +
+        "<th class='num'>Changed</th><th class='num'>Created</th><th class='num'>Total</th><th>Collection target</th>" +
+        "</tr></thead><tbody>";
+      let lastDb = "";
+      for (const r of rows) {
+        if (r.databaseName !== lastDb) {
+          lastDb = r.databaseName;
+          html += "<tr class='group-head'><td colspan='9'>" +
+            escapeHtml(r.orgId) + " · " + escapeHtml(r.databaseName) +
+            "</td></tr>";
+        }
+        html += "<tr>" +
+          "<td class='mono'>" + escapeHtml(r.orgId) + "</td>" +
+          "<td class='mono db'>" + escapeHtml(r.databaseName) + "</td>" +
+          "<td class='mono'>" + escapeHtml(r.kind) + "</td>" +
+          "<td>" + escapeHtml(r.objectType) + "</td>" +
+          "<td>" + escapeHtml(r.contentType) + "</td>" +
+          "<td class='num'>" + fmt(r.changed) + "</td>" +
+          "<td class='num'>" + fmt(r.created) + "</td>" +
+          "<td class='num'>" + fmt(r.total) + "</td>" +
+          "<td class='mono'>" + escapeHtml(r.collectionName) + "</td>" +
+          "</tr>";
+      }
+      html += "</tbody></table>";
+      $("table-wrap").innerHTML = html;
+    }
+    load({ forceOrg: true });
+  </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=data-changes-ui.js.map

package/dist/data-changes-ui.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"data-changes-ui.js","sourceRoot":"","sources":["../src/data-changes-ui.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA0OD,CAAC;AACT,CAAC"}

package/dist/data-changes.d.ts ADDED Viewed

@@ -0,0 +1,51 @@
+/**
+ * Scan org category databases for content-collection change counts
+ * (`_system.modifiedAt`) over rolling windows, keyed by collection target.
+ */
+import type { MongoClient } from "mongodb";
+import { type DatabaseKind } from "@x12i/memorix-data";
+export type DataChangeWindowId = "1h" | "24h";
+export type CollectionChangeTarget = {
+    orgId: string;
+    kind: DatabaseKind;
+    databaseName: string;
+    collectionName: string;
+    objectType: string;
+    contentType: string;
+};
+export type CollectionChangeCounts = CollectionChangeTarget & {
+    total: number;
+    changed: number;
+    created: number;
+};
+export type DataChangesWindowResult = {
+    window: DataChangeWindowId;
+    since: string;
+    until: string;
+    rows: CollectionChangeCounts[];
+    totals: {
+        collections: number;
+        changedCollections: number;
+        changed: number;
+        created: number;
+    };
+};
+export type DataChangesReport = {
+    generatedAt: string;
+    orgIds: string[];
+    windows: Record<DataChangeWindowId, DataChangesWindowResult>;
+};
+/** Longest objectType prefix match → contentType remainder. */
+export declare function resolveObjectAndContentType(collectionName: string, objectTypes: readonly string[]): {
+    objectType: string;
+    contentType: string;
+};
+export type ScanDataChangesOpts = {
+    client: MongoClient;
+    /** Limit to one org; default all orgs with an operational DB. */
+    orgId?: string;
+    /** Include rows with zero changes in both windows (default false). */
+    includeZeros?: boolean;
+};
+export declare function scanDataChanges(opts: ScanDataChangesOpts): Promise<DataChangesReport>;
+//# sourceMappingURL=data-changes.d.ts.map

package/dist/data-changes.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"data-changes.d.ts","sourceRoot":"","sources":["../src/data-changes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA4BxE,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,KAAK,CAAC;AAE9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,GAAG;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAC/B,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;CAC9D,CAAC;AAMF,+DAA+D;AAC/D,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAsB7C;AAiFD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAsB,eAAe,CACnC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAsH5B"}

package/dist/data-changes.js ADDED Viewed

@@ -0,0 +1,218 @@
+import { databaseNameFor } from "@x12i/memorix-data";
+import { isOperationalDbName, orgIdFromOperationalDbName, } from "./operational-db.js";
+const DATABASE_KINDS = [
+    "entity",
+    "event",
+    "knowledge",
+    "operational",
+];
+const RESERVED_COLLECTIONS = new Set([
+    "relationships",
+    "record-directory",
+    "system.profile",
+]);
+/** Skip ops / underscore collections that are not OT-CT content targets. */
+function isContentCollectionName(name) {
+    if (!name || RESERVED_COLLECTIONS.has(name))
+        return false;
+    if (name.startsWith("system."))
+        return false;
+    if (name.includes("_"))
+        return false;
+    if (!name.includes("-"))
+        return false;
+    return /^[a-z][a-z0-9-]*$/.test(name);
+}
+function windowMs(id) {
+    return id === "1h" ? 3_600_000 : 86_400_000;
+}
+/** Longest objectType prefix match → contentType remainder. */
+export function resolveObjectAndContentType(collectionName, objectTypes) {
+    const sorted = [...objectTypes].sort((a, b) => b.length - a.length);
+    for (const objectType of sorted) {
+        const prefix = `${objectType}-`;
+        if (collectionName.startsWith(prefix) &&
+            collectionName.length > prefix.length) {
+            return {
+                objectType,
+                contentType: collectionName.slice(prefix.length),
+            };
+        }
+    }
+    const i = collectionName.lastIndexOf("-");
+    if (i > 0) {
+        return {
+            objectType: collectionName.slice(0, i),
+            contentType: collectionName.slice(i + 1),
+        };
+    }
+    return { objectType: collectionName, contentType: "" };
+}
+async function listOrgIds(client) {
+    const listed = await client.db().admin().listDatabases();
+    const ids = new Set();
+    for (const db of listed.databases ?? []) {
+        const name = String(db.name ?? "");
+        if (!isOperationalDbName(name))
+            continue;
+        const orgId = orgIdFromOperationalDbName(name);
+        if (orgId)
+            ids.add(orgId);
+    }
+    return [...ids].sort((a, b) => a.localeCompare(b));
+}
+async function objectTypesForOrg(client, orgId) {
+    const dbName = databaseNameFor(orgId, "operational");
+    try {
+        const types = await client
+            .db(dbName)
+            .collection("record-directory")
+            .distinct("objectType");
+        return types
+            .map((t) => String(t))
+            .filter((t) => t.length > 0)
+            .sort((a, b) => b.length - a.length || a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+async function countBothWindows(client, target, since1h, since24h) {
+    const coll = client
+        .db(target.databaseName)
+        .collection(target.collectionName);
+    const [total, changed1h, created1h, changed24h, created24h] = await Promise.all([
+        coll.estimatedDocumentCount(),
+        coll.countDocuments({ "_system.modifiedAt": { $gte: since1h } }),
+        coll.countDocuments({ "_system.createdAt": { $gte: since1h } }),
+        coll.countDocuments({ "_system.modifiedAt": { $gte: since24h } }),
+        coll.countDocuments({ "_system.createdAt": { $gte: since24h } }),
+    ]);
+    return { total, changed1h, created1h, changed24h, created24h };
+}
+function sortRows(rows) {
+    rows.sort((a, b) => {
+        if (a.orgId !== b.orgId)
+            return a.orgId.localeCompare(b.orgId);
+        if (a.databaseName !== b.databaseName) {
+            return a.databaseName.localeCompare(b.databaseName);
+        }
+        if (b.changed !== a.changed)
+            return b.changed - a.changed;
+        return a.collectionName.localeCompare(b.collectionName);
+    });
+}
+function summarize(rows) {
+    return {
+        collections: rows.length,
+        changedCollections: rows.filter((r) => r.changed > 0).length,
+        changed: rows.reduce((n, r) => n + r.changed, 0),
+        created: rows.reduce((n, r) => n + r.created, 0),
+    };
+}
+export async function scanDataChanges(opts) {
+    const until = new Date();
+    const untilIso = until.toISOString();
+    const since1h = new Date(until.getTime() - windowMs("1h")).toISOString();
+    const since24h = new Date(until.getTime() - windowMs("24h")).toISOString();
+    let orgIds = await listOrgIds(opts.client);
+    if (opts.orgId?.trim()) {
+        const want = opts.orgId.trim().toLowerCase();
+        orgIds = orgIds.filter((id) => id.toLowerCase() === want);
+        if (orgIds.length === 0)
+            orgIds = [opts.orgId.trim()];
+    }
+    const targets = [];
+    for (const orgId of orgIds) {
+        const objectTypes = await objectTypesForOrg(opts.client, orgId);
+        for (const kind of DATABASE_KINDS) {
+            const databaseName = databaseNameFor(orgId, kind);
+            let names = [];
+            try {
+                const cols = await opts.client
+                    .db(databaseName)
+                    .listCollections()
+                    .toArray();
+                names = cols.map((c) => String(c.name));
+            }
+            catch {
+                continue;
+            }
+            if (names.length === 0)
+                continue;
+            for (const collectionName of names) {
+                if (!isContentCollectionName(collectionName))
+                    continue;
+                const { objectType, contentType } = resolveObjectAndContentType(collectionName, objectTypes);
+                targets.push({
+                    orgId,
+                    kind,
+                    databaseName,
+                    collectionName,
+                    objectType,
+                    contentType,
+                });
+            }
+        }
+    }
+    const rows1h = [];
+    const rows24h = [];
+    const concurrency = 8;
+    let idx = 0;
+    async function worker() {
+        while (idx < targets.length) {
+            const my = idx++;
+            const target = targets[my];
+            try {
+                const counts = await countBothWindows(opts.client, target, since1h, since24h);
+                const has1h = counts.changed1h > 0 || counts.created1h > 0;
+                const has24h = counts.changed24h > 0 || counts.created24h > 0;
+                if (!opts.includeZeros && !has1h && !has24h)
+                    continue;
+                if (opts.includeZeros || has1h) {
+                    rows1h.push({
+                        ...target,
+                        total: counts.total,
+                        changed: counts.changed1h,
+                        created: counts.created1h,
+                    });
+                }
+                if (opts.includeZeros || has24h) {
+                    rows24h.push({
+                        ...target,
+                        total: counts.total,
+                        changed: counts.changed24h,
+                        created: counts.created24h,
+                    });
+                }
+            }
+            catch {
+                /* skip unreadable collections */
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(concurrency, Math.max(targets.length, 1)) }, () => worker()));
+    sortRows(rows1h);
+    sortRows(rows24h);
+    return {
+        generatedAt: untilIso,
+        orgIds,
+        windows: {
+            "1h": {
+                window: "1h",
+                since: since1h,
+                until: untilIso,
+                rows: rows1h,
+                totals: summarize(rows1h),
+            },
+            "24h": {
+                window: "24h",
+                since: since24h,
+                until: untilIso,
+                rows: rows24h,
+                totals: summarize(rows24h),
+            },
+        },
+    };
+}
+//# sourceMappingURL=data-changes.js.map

package/dist/data-changes.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"data-changes.js","sourceRoot":"","sources":["../src/data-changes.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts CHANGED Viewed

@@ -10,6 +10,9 @@ export type ServiceErrorBody = {
         };
     };
 };
+/** Actionable next step for undeclared OT/CT or a rejected metadata ensure handshake. */
+export declare const METADATA_ENSURE_NEXT = "POST /api/metadata/ensure with your metadata pack and confirm:true before writing. pack.agentId must be one of x-memorix-agent-ids. Then retry this write. A 404 on /api/metadata/ensure means this host is older than @x12i/memorix-service@3.7.6.";
+export declare const METADATA_ENSURE_BODY_NEXT = "Call POST /api/metadata/ensure with body { pack: <MetadataPack>, confirm: true }. pack.agentId must be one of x-memorix-agent-ids. Do not invent objectType/contentType on POST /api/data/content.";
 export declare class ServiceError extends Error {
     readonly code: string;
     readonly statusCode: number;

package/dist/errors.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAC/C,CAAC;CACH,CAAC;AAEF,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAO/E;~~AA+DD~~,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;CACxB,~~CAoDA~~;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2BrD"}
1	+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAC/C,CAAC;CACH,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,wPACsN,CAAC;AAExP,eAAO,MAAM,yBAAyB,uMACgK,CAAC;AAEvM,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAO/E;AAwFD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAkEA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2BrD"}

package/dist/errors.js CHANGED Viewed

@@ -1,3 +1,6 @@
+/** Actionable next step for undeclared OT/CT or a rejected metadata ensure handshake. */
+export const METADATA_ENSURE_NEXT = "POST /api/metadata/ensure with your metadata pack and confirm:true before writing. pack.agentId must be one of x-memorix-agent-ids. Then retry this write. A 404 on /api/metadata/ensure means this host is older than @x12i/memorix-service@3.7.6.";
+export const METADATA_ENSURE_BODY_NEXT = "Call POST /api/metadata/ensure with body { pack: <MetadataPack>, confirm: true }. pack.agentId must be one of x-memorix-agent-ids. Do not invent objectType/contentType on POST /api/data/content.";
 export class ServiceError extends Error {
     code;
     statusCode;
@@ -27,6 +30,16 @@ const DATA_PLANE_STATUS = {
     DIRECTORY_CONFLICT_DATA_CATEGORY: 409,
     DIRECTORY_IDENTITY_REUSE_FORBIDDEN: 409,
     DIRECTORY_NOT_RESERVED: 409,
+    PUBLICATION_NOT_FOUND: 404,
+    PUBLICATION_MEMBER_UNAVAILABLE: 409,
+    PUBLICATION_NOT_COMMITTED: 409,
+    PUBLICATION_NOT_DRAFT: 409,
+    PUBLICATION_PINNED: 409,
+    PUBLICATION_EXISTS: 409,
+    WRITE_DIRECTORY_INCONSISTENT: 409,
+    WRITE_IDENTITY_ADOPTION: 400,
+    WRITE_IDENTITY_MISMATCH: 400,
+    WRITE_INTERFACE_BINDING: 400,
     // Unavailable / dependency
     READ_UNAVAILABLE: 503,
     ABSTRACT_WRITE_UNAVAILABLE: 503,
@@ -37,6 +50,7 @@ const DATA_PLANE_ERROR_NAMES = new Set([
     "ReaderError",
     "WriterError",
     "AbstractWriteError",
+    "PublicationError",
 ]);
 function dataPlaneStatus(code) {
     if (DATA_PLANE_STATUS[code] !== undefined)
@@ -47,7 +61,8 @@ function dataPlaneStatus(code) {
         code.startsWith("ROUTE_") ||
         code.startsWith("SCOPE_") ||
         code.startsWith("ABSTRACT_WRITE_") ||
-        code.startsWith("DIRECTORY_")) {
+        code.startsWith("DIRECTORY_") ||
+        code.startsWith("PUBLICATION_")) {
         return 400;
     }
     return undefined;
@@ -64,9 +79,23 @@ function isDataPlaneLike(err) {
     // Duck-type when packages are duplicated across bundles
     return dataPlaneStatus(err.code) !== undefined;
 }
+function mergeDetails(details, extra) {
+    const base = details && typeof details === "object" && !Array.isArray(details)
+        ? { ...details }
+        : details !== undefined
+            ? { value: details }
+            : {};
+    return { ...base, ...extra };
+}
 export function mapErrorToHttp(err, correlationId) {
     if (err && typeof err === "object" && "code" in err && "statusCode" in err) {
         const e = err;
+        const details = e.code === "CONFIRMATION_REQUIRED" ||
+            (e.code === "VALIDATION" &&
+                typeof e.message === "string" &&
+                /pack(\.agentId)? required|must be one of x-memorix-agent-ids/i.test(e.message))
+            ? mergeDetails(e.details, { next: METADATA_ENSURE_BODY_NEXT })
+            : e.details;
         return {
             status: e.statusCode,
             body: {
@@ -74,7 +103,7 @@ export function mapErrorToHttp(err, correlationId) {
                     code: e.code,
                     message: e.message,
                     correlationId,
-                    details: e.details,
+                    details,
                 },
             },
         };
@@ -93,6 +122,10 @@ export function mapErrorToHttp(err, correlationId) {
     }
     if (isDataPlaneLike(err)) {
         const status = dataPlaneStatus(err.code) ?? 500;
+        const details = err.code === "ROUTE_UNKNOWN_OBJECT_TYPE" ||
+            err.code === "ROUTE_UNKNOWN_CONTENT_TYPE"
+            ? mergeDetails(err.details, { next: METADATA_ENSURE_NEXT })
+            : err.details;
         return {
             status,
             body: {
@@ -100,7 +133,7 @@ export function mapErrorToHttp(err, correlationId) {
                     code: err.code,
                     message: err.message,
                     correlationId,
-                    details: err.details,
+                    details,
                 },
             },
         };