@objectstack/platform-objects 4.2.0 → 5.0.0

package/dist/index.mjs

@@ -5577,11 +5577,11 @@ var SysMetadataObject = ObjectSchema.create({
       required: false,
       defaultValue: 1
     }),
-    /** Content checksum for change detection */
+    /** Content checksum for change detection (e.g. `sha256:<64 hex>` = 71 chars) */
     checksum: Field.text({
       label: "Checksum",
       required: false,
-      maxLength: 64
+      maxLength: 71
     }),
     /** Origin of this metadata record */
     source: Field.select(["filesystem", "database", "api", "migration"], {
@@ -5648,7 +5648,7 @@ var SysMetadataHistoryObject = ObjectSchema.create({
   icon: "history",
   isSystem: true,
   managedBy: "system",
-  description: "Version history and audit trail for metadata changes",
+  description: "Durable event log of metadata overlay changes (per-org, append-only)",
   fields: {
     /** Primary Key (UUID) */
     id: Field.text({
@@ -5656,11 +5656,24 @@ var SysMetadataHistoryObject = ObjectSchema.create({
       required: true,
       readonly: true
     }),
-    /** Foreign key to sys_metadata.id */
-    metadata_id: Field.lookup("sys_metadata", {
-      label: "Metadata",
+    /** Per-org monotonic event sequence (durable cursor for replay). */
+    event_seq: Field.number({
+      label: "Event Seq",
       required: true,
-      readonly: true
+      readonly: true,
+      description: "Per-organization monotonic event log cursor."
+    }),
+    /**
+     * Parent `sys_metadata.id` at insertion time (plain text, no FK).
+     * Null for events whose parent row no longer exists (e.g. some
+     * delete records). Forensic only — joins should go through
+     * `(organization_id, type, name)`.
+     */
+    metadata_id: Field.text({
+      label: "Metadata ID",
+      required: false,
+      readonly: true,
+      maxLength: 64
     }),
     /** Machine name (denormalized for easier querying) */
     name: Field.text({
@@ -5678,7 +5691,7 @@ var SysMetadataHistoryObject = ObjectSchema.create({
       readonly: true,
       maxLength: 100
     }),
-    /** Version number at this snapshot */
+    /** Per-(org,type,name) lineage counter at this snapshot. */
     version: Field.number({
       label: "Version",
       required: true,
@@ -5690,33 +5703,47 @@ var SysMetadataHistoryObject = ObjectSchema.create({
       required: true,
       readonly: true
     }),
-    /** Historical metadata snapshot (JSON payload) */
+    /**
+     * Historical metadata snapshot (JSON payload).
+     * Null for `operation_type = 'delete'` — the row carries no body.
+     */
     metadata: Field.textarea({
       label: "Metadata",
-      required: true,
+      required: false,
       readonly: true,
-      description: "JSON-serialized metadata snapshot at this version"
+      description: "JSON-serialized metadata snapshot at this version (null for deletes)."
     }),
-    /** SHA-256 checksum of metadata content */
+    /** SHA-256 checksum of metadata content (null for deletes). */
     checksum: Field.text({
       label: "Checksum",
-      required: true,
+      required: false,
       readonly: true,
-      maxLength: 64
+      maxLength: 80
     }),
-    /** Checksum of the previous version */
+    /** Checksum of the previous version (null for the first event). */
     previous_checksum: Field.text({
       label: "Previous Checksum",
       required: false,
       readonly: true,
-      maxLength: 64
+      maxLength: 80
     }),
-    /** Human-readable description of changes */
+    /** Human-readable description of changes (= MetadataEvent.message). */
     change_note: Field.textarea({
       label: "Change Note",
       required: false,
       readonly: true,
-      description: "Description of what changed in this version"
+      description: "Description of what changed in this version."
+    }),
+    /**
+     * Producer of the event ('sys-metadata-repo', 'fs', 'studio',
+     * 'api', …). Defaults to 'sys-metadata-repo' on the canonical
+     * write path; preserved on history() reads as MetadataEvent.source.
+     */
+    source: Field.text({
+      label: "Source",
+      required: false,
+      readonly: true,
+      maxLength: 64
     }),
     /** Organization ID for multi-tenant isolation */
     organization_id: Field.lookup("sys_organization", {
@@ -5725,15 +5752,7 @@ var SysMetadataHistoryObject = ObjectSchema.create({
       readonly: true,
       description: "Organization for multi-tenant isolation."
     }),
-    /** Environment ID — null = platform-global, set = env-scoped */
-    project_id: Field.text({
-      label: "Environment ID",
-      required: false,
-      readonly: true,
-      maxLength: 255,
-      description: "Scopes this history entry to a specific environment."
-    }),
-    /** User who made this change */
+    /** User who made this change (= MetadataEvent.actor). */
     recorded_by: Field.lookup("sys_user", {
       label: "Recorded By",
       required: false,
@@ -5747,21 +5766,18 @@ var SysMetadataHistoryObject = ObjectSchema.create({
     })
   },
   indexes: [
-    { fields: ["metadata_id", "version"], unique: true },
-    { fields: ["metadata_id", "recorded_at"] },
+    { fields: ["organization_id", "event_seq"], unique: true },
+    { fields: ["organization_id", "type", "name", "version"], unique: true },
+    { fields: ["organization_id", "type", "name", "recorded_at"] },
     { fields: ["type", "name"] },
     { fields: ["recorded_at"] },
-    { fields: ["operation_type"] },
-    { fields: ["organization_id"] },
-    { fields: ["project_id"] }
+    { fields: ["operation_type"] }
   ],
   enable: {
     trackHistory: false,
-    // Don't track history of history records
     searchable: false,
     apiEnabled: true,
     apiMethods: ["get", "list"],
-    // Read-only via API
     trash: false
   }
 });