@x12i/analytix-memorix 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { MemorixRuntimeStore, createMemorixRuntimeStoreFromEnv, ANALYTIX_MEMORIX_WRITE_DESCRIPTORS, } from "./memorix-runtime-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { MemorixRuntimeStore, createMemorixRuntimeStoreFromEnv, ANALYTIX_MEMORIX_WRITE_DESCRIPTORS, } from "./memorix-runtime-store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC"}

package/dist/memorix-runtime-store.d.ts

@@ -0,0 +1,30 @@
+import type { AnalytixRunResult } from "@x12i/analytix-contracts";
+import type { ExecutionRecord, RuntimeStore } from "@x12i/analytix";
+import { type MemorixWriterClient } from "@x12i/memorix-writer";
+/** IDs registered against the shared Memorix Catalox catalog — see scripts/register-descriptors.mjs */
+export declare const ANALYTIX_MEMORIX_WRITE_DESCRIPTORS: {
+    readonly resultCache: "analytix-result-cache-write";
+    readonly tierOutput: "analytix-tier-output-write";
+    readonly execution: "analytix-execution-write";
+};
+/**
+ * RuntimeStore backed by Memorix (descriptor-driven write layer over MongoDB) instead of a
+ * hand-rolled Mongo collection. Reads are served from an in-memory mirror that's populated as
+ * results are produced in this process — there is no cross-process hydration yet (see README).
+ */
+export declare class MemorixRuntimeStore implements RuntimeStore {
+    private writer;
+    private cacheMirror;
+    private tierMirror;
+    constructor(writer: MemorixWriterClient);
+    getCache(key: string): AnalytixRunResult | null;
+    setCache(key: string, result: AnalytixRunResult): void;
+    addExecution(record: ExecutionRecord): void;
+    listExecutions(): ExecutionRecord[];
+    private tierBucketKey;
+    getTierOutput(tierId: string, paramsKey: string): unknown | null;
+    getTierAnalyticOutput(tierId: string, paramsKey: string, analyticId: string): unknown | null;
+    setTierOutput(tierId: string, paramsKey: string, analyticId: string, output: unknown): void;
+}
+export declare function createMemorixRuntimeStoreFromEnv(): Promise<MemorixRuntimeStore>;
+//# sourceMappingURL=memorix-runtime-store.d.ts.map

package/dist/memorix-runtime-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-runtime-store.d.ts","sourceRoot":"","sources":["../src/memorix-runtime-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAkD,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhH,uGAAuG;AACvG,eAAO,MAAM,kCAAkC;;;;CAIrC,CAAC;AAMX;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IAI1C,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,UAAU,CAA8C;gBAE5C,MAAM,EAAE,mBAAmB;IAE/C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAI/C,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAUtD,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAS3C,cAAc,IAAI,eAAe,EAAE;IAMnC,OAAO,CAAC,aAAa;IAIrB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAIhE,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAK5F,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;CAY5F;AAED,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAWrF"}

package/dist/memorix-runtime-store.js

@@ -0,0 +1,83 @@
+import { createMemorixWriterFromEnv, writeMemorixRecord } from "@x12i/memorix-writer";
+/** IDs registered against the shared Memorix Catalox catalog — see scripts/register-descriptors.mjs */
+export const ANALYTIX_MEMORIX_WRITE_DESCRIPTORS = {
+    resultCache: "analytix-result-cache-write",
+    tierOutput: "analytix-tier-output-write",
+    execution: "analytix-execution-write",
+};
+function logWriteFailure(label, err) {
+    console.error(`[analytix-memorix] ${label} failed`, err instanceof Error ? err.message : err);
+}
+/**
+ * RuntimeStore backed by Memorix (descriptor-driven write layer over MongoDB) instead of a
+ * hand-rolled Mongo collection. Reads are served from an in-memory mirror that's populated as
+ * results are produced in this process — there is no cross-process hydration yet (see README).
+ */
+export class MemorixRuntimeStore {
+    writer;
+    cacheMirror = new Map();
+    tierMirror = new Map();
+    constructor(writer) {
+        this.writer = writer;
+    }
+    getCache(key) {
+        return this.cacheMirror.get(key) ?? null;
+    }
+    setCache(key, result) {
+        this.cacheMirror.set(key, result);
+        void writeMemorixRecord(this.writer, {
+            writeDescriptorId: ANALYTIX_MEMORIX_WRITE_DESCRIPTORS.resultCache,
+            operation: "upsert",
+            entityId: key,
+            input: { cacheKey: key, result },
+        }).catch((err) => logWriteFailure("result-cache write", err));
+    }
+    addExecution(record) {
+        void writeMemorixRecord(this.writer, {
+            writeDescriptorId: ANALYTIX_MEMORIX_WRITE_DESCRIPTORS.execution,
+            operation: "add",
+            eventId: `exec_${record.traceId}_${Date.now()}`,
+            input: { ...record },
+        }).catch((err) => logWriteFailure("execution write", err));
+    }
+    listExecutions() {
+        // Execution history lives in Memorix (memorix-events); querying it back is a read-path
+        // follow-up (see README) — not needed on the hot path today.
+        return [];
+    }
+    tierBucketKey(tierId, paramsKey) {
+        return `${tierId}:${paramsKey}`;
+    }
+    getTierOutput(tierId, paramsKey) {
+        return this.tierMirror.get(this.tierBucketKey(tierId, paramsKey)) ?? null;
+    }
+    getTierAnalyticOutput(tierId, paramsKey, analyticId) {
+        const bucket = this.tierMirror.get(this.tierBucketKey(tierId, paramsKey));
+        return bucket?.[analyticId] ?? null;
+    }
+    setTierOutput(tierId, paramsKey, analyticId, output) {
+        const bucketKey = this.tierBucketKey(tierId, paramsKey);
+        const bucket = this.tierMirror.get(bucketKey) ?? {};
+        bucket[analyticId] = output;
+        this.tierMirror.set(bucketKey, bucket);
+        void writeMemorixRecord(this.writer, {
+            writeDescriptorId: ANALYTIX_MEMORIX_WRITE_DESCRIPTORS.tierOutput,
+            operation: "upsert",
+            entityId: bucketKey,
+            input: { tierId, paramsKey, outputs: bucket },
+        }).catch((err) => logWriteFailure("tier-output write", err));
+    }
+}
+export async function createMemorixRuntimeStoreFromEnv() {
+    const { createCataloxFromEnv } = await import("@x12i/catalox/firebase");
+    const appId = process.env.CATALOX_APP_ID || "analytix";
+    const { catalox } = createCataloxFromEnv();
+    const bound = catalox.withContext({
+        appId,
+        actor: { type: "service", id: "analytix-server" },
+        superAdmin: true,
+    });
+    const writer = await createMemorixWriterFromEnv({ appId, catalox: bound });
+    return new MemorixRuntimeStore(writer);
+}
+//# sourceMappingURL=memorix-runtime-store.js.map

package/dist/memorix-runtime-store.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@x12i/analytix-memorix",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@x12i/catalox": "^5.10.1",
+    "@x12i/memorix-writer": "^1.7.0",
+    "@x12i/analytix": "^1.0.0",
+    "@x12i/analytix-contracts": "^1.0.0"
+  },
+  "devDependencies": {
+    "@x12i/memorix-descriptors": "^1.16.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}