@x12i/memorix-service 3.9.2 → 3.11.0

package/dist/analytics/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/analytics/state.ts"],"names":[],"mappings":"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"}

package/dist/analytics/state.js

@@ -0,0 +1,273 @@
+const clone = (v) => structuredClone(v);
+export function createMemoryAnalyticsState() {
+    const counters = new Map();
+    const ledger = new Map();
+    const pairs = new Map();
+    const rowId = (counterId, generation, key) => `${counterId}#${generation}|${key}`;
+    return {
+        async listCounters() {
+            return [...counters.values()].map(clone);
+        },
+        async getCounter(id) {
+            const c = counters.get(id);
+            return c ? clone(c) : null;
+        },
+        async saveCounter(record) {
+            counters.set(record.id, clone(record));
+        },
+        async patchCounter(id, patch, generation) {
+            const c = counters.get(id);
+            if (!c || (generation !== undefined && c.generation !== generation))
+                return false;
+            Object.assign(c, clone(patch));
+            return true;
+        },
+        async deleteCounter(id) {
+            counters.delete(id);
+        },
+        async readLedger(counterId, generation, keys) {
+            const out = new Map();
+            for (const key of keys) {
+                const row = ledger.get(rowId(counterId, generation, key));
+                if (row)
+                    out.set(key, clone(row));
+            }
+            return out;
+        },
+        async writeIntents(counterId, generation, intents, now) {
+            const conflicts = [];
+            for (const i of intents) {
+                const id = rowId(counterId, generation, i.key);
+                const row = ledger.get(id);
+                const seq = row ? row.seq : null;
+                if (seq !== i.expectedSeq) {
+                    conflicts.push(i.key);
+                    continue;
+                }
+                const pending = i.next ? clone(i.next) : { removed: true };
+                if (row) {
+                    row.seq += 1;
+                    row.pending = pending;
+                    row.pendingAt = now;
+                }
+                else {
+                    ledger.set(id, {
+                        counterId,
+                        generation,
+                        key: i.key,
+                        scope: "",
+                        at: "",
+                        facts: [],
+                        track: {},
+                        seq: 1,
+                        pending,
+                        pendingAt: now,
+                    });
+                }
+            }
+            return conflicts;
+        },
+        async commitIntents(counterId, generation, keys) {
+            for (const key of keys) {
+                const id = rowId(counterId, generation, key);
+                const row = ledger.get(id);
+                if (!row?.pending)
+                    continue;
+                if ("removed" in row.pending) {
+                    ledger.delete(id);
+                    continue;
+                }
+                Object.assign(row, row.pending, { pending: null, pendingAt: null });
+            }
+        },
+        async stalePending(olderThan) {
+            const out = new Set();
+            for (const row of ledger.values()) {
+                if (row.pending && row.pendingAt && Date.parse(row.pendingAt) < olderThan.getTime()) {
+                    out.add(row.counterId);
+                }
+            }
+            return [...out];
+        },
+        async dropGenerations(counterId, belowGeneration) {
+            for (const [id, row] of ledger) {
+                if (row.counterId === counterId && (belowGeneration === undefined || row.generation < belowGeneration)) {
+                    ledger.delete(id);
+                }
+            }
+            for (const [id, row] of pairs) {
+                if (row.counterId === counterId && (belowGeneration === undefined || row.generation < belowGeneration)) {
+                    pairs.delete(id);
+                }
+            }
+        },
+        async touchPair(row) {
+            const known = pairs.get(row.scope);
+            if (known) {
+                if (row.firstSeenAt < known.firstSeenAt)
+                    known.firstSeenAt = row.firstSeenAt;
+                return false;
+            }
+            pairs.set(row.scope, clone(row));
+            return true;
+        },
+        async listPairs(counterId, generation, limit) {
+            return [...pairs.values()]
+                .filter((p) => p.counterId === counterId && p.generation === generation)
+                .sort((a, b) => b.firstSeenAt.localeCompare(a.firstSeenAt) || b.scope.localeCompare(a.scope))
+                .slice(0, limit)
+                .map(clone);
+        },
+    };
+}
+function isDuplicateKey(err) {
+    return Boolean(err && typeof err === "object" && err.code === 11000);
+}
+export function createMongoAnalyticsState(db) {
+    const countersCol = db.collection("analytics_counters");
+    const ledgerCol = db.collection("analytics_subject_state");
+    const pairsCol = db.collection("analytics_pairs");
+    let indexed = null;
+    const ensureIndexes = () => (indexed ??= Promise.all([
+        ledgerCol.createIndex({ counterId: 1, generation: 1 }),
+        ledgerCol.createIndex({ pendingAt: 1 }, { sparse: true }),
+        pairsCol.createIndex({ counterId: 1, generation: 1, firstSeenAt: -1 }),
+    ]).then(() => undefined));
+    const rowId = (counterId, generation, key) => `${counterId}#${generation}|${key}`;
+    const strip = (doc) => {
+        const { _id, ...rest } = doc;
+        void _id;
+        return rest;
+    };
+    return {
+        async listCounters() {
+            return (await countersCol.find({}).toArray()).map((d) => strip(d));
+        },
+        async getCounter(id) {
+            const d = await countersCol.findOne({ _id: id });
+            return d ? strip(d) : null;
+        },
+        async saveCounter(record) {
+            await countersCol.replaceOne({ _id: record.id }, record, { upsert: true });
+        },
+        async patchCounter(id, patch, generation) {
+            const { id: _ignored, ...fields } = patch;
+            void _ignored;
+            const res = await countersCol.updateOne(generation === undefined ? { _id: id } : { _id: id, generation }, { $set: fields });
+            return res.matchedCount > 0;
+        },
+        async deleteCounter(id) {
+            await countersCol.deleteOne({ _id: id });
+        },
+        async readLedger(counterId, generation, keys) {
+            await ensureIndexes();
+            const out = new Map();
+            if (keys.length === 0)
+                return out;
+            const docs = await ledgerCol
+                .find({ _id: { $in: keys.map((k) => rowId(counterId, generation, k)) } })
+                .toArray();
+            for (const d of docs)
+                out.set(d.key, strip(d));
+            return out;
+        },
+        async writeIntents(counterId, generation, intents, now) {
+            await ensureIndexes();
+            const conflicts = [];
+            for (const i of intents) {
+                const _id = rowId(counterId, generation, i.key);
+                const pending = i.next ?? { removed: true };
+                if (i.expectedSeq === null) {
+                    try {
+                        await ledgerCol.insertOne({
+                            _id,
+                            counterId,
+                            generation,
+                            key: i.key,
+                            scope: "",
+                            at: "",
+                            facts: [],
+                            track: {},
+                            seq: 1,
+                            pending,
+                            pendingAt: now,
+                        });
+                    }
+                    catch (err) {
+                        if (!isDuplicateKey(err))
+                            throw err;
+                        conflicts.push(i.key);
+                    }
+                    continue;
+                }
+                const res = await ledgerCol.updateOne({ _id, seq: i.expectedSeq }, { $set: { pending, pendingAt: now }, $inc: { seq: 1 } });
+                if (res.matchedCount === 0)
+                    conflicts.push(i.key);
+            }
+            return conflicts;
+        },
+        async commitIntents(counterId, generation, keys) {
+            if (keys.length === 0)
+                return;
+            const ids = keys.map((k) => rowId(counterId, generation, k));
+            await ledgerCol.deleteMany({ _id: { $in: ids }, "pending.removed": true });
+            await ledgerCol.updateMany({ _id: { $in: ids }, pending: { $type: "object" } }, [
+                {
+                    $set: {
+                        scope: "$pending.scope",
+                        at: "$pending.at",
+                        facts: "$pending.facts",
+                        track: "$pending.track",
+                    },
+                },
+                { $unset: ["pending", "pendingAt"] },
+            ]);
+        },
+        async stalePending(olderThan) {
+            await ensureIndexes();
+            const ids = await ledgerCol.distinct("counterId", {
+                pendingAt: { $lt: olderThan.toISOString() },
+            });
+            return ids.map(String);
+        },
+        async dropGenerations(counterId, belowGeneration) {
+            const filter = belowGeneration === undefined ? { counterId } : { counterId, generation: { $lt: belowGeneration } };
+            await ledgerCol.deleteMany(filter);
+            await pairsCol.deleteMany(filter);
+        },
+        async touchPair(row) {
+            await ensureIndexes();
+            const { firstSeenAt, ...rest } = row;
+            try {
+                const res = await pairsCol.updateOne({ _id: row.scope }, { $min: { firstSeenAt }, $setOnInsert: rest }, { upsert: true });
+                return res.upsertedCount > 0;
+            }
+            catch (err) {
+                if (isDuplicateKey(err))
+                    return false;
+                throw err;
+            }
+        },
+        async listPairs(counterId, generation, limit) {
+            await ensureIndexes();
+            const docs = await pairsCol
+                .find({ counterId, generation })
+                .sort({ firstSeenAt: -1, _id: -1 })
+                .limit(limit)
+                .toArray();
+            return docs.map((d) => strip(d));
+        },
+    };
+}
+export function mongoAnalyticsStateFactory(dbFor) {
+    const cache = new Map();
+    return (orgId) => {
+        let s = cache.get(orgId);
+        if (!s) {
+            s = createMongoAnalyticsState(dbFor(orgId));
+            cache.set(orgId, s);
+        }
+        return s;
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/analytics/state.js.map

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

package/dist/analytics/tracker.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Keeps registered counters current.
+ *
+ * Every write through the shared writer enqueues the touched subject. A reconcile reads the
+ * subject's current abstract projection, diffs it with the facts the ledger last counted,
+ * and emits only the -old / +new increments. Ledger rows stay pending until the Countex
+ * flush carrying their increments succeeds; a row left pending by a crashed process makes
+ * the counter rebuild, because Countex does not persist event ids across processes.
+ */
+import type { ListContentQuery, MemorixAbstractWriter, MemorixContentReader, MemorixContentWriter, QueryFilter } from "@x12i/memorix-data";
+import type { MemorixScope } from "../scope.js";
+import { type CounterCatalog } from "./definition.js";
+import { type AnalyticsCountex } from "./engine.js";
+import { type SubjectDatasource } from "./projector.js";
+import { type PropertyIndexStore } from "./index-store.js";
+import type { AnalyticsStateStore, CounterOrigin, CounterRecord } from "./state.js";
+/** Datasource service stamped on materialized records; writes carrying it are not counted. */
+export declare const ANALYTICS_DATASOURCE_SERVICE = "memorix-analytics";
+/** Built-in organization-wide census of current heads by data source. */
+export declare const DATASOURCES_COUNTER_ID = "@datasources";
+export type AnalyticsMetadataView = {
+    /** Raw `analytics` definitions visible to these agents (pack analytics[] items). */
+    analytics(): unknown[];
+    catalog: CounterCatalog;
+    /** Concrete members (objectType + contentType) of an abstract type. */
+    members(abstractType: string): Array<{
+        objectType: string;
+        contentType: string;
+    }>;
+    objectTypeName(objectType: string): string | null;
+    dataCategoryOf(objectType: string): "entity" | "event" | "knowledge";
+};
+export type HeadCollection = {
+    key: string;
+    objectType: string;
+    contentType: string;
+};
+export type HeadRow = {
+    id: string;
+    recordId: string;
+    datasource: SubjectDatasource | null;
+};
+/** Enumerates stored heads for the one-time `@datasources` backfill. */
+export type HeadSource = {
+    collections(orgId: string): Promise<HeadCollection[]>;
+    page(orgId: string, key: string, afterId: string | null, limit: number): Promise<HeadRow[]>;
+};
+export type WriteEvent = {
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    datasourceService?: string;
+};
+export type AnalyticsTrackerOptions = {
+    engine: AnalyticsCountex;
+    stateFor(orgId: string): AnalyticsStateStore;
+    metadataFor(agentIds: string[]): AnalyticsMetadataView;
+    portsFor(scope: MemorixScope): {
+        reader: MemorixContentReader;
+        writer: MemorixContentWriter;
+    };
+    /** Property indexes. Defaults to an in-memory store per org (tests). Mongo passes its own. */
+    indexesFor?(orgId: string): PropertyIndexStore;
+    /** Deletes Countex cells whose scope starts with the prefix (rebuild / unregister). */
+    dropCells?(orgId: string, scopePrefix: string): Promise<void>;
+    heads?: HeadSource | null;
+    /** Disable the built-in `@datasources` census. */
+    datasources?: boolean;
+    debounceMs?: number;
+    batchMs?: number;
+    pendingStaleMs?: number;
+    backfillPageSize?: number;
+    refreshMs?: number;
+    now?: () => Date;
+    log?: (message: string, extra?: Record<string, unknown>) => void;
+};
+export type SourceCensusKind = {
+    kind: string;
+    label: string;
+    count: number;
+};
+export type SourceCensusSystem = {
+    system: string;
+    name: string;
+    total: number;
+    kinds: SourceCensusKind[];
+};
+export type SourceCensusPayload = {
+    ok: true;
+    censusId: string | null;
+    timestamp: string;
+    status: "live" | "backfilling" | "error" | "disabled";
+    subjects: SourceCensusSystem[];
+    heads: SourceCensusSystem[];
+};
+export type MaterializeResult = {
+    materialized: boolean;
+    recordId: string | null;
+    historyRecordId: string | null;
+    status: CounterRecord["status"] | "missing";
+};
+/** Attribution order: `sources[0]`, then the declared `origin`, then the writing `service`. */
+export declare function datasourceOfRecord(record: unknown): SubjectDatasource | null;
+export declare class AnalyticsTracker {
+    private readonly o;
+    private readonly orgs;
+    private readonly orgInit;
+    private readonly queue;
+    private drainTimer;
+    private chain;
+    private readonly dirty;
+    private readonly backfills;
+    private readonly inflight;
+    private readonly memoryIndexes;
+    private readonly indexes;
+    private closed;
+    constructor(options: AnalyticsTrackerOptions);
+    private indexStore;
+    private now;
+    private log;
+    private track;
+    private serial;
+    private counters;
+    private reload;
+    /** Loads the org registry so target content types are readable before a content request. */
+    prepare(orgId: string): Promise<void>;
+    private syncGrants;
+    private ensureOrg;
+    private initOrg;
+    private recoverPending;
+    /** Called by the writer decorator after every successful write or remove. */
+    onWrite(scope: MemorixScope, event: WriteEvent): void;
+    private fanOut;
+    private taskKey;
+    private enqueue;
+    private scheduleDrain;
+    private drain;
+    private retry;
+    private applyEntries;
+    private subjectEntry;
+    private loadSubject;
+    private toSubject;
+    private processAbstract;
+    private subjectFromStored;
+    private loadContentSubject;
+    private processContent;
+    private headEntry;
+    private processHeads;
+    sourceCensus(scope: MemorixScope): Promise<SourceCensusPayload>;
+    /** Registers (or updates) the analytics[] items of the scope's installed packs. */
+    syncPack(scope: MemorixScope): Promise<void>;
+    validate(scope: MemorixScope, raw: unknown): import("./definition.js").CounterValidationIssue[];
+    register(scope: MemorixScope, raw: unknown, opts: {
+        origin: Exclude<CounterOrigin, "builtin">;
+        replace?: boolean;
+        registeredBy?: string | null;
+    }): Promise<CounterRecord>;
+    unregister(orgId: string, id: string, opts?: {
+        allowPack?: boolean;
+    }): Promise<boolean>;
+    /**
+     * Data-source stamps changed outside the writer (datasource backfill): rebuild the counters
+     * that count by `@datasource`, including the built-in census. Returns their ids.
+     */
+    datasourcesRestamped(orgId: string): Promise<string[]>;
+    rebuild(orgId: string, id: string): Promise<CounterRecord>;
+    private rebuildInternal;
+    /** A live index replaces the scan for counters of the same agent that read only its paths. */
+    private rebuildFromIndex;
+    private dropGeneration;
+    list(scope: MemorixScope): Promise<CounterRecord[]>;
+    get(scope: MemorixScope, id: string): Promise<CounterRecord | null>;
+    validateIndex(scope: MemorixScope, raw: unknown): import("./definition.js").CounterValidationIssue[];
+    registerIndex(scope: MemorixScope, raw: unknown, opts?: {
+        replace?: boolean;
+        registeredBy?: string | null;
+    }): Promise<import("./index-store.js").PropertyIndexRecord>;
+    listIndexes(scope: MemorixScope): Promise<import("./index-store.js").PropertyIndexRecord[]>;
+    getIndex(scope: MemorixScope, id: string): Promise<import("./index-store.js").PropertyIndexRecord | null>;
+    deleteIndex(scope: MemorixScope, id: string): Promise<boolean>;
+    countIndexed(scope: MemorixScope, query: {
+        objectType: string;
+        contentType: string;
+        filters?: QueryFilter[];
+    }): Promise<number | null>;
+    explainIndexed(scope: MemorixScope, query: {
+        objectType: string;
+        contentType: string;
+        filters?: QueryFilter[];
+    }): Promise<import("./index-store.js").IndexExplain | null>;
+    listFromIndex(scope: MemorixScope, query: ListContentQuery, reader: MemorixContentReader): Promise<import("@x12i/memorix-data").ListContentResult | null>;
+    private startBackfill;
+    private runBackfill;
+    private markDirty;
+    /**
+     * Materializes the counter now (pipeline step). With covering-scope values, that pair's
+     * history slot is rewritten as well as the current record.
+     */
+    materializeNow(scope: MemorixScope, id: string, scopeValues?: Record<string, unknown>): Promise<MaterializeResult>;
+    /** Publishes an all-`produced: false` body while the counter backfills. Never awaited: callers may hold the chain. */
+    private writePlaceholder;
+    private materialize;
+    private emptyLeaders;
+    private leaders;
+    private trends;
+    private writeRecord;
+    /** Resolves once queued reconciles, backfills, and debounced materializations have run. */
+    idle(timeoutMs?: number): Promise<void>;
+    close(): Promise<void>;
+}
+/** Wraps the shared content writer so every successful write reaches the tracker. */
+export declare function withAnalyticsTracking(writer: MemorixContentWriter, onWrite: (scope: MemorixScope, event: WriteEvent) => void): MemorixContentWriter;
+/** Abstract reverse-writes go through their own concrete writer; report them too. */
+export declare function withAbstractTracking(abstractWriter: MemorixAbstractWriter, onWrite: (scope: MemorixScope, event: WriteEvent) => void): MemorixAbstractWriter;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/analytics/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/analytics/tracker.ts"],"names":[],"mappings":"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"}