@toa.io/core 1.0.0-alpha.287 → 1.0.0-alpha.289

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 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.289](https://github.com/toa-io/toa/compare/v1.0.0-alpha.288...v1.0.0-alpha.289) (2026-09-07)
+
+* 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)
+
+### BREAKING CHANGES
+
+* a component that read `process.env.TOA_*` reads `context` instead;
+  `echo(input)` no longer substitutes from the environment; a bash operation sees no
+  `TOA_*`; images no longer set `USER node` — see migrations/289.md.
+
+
+# [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)
+
+**Note:** Version bump only for package @toa.io/core
+
+
+
+
+
 # [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)
 
 **Note:** Version bump only for package @toa.io/core

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/core",
-  "version": "1.0.0-alpha.287",
+  "version": "1.0.0-alpha.289",
   "type": "module",
   "description": "Toa Core",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -34,10 +34,10 @@
   },
   "dependencies": {
     "@rsql/parser": "1.6.0",
-    "@toa.io/generic": "1.0.0-alpha.286",
-    "@toa.io/schemas": "1.0.0-alpha.287",
+    "@toa.io/generic": "1.0.0-alpha.289",
+    "@toa.io/schemas": "1.0.0-alpha.289",
     "openspan": "1.0.0-alpha.286",
     "uuid": "14.0.2"
   },
-  "gitHead": "5c7944a70c16065ab6372072385cc1f02f5db77c"
+  "gitHead": "4fcb482beac5896305d8084cdbc1d5fcf372d108"
 }

package/source/connector.ts

@@ -1,4 +1,5 @@
 import { console } from 'openspan'
+import { environment } from '@toa.io/generic'
 import type { Locator } from './locator.js'
 
 /** Abstract connections hierarchy */
