@syncbridge/common 1.1.3 → 2.0.0

package/constants.js

@@ -1,4 +1,4 @@
-export const version = '1.1.3';
+export const version = '2.0.0';
 export const CLASS_METADATA = Symbol.for('CLASS_METADATA');
 export const CLASS_TYPE = Symbol.for('CLASS_TYPE');
 export const VARIABLE_CONTAINER = Symbol.for('VARIABLE_CONTAINER');

package/decorators/app-events.decorator.d.ts

@@ -0,0 +1,5 @@
+import 'reflect-metadata';
+import type { Type } from 'ts-gems';
+import type { AppBase } from '../classes/app-base.js';
+export declare function OnCreateProfile<T extends Type<AppBase>>(): (target: T, propertyKey: string | symbol) => void;
+export declare function OnUpdateProfile<T extends Type<AppBase>>(): (target: T, propertyKey: string | symbol) => void;

package/decorators/{processor-events.decorator.js → app-events.decorator.js}

@@ -19,4 +19,4 @@ export function OnUpdateProfile() {
         });
     };
 }
-//# sourceMappingURL=processor-events.decorator.js.map
+//# sourceMappingURL=app-events.decorator.js.map

package/decorators/app-events.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-events.decorator.js","sourceRoot":"","sources":["../../src/decorators/app-events.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,MAAS,EAAE,WAA4B;QACtD,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE;YACxC,YAAY,EAAE;gBACZ,eAAe,EAAE,WAAW;aAC7B;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,MAAS,EAAE,WAA4B;QACtD,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE;YACxC,YAAY,EAAE;gBACZ,eAAe,EAAE,WAAW;aAC7B;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/decorators/app.decorator.d.ts

@@ -0,0 +1,29 @@
+import 'reflect-metadata';
+import type { DeepPartial, StrictOmit, Type } from 'ts-gems';
+import type { AppBase } from '../classes/app-base.js';
+import { AppMetadata } from '../models/index.js';
+import { UseComponent as _UseComponent } from './use-component.decorator.js';
+export declare function App<T extends AppBase>(options?: App.Options): (target: Type<T>) => void;
+export declare namespace App {
+    /**
+     *
+     */
+    function UseVariables<T extends AppBase>(variablesClass?: Type): (target: T, propertyKey: "values") => void;
+    /**
+     *
+     */
+    function UseComponent<T extends AppBase>(options?: _UseComponent.Options): (target: T, propertyKey: string | symbol) => void;
+    /**
+     *
+     */
+    function OnCreateProfile<T extends AppBase>(): (target: Type<T>, propertyKey: string | symbol) => void;
+    /**
+     *
+     */
+    function OnUpdateProfile<T extends AppBase>(): (target: Type<T>, propertyKey: string | symbol) => void;
+}
+export declare namespace App {
+    type Options = DeepPartial<StrictOmit<AppMetadata, 'uri' | 'classType' | 'className' | 'components' | 'variables' | 'version'>> & {
+        className?: string;
+    };
+}

package/decorators/{processor.decorator.js → app.decorator.js}

@@ -3,28 +3,30 @@ import path from 'node:path';
 import { omit } from '@jsopen/objects';
 import callerCallsite from 'caller-callsite';
 import { CLASS_METADATA, CLASS_TYPE } from '../constants.js';
-import { ProcessorMetadata } from '../models/index.js';
-import { resolvePackageJson } from '../utils/locate-package-json.js';
+import { AppMetadata } from '../models/index.js';
+import { readExtensionManifest } from '../registry/package-manifest.js';
+import { locatePackageJson, resolvePackageJson, } from '../utils/locate-package-json.js';
+import { OnCreateProfile as _OnCreateProfile, OnUpdateProfile as _OnUpdateProfile, } from './app-events.decorator.js';
 import { defineOwnMetadata } from './decorator-helpers.js';
-import { OnCreateProfile as _OnCreateProfile, OnUpdateProfile as _OnUpdateProfile, } from './processor-events.decorator.js';
 import { UseComponent as _UseComponent } from './use-component.decorator.js';
 import { UseVariables as _UseVariables } from './use-variables.decorator.js';
