@sandbox-kit/modal 0.1.0 → 0.1.2

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,
-    });
-}