sporades 0.1.0

package/dist/cli/host-helper-config.js

@@ -0,0 +1,111 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { SPORADES_BASE_IMAGE } from "../base-image.js";
+import { errorDetails, helperError } from "./cli-support.js";
+const HOST_HELPER_CONFIG_FILE = "sporades-host-helper.json";
+const DEFAULT_HOSTED_CAPSULE_DOCKER_IMAGE = SPORADES_BASE_IMAGE.image;
+const DEFAULT_HOSTED_CAPSULE_DOCKER_NETWORK = "sporades-hosted-capsules";
+const DEFAULT_HOSTED_CAPSULE_GRACE_CHECK_MS = 500;
+const DEFAULT_HOST_LOG_LINES = 200;
+const DEFAULT_MAX_HOST_LOG_LINES = 10000;
+export function defaultHostHelperConfig() {
+    return {
+        hostedCapsule: {
+            dockerImage: DEFAULT_HOSTED_CAPSULE_DOCKER_IMAGE,
+            dockerNetwork: DEFAULT_HOSTED_CAPSULE_DOCKER_NETWORK,
+            graceCheckMs: DEFAULT_HOSTED_CAPSULE_GRACE_CHECK_MS,
+        },
+        logs: {
+            defaultLines: DEFAULT_HOST_LOG_LINES,
+            maxLines: DEFAULT_MAX_HOST_LOG_LINES,
+        },
+    };
+}
+export async function loadHostHelperConfig(request) {
+    const loaded = defaultHostHelperConfig();
+    const configPath = hostHelperConfigPath(request);
+    if (!configPath) {
+        return loaded;
+    }
+    let contents;
+    try {
+        contents = await readFile(configPath, "utf8");
+    }
+    catch (error) {
+        if (errorDetails(error).code === "ENOENT" && !process.env.SPORADES_HOST_HELPER_CONFIG) {
+            return loaded;
+        }
+        throw helperError("Failed to read Host helper config.", `Check that ${configPath} exists and is readable by the Host helper.`);
+    }
+    let config;
+    try {
+        config = JSON.parse(contents);
+    }
+    catch {
+        throw helperError("Host helper config is invalid JSON.", `Fix ${configPath}, then retry the Host helper command.`);
+    }
+    return applyHostHelperConfig(loaded, config, configPath);
+}
+function hostHelperConfigPath(request) {
+    if (process.env.SPORADES_HOST_HELPER_CONFIG) {
+        return process.env.SPORADES_HOST_HELPER_CONFIG;
+    }
+    if (typeof request.host?.remoteRoot !== "string" || request.host.remoteRoot.length === 0) {
+        return null;
+    }
+    return path.join(request.host.remoteRoot, HOST_HELPER_CONFIG_FILE);
+}
+function applyHostHelperConfig(loaded, config, configPath) {
+    assertPlainObject(config, "Host helper config", configPath);
+    assertKnownKeys(config, ["hostedCapsule", "logs"], "Host helper config", configPath);
+    const hostedCapsule = config.hostedCapsule ?? {};
+    assertPlainObject(hostedCapsule, "Host helper hostedCapsule config", configPath);
+    assertKnownKeys(hostedCapsule, ["dockerImage", "dockerNetwork", "graceCheckMs"], "Host helper hostedCapsule config", configPath);
+    const logs = config.logs ?? {};
+    assertPlainObject(logs, "Host helper logs config", configPath);
+    assertKnownKeys(logs, ["defaultLines", "maxLines"], "Host helper logs config", configPath);
+    if (Object.hasOwn(hostedCapsule, "dockerImage")) {
+        loaded.hostedCapsule.dockerImage = readConfigString(hostedCapsule.dockerImage, "hostedCapsule.dockerImage", configPath);
+    }
+    if (Object.hasOwn(hostedCapsule, "dockerNetwork")) {
+        loaded.hostedCapsule.dockerNetwork = readConfigString(hostedCapsule.dockerNetwork, "hostedCapsule.dockerNetwork", configPath);
+    }
+    if (Object.hasOwn(hostedCapsule, "graceCheckMs")) {
+        loaded.hostedCapsule.graceCheckMs = readConfigPositiveInteger(hostedCapsule.graceCheckMs, "hostedCapsule.graceCheckMs", configPath);
+    }
+    if (Object.hasOwn(logs, "defaultLines")) {
+        loaded.logs.defaultLines = readConfigPositiveInteger(logs.defaultLines, "logs.defaultLines", configPath);
+    }
+    if (Object.hasOwn(logs, "maxLines")) {
+        loaded.logs.maxLines = readConfigPositiveInteger(logs.maxLines, "logs.maxLines", configPath);
+    }
+    if (loaded.logs.defaultLines > loaded.logs.maxLines) {
+        throw helperError("Host helper config is invalid.", `Set logs.defaultLines less than or equal to logs.maxLines in ${configPath}.`);
+    }
+    return loaded;
+}
+function assertPlainObject(value, label, configPath) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw helperError("Host helper config is invalid.", `${label} must be a JSON object in ${configPath}.`);
+    }
+}
+function assertKnownKeys(value, knownKeys, label, configPath) {
+    for (const key of Object.keys(value)) {
+        if (!knownKeys.includes(key)) {
+            throw helperError("Host helper config is invalid.", `${label} contains unsupported key "${key}" in ${configPath}.`);
+        }
+    }
+}
+function readConfigString(value, key, configPath) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw helperError("Host helper config is invalid.", `Set ${key} to a non-empty string in ${configPath}.`);
+    }
+    return value;
+}
+function readConfigPositiveInteger(value, key, configPath) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
+        throw helperError("Host helper config is invalid.", `Set ${key} to a positive whole number in ${configPath}.`);
+    }
+    return value;
+}
+//# sourceMappingURL=host-helper-config.js.map

