feat: Add temporary dedicated server features imports

This allows using the serializer and the parsers in server-side code without
depending on React for the cache, as would be the case if importing
from `nuqs/server`.

Closes #804. See also discussion #717.

Author: franky47

packages/nuqs/package.json

@@ -35,6 +35,9 @@
   "files": [
     "dist/",
     "server.d.ts",
+    "server/cache.d.ts",
+    "server/serializer.d.ts",
+    "server/parsers.d.ts",
     "adapters/react.d.ts",
     "adapters/next.d.ts",
     "adapters/next/app.d.ts",
@@ -60,6 +63,21 @@
       "import": "./dist/server.js",
       "require": "./esm-only.cjs"
     },
+    "./server/cache": {
+      "types": "./dist/server/cache.d.ts",
+      "import": "./dist/server/cache.js",
+      "require": "./esm-only.cjs"
+    },
+    "./server/serializer": {
+      "types": "./dist/server/serializer.d.ts",
+      "import": "./dist/server/serializer.js",
+      "require": "./esm-only.cjs"
+    },
+    "./server/parsers": {
+      "types": "./dist/server/parsers.d.ts",
+      "import": "./dist/server/parsers.js",
+      "require": "./esm-only.cjs"
+    },
     "./adapters/react": {
       "types": "./dist/adapters/react.d.ts",
       "import": "./dist/adapters/react.js",

packages/nuqs/server/cache.d.ts

@@ -0,0 +1,7 @@
+// This file is needed for projects that have `moduleResolution` set to `node`
+// in their tsconfig.json to be able to `import {} from 'nuqs/server/cache'`.
+// Other module resolutions strategies will look for the `exports` in `package.json`,
+// but with `node`, TypeScript will look for a .d.ts file with that name at the
+// root of the package.
+
+export * from './dist/server/cache'

packages/nuqs/server/parsers.d.ts

@@ -0,0 +1,7 @@
+// This file is needed for projects that have `moduleResolution` set to `node`
+// in their tsconfig.json to be able to `import {} from 'nuqs/server/parsers'`.
+// Other module resolutions strategies will look for the `exports` in `package.json`,
+// but with `node`, TypeScript will look for a .d.ts file with that name at the
+// root of the package.
+
+export * from './dist/server/parsers'

packages/nuqs/server/serializer.d.ts

@@ -0,0 +1,7 @@
+// This file is needed for projects that have `moduleResolution` set to `node`
+// in their tsconfig.json to be able to `import {} from 'nuqs/server/serializer'`.
+// Other module resolutions strategies will look for the `exports` in `package.json`,
+// but with `node`, TypeScript will look for a .d.ts file with that name at the
+// root of the package.
+
+export * from './dist/server/serializer'

packages/nuqs/src/index.server.cache.ts

@@ -0,0 +1,2 @@
+export { createSearchParamsCache } from './cache'
+export type { HistoryOptions, Nullable, Options, SearchParams } from './defs'

packages/nuqs/src/index.server.parsers.ts

@@ -0,0 +1,2 @@
+export type { HistoryOptions, Nullable, Options, SearchParams } from './defs'
+export * from './parsers'

packages/nuqs/src/index.server.serializer.ts

@@ -0,0 +1,2 @@
+export type { HistoryOptions, Nullable, Options, SearchParams } from './defs'
+export { createSerializer } from './serializer'

packages/nuqs/tsup.config.ts

@@ -34,7 +34,10 @@ const entrypoints = {
     'adapters/testing': 'src/adapters/testing.ts'
   },
   server: {
-    server: 'src/index.server.ts'
+    server: 'src/index.server.ts',
+    'server/cache': 'src/index.server.cache.ts',
+    'server/parsers': 'src/index.server.parsers.ts',
+    'server/serializer': 'src/index.server.serializer.ts'
   }
 }