@toa.io/definitions 1.0.0-alpha.313 → 1.0.0-alpha.315

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/definitions",
-  "version": "1.0.0-alpha.313",
+  "version": "1.0.0-alpha.315",
   "type": "module",
   "description": "What Toa packages declare, read without running them",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -44,17 +44,32 @@
     "./*": "./transpiled/*/index.js"
   },
   "devDependencies": {
-    "@toa.io/core": "1.0.0-alpha.312",
+    "@aws-sdk/client-s3": "3.1135.0",
+    "@aws-sdk/lib-storage": "3.1135.0",
+    "@toa.io/core": "1.0.0-alpha.315",
+    "cloudinary": "2.11.0",
     "openspan": "1.0.0-alpha.305",
-    "oxc-parser": "0.149.0"
+    "oxc-parser": "0.150.0"
   },
   "peerDependencies": {
-    "oxc-parser": "0.149.0"
+    "@aws-sdk/client-s3": "3.1135.0",
+    "@aws-sdk/lib-storage": "3.1135.0",
+    "cloudinary": "2.11.0",
+    "oxc-parser": "0.150.0"
   },
   "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/lib-storage": {
+      "optional": true
+    },
+    "cloudinary": {
+      "optional": true
+    },
     "oxc-parser": {
       "optional": true
     }
   },
-  "gitHead": "7da3b2627ceeefd1fa19d5c8851be88d928523b6"
+  "gitHead": "d88ed286bf44bf95b5f3d9db6e7d4621261dbb99"
 }

package/schemas/extensions.cadence/declaration.cos.yaml

@@ -16,5 +16,10 @@ patternProperties:
           and the operation is told which interval it is running for.
         type: integer
         minimum: 1
+      scope:
+        description: >
+          Whose work this is: the component's, which one replica makes each call of, or every
+          replica's, for what lives inside a process.
+        enum: [group, replica]
     required: [cycle]
     additionalProperties: false

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

@@ -126,6 +126,14 @@ properties:
       anonymous:
         description: Whether the endpoint answers without a credential
         type: boolean
+      hosts:
+        description: A host of its own per authority, where the endpoint is the root
+        type: object
+        patternProperties:
+          ^.+$:
+            type: string
+            minLength: 1
+        additionalProperties: false
     required:
       - name
     additionalProperties: false

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

@@ -0,0 +1,19 @@
+type: object
+properties:
+  streams:
+    description: The Redis the streams are kept in; several are shards, a key kept by one of them
+    oneOf:
+      - type: string
+        minLength: 1
+      - type: array
+        items:
+          type: string
+          minLength: 1
+        minItems: 1
+  expire:
+    description: Seconds a stream outlives its last reader, the window a client reconnects in
+    type: integer
+    minimum: 1
+required:
+  - streams
+additionalProperties: false

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

@@ -0,0 +1,27 @@
+# a component's `realtime` declaration: its routes, by the label of the event
+type: object
+minProperties: 1
+additionalProperties:
+  type: object
+  properties:
+    key:
+      description: The properties of the event that are the keys of the streams it goes to
+      oneOf:
+        - type: string
+          minLength: 1
+        - type: array
+          items:
+            type: string
+            minLength: 1
+          minItems: 1
+    expose:
+      description: What of the event its streams are given; nothing is given that is not named
+      type: array
+      items:
+        type: string
+        minLength: 1
+      minItems: 1
+  required:
+    - key
+    - expose
+  additionalProperties: false

package/transpiled/definition.js

@@ -13,11 +13,18 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 export async function definition(reference) {
     if (!reference.startsWith(SCOPE))
         return undefined;
-    const suffix = reference.slice(SCOPE.length);
+    // `package#key` is a declaration of its own that a package claims beside its main one
+    const [suffix, key] = reference.slice(SCOPE.length).split('#');
     if (!DEFINED.has(suffix))
         return undefined;
     cache[suffix] ??= import(__rewriteRelativeImportExtension(`./${suffix}/index.ts`));
-    return cache[suffix];
+    const module = await cache[suffix];
+    if (key === undefined)
+        return module;
+    const keyed = module.keys?.[key];
+    if (keyed === undefined)
+        throw new Error(`'${reference}' names a key that '${SCOPE}${suffix}' does not claim`);
+    return keyed;
 }
 const cache = {};
 const SCOPE = '@toa.io/';
