@toa.io/extensions.realtime 1.0.0-alpha.304 → 1.0.0-alpha.306

package/components/realtime.streams/manifest.toa.yaml

@@ -46,4 +46,7 @@ stash: ~
 exposition:
   /:key:
     auth:id: key
-    GET: create
+    GET:
+      endpoint: create
+      # an effect: opening a stream is not a read, and `GET` is the method a client opens one with
+      io:readonly: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.realtime",
-  "version": "1.0.0-alpha.304",
+  "version": "1.0.0-alpha.306",
   "type": "module",
   "description": "Toa Realtime",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -26,14 +26,14 @@
     "!**/.env*"
   ],
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.304",
-    "@toa.io/definitions": "1.0.0-alpha.304",
+    "@toa.io/core": "1.0.0-alpha.306",
+    "@toa.io/definitions": "1.0.0-alpha.306",
     "@toa.io/generic": "1.0.0-alpha.304",
-    "openspan": "1.0.0-alpha.304"
+    "openspan": "1.0.0-alpha.305"
   },
   "scripts": {
     "transpile": "npx tsc && npx tsc -p ./components/realtime.streams",
     "features": "TSX_TSCONFIG_PATH=features/steps/tsconfig.json NODE_OPTIONS=--import=tsx cucumber-js"
   },
-  "gitHead": "a95a5a5a64922b11b23142d4acbcee1331ed31aa"
+  "gitHead": "0693d180a8053a7d07dca879dac2a3c4784d6d45"
 }

package/readme.md

@@ -106,10 +106,14 @@ Realtime extension, and are
 accessible via the `/realtime/streams/:key/` resource with
 the [`auth:id: key`](/extensions/exposition/documentation/access.md#id) authorization rule.
 
+Opening a stream is not a read, and `GET` is the method a client opens one with, so the route
+declares [`io:readonly: false`](/extensions/exposition/documentation/io.md#readonly).
+
 Refer to the [Exposition extension](/extensions/exposition) for more details:
 
 - [Multipart responses](/extensions/exposition/documentation/protocol.md#multipart-types)
 - [Access authorization](/extensions/exposition/documentation/access.md)
+- [Readonly chains](/documentation/readonly.md)
 
 ## Resources management
 

package/transpiled/Factory.d.ts

@@ -1,9 +1,9 @@
+import { type Connector } from '@toa.io/core';
 import type { extensions } from '@toa.io/core/types';
-import { Realtime } from './Realtime.ts';
 export declare class Factory implements extensions.Factory {
     private readonly host;
     constructor(host: Host);
-    service(): Realtime;
+    service(): Connector;
     private discovery;
 }
 export type Host = extensions.Host;

package/transpiled/Factory.js

@@ -7,13 +7,16 @@ export class Factory {
     constructor(host) {
         this.host = host;
     }
+    // a halt takes the whole of it: a stream it would keep open has nothing to carry
     service() {
-        const routes = new Routes(this.host);
-        const composition = new Composition(this.host);
-        const realtime = new Realtime(routes, async () => await this.discovery());
-        realtime.depends(routes);
-        realtime.depends(composition);
-        return realtime;
+        return this.host.gate(async () => {
+            const routes = new Routes(this.host);
+            const composition = new Composition(this.host);
+            const realtime = new Realtime(routes, async () => await this.discovery());
+            realtime.depends(routes);
+            realtime.depends(composition);
+            return realtime;
+        });
     }
     async discovery() {
         const locator = new Locator('streams', 'realtime');

package/transpiled/Factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,OAAO,OAAO;IACD,IAAI,CAAM;IAE3B,YAAmB,IAAU;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QAEzE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACxB,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAE7B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAElD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;IACjE,CAAC;CACF"}
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,OAAO,OAAO;IACD,IAAI,CAAM;IAE3B,YAAmB,IAAU;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,iFAAiF;IAC1E,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACpC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC9C,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;YAEzE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACxB,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;YAE7B,OAAO,QAAQ,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAElD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;IACjE,CAAC;CACF"}