@toa.io/userland 1.0.0-alpha.307 → 1.0.0-alpha.309

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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.309](https://github.com/toa-io/toa/compare/v1.0.0-alpha.308...v1.0.0-alpha.309) (2026-09-16)
+
+**Note:** Version bump only for package @toa.io/userland
+
+
+
+
+
+# [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)
+
+**Note:** Version bump only for package @toa.io/userland
+
+
+
+
+
 # [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)
 
 **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.307",
+  "version": "1.0.0-alpha.309",
   "type": "module",
   "description": "Toa development kit",
   "homepage": "https://toa.io",
@@ -32,12 +32,12 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@toa.io/boot": "1.0.0-alpha.307",
-    "@toa.io/core": "1.0.0-alpha.306",
+    "@toa.io/boot": "1.0.0-alpha.309",
+    "@toa.io/core": "1.0.0-alpha.308",
     "@toa.io/generic": "1.0.0-alpha.304",
-    "@toa.io/norm": "1.0.0-alpha.307",
+    "@toa.io/norm": "1.0.0-alpha.309",
     "@toa.io/schemas": "1.0.0-alpha.304",
-    "@toa.io/storages.null": "1.0.0-alpha.306"
+    "@toa.io/storages.null": "1.0.0-alpha.308"
   },
-  "gitHead": "d5f4b2e97e315ba8ab657039d0407565c96e34bc"
+  "gitHead": "6e0cd9ef0c9b9f4f9db666f6f19fc44e61bf2606"
 }

package/stage/src/map.js

@@ -1,15 +1,15 @@
 import * as boot from '@toa.io/boot'
 
 /**
- * Which version of each component a lookup made in this process asks for.
+ * What this process is given about the components it calls: the contract of the version each of
+ * them runs.
  *
- * A composition staged here is given none unless a test states one, and a lookup with no version
- * goes to the name every version of a component answers on — which is what a run outside a
- * deployment gets.
+ * A composition staged here is given none unless a test states one, and a component the map
+ * states nothing of is asked what it provides — which is what a run outside a deployment gets.
  *
- * @param {Record<string, string> | undefined} versions
+ * @param {Record<string, import('@toa.io/core').Contract> | undefined} contracts
  * @returns {void}
  */
-export const map = (versions) => {
-  boot.map.use(versions)
+export const map = (contracts) => {
+  boot.map.use(contracts)
 }

package/stage/src/shutdown.js

@@ -1,3 +1,5 @@
+import * as boot from '@toa.io/boot'
+
 import { state } from './state.js'
 import { map } from './map.js'
 
@@ -18,8 +20,9 @@ export const shutdown = async () => {
 
   await Promise.all(disconnections)
 
-  // whatever a test stated is not carried into the next one
+  // whatever a test stated is not carried into the next one, and what it composed is gone
   map(undefined)
+  boot.map.forget()
 
   state.reset()
 }

package/stage/test/boot.mock.js

@@ -8,7 +8,7 @@ const connector = () => ({
   link: mock.fn()
 })
 
-export const map = { use: mock.fn() }
+export const map = { use: mock.fn(), forget: mock.fn() }
 export const manifest = mock.fn(async () => generate())
 export const component = mock.fn(async () => connector())
 export const composition = mock.fn(async () => connector())

package/stage/types/index.d.ts

@@ -5,8 +5,8 @@ import type * as _boot from '@toa.io/boot'
 
 export function manifest(path: string): Promise<_norm.Component>
 
-/** which version of each component a lookup made in this process asks for */
-export function map(versions: Record<string, string> | undefined): void
+/** what this process is given about the components it calls */
+export function map(contracts: Record<string, _norm.Contract> | undefined): void
 
 export function component(path: string): Promise<_core.Component>