@toa.io/boot 1.0.0-alpha.314 → 1.0.0-alpha.315

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 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.315](https://github.com/toa-io/toa/compare/v1.0.0-alpha.314...v1.0.0-alpha.315) (2026-09-23)
+
+* feat(map)!: leave out of a contract what the runtime gives every component ([b81837a](https://github.com/toa-io/toa/commit/b81837a3bc4771d7ee1c10fe613c9a1d7501bf1a))
+
+### BREAKING CHANGES
+
+* the deployed component map is `/etc/toa/.map.json.gz`.
+
+
 # [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)
 
 * feat(core)!: let an operation state how long its calls are remembered ([af177c2](https://github.com/toa-io/toa/commit/af177c2ab3d00d475840b5ef9e612f04e82b72bd))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/boot",
-  "version": "1.0.0-alpha.314",
+  "version": "1.0.0-alpha.315",
   "type": "module",
   "description": "Toa Boot",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -21,15 +21,15 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/atomicity": "1.0.0-alpha.314",
-    "@toa.io/core": "1.0.0-alpha.314",
-    "@toa.io/definitions": "1.0.0-alpha.314",
+    "@toa.io/atomicity": "1.0.0-alpha.315",
+    "@toa.io/core": "1.0.0-alpha.315",
+    "@toa.io/definitions": "1.0.0-alpha.315",
     "@toa.io/generic": "1.0.0-alpha.311",
-    "@toa.io/norm": "1.0.0-alpha.314",
+    "@toa.io/norm": "1.0.0-alpha.315",
     "@toa.io/schemas": "1.0.0-alpha.311",
     "clone-deep": "4.0.1",
-    "dotenv": "17.4.2",
+    "dotenv": "18.0.0",
     "openspan": "1.0.0-alpha.305"
   },
-  "gitHead": "4b7c0f4468e6fa89f95a69f43fed85c648fb033d"
+  "gitHead": "d88ed286bf44bf95b5f3d9db6e7d4621261dbb99"
 }

package/src/map.js

@@ -1,4 +1,5 @@
 import assert from 'node:assert'
+import { gunzipSync } from 'node:zlib'
 import { readFile } from 'node:fs/promises'
 import * as core from '@toa.io/core'
 
@@ -78,6 +79,9 @@ export const contract = async (id) => {
 }
 
 /**
+ * A map is read gzipped where it is deployed and plain where it is not, so what it is is told by
+ * its first two bytes rather than by its name.
+ *
  * @param {string} path
  * @returns {Promise<Record<string, import('@toa.io/core').Contract>>}
  */
@@ -85,13 +89,19 @@ async function read(path) {
   let contents
 
   try {
-    contents = await readFile(path, 'utf8')
+    contents = await readFile(path)
   } catch (cause) {
     throw new Error(`Cannot read the component map '${path}'`, { cause })
   }
 
   try {
-    return JSON.parse(contents)
+    if (contents[0] === 0x1f && contents[1] === 0x8b) contents = gunzipSync(contents)
+  } catch (cause) {
+    throw new Error(`The component map '${path}' is not readable gzip`, { cause })
+  }
+
+  try {
+    return JSON.parse(contents.toString('utf8'))
   } catch (cause) {
     throw new Error(`The component map '${path}' is not JSON`, { cause })
   }

package/src/remote.js

@@ -1,4 +1,4 @@
-import { Remote, exceptions } from '@toa.io/core'
+import { Remote, contract as coreContract, exceptions } from '@toa.io/core'
 import { remap } from '@toa.io/generic'
 
 import * as boot from './index.js'
@@ -11,13 +11,17 @@ import * as boot from './index.js'
  *   tenant announced — and absent it, what the map this process was given states.
  */
 export const remote = async (locator, source, options = {}) => {
-  const contract = options.contract ?? (await boot.map.contract(locator.id))
+  const stated = options.contract ?? (await boot.map.contract(locator.id))
 
-  if (contract === undefined)
+  if (stated === undefined)
     throw new exceptions.UnstatedException(
       `Cannot call '${locator.id}': the component map states nothing of it. Run \`toa map\`.`
     )
 
+  // a contract states once, or not at all, what the runtime gives every component; the calls
+  // are made from the whole of it
+  const contract = coreContract.restore(stated)
+
   // a call binds its consumers, which are loaded rather than required
   const calls =
     contract.operations === undefined