@sandbox-kit/modal 0.0.0-stage → 0.1.0

package/dist/provider.checks.gen.js

@@ -0,0 +1,101 @@
+// 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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,40 @@
+// 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.d.ts

@@ -0,0 +1,13 @@
+import type { Backend, Config, CreateOptions, CreateResult, OperationOptions, Provider } from "@sandbox-kit/sandbox";
+export declare const providerName: "modal";
+/** @internal Shared provider identity wiring. */
+export declare abstract class ProviderBase implements Provider {
+    readonly name: "modal";
+    abstract initialize(config: Config): Backend;
+}
+/** @internal Shared backend identity and required create/close surface. */
+export declare abstract class BackendBase implements Backend {
+    readonly name: "modal";
+    abstract create(request: CreateOptions, options: OperationOptions): Promise<CreateResult>;
+    abstract close(options: OperationOptions): Promise<void>;
+}

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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,36 @@
+// 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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,11 @@
+// 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.js

@@ -0,0 +1,10 @@
+// Modal provider construction and native SDK orchestration are handwritten.
+export const providerName = "modal";
+/** @internal Shared provider identity wiring. */
+export class ProviderBase {
+    name = providerName;
+}
+/** @internal Shared backend identity and required create/close surface. */
+export class BackendBase {
+    name = providerName;
+}

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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,161 @@
+// 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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,106 @@
+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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,46 @@
+// 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

@@ -0,0 +1,15 @@
+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