@objectstack/objectql 5.0.0 → 5.1.0

package/dist/index.d.mts

@@ -767,6 +767,15 @@ declare class SysMetadataRepository implements MetadataRepository {
      * callers (e.g. LayeredRepository) fall through to lower layers.
      */
     get(ref: MetaRef): Promise<MetadataItem | null>;
+    /**
+     * 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.
+     */
+    getByHash(ref: MetaRef, hash: string): Promise<MetadataItem | null>;
     put(ref: MetaRef, spec: unknown, opts: PutOptions): Promise<PutResult>;
     delete(ref: MetaRef, opts: DeleteOptions): Promise<DeleteResult>;
     list(filter: ListFilter): AsyncIterable<MetadataItemHeader>;

package/dist/index.d.ts

@@ -767,6 +767,15 @@ declare class SysMetadataRepository implements MetadataRepository {
      * callers (e.g. LayeredRepository) fall through to lower layers.
      */
     get(ref: MetaRef): Promise<MetadataItem | null>;
+    /**
+     * 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.
+     */
+    getByHash(ref: MetaRef, hash: string): Promise<MetadataItem | null>;
     put(ref: MetaRef, spec: unknown, opts: PutOptions): Promise<PutResult>;
     delete(ref: MetaRef, opts: DeleteOptions): Promise<DeleteResult>;
     list(filter: ListFilter): AsyncIterable<MetadataItemHeader>;

package/dist/index.js

@@ -717,6 +717,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);
@@ -749,7 +785,6 @@ var SysMetadataRepository = class {
         version,
         updated_at: now
       };
-      let parentId;
       if (existing) {
         const existingId = existing.id;
         if (existingId === void 0) {
@@ -757,22 +792,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,
@@ -861,7 +893,6 @@ var SysMetadataRepository = class {
         {
           id: this.uuid(),
           event_seq: eventSeq,
-          metadata_id: existingId,
           type: ref.type,
           name: ref.name,
           version,