feat: add node client entrypoint stub

Author: cesarenaldi

biome.json

@@ -74,6 +74,30 @@
           }
         }
       }
+    },
+    {
+      "includes": ["packages/client/src/**/*.ts"],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "patterns": [
+                  {
+                    "group": [
+                      "**/node",
+                      "**/node.ts",
+                      "@polymarket/client/node"
+                    ],
+                    "message": "Import shared client modules directly instead of routing through the Node-only entrypoint."
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
     }
   ]
 }

packages/client/package.json

@@ -10,6 +10,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
     "./actions": {
       "types": "./dist/actions/index.d.ts",
       "default": "./dist/actions/index.js"
@@ -21,6 +25,9 @@
   },
   "typesVersions": {
     "*": {
+      "node": [
+        "./dist/node.d.ts"
+      ],
       "actions": [
         "./dist/actions/index.d.ts"
       ],

packages/client/src/node.test.ts

@@ -0,0 +1,21 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+const clientSourceDir = dirname(fileURLToPath(import.meta.url));
+const nodeEntryUrl = pathToFileURL(resolve(clientSourceDir, 'node.ts'));
+
+describe('node entrypoint', () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it('rejects browser-like runtimes during module evaluation', async () => {
+    vi.stubGlobal('window', {});
+    vi.stubGlobal('document', {});
+
+    await expect(
+      import(`${nodeEntryUrl.href}?browser=${Date.now()}`),
+    ).rejects.toThrow(/browser-like runtime/i);
+  });
+});

packages/client/src/node.ts

@@ -0,0 +1,26 @@
+import process from 'node:process';
+import { invariant } from '@polymarket/types';
+import {
+  type PublicClientConfig as BasePublicClientConfig,
+  createPublicClient as createBasePublicClient,
+  type PublicClient,
+} from './clients';
+
+invariant(
+  process.release.name === 'node',
+  'The @polymarket/client/node entrypoint requires a Node.js runtime.',
+);
+invariant(
+  typeof window === 'undefined' && typeof document === 'undefined',
+  'The @polymarket/client/node entrypoint cannot be imported in a browser-like runtime.',
+);
+
+export type PublicClientConfig = BasePublicClientConfig & {
+  // TODO add builder credentials here
+};
+
+export function createPublicClient(
+  config: PublicClientConfig = {},
+): PublicClient {
+  return createBasePublicClient(config);
+}

packages/client/tsup.config.ts

@@ -2,16 +2,30 @@
 
 import { defineConfig } from 'tsup';
 
-export default defineConfig(() => ({
-  entry: ['src/index.ts', 'src/actions/index.ts', 'src/viem/index.ts'],
-  outDir: 'dist',
-  sourcemap: true,
-  treeshake: true,
-  clean: true,
-  tsconfig: 'tsconfig.build.json',
-  bundle: true,
-  minify: true,
-  dts: true,
-  platform: 'neutral',
-  format: ['esm'],
-}));
+export default defineConfig(() => [
+  {
+    entry: ['src/index.ts', 'src/actions/index.ts', 'src/viem/index.ts'],
+    outDir: 'dist',
+    sourcemap: true,
+    treeshake: true,
+    clean: true,
+    tsconfig: 'tsconfig.build.json',
+    bundle: true,
+    minify: true,
+    dts: true,
+    platform: 'neutral',
+    format: ['esm'],
+  },
+  {
+    entry: ['src/node.ts'],
+    outDir: 'dist',
+    sourcemap: true,
+    treeshake: true,
+    clean: true,
+    tsconfig: 'tsconfig.build.json',
+    minify: true,
+    dts: true,
+    platform: 'node',
+    format: ['esm'],
+  },
+]);

tsconfig.json

@@ -10,6 +10,7 @@
       "@polymarket/bindings/data": ["./packages/bindings/src/data"],
       "@polymarket/bindings/gamma": ["./packages/bindings/src/gamma"],
       "@polymarket/client": ["./packages/client/src"],
+      "@polymarket/client/node": ["./packages/client/src/node.ts"],
       "@polymarket/client/actions": ["./packages/client/src/actions"],
       "@polymarket/client/viem": ["./packages/client/src/viem"],
       "@polymarket/types": ["./packages/types/src"]