Function requireEnum

src/lib/validate.ts:126–141

(
  field: string,
  value: unknown,
  accepted: readonly T[],
  opts: KindOpts = {},
)

 * @param opts.kind `'field'` (default) or `'flag'`.
 */
export function requireEnum<T extends string>(
  field: string,
  value: unknown,
  accepted: readonly T[],
  opts: KindOpts = {},
): asserts value is T {
  const { kind = 'field' } = opts;

  // Use valibot picklist for structural detection. Custom message is
  // composed here so the envelope text is explicit and stable.
  const result = v.safeParse(v.picklist(accepted as [T, ...T[]]), value);
  if (!result.success) {
    const acceptedList = accepted.map(a => `"${a}"`).join(', ');
    throw localValidationError(field, `must be one of: ${acceptedList}`, [...accepted], kind);
  }
}

/**
 * Validate a caller-supplied `--idempotency-key` value before it is sent as