package/dist/cli/host-helper-config.js.map

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

package/dist/cli/host-helper-contract.d.ts

@@ -0,0 +1,5 @@
+export * from "./host-helper-json.js";
+export * from "./host-helper-requests.js";
+export * from "./hosted-capsule-contract.js";
+export * from "./host-helper-docker-types.js";
+//# sourceMappingURL=host-helper-contract.d.ts.map

package/dist/cli/host-helper-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-contract.d.ts","sourceRoot":"","sources":["../../src/cli/host-helper-contract.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/dist/cli/host-helper-contract.js

@@ -0,0 +1,5 @@
+export * from "./host-helper-json.js";
+export * from "./host-helper-requests.js";
+export * from "./hosted-capsule-contract.js";
+export * from "./host-helper-docker-types.js";
+//# sourceMappingURL=host-helper-contract.js.map

package/dist/cli/host-helper-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-contract.js","sourceRoot":"","sources":["../../src/cli/host-helper-contract.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/dist/cli/host-helper-docker-types.d.ts

@@ -0,0 +1,27 @@
+import type { JsonObject } from "./host-helper-json.js";
+export type CommandResult = {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    status: number | null;
+    error?: Error;
+};
+export type DockerCommandResult = CommandResult;
+export type DockerPsContainerRaw = JsonObject & {
+    ID?: string;
+    Names?: string;
+    Image?: string;
+    State?: string;
+    Status?: string;
+    Labels?: string;
+};
+export type DockerStatsRaw = JsonObject & {
+    Name?: string;
+    CPUPerc?: string;
+    MemUsage?: string;
+    MemPerc?: string;
+    NetIO?: string;
+    BlockIO?: string;
+    PIDs?: string;
+};
+//# sourceMappingURL=host-helper-docker-types.d.ts.map

package/dist/cli/host-helper-docker-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-docker-types.d.ts","sourceRoot":"","sources":["../../src/cli/host-helper-docker-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/cli/host-helper-docker-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-helper-docker-types.js.map

