chore: upgrade zod from v3 to v4 (#99)

* chore: bump version to 0.6.0

* chore: upgrade zod from v3 to v4

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

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 3 people

CHANGELOG.md

@@ -1,5 +1,9 @@
 ## Unreleased
 
+### Dependencies
+
+- **Upgrade `zod` from `^3.25.42` to `^4.3.6`** — migrated all `z.record()` calls to require explicit key schema (`z.string()`), updated test assertions for changed error message format
+
 ## 0.6.0 - 2026-04-01
 
 ### Security

package-lock.json

@@ -60,7 +60,7 @@
     "@opentelemetry/sdk-node": "^0.56.0",
     "@opentelemetry/sdk-trace-base": "^1.30.1",
     "@opentelemetry/semantic-conventions": "^1.30.1",
-    "zod": "^3.25.42"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@eslint/js": "^9.27.0",

package.json

@@ -28,7 +28,7 @@ const LightsSchema = z.array(
   z.object({
     id: z.string(),
     type: z.enum(['ambient', 'directional']),
-    properties: z.record(z.any()).optional()
+    properties: z.record(z.string(), z.any()).optional()
   })
 );
 
@@ -48,7 +48,7 @@ const VectorSourceSchema = z.object({
   minzoom: z.number().min(0).max(22).optional(),
   maxzoom: z.number().min(0).max(22).optional(),
   attribution: z.string().optional(),
-  promoteId: z.union([z.string(), z.record(z.string())]).optional(),
+  promoteId: z.union([z.string(), z.record(z.string(), z.string())]).optional(),
   volatile: z.boolean().optional()
 });
 
@@ -88,10 +88,10 @@ const GeoJSONSourceSchema = z.object({
   cluster: z.boolean().optional(),
   clusterRadius: z.number().optional(),
   clusterMaxZoom: z.number().optional(),
-  clusterProperties: z.record(z.any()).optional(),
+  clusterProperties: z.record(z.string(), z.any()).optional(),
   lineMetrics: z.boolean().optional(),
   generateId: z.boolean().optional(),
-  promoteId: z.union([z.string(), z.record(z.string())]).optional()
+  promoteId: z.union([z.string(), z.record(z.string(), z.string())]).optional()
 });
 
 const ImageSourceSchema = z.object({
@@ -156,17 +156,17 @@ const LayerSchema = z.object({
   minzoom: z.number().min(0).max(24).optional(),
   maxzoom: z.number().min(0).max(24).optional(),
   filter: z.any().optional().describe('Expression for filtering features'),
-  layout: z.record(z.any()).optional(),
-  paint: z.record(z.any()).optional(),
-  metadata: z.record(z.any()).optional(),
+  layout: z.record(z.string(), z.any()).optional(),
+  paint: z.record(z.string(), z.any()).optional(),
+  metadata: z.record(z.string(), z.any()).optional(),
   slot: z.string().optional().describe('Slot this layer is assigned to')
 });
 
 // Style import schema
 const StyleImportSchema = z.object({
   id: z.string(),
   url: z.string(),
-  config: z.record(z.any()).optional()
+  config: z.record(z.string(), z.any()).optional()
 });
 
 // Base Style properties (shared between input and output)
@@ -175,12 +175,14 @@ export const BaseStylePropertiesSchema = z.object({
   version: z
     .literal(8)
     .describe('Style specification version number. Must be 8'),
-  sources: z.record(SourceSchema).describe('Data source specifications'),
+  sources: z
+    .record(z.string(), SourceSchema)
+    .describe('Data source specifications'),
   layers: z.array(LayerSchema).describe('Layers in draw order'),
 
   // Optional Style Spec properties
   metadata: z
-    .record(z.any())
+    .record(z.string(), z.any())
     .optional()
     .describe('Arbitrary properties for tracking'),
   center: CoordinatesSchema.optional().describe(
@@ -203,9 +205,13 @@ export const BaseStylePropertiesSchema = z.object({
   terrain: TerrainSchema.optional()
     .nullable()
     .describe('Global terrain elevation'),
-  fog: z.record(z.any()).optional().nullable().describe('Fog properties'),
+  fog: z
+    .record(z.string(), z.any())
+    .optional()
+    .nullable()
+    .describe('Fog properties'),
   projection: z
-    .record(z.any())
+    .record(z.string(), z.any())
     .optional()
     .nullable()
     .describe('Map projection'),

src/schemas/style.ts

@@ -5,10 +5,10 @@ import { z } from 'zod';
 
 export const CompareStylesInputSchema = z.object({
   styleA: z
-    .union([z.string(), z.record(z.unknown())])
+    .union([z.string(), z.record(z.string(), z.unknown())])
     .describe('First Mapbox style (JSON string or style object)'),
   styleB: z
-    .union([z.string(), z.record(z.unknown())])
+    .union([z.string(), z.record(z.string(), z.unknown())])
     .describe('Second Mapbox style (JSON string or style object)'),
   ignoreMetadata: z
     .boolean()

src/tools/compare-styles-tool/CompareStylesTool.input.schema.ts

@@ -9,7 +9,7 @@ import { z } from 'zod';
 export const CreateStyleInputSchema = z.object({
   name: z.string().describe('Human-readable name for the style'),
   style: z
-    .record(z.any())
+    .record(z.string(), z.any())
     .describe(
       'Complete Mapbox Style Specification object. Must include: version (8), sources, layers. Optional: sprite, glyphs, center, zoom, bearing, pitch, metadata, etc. See https://docs.mapbox.com/mapbox-gl-js/style-spec/'
     )

src/tools/create-style-tool/CreateStyleTool.input.schema.ts

@@ -30,7 +30,10 @@ const StyleMetadataSchema = z.object({
   pitch: z.number().optional().describe('Default pitch in degrees'),
 
   // Sources and layers may or may not be included in list responses
-  sources: z.record(z.any()).optional().describe('Style data sources'),
+  sources: z
+    .record(z.string(), z.any())
+    .optional()
+    .describe('Style data sources'),
   layers: z.array(z.any()).optional().describe('Style layers'),
 
   // Additional metadata fields

src/tools/list-styles-tool/ListStylesTool.output.schema.ts

@@ -5,7 +5,7 @@ import { z } from 'zod';
 
 export const OptimizeStyleInputSchema = z.object({
   style: z
-    .union([z.string(), z.record(z.unknown())])
+    .union([z.string(), z.record(z.string(), z.unknown())])
     .describe('Mapbox style to optimize (JSON string or style object)'),
   optimizations: z
     .array(

src/tools/optimize-style-tool/OptimizeStyleTool.input.schema.ts

@@ -10,7 +10,9 @@ const OptimizationSchema = z.object({
 });
 
 export const OptimizeStyleOutputSchema = z.object({
-  optimizedStyle: z.record(z.unknown()).describe('The optimized Mapbox style'),
+  optimizedStyle: z
+    .record(z.string(), z.unknown())
+    .describe('The optimized Mapbox style'),
   optimizations: z
     .array(OptimizationSchema)
     .describe('List of optimizations that were applied'),

src/tools/optimize-style-tool/OptimizeStyleTool.output.schema.ts

@@ -52,7 +52,7 @@ const LayerConfigSchema = z.object({
       z.number(),
       z.boolean(),
       z.array(z.unknown()),
-      z.record(z.unknown())
+      z.record(z.string(), z.unknown())
     ])
     .optional()
     .describe('Custom filter expression'),
@@ -109,7 +109,7 @@ const LayerConfigSchema = z.object({
       z.number(),
       z.boolean(),
       z.array(z.unknown()),
-      z.record(z.unknown())
+      z.record(z.string(), z.unknown())
     ])
     .optional()
     .describe('Custom Mapbox expression for advanced styling'),