@dxos/protocols 0.8.4-main.72ec0f3 → 0.8.4-main.74a063c4e0

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 (252) hide show
  1. package/README.md +1 -1
  2. package/dist/src/FeedProtocol.d.ts +528 -0
  3. package/dist/src/FeedProtocol.d.ts.map +1 -0
  4. package/dist/src/FeedProtocol.js +237 -0
  5. package/dist/src/FeedProtocol.js.map +1 -0
  6. package/dist/src/FunctionProtocol.d.ts +8 -2
  7. package/dist/src/FunctionProtocol.d.ts.map +1 -1
  8. package/dist/src/buf/proto/gen/dxos/client/queue_pb.d.ts +231 -0
  9. package/dist/src/buf/proto/gen/dxos/client/queue_pb.d.ts.map +1 -0
  10. package/dist/src/buf/proto/gen/dxos/client/queue_pb.js +44 -0
  11. package/dist/src/buf/proto/gen/dxos/client/queue_pb.js.map +1 -0
  12. package/dist/src/buf/proto/gen/dxos/client/services_pb.d.ts +33 -3
  13. package/dist/src/buf/proto/gen/dxos/client/services_pb.d.ts.map +1 -1
  14. package/dist/src/buf/proto/gen/dxos/client/services_pb.js +46 -37
  15. package/dist/src/buf/proto/gen/dxos/client/services_pb.js.map +1 -1
  16. package/dist/src/buf/proto/gen/dxos/echo/metadata_pb.d.ts +6 -0
  17. package/dist/src/buf/proto/gen/dxos/echo/metadata_pb.d.ts.map +1 -1
  18. package/dist/src/buf/proto/gen/dxos/echo/metadata_pb.js +1 -1
  19. package/dist/src/buf/proto/gen/dxos/echo/metadata_pb.js.map +1 -1
  20. package/dist/src/buf/proto/gen/dxos/echo/query_pb.d.ts +12 -2
  21. package/dist/src/buf/proto/gen/dxos/echo/query_pb.d.ts.map +1 -1
  22. package/dist/src/buf/proto/gen/dxos/echo/query_pb.js +1 -1
  23. package/dist/src/buf/proto/gen/dxos/echo/query_pb.js.map +1 -1
  24. package/dist/src/buf/proto/gen/dxos/echo/service_pb.d.ts +55 -9
  25. package/dist/src/buf/proto/gen/dxos/echo/service_pb.d.ts.map +1 -1
  26. package/dist/src/buf/proto/gen/dxos/echo/service_pb.js +15 -5
  27. package/dist/src/buf/proto/gen/dxos/echo/service_pb.js.map +1 -1
  28. package/dist/src/buf/proto/gen/dxos/edge/messenger_pb.d.ts +28 -0
  29. package/dist/src/buf/proto/gen/dxos/edge/messenger_pb.d.ts.map +1 -1
  30. package/dist/src/buf/proto/gen/dxos/edge/messenger_pb.js +10 -5
  31. package/dist/src/buf/proto/gen/dxos/edge/messenger_pb.js.map +1 -1
  32. package/dist/src/buf/proto/gen/dxos/google_pb.js +1 -1
  33. package/dist/src/buf/proto/gen/dxos/google_pb.js.map +1 -1
  34. package/dist/src/buf/proto/gen/dxos/halo/credentials_pb.d.ts +39 -0
  35. package/dist/src/buf/proto/gen/dxos/halo/credentials_pb.d.ts.map +1 -1
  36. package/dist/src/buf/proto/gen/dxos/halo/credentials_pb.js +27 -2
  37. package/dist/src/buf/proto/gen/dxos/halo/credentials_pb.js.map +1 -1
  38. package/dist/src/buf/proto/gen/dxos/iframe_pb.d.ts +1 -0
  39. package/dist/src/buf/proto/gen/dxos/iframe_pb.d.ts.map +1 -1
  40. package/dist/src/buf/proto/gen/dxos/iframe_pb.js.map +1 -1
  41. package/dist/src/buf/proto/gen/dxos/tracing_pb.js +1 -1
  42. package/dist/src/buf/proto/gen/dxos/tracing_pb.js.map +1 -1
  43. package/dist/src/codec.test.js +1 -1
  44. package/dist/src/edge/EdgeFunctionEnv.d.ts +108 -0
  45. package/dist/src/edge/EdgeFunctionEnv.d.ts.map +1 -0
  46. package/dist/src/edge/EdgeFunctionEnv.js +4 -0
  47. package/dist/src/edge/EdgeFunctionEnv.js.map +1 -0
  48. package/dist/src/{edge.d.ts → edge/edge.d.ts} +204 -26
  49. package/dist/src/edge/edge.d.ts.map +1 -0
  50. package/dist/src/{edge.js → edge/edge.js} +32 -14
  51. package/dist/src/edge/edge.js.map +1 -0
  52. package/dist/src/{edge-error.d.ts → edge/errors.d.ts} +6 -7
  53. package/dist/src/edge/errors.d.ts.map +1 -0
  54. package/dist/src/{edge-error.js → edge/errors.js} +14 -15
  55. package/dist/src/edge/errors.js.map +1 -0
  56. package/dist/src/edge/index.d.ts +4 -0
  57. package/dist/src/edge/index.d.ts.map +1 -0
  58. package/dist/src/edge/index.js +7 -0
  59. package/dist/src/edge/index.js.map +1 -0
  60. package/dist/src/errors/base-errors.d.ts +86 -8
  61. package/dist/src/errors/base-errors.d.ts.map +1 -1
  62. package/dist/src/errors/base-errors.js +4 -20
  63. package/dist/src/errors/base-errors.js.map +1 -1
  64. package/dist/src/errors/encoding.d.ts +2 -2
  65. package/dist/src/errors/encoding.d.ts.map +1 -1
  66. package/dist/src/errors/encoding.js +1 -1
  67. package/dist/src/errors/encoding.js.map +1 -1
  68. package/dist/src/errors/errors.d.ts +619 -42
  69. package/dist/src/errors/errors.d.ts.map +1 -1
  70. package/dist/src/errors/errors.js +50 -104
  71. package/dist/src/errors/errors.js.map +1 -1
  72. package/dist/src/errors/errors.test.js +2 -2
  73. package/dist/src/errors/errors.test.js.map +1 -1
  74. package/dist/src/errors/helpers.d.ts +9 -5
  75. package/dist/src/errors/helpers.d.ts.map +1 -1
  76. package/dist/src/errors/helpers.js +3 -3
  77. package/dist/src/errors/helpers.js.map +1 -1
  78. package/dist/src/errors/index.d.ts +5 -5
  79. package/dist/src/errors/index.js +5 -5
  80. package/dist/src/feed-replication.d.ts.map +1 -1
  81. package/dist/src/index.d.ts +12 -13
  82. package/dist/src/index.d.ts.map +1 -1
  83. package/dist/src/index.js +11 -12
  84. package/dist/src/index.js.map +1 -1
  85. package/dist/src/indexing.test.js +1 -1
  86. package/dist/src/messenger.d.ts +16 -0
  87. package/dist/src/messenger.d.ts.map +1 -0
  88. package/dist/src/messenger.js +4 -0
  89. package/dist/src/messenger.js.map +1 -0
  90. package/dist/src/proto/gen/dxos/client/services.d.ts +990 -852
  91. package/dist/src/proto/gen/dxos/client/services.d.ts.map +1 -1
  92. package/dist/src/proto/gen/dxos/client/services.js +95 -94
  93. package/dist/src/proto/gen/dxos/client/services.js.map +1 -1
  94. package/dist/src/proto/gen/dxos/devtools/host.d.ts +31 -31
  95. package/dist/src/proto/gen/dxos/devtools/host.d.ts.map +1 -1
  96. package/dist/src/proto/gen/dxos/echo/metadata.d.ts +4 -0
  97. package/dist/src/proto/gen/dxos/echo/metadata.d.ts.map +1 -1
  98. package/dist/src/proto/gen/dxos/echo/metadata.js.map +1 -1
  99. package/dist/src/proto/gen/dxos/echo/query.d.ts +17 -1
  100. package/dist/src/proto/gen/dxos/echo/query.d.ts.map +1 -1
  101. package/dist/src/proto/gen/dxos/echo/query.js.map +1 -1
  102. package/dist/src/proto/gen/dxos/echo/service.d.ts +34 -8
  103. package/dist/src/proto/gen/dxos/echo/service.d.ts.map +1 -1
  104. package/dist/src/proto/gen/dxos/edge/messenger.d.ts +24 -0
  105. package/dist/src/proto/gen/dxos/edge/messenger.d.ts.map +1 -1
  106. package/dist/src/proto/gen/dxos/edge/messenger.js.map +1 -1
  107. package/dist/src/proto/gen/dxos/halo/credentials.d.ts +15 -1
  108. package/dist/src/proto/gen/dxos/halo/credentials.d.ts.map +1 -1
  109. package/dist/src/proto/gen/dxos/halo/credentials.js +9 -0
  110. package/dist/src/proto/gen/dxos/halo/credentials.js.map +1 -1
  111. package/dist/src/proto/gen/google/protobuf.d.ts +326 -40
  112. package/dist/src/proto/gen/google/protobuf.d.ts.map +1 -1
  113. package/dist/src/proto/gen/google/protobuf.js +127 -1
  114. package/dist/src/proto/gen/google/protobuf.js.map +1 -1
  115. package/dist/src/proto/gen/index.d.ts +36 -0
  116. package/dist/src/proto/gen/index.d.ts.map +1 -1
  117. package/dist/src/proto/gen/index.js +1 -1
  118. package/dist/src/proto/gen/index.js.map +1 -1
  119. package/dist/src/proto/index.d.ts +2 -2
  120. package/dist/src/proto/index.js +1 -1
  121. package/dist/src/proto/types.d.ts +1 -1
  122. package/dist/src/space-archive.d.ts +60 -1
  123. package/dist/src/space-archive.d.ts.map +1 -1
  124. package/dist/src/space-archive.js +13 -1
  125. package/dist/src/space-archive.js.map +1 -1
  126. package/dist/src/types.d.ts +2 -2
  127. package/dist/tsconfig.tsbuildinfo +1 -1
  128. package/package.json +19 -15
  129. package/src/FeedProtocol.ts +320 -0
  130. package/src/FunctionProtocol.ts +8 -6
  131. package/src/buf/proto/gen/dxos/agent/dashboard_pb.ts +1 -1
  132. package/src/buf/proto/gen/dxos/agent/echo-proxy_pb.ts +1 -1
  133. package/src/buf/proto/gen/dxos/agent/epoch_pb.ts +1 -1
  134. package/src/buf/proto/gen/dxos/agent/functions_pb.ts +1 -1
  135. package/src/buf/proto/gen/dxos/bot_pb.ts +1 -1
  136. package/src/buf/proto/gen/dxos/client/invitation_pb.ts +1 -1
  137. package/src/buf/proto/gen/dxos/client/logging_pb.ts +1 -1
  138. package/src/buf/proto/gen/dxos/client/queue_pb.ts +280 -0
  139. package/src/buf/proto/gen/dxos/client/services_pb.ts +77 -40
  140. package/src/buf/proto/gen/dxos/config_pb.ts +1 -1
  141. package/src/buf/proto/gen/dxos/devtools/diagnostics_pb.ts +1 -1
  142. package/src/buf/proto/gen/dxos/devtools/host_pb.ts +1 -1
  143. package/src/buf/proto/gen/dxos/devtools/swarm_pb.ts +1 -1
  144. package/src/buf/proto/gen/dxos/echo/blob_pb.ts +1 -1
  145. package/src/buf/proto/gen/dxos/echo/feed_pb.ts +1 -1
  146. package/src/buf/proto/gen/dxos/echo/filter_pb.ts +1 -1
  147. package/src/buf/proto/gen/dxos/echo/indexing_pb.ts +1 -1
  148. package/src/buf/proto/gen/dxos/echo/metadata_pb.ts +9 -2
  149. package/src/buf/proto/gen/dxos/echo/model/document_pb.ts +1 -1
  150. package/src/buf/proto/gen/dxos/echo/model/messenger_pb.ts +1 -1
  151. package/src/buf/proto/gen/dxos/echo/model/text_pb.ts +1 -1
  152. package/src/buf/proto/gen/dxos/echo/object_pb.ts +1 -1
  153. package/src/buf/proto/gen/dxos/echo/query_pb.ts +16 -4
  154. package/src/buf/proto/gen/dxos/echo/service_pb.ts +68 -16
  155. package/src/buf/proto/gen/dxos/echo/snapshot_pb.ts +1 -1
  156. package/src/buf/proto/gen/dxos/echo/timeframe_pb.ts +1 -1
  157. package/src/buf/proto/gen/dxos/edge/calls_pb.ts +1 -1
  158. package/src/buf/proto/gen/dxos/edge/messenger_pb.ts +39 -6
  159. package/src/buf/proto/gen/dxos/edge/signal_pb.ts +1 -1
  160. package/src/buf/proto/gen/dxos/error_pb.ts +1 -1
  161. package/src/buf/proto/gen/dxos/field_options_pb.ts +1 -1
  162. package/src/buf/proto/gen/dxos/google_pb.ts +1 -1
  163. package/src/buf/proto/gen/dxos/gravity_pb.ts +1 -1
  164. package/src/buf/proto/gen/dxos/halo/credentials/auth_pb.ts +1 -1
  165. package/src/buf/proto/gen/dxos/halo/credentials/greet_pb.ts +1 -1
  166. package/src/buf/proto/gen/dxos/halo/credentials/identity_pb.ts +1 -1
  167. package/src/buf/proto/gen/dxos/halo/credentials_pb.ts +49 -3
  168. package/src/buf/proto/gen/dxos/halo/invitations_pb.ts +1 -1
  169. package/src/buf/proto/gen/dxos/halo/keyring_pb.ts +1 -1
  170. package/src/buf/proto/gen/dxos/halo/keys_pb.ts +1 -1
  171. package/src/buf/proto/gen/dxos/halo/signed_pb.ts +1 -1
  172. package/src/buf/proto/gen/dxos/iframe_pb.ts +2 -1
  173. package/src/buf/proto/gen/dxos/keys_pb.ts +1 -1
  174. package/src/buf/proto/gen/dxos/mesh/bridge_pb.ts +1 -1
  175. package/src/buf/proto/gen/dxos/mesh/broadcast_pb.ts +1 -1
  176. package/src/buf/proto/gen/dxos/mesh/messaging_pb.ts +1 -1
  177. package/src/buf/proto/gen/dxos/mesh/muxer_pb.ts +1 -1
  178. package/src/buf/proto/gen/dxos/mesh/presence_pb.ts +1 -1
  179. package/src/buf/proto/gen/dxos/mesh/protocol_pb.ts +1 -1
  180. package/src/buf/proto/gen/dxos/mesh/replicator_pb.ts +1 -1
  181. package/src/buf/proto/gen/dxos/mesh/signal_pb.ts +1 -1
  182. package/src/buf/proto/gen/dxos/mesh/swarm_pb.ts +1 -1
  183. package/src/buf/proto/gen/dxos/mesh/teleport/admission-discovery_pb.ts +1 -1
  184. package/src/buf/proto/gen/dxos/mesh/teleport/auth_pb.ts +1 -1
  185. package/src/buf/proto/gen/dxos/mesh/teleport/automerge_pb.ts +1 -1
  186. package/src/buf/proto/gen/dxos/mesh/teleport/blobsync_pb.ts +1 -1
  187. package/src/buf/proto/gen/dxos/mesh/teleport/control_pb.ts +1 -1
  188. package/src/buf/proto/gen/dxos/mesh/teleport/gossip_pb.ts +1 -1
  189. package/src/buf/proto/gen/dxos/mesh/teleport/notarization_pb.ts +1 -1
  190. package/src/buf/proto/gen/dxos/mesh/teleport/replicator_pb.ts +1 -1
  191. package/src/buf/proto/gen/dxos/registry_pb.ts +1 -1
  192. package/src/buf/proto/gen/dxos/rpc_pb.ts +1 -1
  193. package/src/buf/proto/gen/dxos/service/agentmanager_pb.ts +1 -1
  194. package/src/buf/proto/gen/dxos/service/publisher_pb.ts +1 -1
  195. package/src/buf/proto/gen/dxos/service/supervisor_pb.ts +1 -1
  196. package/src/buf/proto/gen/dxos/service/tunnel_pb.ts +1 -1
  197. package/src/buf/proto/gen/dxos/tracing_pb.ts +1 -1
  198. package/src/buf/proto/gen/dxos/type_pb.ts +1 -1
  199. package/src/buf/proto/gen/dxos/value_pb.ts +1 -1
  200. package/src/buf/proto/gen/example/testing/data_pb.ts +1 -1
  201. package/src/buf/proto/gen/example/testing/rpc_pb.ts +1 -1
  202. package/src/codec.test.ts +1 -1
  203. package/src/edge/EdgeFunctionEnv.ts +187 -0
  204. package/src/{edge.ts → edge/edge.ts} +166 -39
  205. package/src/{edge-error.ts → edge/errors.ts} +15 -16
  206. package/src/edge/index.ts +7 -0
  207. package/src/errors/base-errors.ts +4 -22
  208. package/src/errors/encoding.ts +2 -3
  209. package/src/errors/errors.test.ts +2 -2
  210. package/src/errors/errors.ts +57 -124
  211. package/src/errors/helpers.ts +6 -7
  212. package/src/errors/index.ts +5 -5
  213. package/src/feed-replication.ts +1 -0
  214. package/src/index.ts +12 -13
  215. package/src/indexing.test.ts +1 -1
  216. package/src/messenger.ts +22 -0
  217. package/src/proto/dxos/client/queue.proto +78 -0
  218. package/src/proto/dxos/client/services.proto +9 -1
  219. package/src/proto/dxos/config.proto +1 -1
  220. package/src/proto/dxos/echo/metadata.proto +3 -0
  221. package/src/proto/dxos/echo/query.proto +4 -1
  222. package/src/proto/dxos/echo/service.proto +27 -6
  223. package/src/proto/dxos/edge/messenger.proto +10 -0
  224. package/src/proto/dxos/halo/credentials.proto +15 -0
  225. package/src/proto/dxos/iframe.proto +1 -0
  226. package/src/proto/gen/dxos/client/services.ts +990 -852
  227. package/src/proto/gen/dxos/devtools/host.ts +31 -31
  228. package/src/proto/gen/dxos/echo/metadata.ts +4 -0
  229. package/src/proto/gen/dxos/echo/query.ts +17 -1
  230. package/src/proto/gen/dxos/echo/service.ts +33 -8
  231. package/src/proto/gen/dxos/edge/messenger.ts +24 -0
  232. package/src/proto/gen/dxos/halo/credentials.ts +15 -1
  233. package/src/proto/gen/google/protobuf.ts +326 -40
  234. package/src/proto/gen/index.ts +37 -1
  235. package/src/proto/index.ts +2 -2
  236. package/src/proto/types.ts +1 -1
  237. package/src/space-archive.ts +70 -1
  238. package/src/types.ts +2 -2
  239. package/dist/src/edge-error.d.ts.map +0 -1
  240. package/dist/src/edge-error.js.map +0 -1
  241. package/dist/src/edge.d.ts.map +0 -1
  242. package/dist/src/edge.js.map +0 -1
  243. package/dist/src/query.d.ts +0 -5
  244. package/dist/src/query.d.ts.map +0 -1
  245. package/dist/src/query.js +0 -8
  246. package/dist/src/query.js.map +0 -1
  247. package/dist/src/queue.d.ts +0 -37
  248. package/dist/src/queue.d.ts.map +0 -1
  249. package/dist/src/queue.js +0 -8
  250. package/dist/src/queue.js.map +0 -1
  251. package/src/query.ts +0 -8
  252. package/src/queue.ts +0 -51
