@hydranium/protocol 1.0.0-next.14 → 1.0.0-next.148

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 (177) hide show
  1. package/README.md +35 -1
  2. package/lib/client/data-connection.d.ts +150 -0
  3. package/lib/client/data-connection.d.ts.map +1 -0
  4. package/lib/client/data-connection.js +211 -0
  5. package/lib/client/data-connection.js.map +1 -0
  6. package/lib/client/data-events.d.ts +13 -1
  7. package/lib/client/data-events.d.ts.map +1 -1
  8. package/lib/client/data-events.js +21 -0
  9. package/lib/client/data-events.js.map +1 -1
  10. package/lib/client/data-port.d.ts +17 -22
  11. package/lib/client/data-port.d.ts.map +1 -1
  12. package/lib/client/data-session.d.ts +301 -80
  13. package/lib/client/data-session.d.ts.map +1 -1
  14. package/lib/client/data-session.js +425 -107
  15. package/lib/client/data-session.js.map +1 -1
  16. package/lib/client/index.d.ts +13 -8
  17. package/lib/client/index.d.ts.map +1 -1
  18. package/lib/client/index.js +13 -8
  19. package/lib/client/index.js.map +1 -1
  20. package/lib/client/message-relay.d.ts +9 -3
  21. package/lib/client/message-relay.d.ts.map +1 -1
  22. package/lib/client/message-relay.js +11 -5
  23. package/lib/client/message-relay.js.map +1 -1
  24. package/lib/client/post-message-transport.d.ts +64 -3
  25. package/lib/client/post-message-transport.d.ts.map +1 -1
  26. package/lib/client/post-message-transport.js +175 -1
  27. package/lib/client/post-message-transport.js.map +1 -1
  28. package/lib/client/rpc-connection.d.ts +149 -0
  29. package/lib/client/rpc-connection.d.ts.map +1 -0
  30. package/lib/client/rpc-connection.js +179 -0
  31. package/lib/client/rpc-connection.js.map +1 -0
  32. package/lib/client-ids.d.ts +45 -0
  33. package/lib/client-ids.d.ts.map +1 -0
  34. package/lib/client-ids.js +48 -0
  35. package/lib/client-ids.js.map +1 -0
  36. package/lib/clock.d.ts +38 -0
  37. package/lib/clock.d.ts.map +1 -1
  38. package/lib/clock.js +36 -1
  39. package/lib/clock.js.map +1 -1
  40. package/lib/data/data-protocol-methods.d.ts +4 -4
  41. package/lib/data/data-protocol-methods.d.ts.map +1 -1
  42. package/lib/data/data-protocol-methods.js +11 -1
  43. package/lib/data/data-protocol-methods.js.map +1 -1
  44. package/lib/data/data-server-protocol.d.ts +111 -31
  45. package/lib/data/data-server-protocol.d.ts.map +1 -1
  46. package/lib/data/events.d.ts +103 -14
  47. package/lib/data/events.d.ts.map +1 -1
  48. package/lib/data/requests.d.ts +67 -11
  49. package/lib/data/requests.d.ts.map +1 -1
  50. package/lib/errors.d.ts +163 -17
  51. package/lib/errors.d.ts.map +1 -1
  52. package/lib/errors.js +219 -22
  53. package/lib/errors.js.map +1 -1
  54. package/lib/glsp-save-model-actions.d.ts +50 -0
  55. package/lib/glsp-save-model-actions.d.ts.map +1 -0
  56. package/lib/glsp-save-model-actions.js +28 -0
  57. package/lib/glsp-save-model-actions.js.map +1 -0
  58. package/lib/index.d.ts +3 -0
  59. package/lib/index.d.ts.map +1 -1
  60. package/lib/index.js +6 -0
  61. package/lib/index.js.map +1 -1
  62. package/lib/latency-collector.d.ts +8 -4
  63. package/lib/latency-collector.d.ts.map +1 -1
  64. package/lib/latency-collector.js.map +1 -1
  65. package/lib/messages/index.d.ts +29 -0
  66. package/lib/messages/index.d.ts.map +1 -0
  67. package/lib/messages/index.js +58 -0
  68. package/lib/messages/index.js.map +1 -0
  69. package/lib/messages/primitives.d.ts +188 -0
  70. package/lib/messages/primitives.d.ts.map +1 -0
  71. package/lib/messages/primitives.js +161 -0
  72. package/lib/messages/primitives.js.map +1 -0
  73. package/lib/model-server.d.ts +60 -13
  74. package/lib/model-server.d.ts.map +1 -1
  75. package/lib/model-server.js +4 -2
  76. package/lib/model-server.js.map +1 -1
  77. package/lib/model-service/based-on.d.ts +57 -0
  78. package/lib/model-service/based-on.d.ts.map +1 -0
  79. package/lib/model-service/based-on.js +37 -0
  80. package/lib/model-service/based-on.js.map +1 -0
  81. package/lib/model-service/index.d.ts +1 -1
  82. package/lib/model-service/index.d.ts.map +1 -1
  83. package/lib/model-service/index.js +4 -5
  84. package/lib/model-service/index.js.map +1 -1
  85. package/lib/patch-merge.d.ts +28 -27
  86. package/lib/patch-merge.d.ts.map +1 -1
  87. package/lib/patch-merge.js +66 -22
  88. package/lib/patch-merge.js.map +1 -1
  89. package/lib/profile-session.d.ts +8 -4
  90. package/lib/profile-session.d.ts.map +1 -1
  91. package/lib/profile-session.js.map +1 -1
  92. package/lib/rpc/bind-rpc-methods.d.ts +29 -3
  93. package/lib/rpc/bind-rpc-methods.d.ts.map +1 -1
  94. package/lib/rpc/bind-rpc-methods.js +22 -3
  95. package/lib/rpc/bind-rpc-methods.js.map +1 -1
  96. package/lib/rpc/create-rpc-proxy.d.ts +7 -0
  97. package/lib/rpc/create-rpc-proxy.d.ts.map +1 -1
  98. package/lib/rpc/create-rpc-proxy.js +6 -1
  99. package/lib/rpc/create-rpc-proxy.js.map +1 -1
  100. package/lib/testing/catalogue-audit.d.ts +80 -0
  101. package/lib/testing/catalogue-audit.d.ts.map +1 -0
  102. package/lib/testing/catalogue-audit.js +94 -0
  103. package/lib/testing/catalogue-audit.js.map +1 -0
  104. package/lib/testing/data-doubles.d.ts +13 -12
  105. package/lib/testing/data-doubles.d.ts.map +1 -1
  106. package/lib/testing/data-doubles.js +19 -5
  107. package/lib/testing/data-doubles.js.map +1 -1
  108. package/lib/testing/fake-clock.d.ts +9 -1
  109. package/lib/testing/fake-clock.d.ts.map +1 -1
  110. package/lib/testing/fake-clock.js +54 -45
  111. package/lib/testing/fake-clock.js.map +1 -1
  112. package/lib/testing/index.d.ts +1 -0
  113. package/lib/testing/index.d.ts.map +1 -1
  114. package/lib/testing/index.js +4 -1
  115. package/lib/testing/index.js.map +1 -1
  116. package/lib/testing/node/index.d.ts +1 -0
  117. package/lib/testing/node/index.d.ts.map +1 -1
  118. package/lib/testing/node/index.js +2 -2
  119. package/lib/testing/node/index.js.map +1 -1
  120. package/lib/testing/node/message-port-pair.d.ts +25 -0
  121. package/lib/testing/node/message-port-pair.d.ts.map +1 -0
  122. package/lib/testing/node/message-port-pair.js +26 -0
  123. package/lib/testing/node/message-port-pair.js.map +1 -0
  124. package/lib/transfer-diagnostic.d.ts +33 -0
  125. package/lib/transfer-diagnostic.d.ts.map +1 -1
  126. package/lib/transfer-diagnostic.js +23 -0
  127. package/lib/transfer-diagnostic.js.map +1 -1
  128. package/lib/transfer-document.d.ts +22 -5
  129. package/lib/transfer-document.d.ts.map +1 -1
  130. package/lib/transfer-document.js +14 -1
  131. package/lib/transfer-document.js.map +1 -1
  132. package/lib/util.d.ts +11 -0
  133. package/lib/util.d.ts.map +1 -1
  134. package/lib/util.js +24 -0
  135. package/lib/util.js.map +1 -1
  136. package/package.json +11 -2
  137. package/src/client/data-connection.ts +288 -0
  138. package/src/client/data-events.ts +33 -1
  139. package/src/client/data-port.ts +17 -23
  140. package/src/client/data-session.ts +549 -126
  141. package/src/client/index.ts +13 -8
  142. package/src/client/message-relay.ts +29 -7
  143. package/src/client/post-message-transport.ts +219 -4
  144. package/src/client/rpc-connection.ts +244 -0
  145. package/src/client-ids.ts +49 -0
  146. package/src/clock.ts +56 -0
  147. package/src/data/data-protocol-methods.ts +11 -3
  148. package/src/data/data-server-protocol.ts +132 -31
  149. package/src/data/events.ts +109 -14
  150. package/src/data/requests.ts +71 -11
  151. package/src/errors.ts +259 -24
  152. package/src/glsp-save-model-actions.ts +59 -0
  153. package/src/index.ts +6 -0
  154. package/src/latency-collector.ts +8 -3
  155. package/src/messages/index.ts +36 -0
  156. package/src/messages/primitives.ts +271 -0
  157. package/src/model-server.ts +63 -18
  158. package/src/model-service/based-on.ts +63 -0
  159. package/src/model-service/index.ts +4 -5
  160. package/src/patch-merge.ts +90 -37
  161. package/src/profile-session.ts +9 -4
  162. package/src/rpc/bind-rpc-methods.ts +49 -4
  163. package/src/rpc/create-rpc-proxy.ts +14 -1
  164. package/src/testing/catalogue-audit.ts +111 -0
  165. package/src/testing/data-doubles.ts +42 -17
  166. package/src/testing/fake-clock.ts +62 -47
  167. package/src/testing/index.ts +4 -1
  168. package/src/testing/node/index.ts +2 -2
  169. package/src/testing/node/message-port-pair.ts +40 -0
  170. package/src/transfer-diagnostic.ts +40 -0
  171. package/src/transfer-document.ts +29 -6
  172. package/src/util.ts +24 -0
  173. package/lib/model-service/args.d.ts +0 -64
  174. package/lib/model-service/args.d.ts.map +0 -1
  175. package/lib/model-service/args.js +0 -11
  176. package/lib/model-service/args.js.map +0 -1
  177. package/src/model-service/args.ts +0 -67