@@ -34,7 +41,6 @@ export const DEFINED = new Set([
     'extensions.exposition',
     'extensions.fetch',
     'extensions.introspection',
-    'extensions.realtime',
     'extensions.stash',
     'extensions.state',
     'extensions.storages',

package/transpiled/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../source/definition.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAElD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAE5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IAE1C,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,kCAAC,KAAK,MAAM,WAAW,EAAC,CAAA;IAEhD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,KAAK,GAAoC,EAAE,CAAA;AAEjD,MAAM,KAAK,GAAG,UAAU,CAAA;AAExB,wFAAwF;AACxF,MAAM,CAAC,MAAM,OAAO,GAAwB,IAAI,GAAG,CAAC;IAClD,eAAe;IACf,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,oBAAoB;IACpB,0BAA0B;IAC1B,wBAAwB;IACxB,uBAAuB;IACvB,kBAAkB;IAClB,0BAA0B;IAC1B,qBAAqB;IACrB,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,kBAAkB;CACnB,CAAC,CAAA"}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../source/definition.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAElD,sFAAsF;IACtF,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAE9D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IAE1C,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,kCAAC,KAAK,MAAM,WAAW,EAAC,CAAA;IAEhD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAA;IAElC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IAEpC,MAAM,KAAK,GAAI,MAA4C,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;IAEvE,IAAI,KAAK,KAAK,SAAS;QACrB,MAAM,IAAI,KAAK,CAAC,IAAI,SAAS,uBAAuB,KAAK,GAAG,MAAM,kBAAkB,CAAC,CAAA;IAEvF,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,KAAK,GAAoC,EAAE,CAAA;AAEjD,MAAM,KAAK,GAAG,UAAU,CAAA;AAExB,wFAAwF;AACxF,MAAM,CAAC,MAAM,OAAO,GAAwB,IAAI,GAAG,CAAC;IAClD,eAAe;IACf,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,oBAAoB;IACpB,0BAA0B;IAC1B,wBAAwB;IACxB,uBAAuB;IACvB,kBAAkB;IAClB,0BAA0B;IAC1B,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,kBAAkB;CACnB,CAAC,CAAA"}

package/transpiled/digest/generate.js

@@ -15,8 +15,7 @@ const DIGESTED = [
     'extensions.cadence',
     'extensions.configuration',
     'extensions.exposition',
-    'extensions.introspection',
-    'extensions.realtime'
+    'extensions.introspection'
 ];
 const OUT = resolve(import.meta.dirname, '../../digest');
 mkdirSync(OUT, { recursive: true });

package/transpiled/digest/generate.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../source/digest/generate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../source/digest/generate.ts"],"names":[],"mappings":"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"}

package/transpiled/extensions.cadence/index.d.ts

@@ -4,4 +4,4 @@ export { deployment, standalone } from './deployment.ts';
 export { context } from './context.ts';
 export * from './const.ts';
 export * as schemas from './schemas.ts';
-export type { Annotation, Declaration, Delay, Options, Pulse } from './types.ts';
+export type { Annotation, Declaration, Declared, Delay, Options, Pulse, Scope } from './types.ts';

package/transpiled/extensions.cadence/manifest.d.ts

@@ -1,4 +1,4 @@
-import type { Declaration } from './types.ts';
+import type { Declaration, Declared } from './types.ts';
 import type { Manifest } from '@toa.io/norm';
 /**
  * The `cadence:` block of a component manifest: the operations called on a cadence, by the
@@ -8,4 +8,4 @@ import type { Manifest } from '@toa.io/norm';
  * A component that declares nothing still has a declaration. `cadence: ~` is how one that only
  * delays calls says so, and it has to produce a value or norm rejects the extension.
  */
-export declare function manifest(declaration: Declaration | null | undefined, component: Manifest): Declaration;
+export declare function manifest(declaration: Declared | null | undefined, component: Manifest): Declaration;

package/transpiled/extensions.cadence/manifest.js

@@ -31,6 +31,8 @@ function expand(declaration) {
     return Object.fromEntries(Object.entries(declaration).map(([endpoint, pulse]) => {
         const declared = typeof pulse === 'number' ? { cycle: pulse } : { ...pulse };
         declared.intervals ??= 1;
+        // a pulse that does not say whose work it is is the component's, as every pulse was
+        declared.scope ??= 'group';
         return [endpoint, declared];
     }));
 }

package/transpiled/extensions.cadence/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.cadence/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAIvC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,WAA2C,EAC3C,SAAmB;IAEnB,MAAM,UAAU,GAA4B,MAAM,CAAC,WAAW,CAAC,CAAA;IAE/D,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAc,UAAU,EAAE,6BAA6B,CAAC,CAAA;IAEpF,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAA;QAElD,IAAI,SAAS,KAAK,SAAS;YACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,GAAG,CAAC,CAAA;QAEtE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,qDAAqD;gBACrE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACxB,CAAA;QAEH,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK;YAC/B,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,uBAAuB,KAAK,CAAC,KAAK,gBAAgB;gBAClE,GAAG,KAAK,CAAC,SAAS,8CAA8C,CACnE,CAAA;IACL,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,2EAA2E;AAC3E,SAAS,MAAM,CAAC,WAA2C;IACzD,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAEhE,+EAA+E;IAC/E,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QACpD,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAA;QAE7D,QAAQ,CAAC,SAAS,KAAK,CAAC,CAAA;QAExB,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC7B,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAA"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.cadence/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAIvC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,WAAwC,EACxC,SAAmB;IAEnB,MAAM,UAAU,GAA4B,MAAM,CAAC,WAAW,CAAC,CAAA;IAE/D,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAc,UAAU,EAAE,6BAA6B,CAAC,CAAA;IAEpF,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAA;QAElD,IAAI,SAAS,KAAK,SAAS;YACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,GAAG,CAAC,CAAA;QAEtE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,qDAAqD;gBACrE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACxB,CAAA;QAEH,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK;YAC/B,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,uBAAuB,KAAK,CAAC,KAAK,gBAAgB;gBAClE,GAAG,KAAK,CAAC,SAAS,8CAA8C,CACnE,CAAA;IACL,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,2EAA2E;AAC3E,SAAS,MAAM,CAAC,WAAwC;IACtD,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAEhE,+EAA+E;IAC/E,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QACpD,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAA;QAE7D,QAAQ,CAAC,SAAS,KAAK,CAAC,CAAA;QAExB,oFAAoF;QACpF,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAA;QAE1B,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC7B,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAA"}

