@secure-exec/core 0.2.1-rc.1 → 0.3.0-rc.1

package/dist/types.d.ts

@@ -1,98 +0,0 @@
-/**
- * Core-only types for secure-exec SDK.
- *
- * VFS and permission types are now defined in src/kernel/ (canonical source).
- */
-export interface SpawnedProcess {
-    writeStdin(data: Uint8Array | string): void;
-    closeStdin(): void;
-    kill(signal?: number): void;
-    wait(): Promise<number>;
-}
-export interface CommandExecutor {
-    spawn(command: string, args: string[], options: {
-        cwd?: string;
-        env?: Record<string, string>;
-        streamStdin?: boolean;
-        onStdout?: (data: Uint8Array) => void;
-        onStderr?: (data: Uint8Array) => void;
-    }): SpawnedProcess;
-}
-export interface NetworkServerAddress {
-    address: string;
-    family: string;
-    port: number;
-}
-export interface NetworkServerRequest {
-    method: string;
-    url: string;
-    headers: Record<string, string>;
-    rawHeaders: string[];
-    bodyBase64?: string;
-}
-export interface NetworkServerResponse {
-    status: number;
-    headers?: Array<[string, string]>;
-    body?: string;
-    bodyEncoding?: "utf8" | "base64";
-}
-export interface NetworkServerListenOptions {
-    serverId: number;
-    port?: number;
-    hostname?: string;
-    onRequest(request: NetworkServerRequest): Promise<NetworkServerResponse> | NetworkServerResponse;
-    /** Called when an HTTP upgrade request arrives (e.g. WebSocket). */
-    onUpgrade?(request: NetworkServerRequest, head: string, socketId: number): void;
-    /** Called when the real upgrade socket receives data from the remote peer. */
-    onUpgradeSocketData?(socketId: number, dataBase64: string): void;
-    /** Called when the real upgrade socket closes. */
-    onUpgradeSocketEnd?(socketId: number): void;
-}
-export interface NetworkAdapter {
-    fetch(url: string, options: {
-        method?: string;
-        headers?: Record<string, string>;
-        body?: string | null;
-    }): Promise<{
-        ok: boolean;
-        status: number;
-        statusText: string;
-        headers: Record<string, string>;
-        body: string;
-        url: string;
-        redirected: boolean;
-    }>;
-    dnsLookup(hostname: string): Promise<{
-        address: string;
-        family: number;
-    } | {
-        error: string;
-        code: string;
-    }>;
-    httpRequest(url: string, options: {
-        method?: string;
-        headers?: Record<string, string>;
-        body?: string | null;
-        rejectUnauthorized?: boolean;
-    }): Promise<{
-        status: number;
-        statusText: string;
-        headers: Record<string, string>;
-        body: string;
-        url: string;
-        trailers?: Record<string, string>;
-        upgradeSocketId?: number;
-    }>;
-    /** Write data from the sandbox to a real upgrade socket on the host. */
-    upgradeSocketWrite?(socketId: number, dataBase64: string): void;
-    /** End a real upgrade socket on the host. */
-    upgradeSocketEnd?(socketId: number): void;
-    /** Destroy a real upgrade socket on the host. */
-    upgradeSocketDestroy?(socketId: number): void;
-    /** Register callbacks for client-side upgrade socket data push. */
-    setUpgradeSocketCallbacks?(callbacks: {
-        onData: (socketId: number, dataBase64: string) => void;
-        onEnd: (socketId: number) => void;
-    }): void;
-}
-export type { DriverRuntimeConfig, NodeRuntimeDriver, NodeRuntimeDriverFactory, PythonRuntimeDriver, PythonRuntimeDriverFactory, RuntimeDriver, RuntimeDriverFactory, RuntimeDriverOptions, SharedRuntimeDriver, SystemDriver, } from "./runtime-driver.js";

package/dist/types.js

@@ -1,6 +0,0 @@
-/**
- * Core-only types for secure-exec SDK.
- *
- * VFS and permission types are now defined in src/kernel/ (canonical source).
- */
-export {};

package/dist/vfs/chunked-vfs.d.ts

@@ -1,66 +0,0 @@
-/**
- * ChunkedVFS: composes FsMetadataStore + FsBlockStore into a VirtualFileSystem.
- *
- * Tiered storage: files <= inlineThreshold are stored inline in metadata;
- * larger files are split into fixed-size chunks in the block store.
- * Per-inode async mutex prevents interleaved read-modify-write corruption.
- *
- * Optional write buffering: when enabled, pwrite buffers dirty chunks in
- * memory and flushes to the block store on fsync or auto-flush. Reads
- * always see buffered data. When disabled (default), writes go directly
- * to the block store.
- */
-import type { VirtualFileSystem } from "../kernel/vfs.js";
-import type { FsBlockStore, FsMetadataStore, RetentionPolicy, VersionInfo } from "./types.js";
-/**
- * Configuration for creating a ChunkedVFS instance via `createChunkedVfs()`.
- *
- * Requires a metadata store (directory tree, inodes) and a block store
- * (key-value blob storage). Optional settings control tiered storage
- * thresholds, write buffering, and versioning behavior.
- */
-export interface ChunkedVfsOptions {
-    metadata: FsMetadataStore;
-    blocks: FsBlockStore;
-    /** Chunk size in bytes. Default: 4 MB. */
-    chunkSize?: number;
-    /** Max file size for inline storage. Default: 64 KB. */
-    inlineThreshold?: number;
-    /**
-     * Enable write buffering. When true, pwrite buffers dirty chunks in
-     * memory and flushes to the block store on fsync or auto-flush.
-     * When false, every pwrite immediately writes to the block store.
-     * Default: false.
-     */
-    writeBuffering?: boolean;
-    /**
-     * Auto-flush interval in ms. Only applies when writeBuffering is true.
-     * Dirty chunks are flushed to the block store on this interval.
-     * Default: 1000 (1 second).
-     */
-    autoFlushIntervalMs?: number;
-    /**
-     * Enable file versioning. When true, block keys use the format
-     * {ino}/{chunkIndex}/{randomId} so old blocks are never overwritten.
-     * The metadata store must implement FsMetadataStoreVersioning.
-     * Default: false.
-     */
-    versioning?: boolean;
-}
-/**
- * Extended return type when versioning is enabled.
- * Exposes the versioning API alongside the VirtualFileSystem.
- */
-export interface ChunkedVfsVersioning {
-    /** Snapshot current state. Returns version number. */
-    createVersion(path: string): Promise<number>;
-    /** List all versions of a file, newest first. */
-    listVersions(path: string): Promise<VersionInfo[]>;
-    /** Restore file to a previous version. */
-    restoreVersion(path: string, version: number): Promise<void>;
-    /** Prune old versions according to policy. Returns count of versions pruned. */
-    pruneVersions(path: string, policy: RetentionPolicy): Promise<number>;
-    /** Find and delete orphaned blocks. Returns count of blocks deleted. */
-    collectGarbage(): Promise<number>;
-}
-export declare function createChunkedVfs(options: ChunkedVfsOptions): VirtualFileSystem;