@@ -6,84 +6,203 @@
6
6
  *
7
7
  * SPDX-License-Identifier: MIT
8
8
  ********************************************************************************/
9
- import type { MessageConnection } from 'vscode-jsonrpc';
10
- import { type DataClientProtocol, type DataServerProtocol } from '../data';
11
- import { type RpcProxy } from '../rpc';
9
+ import { type Disposable, Emitter, type Event } from 'vscode-jsonrpc';
10
+ import { type Clock } from '../clock';
11
+ import type { DataServerProtocol, DiagnosticOf, TransferDocumentDirtyChangedEvent } from '../data';
12
+ import type { SnapshotVersion } from '../model-service/based-on';
13
+ import { type ResolvedMessage } from '../messages/primitives';
14
+ import type { OpenModelArgs } from '../model-server';
15
+ import type { MaybePromise } from '../util';
16
+ import type { RpcProxy } from '../rpc';
12
17
  import type { TransferDocument } from '../transfer-document';
13
18
  import type { TransferElement } from '../transfer-element';
14
- import type { DataPort } from './data-port';
15
- /** Options for {@link DataSession}. */
16
- export interface DataSessionOptions {
19
+ /**
20
+ * A session could not re-open a document it had open after its connection
21
+ * dropped.
22
+ */
23
+ export declare const DATA_SESSION_RESTORE_FAILED: import("../messages/primitives").MessageDefinition<"Could not restore {uri} after reconnecting to the data server: {detail}">;
24
+ /**
25
+ * A session re-opened documents after its connection dropped whose version had
26
+ * moved on since the session's last unsaved write to them: another client
27
+ * edited them, even while the session was still connected, the server reverted
28
+ * them to what is on disk, or the server restarted. The session's unsaved edits
29
+ * may be gone.
30
+ */
31
+ export declare const DATA_SESSION_UNSAVED_LOST: import("../messages/primitives").MessageDefinition<"Unsaved changes to {uris} may have been lost when the connection to the data server dropped.">;
32
+ /**
33
+ * What one of `TServer`'s document methods takes, minus the `clientId` a
34
+ * {@link DataSession} stamps itself.
35
+ *
36
+ * Read off the SERVER's signature, not off the framework's own arg type: an
37
+ * adopter server widens these, and a wrapper declared against the narrow
38
+ * shape rejects the extra field on a fresh object literal, so that call
39
+ * cannot go through a session at all.
40
+ */
41
+ export type DataSessionArgs<TMethod extends (args: never) => unknown> = Omit<Parameters<TMethod>[0], 'clientId'>;
42
+ /**
43
+ * Open a document through a session; the session supplies `clientId`. Only the
44
+ * URI and the open's options: a session's open reads the file, and the server
45
+ * ignores the `languageId`, `version` and `text` seeds of `OpenModelArgs`, so
46
+ * accepting them here would let a caller believe they took effect.
47
+ */
48
+ export type DataSessionOpenArgs<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> = Pick<OpenModelArgs, 'uri' | 'options'>;
49
+ /** Create a document through a session; the session supplies `clientId`. */
50
+ export type DataSessionCreateArgs<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> = DataSessionArgs<TServer['createModelDocument']>;
51
+ /** Close a document through a session; the session supplies `clientId`. */
52
+ export type DataSessionCloseArgs<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> = DataSessionArgs<TServer['closeModelDocument']>;
53
+ /** Update a document through a session; the session supplies `clientId`. */
54
+ export type DataSessionUpdateArgs<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> = DataSessionArgs<TServer['updateModelDocument']>;
55
+ /** Update several documents at once through a session; the session supplies `clientId`. */
56
+ export type DataSessionUpdatesArgs<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> = DataSessionArgs<TServer['updateModelDocuments']>;
57
+ /** Persist a document through a session; the session supplies `clientId`. */
58
+ export type DataSessionSaveArgs<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> = DataSessionArgs<TServer['saveModelDocument']>;
59
+ /** The document a session hands back, carrying its server's diagnostic shape. */
60
+ export type DataSessionDocument<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> = TransferDocument<TTransfer, DiagnosticOf<TServer>>;
61
+ /**
62
+ * What a {@link DataSession} needs from the connection that minted it.
63
+ *
64
+ * Narrower than the connection itself so the dependency points one way:
65
+ * `DataConnection` constructs sessions, and nothing here imports it back.
66
+ */
67
+ export interface DataSessionHost<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>>> {
68
+ /** The connected, READY proxy of the current connection; a new object after each reconnect. */
69
+ connected(): Promise<RpcProxy<TServer>>;
70
+ /** Surface a failure no caller is waiting on, such as restoring a document after a reconnect. */
71
+ reportError?(error: unknown, reported: ResolvedMessage): void;
17
72
  /**
18
- * Wire namespace the server is addressed under. Defaults to the
19
- * framework's {@link DATA_SERVER_WIRE_PREFIX}, which is what an unmodified
20
- * `DataServer` binds. Override only alongside the server's own
21
- * `methodNamespace` option — a mismatch turns every request into
22
- * "Unhandled method" rather than failing at wire-up.
73
+ * Tell the connection's client the dirty state a restore read, unless it
74
+ * is what the client was last told of the URI since the URI's last open.
23
75
  */
24
- readonly methodNamespace?: string;
25
- }
26
- /** One connection generation: its connection, its proxy, and its readiness. */
27
- interface Generation<TTransfer extends TransferElement> {
28
- readonly connection: Promise<MessageConnection>;
29
- readonly server: RpcProxy<DataServerProtocol<TTransfer>>;
30
- /** Set on first use; the shared readiness gate for this generation. */
31
- ready?: Promise<void>;
76
+ restoreDirty?(event: TransferDocumentDirtyChangedEvent): void;
77
+ /**
78
+ * Forget what the client was told of `uri`'s dirty state: an open just
79
+ * made answered its caller afresh, and the client heard none of it, or a
80
+ * close leaves nothing to restore. Forgetting a URI another session still
81
+ * has open costs at most one repeat of a state the client already has.
82
+ */
83
+ forgetDirty?(uri: string): void;
32
84
  }
33
85
  /**
34
- * The host-invariant half of talking to the data head: everything above
35
- * {@link DataPort} that would otherwise be re-derived by every host
36
- * adapter.
86
+ * Builds the session `DataConnection.createSession` hands out, for an adopter
87
+ * that extends {@link DataSession}. The connection has minted `clientId` and
88
+ * checked it by then.
89
+ */
90
+ export type DataSessionFactory<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>>> = (clientId: string, host: DataSessionHost<TTransfer, TServer>, label: string) => DataSession<TTransfer, TServer>;
91
+ /**
92
+ * One participant on a data connection: a properties panel, a tree, a form
93
+ * editor. The client side of a server client session, registered over the
94
+ * wire under {@link clientId}.
37
95
  *
38
- * Three jobs, and deliberately no fourth:
96
+ * The session writes only what it has open: the server refuses its update or
97
+ * save of a document it has not opened with a `DocumentNotOpenError` code.
98
+ * Every call waits for the registration, so the first can be issued at once.
39
99
  *
40
- * 1. **Build the typed proxy** over the port's connection, with the framework's
41
- * wire prefix and its drift-proof client-method allowlist.
42
- * 2. **Own the readiness gate** — `waitForReady` once per connection, shared
43
- * across concurrent callers. A socket client can connect before the
44
- * workspace walk finishes, and an early request is then answered correctly
45
- * from an empty registry, which reads as a broken project tier rather than
46
- * as a race.
47
- * 3. **Own the reconnect policy**, by dropping its connection generation when
48
- * the port disposes and building a fresh one on the next request.
100
+ * Every document operation stamps {@link clientId} itself. A caller that
101
+ * passed its own could pass another participant's, and the server would
102
+ * attribute the write and close the document accordingly.
49
103
  *
50
- * It does **not** wrap the protocol methods; callers reach them through
51
- * {@link connected}. The one exception is {@link openDocument}, which exists
52
- * because the open/watch *order* is silently wrong the other way round — see
53
- * its own doc.
104
+ * {@link closeDocument} and {@link dispose} first wait, up to
105
+ * {@link settleBeforeCloseMs}, for this session's calls still in flight on the
106
+ * URI, or on any URI for `dispose`: a save sent just before its close would
107
+ * otherwise reach the server after it, and fail as not open.
54
108
  *
55
- * Generic over the transfer root so this file names no grammar. An adopter
56
- * binds the concrete root (or the union of them, for a multi-grammar head) at
57
- * its own edge.
109
+ * After the connection drops, the session registers again under the same id,
110
+ * re-opens and re-watches what it had open, tells the client of their dirty
111
+ * state where it changed, and reports the documents whose unsaved edits did
112
+ * not survive; see {@link restore}. The connection does this at
113
+ * once for a session with documents open, and any session's next call does it
114
+ * too.
115
+ *
116
+ * Generic over the transfer root so this file names no grammar.
117
+ *
118
+ * `TServer` is bound to a server answering with ITS OWN diagnostic shape, read
119
+ * back off the parameter being bound. Simplifying that to
120
+ * `DataServerProtocol<TTransfer>` compiles and costs the wrappers their
121
+ * return type: every call through `TServer` would resolve against that looser
122
+ * bound, so an adopter's diagnostics would come back as the framework's and
123
+ * the document would have to be cast on the way out.
58
124
  */
59
- export declare class DataSession<TTransfer extends TransferElement> {
60
- protected readonly port: DataPort;
61
- protected readonly client: DataClientProtocol<TTransfer>;
62
- protected readonly methodNamespace: string;
63
- /** The current generation, or `undefined` before the first request / after a teardown. */
64
- protected generation?: Generation<TTransfer>;
65
- protected disposed: boolean;
66
- protected readonly portDisposeListener: {
67
- dispose(): void;
68
- };
69
- constructor(port: DataPort, client: DataClientProtocol<TTransfer>, options?: DataSessionOptions);
70
- /** The identity every request is made under — the port's, not a second one. */
71
- get clientId(): string;
72
- /**
73
- * The connected, READY server proxy.
74
- *
75
- * Returns the proxy rather than `void` on purpose. A reconnect replaces the
76
- * proxy, so a caller that cached one from an earlier call would go on
77
- * addressing a dead connection with no error — handing it back per call
78
- * makes the stale reference unrepresentable.
125
+ export declare class DataSession<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>> = DataServerProtocol<TTransfer>> implements Disposable {
126
+ readonly clientId: string;
127
+ protected readonly host: DataSessionHost<TTransfer, TServer>;
128
+ readonly label: string;
129
+ /**
130
+ * How long {@link closeDocument} and {@link dispose} wait for this session's
131
+ * calls in flight before closing anyway. Long, because the wait only runs
132
+ * out when a call hangs, and a close sent while a save is still running
133
+ * fails that save.
134
+ */
135
+ protected readonly settleBeforeCloseMs: number;
136
+ /**
137
+ * The clock {@link settleBeforeCloseMs} runs on. {@link DataSessionHost}
138
+ * carries no {@link Clock}, so a subclass replaces this field as it
139
+ * replaces the bound.
140
+ */
141
+ protected readonly clock: Clock;
142
+ /** URIs this session has open, re-opened after a reconnect. */
143
+ protected readonly openUris: Set<string>;
144
+ /**
145
+ * Per URI in {@link openUris}, the URI the server's last answer to its open
146
+ * or re-open named. The server keys its notifications by it, and so does
147
+ * the host's record of what its client was told.
148
+ */
149
+ protected readonly serverUris: Map<string, string>;
150
+ /**
151
+ * Per URI, how many opens of it this session has under way. Such a URI
152
+ * counts as open for {@link withOpenDocument}, which would otherwise close
153
+ * it under the open that is still being made.
154
+ */
155
+ protected readonly openingUris: Map<string, number>;
156
+ /**
157
+ * Per URI written since its last save, the version the server answered this
158
+ * session's last write with; see {@link restore}.
159
+ */
160
+ protected readonly unsavedWrites: Map<string, SnapshotVersion>;
161
+ /** Per URI, this session's calls still in flight on it, which a close waits for. */
162
+ protected readonly inFlight: Map<string, Set<Promise<unknown>>>;
163
+ /** This session's saves still in flight, which a host's exit waits for; see {@link hasSavesInFlight}. */
164
+ protected readonly savesInFlight: Set<Promise<unknown>>;
165
+ protected readonly disposeEmitter: Emitter<void>;
166
+ /**
167
+ * Fires once when the session ends, by {@link dispose} or {@link detach}, as
168
+ * soon as it rejects further calls and before any close is sent. For a
169
+ * session its connection created, the connection's listener runs first, so
170
+ * the id is free again on that connection by the time any other listener
171
+ * runs; the server still holds it until the close arrives, and refuses a new
172
+ * session under it until then.
79
173
  *
80
- * Concurrent callers share one readiness promise, so `waitForReady` is
81
- * awaited once per generation and not once per caller.
174
+ * A listener subscribed once the session has ended is never called, so a
175
+ * late subscriber checks {@link isDisposed} first.
82
176
  */
83
- connected(): Promise<RpcProxy<DataServerProtocol<TTransfer>>>;
177
+ readonly onDidDispose: Event<void>;
84
178
  /**
85
- * Open `uri` for editing and start watching it, in that order, returning
86
- * the opened snapshot.
179
+ * Sent with every registration, so the server lets this session register
180
+ * its id again while the dropped connection's session is still live there:
181
+ * a server that has not yet noticed the drop would otherwise refuse the id
182
+ * as a duplicate until it does.
183
+ */
184
+ protected readonly resumeToken: string;
185
+ /** The proxy the session is registered on; another one means the connection was replaced. */
186
+ protected registeredOn?: RpcProxy<TServer>;
187
+ protected registration?: Promise<void>;
188
+ protected disposed: boolean;
189
+ /**
190
+ * Disposed through {@link detach} rather than {@link dispose}, so nothing may
191
+ * be sent. Folding it into {@link disposed} would send the session's close
192
+ * over a connection that is going away.
193
+ */
194
+ protected detached: boolean;
195
+ constructor(clientId: string, host: DataSessionHost<TTransfer, TServer>, label: string);
196
+ /**
197
+ * The connected, READY server proxy once this session is registered on it,
198
+ * for protocol methods this session does not wrap. The proxy stamps
199
+ * nothing: pass this session's {@link clientId} to any method that carries
200
+ * one.
201
+ */
202
+ connected(): Promise<RpcProxy<TServer>>;
203
+ /**
204
+ * Open `args.uri` for editing and start watching it, in that order,
205
+ * returning the opened snapshot.
87
206
  *
88
207
  * **The order is the whole reason this method exists.**
89
208
  * `watchModelDocument` baselines its dedup fingerprint from the *current*
@@ -91,39 +210,141 @@ export declare class DataSession<TTransfer extends TransferElement> {
91
210
  * baseline, and the first phase event after the open arrives as a spurious
92
211
  * `'changed'` — which a widget that resets its in-memory root to the server
93
212
  * view misreads as a concurrent third-party write, losing whatever the user
94
- * had typed. Nothing about the wrong order fails loudly, so it is encoded
95
- * here rather than documented and re-derived.
213
+ * had typed.
96
214
  *
97
215
  * Note that the returned snapshot's empty `diagnostics` does not mean
98
216
  * valid: `open` settles at the integrity landmark, not at validation.
99
217
  * Validity arrives asynchronously on `onDocumentUpdated`, or synchronously
100
218
  * from `getModelDocument({ includeDiagnostics: true })`.
101
219
  */
102
- openDocument(uri: string): Promise<TransferDocument<TTransfer>>;
220
+ openDocument(args: DataSessionOpenArgs<TTransfer, TServer>): Promise<DataSessionDocument<TTransfer, TServer>>;
221
+ /**
222
+ * Create a document that exists nowhere yet, open and watched for this
223
+ * session; it reaches disk with the first {@link saveDocument}. The server
224
+ * refuses a URI that exists on disk or that any client has open.
225
+ */
226
+ createDocument(args: DataSessionCreateArgs<TTransfer, TServer>): Promise<DataSessionDocument<TTransfer, TServer>>;
227
+ /**
228
+ * Watch a document this session just opened, and record it as open. A
229
+ * failed watch closes it again: the caller sees a failed open and so would
230
+ * never close it.
231
+ */
232
+ protected watchOpened(server: RpcProxy<TServer>, uri: string, document: DataSessionDocument<TTransfer, TServer>): Promise<DataSessionDocument<TTransfer, TServer>>;
233
+ /**
234
+ * Close `args.uri`, once this session's calls on it have settled or
235
+ * {@link settleBeforeCloseMs} has passed. The server unwatches implicitly,
236
+ * so this is the dual of {@link openDocument} and needs no separate unwatch.
237
+ */
238
+ closeDocument(args: DataSessionCloseArgs<TTransfer, TServer>): Promise<void>;
239
+ /**
240
+ * Open `args.uri`, run `fn` with the opened snapshot, and close it once
241
+ * `fn` settles, whether it returned or threw. A URI this session already
242
+ * had open, or is still opening through another call, stays open: the close
243
+ * undoes only the open this call made.
244
+ */
245
+ withOpenDocument<T>(args: DataSessionOpenArgs<TTransfer, TServer>, fn: (document: DataSessionDocument<TTransfer, TServer>) => MaybePromise<T>): Promise<T>;
246
+ /** Write `args.model` back as this session. The session must have `args.uri` open. */
247
+ updateDocument(args: DataSessionUpdateArgs<TTransfer, TServer>): Promise<DataSessionDocument<TTransfer, TServer>>;
248
+ /**
249
+ * Write several documents this session has open, all or none: the server
250
+ * refuses the whole set, before any text applies, when one is stale or not
251
+ * open. Resolves to the documents in the order given.
252
+ */
253
+ updateDocuments(args: DataSessionUpdatesArgs<TTransfer, TServer>): Promise<DataSessionDocument<TTransfer, TServer>[]>;
254
+ /** Persist `args.model` to disk as this session. The session must have `args.uri` open. */
255
+ saveDocument(args: DataSessionSaveArgs<TTransfer, TServer>): Promise<DataSessionDocument<TTransfer, TServer>>;
256
+ /** Whether the session has ended, by {@link dispose} or {@link detach}. */
257
+ get isDisposed(): boolean;
103
258
  /**
104
- * Close `uri`. The server unwatches implicitly, so this is the dual of
105
- * {@link openDocument} and needs no separate unwatch.
259
+ * Whether a save of this session has not answered yet. Synchronous, for a
260
+ * host whose exit veto must decide within the tick, such as Theia's
261
+ * `onWillStop`.
106
262
  */
107
- closeDocument(uri: string): Promise<void>;
263
+ get hasSavesInFlight(): boolean;
108
264
  /**
109
- * Whether `event.sourceClientId` identifies this session's own write.
265
+ * Resolves once the saves in flight now have answered, or
266
+ * {@link settleBeforeCloseMs} has passed. Never rejects: a failed save has
267
+ * answered too.
268
+ */
269
+ whenSavesSettled(): Promise<void>;
270
+ /**
271
+ * Whether `sourceClientId` identifies this session's own write.
110
272
  *
111
273
  * Every watcher needs this and the check is one comparison, so getting it
112
274
  * wrong is cheap to do and expensive to find: an unfiltered echo looks
113
275
  * exactly like a concurrent third-party edit.
114
276
  */
115
277
  isOwnEcho(sourceClientId: string): boolean;
116
- /** Tear down the current connection and stop tracking the port. Idempotent. */
278
+ /**
279
+ * End the session: detach it from the connection at once, and once its
280
+ * calls in flight have settled or {@link settleBeforeCloseMs} has passed,
281
+ * end it on the server, which closes everything it has open. Idempotent,
282
+ * and leaves the connection usable by its other sessions.
283
+ *
284
+ * Every later call rejects, and so does a call made earlier in the same
285
+ * tick, which has not reached the wire yet and is never sent. The server
286
+ * close is not awaited, because a `Disposable` cannot be; a close that fails
287
+ * leaves the session to the server's connection-close cleanup.
288
+ */
117
289
  dispose(): void;
118
- /** The live generation, building one if there is none. */
119
- protected currentGeneration(): Generation<TTransfer>;
120
- /** Await the connection and the server's startup gate for one generation. */
121
- protected awaitReady(generation: Generation<TTransfer>): Promise<void>;
122
290
  /**
123
- * Discard the current generation, disposing its connection if it opened.
124
- * The next {@link connected} builds a fresh one.
291
+ * Come off the connection because it is going away.
292
+ *
293
+ * Sends nothing, unlike {@link dispose}: the server ends every session on a
294
+ * connection it sees close, and the close would travel over the very
295
+ * connection being disposed.
296
+ *
297
+ * Public because the connection calls it; anyone else ends a session with
298
+ * {@link dispose}. It fires {@link onDidDispose} only if the session has not
299
+ * already ended, and after {@link dispose} it still cancels the close that
300
+ * dispose has not sent yet.
301
+ */
302
+ detach(): void;
303
+ /** Fire {@link onDidDispose} and dispose its emitter, so a second call fires nothing. */
304
+ protected fireDispose(): void;
305
+ /**
306
+ * Register again and restore now, after the connection dropped, instead of
307
+ * on the next call. A no-op for a session with nothing open, which the next
308
+ * call restores anyway. A failure is left to that next call, which meets it
309
+ * again.
310
+ */
311
+ reconnect(): void;
312
+ /**
313
+ * Register on `server`, and after a reconnect restore what the ended session
314
+ * had. Calls issued meanwhile wait for this.
315
+ */
316
+ protected register(server: RpcProxy<TServer>, reconnected: boolean): Promise<void>;
317
+ /**
318
+ * Re-open and re-watch every document the session had open, and tell the
319
+ * host which of them lost what the session wrote since their last save.
320
+ *
321
+ * The unsaved text is not sent again. A document whose re-opened version is
322
+ * the one the session's last write was answered with still holds that
323
+ * write. Any other version means the text changed after that write:
324
+ * another client edited it, even while the session was still connected;
325
+ * the server reverted it to disk when the session's open closed as the
326
+ * document's last; or the server restarted and numbers versions afresh.
327
+ * Re-sending based on the write's own version then always conflicts, and
328
+ * based on the re-opened version it would overwrite whatever changed, so
329
+ * neither is done.
330
+ *
331
+ * No caller is waiting, so both outcomes go through the host: one report
332
+ * naming every document whose unsaved text is gone, whose record is then
333
+ * dropped, and one per document that could not be re-opened, which is
334
+ * forgotten.
335
+ *
336
+ * Each document's dirty state goes to the host too, read once the watch is
337
+ * in place: a flip while the connection was down, or between the re-open
338
+ * and the watch, reached no one, and the re-open's own answer misses the
339
+ * second.
125
340
  */
126
- protected dropGeneration(): void;
341
+ protected restore(server: RpcProxy<TServer>): Promise<void>;
342
+ /** Run `call`, counted as in flight on each of `uris` until it settles. */
343
+ protected track<T>(uris: readonly string[], call: () => Promise<T>): Promise<T>;
344
+ /** {@link track} an open of `uri`, counted in {@link openingUris} until it settles. */
345
+ protected trackOpen<T>(uri: string, call: () => Promise<T>): Promise<T>;
346
+ /** Wait until `calls` have settled, or {@link settleBeforeCloseMs} has passed. */
347
+ protected settle(calls: Iterable<Promise<unknown>> | undefined): Promise<void>;
348
+ protected assertLive(): void;
127
349
  }
128
- export {};
129
350
  //# sourceMappingURL=data-session.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"data-session.d.ts","sourceRoot":"","sources":["../../src/client/data-session.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAyD,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClI,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,+EAA+E;AAC/E,UAAU,UAAU,CAAC,SAAS,SAAS,eAAe;IACnD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW,CAAC,SAAS,SAAS,eAAe;IAQpD,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ;IACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,SAAS,CAAC;IAR3D,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,0FAA0F;IAC1F,SAAS,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7C,SAAS,CAAC,QAAQ,UAAS;IAC3B,SAAS,CAAC,QAAQ,CAAC,mBAAmB,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAC;gBAGtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACxD,OAAO,GAAE,kBAAuB;IAMnC,+EAA+E;IAC/E,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;;;;;;OAUG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;IAYnE;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAOrE;;;OAGG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;;;;;OAMG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAI1C,+EAA+E;IAC/E,OAAO,IAAI,IAAI;IASf,0DAA0D;IAC1D,SAAS,CAAC,iBAAiB,IAAI,UAAU,CAAC,SAAS,CAAC;IAkBpD,6EAA6E;cAC7D,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5E;;;OAGG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;CAQlC"}
1
+ {"version":3,"file":"data-session.d.ts","sourceRoot":"","sources":["../../src/client/data-session.ts"],"names":[],"mappings":"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"}