@toa.io/core 1.0.0-alpha.273 → 1.0.0-alpha.277

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 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.277](https://github.com/toa-io/toa/compare/v1.0.0-alpha.276...v1.0.0-alpha.277) (2026-09-03)
+
+### Bug Fixes
+
+* read a manifest the way js-yaml read one before ([fcea1b2](https://github.com/toa-io/toa/commit/fcea1b21996d6efa6c3198acbfc9f70f1ce0c35c))
+* settle what the module loader made asynchronous ([d4ab9df](https://github.com/toa-io/toa/commit/d4ab9dfb09e382da311dba08f52214e7645f4a6c))
+
+
 # [1.0.0-alpha.273](https://github.com/toa-io/toa/compare/v1.0.0-alpha.272...v1.0.0-alpha.273) (2026-09-02)
 
 **Note:** Version bump only for package @toa.io/core

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@toa.io/core",
-  "version": "1.0.0-alpha.273",
+  "version": "1.0.0-alpha.277",
+  "type": "module",
   "description": "Toa Core",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -20,11 +21,11 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@rsql/parser": "1.2.4",
-    "@toa.io/generic": "1.0.0-alpha.273",
-    "js-yaml": "4.3.1",
-    "openspan": "1.0.0-alpha.272",
-    "uuid": "11.1.1"
+    "@rsql/parser": "1.6.0",
+    "@toa.io/generic": "1.0.0-alpha.277",
+    "js-yaml": "5.4.1",
+    "openspan": "1.0.0-alpha.277",
+    "uuid": "14.0.2"
   },
-  "gitHead": "ad3284850ece95ffd5325fd0995707fc144c9c3d"
+  "gitHead": "0c0071418c2c56a44e621ba5ced5cdd23dff1738"
 }

package/src/assignment.js

@@ -1,8 +1,6 @@
-'use strict'
+import { Operation } from './operation.js'
 
-const { Operation } = require('./operation')
-
-class Assignment extends Operation {
+export class Assignment extends Operation {
   async acquire (store) {
     store.scope = this.scope.changeset(store.request.query)
     store.state = store.scope.get()
@@ -28,5 +26,3 @@ class Assignment extends Operation {
     }
   }
 }
-
-exports.Assignment = Assignment

package/src/call.js

@@ -1,10 +1,8 @@
-'use strict'
+import { Readable } from 'node:stream'
+import { current, encode } from 'openspan'
+import { Connector } from './connector.js'
 
-const { Readable } = require('node:stream')
-const { current, encode } = require('openspan')
-const { Connector } = require('./connector')
-
-class Call extends Connector {
+export class Call extends Connector {
   #transmitter
   #contract
   #source
@@ -58,7 +56,7 @@ class Call extends Connector {
   }
 }
 
-exports.Call = Call
+
 
 // the remote error as a value: every property it carries, and nothing else enumerable
 class RemoteError extends Error {

package/src/cascade.js

@@ -1,8 +1,6 @@
-'use strict'
+import { Connector } from './connector.js'
 
-const { Connector } = require('./connector')
-
-class Cascade extends Connector {
+export class Cascade extends Connector {
   // #bridges
   #last
 
@@ -34,5 +32,3 @@ class Cascade extends Connector {
     return this.#last.execute(...args)
   }
 }
-
-exports.Cascade = Cascade

package/src/component.js

@@ -1,10 +1,8 @@
-'use strict'
+import assert from 'node:assert'
+import { console, current, decode, run } from 'openspan'
+import { Connector } from './connector.js'
 
-const assert = require('node:assert')
-const { console, current, decode, run } = require('openspan')
-const { Connector } = require('./connector')
-
-class Component extends Connector {
+export class Component extends Connector {
   locator
 
   /** @protected */
@@ -81,5 +79,3 @@ class Component extends Connector {
     return options
   }
 }
-
-exports.Component = Component

package/src/composition.js

@@ -1,9 +1,7 @@
-'use strict'
+import { console } from 'openspan'
+import { Connector } from './connector.js'
 
-const { console } = require('openspan')
-const { Connector } = require('./connector')
-
-class Composition extends Connector {
+export class Composition extends Connector {
   constructor (expositions, producers, receivers, tenants) {
     super()
 
@@ -21,5 +19,3 @@ class Composition extends Connector {
     console.info('Composition shutdown complete')
   }
 }
-
-exports.Composition = Composition

package/src/connector.js

@@ -1,12 +1,10 @@
-'use strict'
-
-const { console } = require('openspan')
+import { console } from 'openspan'
 
 /**
  * Abstract connections hierarchy
  * @implements {toa.core.Connector}
  */
-class Connector {
+export class Connector {
   /** @type {Array<Connector>} */
   #dependencies = []
 
@@ -190,5 +188,3 @@ class Connector {
 
 const DELAY = 5000
 const TRACE_BOOT = process.env.TOA_BOOT_TRACE === '1'
-
-exports.Connector = Connector

package/src/context.js

@@ -1,11 +1,9 @@
-'use strict'
-
-const { Connector } = require('./connector')
+import { Connector } from './connector.js'
 
 /**
  * @implements {toa.core.Context}
  */
-class Context extends Connector {
+export class Context extends Connector {
   env
   name
   aspects
@@ -57,5 +55,3 @@ class Context extends Connector {
     return remote
   }
 }
-
-exports.Context = Context

package/src/contract/contract.js

@@ -1,8 +1,6 @@
-'use strict'
+import { SystemException } from '../exceptions.js'
 
-const { SystemException } = require('../exceptions')
-
-class Contract {
+export class Contract {
   schema
 
   constructor (schema) {
@@ -18,5 +16,3 @@ class Contract {
 
   static Exception = SystemException
 }
-
-exports.Contract = Contract

package/src/contract/index.js

@@ -1,7 +1,2 @@
-'use strict'
-
-const { Request } = require('./request')
-const { Reply } = require('./reply')
-
-exports.Request = Request
-exports.Reply = Reply
+export { Request } from './request.js'
+export { Reply } from './reply.js'

package/src/contract/reply.js

@@ -1,10 +1,8 @@
-'use strict'
+import * as schemas from './schemas/index.js'
+import { Contract } from './contract.js'
+import { ResponseContractException } from '../exceptions.js'
 
-const schemas = require('./schemas')
-const { Contract } = require('./contract')
-const { ResponseContractException } = require('../exceptions')
-
-class Reply extends Contract {
+export class Reply extends Contract {
   static Exception = ResponseContractException
 
   static schema (output, errors) {
@@ -46,5 +44,3 @@ class Reply extends Contract {
     return schema
   }
 }
-
-exports.Reply = Reply

package/src/contract/request.js

@@ -1,10 +1,8 @@
-'use strict'
+import * as schemas from './schemas/index.js'
+import { RequestContractException } from '../exceptions.js'
+import { Contract } from './contract.js'
 
-const schemas = require('./schemas')
-const { RequestContractException } = require('../exceptions')
-const { Contract } = require('./contract')
-
-class Request extends Contract {
+export class Request extends Contract {
   /** @readonly */
   discovery = {}
 
@@ -77,5 +75,3 @@ class Request extends Contract {
     return schema
   }
 }
-
-exports.Request = Request

package/src/contract/schemas/index.js

@@ -1,13 +1,11 @@
-'use strict'
+import { resolve } from 'path'
+import { readFileSync } from 'node:fs'
+import { yaml } from '@toa.io/generic'
 
-const { resolve } = require('path')
-const { readFileSync } = require('node:fs')
-const { load: parseYAML } = require('js-yaml')
-
-exports.query = read(resolve(__dirname, './query.yaml'))
-exports.error = read(resolve(__dirname, './error.yaml'))
-exports.source = read(resolve(__dirname, './source.yaml'))
+export const query = read(resolve(import.meta.dirname, './query.yaml'))
+export const error = read(resolve(import.meta.dirname, './error.yaml'))
+export const source = read(resolve(import.meta.dirname, './source.yaml'))
 
 function read (path) {
-  return parseYAML(readFileSync(path, 'utf8'))
+  return yaml.load(readFileSync(path, 'utf8'))
 }

package/src/discovery.js

@@ -1,9 +1,7 @@
-'use strict'
+import { console } from 'openspan'
+import { Connector } from './connector.js'
 
-const { console } = require('openspan')
-const { Connector } = require('./connector')
-
-class Discovery extends Connector {
+export class Discovery extends Connector {
   #lookup
   #lookups
 
@@ -46,5 +44,3 @@ class Discovery extends Connector {
 }
 
 const INTERVAL = 5000
-
-exports.Discovery = Discovery

package/src/effect.js

@@ -1,8 +1,6 @@
-'use strict'
+import { Observation } from './observation.js'
 
-const { Observation } = require('./observation')
-
-class Effect extends Observation {
+export class Effect extends Observation {
 
   async acquire (store) {
     const { query, entity, input } = store.request
@@ -15,5 +13,3 @@ class Effect extends Observation {
   }
 
 }
-
-exports.Effect = Effect

package/src/emission.js

@@ -1,8 +1,6 @@
-'use strict'
+import { Connector } from './connector.js'
 
-const { Connector } = require('./connector')
-
-class Emission extends Connector {
+export class Emission extends Connector {
   #events
 
   constructor (events) {
@@ -19,5 +17,3 @@ class Emission extends Connector {
     await Promise.all(emission)
   }
 }
-
-exports.Emission = Emission

package/src/entities/changeset.js

@@ -1,8 +1,6 @@
-'use strict'
+import { EntityContractException } from '../exceptions.js'
 
-const { EntityContractException } = require('../exceptions')
-
-class Changeset {
+export class Changeset {
   /** @type {toa.core.Query} */
   query
 
@@ -36,5 +34,3 @@ class Changeset {
     return this.#state
   }
 }
-
-exports.Changeset = Changeset

package/src/entities/entity.js

@@ -1,9 +1,7 @@
-'use strict'
+import { EntityContractException, EntityGuardException } from '../exceptions.js'
+import { newid } from './newid.js'
 
-const { EntityContractException, EntityGuardException } = require('../exceptions')
-const { newid } = require('./newid')
-
-class Entity {
+export class Entity {
   deleted = false
   #schema
   #guards
@@ -119,5 +117,3 @@ class Entity {
     this.#state = value
   }
 }
-
-exports.Entity = Entity

package/src/entities/factory.js

@@ -1,11 +1,9 @@
-'use strict'
+import { newid } from './newid.js'
+import { Entity } from './entity.js'
+import { EntitySet } from './set.js'
+import { Changeset } from './changeset.js'
 
-const { newid } = require('./newid')
-const { Entity } = require('./entity')
-const { EntitySet } = require('./set')
-const { Changeset } = require('./changeset')
-
-class Factory {
+export class Factory {
   #schema
   #guards
 
@@ -40,5 +38,3 @@ class Factory {
     return new Changeset(this.#schema, query)
   }
 }
-
-exports.Factory = Factory

package/src/entities/index.js

@@ -1,5 +1 @@
-'use strict'
-
-const { Factory } = require('./factory')
-
-exports.Factory = Factory
+export { Factory } from './factory.js'

package/src/entities/newid.js

@@ -1,11 +1,9 @@
-const uuid = require('uuid')
+import * as uuid from 'uuid'
 
-function newid () {
+export function newid () {
   const buf = Buffer.alloc(16)
 
   uuid.v7(undefined, buf)
 
   return buf.toString('hex')
 }
-
-module.exports = { newid }

package/src/entities/set.js

@@ -1,8 +1,6 @@
-'use strict'
+import { SystemException } from '../exceptions.js'
 
-const { SystemException } = require("../exceptions")
-
-class EntitySet {
+export class EntitySet {
   #set
 
   constructor (set) {
@@ -24,5 +22,3 @@ class EntitySet {
     return this.#set.map((entity) => entity.event(input))
   }
 }
-
-exports.EntitySet = EntitySet

package/src/event.js

@@ -1,12 +1,10 @@
-'use strict'
-
-const { console, current, encode } = require('openspan')
-const { Connector } = require('./connector')
+import { console, current, encode } from 'openspan'
+import { Connector } from './connector.js'
 
 /**
  * @implements {toa.core.Event}
  */
-class Event extends Connector {
+export class Event extends Connector {
   /** @type {toa.core.bindings.Emitter} */
   #emitter
   #bridge
@@ -54,5 +52,3 @@ class Event extends Connector {
     }
   }
 }
-
-exports.Event = Event

package/src/exceptions.js

@@ -1,8 +1,6 @@
-'use strict'
+import { swap } from '@toa.io/generic'
 
-const { swap } = require('@toa.io/generic')
-
-const codes = {
+export const codes = {
   System: 0,
 
   Contract: 200,
@@ -28,7 +26,7 @@ const codes = {
 /**
  * @implements {toa.core.Exception}
  */
-class Exception {
+export class Exception {
   code
   message
 
@@ -41,7 +39,7 @@ class Exception {
   }
 }
 
-class SystemException extends Exception {
+export class SystemException extends Exception {
   stack
 
   constructor (error) {
@@ -51,7 +49,7 @@ class SystemException extends Exception {
   }
 }
 
-class ContractException extends Exception {
+export class ContractException extends Exception {
   constructor (code, error, cause) {
     super(code || codes.Contract, typeof error === 'string' ? error : error?.message, cause)
 
@@ -62,46 +60,55 @@ class ContractException extends Exception {
   }
 }
 
-class RequestContractException extends ContractException {
+export class RequestContractException extends ContractException {
   constructor (error, cause) { super(codes.RequestContract, error, cause) }
 }
 
-class ResponseContractException extends ContractException {
+export class ResponseContractException extends ContractException {
   constructor (error, cause) { super(codes.ResponseContract, error, cause) }
 }
 
-class EntityContractException extends ContractException {
+export class EntityContractException extends ContractException {
   constructor (error, cause) { super(codes.EntityContract, error, cause) }
 }
 
-class EntityGuardException extends ContractException {
+export class EntityGuardException extends ContractException {
   constructor (name, cause) { super(codes.EntityGuard, name, cause) }
 }
 
 // #region exports
-exports.Exception = Exception
-exports.SystemException = SystemException
-exports.RequestContractException = RequestContractException
-exports.ResponseContractException = ResponseContractException
-exports.EntityContractException = EntityContractException
-exports.EntityGuardException = EntityGuardException
-
-for (const [name, code] of Object.entries(codes)) {
-  const classname = name + 'Exception'
 
-  if (exports[classname] === undefined) {
-    exports[classname] = class extends Exception {
-      constructor (message, cause) {
-        message = message
-          ? `${classname}: ${message}`
-          : classname
 
-        super(code, message ?? classname, cause)
-      }
+
+
+
+
+
+// a module's exports are static, so the ones that follow a code are named rather
+// than generated onto the namespace
+function derive (name) {
+  const classname = name + 'Exception'
+
+  return class extends Exception {
+    constructor (message, cause) {
+      super(codes[name], message ? `${classname}: ${message}` : classname, cause)
     }
+
+    static name = classname
   }
 }
 
-exports.codes = codes
-exports.names = swap(codes)
+export const RequestSyntaxException = derive('RequestSyntax')
+export const RequestConflictException = derive('RequestConflict')
+export const QuerySyntaxException = derive('QuerySyntax')
+export const StateException = derive('State')
+export const StateNotFoundException = derive('StateNotFound')
+export const StatePreconditionException = derive('StatePrecondition')
+export const StateConcurrencyException = derive('StateConcurrency')
+export const StateInitializationException = derive('StateInitialization')
+export const DuplicateException = derive('Duplicate')
+export const CommunicationException = derive('Communication')
+export const TransmissionException = derive('Transmission')
+
+export const names = swap(codes)
 // #endregion

package/src/exposition.js

@@ -1,8 +1,6 @@
-'use strict'
+import { Connector } from './connector.js'
 
-const { Connector } = require('./connector')
-
-class Exposition extends Connector {
+export class Exposition extends Connector {
   locator
 
   #exposition
@@ -24,5 +22,3 @@ const expose = (manifest) => {
 
   return { namespace, name, entity, operations, events }
 }
-
-exports.Exposition = Exposition

package/src/guard.js

@@ -1,6 +1,4 @@
-'use strict'
-
-class Guard {
+export class Guard {
   name
   #bridge
 
@@ -13,5 +11,3 @@ class Guard {
     return this.#bridge.fit(state, origin)
   }
 }
-
-exports.Guard = Guard