-const NAME_PATTERN = /^([A-Z][A-Za-z0-9_]*)(Processor)?$/;
-export function Processor(options) {
+const NAME_PATTERN = /^([A-Z][A-Za-z0-9_]*)(App)?$/;
+export function App(options) {
     const callerFile = callerCallsite()?.getFileName();
-    const pkgjson = callerFile && resolvePackageJson(path.dirname(callerFile));
+    const pkgDir = callerFile && locatePackageJson(path.dirname(callerFile));
+    const pkgjson = pkgDir && resolvePackageJson(pkgDir);
     if (!pkgjson)
         throw new Error('Could not find package.json');
     return function (target) {
         const classType = Reflect.getMetadata(CLASS_TYPE, target);
-        if (classType && classType !== 'processor')
+        if (classType && classType !== 'app')
             throw new TypeError(`${target.name} already decorated as "${classType}"`);
         /** Determine class name */
         let className = options?.className;
         if (!className) {
             const m = NAME_PATTERN.exec(target.name);
             if (!m)
-                throw new TypeError('Class name must be PascalCase and should contains only letters and numbers. Example: MyProcessor ');
+                throw new TypeError('Class name must be PascalCase and should contains only letters and numbers. Example: MyApp ');
             if (m)
                 className = m[1];
         }
@@ -32,11 +34,11 @@ export function Processor(options) {
         if (!className)
             throw new TypeError('Class name is required');
         /** Determine uri */
-        Reflect.defineMetadata(CLASS_TYPE, 'processor', target);
-        const packageName = pkgjson.syncbridge?.name || pkgjson.name;
+        Reflect.defineMetadata(CLASS_TYPE, 'app', target);
+        const packageName = readExtensionManifest(pkgDir, pkgjson)?.manifest.name || pkgjson.name;
         const uri = packageName + ':' + className;
-        defineOwnMetadata(target, CLASS_METADATA, {
-            classType: 'processor',
+        const metadata = defineOwnMetadata(target, CLASS_METADATA, {
+            classType: 'app',
             uri,
             className,
             displayName: className,
@@ -51,39 +53,43 @@ export function Processor(options) {
                 'version',
             ]),
         });
+        /* What its base reaches, it reaches too */
+        const baseMetadata = Reflect.getMetadata(CLASS_METADATA, Object.getPrototypeOf(target));
+        if (baseMetadata?.permissions?.length)
+            metadata.permissions = Array.from(new Set([...baseMetadata.permissions, ...(metadata.permissions || [])]));
         target.uri = uri;
         target.packageName = packageName;
         target.className = className;
     };
 }
-(function (Processor) {
+(function (App) {
     /**
      *
      */
     function UseVariables(variablesClass) {
         return _UseVariables(variablesClass);
     }
-    Processor.UseVariables = UseVariables;
+    App.UseVariables = UseVariables;
     /**
      *
      */
     function UseComponent(options) {
         return _UseComponent(options);
     }
-    Processor.UseComponent = UseComponent;
+    App.UseComponent = UseComponent;
     /**
      *
      */
     function OnCreateProfile() {
         return _OnCreateProfile();
     }
-    Processor.OnCreateProfile = OnCreateProfile;
+    App.OnCreateProfile = OnCreateProfile;
     /**
      *
      */
     function OnUpdateProfile() {
         return _OnUpdateProfile();
     }
-    Processor.OnUpdateProfile = OnUpdateProfile;
-})(Processor || (Processor = {}));
-//# sourceMappingURL=processor.decorator.js.map
+    App.OnUpdateProfile = OnUpdateProfile;
+})(App || (App = {}));
+//# sourceMappingURL=app.decorator.js.map

package/decorators/app.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.decorator.js","sourceRoot":"","sources":["../../src/decorators/app.decorator.ts"],"names":[],"mappings":"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"}

package/decorators/component.decorator.js

@@ -5,14 +5,16 @@ import callerCallsite from 'caller-callsite';
 import { ComponentBase } from '../classes/component-base.js';
 import { CLASS_METADATA, CLASS_TYPE } from '../constants.js';
 import { ComponentMetadata } from '../models/index.js';
-import { resolvePackageJson } from '../utils/locate-package-json.js';
+import { readExtensionManifest } from '../registry/package-manifest.js';
+import { locatePackageJson, resolvePackageJson, } from '../utils/locate-package-json.js';
 import { defineOwnMetadata } from './decorator-helpers.js';
 import { UseComponent as _UseComponent } from './use-component.decorator.js';
 import { UseVariables as _UseVariables } from './use-variables.decorator.js';
 const NAME_PATTERN = /^([A-Z][A-Za-z0-9_]*?)(Component)?$/;
 export function Component(options) {
     const callerFile = callerCallsite()?.getFileName();
-    const pkgjson = callerFile && resolvePackageJson(path.dirname(callerFile));
+    const pkgDir = callerFile && locatePackageJson(path.dirname(callerFile));
+    const pkgjson = pkgDir && resolvePackageJson(pkgDir);
     if (!pkgjson)
         throw new Error('Could not find package.json');
     return function (target) {
@@ -24,7 +26,7 @@ export function Component(options) {
         if (!className) {
             const m = NAME_PATTERN.exec(target.name);
             if (!m)
-                throw new TypeError('Class name must be PascalCase and should contains only letters and numbers. Example: MyProcessor ');
+                throw new TypeError('Class name must be PascalCase and should contains only letters and numbers. Example: MyApp ');
             if (m)
                 className = m[1];
         }
@@ -33,9 +35,9 @@ export function Component(options) {
             throw new TypeError('Class name is required');
         /** Determine uri */
         Reflect.defineMetadata(CLASS_TYPE, 'component', target);
-        /* As in @Processor: a package published under another name (the npm
+        /* As in @App: a package published under another name (the npm
          * mirror's @sbext/vendor__name) keeps its registry name here */
-        const packageName = pkgjson.syncbridge?.name || pkgjson.name;
+        const packageName = readExtensionManifest(pkgDir, pkgjson)?.manifest.name || pkgjson.name;
         const uri = packageName + ':' + className;
         const metadata = defineOwnMetadata(target, CLASS_METADATA, {
             classType: 'component',
@@ -57,6 +59,12 @@ export function Component(options) {
         const baseMetadata = Reflect.getMetadata(CLASS_METADATA, base);
         if (baseMetadata) {
             metadata.interfaces = Array.from(new Set([...(baseMetadata?.interfaces || []), base.uri]));
+            /* What its base reaches, it reaches too */
+            if (baseMetadata.permissions?.length)
+                metadata.permissions = Array.from(new Set([
+                    ...baseMetadata.permissions,
+                    ...(metadata.permissions || []),
+                ]));
         }
         target.uri = uri;
         target.packageName = packageName;

package/decorators/component.decorator.js.map

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

package/decorators/define-variable.decorator.d.ts

@@ -7,7 +7,12 @@ type TVariable = DeepPartial<VariableMetadataRecord> | Type;
 export declare namespace DefineVariable {
     interface Options extends Partial<StrictOmit<VariableMetadata, 'variables' | 'enumValues' | 'choice'>> {
         variables?: TVariable | Promise<TVariable>;
-        enumValues?: TEnumValue | Promise<TEnumValue>;
+        /**
+         * Values known when the module is written. Ones that depend on the
+         * server - its serial ports, its addresses - are an `enumSource`: a
+         * module computes nothing at its import
+         */
+        enumValues?: TEnumValue;
         choice?: string[] | Promise<string[]>;
         index?: number;
     }

package/decorators/define-variable.decorator.js

@@ -24,13 +24,17 @@ export function DefineVariable(options = {}) {
             metadata.type = VariableType.Nested;
             metadata.variables = Reflect.getMetadata(VARIABLE_CONTAINER, options.variables.prototype);
         }
-        if (metadata.enumValues && !metadata.type) {
+        if ((metadata.enumValues || metadata.enumSource) && !metadata.type) {
             metadata.type = VariableType.Enum;
         }
         if (metadata.type !== VariableType.Enum) {
             delete metadata.enumValues;
+            delete metadata.enumSource;
             delete metadata.enumStrict;
         }
+        /* A server's list: what was seen when it was read, a suggestion */
+        if (metadata.enumSource && metadata.enumStrict === undefined)
+            metadata.enumStrict = false;
         if (!metadata.type) {
             if (designType === String)
                 metadata.type = VariableType.String;

package/decorators/define-variable.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-variable.decorator.js","sourceRoot":"","sources":["../../src/decorators/define-variable.decorator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-variable.decorator.js","sourceRoot":"","sources":["../../src/decorators/define-variable.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,MAAM,UAAU,cAAc,CAAC,UAAkC,EAAE;IACjE,OAAO,UAAU,MAAc,EAAE,WAA4B;QAC3D,qBAAqB;QACrB,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAEvD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3E,IAAI,UAAU,KAAK,KAAK;YAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QAEjD,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAQ,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC;YACrE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;YAC1D,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,QAAQ,GAA2B,KAAK,CAC1C,OAAO,EACP,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,EAC/B;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,KAAK;YACtB,YAAY,EAAE,IAAI;SACnB,CACF,CAAC;QAEF,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC;YACpC,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,WAAW,CACtC,kBAAkB,EAClB,OAAO,CAAC,SAAS,CAAC,SAAS,CAC5B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnE,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QACpC,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC,UAAU,CAAC;YAC3B,OAAO,QAAQ,CAAC,UAAU,CAAC;YAC3B,OAAO,QAAQ,CAAC,UAAU,CAAC;QAC7B,CAAC;QACD,mEAAmE;QACnE,IAAI,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS;YAC1D,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC;QAE9B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,IAAI,UAAU,KAAK,MAAM;gBAAE,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC;iBAC1D,IAAI,UAAU,KAAK,OAAO;gBAAE,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC;iBACjE,IAAI,UAAU,KAAK,MAAM;gBAAE,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC;iBAC/D,IAAI,UAAU,KAAK,MAAM;gBAAE,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC;iBAC/D,IACH,OAAO,UAAU,KAAK,UAAU;gBAChC,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,UAAU,CAAC,SAAS,CAAC,EAC7D,CAAC;gBACD,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC;gBACpC,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,WAAW,CACtC,kBAAkB,EAClB,UAAU,CAAC,SAAS,CACrB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI;YACpC,MAAM,IAAI,SAAS,CACjB,0CAA0C;gBACxC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI;oBACtB,GAAG;oBACH,WAAW;oBACX,uBAAuB,CAAC,CAC7B,CAAC;QACJ,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE3C,MAAM,cAAc,GAA2B,OAAO,CAAC,cAAc,CACnE,kBAAkB,EAClB,MAAM,CACP;YACC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,MAAM,CAAC;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QACpC,cAAc,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC;QACvC,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC"}

package/decorators/log-channel.decorator.d.ts

@@ -0,0 +1,97 @@
+import 'reflect-metadata';
+import type { AppBase } from '../classes/app-base.js';
+import type { ComponentBase } from '../classes/component-base.js';
+import { type LogChannelKind, type LogLevel } from '../models/index.js';
+/**
+ * Defines a log channel of an app or component, assigned to the
+ * decorated property, which is declared `declare readonly` so a class
+ * field does not overwrite it:
+ *
+ * ```ts
+ * @LogChannel({ name: 'communication', kind: 'transmit' })
+ * declare readonly ioLogChannel: LogChannel;
+ * ```
+ *
+ * The channel's name defaults to the property's. Records and settings are
+ * keyed by the name, so a channel whose property may be renamed is given
+ * one. Subclasses inherit the channel.
+ */
+export declare function LogChannel(options?: LogChannel.Options): (target: AppBase | ComponentBase, propertyKey: any) => void;
+/**
+ * A log channel: what a `@LogChannel` property holds
+ */
+export interface LogChannel {
+    /** The name within its element */
+    readonly name: string;
+    /** The element's path and the name: `deviceIo/communication` */
+    readonly fullName: string;
+    readonly kind: LogChannelKind;
+    /** Whether records are written; a disabled channel drops them at once */
+    readonly enabled: boolean;
+    write(record: LogChannel.Record): void;
+    fatal(message: string, fields?: Record<string, any>): void;
+    error(message: string, fields?: Record<string, any>): void;
+    warn(message: string, fields?: Record<string, any>): void;
+    info(message: string, fields?: Record<string, any>): void;
+    verbose(message: string, fields?: Record<string, any>): void;
+    debug(message: string, fields?: Record<string, any>): void;
+    trace(message: string, fields?: Record<string, any>): void;
+}
+export declare namespace LogChannel {
+    interface Options {
+        /** Default: the property's name */
+        name?: string;
+        title?: string;
+        description?: string;
+        /** Default: `text` */
+        kind?: LogChannelKind | `${LogChannelKind}`;
+        /** Default level threshold of a text channel */
+        level?: LogLevel | `${LogLevel}`;
+        /** Default days the records are kept */
+        retentionDays?: number;
+        /** Default: true */
+        enabled?: boolean;
+        /**
+         * The events its records are of, which a profile may pick some of
+         * (settings `events`): `read` and `write` for the data received and
+         * sent, `connect`, `disconnect`, or the element's own
+         */
+        events?: string[];
+    }
+    /** A record written to a channel */
+    interface Record {
+        level?: LogLevel | `${LogLevel}`;
+        message?: string;
+        /** Of a transmit channel: received, sent, or a note */
+        direction?: 'in' | 'out' | 'info';
+        /**
+         * What happened, as a profile picks the records by (settings
+         * `events`): `connect`, `disconnect`, or the element's own. Data
+         * received is `read` and sent `write` without it being given.
+         */
+        event?: string;
+        /**
+         * A short note on the record, shown and searched with it: e.g. the
+         * other side of a transmission, `10.0.0.5:2575`, `/dev/ttyUSB0`
+         */
+        details?: string;
+        /** Raw content */
+        data?: Uint8Array | string;
+        /** Fields of the channel's own */
+        fields?: {
+            [key: string]: any;
+        };
+    }
+    /** A record as a channel hands it on */
+    interface Entry extends Record {
+        /** When it was written: a record's only time */
+        time: Date;
+        /** The path of the element that wrote it; '' for the app */
+        source: string;
+    }
+    /**
+     * Where a worker's channels hand their records: the channel's full name
+     * and the record
+     */
+    type Sink = (channel: string, entry: Entry) => void;
+}

package/decorators/log-channel.decorator.js

@@ -0,0 +1,34 @@
+import 'reflect-metadata';
+import { CLASS_METADATA } from '../constants.js';
+import { LogChannelMetadata, } from '../models/index.js';
+import { defineOwnMetadata } from './decorator-helpers.js';
+/**
+ * Defines a log channel of an app or component, assigned to the
+ * decorated property, which is declared `declare readonly` so a class
+ * field does not overwrite it:
+ *
+ * ```ts
+ * @LogChannel({ name: 'communication', kind: 'transmit' })
+ * declare readonly ioLogChannel: LogChannel;
+ * ```
+ *
+ * The channel's name defaults to the property's. Records and settings are
+ * keyed by the name, so a channel whose property may be renamed is given
+ * one. Subclasses inherit the channel.
+ */
+export function LogChannel(options = {}) {
+    return function (target, propertyKey) {
+        if (typeof propertyKey !== 'string')
+            throw new TypeError('Property key must be a string');
+        const name = options.name || propertyKey;
+        const metadata = defineOwnMetadata(target.constructor, CLASS_METADATA);
+        metadata.logChannels = metadata.logChannels || {};
+        metadata.logChannels[name] = new LogChannelMetadata({
+            ...options,
+            kind: (options.kind || 'text'),
+            name,
+            propertyKey,
+        });
+    };
+}
+//# sourceMappingURL=log-channel.decorator.js.map

package/decorators/log-channel.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-channel.decorator.js","sourceRoot":"","sources":["../../src/decorators/log-channel.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAEL,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,UAA8B,EAAE;IACzD,OAAO,UAAU,MAA+B,EAAE,WAAgB;QAChE,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACzC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvE,QAAQ,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;QAClD,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,kBAAkB,CAAC;YAClD,GAAI,OAAuC;YAC3C,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,MAAM,CAAmB;YAChD,IAAI;YACJ,WAAW;SACZ,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/decorators/use-component.decorator.d.ts

@@ -1,9 +1,9 @@
 import 'reflect-metadata';
 import type { StrictOmit } from 'ts-gems';
+import { AppBase } from '../classes/app-base.js';
 import { ComponentBase } from '../classes/component-base.js';
-import { ProcessorBase } from '../classes/processor-base.js';
 import { ElementComponentMetadata } from '../models/index.js';
-export declare function UseComponent<T extends ProcessorBase | ComponentBase>(options?: UseComponent.Options): (target: T, propertyKey: string | symbol) => void;
+export declare function UseComponent<T extends AppBase | ComponentBase>(options?: UseComponent.Options): (target: T, propertyKey: string | symbol) => void;
 export declare namespace UseComponent {
     interface Options extends Partial<StrictOmit<ElementComponentMetadata, 'classUri' | 'interfaceUri'>> {
         uri?: string;

package/decorators/use-component.decorator.js

@@ -1,7 +1,7 @@
 import 'reflect-metadata';
 import { omit } from '@jsopen/objects';
+import { AppBase } from '../classes/app-base.js';
 import { ComponentBase } from '../classes/component-base.js';
-import { ProcessorBase } from '../classes/processor-base.js';
 import { CLASS_METADATA } from '../constants.js';
 import { ElementComponentMetadata } from '../models/index.js';
 import { defineOwnMetadata } from './decorator-helpers.js';

package/decorators/use-component.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-component.decorator.js","sourceRoot":"","sources":["../../src/decorators/use-component.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,UAAU,YAAY,CAC1B,UAAgC,EAAE;IAElC,OAAO,UAAU,MAAS,EAAE,WAA4B;QACtD,qBAAqB;QACrB,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAEvD,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QAEtB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CACpC,aAAa,EACb,MAAM,EACN,WAAW,CACZ,CAAC;YACF,IAAI,OAAO,UAAU,KAAK,UAAU,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;gBACvD,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;YACvB,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvE,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;QAChD,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG;YACjC,YAAY,EAAE,GAAG;YACjB,GAAG,IAAI,CAAC,OAAc,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YACrD,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"use-component.decorator.js","sourceRoot":"","sources":["../../src/decorators/use-component.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,UAAU,YAAY,CAC1B,UAAgC,EAAE;IAElC,OAAO,UAAU,MAAS,EAAE,WAA4B;QACtD,qBAAqB;QACrB,IAAI,OAAO,WAAW,KAAK,QAAQ;YACjC,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAEvD,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QAEtB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CACpC,aAAa,EACb,MAAM,EACN,WAAW,CACZ,CAAC;YACF,IAAI,OAAO,UAAU,KAAK,UAAU,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;gBACvD,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;YACvB,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACvE,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;QAChD,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG;YACjC,YAAY,EAAE,GAAG;YACjB,GAAG,IAAI,CAAC,OAAc,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YACrD,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/decorators/use-variables.decorator.d.ts

@@ -1,5 +1,5 @@
 import 'reflect-metadata';
 import type { Type } from 'ts-gems';
+import type { AppBase } from '../classes/app-base.js';
 import type { ComponentBase } from '../classes/component-base.js';
-import type { ProcessorBase } from '../classes/processor-base.js';
-export declare function UseVariables<T extends ProcessorBase | ComponentBase>(variablesClass?: Type): (target: T, propertyKey: "values") => void;
+export declare function UseVariables<T extends AppBase | ComponentBase>(variablesClass?: Type): (target: T, propertyKey: "values") => void;

package/host-link/host-identity.d.ts

@@ -0,0 +1,53 @@
+/** Where a host pairs with Console, by a code: on its API's port */
+export declare const HOST_PAIR_PATH = "/hosts/pair";
+/**
+ * The header a host's token for Console's APIs comes in: a bearer token
+ * is a user's, there
+ */
+export declare const HOST_TOKEN_HEADER = "x-sb-host-token";
+/** What a token is for: the link (taken once), or Console's other APIs */
+export type HostTokenAudience = 'link' | 'api';
+/** The longest a token is taken for, by what it is for */
+export declare const HOST_TOKEN_MAX_SECONDS: Record<HostTokenAudience, number>;
+/** What a host's token says: who it is, for what, from when until when */
+export interface HostTokenPayload {
+    /** The host's id */
+    h: string;
+    /** What it is for */
+    a: HostTokenAudience;
+    /** Made at, and ends at: seconds */
+    iat: number;
+    exp: number;
+    /** A word of its own: a link's token is taken once */
+    n: string;
+}
+/** A key pair for a host: its public key told, its private key kept */
+export declare function generateHostKeys(): {
+    publicKey: string;
+    privateKey: string;
+};
+/** A public key, as sent: an Ed25519 key's SPKI, base64; undefined if not */
+export declare function readHostPublicKey(value: string): Buffer | undefined;
+/** A public key's fingerprint, to compare by eye: SHA256:<base64> */
+export declare function hostKeyFingerprint(publicKey: string): string;
+/** A token of the host's, signed with its private key */
+export declare function signHostToken(privateKey: string, input: {
+    hostId: string;
+    audience: HostTokenAudience;
+    seconds?: number;
+}): string;
+/** What a token says, not checked yet: whose it is, to find its key */
+export declare function readHostToken(token: string): HostTokenPayload | undefined;
+/**
+ * What a token says, if it is signed with the host's key, for this, now:
+ * not ended, not made later than now (a minute's clock skew taken), and
+ * not lasting longer than its kind may
+ */
+export declare function verifyHostToken(token: string, publicKey: string, audience: HostTokenAudience): HostTokenPayload | undefined;
+/** A new pairing code: 8 letters, as XXXX-XXXX (40 bits) */
+export declare function generatePairingCode(): string;
+/**
+ * A pairing code as typed, taken as given: upper case, spaces and dashes
+ * left out; undefined if not a code
+ */
+export declare function normalizePairingCode(input: string): string | undefined;