package/dist/cli/host-helper-docker-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-docker-types.js","sourceRoot":"","sources":["../../src/cli/host-helper-docker-types.ts"],"names":[],"mappings":""}

package/dist/cli/host-helper-json.d.ts

@@ -0,0 +1,6 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | JsonObject;
+export type JsonObject = {
+    [key: string]: unknown;
+};
+//# sourceMappingURL=host-helper-json.d.ts.map

package/dist/cli/host-helper-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-json.d.ts","sourceRoot":"","sources":["../../src/cli/host-helper-json.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG,UAAU,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC"}

package/dist/cli/host-helper-json.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-helper-json.js.map

package/dist/cli/host-helper-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-json.js","sourceRoot":"","sources":["../../src/cli/host-helper-json.ts"],"names":[],"mappings":""}

package/dist/cli/host-helper-release-files.d.ts

@@ -0,0 +1,4 @@
+import type { HostHelperRelease } from "./host-helper-contract.js";
+export declare function expectedReleaseFiles(release: HostHelperRelease): string[];
+export declare function isExpectedClaimedReleaseFile(file: unknown): boolean;
+//# sourceMappingURL=host-helper-release-files.d.ts.map

package/dist/cli/host-helper-release-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-release-files.d.ts","sourceRoot":"","sources":["../../src/cli/host-helper-release-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,YAS9D;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,WASzD"}

package/dist/cli/host-helper-release-files.js

@@ -0,0 +1,21 @@
+export function expectedReleaseFiles(release) {
+    const files = ["server.mjs", "client.js", "index.html", "sporades.json"];
+    if (release.serverEnvIncluded) {
+        files.push(".env.sporades.server");
+    }
+    if (release.sealedServerEnvIncluded) {
+        files.push(".sporades/sealed-server-env/server-env.sealed.json");
+    }
+    return files;
+}
+export function isExpectedClaimedReleaseFile(file) {
+    return [
+        "server.mjs",
+        "client.js",
+        "index.html",
+        "sporades.json",
+        ".env.sporades.server",
+        ".sporades/sealed-server-env/server-env.sealed.json",
+    ].includes(file);
+}
+//# sourceMappingURL=host-helper-release-files.js.map

package/dist/cli/host-helper-release-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-release-files.js","sourceRoot":"","sources":["../../src/cli/host-helper-release-files.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAa;IACxD,OAAO;QACL,YAAY;QACZ,WAAW;QACX,YAAY;QACZ,eAAe;QACf,sBAAsB;QACtB,oDAAoD;KACrD,CAAC,QAAQ,CAAC,IAAc,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/host-helper-requests.d.ts

