@toa.io/definitions 1.0.0-alpha.331 → 1.0.0-alpha.333

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/definitions",
-  "version": "1.0.0-alpha.331",
+  "version": "1.0.0-alpha.333",
   "type": "module",
   "description": "What Toa packages declare, read without running them",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -30,9 +30,9 @@
     "!**/.env*"
   ],
   "dependencies": {
-    "@toa.io/generic": "1.0.0-alpha.330",
-    "@toa.io/pointer": "1.0.0-alpha.330",
-    "@toa.io/schemas": "1.0.0-alpha.330",
+    "@toa.io/generic": "1.0.0-alpha.332",
+    "@toa.io/pointer": "1.0.0-alpha.332",
+    "@toa.io/schemas": "1.0.0-alpha.332",
     "croner": "10.0.1"
   },
   "scripts": {
@@ -45,18 +45,18 @@
     "./*": "./transpiled/*/index.js"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "3.1148.0",
-    "@aws-sdk/lib-storage": "3.1148.0",
-    "@toa.io/core": "1.0.0-alpha.330",
+    "@aws-sdk/client-s3": "3.1156.0",
+    "@aws-sdk/lib-storage": "3.1156.0",
+    "@toa.io/core": "1.0.0-alpha.333",
     "cloudinary": "2.11.0",
     "openspan": "1.0.0-alpha.330",
-    "oxc-parser": "0.153.0"
+    "oxc-parser": "0.155.0"
   },
   "peerDependencies": {
-    "@aws-sdk/client-s3": "3.1148.0",
-    "@aws-sdk/lib-storage": "3.1148.0",
+    "@aws-sdk/client-s3": "3.1156.0",
+    "@aws-sdk/lib-storage": "3.1156.0",
     "cloudinary": "2.11.0",
-    "oxc-parser": "0.153.0"
+    "oxc-parser": "0.155.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {
@@ -72,5 +72,5 @@
       "optional": true
     }
   },
-  "gitHead": "e7020d160910ca4f0c2ff9040b3cbb4fca8ea41f"
+  "gitHead": "ddb74b2f99026fae540a8a8e0a49c26cbd22886a"
 }

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

@@ -0,0 +1,52 @@
+# context.toa.yaml chronicles annotation
+type: object
+properties:
+  broker:
+    description: The AMQP address of the broker the rows are published to
+    type: string
+    pattern: ^amqps?://
+  store:
+    description: Where the log is read, by the provider that keeps it
+    oneOf:
+      - type: object
+        properties:
+          provider:
+            const: clickhouse
+          url:
+            description: The HTTP address of ClickHouse; what is read is the user's own
+            type: string
+            format: uri
+        required: [provider, url]
+        additionalProperties: false
+  retention:
+    description: Days a row of `events` and of `encounters` is kept; absent, kept
+    type: integer
+    minimum: 1
+  encounters:
+    description: Whether the routes clients send encounters to are served
+    type: boolean
+  ip:
+    description: >
+      How much of a client's address the log keeps: its network, truncated to /24 of IPv4 and /48
+      of IPv6, or all of it
+    enum: [truncated, full]
+  resources:
+    # what the service may take; `null` deploys it without any, which every deployment has to
+    # state one way or the other — see `migrations/262.md`
+    type: object
+    nullable: true
+    properties:
+      cpu:
+        type: array
+        items:
+          type: string
+        minItems: 2
+        maxItems: 2
+      memory:
+        type: array
+        items:
+          type: string
+        minItems: 2
+        maxItems: 2
+required: [broker, store]
+additionalProperties: false

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

