@solarisdk/e2b-compat 0.0.0-stage → 0.1.0

package/dist/errors.js

@@ -0,0 +1,159 @@
+// E2B-shaped error hierarchy (names and parent classes follow e2b 2.59 `errors.d.ts`), plus translation from
+// Solari SDK errors. Anything Solari cannot do raises SolariCompatUnsupported (a SandboxError) naming the feature.
+import { ActionError, ConnectionError, GatewayError, SolariError, TimeoutError as SolariTimeoutError } from "@solarisdk/core";
+export class SandboxError extends Error {
+    constructor(message, opts) {
+        super(message);
+        this.name = new.target.name;
+        if (opts?.cause !== undefined)
+            this.cause = opts.cause;
+    }
+}
+export class TimeoutError extends SandboxError {
+}
+export class InvalidArgumentError extends SandboxError {
+}
+export class NotEnoughSpaceError extends SandboxError {
+}
+export class NotFoundError extends SandboxError {
+}
+export class FileNotFoundError extends NotFoundError {
+}
+export class SandboxNotFoundError extends NotFoundError {
+}
+export class SandboxNotRunningError extends TimeoutError {
+}
+export class SandboxUnreachableError extends TimeoutError {
+}
+export class AuthenticationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class GitAuthError extends AuthenticationError {
+}
+export class GitUpstreamError extends SandboxError {
+}
+export class TemplateError extends SandboxError {
+}
+export class RateLimitError extends SandboxError {
+}
+export class ServiceBusyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class BuildError extends Error {
+    constructor(message, opts) {
+        super(message);
+        this.name = new.target.name;
+        if (opts?.cause !== undefined)
+            this.cause = opts.cause;
+    }
+}
+export class FileUploadError extends BuildError {
+}
+export class VolumeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class VolumeNotFoundError extends VolumeError {
+}
+export class VolumePathNotFoundError extends VolumeError {
+}
+export class SecretError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class SecretNotFoundError extends SecretError {
+}
+/** A command exited non-zero. `commands.run` throws this (E2B semantics); `result.exitCode` etc. are on the error. */
+export class CommandExitError extends SandboxError {
+    result;
+    constructor(result) {
+        super(result.error || `Command exited with code ${result.exitCode}`);
+        this.result = result;
+        this.name = "CommandExitError";
+    }
+    get exitCode() {
+        return this.result.exitCode;
+    }
+    get error() {
+        return this.result.error;
+    }
+    get stdout() {
+        return this.result.stdout;
+    }
+    get stderr() {
+        return this.result.stderr;
+    }
+}
+/** The feature has no Solari equivalent (see COMPAT.md). Never a silent no-op. */
+export class SolariCompatUnsupported extends SandboxError {
+    feature;
+    constructor(feature, detail) {
+        super(`${feature} is not supported by @solarisdk/e2b-compat${detail ? `: ${detail}` : ""}. See COMPAT.md.`);
+        this.feature = feature;
+    }
+}
+/** A namespace whose every method throws {@link SolariCompatUnsupported}. */
+export function unsupportedNamespace(feature) {
+    return new Proxy({}, {
+        get: (_t, prop) => {
+            if (prop === "then" || typeof prop === "symbol")
+                return undefined;
+            return () => {
+                throw new SolariCompatUnsupported(`${feature}.${String(prop)}`);
+            };
+        },
+    });
+}
+const NOT_FOUND_RE = /no such file|not exist|not found|enoent/i;
+/** Map a Solari error onto the E2B class a caller would catch. `what` says what was being looked up. */
+export function translateError(err, what = "other") {
+    if (err instanceof SandboxError || err instanceof AuthenticationError)
+        return err;
+    if (err instanceof GatewayError) {
+        const msg = err.message;
+        if (err.status === 401 || err.status === 403)
+            return new AuthenticationError(msg);
+        if (err.status === 404)
+            return what === "sandbox" ? new SandboxNotFoundError(msg, { cause: err }) : what === "file" ? new FileNotFoundError(msg, { cause: err }) : new NotFoundError(msg, { cause: err });
+        if (err.status === 429)
+            return new RateLimitError(msg, { cause: err });
+        if (err.status === 400 || err.status === 422)
+            return new InvalidArgumentError(msg, { cause: err });
+        if (err.status === 503)
+            return new ServiceBusyError(msg);
+        return new SandboxError(msg, { cause: err });
+    }
+    if (err instanceof SolariTimeoutError)
+        return new TimeoutError(err.message, { cause: err });
+    if (err instanceof ConnectionError)
+        return new SandboxUnreachableError(err.message, { cause: err });
+    if (err instanceof ActionError) {
+        if (NOT_FOUND_RE.test(err.message))
+            return what === "file" ? new FileNotFoundError(err.message, { cause: err }) : new NotFoundError(err.message, { cause: err });
+        return new SandboxError(err.message, { cause: err });
+    }
+    if (err instanceof SolariError)
+        return new SandboxError(err.message, { cause: err });
+    if (err?.name === "AbortError")
+        return new TimeoutError(err.message, { cause: err });
+    return err;
+}
+export async function translating(fn, what = "other") {
+    try {
+        return await fn();
+    }
+    catch (e) {
+        throw translateError(e, what);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/filesystem.d.ts

@@ -0,0 +1,99 @@
+import type { Box } from "./box.js";
+export declare enum FileType {
+    FILE = "file",
+    DIR = "dir",
+    SYMLINK = "symlink"
+}
+export declare enum FilesystemEventType {
+    CHMOD = "chmod",
+    CREATE = "create",
+    REMOVE = "remove",
+    RENAME = "rename",
+    WRITE = "write"
+}
+export interface WriteInfo {
+    name: string;
+    type?: FileType;
+    path: string;
+    metadata?: Record<string, string>;
+}
+export interface EntryInfo extends WriteInfo {
+    size: number;
+    mode: number;
+    permissions: string;
+    owner: string;
+    group: string;
+    modifiedTime?: Date;
+    symlinkTarget?: string;
+}
+export interface FilesystemEvent {
+    name: string;
+    type: FilesystemEventType;
+    entry?: EntryInfo;
+}
+export type WriteData = string | ArrayBuffer | Blob | ReadableStream;
+export type WriteEntry = {
+    path: string;
+    data: WriteData;
+};
+export interface FilesystemRequestOpts {
+    requestTimeoutMs?: number;
+    signal?: AbortSignal;
+    user?: string;
+}
+export interface FilesystemWriteOpts extends FilesystemRequestOpts {
+    gzip?: boolean;
+    useOctetStream?: boolean;
+    metadata?: Record<string, string>;
+}
+export interface FilesystemReadOpts extends FilesystemRequestOpts {
+    gzip?: boolean;
+    streamIdleTimeoutMs?: number;
+}
+export interface FilesystemListOpts extends FilesystemRequestOpts {
+    depth?: number;
+}
+export interface WatchOpts extends FilesystemRequestOpts {
+    timeoutMs?: number;
+    onExit?: (err?: Error) => void | Promise<void>;
+    recursive?: boolean;
+    includeEntry?: boolean;
+    allowNetworkMounts?: boolean;
+}
+export declare class WatchHandle {
+    private readonly unwatch;
+    private stopped;
+    /** @internal */
+    constructor(unwatch: () => Promise<void>);
+    stop(): Promise<void>;
+}
+export declare class Filesystem {
+    private readonly box;
+    /** @internal */
+    constructor(box: Box);
+    read(path: string, opts?: FilesystemReadOpts & {
+        format?: "text";
+    }): Promise<string>;
+    read(path: string, opts: FilesystemReadOpts & {
+        format: "bytes";
+    }): Promise<Uint8Array>;
+    read(path: string, opts: FilesystemReadOpts & {
+        format: "blob";
+    }): Promise<Blob>;
+    read(path: string, opts: FilesystemReadOpts & {
+        format: "stream";
+    }): Promise<ReadableStream<Uint8Array>>;
+    write(path: string, data: WriteData, opts?: FilesystemWriteOpts): Promise<WriteInfo>;
+    write(files: WriteEntry[], opts?: FilesystemWriteOpts): Promise<WriteInfo[]>;
+    writeFiles(files: WriteEntry[], opts?: FilesystemWriteOpts): Promise<WriteInfo[]>;
+    private writeOne;
+    list(path: string, opts?: FilesystemListOpts): Promise<EntryInfo[]>;
+    getInfo(path: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>;
+    private info;
+    exists(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+    makeDir(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
+    rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>;
+    remove(path: string, opts?: FilesystemRequestOpts): Promise<void>;
+    watchDir(path: string, onEvent: (event: FilesystemEvent) => void | Promise<void>, opts?: WatchOpts): Promise<WatchHandle>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

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

package/dist/filesystem.js

@@ -0,0 +1,245 @@
+// E2B `sandbox.files`. Relative paths resolve against the guest's $HOME (E2B resolves against the user's home).
+// Solari's listing carries name/dir/size; mode and mtime come from a stat per entry; owner and group are not exposed.
+import { FileNotFoundError, InvalidArgumentError, SolariCompatUnsupported, translateError } from "./errors.js";
+export var FileType;
+(function (FileType) {
+    FileType["FILE"] = "file";
+    FileType["DIR"] = "dir";
+    FileType["SYMLINK"] = "symlink";
+})(FileType || (FileType = {}));
+export var FilesystemEventType;
+(function (FilesystemEventType) {
+    FilesystemEventType["CHMOD"] = "chmod";
+    FilesystemEventType["CREATE"] = "create";
+    FilesystemEventType["REMOVE"] = "remove";
+    FilesystemEventType["RENAME"] = "rename";
+    FilesystemEventType["WRITE"] = "write";
+})(FilesystemEventType || (FilesystemEventType = {}));
+export class WatchHandle {
+    unwatch;
+    stopped = false;
+    /** @internal */
+    constructor(unwatch) {
+        this.unwatch = unwatch;
+    }
+    async stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        await this.unwatch();
+    }
+}
+function permissionString(mode, dir) {
+    const bits = "rwxrwxrwx";
+    let s = dir ? "d" : "-";
+    for (let i = 0; i < 9; i++)
+        s += mode & (1 << (8 - i)) ? bits[i] : "-";
+    return s;
+}
+function dirname(p) {
+    const i = p.lastIndexOf("/");
+    return i <= 0 ? "/" : p.slice(0, i);
+}
+const baseName = (p) => p.slice(p.lastIndexOf("/") + 1);
+async function toBytes(data) {
+    if (typeof data === "string")
+        return new TextEncoder().encode(data);
+    if (data instanceof ArrayBuffer)
+        return new Uint8Array(data);
+    if (typeof Blob !== "undefined" && data instanceof Blob)
+        return new Uint8Array(await data.arrayBuffer());
+    if (data && typeof data.getReader === "function") {
+        const reader = data.getReader();
+        const chunks = [];
+        let n = 0;
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            const chunk = typeof value === "string" ? new TextEncoder().encode(value) : value;
+            chunks.push(chunk);
+            n += chunk.length;
+        }
+        const out = new Uint8Array(n);
+        let o = 0;
+        for (const c of chunks) {
+            out.set(c, o);
+            o += c.length;
+        }
+        return out;
+    }
+    throw new InvalidArgumentError("Unsupported data type for write: use string, ArrayBuffer, Blob or ReadableStream");
+}
+function rejectUnsupported(opts, what) {
+    if (opts.user)
+        throw new SolariCompatUnsupported(`${what} user`, "Solari runs file operations as the sandbox's default user");
+}
+export class Filesystem {
+    box;
+    /** @internal */
+    constructor(box) {
+        this.box = box;
+    }
+    async read(path, opts = {}) {
+        rejectUnsupported(opts, "files.read");
+        const abs = await this.box.abs(path);
+        const bytes = await this.box.on((sb) => sb.files.read(abs), "file");
+        switch (opts.format ?? "text") {
+            case "bytes":
+                return bytes;
+            case "blob":
+                return new Blob([bytes]);
+            case "stream":
+                return new ReadableStream({
+                    start(c) {
+                        c.enqueue(bytes);
+                        c.close();
+                    },
+                });
+            default:
+                return new TextDecoder().decode(bytes);
+        }
+    }
+    async write(pathOrFiles, dataOrOpts, maybeOpts) {
+        if (typeof pathOrFiles !== "string")
+            return this.writeFiles(pathOrFiles, dataOrOpts);
+        const opts = maybeOpts ?? {};
+        return this.writeOne(pathOrFiles, dataOrOpts, opts);
+    }
+    async writeFiles(files, opts = {}) {
+        const out = [];
+        for (const f of files)
+            out.push(await this.writeOne(f.path, f.data, opts));
+        return out;
+    }
+    async writeOne(path, data, opts) {
+        rejectUnsupported(opts, "files.write");
+        if (opts.metadata && Object.keys(opts.metadata).length > 0)
+            throw new SolariCompatUnsupported("files.write metadata", "file extended attributes are not stored");
+        const abs = await this.box.abs(path);
+        const bytes = await toBytes(data);
+        // E2B creates missing parent directories.
+        await this.box.on((sb) => sb.files.mkdir(dirname(abs)).catch(() => undefined));
+        await this.box.on((sb) => sb.files.write(abs, bytes), "file");
+        return { name: baseName(abs), type: FileType.FILE, path: abs };
+    }
+    async list(path, opts = {}) {
+        rejectUnsupported(opts, "files.list");
+        const depth = opts.depth ?? 1;
+        if (depth < 1)
+            throw new InvalidArgumentError("depth should be at least one");
+        const abs = (await this.box.abs(path)).replace(/(?<=.)\/+$/, "");
+        const out = [];
+        const walk = async (dir, left) => {
+            const entries = await this.box.on((sb) => sb.files.list(dir), "file");
+            const infos = await mapLimit(entries, 8, (e) => this.info(`${dir === "/" ? "" : dir}/${e.name}`));
+            out.push(...infos);
+            if (left > 1)
+                for (const i of infos)
+                    if (i.type === FileType.DIR)
+                        await walk(i.path, left - 1);
+        };
+        await walk(abs, depth);
+        return out;
+    }
+    async getInfo(path, opts = {}) {
+        rejectUnsupported(opts, "files.getInfo");
+        return this.info(await this.box.abs(path));
+    }
+    async info(abs) {
+        const st = await this.box.on((sb) => sb.files.stat(abs), "file");
+        const dir = Boolean(st.dir);
+        return {
+            name: st.name || baseName(abs),
+            path: abs,
+            type: dir ? FileType.DIR : FileType.FILE,
+            size: st.size,
+            mode: st.mode & 0o7777,
+            permissions: permissionString(st.mode, dir),
+            owner: "",
+            group: "",
+            modifiedTime: new Date(st.modTimeMs),
+        };
+    }
+    async exists(path, opts = {}) {
+        rejectUnsupported(opts, "files.exists");
+        try {
+            await this.info(await this.box.abs(path));
+            return true;
+        }
+        catch (e) {
+            if (e instanceof FileNotFoundError || e.name === "NotFoundError")
+                return false;
+            // Solari answers a missing path with an action error; E2B's exists() is false for it.
+            if (/no such file|not exist|not found|enoent/i.test(String(e?.message)))
+                return false;
+            throw e;
+        }
+    }
+    async makeDir(path, opts = {}) {
+        rejectUnsupported(opts, "files.makeDir");
+        const abs = await this.box.abs(path);
+        if (await this.exists(abs))
+            return false;
+        await this.box.on((sb) => sb.files.mkdir(abs), "file");
+        return true;
+    }
+    async rename(oldPath, newPath, opts = {}) {
+        rejectUnsupported(opts, "files.rename");
+        const from = await this.box.abs(oldPath);
+        const to = await this.box.abs(newPath);
+        await this.box.on((sb) => sb.files.rename(from, to), "file");
+        return this.info(to);
+    }
+    async remove(path, opts = {}) {
+        rejectUnsupported(opts, "files.remove");
+        const abs = await this.box.abs(path);
+        await this.box.on((sb) => sb.files.remove(abs, true), "file");
+    }
+    async watchDir(path, onEvent, opts = {}) {
+        rejectUnsupported(opts, "files.watchDir");
+        if (opts.includeEntry)
+            throw new SolariCompatUnsupported("files.watchDir includeEntry");
+        const abs = await this.box.abs(path);
+        const base = abs.replace(/\/+$/, "");
+        const unwatch = await this.box.on((sb) => sb.files.watch(abs, (ev) => {
+            const type = Object.values(FilesystemEventType).includes(ev.type) ? ev.type : FilesystemEventType.WRITE;
+            const name = ev.path.startsWith(`${base}/`) ? ev.path.slice(base.length + 1) : ev.path;
+            void Promise.resolve(onEvent({ name, type })).catch(() => undefined);
+        }, Boolean(opts.recursive)));
+        let timer;
+        const handle = new WatchHandle(async () => {
+            if (timer)
+                clearTimeout(timer);
+            await unwatch().catch(() => undefined);
+        });
+        // E2B ends a watch after `timeoutMs` (default 60 s; 0 disables).
+        const timeoutMs = opts.timeoutMs ?? 60_000;
+        if (timeoutMs > 0) {
+            timer = setTimeout(() => {
+                void handle.stop().then(() => opts.onExit?.());
+            }, timeoutMs);
+            timer.unref?.();
+        }
+        return handle;
+    }
+}
+async function mapLimit(items, limit, fn) {
+    const out = new Array(items.length);
+    let i = 0;
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, async () => {
+        for (;;) {
+            const k = i++;
+            if (k >= items.length)
+                return;
+            try {
+                out[k] = await fn(items[k]);
+            }
+            catch (e) {
+                throw translateError(e, "file");
+            }
+        }
+    }));
+    return out;
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,sHAAsH;AAGtH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/G,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,uBAAW,CAAA;IACX,+BAAmB,CAAA;AACrB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AACD,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,sCAAe,CAAA;IACf,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,wCAAiB,CAAA;IACjB,sCAAe,CAAA;AACjB,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B;AAgDD,MAAM,OAAO,WAAW;IAGO;IAFrB,OAAO,GAAG,KAAK,CAAC;IACxB,gBAAgB;IAChB,YAA6B,OAA4B;QAA5B,YAAO,GAAP,OAAO,CAAqB;IAAG,CAAC;IAC7D,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,GAAY;IAClD,MAAM,IAAI,GAAG,WAAW,CAAC;IACzB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AACD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,KAAK,UAAU,OAAO,CAAC,IAAe;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,IAAI,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI;QAAE,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACzG,IAAI,IAAI,IAAI,OAAQ,IAAuB,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACrE,MAAM,MAAM,GAAI,IAAmC,CAAC,SAAS,EAAE,CAAC;QAChE,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,SAAS,CAAC;YACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAoB,CAAC;YAClG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;QACpB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACd,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,IAAI,oBAAoB,CAAC,kFAAkF,CAAC,CAAC;AACrH,CAAC;AAED,SAAS,iBAAiB,CAAC,IAA0D,EAAE,IAAY;IACjG,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,IAAI,OAAO,EAAE,2DAA2D,CAAC,CAAC;AAChI,CAAC;AAED,MAAM,OAAO,UAAU;IAEQ;IAD7B,gBAAgB;IAChB,YAA6B,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAMzC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAA+E,EAAE;QACxG,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACpE,QAAQ,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC9B,KAAK,OAAO;gBACV,OAAO,KAAK,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,IAAI,IAAI,CAAC,CAAC,KAAiB,CAAC,CAAC,CAAC;YACvC,KAAK,QAAQ;gBACX,OAAO,IAAI,cAAc,CAAa;oBACpC,KAAK,CAAC,CAAC;wBACL,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;wBACjB,CAAC,CAAC,KAAK,EAAE,CAAC;oBACZ,CAAC;iBACF,CAAC,CAAC;YACL;gBACE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAID,KAAK,CAAC,KAAK,CAAC,WAAkC,EAAE,UAA4C,EAAE,SAA+B;QAC3H,IAAI,OAAO,WAAW,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,UAA6C,CAAC,CAAC;QACxH,MAAM,IAAI,GAAG,SAAS,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,UAAuB,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAmB,EAAE,OAA4B,EAAE;QAClE,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3E,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAAe,EAAE,IAAyB;QAC7E,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,uBAAuB,CAAC,sBAAsB,EAAE,yCAAyC,CAAC,CAAC;QACjK,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,0CAA0C;QAC1C,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/E,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAA2B,EAAE;QACpD,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,oBAAoB,CAAC,8BAA8B,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACjE,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAE,IAAY,EAAiB,EAAE;YAC9D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YACtE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAClG,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YACnB,IAAI,IAAI,GAAG,CAAC;gBAAE,KAAK,MAAM,CAAC,IAAI,KAAK;oBAAE,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,GAAG;wBAAE,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;QACjG,CAAC,CAAC;QACF,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAA8B,EAAE;QAC1D,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,GAAW;QAC5B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;YACxC,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM;YACtB,WAAW,EAAE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;YAC3C,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC;SACrC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAA8B,EAAE;QACzD,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,iBAAiB,IAAK,CAAuB,CAAC,IAAI,KAAK,eAAe;gBAAE,OAAO,KAAK,CAAC;YACtG,sFAAsF;YACtF,IAAI,0CAA0C,CAAC,IAAI,CAAC,MAAM,CAAE,CAAW,EAAE,OAAO,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YACjG,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAA8B,EAAE;QAC1D,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe,EAAE,OAA8B,EAAE;QAC7E,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAA8B,EAAE;QACzD,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAyD,EAAE,OAAkB,EAAE;QAC1G,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,uBAAuB,CAAC,6BAA6B,CAAC,CAAC;QACxF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CACvC,EAAE,CAAC,KAAK,CAAC,KAAK,CACZ,GAAG,EACH,CAAC,EAAE,EAAE,EAAE;YACL,MAAM,IAAI,GAAI,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,IAA4B,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC;YAC/I,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;YACvF,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC,EACD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CACxB,CACF,CAAC;QACF,IAAI,KAAgD,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YACxC,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,MAAM,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,iEAAiE;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;QAC3C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjD,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,KAAK,UAAU,QAAQ,CAAO,KAAU,EAAE,KAAa,EAAE,EAAwB;IAC/E,MAAM,GAAG,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/D,SAAS,CAAC;YACR,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAC9B,IAAI,CAAC;gBACH,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAM,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { Sandbox } from "./sandbox.js";
+export * from "./errors.js";
+export { DEFAULT_BASE_URL, isSolariBaseUrl, type ConnectionOpts } from "./config.js";
+export * from "./sandbox.js";
+export { Commands, Pty, CommandHandle, CommandInputHandle, type CommandResult, type CommandRequestOpts, type CommandStartOpts, type CommandConnectOpts, type CommandStreamInputOpts, type ProcessInfo, type PtyCreateOpts, type PtyConnectOpts, } from "./commands.js";
+export * from "./filesystem.js";
+export * from "./template.js";
+/** E2B's Volume and Secret APIs have no Solari equivalent yet: every call throws {@link SolariCompatUnsupported}. */
+export declare const Volume: Record<string, (...a: unknown[]) => never>;
+export declare const Secret: Record<string, (...a: unknown[]) => never>;
+/** The `new E2B(opts)` client object is not supported; use the static `Sandbox` / `Template` APIs. */
+export declare class E2B {
+    constructor(_opts?: unknown);
+}
+export { Sandbox };
+export default Sandbox;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACrF,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,GAAG,EACH,aAAa,EACb,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAE9B,qHAAqH;AACrH,eAAO,MAAM,MAAM,4CAAiC,CAAC;AACrD,eAAO,MAAM,MAAM,4CAAiC,CAAC;AACrD,sGAAsG;AACtG,qBAAa,GAAG;gBACF,KAAK,CAAC,EAAE,OAAO;CAG5B;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// @solarisdk/e2b-compat: an E2B-compatible API on Solari Sandbox. Not affiliated with E2B. See README.md, COMPAT.md, NOTICE.
+import { Sandbox } from "./sandbox.js";
+import { SolariCompatUnsupported, unsupportedNamespace } from "./errors.js";
+export * from "./errors.js";
+export { DEFAULT_BASE_URL, isSolariBaseUrl } from "./config.js";
+export * from "./sandbox.js";
+export { Commands, Pty, CommandHandle, CommandInputHandle, } from "./commands.js";
+export * from "./filesystem.js";
+export * from "./template.js";
+/** E2B's Volume and Secret APIs have no Solari equivalent yet: every call throws {@link SolariCompatUnsupported}. */
+export const Volume = unsupportedNamespace("Volume");
+export const Secret = unsupportedNamespace("Secret");
+/** The `new E2B(opts)` client object is not supported; use the static `Sandbox` / `Template` APIs. */
+export class E2B {
+    constructor(_opts) {
+        throw new SolariCompatUnsupported("new E2B(...)", "use Sandbox.create(...) and Template.build(...) with SOLARI_API_KEY");
+    }
+}
+export { Sandbox };
+export default Sandbox;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAE7H,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE5E,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAuB,MAAM,aAAa,CAAC;AACrF,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,GAAG,EACH,aAAa,EACb,kBAAkB,GASnB,MAAM,eAAe,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAE9B,qHAAqH;AACrH,MAAM,CAAC,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AACrD,sGAAsG;AACtG,MAAM,OAAO,GAAG;IACd,YAAY,KAAe;QACzB,MAAM,IAAI,uBAAuB,CAAC,cAAc,EAAE,qEAAqE,CAAC,CAAC;IAC3H,CAAC;CACF;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,eAAe,OAAO,CAAC"}