@dxos/migrations 0.8.4-main.fffef41 → 0.9.0

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"src/migration-builder.ts":{"bytes":22035,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-db","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/migrations.ts":{"bytes":9709,"imports":[{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"}],"format":"esm"},"src/index.ts":{"bytes":653,"imports":[{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"},{"path":"src/migrations.ts","kind":"import-statement","original":"./migrations"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15612},"dist/lib/browser/index.mjs":{"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-db","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"exports":["MigrationBuilder","Migrations"],"entryPoint":"src/index.ts","inputs":{"src/migration-builder.ts":{"bytesInOutput":4851},"src/index.ts":{"bytesInOutput":0},"src/migrations.ts":{"bytesInOutput":2727}},"bytes":7708}}}
+{"inputs":{"src/annotations.ts":{"bytes":1241,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true}],"format":"esm"},"src/migration-builder.ts":{"bytes":28104,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo-client/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo/Type","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true}],"format":"esm"},"src/document-compaction.ts":{"bytes":4389,"imports":[{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"}],"format":"esm"},"src/migrations.ts":{"bytes":11492,"imports":[{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@effect-atom/atom/Registry","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/annotations.ts","kind":"import-statement","original":"./annotations"},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"}],"format":"esm"},"src/index.ts":{"bytes":789,"imports":[{"path":"src/annotations.ts","kind":"import-statement","original":"./annotations"},{"path":"src/document-compaction.ts","kind":"import-statement","original":"./document-compaction"},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"},{"path":"src/migrations.ts","kind":"import-statement","original":"./migrations"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":21776},"dist/lib/browser/index.mjs":{"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo-client/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo/Type","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@effect-atom/atom/Registry","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"exports":["MigrationBuilder","MigrationVersionAnnotation","Migrations","compactDocumentsEpochMigration"],"entryPoint":"src/index.ts","inputs":{"src/annotations.ts":{"bytesInOutput":198},"src/index.ts":{"bytesInOutput":0},"src/document-compaction.ts":{"bytesInOutput":936},"src/migration-builder.ts":{"bytesInOutput":7116},"src/migrations.ts":{"bytesInOutput":2999}},"bytes":11528}}}

package/dist/lib/node-esm/index.mjs

@@ -1,26 +1,42 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 
+// src/annotations.ts
+import * as Schema from "effect/Schema";
+import { Annotation } from "@dxos/echo";
+var MigrationVersionAnnotation = Annotation.make({
+  id: "org.dxos.migrations.version",
+  schema: Schema.String
+});
+
+// src/document-compaction.ts
+import { SpaceState } from "@dxos/client/echo";
+import { invariant as invariant2 } from "@dxos/invariant";
+
 // src/migration-builder.ts
-import { next as A } from "@automerge/automerge";
+import { next as A, toJS } from "@automerge/automerge";
 import { CreateEpochRequest } from "@dxos/client/halo";
-import { requireTypeReference } from "@dxos/echo/internal";
-import { ObjectCore, migrateDocument } from "@dxos/echo-db";
-import { Reference, SpaceDocVersion, encodeReference } from "@dxos/echo-protocol";
+import { ObjectCore, migrateDocument } from "@dxos/echo-client/internal";
+import { EncodedReference, SpaceDocVersion } from "@dxos/echo-protocol";
+import { getSchemaURI } from "@dxos/echo/internal";
+import * as Type from "@dxos/echo/Type";
 import { invariant } from "@dxos/invariant";
