@sandbox-kit/modal 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sandbox-kit/modal",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "modal provider for sandbox kit",
   "keywords": [
     "sandbox-kit",
@@ -59,13 +59,14 @@
     }
   },
   "scripts": {
+    "clean": "rm -rf dist",
     "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "npm run clean && npm run build",
     "test": "tsc -p tsconfig.test.json && vitest run"
   },
   "dependencies": {
     "@bufbuild/protobuf": "2.16.0",
-    "@sandbox-kit/sandbox": "0.1.1",
+    "@sandbox-kit/sandbox": "0.1.2",
     "modal": "0.11.1"
   },
   "devDependencies": {

package/dist/mappings.d.ts

@@ -1,17 +0,0 @@
-import { type ModalClientParams, type Sandbox, type SandboxCreateParams } from "modal";
-import { type Config, type CreateOptions, type SandboxInfo } from "@sandbox-kit/sandbox";
-import type { ProviderState } from "./provider_config.js";
-export interface ModalCreatePlan {
-    readonly app: string;
-    readonly environment?: string;
-    readonly image: string;
-    readonly params: SandboxCreateParams;
-    readonly secretNames: readonly string[];
-    readonly proxyName?: string;
-    readonly waitUntilReady: boolean;
-    readonly readyTimeoutMs?: number;
-}
-export declare function mapClientConfig(config: Config): ModalClientParams;
-export declare function mapCreateRequest(request: CreateOptions, config: ProviderState): ModalCreatePlan;
-export declare function mapSandboxInfo(value: Sandbox, request?: CreateOptions): SandboxInfo;
-//# sourceMappingURL=mappings.d.ts.map

package/dist/mappings.js

@@ -1,317 +0,0 @@
-// Provider-specific orchestration around generated portable field mappings.
-import { Probe, } from "modal";
-import { EgressMode, ErrorKind, IsolationKind, PolicyMode, PortTransport, SecretInjection, SandboxState, ValueOrigin, WaitCondition, sandboxError } from "@sandbox-kit/sandbox";
-import { mapCommonCreateFields as generatedMapCommonCreateFields, mapIdleDuration as generatedMapIdleDuration, mapLifetimeDuration as generatedMapLifetimeDuration, mapResources as generatedMapResources, mapSandboxIdentity as generatedMapSandboxIdentity, } from "./provider_mappings.js";
-import { validateProviderCreate } from "./provider_checks.js";
-import { mapGeneratedClientConfig } from "./provider_config.js";
-export function mapClientConfig(config) {
-    const result = mapGeneratedClientConfig(config);
-    if (config.timeout !== undefined)
-        result.timeoutMs = finiteDurationMs(config.timeout, "timeout", true);
-    return result;
-}
-export function mapCreateRequest(request, config) {
-    validateProviderCreate(request);
-    const app = config.scope?.appName === undefined
-        ? invalid("scope.appName", "Modal app name is required")
-        : nonblank(config.scope.appName, "scope.appName");
-    if (request.source?.image === undefined)
-        unsupported("source", "Modal requires an explicit image source");
-    const params = generatedMapCommonCreateFields(request);
-    if (request.name !== undefined)
-        params.name = nonblank(request.name, "name");
-    if (config.region !== undefined)
-        params.regions = [nonblankConfig(config.region, "region")];
-    mapRuntime(request, params);
-    mapIsolation(request, params);
-    mapResources(request, params);
-    mapPlacement(request, params);
-    mapNetwork(request, params);
-    const secretNames = mapSecurity(request, params);
-    mapLifetime(request, params);
-    mapReadiness(request, params);
-    const wait = mapProvisioning(request, params);
-    mapObservability(request, params);
-    if (request.providerOptions !== undefined)
-        unsupported("providerOptions", "Modal provider options are not mapped");
-    return {
-        app,
-        ...(config.scope?.environment === undefined
-            ? {}
-            : { environment: config.scope.environment }),
-        image: nonblank(request.source.image.reference, "source.image.reference"),
-        params,
-        secretNames,
-        ...(request.network?.proxyReference === undefined
-            ? {}
-            : {
-                proxyName: nonblank(request.network.proxyReference, "network.proxyReference"),
-            }),
-        ...wait,
-    };
-}
-function mapRuntime(r, p) {
-    const v = r.runtime;
-    if (!v)
-        return;
-    if (v.workingDirectory !== undefined)
-        p.workdir = v.workingDirectory;
-    if (v.entrypoint !== undefined)
-        p.command = [...v.entrypoint];
-    if (v.pty !== undefined)
-        p.pty = v.pty;
-    if (v.language !== undefined ||
-        v.version !== undefined ||
-        v.user !== undefined)
-        unsupported("runtime", "language, version, and user must come from the Modal image");
-}
-function mapIsolation(r, p) {
-    const v = r.isolation;
-    if (!v)
-        return;
-    const kind = v.kind ?? IsolationKind.Default;
-    if (kind === IsolationKind.LinuxVm)
-        p.runtime = "vm";
-    else if (kind === IsolationKind.Container)
-        p.runtime = "gvisor";
-    else if (kind !== IsolationKind.Default)
-        unsupported("isolation.kind", "requested Modal isolation is unsupported");
-    if (v.providerKind !== undefined || v.nestedVirtualization !== undefined)
-        unsupported("isolation", "provider kind and nested virtualization are unsupported");
-}
-function mapResources(r, p) {
-    const v = r.resources;
-    if (!v)
-        return;
-    if (v.cpuLimitCores !== undefined)
-        positive(v.cpuLimitCores, "resources.cpuLimitCores");
-    if (v.memoryMib !== undefined)
-        integer(v.memoryMib, "resources.memoryMib", 128);
-    if (v.memoryLimitMib !== undefined)
-        integer(v.memoryLimitMib, "resources.memoryLimitMib", 1);
-    if (v.diskMib !== undefined)
-        unsupported("resources.diskMib", "Modal disk override is unsupported");
-    Object.assign(p, generatedMapResources(v));
-}
-function mapPlacement(r, p) {
-    const v = r.placement;
-    if (!v)
-        return;
-    if (v.cloud !== undefined)
-        p.cloud = v.cloud;
-    if (v.regions !== undefined)
-        p.regions = [...v.regions];
-    if (v.target !== undefined)
-        unsupported("placement.target", "Modal placement target is unsupported");
-}
-function mapNetwork(r, p) {
-    const v = r.network;
-    if (!v)
-        return;
-    const egress = v.egress ?? EgressMode.Default;
-    if (egress === EgressMode.BlockAll)
-        p.blockNetwork = true;
-    else if (egress !== EgressMode.Default &&
-        egress !== EgressMode.AllowAll &&
-        egress !== EgressMode.Restricted)
-        invalid("network.egress", "unknown egress mode");
-    if (v.outboundCidrs !== undefined)
-        p.outboundCidrAllowlist = [...v.outboundCidrs];
-    if (v.outboundDomains !== undefined)
-        p.outboundDomainAllowlist = [...v.outboundDomains];
-    if (v.inboundCidrs !== undefined) {
-        if (!v.inboundCidrs.length)
-            unsupported("network.inboundCidrs", "empty inbound deny-all is not representable");
-        p.inboundCidrAllowlist = [...v.inboundCidrs];
-    }
-    if (v.privateNetwork !== undefined)
-        p.i6pn = v.privateNetwork;
-    if (v.customDomain !== undefined)
-        p.customDomain = v.customDomain;
-    if (v.ports) {
-        p.encryptedPorts = [];
-        p.h2Ports = [];
-        p.unencryptedPorts = [];
-        for (const x of v.ports) {
-            const port = x.port;
-            if (port === undefined)
-                invalid("network.ports.port", "port is required");
-            const transport = x.transport ?? PortTransport.Default;
-            if (transport === PortTransport.Tls)
-                p.encryptedPorts.push(port);
-            else if (transport === PortTransport.Http2Tls)
-                p.h2Ports.push(port);
-            else if (transport === PortTransport.Plain)
-                p.unencryptedPorts.push(port);
-            else
-                invalid("network.ports.transport", "explicit transport is required");
-        }
-    }
-    if (v.linkedSandbox !== undefined || v.outboundProxyUrl !== undefined)
-        unsupported("network", "linked sandbox and outbound proxy URL mappings are unsupported");
-}
-function mapSecurity(r, p) {
-    const v = r.security;
-    if (!v)
-        return [];
-    if (v.workloadIdentity !== undefined)
-        p.includeOidcIdentityToken = v.workloadIdentity;
-    if (v.publicAccess !== undefined)
-        unsupported("security.publicAccess", "Modal public access is represented by ports");
-    const names = [];
-    for (const s of v.secrets ?? []) {
-        if (s.environmentVariable !== undefined)
-            unsupported("security.secrets.environmentVariable", "per-variable secret renaming is unsupported");
-        const injection = s.injection ?? SecretInjection.Default;
-        if (injection !== SecretInjection.Default &&
-            injection !== SecretInjection.Environment)
-            unsupported("security.secrets.injection", "egress-placeholder injection is unsupported");
-        names.push(nonblank(s.reference, "security.secrets.reference"));
-    }
-    return names;
-}
-function mapLifetime(r, p) {
-    const v = r.lifetime;
-    if (!v)
-        return;
-    if (v.maximumLifetime !== undefined)
-        finiteDurationMs(v.maximumLifetime, "lifetime.maximumLifetime", false);
-    Object.assign(p, generatedMapLifetimeDuration(v));
-    if (v.idleTerminate) {
-        const mode = v.idleTerminate.mode ?? PolicyMode.Default;
-        if (mode === PolicyMode.Disabled)
-            p.idleTimeoutMs = 0;
-        else if (mode === PolicyMode.After) {
-            if (v.idleTerminate.after === undefined)
-                invalid("lifetime.idleTerminate.after", "duration is required");
-            finiteDurationMs(v.idleTerminate.after, "lifetime.idleTerminate.after", false);
-            Object.assign(p, generatedMapIdleDuration(v.idleTerminate));
-        }
-        else if (mode !== PolicyMode.Default)
-            invalid("lifetime.idleTerminate.mode", "unknown policy mode");
-    }
-    if (v.ephemeral !== undefined ||
-        v.idleStop !== undefined ||
-        v.idlePause !== undefined ||
-        v.stoppedArchive !== undefined ||
-        v.stoppedDelete !== undefined)
-        unsupported("lifetime", "requested lifecycle policy is unsupported by Modal");
-}
-function mapReadiness(r, p) {
-    const v = r.readiness;
-    if (!v)
-        return;
-    if (v.tcpPort !== undefined) {
-        p.readinessProbe = Probe.withTcp(v.tcpPort);
-    }
-    else if (v.command !== undefined)
-        p.readinessProbe = Probe.withExec([...(v.command.argv ?? [])]);
-    else
-        invalid("readiness", "probe is required");
-}
-function mapProvisioning(r, _p) {
-    const v = r.provisioning;
-    if (!v)
-        return { waitUntilReady: false };
-    if (v.queueTimeout !== undefined)
-        unsupported("provisioning.queueTimeout", "Modal queue timeout is unsupported");
-    const waitFor = v.waitFor ?? WaitCondition.Default;
-    if (waitFor === WaitCondition.Default || waitFor === WaitCondition.Scheduled)
-        return { waitUntilReady: false };
-    if (waitFor === WaitCondition.Ready) {
-        if (v.timeout === undefined || v.timeout <= 0)
-            invalid("provisioning.timeout", "ready wait requires a positive timeout");
-        if (!r.readiness)
-            invalid("readiness", "ready wait requires a probe");
-        return { waitUntilReady: true, readyTimeoutMs: v.timeout };
-    }
-    unsupported("provisioning.waitFor", "requested wait condition is unsupported");
-}
-function mapObservability(r, p) {
-    const v = r.observability;
-    if (!v)
-        return;
-    if (v.verbose !== undefined)
-        p.verbose = v.verbose;
-    if (v.telemetryEndpoint !== undefined)
-        unsupported("observability.telemetryEndpoint", "per-sandbox telemetry endpoint is unsupported");
-}
-export function mapSandboxInfo(value, request) {
-    const mapped = generatedMapSandboxIdentity(value);
-    const origins = { ...(mapped.origins ?? {}) };
-    const result = {
-        id: mapped.id ?? value.sandboxId,
-        provider: "modal",
-        state: SandboxState.Running,
-        labels: {},
-        origins,
-    };
-    if (request?.name !== undefined) {
-        mutable(result).name = request.name;
-        origins.name = ValueOrigin.Request;
-    }
-    if (request?.labels !== undefined) {
-        mutable(result).labels = { ...request.labels };
-        origins.labels = ValueOrigin.Request;
-    }
-    if (request?.isolation !== undefined) {
-        mutable(result).isolation = { ...request.isolation };
-        origins.isolation = ValueOrigin.Request;
-    }
-    return result;
-}
-function mutable(v) {
-    return v;
-}
-function nonblank(v, f) {
-    if (!v.trim())
-        invalid(f, "must not be blank");
-    return v;
-}
-function nonblankConfig(v, f) {
-    if (!v.trim())
-        configInvalid(f, "must not be blank");
-    return v;
-}
-function positive(v, f) {
-    if (!Number.isFinite(v) || v <= 0)
-        invalid(f, "must be positive");
-    return v;
-}
-function integer(v, f, min) {
-    if (v < BigInt(min) || v > 2147483647n)
-        invalid(f, "is outside the supported range");
-    return Number(v);
-}
-function finiteDurationMs(v, f, zero) {
-    if (!Number.isFinite(v) || v < 0 || (!zero && v === 0))
-        invalid(f, "must be a finite positive duration");
-    return v;
-}
-function invalid(field, message) {
-    throw sandboxError({
-        kind: ErrorKind.InvalidArgument,
-        provider: "modal",
-        operation: "create",
-        field,
-        message: "sandbox-kit modal: " + message,
-    });
-}
-function unsupported(field, message) {
-    throw sandboxError({
-        kind: ErrorKind.Unsupported,
-        provider: "modal",
-        operation: "create",
-        field,
-        message: "sandbox-kit modal: " + message,
-    });
-}
-function configInvalid(field, message) {
-    throw sandboxError({
-        kind: ErrorKind.InvalidArgument,
-        provider: "modal",
-        operation: "initialize",
-        field,
-        message: "sandbox-kit modal: " + message,
-    });
-}

package/dist/provider.checks.gen.d.ts

@@ -1,3 +0,0 @@
-import { type CreateOptionsWire } from "@sandbox-kit/sandbox";
-export declare function validateProviderCreate(request: CreateOptionsWire): void;
-//# sourceMappingURL=provider.checks.gen.d.ts.map

package/dist/provider.checks.gen.js

@@ -1,101 +0,0 @@
-// Code generated by protoc-gen-kit-typescript. DO NOT EDIT.
-// source: kit/providers/modal/v1/provider.proto + specs/providers/modal.yaml
-import { durationMs } from "@bufbuild/protobuf/wkt";
-import { ErrorKind, PolicyMode, sandboxError } from "@sandbox-kit/sandbox";
-export function validateProviderCreate(request) {
-    const value0_0 = request.resources;
-    if (value0_0 !== undefined) {
-        const value0 = value0_0.cpuCores;
-        if (value0 !== undefined) {
-            if (value0 < 0.125)
-                fail(ErrorKind.InvalidArgument, "resources.cpuCores", "resources.cpu_cores is outside supported values");
-        }
-    }
-    const value1_0 = request.resources;
-    if (value1_0 !== undefined) {
-        const value1 = value1_0.memoryMib;
-        if (value1 !== undefined) {
-            if (value1 < BigInt("128"))
-                fail(ErrorKind.InvalidArgument, "resources.memoryMib", "resources.memory_mib is outside supported values");
-        }
-    }
-    const value2_0 = request.runtime;
-    if (value2_0 !== undefined) {
-        const value2 = value2_0.workingDirectory;
-        if (value2 !== undefined) {
-            if (!validAbsolutePath(value2))
-                fail(ErrorKind.InvalidArgument, "runtime.workingDirectory", "runtime.working_directory is outside supported values");
-        }
-    }
-    const value3_0 = request.placement;
-    if (value3_0 !== undefined) {
-        const value3 = value3_0.cloud;
-        if (value3 !== undefined) {
-            if (value3 !== "aws" && value3 !== "gcp" && value3 !== "oci" && value3 !== "auto")
-                fail(ErrorKind.Unsupported, "placement.cloud", "placement.cloud is outside supported values");
-        }
-    }
-    const value4_0 = request.network;
-    if (value4_0 !== undefined) {
-        const value4_1 = value4_0.outboundCidrs;
-        if (value4_1 !== undefined) {
-            for (const value4 of value4_1.entries ?? []) {
-                if (value4 !== "" && !validCidr(value4))
-                    fail(ErrorKind.InvalidArgument, "network.outboundCidrs.entries", "network.outbound_cidrs.entries is outside supported values");
-            }
-        }
-    }
-    const value5_0 = request.network;
-    if (value5_0 !== undefined) {
-        const value5_1 = value5_0.inboundCidrs;
-        if (value5_1 !== undefined) {
-            for (const value5 of value5_1.entries ?? []) {
-                if (!validCidr(value5))
-                    fail(ErrorKind.InvalidArgument, "network.inboundCidrs.entries", "network.inbound_cidrs.entries is outside supported values");
-            }
-        }
-    }
-    const value6_0 = request.network;
-    if (value6_0 !== undefined) {
-        const value6_1 = value6_0.outboundDomains;
-        if (value6_1 !== undefined) {
-            for (const value6 of value6_1.entries ?? []) {
-                if (value6 !== "" && !validDomain(value6))
-                    fail(ErrorKind.InvalidArgument, "network.outboundDomains.entries", "network.outbound_domains.entries is outside supported values");
-            }
-        }
-    }
-    for (const value7 of Object.keys(request.environment ?? {})) {
-        if (!validEnvName(value7))
-            fail(ErrorKind.InvalidArgument, "environment", "environment is outside supported values");
-    }
-}
-function delayed(policy) { return (policy?.mode ?? PolicyMode.Default) === PolicyMode.After && policy?.after !== undefined && durationMs(policy.after) > 0; }
-function immediate(policy) { return (policy?.mode ?? PolicyMode.Default) === PolicyMode.After && policy?.after !== undefined && durationMs(policy.after) === 0; }
-function validEnvName(value) { return /^[A-Za-z_][A-Za-z0-9_]*$/.test(value); }
-function validAbsolutePath(value) { return value.startsWith("/"); }
-function validHttpUrl(value) { try {
-    const parsed = new URL(value);
-    return parsed.hostname !== "" && (parsed.protocol === "http:" || parsed.protocol === "https:");
-}
-catch {
-    return false;
-} }
-function validDomain(value) { const domain = value.startsWith("*.") ? value.slice(2) : value; return domain.length <= 253 && /^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.?$/i.test(domain); }
-function validCidr(value) { const separator = value.lastIndexOf("/"); if (separator <= 0)
-    return false; const address = value.slice(0, separator); const prefix = Number(value.slice(separator + 1)); if (!Number.isInteger(prefix))
-    return false; return address.includes(":") ? prefix >= 0 && prefix <= 128 && validIpv6(address) : prefix >= 0 && prefix <= 32 && validIpv4(address); }
-function validIpv4(value) { const parts = value.split("."); return parts.length === 4 && parts.every((part) => /^(0|[1-9][0-9]{0,2})$/.test(part) && Number(part) <= 255); }
-function validIpv6(value) { if ((value.match(/::/g)?.length ?? 0) > 1)
-    return false; const halves = value.split("::"); if (halves.length > 2)
-    return false; const count = (part) => { if (part === "")
-    return 0; const groups = part.split(":"); let total = 0; for (const group of groups) {
-    if (/^[0-9a-f]{1,4}$/i.test(group))
-        total++;
-    else if (validIpv4(group))
-        total += 2;
-    else
-        return undefined;
-} return total; }; const left = count(halves[0] ?? ""); const right = count(halves[1] ?? ""); return left !== undefined && right !== undefined && (halves.length === 2 ? left + right < 8 : left === 8); }
-function invalid(field, message) { fail(ErrorKind.InvalidArgument, field, message); }
-function fail(kind, field, message) { throw sandboxError({ kind, provider: "modal", operation: "create", field, message: "sandbox-kit modal: " + message }); }

package/dist/provider.config.gen.d.ts

@@ -1,9 +0,0 @@
-import type { ModalClientParams as NativeClientConfig } from "modal";
-import { type ConfigWire, type ConfigWire, type Scope } from "@sandbox-kit/sandbox";
-export declare function mapGeneratedClientConfig(config: ConfigWire): NativeClientConfig;
-export interface ProviderState {
-    readonly scope?: ConfigWire["scope"] | Scope;
-    readonly region?: string;
-}
-export declare function captureProviderState(config: ConfigWire | ConfigWire): ProviderState;
-//# sourceMappingURL=provider.config.gen.d.ts.map

package/dist/provider.config.gen.js

@@ -1,40 +0,0 @@
-// Code generated by protoc-gen-kit-typescript. DO NOT EDIT.
-// source: kit/providers/modal/v1/provider.proto + specs/providers/modal.yaml
-import { ErrorKind, materializeClientConfig, sandboxError, validateConfig, } from "@sandbox-kit/sandbox";
-import { mapClientScope, mapOAuthAuth, mapTokenPairCredentials } from "./provider.mappings.gen.js";
-export function mapGeneratedClientConfig(config) {
-    let source = config;
-    validateConfig(source, "modal", "initialize");
-    const target = {};
-    if (source.endpoint !== undefined)
-        unsupported("endpoint", "Endpoint cannot be configured through this SDK's public client constructor");
-    if (source.scope !== undefined) {
-        const mapped = mapClientScope(source.scope, "initialize");
-        Object.assign(target, mapped);
-        if (source.scope.organizationId !== undefined)
-            unsupported("scope.organizationId", "unsupported client configuration field");
-        if (source.scope.projectId !== undefined)
-            unsupported("scope.projectId", "unsupported client configuration field");
-    }
-    const credentials = source.auth?.credentials;
-    if (credentials?.case === "tokenPair") {
-        const mapped = mapTokenPairCredentials(credentials.value, "initialize");
-        Object.assign(target, mapped);
-    }
-    else if (credentials?.case === "oauthRefresh") {
-        const mapped = mapOAuthAuth(credentials.value, "initialize");
-        Object.assign(target, mapped);
-    }
-    else if (credentials?.case !== undefined) {
-        unsupported("auth", "unsupported authentication mode");
-    }
-    return target;
-}
-export function captureProviderState(config) {
-    const source = materializeClientConfig(config);
-    return {
-        ...(source.scope === undefined ? {} : { scope: structuredClone(source.scope) }),
-        ...(source.region === undefined ? {} : { region: source.region }),
-    };
-}
-function unsupported(field, message) { throw sandboxError({ kind: ErrorKind.Unsupported, provider: "modal", operation: "initialize", field, message: "sandbox-kit modal: " + message }); }

package/dist/provider.errors.gen.d.ts

@@ -1,3 +0,0 @@
-import { SandboxError } from "@sandbox-kit/sandbox";
-export declare function mapModalError(error: unknown, operation: string): SandboxError;
-//# sourceMappingURL=provider.errors.gen.d.ts.map

package/dist/provider.errors.gen.js

@@ -1,36 +0,0 @@
-// Code generated by protoc-gen-kit-typescript. DO NOT EDIT.
-// source: kit/providers/modal/v1/provider.proto + specs/providers/modal.yaml
-import { AlreadyExistsError, ClientClosedError, ConflictError, InvalidError, NotFoundError, ResourceExhaustedError, SandboxTimeoutError, TimeoutError } from "modal";
-import { ErrorKind, SandboxError, sandboxError } from "@sandbox-kit/sandbox";
-export function mapModalError(error, operation) {
-    if (error instanceof SandboxError)
-        return error;
-    if (error instanceof DOMException && error.name === "AbortError")
-        return create(ErrorKind.Canceled, error, operation);
-    if (error instanceof DOMException && error.name === "TimeoutError")
-        return create(ErrorKind.Timeout, error, operation);
-    let kind = ErrorKind.Unknown;
-    if (kind === ErrorKind.Unknown && error instanceof InvalidError)
-        kind = ErrorKind.InvalidArgument;
-    if (kind === ErrorKind.Unknown && error instanceof NotFoundError)
-        kind = ErrorKind.NotFound;
-    if (kind === ErrorKind.Unknown && error instanceof AlreadyExistsError)
-        kind = ErrorKind.AlreadyExists;
-    if (kind === ErrorKind.Unknown && error instanceof ConflictError)
-        kind = ErrorKind.Conflict;
-    if (kind === ErrorKind.Unknown && error instanceof ResourceExhaustedError)
-        kind = ErrorKind.ResourceExhausted;
-    if (kind === ErrorKind.Unknown && error instanceof TimeoutError)
-        kind = ErrorKind.Timeout;
-    if (kind === ErrorKind.Unknown && error instanceof SandboxTimeoutError)
-        kind = ErrorKind.Timeout;
-    if (kind === ErrorKind.Unknown && error instanceof ClientClosedError)
-        kind = ErrorKind.FailedPrecondition;
-    let statusCode;
-    let providerCode;
-    let providerSource;
-    return create(kind, error, operation, statusCode, providerCode, providerSource);
-}
-function create(kind, error, operation, statusCode, providerCode, providerSource) {
-    return sandboxError({ kind, provider: "modal", operation, field: "", message: error instanceof Error ? error.message : "sandbox-kit modal: provider operation failed", ...(statusCode === undefined ? {} : { statusCode }), ...(providerCode === undefined ? {} : { providerCode }), ...(providerSource === undefined ? {} : { providerSource }) }, error);
-}

package/dist/provider.gen.d.ts

@@ -1,14 +0,0 @@
-import type { Backend, ConfigWire, CreateOptionsWire, CreateResult, OperationOptions, Provider } from "@sandbox-kit/sandbox";
-export declare const providerName: "modal";
-/** @internal Shared generated provider identity wiring. */
-export declare abstract class ProviderBase implements Provider {
-    readonly name: "modal";
-    abstract initialize(config: ConfigWire): Backend;
-}
-/** @internal Shared generated backend identity and required operation surface. */
-export declare abstract class BackendBase implements Backend {
-    readonly name: "modal";
-    abstract create(request: CreateOptionsWire, options: OperationOptions): Promise<CreateResult>;
-    abstract close(options: OperationOptions): Promise<void>;
-}
-//# sourceMappingURL=provider.gen.d.ts.map

package/dist/provider.gen.js

@@ -1,11 +0,0 @@
-// Code generated by protoc-gen-kit-typescript. DO NOT EDIT.
-// source: kit/providers/modal/v1/provider.proto + specs/providers/modal.yaml
-export const providerName = "modal";
-/** @internal Shared generated provider identity wiring. */
-export class ProviderBase {
-    name = providerName;
-}
-/** @internal Shared generated backend identity and required operation surface. */
-export class BackendBase {
-    name = providerName;
-}

package/dist/provider.mappings.gen.d.ts

@@ -1,11 +0,0 @@
-import { type AutomaticAction, type CreateOptionsWire, type LifetimePolicy, type OAuthCredentials, type Resources, type SandboxInfo, type Scope, type TokenPairCredentials } from "@sandbox-kit/sandbox";
-import type { ModalClientParams as NativeModalClientParams, Sandbox as NativeSandbox, SandboxCreateParams as NativeSandboxCreateParams } from "modal";
-export declare function mapSandboxIdentity(source: NativeSandbox | undefined, operation?: string): Partial<SandboxInfo>;
-export declare function mapClientScope(source: Scope | undefined, operation?: string): NativeModalClientParams;
-export declare function mapCommonCreateFields(source: CreateOptionsWire | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapResources(source: Resources | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapLifetimeDuration(source: LifetimePolicy | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapIdleDuration(source: AutomaticAction | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapTokenPairCredentials(source: TokenPairCredentials | undefined, operation?: string): NativeModalClientParams;
-export declare function mapOAuthAuth(source: OAuthCredentials | undefined, operation?: string): NativeModalClientParams;
-//# sourceMappingURL=provider.mappings.gen.d.ts.map

package/dist/provider.mappings.gen.js

@@ -1,161 +0,0 @@
-// Code generated by protoc-gen-kit-typescript. DO NOT EDIT.
-// source: kit/providers/modal/v1/provider.proto + specs/providers/modal.yaml
-import { durationMs } from "@bufbuild/protobuf/wkt";
-import { ErrorKind, PolicyMode, ValueOrigin, sandboxError } from "@sandbox-kit/sandbox";
-export function mapSandboxIdentity(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    const origins = {};
-    target.origins = origins;
-    {
-        if (source.sandboxId !== undefined) {
-            const value = source.sandboxId;
-            target.id = value;
-            origins["id"] = ValueOrigin.Provider;
-        }
-    }
-    target.provider = "modal";
-    return target;
-}
-export function mapClientScope(source, operation = "initialize") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.environment !== undefined) {
-            const value = source.environment;
-            target.environment = value;
-        }
-    }
-    return target;
-}
-export function mapCommonCreateFields(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.name !== undefined) {
-            const value = source.name;
-            target.name = value;
-        }
-    }
-    {
-        if (source.environment !== undefined) {
-            const value = source.environment;
-            target.env = { ...value };
-        }
-    }
-    {
-        if (source.labels !== undefined) {
-            const value = source.labels;
-            target.tags = { ...value };
-        }
-    }
-    return target;
-}
-export function mapResources(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.cpuCores !== undefined) {
-            const value = source.cpuCores;
-            target.cpu = value;
-        }
-    }
-    {
-        if (source.cpuLimitCores !== undefined) {
-            const value = source.cpuLimitCores;
-            target.cpuLimit = value;
-        }
-    }
-    {
-        if (source.memoryMib !== undefined) {
-            const value = source.memoryMib;
-            if (value > 2147483647n)
-                mappingError(ErrorKind.InvalidArgument, "resources.memory_mib", "memory_mib cannot be represented", operation);
-            target.memoryMiB = Number(value);
-        }
-    }
-    {
-        if (source.memoryLimitMib !== undefined) {
-            const value = source.memoryLimitMib;
-            if (value > 2147483647n)
-                mappingError(ErrorKind.InvalidArgument, "resources.memory_limit_mib", "memory_limit_mib cannot be represented", operation);
-            target.memoryLimitMiB = Number(value);
-        }
-    }
-    return target;
-}
-export function mapLifetimeDuration(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.maximumLifetime !== undefined) {
-            const value = durationMs(source.maximumLifetime);
-            if (value > 86400000)
-                mappingError(ErrorKind.InvalidArgument, "lifetime.maximum_lifetime", "maximum_lifetime cannot be represented", operation);
-            target.timeoutMs = value;
-        }
-    }
-    return target;
-}
-export function mapIdleDuration(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.after !== undefined) {
-            const value = durationMs(source.after);
-            if (value > 4294967295000)
-                mappingError(ErrorKind.InvalidArgument, "lifetime.idle_terminate.after", "after cannot be represented", operation);
-            target.idleTimeoutMs = value;
-        }
-    }
-    return target;
-}
-export function mapTokenPairCredentials(source, operation = "initialize") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        const value = source.id;
-        target.tokenId = value;
-    }
-    {
-        const value = source.secret;
-        target.tokenSecret = value;
-    }
-    return target;
-}
-export function mapOAuthAuth(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        const value = source.refreshToken;
-        target.oauthRefreshToken = value;
-    }
-    {
-        const value = source.clientId;
-        target.oauthClientId = value;
-    }
-    {
-        if (source.clientSecret !== undefined) {
-            const value = source.clientSecret;
-            target.oauthClientSecret = value;
-        }
-    }
-    {
-        if (source.jwtKey !== undefined) {
-            const value = source.jwtKey;
-            target.oauthJwtKey = value;
-        }
-    }
-    return target;
-}
-function mappingError(kind, field, message, operation) {
-    throw sandboxError({ kind, provider: "modal", operation, field, message: "sandbox-kit modal: " + message });
-}