@@ -0,0 +1,60 @@
+# manifest.toa.yaml chronicles declaration, normalised: the events whose renderings are rows of
+# the log, the event whose payload is the entity as it stands, and the facts the component sends,
+# each with its contract. What a contract's properties are is checked by the extension, which
+# says where a property is that has no type of the log.
+type: object
+properties:
+  events:
+    type: object
+    propertyNames:
+      pattern: ^[a-zA-Z][a-zA-Z0-9]*$
+    additionalProperties:
+      $ref: '#/definitions/contract'
+  state:
+    type: object
+    properties:
+      event:
+        description: The event whose payload is the entity as it stands
+        type: string
+        pattern: ^[a-zA-Z][a-zA-Z0-9]*$
+      description:
+        $ref: '#/definitions/description'
+      properties:
+        $ref: '#/definitions/properties'
+    required: [event, description, properties]
+    additionalProperties: false
+  facts:
+    type: object
+    propertyNames:
+      pattern: ^[a-zA-Z][a-zA-Z0-9]*(\.[a-zA-Z][a-zA-Z0-9]*)*$
+    additionalProperties:
+      $ref: '#/definitions/contract'
+  identity:
+    description: The property of the payloads that names the identity a row is of; null, none
+    type: [string, "null"]
+    pattern: ^[a-zA-Z_][a-zA-Z0-9_]*$
+  timestamp:
+    description: >
+      The property of the payloads that says when the change was made, in milliseconds; null, none,
+      and the time the message carries is when
+    type: [string, "null"]
+    pattern: ^[a-zA-Z_][a-zA-Z0-9_]*$
+required: [events, facts, timestamp]
+additionalProperties: false
+definitions:
+  contract:
+    type: object
+    properties:
+      description:
+        $ref: '#/definitions/description'
+      properties:
+        $ref: '#/definitions/properties'
+    required: [description, properties]
+    additionalProperties: false
+  description:
+    description: What the label means
+    type: string
+    minLength: 1
+  properties:
+    description: What of the payload is written, as JSON Schema
+    type: object

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

@@ -47,24 +47,17 @@ properties:
         type: integer
         minimum: 1
     additionalProperties: false
+  country:
+    description: The header the client's country is read from, which the edge in front writes
+    type: string
+    minLength: 1
   censor:
-    description: Header values a request is answered 451 for
-    type: object
-    properties:
-      header:
-        description: The request header the values are read from, in any case
-        type: string
-        minLength: 1
-      values:
-        description: What the header holds for a request to be refused, compared exactly
-        type: array
-        items:
-          type: string
-        minItems: 1
-    required:
-      - header
-      - values
-    additionalProperties: false
+    description: The countries a request is answered 451 from, as the header `country` names holds them
+    type: array
+    items:
+      type: string
+      minLength: 1
+    minItems: 1
   protocol:
     type: string
     enum: [h1, h2c]

package/transpiled/definition.js