@@ -2,208 +2,141 @@
2
2
  // Copyright 2021 DXOS.org
3
3
  //
4
4
 
5
+ import { BaseError } from '@dxos/errors';
5
6
  import { PublicKey } from '@dxos/keys';
6
7
 
7
- import type { ObjectId } from '../types.js';
8
-
9
- import { ApiError, BaseError, DatabaseError, SystemError } from './base-errors.js';
10
- import { registerError, registerErrorMessageContext, registerErrorNoArgs } from './helpers.js';
8
+ import type { ObjectId } from '../types.ts';
9
+ import { registerError, registerErrorMessageContext, registerErrorNoArgs } from './helpers.ts';
11
10
 
12
11
  /**
13
12
  * Thrown when request was terminated because the RPC endpoint has been closed.
14
13
  */
15
- export class RpcClosedError extends SystemError {
16
- constructor() {
17
- super('RPC_CLOSED', 'Request was terminated because the RPC endpoint is closed.');
18
- }
19
- }
14
+ export class RpcClosedError extends BaseError.extend(
15
+ 'RpcClosedError',
16
+ 'Request was terminated because the RPC endpoint is closed.',
17
+ ) {}
20
18
 
21
- registerErrorNoArgs('RPC_CLOSED', RpcClosedError);
19
+ registerErrorNoArgs('RpcClosedError', RpcClosedError);
22
20
 
