@solarisdk/e2b-compat 0.0.0-stage → 0.1.0

package/dist/commands.js

@@ -0,0 +1,302 @@
+// E2B `sandbox.commands` and `sandbox.pty`. Solari identifies a running command by a string id that lives on the
+// creating control channel, so E2B's numeric `pid`s are process-local handles: list/connect/kill/sendStdin work for
+// commands started by this process (see COMPAT.md).
+import { shellArgs } from "./box.js";
+import { CommandExitError, NotFoundError, SandboxError, SolariCompatUnsupported, TimeoutError, translateError } from "./errors.js";
+const DEFAULT_COMMAND_TIMEOUT_MS = 60_000;
+let nextPid = 1000;
+const procs = new Map();
+function procsOf(id) {
+    let m = procs.get(id);
+    if (!m)
+        procs.set(id, (m = new Map()));
+    return m;
+}
+/** What `commands.run({ background: true })` and `pty.create` return. */
+export class CommandHandle {
+    backend;
+    pty;
+    pid;
+    _stdout = "";
+    _stderr = "";
+    _exit;
+    _error;
+    done;
+    finish;
+    stdoutCbs = [];
+    stderrCbs = [];
+    ptyCbs = [];
+    /** @internal */
+    constructor(pid, backend, pty) {
+        this.backend = backend;
+        this.pty = pty;
+        this.pid = pid;
+        this.done = new Promise((r) => (this.finish = r));
+    }
+    get stdout() {
+        return this._stdout;
+    }
+    get stderr() {
+        return this._stderr;
+    }
+    get exitCode() {
+        return this._exit;
+    }
+    get error() {
+        return this._error;
+    }
+    /** @internal */
+    _data(stream, data) {
+        if (stream === "stdout") {
+            this._stdout += data;
+            for (const cb of this.stdoutCbs)
+                void Promise.resolve(cb(data)).catch(() => undefined);
+        }
+        else {
+            this._stderr += data;
+            for (const cb of this.stderrCbs)
+                void Promise.resolve(cb(data)).catch(() => undefined);
+        }
+    }
+    /** @internal */
+    _ptyData(data) {
+        for (const cb of this.ptyCbs)
+            void Promise.resolve(cb(data)).catch(() => undefined);
+    }
+    /** @internal */
+    _onStdout(cb) {
+        if (cb)
+            this.stdoutCbs.push(cb);
+    }
+    /** @internal */
+    _onStderr(cb) {
+        if (cb)
+            this.stderrCbs.push(cb);
+    }
+    /** @internal */
+    _onPty(cb) {
+        if (cb)
+            this.ptyCbs.push(cb);
+    }
+    /** @internal */
+    _exited(code, error) {
+        if (this._exit !== undefined)
+            return;
+        this._exit = code;
+        this._error = error;
+        this.finish();
+    }
+    /** Wait for the command to end. Throws {@link CommandExitError} on a non-zero exit, as E2B does. */
+    async wait() {
+        await this.done;
+        const result = { exitCode: this._exit ?? 0, stdout: this._stdout, stderr: this._stderr, ...(this._error ? { error: this._error } : {}) };
+        if (result.exitCode !== 0)
+            throw new CommandExitError(result);
+        return result;
+    }
+    /** Stop receiving output; the command keeps running. */
+    async disconnect() {
+        this.stdoutCbs.length = 0;
+        this.stderrCbs.length = 0;
+        this.ptyCbs.length = 0;
+    }
+    /** SIGKILL. `false` when the command already ended. */
+    async kill() {
+        if (this._exit !== undefined)
+            return false;
+        try {
+            await this.backend.kill();
+        }
+        catch (e) {
+            throw translateError(e);
+        }
+        if (this.pty)
+            this._exited(137, "killed");
+        return true;
+    }
+    async sendStdin(data, _opts) {
+        try {
+            await this.backend.stdin(data);
+        }
+        catch (e) {
+            throw translateError(e);
+        }
+    }
+    async closeStdin(_opts) {
+        if (!this.backend.closeStdin)
+            throw new SolariCompatUnsupported("closeStdin", "Solari cannot close a command's stdin; end the program another way (for example a sentinel line)");
+        await this.backend.closeStdin();
+    }
+}
+/** Ordered input stream, built over repeated writes (Solari writes are ordered per command). */
+export class CommandInputHandle {
+    write;
+    closed = false;
+    queue = Promise.resolve();
+    constructor(write) {
+        this.write = write;
+    }
+    send(data) {
+        if (this.closed)
+            return Promise.reject(new SandboxError("The input stream is closed"));
+        this.queue = this.queue.then(() => this.write(data));
+        return this.queue;
+    }
+    async close() {
+        this.closed = true;
+        await this.queue;
+    }
+}
+export class Commands {
+    box;
+    /** @internal */
+    constructor(box) {
+        this.box = box;
+    }
+    get supportsStdinClose() {
+        return false;
+    }
+    async run(cmd, opts = {}) {
+        const handle = await this.start(cmd, opts);
+        if (opts.background)
+            return handle;
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_COMMAND_TIMEOUT_MS;
+        if (timeoutMs > 0) {
+            let timer;
+            const timeout = new Promise((_, rej) => {
+                timer = setTimeout(() => rej(new SandboxError(`Command timed out after ${timeoutMs}ms`)), timeoutMs);
+            });
+            try {
+                return await Promise.race([handle.wait(), timeout]);
+            }
+            catch (e) {
+                if (e instanceof SandboxError && !(e instanceof CommandExitError)) {
+                    await handle.kill().catch(() => undefined);
+                    throw new TimeoutError(e.message);
+                }
+                throw e;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        return handle.wait();
+    }
+    async start(cmd, opts) {
+        const native = await this.box.isNative();
+        const [program, args] = shellArgs(native, cmd);
+        // E2B runs commands from the user's home directory unless told otherwise.
+        const cwd = opts.cwd ? await this.box.abs(opts.cwd) : await this.box.home();
+        const core = await this.box.on((sb) => sb.commands.start(program, {
+            args,
+            cwd,
+            ...(opts.envs ? { env: opts.envs } : {}),
+            ...(opts.user ? { user: opts.user } : {}),
+        }));
+        const pid = nextPid++;
+        const handle = new CommandHandle(pid, { kill: () => core.kill(9), stdin: (d) => core.stdin(d) }, false);
+        handle._onStdout(opts.onStdout);
+        handle._onStderr(opts.onStderr);
+        core.onData((c) => handle._data(c.stream, c.data));
+        const rec = { pid, info: { pid, cmd: program, args, envs: opts.envs ?? {}, cwd }, handle, kind: "cmd", exited: false };
+        procsOf(this.box.id).set(pid, rec);
+        core.wait().then((code) => {
+            rec.exited = true;
+            handle._exited(code);
+        }, (e) => {
+            rec.exited = true;
+            handle._exited(1, e instanceof Error ? e.message : String(e));
+        });
+        return handle;
+    }
+    /** Commands and PTYs this process started on the sandbox that have not ended. */
+    async list(_opts) {
+        return [...procsOf(this.box.id).values()].filter((r) => !r.exited).map((r) => r.info);
+    }
+    async kill(pid, _opts) {
+        const rec = procsOf(this.box.id).get(pid);
+        if (!rec || rec.exited)
+            return false;
+        return rec.handle.kill();
+    }
+    async sendStdin(pid, data, opts) {
+        await this.known(pid).handle.sendStdin(data, opts);
+    }
+    streamInput(pid, _opts) {
+        const rec = this.known(pid);
+        return new CommandInputHandle((d) => rec.handle.sendStdin(d));
+    }
+    async closeStdin(pid, opts) {
+        await this.known(pid).handle.closeStdin(opts);
+    }
+    async connect(pid, opts) {
+        const rec = this.known(pid);
+        rec.handle._onStdout(opts?.onStdout);
+        rec.handle._onStderr(opts?.onStderr);
+        return rec.handle;
+    }
+    known(pid) {
+        const rec = procsOf(this.box.id).get(pid);
+        if (!rec) {
+            throw new NotFoundError(`Process ${pid} not found. Solari can only address commands started by this process (see COMPAT.md).`);
+        }
+        return rec;
+    }
+}
+export class Pty {
+    box;
+    /** @internal */
+    constructor(box) {
+        this.box = box;
+    }
+    async create(opts) {
+        if (opts.user)
+            throw new SolariCompatUnsupported("pty.create user");
+        const core = await this.box.on((sb) => sb.pty.create({ cols: opts.cols, rows: opts.rows, ...(opts.cwd ? { cwd: opts.cwd } : {}), env: { TERM: "xterm-256color", ...(opts.envs ?? {}) } }));
+        const pid = nextPid++;
+        const handle = new CommandHandle(pid, { kill: () => core.kill(), stdin: (d) => core.write(d) }, true);
+        handle._onPty(opts.onData);
+        core.onData((d) => handle._ptyData(d));
+        procsOf(this.box.id).set(pid, { pid, info: { pid, cmd: "pty", args: [], envs: opts.envs ?? {}, ...(opts.cwd ? { cwd: opts.cwd } : {}) }, handle, kind: "pty", exited: false });
+        ptyCores.set(handle, core);
+        return handle;
+    }
+    async connect(pid, opts) {
+        const rec = procsOf(this.box.id).get(pid);
+        if (!rec || rec.kind !== "pty")
+            throw new NotFoundError(`PTY ${pid} not found. Solari can only address PTYs created by this process (see COMPAT.md).`);
+        rec.handle._onPty(opts?.onData);
+        return rec.handle;
+    }
+    async sendInput(pid, data, _opts) {
+        await this.pty(pid).handle.sendStdin(data);
+    }
+    streamInput(pid, _opts) {
+        const rec = this.pty(pid);
+        return new CommandInputHandle((d) => rec.handle.sendStdin(d));
+    }
+    async resize(pid, size, _opts) {
+        const core = ptyCores.get(this.pty(pid).handle);
+        try {
+            await core.resize(size.cols, size.rows);
+        }
+        catch (e) {
+            throw translateError(e);
+        }
+    }
+    async kill(pid, _opts) {
+        const rec = procsOf(this.box.id).get(pid);
+        if (!rec || rec.kind !== "pty" || rec.exited)
+            return false;
+        rec.exited = true;
+        return rec.handle.kill();
+    }
+    pty(pid) {
+        const rec = procsOf(this.box.id).get(pid);
+        if (!rec || rec.kind !== "pty")
+            throw new NotFoundError(`PTY ${pid} not found. Solari can only address PTYs created by this process (see COMPAT.md).`);
+        return rec;
+    }
+}
+const ptyCores = new WeakMap();
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+import { HttpTransport } from "@solarisdk/core";
+import { SandboxClient } from "@solarisdk/sandbox";
+export declare const DEFAULT_BASE_URL = "https://api.getsolari.com";
+/** @internal Whether a base URL may receive a Solari key: https on getsolari.com or a subdomain, or loopback. */
+export declare function isSolariBaseUrl(raw: string): boolean;
+/** The E2B connection options this package reads. Everything else is accepted and ignored. */
+export interface ConnectionOpts {
+    apiKey?: string;
+    domain?: string;
+    apiUrl?: string;
+    requestTimeoutMs?: number;
+    debug?: boolean;
+    headers?: Record<string, string>;
+    apiHeaders?: Record<string, string>;
+    signal?: AbortSignal;
+    retries?: number;
+    validateApiKey?: boolean;
+    logger?: unknown;
+    proxy?: string;
+    httpVersion?: "1.1" | "2";
+}
+/** @internal */
+export interface Conn {
+    readonly apiKey: string;
+    readonly baseUrl: string;
+    readonly solari: SandboxClient;
+    readonly http: HttpTransport;
+    readonly requestTimeoutMs: number | undefined;
+}
+/** @internal Resolve the connection for one call: option, then environment, then default. Cached per key + URL. */
+export declare function resolveConn(opts?: ConnectionOpts): Conn;
+//# 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":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAE5D,iHAAiH;AACjH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWpD;AAUD,8FAA8F;AAC9F,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC;CAC3B;AAED,gBAAgB;AAChB,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAKD,mHAAmH;AACnH,wBAAgB,WAAW,CAAC,IAAI,GAAE,cAAmB,GAAG,IAAI,CA2D3D"}

package/dist/config.js

@@ -0,0 +1,92 @@
+// Connection config. Only a Solari key (slr_…) is ever used or sent. An E2B key (E2B_API_KEY, e2b_…) that a
+// E2B-targeting program already has in its environment is never sent to Solari, and E2B_DOMAIN / E2B_API_URL
+// are only honoured when they point at Solari or loopback.
+import { HttpTransport } from "@solarisdk/core";
+import { SandboxClient } from "@solarisdk/sandbox";
+import { SandboxError, SolariCompatUnsupported } from "./errors.js";
+export const DEFAULT_BASE_URL = "https://api.getsolari.com";
+/** @internal Whether a base URL may receive a Solari key: https on getsolari.com or a subdomain, or loopback. */
+export function isSolariBaseUrl(raw) {
+    let u;
+    try {
+        u = new URL(raw);
+    }
+    catch {
+        return false;
+    }
+    const host = u.hostname.toLowerCase().replace(/\.$/, "");
+    if (u.protocol === "https:" && (host === "getsolari.com" || host.endsWith(".getsolari.com")))
+        return true;
+    const loopback = host === "localhost" || host === "[::1]" || /^127(\.\d{1,3}){3}$/.test(host);
+    return loopback && (u.protocol === "http:" || u.protocol === "https:");
+}
+function describeHost(raw) {
+    try {
+        return new URL(raw).hostname || "unparsable URL";
+    }
+    catch {
+        return "unparsable URL";
+    }
+}
+const env = (k) => (typeof process !== "undefined" ? process.env[k] : undefined) || undefined;
+const cache = new Map();
+/** @internal Resolve the connection for one call: option, then environment, then default. Cached per key + URL. */
+export function resolveConn(opts = {}) {
+    if (opts.headers && Object.keys(opts.headers).length > 0)
+        throw new SolariCompatUnsupported("headers");
+    if (opts.apiHeaders && Object.keys(opts.apiHeaders).length > 0)
+        throw new SolariCompatUnsupported("apiHeaders");
+    if (opts.proxy)
+        throw new SolariCompatUnsupported("proxy");
+    const candidates = [
+        ["the apiKey option", opts.apiKey],
+        ["SOLARI_API_KEY", env("SOLARI_API_KEY")],
+        ["E2B_API_KEY", env("E2B_API_KEY")],
+    ];
+    let key;
+    for (const [source, value] of candidates) {
+        if (!value)
+            continue;
+        if (value.startsWith("slr_")) {
+            key = value;
+            break;
+        }
+        console.warn(`@solarisdk/e2b-compat: ignoring ${source}: it is not a Solari API key (slr_…). It is not sent anywhere.`);
+    }
+    if (!key) {
+        throw new SandboxError("No Solari API key. Set SOLARI_API_KEY, or pass { apiKey: 'slr_live_…' }. An E2B key (E2B_API_KEY) is never sent to Solari and cannot be used here.");
+    }
+    // E2B's own url settings usually point at e2b.dev. Using them blindly would send the user's slr_ key to E2B.
+    const explicit = opts.apiUrl ?? (opts.domain ? `https://api.${opts.domain}` : undefined);
+    const inheritedRaw = env("E2B_API_URL") ?? (env("E2B_DOMAIN") ? `https://api.${env("E2B_DOMAIN")}` : undefined);
+    let base;
+    if (explicit) {
+        if (!isSolariBaseUrl(explicit)) {
+            throw new SandboxError(`Refusing to send a Solari API key to ${describeHost(explicit)}: it does not point at Solari.`);
+        }
+        base = explicit;
+    }
+    let inherited;
+    if (inheritedRaw) {
+        if (isSolariBaseUrl(inheritedRaw))
+            inherited = inheritedRaw;
+        else if (!base && !env("SOLARI_BASE_URL")) {
+            console.warn(`@solarisdk/e2b-compat: ignoring E2B_API_URL/E2B_DOMAIN (${describeHost(inheritedRaw)}): it does not point at Solari, and your Solari API key is never sent anywhere else. Using ${DEFAULT_BASE_URL}.`);
+        }
+    }
+    const baseUrl = (base ?? env("SOLARI_BASE_URL") ?? inherited ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const ck = `${key}\n${baseUrl}`;
+    let c = cache.get(ck);
+    if (!c) {
+        c = {
+            apiKey: key,
+            baseUrl,
+            solari: new SandboxClient({ apiKey: key, baseUrl }),
+            http: new HttpTransport({ apiKey: key, baseUrl }),
+            requestTimeoutMs: undefined,
+        };
+        cache.set(ck, c);
+    }
+    return opts.requestTimeoutMs ? { ...c, requestTimeoutMs: opts.requestTimeoutMs } : c;
+}
+//# 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/errors.d.ts

@@ -0,0 +1,79 @@
+export declare class SandboxError extends Error {
+    constructor(message?: string, opts?: {
+        cause?: unknown;
+    });
+}
+export declare class TimeoutError extends SandboxError {
+}
+export declare class InvalidArgumentError extends SandboxError {
+}
+export declare class NotEnoughSpaceError extends SandboxError {
+}
+export declare class NotFoundError extends SandboxError {
+}
+export declare class FileNotFoundError extends NotFoundError {
+}
+export declare class SandboxNotFoundError extends NotFoundError {
+}
+export declare class SandboxNotRunningError extends TimeoutError {
+}
+export declare class SandboxUnreachableError extends TimeoutError {
+}
+export declare class AuthenticationError extends Error {
+    constructor(message?: string);
+}
+export declare class GitAuthError extends AuthenticationError {
+}
+export declare class GitUpstreamError extends SandboxError {
+}
+export declare class TemplateError extends SandboxError {
+}
+export declare class RateLimitError extends SandboxError {
+}
+export declare class ServiceBusyError extends Error {
+    constructor(message?: string);
+}
+export declare class BuildError extends Error {
+    constructor(message?: string, opts?: {
+        cause?: unknown;
+    });
+}
+export declare class FileUploadError extends BuildError {
+}
+export declare class VolumeError extends Error {
+    constructor(message?: string);
+}
+export declare class VolumeNotFoundError extends VolumeError {
+}
+export declare class VolumePathNotFoundError extends VolumeError {
+}
+export declare class SecretError extends Error {
+    constructor(message?: string);
+}
+export declare class SecretNotFoundError extends SecretError {
+}
+/** A command exited non-zero. `commands.run` throws this (E2B semantics); `result.exitCode` etc. are on the error. */
+export declare class CommandExitError extends SandboxError {
+    private readonly result;
+    constructor(result: {
+        exitCode: number;
+        error?: string;
+        stdout: string;
+        stderr: string;
+    });
+    get exitCode(): number;
+    get error(): string | undefined;
+    get stdout(): string;
+    get stderr(): string;
+}
+/** The feature has no Solari equivalent (see COMPAT.md). Never a silent no-op. */
+export declare class SolariCompatUnsupported extends SandboxError {
+    readonly feature: string;
+    constructor(feature: string, detail?: string);
+}
+/** A namespace whose every method throws {@link SolariCompatUnsupported}. */
+export declare function unsupportedNamespace<T extends object = Record<string, (...a: unknown[]) => never>>(feature: string): T;
+/** Map a Solari error onto the E2B class a caller would catch. `what` says what was being looked up. */
+export declare function translateError(err: unknown, what?: "sandbox" | "file" | "other"): unknown;
+export declare function translating<T>(fn: () => Promise<T>, what?: "sandbox" | "file" | "other"): Promise<T>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAKA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKzD;AACD,qBAAa,YAAa,SAAQ,YAAY;CAAG;AACjD,qBAAa,oBAAqB,SAAQ,YAAY;CAAG;AACzD,qBAAa,mBAAoB,SAAQ,YAAY;CAAG;AACxD,qBAAa,aAAc,SAAQ,YAAY;CAAG;AAClD,qBAAa,iBAAkB,SAAQ,aAAa;CAAG;AACvD,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAC1D,qBAAa,sBAAuB,SAAQ,YAAY;CAAG;AAC3D,qBAAa,uBAAwB,SAAQ,YAAY;CAAG;AAC5D,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,CAAC,EAAE,MAAM;CAI7B;AACD,qBAAa,YAAa,SAAQ,mBAAmB;CAAG;AACxD,qBAAa,gBAAiB,SAAQ,YAAY;CAAG;AACrD,qBAAa,aAAc,SAAQ,YAAY;CAAG;AAClD,qBAAa,cAAe,SAAQ,YAAY;CAAG;AACnD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,CAAC,EAAE,MAAM;CAI7B;AACD,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKzD;AACD,qBAAa,eAAgB,SAAQ,UAAU;CAAG;AAClD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,CAAC,EAAE,MAAM;CAI7B;AACD,qBAAa,mBAAoB,SAAQ,WAAW;CAAG;AACvD,qBAAa,uBAAwB,SAAQ,WAAW;CAAG;AAC3D,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,CAAC,EAAE,MAAM;CAI7B;AACD,qBAAa,mBAAoB,SAAQ,WAAW;CAAG;AAEvD,sHAAsH;AACtH,qBAAa,gBAAiB,SAAQ,YAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAIzG,IAAI,QAAQ,IAAI,MAAM,CAErB;IACD,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAED,kFAAkF;AAClF,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAI7C;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAStH;AAID,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,SAAS,GAAG,MAAM,GAAG,OAAiB,GAAG,OAAO,CAoBlG;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,SAAS,GAAG,MAAM,GAAG,OAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnH"}