@toa.io/operations 1.0.0-alpha.300 → 1.0.0-alpha.301

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 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.301](https://github.com/toa-io/toa/compare/v1.0.0-alpha.300...v1.0.0-alpha.301) (2026-09-11)
+
+### Bug Fixes
+
+* **operations:** a composition of evicted components asks for no resources ([a6a3ec7](https://github.com/toa-io/toa/commit/a6a3ec76781812f5a9bdd46c6de0fe7769174d57))
+
+### Features
+
+* **operations:** an evicted component is given its environment and configuration ([6cf7890](https://github.com/toa-io/toa/commit/6cf7890a632a2185d2b7d9790890a04187e5a897))
+
+
 # [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)
 
 * feat(core)!: an operation may ask to run once ([dca616c](https://github.com/toa-io/toa/commit/dca616cb380a7a389e277875d3bd5ca55a6e4d45))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/operations",
-  "version": "1.0.0-alpha.300",
+  "version": "1.0.0-alpha.301",
   "type": "module",
   "description": "Toa Deployment",
   "homepage": "https://toa.io",
@@ -28,11 +28,11 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/generic": "1.0.0-alpha.292",
-    "@toa.io/kubernetes": "1.0.0-alpha.293",
-    "@toa.io/norm": "1.0.0-alpha.300",
+    "@toa.io/generic": "1.0.0-alpha.301",
+    "@toa.io/kubernetes": "1.0.0-alpha.301",
+    "@toa.io/norm": "1.0.0-alpha.301",
     "oxc-parser": "0.149.0",
-    "paseto": "4.0.0"
+    "paseto": "4.0.1"
   },
-  "gitHead": "f91131a9aeb29aa271f177c4055ddcf0cda8c75e"
+  "gitHead": "cc49bc90efd35464b2ad7803246786c607a44685"
 }

package/src/deployment/.deployment/.describe/resources.js

@@ -9,7 +9,7 @@
  * `resources: null` — at either place.
  */
 export function resources(context, values) {
-  for (const unit of units(values)) {
+  for (const unit of units(values, evicted(context))) {
     // `null` is an answer and `undefined` is not one, so the fallback reads only the latter
     if (unit.deployment.resources === undefined)
       unit.deployment.resources = context.resources
@@ -86,12 +86,38 @@ const SUFFIXES = {
   Ei: 2 ** 60
 }
 
-function* units(values) {
+/**
+ * The labels of the components the context evicts, whether or not the eviction was applied:
+ * `toa env -c` does not apply it, since a local run of an evicted component still needs its
+ * variables.
+ *
+ * @returns {Set<string>}
+ */
+function evicted(context) {
+  const ids = new Set(context.evicted?.components ?? [])
+
+  return new Set(
+    (context.components ?? [])
+      .filter(({ locator }) => ids.has(locator.id))
+      .map(({ locator }) => locator.label)
+  )
+}
+
+function* units(values, evicted) {
   if (values.mono !== undefined)
     yield { deployment: values.mono, subject: 'The mono deployment' }
 
-  for (const composition of values.compositions ?? [])
+  for (const composition of values.compositions ?? []) {
+    // a composition of what the context evicts is here only for a local run of it, and Toa
+    // deploys none of it, so nothing asks what it may take
+    if (
+      composition.components?.length > 0 &&
+      composition.components.every((label) => evicted.has(label))
+    )
+      continue
+
     yield { deployment: composition, subject: `Composition '${composition.name}'` }
+  }
 
   for (const service of values.services ?? []) {
     // a service a composition runs has no deployment of its own to size; the composition

package/src/deployment/factory.js

@@ -128,8 +128,10 @@ export class Factory {
 
     const annotation = this.#context.annotations?.[name]
 
+    // every instance as well: what a definition keeps for all of its components, such as the
+    // configuration the values service serves, holds for an evicted one too
     /** @type {toa.deployment.dependency.Declaration} */
-    const dependency = module.deployment(managed, annotation)
+    const dependency = module.deployment(managed, annotation, instances)
 
     // mono claims every service, including one an extension added since this context was
     // written, so its claim is the wildcard rather than a list
@@ -169,7 +171,7 @@ export class Factory {
   }
 
   static async create(path, environment, options = {}) {
-    const context = await load(path, environment)
+    const context = await load(path, environment, options)
 
     return new Factory(context, options)
   }

package/src/deployment/images/image.fixtures.js

@@ -1,38 +1,36 @@
 import { Image } from './image.js'
 import { generate } from 'randomstring'
 
-const version = '168b04ff'
-const name = generate()
+const reported = '168b04ff'
+export const name = generate()
 
 /**
  * @implements {toa.deployment.images.Image}
  */
-class Class extends Image {
+export class Class extends Image {
   get name() {
     return name
   }
 
   get version() {
-    return version
+    return reported
   }
 }
 
 /** @type {toa.norm.context.Runtime} */
-const runtime = {
+export const runtime = {
   version: '0.0.0'
 }
 
 /** @type {toa.norm.context.Registry} */
-const registry = {
+export const registry = {
   base: 'node:alpine'
 }
 
 export const scope = generate()
 
-// distinct from the module's own `version` above
-const published = 'ba2409fc'
+// distinct from the version `Class` reports
+export const version = 'ba2409fc'
 
 // the fixture stands in for the global process
-const current = process
-
-export { name, Class, runtime, registry, current as process, published as version }
+export const process = globalThis.process

package/types/_deployment/composition.d.ts

@@ -1,4 +1,4 @@
-import type * as _deployment from './deployment.js'
+import type * as _deployment from './deployment.d.ts'
 
 declare namespace toa.deployment {
   interface Composition extends _deployment.Deployable {

package/types/_deployment/dependency.d.ts

@@ -1,4 +1,4 @@
-import * as _service from './service.js'
+import * as _service from './service.d.ts'
 import { dependencies } from '@toa.io/norm/types/context'
 
 declare namespace toa.deployment {

package/types/_deployment/deployment.d.ts

@@ -1,6 +1,6 @@
-import type * as _composition from './composition.js'
-import type * as _service from './service.js'
-import type * as _dependency from './dependency.js'
+import type * as _composition from './composition.d.ts'
+import type * as _service from './service.d.ts'
+import type * as _dependency from './dependency.d.ts'
 
 declare namespace toa.deployment {
   interface Declaration {

package/types/_deployment/factory.d.ts

@@ -1,5 +1,5 @@
-import type * as _operator from './operator.js'
-import * as _registry from './registry.js'
+import type * as _operator from './operator.d.ts'
+import * as _registry from './registry.d.ts'
 
 declare namespace toa.deployment {
   interface Factory {

package/types/_deployment/images/factory.d.ts

@@ -1,8 +1,8 @@
 // noinspection ES6UnusedImports
 
 import type { Composition } from '@toa.io/norm/types'
-import type { Image } from './image.js'
-import type { dependency } from '../dependency.js'
+import type { Image } from './image.d.ts'
+import type { dependency } from '../dependency.d.ts'
 
 declare namespace toa.deployment.images {
   interface Factory {

package/types/_deployment/images/registry.d.ts

@@ -1,8 +1,8 @@
 // noinspection ES6UnusedImports
 
 import type { Composition } from '@toa.io/norm'
-import type { dependency } from '../dependency.js'
-import type { Image } from './image.js'
+import type { dependency } from '../dependency.d.ts'
+import type { Image } from './image.d.ts'
 
 declare namespace toa.deployment.images {
   interface Registry {

package/types/_deployment/operator.d.ts

@@ -1,5 +1,5 @@
-import * as _deployment from './deployment.js'
-import * as _dependency from './dependency.js'
+import * as _deployment from './deployment.d.ts'
+import * as _dependency from './dependency.d.ts'
 
 declare namespace toa.deployment {
   interface Operator {

package/types/_deployment/registry.d.ts

@@ -1,6 +1,6 @@
 import type * as _norm from '@toa.io/norm/types'
-import type * as _dependency from './dependency.js'
-import type * as _image from './images/image.js'
+import type * as _dependency from './dependency.d.ts'
+import type * as _image from './images/image.d.ts'
 
 declare namespace toa.deployment {
   interface Registry {

package/types/_deployment/service.d.ts

@@ -1,4 +1,4 @@
-import type * as _deployment from './deployment.js'
+import type * as _deployment from './deployment.d.ts'
 
 declare namespace toa.deployment {
   interface Ingress {

package/types/index.ts

@@ -1 +1 @@
-export * from './dependency.js'
+export * from './dependency.ts'