package/dist/provider_checks.d.ts

@@ -1,3 +0,0 @@
-import type { CreateOptions } from "@sandbox-kit/sandbox";
-export declare function validateProviderCreate(request: CreateOptions): void;
-//# sourceMappingURL=provider_checks.d.ts.map

package/dist/provider_checks.js

@@ -1,106 +0,0 @@
-import { ErrorKind, sandboxError } from "@sandbox-kit/sandbox";
-// validateProviderCreate rejects creation settings this provider cannot honor.
-// Rules are inventoried in specs/providers/modal.yaml checks.
-export function validateProviderCreate(request) {
-    const cpuCores = request.resources?.cpuCores;
-    if (cpuCores !== undefined && cpuCores < 0.125) {
-        fail(ErrorKind.InvalidArgument, "resources.cpuCores", "resources.cpu_cores is outside supported values");
-    }
-    const memoryMib = request.resources?.memoryMib;
-    if (memoryMib !== undefined && memoryMib < BigInt("128")) {
-        fail(ErrorKind.InvalidArgument, "resources.memoryMib", "resources.memory_mib is outside supported values");
-    }
-    const workingDirectory = request.runtime?.workingDirectory;
-    if (workingDirectory !== undefined && !workingDirectory.startsWith("/")) {
-        fail(ErrorKind.InvalidArgument, "runtime.workingDirectory", "runtime.working_directory is outside supported values");
-    }
-    const cloud = request.placement?.cloud;
-    if (cloud !== undefined &&
-        cloud !== "aws" &&
-        cloud !== "gcp" &&
-        cloud !== "oci" &&
-        cloud !== "auto") {
-        fail(ErrorKind.Unsupported, "placement.cloud", "placement.cloud is outside supported values");
-    }
-    for (const value of request.network?.outboundCidrs ?? []) {
-        if (value !== "" && !validCidr(value)) {
-            fail(ErrorKind.InvalidArgument, "network.outboundCidrs.entries", "network.outbound_cidrs.entries is outside supported values");
-        }
-    }
-    for (const value of request.network?.inboundCidrs ?? []) {
-        if (!validCidr(value)) {
-            fail(ErrorKind.InvalidArgument, "network.inboundCidrs.entries", "network.inbound_cidrs.entries is outside supported values");
-        }
-    }
-    for (const value of request.network?.outboundDomains ?? []) {
-        if (value !== "" && !validDomain(value)) {
-            fail(ErrorKind.InvalidArgument, "network.outboundDomains.entries", "network.outbound_domains.entries is outside supported values");
-        }
-    }
-    for (const value of Object.keys(request.environment ?? {})) {
-        if (!validEnvName(value)) {
-            fail(ErrorKind.InvalidArgument, "environment", "environment is outside supported values");
-        }
-    }
-}
-function validEnvName(value) {
-    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(value);
-}
-function validDomain(value) {
-    const domain = value.startsWith("*.") ? value.slice(2) : value;
-    return (domain.length <= 253 &&
-        /^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.?$/i.test(domain));
-}
-function validCidr(value) {
-    const separator = value.lastIndexOf("/");
-    if (separator <= 0)
-        return false;
-    const address = value.slice(0, separator);
-    const prefix = Number(value.slice(separator + 1));
-    if (!Number.isInteger(prefix))
-        return false;
-    return address.includes(":")
-        ? prefix >= 0 && prefix <= 128 && validIpv6(address)
-        : prefix >= 0 && prefix <= 32 && validIpv4(address);
-}
-function validIpv4(value) {
-    const parts = value.split(".");
-    return (parts.length === 4 &&
-        parts.every((part) => /^(0|[1-9][0-9]{0,2})$/.test(part) && Number(part) <= 255));
-}
-function validIpv6(value) {
-    if ((value.match(/::/g)?.length ?? 0) > 1)
-        return false;
-    const halves = value.split("::");
-    if (halves.length > 2)
-        return false;
-    const count = (part) => {
-        if (part === "")
-            return 0;
-        const groups = part.split(":");
-        let total = 0;
-        for (const group of groups) {
-            if (/^[0-9a-f]{1,4}$/i.test(group))
-                total++;
-            else if (validIpv4(group))
-                total += 2;
-            else
-                return undefined;
-        }
-        return total;
-    };
-    const left = count(halves[0] ?? "");
-    const right = count(halves[1] ?? "");
-    return (left !== undefined &&
-        right !== undefined &&
-        (halves.length === 2 ? left + right < 8 : left === 8));
-}
-function fail(kind, field, message) {
-    throw sandboxError({
-        kind,
-        provider: "modal",
-        operation: "create",
-        field,
-        message: "sandbox-kit modal: " + message,
-    });
-}

