@optique/zod 1.0.0-dev.1354 → 1.0.0-dev.1361

package/dist/index.cjs

@@ -26,6 +26,20 @@ const __optique_core_nonempty = __toESM(require("@optique/core/nonempty"));
 
 //#region src/index.ts
 /**
+* Checks whether the given error is a Zod async-parse error.
+*
+* - **Zod v4** throws a dedicated `$ZodAsyncError` class.
+* - **Zod v3** (3.25+) throws a plain `Error` whose message starts with
+*   `"Async refinement encountered during synchronous parse operation"` for
+*   async refinements, or `"Asynchronous transform encountered during
+*   synchronous parse operation"` for async transforms.
+*/
+function isZodAsyncError(error) {
+	if (error.constructor.name === "$ZodAsyncError") return true;
+	if (error.message === "Async refinement encountered during synchronous parse operation. Use .parseAsync instead." || error.message === "Asynchronous transform encountered during synchronous parse operation. Use .parseAsync instead." || error.message === "Synchronous parse encountered promise.") return true;
+	return false;
+}
+/**
 * Infers an appropriate metavar string from a Zod schema.
 *
 * This function analyzes the Zod schema's internal structure to determine
@@ -231,6 +245,8 @@ function inferChoices(schema) {
 * ```
 *
 * @throws {TypeError} If the resolved `metavar` is an empty string.
+* @throws {TypeError} If the schema contains async refinements or other async
+*   operations that cannot be executed synchronously.
 * @since 0.7.0
 */
 function zod(schema, options = {}) {
@@ -250,7 +266,13 @@ function zod(schema, options = {}) {
 			}
 		} : {},
 		parse(input) {
-			const result = schema.safeParse(input);
+			let result;
+			try {
+				result = schema.safeParse(input);
+			} catch (error) {
+				if (error instanceof Error && isZodAsyncError(error)) throw new TypeError("Async Zod schemas (e.g., async refinements) are not supported by zod(). Use synchronous schemas instead.");
+				throw error;
+			}
 			if (result.success) return {
 				success: true,
 				value: result.data

package/dist/index.d.cts

@@ -98,6 +98,8 @@ interface ZodParserOptions {
  * ```
  *
  * @throws {TypeError} If the resolved `metavar` is an empty string.
+ * @throws {TypeError} If the schema contains async refinements or other async
+ *   operations that cannot be executed synchronously.
  * @since 0.7.0
  */
 declare function zod<T>(schema: z.Schema<T>, options?: ZodParserOptions): ValueParser<"sync", T>;

package/dist/index.d.ts

@@ -98,6 +98,8 @@ interface ZodParserOptions {
  * ```
  *
  * @throws {TypeError} If the resolved `metavar` is an empty string.
+ * @throws {TypeError} If the schema contains async refinements or other async
+ *   operations that cannot be executed synchronously.
  * @since 0.7.0
  */
 declare function zod<T>(schema: z.Schema<T>, options?: ZodParserOptions): ValueParser<"sync", T>;

package/dist/index.js

@@ -3,6 +3,20 @@ import { ensureNonEmptyString } from "@optique/core/nonempty";
 
 //#region src/index.ts
 /**
+* Checks whether the given error is a Zod async-parse error.
+*
+* - **Zod v4** throws a dedicated `$ZodAsyncError` class.
+* - **Zod v3** (3.25+) throws a plain `Error` whose message starts with
+*   `"Async refinement encountered during synchronous parse operation"` for
+*   async refinements, or `"Asynchronous transform encountered during
+*   synchronous parse operation"` for async transforms.
+*/
+function isZodAsyncError(error) {
+	if (error.constructor.name === "$ZodAsyncError") return true;
+	if (error.message === "Async refinement encountered during synchronous parse operation. Use .parseAsync instead." || error.message === "Asynchronous transform encountered during synchronous parse operation. Use .parseAsync instead." || error.message === "Synchronous parse encountered promise.") return true;
+	return false;
+}
+/**
 * Infers an appropriate metavar string from a Zod schema.
 *
 * This function analyzes the Zod schema's internal structure to determine
@@ -208,6 +222,8 @@ function inferChoices(schema) {
 * ```
 *
 * @throws {TypeError} If the resolved `metavar` is an empty string.
+* @throws {TypeError} If the schema contains async refinements or other async
+*   operations that cannot be executed synchronously.
 * @since 0.7.0
 */
 function zod(schema, options = {}) {
@@ -227,7 +243,13 @@ function zod(schema, options = {}) {
 			}
 		} : {},
 		parse(input) {
-			const result = schema.safeParse(input);
+			let result;
+			try {
+				result = schema.safeParse(input);
+			} catch (error) {
+				if (error instanceof Error && isZodAsyncError(error)) throw new TypeError("Async Zod schemas (e.g., async refinements) are not supported by zod(). Use synchronous schemas instead.");
+				throw error;
+			}
 			if (result.success) return {
 				success: true,
 				value: result.data

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/zod",
-  "version": "1.0.0-dev.1354+b0af7b96",
+  "version": "1.0.0-dev.1361+c7adf09c",
   "description": "Zod value parsers for Optique",
   "keywords": [
     "CLI",
@@ -57,7 +57,7 @@
     "zod": "^3.25.0 || ^4.0.0"
   },
   "dependencies": {
-    "@optique/core": "1.0.0-dev.1354+b0af7b96"
+    "@optique/core": "1.0.0-dev.1361+c7adf09c"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",