fix: Make SandboxExecuteResponse's run field nullable to match compile

Co-Authored-By: Claude <noreply@anthropic.com>

Author: koki-develop

typescript/CLAUDE.md

@@ -33,15 +33,21 @@ npx tsc --noEmit
 
 tsc is type-check only (`noEmit: true`). tsdown handles the actual compilation and emit.
 
-## Testing / Linting
+## Testing
 
-No test framework or linting tools are configured yet. `CodizeClient` accepts a `fetchFn` option for future test mocking.
+**Vitest** is the test framework. Test files use the `*.spec.ts` naming convention and live alongside source files in `src/`.
+
+```sh
+bun test   # run all tests via vitest
+```
+
+`CodizeClient` accepts a `fetchFn` option for injecting a mock `fetch` in tests.
 
 ## Architecture
 
 Three source files:
 
-- **`src/client.ts`** — `CodizeClient` class. Takes `{ apiKey, fetchFn? }`. Makes `POST https://codize.dev/api/v1/sandbox/execute` with Bearer auth. Returns `SandboxExecuteResponse` containing `data.compile` (nullable) and `data.run` stage results plus `headers`.
+- **`src/client.ts`** — `CodizeClient` class. Takes `{ apiKey, fetchFn? }`. Makes `POST https://codize.dev/api/v1/sandbox/execute` with Bearer auth. Returns `SandboxExecuteResponse` containing `data.compile` (nullable) and `data.run` (nullable) stage results plus `headers`.
 - **`src/error.ts`** — `CodizeApiError` class. Thrown on non-2xx responses. Parses error body using valibot's `apiErrorResponseSchema`. Exposes `.code`, `.status`, `.headers`, `.errors`.
 - **`src/index.ts`** — Barrel file re-exporting all public types and classes from `client.ts` and `error.ts`.
 

typescript/src/client.spec.ts

@@ -153,6 +153,18 @@ describe("CodizeClient", () => {
         expect(result.data.compile).toBeNull();
       });
 
+      it("returns run as null when the API returns null", async () => {
+        const body = {
+          compile: null,
+          run: null,
+        };
+        const fetchFn = vi.fn().mockResolvedValue(makeJsonResponse(body));
+        const client = new CodizeClient({ apiKey: "key", fetchFn });
+        const result = await client.sandbox.execute(sampleRequest);
+
+        expect(result.data.run).toBeNull();
+      });
+
       it("returns the response headers", async () => {
         const fetchFn = vi.fn().mockResolvedValue(
           makeJsonResponse(

typescript/src/client.ts

@@ -71,7 +71,7 @@ export type SandboxExecuteResponse = {
     /**
      * Run-stage output.
      */
-    run: SandboxStageResult;
+    run: SandboxStageResult | null;
   };
 };
 
@@ -182,13 +182,13 @@ export class CodizeClient {
 
     const data = (await response.json()) as {
       compile: RawStageResult | null;
-      run: RawStageResult;
+      run: RawStageResult | null;
     };
     return {
       headers: response.headers,
       data: {
         compile: data.compile ? mapStageResult(data.compile) : null,
-        run: mapStageResult(data.run),
+        run: data.run ? mapStageResult(data.run) : null,
       },
     };
   }