@dxos/client-services 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.
Files changed (229) hide show
  1. package/dist/lib/browser/{chunk-FZDVFED2.mjs → chunk-KW4WMU5R.mjs} +2698 -4599
  2. package/dist/lib/browser/chunk-KW4WMU5R.mjs.map +7 -0
  3. package/dist/lib/browser/chunk-QCWEHHJW.mjs +24 -0
  4. package/dist/lib/browser/chunk-QCWEHHJW.mjs.map +7 -0
  5. package/dist/lib/browser/chunk-XJRPB3GA.mjs +22 -0
  6. package/dist/lib/browser/chunk-XJRPB3GA.mjs.map +7 -0
  7. package/dist/lib/browser/index.mjs +490 -228
  8. package/dist/lib/browser/index.mjs.map +4 -4
  9. package/dist/lib/browser/meta.json +1 -1
  10. package/dist/lib/browser/packlets/diagnostics/browser-diagnostics-broadcast.mjs +88 -0
  11. package/dist/lib/browser/packlets/diagnostics/browser-diagnostics-broadcast.mjs.map +7 -0
  12. package/dist/lib/browser/packlets/diagnostics/diagnostics-broadcast.mjs +11 -0
  13. package/dist/lib/browser/packlets/diagnostics/diagnostics-broadcast.mjs.map +7 -0
  14. package/dist/lib/browser/packlets/locks/browser.mjs +86 -0
  15. package/dist/lib/browser/packlets/locks/browser.mjs.map +7 -0
  16. package/dist/lib/browser/packlets/locks/node.mjs +48 -0
  17. package/dist/lib/browser/packlets/locks/node.mjs.map +7 -0
  18. package/dist/lib/browser/testing/index.mjs +60 -90
  19. package/dist/lib/browser/testing/index.mjs.map +3 -3
  20. package/dist/lib/node-esm/chunk-2DT3MZRL.mjs +22 -0
  21. package/dist/lib/node-esm/chunk-2DT3MZRL.mjs.map +7 -0
  22. package/dist/lib/node-esm/chunk-2SZHAWBN.mjs +24 -0
  23. package/dist/lib/node-esm/chunk-2SZHAWBN.mjs.map +7 -0
  24. package/dist/lib/node-esm/{chunk-JDTIU3EP.mjs → chunk-NDMKP2CH.mjs} +2621 -4391
  25. package/dist/lib/node-esm/chunk-NDMKP2CH.mjs.map +7 -0
  26. package/dist/lib/node-esm/index.mjs +490 -228
  27. package/dist/lib/node-esm/index.mjs.map +4 -4
  28. package/dist/lib/node-esm/meta.json +1 -1
  29. package/dist/lib/node-esm/packlets/diagnostics/browser-diagnostics-broadcast.mjs +88 -0
  30. package/dist/lib/node-esm/packlets/diagnostics/browser-diagnostics-broadcast.mjs.map +7 -0
  31. package/dist/lib/node-esm/packlets/diagnostics/diagnostics-broadcast.mjs +11 -0
  32. package/dist/lib/node-esm/packlets/diagnostics/diagnostics-broadcast.mjs.map +7 -0
  33. package/dist/lib/node-esm/packlets/locks/browser.mjs +86 -0
  34. package/dist/lib/node-esm/packlets/locks/browser.mjs.map +7 -0
  35. package/dist/lib/node-esm/packlets/locks/node.mjs +48 -0
  36. package/dist/lib/node-esm/packlets/locks/node.mjs.map +7 -0
  37. package/dist/lib/node-esm/testing/index.mjs +60 -90
  38. package/dist/lib/node-esm/testing/index.mjs.map +3 -3
  39. package/dist/types/src/index.d.ts +1 -0
  40. package/dist/types/src/index.d.ts.map +1 -1
  41. package/dist/types/src/packlets/agents/edge-agent-manager.d.ts +3 -2
  42. package/dist/types/src/packlets/agents/edge-agent-manager.d.ts.map +1 -1
  43. package/dist/types/src/packlets/agents/edge-agent-service.d.ts +2 -1
  44. package/dist/types/src/packlets/agents/edge-agent-service.d.ts.map +1 -1
  45. package/dist/types/src/packlets/devices/devices-service.d.ts.map +1 -1
  46. package/dist/types/src/packlets/devtools/devtools.d.ts +2 -2
  47. package/dist/types/src/packlets/devtools/devtools.d.ts.map +1 -1
  48. package/dist/types/src/packlets/devtools/feeds.d.ts.map +1 -1
  49. package/dist/types/src/packlets/devtools/keys.d.ts.map +1 -1
  50. package/dist/types/src/packlets/devtools/metadata.d.ts.map +1 -1
  51. package/dist/types/src/packlets/devtools/network.d.ts.map +1 -1
  52. package/dist/types/src/packlets/devtools/spaces.d.ts.map +1 -1
  53. package/dist/types/src/packlets/diagnostics/browser-diagnostics-broadcast.d.ts.map +1 -1
  54. package/dist/types/src/packlets/diagnostics/diagnostics-broadcast.d.ts.map +1 -1
  55. package/dist/types/src/packlets/diagnostics/diagnostics-collector.d.ts.map +1 -1
  56. package/dist/types/src/packlets/diagnostics/diagnostics.d.ts +2 -3
  57. package/dist/types/src/packlets/diagnostics/diagnostics.d.ts.map +1 -1
  58. package/dist/types/src/packlets/diagnostics/index.d.ts +1 -1
  59. package/dist/types/src/packlets/diagnostics/index.d.ts.map +1 -1
  60. package/dist/types/src/packlets/identity/authenticator.d.ts +2 -2
  61. package/dist/types/src/packlets/identity/authenticator.d.ts.map +1 -1
  62. package/dist/types/src/packlets/identity/contacts-service.d.ts.map +1 -1
  63. package/dist/types/src/packlets/identity/identity-manager.d.ts +6 -6
  64. package/dist/types/src/packlets/identity/identity-manager.d.ts.map +1 -1
  65. package/dist/types/src/packlets/identity/identity-recovery-manager.d.ts +8 -7
  66. package/dist/types/src/packlets/identity/identity-recovery-manager.d.ts.map +1 -1
  67. package/dist/types/src/packlets/identity/identity-service.d.ts +6 -10
  68. package/dist/types/src/packlets/identity/identity-service.d.ts.map +1 -1
  69. package/dist/types/src/packlets/identity/identity.d.ts +8 -11
  70. package/dist/types/src/packlets/identity/identity.d.ts.map +1 -1
  71. package/dist/types/src/packlets/invitations/device-invitation-protocol.d.ts +6 -5
  72. package/dist/types/src/packlets/invitations/device-invitation-protocol.d.ts.map +1 -1
  73. package/dist/types/src/packlets/invitations/edge-invitation-handler.d.ts +1 -1
  74. package/dist/types/src/packlets/invitations/edge-invitation-handler.d.ts.map +1 -1
  75. package/dist/types/src/packlets/invitations/invitation-guest-extenstion.d.ts.map +1 -1
  76. package/dist/types/src/packlets/invitations/invitation-host-extension.d.ts.map +1 -1
  77. package/dist/types/src/packlets/invitations/invitation-protocol.d.ts +7 -4
  78. package/dist/types/src/packlets/invitations/invitation-protocol.d.ts.map +1 -1
  79. package/dist/types/src/packlets/invitations/invitation-state.d.ts.map +1 -1
  80. package/dist/types/src/packlets/invitations/invitation-topology.d.ts.map +1 -1
  81. package/dist/types/src/packlets/invitations/invitations-handler.d.ts +4 -4
  82. package/dist/types/src/packlets/invitations/invitations-handler.d.ts.map +1 -1
  83. package/dist/types/src/packlets/invitations/invitations-manager.d.ts +3 -3
  84. package/dist/types/src/packlets/invitations/invitations-manager.d.ts.map +1 -1
  85. package/dist/types/src/packlets/invitations/invitations-service.d.ts +3 -3
  86. package/dist/types/src/packlets/invitations/invitations-service.d.ts.map +1 -1
  87. package/dist/types/src/packlets/invitations/space-invitation-protocol.d.ts +4 -3
  88. package/dist/types/src/packlets/invitations/space-invitation-protocol.d.ts.map +1 -1
  89. package/dist/types/src/packlets/invitations/utils.d.ts.map +1 -1
  90. package/dist/types/src/packlets/locks/browser.d.ts.map +1 -1
  91. package/dist/types/src/packlets/locks/index.d.ts +1 -1
  92. package/dist/types/src/packlets/locks/index.d.ts.map +1 -1
  93. package/dist/types/src/packlets/locks/node.d.ts.map +1 -1
  94. package/dist/types/src/packlets/logging/logging-service.d.ts +4 -0
  95. package/dist/types/src/packlets/logging/logging-service.d.ts.map +1 -1
  96. package/dist/types/src/packlets/network/network-service.d.ts +5 -4
  97. package/dist/types/src/packlets/network/network-service.d.ts.map +1 -1
  98. package/dist/types/src/packlets/services/client-rpc-server.d.ts +5 -5
  99. package/dist/types/src/packlets/services/client-rpc-server.d.ts.map +1 -1
  100. package/dist/types/src/packlets/services/feed-syncer.d.ts +59 -0
  101. package/dist/types/src/packlets/services/feed-syncer.d.ts.map +1 -0
  102. package/dist/types/src/packlets/services/feed-syncer.test.d.ts +2 -0
  103. package/dist/types/src/packlets/services/feed-syncer.test.d.ts.map +1 -0
  104. package/dist/types/src/packlets/services/platform.d.ts.map +1 -1
  105. package/dist/types/src/packlets/services/service-context.d.ts +13 -9
  106. package/dist/types/src/packlets/services/service-context.d.ts.map +1 -1
  107. package/dist/types/src/packlets/services/service-host.d.ts +20 -7
  108. package/dist/types/src/packlets/services/service-host.d.ts.map +1 -1
  109. package/dist/types/src/packlets/services/service-registry.d.ts.map +1 -1
  110. package/dist/types/src/packlets/services/util.d.ts.map +1 -1
  111. package/dist/types/src/packlets/space-export/archive-format.d.ts +9 -0
  112. package/dist/types/src/packlets/space-export/archive-format.d.ts.map +1 -0
  113. package/dist/types/src/packlets/space-export/index.d.ts +4 -1
  114. package/dist/types/src/packlets/space-export/index.d.ts.map +1 -1
  115. package/dist/types/src/packlets/space-export/serialized-space-reader.d.ts +23 -0
  116. package/dist/types/src/packlets/space-export/serialized-space-reader.d.ts.map +1 -0
  117. package/dist/types/src/packlets/space-export/serialized-space-writer.d.ts +36 -0
  118. package/dist/types/src/packlets/space-export/serialized-space-writer.d.ts.map +1 -0
  119. package/dist/types/src/packlets/space-export/space-archive-reader.d.ts +9 -1
  120. package/dist/types/src/packlets/space-export/space-archive-reader.d.ts.map +1 -1
  121. package/dist/types/src/packlets/space-export/space-archive-writer.d.ts +7 -1
  122. package/dist/types/src/packlets/space-export/space-archive-writer.d.ts.map +1 -1
  123. package/dist/types/src/packlets/space-export/space-archive.test.d.ts +2 -0
  124. package/dist/types/src/packlets/space-export/space-archive.test.d.ts.map +1 -0
  125. package/dist/types/src/packlets/spaces/automerge-space-state.d.ts.map +1 -1
  126. package/dist/types/src/packlets/spaces/data-space-manager.d.ts +28 -17
  127. package/dist/types/src/packlets/spaces/data-space-manager.d.ts.map +1 -1
  128. package/dist/types/src/packlets/spaces/data-space.d.ts +26 -9
  129. package/dist/types/src/packlets/spaces/data-space.d.ts.map +1 -1
  130. package/dist/types/src/packlets/spaces/edge-feed-replicator.d.ts +2 -2
  131. package/dist/types/src/packlets/spaces/edge-feed-replicator.d.ts.map +1 -1
  132. package/dist/types/src/packlets/spaces/epoch-migrations.d.ts.map +1 -1
  133. package/dist/types/src/packlets/spaces/genesis.d.ts +2 -1
  134. package/dist/types/src/packlets/spaces/genesis.d.ts.map +1 -1
  135. package/dist/types/src/packlets/spaces/notarization-plugin.d.ts +6 -9
  136. package/dist/types/src/packlets/spaces/notarization-plugin.d.ts.map +1 -1
  137. package/dist/types/src/packlets/spaces/spaces-service.d.ts +10 -7
  138. package/dist/types/src/packlets/spaces/spaces-service.d.ts.map +1 -1
  139. package/dist/types/src/packlets/storage/level.d.ts.map +1 -1
  140. package/dist/types/src/packlets/storage/profile-archive.d.ts.map +1 -1
  141. package/dist/types/src/packlets/storage/storage.d.ts.map +1 -1
  142. package/dist/types/src/packlets/storage/util.d.ts.map +1 -1
  143. package/dist/types/src/packlets/system/system-service.d.ts +1 -1
  144. package/dist/types/src/packlets/system/system-service.d.ts.map +1 -1
  145. package/dist/types/src/packlets/testing/credential-utils.d.ts.map +1 -1
  146. package/dist/types/src/packlets/testing/invitation-utils.d.ts +6 -3
  147. package/dist/types/src/packlets/testing/invitation-utils.d.ts.map +1 -1
  148. package/dist/types/src/packlets/testing/test-builder.d.ts +6 -5
  149. package/dist/types/src/packlets/testing/test-builder.d.ts.map +1 -1
  150. package/dist/types/src/packlets/worker/worker-runtime.d.ts +41 -4
  151. package/dist/types/src/packlets/worker/worker-runtime.d.ts.map +1 -1
  152. package/dist/types/src/packlets/worker/worker-session.d.ts +2 -4
  153. package/dist/types/src/packlets/worker/worker-session.d.ts.map +1 -1
  154. package/dist/types/src/testing/setup.d.ts.map +1 -1
  155. package/dist/types/src/version.d.ts +1 -1
  156. package/dist/types/src/version.d.ts.map +1 -1
  157. package/dist/types/tsconfig.tsbuildinfo +1 -1
  158. package/package.json +70 -55
  159. package/src/index.ts +1 -0
  160. package/src/packlets/agents/edge-agent-manager.ts +8 -5
  161. package/src/packlets/agents/edge-agent-service.ts +15 -3
  162. package/src/packlets/devices/devices-service.test.ts +0 -1
  163. package/src/packlets/devices/devices-service.ts +1 -1
  164. package/src/packlets/devtools/devtools.ts +2 -3
  165. package/src/packlets/diagnostics/diagnostics.ts +1 -2
  166. package/src/packlets/diagnostics/index.ts +1 -1
  167. package/src/packlets/identity/authenticator.ts +2 -2
  168. package/src/packlets/identity/contacts-service.ts +0 -1
  169. package/src/packlets/identity/identity-manager.test.ts +5 -5
  170. package/src/packlets/identity/identity-manager.ts +23 -22
  171. package/src/packlets/identity/identity-recovery-manager.ts +22 -18
  172. package/src/packlets/identity/identity-service.test.ts +6 -27
  173. package/src/packlets/identity/identity-service.ts +13 -81
  174. package/src/packlets/identity/identity.test.ts +6 -6
  175. package/src/packlets/identity/identity.ts +11 -34
  176. package/src/packlets/invitations/device-invitation-protocol.ts +8 -7
  177. package/src/packlets/invitations/edge-invitation-handler.ts +9 -5
  178. package/src/packlets/invitations/invitation-guest-extenstion.ts +6 -4
  179. package/src/packlets/invitations/invitation-host-extension.ts +13 -14
  180. package/src/packlets/invitations/invitation-protocol.ts +7 -4
  181. package/src/packlets/invitations/invitation-state.ts +1 -15
  182. package/src/packlets/invitations/invitations-handler.test.ts +4 -5
  183. package/src/packlets/invitations/invitations-handler.ts +74 -22
  184. package/src/packlets/invitations/invitations-manager.ts +40 -15
  185. package/src/packlets/invitations/invitations-service.ts +9 -9
  186. package/src/packlets/invitations/space-invitation-protocol.test.ts +17 -16
  187. package/src/packlets/invitations/space-invitation-protocol.ts +11 -16
  188. package/src/packlets/locks/index.ts +1 -1
  189. package/src/packlets/logging/logging-service.ts +20 -16
  190. package/src/packlets/network/network-service.test.ts +0 -1
  191. package/src/packlets/network/network-service.ts +10 -8
  192. package/src/packlets/services/client-rpc-server.ts +19 -16
  193. package/src/packlets/services/feed-syncer.test.ts +340 -0
  194. package/src/packlets/services/feed-syncer.ts +337 -0
  195. package/src/packlets/services/platform.ts +7 -1
  196. package/src/packlets/services/service-context.test.ts +3 -2
  197. package/src/packlets/services/service-context.ts +138 -56
  198. package/src/packlets/services/service-host.test.ts +8 -8
  199. package/src/packlets/services/service-host.ts +70 -40
  200. package/src/packlets/services/service-registry.test.ts +0 -1
  201. package/src/packlets/space-export/archive-format.ts +42 -0
  202. package/src/packlets/space-export/index.ts +4 -1
  203. package/src/packlets/space-export/serialized-space-reader.ts +111 -0
  204. package/src/packlets/space-export/serialized-space-writer.ts +253 -0
  205. package/src/packlets/space-export/space-archive-reader.ts +64 -3
  206. package/src/packlets/space-export/space-archive-writer.ts +41 -3
  207. package/src/packlets/space-export/space-archive.test.ts +461 -0
  208. package/src/packlets/spaces/data-space-manager.test.ts +79 -13
  209. package/src/packlets/spaces/data-space-manager.ts +115 -115
  210. package/src/packlets/spaces/data-space.ts +58 -33
  211. package/src/packlets/spaces/edge-feed-replicator.test.ts +2 -2
  212. package/src/packlets/spaces/edge-feed-replicator.ts +12 -10
  213. package/src/packlets/spaces/epoch-migrations.ts +5 -5
  214. package/src/packlets/spaces/genesis.ts +6 -1
  215. package/src/packlets/spaces/notarization-plugin.test.ts +2 -2
  216. package/src/packlets/spaces/notarization-plugin.ts +10 -9
  217. package/src/packlets/spaces/spaces-service.test.ts +18 -11
  218. package/src/packlets/spaces/spaces-service.ts +123 -24
  219. package/src/packlets/storage/storage.ts +4 -4
  220. package/src/packlets/testing/invitation-utils.ts +10 -6
  221. package/src/packlets/testing/test-builder.ts +36 -10
  222. package/src/packlets/worker/worker-runtime.ts +188 -17
  223. package/src/packlets/worker/worker-session.ts +12 -18
  224. package/src/version.ts +1 -1
  225. package/dist/lib/browser/chunk-FZDVFED2.mjs.map +0 -7
  226. package/dist/lib/node-esm/chunk-JDTIU3EP.mjs.map +0 -7
  227. package/dist/types/src/packlets/identity/default-space-state-machine.d.ts +0 -19
  228. package/dist/types/src/packlets/identity/default-space-state-machine.d.ts.map +0 -1
  229. package/src/packlets/identity/default-space-state-machine.ts +0 -44
