@toa.io/definitions 1.0.0-alpha.323 → 1.0.0-alpha.325

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/definitions",
-  "version": "1.0.0-alpha.323",
+  "version": "1.0.0-alpha.325",
   "type": "module",
   "description": "What Toa packages declare, read without running them",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -71,5 +71,5 @@
       "optional": true
     }
   },
-  "gitHead": "1d31b234602c9eda959d80bdca79b983ebf541ea"
+  "gitHead": "95bc03e65c65f02d536da6ed027cf4f78f5cec74"
 }

package/schemas/extensions.exposition/annotation.cos.yaml

@@ -134,6 +134,11 @@ properties:
             type: string
             minLength: 1
         additionalProperties: false
+      manifest:
+        description: The web manifest whose icons the server shows itself by
+        type: string
+        maxLength: 2048
+        pattern: ^(https://[^/]|http://(localhost|127\.0\.0\.1|\[::1\])(:\d+)?/)
     required:
       - name
     additionalProperties: false

package/schemas/extensions.exposition/routes.cos.yaml

@@ -5,14 +5,17 @@ additionalProperties:
   type: object
   properties:
     key:
-      description: The properties of the event that are the keys of the streams it goes to
+      description: >-
+        The properties of the event that are the keys of the streams it goes to, or literal keys:
+        `~` and the key
+      # a property, or `~` and at least one character of a literal
       oneOf:
         - type: string
-          minLength: 1
+          pattern: ^(?:[^~]|~.)
         - type: array
           items:
             type: string
-            minLength: 1
+            pattern: ^(?:[^~]|~.)
           minItems: 1
     expose:
       description: What of the event its streams are given; nothing is given that is not named

package/transpiled/extensions.exposition/Annotation.d.ts

@@ -72,6 +72,11 @@ export interface MCP {
      * else is. See `documentation/mcp.md`.
      */
     hosts?: Record<string, string>;
+    /**
+     * The application's web manifest, whose icons the server shows itself by: `https`, or
+     * `http` on a loopback host. See `documentation/mcp.md`.
+     */
+    manifest?: string;
 }
 export interface Bouncer {
     /** what an address may fail at once, 20 by default */

package/transpiled/extensions.exposition/realtime/index.d.ts

@@ -1,6 +1,6 @@
 export { deployment } from './deployment.ts';
 export { manifest } from './manifest.ts';
-export { parse } from './routes.ts';
+export { literal, parse } from './routes.ts';
 export { EXPIRE, STREAMS } from './const.ts';
 export type { Annotation } from './deployment.ts';
 export type { Declaration, Route, RouteDeclaration } from './routes.ts';

package/transpiled/extensions.exposition/realtime/index.js

@@ -1,5 +1,5 @@
 export { deployment } from './deployment.js';
 export { manifest } from './manifest.js';
-export { parse } from './routes.js';
+export { literal, parse } from './routes.js';
 export { EXPIRE, STREAMS } from './const.js';
 //# sourceMappingURL=index.js.map

package/transpiled/extensions.exposition/realtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/transpiled/extensions.exposition/realtime/routes.d.ts

@@ -1,11 +1,14 @@
 /**
  * A realtime route: an event of a component, the properties of its payload that are the keys of
- * the streams it goes to, and what of it they are given.
+ * the streams it goes to, the literal keys it goes to whatever its payload, and what of it they
+ * are given.
  */
 export interface Route {
     /** the event's label within its component */
     event: string;
     properties: string[];
+    /** keys as they are, `~` included */
+    literals: string[];
     expose: string[];
 }
 /** A component's `realtime` declaration, by event label. */
@@ -16,3 +19,9 @@ export interface RouteDeclaration {
     expose: string[];
 }
 export declare function parse(declaration: Declaration): Route[];
+/**
+ * A key that begins with `~` is the key itself. No property is named so, and no value of a
+ * property is taken for a key so, which keeps a literal's stream out of reach of whoever writes
+ * the values.
+ */
+export declare function literal(key: string): boolean;

package/transpiled/extensions.exposition/realtime/routes.js

@@ -1,8 +1,20 @@
 export function parse(declaration) {
-    return Object.entries(declaration).map(([event, { key, expose }]) => ({
-        event,
-        properties: Array.isArray(key) ? key : [key],
-        expose
-    }));
+    return Object.entries(declaration).map(([event, { key, expose }]) => {
+        const keys = Array.isArray(key) ? key : [key];
+        return {
+            event,
+            properties: keys.filter((one) => !literal(one)),
+            literals: keys.filter(literal),
+            expose
+        };
+    });
+}
+/**
+ * A key that begins with `~` is the key itself. No property is named so, and no value of a
+ * property is taken for a key so, which keeps a literal's stream out of reach of whoever writes
+ * the values.
+ */
+export function literal(key) {
+    return key.startsWith('~');
 }
 //# sourceMappingURL=routes.js.map

package/transpiled/extensions.exposition/realtime/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/routes.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,KAAK,CAAC,WAAwB;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACpE,KAAK;QACL,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5C,MAAM;KACP,CAAC,CAAC,CAAA;AACL,CAAC"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/routes.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,KAAK,CAAC,WAAwB;IAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAClE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAE7C,OAAO;YACL,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAC9B,MAAM;SACP,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC"}