@@ -36,6 +36,7 @@ export const DEFINED = new Set([
     'bridges.bash',
     'bridges.node',
     'extensions.cadence',
+    'extensions.chronicles',
     'extensions.configuration',
     'extensions.continuity',
     'extensions.convergence',

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,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,uBAAuB;IACvB,wBAAwB;IACxB,uBAAuB;IACvB,kBAAkB;IAClB,0BAA0B;IAC1B,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,uBAAuB;IACvB,0BAA0B;IAC1B,uBAAuB;IACvB,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

@@ -13,6 +13,7 @@ const require = createRequire(import.meta.url);
 const { component } = (await import('@toa.io/norm'));
 const DIGESTED = [
     'extensions.cadence',
+    'extensions.chronicles',
     'extensions.configuration',
     'extensions.continuity',
     'extensions.exposition',

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.chronicles/components.d.ts

@@ -0,0 +1,7 @@
+import { type Components } from '../digest/read.ts';
+import type { Annotation } from './types.ts';
+/**
+ * The components this extension ships, which run inside its own service: the encounters only
+ * where the annotation serves them.
+ */
+export declare function components(annotation?: Partial<Annotation>): Components;

package/transpiled/extensions.chronicles/components.js

@@ -0,0 +1,10 @@
+import { components as digest } from '../digest/read.js';
+import { ENCOUNTERS, NAMESPACE } from './const.js';
+/**
+ * The components this extension ships, which run inside its own service: the encounters only
+ * where the annotation serves them.
+ */
+export function components(annotation) {
+    return digest('extensions.chronicles', (label) => annotation?.encounters === true || label !== `${NAMESPACE}-${ENCOUNTERS}`);
+}
+//# sourceMappingURL=components.js.map

package/transpiled/extensions.chronicles/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../source/extensions.chronicles/components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,MAAM,EAAmB,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGlD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAgC;IACzD,OAAO,MAAM,CACX,uBAAuB,EACvB,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,SAAS,IAAI,UAAU,EAAE,CACrF,CAAA;AACH,CAAC"}

package/transpiled/extensions.chronicles/const.d.ts

@@ -0,0 +1,20 @@
+/** What the service is given of the annotation, as JSON, and what its secrets are named after. */
+export declare const SETTINGS = "TOA_CHRONICLES";
+/** The secret of the broker the rows are published to, and of the store they are read from. */
+export declare const SECRET = "toa-chronicles";
+/** Its keys: the users of the broker and of the store. */
+export declare const KEYS: string[];
+/** The namespace of the components this extension ships. */
+export declare const NAMESPACE = "chronicles";
+/** The service they run in, which is also the one consumer of the events the log is kept of. */
+export declare const SERVICE = "relay";
+/** The component that publishes the rows: of events, of facts `send` tasks it with, of encounters. */
+export declare const RELAY = "relay";
+/** The exchange of the broker the rows are published to, under the key of their table. */
+export declare const EXCHANGE = "chronicles";
+/** The component clients send encounters through, which documents them. */
+export declare const ENCOUNTERS = "encounters";
+/** The component the log is read through. */
+export declare const QUERIES = "queries";
+/** The stores Toa provides. */
+export declare const PROVIDERS: readonly ['clickhouse'];

package/transpiled/extensions.chronicles/const.js

@@ -0,0 +1,26 @@
+/** What the service is given of the annotation, as JSON, and what its secrets are named after. */
+export const SETTINGS = 'TOA_CHRONICLES';
+/** The secret of the broker the rows are published to, and of the store they are read from. */
+export const SECRET = 'toa-chronicles';
+/** Its keys: the users of the broker and of the store. */
+export const KEYS = [
+    'broker_username',
+    'broker_password',
+    'store_username',
+    'store_password'
+];
+/** The namespace of the components this extension ships. */
+export const NAMESPACE = 'chronicles';
+/** The service they run in, which is also the one consumer of the events the log is kept of. */
+export const SERVICE = 'relay';
+/** The component that publishes the rows: of events, of facts `send` tasks it with, of encounters. */
+export const RELAY = 'relay';
+/** The exchange of the broker the rows are published to, under the key of their table. */
+export const EXCHANGE = 'chronicles';
+/** The component clients send encounters through, which documents them. */
+export const ENCOUNTERS = 'encounters';
+/** The component the log is read through. */
+export const QUERIES = 'queries';
+/** The stores Toa provides. */
+export const PROVIDERS = ['clickhouse'];
+//# sourceMappingURL=const.js.map

package/transpiled/extensions.chronicles/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../source/extensions.chronicles/const.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAA;AAExC,+FAA+F;AAC/F,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAA;AAEtC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;CACjB,CAAA;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAA;AAErC,gGAAgG;AAChG,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA;AAE9B,sGAAsG;AACtG,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAAA;AAE5B,0FAA0F;AAC1F,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAA;AAEpC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAA;AAEtC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAA;AAEhC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,YAAY,CAAU,CAAA"}

package/transpiled/extensions.chronicles/context.d.ts

@@ -0,0 +1,3 @@
+import type { Contribution } from '@toa.io/core/types';
+/** What this extension puts on the context of a component that declares it. */
+export declare function context(): Contribution[];

package/transpiled/extensions.chronicles/context.js

@@ -0,0 +1,11 @@
+/** What this extension puts on the context of a component that declares it. */
+export function context() {
+    return [
+        {
+            name: 'chronicles',
+            type: 'Chronicles',
+            imports: { '@toa.io/extensions.chronicles': ['Chronicles'] }
+        }
+    ];
+}
+//# sourceMappingURL=context.js.map

package/transpiled/extensions.chronicles/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../source/extensions.chronicles/context.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,UAAU,OAAO;IACrB,OAAO;QACL;YACE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,EAAE,+BAA+B,EAAE,CAAC,YAAY,CAAC,EAAE;SAC7D;KACF,CAAA;AACH,CAAC"}

package/transpiled/extensions.chronicles/contract.d.ts

@@ -0,0 +1,7 @@
+import type { Contract } from './types.ts';
+/**
+ * Refuses a contract a store could not read in types of its own: every property is one of the
+ * types the log has, described at every depth, and named so a store can name a column after it.
+ * `where` says whose contract it is, for the message.
+ */
+export declare function check(contract: Contract, where: string): void;

package/transpiled/extensions.chronicles/contract.js

@@ -0,0 +1,69 @@
+/**
+ * Refuses a contract a store could not read in types of its own: every property is one of the
+ * types the log has, described at every depth, and named so a store can name a column after it.
+ * `where` says whose contract it is, for the message.
+ */
+export function check(contract, where) {
+    for (const [name, property] of Object.entries(contract.properties)) {
+        if (OWN.has(name))
+            throw new Error(`Chronicles declare '${where}.${name}', which is a column of the row: the payload's '${name}' is read before the contract, and is not declared.`);
+        named(name, `${where}.${name}`);
+        inspect(property, `${where}.${name}`, true);
+    }
+}
+/** A name a store can name a column after, which it then need not quote. */
+function named(name, path) {
+    if (!NAME.test(name))
+        throw new Error(`Chronicles declare '${path}': a property is named by letters, digits and underscores from a letter or an underscore.`);
+}
+function inspect(property, path, described) {
+    if (typeof property !== 'object' || property === null || Array.isArray(property))
+        throw new Error(`Chronicles declare '${path}', which is not a schema of a property.`);
+    const schema = property;
+    for (const key of Object.keys(schema))
+        if (!KEYS.has(key))
+            throw new Error(`Chronicles declare '${path}' with '${key}', which the log has no type for.`);
+    if (described && (typeof schema.description !== 'string' || schema.description === ''))
+        throw new Error(`Chronicles declare '${path}' with no description.`);
+    const type = schema.type;
+    if (typeof type !== 'string' || !TYPES.has(type))
+        throw new Error(`Chronicles declare '${path}' of the type '${JSON.stringify(type)}', which is not one of ${[...TYPES].join(', ')}.`);
+    if (schema.enum !== undefined && (type !== 'string' || !strings(schema.enum)))
+        throw new Error(`Chronicles declare '${path}' with an enum that is not of strings.`);
+    if (schema.format !== undefined &&
+        (typeof schema.format !== 'string' || !SCALARS.has(type)))
+        throw new Error(`Chronicles declare '${path}' with a format the type has none of.`);
+    if (type === 'object') {
+        const properties = schema.properties;
+        if (typeof properties !== 'object' ||
+            properties === null ||
+            Array.isArray(properties))
+            throw new Error(`Chronicles declare the object '${path}' with no properties.`);
+        for (const [key, nested] of Object.entries(properties)) {
+            named(key, `${path}.${key}`);
+            inspect(nested, `${path}.${key}`, true);
+        }
+    }
+    else if (schema.properties !== undefined)
+        throw new Error(`Chronicles declare '${path}' with properties, which is not an object.`);
+    if (type === 'array') {
+        if (schema.items === undefined)
+            throw new Error(`Chronicles declare the array '${path}' with no items.`);
+        // what the array is of is told by the array's description
+        inspect(schema.items, `${path}[]`, false);
+    }
+    else if (schema.items !== undefined)
+        throw new Error(`Chronicles declare '${path}' with items, which is not an array.`);
+}
+function strings(values) {
+    return (Array.isArray(values) &&
+        values.length > 0 &&
+        values.every((value) => typeof value === 'string'));
+}
+const SCALARS = new Set(['string', 'integer', 'number', 'boolean']);
+const TYPES = new Set([...SCALARS, 'object', 'array']);
+const KEYS = new Set(['type', 'description', 'enum', 'format', 'properties', 'items']);
+const NAME = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+/** What a row of the log says of itself: columns of its own, beside the payload. */
+const OWN = new Set(['id', 'time', 'received', 'entity', 'version', 'identity', 'trace']);
+//# sourceMappingURL=contract.js.map

package/transpiled/extensions.chronicles/contract.js.map

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

package/transpiled/extensions.chronicles/deployment.d.ts

@@ -0,0 +1,12 @@
+import type { Annotation } from './types.ts';
+import type { context } from '@toa.io/norm';
+import type { Dependency } from '@toa.io/operations';
+/**
+ * The events the components declare are consumed, so they are published, and the service consumes
+ * them: it is given which they are and their contracts, the contracts of the facts, the store, and
+ * the store's credentials, which nothing else is.
+ * Where the events travel is the context's `amqp`, as it is for any receiver.
+ */
+export declare function deployment(instances: context.Dependency[], annotation: Annotation | undefined): Dependency;
+/** The extension is deployed for the sake of the annotation, which a component need not name. */
+export declare const standalone = true;

package/transpiled/extensions.chronicles/deployment.js

@@ -0,0 +1,84 @@
+import { components } from './components.js';
+import { version } from '../version.js';
+import { KEYS, NAMESPACE, SECRET, SERVICE, SETTINGS } from './const.js';
+import * as schemas from './schemas.js';
+/**
+ * The events the components declare are consumed, so they are published, and the service consumes
+ * them: it is given which they are and their contracts, the contracts of the facts, the store, and
+ * the store's credentials, which nothing else is.
+ * Where the events travel is the context's `amqp`, as it is for any receiver.
+ */
+export function deployment(instances, annotation) {
+    // the components the extension ships are among the instances, and declare nothing to keep
+    const declaring = instances.filter((instance) => instance.locator.namespace !== NAMESPACE);
+    if (annotation === undefined)
+        throw new Error(`Chronicles are declared by '${declaring.map((instance) => instance.locator.id).join("', '")}', ` +
+            "and the context has no 'chronicles' annotation.");
+    schemas.annotation.validate(annotation, 'Invalid chronicles annotation');
+    const events = {};
+    const states = {};
+    const facts = {};
+    const identities = {};
+    const timestamps = {};
+    for (const instance of declaring) {
+        const declaration = instance.manifest ?? NONE;
+        const id = instance.locator.id;
+        for (const [event, contract] of Object.entries(declaration.events))
+            events[`${id}.${event}`] = contract;
+        if (declaration.state !== undefined) {
+            const { event, ...contract } = declaration.state;
+            states[`${id}.${event}`] = contract;
+        }
+        for (const [fact, contract] of Object.entries(declaration.facts))
+            facts[`${id}.${fact}`] = contract;
+        if (declaration.identity !== null)
+            identities[id] = declaration.identity;
+        timestamps[id] = declaration.timestamp;
+    }
+    const settings = {
+        ...read(annotation),
+        events,
+        states,
+        facts,
+        identities,
+        timestamps
+    };
+    const { labels } = components(annotation);
+    const service = {
+        group: NAMESPACE,
+        name: SERVICE,
+        version,
+        components: labels,
+        variables: [{ name: SETTINGS, value: JSON.stringify(settings) }, ...credentials()]
+    };
+    if (annotation.resources !== undefined)
+        service.resources = annotation.resources;
+    // a state's event is consumed as an event's is
+    return {
+        services: [service],
+        events: [...new Set([...Object.keys(events), ...Object.keys(states)])]
+    };
+}
+/** The extension is deployed for the sake of the annotation, which a component need not name. */
+export const standalone = true;
+function read(annotation) {
+    // what is read is the user's own: the address names a server, and no database of it
+    if (new URL(annotation.store.url).pathname.replace(/\//g, '') !== '')
+        throw new Error("The store of chronicles is the address of a server: what is read is its user's.");
+    return {
+        broker: annotation.broker,
+        store: annotation.store,
+        retention: annotation.retention,
+        encounters: annotation.encounters === true,
+        ip: annotation.ip ?? 'truncated'
+    };
+}
+/** The user the store is provisioned as, and the password of the reader it creates. */
+function credentials() {
+    return KEYS.map((key) => ({
+        name: `${SETTINGS}_${key.toUpperCase()}`,
+        secret: { name: SECRET, key }
+    }));
+}
+const NONE = { events: {}, facts: {}, identity: null, timestamp: null };
+//# sourceMappingURL=deployment.js.map

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

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

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

@@ -0,0 +1,7 @@
+export { manifest } from './manifest.ts';
+export { components } from './components.ts';
+export { deployment, standalone } from './deployment.ts';
+export { context } from './context.ts';
+export * from './const.ts';
+export * as schemas from './schemas.ts';
+export type { Address, Annotation, Contract, Declaration, Declared, Property, Settings, State, Store } from './types.ts';

package/transpiled/extensions.chronicles/index.js

@@ -0,0 +1,7 @@
+export { manifest } from './manifest.js';
+export { components } from './components.js';
+export { deployment, standalone } from './deployment.js';
+export { context } from './context.js';
+export * from './const.js';
+export * as schemas from './schemas.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.chronicles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,cAAc,YAAY,CAAA;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

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

@@ -0,0 +1,12 @@
+import type { Declaration, Declared } from './types.ts';
+import type { Manifest } from '@toa.io/norm';
+/**
+ * The `chronicles:` block of a component manifest: the events whose renderings are rows of the
+ * log, the one whose payload is the entity as it stands, and the facts the component sends, each
+ * with the contract of what is written of it. Norm hands over the whole manifest, prototype events
+ * included, so a label is checked here rather than left to fail at boot.
+ *
+ * `chronicles: ~` is a component that logs nothing; it has to produce a value or norm rejects the
+ * extension.
+ */
+export declare function manifest(declared: Declared | undefined, component: Manifest): Declaration;

package/transpiled/extensions.chronicles/manifest.js

@@ -0,0 +1,63 @@
+import * as schemas from './schemas.js';
+import { check } from './contract.js';
+/**
+ * The `chronicles:` block of a component manifest: the events whose renderings are rows of the
+ * log, the one whose payload is the entity as it stands, and the facts the component sends, each
+ * with the contract of what is written of it. Norm hands over the whole manifest, prototype events
+ * included, so a label is checked here rather than left to fail at boot.
+ *
+ * `chronicles: ~` is a component that logs nothing; it has to produce a value or norm rejects the
+ * extension.
+ */
+export function manifest(declared, component) {
+    const declaration = normalize(declared);
+    schemas.declaration.validate(declaration, 'Invalid chronicles declaration');
+    const name = id(component);
+    const events = Object.keys(declaration.events);
+    if (declaration.state !== undefined)
+        events.push(declaration.state.event);
+    for (const event of events)
+        if (component.events?.[event] === undefined)
+            throw new Error(`Chronicles of '${name}' name '${event}', which is not an event of the component.`);
+    for (const [event, contract] of Object.entries(declaration.events))
+        check(contract, `${name}.${event}`);
+    if (declaration.state !== undefined)
+        check(declaration.state, `${name}.${declaration.state.event}`);
+    for (const [fact, contract] of Object.entries(declaration.facts))
+        check(contract, `${name}.${fact}`);
+    // the default may name nothing of the entity, and reads as none where it does not; a property
+    // the component names is one it means to have
+    const named = declared?.identity !== undefined;
+    const properties = component.entity?.properties;
+    if (named &&
+        declaration.identity !== null &&
+        properties !== undefined &&
+        !(declaration.identity in properties))
+        throw new Error(`Chronicles of '${name}' name the identity '${declaration.identity}', ` +
+            'which is not a property of the entity.');
+    return declaration;
+}
+/**
+ * `identity` unless the component names another property, or none with `identity: ~`; `UPDATED`
+ * unless it names another of when a change was made, or none with `timestamp: ~`.
+ */
+function normalize(declared) {
+    if (declared === null || declared === undefined)
+        return { events: {}, facts: {}, identity: IDENTITY, timestamp: TIMESTAMP };
+    return {
+        ...declared,
+        events: declared.events ?? {},
+        facts: declared.facts ?? {},
+        identity: declared.identity === undefined ? IDENTITY : declared.identity,
+        timestamp: declared.timestamp === undefined ? TIMESTAMP : declared.timestamp
+    };
+}
+const IDENTITY = 'identity';
+/** what an entity as it stands says of when it last changed */
+const TIMESTAMP = 'UPDATED';
+function id(component) {
+    return component.namespace === undefined || component.namespace === 'default'
+        ? component.name
+        : `${component.namespace}.${component.name}`;
+}
+//# sourceMappingURL=manifest.js.map