@nahisaho/katashiro-sandbox 0.4.0

package/dist/local-executor.d.ts

@@ -0,0 +1,64 @@
+/**
+ * KATASHIRO Sandbox - Local Executor Implementation
+ *
+ * @fileoverview REQ-007: ローカル環境でのコード実行（開発/テスト用）
+ * @module @nahisaho/katashiro-sandbox
+ * @since 0.4.0
+ */
+import { EventEmitter } from 'events';
+import { type Result } from '@nahisaho/katashiro-core';
+import type { SandboxConfig, ExecutionRequest, ExecutionResult, SupportedLanguage, SandboxEventType, SandboxEventListener } from './types';
+import { SandboxError } from './docker-executor';
+/**
+ * Local Executor（開発/テスト用）
+ *
+ * 注意: このExecutorはホストシステムで直接コードを実行するため、
+ * 本番環境では使用しないでください。開発とテスト目的専用です。
+ */
+export declare class LocalExecutor extends EventEmitter {
+    private readonly config;
+    private readonly activeProcesses;
+    private readonly tempDir;
+    constructor(config?: Partial<SandboxConfig>);
+    /**
+     * 型安全なイベントリスナー登録
+     */
+    on(event: SandboxEventType, listener: SandboxEventListener): this;
+    /**
+     * イベント発火
+     */
+    private emitEvent;
+    /**
+     * コードを実行
+     */
+    execute(code: string, language: SupportedLanguage, options?: Partial<Pick<ExecutionRequest, 'stdin' | 'env' | 'timeout'>>): Promise<Result<ExecutionResult, SandboxError>>;
+    /**
+     * 言語に対応する拡張子を取得
+     */
+    private getExtension;
+    /**
+     * コマンドを構築
+     */
+    private buildCommand;
+    /**
+     * プロセスを実行
+     */
+    private runProcess;
+    /**
+     * エラーをパース
+     */
+    private parseError;
+    /**
+     * 指定した実行をキャンセル
+     */
+    cancel(requestId: string): boolean;
+    /**
+     * 全アクティブプロセスをクリーンアップ
+     */
+    cleanup(): void;
+    /**
+     * アクティブなプロセス数を取得
+     */
+    getActiveProcessCount(): number;
+}
+//# sourceMappingURL=local-executor.d.ts.map

package/dist/local-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-executor.d.ts","sourceRoot":"","sources":["../src/local-executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAW,KAAK,MAAM,EAAc,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EAEf,iBAAiB,EAEjB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMjD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAM/C;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIjE;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC,CAAM,GACzE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IA8EjD;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,UAAU;IA0DlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASlC;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,qBAAqB,IAAI,MAAM;CAGhC"}

package/dist/local-executor.js

