@toa.io/boot 1.0.0-alpha.32 → 1.0.0-alpha.320

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 (60) hide show
  1. package/CHANGELOG.md +306 -0
  2. package/package.json +11 -8
  3. package/src/atom.js +41 -0
  4. package/src/atomicity.js +11 -0
  5. package/src/bindings/broadcast.js +3 -6
  6. package/src/bindings/constants.js +1 -3
  7. package/src/bindings/consume.js +18 -6
  8. package/src/bindings/emit.js +3 -6
  9. package/src/bindings/factory.js +5 -9
  10. package/src/bindings/inbound.js +11 -0
  11. package/src/bindings/index.js +7 -13
  12. package/src/bindings/outbound.js +10 -0
  13. package/src/bindings/produce.js +56 -17
  14. package/src/bindings/receive.js +3 -6
  15. package/src/bridge.js +22 -16
  16. package/src/call.js +28 -9
  17. package/src/cascade.js +16 -10
  18. package/src/component.js +98 -32
  19. package/src/composition.js +106 -15
  20. package/src/context.js +7 -8
  21. package/src/contract.js +11 -12
  22. package/src/emission.js +21 -14
  23. package/src/env.js +19 -12
  24. package/src/events.js +27 -0
  25. package/src/extensions/aspects.js +4 -8
  26. package/src/extensions/component.js +4 -8
  27. package/src/extensions/context.js +4 -8
  28. package/src/extensions/destinations.js +27 -0
  29. package/src/extensions/emitter.js +7 -9
  30. package/src/extensions/index.js +10 -19
  31. package/src/extensions/instances.js +2 -4
  32. package/src/extensions/load.js +7 -7
  33. package/src/extensions/manage.js +15 -0
  34. package/src/extensions/receiver.js +5 -9
  35. package/src/extensions/resolve.js +62 -13
  36. package/src/extensions/storage.js +6 -9
  37. package/src/extensions/tenants.js +5 -9
  38. package/src/guards.js +20 -0
  39. package/src/host.js +29 -0
  40. package/src/inbox.js +12 -0
  41. package/src/index.js +28 -34
  42. package/src/manifest.js +78 -36
  43. package/src/manifest.test.js +85 -8
  44. package/src/map.js +108 -0
  45. package/src/operation.js +26 -14
  46. package/src/outbox.js +22 -0
  47. package/src/rc.js +5 -0
  48. package/src/receivers.js +53 -23
  49. package/src/remote.js +41 -22
  50. package/src/rendering.js +50 -0
  51. package/src/span.js +19 -0
  52. package/src/storage.js +50 -16
  53. package/src/storage.test.js +57 -0
  54. package/src/workload.js +281 -0
  55. package/src/workload.test.js +321 -0
  56. package/types/bindings.d.ts +6 -2
  57. package/types/index.d.ts +62 -10
  58. package/types/manifest.d.ts +5 -4
  59. package/src/discovery.js +0 -43
  60. package/src/exposition.js +0 -17
