Class ZodBranded<T, B>

constructor

• new ZodBranded<T extends ZodTypeAny, B extends string | number | symbol>(
      def: ZodBrandedDef,
  ): ZodBranded<T, B>

  Type Parameters

  • T extends ZodTypeAny
  • B extends string | number | symbol

  Parameters

  • def: ZodBrandedDef

  Returns ZodBranded<T, B>

Readonly_def

Readonly_input

Readonly_output

Readonly_type

~standard

spa

description

• get description(): string | undefined

  Returns string | undefined

_getOrReturnCtx

• _getOrReturnCtx(input: ParseInput, ctx?: ParseContext): ParseContext

  Parameters

  • input: ParseInput
  • Optionalctx: ParseContext

  Returns ParseContext

_getType

• _getType(input: ParseInput): string

  Parameters

  • input: ParseInput

  Returns string

_parse

• _parse(input: ParseInput): ParseReturnType<any>

  Parameters

  • input: ParseInput

  Returns ParseReturnType<any>

_parseAsync

• _parseAsync(input: ParseInput): AsyncParseReturnType<T["_output"] & z.BRAND<B>>

  Parameters

  • input: ParseInput

  Returns AsyncParseReturnType<T["_output"] & z.BRAND<B>>

_parseSync

• _parseSync(input: ParseInput): SyncParseReturnType<T["_output"] & z.BRAND<B>>

  Parameters

  • input: ParseInput

  Returns SyncParseReturnType<T["_output"] & z.BRAND<B>>

_processInputParams

• _processInputParams(
      input: ParseInput,
  ): { ctx: ParseContext; status: ParseStatus }

  Parameters

  • input: ParseInput

  Returns { ctx: ParseContext; status: ParseStatus }

_refinement

