refactor: migrate to zod v4

Author: cameroncooke

docs/ZOD_MIGRATION_GUIDE.md

@@ -63,7 +63,7 @@
     "@sentry/cli": "^2.43.1",
     "@sentry/node": "^10.5.0",
     "uuid": "^11.1.0",
-    "zod": "^3.24.2"
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@bacons/xcode": "^1.0.0-alpha.24",

package-lock.json

@@ -1,10 +1,12 @@
-import { z } from 'zod';
+import * as z from 'zod';
 import { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
 import { ToolResponse } from '../types/common.ts';
 
+export type ToolSchemaShape = Record<string, z.ZodType>;
+
 export interface PluginMeta {
   readonly name: string; // Verb used by MCP
-  readonly schema: Record<string, z.ZodTypeAny>; // Zod validation schema (object schema)
+  readonly schema: ToolSchemaShape; // Zod validation schema (object schema)
   readonly description?: string; // One-liner shown in help
   readonly annotations?: ToolAnnotations; // MCP tool annotations for LLM behavior hints
   handler(params: Record<string, unknown>): Promise<ToolResponse>;

package.json

@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeEach } from 'vitest';
-import { z } from 'zod';
+import * as z from 'zod';
 
 import simulatorsResource, { simulatorsResourceLogic } from '../simulators.ts';
 import { createMockExecutor } from '../../../test-utils/mock-executors.ts';

src/core/plugin-types.ts

@@ -5,7 +5,7 @@
  */
 
 import { describe, it, expect, beforeEach } from 'vitest';
-import { z } from 'zod';
+import * as z from 'zod';
 import { createMockExecutor, createNoopExecutor } from '../../../../test-utils/mock-executors.ts';
 import buildDevice, { buildDeviceLogic } from '../build_device.ts';
 import { sessionStore } from '../../../../utils/session-store.ts';
@@ -29,7 +29,7 @@ describe('build_device plugin', () => {
     });
 
     it('should expose only optional build-tuning fields in public schema', () => {
-      const schema = z.object(buildDevice.schema).strict();
+      const schema = z.strictObject(buildDevice.schema);
       expect(schema.safeParse({}).success).toBe(true);
       expect(
         schema.safeParse({ derivedDataPath: '/path/to/derived-data', extraArgs: [] }).success,

src/mcp/resources/__tests__/simulators.test.ts

@@ -5,7 +5,7 @@
  */
 
 import { describe, it, expect, beforeEach } from 'vitest';
-import { z } from 'zod';
+import * as z from 'zod';
 import { createMockExecutor } from '../../../../test-utils/mock-executors.ts';
 import getDeviceAppPath, { get_device_app_pathLogic } from '../get_device_app_path.ts';
 import { sessionStore } from '../../../../utils/session-store.ts';
@@ -31,7 +31,7 @@ describe('get_device_app_path plugin', () => {
     });
 
     it('should expose only platform in public schema', () => {
-      const schema = z.object(getDeviceAppPath.schema).strict();
+      const schema = z.strictObject(getDeviceAppPath.schema);
       expect(schema.safeParse({}).success).toBe(true);
       expect(schema.safeParse({ platform: 'iOS' }).success).toBe(true);
       expect(schema.safeParse({ projectPath: '/path/to/project.xcodeproj' }).success).toBe(false);

src/mcp/tools/device/__tests__/build_device.test.ts

@@ -5,7 +5,7 @@
  */
 
 import { describe, it, expect, beforeEach } from 'vitest';
-import { z } from 'zod';
+import * as z from 'zod';
 import { createMockExecutor } from '../../../../test-utils/mock-executors.ts';
 import installAppDevice, { install_app_deviceLogic } from '../install_app_device.ts';
 import { sessionStore } from '../../../../utils/session-store.ts';
@@ -40,7 +40,7 @@ describe('install_app_device plugin', () => {
     });
 
     it('should require appPath in public schema', () => {
-      const schema = z.object(installAppDevice.schema).strict();
+      const schema = z.strictObject(installAppDevice.schema);
       expect(schema.safeParse({ appPath: '/path/to/test.app' }).success).toBe(true);
       expect(schema.safeParse({}).success).toBe(false);
       expect(schema.safeParse({ deviceId: 'test-device-123' }).success).toBe(false);

src/mcp/tools/device/__tests__/get_device_app_path.test.ts

@@ -8,7 +8,7 @@
  */
 
 import { describe, it, expect, beforeEach } from 'vitest';
-import { z } from 'zod';
+import * as z from 'zod';
 import { createMockExecutor } from '../../../../test-utils/mock-executors.ts';
 import launchAppDevice, { launch_app_deviceLogic } from '../launch_app_device.ts';
 import { sessionStore } from '../../../../utils/session-store.ts';
@@ -32,14 +32,14 @@ describe('launch_app_device plugin (device-shared)', () => {
     });
 
     it('should validate schema with valid inputs', () => {
-      const schema = z.object(launchAppDevice.schema).strict();
+      const schema = z.strictObject(launchAppDevice.schema);
       expect(schema.safeParse({ bundleId: 'com.example.app' }).success).toBe(true);
       expect(schema.safeParse({}).success).toBe(false);
       expect(Object.keys(launchAppDevice.schema)).toEqual(['bundleId']);
     });
 
     it('should validate schema with invalid inputs', () => {
-      const schema = z.object(launchAppDevice.schema).strict();
+      const schema = z.strictObject(launchAppDevice.schema);
       expect(schema.safeParse({ bundleId: null }).success).toBe(false);
       expect(schema.safeParse({ bundleId: 123 }).success).toBe(false);
     });

src/mcp/tools/device/__tests__/install_app_device.test.ts

@@ -5,7 +5,7 @@
  */
 
 import { describe, it, expect, beforeEach } from 'vitest';
-import { z } from 'zod';
+import * as z from 'zod';
 import { createMockExecutor } from '../../../../test-utils/mock-executors.ts';
 import stopAppDevice, { stop_app_deviceLogic } from '../stop_app_device.ts';
 import { sessionStore } from '../../../../utils/session-store.ts';
@@ -29,7 +29,7 @@ describe('stop_app_device plugin', () => {
     });
 
     it('should require processId in public schema', () => {
-      const schema = z.object(stopAppDevice.schema).strict();
+      const schema = z.strictObject(stopAppDevice.schema);
       expect(schema.safeParse({ processId: 12345 }).success).toBe(true);
       expect(schema.safeParse({}).success).toBe(false);
       expect(schema.safeParse({ deviceId: 'test-device-123' }).success).toBe(false);