@akinon/next 2.0.0-beta.25 → 2.0.0-beta.27

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @akinon/next
 
+## 2.0.0-beta.27
+
+## 2.0.0-beta.26
+
+### Patch Changes
+
+- 09ccd457: ZERO-4371: Restore `URLSearchParams` type for `PageProps.searchParams` (v1 brand backward compat)
+
+  In v1 (`@akinon/next` 1.x) `PageProps.searchParams` was typed as `URLSearchParams`. Beta v2 widened this to a `Record<string, string | string[]> | URLSearchParams` union, which broke v1 brand pages calling `new URLSearchParams(searchParams)` (TS rejects the `Record<string, string[]>` arm of the union).
+
+  This restores the v1 contract — `PageProps.searchParams: URLSearchParams` — and adds a defensive runtime normalizer in the server `withSegmentDefaults` HOC so Next 16's raw `Record<string, string | string[]>` is converted to a real `URLSearchParams` instance before brand components see it. v1 brands can keep using `.get()`/`.has()`/etc safely without code changes.
+
+  A new `RawSearchParams` type is exported for code at the middleware/HOC boundary that needs to handle the unnormalized Next 16 shape directly.
+
 ## 2.0.0-beta.25
 
 ### Patch Changes

package/hocs/server/with-segment-defaults.tsx

@@ -35,10 +35,26 @@ export const withSegmentDefaults =
       ? await props.searchParams
       : undefined;
 
+    // Normalize Next 16's raw Record<string, string | string[]> shape into a
+    // URLSearchParams instance so v1 brands (which expect URLSearchParams) can
+    // call .get/.has/etc without runtime breakage.
+    const normalizedSearchParams =
+      resolvedSearchParams instanceof URLSearchParams
+        ? resolvedSearchParams
+        : new URLSearchParams(
+            Object.entries(resolvedSearchParams ?? {}).flatMap(([k, v]) =>
+              Array.isArray(v)
+                ? v.map((item): [string, string] => [k, String(item)])
+                : v != null
+                  ? ([[k, String(v)]] as [string, string][])
+                  : []
+            )
+          );
+
     let componentProps = {
       ...props,
       params: resolvedParams,
-      searchParams: resolvedSearchParams,
+      searchParams: normalizedSearchParams,
       ...('children' in props ? { children: (props as any).children } : {})
     } as T;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@akinon/next",
   "description": "Core package for Project Zero Next",
-  "version": "2.0.0-beta.25",
+  "version": "2.0.0-beta.27",
   "private": false,
   "license": "MIT",
   "bin": {
@@ -37,7 +37,7 @@
     "set-cookie-parser": "2.6.0"
   },
   "devDependencies": {
-    "@akinon/eslint-plugin-projectzero": "2.0.0-beta.25",
+    "@akinon/eslint-plugin-projectzero": "2.0.0-beta.27",
     "@babel/core": "7.26.10",
     "@babel/preset-env": "7.26.9",
     "@babel/preset-typescript": "7.27.0",

package/types/index.ts

@@ -278,7 +278,12 @@ export interface PzSegmentsConfig {
 // Search params type compatible with both Next.js resolved searchParams and URLSearchParams
 export type SearchParams = Record<string, string | string[] | undefined> | URLSearchParams;
 
-// Page/Layout props — sync params for backward compatibility with v1 brands
+// Raw Next 16 server prop shape, used at the middleware/HOC boundary before normalization
+export type RawSearchParams = Record<string, string | string[] | undefined>;
+
+// Page/Layout props — sync params for backward compatibility with v1 brands.
+// `searchParams` is always exposed as `URLSearchParams` (matching v1 behavior).
+// The server HOC normalizes Next 16's raw Record into a URLSearchParams instance.
 export interface PageProps<T = any> {
   params: T & {
     pz?: string;
@@ -288,7 +293,7 @@ export interface PageProps<T = any> {
     url?: string;
     [key: string]: any;
   };
-  searchParams: SearchParams;
+  searchParams: URLSearchParams;
 }
 
 export interface LayoutProps<T = any> extends PageProps<T> {
@@ -318,7 +323,7 @@ export interface AsyncPageProps<T = any> {
 // Resolved (sync) versions for inner components after withSegmentDefaults resolves props
 export interface ResolvedPageProps<T = any> {
   params: T & { locale: string; currency: string };
-  searchParams: SearchParams;
+  searchParams: URLSearchParams;
 }
 
 export interface ResolvedLayoutProps<T = any> extends ResolvedPageProps<T> {