@x12i/memorix-writer 1.7.0 → 1.8.0

package/catalox-seeds/memorix-write-descriptors.manifest.json

@@ -85,42 +85,258 @@
     }
   ],
   "items": [
+    {
+      "catalogId": "memorix-write-descriptors",
+      "data": {
+        "operations": {
+          "default": "add",
+          "allowed": [
+            "add"
+          ]
+        },
+        "identity": {
+          "idField": "eventId"
+        },
+        "id": "analytix-execution-write",
+        "title": "Write Analytix Execution Record",
+        "fields": {
+          "traceId": {
+            "inputPath": "traceId",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.traceId"
+            }
+          },
+          "analyticId": {
+            "inputPath": "analyticId",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.analyticId"
+            }
+          },
+          "cacheKey": {
+            "inputPath": "cacheKey",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.cacheKey"
+            }
+          },
+          "analyticType": {
+            "inputPath": "analyticType",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.analyticType"
+            }
+          },
+          "cacheHit": {
+            "inputPath": "cacheHit",
+            "valueType": "boolean",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.cacheHit"
+            }
+          },
+          "startedAt": {
+            "inputPath": "startedAt",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.startedAt"
+            }
+          },
+          "durationMs": {
+            "inputPath": "durationMs",
+            "valueType": "number",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.durationMs"
+            }
+          },
+          "finishedAt": {
+            "inputPath": "finishedAt",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.finishedAt"
+            }
+          }
+        },
+        "entity": "analytix-execution",
+        "return": {
+          "defaultMode": "summary"
+        },
+        "validation": {
+          "rejectUnknownFields": true
+        },
+        "target": {
+          "contentType": "execution"
+        }
+      }
+    },
+    {
+      "catalogId": "memorix-write-descriptors",
+      "data": {
+        "operations": {
+          "default": "upsert",
+          "allowed": [
+            "upsert"
+          ]
+        },
+        "identity": {
+          "idField": "entityId"
+        },
+        "id": "analytix-result-cache-write",
+        "title": "Write Analytix Result Cache",
+        "fields": {
+          "result": {
+            "inputPath": "result",
+            "valueType": "object",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.result"
+            }
+          },
+          "cacheKey": {
+            "inputPath": "cacheKey",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.cacheKey"
+            }
+          }
+        },
+        "entity": "analytix-cache",
+        "return": {
+          "defaultMode": "summary"
+        },
+        "validation": {
+          "rejectUnknownFields": true
+        },
+        "target": {
+          "contentType": "result-cache"
+        }
+      }
+    },
+    {
+      "catalogId": "memorix-write-descriptors",
+      "data": {
+        "operations": {
+          "default": "upsert",
+          "allowed": [
+            "upsert"
+          ]
+        },
+        "identity": {
+          "idField": "entityId"
+        },
+        "id": "analytix-tier-output-write",
+        "title": "Write Analytix Tier Output",
+        "fields": {
+          "outputs": {
+            "inputPath": "outputs",
+            "valueType": "object",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.outputs"
+            }
+          },
+          "tierId": {
+            "inputPath": "tierId",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.tierId"
+            }
+          },
+          "paramsKey": {
+            "inputPath": "paramsKey",
+            "valueType": "string",
+            "required": true,
+            "writable": true,
+            "target": {
+              "path": "data.paramsKey"
+            }
+          }
+        },
+        "entity": "analytix-cache",
+        "return": {
+          "defaultMode": "summary"
+        },
+        "validation": {
+          "rejectUnknownFields": true
+        },
+        "target": {
+          "contentType": "tier-output"
+        }
+      }
+    },
     {
       "catalogId": "memorix-write-descriptors",
       "data": {
         "id": "asset-analysis-write",
         "entity": "assets",
         "title": "Write Asset Analysis",
-        "target": { "contentType": "analysis" },
+        "target": {
+          "contentType": "analysis"
+        },
         "identity": {
           "idField": "entityId",
           "requireExistingCanonical": true
         },
         "operations": {
-          "allowed": ["add"],
+          "allowed": [
+            "add"
+          ],
           "default": "add"
         },
         "fields": {
           "riskLevel": {
             "label": "Risk Level",
             "inputPath": "riskLevel",
-            "target": { "path": "data.riskLevel" },
+            "target": {
+              "path": "data.riskLevel"
+            },
             "required": true,
             "writable": true,
             "valueType": "enum",
-            "enumValues": ["LOW", "MEDIUM", "HIGH", "CRITICAL"]
+            "enumValues": [
+              "LOW",
+              "MEDIUM",
+              "HIGH",
+              "CRITICAL"
+            ]
           },
           "summary": {
             "label": "Summary",
             "inputPath": "summary",
-            "target": { "path": "data.summary" },
+            "target": {
+              "path": "data.summary"
+            },
             "writable": true,
             "valueType": "string"
           },
           "investigationReport": {
             "label": "Investigation Report",
             "inputPath": "investigationReport",
-            "target": { "path": "data.investigationReport" },
+            "target": {
+              "path": "data.investigationReport"
+            },
             "writable": true,
             "valueType": "content",
             "content": {
@@ -144,7 +360,9 @@
         },
         "content": {
           "allowed": true,
-          "allowedFields": ["investigationReport"],
+          "allowedFields": [
+            "investigationReport"
+          ],
           "generatePreview": true,
           "previewMaxChars": 500,
           "computeMetadata": true,
@@ -159,6 +377,83 @@
         }
       }
     },
+    {
+      "catalogId": "memorix-write-descriptors",
+      "data": {
+        "id": "content-documents-chunk-write",
+        "entity": "content-documents",
+        "title": "Write Content Document Chunk",
+        "target": {
+          "kind": "knowledge",
+          "contentType": "chunks"
+        },
+        "identity": {
+          "idField": "knowledgeId",
+          "requireExistingCanonical": false
+        },
+        "operations": {
+          "allowed": [
+            "add"
+          ],
+          "default": "add"
+        },
+        "fields": {
+          "text": {
+            "label": "Chunk text",
+            "inputPath": "text",
+            "target": {
+              "path": "data.text"
+            },
+            "required": true,
+            "writable": true,
+            "valueType": "string"
+          },
+          "sectionTitle": {
+            "label": "Section title",
+            "inputPath": "sectionTitle",
+            "target": {
+              "path": "data.sectionTitle"
+            },
+            "writable": true,
+            "valueType": "string"
+          },
+          "tokenCount": {
+            "label": "Token count",
+            "inputPath": "tokenCount",
+            "target": {
+              "path": "data.tokenCount"
+            },
+            "writable": true,
+            "valueType": "number"
+          },
+          "chunkIndex": {
+            "label": "Chunk index",
+            "inputPath": "chunkIndex",
+            "target": {
+              "path": "provenance.chunkIndex"
+            },
+            "writable": true,
+            "valueType": "number"
+          },
+          "contentHash": {
+            "label": "Parent content hash",
+            "inputPath": "contentHash",
+            "target": {
+              "path": "parent.contentHash"
+            },
+            "writable": true,
+            "valueType": "string"
+          }
+        },
+        "validation": {
+          "rejectUnknownFields": true,
+          "requireAtLeastOneWritableField": true
+        },
+        "return": {
+          "defaultMode": "summary"
+        }
+      }
+    },
     {
       "catalogId": "memorix-write-descriptors",
       "data": {
@@ -174,63 +469,82 @@
           "requireExistingCanonical": false
         },
         "operations": {
-          "allowed": ["add", "upsert"],
+          "allowed": [
+            "add",
+            "upsert"
+          ],
           "default": "upsert"
         },
         "fields": {
           "title": {
             "label": "Title",
             "inputPath": "title",
-            "target": { "path": "data.title" },
+            "target": {
+              "path": "data.title"
+            },
             "writable": true,
             "valueType": "string"
           },
           "summary": {
             "label": "Summary",
             "inputPath": "summary",
-            "target": { "path": "data.summary" },
+            "target": {
+              "path": "data.summary"
+            },
             "writable": true,
             "valueType": "string"
           },
           "language": {
             "label": "Language",
             "inputPath": "language",
-            "target": { "path": "data.language" },
+            "target": {
+              "path": "data.language"
+            },
             "writable": true,
             "valueType": "string"
           },
           "sourceKind": {
             "label": "Source kind",
             "inputPath": "sourceKind",
-            "target": { "path": "source.kind" },
+            "target": {
+              "path": "source.kind"
+            },
             "writable": true,
             "valueType": "string"
           },
           "sourceUri": {
             "label": "Source URI",
             "inputPath": "sourceUri",
-            "target": { "path": "source.uri" },
+            "target": {
+              "path": "source.uri"
+            },
             "writable": true,
             "valueType": "string"
           },
           "canonicalUri": {
             "label": "Canonical URI",
             "inputPath": "canonicalUri",
-            "target": { "path": "source.canonicalUri" },
+            "target": {
+              "path": "source.canonicalUri"
+            },
             "writable": true,
             "valueType": "string"
           },
           "contentHash": {
             "label": "Content hash",
             "inputPath": "contentHash",
-            "target": { "path": "provenance.contentHash" },
+            "target": {
+              "path": "provenance.contentHash"
+            },
             "writable": true,
             "valueType": "string"
           },
           "cleanMarkdown": {
             "label": "Clean Markdown",
             "inputPath": "cleanMarkdown",
-            "target": { "path": "content.cleanMarkdown" },
+            "target": {
+              "path": "content.cleanMarkdown"
+            },
             "writable": true,
             "valueType": "content",
             "content": {
@@ -254,7 +568,9 @@
         },
         "content": {
           "allowed": true,
-          "allowedFields": ["cleanMarkdown"],
+          "allowedFields": [
+            "cleanMarkdown"
+          ],
           "generatePreview": true,
           "previewMaxChars": 500,
           "computeMetadata": true,
@@ -268,71 +584,6 @@
           "defaultMode": "summary"
         }
       }
-    },
-    {
-      "catalogId": "memorix-write-descriptors",
-      "data": {
-        "id": "content-documents-chunk-write",
-        "entity": "content-documents",
-        "title": "Write Content Document Chunk",
-        "target": {
-          "kind": "knowledge",
-          "contentType": "chunks"
-        },
-        "identity": {
-          "idField": "knowledgeId",
-          "requireExistingCanonical": false
-        },
-        "operations": {
-          "allowed": ["add"],
-          "default": "add"
-        },
-        "fields": {
-          "text": {
-            "label": "Chunk text",
-            "inputPath": "text",
-            "target": { "path": "data.text" },
-            "required": true,
-            "writable": true,
-            "valueType": "string"
-          },
-          "sectionTitle": {
-            "label": "Section title",
-            "inputPath": "sectionTitle",
-            "target": { "path": "data.sectionTitle" },
-            "writable": true,
-            "valueType": "string"
-          },
-          "tokenCount": {
-            "label": "Token count",
-            "inputPath": "tokenCount",
-            "target": { "path": "data.tokenCount" },
-            "writable": true,
-            "valueType": "number"
-          },
-          "chunkIndex": {
-            "label": "Chunk index",
-            "inputPath": "chunkIndex",
-            "target": { "path": "provenance.chunkIndex" },
-            "writable": true,
-            "valueType": "number"
-          },
-          "contentHash": {
-            "label": "Parent content hash",
-            "inputPath": "contentHash",
-            "target": { "path": "parent.contentHash" },
-            "writable": true,
-            "valueType": "string"
-          }
-        },
-        "validation": {
-          "rejectUnknownFields": true,
-          "requireAtLeastOneWritableField": true
-        },
-        "return": {
-          "defaultMode": "summary"
-        }
-      }
     }
   ]
 }

package/dist/constants.d.ts

@@ -3,11 +3,11 @@ export declare const DEFAULT_MEMORIX_APP_ID = "memorix";
 export declare const MEMORIX_WRITE_DESCRIPTORS_CATALOG_ID = "memorix-write-descriptors";
 export declare const DEFAULT_CANONICAL_CONTENT_TYPE = "snapshots";
 export declare const DEFAULT_DATA_ROOT = "data";
-export declare const DEFAULT_EFFECTIVE_DATE_PATH = "modifiedAt";
+export declare const DEFAULT_EFFECTIVE_DATE_PATH = "lifecycle.modifiedAt";
 export declare const DEFAULT_CONTENT_MAX_BYTES: number;
-export declare const DEFAULT_MEMORIX_METADATA_PATH = "_memorix";
-export declare const DEFAULT_AUDIT_PATH = "_memorix.audit";
-export declare const DEFAULT_IDEMPOTENCY_KEY_PATH = "_memorix.idempotencyKey";
-export declare const DEFAULT_PAYLOAD_HASH_PATH = "_memorix.payloadHash";
+export declare const DEFAULT_MEMORIX_METADATA_PATH = "_system.memorix";
+export declare const DEFAULT_AUDIT_PATH = "_system.memorix.audit";
+export declare const DEFAULT_IDEMPOTENCY_KEY_PATH = "_system.memorix.idempotencyKey";
+export declare const DEFAULT_PAYLOAD_HASH_PATH = "_system.memorix.payloadHash";
 export declare const DEFAULT_CONTENT_KEY_TEMPLATE = "{{entity}}/{{contentType}}/{{id}}/{{recordId}}/{{field}}.md";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,eAAO,MAAM,oCAAoC,8BAA8B,CAAC;AAEhF,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,iBAAiB,SAAS,CAAC;AACxC,eAAO,MAAM,2BAA2B,eAAe,CAAC;AACxD,eAAO,MAAM,yBAAyB,QAAkB,CAAC;AACzD,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE,eAAO,MAAM,4BAA4B,gEACsB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,eAAO,MAAM,oCAAoC,8BAA8B,CAAC;AAEhF,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,iBAAiB,SAAS,CAAC;AACxC,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,yBAAyB,QAAkB,CAAC;AACzD,eAAO,MAAM,6BAA6B,oBAAoB,CAAC;AAC/D,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAC1D,eAAO,MAAM,4BAA4B,mCAAmC,CAAC;AAC7E,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE,eAAO,MAAM,4BAA4B,gEACsB,CAAC"}

package/dist/constants.js

@@ -3,11 +3,11 @@ export const DEFAULT_MEMORIX_APP_ID = "memorix";
 export const MEMORIX_WRITE_DESCRIPTORS_CATALOG_ID = "memorix-write-descriptors";
 export const DEFAULT_CANONICAL_CONTENT_TYPE = "snapshots";
 export const DEFAULT_DATA_ROOT = "data";
-export const DEFAULT_EFFECTIVE_DATE_PATH = "modifiedAt";
+export const DEFAULT_EFFECTIVE_DATE_PATH = "lifecycle.modifiedAt";
 export const DEFAULT_CONTENT_MAX_BYTES = 5 * 1024 * 1024;
-export const DEFAULT_MEMORIX_METADATA_PATH = "_memorix";
-export const DEFAULT_AUDIT_PATH = "_memorix.audit";
-export const DEFAULT_IDEMPOTENCY_KEY_PATH = "_memorix.idempotencyKey";
-export const DEFAULT_PAYLOAD_HASH_PATH = "_memorix.payloadHash";
+export const DEFAULT_MEMORIX_METADATA_PATH = "_system.memorix";
+export const DEFAULT_AUDIT_PATH = "_system.memorix.audit";
+export const DEFAULT_IDEMPOTENCY_KEY_PATH = "_system.memorix.idempotencyKey";
+export const DEFAULT_PAYLOAD_HASH_PATH = "_system.memorix.payloadHash";
 export const DEFAULT_CONTENT_KEY_TEMPLATE = "{{entity}}/{{contentType}}/{{id}}/{{recordId}}/{{field}}.md";
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAEhF,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAW,CAAC;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CAAC;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE,MAAM,CAAC,MAAM,4BAA4B,GACvC,6DAA6D,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC;AAEhD,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAEhF,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAW,CAAC;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAAsB,CAAC;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,iBAAiB,CAAC;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,gCAAgC,CAAC;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAEvE,MAAM,CAAC,MAAM,4BAA4B,GACvC,6DAA6D,CAAC"}

package/dist/data/record-lookup.d.ts

@@ -0,0 +1,27 @@
+import type { MemorixRecordRef } from "@x12i/memorix-descriptors/types";
+import type { MemorixTarget } from "../mongo/target.js";
+import type { MemorixWriteAdapter } from "./memorix-write-adapter.js";
+/** Mirrors read-side priority in `@x12i/memorix-retrieval` `resolveMemorixRecordIdentity`. */
+export type RecordLookupCandidate = {
+    idField: string;
+    filter: Record<string, unknown>;
+};
+/**
+ * Ordered identity probes for locating a Memorix record by a caller-supplied id value.
+ * Tries nested `memorix-record.2.0` fields first, then legacy flat ids, then `_id`.
+ */
+export declare function buildIdentityValueLookupCandidates(target: MemorixTarget, idValue: string): RecordLookupCandidate[];
+export declare function buildRecordRefLookupCandidates(ref: Pick<MemorixRecordRef, "target" | "recordId">): RecordLookupCandidate[];
+export declare function buildRecordRefLookupFilter(ref: Pick<MemorixRecordRef, "target" | "recordId">): Record<string, unknown>;
+export declare function buildPersistencyResultLookupFilter(target: MemorixTarget, identityId: string, recordId: string): Record<string, unknown>;
+export type FindRecordByLookupResult = {
+    doc: Record<string, unknown>;
+    matched: RecordLookupCandidate;
+};
+export declare function findRecordByLookupCandidates(adapter: MemorixWriteAdapter, collection: string, candidates: RecordLookupCandidate[], opts?: {
+    session?: import("mongodb").ClientSession;
+}): Promise<FindRecordByLookupResult | null>;
+export declare function findRecordByRef(adapter: MemorixWriteAdapter, collection: string, ref: Pick<MemorixRecordRef, "target" | "recordId">, opts?: {
+    session?: import("mongodb").ClientSession;
+}): Promise<FindRecordByLookupResult | null>;
+//# sourceMappingURL=record-lookup.d.ts.map

package/dist/data/record-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-lookup.d.ts","sourceRoot":"","sources":["../../src/data/record-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,8FAA8F;AAC9F,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAsBF;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CASzB;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,UAAU,CAAC,GACjD,qBAAqB,EAAE,CAEzB;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,UAAU,CAAC,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,qBAAqB,CAAC;CAChC,CAAC;AAEF,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,qBAAqB,EAAE,EACnC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,aAAa,CAAA;CAAE,GACnD,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAM1C;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,UAAU,CAAC,EAClD,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,aAAa,CAAA;CAAE,GACnD,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAO1C"}

package/dist/data/record-lookup.js

@@ -0,0 +1,66 @@
+import { maybeObjectId } from "../mongo/id-normalize.js";
+function flatIdFieldForTarget(target) {
+    if (target === "event")
+        return "eventId";
+    if (target === "knowledge")
+        return "knowledgeId";
+    return "entityId";
+}
+function dedupeCandidates(candidates) {
+    const seen = new Set();
+    const out = [];
+    for (const candidate of candidates) {
+        const key = JSON.stringify(candidate.filter);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(candidate);
+    }
+    return out;
+}
+/**
+ * Ordered identity probes for locating a Memorix record by a caller-supplied id value.
+ * Tries nested `memorix-record.2.0` fields first, then legacy flat ids, then `_id`.
+ */
+export function buildIdentityValueLookupCandidates(target, idValue) {
+    const flatField = flatIdFieldForTarget(target);
+    return dedupeCandidates([
+        { idField: "identity.recordId", filter: { "identity.recordId": idValue } },
+        { idField: "identity.targetId", filter: { "identity.targetId": idValue } },
+        { idField: flatField, filter: { [flatField]: idValue } },
+        { idField: "id", filter: { id: idValue } },
+        { idField: "_id", filter: { _id: maybeObjectId(idValue) } },
+    ]);
+}
+export function buildRecordRefLookupCandidates(ref) {
+    return buildIdentityValueLookupCandidates(ref.target, ref.recordId);
+}
+export function buildRecordRefLookupFilter(ref) {
+    const candidates = buildRecordRefLookupCandidates(ref);
+    if (candidates.length === 1)
+        return candidates[0].filter;
+    return { $or: candidates.map((candidate) => candidate.filter) };
+}
+export function buildPersistencyResultLookupFilter(target, identityId, recordId) {
+    const candidates = dedupeCandidates([
+        ...buildIdentityValueLookupCandidates(target, recordId),
+        ...(recordId === identityId
+            ? []
+            : buildIdentityValueLookupCandidates(target, identityId)),
+    ]);
+    if (candidates.length === 1)
+        return candidates[0].filter;
+    return { $or: candidates.map((candidate) => candidate.filter) };
+}
+export async function findRecordByLookupCandidates(adapter, collection, candidates, opts) {
+    for (const candidate of candidates) {
+        const doc = await adapter.findOne(collection, candidate.filter, opts);
+        if (doc)
+            return { doc, matched: candidate };
+    }
+    return null;
+}
+export async function findRecordByRef(adapter, collection, ref, opts) {
+    return findRecordByLookupCandidates(adapter, collection, buildRecordRefLookupCandidates(ref), opts);
+}
+//# sourceMappingURL=record-lookup.js.map