@toa.io/bindings.loop 1.0.0-alpha.32 → 1.0.0-alpha.321

package/CHANGELOG.md

@@ -0,0 +1,182 @@
+# Change Log
+
+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.321](https://github.com/toa-io/toa/compare/v1.0.0-alpha.320...v1.0.0-alpha.321) (2026-09-28)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.320](https://github.com/toa-io/toa/compare/v1.0.0-alpha.319...v1.0.0-alpha.320) (2026-09-28)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.319](https://github.com/toa-io/toa/compare/v1.0.0-alpha.318...v1.0.0-alpha.319) (2026-09-27)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [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)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [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)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.312](https://github.com/toa-io/toa/compare/v1.0.0-alpha.311...v1.0.0-alpha.312) (2026-09-18)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.311](https://github.com/toa-io/toa/compare/v1.0.0-alpha.310...v1.0.0-alpha.311) (2026-09-17)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.310](https://github.com/toa-io/toa/compare/v1.0.0-alpha.309...v1.0.0-alpha.310) (2026-09-16)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [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/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.306](https://github.com/toa-io/toa/compare/v1.0.0-alpha.305...v1.0.0-alpha.306) (2026-09-14)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.305](https://github.com/toa-io/toa/compare/v1.0.0-alpha.304...v1.0.0-alpha.305) (2026-09-13)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.304](https://github.com/toa-io/toa/compare/v1.0.0-alpha.303...v1.0.0-alpha.304) (2026-09-13)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.303](https://github.com/toa-io/toa/compare/v1.0.0-alpha.302...v1.0.0-alpha.303) (2026-09-12)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.302](https://github.com/toa-io/toa/compare/v1.0.0-alpha.301...v1.0.0-alpha.302) (2026-09-11)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [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)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [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)
+
+### Features
+
+* **core:** a call may name the process it goes to, and wait for a set time ([7d8adb2](https://github.com/toa-io/toa/commit/7d8adb2772a95ff45ae5374efdedfb5a857fbbe9))
+
+
+# [1.0.0-alpha.299](https://github.com/toa-io/toa/compare/v1.0.0-alpha.298...v1.0.0-alpha.299) (2026-09-10)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.293](https://github.com/toa-io/toa/compare/v1.0.0-alpha.292...v1.0.0-alpha.293) (2026-09-07)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [1.0.0-alpha.292](https://github.com/toa-io/toa/compare/v1.0.0-alpha.291...v1.0.0-alpha.292) (2026-09-07)
+
+### Features
+
+* **definitions:** what a package declares is read from one package ([7052341](https://github.com/toa-io/toa/commit/70523411b5d9e2b204c999aa02365173f3bb518d))
+
+
+# [1.0.0-alpha.291](https://github.com/toa-io/toa/compare/v1.0.0-alpha.290...v1.0.0-alpha.291) (2026-09-07)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [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)
+
+**Note:** Version bump only for package @toa.io/bindings.loop
+
+
+
+
+
+# [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/bindings.loop
+
+
+
+
+
+# [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/bindings.loop

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@toa.io/bindings.loop",
-  "version": "1.0.0-alpha.32",
+  "version": "1.0.0-alpha.321",
+  "type": "module",
   "description": "Toa Loop Binding",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -19,7 +20,8 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/generic": "1.0.0-alpha.32"
+    "@toa.io/core": "1.0.0-alpha.321",
+    "@toa.io/generic": "1.0.0-alpha.311"
   },
-  "gitHead": "93ceb53797363abb77eb9c550db77e906691d42a"
+  "gitHead": "fa850e861a0c748d7364ccf7c8a09ce26973fc04"
 }

package/src/consumer.js

@@ -1,13 +1,11 @@
-'use strict'
+import { Connector, instance } from '@toa.io/core'
 
-const { Connector } = require('@toa.io/core')
-
-class Consumer extends Connector {
+export class Consumer extends Connector {
   #bindings
   #locator
   #endpoint
 
-  constructor (bindings, locator, endpoint) {
+  constructor(bindings, locator, endpoint) {
     super()
 
     this.#bindings = bindings
@@ -15,12 +13,16 @@ class Consumer extends Connector {
     this.#endpoint = endpoint
   }
 
-  async request (request) {
+  /**
+   * An addressed call is served here when it names this process, and handed to the next binding
+   * when it names another: the call is for that process, whichever replica composes the component here.
+   */
+  async request(request, terms) {
+    if (terms?.instance !== undefined && terms.instance !== instance()) return false
+
     const invoke = this.#bindings[this.#locator.id]?.[this.#endpoint]
 
     if (invoke === undefined) return false
     else return invoke(request)
   }
 }
-
-exports.Consumer = Consumer

package/src/factory.js

@@ -1,18 +1,14 @@
-'use strict'
+import { Producer } from './producer.js'
+import { Consumer } from './consumer.js'
 
-const { Producer } = require('./producer')
-const { Consumer } = require('./consumer')
-
-class Factory {
+export class Factory {
   #bindings = {}
 
-  producer (locator, endpoints, producer) {
+  producer(locator, endpoints, producer) {
     return new Producer(this.#bindings, locator, endpoints, producer)
   }
 
-  consumer (locator, endpoint) {
+  consumer(locator, endpoint) {
     return new Consumer(this.#bindings, locator, endpoint)
   }
 }
-
-exports.Factory = Factory

package/src/index.js

@@ -1,6 +1 @@
-'use strict'
-
-const { Factory } = require('./factory')
-
-exports.Factory = Factory
-exports.properties = { async: false }
+export { Factory } from './factory.js'

package/src/producer.js

@@ -1,13 +1,11 @@
-'use strict'
+import { Connector } from '@toa.io/core'
 
-const { Connector } = require('@toa.io/core')
-
-class Producer extends Connector {
+export class Producer extends Connector {
   #binding
   #endpoints
   #producer
 
-  constructor (bindings, locator, endpoints, producer) {
+  constructor(bindings, locator, endpoints, producer) {
     super()
 
     if (bindings[locator.id] === undefined) bindings[locator.id] = {}
@@ -19,19 +17,18 @@ class Producer extends Connector {
     this.depends(producer)
   }
 
-  async open () {
+  async open() {
     this.#endpoints.forEach((endpoint) => this.#operation(endpoint))
   }
 
-  async close () {
+  async close() {
     this.#endpoints.forEach((endpoint) => delete this.#binding[endpoint])
   }
 
-  #operation (endpoint) {
-    if (this.#binding[endpoint] !== undefined) throw new Error(`Loop binding endpoint '${endpoint}' already exists`)
+  #operation(endpoint) {
+    if (this.#binding[endpoint] !== undefined)
+      throw new Error(`Loop binding endpoint '${endpoint}' already exists`)
 
     this.#binding[endpoint] = async (request) => this.#producer.invoke(endpoint, request)
   }
 }
-
-exports.Producer = Producer

package/test/fixtures.js

@@ -1,8 +1,8 @@
-'use strict'
+import { mock } from 'node:test'
 
-const { generate } = require('randomstring')
+import { generate } from 'randomstring'
 
-const component = {
+export const component = {
   locator: {
     id: 'foo.bar',
     operations: [
@@ -17,21 +17,17 @@ const component = {
       }
     ]
   },
-  invoke: jest.fn(async () => generate()),
+  invoke: mock.fn(async () => generate()),
   link: () => null,
   connect: () => null,
   disconnect: () => null
 }
 
-const endpoints = ['get', 'add', 'discover']
+export const endpoints = ['get', 'add', 'discover']
 
-const exposition = {
+export const exposition = {
   locator: {
     id: 'foo.bar'
   },
-  invoke: jest.fn(async () => generate())
+  invoke: mock.fn(async () => generate())
 }
-
-exports.component = component
-exports.endpoints = endpoints
-exports.exposition = exposition

package/test/loop.test.js

@@ -0,0 +1,105 @@
+import { it, before, after, beforeEach, afterEach } from 'node:test'
+import assert from 'node:assert/strict'
+
+import clone from 'clone-deep'
+import { sample } from '@toa.io/generic'
+import { instance } from '@toa.io/core'
+
+import { Factory } from '../src/factory.js'
+import * as fixtures from './fixtures.js'
+
+const factory = new Factory()
+const producer = factory.producer(
+  fixtures.component.locator,
+  fixtures.endpoints,
+  fixtures.component
+)
+
+let consumer, endpoint
+
+before(async () => {
+  await producer.connect()
+})
+
+after(async () => {
+  await producer.disconnect()
+})
+
+beforeEach(async () => {
+  resetCalls()
+
+  endpoint = sample(fixtures.endpoints)
+  consumer = factory.consumer(fixtures.component.locator, endpoint)
+
+  await consumer.connect()
+})
+
+afterEach(async () => {
+  await consumer.disconnect()
+})
+
+it('should bind', async () => {
+  const r1 = await consumer.request(1)
+  const r2 = await consumer.request(2)
+
+  const calls = fixtures.component.invoke.mock.calls
+
+  assert.strictEqual(calls.length, 2)
+  assert.deepStrictEqual(calls[0].arguments, [endpoint, 1])
+  assert.deepStrictEqual(calls[1].arguments, [endpoint, 2])
+
+  assert.strictEqual(r1, await calls[0].result)
+  assert.strictEqual(r2, await calls[1].result)
+})
+
+it('should serve an addressed call that names this process', async () => {
+  const result = await consumer.request(3, { instance: instance() })
+  const calls = fixtures.component.invoke.mock.calls
+
+  assert.strictEqual(calls.length, 1)
+  assert.strictEqual(result, await calls[0].result)
+})
+
+// a call for another process runs on that process, though the component is composed here too
+it('should hand an addressed call that names another process to the next binding', async () => {
+  const result = await consumer.request(4, { instance: 'another' })
+
+  assert.strictEqual(result, false)
+  assert.strictEqual(fixtures.component.invoke.mock.calls.length, 0)
+})
+
+it('should return false if no binding', async () => {
+  const consumer = factory.consumer({ id: 'not.existent' }, endpoint)
+  const result = await consumer.request()
+
+  assert.strictEqual(result, false)
+})
+
+it('should not depend on initialization order', async () => {
+  const component = clone(fixtures.component)
+
+  component.locator.id = 'other.name'
+
+  const consumer = factory.consumer(component.locator, endpoint)
+  await consumer.connect()
+
+  assert.strictEqual(await consumer.request(), false)
+
+  const producer = factory.producer(component.locator, fixtures.endpoints, component)
+  await producer.connect()
+
+  assert.strictEqual(
+    await consumer.request(),
+    await component.invoke.mock.calls[0].result
+  )
+})
+
+function resetCalls(target = [fixtures], seen = new Set()) {
+  if (target === null || typeof target !== 'object' || seen.has(target)) return
+
+  seen.add(target)
+
+  for (const value of Object.values(target))
+    if (typeof value === 'function' && value.mock !== undefined) value.mock.resetCalls()
+    else resetCalls(value, seen)
+}

package/test/test.js

@@ -1,68 +0,0 @@
-'use strict'
-
-const clone = require('clone-deep')
-const { sample } = require('@toa.io/generic')
-
-const { Factory } = require('../src/factory')
-const fixtures = require('./fixtures')
-
-const factory = new Factory()
-const producer = factory.producer(fixtures.component.locator, fixtures.endpoints, fixtures.component)
-
-let consumer, endpoint
-
-beforeAll(async () => {
-  await producer.connect()
-})
-
-afterAll(async () => {
-  await producer.disconnect()
-})
-
-beforeEach(async () => {
-  jest.clearAllMocks()
-
-  endpoint = sample(fixtures.endpoints)
-  consumer = factory.consumer(fixtures.component.locator, endpoint)
-
-  await consumer.connect()
-})
-
-afterEach(async () => {
-  await consumer.disconnect()
-})
-
-it('should bind', async () => {
-  const r1 = await consumer.request(1)
-  const r2 = await consumer.request(2)
-
-  expect(fixtures.component.invoke).toHaveBeenCalledTimes(2)
-  expect(fixtures.component.invoke).toHaveBeenNthCalledWith(1, endpoint, 1)
-  expect(fixtures.component.invoke).toHaveBeenNthCalledWith(2, endpoint, 2)
-
-  expect(r1).toBe(await fixtures.component.invoke.mock.results[0].value)
-  expect(r2).toBe(await fixtures.component.invoke.mock.results[1].value)
-})
-
-it('should return false if no binding', async () => {
-  const consumer = factory.consumer({ id: 'not.existent' }, endpoint)
-  const result = await consumer.request()
-
-  expect(result).toBe(false)
-})
-
-it('should not depend on initialization order', async () => {
-  const component = clone(fixtures.component)
-
-  component.locator.id = 'other.name'
-
-  const consumer = factory.consumer(component.locator, endpoint)
-  await consumer.connect()
-
-  expect(await consumer.request()).toBe(false)
-
-  const producer = factory.producer(component.locator, fixtures.endpoints, component)
-  await producer.connect()
-
-  expect(await consumer.request()).toBe(await component.invoke.mock.results[0].value)
-})