odelic 0.2.0 → 0.2.2

package/dist/config.d.ts

@@ -0,0 +1,34 @@
+import * as P from './protocol.ts';
+export declare const ALL_NAMES: readonly string[];
+export declare const DEFAULT_IDLE_TIMEOUT = 60;
+/** The JSON stored on disk (snake_case, shared with the Python package). */
+export interface ConfigData {
+    id?: string | null;
+    node?: string | null;
+    idle_timeout?: number | string | null;
+    lights?: Record<string, string>;
+}
+/** Seconds before an idle connection is closed; 0 (or "never"/"keep") = stay connected; null = not set. */
+export declare function parseIdle(value: unknown): number | null;
+export declare function configPath(): string;
+export declare class Config {
+    path: string;
+    id: string | null;
+    node: string | null;
+    idleTimeout: number | null;
+    /** name -> vaddr hex (null prototype: names like "constructor" are plain keys) */
+    lights: Record<string, string>;
+    constructor(data?: ConfigData | null, file?: string | null);
+    static load(file?: string | null): Config;
+    save(): void;
+    /** Effective app ID: override > $ODELIC_ID > config. */
+    appId(override?: string | null): string | null;
+    /** Effective idle timeout: override > $ODELIC_IDLE_TIMEOUT > config > 60 s. 0 = stay connected. */
+    idle(override?: number | string | null): number;
+    nameOf(vaddr: Uint8Array): string | null;
+    /** light name / "all" / vaddr hex / bytes -> 4-byte vaddr */
+    resolve(target: P.VaddrLike | null | undefined): Buffer;
+    setName(name: string, target: P.VaddrLike): void;
+    removeName(name: string): void;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AAEnC,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAA8B,CAAC;AACtE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,2GAA2G;AAC3G,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOvD;AAED,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAMD,qBAAa,MAAM;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,YAAY,IAAI,GAAE,UAAU,GAAG,IAAS,EAAE,IAAI,GAAE,MAAM,GAAG,IAAW,EAQnE;IAED,MAAM,CAAC,IAAI,CAAC,IAAI,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CAS9C;IAED,IAAI,IAAI,IAAI,CAYX;IAED,wDAAwD;IACxD,KAAK,CAAC,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,GAAG,IAAI,CAEnD;IAED,mGAAmG;IACnG,IAAI,CAAC,QAAQ,GAAE,MAAM,GAAG,MAAM,GAAG,IAAW,GAAG,MAAM,CAMpD;IAGD,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAIvC;IAED,6DAA6D;IAC7D,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CActD;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,IAAI,CAI/C;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG7B;CACF"}

package/dist/config.js

@@ -0,0 +1,139 @@
+/**
+ * User configuration: app ID, preferred node, connection mode and light names.
+ *
+ * Stored as JSON at $ODELIC_CONFIG, or $XDG_CONFIG_HOME/odelic/config.json (default ~/.config/odelic/config.json).
+ * The format is shared with the Python package (odelic.py), so both can use the same file:
+ *
+ *     {"id": "12345678", "node": null, "idle_timeout": 60, "lights": {"living": "00000000"}}
+ *
+ * idle_timeout: seconds of inactivity before the BLE link is released (so the phone app can connect);
+ * 0 keeps the link open permanently.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { InputError } from './errors.js';
+import * as P from './protocol.js';
+export const ALL_NAMES = ['all', '*', '全部', 'すべて'];
+export const DEFAULT_IDLE_TIMEOUT = 60;
+const KEEP_WORDS = ['0', 'never', 'none', 'off', 'keep', 'forever'];
+/** Seconds before an idle connection is closed; 0 (or "never"/"keep") = stay connected; null = not set. */
+export function parseIdle(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    if (typeof value === 'string' && KEEP_WORDS.includes(value.trim().toLowerCase()))
+        return 0;
+    const v = typeof value === 'string' ? Number(value.trim()) : Number(value);
+    if (typeof value === 'boolean' || !Number.isFinite(v))
+        throw new InputError(`invalid idle timeout: ${String(value)}`);
+    if (v < 0)
+        throw new InputError('idle timeout must be >= 0');
+    return v;
+}
+export function configPath() {
+    if (process.env.ODELIC_CONFIG)
+        return expandHome(process.env.ODELIC_CONFIG);
+    const base = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
+    return path.join(base, 'odelic', 'config.json');
+}
+function expandHome(p) {
+    return p === '~' || p.startsWith('~/') ? path.join(os.homedir(), p.slice(1)) : p;
+}
+export class Config {
+    path;
+    id;
+    node;
+    idleTimeout;
+    /** name -> vaddr hex (null prototype: names like "constructor" are plain keys) */
+    lights;
+    constructor(data = {}, file = null) {
+        data ??= {};
+        this.path = file ?? configPath();
+        this.id = data.id ?? null;
+        this.node = data.node ?? null;
+        this.lights = Object.create(null);
+        for (const [k, v] of Object.entries(data.lights ?? {}))
+            this.lights[String(k)] = String(v).toLowerCase();
+        this.idleTimeout = parseIdle(data.idle_timeout);
+    }
+    static load(file = null) {
+        const p = file ?? configPath();
+        let data = {};
+        try {
+            data = JSON.parse(fs.readFileSync(p, 'utf8'));
+        }
+        catch (e) {
+            if (e.code !== 'ENOENT')
+                throw e;
+        }
+        return new Config(data, p);
+    }
+    save() {
+        fs.mkdirSync(path.dirname(this.path), { recursive: true });
+        const tmp = this.path.replace(/\.[^./]*$/, '') + '.tmp';
+        const data = { id: this.id, node: this.node, idle_timeout: this.idleTimeout, lights: this.lights };
+        // the ID is the mesh password: keep the file private
+        fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', { encoding: 'utf8', mode: 0o600 });
+        try {
+            fs.chmodSync(tmp, 0o600);
+        }
+        catch {
+            // not supported on this filesystem
+        }
+        fs.renameSync(tmp, this.path);
+    }
+    /** Effective app ID: override > $ODELIC_ID > config. */
+    appId(override = null) {
+        return override || process.env.ODELIC_ID || this.id;
+    }
+    /** Effective idle timeout: override > $ODELIC_IDLE_TIMEOUT > config > 60 s. 0 = stay connected. */
+    idle(override = null) {
+        for (const v of [override, process.env.ODELIC_IDLE_TIMEOUT, this.idleTimeout]) {
+            const parsed = parseIdle(v);
+            if (parsed !== null)
+                return parsed;
+        }
+        return DEFAULT_IDLE_TIMEOUT;
+    }
+    // ------------------------------------------------------------ names
+    nameOf(vaddr) {
+        const hex = Buffer.from(vaddr).toString('hex');
+        for (const [name, v] of Object.entries(this.lights))
+            if (v === hex)
+                return name;
+        return null;
+    }
+    /** light name / "all" / vaddr hex / bytes -> 4-byte vaddr */
+    resolve(target) {
+        if (target === null || target === undefined)
+            return P.BROADCAST;
+        if (target instanceof Uint8Array)
+            return P.vaddr(target);
+        const t = String(target).trim();
+        if (t === '' || ALL_NAMES.includes(t.toLowerCase()))
+            return P.BROADCAST;
+        for (const [name, v] of Object.entries(this.lights)) {
+            if (name.toLowerCase() === t.toLowerCase())
+                return Buffer.from(v, 'hex');
+        }
+        try {
+            return P.vaddr(t);
+        }
+        catch {
+            const known = Object.keys(this.lights).join(', ') || '(none)';
+            throw new InputError(`unknown light ${JSON.stringify(String(target))} (known names: ${known})`);
+        }
+    }
+    setName(name, target) {
+        const v = this.resolve(target);
+        if (v.equals(P.BROADCAST))
+            throw new InputError('cannot name the broadcast address');
+        this.lights[name] = v.toString('hex');
+    }
+    removeName(name) {
+        if (!Object.hasOwn(this.lights, name))
+            throw new InputError(`no light named ${JSON.stringify(name)}`);
+        delete this.lights[name];
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/controller.d.ts

@@ -0,0 +1,95 @@
+import * as P from './protocol.ts';
+import { OdelicMesh } from './client.ts';
+import { Config } from './config.ts';
+/** Where a command goes: a light name from the config, "all", or a vaddr. */
+export type Target = P.VaddrLike;
+export interface ActionResult {
+    ok: true;
+    action: string;
+    target?: string;
+    color?: number;
+    brightness?: number;
+    level?: number;
+    group?: number;
+    index?: number;
+}
+export interface LightInfo {
+    name: string | null;
+    vaddr: string;
+    online: boolean;
+    mac?: string;
+    product?: number;
+    version?: string;
+}
+export type LightStatus = ({
+    name: string | null;
+    online: true;
+} & P.LightStateJSON) | {
+    name: string | null;
+    vaddr: string;
+    online: false;
+};
+export interface ControllerInfo {
+    connected: boolean;
+    node: string | null;
+    mode: 'keep' | 'idle';
+    idle_timeout: number;
+}
+export interface ControllerOptions {
+    /** BLE name / address of the node to connect through (default: config, else strongest node) */
+    node?: string | null;
+    config?: Config | null;
+    /** seconds before an idle link is released; 0 = stay connected; null = $ODELIC_IDLE_TIMEOUT / config / 60 s */
+    idleTimeout?: number | string | null;
+    /** use this mesh connection instead of creating one (mainly for tests) */
+    mesh?: OdelicMesh | null;
+}
+/** Integer from a number or numeric string (like Python's int()); throws InputError otherwise. */
+export declare function toInt(v: unknown, what?: string): number;
+export declare class Controller {
+    readonly config: Config;
+    readonly mesh: OdelicMesh;
+    /** seconds; 0 = keep the link open */
+    readonly idleTimeout: number;
+    private queue;
+    private idle;
+    /** @param appId default: $ODELIC_ID / config file */
+    constructor(appId?: string | null, { node, config, idleTimeout, mesh }?: ControllerOptions);
+    /** Run `fn` after every previously queued operation (a simple mutex). */
+    private locked;
+    private run;
+    private cancelIdle;
+    private armIdle;
+    /** Connect now (otherwise the first command connects). */
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    get connected(): boolean;
+    get keepConnected(): boolean;
+    info(): ControllerInfo;
+    private label;
+    private done;
+    on(target?: Target): Promise<ActionResult>;
+    off(target?: Target): Promise<ActionResult>;
+    /** color 0 (warm) .. 100 (cool), brightness 1..100 % */
+    setLight(target?: Target, color?: number | string, brightness?: number | string): Promise<ActionResult>;
+    nightLight(target?: Target, level?: number | string): Promise<ActionResult>;
+    /** action: "on", "off" or "light" (uses color / brightness) */
+    group(groupId: number | string, action?: string, color?: number | string, brightness?: number | string): Promise<ActionResult>;
+    scene(index: number | string, save?: boolean): Promise<ActionResult>;
+    changeColor(target: Target): Promise<ActionResult>;
+    /** Lights answering a mesh ping, plus named lights that did not answer (online: false). */
+    lights(timeout?: number): Promise<LightInfo[]>;
+    /** State of one light, or of every responding light for "all". */
+    status(target?: Target): Promise<LightStatus | LightStatus[]>;
+    private statusOf;
+    nameLight(name: string, target: Target): {
+        ok: true;
+        name: string;
+        vaddr: string;
+    };
+    forgetName(name: string): {
+        ok: true;
+        removed: string;
+    };
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

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

package/dist/controller.js

@@ -0,0 +1,239 @@
+/**
+ * High-level controller shared by the CLI, the HTTP API and the MCP server.
+ *
+ * - connects lazily, serialises operations and reconnects once if the link dropped
+ * - disconnects after `idleTimeout` seconds without commands, so the phone app can use the mesh again
+ *   (0 = keep the link open)
+ * - accepts light names from the config file ("living"), "all", or a raw vaddr ("00000000")
+ */
+import { InputError, LoginError } from './errors.js';
+import { log } from './log.js';
+import * as P from './protocol.js';
+import { OdelicMesh } from './client.js';
+import { Config } from './config.js';
+/** Integer from a number or numeric string (like Python's int()); throws InputError otherwise. */
+export function toInt(v, what = 'value') {
+    const n = typeof v === 'string' && v.trim() !== '' ? Number(v) : v;
+    if (typeof n !== 'number' || !Number.isFinite(n))
+        throw new InputError(`${what} must be a number (got ${JSON.stringify(v)})`);
+    return Math.trunc(n);
+}
+const clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
+const byVaddr = (a, b) => Buffer.compare(a.vaddr, b.vaddr);
+export class Controller {
+    config;
+    mesh;
+    /** seconds; 0 = keep the link open */
+    idleTimeout;
+    queue = Promise.resolve();
+    idle = null;
+    /** @param appId default: $ODELIC_ID / config file */
+    constructor(appId = null, { node = null, config = null, idleTimeout = null, mesh = null } = {}) {
+        this.config = config ?? Config.load();
+        const aid = this.config.appId(appId);
+        if (!aid && !mesh)
+            throw new InputError('no app ID: pass --id, set ODELIC_ID, or run `odelic setup --id <ID>`');
+        this.mesh = mesh ?? new OdelicMesh(aid, { device: node ?? this.config.node });
+        this.idleTimeout = this.config.idle(idleTimeout);
+    }
+    // ------------------------------------------------------------ connection handling
+    /** Run `fn` after every previously queued operation (a simple mutex). */
+    locked(fn) {
+        const run = this.queue.then(fn);
+        this.queue = run.catch(() => { });
+        return run;
+    }
+    run(fn) {
+        return this.locked(async () => {
+            this.cancelIdle();
+            try {
+                for (let attempt = 0;; attempt++) {
+                    if (!this.mesh.isConnected) {
+                        log.info(`connecting via ${this.mesh.device ?? 'strongest node'}`);
+                        await this.mesh.connect();
+                    }
+                    else if (this.mesh.suspect) {
+                        log.info('session looks stale, resynchronising');
+                        try {
+                            await this.mesh.resync();
+                        }
+                        catch (e) {
+                            log.warning(`resync failed (${e.message}), reconnecting`);
+                            await this.mesh.disconnect();
+                            continue;
+                        }
+                    }
+                    let res;
+                    try {
+                        res = await fn(this.mesh);
+                    }
+                    catch (e) {
+                        // input / login errors are final; anything else may be a dropped link
+                        if (attempt || e instanceof InputError || e instanceof LoginError)
+                            throw e;
+                        log.warning(`request failed (${e.message}), reconnecting`);
+                        await this.mesh.disconnect();
+                        continue;
+                    }
+                    // status() resolves to null on timeout: the session may have
+                    // switched under us (another controller logged in), so make sure
+                    // the link is live and retry once
+                    if (res === null && !attempt) {
+                        log.info('no reply, ensuring the session is live and retrying');
+                        try {
+                            await this.mesh.ensureLive();
+                        }
+                        catch (e) {
+                            log.warning(`ensureLive failed (${e.message})`);
+                        }
+                        continue;
+                    }
+                    return res;
+                }
+            }
+            finally {
+                this.armIdle();
+            }
+        });
+    }
+    cancelIdle() {
+        if (this.idle)
+            clearTimeout(this.idle);
+        this.idle = null;
+    }
+    armIdle() {
+        if (!this.idleTimeout || !this.mesh.isConnected)
+            return;
+        this.idle = setTimeout(() => {
+            this.locked(async () => {
+                this.idle = null;
+                if (this.mesh.isConnected) {
+                    log.info('idle, disconnecting');
+                    await this.mesh.disconnect();
+                }
+            }).catch((e) => log.warning(`idle disconnect failed: ${e.message}`));
+        }, this.idleTimeout * 1000);
+        this.idle.unref();
+    }
+    /** Connect now (otherwise the first command connects). */
+    async connect() {
+        await this.run(async () => { });
+    }
+    async close() {
+        this.cancelIdle();
+        await this.locked(() => this.mesh.disconnect());
+    }
+    get connected() {
+        return this.mesh.isConnected;
+    }
+    get keepConnected() {
+        return !this.idleTimeout;
+    }
+    info() {
+        return { connected: this.connected, node: this.mesh.nodeName, mode: this.keepConnected ? 'keep' : 'idle', idle_timeout: this.idleTimeout };
+    }
+    // ------------------------------------------------------------ helpers
+    label(v) {
+        return v.equals(P.BROADCAST) ? 'all' : (this.config.nameOf(v) ?? v.toString('hex'));
+    }
+    done(action, v, extra = {}) {
+        return { ok: true, action, target: this.label(v), ...extra };
+    }
+    // ------------------------------------------------------------ actions
+    async on(target = 'all') {
+        const v = this.config.resolve(target);
+        await this.run((m) => m.on(v));
+        return this.done('on', v);
+    }
+    async off(target = 'all') {
+        const v = this.config.resolve(target);
+        await this.run((m) => m.off(v));
+        return this.done('off', v);
+    }
+    /** color 0 (warm) .. 100 (cool), brightness 1..100 % */
+    async setLight(target = 'all', color = 50, brightness = 100) {
+        const v = this.config.resolve(target);
+        const c = clamp(toInt(color, 'color'), 0, 100);
+        const b = clamp(toInt(brightness, 'brightness'), 1, 100);
+        await this.run((m) => m.setLight({ color: c, brightness: b, target: v }));
+        return this.done('light', v, { color: c, brightness: b });
+    }
+    async nightLight(target = 'all', level = 0) {
+        const v = this.config.resolve(target);
+        const l = clamp(toInt(level, 'level'), 0, 2);
+        await this.run((m) => m.nightLight(l, v));
+        return this.done('night', v, { level: l });
+    }
+    /** action: "on", "off" or "light" (uses color / brightness) */
+    async group(groupId, action = 'on', color = 50, brightness = 100) {
+        const id = toInt(groupId, 'group id');
+        if (action === 'light') {
+            const c = clamp(toInt(color, 'color'), 0, 100);
+            const b = clamp(toInt(brightness, 'brightness'), 1, 100);
+            await this.run((m) => m.setGroup(id, { color: c, brightness: b }));
+        }
+        else if (action === 'on' || action === 'off') {
+            await this.run((m) => m.setGroup(id, { on: action === 'on' }));
+        }
+        else {
+            throw new InputError('action must be on, off or light');
+        }
+        return { ok: true, action: `group_${action}`, group: id };
+    }
+    async scene(index, save = false) {
+        const i = toInt(index, 'scene index');
+        await this.run((m) => (save ? m.saveScene(i) : m.playScene(i)));
+        return { ok: true, action: save ? 'scene_save' : 'scene_play', index: i };
+    }
+    async changeColor(target) {
+        const v = this.config.resolve(target);
+        await this.run((m) => m.changeColor(v));
+        return this.done('change_color', v);
+    }
+    /** Lights answering a mesh ping, plus named lights that did not answer (online: false). */
+    async lights(timeout = 3) {
+        const devs = await this.run((m) => m.devices(timeout));
+        const out = [];
+        const seen = new Set();
+        for (const d of [...devs].sort(byVaddr)) {
+            const hex = d.vaddr.toString('hex');
+            seen.add(hex);
+            out.push({ name: this.config.nameOf(d.vaddr), vaddr: hex, online: true, mac: d.mac, product: d.product, version: d.version });
+        }
+        for (const [name, v] of Object.entries(this.config.lights)) {
+            if (!seen.has(v))
+                out.push({ name, vaddr: v, online: false });
+        }
+        return out;
+    }
+    /** State of one light, or of every responding light for "all". */
+    async status(target = 'all') {
+        const v = this.config.resolve(target);
+        if (v.equals(P.BROADCAST)) {
+            const devs = await this.run((m) => m.devices());
+            const out = [];
+            for (const d of [...devs].sort(byVaddr))
+                out.push(await this.statusOf(d.vaddr));
+            return out;
+        }
+        return this.statusOf(v);
+    }
+    async statusOf(v) {
+        const st = await this.run((m) => m.status(v));
+        if (st === null)
+            return { name: this.config.nameOf(v), vaddr: v.toString('hex'), online: false };
+        return { name: this.config.nameOf(v), online: true, ...st.toJSON() };
+    }
+    // ------------------------------------------------------------ names (no BLE needed)
+    nameLight(name, target) {
+        this.config.setName(name, target);
+        this.config.save();
+        return { ok: true, name, vaddr: this.config.lights[name] };
+    }
+    forgetName(name) {
+        this.config.removeName(name);
+        this.config.save();
+        return { ok: true, removed: name };
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA8CrC,kGAAkG;AAClG,MAAM,UAAU,KAAK,CAAC,CAAU,EAAE,IAAI,GAAG,OAAO;IAC9C,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,0BAA0B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9H,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACnF,MAAM,OAAO,GAAG,CAAC,CAAW,EAAE,CAAW,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AAE/E,MAAM,OAAO,UAAU;IACZ,MAAM,CAAS;IACf,IAAI,CAAa;IAC1B,sCAAsC;IAC7B,WAAW,CAAS;IACrB,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,IAAI,GAA0B,IAAI,CAAC;IAE3C,qDAAqD;IACrD,YAAY,KAAK,GAAkB,IAAI,EAAE,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,GAAsB,EAAE;QAC9H,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,sEAAsE,CAAC,CAAC;QAChH,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,UAAU,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,mFAAmF;IACnF,yEAAyE;IACjE,MAAM,CAAI,EAAoB;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,GAAG,CAAI,EAAoC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;wBAC3B,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC,CAAC;wBACnE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBAC5B,CAAC;yBAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;wBAC7B,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;wBACjD,IAAI,CAAC;4BACH,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;wBAC3B,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC;4BACX,GAAG,CAAC,OAAO,CAAC,kBAAmB,CAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;4BACrE,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;4BAC7B,SAAS;wBACX,CAAC;oBACH,CAAC;oBACD,IAAI,GAAM,CAAC;oBACX,IAAI,CAAC;wBACH,GAAG,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC5B,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,sEAAsE;wBACtE,IAAI,OAAO,IAAI,CAAC,YAAY,UAAU,IAAI,CAAC,YAAY,UAAU;4BAAE,MAAM,CAAC,CAAC;wBAC3E,GAAG,CAAC,OAAO,CAAC,mBAAoB,CAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;wBACtE,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;wBAC7B,SAAS;oBACX,CAAC;oBACD,6DAA6D;oBAC7D,iEAAiE;oBACjE,kCAAkC;oBAClC,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBAC7B,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;wBAChE,IAAI,CAAC;4BACH,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;wBAC/B,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC;4BACX,GAAG,CAAC,OAAO,CAAC,sBAAuB,CAAW,CAAC,OAAO,GAAG,CAAC,CAAC;wBAC7D,CAAC;wBACD,SAAS;oBACX,CAAC;oBACD,OAAO,GAAG,CAAC;gBACb,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,IAAI;YAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QACxD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;gBACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC1B,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;oBAChC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;IAC/B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7I,CAAC;IAED,uEAAuE;IAC/D,KAAK,CAAC,CAAS;QACrB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,CAAC;IAEO,IAAI,CAAC,MAAc,EAAE,CAAS,EAAE,KAAK,GAA0B,EAAE;QACvE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;IAC/D,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,EAAE,CAAC,MAAM,GAAW,KAAK;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAM,GAAW,KAAK;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAW,KAAK,EAAE,KAAK,GAAoB,EAAE,EAAE,UAAU,GAAoB,GAAG;QACnG,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAM,GAAW,KAAK,EAAE,KAAK,GAAoB,CAAC;QACjE,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,KAAK,CAAC,OAAwB,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAoB,EAAE,EAAE,UAAU,GAAoB,GAAG;QACjH,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YACzD,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAsB,EAAE,IAAI,GAAG,KAAK;QAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,2FAA2F;IAC3F,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACvD,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAChI,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,MAAM,CAAC,MAAM,GAAW,KAAK;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,MAAM,GAAG,GAAkB,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAChF,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,CAAS;QAC9B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACjG,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;IACvE,CAAC;IAED,qFAAqF;IACrF,SAAS,CAAC,IAAY,EAAE,MAAc;QACpC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;CACF"}

package/dist/crypto.d.ts

@@ -0,0 +1,34 @@
+/** AES-128-ECB without padding; `data` must be a multiple of 16 bytes. */
+export declare function aes128(key: Uint8Array, data: Uint8Array, { decrypt }?: {
+    decrypt?: boolean;
+}): Buffer;
+export declare function pkcs7Pad(data: Uint8Array): Buffer;
+export declare function pkcs7Unpad(data: Buffer): Buffer;
+/** Keys for one mesh (HomeID + password) and the per-connection session value. */
+export declare class MeshCrypto {
+    readonly homeid: Buffer;
+    readonly password: Buffer;
+    /** Per-connection value from the login challenge; null until logged in. */
+    session: Buffer | null;
+    private readonly loginKey;
+    private readonly eventKey;
+    /** @param password 4 ASCII characters */
+    constructor(homeid: number, password: string);
+    /** `challenge` = the 16 encrypted bytes following `02 20`. Returns the login packet. */
+    answerChallenge(challenge: Uint8Array): Buffer;
+    /**
+     * Follow a login challenge we did not ask for.
+     *
+     * The node switches to the session value of every new challenge, even when that login is
+     * later refused with status 08. On macOS all processes share one BLE link per peripheral,
+     * so another program logging in through the same link silently invalidates our session
+     * unless we switch too. Returns true if the session changed.
+     */
+    adoptChallenge(challenge: Uint8Array): boolean;
+    private xor;
+    /** `03 <dst4> <ch> <payload>`  ->  `06 <dst4> <ch> <cipher>` */
+    encrypt(packet: Uint8Array): Buffer;
+    /** `06 <src/dst4> <ch> <cipher>`  ->  `03 <...> <payload>`; other packet types pass through. */
+    decrypt(data: Uint8Array): Buffer;
+}
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAiBA,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,OAAe,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAIjH;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,kFAAkF;AAClF,qBAAa,UAAU;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,yCAAyC;IACzC,YAAY,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAiB3C;IAED,wFAAwF;IACxF,eAAe,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAQ7C;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAO7C;IAED,OAAO,CAAC,GAAG;IAIX,gEAAgE;IAChE,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAMlC;IAED,gGAAgG;IAChG,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAOhC;CACF"}