23
21
  /**
24
22
  * Thrown when `request` is called when RPC has not been opened.
25
23
  */
26
- export class RpcNotOpenError extends SystemError {
27
- constructor() {
28
- super('RPC_NOT_OPEN', 'RPC has not been opened.');
29
- }
30
- }
24
+ export class RpcNotOpenError extends BaseError.extend('RpcNotOpenError', 'RPC has not been opened.') {}
31
25
 
32
- registerErrorNoArgs('RPC_NOT_OPEN', RpcNotOpenError);
26
+ registerErrorNoArgs('RpcNotOpenError', RpcNotOpenError);
33
27
 
34
- export class CancelledError extends SystemError {
35
- constructor(message?: string, context?: Record<string, any>) {
36
- super('CANCELLED', message, context);
37
- }
38
- }
28
+ export class CancelledError extends BaseError.extend('CancelledError') {}
39
29
 
40
- registerErrorMessageContext('CANCELLED', CancelledError);
30
+ registerErrorMessageContext('CancelledError', CancelledError);
41
31
 
42
- export class InvalidConfigError extends ApiError {
43
- constructor(message?: string, context?: Record<string, any>) {
44
- super('INVALID_CONFIG', message, context);
45
- }
46
- }
32
+ export class InvalidConfigError extends BaseError.extend('InvalidConfigError') {}
47
33
 
