Option to create params from input in custom validation

zod custom validation allows params to be passed in to the error object. It would be nice if these could be created based on the initial data.

That is, instead of this type signature: .refine(validator: (data:T)=>any, params?: RefineParams)

zod could use: .refine(validator: (data:T)=>any, params?: RefineParams | (data: T) => RefineParams

[colinhacks]

This is now possible in Zod 2 (now in beta)

const dynamicRefine = z.string().refine(
    val => val === val.toUpperCase(),
    val => ({ params: { val } }),
  );

  console.log(dynamicRefine.safeParse('asdf'));

returns

{
    Error: [
      {
        code: 'custom_error',
        params: {
          val: 'asdf',
        },
        path: [],
        message: 'Invalid input.',
      },
    ];
  }

---

@tmtron this is a pretty advanced use case but it is possible. Internally .refine delegates to the more advanced ._refinement method which you can use to implement this. You can use this method without worrying about breaking changes, I consider it a part of the public API; it only starts with an underscore mostly because it’s a “power user” feature.

Some other context: in Zod 2 the errors property of a ZodError has been renamed to issues. This clarifies the confusing “error” vs “suberror” aspect of the previous naming.

const apiString = z.string();
  z.object({
    columns: z.record(z.string()),
    primaryKey: z.array(apiString.nonempty()).nonempty(),
  })._refinement((data, ctx) => {
    const invalidPks = data.primaryKey.filter(
      pk => !Object.keys(data.columns).includes(pk),
    );
    if (invalidPks.length) {
      ctx.addIssue({
        code: z.ZodIssueCode.custom,
        message: `Invalid PKs: ${invalidPks.join(', ')}`,
      });
    }
  });

As you can see there’s no need to return anything from _refinement(). If ctx.addIssue is called at any point during the execution of the refinement, the parse will fail. You can call ctx.addIssue multiple times to create multiple errors. You can also make this function async if you want to do your database fetches inside your refinement.

You need to manually provide the error code using the z.ZodErrorCode enum. This isn’t required in .refine because .refine only every throws a single ZodCustomIssue whereas `refinement lets you throw arbitrarily many issues of any kind. The error handling guide has more information on this.

---

@brabeji The approach above also enables what you were trying to achieve with .dynamicRefinement. Great job on that PR 👍

[colinhacks]

Great idea. I’ll definitely do something like this. Might leave the .refine method as is but add a .refinement for more advanced use cases.