+import { EID, EntityId } from "@dxos/keys";
 var __dxlog_file = "/__w/dxos/dxos/packages/sdk/migrations/src/migration-builder.ts";
 var MigrationBuilder = class {
   _space;
   _repo;
   _rootDoc;
-  // echoId -> automergeUrl
+  // echoUri -> automergeUrl
   _newLinks = {};
   _flushIds = [];
   _deleteObjects = [];
   _newRoot = void 0;
   constructor(_space) {
     this._space = _space;
-    this._repo = this._space.db.coreDatabase._repo;
-    this._rootDoc = this._space.db.coreDatabase._automergeDocLoader.getSpaceRootDocHandle().doc();
+    this._repo = this._space.internal.db._repo;
+    const rootDoc = this._space.internal.db._getSpaceRootDocHandle().doc();
+    invariant(rootDoc, "Space root document must be available when creating MigrationBuilder", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 41, S: this, A: ["rootDoc", "'Space root document must be available when creating MigrationBuilder'"] });
+    this._rootDoc = rootDoc;
   }
   async findObject(id) {
     const documentId = (this._rootDoc.links?.[id] || this._newLinks[id])?.toString();
@@ -37,17 +53,10 @@ var MigrationBuilder = class {
     if (!objectStructure) {
       return;
     }
-    const { schema, props } = await migrate(objectStructure);
+    const { type, props } = await migrate(objectStructure);
+    const schema = Type.getSchema(type);
     const oldHandle = await this._findObjectContainingHandle(id);
-    invariant(oldHandle, void 0, {
-      F: __dxlog_file,
-      L: 84,
-      S: this,
-      A: [
-        "oldHandle",
-        ""
-      ]
-    });
+    invariant(oldHandle, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 62, S: this, A: ["oldHandle", ""] });
     const newState = {
       version: SpaceDocVersion.CURRENT,
       access: {
@@ -56,7 +65,7 @@ var MigrationBuilder = class {
       objects: {
         [id]: {
           system: {
-            type: encodeReference(requireTypeReference(schema))
+            type: EncodedReference.fromURI(getSchemaURI(schema))
           },
           data: props,
           meta: {
@@ -67,58 +76,78 @@ var MigrationBuilder = class {
     };
     const migratedDoc = migrateDocument(oldHandle.doc(), newState);
     const newHandle = this._repo.import(A.save(migratedDoc));
+    await newHandle.whenReady();
+    invariant(newHandle.url, "Migrated document URL not available after whenReady", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 83, S: this, A: ["newHandle.url", "'Migrated document URL not available after whenReady'"] });
     this._newLinks[id] = newHandle.url;
-    this._addHandleToFlushList(newHandle);
+    this._addHandleToFlushList(newHandle.documentId);
   }
-  async addObject(schema, props) {
-    const core = this._createObject({
-      schema,
+  async addObject(type, props) {
+    const resolved = Type.getSchema(type);
+    const core = await this._createObject({
+      schema: resolved,
       props
     });
     return core.id;
   }
   createReference(id) {
-    return encodeReference(Reference.localObjectReference(id));
+    invariant(EntityId.isValid(id), "Invalid EntityId.", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 96, S: this, A: ["EntityId.isValid(id)", "'Invalid EntityId.'"] });
+    return EncodedReference.fromURI(EID.make({
+      entityId: id
+    }));
   }
   deleteObject(id) {
     this._deleteObjects.push(id);
   }
-  changeProperties(changeFn) {
+  /**
+  * Re-materializes linked object documents into fresh Automerge docs without history.
+  * Call {@link _commit} to publish a new space epoch with updated root links.
+  */
+  async compactLinkedDocuments(objectIds) {
+    const linkIds = objectIds ?? Object.keys(this._rootDoc.links ?? {});
+    const compacted = [];
+    const skipped = [];
+    for (const id of linkIds) {
+      const oldHandle = await this._findObjectContainingHandle(id);
+      if (!oldHandle) {
+        skipped.push(id);
+        continue;
+      }
+      await oldHandle.whenReady();
+      const materialized = toJS(oldHandle.doc());
+      const newHandle = this._repo.create(materialized);
+      await newHandle.whenReady();
+      invariant(newHandle.url, "Compacted document URL not available after whenReady", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 121, S: this, A: ["newHandle.url", "'Compacted document URL not available after whenReady'"] });
+      this._newLinks[id] = newHandle.url;
+      this._addHandleToFlushList(newHandle.documentId);
+      compacted.push(id);
+    }
+    return {
+      compacted,
+      skipped
+    };
+  }
+  async changeProperties(changeFn) {
     if (!this._newRoot) {
-      this._buildNewRoot();
+      await this._buildNewRoot();
     }
-    invariant(this._newRoot, "New root not created", {
-      F: __dxlog_file,
-      L: 126,
-      S: this,
-      A: [
-        "this._newRoot",
-        "'New root not created'"
-      ]
-    });
+    invariant(this._newRoot, "New root not created", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 135, S: this, A: ["this._newRoot", "'New root not created'"] });
     this._newRoot.change((doc) => {
       const propertiesStructure = doc.objects?.[this._space.properties.id];
       propertiesStructure && changeFn(propertiesStructure);
     });
-    this._addHandleToFlushList(this._newRoot);
+    await this._newRoot.whenReady();
+    this._addHandleToFlushList(this._newRoot.documentId);
   }
   /**
   * @internal
   */
   async _commit() {
     if (!this._newRoot) {
-      this._buildNewRoot();
+      await this._buildNewRoot();
     }
-    invariant(this._newRoot, "New root not created", {
-      F: __dxlog_file,
-      L: 142,
-      S: this,
-      A: [
-        "this._newRoot",
-        "'New root not created'"
-      ]
-    });
+    invariant(this._newRoot, "New root not created", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 149, S: this, A: ["this._newRoot", "'New root not created'"] });
     await this._space.db.flush();
+    invariant(this._newRoot.url, "New root URL not available", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 152, S: this, A: ["this._newRoot.url", "'New root URL not available'"] });
     await this._space.internal.createEpoch({
       migration: CreateEpochRequest.Migration.REPLACE_AUTOMERGE_ROOT,
       automergeRootUrl: this._newRoot.url
@@ -133,7 +162,7 @@ var MigrationBuilder = class {
     await docHandle.whenReady();
     return docHandle;
   }
-  _buildNewRoot() {
+  async _buildNewRoot() {
     const links = {
       ...this._rootDoc.links ?? {}
     };
@@ -151,15 +180,16 @@ var MigrationBuilder = class {
       objects: this._rootDoc.objects,
       links
     });
-    this._addHandleToFlushList(this._newRoot);
+    await this._newRoot.whenReady();
+    this._addHandleToFlushList(this._newRoot.documentId);
   }
-  _createObject({ id, schema, props }) {
+  async _createObject({ id, schema, props }) {
     const core = new ObjectCore();
     if (id) {
       core.id = id;
     }
     core.initNewObject(props);
-    core.setType(requireTypeReference(schema));
+    core.setType(EncodedReference.fromURI(getSchemaURI(schema)));
     const newHandle = this._repo.create({
       version: SpaceDocVersion.CURRENT,
       access: {
@@ -169,25 +199,51 @@ var MigrationBuilder = class {
         [core.id]: core.getDoc()
       }
     });
+    await newHandle.whenReady();
     this._newLinks[core.id] = newHandle.url;
-    this._addHandleToFlushList(newHandle);
+    this._addHandleToFlushList(newHandle.documentId);
     return core;
   }
-  _addHandleToFlushList(handle) {
-    this._flushIds.push(handle.documentId);
+  _addHandleToFlushList(id) {
+    this._flushIds.push(id);
   }
 };
 
+// src/document-compaction.ts
+var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/migrations/src/document-compaction.ts";
+var compactDocumentsEpochMigration = async (space, options = {}) => {
+  invariant2(space.state.get() === SpaceState.SPACE_READY, "Space must be open and ready before compaction.", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 11, S: void 0, A: ["space.state.get() === SpaceState.SPACE_READY", "'Space must be open and ready before compaction.'"] });
+  const builder = new MigrationBuilder(space);
+  const { compacted, skipped } = await builder.compactLinkedDocuments(options.objectIds);
+  await builder._commit();
+  const epochs = await space.internal.getEpochs();
+  const lastEpoch = epochs[epochs.length - 1];
+  const epochNumber = lastEpoch?.subject.assertion.number ?? 0;
+  return {
+    compacted,
+    skipped,
+    epochNumber
+  };
+};
+
 // src/migrations.ts
-import { SpaceState, live } from "@dxos/client/echo";
-import { invariant as invariant2 } from "@dxos/invariant";
-var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/migrations/src/migrations.ts";
+import { Atom } from "@effect-atom/atom";
+import * as Registry from "@effect-atom/atom/Registry";
+import * as Option from "effect/Option";
+import { SpaceState as SpaceState2 } from "@dxos/client/echo";
+import { Annotation as Annotation2, Obj } from "@dxos/echo";
+import { invariant as invariant3 } from "@dxos/invariant";
+var __dxlog_file3 = "/__w/dxos/dxos/packages/sdk/migrations/src/migrations.ts";
 var Migrations = class {
   static namespace;
   static migrations = [];
-  static _state = live({
+  static _registry = Registry.make();
+  static _stateAtom = Atom.make({
     running: []
-  });
+  }).pipe(Atom.keepAlive);
+  /**
+  * @deprecated Use `MigrationVersionAnnotation` via `Annotation.get/set` on space properties.
+  */
   static get versionProperty() {
     return this.namespace && `${this.namespace}.version`;
   }
@@ -195,77 +251,59 @@ var Migrations = class {
     return this.migrations[this.migrations.length - 1]?.version;
   }
   static running(space) {
-    return this._state.running.includes(space.key.toHex());
+    const state = this._registry.get(this._stateAtom);
+    return state.running.includes(space.key.toHex());
   }
   static define(namespace, migrations) {
     this.namespace = namespace;
     this.migrations = migrations;
   }
   static async migrate(space, targetVersion) {
-    invariant2(!this.running(space), "Migration already running", {
-      F: __dxlog_file2,
-      L: 44,
-      S: this,
-      A: [
-        "!this.running(space)",
-        "'Migration already running'"
-      ]
-    });
-    invariant2(this.versionProperty, "Migrations namespace not set", {
-      F: __dxlog_file2,
-      L: 45,
-      S: this,
-      A: [
-        "this.versionProperty",
-        "'Migrations namespace not set'"
-      ]
-    });
-    invariant2(space.state.get() === SpaceState.SPACE_READY, "Space not ready", {
-      F: __dxlog_file2,
-      L: 46,
-      S: this,
-      A: [
-        "space.state.get() === SpaceState.SPACE_READY",
-        "'Space not ready'"
-      ]
-    });
-    const currentVersion = space.properties[this.versionProperty];
+    invariant3(!this.running(space), "Migration already running", { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 36, S: this, A: ["!this.running(space)", "'Migration already running'"] });
+    invariant3(space.state.get() === SpaceState2.SPACE_READY, "Space not ready", { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 37, S: this, A: ["space.state.get() === SpaceState.SPACE_READY", "'Space not ready'"] });
+    const currentVersion = Annotation2.get(space.properties, MigrationVersionAnnotation).pipe(Option.getOrUndefined);
     const currentIndex = this.migrations.findIndex((m) => m.version === currentVersion) + 1;
     const i = this.migrations.findIndex((m) => m.version === targetVersion);
     const targetIndex = i === -1 ? this.migrations.length : i + 1;
     if (currentIndex === targetIndex) {
       return false;
     }
-    this._state.running.push(space.key.toHex());
-    if (targetIndex > currentIndex) {
-      const migrations = this.migrations.slice(currentIndex, targetIndex);
-      for (const migration of migrations) {
-        const builder = new MigrationBuilder(space);
-        await migration.next({
-          space,
-          builder
-        });
-        builder.changeProperties((propertiesStructure) => {
-          invariant2(this.versionProperty, "Migrations namespace not set", {
-            F: __dxlog_file2,
-            L: 62,
-            S: this,
-            A: [
-              "this.versionProperty",
-              "'Migrations namespace not set'"
-            ]
+    const spaceKey = space.key.toHex();
+    const currentState = this._registry.get(this._stateAtom);
+    this._registry.set(this._stateAtom, {
+      running: [
+        ...currentState.running,
+        spaceKey
+      ]
+    });
+    try {
+      if (targetIndex > currentIndex) {
+        const migrations = this.migrations.slice(currentIndex, targetIndex);
+        for (const migration of migrations) {
+          const builder = new MigrationBuilder(space);
+          await migration.next({
+            space,
+            builder
+          });
+          await builder._commit();
+          Obj.update(space.properties, (properties) => {
+            Annotation2.set(properties, MigrationVersionAnnotation, migration.version);
           });
-          propertiesStructure.data[this.versionProperty] = migration.version;
-        });
-        await builder._commit();
+        }
       }
+    } finally {
+      const finalState = this._registry.get(this._stateAtom);
+      this._registry.set(this._stateAtom, {
+        running: finalState.running.filter((key) => key !== spaceKey)
+      });
     }
-    this._state.running.splice(this._state.running.indexOf(space.key.toHex()), 1);
     return true;
   }
 };
 export {
   MigrationBuilder,
-  Migrations
+  MigrationVersionAnnotation,
+  Migrations,
+  compactDocumentsEpochMigration
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/migration-builder.ts", "../../../src/migrations.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { next as A, type Doc } from '@automerge/automerge';\nimport { type AnyDocumentId, type DocumentId } from '@automerge/automerge-repo';\nimport type * as Schema from 'effect/Schema';\n\nimport { type Space } from '@dxos/client/echo';\nimport { CreateEpochRequest } from '@dxos/client/halo';\nimport { requireTypeReference } from '@dxos/echo/internal';\nimport { type DocHandleProxy, ObjectCore, type RepoProxy, migrateDocument } from '@dxos/echo-db';\nimport {\n  type DatabaseDirectory,\n  type ObjectStructure,\n  Reference,\n  SpaceDocVersion,\n  encodeReference,\n} from '@dxos/echo-protocol';\nimport { invariant } from '@dxos/invariant';\nimport { type MaybePromise } from '@dxos/util';\n\n/*\n\nConsidering a better API for this:\n\n```ts\nconst migration = space.db.beginMigration(); // all actions are not visible to queries and are only applied once you call `apply`\n\nmigration.applyObjectMigration(defineMigration(From, To, { ... }));\n\nmigration.delete(id);\nmigration.add(obj);\n\nawait migration.apply(); // Will create new epoch.\n```\n\n*/\n\n// TODO(dmaretskyi): We no longer need to hook into ECHO internals, with the changes to echo APIs.\nexport class MigrationBuilder {\n  private readonly _repo: RepoProxy;\n  private readonly _rootDoc: Doc<DatabaseDirectory>;\n\n  // echoId -> automergeUrl\n  private readonly _newLinks: Record<string, string> = {};\n  private readonly _flushIds: DocumentId[] = [];\n  private readonly _deleteObjects: string[] = [];\n\n  private _newRoot?: DocHandleProxy<DatabaseDirectory> = undefined;\n\n  constructor(private readonly _space: Space) {\n    this._repo = this._space.db.coreDatabase._repo;\n    // TODO(wittjosiah): Accessing private API.\n    this._rootDoc = (this._space.db.coreDatabase as any)._automergeDocLoader\n      .getSpaceRootDocHandle()\n      .doc() as Doc<DatabaseDirectory>;\n  }\n\n  async findObject(id: string): Promise<ObjectStructure | undefined> {\n    const documentId = (this._rootDoc.links?.[id] || this._newLinks[id])?.toString() as AnyDocumentId | undefined;\n    const docHandle = documentId && this._repo.find(documentId);\n    if (!docHandle) {\n      return undefined;\n    }\n\n    await docHandle.whenReady();\n    const doc = docHandle.doc() as Doc<DatabaseDirectory>;\n    return doc.objects?.[id];\n  }\n\n  async migrateObject(\n    id: string,\n    migrate: (objectStructure: ObjectStructure) => MaybePromise<{ schema: Schema.Schema.AnyNoContext; props: any }>,\n  ): Promise<void> {\n    const objectStructure = await this.findObject(id);\n    if (!objectStructure) {\n      return;\n    }\n\n    const { schema, props } = await migrate(objectStructure);\n\n    const oldHandle = await this._findObjectContainingHandle(id);\n    invariant(oldHandle);\n\n    const newState: DatabaseDirectory = {\n      version: SpaceDocVersion.CURRENT,\n      access: {\n        spaceKey: this._space.key.toHex(),\n      },\n      objects: {\n        [id]: {\n          system: {\n            type: encodeReference(requireTypeReference(schema)),\n          },\n          data: props,\n          meta: {\n            keys: [],\n          },\n        },\n      },\n    };\n    const migratedDoc = migrateDocument(oldHandle.doc() as Doc<DatabaseDirectory>, newState);\n    const newHandle = this._repo.import<DatabaseDirectory>(A.save(migratedDoc));\n    this._newLinks[id] = newHandle.url;\n    this._addHandleToFlushList(newHandle);\n  }\n\n  async addObject(schema: Schema.Schema.AnyNoContext, props: any): Promise<string> {\n    const core = this._createObject({ schema, props });\n    return core.id;\n  }\n\n  createReference(id: string) {\n    return encodeReference(Reference.localObjectReference(id));\n  }\n\n  deleteObject(id: string): void {\n    this._deleteObjects.push(id);\n  }\n\n  changeProperties(changeFn: (properties: ObjectStructure) => void): void {\n    if (!this._newRoot) {\n      this._buildNewRoot();\n    }\n    invariant(this._newRoot, 'New root not created');\n\n    this._newRoot.change((doc: DatabaseDirectory) => {\n      const propertiesStructure = doc.objects?.[this._space.properties.id];\n      propertiesStructure && changeFn(propertiesStructure);\n    });\n    this._addHandleToFlushList(this._newRoot);\n  }\n\n  /**\n   * @internal\n   */\n  async _commit(): Promise<void> {\n    if (!this._newRoot) {\n      this._buildNewRoot();\n    }\n    invariant(this._newRoot, 'New root not created');\n\n    await this._space.db.flush();\n\n    // Create new epoch.\n    await this._space.internal.createEpoch({\n      migration: CreateEpochRequest.Migration.REPLACE_AUTOMERGE_ROOT,\n      automergeRootUrl: this._newRoot.url,\n    });\n  }\n\n  private async _findObjectContainingHandle(id: string): Promise<DocHandleProxy<DatabaseDirectory> | undefined> {\n    const documentId = (this._rootDoc.links?.[id] || this._newLinks[id])?.toString() as AnyDocumentId | undefined;\n    const docHandle = documentId && this._repo.find(documentId);\n    if (!docHandle) {\n      return undefined;\n    }\n\n    await docHandle.whenReady();\n    return docHandle;\n  }\n\n  private _buildNewRoot(): void {\n    const links = { ...(this._rootDoc.links ?? {}) };\n    for (const id of this._deleteObjects) {\n      delete links[id];\n    }\n\n    for (const [id, url] of Object.entries(this._newLinks)) {\n      links[id] = new A.RawString(url);\n    }\n\n    this._newRoot = this._repo.create<DatabaseDirectory>({\n      version: SpaceDocVersion.CURRENT,\n      access: {\n        spaceKey: this._space.key.toHex(),\n      },\n      objects: this._rootDoc.objects,\n      links,\n    });\n    this._addHandleToFlushList(this._newRoot);\n  }\n\n  private _createObject({\n    id,\n    schema,\n    props,\n  }: {\n    id?: string;\n    schema: Schema.Schema.AnyNoContext;\n    props: any;\n  }): ObjectCore {\n    const core = new ObjectCore();\n    if (id) {\n      core.id = id;\n    }\n\n    core.initNewObject(props);\n    core.setType(requireTypeReference(schema));\n    const newHandle = this._repo.create<DatabaseDirectory>({\n      version: SpaceDocVersion.CURRENT,\n      access: {\n        spaceKey: this._space.key.toHex(),\n      },\n      objects: {\n        [core.id]: core.getDoc() as ObjectStructure,\n      },\n    });\n    this._newLinks[core.id] = newHandle.url;\n    this._addHandleToFlushList(newHandle);\n\n    return core;\n  }\n\n  private _addHandleToFlushList(handle: DocHandleProxy<any>): void {\n    this._flushIds.push(handle.documentId);\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Space, SpaceState, live } from '@dxos/client/echo';\nimport { invariant } from '@dxos/invariant';\nimport { type MaybePromise } from '@dxos/util';\n\nimport { MigrationBuilder } from './migration-builder';\n\nexport type MigrationContext = {\n  space: Space;\n  builder: MigrationBuilder;\n};\n\nexport type Migration = {\n  version: string;\n  next: (context: MigrationContext) => MaybePromise<void>;\n};\n\nexport class Migrations {\n  static namespace?: string;\n  static migrations: Migration[] = [];\n  private static _state = live<{ running: string[] }>({ running: [] });\n\n  static get versionProperty() {\n    return this.namespace && `${this.namespace}.version`;\n  }\n\n  static get targetVersion() {\n    return this.migrations[this.migrations.length - 1]?.version;\n  }\n\n  static running(space: Space): boolean {\n    return this._state.running.includes(space.key.toHex());\n  }\n\n  static define(namespace: string, migrations: Migration[]): void {\n    this.namespace = namespace;\n    this.migrations = migrations;\n  }\n\n  static async migrate(space: Space, targetVersion?: string | number): Promise<boolean> {\n    invariant(!this.running(space), 'Migration already running');\n    invariant(this.versionProperty, 'Migrations namespace not set');\n    invariant(space.state.get() === SpaceState.SPACE_READY, 'Space not ready');\n    const currentVersion = space.properties[this.versionProperty];\n    const currentIndex = this.migrations.findIndex((m) => m.version === currentVersion) + 1;\n    const i = this.migrations.findIndex((m) => m.version === targetVersion);\n    const targetIndex = i === -1 ? this.migrations.length : i + 1;\n    if (currentIndex === targetIndex) {\n      return false;\n    }\n\n    this._state.running.push(space.key.toHex());\n    if (targetIndex > currentIndex) {\n      const migrations = this.migrations.slice(currentIndex, targetIndex);\n      for (const migration of migrations) {\n        const builder = new MigrationBuilder(space);\n        await migration.next({ space, builder });\n        builder.changeProperties((propertiesStructure) => {\n          invariant(this.versionProperty, 'Migrations namespace not set');\n          propertiesStructure.data[this.versionProperty] = migration.version;\n        });\n        await builder._commit();\n      }\n    }\n    this._state.running.splice(this._state.running.indexOf(space.key.toHex()), 1);\n\n    return true;\n  }\n}\n"],
-  "mappings": ";;;AAIA,SAASA,QAAQC,SAAmB;AAKpC,SAASC,0BAA0B;AACnC,SAASC,4BAA4B;AACrC,SAA8BC,YAA4BC,uBAAuB;AACjF,SAGEC,WACAC,iBACAC,uBACK;AACP,SAASC,iBAAiB;;AAqBnB,IAAMC,mBAAN,MAAMA;;EACMC;EACAC;;EAGAC,YAAoC,CAAC;EACrCC,YAA0B,CAAA;EAC1BC,iBAA2B,CAAA;EAEpCC,WAA+CC;EAEvD,YAA6BC,QAAe;SAAfA,SAAAA;AAC3B,SAAKP,QAAQ,KAAKO,OAAOC,GAAGC,aAAaT;AAEzC,SAAKC,WAAY,KAAKM,OAAOC,GAAGC,aAAqBC,oBAClDC,sBAAqB,EACrBC,IAAG;EACR;EAEA,MAAMC,WAAWC,IAAkD;AACjE,UAAMC,cAAc,KAAKd,SAASe,QAAQF,EAAAA,KAAO,KAAKZ,UAAUY,EAAAA,IAAMG,SAAAA;AACtE,UAAMC,YAAYH,cAAc,KAAKf,MAAMmB,KAAKJ,UAAAA;AAChD,QAAI,CAACG,WAAW;AACd,aAAOZ;IACT;AAEA,UAAMY,UAAUE,UAAS;AACzB,UAAMR,MAAMM,UAAUN,IAAG;AACzB,WAAOA,IAAIS,UAAUP,EAAAA;EACvB;EAEA,MAAMQ,cACJR,IACAS,SACe;AACf,UAAMC,kBAAkB,MAAM,KAAKX,WAAWC,EAAAA;AAC9C,QAAI,CAACU,iBAAiB;AACpB;IACF;AAEA,UAAM,EAAEC,QAAQC,MAAK,IAAK,MAAMH,QAAQC,eAAAA;AAExC,UAAMG,YAAY,MAAM,KAAKC,4BAA4Bd,EAAAA;AACzDhB,cAAU6B,WAAAA,QAAAA;;;;;;;;;AAEV,UAAME,WAA8B;MAClCC,SAASlC,gBAAgBmC;MACzBC,QAAQ;QACNC,UAAU,KAAK1B,OAAO2B,IAAIC,MAAK;MACjC;MACAd,SAAS;QACP,CAACP,EAAAA,GAAK;UACJsB,QAAQ;YACNC,MAAMxC,gBAAgBL,qBAAqBiC,MAAAA,CAAAA;UAC7C;UACAa,MAAMZ;UACNa,MAAM;YACJC,MAAM,CAAA;UACR;QACF;MACF;IACF;AACA,UAAMC,cAAc/C,gBAAgBiC,UAAUf,IAAG,GAA8BiB,QAAAA;AAC/E,UAAMa,YAAY,KAAK1C,MAAM2C,OAA0BrD,EAAEsD,KAAKH,WAAAA,CAAAA;AAC9D,SAAKvC,UAAUY,EAAAA,IAAM4B,UAAUG;AAC/B,SAAKC,sBAAsBJ,SAAAA;EAC7B;EAEA,MAAMK,UAAUtB,QAAoCC,OAA6B;AAC/E,UAAMsB,OAAO,KAAKC,cAAc;MAAExB;MAAQC;IAAM,CAAA;AAChD,WAAOsB,KAAKlC;EACd;EAEAoC,gBAAgBpC,IAAY;AAC1B,WAAOjB,gBAAgBF,UAAUwD,qBAAqBrC,EAAAA,CAAAA;EACxD;EAEAsC,aAAatC,IAAkB;AAC7B,SAAKV,eAAeiD,KAAKvC,EAAAA;EAC3B;EAEAwC,iBAAiBC,UAAuD;AACtE,QAAI,CAAC,KAAKlD,UAAU;AAClB,WAAKmD,cAAa;IACpB;AACA1D,cAAU,KAAKO,UAAU,wBAAA;;;;;;;;;AAEzB,SAAKA,SAASoD,OAAO,CAAC7C,QAAAA;AACpB,YAAM8C,sBAAsB9C,IAAIS,UAAU,KAAKd,OAAOoD,WAAW7C,EAAE;AACnE4C,6BAAuBH,SAASG,mBAAAA;IAClC,CAAA;AACA,SAAKZ,sBAAsB,KAAKzC,QAAQ;EAC1C;;;;EAKA,MAAMuD,UAAyB;AAC7B,QAAI,CAAC,KAAKvD,UAAU;AAClB,WAAKmD,cAAa;IACpB;AACA1D,cAAU,KAAKO,UAAU,wBAAA;;;;;;;;;AAEzB,UAAM,KAAKE,OAAOC,GAAGqD,MAAK;AAG1B,UAAM,KAAKtD,OAAOuD,SAASC,YAAY;MACrCC,WAAWzE,mBAAmB0E,UAAUC;MACxCC,kBAAkB,KAAK9D,SAASwC;IAClC,CAAA;EACF;EAEA,MAAcjB,4BAA4Bd,IAAoE;AAC5G,UAAMC,cAAc,KAAKd,SAASe,QAAQF,EAAAA,KAAO,KAAKZ,UAAUY,EAAAA,IAAMG,SAAAA;AACtE,UAAMC,YAAYH,cAAc,KAAKf,MAAMmB,KAAKJ,UAAAA;AAChD,QAAI,CAACG,WAAW;AACd,aAAOZ;IACT;AAEA,UAAMY,UAAUE,UAAS;AACzB,WAAOF;EACT;EAEQsC,gBAAsB;AAC5B,UAAMxC,QAAQ;MAAE,GAAI,KAAKf,SAASe,SAAS,CAAC;IAAG;AAC/C,eAAWF,MAAM,KAAKV,gBAAgB;AACpC,aAAOY,MAAMF,EAAAA;IACf;AAEA,eAAW,CAACA,IAAI+B,GAAAA,KAAQuB,OAAOC,QAAQ,KAAKnE,SAAS,GAAG;AACtDc,YAAMF,EAAAA,IAAM,IAAIxB,EAAEgF,UAAUzB,GAAAA;IAC9B;AAEA,SAAKxC,WAAW,KAAKL,MAAMuE,OAA0B;MACnDzC,SAASlC,gBAAgBmC;MACzBC,QAAQ;QACNC,UAAU,KAAK1B,OAAO2B,IAAIC,MAAK;MACjC;MACAd,SAAS,KAAKpB,SAASoB;MACvBL;IACF,CAAA;AACA,SAAK8B,sBAAsB,KAAKzC,QAAQ;EAC1C;EAEQ4C,cAAc,EACpBnC,IACAW,QACAC,MAAK,GAKQ;AACb,UAAMsB,OAAO,IAAIvD,WAAAA;AACjB,QAAIqB,IAAI;AACNkC,WAAKlC,KAAKA;IACZ;AAEAkC,SAAKwB,cAAc9C,KAAAA;AACnBsB,SAAKyB,QAAQjF,qBAAqBiC,MAAAA,CAAAA;AAClC,UAAMiB,YAAY,KAAK1C,MAAMuE,OAA0B;MACrDzC,SAASlC,gBAAgBmC;MACzBC,QAAQ;QACNC,UAAU,KAAK1B,OAAO2B,IAAIC,MAAK;MACjC;MACAd,SAAS;QACP,CAAC2B,KAAKlC,EAAE,GAAGkC,KAAK0B,OAAM;MACxB;IACF,CAAA;AACA,SAAKxE,UAAU8C,KAAKlC,EAAE,IAAI4B,UAAUG;AACpC,SAAKC,sBAAsBJ,SAAAA;AAE3B,WAAOM;EACT;EAEQF,sBAAsB6B,QAAmC;AAC/D,SAAKxE,UAAUkD,KAAKsB,OAAO5D,UAAU;EACvC;AACF;;;ACtNA,SAAqB6D,YAAYC,YAAY;AAC7C,SAASC,aAAAA,kBAAiB;;AAenB,IAAMC,aAAN,MAAMA;EACX,OAAOC;EACP,OAAOC,aAA0B,CAAA;EACjC,OAAeC,SAASC,KAA4B;IAAEC,SAAS,CAAA;EAAG,CAAA;EAElE,WAAWC,kBAAkB;AAC3B,WAAO,KAAKL,aAAa,GAAG,KAAKA,SAAS;EAC5C;EAEA,WAAWM,gBAAgB;AACzB,WAAO,KAAKL,WAAW,KAAKA,WAAWM,SAAS,CAAA,GAAIC;EACtD;EAEA,OAAOJ,QAAQK,OAAuB;AACpC,WAAO,KAAKP,OAAOE,QAAQM,SAASD,MAAME,IAAIC,MAAK,CAAA;EACrD;EAEA,OAAOC,OAAOb,WAAmBC,YAA+B;AAC9D,SAAKD,YAAYA;AACjB,SAAKC,aAAaA;EACpB;EAEA,aAAaa,QAAQL,OAAcH,eAAmD;AACpFS,IAAAA,WAAU,CAAC,KAAKX,QAAQK,KAAAA,GAAQ,6BAAA;;;;;;;;;AAChCM,IAAAA,WAAU,KAAKV,iBAAiB,gCAAA;;;;;;;;;AAChCU,IAAAA,WAAUN,MAAMO,MAAMC,IAAG,MAAOC,WAAWC,aAAa,mBAAA;;;;;;;;;AACxD,UAAMC,iBAAiBX,MAAMY,WAAW,KAAKhB,eAAe;AAC5D,UAAMiB,eAAe,KAAKrB,WAAWsB,UAAU,CAACC,MAAMA,EAAEhB,YAAYY,cAAAA,IAAkB;AACtF,UAAMK,IAAI,KAAKxB,WAAWsB,UAAU,CAACC,MAAMA,EAAEhB,YAAYF,aAAAA;AACzD,UAAMoB,cAAcD,MAAM,KAAK,KAAKxB,WAAWM,SAASkB,IAAI;AAC5D,QAAIH,iBAAiBI,aAAa;AAChC,aAAO;IACT;AAEA,SAAKxB,OAAOE,QAAQuB,KAAKlB,MAAME,IAAIC,MAAK,CAAA;AACxC,QAAIc,cAAcJ,cAAc;AAC9B,YAAMrB,aAAa,KAAKA,WAAW2B,MAAMN,cAAcI,WAAAA;AACvD,iBAAWG,aAAa5B,YAAY;AAClC,cAAM6B,UAAU,IAAIC,iBAAiBtB,KAAAA;AACrC,cAAMoB,UAAUG,KAAK;UAAEvB;UAAOqB;QAAQ,CAAA;AACtCA,gBAAQG,iBAAiB,CAACC,wBAAAA;AACxBnB,UAAAA,WAAU,KAAKV,iBAAiB,gCAAA;;;;;;;;;AAChC6B,8BAAoBC,KAAK,KAAK9B,eAAe,IAAIwB,UAAUrB;QAC7D,CAAA;AACA,cAAMsB,QAAQM,QAAO;MACvB;IACF;AACA,SAAKlC,OAAOE,QAAQiC,OAAO,KAAKnC,OAAOE,QAAQkC,QAAQ7B,MAAME,IAAIC,MAAK,CAAA,GAAK,CAAA;AAE3E,WAAO;EACT;AACF;",
-  "names": ["next", "A", "CreateEpochRequest", "requireTypeReference", "ObjectCore", "migrateDocument", "Reference", "SpaceDocVersion", "encodeReference", "invariant", "MigrationBuilder", "_repo", "_rootDoc", "_newLinks", "_flushIds", "_deleteObjects", "_newRoot", "undefined", "_space", "db", "coreDatabase", "_automergeDocLoader", "getSpaceRootDocHandle", "doc", "findObject", "id", "documentId", "links", "toString", "docHandle", "find", "whenReady", "objects", "migrateObject", "migrate", "objectStructure", "schema", "props", "oldHandle", "_findObjectContainingHandle", "newState", "version", "CURRENT", "access", "spaceKey", "key", "toHex", "system", "type", "data", "meta", "keys", "migratedDoc", "newHandle", "import", "save", "url", "_addHandleToFlushList", "addObject", "core", "_createObject", "createReference", "localObjectReference", "deleteObject", "push", "changeProperties", "changeFn", "_buildNewRoot", "change", "propertiesStructure", "properties", "_commit", "flush", "internal", "createEpoch", "migration", "Migration", "REPLACE_AUTOMERGE_ROOT", "automergeRootUrl", "Object", "entries", "RawString", "create", "initNewObject", "setType", "getDoc", "handle", "SpaceState", "live", "invariant", "Migrations", "namespace", "migrations", "_state", "live", "running", "versionProperty", "targetVersion", "length", "version", "space", "includes", "key", "toHex", "define", "migrate", "invariant", "state", "get", "SpaceState", "SPACE_READY", "currentVersion", "properties", "currentIndex", "findIndex", "m", "i", "targetIndex", "push", "slice", "migration", "builder", "MigrationBuilder", "next", "changeProperties", "propertiesStructure", "data", "_commit", "splice", "indexOf"]
+  "sources": ["../../../src/annotations.ts", "../../../src/document-compaction.ts", "../../../src/migration-builder.ts", "../../../src/migrations.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation } from '@dxos/echo';\n\n/** Migration version stored on space properties meta. */\nexport const MigrationVersionAnnotation = Annotation.make({\n  id: 'org.dxos.migrations.version',\n  schema: Schema.String,\n});\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Space, SpaceState } from '@dxos/client/echo';\nimport { invariant } from '@dxos/invariant';\n\nimport { MigrationBuilder } from './migration-builder';\n\nexport type CompactDocumentsOptions = {\n  /**\n   * Entity ids whose linked Automerge documents should be compacted.\n   * Defaults to all ids in the space root `links` map.\n   */\n  objectIds?: string[];\n};\n\nexport type CompactDocumentsResult = {\n  compacted: string[];\n  skipped: string[];\n  epochNumber: number;\n};\n\n/**\n * Re-materializes linked object documents into fresh Automerge docs (no history) and commits\n * a new space epoch with {@link CreateEpochRequest.Migration.REPLACE_AUTOMERGE_ROOT}.\n */\nexport const compactDocumentsEpochMigration = async (\n  space: Space,\n  options: CompactDocumentsOptions = {},\n): Promise<CompactDocumentsResult> => {\n  invariant(space.state.get() === SpaceState.SPACE_READY, 'Space must be open and ready before compaction.');\n\n  const builder = new MigrationBuilder(space);\n  const { compacted, skipped } = await builder.compactLinkedDocuments(options.objectIds);\n  await builder._commit();\n\n  const epochs = await space.internal.getEpochs();\n  const lastEpoch = epochs[epochs.length - 1];\n  const epochNumber = lastEpoch?.subject.assertion.number ?? 0;\n\n  return { compacted, skipped, epochNumber };\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { next as A, type Doc, toJS } from '@automerge/automerge';\nimport { type AnyDocumentId, type DocumentId } from '@automerge/automerge-repo';\nimport type * as Schema from 'effect/Schema';\n\nimport { type Space } from '@dxos/client/echo';\nimport { CreateEpochRequest } from '@dxos/client/halo';\nimport { type DocHandleProxy, ObjectCore, type RepoProxy, migrateDocument } from '@dxos/echo-client/internal';\nimport { type DatabaseDirectory, EncodedReference, type EntityStructure, SpaceDocVersion } from '@dxos/echo-protocol';\nimport { getSchemaURI } from '@dxos/echo/internal';\nimport * as Type from '@dxos/echo/Type';\nimport { invariant } from '@dxos/invariant';\nimport { EID, EntityId } from '@dxos/keys';\nimport { type MaybePromise } from '@dxos/util';\n\n/*\n\nConsidering a better API for this:\n\n```ts\nconst migration = space.db.beginMigration(); // all actions are not visible to queries and are only applied once you call `apply`\n\nmigration.applyObjectMigration(defineMigration(From, To, { ... }));\n\nmigration.delete(id);\nmigration.add(obj);\n\nawait migration.apply(); // Will create new epoch.\n```\n\n*/\n\n// TODO(dmaretskyi): We no longer need to hook into ECHO internals, with the changes to echo APIs.\nexport class MigrationBuilder {\n  private readonly _repo: RepoProxy;\n  private readonly _rootDoc: Doc<DatabaseDirectory>;\n\n  // echoUri -> automergeUrl\n  private readonly _newLinks: Record<string, string> = {};\n  private readonly _flushIds: DocumentId[] = [];\n  private readonly _deleteObjects: string[] = [];\n\n  private _newRoot?: DocHandleProxy<DatabaseDirectory> = undefined;\n\n  constructor(private readonly _space: Space) {\n    this._repo = this._space.internal.db._repo;\n    const rootDoc = this._space.internal.db._getSpaceRootDocHandle().doc();\n    invariant(rootDoc, 'Space root document must be available when creating MigrationBuilder');\n    this._rootDoc = rootDoc;\n  }\n\n  async findObject(id: string): Promise<EntityStructure | undefined> {\n    const documentId = (this._rootDoc.links?.[id] || this._newLinks[id])?.toString() as AnyDocumentId | undefined;\n    const docHandle = documentId && this._repo.find(documentId);\n    if (!docHandle) {\n      return undefined;\n    }\n\n    await docHandle.whenReady();\n    const doc = docHandle.doc() as Doc<DatabaseDirectory>;\n    return doc.objects?.[id];\n  }\n\n  async migrateObject(\n    id: string,\n    migrate: (objectStructure: EntityStructure) => MaybePromise<{ type: Type.AnyEntity; props: any }>,\n  ): Promise<void> {\n    const objectStructure = await this.findObject(id);\n    if (!objectStructure) {\n      return;\n    }\n\n    const { type, props } = await migrate(objectStructure);\n    const schema = Type.getSchema(type);\n\n    const oldHandle = await this._findObjectContainingHandle(id);\n    invariant(oldHandle);\n\n    const newState: DatabaseDirectory = {\n      version: SpaceDocVersion.CURRENT,\n      access: {\n        spaceKey: this._space.key.toHex(),\n      },\n      objects: {\n        [id]: {\n          system: {\n            type: EncodedReference.fromURI(getSchemaURI(schema)!),\n          },\n          data: props,\n          meta: {\n            keys: [],\n          },\n        },\n      },\n    };\n    const migratedDoc = migrateDocument(oldHandle.doc() as Doc<DatabaseDirectory>, newState);\n    const newHandle = this._repo.import<DatabaseDirectory>(A.save(migratedDoc));\n    await newHandle.whenReady();\n    invariant(newHandle.url, 'Migrated document URL not available after whenReady');\n    this._newLinks[id] = newHandle.url;\n    this._addHandleToFlushList(newHandle.documentId!);\n  }\n\n  async addObject(type: Type.AnyEntity, props: any): Promise<string> {\n    const resolved = Type.getSchema(type);\n    const core = await this._createObject({ schema: resolved, props });\n    return core.id;\n  }\n\n  createReference(id: string) {\n    invariant(EntityId.isValid(id), 'Invalid EntityId.');\n    return EncodedReference.fromURI(EID.make({ entityId: id }));\n  }\n\n  deleteObject(id: string): void {\n    this._deleteObjects.push(id);\n  }\n\n  /**\n   * Re-materializes linked object documents into fresh Automerge docs without history.\n   * Call {@link _commit} to publish a new space epoch with updated root links.\n   */\n  async compactLinkedDocuments(objectIds?: string[]): Promise<{ compacted: string[]; skipped: string[] }> {\n    const linkIds = objectIds ?? Object.keys(this._rootDoc.links ?? {});\n    const compacted: string[] = [];\n    const skipped: string[] = [];\n\n    for (const id of linkIds) {\n      const oldHandle = await this._findObjectContainingHandle(id);\n      if (!oldHandle) {\n        skipped.push(id);\n        continue;\n      }\n\n      await oldHandle.whenReady();\n      const materialized = toJS(oldHandle.doc()!) as DatabaseDirectory;\n      const newHandle = this._repo.create<DatabaseDirectory>(materialized);\n      await newHandle.whenReady();\n      invariant(newHandle.url, 'Compacted document URL not available after whenReady');\n      this._newLinks[id] = newHandle.url;\n      this._addHandleToFlushList(newHandle.documentId!);\n      compacted.push(id);\n    }\n\n    return { compacted, skipped };\n  }\n\n  async changeProperties(changeFn: (properties: EntityStructure) => void): Promise<void> {\n    if (!this._newRoot) {\n      await this._buildNewRoot();\n    }\n    invariant(this._newRoot, 'New root not created');\n\n    this._newRoot.change((doc: DatabaseDirectory) => {\n      const propertiesStructure = doc.objects?.[this._space.properties.id];\n      propertiesStructure && changeFn(propertiesStructure);\n    });\n    await this._newRoot.whenReady();\n    this._addHandleToFlushList(this._newRoot.documentId!);\n  }\n\n  /**\n   * @internal\n   */\n  async _commit(): Promise<void> {\n    if (!this._newRoot) {\n      await this._buildNewRoot();\n    }\n    invariant(this._newRoot, 'New root not created');\n\n    await this._space.db.flush();\n\n    // Create new epoch.\n    invariant(this._newRoot.url, 'New root URL not available');\n    await this._space.internal.createEpoch({\n      migration: CreateEpochRequest.Migration.REPLACE_AUTOMERGE_ROOT,\n      automergeRootUrl: this._newRoot.url,\n    });\n  }\n\n  private async _findObjectContainingHandle(id: string): Promise<DocHandleProxy<DatabaseDirectory> | undefined> {\n    const documentId = (this._rootDoc.links?.[id] || this._newLinks[id])?.toString() as AnyDocumentId | undefined;\n    const docHandle = documentId && this._repo.find(documentId);\n    if (!docHandle) {\n      return undefined;\n    }\n\n    await docHandle.whenReady();\n    return docHandle;\n  }\n\n  private async _buildNewRoot(): Promise<void> {\n    const links = { ...(this._rootDoc.links ?? {}) };\n    for (const id of this._deleteObjects) {\n      delete links[id];\n    }\n\n    for (const [id, url] of Object.entries(this._newLinks)) {\n      links[id] = new A.RawString(url);\n    }\n\n    this._newRoot = this._repo.create<DatabaseDirectory>({\n      version: SpaceDocVersion.CURRENT,\n      access: {\n        spaceKey: this._space.key.toHex(),\n      },\n      objects: this._rootDoc.objects,\n      links,\n    });\n    await this._newRoot.whenReady();\n    this._addHandleToFlushList(this._newRoot.documentId!);\n  }\n\n  private async _createObject({\n    id,\n    schema,\n    props,\n  }: {\n    id?: string;\n    schema: Schema.Schema.AnyNoContext;\n    props: any;\n  }): Promise<ObjectCore> {\n    const core = new ObjectCore();\n    if (id) {\n      core.id = id;\n    }\n\n    core.initNewObject(props);\n    core.setType(EncodedReference.fromURI(getSchemaURI(schema)!));\n    const newHandle = this._repo.create<DatabaseDirectory>({\n      version: SpaceDocVersion.CURRENT,\n      access: {\n        spaceKey: this._space.key.toHex(),\n      },\n      objects: {\n        [core.id]: core.getDoc() as EntityStructure,\n      },\n    });\n    await newHandle.whenReady();\n    this._newLinks[core.id] = newHandle.url!;\n    this._addHandleToFlushList(newHandle.documentId!);\n\n    return core;\n  }\n\n  private _addHandleToFlushList(id: DocumentId): void {\n    this._flushIds.push(id);\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { Atom } from '@effect-atom/atom';\nimport * as Registry from '@effect-atom/atom/Registry';\nimport * as Option from 'effect/Option';\n\nimport { type Space, SpaceState } from '@dxos/client/echo';\nimport { Annotation, Obj } from '@dxos/echo';\nimport { invariant } from '@dxos/invariant';\nimport { type MaybePromise } from '@dxos/util';\n\nimport { MigrationVersionAnnotation } from './annotations';\nimport { MigrationBuilder } from './migration-builder';\n\nexport type MigrationContext = {\n  space: Space;\n  builder: MigrationBuilder;\n};\n\nexport type Migration = {\n  version: string;\n  next: (context: MigrationContext) => MaybePromise<void>;\n};\n\nexport class Migrations {\n  static namespace?: string;\n  static migrations: Migration[] = [];\n  private static _registry = Registry.make();\n  private static _stateAtom = Atom.make<{ running: string[] }>({ running: [] }).pipe(Atom.keepAlive);\n\n  /**\n   * @deprecated Use `MigrationVersionAnnotation` via `Annotation.get/set` on space properties.\n   */\n  static get versionProperty() {\n    return this.namespace && `${this.namespace}.version`;\n  }\n\n  static get targetVersion() {\n    return this.migrations[this.migrations.length - 1]?.version;\n  }\n\n  static running(space: Space): boolean {\n    const state = this._registry.get(this._stateAtom);\n    return state.running.includes(space.key.toHex());\n  }\n\n  static define(namespace: string, migrations: Migration[]): void {\n    this.namespace = namespace;\n    this.migrations = migrations;\n  }\n\n  static async migrate(space: Space, targetVersion?: string | number): Promise<boolean> {\n    invariant(!this.running(space), 'Migration already running');\n    invariant(space.state.get() === SpaceState.SPACE_READY, 'Space not ready');\n    const currentVersion = Annotation.get(space.properties, MigrationVersionAnnotation).pipe(Option.getOrUndefined);\n    const currentIndex = this.migrations.findIndex((m) => m.version === currentVersion) + 1;\n    const i = this.migrations.findIndex((m) => m.version === targetVersion);\n    const targetIndex = i === -1 ? this.migrations.length : i + 1;\n    if (currentIndex === targetIndex) {\n      return false;\n    }\n\n    const spaceKey = space.key.toHex();\n    const currentState = this._registry.get(this._stateAtom);\n    this._registry.set(this._stateAtom, { running: [...currentState.running, spaceKey] });\n    try {\n      if (targetIndex > currentIndex) {\n        const migrations = this.migrations.slice(currentIndex, targetIndex);\n        for (const migration of migrations) {\n          const builder = new MigrationBuilder(space);\n          await migration.next({ space, builder });\n          await builder._commit();\n          Obj.update(space.properties, (properties) => {\n            Annotation.set(properties, MigrationVersionAnnotation, migration.version);\n          });\n        }\n      }\n    } finally {\n      const finalState = this._registry.get(this._stateAtom);\n      this._registry.set(this._stateAtom, { running: finalState.running.filter((key) => key !== spaceKey) });\n    }\n\n    return true;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["Schema", "Annotation", "MigrationVersionAnnotation", "make", "id", "schema", "String", "SpaceState", "invariant", "next", "A", "toJS", "CreateEpochRequest", "ObjectCore", "migrateDocument", "EncodedReference", "SpaceDocVersion", "getSchemaURI", "Type", "invariant", "EID", "EntityId", "_repo", "_rootDoc", "_newLinks", "_deleteObjects", "_newRoot", "undefined", "_space", "rootDoc", "findObject", "docHandle", "objects", "migrateObject", "migrate", "objectStructure", "oldHandle", "_findObjectContainingHandle", "newState", "version", "access", "spaceKey", "system", "data", "props", "meta", "keys", "newHandle", "whenReady", "id", "_addHandleToFlushList", "addObject", "core", "_createObject", "schema", "resolved", "createReference", "entityId", "deleteObject", "skipped", "linkIds", "compacted", "_buildNewRoot", "propertiesStructure", "properties", "changeFn", "migration", "REPLACE_AUTOMERGE_ROOT", "automergeRootUrl", "documentId", "url", "create", "links", "initNewObject", "CURRENT", "__dxlog_file", "builder", "space", "invariant", "compacted", "skipped", "compactLinkedDocuments", "_commit", "epochs", "internal", "getEpochs", "lastEpoch", "epochNumber", "subject", "assertion", "Atom", "Registry", "Option", "SpaceState", "Annotation", "Obj", "invariant", "__dxlog_file", "Migrations", "migrations", "_registry", "_stateAtom", "Atom", "running", "keepAlive", "targetVersion", "space", "state", "define", "namespace", "invariant", "get", "SpaceState", "currentVersion", "Annotation", "MigrationVersionAnnotation", "pipe", "getOrUndefined", "currentIndex", "findIndex", "version", "i", "m", "targetIndex", "length", "spaceKey", "set", "currentState", "migration", "builder", "MigrationBuilder", "Obj", "properties", "finalState", "filter", "key"]
 }

package/dist/lib/node-esm/meta.json

@@ -1 +1 @@
-{"inputs":{"src/migration-builder.ts":{"bytes":22035,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-db","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/migrations.ts":{"bytes":9709,"imports":[{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"}],"format":"esm"},"src/index.ts":{"bytes":653,"imports":[{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"},{"path":"src/migrations.ts","kind":"import-statement","original":"./migrations"}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15614},"dist/lib/node-esm/index.mjs":{"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-db","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"exports":["MigrationBuilder","Migrations"],"entryPoint":"src/index.ts","inputs":{"src/migration-builder.ts":{"bytesInOutput":4851},"src/index.ts":{"bytesInOutput":0},"src/migrations.ts":{"bytesInOutput":2727}},"bytes":7801}}}
+{"inputs":{"src/annotations.ts":{"bytes":1241,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true}],"format":"esm"},"src/migration-builder.ts":{"bytes":28104,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo-client/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo/Type","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true}],"format":"esm"},"src/document-compaction.ts":{"bytes":4389,"imports":[{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"}],"format":"esm"},"src/migrations.ts":{"bytes":11492,"imports":[{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@effect-atom/atom/Registry","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/annotations.ts","kind":"import-statement","original":"./annotations"},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"}],"format":"esm"},"src/index.ts":{"bytes":789,"imports":[{"path":"src/annotations.ts","kind":"import-statement","original":"./annotations"},{"path":"src/document-compaction.ts","kind":"import-statement","original":"./document-compaction"},{"path":"src/migration-builder.ts","kind":"import-statement","original":"./migration-builder"},{"path":"src/migrations.ts","kind":"import-statement","original":"./migrations"}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":21778},"dist/lib/node-esm/index.mjs":{"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","kind":"import-statement","external":true},{"path":"@dxos/echo-client/internal","kind":"import-statement","external":true},{"path":"@dxos/echo-protocol","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/echo/Type","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@effect-atom/atom/Registry","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"@dxos/client/echo","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"exports":["MigrationBuilder","MigrationVersionAnnotation","Migrations","compactDocumentsEpochMigration"],"entryPoint":"src/index.ts","inputs":{"src/annotations.ts":{"bytesInOutput":198},"src/index.ts":{"bytesInOutput":0},"src/document-compaction.ts":{"bytesInOutput":936},"src/migration-builder.ts":{"bytesInOutput":7116},"src/migrations.ts":{"bytesInOutput":2999}},"bytes":11621}}}

package/dist/types/src/annotations.d.ts

@@ -0,0 +1,4 @@
+import { Annotation } from '@dxos/echo';
+/** Migration version stored on space properties meta. */
+export declare const MigrationVersionAnnotation: Annotation.Annotation<string>;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/types/src/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../../src/annotations.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,+BAGrC,CAAC"}

package/dist/types/src/document-compaction.d.ts

@@ -0,0 +1,19 @@
+import { type Space } from '@dxos/client/echo';
+export type CompactDocumentsOptions = {
+    /**
+     * Entity ids whose linked Automerge documents should be compacted.
+     * Defaults to all ids in the space root `links` map.
+     */
+    objectIds?: string[];
+};
+export type CompactDocumentsResult = {
+    compacted: string[];
+    skipped: string[];
+    epochNumber: number;
+};
+/**
+ * Re-materializes linked object documents into fresh Automerge docs (no history) and commits
+ * a new space epoch with {@link CreateEpochRequest.Migration.REPLACE_AUTOMERGE_ROOT}.
+ */
+export declare const compactDocumentsEpochMigration: (space: Space, options?: CompactDocumentsOptions) => Promise<CompactDocumentsResult>;
+//# sourceMappingURL=document-compaction.d.ts.map

package/dist/types/src/document-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-compaction.d.ts","sourceRoot":"","sources":["../../../src/document-compaction.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAc,MAAM,mBAAmB,CAAC;AAK3D,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,UAClC,KAAK,YACH,uBAAuB,KAC/B,OAAO,CAAC,sBAAsB,CAYhC,CAAC"}

package/dist/types/src/document-compaction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-compaction.test.d.ts.map

package/dist/types/src/document-compaction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-compaction.test.d.ts","sourceRoot":"","sources":["../../../src/document-compaction.test.ts"],"names":[],"mappings":""}

package/dist/types/src/index.d.ts

@@ -1,4 +1,6 @@
-export type { ObjectStructure } from '@dxos/echo-protocol';
+export type { EntityStructure } from '@dxos/echo-protocol';
+export * from './annotations';
+export * from './document-compaction';
 export * from './migration-builder';
 export * from './migrations';
 //# sourceMappingURL=index.d.ts.map