package/transpiled/extensions.cadence/types.d.ts

@@ -1,11 +1,24 @@
 /** What one component declares under `cadence:`, by the operation each one calls. */
 export type Declaration = Record<string, Pulse>;
+/**
+ * What a manifest may state: a whole pulse, one with what it leaves to the default left out,
+ * or the cycle alone.
+ */
+export type Declared = Record<string, number | (Partial<Pulse> & {
+    cycle: number;
+})>;
 export interface Pulse {
     /** seconds one whole cycle takes */
     cycle: number;
     /** intervals the cycle is split into; the gap between calls is `cycle / intervals` */
     intervals: number;
+    /**
+     * Whose work this is: `group` is the component's, and one replica makes each call; `replica`
+     * is every replica's own, for what lives inside a process.
+     */
+    scope: Scope;
 }
+export type Scope = 'group' | 'replica';
 /** `context.delay` — a call to be made later, answering the id that cancels it. */
 export interface Delay {
     (endpoint: string, request: object | null, options: Options): Promise<string>;

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

@@ -26,7 +26,7 @@ export interface Annotation {
     oauth?: OAuth;
     /** JSON-RPC at `/.rpc`; none is served without it. See `documentation/rpc.md`. */
     rpc?: RPC;
-    /** MCP at `/.mcp`; none is served without it. See `documentation/mcp.md`. */
+    /** MCP at `/.mcp`, and on a host of its own where one is named; none without it. */
     mcp?: MCP;
     '/'?: object;
 }
@@ -67,6 +67,11 @@ export interface MCP {
     origins?: string[];
     /** Whether the endpoint answers without a credential. It does not unless it says so. */
     anonymous?: boolean;
+    /**
+     * A host of its own per authority, where the endpoint is served at the root and nothing
+     * else is. See `documentation/mcp.md`.
+     */
+    hosts?: Record<string, string>;
 }
 export interface Bouncer {
     /** what an address may fail at once, 20 by default */

package/transpiled/extensions.exposition/deployment.js

@@ -36,7 +36,7 @@ export function deployment(_, annotation) {
         });
     }
     const { debug, authorities } = annotation;