@@ -0,0 +1,461 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import type { DocumentId } from '@automerge/automerge-repo';
6
+ import { describe, expect, test } from 'vitest';
7
+
8
+ import { type SerializedSpace } from '@dxos/echo-db';
9
+ import { ObjectId, SpaceId } from '@dxos/keys';
10
+ import {
11
+ FEED_ARCHIVE_BLOCKS_PER_CHUNK,
12
+ type FeedArchiveBlock,
13
+ SpaceArchiveFileStructure,
14
+ SpaceArchiveVersion,
15
+ } from '@dxos/protocols';
16
+ import { SpaceArchive } from '@dxos/protocols/proto/dxos/client/services';
17
+
18
+ import { detectSpaceArchiveFormat } from './archive-format';
19
+ import { buildDatabaseDirectoryFromObjects, readSerializedSpaceArchive } from './serialized-space-reader';
20
+ import { objectStructureToObjJson, orderObjJsonFields } from './serialized-space-writer';
21
+ import { extractSpaceArchive } from './space-archive-reader';
22
+ import { SpaceArchiveWriter } from './space-archive-writer';
23
+
24
+ describe('SpaceArchive', () => {
25
+ describe('SpaceArchiveWriter', () => {
26
+ test('writes and reads documents', async () => {
27
+ const writer = new SpaceArchiveWriter();
28
+ await writer.open();
29
+ try {
30
+ const spaceId = SpaceId.random();
31
+ await writer.begin({ spaceId });
32
+ await writer.setCurrentRootUrl('automerge:test123');
33
+ await writer.writeDocument('doc1', new Uint8Array([1, 2, 3]));
34
+ await writer.writeDocument('doc2', new Uint8Array([4, 5, 6]));
35
+
36
+ const archive = await writer.finish();
37
+
38
+ expect(archive.filename).toContain(spaceId);
39
+ expect(archive.contents).toBeInstanceOf(Uint8Array);
40
+
41
+ const extracted = await extractSpaceArchive(archive);
42
+ expect(extracted.metadata.version).toBe(SpaceArchiveVersion.V1);
43
+ expect(extracted.metadata.originalSpaceId).toBe(spaceId);
44
+ expect(extracted.metadata.echo?.currentRootUrl).toBe('automerge:test123');
45
+ expect(extracted.documents['doc1' as DocumentId]).toEqual(new Uint8Array([1, 2, 3]));
46
+ expect(extracted.documents['doc2' as DocumentId]).toEqual(new Uint8Array([4, 5, 6]));
47
+ } finally {
48
+ await writer.close();
49
+ }
50
+ });
51
+ });
52
+
53
+ describe('Feed Archive', () => {
54
+ test('writes and reads a single feed with blocks', async () => {
55
+ const writer = new SpaceArchiveWriter();
56
+ await writer.open();
57
+ try {
58
+ const spaceId = SpaceId.random();
59
+ await writer.begin({ spaceId });
60
+ await writer.setCurrentRootUrl('automerge:root');
61
+
62
+ const blocks: FeedArchiveBlock[] = [
63
+ {
64
+ actorId: 'actor1',
65
+ sequence: 0,
66
+ prevActorId: null,
67
+ prevSequence: null,
68
+ position: 0,
69
+ timestamp: 1000,
70
+ data: btoa('block0'),
71
+ },
72
+ {
73
+ actorId: 'actor1',
74
+ sequence: 1,
75
+ prevActorId: 'actor1',
76
+ prevSequence: 0,
77
+ position: 1,
78
+ timestamp: 2000,
79
+ data: btoa('block1'),
80
+ },
81
+ ];
82
+
83
+ await writer.writeFeed('feed-123', 'data', blocks);
84
+
85
+ const archive = await writer.finish();
86
+ const extracted = await extractSpaceArchive(archive);
87
+
88
+ expect(Object.keys(extracted.feeds)).toHaveLength(1);
89
+ expect(extracted.feeds['feed-123']).toBeDefined();
90
+ expect(extracted.feeds['feed-123'].metadata.id).toBe('feed-123');
91
+ expect(extracted.feeds['feed-123'].metadata.namespace).toBe('data');
92
+ expect(extracted.feeds['feed-123'].blocks).toHaveLength(2);
93
+ expect(extracted.feeds['feed-123'].blocks[0].actorId).toBe('actor1');
94
+ expect(extracted.feeds['feed-123'].blocks[0].sequence).toBe(0);
95
+ expect(extracted.feeds['feed-123'].blocks[1].sequence).toBe(1);
96
+ } finally {
97
+ await writer.close();
98
+ }
99
+ });
100
+
101
+ test('writes and reads multiple feeds', async () => {
102
+ const writer = new SpaceArchiveWriter();
103
+ await writer.open();
104
+ try {
105
+ const spaceId = SpaceId.random();
106
+ await writer.begin({ spaceId });
107
+ await writer.setCurrentRootUrl('automerge:root');
108
+
109
+ const dataBlocks: FeedArchiveBlock[] = [
110
+ {
111
+ actorId: 'actor1',
112
+ sequence: 0,
113
+ prevActorId: null,
114
+ prevSequence: null,
115
+ position: 0,
116
+ timestamp: 1000,
117
+ data: btoa('data-block'),
118
+ },
119
+ ];
120
+
121
+ const traceBlocks: FeedArchiveBlock[] = [
122
+ {
123
+ actorId: 'actor2',
124
+ sequence: 0,
125
+ prevActorId: null,
126
+ prevSequence: null,
127
+ position: 0,
128
+ timestamp: 2000,
129
+ data: btoa('trace-block'),
130
+ },
131
+ ];
132
+
133
+ await writer.writeFeed('feed-data', 'data', dataBlocks);
134
+ await writer.writeFeed('feed-trace', 'trace', traceBlocks);
135
+
136
+ const archive = await writer.finish();
137
+ const extracted = await extractSpaceArchive(archive);
138
+
139
+ expect(Object.keys(extracted.feeds)).toHaveLength(2);
140
+ expect(extracted.feeds['feed-data'].metadata.namespace).toBe('data');
141
+ expect(extracted.feeds['feed-trace'].metadata.namespace).toBe('trace');
142
+ } finally {
143
+ await writer.close();
144
+ }
145
+ });
146
+
147
+ test('writes blocks in chunks when exceeding chunk size', async () => {
148
+ const writer = new SpaceArchiveWriter();
149
+ await writer.open();
150
+ try {
151
+ const spaceId = SpaceId.random();
152
+ await writer.begin({ spaceId });
153
+ await writer.setCurrentRootUrl('automerge:root');
154
+
155
+ const numBlocks = FEED_ARCHIVE_BLOCKS_PER_CHUNK + 50;
156
+ const blocks: FeedArchiveBlock[] = [];
157
+ for (let i = 0; i < numBlocks; i++) {
158
+ blocks.push({
159
+ actorId: 'actor1',
160
+ sequence: i,
161
+ prevActorId: i > 0 ? 'actor1' : null,
162
+ prevSequence: i > 0 ? i - 1 : null,
163
+ position: i,
164
+ timestamp: 1000 + i,
165
+ data: btoa(`block-${i}`),
166
+ });
167
+ }
168
+
169
+ await writer.writeFeed('large-feed', 'data', blocks);
170
+
171
+ const archive = await writer.finish();
172
+ const extracted = await extractSpaceArchive(archive);
173
+
174
+ expect(extracted.feeds['large-feed'].blocks).toHaveLength(numBlocks);
175
+ expect(extracted.feeds['large-feed'].blocks[0].sequence).toBe(0);
176
+ expect(extracted.feeds['large-feed'].blocks[numBlocks - 1].sequence).toBe(numBlocks - 1);
177
+ } finally {
178
+ await writer.close();
179
+ }
180
+ });
181
+
182
+ test('handles empty feeds', async () => {
183
+ const writer = new SpaceArchiveWriter();
184
+ await writer.open();
185
+ try {
186
+ const spaceId = SpaceId.random();
187
+ await writer.begin({ spaceId });
188
+ await writer.setCurrentRootUrl('automerge:root');
189
+
190
+ await writer.writeFeed('empty-feed', 'data', []);
191
+
192
+ const archive = await writer.finish();
193
+ const extracted = await extractSpaceArchive(archive);
194
+
195
+ expect(extracted.feeds['empty-feed']).toBeDefined();
196
+ expect(extracted.feeds['empty-feed'].metadata.id).toBe('empty-feed');
197
+ expect(extracted.feeds['empty-feed'].blocks).toHaveLength(0);
198
+ } finally {
199
+ await writer.close();
200
+ }
201
+ });
202
+
203
+ test('preserves block data encoding', async () => {
204
+ const writer = new SpaceArchiveWriter();
205
+ await writer.open();
206
+ try {
207
+ const spaceId = SpaceId.random();
208
+ await writer.begin({ spaceId });
209
+ await writer.setCurrentRootUrl('automerge:root');
210
+
211
+ const originalData = new Uint8Array([0, 1, 2, 255, 128, 64]);
212
+ const base64Data = btoa(String.fromCharCode(...originalData));
213
+
214
+ const blocks: FeedArchiveBlock[] = [
215
+ {
216
+ actorId: 'actor1',
217
+ sequence: 0,
218
+ prevActorId: null,
219
+ prevSequence: null,
220
+ position: null,
221
+ timestamp: 1000,
222
+ data: base64Data,
223
+ },
224
+ ];
225
+
226
+ await writer.writeFeed('binary-feed', 'data', blocks);
227
+
228
+ const archive = await writer.finish();
229
+ const extracted = await extractSpaceArchive(archive);
230
+
231
+ const extractedData = extracted.feeds['binary-feed'].blocks[0].data;
232
+ expect(extractedData).toBe(base64Data);
233
+
234
+ const decoded = new Uint8Array(
235
+ atob(extractedData)
236
+ .split('')
237
+ .map((char) => char.charCodeAt(0)),
238
+ );
239
+ expect(decoded).toEqual(originalData);
240
+ } finally {
241
+ await writer.close();
242
+ }
243
+ });
244
+
245
+ test('combines documents and feeds in archive', async () => {
246
+ const writer = new SpaceArchiveWriter();
247
+ await writer.open();
248
+ try {
249
+ const spaceId = SpaceId.random();
250
+ await writer.begin({ spaceId });
251
+ await writer.setCurrentRootUrl('automerge:root');
252
+
253
+ await writer.writeDocument('doc1', new Uint8Array([1, 2, 3]));
254
+ await writer.writeFeed('feed1', 'data', [
255
+ {
256
+ actorId: 'actor1',
257
+ sequence: 0,
258
+ prevActorId: null,
259
+ prevSequence: null,
260
+ position: 0,
261
+ timestamp: 1000,
262
+ data: btoa('test'),
263
+ },
264
+ ]);
265
+
266
+ const archive = await writer.finish();
267
+ const extracted = await extractSpaceArchive(archive);
268
+
269
+ expect(Object.keys(extracted.documents)).toHaveLength(1);
270
+ expect(Object.keys(extracted.feeds)).toHaveLength(1);
271
+ expect(extracted.documents['doc1' as DocumentId]).toEqual(new Uint8Array([1, 2, 3]));
272
+ expect(extracted.feeds['feed1'].blocks).toHaveLength(1);
273
+ } finally {
274
+ await writer.close();
275
+ }
276
+ });
277
+ });
278
+
279
+ describe('File Structure', () => {
280
+ test('file structure constants are correct', () => {
281
+ expect(SpaceArchiveFileStructure.metadata).toBe('metadata.json');
282
+ expect(SpaceArchiveFileStructure.documents).toBe('documents');
283
+ expect(SpaceArchiveFileStructure.feeds).toBe('feeds');
284
+ expect(SpaceArchiveFileStructure.feedMetadata).toBe('metadata.json');
285
+ expect(SpaceArchiveFileStructure.feedBlocksPrefix).toBe('blocks-');
286
+ });
287
+
288
+ test('blocks per chunk constant is set', () => {
289
+ expect(FEED_ARCHIVE_BLOCKS_PER_CHUNK).toBe(100);
290
+ });
291
+ });
292
+
293
+ describe('detectSpaceArchiveFormat', () => {
294
+ test('detects JSON via .dx.json extension', () => {
295
+ const format = detectSpaceArchiveFormat({ filename: 'space.dx.json', contents: new Uint8Array() });
296
+ expect(format).toBe(SpaceArchive.Format.JSON);
297
+ });
298
+
299
+ test('detects JSON via .json extension', () => {
300
+ const format = detectSpaceArchiveFormat({ filename: 'backup.json', contents: new Uint8Array() });
301
+ expect(format).toBe(SpaceArchive.Format.JSON);
302
+ });
303
+
304
+ test('detects BINARY via .tar extension', () => {
305
+ const format = detectSpaceArchiveFormat({ filename: 'space.tar', contents: new Uint8Array() });
306
+ expect(format).toBe(SpaceArchive.Format.BINARY);
307
+ });
308
+
309
+ test('detects BINARY via .tar.gz extension', () => {
310
+ const format = detectSpaceArchiveFormat({ filename: 'space.tar.gz', contents: new Uint8Array() });
311
+ expect(format).toBe(SpaceArchive.Format.BINARY);
312
+ });
313
+
314
+ test('falls back to JSON via leading { byte', () => {
315
+ const contents = new TextEncoder().encode('{"version":1}');
316
+ const format = detectSpaceArchiveFormat({ filename: 'unknown', contents });
317
+ expect(format).toBe(SpaceArchive.Format.JSON);
318
+ });
319
+
320
+ test('skips leading whitespace before sniffing', () => {
321
+ const contents = new TextEncoder().encode(' \n\t{"version":1}');
322
+ const format = detectSpaceArchiveFormat({ filename: 'unknown', contents });
323
+ expect(format).toBe(SpaceArchive.Format.JSON);
324
+ });
325
+
326
+ test('falls back to BINARY on non-JSON bytes', () => {
327
+ const format = detectSpaceArchiveFormat({
328
+ filename: 'unknown',
329
+ contents: new Uint8Array([0x00, 0x01, 0x02]),
330
+ });
331
+ expect(format).toBe(SpaceArchive.Format.BINARY);
332
+ });
333
+ });
334
+
335
+ describe('SerializedSpace reader', () => {
336
+ test('parses a minimal JSON archive', () => {
337
+ const serialized: SerializedSpace = {
338
+ version: 1,
339
+ objects: [],
340
+ };
341
+ const contents = new TextEncoder().encode(JSON.stringify(serialized));
342
+ const archive: SpaceArchive = {
343
+ filename: 'test.dx.json',
344
+ contents,
345
+ format: SpaceArchive.Format.JSON,
346
+ };
347
+ const result = readSerializedSpaceArchive(archive);
348
+ expect(result.version).toBe(1);
349
+ expect(result.objects).toEqual([]);
350
+ });
351
+
352
+ test('rejects archives missing required fields', () => {
353
+ const bogus = new TextEncoder().encode(JSON.stringify({ objects: [] }));
354
+ expect(() =>
355
+ readSerializedSpaceArchive({
356
+ filename: 'bad.json',
357
+ contents: bogus,
358
+ format: SpaceArchive.Format.JSON,
359
+ }),
360
+ ).toThrow();
361
+ });
362
+
363
+ test('buildDatabaseDirectoryFromObjects round-trips data and type info', () => {
364
+ const id = ObjectId.random();
365
+ const objects = [
366
+ {
367
+ id,
368
+ '@type': 'dxn:type:example.Thing',
369
+ '@meta': { keys: [] },
370
+ title: 'hello',
371
+ },
372
+ ];
373
+ const directory = buildDatabaseDirectoryFromObjects(objects as any);
374
+ expect(directory.objects).toBeDefined();
375
+ const structure = directory.objects![id];
376
+ expect(structure).toBeDefined();
377
+ expect(structure.data).toEqual({ title: 'hello' });
378
+ expect(structure.system?.type).toEqual({ '/': 'dxn:type:example.Thing' });
379
+ expect(structure.system?.kind).toBe('object');
380
+ });
381
+
382
+ test('objectStructureToObjJson emits fields in canonical order', () => {
383
+ const id = ObjectId.random();
384
+ const sourceId = ObjectId.random();
385
+ const targetId = ObjectId.random();
386
+ const parentId = ObjectId.random();
387
+ const obj = objectStructureToObjJson(id, {
388
+ data: { title: 'hello', count: 42 },
389
+ meta: { keys: [] },
390
+ system: {
391
+ type: { '/': 'dxn:type:example.Link' },
392
+ kind: 'relation',
393
+ source: { '/': sourceId },
394
+ target: { '/': targetId },
395
+ parent: { '/': parentId },
396
+ deleted: true,
397
+ },
398
+ });
399
+
400
+ expect(Object.keys(obj)).toEqual([
401
+ 'id',
402
+ '@type',
403
+ '@meta',
404
+ '@deleted',
405
+ '@parent',
406
+ '@relationSource',
407
+ '@relationTarget',
408
+ 'title',
409
+ 'count',
410
+ ]);
411
+ });
412
+
413
+ test('orderObjJsonFields reorders feed queue messages with id/@type/@meta first', () => {
414
+ const id = ObjectId.random();
415
+ const message = {
416
+ payload: { value: 'x' },
417
+ timestamp: 1000,
418
+ id,
419
+ '@meta': { keys: [] },
420
+ '@type': 'dxn:type:example.Message',
421
+ } as any;
422
+
423
+ const ordered = orderObjJsonFields(message);
424
+ expect(Object.keys(ordered)).toEqual(['id', '@type', '@meta', 'payload', 'timestamp']);
425
+ expect(ordered).toEqual(message);
426
+ });
427
+
428
+ test('orderObjJsonFields preserves unknown @-prefixed fields between system and data', () => {
429
+ const id = ObjectId.random();
430
+ const obj = {
431
+ data: 1,
432
+ '@custom': 'extension',
433
+ '@type': 'dxn:type:example.Thing',
434
+ id,
435
+ } as any;
436
+
437
+ const ordered = orderObjJsonFields(obj);
438
+ expect(Object.keys(ordered)).toEqual(['id', '@type', '@custom', 'data']);
439
+ });
440
+
441
+ test('buildDatabaseDirectoryFromObjects flags relations', () => {
442
+ const id = ObjectId.random();
443
+ const sourceId = ObjectId.random();
444
+ const targetId = ObjectId.random();
445
+ const objects = [
446
+ {
447
+ id,
448
+ '@type': 'dxn:type:example.Link',
449
+ '@meta': { keys: [] },
450
+ '@relationSource': sourceId,
451
+ '@relationTarget': targetId,
452
+ },
453
+ ];
454
+ const directory = buildDatabaseDirectoryFromObjects(objects as any);
455
+ const structure = directory.objects![id];
456
+ expect(structure.system?.kind).toBe('relation');
457
+ expect(structure.system?.source).toEqual({ '/': sourceId });
458
+ expect(structure.system?.target).toEqual({ '/': targetId });
459
+ });
460
+ });
461
+ });
@@ -5,6 +5,7 @@
5
5
  import { describe, expect, test } from 'vitest';