@@ -0,0 +1,163 @@
+import type { JsonObject, JsonValue } from "./host-helper-json.js";
+import type { HostHelperCapsuleTarget, HostHelperHost, HostHelperSealedServerEnv, HostLifecycleOptions, HostedCapsuleBaseImage, HostTlsMode } from "./hosted-capsule-contract.js";
+export type HostHelperAction = "capsule.register" | "capsule.sealed-env.rotate-key" | "capsule.unregister" | "capsule.delete" | "capsule.release.install" | "capsule.release.list" | "capsule.release.rollback" | "capsule.start" | "capsule.stop" | "capsule.restart" | "capsule.stats" | "capsule.health" | "capsule.list" | "host.stats" | "host.logs" | "host.bootstrap";
+export type HostHelperVerification = JsonObject & {
+    enabled?: boolean;
+    fallbackToPreviousRelease?: boolean;
+    healthTimeoutMs?: number;
+};
+export type HostHelperRelease = JsonObject & {
+    id: string;
+    remoteArchive: string;
+    files: string[];
+    hostedUrl?: string;
+    currentLink?: string;
+    directories?: {
+        releases?: string;
+        release?: string;
+        data?: string;
+        logs?: string;
+        [key: string]: unknown;
+    };
+    baseImage?: HostedCapsuleBaseImage | null;
+    restart?: boolean;
+    serverEnvIncluded?: boolean;
+    sealedServerEnvIncluded?: boolean;
+    sealedServerEnv?: HostHelperSealedServerEnv | null;
+};
+export type HostHelperRequestBase = JsonObject & {
+    action: HostHelperAction;
+    host: HostHelperHost;
+    capsule?: HostHelperCapsuleTarget | null;
+    release?: HostHelperRelease;
+    rollback?: {
+        releaseId: string;
+    };
+    lifecycle?: HostLifecycleOptions;
+    registration?: HostRegistrationOptions;
+    unregister?: HostRegistrationOptions;
+    delete?: HostRegistrationOptions;
+    logs?: HostLogsOptions;
+    bootstrap?: HostBootstrapOptions;
+    source?: "http" | "stdout" | "stderr";
+    lines?: number;
+    verification?: HostHelperVerification;
+};
+export type HostRegistrationOptions = JsonObject & {
+    subname?: string;
+    domain?: string;
+    remoteCapsuleId?: string;
+    route?: {
+        log?: {
+            file?: string;
+        };
+        [key: string]: unknown;
+    };
+    baseImage?: HostedCapsuleBaseImage;
+    bootstrap?: HostBootstrapOptions;
+};
+export type HostLogsOptions = JsonObject & {
+    source?: "http" | "caddy-combined" | "stdout" | "stderr";
+    lines?: number;
+    file?: string;
+    path?: string;
+    accessLog?: {
+        file?: string;
+    };
+    container?: {
+        name?: string;
+    };
+};
+export type HostBootstrapOptions = JsonObject & {
+    domainDirectory?: string;
+    network?: string;
+    tls?: {
+        mode?: HostTlsMode | string;
+        directory?: string;
+        certificate?: string;
+        key?: string;
+    };
+    directories?: Record<string, string>;
+    substrate?: {
+        packages?: string[];
+        services?: string[];
+    };
+    caddy?: {
+        managedInclude?: string;
+        domainInclude?: string;
+        accessLog?: string;
+    };
+};
+export type HostBootstrapRequest = HostHelperRequestBase & {
+    action: "host.bootstrap";
+};
+export type HostRegistrationRequest = HostHelperRequestBase & {
+    action: "capsule.register";
+    capsule: HostHelperCapsuleTarget;
+};
+export type HostSealedEnvRotationRequest = HostHelperRequestBase & {
+    action: "capsule.sealed-env.rotate-key";
+    capsule: HostHelperCapsuleTarget;
+};
+export type HostUnregisterRequest = HostHelperRequestBase & {
+    action: "capsule.unregister";
+    capsule: HostHelperCapsuleTarget;
+};
+export type HostDeleteRequest = HostHelperRequestBase & {
+    action: "capsule.delete";
+    capsule: HostHelperCapsuleTarget;
+};
+export type HostReleaseInstallRequest = HostHelperRequestBase & {
+    action: "capsule.release.install";
+    capsule: HostHelperCapsuleTarget;
+    release: HostHelperRelease;
+};
+export type HostReleaseListRequest = HostHelperRequestBase & {
+    action: "capsule.release.list";
+    capsule: HostHelperCapsuleTarget;
+};
+export type HostReleaseRollbackRequest = HostHelperRequestBase & {
+    action: "capsule.release.rollback";
+    capsule: HostHelperCapsuleTarget;
+    rollback: {
+        releaseId: string;
+    };
+};
+export type HostLifecycleRequest = HostHelperRequestBase & {
+    action: "capsule.start" | "capsule.stop" | "capsule.restart";
+    capsule: HostHelperCapsuleTarget;
+};
+export type HostStatsRequest = (HostHelperRequestBase & {
+    action: "host.stats";
+}) | (HostHelperRequestBase & {
+    action: "capsule.stats";
+    capsule: HostHelperCapsuleTarget;
+});
+export type HostHealthRequest = HostHelperRequestBase & {
+    action: "capsule.health";
+    capsule: HostHelperCapsuleTarget;
+};
+export type HostLogsRequest = HostHelperRequestBase & {
+    action: "host.logs";
+    source: "http" | "stdout" | "stderr";
+    lines: number;
+};
+export type HostCapsuleListRequest = HostHelperRequestBase & {
+    action: "capsule.list";
+};
+export type HostHelperRequest = HostBootstrapRequest | HostRegistrationRequest | HostSealedEnvRotationRequest | HostUnregisterRequest | HostDeleteRequest | HostReleaseInstallRequest | HostReleaseListRequest | HostReleaseRollbackRequest | HostLifecycleRequest | HostStatsRequest | HostHealthRequest | HostLogsRequest | HostCapsuleListRequest;
+export type HostHelperErrorBody = JsonObject & {
+    message: string;
+    hint: string;
+    diagnostics?: JsonValue;
+};
+export type HostHelperEnvelope<Data = JsonValue> = {
+    ok: true;
+    data: Data;
+    error: null;
+} | {
+    ok: false;
+    data: Data | null;
+    error: HostHelperErrorBody;
+};
+//# sourceMappingURL=host-helper-requests.d.ts.map

