@objectstack/objectql 5.0.0 → 5.1.0

package/dist/index.mjs

@@ -667,6 +667,42 @@ var SysMetadataRepository = class {
     if (!row) return null;
     return this.rowToItem(ref, row);
   }
+  /**
+   * Resolve a historical version by content hash (ADR-0009).
+   *
+   * Looks up `sys_metadata_history` by `(organization_id, type, name,
+   * checksum)`. Returns null if no row matches. `executionPinned` types
+   * are guaranteed to find their body here because history GC skips
+   * them.
+   */
+  async getByHash(ref, hash) {
+    this.assertOpen();
+    const full = this.fullRef(ref);
+    const row = await this.engine.findOne(this.historyTable, {
+      where: {
+        organization_id: this.organizationId,
+        type: full.type,
+        name: full.name,
+        checksum: hash
+      }
+    });
+    if (!row) return null;
+    const rawBody = row.metadata;
+    if (rawBody === null || rawBody === void 0) {
+      return null;
+    }
+    const body = typeof rawBody === "string" ? JSON.parse(rawBody) : rawBody;
+    return {
+      ref: { ...full, version: void 0 },
+      body,
+      hash,
+      parentHash: row.previous_checksum ?? null,
+      authoredBy: row.recorded_by ?? "unknown",
+      authoredAt: row.recorded_at ?? (/* @__PURE__ */ new Date(0)).toISOString(),
+      message: row.change_note ?? void 0,
+      seq: row.event_seq ?? 0
+    };
+  }
   async put(ref, spec, opts) {
     this.assertOpen();
     this.assertAllowed(ref.type);
@@ -699,7 +735,6 @@ var SysMetadataRepository = class {
         version,
         updated_at: now
       };
-      let parentId;
       if (existing) {
         const existingId = existing.id;
         if (existingId === void 0) {
@@ -707,22 +742,19 @@ var SysMetadataRepository = class {
             `SysMetadataRepository.put: existing row for ${ref.type}/${ref.name} has no id column`
           );
         }
-        parentId = existingId;
         await this.engine.update("sys_metadata", parentRowData, {
           where: { id: existingId },
           context: ctx
         });
       } else {
         parentRowData.created_at = now;
-        const inserted = await this.engine.insert("sys_metadata", parentRowData, { context: ctx });
-        parentId = inserted.id;
+        await this.engine.insert("sys_metadata", parentRowData, { context: ctx });
       }
       await this.engine.insert(
         this.historyTable,
         {
           id: this.uuid(),
           event_seq: eventSeq,
-          metadata_id: parentId,
           type: ref.type,
           name: ref.name,
           version,
@@ -811,7 +843,6 @@ var SysMetadataRepository = class {
         {
           id: this.uuid(),
           event_seq: eventSeq,
-          metadata_id: existingId,
           type: ref.type,
           name: ref.name,
           version,