6
6
 
7
7
  import { asyncTimeout, latch } from '@dxos/async';
8
+ import { Context } from '@dxos/context';
8
9
  import { createAdmissionCredentials } from '@dxos/credentials';
9
10
  import { AuthStatus } from '@dxos/echo-pipeline';
10
11
  import { writeMessages } from '@dxos/feed-store';
@@ -22,7 +23,7 @@ describe('DataSpaceManager', () => {
22
23
  await peer.createIdentity();
23
24
  await openAndClose(peer.echoHost, peer.dataSpaceManager);
24
25
 
25
- const space = await peer.dataSpaceManager.createSpace();
26
+ const space = await peer.dataSpaceManager.createSpace(new Context());
26
27
 
27
28
  // Process all written mutations.
28
29
  await space.inner.controlPipeline.state.waitUntilTimeframe(space.inner.controlPipeline.state.endTimeframe);
@@ -45,7 +46,7 @@ describe('DataSpaceManager', () => {
45
46
  await openAndClose(peer1.echoHost, peer1.dataSpaceManager, peer2.echoHost, peer2.dataSpaceManager);
46
47
  await connectReplicators([peer1, peer2]);
47
48
 
48
- const space1 = await peer1.dataSpaceManager.createSpace();
49
+ const space1 = await peer1.dataSpaceManager.createSpace(new Context());
49
50
  await space1.inner.controlPipeline.state.waitUntilTimeframe(space1.inner.controlPipeline.state.endTimeframe);
50
51
 
51
52
  // Admit peer2 to space1.
@@ -60,7 +61,7 @@ describe('DataSpaceManager', () => {
60
61
  );
61
62
 
62
63
  // Accept must be called after admission so that the peer can authenticate for notarization.
63
- const space2 = await peer2.dataSpaceManager.acceptSpace({
64
+ const space2 = await peer2.dataSpaceManager.acceptSpace(new Context(), {
64
65
  spaceKey: space1.key,
65
66
  genesisFeedKey: space1.inner.genesisFeedKey,
66
67
  });
@@ -115,7 +116,7 @@ describe('DataSpaceManager', () => {
115
116
  await openAndClose(peer1.echoHost, peer1.dataSpaceManager, peer2.echoHost, peer2.dataSpaceManager);
116
117
  await connectReplicators([peer1, peer2]);
117
118
 
118
- const space1 = await peer1.dataSpaceManager.createSpace();
119
+ const space1 = await peer1.dataSpaceManager.createSpace(new Context());
119
120
  await space1.inner.controlPipeline.state.waitUntilTimeframe(space1.inner.controlPipeline.state.endTimeframe);
120
121
 
121
122
  // Admit peer2 to space1.
@@ -130,7 +131,7 @@ describe('DataSpaceManager', () => {
130
131
  );
131
132
 
132
133
  // Accept must be called after admission so that the peer can authenticate for notarization.
133
- const space2 = await peer2.dataSpaceManager.acceptSpace({
134
+ const space2 = await peer2.dataSpaceManager.acceptSpace(new Context(), {
134
135
  spaceKey: space1.key,
135
136
  genesisFeedKey: space1.inner.genesisFeedKey,
136
137
  });
@@ -149,6 +150,71 @@ describe('DataSpaceManager', () => {
149
150
  await receivedMessage();
150
151
  });
151
152
 
153
+ test('create space with tags', async () => {
154
+ const builder = new TestBuilder();
155
+ const peer = builder.createPeer();
156
+ await peer.createIdentity();
157
+ await openAndClose(peer.echoHost, peer.dataSpaceManager);
158
+
159
+ const space = await peer.dataSpaceManager.createSpace(new Context(), { tags: ['personal', 'test'] });
160
+ await space.inner.controlPipeline.state.waitUntilTimeframe(space.inner.controlPipeline.state.endTimeframe);
161
+
162
+ expect(space.inner.spaceState.tags).toEqual(['personal', 'test']);
163
+ expect(space.inner.spaceState.genesisCredential).to.exist;
164
+ });
165
+
166
+ test('create space without tags has empty tags', async () => {
167
+ const builder = new TestBuilder();
168
+ const peer = builder.createPeer();
169
+ await peer.createIdentity();
170
+ await openAndClose(peer.echoHost, peer.dataSpaceManager);
171
+
172
+ const space = await peer.dataSpaceManager.createSpace(new Context());
173
+ await space.inner.controlPipeline.state.waitUntilTimeframe(space.inner.controlPipeline.state.endTimeframe);
174
+
175
+ expect(space.inner.spaceState.tags).toEqual([]);
176
+ });
177
+
178
+ test('tags propagate through peer admission', async () => {
179
+ const builder = new TestBuilder();
180
+ const peer1 = builder.createPeer();
181
+ await peer1.createIdentity();
182
+ const peer2 = builder.createPeer();
183
+ await peer2.createIdentity();
184
+
185
+ await openAndClose(peer1.echoHost, peer1.dataSpaceManager, peer2.echoHost, peer2.dataSpaceManager);
186
+ await connectReplicators([peer1, peer2]);
187
+
188
+ const space1 = await peer1.dataSpaceManager.createSpace(new Context(), { tags: ['personal'] });
189
+ await space1.inner.controlPipeline.state.waitUntilTimeframe(space1.inner.controlPipeline.state.endTimeframe);
190
+
191
+ // Admit peer2 to space1.
192
+ await writeMessages(
193
+ space1.inner.controlPipeline.writer,
194
+ await createAdmissionCredentials(
195
+ peer1.identity.credentialSigner,
196
+ peer2.identity.identityKey,
197
+ space1.key,
198
+ space1.inner.genesisFeedKey,
199
+ undefined, // role (default ADMIN)
200
+ undefined, // membershipChainHeads
201
+ undefined, // profile
202
+ undefined, // invitationCredentialId
203
+ space1.inner.spaceState.tags, // tags
204
+ ),
205
+ );
206
+
207
+ const space2 = await peer2.dataSpaceManager.acceptSpace(new Context(), {
208
+ spaceKey: space1.key,
209
+ genesisFeedKey: space1.inner.genesisFeedKey,
210
+ tags: space1.inner.spaceState.tags,
211
+ });
212
+ await peer2.dataSpaceManager.waitUntilSpaceReady(space2.key);
213
+
214
+ // Peer2's space should have the same tags.
215
+ expect(space2.inner.spaceState.tags).toEqual(['personal']);
216
+ });
217
+
152
218
  describe('activation', () => {
153
219
  test('can activate and deactivate a space', async () => {
154
220
  const builder = new TestBuilder();
@@ -157,14 +223,14 @@ describe('DataSpaceManager', () => {
157
223
  await peer.createIdentity();
158
224
  await openAndClose(peer.echoHost, peer.dataSpaceManager);
159
225
 
160
- const space = await peer.dataSpaceManager.createSpace();
226
+ const space = await peer.dataSpaceManager.createSpace(new Context());
161
227
  await space.inner.controlPipeline.state.waitUntilTimeframe(space.inner.controlPipeline.state.endTimeframe);
162
228
  expect(space.state).to.equal(SpaceState.SPACE_READY);
163
229
 
164
- await space.deactivate();
230
+ await space.deactivate(new Context());
165
231
  expect(space.state).to.equal(SpaceState.SPACE_INACTIVE);
166
232
 
167
- await space.activate();
233
+ await space.activate(new Context());
168
234
  await asyncTimeout(
169
235
  space.stateUpdate.waitForCondition(() => space.state === SpaceState.SPACE_READY),
170
236
  500,
@@ -178,12 +244,12 @@ describe('DataSpaceManager', () => {
178
244
  await peer.createIdentity();
179
245
  await openAndClose(peer.echoHost, peer.dataSpaceManager);
180
246
 
181
- await peer.dataSpaceManager.createSpace();
247
+ await peer.dataSpaceManager.createSpace(new Context());
182
248
  await reloadDataSpaces(peer);
183
249
 
184
250
  const space = getFirstSpace(peer);
185
251
  expect(space.state).to.equal(SpaceState.SPACE_CLOSED);
186
- await space.activate();
252
+ await space.activate(new Context());
187
253
  await asyncTimeout(
188
254
  space.stateUpdate.waitForCondition(() => space.state === SpaceState.SPACE_READY),
189
255
  500,
@@ -197,10 +263,10 @@ describe('DataSpaceManager', () => {
197
263
  await peer.createIdentity();
198
264
  await openAndClose(peer.echoHost, peer.dataSpaceManager);
199
265
 
200
- await peer.dataSpaceManager.createSpace();
266
+ await peer.dataSpaceManager.createSpace(new Context());
201
267
  await reloadDataSpaces(peer);
202
268
 
203
- await getFirstSpace(peer).deactivate();
269
+ await getFirstSpace(peer).deactivate(new Context());
204
270
 
205
271
  await reloadDataSpaces(peer);
206
272
 
@@ -209,7 +275,7 @@ describe('DataSpaceManager', () => {
209
275
  });
210
276
 
211
277
  const connectReplicators = (peers: TestPeer[]) => {
212
- return Promise.all(peers.map((peer) => peer.echoHost.addReplicator(peer.meshEchoReplicator)));
278
+ return Promise.all(peers.map((peer) => peer.echoHost.addReplicator(Context.default(), peer.meshEchoReplicator)));
213
279
  };
214
280
 
215
281
  const reloadDataSpaces = async (peer: TestPeer) => {