-    service.ingress.hosts = Object.values(authorities);
+    service.ingress.hosts = Object.values(authorities).concat(mcp(annotation));
     // leaving these undefined lets the context's own ingress section supply them
     if (annotation.class !== undefined)
         service.ingress.class = annotation.class;
@@ -74,4 +74,17 @@ export function deployment(_, annotation) {
     });
     return { services: [service] };
 }
+/**
+ * The hosts MCP is served at the root of. Each is declared under the authority it belongs
+ * to, and one under a key naming no authority would be a host nothing resolves.
+ */
+function mcp(annotation) {
+    const hosts = annotation.mcp?.hosts;
+    if (hosts === undefined)
+        return [];
+    for (const authority of Object.keys(hosts))
+        if (!(authority in annotation.authorities))
+            throw new Error(`MCP host names an undeclared authority '${authority}'`);
+    return Object.values(hosts);
+}
 //# sourceMappingURL=deployment.js.map

package/transpiled/extensions.exposition/deployment.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../source/extensions.exposition/deployment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC;oFACoF;AACpF,MAAM,CAAC,MAAM,KAAK,GAAG,6CAA6C,CAAA;AAElE,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,UAAuB;IAC5D,IAAI,UAAU,KAAK,SAAS;QAC1B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC9D,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IAEvC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC,MAAM,CAAA;IAElC,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,SAAS;QACf,KAAK;QACL,IAAI,EAAE,IAAI;QACV,OAAO;QACP,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;QACjC,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,KAAK;SACb;KACF,CAAA;IAED,IAAI,UAAU,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAA;QAE9C,OAAO,CAAC,SAAU,CAAC,IAAI,CAAC;YACtB,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC5B,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,UAAU,CAAA;IAEzC,OAAO,CAAC,OAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAEnD,6EAA6E;IAC7E,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,OAAQ,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAA;IAE7E,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS;QACtC,OAAO,CAAC,OAAQ,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAA;IAEvD,IAAI,UAAU,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS;QAC/C,OAAO,CAAC,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,CAAA;IAEtD,MAAM,UAAU,GAAe,EAAE,WAAW,EAAE,CAAA;IAE9C,IAAI,KAAK,KAAK,IAAI;QAAE,UAAU,CAAC,KAAK,GAAG,IAAI,CAAA;IAE3C,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS;QAAE,UAAU,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAA;IAEhF,IAAI,UAAU,CAAC,EAAE,KAAK,SAAS;QAAE,UAAU,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAA;IAE9D,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS;QAAE,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAA;IAE7E,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;QAAE,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAA;IAE1E,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;QAAE,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAA;IAEvE,IAAI,UAAU,CAAC,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAA;IAEjE,IAAI,UAAU,CAAC,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAA;IAEjE,OAAO,CAAC,SAAU,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;KAClC,CAAC,CAAA;IAEF,2FAA2F;IAC3F,uFAAuF;IACvF,8EAA8E;IAC9E,OAAO,CAAC,SAAU,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KAC7B,CAAC,CAAA;IAEF,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAA;AAChC,CAAC"}
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../source/extensions.exposition/deployment.ts"],"names":[],"mappings":"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"}

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

@@ -3,6 +3,7 @@ export { components } from './components.ts';
 export { installs } from './packages.ts';
 export { deployment, image } from './deployment.ts';
 export { shortcuts } from './shortcuts.ts';
+export * as keys from './keys.ts';
 export * from './const.ts';
 export * as schemas from './schemas.ts';
 export * as syntax from './syntax/index.ts';

package/transpiled/extensions.exposition/index.js

@@ -3,6 +3,7 @@ export { components } from './components.js';
 export { installs } from './packages.js';
 export { deployment, image } from './deployment.js';
 export { shortcuts } from './shortcuts.js';
+export * as keys from './keys.js';
 export * from './const.js';
 export * as schemas from './schemas.js';
 export * as syntax from './syntax/index.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.exposition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,cAAc,YAAY,CAAA;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.exposition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA"}

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