• _refinement(
      refinement: (arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => any,
  ): ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

  Parameters

  • refinement: (arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => any

  Returns ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

~validate

• "~validate"(
      data: unknown,
  ):
      | Result<T["_output"] & z.BRAND<B>>
      | Promise<Result<T["_output"] & z.BRAND<B>>>

  Parameters

  • data: unknown

  Returns Result<T["_output"] & z.BRAND<B>> | Promise<Result<T["_output"] & z.BRAND<B>>>

and

• and<T extends ZodTypeAny>(incoming: T): ZodIntersection<ZodBranded<T, B>, T>

  Type Parameters

  • T extends ZodTypeAny

  Parameters

  • incoming: T

  Returns ZodIntersection<ZodBranded<T, B>, T>

array

• array(): ZodArray<ZodBranded<T, B>>

  Returns ZodArray<ZodBranded<T, B>>

brand

• brand<B extends string | number | symbol>(
      brand?: B,
  ): ZodBranded<ZodBranded<T, B>, B>

  Type Parameters

  • B extends string | number | symbol

  Parameters

  • Optionalbrand: B

  Returns ZodBranded<ZodBranded<T, B>, B>

catch

• catch(def: T["_output"] & z.BRAND<B>): ZodCatch<ZodBranded<T, B>>

  Parameters

  • def: T["_output"] & z.BRAND<B>

  Returns ZodCatch<ZodBranded<T, B>>

• catch(
      def: (
          ctx: { error: ZodError; input: T["_input"] },
      ) => T["_output"] & z.BRAND<B>,
  ): ZodCatch<ZodBranded<T, B>>

  Parameters

  • def: (ctx: { error: ZodError; input: T["_input"] }) => T["_output"] & z.BRAND<B>

  Returns ZodCatch<ZodBranded<T, B>>

default

• default(def: noUndefined<T["_input"]>): ZodDefault<ZodBranded<T, B>>

  Parameters

  • def: noUndefined<T["_input"]>

  Returns ZodDefault<ZodBranded<T, B>>

• default(def: () => noUndefined<T["_input"]>): ZodDefault<ZodBranded<T, B>>

  Parameters

  • def: () => noUndefined<T["_input"]>

  Returns ZodDefault<ZodBranded<T, B>>

describe

• describe(description: string): this

  Parameters

  • description: string

  Returns this

isNullable

• isNullable(): boolean

  Returns boolean

isOptional

• isOptional(): boolean

  Returns boolean

nullable

• nullable(): ZodNullable<ZodBranded<T, B>>

  Returns ZodNullable<ZodBranded<T, B>>

nullish

• nullish(): ZodOptional<ZodNullable<ZodBranded<T, B>>>

  Returns ZodOptional<ZodNullable<ZodBranded<T, B>>>

optional

• optional(): ZodOptional<ZodBranded<T, B>>

  Returns ZodOptional<ZodBranded<T, B>>

or

• or<T extends ZodTypeAny>(option: T): ZodUnion<[ZodBranded<T, B>, T]>

  Type Parameters

  • T extends ZodTypeAny

  Parameters

  • option: T

  Returns ZodUnion<[ZodBranded<T, B>, T]>

parse

• parse(
      data: unknown,
      params?: InexactPartial<ParseParams>,
  ): T["_output"] & z.BRAND<B>

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

  Returns T["_output"] & z.BRAND<B>

parseAsync

• parseAsync(
      data: unknown,
      params?: InexactPartial<ParseParams>,
  ): Promise<T["_output"] & z.BRAND<B>>

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

  Returns Promise<T["_output"] & z.BRAND<B>>

pipe

• pipe<T extends ZodTypeAny>(target: T): ZodPipeline<ZodBranded<T, B>, T>

  Type Parameters

  • T extends ZodTypeAny

  Parameters

  • target: T

  Returns ZodPipeline<ZodBranded<T, B>, T>

promise

• promise(): ZodPromise<ZodBranded<T, B>>

  Returns ZodPromise<ZodBranded<T, B>>

readonly

• readonly(): ZodReadonly<ZodBranded<T, B>>

  Returns ZodReadonly<ZodBranded<T, B>>

refine

• refine<RefinedOutput extends any>(
      check: (arg: T["_output"] & z.BRAND<B>) => arg is RefinedOutput,
      message?:
          | string
          | Partial<Omit<ZodCustomIssue, "code">>
          | ((arg: T["_output"] & z.BRAND<B>) => CustomErrorParams),
  ): ZodEffects<ZodBranded<T, B>, RefinedOutput, T["_input"]>

  Type Parameters

  • RefinedOutput extends any

  Parameters

  • check: (arg: T["_output"] & z.BRAND<B>) => arg is RefinedOutput
  • Optionalmessage:
        | string
        | Partial<Omit<ZodCustomIssue, "code">>
        | ((arg: T["_output"] & z.BRAND<B>) => CustomErrorParams)

  Returns ZodEffects<ZodBranded<T, B>, RefinedOutput, T["_input"]>

• refine(
      check: (arg: T["_output"] & z.BRAND<B>) => unknown,
      message?:
          | string
          | Partial<Omit<ZodCustomIssue, "code">>
          | ((arg: T["_output"] & z.BRAND<B>) => CustomErrorParams),
  ): ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

  Parameters

  • check: (arg: T["_output"] & z.BRAND<B>) => unknown
  • Optionalmessage:
        | string
        | Partial<Omit<ZodCustomIssue, "code">>
        | ((arg: T["_output"] & z.BRAND<B>) => CustomErrorParams)

  Returns ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

refinement

• refinement<RefinedOutput extends any>(
      check: (arg: T["_output"] & z.BRAND<B>) => arg is RefinedOutput,
      refinementData:
          | IssueData
          | ((arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => IssueData),
  ): ZodEffects<ZodBranded<T, B>, RefinedOutput, T["_input"]>

  Type Parameters

  • RefinedOutput extends any

  Parameters

  • check: (arg: T["_output"] & z.BRAND<B>) => arg is RefinedOutput
  • refinementData: IssueData | ((arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => IssueData)

  Returns ZodEffects<ZodBranded<T, B>, RefinedOutput, T["_input"]>

• refinement(
      check: (arg: T["_output"] & z.BRAND<B>) => boolean,
      refinementData:
          | IssueData
          | ((arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => IssueData),
  ): ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

  Parameters

  • check: (arg: T["_output"] & z.BRAND<B>) => boolean
  • refinementData: IssueData | ((arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => IssueData)

  Returns ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

safeParse

• safeParse(
      data: unknown,
      params?: InexactPartial<ParseParams>,
  ): SafeParseReturnType<T["_input"], T["_output"] & z.BRAND<B>>

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

  Returns SafeParseReturnType<T["_input"], T["_output"] & z.BRAND<B>>

safeParseAsync

• safeParseAsync(
      data: unknown,
      params?: InexactPartial<ParseParams>,
  ): Promise<SafeParseReturnType<T["_input"], T["_output"] & z.BRAND<B>>>

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

  Returns Promise<SafeParseReturnType<T["_input"], T["_output"] & z.BRAND<B>>>

superRefine

• superRefine<RefinedOutput extends any>(
      refinement: (
          arg: T["_output"] & z.BRAND<B>,
          ctx: RefinementCtx,
      ) => arg is RefinedOutput,
  ): ZodEffects<ZodBranded<T, B>, RefinedOutput, T["_input"]>

  Type Parameters

  • RefinedOutput extends any

  Parameters

  • refinement: (arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => arg is RefinedOutput

  Returns ZodEffects<ZodBranded<T, B>, RefinedOutput, T["_input"]>

• superRefine(
      refinement: (arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => void,
  ): ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

  Parameters

  • refinement: (arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => void

  Returns ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

• superRefine(
      refinement: (
          arg: T["_output"] & z.BRAND<B>,
          ctx: RefinementCtx,
      ) => Promise<void>,
  ): ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

  Parameters

  • refinement: (arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => Promise<void>

  Returns ZodEffects<ZodBranded<T, B>, T["_output"] & z.BRAND<B>, T["_input"]>

transform

• transform<NewOut>(
      transform: (
          arg: T["_output"] & z.BRAND<B>,
          ctx: RefinementCtx,
      ) => NewOut | Promise<NewOut>,
  ): ZodEffects<ZodBranded<T, B>, NewOut>

  Type Parameters

  • NewOut

  Parameters

  • transform: (arg: T["_output"] & z.BRAND<B>, ctx: RefinementCtx) => NewOut | Promise<NewOut>

  Returns ZodEffects<ZodBranded<T, B>, NewOut>

unwrap

• unwrap(): T

  Returns T