@schemashift/zod-v3-v4 0.2.0

package/dist/index.cjs

@@ -0,0 +1,205 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BEHAVIOR_CHANGES: () => BEHAVIOR_CHANGES,
+  V3_TO_V4_PATTERNS: () => V3_TO_V4_PATTERNS,
+  ZodV3ToV4Transformer: () => ZodV3ToV4Transformer,
+  createZodV3ToV4Handler: () => createZodV3ToV4Handler
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/transformer.ts
+var import_ts_morph = require("ts-morph");
+
+// src/mappings.ts
+var V3_TO_V4_PATTERNS = {
+  // z.record(valueSchema) -> z.record(z.string(), valueSchema)
+  recordSingleArg: /z\.record\((?!z\.string\(\)|z\.number\(\)|z\.symbol\(\))/g,
+  // error.errors -> error.issues
+  errorErrors: /\.errors\b/g,
+  // .brand<T>() -> .brand<T>() (same but check for proper usage)
+  brandUsage: /\.brand<([^>]+)>\(\)/g
+};
+var BEHAVIOR_CHANGES = /* @__PURE__ */ new Set([
+  "default",
+  // Type inference changed
+  "uuid",
+  // Stricter validation
+  "record",
+  // Requires key type
+  "discriminatedUnion",
+  // Stricter discriminator requirements
+  "function"
+  // Input/output parameter changes
+]);
+
+// src/transformer.ts
+var ZodV3ToV4Transformer = class {
+  errors = [];
+  warnings = [];
+  transform(sourceFile) {
+    this.errors = [];
+    this.warnings = [];
+    const filePath = sourceFile.getFilePath();
+    const originalCode = sourceFile.getFullText();
+    try {
+      this.transformRecordCalls(sourceFile);
+      this.transformErrorProperties(sourceFile);
+      this.checkBehaviorChanges(sourceFile);
+      return {
+        success: this.errors.length === 0,
+        filePath,
+        originalCode,
+        transformedCode: sourceFile.getFullText(),
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    } catch (error) {
+      this.errors.push({
+        message: error instanceof Error ? error.message : "Unknown error"
+      });
+      return {
+        success: false,
+        filePath,
+        originalCode,
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    }
+  }
+  /**
+   * Transform z.record(valueSchema) to z.record(z.string(), valueSchema)
+   */
+  transformRecordCalls(sourceFile) {
+    sourceFile.forEachDescendant((node) => {
+      if (import_ts_morph.Node.isCallExpression(node)) {
+        const expression = node.getExpression();
+        if (import_ts_morph.Node.isPropertyAccessExpression(expression)) {
+          const name = expression.getName();
+          const object = expression.getExpression();
+          if (name === "record" && object.getText() === "z") {
+            const args = node.getArguments();
+            if (args.length === 1) {
+              const valueSchema = args[0]?.getText();
+              if (valueSchema) {
+                node.replaceWithText(`z.record(z.string(), ${valueSchema})`);
+                this.warnings.push(
+                  `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: z.record() updated to include explicit key type z.string()`
+                );
+              }
+            }
+          }
+        }
+      }
+    });
+  }
+  /**
+   * Transform error.errors to error.issues
+   */
+  transformErrorProperties(sourceFile) {
+    sourceFile.forEachDescendant((node) => {
+      if (import_ts_morph.Node.isPropertyAccessExpression(node)) {
+        const name = node.getName();
+        if (name === "errors") {
+          const object = node.getExpression();
+          const objectText = object.getText();
+          if (objectText.toLowerCase().includes("error") || objectText.toLowerCase().includes("err")) {
+            const fullText = node.getText();
+            const newText = fullText.replace(/\.errors$/, ".issues");
+            node.replaceWithText(newText);
+            this.warnings.push(
+              `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: .errors renamed to .issues (ZodError property change)`
+            );
+          }
+        }
+      }
+    });
+  }
+  /**
+   * Check for methods with behavior changes and add warnings
+   */
+  checkBehaviorChanges(sourceFile) {
+    const filePath = sourceFile.getFilePath();
+    sourceFile.forEachDescendant((node) => {
+      if (import_ts_morph.Node.isCallExpression(node)) {
+        const expression = node.getExpression();
+        if (import_ts_morph.Node.isPropertyAccessExpression(expression)) {
+          const name = expression.getName();
+          if (BEHAVIOR_CHANGES.has(name)) {
+            const lineNumber = node.getStartLineNumber();
+            switch (name) {
+              case "default":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: .default() has stricter type inference in v4. Verify default value matches schema type exactly.`
+                );
+                break;
+              case "uuid":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: .uuid() now enforces strict RFC 4122 compliance. Non-standard UUIDs may fail validation.`
+                );
+                break;
+              case "discriminatedUnion":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: z.discriminatedUnion() now requires a literal type for the discriminator property.`
+                );
+                break;
+              case "function":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: z.function() parameter handling has changed. Review input/output schema definitions.`
+                );
+                break;
+            }
+          }
+        }
+      }
+    });
+    const text = sourceFile.getFullText();
+    if (text.includes(".flatten()")) {
+      const matches = text.matchAll(/\.flatten\(\)/g);
+      for (const match of matches) {
+        const pos = match.index ?? 0;
+        const lineNumber = sourceFile.getLineAndColumnAtPos(pos).line;
+        this.warnings.push(
+          `${filePath}:${lineNumber}: .flatten() is removed in v4. Use error.issues directly or implement custom flattening.`
+        );
+      }
+    }
+  }
+};
+
+// src/handler.ts
+function createZodV3ToV4Handler() {
+  const transformer = new ZodV3ToV4Transformer();
+  return {
+    transform(sourceFile, _options) {
+      return transformer.transform(sourceFile);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BEHAVIOR_CHANGES,
+  V3_TO_V4_PATTERNS,
+  ZodV3ToV4Transformer,
+  createZodV3ToV4Handler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/transformer.ts","../src/mappings.ts","../src/handler.ts"],"sourcesContent":["export { createZodV3ToV4Handler } from './handler.js';\nexport { BEHAVIOR_CHANGES, V3_TO_V4_PATTERNS } from './mappings.js';\nexport { ZodV3ToV4Transformer } from './transformer.js';\n","import type { TransformError, TransformResult } from '@schemashift/core';\nimport { Node, type SourceFile } from 'ts-morph';\nimport { BEHAVIOR_CHANGES } from './mappings.js';\n\n/**\n * Zod v3 to v4 Transformer\n *\n * Handles breaking changes between Zod v3 and v4:\n * - z.record() now requires explicit key type\n * - error.errors -> error.issues\n * - Stricter UUID validation\n * - Type inference changes in .default()\n */\nexport class ZodV3ToV4Transformer {\n  private errors: TransformError[] = [];\n  private warnings: string[] = [];\n\n  transform(sourceFile: SourceFile): TransformResult {\n    this.errors = [];\n    this.warnings = [];\n\n    const filePath = sourceFile.getFilePath();\n    const originalCode = sourceFile.getFullText();\n\n    try {\n      this.transformRecordCalls(sourceFile);\n      this.transformErrorProperties(sourceFile);\n      this.checkBehaviorChanges(sourceFile);\n\n      return {\n        success: this.errors.length === 0,\n        filePath,\n        originalCode,\n        transformedCode: sourceFile.getFullText(),\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    } catch (error) {\n      this.errors.push({\n        message: error instanceof Error ? error.message : 'Unknown error',\n      });\n      return {\n        success: false,\n        filePath,\n        originalCode,\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    }\n  }\n\n  /**\n   * Transform z.record(valueSchema) to z.record(z.string(), valueSchema)\n   */\n  private transformRecordCalls(sourceFile: SourceFile): void {\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        const expression = node.getExpression();\n\n        // Check if this is z.record() call\n        if (Node.isPropertyAccessExpression(expression)) {\n          const name = expression.getName();\n          const object = expression.getExpression();\n\n          if (name === 'record' && object.getText() === 'z') {\n            const args = node.getArguments();\n\n            // If only one argument, add z.string() as key type\n            if (args.length === 1) {\n              const valueSchema = args[0]?.getText();\n              if (valueSchema) {\n                node.replaceWithText(`z.record(z.string(), ${valueSchema})`);\n\n                this.warnings.push(\n                  `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: ` +\n                    'z.record() updated to include explicit key type z.string()',\n                );\n              }\n            }\n          }\n        }\n      }\n    });\n  }\n\n  /**\n   * Transform error.errors to error.issues\n   */\n  private transformErrorProperties(sourceFile: SourceFile): void {\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isPropertyAccessExpression(node)) {\n        const name = node.getName();\n\n        // Check for .errors property access that might be on ZodError\n        if (name === 'errors') {\n          const object = node.getExpression();\n          const objectText = object.getText();\n\n          // Heuristic: if the variable is named error, err, or zodError, likely a ZodError\n          if (\n            objectText.toLowerCase().includes('error') ||\n            objectText.toLowerCase().includes('err')\n          ) {\n            // Replace .errors with .issues\n            const fullText = node.getText();\n            const newText = fullText.replace(/\\.errors$/, '.issues');\n            node.replaceWithText(newText);\n\n            this.warnings.push(\n              `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: ` +\n                '.errors renamed to .issues (ZodError property change)',\n            );\n          }\n        }\n      }\n    });\n  }\n\n  /**\n   * Check for methods with behavior changes and add warnings\n   */\n  private checkBehaviorChanges(sourceFile: SourceFile): void {\n    const filePath = sourceFile.getFilePath();\n\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        const expression = node.getExpression();\n\n        if (Node.isPropertyAccessExpression(expression)) {\n          const name = expression.getName();\n\n          if (BEHAVIOR_CHANGES.has(name)) {\n            const lineNumber = node.getStartLineNumber();\n\n            switch (name) {\n              case 'default':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: .default() has stricter type inference in v4. ` +\n                    'Verify default value matches schema type exactly.',\n                );\n                break;\n\n              case 'uuid':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: .uuid() now enforces strict RFC 4122 compliance. ` +\n                    'Non-standard UUIDs may fail validation.',\n                );\n                break;\n\n              case 'discriminatedUnion':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: z.discriminatedUnion() now requires ` +\n                    'a literal type for the discriminator property.',\n                );\n                break;\n\n              case 'function':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: z.function() parameter handling has changed. ` +\n                    'Review input/output schema definitions.',\n                );\n                break;\n            }\n          }\n        }\n      }\n    });\n\n    // Check for flatten() usage which is removed in v4\n    const text = sourceFile.getFullText();\n    if (text.includes('.flatten()')) {\n      const matches = text.matchAll(/\\.flatten\\(\\)/g);\n      for (const match of matches) {\n        const pos = match.index ?? 0;\n        const lineNumber = sourceFile.getLineAndColumnAtPos(pos).line;\n        this.warnings.push(\n          `${filePath}:${lineNumber}: .flatten() is removed in v4. ` +\n            'Use error.issues directly or implement custom flattening.',\n        );\n      }\n    }\n  }\n}\n","/**\n * Zod v3 to v4 Breaking Changes\n *\n * Key changes in Zod v4:\n * 1. z.record() now requires explicit key type\n * 2. .default() has stricter type inference\n * 3. error.errors renamed to error.issues\n * 4. .uuid() has stricter validation (RFC 4122 compliant)\n * 5. z.function() input/output changed\n * 6. Branded types use different syntax\n * 7. z.discriminatedUnion() requires literal discriminator\n */\n\n// Patterns that need transformation\nexport const V3_TO_V4_PATTERNS = {\n  // z.record(valueSchema) -> z.record(z.string(), valueSchema)\n  recordSingleArg: /z\\.record\\((?!z\\.string\\(\\)|z\\.number\\(\\)|z\\.symbol\\(\\))/g,\n\n  // error.errors -> error.issues\n  errorErrors: /\\.errors\\b/g,\n\n  // .brand<T>() -> .brand<T>() (same but check for proper usage)\n  brandUsage: /\\.brand<([^>]+)>\\(\\)/g,\n};\n\n// Methods that have changed behavior\nexport const BEHAVIOR_CHANGES = new Set([\n  'default', // Type inference changed\n  'uuid', // Stricter validation\n  'record', // Requires key type\n  'discriminatedUnion', // Stricter discriminator requirements\n  'function', // Input/output parameter changes\n]);\n\n// Error property renames\nexport const ERROR_RENAMES: Record<string, string> = {\n  errors: 'issues',\n  formErrors: 'formErrors', // Unchanged\n  fieldErrors: 'fieldErrors', // Unchanged\n};\n\n// Methods that are deprecated in v4\nexport const DEPRECATED_METHODS = new Set([\n  // Add any deprecated methods here\n]);\n","import type { TransformHandler, TransformOptions, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { ZodV3ToV4Transformer } from './transformer.js';\n\nexport function createZodV3ToV4Handler(): TransformHandler {\n  const transformer = new ZodV3ToV4Transformer();\n  return {\n    transform(sourceFile: SourceFile, _options: TransformOptions): TransformResult {\n      return transformer.transform(sourceFile);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+import { TransformHandler, TransformResult } from '@schemashift/core';
+import { SourceFile } from 'ts-morph';
+
+declare function createZodV3ToV4Handler(): TransformHandler;
+
+/**
+ * Zod v3 to v4 Breaking Changes
+ *
+ * Key changes in Zod v4:
+ * 1. z.record() now requires explicit key type
+ * 2. .default() has stricter type inference
+ * 3. error.errors renamed to error.issues
+ * 4. .uuid() has stricter validation (RFC 4122 compliant)
+ * 5. z.function() input/output changed
+ * 6. Branded types use different syntax
+ * 7. z.discriminatedUnion() requires literal discriminator
+ */
+declare const V3_TO_V4_PATTERNS: {
+    recordSingleArg: RegExp;
+    errorErrors: RegExp;
+    brandUsage: RegExp;
+};
+declare const BEHAVIOR_CHANGES: Set<string>;
+
+/**
+ * Zod v3 to v4 Transformer
+ *
+ * Handles breaking changes between Zod v3 and v4:
+ * - z.record() now requires explicit key type
+ * - error.errors -> error.issues
+ * - Stricter UUID validation
+ * - Type inference changes in .default()
+ */
+declare class ZodV3ToV4Transformer {
+    private errors;
+    private warnings;
+    transform(sourceFile: SourceFile): TransformResult;
+    /**
+     * Transform z.record(valueSchema) to z.record(z.string(), valueSchema)
+     */
+    private transformRecordCalls;
+    /**
+     * Transform error.errors to error.issues
+     */
+    private transformErrorProperties;
+    /**
+     * Check for methods with behavior changes and add warnings
+     */
+    private checkBehaviorChanges;
+}
+
+export { BEHAVIOR_CHANGES, V3_TO_V4_PATTERNS, ZodV3ToV4Transformer, createZodV3ToV4Handler };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { TransformHandler, TransformResult } from '@schemashift/core';
+import { SourceFile } from 'ts-morph';
+
+declare function createZodV3ToV4Handler(): TransformHandler;
+
+/**
+ * Zod v3 to v4 Breaking Changes
+ *
+ * Key changes in Zod v4:
+ * 1. z.record() now requires explicit key type
+ * 2. .default() has stricter type inference
+ * 3. error.errors renamed to error.issues
+ * 4. .uuid() has stricter validation (RFC 4122 compliant)
+ * 5. z.function() input/output changed
+ * 6. Branded types use different syntax
+ * 7. z.discriminatedUnion() requires literal discriminator
+ */
+declare const V3_TO_V4_PATTERNS: {
+    recordSingleArg: RegExp;
+    errorErrors: RegExp;
+    brandUsage: RegExp;
+};
+declare const BEHAVIOR_CHANGES: Set<string>;
+
+/**
+ * Zod v3 to v4 Transformer
+ *
+ * Handles breaking changes between Zod v3 and v4:
+ * - z.record() now requires explicit key type
+ * - error.errors -> error.issues
+ * - Stricter UUID validation
+ * - Type inference changes in .default()
+ */
+declare class ZodV3ToV4Transformer {
+    private errors;
+    private warnings;
+    transform(sourceFile: SourceFile): TransformResult;
+    /**
+     * Transform z.record(valueSchema) to z.record(z.string(), valueSchema)
+     */
+    private transformRecordCalls;
+    /**
+     * Transform error.errors to error.issues
+     */
+    private transformErrorProperties;
+    /**
+     * Check for methods with behavior changes and add warnings
+     */
+    private checkBehaviorChanges;
+}
+
+export { BEHAVIOR_CHANGES, V3_TO_V4_PATTERNS, ZodV3ToV4Transformer, createZodV3ToV4Handler };

package/dist/index.js

@@ -0,0 +1,175 @@
+// src/transformer.ts
+import { Node } from "ts-morph";
+
+// src/mappings.ts
+var V3_TO_V4_PATTERNS = {
+  // z.record(valueSchema) -> z.record(z.string(), valueSchema)
+  recordSingleArg: /z\.record\((?!z\.string\(\)|z\.number\(\)|z\.symbol\(\))/g,
+  // error.errors -> error.issues
+  errorErrors: /\.errors\b/g,
+  // .brand<T>() -> .brand<T>() (same but check for proper usage)
+  brandUsage: /\.brand<([^>]+)>\(\)/g
+};
+var BEHAVIOR_CHANGES = /* @__PURE__ */ new Set([
+  "default",
+  // Type inference changed
+  "uuid",
+  // Stricter validation
+  "record",
+  // Requires key type
+  "discriminatedUnion",
+  // Stricter discriminator requirements
+  "function"
+  // Input/output parameter changes
+]);
+
+// src/transformer.ts
+var ZodV3ToV4Transformer = class {
+  errors = [];
+  warnings = [];
+  transform(sourceFile) {
+    this.errors = [];
+    this.warnings = [];
+    const filePath = sourceFile.getFilePath();
+    const originalCode = sourceFile.getFullText();
+    try {
+      this.transformRecordCalls(sourceFile);
+      this.transformErrorProperties(sourceFile);
+      this.checkBehaviorChanges(sourceFile);
+      return {
+        success: this.errors.length === 0,
+        filePath,
+        originalCode,
+        transformedCode: sourceFile.getFullText(),
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    } catch (error) {
+      this.errors.push({
+        message: error instanceof Error ? error.message : "Unknown error"
+      });
+      return {
+        success: false,
+        filePath,
+        originalCode,
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    }
+  }
+  /**
+   * Transform z.record(valueSchema) to z.record(z.string(), valueSchema)
+   */
+  transformRecordCalls(sourceFile) {
+    sourceFile.forEachDescendant((node) => {
+      if (Node.isCallExpression(node)) {
+        const expression = node.getExpression();
+        if (Node.isPropertyAccessExpression(expression)) {
+          const name = expression.getName();
+          const object = expression.getExpression();
+          if (name === "record" && object.getText() === "z") {
+            const args = node.getArguments();
+            if (args.length === 1) {
+              const valueSchema = args[0]?.getText();
+              if (valueSchema) {
+                node.replaceWithText(`z.record(z.string(), ${valueSchema})`);
+                this.warnings.push(
+                  `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: z.record() updated to include explicit key type z.string()`
+                );
+              }
+            }
+          }
+        }
+      }
+    });
+  }
+  /**
+   * Transform error.errors to error.issues
+   */
+  transformErrorProperties(sourceFile) {
+    sourceFile.forEachDescendant((node) => {
+      if (Node.isPropertyAccessExpression(node)) {
+        const name = node.getName();
+        if (name === "errors") {
+          const object = node.getExpression();
+          const objectText = object.getText();
+          if (objectText.toLowerCase().includes("error") || objectText.toLowerCase().includes("err")) {
+            const fullText = node.getText();
+            const newText = fullText.replace(/\.errors$/, ".issues");
+            node.replaceWithText(newText);
+            this.warnings.push(
+              `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: .errors renamed to .issues (ZodError property change)`
+            );
+          }
+        }
+      }
+    });
+  }
+  /**
+   * Check for methods with behavior changes and add warnings
+   */
+  checkBehaviorChanges(sourceFile) {
+    const filePath = sourceFile.getFilePath();
+    sourceFile.forEachDescendant((node) => {
+      if (Node.isCallExpression(node)) {
+        const expression = node.getExpression();
+        if (Node.isPropertyAccessExpression(expression)) {
+          const name = expression.getName();
+          if (BEHAVIOR_CHANGES.has(name)) {
+            const lineNumber = node.getStartLineNumber();
+            switch (name) {
+              case "default":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: .default() has stricter type inference in v4. Verify default value matches schema type exactly.`
+                );
+                break;
+              case "uuid":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: .uuid() now enforces strict RFC 4122 compliance. Non-standard UUIDs may fail validation.`
+                );
+                break;
+              case "discriminatedUnion":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: z.discriminatedUnion() now requires a literal type for the discriminator property.`
+                );
+                break;
+              case "function":
+                this.warnings.push(
+                  `${filePath}:${lineNumber}: z.function() parameter handling has changed. Review input/output schema definitions.`
+                );
+                break;
+            }
+          }
+        }
+      }
+    });
+    const text = sourceFile.getFullText();
+    if (text.includes(".flatten()")) {
+      const matches = text.matchAll(/\.flatten\(\)/g);
+      for (const match of matches) {
+        const pos = match.index ?? 0;
+        const lineNumber = sourceFile.getLineAndColumnAtPos(pos).line;
+        this.warnings.push(
+          `${filePath}:${lineNumber}: .flatten() is removed in v4. Use error.issues directly or implement custom flattening.`
+        );
+      }
+    }
+  }
+};
+
+// src/handler.ts
+function createZodV3ToV4Handler() {
+  const transformer = new ZodV3ToV4Transformer();
+  return {
+    transform(sourceFile, _options) {
+      return transformer.transform(sourceFile);
+    }
+  };
+}
+export {
+  BEHAVIOR_CHANGES,
+  V3_TO_V4_PATTERNS,
+  ZodV3ToV4Transformer,
+  createZodV3ToV4Handler
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transformer.ts","../src/mappings.ts","../src/handler.ts"],"sourcesContent":["import type { TransformError, TransformResult } from '@schemashift/core';\nimport { Node, type SourceFile } from 'ts-morph';\nimport { BEHAVIOR_CHANGES } from './mappings.js';\n\n/**\n * Zod v3 to v4 Transformer\n *\n * Handles breaking changes between Zod v3 and v4:\n * - z.record() now requires explicit key type\n * - error.errors -> error.issues\n * - Stricter UUID validation\n * - Type inference changes in .default()\n */\nexport class ZodV3ToV4Transformer {\n  private errors: TransformError[] = [];\n  private warnings: string[] = [];\n\n  transform(sourceFile: SourceFile): TransformResult {\n    this.errors = [];\n    this.warnings = [];\n\n    const filePath = sourceFile.getFilePath();\n    const originalCode = sourceFile.getFullText();\n\n    try {\n      this.transformRecordCalls(sourceFile);\n      this.transformErrorProperties(sourceFile);\n      this.checkBehaviorChanges(sourceFile);\n\n      return {\n        success: this.errors.length === 0,\n        filePath,\n        originalCode,\n        transformedCode: sourceFile.getFullText(),\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    } catch (error) {\n      this.errors.push({\n        message: error instanceof Error ? error.message : 'Unknown error',\n      });\n      return {\n        success: false,\n        filePath,\n        originalCode,\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    }\n  }\n\n  /**\n   * Transform z.record(valueSchema) to z.record(z.string(), valueSchema)\n   */\n  private transformRecordCalls(sourceFile: SourceFile): void {\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        const expression = node.getExpression();\n\n        // Check if this is z.record() call\n        if (Node.isPropertyAccessExpression(expression)) {\n          const name = expression.getName();\n          const object = expression.getExpression();\n\n          if (name === 'record' && object.getText() === 'z') {\n            const args = node.getArguments();\n\n            // If only one argument, add z.string() as key type\n            if (args.length === 1) {\n              const valueSchema = args[0]?.getText();\n              if (valueSchema) {\n                node.replaceWithText(`z.record(z.string(), ${valueSchema})`);\n\n                this.warnings.push(\n                  `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: ` +\n                    'z.record() updated to include explicit key type z.string()',\n                );\n              }\n            }\n          }\n        }\n      }\n    });\n  }\n\n  /**\n   * Transform error.errors to error.issues\n   */\n  private transformErrorProperties(sourceFile: SourceFile): void {\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isPropertyAccessExpression(node)) {\n        const name = node.getName();\n\n        // Check for .errors property access that might be on ZodError\n        if (name === 'errors') {\n          const object = node.getExpression();\n          const objectText = object.getText();\n\n          // Heuristic: if the variable is named error, err, or zodError, likely a ZodError\n          if (\n            objectText.toLowerCase().includes('error') ||\n            objectText.toLowerCase().includes('err')\n          ) {\n            // Replace .errors with .issues\n            const fullText = node.getText();\n            const newText = fullText.replace(/\\.errors$/, '.issues');\n            node.replaceWithText(newText);\n\n            this.warnings.push(\n              `${sourceFile.getFilePath()}:${node.getStartLineNumber()}: ` +\n                '.errors renamed to .issues (ZodError property change)',\n            );\n          }\n        }\n      }\n    });\n  }\n\n  /**\n   * Check for methods with behavior changes and add warnings\n   */\n  private checkBehaviorChanges(sourceFile: SourceFile): void {\n    const filePath = sourceFile.getFilePath();\n\n    sourceFile.forEachDescendant((node) => {\n      if (Node.isCallExpression(node)) {\n        const expression = node.getExpression();\n\n        if (Node.isPropertyAccessExpression(expression)) {\n          const name = expression.getName();\n\n          if (BEHAVIOR_CHANGES.has(name)) {\n            const lineNumber = node.getStartLineNumber();\n\n            switch (name) {\n              case 'default':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: .default() has stricter type inference in v4. ` +\n                    'Verify default value matches schema type exactly.',\n                );\n                break;\n\n              case 'uuid':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: .uuid() now enforces strict RFC 4122 compliance. ` +\n                    'Non-standard UUIDs may fail validation.',\n                );\n                break;\n\n              case 'discriminatedUnion':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: z.discriminatedUnion() now requires ` +\n                    'a literal type for the discriminator property.',\n                );\n                break;\n\n              case 'function':\n                this.warnings.push(\n                  `${filePath}:${lineNumber}: z.function() parameter handling has changed. ` +\n                    'Review input/output schema definitions.',\n                );\n                break;\n            }\n          }\n        }\n      }\n    });\n\n    // Check for flatten() usage which is removed in v4\n    const text = sourceFile.getFullText();\n    if (text.includes('.flatten()')) {\n      const matches = text.matchAll(/\\.flatten\\(\\)/g);\n      for (const match of matches) {\n        const pos = match.index ?? 0;\n        const lineNumber = sourceFile.getLineAndColumnAtPos(pos).line;\n        this.warnings.push(\n          `${filePath}:${lineNumber}: .flatten() is removed in v4. ` +\n            'Use error.issues directly or implement custom flattening.',\n        );\n      }\n    }\n  }\n}\n","/**\n * Zod v3 to v4 Breaking Changes\n *\n * Key changes in Zod v4:\n * 1. z.record() now requires explicit key type\n * 2. .default() has stricter type inference\n * 3. error.errors renamed to error.issues\n * 4. .uuid() has stricter validation (RFC 4122 compliant)\n * 5. z.function() input/output changed\n * 6. Branded types use different syntax\n * 7. z.discriminatedUnion() requires literal discriminator\n */\n\n// Patterns that need transformation\nexport const V3_TO_V4_PATTERNS = {\n  // z.record(valueSchema) -> z.record(z.string(), valueSchema)\n  recordSingleArg: /z\\.record\\((?!z\\.string\\(\\)|z\\.number\\(\\)|z\\.symbol\\(\\))/g,\n\n  // error.errors -> error.issues\n  errorErrors: /\\.errors\\b/g,\n\n  // .brand<T>() -> .brand<T>() (same but check for proper usage)\n  brandUsage: /\\.brand<([^>]+)>\\(\\)/g,\n};\n\n// Methods that have changed behavior\nexport const BEHAVIOR_CHANGES = new Set([\n  'default', // Type inference changed\n  'uuid', // Stricter validation\n  'record', // Requires key type\n  'discriminatedUnion', // Stricter discriminator requirements\n  'function', // Input/output parameter changes\n]);\n\n// Error property renames\nexport const ERROR_RENAMES: Record<string, string> = {\n  errors: 'issues',\n  formErrors: 'formErrors', // Unchanged\n  fieldErrors: 'fieldErrors', // Unchanged\n};\n\n// Methods that are deprecated in v4\nexport const DEPRECATED_METHODS = new Set([\n  // Add any deprecated methods here\n]);\n","import type { TransformHandler, TransformOptions, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { ZodV3ToV4Transformer } from './transformer.js';\n\nexport function createZodV3ToV4Handler(): TransformHandler {\n  const transformer = new ZodV3ToV4Transformer();\n  return {\n    transform(sourceFile: SourceFile, _options: TransformOptions): TransformResult {\n      return transformer.transform(sourceFile);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@schemashift/zod-v3-v4",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@schemashift/core": "0.2.0",
+    "ts-morph": "27.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}