@dxos/migrations 0.8.4-main.a4bbb77 → 0.8.4-main.abd8ff62ef
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/lib/browser/index.mjs +71 -135
- package/dist/lib/browser/index.mjs.map +3 -3
- package/dist/lib/browser/meta.json +1 -1
- package/dist/lib/node-esm/index.mjs +71 -135
- package/dist/lib/node-esm/index.mjs.map +3 -3
- package/dist/lib/node-esm/meta.json +1 -1
- package/dist/types/src/migration-builder.d.ts +4 -4
- package/dist/types/src/migration-builder.d.ts.map +1 -1
- package/dist/types/src/migrations.d.ts +2 -1
- package/dist/types/src/migrations.d.ts.map +1 -1
- package/dist/types/tsconfig.tsbuildinfo +1 -1
- package/package.json +18 -16
- package/src/migration-builder.ts +32 -31
- package/src/migrations.test.ts +25 -17
- package/src/migrations.ts +14 -6
package/README.md
CHANGED
|
@@ -1,25 +1,26 @@
|
|
|
1
1
|
// src/migration-builder.ts
|
|
2
|
-
import { next as
|
|
2
|
+
import { next as A } from "@automerge/automerge";
|
|
3
3
|
import { CreateEpochRequest } from "@dxos/client/halo";
|
|
4
4
|
import { ObjectCore, migrateDocument } from "@dxos/echo-db";
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
5
|
+
import { EncodedReference, SpaceDocVersion } from "@dxos/echo-protocol";
|
|
6
|
+
import { getSchemaDXN } from "@dxos/echo/internal";
|
|
7
7
|
import { invariant } from "@dxos/invariant";
|
|
8
|
-
|
|
9
|
-
if (key in obj) {
|
|
10
|
-
Object.defineProperty(obj, key, {
|
|
11
|
-
value,
|
|
12
|
-
enumerable: true,
|
|
13
|
-
configurable: true,
|
|
14
|
-
writable: true
|
|
15
|
-
});
|
|
16
|
-
} else {
|
|
17
|
-
obj[key] = value;
|
|
18
|
-
}
|
|
19
|
-
return obj;
|
|
20
|
-
}
|
|
8
|
+
import { DXN } from "@dxos/keys";
|
|
21
9
|
var __dxlog_file = "/__w/dxos/dxos/packages/sdk/migrations/src/migration-builder.ts";
|
|
22
10
|
var MigrationBuilder = class {
|
|
11
|
+
_space;
|
|
12
|
+
_repo;
|
|
13
|
+
_rootDoc;
|
|
14
|
+
// echoId -> automergeUrl
|
|
15
|
+
_newLinks = {};
|
|
16
|
+
_flushIds = [];
|
|
17
|
+
_deleteObjects = [];
|
|
18
|
+
_newRoot = void 0;
|
|
19
|
+
constructor(_space) {
|
|
20
|
+
this._space = _space;
|
|
21
|
+
this._repo = this._space.internal.db.coreDatabase._repo;
|
|
22
|
+
this._rootDoc = this._space.internal.db.coreDatabase._automergeDocLoader.getSpaceRootDocHandle().doc();
|
|
23
|
+
}
|
|
23
24
|
async findObject(id) {
|
|
24
25
|
const documentId = (this._rootDoc.links?.[id] || this._newLinks[id])?.toString();
|
|
25
26
|
const docHandle = documentId && this._repo.find(documentId);
|
|
@@ -37,15 +38,7 @@ var MigrationBuilder = class {
|
|
|
37
38
|
}
|
|
38
39
|
const { schema, props } = await migrate(objectStructure);
|
|
39
40
|
const oldHandle = await this._findObjectContainingHandle(id);
|
|
40
|
-
invariant(oldHandle, void 0, {
|
|
41
|
-
F: __dxlog_file,
|
|
42
|
-
L: 84,
|
|
43
|
-
S: this,
|
|
44
|
-
A: [
|
|
45
|
-
"oldHandle",
|
|
46
|
-
""
|
|
47
|
-
]
|
|
48
|
-
});
|
|
41
|
+
invariant(oldHandle, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 59, S: this, A: ["oldHandle", ""] });
|
|
49
42
|
const newState = {
|
|
50
43
|
version: SpaceDocVersion.CURRENT,
|
|
51
44
|
access: {
|
|
@@ -54,7 +47,7 @@ var MigrationBuilder = class {
|
|
|
54
47
|
objects: {
|
|
55
48
|
[id]: {
|
|
56
49
|
system: {
|
|
57
|
-
type:
|
|
50
|
+
type: EncodedReference.fromDXN(getSchemaDXN(schema))
|
|
58
51
|
},
|
|
59
52
|
data: props,
|
|
60
53
|
meta: {
|
|
@@ -64,59 +57,47 @@ var MigrationBuilder = class {
|
|
|
64
57
|
}
|
|
65
58
|
};
|
|
66
59
|
const migratedDoc = migrateDocument(oldHandle.doc(), newState);
|
|
67
|
-
const newHandle = this._repo.import(
|
|
60
|
+
const newHandle = this._repo.import(A.save(migratedDoc));
|
|
61
|
+
await newHandle.whenReady();
|
|
62
|
+
invariant(newHandle.url, "Migrated document URL not available after whenReady", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 80, S: this, A: ["newHandle.url", "'Migrated document URL not available after whenReady'"] });
|
|
68
63
|
this._newLinks[id] = newHandle.url;
|
|
69
|
-
this._addHandleToFlushList(newHandle);
|
|
64
|
+
this._addHandleToFlushList(newHandle.documentId);
|
|
70
65
|
}
|
|
71
66
|
async addObject(schema, props) {
|
|
72
|
-
const core = this._createObject({
|
|
67
|
+
const core = await this._createObject({
|
|
73
68
|
schema,
|
|
74
69
|
props
|
|
75
70
|
});
|
|
76
71
|
return core.id;
|
|
77
72
|
}
|
|
78
73
|
createReference(id) {
|
|
79
|
-
return
|
|
74
|
+
return EncodedReference.fromDXN(DXN.fromLocalObjectId(id));
|
|
80
75
|
}
|
|
81
76
|
deleteObject(id) {
|
|
82
77
|
this._deleteObjects.push(id);
|
|
83
78
|
}
|
|
84
|
-
changeProperties(changeFn) {
|
|
79
|
+
async changeProperties(changeFn) {
|
|
85
80
|
if (!this._newRoot) {
|
|
86
|
-
this._buildNewRoot();
|
|
81
|
+
await this._buildNewRoot();
|
|
87
82
|
}
|
|
88
|
-
invariant(this._newRoot, "New root not created", {
|
|
89
|
-
F: __dxlog_file,
|
|
90
|
-
L: 126,
|
|
91
|
-
S: this,
|
|
92
|
-
A: [
|
|
93
|
-
"this._newRoot",
|
|
94
|
-
"'New root not created'"
|
|
95
|
-
]
|
|
96
|
-
});
|
|
83
|
+
invariant(this._newRoot, "New root not created", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 101, S: this, A: ["this._newRoot", "'New root not created'"] });
|
|
97
84
|
this._newRoot.change((doc) => {
|
|
98
85
|
const propertiesStructure = doc.objects?.[this._space.properties.id];
|
|
99
86
|
propertiesStructure && changeFn(propertiesStructure);
|
|
100
87
|
});
|
|
101
|
-
this.
|
|
88
|
+
await this._newRoot.whenReady();
|
|
89
|
+
this._addHandleToFlushList(this._newRoot.documentId);
|
|
102
90
|
}
|
|
103
91
|
/**
|
|
104
92
|
* @internal
|
|
105
93
|
*/
|
|
106
94
|
async _commit() {
|
|
107
95
|
if (!this._newRoot) {
|
|
108
|
-
this._buildNewRoot();
|
|
96
|
+
await this._buildNewRoot();
|
|
109
97
|
}
|
|
110
|
-
invariant(this._newRoot, "New root not created", {
|
|
111
|
-
F: __dxlog_file,
|
|
112
|
-
L: 142,
|
|
113
|
-
S: this,
|
|
114
|
-
A: [
|
|
115
|
-
"this._newRoot",
|
|
116
|
-
"'New root not created'"
|
|
117
|
-
]
|
|
118
|
-
});
|
|
98
|
+
invariant(this._newRoot, "New root not created", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 115, S: this, A: ["this._newRoot", "'New root not created'"] });
|
|
119
99
|
await this._space.db.flush();
|
|
100
|
+
invariant(this._newRoot.url, "New root URL not available", { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 118, S: this, A: ["this._newRoot.url", "'New root URL not available'"] });
|
|
120
101
|
await this._space.internal.createEpoch({
|
|
121
102
|
migration: CreateEpochRequest.Migration.REPLACE_AUTOMERGE_ROOT,
|
|
122
103
|
automergeRootUrl: this._newRoot.url
|
|
@@ -131,7 +112,7 @@ var MigrationBuilder = class {
|
|
|
131
112
|
await docHandle.whenReady();
|
|
132
113
|
return docHandle;
|
|
133
114
|
}
|
|
134
|
-
_buildNewRoot() {
|
|
115
|
+
async _buildNewRoot() {
|
|
135
116
|
const links = {
|
|
136
117
|
...this._rootDoc.links ?? {}
|
|
137
118
|
};
|
|
@@ -139,7 +120,7 @@ var MigrationBuilder = class {
|
|
|
139
120
|
delete links[id];
|
|
140
121
|
}
|
|
141
122
|
for (const [id, url] of Object.entries(this._newLinks)) {
|
|
142
|
-
links[id] = new
|
|
123
|
+
links[id] = new A.RawString(url);
|
|
143
124
|
}
|
|
144
125
|
this._newRoot = this._repo.create({
|
|
145
126
|
version: SpaceDocVersion.CURRENT,
|
|
@@ -149,15 +130,16 @@ var MigrationBuilder = class {
|
|
|
149
130
|
objects: this._rootDoc.objects,
|
|
150
131
|
links
|
|
151
132
|
});
|
|
152
|
-
this.
|
|
133
|
+
await this._newRoot.whenReady();
|
|
134
|
+
this._addHandleToFlushList(this._newRoot.documentId);
|
|
153
135
|
}
|
|
154
|
-
_createObject({ id, schema, props }) {
|
|
136
|
+
async _createObject({ id, schema, props }) {
|
|
155
137
|
const core = new ObjectCore();
|
|
156
138
|
if (id) {
|
|
157
139
|
core.id = id;
|
|
158
140
|
}
|
|
159
141
|
core.initNewObject(props);
|
|
160
|
-
core.setType(
|
|
142
|
+
core.setType(EncodedReference.fromDXN(getSchemaDXN(schema)));
|
|
161
143
|
const newHandle = this._repo.create({
|
|
162
144
|
version: SpaceDocVersion.CURRENT,
|
|
163
145
|
access: {
|
|
@@ -167,49 +149,29 @@ var MigrationBuilder = class {
|
|
|
167
149
|
[core.id]: core.getDoc()
|
|
168
150
|
}
|
|
169
151
|
});
|
|
152
|
+
await newHandle.whenReady();
|
|
170
153
|
this._newLinks[core.id] = newHandle.url;
|
|
171
|
-
this._addHandleToFlushList(newHandle);
|
|
154
|
+
this._addHandleToFlushList(newHandle.documentId);
|
|
172
155
|
return core;
|
|
173
156
|
}
|
|
174
|
-
_addHandleToFlushList(
|
|
175
|
-
this._flushIds.push(
|
|
176
|
-
}
|
|
177
|
-
constructor(_space) {
|
|
178
|
-
_define_property(this, "_space", void 0);
|
|
179
|
-
_define_property(this, "_repo", void 0);
|
|
180
|
-
_define_property(this, "_rootDoc", void 0);
|
|
181
|
-
_define_property(this, "_newLinks", void 0);
|
|
182
|
-
_define_property(this, "_flushIds", void 0);
|
|
183
|
-
_define_property(this, "_deleteObjects", void 0);
|
|
184
|
-
_define_property(this, "_newRoot", void 0);
|
|
185
|
-
this._space = _space;
|
|
186
|
-
this._newLinks = {};
|
|
187
|
-
this._flushIds = [];
|
|
188
|
-
this._deleteObjects = [];
|
|
189
|
-
this._newRoot = void 0;
|
|
190
|
-
this._repo = this._space.db.coreDatabase._repo;
|
|
191
|
-
this._rootDoc = this._space.db.coreDatabase._automergeDocLoader.getSpaceRootDocHandle().doc();
|
|
157
|
+
_addHandleToFlushList(id) {
|
|
158
|
+
this._flushIds.push(id);
|
|
192
159
|
}
|
|
193
160
|
};
|
|
194
161
|
|
|
195
162
|
// src/migrations.ts
|
|
196
|
-
import {
|
|
163
|
+
import { Atom } from "@effect-atom/atom";
|
|
164
|
+
import * as Registry from "@effect-atom/atom/Registry";
|
|
165
|
+
import { SpaceState } from "@dxos/client/echo";
|
|
197
166
|
import { invariant as invariant2 } from "@dxos/invariant";
|
|
198
|
-
function _define_property2(obj, key, value) {
|
|
199
|
-
if (key in obj) {
|
|
200
|
-
Object.defineProperty(obj, key, {
|
|
201
|
-
value,
|
|
202
|
-
enumerable: true,
|
|
203
|
-
configurable: true,
|
|
204
|
-
writable: true
|
|
205
|
-
});
|
|
206
|
-
} else {
|
|
207
|
-
obj[key] = value;
|
|
208
|
-
}
|
|
209
|
-
return obj;
|
|
210
|
-
}
|
|
211
167
|
var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/migrations/src/migrations.ts";
|
|
212
168
|
var Migrations = class {
|
|
169
|
+
static namespace;
|
|
170
|
+
static migrations = [];
|
|
171
|
+
static _registry = Registry.make();
|
|
172
|
+
static _stateAtom = Atom.make({
|
|
173
|
+
running: []
|
|
174
|
+
}).pipe(Atom.keepAlive);
|
|
213
175
|
static get versionProperty() {
|
|
214
176
|
return this.namespace && `${this.namespace}.version`;
|
|
215
177
|
}
|
|
@@ -217,40 +179,17 @@ var Migrations = class {
|
|
|
217
179
|
return this.migrations[this.migrations.length - 1]?.version;
|
|
218
180
|
}
|
|
219
181
|
static running(space) {
|
|
220
|
-
|
|
182
|
+
const state = this._registry.get(this._stateAtom);
|
|
183
|
+
return state.running.includes(space.key.toHex());
|
|
221
184
|
}
|
|
222
185
|
static define(namespace, migrations) {
|
|
223
186
|
this.namespace = namespace;
|
|
224
187
|
this.migrations = migrations;
|
|
225
188
|
}
|
|
226
189
|
static async migrate(space, targetVersion) {
|
|
227
|
-
invariant2(!this.running(space), "Migration already running", {
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
S: this,
|
|
231
|
-
A: [
|
|
232
|
-
"!this.running(space)",
|
|
233
|
-
"'Migration already running'"
|
|
234
|
-
]
|
|
235
|
-
});
|
|
236
|
-
invariant2(this.versionProperty, "Migrations namespace not set", {
|
|
237
|
-
F: __dxlog_file2,
|
|
238
|
-
L: 45,
|
|
239
|
-
S: this,
|
|
240
|
-
A: [
|
|
241
|
-
"this.versionProperty",
|
|
242
|
-
"'Migrations namespace not set'"
|
|
243
|
-
]
|
|
244
|
-
});
|
|
245
|
-
invariant2(space.state.get() === SpaceState.SPACE_READY, "Space not ready", {
|
|
246
|
-
F: __dxlog_file2,
|
|
247
|
-
L: 46,
|
|
248
|
-
S: this,
|
|
249
|
-
A: [
|
|
250
|
-
"space.state.get() === SpaceState.SPACE_READY",
|
|
251
|
-
"'Space not ready'"
|
|
252
|
-
]
|
|
253
|
-
});
|
|
190
|
+
invariant2(!this.running(space), "Migration already running", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 31, S: this, A: ["!this.running(space)", "'Migration already running'"] });
|
|
191
|
+
invariant2(this.versionProperty, "Migrations namespace not set", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 32, S: this, A: ["this.versionProperty", "'Migrations namespace not set'"] });
|
|
192
|
+
invariant2(space.state.get() === SpaceState.SPACE_READY, "Space not ready", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 33, S: this, A: ["space.state.get() === SpaceState.SPACE_READY", "'Space not ready'"] });
|
|
254
193
|
const currentVersion = space.properties[this.versionProperty];
|
|
255
194
|
const currentIndex = this.migrations.findIndex((m) => m.version === currentVersion) + 1;
|
|
256
195
|
const i = this.migrations.findIndex((m) => m.version === targetVersion);
|
|
@@ -258,7 +197,14 @@ var Migrations = class {
|
|
|
258
197
|
if (currentIndex === targetIndex) {
|
|
259
198
|
return false;
|
|
260
199
|
}
|
|
261
|
-
|
|
200
|
+
const spaceKey = space.key.toHex();
|
|
201
|
+
const currentState = this._registry.get(this._stateAtom);
|
|
202
|
+
this._registry.set(this._stateAtom, {
|
|
203
|
+
running: [
|
|
204
|
+
...currentState.running,
|
|
205
|
+
spaceKey
|
|
206
|
+
]
|
|
207
|
+
});
|
|
262
208
|
if (targetIndex > currentIndex) {
|
|
263
209
|
const migrations = this.migrations.slice(currentIndex, targetIndex);
|
|
264
210
|
for (const migration of migrations) {
|
|
@@ -267,30 +213,20 @@ var Migrations = class {
|
|
|
267
213
|
space,
|
|
268
214
|
builder
|
|
269
215
|
});
|
|
270
|
-
builder.changeProperties((propertiesStructure) => {
|
|
271
|
-
invariant2(this.versionProperty, "Migrations namespace not set", {
|
|
272
|
-
F: __dxlog_file2,
|
|
273
|
-
L: 62,
|
|
274
|
-
S: this,
|
|
275
|
-
A: [
|
|
276
|
-
"this.versionProperty",
|
|
277
|
-
"'Migrations namespace not set'"
|
|
278
|
-
]
|
|
279
|
-
});
|
|
216
|
+
await builder.changeProperties((propertiesStructure) => {
|
|
217
|
+
invariant2(this.versionProperty, "Migrations namespace not set", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 58, S: this, A: ["this.versionProperty", "'Migrations namespace not set'"] });
|
|
280
218
|
propertiesStructure.data[this.versionProperty] = migration.version;
|
|
281
219
|
});
|
|
282
220
|
await builder._commit();
|
|
283
221
|
}
|
|
284
222
|
}
|
|
285
|
-
this.
|
|
223
|
+
const finalState = this._registry.get(this._stateAtom);
|
|
224
|
+
this._registry.set(this._stateAtom, {
|
|
225
|
+
running: finalState.running.filter((key) => key !== spaceKey)
|
|
226
|
+
});
|
|
286
227
|
return true;
|
|
287
228
|
}
|
|
288
229
|
};
|
|
289
|
-
_define_property2(Migrations, "namespace", void 0);
|
|
290
|
-
_define_property2(Migrations, "migrations", []);
|
|
291
|
-
_define_property2(Migrations, "_state", live({
|
|
292
|
-
running: []
|
|
293
|
-
}));
|
|
294
230
|
export {
|
|
295
231
|
MigrationBuilder,
|
|
296
232
|
Migrations
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../src/migration-builder.ts", "../../../src/migrations.ts"],
|
|
4
|
-
"sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport {
|
|
5
|
-
"mappings": ";AAIA,
|
|
6
|
-
"names": ["next", "
|
|
4
|
+
"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 { type DocHandleProxy, ObjectCore, type RepoProxy, migrateDocument } from '@dxos/echo-db';\nimport { type DatabaseDirectory, EncodedReference, type ObjectStructure, SpaceDocVersion } from '@dxos/echo-protocol';\nimport { getSchemaDXN } from '@dxos/echo/internal';\nimport { invariant } from '@dxos/invariant';\nimport { DXN } 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 // 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.internal.db.coreDatabase._repo;\n // TODO(wittjosiah): Accessing private API.\n this._rootDoc = (this._space.internal.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: EncodedReference.fromDXN(getSchemaDXN(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(schema: Schema.Schema.AnyNoContext, props: any): Promise<string> {\n const core = await this._createObject({ schema, props });\n return core.id;\n }\n\n createReference(id: string) {\n return EncodedReference.fromDXN(DXN.fromLocalObjectId(id));\n }\n\n deleteObject(id: string): void {\n this._deleteObjects.push(id);\n }\n\n async changeProperties(changeFn: (properties: ObjectStructure) => 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.fromDXN(getSchemaDXN(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 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';\n\nimport { type Space, SpaceState } 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 _registry = Registry.make();\n private static _stateAtom = Atom.make<{ running: string[] }>({ running: [] }).pipe(Atom.keepAlive);\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(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 const spaceKey = space.key.toHex();\n const currentState = this._registry.get(this._stateAtom);\n this._registry.set(this._stateAtom, { running: [...currentState.running, spaceKey] });\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.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 const finalState = this._registry.get(this._stateAtom);\n this._registry.set(this._stateAtom, { running: finalState.running.filter((key) => key !== spaceKey) });\n\n return true;\n }\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["next", "A", "CreateEpochRequest", "ObjectCore", "migrateDocument", "EncodedReference", "SpaceDocVersion", "getSchemaDXN", "invariant", "DXN", "_repo", "_rootDoc", "_newLinks", "_deleteObjects", "_newRoot", "undefined", "_space", "internal", "db", "coreDatabase", "findObject", "docHandle", "objects", "migrateObject", "migrate", "objectStructure", "oldHandle", "newState", "version", "access", "spaceKey", "system", "data", "props", "meta", "keys", "newHandle", "whenReady", "id", "_addHandleToFlushList", "addObject", "schema", "createReference", "deleteObject", "changeProperties", "changeFn", "_buildNewRoot", "propertiesStructure", "properties", "migration", "REPLACE_AUTOMERGE_ROOT", "automergeRootUrl", "documentId", "url", "create", "links", "_createObject", "core", "initNewObject", "CURRENT", "Atom", "Registry", "SpaceState", "invariant", "__dxlog_file", "Migrations", "migrations", "_registry", "_stateAtom", "Atom", "running", "keepAlive", "versionProperty", "namespace", "targetVersion", "space", "state", "define", "invariant", "get", "SpaceState", "currentVersion", "properties", "currentIndex", "findIndex", "version", "i", "m", "targetIndex", "length", "spaceKey", "set", "currentState", "migration", "builder", "MigrationBuilder", "propertiesStructure", "finalState", "filter", "key"]
|
|
7
7
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"inputs":{"src/migration-builder.ts":{"bytes":
|
|
1
|
+
{"inputs":{"src/migration-builder.ts":{"bytes":23409,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/client/halo","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/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true}],"format":"esm"},"src/migrations.ts":{"bytes":10982,"imports":[{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@effect-atom/atom/Registry","kind":"import-statement","external":true},{"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":575,"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":16635},"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-db","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/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":"@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":5430},"src/index.ts":{"bytesInOutput":0},"src/migrations.ts":{"bytesInOutput":3055}},"bytes":8615}}}
|