48
- registerErrorMessageContext('INVALID_CONFIG', InvalidConfigError);
34
+ registerErrorMessageContext('InvalidConfigError', InvalidConfigError);
49
35
 
50
36
  /**
51
37
  * Explicit failure to connect with remote client services.
52
38
  */
53
- export class RemoteServiceConnectionError extends ApiError {
54
- constructor(message?: string, context?: Record<string, any>) {
55
- super('REMOTE_SERVICE_CONNECTION_ERROR', message, context);
56
- }
57
- }
39
+ export class RemoteServiceConnectionError extends BaseError.extend('RemoteServiceConnectionError') {}
58
40
 
59
- registerErrorMessageContext('REMOTE_SERVICE_CONNECTION_ERROR', RemoteServiceConnectionError);
41
+ registerErrorMessageContext('RemoteServiceConnectionError', RemoteServiceConnectionError);
60
42
 
61
43
  /**
62
44
  * Failed to open a connection to remote client services.
63
45
  */
64
- export class RemoteServiceConnectionTimeout extends ApiError {
65
- constructor(message?: string, context?: Record<string, any>) {
66
- super('REMOTE_SERVICE_CONNECTION_TIMEOUT', message, context);
67
- }
68
- }
46
+ export class RemoteServiceConnectionTimeout extends BaseError.extend('RemoteServiceConnectionTimeout') {}
69
47
 
70
- registerErrorMessageContext('REMOTE_SERVICE_CONNECTION_TIMEOUT', RemoteServiceConnectionTimeout);
48
+ registerErrorMessageContext('RemoteServiceConnectionTimeout', RemoteServiceConnectionTimeout);
71
49
 