package/dist/cli/host-helper-requests.d.ts.map

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

package/dist/cli/host-helper-requests.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-helper-requests.js.map

package/dist/cli/host-helper-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-requests.js","sourceRoot":"","sources":["../../src/cli/host-helper-requests.ts"],"names":[],"mappings":""}

package/dist/cli/host-helper-validation.d.ts

@@ -0,0 +1,27 @@
+import type { HostHelperRelease, HostHelperRequest as HostHelperContractRequest, HostHelperCapsuleTarget } from "./host-helper-contract.js";
+export type HostHelperRequest = HostHelperContractRequest & {
+    capsule: HostHelperCapsuleTarget;
+    release: HostHelperRelease;
+};
+export type HostLogLineLimits = {
+    defaultLines: number;
+    maxLines: number;
+};
+export declare function missingCapsuleHint(request: HostHelperRequest, purpose: string): string;
+export declare function hostRegistryRetryCommand(request: HostHelperRequest): string;
+export declare function validateLifecycleRequest(request: HostHelperRequest): void;
+export declare function validateSealedEnvRotationRequest(request: HostHelperRequest): void;
+export declare function validateStatsRequest(request: HostHelperRequest): void;
+export declare function validateReleaseListRequest(request: HostHelperRequest): void;
+export declare function validateHealthRequest(request: HostHelperRequest): void;
+export declare function validateHostStatsRequest(request: HostHelperRequest): void;
+export declare function validateRollbackRequest(request: HostHelperRequest): void;
+export declare function validateHostLogsRequest(request: HostHelperRequest, limits: HostLogLineLimits): void;
+export declare function validateListRequest(request: HostHelperRequest): void;
+export declare function validateListRegistryRecord(request: HostHelperRequest, record: unknown, recordPath: string): void;
+export declare function validateBootstrapRequest(request: HostHelperRequest): void;
+export declare function validateRegisterRequest(request: HostHelperRequest): void;
+export declare function validateUnregisterRequest(request: HostHelperRequest): void;
+export declare function validateDeleteRequest(request: HostHelperRequest): void;
+export declare function validateInstallRequest(request: HostHelperRequest): void;
+//# sourceMappingURL=host-helper-validation.d.ts.map

package/dist/cli/host-helper-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-helper-validation.d.ts","sourceRoot":"","sources":["../../src/cli/host-helper-validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAG5I,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,GAAG;IAC1D,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,iBAAiB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,UAW7E;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,UAElE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,QAUlE;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iBAAiB,QAU1E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,QAU9D;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,QAUpE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,QAU/D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,QASlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,QAkBjE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,QA6B5F;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,QAS7D;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,QAiBzG;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,QAgBlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,QA4BjE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,QAqBnE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,QAqB/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,QAsChE"}