@toa.io/atomicity 1.0.0-alpha.308 → 1.0.0-alpha.311

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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.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/atomicity
+
+
+
+
+
+# [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/atomicity
+
+
+
+
+
 # [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/atomicity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/atomicity",
-  "version": "1.0.0-alpha.308",
+  "version": "1.0.0-alpha.311",
   "type": "module",
   "description": "Toa Atomicity Connector",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -18,8 +18,8 @@
   },
   "dependencies": {
     "@sesamecare-oss/redlock": "1.4.0",
-    "@toa.io/core": "1.0.0-alpha.308",
-    "@toa.io/generic": "1.0.0-alpha.304",
+    "@toa.io/core": "1.0.0-alpha.311",
+    "@toa.io/generic": "1.0.0-alpha.311",
     "ioredis": "6.0.0",
     "n-and-i": "0.3.4",
     "openspan": "1.0.0-alpha.305"
@@ -27,5 +27,5 @@
   "scripts": {
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
-  "gitHead": "66eb0d54032f60e6ead9e13fd9e21fb60c611277"
+  "gitHead": "4f45061964e275296a27ff8ff39f757ce27d4008"
 }

package/readme.md

@@ -85,6 +85,9 @@ const atom = new Factory().atom('mail.sender')
 await atom.connect()
 ```
 
+The group is the context's, so a process with Redis configured has `TOA_CONTEXT` — or `TOA_DEV=1`
+— and an atom connecting without either throws.
+
 ## Configuration
 
 Requires Redis.
@@ -106,5 +109,8 @@ and two tolerate none at all.
 One set of clients per process, shared by every atom in it, and an unreachable Redis does not fail
 a start.
 
-Keys nest by whose they are, then by what they are for: `atom:<group>:slots:{group}…`,
-`atom:<group>:meter:<key>`, `atom:<group>:lock:<key>`.
+Keys nest by whose they are, then by what they are for: `<scope>:atom:<group>:slots:{group}…`,
+`<scope>:atom:<group>:meter:<key>`, `<scope>:atom:<group>:lock:<key>`. The scope is the context's
+name followed by `TOA_SUFFIX` (see
+[deployment](/documentation/deployment.md#several-processes-of-one-context-on-shared-infrastructure)),
+so contexts sharing a Redis do not share a group.

package/src/atom.js

@@ -14,6 +14,9 @@ export class Atom extends Connector {
   #name
   #interval
 
+  /** what every key of this atom begins with, once it has a Redis to write them to */
+  #prefix
+
   /** @type {{ i: number, n: number } | null} */
   #assignment = null
 
@@ -145,14 +148,15 @@ export class Atom extends Connector {
   /**
    * A key names whose it is and then what it is for, under the one namespace every atom
    * shares, so that a name used for a lock and for a meter is two keys, and two groups using
-   * the same name do not meet either.
+   * the same name do not meet either. All of it is under the scope, because contexts share a
+   * Redis, and so do the processes of one context given different suffixes.
    *
    * @private
    */
   #keys(kind, keys) {
     if (typeof keys === 'string') keys = [keys]
 
-    return keys.map((key) => `${ATOM}:${this.#name}:${kind}:${key}`)
+    return keys.map((key) => `${this.#prefix}${kind}:${key}`)
   }
 
   async open() {
@@ -161,6 +165,11 @@ export class Atom extends Connector {
     // without a Redis nothing can be owned exclusively, so nothing is claimed at all
     if (redis === undefined) return
 
+    // read as it opens rather than when it is made: an atom is one per group for the life of
+    // the process, and a process without a Redis — one run outside a context — has no scope
+    // to ask for
+    this.#prefix = `${environment.scope()}:${ATOM}:${this.#name}:`
+
     this.#abort = new AbortController()
     this.#discovering = this.#discover(redis)
   }
@@ -186,7 +195,7 @@ export class Atom extends Connector {
 
     const loop = discover({
       redis,
-      prefix: `${ATOM}:${this.#name}:${SLOTS}:`,
+      prefix: `${this.#prefix}${SLOTS}:`,
       name: this.#name,
       interval: this.#interval,
       signal: this.#abort.signal,