@@ -7,6 +8,7 @@ export class Connector {
   #links: Connector[] = []
   #connecting: Promise<void> | undefined
   #disconnecting: Promise<void> | undefined
+  #discarded: boolean = false
 
   public readonly id: string
   public connected: boolean = false
@@ -40,9 +42,30 @@ export class Connector {
     this.#dependencies.push(next)
     next.link(this)
 
+    // See .#discard()
+    if (this.#disconnecting !== undefined) next.#discard()
+
     return next
   }
 
+  /**
+   * Disconnects, now and again if a connection is still to land.
+   *
+   * A dependency taken on after its dependant was disconnected — a lookup that returns
+   * once the teardown walk has gone by — is one nothing is left to take down, as the
+   * walk that would have reached it is over. One that stays connected holds open
+   * everything it depends on with it: a dependency reads `connected` of every dependant
+   * before it closes, and a dependant that is connected for good is a dependency that
+   * never closes.
+   */
+  #discard(): void {
+    this.#discarded = true
+
+    // one that is up already, or on its way, is taken down here; one that is not is
+    // taken down by the connection when it comes, and until then there is nothing to do
+    if (this.#connecting !== undefined) void this.#drop()
+  }
+
   /**
    * Creates a backlink to another Connector
    *
@@ -72,7 +95,7 @@ export class Connector {
     }
 
     // anonymous grouping nodes are not worth a span
-    this.#connecting =
+    const connecting =
       TRACE_BOOT && this.constructor.name !== 'Connector'
         ? console.span(
             {
@@ -84,13 +107,36 @@ export class Connector {
           )
         : work()
 
+    this.#connecting = connecting
+
     try {
-      await this.#connecting
-      this.connected = true
+      await connecting
+
+      /*
+       * A disconnection that did not wait for this connection emptied `#connecting` to
+       * say so. Reporting `connected` now would report it of a connector nothing takes
+       * down again — its `#disconnecting` has settled, so a later call returns at once —
+       * and what it depends on reads that of every dependant before it closes.
+       */
+      if (this.#connecting === connecting) this.connected = true
     } catch (e) {
       await this.disconnect(true)
       throw e
     }
+
+    // a connection asked for before this one was discarded, landing after. See .#discard()
+    if (this.#discarded) await this.#drop()
+  }
+
+  /** Disconnects a discarded connector, saying so rather than throwing at whoever is not waiting. */
+  async #drop(): Promise<void> {
+    this.#discarded = false
+
+    try {
+      await this.disconnect()
+    } catch (error) {
+      console.error('Discarded connector failed to disconnect', { id: this.id, error })
+    }
   }
 
   /**
@@ -168,4 +214,4 @@ export class Connector {
 }
 
 const DELAY = 5000
-const TRACE_BOOT = process.env.TOA_BOOT_TRACE === '1'
+const TRACE_BOOT = environment.get('TOA_BOOT_TRACE') === '1'

package/source/context.ts

@@ -1,4 +1,5 @@
 import { Connector } from './connector.js'
+import { environment } from '@toa.io/generic'
 import type { Locator } from './locator.js'
 import type { Component } from './component.js'
 import type { Remote } from './remote.js'
@@ -20,8 +21,8 @@ export class Context extends Connector {
   public constructor(local: Component, discover: Discover, aspects: Aspect[] = []) {
     super()
 
-    this.env = process.env.TOA_ENV
-    this.name = process.env.TOA_CONTEXT
+    this.env = environment.get('TOA_ENV')
+    this.name = environment.get('TOA_CONTEXT')
     this.aspects = aspects
     this.locator = local?.locator
 

package/source/contract/request.ts

@@ -19,18 +19,37 @@ export interface Definition extends Explanation {
   query?: boolean
 }
 
+/** What the operation works on, as the manifest declares it. */
+export interface Entity {
+  properties: Record<string, JSONSchema>
+  required?: string[]
+}
+
 export class Request extends Contract {
   public readonly discovery: Explanation = {}
 
   public static override Exception: Refusal =
     RequestContractException as unknown as Refusal
 
-  public constructor(schema: Schema, definition: Definition) {
+  public constructor(schema: Schema, definition: Definition, entity?: Entity) {
     super(schema)
 
     for (const key of ['description', 'input', 'output', 'errors'] as const)
       if (definition[key] !== undefined)
         (this.discovery as Record<string, unknown>)[key] = definition[key]
+
+    /*
+     * An operation that states no output states an empty schema, which every reply fits —
+     * and which says nothing to whoever reads it. What its type answers does, so that is
+     * said here instead. Here and not in the definition, because the definition is what a
+     * reply is held to: a projection is a lawful answer, and describing one is not the same
+     * as requiring it.
+     */
+    if (empty(this.discovery.output)) {
+      const answered = answers(definition, entity)
+
+      if (answered !== undefined) this.discovery.output = answered
+    }
   }
 
   public static schema(
@@ -83,3 +102,39 @@ export class Request extends Contract {
     return schema
   }
 }
+
+/**
+ * What an operation of this type answers, where it did not say.
+ *
+ * A transition, an observation and an assignment work on the Entity Object, so that is what
+ * they answer — a set of them where the scope is a set. A computation neither uses the scope
+ * nor produces one, and an effect answers whatever it computed, so neither is guessed at.
+ * A stream is not a value with a schema, and is not one either.
+ *
+ * What the entity requires is said as well. It is a description and nothing is held to it —
+ * an operation answering a projection says so by declaring its own output — and a shape
+ * whose every property reads as optional says less than it knows.
+ */
+function answers(definition: Definition, entity?: Entity): JSONSchema | undefined {
+  if (entity === undefined || !ENTITY.has(definition.type as string)) return undefined
+
+  const object: JSONSchema = {
+    type: 'object',
+    properties: entity.properties,
+    ...(entity.required === undefined ? {} : { required: entity.required })
+  }
+
+  if (definition.scope === 'objects') return { type: 'array', items: object } as JSONSchema
+
+  return definition.scope === 'object' || definition.scope === 'changeset'
+    ? object
+    : undefined
+}
+
+/** The types whose subject is the Entity Object; see `documentation/design.md`. */
+const ENTITY = new Set(['transition', 'observation', 'assignment'])
+
+/** A schema that states nothing, which is what an operation saying nothing normalizes to. */
+function empty(schema: JSONSchema | null | undefined): boolean {
+  return schema === undefined || schema === null || Object.keys(schema).length === 0
+}

package/source/operation.ts

@@ -1,6 +1,7 @@
 import { Readable } from 'node:stream'
 import { Connector } from './connector.js'
 import { SystemException, RequestContractException } from './exceptions.js'
+import { environment } from '@toa.io/generic'
 import type { Cascade } from './cascade.js'
 import type { State } from './state.js'
 import type { Query as Translator } from './query.js'
@@ -116,7 +117,7 @@ export class Operation extends Connector {
     const reply = await this.#cascade.run(request.input, state)
 
     // validate reply only on local environments
-    if (process.env.TOA_ENV === 'local' && !(reply instanceof Readable))
+    if (environment.get('TOA_ENV') === 'local' && !(reply instanceof Readable))
       this.#contracts.reply.fit(reply)
 
     store.reply = reply

package/source/outbox/outbox.ts

@@ -1,6 +1,7 @@
 import { console } from 'openspan'
 import { Connector } from '../connector.js'
 import { newid } from '../entities/newid.js'
+import { environment } from '@toa.io/generic'
 import type { Emission } from '../emission.js'
 import type { Atom } from '../types/atomicity.js'
 import type { Storage } from '../types/storages.js'
@@ -64,7 +65,7 @@ export class Outbox extends Connector {
     this.#interval = number('TOA_OUTBOX_INTERVAL', options.interval, INTERVAL)
     this.#batch = number('TOA_OUTBOX_BATCH', options.batch, BATCH)
     this.#gap = options.gap ?? this.#interval * K
-    this.#defer = process.env.TOA_OUTBOX_DEFER === '1'
+    this.#defer = environment.get('TOA_OUTBOX_DEFER') === '1'
 
     this.depends(emission)
     this.depends(atom)
@@ -304,7 +305,7 @@ function number(
 ): number {
   if (declared !== undefined) return declared
 
-  const value = Number(process.env[variable])
+  const value = Number(environment.get(variable))
 
   return Number.isNaN(value) || value <= 0 ? fallback : value
 }

package/source/types/storages.ts

@@ -113,10 +113,15 @@ export interface Entity {
   migrations?: Migration[]
 }
 
-/** One file of a component's `migrations` directory, named after it. */
+/**
+ * One file of a `migrations` directory, named after it — the component's own, or a prototype's,
+ * which every descendant applies to its collection ahead of its own.
+ */
 export interface Migration {
   id: string
   steps: unknown[]
+  /** the prototype it is inherited from; absent on the component's own */
+  prototype?: string
 }
 
 export interface StorageOptions {

package/test/connector.fixtures.js

@@ -34,6 +34,20 @@ export class FailingConnector extends Connector {
   }
 }
 
+/** Stands for a connector whose connection lands once it has been disconnected. */
+export class LateConnector extends Connector {
+  #arrive
+
+  async open() {
+    await new Promise((resolve) => (this.#arrive = resolve))
+  }
+
+  /** Lets the connection land. */
+  arrive() {
+    this.#arrive()
+  }
+}
+
 /** Stands for a connector waiting for something that never arrives. */
 export class StuckConnector extends Connector {
   async open() {

package/test/connector.test.js

@@ -180,6 +180,62 @@ describe('dependencies', () => {
     assert.deepStrictEqual(sequence, ['+b', '-b', '*b', '*a'])
   })
 
+  it('should disconnect a dependency taken on after disconnection', async () => {
+    a.depends(b)
+
+    await a.connect()
+    await a.disconnect()
+
+    // what a lookup that returns once the teardown walk has gone by amounts to
+    a.depends(c)
+
+    await c.connect()
+
+    assert.strictEqual(c.connected, false)
+    assert.ok(sequence.indexOf('*c') > sequence.indexOf('*a'))
+  })
+
+  it('should disconnect a connected dependency taken on after disconnection', async () => {
+    a.depends(b)
+
+    await a.connect()
+    await a.disconnect()
+    await c.connect()
+
+    a.depends(c)
+
+    // the discarding is not something the caller waits for
+    for (let i = 0; c.connected && i < 100; i++) await timeout(1)
+
+    assert.strictEqual(c.connected, false)
+    assert.ok(sequence.includes('*c'))
+  })
+
+  it('should not connect what was disconnected while connecting', async () => {
+    const late = new fixtures.LateConnector()
+
+    late.depends(c)
+    b.depends(c)
+
+    await b.connect()
+
+    const connecting = late.connect()
+
+    await late.disconnect()
+
+    late.arrive()
+
+    await connecting
+
+    // the connection landed after the disconnection, and nothing is left to say it again
+    assert.strictEqual(late.connected, false)
+
+    await b.disconnect()
+
+    assert.strictEqual(c.connected, false)
+    assert.ok(sequence.includes('*c'))
+  })
+
   describe('errors', () => {
     let f
 

package/transpiled/connector.js

@@ -1,10 +1,12 @@
 import { console } from 'openspan';
+import { environment } from '@toa.io/generic';
 /** Abstract connections hierarchy */
 export class Connector {
     #dependencies = [];
     #links = [];
     #connecting;
     #disconnecting;
+    #discarded = false;
     id;
     connected = false;
     constructor() {
@@ -35,8 +37,28 @@ export class Connector {
             next = connector;
         this.#dependencies.push(next);
         next.link(this);
+        // See .#discard()
+        if (this.#disconnecting !== undefined)
+            next.#discard();
         return next;
     }
+    /**
+     * Disconnects, now and again if a connection is still to land.
+     *
+     * A dependency taken on after its dependant was disconnected — a lookup that returns
+     * once the teardown walk has gone by — is one nothing is left to take down, as the
+     * walk that would have reached it is over. One that stays connected holds open
+     * everything it depends on with it: a dependency reads `connected` of every dependant
+     * before it closes, and a dependant that is connected for good is a dependency that
+     * never closes.
+     */
+    #discard() {
+        this.#discarded = true;
+        // one that is up already, or on its way, is taken down here; one that is not is
+        // taken down by the connection when it comes, and until then there is nothing to do
+        if (this.#connecting !== undefined)
+            void this.#drop();
+    }
     /**
      * Creates a backlink to another Connector
      *
@@ -63,22 +85,42 @@ export class Connector {
             await this.open();
         };
         // anonymous grouping nodes are not worth a span
-        this.#connecting =
-            TRACE_BOOT && this.constructor.name !== 'Connector'
-                ? console.span({
-                    name: `connect ${this.constructor.name}`,
-                    // a connector that has a locator is named by it; a grouping node has none
-                    attributes: { id: this.locator?.id ?? this.id }
-                }, work)
-                : work();
+        const connecting = TRACE_BOOT && this.constructor.name !== 'Connector'
+            ? console.span({
+                name: `connect ${this.constructor.name}`,
+                // a connector that has a locator is named by it; a grouping node has none
+                attributes: { id: this.locator?.id ?? this.id }
+            }, work)
+            : work();
+        this.#connecting = connecting;
         try {
-            await this.#connecting;
-            this.connected = true;
+            await connecting;
+            /*
+             * A disconnection that did not wait for this connection emptied `#connecting` to
+             * say so. Reporting `connected` now would report it of a connector nothing takes
+             * down again — its `#disconnecting` has settled, so a later call returns at once —
+             * and what it depends on reads that of every dependant before it closes.
+             */
+            if (this.#connecting === connecting)
+                this.connected = true;
         }
         catch (e) {
             await this.disconnect(true);
             throw e;
         }
+        // a connection asked for before this one was discarded, landing after. See .#discard()
+        if (this.#discarded)
+            await this.#drop();
+    }
+    /** Disconnects a discarded connector, saying so rather than throwing at whoever is not waiting. */
+    async #drop() {
+        this.#discarded = false;
+        try {
+            await this.disconnect();
+        }
+        catch (error) {
+            console.error('Discarded connector failed to disconnect', { id: this.id, error });
+        }
     }
     /**
      * Disconnects self then dependants
@@ -139,5 +181,5 @@ export class Connector {
     dispose() { }
 }
 const DELAY = 5000;
-const TRACE_BOOT = process.env.TOA_BOOT_TRACE === '1';
+const TRACE_BOOT = environment.get('TOA_BOOT_TRACE') === '1';
 //# sourceMappingURL=connector.js.map

package/transpiled/connector.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector.js","sourceRoot":"","sources":["../source/connector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../source/connector.ts"],"names":[],"mappings":"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"}

package/transpiled/context.js

@@ -1,4 +1,5 @@
 import { Connector } from './connector.js';
+import { environment } from '@toa.io/generic';
 export class Context extends Connector {
     env;
     name;
@@ -9,8 +10,8 @@ export class Context extends Connector {
     #remotes = {};
     constructor(local, discover, aspects = []) {
         super();
-        this.env = process.env.TOA_ENV;
-        this.name = process.env.TOA_CONTEXT;
+        this.env = environment.get('TOA_ENV');
+        this.name = environment.get('TOA_CONTEXT');
         this.aspects = aspects;
         this.locator = local?.locator;
         this.#local = local;

package/transpiled/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../source/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAS1C,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpB,GAAG,CAAoB;IACvB,IAAI,CAAoB;IACxB,OAAO,CAAU;IACjB,OAAO,CAAS;IAEvB,MAAM,CAAW;IACjB,SAAS,CAAU;IACnB,QAAQ,GAAoC,EAAE,CAAA;IAEvD,YAAmB,KAAgB,EAAE,QAAkB,EAAE,OAAO,GAAa,EAAE;QAC7E,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,OAAO,CAAA;QAE7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QAEzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAEnB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/C,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAgB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,sCAAsC;IAC/B,KAAK,CAAC,IAAI,CACf,SAAiB,EACjB,IAAY,EACZ,QAAgB,EAChB,OAAgB;QAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAElD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,IAAY;QAC3C,MAAM,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAAA;QAElC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAErD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAAY;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAEpD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpB,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../source/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAS7C,MAAM,OAAO,OAAQ,SAAQ,SAAS;IACpB,GAAG,CAAoB;IACvB,IAAI,CAAoB;IACxB,OAAO,CAAU;IACjB,OAAO,CAAS;IAEvB,MAAM,CAAW;IACjB,SAAS,CAAU;IACnB,QAAQ,GAAoC,EAAE,CAAA;IAEvD,YAAmB,KAAgB,EAAE,QAAkB,EAAE,OAAO,GAAa,EAAE;QAC7E,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,EAAE,OAAO,CAAA;QAE7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QAEzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAEnB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/C,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAgB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,sCAAsC;IAC/B,KAAK,CAAC,IAAI,CACf,SAAiB,EACjB,IAAY,EACZ,QAAgB,EAChB,OAAgB;QAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAElD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,IAAY;QAC3C,MAAM,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAAA;QAElC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAErD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAAY;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAEpD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEpB,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/transpiled/contract/request.d.ts

@@ -14,10 +14,15 @@ export interface Definition extends Explanation {
     scope?: string;
     query?: boolean;
 }
+/** What the operation works on, as the manifest declares it. */
+export interface Entity {
+    properties: Record<string, JSONSchema>;
+    required?: string[];
+}
 export declare class Request extends Contract {
     readonly discovery: Explanation;
     static Exception: Refusal;
-    constructor(schema: Schema, definition: Definition);
+    constructor(schema: Schema, definition: Definition, entity?: Entity);
     static schema(definition: Definition, entity?: {
         properties: Record<string, JSONSchema>;
     }): JSONSchema;

package/transpiled/contract/request.js

@@ -4,11 +4,23 @@ import { Contract } from './contract.js';
 export class Request extends Contract {
     discovery = {};
     static Exception = RequestContractException;
-    constructor(schema, definition) {
+    constructor(schema, definition, entity) {
         super(schema);
         for (const key of ['description', 'input', 'output', 'errors'])
             if (definition[key] !== undefined)
                 this.discovery[key] = definition[key];
+        /*
+         * An operation that states no output states an empty schema, which every reply fits —
+         * and which says nothing to whoever reads it. What its type answers does, so that is
+         * said here instead. Here and not in the definition, because the definition is what a
+         * reply is held to: a projection is a lawful answer, and describing one is not the same
+         * as requiring it.
+         */
+        if (empty(this.discovery.output)) {
+            const answered = answers(definition, entity);
+            if (answered !== undefined)
+                this.discovery.output = answered;
+        }
     }
     static schema(definition, entity) {
         // `source` is not among these: the framework stamps it and whoever reads it takes the keys
@@ -56,4 +68,36 @@ export class Request extends Contract {
         return schema;
     }
 }
+/**
+ * What an operation of this type answers, where it did not say.
+ *
+ * A transition, an observation and an assignment work on the Entity Object, so that is what
+ * they answer — a set of them where the scope is a set. A computation neither uses the scope
+ * nor produces one, and an effect answers whatever it computed, so neither is guessed at.
+ * A stream is not a value with a schema, and is not one either.
+ *
+ * What the entity requires is said as well. It is a description and nothing is held to it —
+ * an operation answering a projection says so by declaring its own output — and a shape
+ * whose every property reads as optional says less than it knows.
+ */
+function answers(definition, entity) {
+    if (entity === undefined || !ENTITY.has(definition.type))
+        return undefined;
+    const object = {
+        type: 'object',
+        properties: entity.properties,
+        ...(entity.required === undefined ? {} : { required: entity.required })
+    };
+    if (definition.scope === 'objects')
+        return { type: 'array', items: object };
+    return definition.scope === 'object' || definition.scope === 'changeset'
+        ? object
+        : undefined;
+}
+/** The types whose subject is the Entity Object; see `documentation/design.md`. */
+const ENTITY = new Set(['transition', 'observation', 'assignment']);
+/** A schema that states nothing, which is what an operation saying nothing normalizes to. */
+function empty(schema) {
+    return schema === undefined || schema === null || Object.keys(schema).length === 0;
+}
 //# sourceMappingURL=request.js.map

package/transpiled/contract/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../source/contract/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAmBxC,MAAM,OAAO,OAAQ,SAAQ,QAAQ;IACnB,SAAS,GAAgB,EAAE,CAAA;IAEpC,MAAM,CAAU,SAAS,GAC9B,wBAA8C,CAAA;IAEhD,YAAmB,MAAc,EAAE,UAAsB;QACvD,KAAK,CAAC,MAAM,CAAC,CAAA;QAEb,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAU;YACrE,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS;gBAC9B,IAAI,CAAC,SAAqC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IACxE,CAAC;IAEM,MAAM,CAAC,MAAM,CAClB,UAAsB,EACtB,MAAmD;QAEnD,2FAA2F;QAC3F,6FAA6F;QAC7F,MAAM,MAAM,GAAe;YACzB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC1B;YACD,oBAAoB,EAAE,IAAI;SAC3B,CAAA;QAED,MAAM,QAAQ,GAAa,EAAE,CAAA;QAE7B,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAA;YAC1C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;;YAAM,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QAEjD,IAAI,MAAM,KAAK,SAAS;YAAE,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;QAElD,IAAI,UAAU,CAAC,KAAK,KAAK,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAErD,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK;YAAE,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QAE1E,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAE5C,KAAK,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,CAAC,EAAE,CAAA;YAE3C,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa;gBAAE,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,CAAA;;gBACjE,OAAO,KAAK,CAAC,UAAU,CAAC,UAAU,CAAA;YAEvC,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxE,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAA;gBAC5B,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAAA;YAC/B,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;gBAAE,KAAK,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAC,CAAA;;gBAC9D,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAEjC,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;QACjC,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAEnD,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../source/contract/request.ts"],"names":[],"mappings":"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"}

package/transpiled/operation.js

@@ -1,6 +1,7 @@
 import { Readable } from 'node:stream';
 import { Connector } from './connector.js';
 import { SystemException, RequestContractException } from './exceptions.js';
+import { environment } from '@toa.io/generic';
 export class Operation extends Connector {
     scope;
     /**
@@ -62,7 +63,7 @@ export class Operation extends Connector {
         const { request, state } = store;
         const reply = await this.#cascade.run(request.input, state);
         // validate reply only on local environments
-        if (process.env.TOA_ENV === 'local' && !(reply instanceof Readable))
+        if (environment.get('TOA_ENV') === 'local' && !(reply instanceof Readable))
             this.#contracts.reply.fit(reply);
         store.reply = reply;
     }