@@ -0,0 +1,2 @@
+/** What `realtime` declares beside `exposition`: `@toa.io/extensions.exposition#realtime`. */
+export * as realtime from './realtime/index.ts';

package/transpiled/extensions.exposition/keys.js

@@ -0,0 +1,3 @@
+/** What `realtime` declares beside `exposition`: `@toa.io/extensions.exposition#realtime`. */
+export * as realtime from './realtime/index.js';
+//# sourceMappingURL=keys.js.map

package/transpiled/extensions.exposition/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../source/extensions.exposition/keys.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA"}

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

@@ -0,0 +1,4 @@
+/** The addresses of the Redis the streams are kept in, space-separated. */
+export declare const STREAMS = "TOA_REALTIME_STREAMS";
+/** Seconds a stream outlives its last reader. */
+export declare const EXPIRE = "TOA_REALTIME_EXPIRE";

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

@@ -0,0 +1,5 @@
+/** The addresses of the Redis the streams are kept in, space-separated. */
+export const STREAMS = 'TOA_REALTIME_STREAMS';
+/** Seconds a stream outlives its last reader. */
+export const EXPIRE = 'TOA_REALTIME_EXPIRE';
+//# sourceMappingURL=const.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/const.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,OAAO,GAAG,sBAAsB,CAAA;AAE7C,iDAAiD;AACjD,MAAM,CAAC,MAAM,MAAM,GAAG,qBAAqB,CAAA"}

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

@@ -0,0 +1,11 @@
+import type { Dependency } from '@toa.io/operations';
+/**
+ * Where the streams are kept, given to every process: the components that route events write them,
+ * and the gateway reads them. Asked for where a component declares routes, as any annotation is
+ * where its extension is declared.
+ */
+export declare function deployment(_: unknown, annotation?: Annotation): Dependency;
+export interface Annotation {
+    streams: string | string[];
+    expire?: number;
+}

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

@@ -0,0 +1,17 @@
+import * as schemas from '../schemas.js';
+import { EXPIRE, STREAMS } from './const.js';
+/**
+ * Where the streams are kept, given to every process: the components that route events write them,
+ * and the gateway reads them. Asked for where a component declares routes, as any annotation is
+ * where its extension is declared.
+ */
+export function deployment(_, annotation) {
+    schemas.realtime.validate(annotation ?? null, 'Invalid realtime annotation');
+    const { streams, expire } = annotation;
+    const addresses = Array.isArray(streams) ? streams : [streams];
+    const global = [{ name: STREAMS, value: addresses.join(' ') }];
+    if (expire !== undefined)
+        global.push({ name: EXPIRE, value: String(expire) });
+    return { variables: { global } };
+}
+//# sourceMappingURL=deployment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAG5C;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,UAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,EAAE,6BAA6B,CAAC,CAAA;IAE5E,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAW,CAAA;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC9D,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAE9D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAE9E,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,CAAA;AAClC,CAAC"}

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

@@ -0,0 +1,6 @@
+export { deployment } from './deployment.ts';
+export { manifest } from './manifest.ts';
+export { 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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,7 @@
+import type { Declaration } from './routes.ts';
+import type { Manifest } from '@toa.io/norm';
+/**
+ * A component's routes, refused where one does not say what it exposes: an event is given to its
+ * streams only as far as its route names.
+ */
+export declare function manifest(declaration: unknown, manifest: Manifest): Declaration;

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

@@ -0,0 +1,10 @@
+import * as schemas from '../schemas.js';
+/**
+ * A component's routes, refused where one does not say what it exposes: an event is given to its
+ * streams only as far as its route names.
+ */
+export function manifest(declaration, manifest) {
+    schemas.routes.validate(declaration, `Realtime routes of '${manifest.namespace}.${manifest.name}' are invalid`);
+    return declaration;
+}
+//# sourceMappingURL=manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../source/extensions.exposition/realtime/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,eAAe,CAAA;AAIxC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAoB,EAAE,QAAkB;IAC/D,OAAO,CAAC,MAAM,CAAC,QAAQ,CACrB,WAAW,EACX,uBAAuB,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,IAAI,eAAe,CAC1E,CAAA;IAED,OAAO,WAA0B,CAAA;AACnC,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export interface Route {
+    /** the event's label within its component */
+    event: string;
+    properties: string[];
+    expose: string[];
+}
+/** A component's `realtime` declaration, by event label. */
+export type Declaration = Record<string, RouteDeclaration>;
+export interface RouteDeclaration {
+    key: string | string[];
+    /** What the streams are given of the event. Required: nothing is given that is not named. */
+    expose: string[];
+}
+export declare function parse(declaration: Declaration): Route[];

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

