@solarisdk/runloop-compat 0.0.0-stage → 0.1.0

package/dist/dockerfile.js

@@ -0,0 +1,338 @@
+// Dockerfile (a practical subset) -> Solari's `CompiledImage` build recipe. Mirrors
+// sdk/python-runloop-compat/solari_runloop/_dockerfile.py, with one deliberate difference: a `FROM <image>` other than
+// ubuntu/debian becomes the gateway's native `compiled.fromImage` (blueprint level 3b) instead of the chroot shim
+// (level 3a): the guest agent chroots exec / fs into the unpacked image, RUN steps run inside it.
+//
+// Supported: FROM (one stage), RUN, ENV, ARG (+ build_args), WORKDIR, ENTRYPOINT, CMD, COPY / ADD (from a build
+// context), LABEL / EXPOSE / MAINTAINER / STOPSIGNAL (ignored), SHELL (sh/bash). Not: multi-stage, USER, VOLUME,
+// HEALTHCHECK, ONBUILD, COPY --from, URL sources.
+import { SolariCompatUnsupported } from "./errors.js";
+import { parseImageRef } from "./image-ref.js";
+const DEBIAN_FAMILY = new Set(["ubuntu", "debian"]);
+const SOLARI_BASES = new Set(["base", "workstation"]);
+/** `build_args` switch that forces native image import even for ubuntu/debian images. */
+export const IMPORT_ARG = "SOLARI_IMPORT";
+export const CONTEXT_DIR = "/tmp/solari-context";
+/** Base64 characters per context chunk: one exec argument must stay far below the kernel's 128 KiB limit. */
+const CHUNK = 60_000;
+/** Join `\` continuations, drop comments and blank lines, split into [INSTRUCTION, rest]. */
+export function logicalLines(text) {
+    const out = [];
+    let buf = "";
+    const flush = (s) => {
+        const t = s.trim();
+        if (!t)
+            return;
+        const sp = t.search(/\s/);
+        out.push(sp < 0 ? [t.toUpperCase(), ""] : [t.slice(0, sp).toUpperCase(), t.slice(sp).trim()]);
+    };
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.replace(/\s+$/, "");
+        if (!buf && (!line.trim() || line.trimStart().startsWith("#")))
+            continue;
+        if (buf && line.trimStart().startsWith("#"))
+            continue;
+        if (line.endsWith("\\")) {
+            buf += line.slice(0, -1) + " ";
+            continue;
+        }
+        buf += line;
+        flush(buf);
+        buf = "";
+    }
+    if (buf.trim())
+        flush(buf);
+    return out;
+}
+/** Docker's default PATH, so `ENV PATH=/opt/x/bin:$PATH` expands to a usable value (an unknown $VAR is ""). */
+export const DEFAULT_PATH = "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin";
+function subst(s, args) {
+    return s.replace(/\$(?:\{([A-Za-z_][A-Za-z0-9_]*)\}|([A-Za-z_][A-Za-z0-9_]*))/g, (_m, a, b) => args[(a ?? b)] ?? "");
+}
+/** POSIX-ish word splitting with single quotes, double quotes and backslashes (enough for ENV / COPY lines). */
+export function shellSplit(s) {
+    const out = [];
+    let cur = "";
+    let has = false;
+    let q = null;
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (q) {
+            if (c === q)
+                q = null;
+            else if (c === "\\" && q === '"' && i + 1 < s.length && '"\\$`'.includes(s[i + 1]))
+                cur += s[++i];
+            else
+                cur += c;
+        }
+        else if (c === "'" || c === '"') {
+            q = c;
+            has = true;
+        }
+        else if (c === "\\" && i + 1 < s.length) {
+            cur += s[++i];
+            has = true;
+        }
+        else if (/\s/.test(c)) {
+            if (has || cur)
+                out.push(cur);
+            cur = "";
+            has = false;
+        }
+        else {
+            cur += c;
+            has = true;
+        }
+    }
+    if (q)
+        throw new SolariCompatUnsupported("unterminated quote in Dockerfile line");
+    if (has || cur)
+        out.push(cur);
+    return out;
+}
+export function shq(s) {
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+function jsonOrShell(rest) {
+    const r = rest.trim();
+    if (r.startsWith("[")) {
+        try {
+            const v = JSON.parse(r);
+            if (Array.isArray(v) && v.every((x) => typeof x === "string"))
+                return v;
+        }
+        catch {
+            /* fall through to shell form */
+        }
+    }
+    return ["/bin/sh", "-c", r];
+}
+function parseEnv(rest) {
+    const first = rest.split(/\s+/, 1)[0] ?? "";
+    if (!first.includes("=")) {
+        const i = rest.search(/\s/);
+        return [[rest.slice(0, i < 0 ? undefined : i), i < 0 ? "" : rest.slice(i).trim().replace(/^"(.*)"$/, "$1")]];
+    }
+    return shellSplit(rest).map((t) => {
+        const i = t.indexOf("=");
+        return [t.slice(0, i), t.slice(i + 1)];
+    });
+}
+function resolveFrom(rest, args) {
+    const tokens = rest.split(/\s+/).filter((t) => t && !t.startsWith("--"));
+    if (tokens.slice(1).some((t) => t.toUpperCase() === "AS"))
+        throw new SolariCompatUnsupported("Multi-stage Dockerfile (FROM ... AS)", "Single-stage builds only.");
+    const image = subst(tokens[0] ?? "", args);
+    if (!image)
+        throw new SolariCompatUnsupported("FROM without an image");
+    if (image === "scratch")
+        throw new SolariCompatUnsupported("FROM scratch");
+    let repo = image.split("@", 1)[0];
+    const last = repo.split("/").at(-1);
+    if (last.includes(":"))
+        repo = repo.slice(0, repo.lastIndexOf(":"));
+    let parts = repo.split("/");
+    if (parts.length > 1 && (parts[0].includes(".") || parts[0].includes(":") || parts[0] === "localhost"))
+        parts = parts.slice(1);
+    if (parts[0] === "library")
+        parts = parts.slice(1);
+    const name = parts.join("/");
+    const force = !["", "0", "false", undefined].includes(args[IMPORT_ARG]);
+    if (SOLARI_BASES.has(name))
+        return { base: name };
+    if (DEBIAN_FAMILY.has(name) && !force)
+        return { base: "base" };
+    const ref = parseImageRef(image);
+    if (!ref.ok)
+        throw new SolariCompatUnsupported(`FROM ${image}`, ref.error);
+    return { fromImage: image };
+}
+const run = (command) => ({ op: "run", command });
+const GLOB_SAFE = /^[A-Za-z0-9_./*?[\]+@%-]+$/;
+/** Steps that unpack the tar.gz build context into CONTEXT_DIR (chunked so no exec argument is huge). */
+export function contextSteps(ctx) {
+    const b64 = Buffer.from(ctx).toString("base64");
+    const steps = [run(`rm -rf ${CONTEXT_DIR} ${CONTEXT_DIR}.b64 && mkdir -p ${CONTEXT_DIR} && : > ${CONTEXT_DIR}.b64`)];
+    for (let i = 0; i < b64.length; i += CHUNK)
+        steps.push(run(`printf %s ${shq(b64.slice(i, i + CHUNK))} >> ${CONTEXT_DIR}.b64`));
+    steps.push(run(`base64 -d < ${CONTEXT_DIR}.b64 | tar -xz -C ${CONTEXT_DIR} && rm -f ${CONTEXT_DIR}.b64`));
+    return steps;
+}
+function posixNormalize(p) {
+    const out = [];
+    for (const c of p.split("/")) {
+        if (!c || c === ".")
+            continue;
+        if (c === "..")
+            out.pop();
+        else
+            out.push(c);
+    }
+    return "/" + out.join("/");
+}
+function copyStep(instr, rest, workdir) {
+    let parts;
+    if (rest.trim().startsWith("[")) {
+        try {
+            parts = JSON.parse(rest);
+        }
+        catch {
+            throw new SolariCompatUnsupported(`${instr} with malformed JSON form`);
+        }
+    }
+    else
+        parts = shellSplit(rest);
+    const flags = parts.filter((p) => p.startsWith("--"));
+    parts = parts.filter((p) => !p.startsWith("--"));
+    for (const f of flags) {
+        if (f.startsWith("--from"))
+            throw new SolariCompatUnsupported(`${instr} --from (multi-stage)`);
+        if (!f.startsWith("--chown=") && !f.startsWith("--chmod="))
+            throw new SolariCompatUnsupported(`${instr} ${f.split("=")[0]}`);
+    }
+    if (parts.length < 2)
+        throw new SolariCompatUnsupported(`${instr} needs at least a source and a destination`);
+    const dest = parts.at(-1);
+    const srcs = parts.slice(0, -1);
+    for (const src of srcs) {
+        if (src.includes("://"))
+            throw new SolariCompatUnsupported(`${instr} from a URL`, "Download with RUN curl instead.");
+        if (src.startsWith("/") || src.split("/").includes("..")) {
+            throw new SolariCompatUnsupported(`${instr} source ${JSON.stringify(src)}`, "Sources must be relative paths inside the build context.");
+        }
+    }
+    let absDest = dest.startsWith("/") ? posixNormalize(dest) : posixNormalize(`${workdir}/${dest}`);
+    const dirDest = dest.endsWith("/") || dest === "." || dest === "./";
+    if (dirDest)
+        absDest = absDest.replace(/\/+$/, "") + "/";
+    const quoted = srcs.map((s) => (GLOB_SAFE.test(s) ? s : shq(s))).join(" ");
+    const qDest = shq(absDest);
+    const unpack = instr === "ADD" && srcs.length === 1 && /\.(tar|tar\.gz|tgz)$/.test(srcs[0]);
+    let body;
+    if (unpack)
+        body = `mkdir -p ${qDest} && tar -xf ${quoted} -C ${qDest}`;
+    // Docker copies a directory source's CONTENTS into the destination (never nests it), and a file source into a
+    // directory destination or onto the destination path. `cp -a src/ dest/` would nest, so directories go through `src/.`.
+    else if (dirDest || srcs.length > 1 || srcs.some((x) => /[*?[]/.test(x))) {
+        body = `mkdir -p ${qDest} && for s in ${quoted}; do if [ -d "$s" ]; then cp -a -- "$s"/. ${qDest}; else cp -a -- "$s" ${qDest}; fi; done`;
+    }
+    else {
+        body = `s=${quoted}; if [ -d "$s" ]; then mkdir -p ${qDest} && cp -a -- "$s"/. ${qDest}; else mkdir -p "$(dirname ${qDest})" && cp -a -- "$s" ${qDest}; fi`;
+    }
+    let post = "";
+    for (const f of flags) {
+        if (f.startsWith("--chown="))
+            post += ` && (chown -R ${shq(f.slice(8))} ${qDest} 2>/dev/null || true)`;
+        else if (f.startsWith("--chmod="))
+            post += ` && chmod -R ${shq(f.slice(8))} ${qDest}`;
+    }
+    return run(`cd ${CONTEXT_DIR} && ${body}${post}`);
+}
+export function compileDockerfile(input) {
+    const warn = input.warn ?? ((m) => console.warn(`@solarisdk/runloop-compat: ${m}`));
+    const steps = [];
+    let base;
+    let fromTemplate = input.base_template ?? input.base_blueprint_name ?? undefined;
+    let fromImage;
+    const args = { PATH: DEFAULT_PATH, ...(input.build_args ?? {}) };
+    const argOnly = { ...(input.build_args ?? {}) };
+    let seenFrom = false;
+    let workdir = "/";
+    let contextLoaded = false;
+    for (const [instr, rest] of logicalLines(input.dockerfile ?? "")) {
+        switch (instr) {
+            case "FROM": {
+                if (seenFrom)
+                    throw new SolariCompatUnsupported("Multi-stage Dockerfile (second FROM)", "Single-stage builds only.");
+                seenFrom = true;
+                const f = resolveFrom(rest, args);
+                if (fromTemplate) {
+                    warn(`base blueprint ${JSON.stringify(fromTemplate)} overrides the Dockerfile FROM`);
+                }
+                else {
+                    base = f.base;
+                    fromImage = f.fromImage;
+                }
+                break;
+            }
+            case "ARG": {
+                const i = rest.indexOf("=");
+                const k = (i < 0 ? rest : rest.slice(0, i)).trim();
+                if (!(k in args))
+                    args[k] = i < 0 ? "" : rest.slice(i + 1).trim().replace(/^"(.*)"$/, "$1");
+                argOnly[k] = args[k];
+                break;
+            }
+            case "ENV":
+                for (const [k, v] of parseEnv(subst(rest, args))) {
+                    args[k] = v;
+                    steps.push({ op: "env", key: k, value: v });
+                }
+                break;
+            case "RUN": {
+                const cmd = rest.startsWith("[") ? JSON.parse(rest).map(shq).join(" ") : withArgs(rest, argOnly);
+                steps.push(run(cmd));
+                break;
+            }
+            case "WORKDIR": {
+                const wd = subst(rest, args);
+                workdir = wd.startsWith("/") ? posixNormalize(wd) : posixNormalize(`${workdir}/${wd}`);
+                steps.push({ op: "workdir", dir: workdir });
+                break;
+            }
+            case "ENTRYPOINT":
+                steps.push({ op: "entrypoint", command: jsonOrShell(subst(rest, args)) });
+                break;
+            case "CMD":
+                steps.push({ op: "cmd", command: jsonOrShell(subst(rest, args)) });
+                break;
+            case "LABEL":
+            case "EXPOSE":
+            case "MAINTAINER":
+            case "STOPSIGNAL":
+                break;
+            case "SHELL":
+                if (!rest.includes("bash") && !rest.includes("sh"))
+                    throw new SolariCompatUnsupported(`SHELL ${rest}`);
+                break;
+            case "COPY":
+            case "ADD":
+                if (!input.context) {
+                    throw new SolariCompatUnsupported(instr, "No build_context was given. Upload one with sdk.storageObject.uploadFromDir(...) and pass build_context: obj.asBuildContext().");
+                }
+                if (!contextLoaded) {
+                    steps.push(...contextSteps(input.context));
+                    contextLoaded = true;
+                }
+                steps.push(copyStep(instr, subst(rest, args), workdir));
+                break;
+            default:
+                throw new SolariCompatUnsupported(instr);
+        }
+    }
+    for (const cmd of input.system_setup_commands ?? [])
+        steps.push(run(cmd));
+    for (const [path, contents] of Object.entries(input.file_mounts ?? {})) {
+        const dest = path.startsWith("/") ? path : posixNormalize(`${workdir}/${path}`);
+        steps.push(run(`mkdir -p "$(dirname ${shq(dest)})" && echo ${Buffer.from(contents).toString("base64")} | base64 -d > ${shq(dest)}`));
+    }
+    if (contextLoaded)
+        steps.push(run(`rm -rf ${CONTEXT_DIR}`));
+    const out = { kind: "sandbox", packages: [], steps, fragment: "", localFiles: [] };
+    if (fromTemplate)
+        out.fromTemplate = fromTemplate;
+    else if (fromImage)
+        out.fromImage = fromImage;
+    else
+        out.base = base ?? "base";
+    return out;
+}
+/** Docker expands ARG in RUN through the shell; ENV became real env steps, so only ARGs need injecting. */
+function withArgs(cmd, args) {
+    const exports = Object.entries(args)
+        .filter(([k]) => /^[A-Za-z_][A-Za-z0-9_]*$/.test(k))
+        .map(([k, v]) => `${k}=${shq(v)}`)
+        .join(" ");
+    return exports ? `export ${exports}; ${cmd}` : cmd;
+}
+//# sourceMappingURL=dockerfile.js.map

package/dist/dockerfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockerfile.js","sourceRoot":"","sources":["../src/dockerfile.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uHAAuH;AACvH,kHAAkH;AAClH,kGAAkG;AAClG,EAAE;AACF,gHAAgH;AAChH,iHAAiH;AACjH,kDAAkD;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAa/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AACtD,yFAAyF;AACzF,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,qBAAqB,CAAC;AACjD,6GAA6G;AAC7G,MAAM,KAAK,GAAG,MAAM,CAAC;AAErB,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACnB,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAAE,SAAS;QACzE,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACtD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,GAAG,IAAI,IAAI,CAAC;QACZ,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,GAAG,GAAG,EAAE,CAAC;IACX,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,MAAM,YAAY,GAAG,8DAA8D,CAAC;AAE3F,SAAS,KAAK,CAAC,CAAS,EAAE,IAA4B;IACpD,OAAO,CAAC,CAAC,OAAO,CAAC,8DAA8D,EAAE,CAAC,EAAE,EAAE,CAAqB,EAAE,CAAqB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAW,CAAC,IAAI,EAAE,CAAC,CAAC;AACzK,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,CAAC,GAAkB,IAAI,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAChB,IAAI,CAAC,EAAE,CAAC;YACN,IAAI,CAAC,KAAK,CAAC;gBAAE,CAAC,GAAG,IAAI,CAAC;iBACjB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;gBAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;gBAC9F,GAAG,IAAI,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAClC,CAAC,GAAG,CAAC,CAAC;YACN,GAAG,GAAG,IAAI,CAAC;QACb,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YAC1C,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACd,GAAG,GAAG,IAAI,CAAC;QACb,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,IAAI,GAAG,IAAI,GAAG;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,GAAG,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,KAAK,CAAC;QACd,CAAC;aAAM,CAAC;YACN,GAAG,IAAI,CAAC,CAAC;YACT,GAAG,GAAG,IAAI,CAAC;QACb,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,uCAAuC,CAAC,CAAC;IAClF,IAAI,GAAG,IAAI,GAAG;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAS;IAC3B,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAY,CAAC;YACnC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;gBAAE,OAAO,CAAa,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAqB,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAOD,SAAS,WAAW,CAAC,IAAY,EAAE,IAA4B;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,sCAAsC,EAAE,2BAA2B,CAAC,CAAC;IAClK,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,uBAAuB,CAAC,uBAAuB,CAAC,CAAC;IACvE,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAC3E,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC;QAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACxE,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClD,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,uBAAuB,CAAC,QAAQ,KAAK,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,OAAe,EAA2B,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACnF,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C,yGAAyG;AACzG,MAAM,UAAU,YAAY,CAAC,GAAe;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,KAAK,GAAmC,CAAC,GAAG,CAAC,UAAU,WAAW,IAAI,WAAW,oBAAoB,WAAW,WAAW,WAAW,MAAM,CAAC,CAAC,CAAC;IACrJ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,WAAW,MAAM,CAAC,CAAC,CAAC;IAC/H,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,WAAW,qBAAqB,WAAW,aAAa,WAAW,MAAM,CAAC,CAAC,CAAC;IAC1G,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,CAAS;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG;YAAE,SAAS;QAC9B,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,EAAE,CAAC;;YACrB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,IAAY,EAAE,OAAe;IAC5D,IAAI,KAAe,CAAC;IACpB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,2BAA2B,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;;QAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,uBAAuB,CAAC,CAAC;QAC/F,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/H,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,4CAA4C,CAAC,CAAC;IAC9G,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,aAAa,EAAE,iCAAiC,CAAC,CAAC;QACrH,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,uBAAuB,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,0DAA0D,CAAC,CAAC;QAC1I,CAAC;IACH,CAAC;IACD,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;IACpE,IAAI,OAAO;QAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;IAC7F,IAAI,IAAY,CAAC;IACjB,IAAI,MAAM;QAAE,IAAI,GAAG,YAAY,KAAK,eAAe,MAAM,OAAO,KAAK,EAAE,CAAC;IACxE,8GAA8G;IAC9G,wHAAwH;SACnH,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,IAAI,GAAG,YAAY,KAAK,gBAAgB,MAAM,6CAA6C,KAAK,wBAAwB,KAAK,YAAY,CAAC;IAC5I,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,KAAK,MAAM,mCAAmC,KAAK,uBAAuB,KAAK,8BAA8B,KAAK,uBAAuB,KAAK,MAAM,CAAC;IAC9J,CAAC;IACD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,IAAI,IAAI,iBAAiB,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAC;aAClG,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,IAAI,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;IACxF,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,WAAW,OAAO,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAeD,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,KAAK,GAAmC,EAAE,CAAC;IACjD,IAAI,IAAwB,CAAC;IAC7B,IAAI,YAAY,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,mBAAmB,IAAI,SAAS,CAAC;IACjF,IAAI,SAA6B,CAAC;IAClC,MAAM,IAAI,GAA2B,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;IACzF,MAAM,OAAO,GAA2B,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;IACxE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,QAAQ;oBAAE,MAAM,IAAI,uBAAuB,CAAC,sCAAsC,EAAE,2BAA2B,CAAC,CAAC;gBACrH,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAClC,IAAI,YAAY,EAAE,CAAC;oBACjB,IAAI,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,gCAAgC,CAAC,CAAC;gBACvF,CAAC;qBAAM,CAAC;oBACN,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;oBACd,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;gBAC1B,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACnD,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;oBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAC5F,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;gBACtB,MAAM;YACR,CAAC;YACD,KAAK,KAAK;gBACR,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;oBACjD,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBACZ,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM;YACR,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC/G,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrB,MAAM;YACR,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC7B,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;gBACvF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC5C,MAAM;YACR,CAAC;YACD,KAAK,YAAY;gBACf,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1E,MAAM;YACR,KAAK,KAAK;gBACR,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;gBACnE,MAAM;YACR,KAAK,OAAO,CAAC;YACb,KAAK,QAAQ,CAAC;YACd,KAAK,YAAY,CAAC;YAClB,KAAK,YAAY;gBACf,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,MAAM,IAAI,uBAAuB,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;gBACvG,MAAM;YACR,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK;gBACR,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM,IAAI,uBAAuB,CAAC,KAAK,EAAE,gIAAgI,CAAC,CAAC;gBAC7K,CAAC;gBACD,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;oBAC3C,aAAa,GAAG,IAAI,CAAC;gBACvB,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;gBACxD,MAAM;YACR;gBACE,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,uBAAuB,GAAG,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACvI,CAAC;IACD,IAAI,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACnG,IAAI,YAAY;QAAE,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;SAC7C,IAAI,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;;QACzC,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI,MAAM,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2GAA2G;AAC3G,SAAS,QAAQ,CAAC,GAAW,EAAE,IAA4B;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;SACjC,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,OAAO,CAAC,CAAC,CAAC,UAAU,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACrD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,67 @@
+export type Headers = Record<string, string | null | undefined>;
+export declare class RunloopError extends Error {
+    constructor(message?: string);
+}
+export declare class APIError<TStatus extends number | undefined = number | undefined, THeaders extends Headers | undefined = Headers | undefined, TError extends object | undefined = object | undefined> extends RunloopError {
+    /** HTTP status for the response that caused the error */
+    readonly status: TStatus;
+    /** HTTP headers for the response that caused the error */
+    readonly headers: THeaders;
+    /** JSON body of the response that caused the error */
+    readonly error: TError;
+    constructor(status: TStatus, error: TError, message: string | undefined, headers: THeaders);
+    private static makeMessage;
+    static generate(status: number | undefined, errorResponse: object | undefined, message: string | undefined, headers: Headers | undefined): APIError;
+}
+export declare class APIUserAbortError extends APIError<undefined, undefined, undefined> {
+    constructor({ message }?: {
+        message?: string;
+    });
+}
+export declare class APIConnectionError extends APIError<undefined, undefined, undefined> {
+    constructor({ message, cause }?: {
+        message?: string | undefined;
+        cause?: Error | undefined;
+    });
+}
+export declare class APIConnectionTimeoutError extends APIConnectionError {
+    constructor({ message }?: {
+        message?: string;
+    });
+}
+/** Alias: the Python SDK (and the compat docs) call this `APITimeoutError`. */
+export { APIConnectionTimeoutError as APITimeoutError };
+export declare class BadRequestError extends APIError<400, Headers> {
+}
+export declare class AuthenticationError extends APIError<401, Headers> {
+}
+export declare class PermissionDeniedError extends APIError<403, Headers> {
+}
+export declare class NotFoundError extends APIError<404, Headers> {
+}
+export declare class ConflictError extends APIError<409, Headers> {
+}
+export declare class UnprocessableEntityError extends APIError<422, Headers> {
+}
+export declare class RateLimitError extends APIError<429, Headers> {
+}
+export declare class InternalServerError extends APIError<number, Headers> {
+}
+/**
+ * Raised for Runloop features Solari does not offer (or not yet). Always names the
+ * feature; the compat layer never silently ignores a parameter it cannot honour.
+ */
+export declare class SolariCompatUnsupported extends APIError<undefined, undefined, undefined> {
+    readonly feature: string;
+    constructor(feature: string, detail?: string);
+}
+/**
+ * Translate anything thrown by the Solari SDK into the Runloop hierarchy.
+ * Already-translated errors pass through untouched.
+ */
+export declare function translateError(err: unknown): unknown;
+/** Run `fn`, translating any thrown Solari error. */
+export declare function translating<T>(fn: () => Promise<T>): Promise<T>;
+/** A namespace whose every method throws {@link SolariCompatUnsupported}. */
+export declare function unsupportedNamespace<T extends object = Record<string, (...a: unknown[]) => never>>(feature: string): 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":"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"}

package/dist/errors.js

@@ -0,0 +1,171 @@
+// Runloop-shaped error hierarchy (names and fields follow @runloop/api-client
+// 2.0.0 `error.d.ts`), plus translation from Solari SDK errors. Solari's own
+// `{code,error,message,retryable}` body is kept verbatim on `.error`.
+import { ActionError, ConnectionError, GatewayError, SolariError, TimeoutError, } from "@solarisdk/core";
+export class RunloopError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class APIError extends RunloopError {
+    /** HTTP status for the response that caused the error */
+    status;
+    /** HTTP headers for the response that caused the error */
+    headers;
+    /** JSON body of the response that caused the error */
+    error;
+    constructor(status, error, message, headers) {
+        super(APIError.makeMessage(status, error, message));
+        this.status = status;
+        this.headers = headers;
+        this.error = error;
+    }
+    static makeMessage(status, error, message) {
+        const msg = error?.message !== undefined
+            ? typeof error.message === "string"
+                ? error.message
+                : JSON.stringify(error.message)
+            : error
+                ? JSON.stringify(error)
+                : message;
+        if (status && msg)
+            return `${status} ${msg}`;
+        if (status)
+            return `${status} status code (no body)`;
+        if (msg)
+            return msg;
+        return "(no status code or body)";
+    }
+    static generate(status, errorResponse, message, headers) {
+        if (!status)
+            return new APIConnectionError({ message });
+        const error = errorResponse;
+        if (status === 400)
+            return new BadRequestError(status, error, message, headers);
+        if (status === 401)
+            return new AuthenticationError(status, error, message, headers);
+        if (status === 403)
+            return new PermissionDeniedError(status, error, message, headers);
+        if (status === 404)
+            return new NotFoundError(status, error, message, headers);
+        if (status === 409)
+            return new ConflictError(status, error, message, headers);
+        if (status === 422)
+            return new UnprocessableEntityError(status, error, message, headers);
+        if (status === 429)
+            return new RateLimitError(status, error, message, headers);
+        if (status >= 500)
+            return new InternalServerError(status, error, message, headers);
+        return new APIError(status, error, message, headers);
+    }
+}
+export class APIUserAbortError extends APIError {
+    constructor({ message } = {}) {
+        super(undefined, undefined, message || "Request was aborted.", undefined);
+    }
+}
+export class APIConnectionError extends APIError {
+    constructor({ message, cause } = {}) {
+        super(undefined, undefined, message || "Connection error.", undefined);
+        if (cause)
+            this.cause = cause;
+    }
+}
+export class APIConnectionTimeoutError extends APIConnectionError {
+    constructor({ message } = {}) {
+        super({ message: message ?? "Request timed out." });
+    }
+}
+/** Alias: the Python SDK (and the compat docs) call this `APITimeoutError`. */
+export { APIConnectionTimeoutError as APITimeoutError };
+export class BadRequestError extends APIError {
+}
+export class AuthenticationError extends APIError {
+}
+export class PermissionDeniedError extends APIError {
+}
+export class NotFoundError extends APIError {
+}
+export class ConflictError extends APIError {
+}
+export class UnprocessableEntityError extends APIError {
+}
+export class RateLimitError extends APIError {
+}
+export class InternalServerError extends APIError {
+}
+/**
+ * Raised for Runloop features Solari does not offer (or not yet). Always names the
+ * feature; the compat layer never silently ignores a parameter it cannot honour.
+ */
+export class SolariCompatUnsupported extends APIError {
+    feature;
+    constructor(feature, detail) {
+        super(undefined, undefined, `Solari does not support ${feature} through the Runloop compatibility layer${detail ? `: ${detail}` : "."}`, undefined);
+        this.feature = feature;
+    }
+}
+/** Solari HTTP status → Runloop class (402 plan errors surface as PermissionDenied). */
+function statusToStatus(status) {
+    return status === 402 ? 403 : status;
+}
+/**
+ * Translate anything thrown by the Solari SDK into the Runloop hierarchy.
+ * Already-translated errors pass through untouched.
+ */
+export function translateError(err) {
+    if (err instanceof RunloopError)
+        return err;
+    if (err instanceof GatewayError) {
+        const body = (err.body ?? { message: err.message });
+        const e = APIError.generate(statusToStatus(err.status), body, err.message, {});
+        // 402 (plan) surfaces as PermissionDeniedError but keeps its real status.
+        if (err.status === 402)
+            e.status = 402;
+        e.cause = err;
+        return e;
+    }
+    if (err instanceof TimeoutError) {
+        const e = new APIConnectionTimeoutError({ message: err.message });
+        e.cause = err;
+        return e;
+    }
+    if (err instanceof ConnectionError) {
+        return new APIConnectionError({ message: err.message, cause: err });
+    }
+    if (err instanceof ActionError) {
+        const e = new APIError(undefined, { code: err.code, message: err.message }, err.message, undefined);
+        e.cause = err;
+        return e;
+    }
+    if (err instanceof SolariError) {
+        return new APIConnectionError({ message: err.message, cause: err });
+    }
+    if (err instanceof TypeError || err?.name === "AbortError") {
+        return new APIConnectionError({ message: err.message, cause: err });
+    }
+    return err;
+}
+/** Run `fn`, translating any thrown Solari error. */
+export async function translating(fn) {
+    try {
+        return await fn();
+    }
+    catch (e) {
+        throw translateError(e);
+    }
+}
+/** 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)}`);
+            };
+        },
+    });
+}
+//# 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/image-ref.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OCI image reference validation for `fromImage` templates (blueprint level 3b).
+ *
+ * The reference comes from a tenant and ends up on a command line inside the builder VM, so it is
+ * parsed strictly into registry / repository / tag / digest and re-rendered from the parts. Nothing
+ * the caller typed is passed through verbatim. Rules:
+ *   - the registry must be on the allowlist (public registries only);
+ *   - no scheme, no userinfo / credentials, no port, no whitespace or control characters;
+ *   - repository, tag and digest must match the OCI grammar;
+ *   - a short docker.io name gets `library/` and the tag defaults to `latest`.
+ */
+/** Registries a template may pull from. Public, anonymous pulls only: no credentials are ever sent. */
+export declare const IMAGE_REGISTRY_ALLOWLIST: readonly string[];
+export interface ParsedImageRef {
+    /** Allowlisted registry host, e.g. "docker.io". */
+    registry: string;
+    /** Repository path, e.g. "library/python". */
+    repository: string;
+    tag?: string;
+    digest?: string;
+    /** `registry/repository` with no tag or digest. */
+    name: string;
+    /** Canonical re-rendering: `name[:tag][@digest]`. */
+    canonical: string;
+}
+export type ImageRefResult = {
+    ok: true;
+    ref: ParsedImageRef;
+} | {
+    ok: false;
+    code: "InvalidImage" | "ImageRegistryNotAllowed";
+    error: string;
+};
+export declare function parseImageRef(input: unknown): ImageRefResult;
+//# sourceMappingURL=image-ref.d.ts.map