package/dist/provider_config.d.ts

@@ -1,9 +0,0 @@
-import type { ModalClientParams as NativeClientConfig } from "modal";
-import { type Config, type Scope } from "@sandbox-kit/sandbox";
-export declare function mapGeneratedClientConfig(config: Config): NativeClientConfig;
-export interface ProviderState {
-    readonly scope?: Scope;
-    readonly region?: string;
-}
-export declare function captureProviderState(config: Config): ProviderState;
-//# sourceMappingURL=provider_config.d.ts.map

package/dist/provider_config.js

@@ -1,46 +0,0 @@
-// Client configuration composition for the native SDK constructor.
-// Kept in sync with specs/providers/modal.yaml client: rules (not emitted).
-import { ErrorKind, sandboxError, validateConfig, } from "@sandbox-kit/sandbox";
-import { mapClientScope, mapOAuthAuth, mapTokenPairCredentials, } from "./provider_mappings.js";
-export function mapGeneratedClientConfig(config) {
-    const source = config;
-    validateConfig(source, "modal", "initialize");
-    const target = {};
-    if (source.endpoint !== undefined)
-        unsupported("endpoint", "Endpoint cannot be configured through this SDK's public client constructor");
-    if (source.scope !== undefined) {
-        const mapped = mapClientScope(source.scope, "initialize");
-        Object.assign(target, mapped);
-        if (source.scope.organizationId !== undefined)
-            unsupported("scope.organizationId", "unsupported client configuration field");
-        if (source.scope.projectId !== undefined)
-            unsupported("scope.projectId", "unsupported client configuration field");
-    }
-    if (source.auth?.tokenPair !== undefined) {
-        Object.assign(target, mapTokenPairCredentials(source.auth.tokenPair, "initialize"));
-    }
-    else if (source.auth?.oauthRefresh !== undefined) {
-        Object.assign(target, mapOAuthAuth(source.auth.oauthRefresh, "initialize"));
-    }
-    else if (source.auth !== undefined) {
-        unsupported("auth", "unsupported authentication mode");
-    }
-    return target;
-}
-export function captureProviderState(config) {
-    return {
-        ...(config.scope === undefined
-            ? {}
-            : { scope: structuredClone(config.scope) }),
-        ...(config.region === undefined ? {} : { region: config.region }),
-    };
-}
-function unsupported(field, message) {
-    throw sandboxError({
-        kind: ErrorKind.Unsupported,
-        provider: "modal",
-        operation: "initialize",
-        field,
-        message: "sandbox-kit modal: " + message,
-    });
-}