72
- export class DataCorruptionError extends SystemError {
73
- constructor(message?: string, context?: Record<string, any>) {
74
- super('DATA_CORRUPTION', message, context);
75
- }
76
- }
50
+ export class DataCorruptionError extends BaseError.extend('DataCorruptionError') {}
77
51
 
78
- registerErrorMessageContext('DATA_CORRUPTION', DataCorruptionError);
52
+ registerErrorMessageContext('DataCorruptionError', DataCorruptionError);
79
53
 
80
- export class InvalidInvitationExtensionRoleError extends SystemError {
81
- constructor(message?: string, context?: Record<string, any>) {
82
- super('INVALID_INVITATION_EXTENSION_ROLE', message, context);
83
- }
84
- }
54
+ export class InvalidInvitationExtensionRoleError extends BaseError.extend('InvalidInvitationExtensionRoleError') {}
85
55
 
86
- registerErrorMessageContext('INVALID_INVITATION_EXTENSION_ROLE', InvalidInvitationExtensionRoleError);
56
+ registerErrorMessageContext('InvalidInvitationExtensionRoleError', InvalidInvitationExtensionRoleError);
87
57
 
88
- export class IdentityNotInitializedError extends DatabaseError {
89
- constructor(message?: string, context?: Record<string, any>) {
90
- super('IDENTITY_NOT_INITIALIZED', message, context);
91
- }
92
- }
58
+ export class IdentityNotInitializedError extends BaseError.extend('IdentityNotInitializedError') {}
93
59
 
94
- registerErrorMessageContext('IDENTITY_NOT_INITIALIZED', IdentityNotInitializedError);
60
+ registerErrorMessageContext('IdentityNotInitializedError', IdentityNotInitializedError);
95
61
 
96
- export class InvalidInvitationError extends DatabaseError {
97
- constructor(message?: string, context?: Record<string, any>) {
98
- super('INVALID_INVITATION', message, context);
99
- }
100
- }
62
+ export class InvalidInvitationError extends BaseError.extend('InvalidInvitationError') {}
101
63
 
102
- registerErrorMessageContext('INVALID_INVITATION', InvalidInvitationError);
64
+ registerErrorMessageContext('InvalidInvitationError', InvalidInvitationError);
103
65
 
104
- export class AlreadyJoinedError extends DatabaseError {
105
- constructor(message?: string, context?: Record<string, any>) {
106
- super('ALREADY_JOINED', message, context);
107
- }
108
- }
66
+ export class AlreadyJoinedError extends BaseError.extend('AlreadyJoinedError') {}
109
67
 
110
- registerErrorMessageContext('ALREADY_JOINED', AlreadyJoinedError);
68
+ registerErrorMessageContext('AlreadyJoinedError', AlreadyJoinedError);
111
69
 
112
- export class ConnectionResetError extends BaseError {
113
- constructor(message?: string, context?: any) {
114
- super('CONNECTION_RESET', message, context);
115
- }
116
- }
70
+ export class ConnectionResetError extends BaseError.extend('ConnectionResetError') {}
117
71
 
118
- registerErrorMessageContext('CONNECTION_RESET', ConnectionResetError);
72
+ registerErrorMessageContext('ConnectionResetError', ConnectionResetError);
119
73
 
120
- export class TimeoutError extends BaseError {
121
- constructor(message?: string, context?: any) {
122
- super('TIMEOUT', message, context);
123
- }
124
- }
74
+ export class TimeoutError extends BaseError.extend('TimeoutError') {}
125
75
 
126
- registerErrorMessageContext('TIMEOUT', TimeoutError);
76
+ registerErrorMessageContext('TimeoutError', TimeoutError);
127
77
 
128
78
  // General protocol error.
129
- export class ProtocolError extends BaseError {
130
- constructor(message?: string, context?: any) {
131
- super('PROTOCOL_ERROR', message, context);
132
- }
133
- }
79
+ export class ProtocolError extends BaseError.extend('ProtocolError') {}
134
80
 
135
- registerErrorMessageContext('PROTOCOL_ERROR', ProtocolError);
81
+ registerErrorMessageContext(ProtocolError.name, ProtocolError);
136
82
 
137
83
  // General connectivity errors.
138
- export class ConnectivityError extends BaseError {
139
- constructor(message?: string, context?: any) {
140
- super('CONNECTIVITY_ERROR', message, context);
141
- }
142
- }
84
+ export class ConnectivityError extends BaseError.extend('ConnectivityError') {}
143
85
 
144
- registerErrorMessageContext('CONNECTIVITY_ERROR', ConnectivityError);
86
+ registerErrorMessageContext('ConnectivityError', ConnectivityError);
145
87
 
146
- export class RateLimitExceededError extends BaseError {
147
- constructor(message?: string, context?: any) {
148
- super('RATE_LIMIT_EXCEEDED', message, context);
149
- }
150
- }
88
+ export class RateLimitExceededError extends BaseError.extend('RateLimitExceededError') {}
151
89
 
152
- registerErrorMessageContext('RATE_LIMIT_EXCEEDED', RateLimitExceededError);
90
+ registerErrorMessageContext('RateLimitExceededError', RateLimitExceededError);
153
91
 
154
92
  // TODO(nf): Rename? the protocol isn't what's unknown...
155
- export class UnknownProtocolError extends BaseError {
156
- constructor(message?: string, innerError?: Error) {
157
- super('UNKNOWN_PROTOCOL_ERROR', message, innerError);
158
- }
159
- }
93
+ export class UnknownProtocolError extends BaseError.extend('UnknownProtocolError') {}
160
94
 
161
- registerErrorMessageContext('UNKNOWN_PROTOCOL_ERROR', UnknownProtocolError);
95
+ registerError(UnknownProtocolError.name, (message, context) => new UnknownProtocolError({ message, context }));
162
96
 