@@ -0,0 +1,8 @@
+export function parse(declaration) {
+    return Object.entries(declaration).map(([event, { key, expose }]) => ({
+        event,
+        properties: Array.isArray(key) ? key : [key],
+        expose
+    }));
+}
+//# sourceMappingURL=routes.js.map

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

@@ -0,0 +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"}

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

@@ -5,3 +5,5 @@ export declare const querystring: Schema<Record<string, unknown>>;
 export declare const call: Schema<Record<string, unknown>>;
 export declare const annotation: Schema<Annotation>;
 export declare const node: Schema<Node>;
+export declare const realtime: Schema<unknown>;
+export declare const routes: Schema<unknown>;

package/transpiled/extensions.exposition/schemas.js

@@ -7,4 +7,6 @@ export const querystring = namespace.schema('querystring');
 export const call = namespace.schema('call');
 export const annotation = namespace.schema('annotation');
 export const node = namespace.schema('node');
+export const realtime = namespace.schema('realtime');
+export const routes = namespace.schema('routes');
 //# sourceMappingURL=schemas.js.map

package/transpiled/extensions.exposition/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../source/extensions.exposition/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAK1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAA;AAChF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAEzC,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GACtB,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;AACjC,MAAM,CAAC,MAAM,IAAI,GAAoC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAE7E,MAAM,CAAC,MAAM,UAAU,GAAuB,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;AAC5E,MAAM,CAAC,MAAM,IAAI,GAAiB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../source/extensions.exposition/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAK1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAA;AAChF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAEzC,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GACtB,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;AACjC,MAAM,CAAC,MAAM,IAAI,GAAoC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAE7E,MAAM,CAAC,MAAM,UAAU,GAAuB,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;AAC5E,MAAM,CAAC,MAAM,IAAI,GAAiB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC1D,MAAM,CAAC,MAAM,QAAQ,GAAoB,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;AACrE,MAAM,CAAC,MAAM,MAAM,GAAoB,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA"}

package/transpiled/extensions.storages/packages.d.ts

@@ -3,7 +3,8 @@ import type { Instance } from './deployment.ts';
 /**
  * What each provider is written against, stated apart from the provider for the reason its
  * secrets are: so that a deploy installs the SDK without loading it, and an image carries no
- * SDK a declaration does not name. These are the extension's optional peers at the versions it
+ * SDK a declaration does not name. The versions are this package's optional peers, so a bump
+ * is a change to its manifest alone. They are the extension's optional peers at the versions it
  * declares them — `packages.test.ts` is what keeps the two the same.
  */
 export declare const packages: Record<Provider, Readonly<Record<string, string>>>;

package/transpiled/extensions.storages/packages.js

