fix: Errors thrown in parsers count as null

This allows using a Zod schema in custom parsers without
the overhead of using safeParse there.

packages/next-usequerystate/src/debug.ts

@@ -12,6 +12,13 @@ export function debug(message: string, ...args: any[]) {
   console.debug(message, ...args)
 }
 
+export function warn(message: string, ...args: any[]) {
+  if (!enabled) {
+    return
+  }
+  console.warn(message, ...args)
+}
+
 export function sprintf(base: string, ...args: any[]) {
   return base.replace(/%[sfdO]/g, match => {
     const arg = args.shift()

packages/next-usequerystate/src/parsers.ts

@@ -1,4 +1,5 @@
 import type { Options } from './defs'
+import { safeParse } from './utils'
 
 export type Parser<T> = {
   parse: (value: string) => T | null
@@ -86,7 +87,7 @@ export function createParser<T>(parser: Required<Parser<T>>): ParserBuilder<T> {
     if (typeof value === 'string') {
       str = value
     }
-    return parser.parse(str)
+    return safeParse(parser.parse, str)
   }
 
   return {
@@ -278,7 +279,10 @@ export function parseAsArrayOf<ItemType>(
       return query
         .split(separator)
         .map(item =>
-          itemParser.parse(item.replaceAll(encodedSeparator, separator))
+          safeParse(
+            itemParser.parse,
+            item.replaceAll(encodedSeparator, separator)
+          )
         )
         .filter(value => value !== null && value !== undefined) as ItemType[]
     },

packages/next-usequerystate/src/useQueryState.ts

@@ -10,6 +10,7 @@ import {
   getQueuedValue,
   scheduleFlushToURL
 } from './update-queue'
+import { safeParse } from './utils'
 
 export interface UseQueryStateOptions<T> extends Parser<T>, Options {}
 
@@ -226,7 +227,7 @@ export function useQueryState<T = string>(
         : // Components mounted after page load must use the current URL value
           new URLSearchParams(location.search).get(key) ?? null
     const value = queueValue ?? urlValue
-    return value === null ? null : parse(value)
+    return value === null ? null : safeParse(parse, value)
   })
   const stateRef = React.useRef(internalState)
   debug(

packages/next-usequerystate/src/useQueryStates.ts

@@ -14,6 +14,7 @@ import {
   getQueuedValue,
   scheduleFlushToURL
 } from './update-queue'
+import { safeParse } from './utils'
 
 type KeyMapValue<Type> = Parser<Type> & {
   defaultValue?: Type
@@ -172,7 +173,7 @@ function parseMap<KeyMap extends UseQueryStatesKeysMap>(
     const urlQuery = searchParams?.get(key) ?? null
     const queueQuery = getQueuedValue(key)
     const query = queueQuery ?? urlQuery
-    const value = query === null ? null : parse(query)
+    const value = query === null ? null : safeParse(parse, query)
     obj[key as keyof KeyMap] = value ?? defaultValue ?? null
     return obj
   }, {} as Values<KeyMap>)

packages/next-usequerystate/src/utils.ts

@@ -0,0 +1,11 @@
+import { warn } from './debug'
+import type { Parser } from './parsers'
+
+export function safeParse<T>(parser: Parser<T>['parse'], value: string) {
+  try {
+    return parser(value)
+  } catch (error) {
+    warn('[nuqs] Error while parsing value `%s`: %O', error)
+    return null
+  }
+}