package/CHANGELOG.md ADDED
@@ -0,0 +1,306 @@
1
+ # Change Log
2
+
3
+ All notable changes to this project will be documented in this file.
4
+ See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
+
6
+ # [1.0.0-alpha.320](https://github.com/toa-io/toa/compare/v1.0.0-alpha.319...v1.0.0-alpha.320) (2026-09-28)
7
+
8
+ **Note:** Version bump only for package @toa.io/boot
9
+
10
+
11
+
12
+
13
+
14
+ # [1.0.0-alpha.319](https://github.com/toa-io/toa/compare/v1.0.0-alpha.318...v1.0.0-alpha.319) (2026-09-27)
15
+
16
+ **Note:** Version bump only for package @toa.io/boot
17
+
18
+
19
+
20
+
21
+
22
+ # [1.0.0-alpha.318](https://github.com/toa-io/toa/compare/v1.0.0-alpha.317...v1.0.0-alpha.318) (2026-09-23)
23
+
24
+ **Note:** Version bump only for package @toa.io/boot
25
+
26
+
27
+
28
+
29
+
30
+ # [1.0.0-alpha.317](https://github.com/toa-io/toa/compare/v1.0.0-alpha.316...v1.0.0-alpha.317) (2026-09-23)
31
+
32
+ **Note:** Version bump only for package @toa.io/boot
33
+
34
+
35
+
36
+
37
+
38
+ # [1.0.0-alpha.316](https://github.com/toa-io/toa/compare/v1.0.0-alpha.315...v1.0.0-alpha.316) (2026-09-23)
39
+
40
+ **Note:** Version bump only for package @toa.io/boot
41
+
42
+
43
+
44
+
45
+
46
+ # [1.0.0-alpha.315](https://github.com/toa-io/toa/compare/v1.0.0-alpha.314...v1.0.0-alpha.315) (2026-09-23)
47
+
48
+ * feat(map)!: leave out of a contract what the runtime gives every component ([b81837a](https://github.com/toa-io/toa/commit/b81837a3bc4771d7ee1c10fe613c9a1d7501bf1a))
49
+
50
+ ### BREAKING CHANGES
51
+
52
+ * the deployed component map is `/etc/toa/.map.json.gz`.
53
+
54
+
55
+ # [1.0.0-alpha.314](https://github.com/toa-io/toa/compare/v1.0.0-alpha.313...v1.0.0-alpha.314) (2026-09-19)
56
+
57
+ * feat(core)!: let an operation state how long its calls are remembered ([af177c2](https://github.com/toa-io/toa/commit/af177c2ab3d00d475840b5ef9e612f04e82b72bd))
58
+
59
+ ### Features
60
+
61
+ * **core:** a destination renders the component's events ([2f93b28](https://github.com/toa-io/toa/commit/2f93b28bed61a0afe99cb8cfa646ed7815467497))
62
+ * **core:** a reference may name a declaration its package claims ([8040f60](https://github.com/toa-io/toa/commit/8040f60976549ab90497675bb54e664261f5b6bb))
63
+
64
+ ### BREAKING CHANGES
65
+
66
+ * `inbox.retention` under 600 is refused. See
67
+ migrations/313.md.
68
+
69
+
70
+ # [1.0.0-alpha.313](https://github.com/toa-io/toa/compare/v1.0.0-alpha.312...v1.0.0-alpha.313) (2026-09-18)
71
+
72
+ **Note:** Version bump only for package @toa.io/boot
73
+
74
+
75
+
76
+
77
+
78
+ # [1.0.0-alpha.312](https://github.com/toa-io/toa/compare/v1.0.0-alpha.311...v1.0.0-alpha.312) (2026-09-18)
79
+
80
+ ### Features
81
+
82
+ * **boot:** offer a streamed endpoint to the bindings that carry a stream ([0099b4e](https://github.com/toa-io/toa/commit/0099b4e12bff4ce5dba2d0098f0b8c6a18fff2c5))
83
+ * **boot:** tell a producer which of its endpoints take a stream ([6383adc](https://github.com/toa-io/toa/commit/6383adcebf38d889db80d8cbd19fe38f3ba4eb2e))
84
+ * **core:** refuse a call that carries no stream where the operation takes one ([fb78e02](https://github.com/toa-io/toa/commit/fb78e02fa620b15f6aa7bac184dd8a6ede923150))
85
+ * **core:** require the property that carries a stream, and refuse a task that carries one ([fdc7e6b](https://github.com/toa-io/toa/commit/fdc7e6b345ee22b030a52f1fda0e91e6bf63a392))
86
+
87
+
88
+ # [1.0.0-alpha.311](https://github.com/toa-io/toa/compare/v1.0.0-alpha.310...v1.0.0-alpha.311) (2026-09-17)
89
+
90
+ ### Features
91
+
92
+ * read the scope of a process once, as it boots ([0d65de5](https://github.com/toa-io/toa/commit/0d65de58ffc655ff872b8e66f95c5609ada3370a))
93
+
94
+
95
+ # [1.0.0-alpha.310](https://github.com/toa-io/toa/compare/v1.0.0-alpha.309...v1.0.0-alpha.310) (2026-09-16)
96
+
97
+ **Note:** Version bump only for package @toa.io/boot
98
+
99
+
100
+
101
+
102
+
103
+ # [1.0.0-alpha.309](https://github.com/toa-io/toa/compare/v1.0.0-alpha.308...v1.0.0-alpha.309) (2026-09-16)
104
+
105
+ **Note:** Version bump only for package @toa.io/boot
106
+
107
+
108
+
109
+
110
+
111
+ # [1.0.0-alpha.308](https://github.com/toa-io/toa/compare/v1.0.0-alpha.307...v1.0.0-alpha.308) (2026-09-15)
112
+
113
+ **Note:** Version bump only for package @toa.io/boot
114
+
115
+
116
+
117
+
118
+
119
+ # [1.0.0-alpha.307](https://github.com/toa-io/toa/compare/v1.0.0-alpha.306...v1.0.0-alpha.307) (2026-09-15)
120
+
121
+ **Note:** Version bump only for package @toa.io/boot
122
+
123
+
124
+
125
+
126
+
127
+ # [1.0.0-alpha.306](https://github.com/toa-io/toa/compare/v1.0.0-alpha.305...v1.0.0-alpha.306) (2026-09-14)
128
+
129
+ * refactor(core)!: name the quiesce hooks pause and unpause ([6e4e5f5](https://github.com/toa-io/toa/commit/6e4e5f55d43f03ea95ca8bbdaae57b949564dfa2))
130
+ * feat(boot)!: a process can be halted and come back ([7196fa5](https://github.com/toa-io/toa/commit/7196fa51a9c882e84c3767a4fdd329fd2df319f5))
131
+
132
+ ### Bug Fixes
133
+
134
+ * **boot:** declare what a workload does with a quiesce ([0e1521d](https://github.com/toa-io/toa/commit/0e1521d7abae3a3860a29978d267927d814c1d3a))
135
+ * **boot:** keep a halted process alive until it comes back ([3d3cc23](https://github.com/toa-io/toa/commit/3d3cc23835f836f9f98b1d9a448090a2b0d473c8))
136
+
137
+ ### Features
138
+
139
+ * **boot:** let a process go quiet and be let go again ([0fc3e66](https://github.com/toa-io/toa/commit/0fc3e66f217ab45e85f70271ab0768232b3fa088))
140
+ * **boot:** quiet a tree before taking it down ([7a339ca](https://github.com/toa-io/toa/commit/7a339caea4499509b55daf91061fc9836c0f6e68))
141
+ * **bridges.node:** let a component stop what it started and start it again ([d10d5d1](https://github.com/toa-io/toa/commit/d10d5d16fcd181e717d9d2cef4c7814ae8f2a93f))
142
+
143
+ ### BREAKING CHANGES
144
+
145
+ * `Host.halt` is `Host.stop`.
146
+ * `Host` gains `gate` and `halt`, and `Factory.service` may answer a gate. An
147
+ extension that gates nothing keeps its connections through a halt.
148
+
149
+
150
+ # [1.0.0-alpha.305](https://github.com/toa-io/toa/compare/v1.0.0-alpha.304...v1.0.0-alpha.305) (2026-09-13)
151
+
152
+ ### Features
153
+
154
+ * **core:** refuse a call that writes, made under a request that only reads ([92951d0](https://github.com/toa-io/toa/commit/92951d0f7b95bd5b838097dd6a42db5586968d0b))
155
+
156
+
157
+ # [1.0.0-alpha.304](https://github.com/toa-io/toa/compare/v1.0.0-alpha.303...v1.0.0-alpha.304) (2026-09-13)
158
+
159
+ **Note:** Version bump only for package @toa.io/boot
160
+
161
+
162
+
163
+
164
+
165
+ # [1.0.0-alpha.303](https://github.com/toa-io/toa/compare/v1.0.0-alpha.302...v1.0.0-alpha.303) (2026-09-12)
166
+
167
+ **Note:** Version bump only for package @toa.io/boot
168
+
169
+
170
+
171
+
172
+
173
+ # [1.0.0-alpha.302](https://github.com/toa-io/toa/compare/v1.0.0-alpha.301...v1.0.0-alpha.302) (2026-09-11)
174
+
175
+ ### Features
176
+
177
+ * **boot:** a run command may wait until the component is served ([0f66bed](https://github.com/toa-io/toa/commit/0f66bedf7b54dc9c1397f7f32bbccbffde7288ca))
178
+
179
+
180
+ # [1.0.0-alpha.301](https://github.com/toa-io/toa/compare/v1.0.0-alpha.300...v1.0.0-alpha.301) (2026-09-11)
181
+
182
+ **Note:** Version bump only for package @toa.io/boot
183
+
184
+
185
+
186
+
187
+
188
+ # [1.0.0-alpha.300](https://github.com/toa-io/toa/compare/v1.0.0-alpha.299...v1.0.0-alpha.300) (2026-09-11)
189
+
190
+ * feat(boot)!: a process is a thing, and an extension may keep something in one ([528d6cd](https://github.com/toa-io/toa/commit/528d6cdd307b45a6c30b6a184d7e06b3328cecf8))
191
+ * feat(core)!: an operation may ask to run once ([dca616c](https://github.com/toa-io/toa/commit/dca616cb380a7a389e277875d3bd5ca55a6e4d45))
192
+
193
+ ### Features
194
+
195
+ * **core:** a call carries what it is, and a chain of them carries it down ([ebd7769](https://github.com/toa-io/toa/commit/ebd776984a79adb9bf4a97b680128be1efab856f))
196
+ * **core:** a call may name the process it goes to, and wait for a set time ([7d8adb2](https://github.com/toa-io/toa/commit/7d8adb2772a95ff45ae5374efdedfb5a857fbbe9))
197
+
198
+ ### BREAKING CHANGES
199
+
200
+ * `Storage.store`, `.upsert` and `.ensure` take one more
201
+ argument, and `Storage` has two more members. A connector that ignores them
202
+ works exactly as it did; a component that asks it for `once` is refused at
203
+ boot. See migrations/299.md.
204
+ * a composition booted directly has no readiness probe. Readiness is
205
+ the process's, and a composition is not a process. `stage.workload` boots one where a
206
+ suite needs it.
207
+
208
+
209
+ # [1.0.0-alpha.299](https://github.com/toa-io/toa/compare/v1.0.0-alpha.298...v1.0.0-alpha.299) (2026-09-10)
210
+
211
+ ### Features
212
+
213
+ * **bindings.amqp:** a binding carries a channel, addressed by label ([17cf178](https://github.com/toa-io/toa/commit/17cf1782d1c47d033c02f99947b766eb9d45df75))
214
+ * **convergence:** deployments of one context converge ([8a70343](https://github.com/toa-io/toa/commit/8a70343cf6953aab58d4a25bac215508ff8d9a37))
215
+ * **core:** an outbox row is published to destinations ([cfb77b4](https://github.com/toa-io/toa/commit/cfb77b4826ff0f9560769a0996981e143d6525af))
216
+
217
+
218
+ # [1.0.0-alpha.298](https://github.com/toa-io/toa/compare/v1.0.0-alpha.297...v1.0.0-alpha.298) (2026-09-08)
219
+
220
+ **Note:** Version bump only for package @toa.io/boot
221
+
222
+
223
+
224
+
225
+
226
+ # [1.0.0-alpha.297](https://github.com/toa-io/toa/compare/v1.0.0-alpha.296...v1.0.0-alpha.297) (2026-09-08)
227
+
228
+ **Note:** Version bump only for package @toa.io/boot
229
+
230
+
231
+
232
+
233
+
234
+ # [1.0.0-alpha.296](https://github.com/toa-io/toa/compare/v1.0.0-alpha.295...v1.0.0-alpha.296) (2026-09-08)
235
+
236
+ **Note:** Version bump only for package @toa.io/boot
237
+
238
+
239
+
240
+
241
+
242
+ # [1.0.0-alpha.295](https://github.com/toa-io/toa/compare/v1.0.0-alpha.294...v1.0.0-alpha.295) (2026-09-07)
243
+
244
+ **Note:** Version bump only for package @toa.io/boot
245
+
246
+
247
+
248
+
249
+
250
+ # [1.0.0-alpha.294](https://github.com/toa-io/toa/compare/v1.0.0-alpha.293...v1.0.0-alpha.294) (2026-09-07)
251
+
252
+ **Note:** Version bump only for package @toa.io/boot
253
+
254
+
255
+
256
+
257
+
258
+ # [1.0.0-alpha.293](https://github.com/toa-io/toa/compare/v1.0.0-alpha.292...v1.0.0-alpha.293) (2026-09-07)
259
+
260
+ **Note:** Version bump only for package @toa.io/boot
261
+
262
+
263
+
264
+
265
+
266
+ # [1.0.0-alpha.292](https://github.com/toa-io/toa/compare/v1.0.0-alpha.291...v1.0.0-alpha.292) (2026-09-07)
267
+
268
+ ### Features
269
+
270
+ * **definitions:** the version of Toa is the definitions package's ([3d0272e](https://github.com/toa-io/toa/commit/3d0272ea0ab862f4b6c2e58a2f003f92d0f8a87f))
271
+ * **definitions:** what a package declares is read from one package ([7052341](https://github.com/toa-io/toa/commit/70523411b5d9e2b204c999aa02365173f3bb518d))
272
+ * **norm:** a package's definition is read by one resolver ([bffd41c](https://github.com/toa-io/toa/commit/bffd41c8d18c42786b0bf321623088b9dabc4724))
273
+
274
+
275
+ # [1.0.0-alpha.291](https://github.com/toa-io/toa/compare/v1.0.0-alpha.290...v1.0.0-alpha.291) (2026-09-07)
276
+
277
+ **Note:** Version bump only for package @toa.io/boot
278
+
279
+
280
+
281
+
282
+
283
+ # [1.0.0-alpha.289](https://github.com/toa-io/toa/compare/v1.0.0-alpha.288...v1.0.0-alpha.289) (2026-09-07)
284
+
285
+ * A deploy moves only what changed, and a component sees none of the runtime's environment (#1073) ([f38e3db](https://github.com/toa-io/toa/commit/f38e3db533f24db866c57bfa1ef294eff1eaf499)), closes [#1073](https://github.com/toa-io/toa/issues/1073) [#1064](https://github.com/toa-io/toa/issues/1064) [#1066](https://github.com/toa-io/toa/issues/1066) [#1067](https://github.com/toa-io/toa/issues/1067) [#1068](https://github.com/toa-io/toa/issues/1068) [#1069](https://github.com/toa-io/toa/issues/1069) [#1071](https://github.com/toa-io/toa/issues/1071) [#1070](https://github.com/toa-io/toa/issues/1070) [#1072](https://github.com/toa-io/toa/issues/1072)
286
+
287
+ ### BREAKING CHANGES
288
+
289
+ * a component that read `process.env.TOA_*` reads `context` instead;
290
+ `echo(input)` no longer substitutes from the environment; a bash operation sees no
291
+ `TOA_*`; images no longer set `USER node` — see migrations/289.md.
292
+
293
+
294
+ # [1.0.0-alpha.288](https://github.com/toa-io/toa/compare/v1.0.0-alpha.287...v1.0.0-alpha.288) (2026-09-06)
295
+
296
+ **Note:** Version bump only for package @toa.io/boot
297
+
298
+
299
+
300
+
301
+
302
+ # [1.0.0-alpha.287](https://github.com/toa-io/toa/compare/v1.0.0-alpha.286...v1.0.0-alpha.287) (2026-09-06)
303
+
304
+ ### Bug Fixes
305
+
306
+ * **boot:** a discovery belongs to the connection that made it ([48e1c8f](https://github.com/toa-io/toa/commit/48e1c8f668b1853134ae9fb2349c485e6da66c28))
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "@toa.io/boot",
3
- "version": "1.0.0-alpha.32",
3
+ "version": "1.0.0-alpha.320",
4
+ "type": "module",
4
5
  "description": "Toa Boot",
5
6
  "author": "temich <tema.gurtovoy@gmail.com>",
6
7
  "homepage": "https://github.com/toa-io/toa#readme",
@@ -20,13 +21,15 @@
20
21
  "test": "echo \"Error: run tests from root\" && exit 1"
21
22
  },
22
23
  "dependencies": {
23
- "@toa.io/core": "1.0.0-alpha.32",
24
- "@toa.io/filesystem": "1.0.0-alpha.32",
25
- "@toa.io/generic": "1.0.0-alpha.32",
26
- "@toa.io/norm": "1.0.0-alpha.32",
27
- "@toa.io/schema": "1.0.0-alpha.32",
24
+ "@toa.io/atomicity": "1.0.0-alpha.320",
25
+ "@toa.io/core": "1.0.0-alpha.320",
26
+ "@toa.io/definitions": "1.0.0-alpha.320",
27
+ "@toa.io/generic": "1.0.0-alpha.311",
28
+ "@toa.io/norm": "1.0.0-alpha.320",
29
+ "@toa.io/schemas": "1.0.0-alpha.311",
28
30
  "clone-deep": "4.0.1",
29
- "dotenv": "16.1.1"
31
+ "dotenv": "18.0.3",
32
+ "openspan": "1.0.0-alpha.305"
30
33
  },
31
- "gitHead": "93ceb53797363abb77eb9c550db77e906691d42a"
34
+ "gitHead": "5ef92ab939a596e4ac820965c59c015820eba7b2"
32
35
  }
package/src/atom.js ADDED
@@ -0,0 +1,41 @@
1
+ import { Connector } from '@toa.io/core'
2
+
3
+ import * as boot from './index.js'
4
+
5
+ /**
6
+ * The atom as a system aspect. Every component has `context.atom`, with nothing declared in its
7
+ * manifest and nothing of its own to configure.
8
+ *
9
+ * @implements {import('@toa.io/core/types').extensions.Aspect}
10
+ */
11
+ class Aspect extends Connector {
12
+ name = 'atom'
13
+
14
+ #atom
15
+
16
+ constructor(atom) {
17
+ super()
18
+
19
+ this.#atom = atom
20
+
21
+ this.depends(atom)
22
+ }
23
+
24
+ // the methods are named rather than forwarded, so that the connector's lifecycle is not
25
+ // reachable from an algorithm
26
+ invoke(method, ...args) {
27
+ switch (method) {
28
+ case 'slots':
29
+ return this.#atom.slots(...args)
30
+ case 'meter':
31
+ return this.#atom.meter(...args)
32
+ case 'lock':
33
+ return this.#atom.lock(...args)
34
+ default:
35
+ throw new Error(`Atom aspect has no '${method}' method`)
36
+ }
37
+ }
38
+ }
39
+
40
+ /** @param {string} group */
41
+ export const atom = (group) => new Aspect(boot.atomicity(group))
@@ -0,0 +1,11 @@
1
+ import { Factory } from '@toa.io/atomicity'
2
+
3
+ /**
4
+ * What the replicas of one group decide together. Every component has one, whether or not there
5
+ * is anything to coordinate through: without a Redis nothing is owned and nothing is metered —
6
+ * see the connector's readme.
7
+ *
8
+ * @param {string} group
9
+ * @returns {import('@toa.io/core/types').atomicity.Atom}
10
+ */
11
+ export const atomicity = (group) => new Factory().atom(group)
@@ -1,7 +1,4 @@
1
- 'use strict'
1
+ import { factory } from './factory.js'
2
2
 
3
- const { factory } = require('./factory')
4
-
5
- const broadcast = (channel, group, binding = '@toa.io/bindings.amqp') => factory(binding).broadcast(channel, group)
6
-
7
- exports.broadcast = broadcast
3
+ export const broadcast = async (channel, group, binding = '@toa.io/bindings.amqp') =>
4
+ (await factory(binding)).broadcast(channel, group)
@@ -1,3 +1 @@
1
- 'use strict'
2
-
3
- exports.LOOP = '@toa.io/bindings.loop'
1
+ export const LOOP = '@toa.io/bindings.loop'
@@ -1,9 +1,21 @@
1
- 'use strict'
1
+ import { LOOP } from './constants.js'
2
+ import { factory } from './factory.js'
3
+ import { carries } from './produce.js'
2
4
 
3
- const { LOOP } = require('./constants')
4
- const { factory } = require('./factory')
5
+ export const consume = async (locator, endpoint, bindings, streamed = false) => {
6
+ const declared = [LOOP].concat(bindings)
7
+ const carrying = streamed ? await filter(declared) : declared
5
8
 
6
- const consume = (locator, endpoint, bindings) =>
7
- [LOOP].concat(bindings).map((binding) => factory(binding).consumer(locator, endpoint))
9
+ return await Promise.all(
10
+ carrying.map(async (binding) => (await factory(binding)).consumer(locator, endpoint))
11
+ )
12
+ }
8
13
 
9
- exports.consume = consume
14
+ /** A call that carries a stream is handed to nothing that cannot carry one. */
15
+ const filter = async (bindings) => {
16
+ const carrying = []
17
+
18
+ for (const binding of bindings) if (await carries(binding)) carrying.push(binding)
19
+
20
+ return carrying
21
+ }
@@ -1,7 +1,4 @@
1
- 'use strict'
1
+ import { factory } from './factory.js'
2
2
 
3
- const { factory } = require('./factory')
4
-
5
- const emit = (binding, locator, label) => factory(binding).emitter(locator, label)
6
-
7
- exports.emit = emit
3
+ export const emit = async (binding, locator, label) =>
4
+ (await factory(binding)).emitter(locator, label)
@@ -1,15 +1,11 @@
1
- 'use strict'
2
-
3
1
  let instances = {}
4
2
 
5
- const factory = (binding) => {
6
- if (instances[binding] === undefined) instances[binding] = new (require(binding).Factory)()
3
+ // the promise is what is remembered, so two components cannot each make a factory
4
+ export const factory = async (binding) => {
5
+ instances[binding] ??= import(binding).then(({ Factory }) => new Factory())
7
6
 
8
- return instances[binding]
7
+ return await instances[binding]
9
8
  }
10
9
 
11
10
  // for testing purposes
12
- const reset = () => (instances = {})
13
-
14
- exports.factory = factory
15
- exports.reset = reset
11
+ export const reset = () => (instances = {})
@@ -0,0 +1,11 @@
1
+ import { factory } from './factory.js'
2
+
3
+ // eslint-disable-next-line max-params
4
+ export const inbound = async (binding, channel, uris, label, sink) => {
5
+ const instance = await factory(binding)
6
+
7
+ if (instance.inbound === undefined)
8
+ throw new Error(`Binding '${binding}' does not consume a channel`)
9
+
10
+ return instance.inbound(channel, uris, label, sink)
11
+ }
@@ -1,13 +1,7 @@
1
- 'use strict'
2
-
3
- const { broadcast } = require('./broadcast')
4
- const { consume } = require('./consume')
5
- const { emit } = require('./emit')
6
- const { produce } = require('./produce')
7
- const { receive } = require('./receive')
8
-
9
- exports.broadcast = broadcast
10
- exports.consume = consume
11
- exports.emit = emit
12
- exports.produce = produce
13
- exports.receive = receive
1
+ export { broadcast } from './broadcast.js'
2
+ export { consume } from './consume.js'
3
+ export { emit } from './emit.js'
4
+ export { inbound } from './inbound.js'
5
+ export { outbound } from './outbound.js'
6
+ export { produce } from './produce.js'
7
+ export { receive } from './receive.js'
@@ -0,0 +1,10 @@
1
+ import { factory } from './factory.js'
2
+
3
+ export const outbound = async (binding, channel, uris) => {
4
+ const instance = await factory(binding)
5
+
6
+ if (instance.outbound === undefined)
7
+ throw new Error(`Binding '${binding}' does not publish a channel`)
8
+
9
+ return instance.outbound(channel, uris)
10
+ }
@@ -1,28 +1,67 @@
1
- 'use strict'
1
+ import { definition } from '@toa.io/norm'
2
+ import { LOOP } from './constants.js'
3
+ import { factory } from './factory.js'
2
4
 
3
- const { LOOP } = require('./constants')
4
- const { factory } = require('./factory')
5
+ export const produce = async (component, operations) => {
6
+ const local = []
7
+ const other = []
8
+ const stateful = addressed(operations)
9
+ const streams = streamed(operations)
5
10
 
6
- const produce = (component, operations) => group(operations, (factory, endpoints) =>
7
- factory.producer(component.locator, endpoints, component))
11
+ for (const [binding, endpoints] of await group(operations)) {
12
+ const made = await factory(binding)
13
+ const carried = stateful.filter((endpoint) => endpoints.includes(endpoint))
14
+ const carries = streams.filter((endpoint) => endpoints.includes(endpoint))
15
+ const producer = made.producer(component.locator, endpoints, component, carried, carries)
16
+ const { properties } = (await definition(binding)).module
8
17
 
9
- const group = (operations, callback) => {
18
+ if (properties.local === true) local.push(producer)
19
+ else other.push(producer)
20
+ }
21
+
22
+ return { local, other }
23
+ }
24
+
25
+ /** The endpoints that take one of their input properties as a stream. */
26
+ const streamed = (operations) =>
27
+ operations === undefined
28
+ ? []
29
+ : Object.entries(operations)
30
+ .filter(([, operation]) => operation.stream !== undefined)
31
+ .map(([endpoint]) => endpoint)
32
+
33
+ /** The endpoints that take addressed calls only. */
34
+ const addressed = (operations) =>
35
+ operations === undefined
36
+ ? []
37
+ : Object.entries(operations)
38
+ .filter(([, operation]) => operation.stateful === true)
39
+ .map(([endpoint]) => endpoint)
40
+
41
+ /** The endpoints each binding carries, as entries. */
42
+ const group = async (operations) => {
10
43
  const map = {}
11
44
 
12
- for (const [endpoint, operation] of Object.entries(operations)) {
13
- // noinspection JSUnresolvedVariable
14
- const bindings = global.TOA_INTEGRATION_BINDINGS_LOOP_DISABLED
15
- ? operation.bindings
16
- : [LOOP].concat(operation.bindings)
45
+ if (operations !== undefined)
46
+ for (const [endpoint, operation] of Object.entries(operations)) {
47
+ // noinspection JSUnresolvedVariable
48
+ const bindings = global.TOA_INTEGRATION_BINDINGS_LOOP_DISABLED
49
+ ? operation.bindings
50
+ : [LOOP].concat(operation.bindings)
17
51
 
18
- for (const binding of bindings) {
19
- if (!map[binding]) map[binding] = []
52
+ for (const binding of bindings) {
53
+ // an endpoint that takes a stream is served by the bindings that carry one, and by no other
54
+ if (operation.stream !== undefined && !(await carries(binding))) continue
20
55
 
21
- map[binding].push(endpoint)
56
+ if (!map[binding]) map[binding] = []
57
+
58
+ map[binding].push(endpoint)
59
+ }
22
60
  }
23
- }
24
61
 
25
- return Object.entries(map).map(([binding, endpoints]) => callback(factory(binding), endpoints))
62
+ return Object.entries(map)
26
63
  }
27
64
 
28
- exports.produce = produce
65
+ /** Whether a binding carries a call whose input holds a stream, which only its module says. */
66
+ export const carries = async (binding) =>
67
+ (await definition(binding)).module.properties.streams === true
@@ -1,7 +1,4 @@
1
- 'use strict'
1
+ import { factory } from './factory.js'
2
2
 
3
- const { factory } = require('./factory')
4
-
5
- const receive = (binding, locator, label, group, receiver) => factory(binding).receiver(locator, label, group, receiver)
6
-
7
- exports.receive = receive
3
+ export const receive = async (binding, locator, label, group, receiver) =>
4
+ (await factory(binding)).receiver(locator, label, group, receiver)