package/dist/provider_mappings.d.ts

@@ -1,15 +0,0 @@
-import { type SandboxInfo, type Scope } from "@sandbox-kit/sandbox";
-import type { CreateOptions, OAuthCredentials, Resources, TokenPairCredentials } from "@sandbox-kit/sandbox";
-import type { ModalClientParams as NativeModalClientParams, Sandbox as NativeSandbox, SandboxCreateParams as NativeSandboxCreateParams } from "modal";
-type PublicLifetime = NonNullable<CreateOptions["lifetime"]>;
-type PublicIdleTerminate = NonNullable<PublicLifetime["idleTerminate"]>;
-export declare function mapSandboxIdentity(source: NativeSandbox | undefined, operation?: string): Partial<SandboxInfo>;
-export declare function mapClientScope(source: Scope | undefined, operation?: string): NativeModalClientParams;
-export declare function mapCommonCreateFields(source: CreateOptions | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapResources(source: Resources | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapLifetimeDuration(source: PublicLifetime | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapIdleDuration(source: PublicIdleTerminate | undefined, operation?: string): NativeSandboxCreateParams;
-export declare function mapTokenPairCredentials(source: TokenPairCredentials | undefined, operation?: string): NativeModalClientParams;
-export declare function mapOAuthAuth(source: OAuthCredentials | undefined, operation?: string): NativeModalClientParams;
-export {};
-//# sourceMappingURL=provider_mappings.d.ts.map

package/dist/provider_mappings.js

@@ -1,179 +0,0 @@
-// Provider field mappings between shared CreateOptions/Config and the native SDK.
-// Inventoried in specs/providers/modal.yaml groups; kept in sync by hand (not emitted).
-import { ErrorKind, ValueOrigin, sandboxError } from "@sandbox-kit/sandbox";
-export function mapSandboxIdentity(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    const origins = {};
-    target.origins = origins;
-    {
-        if (source.sandboxId !== undefined) {
-            const value = source.sandboxId;
-            target.id = value;
-            origins["id"] = ValueOrigin.Provider;
-        }
-    }
-    target.provider = "modal";
-    return target;
-}
-export function mapClientScope(source, operation = "initialize") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.environment !== undefined) {
-            const value = source.environment;
-            target.environment = value;
-        }
-    }
-    return target;
-}
-export function mapCommonCreateFields(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.name !== undefined) {
-            const value = source.name;
-            target.name = value;
-        }
-    }
-    {
-        if (source.environment !== undefined) {
-            const value = source.environment;
-            target.env = { ...value };
-        }
-    }
-    {
-        if (source.labels !== undefined) {
-            const value = source.labels;
-            target.tags = { ...value };
-        }
-    }
-    return target;
-}
-export function mapResources(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.cpuCores !== undefined) {
-            target.cpu = scaledCpuCores(source.cpuCores, "resources.cpu_cores", operation);
-        }
-    }
-    {
-        if (source.cpuLimitCores !== undefined) {
-            target.cpuLimit = scaledCpuCores(source.cpuLimitCores, "resources.cpu_limit_cores", operation);
-        }
-    }
-    {
-        if (source.memoryMib !== undefined) {
-            const value = source.memoryMib;
-            if (value > 2147483647n)
-                mappingError(ErrorKind.InvalidArgument, "resources.memory_mib", "memory_mib cannot be represented", operation);
-            target.memoryMiB = Number(value);
-        }
-    }
-    {
-        if (source.memoryLimitMib !== undefined) {
-            const value = source.memoryLimitMib;
-            if (value > 2147483647n)
-                mappingError(ErrorKind.InvalidArgument, "resources.memory_limit_mib", "memory_limit_mib cannot be represented", operation);
-            target.memoryLimitMiB = Number(value);
-        }
-    }
-    return target;
-}
-export function mapLifetimeDuration(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.maximumLifetime !== undefined) {
-            target.timeoutMs = durationSecondsMs(source.maximumLifetime, "lifetime.maximum_lifetime", 86_400, operation);
-        }
-    }
-    return target;
-}
-export function mapIdleDuration(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        if (source.after !== undefined) {
-            target.idleTimeoutMs = durationSecondsMs(source.after, "lifetime.idle_terminate.after", 4_294_967_295, operation);
-        }
-    }
-    return target;
-}
-/** Modal CPU fields are millis-scaled: value must equal round(value*1000)/1000. */
-function scaledCpuCores(value, field, operation) {
-    const scaled = Math.round(value * 1000);
-    if (!Number.isFinite(value) ||
-        value < 0 ||
-        value !== scaled / 1000 ||
-        scaled > 4_294_967_295) {
-        mappingError(ErrorKind.InvalidArgument, field, field.slice(field.lastIndexOf(".") + 1) + " cannot be represented", operation);
-    }
-    return value * 1000 < scaled ? scaled / 1000 : value;
-}
-/** Modal lifetime/idle timeouts are whole seconds expressed as milliseconds. */
-function durationSecondsMs(value, field, maximumSeconds, operation) {
-    if (!Number.isFinite(value) ||
-        value <= 0 ||
-        value % 1000 !== 0 ||
-        value / 1000 > maximumSeconds) {
-        mappingError(ErrorKind.InvalidArgument, field, field.slice(field.lastIndexOf(".") + 1) + " cannot be represented", operation);
-    }
-    return value;
-}
-export function mapTokenPairCredentials(source, operation = "initialize") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        const value = source.id;
-        target.tokenId = value;
-    }
-    {
-        const value = source.secret;
-        target.tokenSecret = value;
-    }
-    return target;
-}
-export function mapOAuthAuth(source, operation = "create") {
-    const target = {};
-    if (source === undefined)
-        return target;
-    {
-        const value = source.refreshToken;
-        target.oauthRefreshToken = value;
-    }
-    {
-        const value = source.clientId;
-        target.oauthClientId = value;
-    }
-    {
-        if (source.clientSecret !== undefined) {
-            const value = source.clientSecret;
-            target.oauthClientSecret = value;
-        }
-    }
-    {
-        if (source.jwtKey !== undefined) {
-            const value = source.jwtKey;
-            target.oauthJwtKey = value;
-        }
-    }
-    return target;
-}
-function mappingError(kind, field, message, operation) {
-    throw sandboxError({
-        kind,
-        provider: "modal",
-        operation,
-        field,
-        message: "sandbox-kit modal: " + message,
-    });
-}