@ignite-ember/extension-bridge 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/NOTICE CHANGED
@@ -2,4 +2,4 @@ igni
2
2
  Copyright 2026 Ignite Ember
3
3
 
4
4
  This product includes software developed at Ignite Ember
5
- (https://ignite-ember.sh/).
5
+ (https://igni.sh/).
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # `@ignite-ember/extension-bridge`
2
2
 
3
- **Full documentation:** [ignite-ember.sh/docs/sdk/extension-bridge](https://ignite-ember.sh/docs/sdk/extension-bridge) — guides and the complete API reference, a page per topic.
3
+ **Full documentation:** [igni.sh/docs/sdk/extension-bridge](https://igni.sh/docs/sdk/extension-bridge) — guides and the complete API reference, a page per topic.
4
4
 
5
5
  The guest half of the bridge between an igni extension's page and igni:
6
6
  `connect()`, RPC to the extension's tools, navigation, and the theme. The
@@ -50,7 +50,14 @@ async function main() {
50
50
  // The extension's own backend, as the person signed in to igni.
51
51
  const notes = await bridge.rpc("ext.example.teamnotes.search", { query: "" });
52
52
 
53
- render(notes);
53
+ // Draw it however your page draws: plain DOM here, React with @ignite-ember/ui-react.
54
+ const list = document.createElement("ul");
55
+ for (const note of notes as { title: string }[]) {
56
+ const item = document.createElement("li");
57
+ item.textContent = note.title;
58
+ list.append(item);
59
+ }
60
+ document.body.append(list);
54
61
  }
55
62
 
56
63
  main().catch((error) => {
@@ -95,7 +102,7 @@ framed by a host.
95
102
  ## The host: `bridge.host`
96
103
 
97
104
  `bridge.host` is igni as the page sees it — the **host object model**
98
- (`docs/HOST_OBJECT_MODEL.md` in igni), the same model the extension's
105
+ ([`docs/HOST_OBJECT_MODEL.md`](https://github.com/ignite-ember/igni-core/blob/main/docs/HOST_OBJECT_MODEL.md) in igni-core), the same model the extension's
99
106
  process reaches as `ext.host`. Names are the schema's, as in Python.
100
107
 
101
108
  ```ts
@@ -135,11 +142,14 @@ socket.addEventListener("message", (e) => render(JSON.parse(e.data)));
135
142
 
136
143
  `url` is `null` when the extension has no service a page may reach, and
137
144
  then `fetch` and `websocket` reject with `no_service`. An extension igni
138
- distributed always has one: the service that shipped it. A development
145
+ distributed always has a service: the one that shipped it. A development
139
146
  install has one only when its manifest declares a `serviceUrl` setting
140
- (`contributes.settings`) and it is set; a plain-`http` URL counts only for
141
- this machine (`localhost`, `127.0.0.1`, `::1`) and only with
142
- `IGNI_DEV_EXTENSIONS=1`, so a service on another host must be `https`.
147
+ (`contributes.settings`) and it is set. A page is given the service only
148
+ over `https`: a plain-`http` URL counts only for this machine (`localhost`,
149
+ any name under `.localhost`, or a loopback address such as `127.0.0.1` or
150
+ `::1`) and only with `IGNI_DEV_EXTENSIONS=1`. A service on another host,
151
+ or on this machine outside development, leaves `url` `null`; a service on
152
+ another host must be `https`.
143
153
 
144
154
  `websocket` resolves once the socket is open and has sent
145
155
  `{"type": "auth", "token": …}` as its first frame (a browser socket
@@ -168,9 +178,13 @@ const one = await bridge.rpc<Note>("ext.example.teamnotes.get", { id: "n1" });
168
178
  reaches your service as an MCP tool call.
169
179
  - **The arguments** are a plain record of strings and JSON values, sent
170
180
  as they are.
171
- - **The answer** is whatever the service returned, parsed as JSON. Give
172
- the call its type — `rpc<Note>(...)` — and the compiler will hold you
173
- to it; nothing checks it at runtime.
181
+ - **The answer** is the tool's text answer, parsed as JSON when it is
182
+ JSON and the text itself when it is not: a tool returning a `dict` or a
183
+ `json.dumps(...)` string gives an object, one returning a sentence a
184
+ string, and one returning a Python `list` its items' text, one per
185
+ line ([igni-extension's table](../igni-extension/README.md#what-a-tool-returns)).
186
+ Give the call its type — `rpc<Note>(...)` — and the compiler will hold
187
+ you to it; nothing checks it at runtime.
174
188
  - **The deadline** is thirty seconds. `timeoutMs` overrides it. The host
175
189
  has a timeout of its own, and the shorter of the two is the one that
176
190
  fires.
@@ -201,10 +215,9 @@ one of the host's signals.
201
215
 
202
216
  `bridge.on(signal, fn, onRefused?)` takes a third argument, and it
203
217
  matters: a signal whose object is **not granted** never arrives, and
204
- without `onRefused` that refusal is silent — your handler simply never
205
- runs, and there is nothing in the console to say why. With it, the
206
- refusal arrives as a `HostError` you can show. Without it, it goes to
207
- the console, so it is never *completely* silent.
218
+ without `onRefused` your handler simply never runs, with only a console
219
+ warning (`igni bridge: subscribing to <signal> failed: …`) to say why.
220
+ With it, the refusal arrives as a `HostError` you can show.
208
221
 
209
222
  The first handler of a signal subscribes to it; removing the last one
210
223
  unsubscribes.
@@ -225,11 +238,73 @@ keystroke.
225
238
  `bridge.close()` tells the host this surface is finished. `bridge.navigate(to)`
226
239
  asks the host app to navigate; it decides whether to.
227
240
 
241
+ ## Putting a built page in the extension
242
+
243
+ An extension's page is the `ui/` directory of its package, and its entry is
244
+ `ui/index.html`. A page built with a bundler goes there as files: build to
245
+ `ui/` (or copy the output into it), keep the script and stylesheet as files
246
+ (the page's CSP is `script-src 'self'`, so nothing may be inline), and make
247
+ the asset URLs relative. With Vite that is `base: "./"` in `vite.config`.
248
+ `igni ext init` writes a no-build page in `ui/`; replace it with the build.
249
+
250
+ A development install (`IGNI_DEV_EXTENSIONS=1 igni ext install <dir>`) is a
251
+ copy of the directory in igni's extension store, so a rebuilt page reaches
252
+ igni only by installing again: `igni ext install --replace <dir>`, which
253
+ prints again what the extension may use (it asks nothing). A running igni
254
+ serves the rebuilt page at once: reload it. A second install without
255
+ `--replace` is refused ("already installed").
256
+
257
+ With TypeScript 6 or later, `import "@ignite-ember/ui-css"` type-checks
258
+ because the stylesheet package ships a declaration for it (0.2.0 and later).
259
+
260
+ ## Testing a page
261
+
262
+ Only igni's app frames a page, and only igni's window carries a page's
263
+ `ext.*` calls to igni, in the page's extension's name; a program, a
264
+ browser test or `igni-client` cannot make those calls as the page. So a
265
+ page is tested with a stand-in for its parent window, and the tool behind
266
+ a call is tested on its own, with igni-extension's `HostHarness`.
267
+
268
+ The page speaks to its parent with `postMessage`, in the shapes the
269
+ `protocol` subpath exports. A stand-in parent sends `hello`, reads each
270
+ `call` the page posts, and answers it with a `result` of the same `id`:
271
+
272
+ ```ts
273
+ import { BRIDGE_VERSION, isGuestMessage } from "@ignite-ember/extension-bridge/protocol";
274
+ import type { HelloMessage, ResultMessage } from "@ignite-ember/extension-bridge/protocol";
275
+
276
+ const hello: HelloMessage = {
277
+ igni: BRIDGE_VERSION, kind: "hello", nonce: "n1", extensionId: "acme.tickets",
278
+ params: {}, theme: "dark", tokens: {},
279
+ };
280
+ // After the frame's load event: connect() hears only a hello posted once
281
+ // the page's script runs, and one posted earlier is lost.
282
+ frame.addEventListener("load", () => frame.contentWindow!.postMessage(hello, "*"));
283
+
284
+ window.addEventListener("message", (event) => {
285
+ if (event.source !== frame.contentWindow || !isGuestMessage(event.data)) return;
286
+ if (event.data.kind !== "call") return;
287
+ const answer: ResultMessage = {
288
+ igni: BRIDGE_VERSION, kind: "result", id: event.data.id, ok: true,
289
+ value: { id: "T-1001", status: "open" }, // what the tool would return
290
+ };
291
+ frame.contentWindow!.postMessage(answer, "*");
292
+ });
293
+ ```
294
+
295
+ `packages/test-utils/ticketLookupPage.test.ts` in this repository does
296
+ this for the ticket-lookup example's page, in jsdom.
297
+
298
+ There is deliberately no way to send a framed page's calls to the real
299
+ backend outside igni's app — no URL to point it at, no token to pass: the
300
+ answers in a test are the stand-in's. What the real tool returns is tested
301
+ on the tool, with `HostHarness`, and the two meet in igni's app.
302
+
228
303
  ## The floor
229
304
 
230
305
  Everything this package exports is under igni's **compatibility floor**:
231
306
  removing a name, renaming it, or changing the meaning of one of its
232
- members is a breaking change under `docs/EXTENSIBILITY.md` §8.
307
+ members is a breaking change under [`docs/EXTENSIBILITY.md`](https://github.com/ignite-ember/igni-core/blob/main/docs/EXTENSIBILITY.md) §8.
233
308
 
234
309
  Two versions of that floor are worth knowing about:
235
310
 
@@ -262,24 +337,10 @@ reachable from `bridge.host`, and the page simply does not use it.
262
337
 
263
338
  ## Installing
264
339
 
265
- > **Until it is on npm: install it from a checkout.** The package is not
266
- > published yet, so `npm install @ignite-ember/extension-bridge` finds
267
- > nothing. Pack it from an igni-sdk checkout and install the tarball:
268
- >
269
- > ```bash
270
- > git clone https://github.com/ignite-ember/igni-sdk.git
271
- > npm pack --pack-destination ./sdk-packages ./igni-sdk/packages/extension-bridge
272
- > npm install ./sdk-packages/ignite-ember-extension-bridge-0.2.0.tgz
273
- > ```
274
- >
275
- > (`mkdir sdk-packages` first.) It ships TypeScript source and a compiled
276
- > build beside it (*The source, and a build beside it*, below), so the
277
- > tarball is all there is.
278
-
279
- Once published, from npm:
340
+ From npm, with the stylesheet a page is drawn with:
280
341
 
281
342
  ```bash
282
- npm install @ignite-ember/extension-bridge
343
+ npm install @ignite-ember/extension-bridge @ignite-ember/ui-css
283
344
  ```
284
345
 
285
346
  Each release's tarballs are also attached to igni-sdk's GitHub release
package/dist/bridge.d.ts CHANGED
@@ -26,6 +26,10 @@ import { type ExtensionSettings, type LaunchParams } from "./protocol.js";
26
26
  * `P` and `S` name the extension's own launch parameters and settings;
27
27
  * the bridge passes on what the host sent without checking it against
28
28
  * them.
29
+ *
30
+ * @param options — how long to wait for the host's `hello` before
31
+ * giving up: `timeoutMs`, in milliseconds, and thirty seconds by
32
+ * default.
29
33
  */
30
34
  export declare function connect<P extends LaunchParams = LaunchParams, S extends ExtensionSettings = ExtensionSettings>(options?: {
31
35
  timeoutMs?: number;
@@ -1 +1 @@
1
- {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CACrB,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAC/C,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAmC7D"}
1
+ {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CACrB,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAC/C,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAmC7D"}
package/dist/bridge.js CHANGED
@@ -27,6 +27,10 @@ import { isHostMessage, } from "./protocol.js";
27
27
  * `P` and `S` name the extension's own launch parameters and settings;
28
28
  * the bridge passes on what the host sent without checking it against
29
29
  * them.
30
+ *
31
+ * @param options — how long to wait for the host's `hello` before
32
+ * giving up: `timeoutMs`, in milliseconds, and thirty seconds by
33
+ * default.
30
34
  */
31
35
  export function connect(options = {}) {
32
36
  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
@@ -1 +1 @@
1
- {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}
@@ -34,13 +34,30 @@ export interface Bridge<P extends LaunchParams = LaunchParams, S extends Extensi
34
34
  * than a CSS variable — a canvas, a chart library.
35
35
  */
36
36
  readonly tokens: ThemeTokens;
37
- /** Call a backend RPC. Rejects with the host's refusal, as a sentence. */
37
+ /**
38
+ * Call a backend RPC. Rejects with the host's refusal, as a sentence.
39
+ *
40
+ * @param method — the method to call, as `ext.<extension-id>.<method>`
41
+ * names it.
42
+ * @param args — the method's arguments, by name.
43
+ * @param timeoutMs — how long to wait for the answer before giving up,
44
+ * in milliseconds. The host has a timeout of its own, and the
45
+ * shorter of the two is the one that fires.
46
+ */
38
47
  rpc<T = unknown>(method: string, args?: RpcArgs, timeoutMs?: number): Promise<T>;
39
- /** Ask the host app to navigate. It decides whether to. */
48
+ /**
49
+ * Ask the host app to navigate. It decides whether to.
50
+ *
51
+ * @param to — the page to go to; the host decides whether it exists.
52
+ */
40
53
  navigate(to: string): void;
41
54
  /** Tell the host this surface is finished. */
42
55
  close(): void;
43
- /** Follow the host's theme. Returns an unsubscribe. */
56
+ /**
57
+ * Follow the host's theme. Returns an unsubscribe.
58
+ *
59
+ * @param fn — called with the theme whenever it changes.
60
+ */
44
61
  onTheme(fn: (theme: string) => void): () => void;
45
62
  /**
46
63
  * Follow the launch parameters.
@@ -53,6 +70,8 @@ export interface Bridge<P extends LaunchParams = LaunchParams, S extends Extensi
53
70
  *
54
71
  * Fires only on change, never for the initial value; read
55
72
  * {@link params} for that.
73
+ *
74
+ * @param fn — called with the parameters whenever they change.
56
75
  */
57
76
  onParams(fn: (params: P) => void): () => void;
58
77
  /**
@@ -68,11 +87,14 @@ export interface Bridge<P extends LaunchParams = LaunchParams, S extends Extensi
68
87
  * Strings only, and keep it small — it ends up in the host's URL.
69
88
  * Call it when the user lands somewhere worth returning to, not on
70
89
  * every keystroke.
90
+ *
91
+ * @param state — where inside the extension the user is now, in
92
+ * strings, for the host to fold into its own URL.
71
93
  */
72
94
  setLocation(state: LocationState): void;
73
95
  /**
74
96
  * igni, as this extension sees it: the host object model
75
- * (`docs/HOST_OBJECT_MODEL.md` in igni). The same model the
97
+ * (igni-core's `docs/HOST_OBJECT_MODEL.md` (https://github.com/ignite-ember/igni-core/blob/main/docs/HOST_OBJECT_MODEL.md)). The same model the
76
98
  * extension's process reaches as `ext.host`.
77
99
  *
78
100
  * const busy = await bridge.host.chat.processing.get();
@@ -90,11 +112,16 @@ export interface Bridge<P extends LaunchParams = LaunchParams, S extends Extensi
90
112
  * one unsubscribes. A signal whose object is not granted never
91
113
  * arrives; the refusal goes to `onRefused`, or to the console when
92
114
  * there is none. Returns an unsubscribe.
115
+ *
116
+ * @param signal — the host signal to follow.
117
+ * @param fn — called with the signal's value each time it arrives.
118
+ * @param onRefused — called with the refusal when the host will not
119
+ * grant the signal; without one the refusal goes to the console.
93
120
  */
94
121
  on<T>(signal: Signal<T>, fn: (value: T) => void, onRefused?: (error: HostError) => void): () => void;
95
122
  /**
96
123
  * The extension's own service, reached directly, as the signed-in
97
- * person:
124
+ * person.
98
125
  *
99
126
  * const res = await bridge.service.fetch("/v1/notes");
100
127
  * const socket = await bridge.service.websocket("/v1/rooms/a");
@@ -102,7 +129,7 @@ export interface Bridge<P extends LaunchParams = LaunchParams, S extends Extensi
102
129
  * The host fetches a token whose audience is this extension's service
103
130
  * and nothing else; it is kept and renewed before it expires. No
104
131
  * `permissions.host` grant: having a service is the grant — see
105
- * `docs/HOST_OBJECT_MODEL.md` in igni. `url` is `null` when the
132
+ * igni-core's `docs/HOST_OBJECT_MODEL.md` (https://github.com/ignite-ember/igni-core/blob/main/docs/HOST_OBJECT_MODEL.md). `url` is `null` when the
106
133
  * extension has none.
107
134
  */
108
135
  readonly service: ServiceBridge;
@@ -1 +1 @@
1
- {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,OAAO,EACR,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,0CAA0C;AAC1C,MAAM,WAAW,MAAM,CACrB,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAE/C,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,0EAA0E;IAC1E,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8CAA8C;IAC9C,KAAK,IAAI,IAAI,CAAC;IACd,uDAAuD;IACvD,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9C;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAExC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB;;;;;;;OAOG;IACH,EAAE,CAAC,CAAC,EACF,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EACtB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GACrC,MAAM,IAAI,CAAC;IAEd;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC"}
1
+ {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,OAAO,EACR,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,0CAA0C;AAC1C,MAAM,WAAW,MAAM,CACrB,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAE/C,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;;;;;;;OASG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8CAA8C;IAC9C,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjD;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9C;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAExC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,CAAC,EACF,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EACtB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GACrC,MAAM,IAAI,CAAC;IAEd;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC"}
@@ -1 +1 @@
1
- {"version":3,"file":"correlator.d.ts","sourceRoot":"","sources":["../src/correlator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,qBAAa,UAAU;IASnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD;;;;OAIG;gBAEgB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,MAAM;IAG3C;;;;;OAKG;IACH,IAAI,CAAC,CAAC,EACJ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,KAAK,EACrB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,CAAC,CAAC;IAmBb,mCAAmC;IACnC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIzC,iCAAiC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAItC;;;;OAIG;IACH,OAAO,CAAC,IAAI;CAOb"}
1
+ {"version":3,"file":"correlator.d.ts","sourceRoot":"","sources":["../src/correlator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,qBAAa,UAAU;IASnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD;;;;OAIG;gBAEgB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,MAAM;IAG3C;;;;;OAKG;IACH,IAAI,CAAC,CAAC,EACJ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,KAAK,EACrB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,CAAC,CAAC;IA0Bb,mCAAmC;IACnC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIzC,iCAAiC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAItC;;;;OAIG;IACH,OAAO,CAAC,IAAI;CAOb"}
@@ -39,7 +39,15 @@ export class Correlator {
39
39
  reject,
40
40
  timer,
41
41
  });
42
- post(id);
42
+ try {
43
+ post(id);
44
+ }
45
+ catch (error) {
46
+ // Nothing was sent, so no reply will come: do not leave the
47
+ // waiter and its timer behind for a request that never left.
48
+ this.take(id);
49
+ throw error;
50
+ }
43
51
  });
44
52
  }
45
53
  /** The reply to `id` succeeded. */
@@ -1 +1 @@
1
- {"version":3,"file":"correlator.js","sourceRoot":"","sources":["../src/correlator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,OAAO,UAAU;IASF;IACA;IATF,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD;;;;OAIG;IACH,YACmB,MAAc,EACd,UAAwB;QADxB,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAc;IACxC,CAAC;IAEJ;;;;;OAKG;IACH,IAAI,CACF,SAAwB,EACxB,QAAqB,EACrB,IAA0B;QAE1B,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAChD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,KAAK,GACT,SAAS,KAAK,IAAI;gBAChB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACxB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACrB,CAAC,EAAE,SAAS,CAAC,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO,EAAE,OAAmC;gBAC5C,MAAM;gBACN,KAAK;aACN,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,OAAO,CAAC,EAAU,EAAE,KAAc;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,iCAAiC;IACjC,MAAM,CAAC,EAAU,EAAE,KAAY;QAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,IAAI,CAAC,EAAU;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
1
+ {"version":3,"file":"correlator.js","sourceRoot":"","sources":["../src/correlator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,OAAO,UAAU;IASF;IACA;IATF,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD;;;;OAIG;IACH,YACmB,MAAc,EACd,UAAwB;QADxB,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAc;IACxC,CAAC;IAEJ;;;;;OAKG;IACH,IAAI,CACF,SAAwB,EACxB,QAAqB,EACrB,IAA0B;QAE1B,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAChD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,KAAK,GACT,SAAS,KAAK,IAAI;gBAChB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACxB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACrB,CAAC,EAAE,SAAS,CAAC,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO,EAAE,OAAmC;gBAC5C,MAAM;gBACN,KAAK;aACN,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,CAAC;YACX,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,4DAA4D;gBAC5D,6DAA6D;gBAC7D,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACd,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,OAAO,CAAC,EAAU,EAAE,KAAc;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,iCAAiC;IACjC,MAAM,CAAC,EAAU,EAAE,KAAY;QAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,IAAI,CAAC,EAAU;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
@@ -37,7 +37,7 @@ export interface HostLink {
37
37
  * Send one request to the host.
38
38
  *
39
39
  * @param op — what to do: read a property, write one, or call a method.
40
- * @param path — where in the model, as `host.chat.processing`.
40
+ * @param path — where in the model, as `chat.processing`: the path without the leading `host.`.
41
41
  * @param options — the window or session it is about, the arguments
42
42
  * of a call, and the value of a write.
43
43
  * @returns — whatever the host answered with.
@@ -57,7 +57,7 @@ export interface HostLink {
57
57
  export declare class HostObject {
58
58
  /** How requests reach the host. */
59
59
  protected readonly link: HostLink;
60
- /** Where in the model this object sits: `host.chat`. */
60
+ /** Where in the model this object sits: `chat`, without the leading `host.`. */
61
61
  readonly path: string;
62
62
  /** The window it belongs to, when it belongs to one. */
63
63
  protected readonly window: string | null;
@@ -77,7 +77,7 @@ export declare class HostObject {
77
77
  constructor(
78
78
  /** How requests reach the host. */
79
79
  link: HostLink,
80
- /** Where in the model this object sits: `host.chat`. */
80
+ /** Where in the model this object sits: `chat`, without the leading `host.`. */
81
81
  path: string,
82
82
  /** The window it belongs to, when it belongs to one. */
83
83
  window?: string | null,
@@ -122,7 +122,7 @@ export declare class Property<T> {
122
122
  name: string,
123
123
  /** Whether it may be written. */
124
124
  writable: boolean);
125
- /** Where in the model this value sits: `host.chat.processing`. */
125
+ /** Where in the model this value sits: `chat.processing`, without the leading `host.`. */
126
126
  get path(): string;
127
127
  /**
128
128
  * Read it.
@@ -130,7 +130,11 @@ export declare class Property<T> {
130
130
  * @returns — the value the host holds right now.
131
131
  */
132
132
  get(): Promise<T>;
133
- /** Write it, as the person's UI would. Refused where theirs would be. */
133
+ /**
134
+ * Write it, as the person's UI would. Refused where theirs would be.
135
+ *
136
+ * @param value — what the host should hold for it from now on.
137
+ */
134
138
  set(value: T): Promise<void>;
135
139
  }
136
140
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"hostModel.d.ts","sourceRoot":"","sources":["../src/hostModel.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"hostModel.d.ts","sourceRoot":"","sources":["../src/hostModel.ts"],"names":[],"mappings":"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"}