@@ -0,0 +1,242 @@
+"use strict";
+/**
+ * KATASHIRO Sandbox - Local Executor Implementation
+ *
+ * @fileoverview REQ-007: ローカル環境でのコード実行（開発/テスト用）
+ * @module @nahisaho/katashiro-sandbox
+ * @since 0.4.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalExecutor = void 0;
+const child_process_1 = require("child_process");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const os_1 = require("os");
+const events_1 = require("events");
+const katashiro_core_1 = require("@nahisaho/katashiro-core");
+const types_1 = require("./types");
+const docker_executor_1 = require("./docker-executor");
+// =============================================================================
+// Local Executor
+// =============================================================================
+/**
+ * Local Executor（開発/テスト用）
+ *
+ * 注意: このExecutorはホストシステムで直接コードを実行するため、
+ * 本番環境では使用しないでください。開発とテスト目的専用です。
+ */
+class LocalExecutor extends events_1.EventEmitter {
+    config;
+    activeProcesses = new Map();
+    tempDir;
+    constructor(config = {}) {
+        super();
+        this.config = { ...types_1.DEFAULT_SANDBOX_CONFIG, ...config, runtime: 'local' };
+        this.tempDir = (0, path_1.join)((0, os_1.tmpdir)(), 'katashiro-sandbox');
+    }
+    /**
+     * 型安全なイベントリスナー登録
+     */
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    /**
+     * イベント発火
+     */
+    emitEvent(type, data) {
+        const event = {
+            type,
+            timestamp: new Date().toISOString(),
+            ...data,
+        };
+        this.emit(type, event);
+    }
+    /**
+     * コードを実行
+     */
+    async execute(code, language, options = {}) {
+        const requestId = (0, katashiro_core_1.generateId)();
+        const timeout = options.timeout ?? this.config.timeout;
+        const startTime = Date.now();
+        this.emitEvent('execution:start', { requestId });
+        let tempFile;
+        try {
+            // 一時ディレクトリ作成
+            await (0, promises_1.mkdir)(this.tempDir, { recursive: true });
+            // コードを一時ファイルに書き込み
+            tempFile = (0, path_1.join)(this.tempDir, `${requestId}${this.getExtension(language)}`);
+            await (0, promises_1.writeFile)(tempFile, code, 'utf-8');
+            // コマンド構築
+            const { command, args } = this.buildCommand(language, tempFile);
+            // プロセス起動
+            const result = await this.runProcess(requestId, command, args, timeout, options.stdin, options.env);
+            const duration = Date.now() - startTime;
+            const executionResult = {
+                requestId,
+                status: result.exitCode === 0 ? 'completed' : 'failed',
+                exitCode: result.exitCode,
+                stdout: result.stdout,
+                stderr: result.stderr,
+                duration,
+                files: [],
+                completedAt: new Date().toISOString(),
+            };
+            this.emitEvent('execution:complete', { requestId, data: executionResult });
+            return (0, katashiro_core_1.ok)(executionResult);
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const execError = this.parseError(error);
+            const executionResult = {
+                requestId,
+                status: execError.code === 'TIMEOUT' ? 'timeout' : 'failed',
+                exitCode: -1,
+                stdout: '',
+                stderr: execError.message,
+                duration,
+                files: [],
+                error: execError,
+                completedAt: new Date().toISOString(),
+            };
+            if (execError.code === 'TIMEOUT') {
+                this.emitEvent('execution:timeout', { requestId, data: executionResult });
+            }
+            else {
+                this.emitEvent('execution:error', { requestId, data: executionResult });
+            }
+            return (0, katashiro_core_1.err)(new docker_executor_1.SandboxError(execError.message, execError.code, { requestId }));
+        }
+        finally {
+            // 一時ファイル削除
+            if (tempFile) {
+                await (0, promises_1.unlink)(tempFile).catch(() => { });
+            }
+            this.activeProcesses.delete(requestId);
+        }
+    }
+    /**
+     * 言語に対応する拡張子を取得
+     */
+    getExtension(language) {
+        const extensions = {
+            bash: '.sh',
+            python: '.py',
+            javascript: '.js',
+            typescript: '.ts',
+        };
+        return extensions[language];
+    }
+    /**
+     * コマンドを構築
+     */
+    buildCommand(language, filePath) {
+        switch (language) {
+            case 'bash':
+                return { command: 'bash', args: [filePath] };
+            case 'python':
+                return { command: 'python3', args: [filePath] };
+            case 'javascript':
+                return { command: 'node', args: [filePath] };
+            case 'typescript':
+                return { command: 'npx', args: ['tsx', filePath] };
+            default:
+                throw new docker_executor_1.SandboxError(`Unsupported language: ${language}`, 'UNSUPPORTED_LANGUAGE');
+        }
+    }
+    /**
+     * プロセスを実行
+     */
+    runProcess(requestId, command, args, timeout, stdin, env) {
+        return new Promise((resolve, reject) => {
+            const proc = (0, child_process_1.spawn)(command, args, {
+                cwd: this.tempDir,
+                env: { ...process.env, ...env },
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            this.activeProcesses.set(requestId, proc);
+            let stdout = '';
+            let stderr = '';
+            proc.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            // stdin送信
+            if (stdin && proc.stdin) {
+                proc.stdin.write(stdin);
+                proc.stdin.end();
+            }
+            else if (proc.stdin) {
+                proc.stdin.end();
+            }
+            // タイムアウト
+            const timeoutId = setTimeout(() => {
+                proc.kill('SIGKILL');
+                reject(new docker_executor_1.SandboxError('Execution timeout', 'TIMEOUT', { timeout }));
+            }, timeout * 1000);
+            proc.on('close', (code) => {
+                clearTimeout(timeoutId);
+                resolve({
+                    exitCode: code ?? -1,
+                    stdout,
+                    stderr,
+                });
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timeoutId);
+                reject(err);
+            });
+        });
+    }
+    /**
+     * エラーをパース
+     */
+    parseError(error) {
+        if (error instanceof docker_executor_1.SandboxError) {
+            return {
+                code: error.code,
+                message: error.message,
+            };
+        }
+        if (error instanceof Error) {
+            return {
+                code: 'EXECUTION_ERROR',
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        return {
+            code: 'UNKNOWN_ERROR',
+            message: String(error),
+        };
+    }
+    /**
+     * 指定した実行をキャンセル
+     */
+    cancel(requestId) {
+        const proc = this.activeProcesses.get(requestId);
+        if (!proc)
+            return false;
+        proc.kill('SIGKILL');
+        this.activeProcesses.delete(requestId);
+        return true;
+    }
+    /**
+     * 全アクティブプロセスをクリーンアップ
+     */
+    cleanup() {
+        for (const [requestId, proc] of this.activeProcesses) {
+            proc.kill('SIGKILL');
+            this.activeProcesses.delete(requestId);
+        }
+    }
+    /**
+     * アクティブなプロセス数を取得
+     */
+    getActiveProcessCount() {
+        return this.activeProcesses.size;
+    }
+}
+exports.LocalExecutor = LocalExecutor;
+//# sourceMappingURL=local-executor.js.map

package/dist/local-executor.js.map

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

package/dist/sandbox.d.ts

@@ -0,0 +1,104 @@
+/**
+ * KATASHIRO Sandbox - Unified Sandbox Interface
+ *
+ * @fileoverview REQ-007: 統一サンドボックスインターフェース
+ * @module @nahisaho/katashiro-sandbox
+ * @since 0.4.0
+ */
+import type { Result } from '@nahisaho/katashiro-core';
+import type { SandboxConfig, SandboxRuntime, ExecutionResult, SupportedLanguage, ExecutionRequest, SandboxEventType, SandboxEventListener } from './types';
+import { SandboxError } from './docker-executor';
+/**
+ * サンドボックスインターフェース
+ */
+export interface ISandbox {
+    /**
+     * コードを実行
+     */
+    execute(code: string, language: SupportedLanguage, options?: Partial<Pick<ExecutionRequest, 'stdin' | 'env' | 'timeout'>>): Promise<Result<ExecutionResult, SandboxError>>;
+    /**
+     * 指定した実行をキャンセル
+     */
+    cancel(requestId: string): boolean | Promise<boolean>;
+    /**
+     * 全アクティブ実行をクリーンアップ
+     */
+    cleanup(): void | Promise<void>;
+    /**
+     * イベントリスナー登録
+     */
+    on(event: SandboxEventType, listener: SandboxEventListener): this;
+}
+/**
+ * サンドボックスファクトリ
+ *
+ * 環境に応じて適切なExecutorを生成します。
+ */
+export declare class SandboxFactory {
+    /**
+     * サンドボックスを作成
+     *
+     * @param config サンドボックス設定
+     * @param runtime ランタイム（省略時はconfig.runtimeを使用）
+     */
+    static create(config?: Partial<SandboxConfig>, runtime?: SandboxRuntime): ISandbox;
+    /**
+     * Dockerが利用可能か確認
+     */
+    static isDockerAvailable(): Promise<boolean>;
+    /**
+     * 環境に応じて最適なランタイムを自動選択
+     */
+    static autoDetect(): Promise<SandboxRuntime>;
+    /**
+     * 自動検出してサンドボックスを作成
+     */
+    static createAuto(config?: Partial<SandboxConfig>): Promise<ISandbox>;
+}
+/**
+ * コードを実行（簡易関数）
+ *
+ * @example
+ * ```typescript
+ * const result = await executeCode('print("Hello")', 'python');
+ * if (result.isOk()) {
+ *   console.log(result.value.stdout); // "Hello\n"
+ * }
+ * ```
+ */
+export declare function executeCode(code: string, language: SupportedLanguage, options?: {
+    runtime?: SandboxRuntime;
+    timeout?: number;
+    stdin?: string;
+    env?: Record<string, string>;
+}): Promise<Result<ExecutionResult, SandboxError>>;
+/**
+ * Bashスクリプトを実行
+ */
+export declare function executeBash(script: string, options?: {
+    timeout?: number;
+    env?: Record<string, string>;
+}): Promise<Result<ExecutionResult, SandboxError>>;
+/**
+ * Pythonコードを実行
+ */
+export declare function executePython(code: string, options?: {
+    timeout?: number;
+    stdin?: string;
+    env?: Record<string, string>;
+}): Promise<Result<ExecutionResult, SandboxError>>;
+/**
+ * JavaScriptコードを実行
+ */
+export declare function executeJavaScript(code: string, options?: {
+    timeout?: number;
+    env?: Record<string, string>;
+}): Promise<Result<ExecutionResult, SandboxError>>;
+/**
+ * TypeScriptコードを実行
+ */
+export declare function executeTypeScript(code: string, options?: {
+    timeout?: number;
+    env?: Record<string, string>;
+}): Promise<Result<ExecutionResult, SandboxError>>;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

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

package/dist/sandbox.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * KATASHIRO Sandbox - Unified Sandbox Interface
+ *
+ * @fileoverview REQ-007: 統一サンドボックスインターフェース
+ * @module @nahisaho/katashiro-sandbox
+ * @since 0.4.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxFactory = void 0;
+exports.executeCode = executeCode;
+exports.executeBash = executeBash;
+exports.executePython = executePython;
+exports.executeJavaScript = executeJavaScript;
+exports.executeTypeScript = executeTypeScript;
+const types_1 = require("./types");
+const docker_executor_1 = require("./docker-executor");
+const local_executor_1 = require("./local-executor");
+/**
+ * サンドボックスファクトリ
+ *
+ * 環境に応じて適切なExecutorを生成します。
+ */
+class SandboxFactory {
+    /**
+     * サンドボックスを作成
+     *
+     * @param config サンドボックス設定
+     * @param runtime ランタイム（省略時はconfig.runtimeを使用）
+     */
+    static create(config = {}, runtime) {
+        const resolvedRuntime = runtime ?? config.runtime ?? types_1.DEFAULT_SANDBOX_CONFIG.runtime;
+        switch (resolvedRuntime) {
+            case 'docker':
+                return new docker_executor_1.DockerExecutor(config);
+            case 'local':
+                return new local_executor_1.LocalExecutor(config);
+            case 'wasm':
+                throw new docker_executor_1.SandboxError('WASM runtime is not yet implemented', 'NOT_IMPLEMENTED');
+            default:
+                throw new docker_executor_1.SandboxError(`Unknown runtime: ${resolvedRuntime}`, 'UNKNOWN_RUNTIME');
+        }
+    }
+    /**
+     * Dockerが利用可能か確認
+     */
+    static async isDockerAvailable() {
+        try {
+            const Docker = (await import('dockerode')).default;
+            const docker = new Docker();
+            await docker.ping();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 環境に応じて最適なランタイムを自動選択
+     */
+    static async autoDetect() {
+        if (await this.isDockerAvailable()) {
+            return 'docker';
+        }
+        return 'local';
+    }
+    /**
+     * 自動検出してサンドボックスを作成
+     */
+    static async createAuto(config = {}) {
+        const runtime = await this.autoDetect();
+        return this.create(config, runtime);
+    }
+}
+exports.SandboxFactory = SandboxFactory;
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * コードを実行（簡易関数）
+ *
+ * @example
+ * ```typescript
+ * const result = await executeCode('print("Hello")', 'python');
+ * if (result.isOk()) {
+ *   console.log(result.value.stdout); // "Hello\n"
+ * }
+ * ```
+ */
+async function executeCode(code, language, options) {
+    const timeout = options?.timeout ?? types_1.DEFAULT_SANDBOX_CONFIG.timeout;
+    const sandbox = SandboxFactory.create({ timeout }, options?.runtime ?? 'local');
+    try {
+        return await sandbox.execute(code, language, {
+            stdin: options?.stdin,
+            env: options?.env,
+            timeout,
+        });
+    }
+    finally {
+        sandbox.cleanup();
+    }
+}
+/**
+ * Bashスクリプトを実行
+ */
+async function executeBash(script, options) {
+    return executeCode(script, 'bash', options);
+}
+/**
+ * Pythonコードを実行
+ */
+async function executePython(code, options) {
+    return executeCode(code, 'python', options);
+}
+/**
+ * JavaScriptコードを実行
+ */
+async function executeJavaScript(code, options) {
+    return executeCode(code, 'javascript', options);
+}
+/**
+ * TypeScriptコードを実行
+ */
+async function executeTypeScript(code, options) {
+    return executeCode(code, 'typescript', options);
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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