163
- export class InvalidStorageVersionError extends DatabaseError {
97
+ export class InvalidStorageVersionError extends BaseError.extend(
98
+ 'InvalidStorageVersionError',
99
+ 'Invalid storage version.',
100
+ ) {
164
101
  constructor(expected: number, actual: number) {
165
- super('INVALID_STORAGE_VERSION', 'Invalid storage version.', { expected, actual });
102
+ super({ context: { expected, actual } });
166
103
  }
167
104
  }
168
105
 
169
- registerError('INVALID_STORAGE_VERSION', (_, context) => {
106
+ registerError('InvalidStorageVersionError', (_, context) => {
170
107
  return new InvalidStorageVersionError(context.expected ?? NaN, context.actual ?? NaN);
171
108
  });
172
109
 
173
- export class SpaceNotFoundError extends DatabaseError {
110
+ export class SpaceNotFoundError extends BaseError.extend('SpaceNotFoundError', 'Space not found.') {
174
111
  constructor(spaceKey: PublicKey) {
175
- super('SPACE_NOT_FOUND', 'Space not found.', { spaceKey });
112
+ super({ context: { spaceKey } });
176
113
  }
177
114
  }
178
115
 
179
- registerError('SPACE_NOT_FOUND', (_, context) => {
116
+ registerError('SpaceNotFoundError', (_, context) => {
180
117
  return new SpaceNotFoundError(PublicKey.safeFrom(context.spaceKey) ?? PublicKey.from('00'));
181
118
  });
182
119
 
183
- export class EntityNotFoundError extends DatabaseError {
120
+ export class EntityNotFoundError extends BaseError.extend('EntityNotFoundError', 'Item not found.') {
184
121
  constructor(entityId: ObjectId) {
185
- super('ITEM_NOT_FOUND', 'Item not found.', { entityId });
122
+ super({ context: { entityId } });
186
123
  }
187
124
  }
188
125
 
189
- registerError('ITEM_NOT_FOUND', (_, context) => {
126
+ registerError('EntityNotFoundError', (_, context) => {
190
127
  return new EntityNotFoundError(context.entityId);
191
128
  });
192
129
 
193
- export class UnknownModelError extends DatabaseError {
130
+ export class UnknownModelError extends BaseError.extend('UnknownModelError', 'Unknown model.') {
194
131
  constructor(model: string) {
195
- super('UNKNOWN_MODEL', 'Unknown model.', { model });
132
+ super({ context: { model } });
196
133
  }
197
134
  }
198
135
 
199
- registerError('UNKNOWN_MODEL', (_, context) => {
136
+ registerError('UnknownModelError', (_, context) => {
200
137
  return new UnknownModelError(context.model);
201
138
  });
202
139
 
203
- export class AuthorizationError extends ApiError {
204
- constructor(message?: string, context?: any) {
205
- super('AUTHORIZATION_ERROR', message, context);
206
- }
207
- }
140
+ export class AuthorizationError extends BaseError.extend('AuthorizationError') {}
208
141
 
209
- registerErrorMessageContext('AUTHORIZATION_ERROR', AuthorizationError);
142
+ registerErrorMessageContext('AuthorizationError', AuthorizationError);
@@ -2,11 +2,10 @@
2
2
  // Copyright 2023 DXOS.org
3
3
  //
4
4
 
5
+ import { BaseError } from '@dxos/errors';
5
6
  import { invariant } from '@dxos/invariant';
6
7
 
7
- import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error.js';
8
-
9
- import { SystemError } from './base-errors.js';
8
+ import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error.ts';
10
9
 
11
10
  export const reconstructError = (error: SerializedErrorProto) => {
12
11
  const { name, message, context } = error;
@@ -20,21 +19,21 @@ export const registerError = (code: string, make: (message?: string, context?: a
20
19
  errorRegistry.set(code, make);
21
20
  };
22
21
 
23
- export const registerErrorNoArgs = (code: string, Constructor: { new (): Error }) => {
22
+ export const registerErrorNoArgs = (code: string, Constructor: { new (options?: any): Error }) => {
24
23
  registerError(code, () => new Constructor());
25
24
  };
26
25
 
27
26
  export const registerErrorMessageContext = (
28
27
  code: string,
29
- Constructor: { new (message?: string, context?: any): Error },
28
+ Constructor: { new (options?: { message?: string; context?: any }): Error },
30
29
  ) => {
31
- registerError(code, (message?: string, context?: string) => new Constructor(message, context));
30
+ registerError(code, (message?: string, context?: any) => new Constructor({ message, context }));
32
31
  };
33
32
 
34
33
  export const errorFromCode = (code?: string, message?: string, context?: any) => {
35
34
  if (code && errorRegistry.has(code)) {
36
35
  return errorRegistry.get(code)!(message, context);
37
36
  } else {
38
- return new SystemError(code ?? 'Error', message, context);
37
+ return new BaseError(code ?? 'Error', { message, context });
39
38
  }
40
39
  };
@@ -2,8 +2,8 @@
2
2
  // Copyright 2022 DXOS.org
3
3
  //
4
4
 
5
- export * from './encoding.js';
6
- export * from './errors.js';
7
- export * from './helpers.js';
8
- export * from './base-errors.js';
9
- export * from './parameter.js';
5
+ export * from './encoding.ts';
6
+ export * from './errors.ts';
7
+ export * from './helpers.ts';
8
+ export * from './base-errors.ts';
9
+ export * from './parameter.ts';
@@ -12,6 +12,7 @@ export type FeedBlock = {
12
12
  }[];
13
13
  signature: Uint8Array;
14
14
  };
15
+
15
16
  export type GetMetadataProtocolMessage = {
16
17
  type: 'get-metadata';
17
18
  feedKey: string;
package/src/index.ts CHANGED
@@ -2,16 +2,15 @@
2
2
  // Copyright 2021 DXOS.org
3
3
  //
4
4
 
5
- export * from './automerge.js';
6
- export * from './edge-error.js';
7
- export * from './edge.js';
8
- export * from './errors/index.js';
9
- export * from './indexing.js';
10
- export * from './profile-archive.js';
11
- export * from './query.js';
12
- export * from './queue.js';
13
- export * from './space-archive.js';
14
- export * from './storage.js';
15
- export * from './tracing.js';
16
- export type * from './types.js';
17
- export * as FunctionProtocol from './FunctionProtocol.js';
5
+ export * from './automerge.ts';
6
+ export * from './edge/index.ts';
7
+ export * from './errors/index.ts';
8
+ export * from './indexing.ts';
9
+ export * from './messenger.ts';
10
+ export * from './profile-archive.ts';
11
+ export * from './space-archive.ts';
12
+ export * from './storage.ts';
13
+ export * from './tracing.ts';
14
+ export type * from './types.ts';
15
+ export * as FunctionProtocol from './FunctionProtocol.ts';
16
+ export * as FeedProtocol from './FeedProtocol.ts';
@@ -4,7 +4,7 @@
4
4
 
5
5
  import { describe, expect, test } from 'vitest';
6
6
 
7
- import { ObjectPointerVersion, objectPointerCodec } from './indexing.js';
7
+ import { ObjectPointerVersion, objectPointerCodec } from './indexing.ts';
8
8
 
9
9
  describe('Indexing object pointer codec', () => {
10
10
  test('getVersion', async () => {
@@ -0,0 +1,22 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { type CleanupFn } from '@dxos/async';
6
+
7
+ import { type GossipMessage } from './proto/gen/dxos/mesh/teleport/gossip';
8
+
9
+ /**
10
+ * Message passing abstraction.
11
+ */
12
+ export interface Messenger {
13
+ /**
14
+ * Register channel listener.
15
+ */
16
+ listen: (channel: string, callback: (message: GossipMessage) => void) => CleanupFn;
17
+
18
+ /**
19
+ * Send message to channel.
20
+ */
21
+ postMessage: (channel: string, message: any) => Promise<void>;
22
+ }
@@ -0,0 +1,78 @@
1
+ syntax = "proto3";
2
+
3
+ package dxos.client.services;
4
+
5
+ import "google/protobuf/struct.proto";
6
+ import "google/protobuf/empty.proto";
7
+
8
+
9
+ message QueueQuery {
10
+ string space_id = 1;
11
+
12
+ optional string queues_namespace = 2;
13
+
14
+ /// Queries the whole space if missing.
15
+ repeated string queue_ids = 3;
16
+
17
+ /// Filter items after this cursor. Exclusive.
18
+ optional string after = 4;
19
+
20
+ /// Filter items before this cursor. Exclusive.
21
+ optional string before = 5;
22
+
23
+ /// Filter items after this position. Inclusive.
24
+ optional int64 begin_position = 6;
25
+
26
+ /// Filter items before this position. Exclusive.
27
+ optional int64 end_position = 7;
28
+
29
+ optional int32 limit = 8;
30
+ optional bool reverse = 9;
31
+
32
+ // TODO(dmaretskyi): Remove this field -- raw queues dont index object IDs anymore.
33
+ repeated string object_ids = 100;
34
+ }
35
+
36
+ message QueueQueryResult {
37
+ repeated google.protobuf.Struct objects = 1;
38
+
39
+ /// Cursor to query the next items. Can be passed to `after` in query to keep querying.
40
+ string next_cursor = 2;
41
+
42
+ string prev_cursor = 3;
43
+ }
44
+
45
+ message QueryQueueRequest {
46
+ QueueQuery query = 1;
47
+ }
48
+
49
+ message InsertIntoQueueRequest {
50
+ string subspace_tag = 1;
51
+ string space_id = 2;
52
+ string queue_id = 3;
53
+ repeated google.protobuf.Struct objects = 4;
54
+ }
55
+
56
+ message DeleteFromQueueRequest {
57
+ string subspace_tag = 1;
58
+ string space_id = 2;
59
+ string queue_id = 3;
60
+ repeated string object_ids = 4;
61
+ }
62
+
63
+ message SyncQueueRequest {
64
+ string subspace_tag = 1;
65
+ string space_id = 2;
66
+ string queue_id = 3;
67
+ /// Whether to push local changes to the server. Defaults to true.
68
+ optional bool should_push = 4;
69
+ /// Whether to pull remote changes from the server. Defaults to true.
70
+ optional bool should_pull = 5;
71
+ }
72
+
73
+ service QueueService {
74
+ rpc QueryQueue(QueryQueueRequest) returns (QueueQueryResult);
75
+ rpc InsertIntoQueue(InsertIntoQueueRequest) returns (google.protobuf.Empty);
76
+ rpc DeleteFromQueue(DeleteFromQueueRequest) returns (google.protobuf.Empty);
77
+ rpc SyncQueue(SyncQueueRequest) returns (google.protobuf.Empty);
78
+ }
@@ -72,6 +72,7 @@ message Platform {
72
72
  BROWSER = 0;
73
73
  SHARED_WORKER = 1;
74
74
  NODE = 2;
75
+ DEDICATED_WORKER = 3;
75
76
  }
76
77
 
77
78
  PLATFORM_TYPE type = 1;
@@ -331,6 +332,8 @@ message Space {
331
332
  optional PipelineState pipeline = 3;
332
333
  optional dxos.error.Error error = 4;
333
334
  optional dxos.echo.metadata.EdgeReplicationSetting edge_replication = 6;
335
+ repeated string tags = 7;
336
+ dxos.halo.credentials.MembershipPolicy membership_policy = 8;
334
337
 
335
338
  repeated SpaceMember members = 10;
336
339
  optional dxos.keys.PublicKey creator = 11;
@@ -341,6 +344,11 @@ message Space {
341
344
 
342
345
  // TODO(burdon): Create type for epoch?
343
346
 
347
+ message CreateSpaceRequest {
348
+ repeated string tags = 1;
349
+ dxos.halo.credentials.MembershipPolicy membership_policy = 2;
350
+ }
351
+
344
352
  message UpdateSpaceRequest {
345
353
  dxos.keys.PublicKey space_key = 1;
346
354
 
@@ -457,7 +465,7 @@ message ImportSpaceResponse {
457
465
  }
458
466
 
459
467
  service SpacesService {
460
- rpc CreateSpace(google.protobuf.Empty) returns (Space);
468
+ rpc CreateSpace(CreateSpaceRequest) returns (Space);
461
469
  rpc UpdateSpace(UpdateSpaceRequest) returns (google.protobuf.Empty);
462
470
  rpc QuerySpaces(google.protobuf.Empty) returns (stream QuerySpacesResponse);
463
471
 
@@ -59,7 +59,7 @@ message Module {
59
59
  optional string id = 8; // TODO(burdon): Ensured FQ (e.g., 'dxos.app.xxx')
60
60
  optional string name = 1; // TODO(burdon): Replace with id (or key?)
61
61
  optional string type = 2; // TODO(burdon): Define namespace (e.g.,
62
- // 'dxos.org/type/frame' vs. 'dxos.type.frame')
62
+ // 'org.dxos.type.frame')
63
63
 
64
64
  // TODO(burdon): Developer info message.
65
65
 
@@ -54,6 +54,9 @@ message SpaceMetadata {
54
54
  /// Space key.
55
55
  dxos.keys.PublicKey key = 1;
56
56
 
57
+ /// Immutable tags assigned at space creation time.
58
+ repeated string tags = 12;
59
+
57
60
  /// ACTIVE, INACTIVE, etc.
58
61
  optional dxos.client.services.SpaceState state = 10;
59
62
 
@@ -36,9 +36,12 @@ message Heads {
36
36
  message QueryResult {
37
37
  string id = 1;
38
38
  string spaceId = 4;
39
- string documentId = 5;
39
+ optional string documentId = 5;
40
+ optional string queueId = 6;
41
+ optional string queueNamespace = 7;
40
42
  float rank = 3;
41
43
 
44
+ /// In the ECHO Json object format.
42
45
  optional string document_json = 10;
43
46
  optional bytes document_automerge = 11;
44
47
 
@@ -6,6 +6,7 @@ syntax = "proto3";
6
6
 
7
7
  import "dxos/keys.proto";
8
8
  import "google/protobuf/empty.proto";
9
+ import "google/protobuf/struct.proto";
9
10
 
10
11
  package dxos.echo.service;
11
12
 
@@ -61,12 +62,6 @@ message DocumentUpdate {
61
62
  * Value returned by `Automerge.saveSince()`.
62
63
  */
63
64
  bytes mutation = 2;
64
-
65
- /**
66
- * Set to true for init mutation of document.
67
- * default: undefined.
68
- */
69
- optional bool is_new = 3;
70
65
  }
71
66
 
72
67
  message DocHeadsList {
@@ -94,6 +89,26 @@ message ReIndexHeadsRequest {
94
89
  repeated string document_ids = 1;
95
90
  }
96
91
 
92
+ message CreateDocumentRequest {
93
+ /**
94
+ * Space id where the document will be created.
95
+ */
96
+ string space_id = 1;
97
+
98
+ /**
99
+ * Automerge encoded initial document value.
100
+ * Optional - if not provided, an empty document will be created.
101
+ */
102
+ optional google.protobuf.Struct initial_value = 2;
103
+ }
104
+
105
+ message CreateDocumentResponse {
106
+ /**
107
+ * The generated document id.
108
+ */
109
+ string document_id = 1;
110
+ }
111
+
97
112
  message GetSpaceSyncStateRequest {
98
113
  string space_id = 1;
99
114
  }
@@ -157,6 +172,12 @@ service DataService {
157
172
  */
158
173
  rpc UpdateSubscription(UpdateSubscriptionRequest) returns (google.protobuf.Empty);
159
174
 
175
+ /**
176
+ * Create a new automerge document.
177
+ * Returns the generated document id which is controlled by the host.
178
+ */
179
+ rpc CreateDocument(CreateDocumentRequest) returns (CreateDocumentResponse);
180
+
160
181
  /**
161
182
  * Write incremental updates to multiple automerge documents.
162
183
  * Used to propagate changes from client to services.
@@ -76,9 +76,19 @@ message Message {
76
76
  /// Maybe be used to address a service at EDGE, but also to address components inside the client.
77
77
  optional string service_id = 20;
78
78
 
79
+ optional TraceContext trace_context = 21;
80
+
79
81
  optional google.protobuf.Any payload = 100;
80
82
  }
81
83
 
84
+ /// W3C Trace Context propagation (https://www.w3.org/TR/trace-context/).
85
+ message TraceContext {
86
+ /// W3C `traceparent` header value (e.g. "00-<trace-id>-<parent-id>-<trace-flags>").
87
+ string traceparent = 1;
88
+ /// W3C `tracestate` header value; vendor-specific key-value pairs.
89
+ optional string tracestate = 2;
90
+ }
91
+
82
92
  //
83
93
  // Swarms are used to publish and subscribe to messages based on a topic.
84
94
  //
@@ -28,9 +28,18 @@ import "dxos/keys.proto";
28
28
  // First message written to initial Feed in a new Space.
29
29
  //
30
30
 
31
+ enum MembershipPolicy {
32
+ /// Members can be invited by admins/owners.
33
+ INVITE = 0;
34
+ /// No new members can be added after genesis.
35
+ LOCKED = 1;
36
+ }
37
+
31
38
  // [ASSERTION]
32
39
  message SpaceGenesis {
33
40
  dxos.keys.PublicKey space_key = 1; // Feeds belong to Spaces.
41
+ repeated string tags = 2;
42
+ MembershipPolicy membership_policy = 3;
34
43
  }
35
44
 
36
45
  //
@@ -60,6 +69,9 @@ message SpaceMember {
60
69
  dxos.keys.PublicKey space_key = 1;
61
70
  Role role = 2;
62
71
 
72
+ /// Immutable tags assigned at space creation time.
73
+ repeated string tags = 6;
74
+
63
75
  // TODO(burdon): Identity key?
64
76
  optional ProfileDocument profile = 3;
65
77
 
@@ -163,6 +175,8 @@ enum DeviceType {
163
175
  UNKNOWN = 0;
164
176
  BROWSER = 1;
165
177
  NATIVE = 2;
178
+ // TODO(wittjosiah): Rename "agent" to avoid naming collision with AI agents.
179
+ // TODO(wittjosiah): Unknown, Browser, CLI, Desktop, Mobile, Custodian?
166
180
  AGENT = 3;
167
181
  AGENT_MANAGED = 4;
168
182
  MOBILE = 5;
@@ -188,6 +202,7 @@ message DeviceProfile {
188
202
  }
189
203
 
190
204
  /// [ASSERTION]: Sets default space for identity.
205
+ /// @deprecated Default space is no longer managed by the SDK. Existing credentials are ignored.
191
206
  message DefaultSpace {
192
207
  string space_id = 1;
193
208
  }