@syncbridge/common 1.1.3 → 2.0.0

package/host-link/multiplexer.js

@@ -0,0 +1,289 @@
+import { Buffer } from 'node:buffer';
+import { EventEmitter } from 'node:events';
+import { Duplex } from 'node:stream';
+/*
+ * A frame: [type: u8][stream id: u32][payload]. The link (a WebSocket's
+ * binary messages) keeps the frames whole and in order.
+ */
+const FrameType = {
+    /** Opens a stream; payload: its meta, JSON */
+    OPEN: 1,
+    DATA: 2,
+    /** Lets the peer send that many more bytes on the stream; payload: u32 */
+    CREDIT: 3,
+    /** The sender writes no more on the stream */
+    END: 4,
+    /** The stream is gone, both ways; payload: why, utf8 */
+    RESET: 5,
+    /** A message of the link itself, on no stream (id 0); payload: JSON */
+    CONTROL: 6,
+};
+const HEADER_SIZE = 5;
+/** A DATA frame's payload at most: big writes are cut */
+const MAX_DATA = 32 * 1024;
+/** Bytes a stream's sender may have sent the receiver has not taken */
+const WINDOW = 256 * 1024;
+/**
+ * Streams over one link: each a Duplex, with its own flow control - a
+ * sender sends no more than its receiver has room for, so a slow stream
+ * holds back itself, not the link or the others.
+ */
+export class Multiplexer extends EventEmitter {
+    options;
+    _streams = new Map();
+    _nextId;
+    _closed = false;
+    constructor(options) {
+        super();
+        this.options = options;
+        this._nextId = options.side === 'console' ? 1 : 2;
+    }
+    get closed() {
+        return this._closed;
+    }
+    /** Opens a stream to the peer, with what it is for */
+    open(meta = {}) {
+        if (this._closed)
+            throw new Error('The link is closed');
+        const id = this._nextId;
+        this._nextId += 2;
+        const stream = new MuxStream(this, id);
+        this._streams.set(id, stream);
+        this._send(FrameType.OPEN, id, Buffer.from(JSON.stringify(meta)));
+        return stream;
+    }
+    /** Sends a message of the link itself */
+    control(message) {
+        if (this._closed)
+            return;
+        this._send(FrameType.CONTROL, 0, Buffer.from(JSON.stringify(message)));
+    }
+    /** Takes a frame the link received */
+    receive(frame) {
+        if (this._closed || frame.length < HEADER_SIZE)
+            return;
+        const type = frame.readUInt8(0);
+        const id = frame.readUInt32BE(1);
+        const payload = frame.subarray(HEADER_SIZE);
+        if (type === FrameType.CONTROL) {
+            const message = parseJson(payload);
+            if (message)
+                this.emit('control', message);
+            return;
+        }
+        if (type === FrameType.OPEN) {
+            if (this._streams.has(id) || id % 2 === this._nextId % 2) {
+                this._send(FrameType.RESET, id, Buffer.from('Bad stream id'));
+                return;
+            }
+            const stream = new MuxStream(this, id);
+            this._streams.set(id, stream);
+            this.emit('stream', stream, parseJson(payload) || {});
+            return;
+        }
+        const stream = this._streams.get(id);
+        if (!stream)
+            return;
+        switch (type) {
+            case FrameType.DATA:
+                stream._receiveData(Buffer.from(payload));
+                break;
+            case FrameType.CREDIT:
+                if (payload.length >= 4)
+                    stream._receiveCredit(payload.readUInt32BE(0));
+                break;
+            case FrameType.END:
+                stream._receiveEnd();
+                break;
+            case FrameType.RESET:
+                stream._receiveReset(payload.toString('utf8'));
+                break;
+        }
+    }
+    /** The link is gone: its streams too */
+    close(reason = 'The link closed') {
+        if (this._closed)
+            return;
+        this._closed = true;
+        for (const stream of [...this._streams.values()])
+            stream._receiveReset(reason);
+        this._streams.clear();
+    }
+    /** @internal */
+    _send(type, id, payload) {
+        if (this._closed)
+            return;
+        const frame = Buffer.allocUnsafe(HEADER_SIZE + (payload?.length || 0));
+        frame.writeUInt8(type, 0);
+        frame.writeUInt32BE(id, 1);
+        if (payload)
+            payload.copy(frame, HEADER_SIZE);
+        this.options.send(frame);
+    }
+    /** @internal */
+    _sendCredit(id, bytes) {
+        const payload = Buffer.allocUnsafe(4);
+        payload.writeUInt32BE(bytes, 0);
+        this._send(FrameType.CREDIT, id, payload);
+    }
+    /** @internal */
+    _sendData(id, data) {
+        this._send(FrameType.DATA, id, data);
+    }
+    /** @internal */
+    _sendEnd(id) {
+        this._send(FrameType.END, id);
+    }
+    /** @internal */
+    _sendReset(id, reason) {
+        this._send(FrameType.RESET, id, Buffer.from(reason));
+    }
+    /** @internal */
+    _forget(id) {
+        this._streams.delete(id);
+    }
+}
+/**
+ * A stream of a Multiplexer. It passes for a socket where a Node HTTP
+ * server or client takes one: it has what they call on a socket.
+ */
+export class MuxStream extends Duplex {
+    _mux;
+    id;
+    /** Bytes it may send: what the peer has room for */
+    _credit = WINDOW;
+    /** Bytes taken in but not yet given back as credit: the reader is slow */
+    _owed = 0;
+    /** A write waiting for credit */
+    _pending;
+    _ended = false;
+    _peerEnded = false;
+    _timeout;
+    _timeoutMs = 0;
+    /** Where it comes from, for a server's request: the link */
+    remoteAddress = 'tunnel';
+    remotePort = 0;
+    constructor(_mux, id) {
+        super({ allowHalfOpen: true });
+        this._mux = _mux;
+        this.id = id;
+    }
+    /* What an HTTP server or client calls on a socket */
+    setTimeout(ms, callback) {
+        this._timeoutMs = ms;
+        if (callback)
+            this.once('timeout', callback);
+        this._touch();
+        return this;
+    }
+    setNoDelay() {
+        return this;
+    }
+    setKeepAlive() {
+        return this;
+    }
+    ref() {
+        return this;
+    }
+    unref() {
+        return this;
+    }
+    address() {
+        return {};
+    }
+    /** @internal */
+    _receiveData(data) {
+        this._touch();
+        if (this.destroyed)
+            return;
+        if (this.push(data))
+            this._mux._sendCredit(this.id, data.length);
+        else
+            this._owed += data.length;
+    }
+    /** @internal */
+    _receiveCredit(bytes) {
+        this._credit += bytes;
+        const pending = this._pending;
+        if (pending) {
+            this._pending = undefined;
+            this._write(pending.data, 'binary', pending.callback);
+        }
+    }
+    /** @internal */
+    _receiveEnd() {
+        this._peerEnded = true;
+        this.push(null);
+        this._settle();
+    }
+    /** @internal */
+    _receiveReset(reason) {
+        this._peerEnded = true;
+        this._ended = true;
+        /* An error to who listens for one: else it is closed, not thrown */
+        this.destroy(this.listenerCount('error') ? new Error(reason) : undefined);
+    }
+    _read() {
+        /* The reader has room again: what it was owed, the peer may send */
+        if (this._owed) {
+            const owed = this._owed;
+            this._owed = 0;
+            this._mux._sendCredit(this.id, owed);
+        }
+    }
+    _write(chunk, _encoding, callback) {
+        this._touch();
+        let data = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        while (data.length) {
+            if (this._credit <= 0) {
+                this._pending = { data, callback };
+                return;
+            }
+            const size = Math.min(data.length, MAX_DATA, this._credit);
+            this._mux._sendData(this.id, data.subarray(0, size));
+            this._credit -= size;
+            data = data.subarray(size);
+        }
+        callback();
+    }
+    _final(callback) {
+        this._ended = true;
+        this._mux._sendEnd(this.id);
+        callback();
+        this._settle();
+    }
+    _destroy(error, callback) {
+        clearTimeout(this._timeout);
+        if (!this._ended || !this._peerEnded)
+            this._mux._sendReset(this.id, error?.message || 'Closed');
+        this._ended = this._peerEnded = true;
+        this._mux._forget(this.id);
+        const pending = this._pending;
+        this._pending = undefined;
+        pending?.callback(error || new Error('Closed'));
+        callback(error);
+    }
+    /** Done both ways: it is let go */
+    _settle() {
+        if (this._ended && this._peerEnded) {
+            clearTimeout(this._timeout);
+            this._mux._forget(this.id);
+        }
+    }
+    /** Activity: the idle timeout starts over */
+    _touch() {
+        clearTimeout(this._timeout);
+        if (this._timeoutMs > 0 && !this.destroyed)
+            this._timeout = setTimeout(() => this.emit('timeout'), this._timeoutMs).unref();
+    }
+}
+function parseJson(payload) {
+    try {
+        const value = JSON.parse(payload.toString('utf8'));
+        return value && typeof value === 'object' ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=multiplexer.js.map

package/host-link/multiplexer.js.map

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

package/host-link/sealed-box.d.ts

@@ -0,0 +1,21 @@
+/** A key pair a host's values are sealed for: its public key told */
+export declare function generateSealKeys(): {
+    publicKey: string;
+    privateKey: string;
+};
+/**
+ * A key pair to seal for drawn from a secret, the same each time: one kept
+ * by none but drawn when needed - Console's own, from the key it is given
+ */
+export declare function sealKeysOf(secret: string): {
+    publicKey: string;
+    privateKey: string;
+};
+/** A public key to seal for, as sent: an X25519 key's SPKI, base64; undefined if not */
+export declare function readSealPublicKey(value: string): Buffer | undefined;
+/** A value sealed for the host whose public key is given */
+export declare function sealFor(publicKey: string, value: string): string;
+/** Whether a value is one sealed */
+export declare const isSealed: (value: string) => boolean;
+/** A sealed value opened, by the private key it was sealed for */
+export declare function openSealed(privateKey: string, sealed: string): string;

package/host-link/sealed-box.js

@@ -0,0 +1,104 @@
+import { createCipheriv, createDecipheriv, createPrivateKey, createPublicKey, diffieHellman, generateKeyPairSync, hkdfSync, randomBytes, } from 'node:crypto';
+/*
+ * A value sealed for one host: only its private key opens it. Its key pair
+ * for this (X25519) is apart from its identity's (Ed25519, signing): made
+ * on the host when it pairs, its public key told to Console. A value is
+ * sealed with a key of its own each time (ephemeral X25519), the shared
+ * secret drawn out by HKDF-SHA256, the value enciphered by AES-256-GCM -
+ * what Console sends a host, its workers' secrets, never plain on the way.
+ */
+/** A sealed value's first part: its kind and version */
+const SEALED_PREFIX = 'sbseal1.';
+const INFO = Buffer.from('syncbridge sealed box v1');
+const SPKI = { format: 'der', type: 'spki' };
+/** A key pair a host's values are sealed for: its public key told */
+export function generateSealKeys() {
+    const { publicKey, privateKey } = generateKeyPairSync('x25519');
+    return {
+        publicKey: publicKey.export(SPKI).toString('base64'),
+        privateKey: privateKey.export({ type: 'pkcs8', format: 'pem' }).toString(),
+    };
+}
+/* An X25519 private key's PKCS#8 DER, but for its 32 bytes */
+const X25519_PKCS8 = Buffer.from('302e020100300506032b656e04220420', 'hex');
+/**
+ * A key pair to seal for drawn from a secret, the same each time: one kept
+ * by none but drawn when needed - Console's own, from the key it is given
+ */
+export function sealKeysOf(secret) {
+    const seed = Buffer.from(hkdfSync('sha256', secret, Buffer.alloc(0), Buffer.from('syncbridge seal key v1'), 32));
+    const privateKey = createPrivateKey({
+        key: Buffer.concat([X25519_PKCS8, seed]),
+        format: 'der',
+        type: 'pkcs8',
+    });
+    return {
+        publicKey: createPublicKey(privateKey).export(SPKI).toString('base64'),
+        privateKey: privateKey.export({ type: 'pkcs8', format: 'pem' }).toString(),
+    };
+}
+/** A public key to seal for, as sent: an X25519 key's SPKI, base64; undefined if not */
+export function readSealPublicKey(value) {
+    try {
+        const der = Buffer.from(String(value), 'base64');
+        const key = createPublicKey({ key: der, ...SPKI });
+        return key.asymmetricKeyType === 'x25519' ? der : undefined;
+    }
+    catch {
+        return;
+    }
+}
+/** The key a sealed value is enciphered with: both public keys bound in */
+function sealKey(shared, ephemeral, recipient) {
+    return Buffer.from(hkdfSync('sha256', shared, Buffer.concat([ephemeral, recipient]), INFO, 32));
+}
+/** A value sealed for the host whose public key is given */
+export function sealFor(publicKey, value) {
+    const recipientDer = readSealPublicKey(publicKey);
+    if (!recipientDer)
+        throw new TypeError('Not a key to seal for');
+    const recipient = createPublicKey({ key: recipientDer, ...SPKI });
+    const ephemeral = generateKeyPairSync('x25519');
+    const ephemeralDer = ephemeral.publicKey.export(SPKI);
+    const key = sealKey(diffieHellman({ privateKey: ephemeral.privateKey, publicKey: recipient }), ephemeralDer, recipientDer);
+    const iv = randomBytes(12);
+    const cipher = createCipheriv('aes-256-gcm', key, iv);
+    const enciphered = Buffer.concat([
+        cipher.update(value, 'utf8'),
+        cipher.final(),
+    ]);
+    return (SEALED_PREFIX +
+        Buffer.concat([
+            Buffer.from([ephemeralDer.length]),
+            ephemeralDer,
+            iv,
+            cipher.getAuthTag(),
+            enciphered,
+        ]).toString('base64'));
+}
+/** Whether a value is one sealed */
+export const isSealed = (value) => value.startsWith(SEALED_PREFIX);
+/** A sealed value opened, by the private key it was sealed for */
+export function openSealed(privateKey, sealed) {
+    if (!isSealed(sealed))
+        throw new TypeError('Not a sealed value');
+    const data = Buffer.from(sealed.slice(SEALED_PREFIX.length), 'base64');
+    const length = data[0];
+    const ephemeralDer = data.subarray(1, 1 + length);
+    const iv = data.subarray(1 + length, 13 + length);
+    const tag = data.subarray(13 + length, 29 + length);
+    const enciphered = data.subarray(29 + length);
+    const own = createPrivateKey(privateKey);
+    const ownDer = createPublicKey(own).export(SPKI);
+    const key = sealKey(diffieHellman({
+        privateKey: own,
+        publicKey: createPublicKey({ key: ephemeralDer, ...SPKI }),
+    }), ephemeralDer, ownDer);
+    const decipher = createDecipheriv('aes-256-gcm', key, iv);
+    decipher.setAuthTag(tag);
+    return Buffer.concat([
+        decipher.update(enciphered),
+        decipher.final(),
+    ]).toString('utf8');
+}
+//# sourceMappingURL=sealed-box.js.map

package/host-link/sealed-box.js.map

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

package/index.d.ts

@@ -1,26 +1,39 @@
+export * from './app-factory.js';
+export * from './classes/app-base.js';
 export * from './classes/base-element.js';
 export * from './classes/component-base.js';
 export * from './classes/console-logger.js';
 export * from './classes/frame-stream.js';
-export * from './classes/processor-base.js';
+export * from './classes/log-channel-writer.js';
 export * from './classes/runnable.js';
 export * from './classes/sb-error.js';
 export * from './classes/stack-executor.js';
 export * from './constants.js';
+export * from './decorators/app.decorator.js';
 export * from './decorators/component.decorator.js';
 export * from './decorators/define-variable.decorator.js';
-export * from './decorators/processor.decorator.js';
+export * from './decorators/log-channel.decorator.js';
+export * from './host-link/host-identity.js';
+export * from './host-link/host-link.js';
+export * from './host-link/host-packages.js';
+export * from './host-link/host-workers.js';
+export * from './host-link/multiplexer.js';
+export * from './host-link/sealed-box.js';
 export * from './interfaces/index.js';
 export * from './models/index.js';
 export * as models from './models/index.js';
 export * from './models-document.js';
-export * from './processor-factory.js';
+export * from './registry/docs-sidebar.js';
 export * from './registry/extension-package.js';
 export * from './registry/extension-registry.js';
+export * from './registry/module-catalog.js';
+export * from './registry/package-docs.js';
 export * from './registry/package-manifest.js';
 export * from './utils/decode-profile.js';
+export { SECRET_PREFIX, secretDecryptor, secretEncryptor, } from './utils/encrypt-helpers.js';
 export * from './utils/materialize-metadata.js';
 export * from './utils/normalize-metadata.js';
 export * from './utils/registry-names.js';
 export * from './utils/type-guards.js';
 export * from './utils/uri-to-id.js';
+export * from './utils/worker-permissions.js';

package/index.js

@@ -1,27 +1,40 @@
+export * from './app-factory.js';
+export * from './classes/app-base.js';
 export * from './classes/base-element.js';
 export * from './classes/component-base.js';
 export * from './classes/console-logger.js';
 export * from './classes/frame-stream.js';
-export * from './classes/processor-base.js';
+export * from './classes/log-channel-writer.js';
 export * from './classes/runnable.js';
 export * from './classes/sb-error.js';
 export * from './classes/stack-executor.js';
 export * from './constants.js';
+export * from './decorators/app.decorator.js';
 export * from './decorators/component.decorator.js';
 export * from './decorators/define-variable.decorator.js';
-export * from './decorators/processor.decorator.js';
+export * from './decorators/log-channel.decorator.js';
+export * from './host-link/host-identity.js';
+export * from './host-link/host-link.js';
+export * from './host-link/host-packages.js';
+export * from './host-link/host-workers.js';
+export * from './host-link/multiplexer.js';
+export * from './host-link/sealed-box.js';
 export * from './interfaces/index.js';
 export * from './models/index.js';
 export * as models from './models/index.js';
 export * from './models-document.js';
-export * from './processor-factory.js';
+export * from './registry/docs-sidebar.js';
 export * from './registry/extension-package.js';
 export * from './registry/extension-registry.js';
+export * from './registry/module-catalog.js';
+export * from './registry/package-docs.js';
 export * from './registry/package-manifest.js';
 export * from './utils/decode-profile.js';
+export { SECRET_PREFIX, secretDecryptor, secretEncryptor, } from './utils/encrypt-helpers.js';
 export * from './utils/materialize-metadata.js';
 export * from './utils/normalize-metadata.js';
 export * from './utils/registry-names.js';
 export * from './utils/type-guards.js';
 export * from './utils/uri-to-id.js';
+export * from './utils/worker-permissions.js';
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}

package/models/enums/enum-source.enum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Where an enum variable's values come from when they depend on the server
+ * it runs on: filled in by SyncBridge as the list is asked for - never at
+ * a module's import, nor when its package is built
+ */
+export declare enum EnumSource {
+    /** The serial ports of the server, by their paths */
+    SerialPorts = "serial-ports",
+    /** The server's IPv4 addresses, its loopback's apart */
+    NetworkAddresses = "network-addresses"
+}

package/models/enums/enum-source.enum.js

@@ -0,0 +1,22 @@
+import { EnumType } from '@opra/common';
+/**
+ * Where an enum variable's values come from when they depend on the server
+ * it runs on: filled in by SyncBridge as the list is asked for - never at
+ * a module's import, nor when its package is built
+ */
+export var EnumSource;
+(function (EnumSource) {
+    /** The serial ports of the server, by their paths */
+    EnumSource["SerialPorts"] = "serial-ports";
+    /** The server's IPv4 addresses, its loopback's apart */
+    EnumSource["NetworkAddresses"] = "network-addresses";
+})(EnumSource || (EnumSource = {}));
+EnumType(EnumSource, {
+    name: 'EnumSource',
+    description: "Where an enum variable's values come from, filled in by SyncBridge as the list is asked for",
+    meanings: {
+        SerialPorts: 'The serial ports of the server, by their paths',
+        NetworkAddresses: "The server's IPv4 addresses, its loopback's apart",
+    },
+});
+//# sourceMappingURL=enum-source.enum.js.map

package/models/enums/enum-source.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-source.enum.js","sourceRoot":"","sources":["../../../src/models/enums/enum-source.enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,qDAAqD;IACrD,0CAA4B,CAAA;IAC5B,wDAAwD;IACxD,oDAAsC,CAAA;AACxC,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,QAAQ,CAAC,UAAU,EAAE;IACnB,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,6FAA6F;IAC/F,QAAQ,EAAE;QACR,WAAW,EAAE,gDAAgD;QAC7D,gBAAgB,EAAE,mDAAmD;KACtE;CACF,CAAC,CAAC"}

package/models/enums/log-channel-kind.d.ts

@@ -0,0 +1,7 @@
+/** How a log channel's records are shown */
+export declare enum LogChannelKind {
+    /** Level and message, as the console */
+    text = "text",
+    /** Direction and raw data, as device communication */
+    transmit = "transmit"
+}

package/models/enums/log-channel-kind.js

@@ -0,0 +1,14 @@
+import { EnumType } from '@opra/common';
+/** How a log channel's records are shown */
+export var LogChannelKind;
+(function (LogChannelKind) {
+    /** Level and message, as the console */
+    LogChannelKind["text"] = "text";
+    /** Direction and raw data, as device communication */
+    LogChannelKind["transmit"] = "transmit";
+})(LogChannelKind || (LogChannelKind = {}));
+EnumType(LogChannelKind, {
+    name: 'LogChannelKind',
+    description: "How a log channel's records are shown",
+});
+//# sourceMappingURL=log-channel-kind.js.map

package/models/enums/log-channel-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-channel-kind.js","sourceRoot":"","sources":["../../../src/models/enums/log-channel-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,4CAA4C;AAC5C,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,wCAAwC;IACxC,+BAAa,CAAA;IACb,sDAAsD;IACtD,uCAAqB,CAAA;AACvB,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAED,QAAQ,CAAC,cAAc,EAAE;IACvB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,uCAAuC;CACrD,CAAC,CAAC"}

package/models/enums/service-status.d.ts

@@ -4,5 +4,9 @@ export declare enum ServiceStatus {
     started = "started",
     unhealthy = "unhealthy",
     stopping = "stopping",
-    invalid = "invalid"
+    invalid = "invalid",
+    /** Its packages are not installed for its configuration; init installs them */
+    needsInit = "needs-init",
+    /** Its packages are being installed */
+    initializing = "initializing"
 }

package/models/enums/service-status.js

@@ -7,6 +7,10 @@ export var ServiceStatus;
     ServiceStatus["unhealthy"] = "unhealthy";
     ServiceStatus["stopping"] = "stopping";
     ServiceStatus["invalid"] = "invalid";
+    /** Its packages are not installed for its configuration; init installs them */
+    ServiceStatus["needsInit"] = "needs-init";
+    /** Its packages are being installed */
+    ServiceStatus["initializing"] = "initializing";
 })(ServiceStatus || (ServiceStatus = {}));
 EnumType(ServiceStatus, {
     name: 'ServiceStatus',

package/models/enums/service-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-status.js","sourceRoot":"","sources":["../../../src/models/enums/service-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;AACrB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAED,QAAQ,CAAC,aAAa,EAAE;IACtB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,uBAAuB;CACrC,CAAC,CAAC"}
+{"version":3,"file":"service-status.js","sourceRoot":"","sources":["../../../src/models/enums/service-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,+EAA+E;IAC/E,yCAAwB,CAAA;IACxB,uCAAuC;IACvC,8CAA6B,CAAA;AAC/B,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB;AAED,QAAQ,CAAC,aAAa,EAAE;IACtB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,uBAAuB;CACrC,CAAC,CAAC"}

package/models/enums/worker-permission.enum.d.ts

@@ -0,0 +1,16 @@
+/**
+ * What of the server a worker reaches beyond its own directory, as an app
+ * or a component declares it needs: its worker given it - its user in the
+ * device's group - and told in the UI. Not declared, none.
+ */
+export declare enum WorkerPermission {
+    /** The serial ports: its user in their group (dialout) */
+    SerialPorts = "serial-ports",
+    /**
+     * Native addons (.node): a module with one - serialport, oracledb - is
+     * outside Node's permission model, so it is given it by name alone
+     */
+    NativeCode = "native-code",
+    /** Starting other programs: outside Node's permission model too */
+    ChildProcesses = "child-processes"
+}