@toa.io/userland 1.0.0-alpha.342 → 1.0.0-alpha.344

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.344](https://github.com/toa-io/toa/compare/v1.0.0-alpha.343...v1.0.0-alpha.344) (2026-11-04)
+
+### Bug Fixes
+
+* **stage:** stop what is still connecting when the stage stops ([dbdd30d](https://github.com/toa-io/toa/commit/dbdd30ddbbee6434df82c7c5fee01170d94c2611))
+
+
+# [1.0.0-alpha.343](https://github.com/toa-io/toa/compare/v1.0.0-alpha.342...v1.0.0-alpha.343) (2026-10-29)
+
+**Note:** Version bump only for package @toa.io/userland
+
+
+
+
+
 # [1.0.0-alpha.342](https://github.com/toa-io/toa/compare/v1.0.0-alpha.341...v1.0.0-alpha.342) (2026-10-28)
 
 **Note:** Version bump only for package @toa.io/userland

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/userland",
-  "version": "1.0.0-alpha.342",
+  "version": "1.0.0-alpha.344",
   "type": "module",
   "description": "Toa development kit",
   "homepage": "https://toa.io",
@@ -33,12 +33,12 @@
   },
   "dependencies": {
     "@toa.io/agent": "1.0.0-alpha.333",
-    "@toa.io/boot": "1.0.0-alpha.342",
+    "@toa.io/boot": "1.0.0-alpha.344",
     "@toa.io/core": "1.0.0-alpha.333",
     "@toa.io/generic": "1.0.0-alpha.332",
-    "@toa.io/norm": "1.0.0-alpha.342",
+    "@toa.io/norm": "1.0.0-alpha.344",
     "@toa.io/schemas": "1.0.0-alpha.332",
     "@toa.io/storages.null": "1.0.0-alpha.333"
   },
-  "gitHead": "5a9d2c7c81f9d3fff002533ecafd5ec22faa2119"
+  "gitHead": "795a286affa7ce1b4445df6b41fc5bc04ce4900d"
 }

package/stage/readme.md

@@ -36,6 +36,7 @@ Connect the remote.
 
 ## Shutdown
 
-`async sutdown(): void`
+`async shutdown(): void`
 
-Shutdown all components, compositions and services.
+Shutdown all components, compositions, workloads, services and remotes, those still connecting
+included.

package/stage/src/component.js

@@ -6,9 +6,10 @@ export const component = async (path, options) => {
   const manifest = await boot.manifest(path, options)
   const component = await boot.component(manifest)
 
-  await component.connect()
-
+  // held before it connects: one that is still connecting when the stage stops is stopped too
   state.components.push(component)
 
+  await component.connect()
+
   return component
 }

package/stage/src/composition.js

@@ -5,7 +5,8 @@ import { state } from './state.js'
 export const composition = async (paths, options) => {
   const composition = await boot.composition(paths, options)
 
-  await composition.connect()
-
+  // held before it connects: one that is still connecting when the stage stops is stopped too
   state.compositions.push(composition)
+
+  await composition.connect()
 }

package/stage/src/remote.js

@@ -13,10 +13,11 @@ export const remote = async (id) => {
   const locator = new Locator(name, namespace)
   const remote = await boot.remote(locator, SOURCE)
 
-  await remote.connect()
-
+  // held before it connects: one that is still connecting when the stage stops is stopped too
   state.remotes.push(remote)
 
+  await remote.connect()
+
   return remote
 }
 

package/stage/src/service.js

@@ -13,9 +13,10 @@ export const service = async (ref) => {
   const factory = new Factory(boot.host())
   const service = await factory.service()
 
-  await service.connect()
-
+  // held before it connects: one that is still connecting when the stage stops is stopped too
   state.services.push(service)
 
+  await service.connect()
+
   return service
 }

package/stage/src/workload.js

@@ -45,9 +45,10 @@ export const workload = async (paths, options, services = []) => {
     return root
   })
 
-  await workload.connect()
-
+  // held before it connects: one that is still connecting when the stage stops is stopped too
   state.workloads.push(workload)
 
+  await workload.connect()
+
   return workload
 }

package/stage/test/shutdown.test.js

@@ -44,6 +44,46 @@ it('should disconnect compositions', async () => {
   assert.ok(composition.disconnect.mock.callCount() > 0)
 })
 
+it('should disconnect a composition still connecting', async () => {
+  const paths = [generate(), generate()]
+  const connecting = {
+    connect: mocking.fn(() => new Promise(() => undefined)),
+    disconnect: mocking.fn(),
+    link: mocking.fn()
+  }
+
+  mock.boot.composition.mock.mockImplementationOnce(async () => connecting)
+
+  void stage.composition(paths)
+
+  // booted, and connecting
+  while (connecting.connect.mock.callCount() === 0)
+    await new Promise((resolve) => setImmediate(resolve))
+
+  await stage.shutdown()
+
+  assert.ok(connecting.disconnect.mock.callCount() > 0)
+})
+
+it('should disconnect a component still connecting', async () => {
+  const connecting = {
+    connect: mocking.fn(() => new Promise(() => undefined)),
+    disconnect: mocking.fn(),
+    link: mocking.fn()
+  }
+
+  mock.boot.component.mock.mockImplementationOnce(async () => connecting)
+
+  void stage.component(generate())
+
+  while (connecting.connect.mock.callCount() === 0)
+    await new Promise((resolve) => setImmediate(resolve))
+
+  await stage.shutdown()
+
+  assert.ok(connecting.disconnect.mock.callCount() > 0)
+})
+
 it('should disconnect remotes', async () => {
   const id = generate() + '.' + generate()