@@ -1,13 +1,17 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const peers = JSON.parse(readFileSync(join(import.meta.dirname, '../../package.json'), 'utf8')).peerDependencies;
 /**
  * What each provider is written against, stated apart from the provider for the reason its
  * secrets are: so that a deploy installs the SDK without loading it, and an image carries no
- * SDK a declaration does not name. These are the extension's optional peers at the versions it
+ * SDK a declaration does not name. The versions are this package's optional peers, so a bump
+ * is a change to its manifest alone. They are the extension's optional peers at the versions it
  * declares them — `packages.test.ts` is what keeps the two the same.
  */
 export const packages = {
-    s3: { '@aws-sdk/client-s3': '3.1131.0', '@aws-sdk/lib-storage': '3.1131.0' },
-    spaces: { '@aws-sdk/client-s3': '3.1131.0', '@aws-sdk/lib-storage': '3.1131.0' },
-    cloudinary: { cloudinary: '2.11.0' },
+    s3: pin('@aws-sdk/client-s3', '@aws-sdk/lib-storage'),
+    spaces: pin('@aws-sdk/client-s3', '@aws-sdk/lib-storage'),
+    cloudinary: pin('cloudinary'),
     fs: {},
     tmp: {},
     test: {}
@@ -38,4 +42,10 @@ export function installs(instance, annotation) {
 function isAnnotation(value) {
     return typeof value === 'object' && value !== null;
 }
+function pin(...names) {
+    const pinned = {};
+    for (const name of names)
+        pinned[name] = peers[name];
+    return pinned;
+}
 //# sourceMappingURL=packages.js.map

package/transpiled/extensions.storages/packages.js.map

@@ -1 +1 @@
-{"version":3,"file":"packages.js","sourceRoot":"","sources":["../../source/extensions.storages/packages.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuD;IAC1E,EAAE,EAAE,EAAE,oBAAoB,EAAE,UAAU,EAAE,sBAAsB,EAAE,UAAU,EAAE;IAC5E,MAAM,EAAE,EAAE,oBAAoB,EAAE,UAAU,EAAE,sBAAsB,EAAE,UAAU,EAAE;IAChF,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;IACpC,EAAE,EAAE,EAAE;IACN,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,EAAE;CACT,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA8B,EAC9B,UAAmB;IAEnB,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAA;IAElE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACtE,MAAM,QAAQ,GAA2B,EAAE,CAAA;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAEpC,IAAI,WAAW,KAAK,SAAS;YAAE,SAAQ;QAEvC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AACpD,CAAC"}
+{"version":3,"file":"packages.js","sourceRoot":"","sources":["../../source/extensions.storages/packages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAKhC,MAAM,KAAK,GAA2B,IAAI,CAAC,KAAK,CAC9C,YAAY,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC,CACtE,CAAC,gBAAgB,CAAA;AAElB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuD;IAC1E,EAAE,EAAE,GAAG,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;IACrD,MAAM,EAAE,GAAG,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;IACzD,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC;IAC7B,EAAE,EAAE,EAAE;IACN,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,EAAE;CACT,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA8B,EAC9B,UAAmB;IAEnB,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAA;IAElE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACtE,MAAM,QAAQ,GAA2B,EAAE,CAAA;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAEpC,IAAI,WAAW,KAAK,SAAS;YAAE,SAAQ;QAEvC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AACpD,CAAC;AAED,SAAS,GAAG,CAAC,GAAG,KAAe;IAC7B,MAAM,MAAM,GAA2B,EAAE,CAAA;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IAEpD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/transpiled/index.d.ts

@@ -1,4 +1,4 @@
 export { version } from './version.ts';
-export { MAP, MAP_DIRECTORY, MAP_FILE } from './map.ts';
+export { MAP, MAP_DIRECTORY, MAP_FILE, MAP_LOCAL, MAP_LOCAL_FILE } from './map.ts';
 export { PREDEFINED } from './predefined.ts';
 export { definition, DEFINED } from './definition.ts';

package/transpiled/index.js

@@ -1,5 +1,5 @@
 export { version } from './version.js';
-export { MAP, MAP_DIRECTORY, MAP_FILE } from './map.js';
+export { MAP, MAP_DIRECTORY, MAP_FILE, MAP_LOCAL, MAP_LOCAL_FILE } from './map.js';
 export { PREDEFINED } from './predefined.js';
 export { definition, DEFINED } from './definition.js';
 //# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA"}

package/transpiled/map.d.ts

@@ -1,9 +1,18 @@
+/** What `toa map` writes, and what a process is given by anything but a deployment. */
+export declare const MAP_LOCAL_FILE = ".map.json";
 /**
  * Where a deployed process reads the component map from: the directory a chart mounts it in, and
  * the file a command is given. The image names the file, because a mounted ConfigMap is a
  * directory and a file placed into an existing one with `subPath` is the one kind of mount
  * Kubernetes does not update.
+ *
+ * Gzipped, because a ConfigMap is capped at a megabyte and nothing reads this copy by eye. Named
+ * for what it is: a gzip stream called `.json` is something someone opens once and reports as
+ * broken, and so is a plain one called `.gz`, which is why a map mounted from a checkout is
+ * mounted under its own name.
  */
 export declare const MAP_DIRECTORY = "/etc/toa";
-export declare const MAP_FILE = ".map.json";
+export declare const MAP_FILE: string;
 export declare const MAP: string;
+/** Where a container run from a checkout is given the map that checkout wrote. */
+export declare const MAP_LOCAL: string;