houdini-react 2.0.0-next.2 → 2.0.0-next.23

package/bin/houdini-react

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+// Simple shim that can be replaced with the actual binary for optimal performance
+// This follows esbuild's approach: the postInstall script will replace this entire file
+// with the native binary when possible, eliminating Node.js startup overhead
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+// Manual binary path override support
+const MANUAL_BINARY_PATH = process.env.HOUDINI_BINARY_PATH || process.env.HOUDINI_REACT_BINARY_PATH;
+
+function getBinaryPath() {
+	// Check for manual override first
+	if (MANUAL_BINARY_PATH && fs.existsSync(MANUAL_BINARY_PATH)) {
+		return MANUAL_BINARY_PATH;
+	}
+
+	// Platform-specific package lookup
+	const BINARY_DISTRIBUTION_PACKAGES = {
+		'linux-x64': 'houdini-react-linux-x64',
+		'linux-arm64': 'houdini-react-linux-arm64',
+		'win32-x64': 'houdini-react-win32-x64',
+		'win32-arm64': 'houdini-react-win32-arm64',
+		'darwin-x64': 'houdini-react-darwin-x64',
+		'darwin-arm64': 'houdini-react-darwin-arm64',
+	}
+
+	const binaryName = process.platform === 'win32' ? 'houdini-react.exe' : 'houdini-react'
+	const platformSpecificPackageName = BINARY_DISTRIBUTION_PACKAGES[`${process.platform}-${process.arch}`]
+
+	if (!platformSpecificPackageName) {
+		// Fallback to downloaded binary if platform not supported
+		return path.join(__dirname, binaryName)
+	}
+
+	try {
+		// Method 1: Use require.resolve to find the platform-specific package
+		const platformPackagePath = require.resolve(`${platformSpecificPackageName}/package.json`)
+		const platformPackageDir = path.dirname(platformPackagePath)
+		return path.join(platformPackageDir, 'bin', binaryName)
+	} catch (error) {
+		// Method 2: Check sibling directory (npm structure)
+		const siblingPath = path.join(__dirname, '..', platformSpecificPackageName)
+		const siblingBinaryPath = path.join(siblingPath, 'bin', binaryName)
+
+		if (fs.existsSync(siblingBinaryPath)) {
+			return siblingBinaryPath
+		}
+
+		// Method 3: Check pnpm structure
+		const pnpmMatch = __dirname.match(/(.+\/node_modules\/)\.pnpm\/([^\/]+)\/node_modules\//)
+		if (pnpmMatch) {
+			const [, nodeModulesRoot] = pnpmMatch
+			const pnpmDir = path.join(nodeModulesRoot, '.pnpm')
+
+			try {
+				const pnpmEntries = fs.readdirSync(pnpmDir)
+				// Get the expected version from the main package
+				const packageJSON = require(path.join(__dirname, '..', 'package.json'))
+				const expectedVersion = packageJSON.version
+				const expectedPnpmEntry = `${platformSpecificPackageName}@${expectedVersion}`
+				const platformEntry = pnpmEntries.find(entry => entry === expectedPnpmEntry)
+
+				if (platformEntry) {
+					const pnpmBinaryPath = path.join(pnpmDir, platformEntry, 'node_modules', platformSpecificPackageName, 'bin', binaryName)
+					if (fs.existsSync(pnpmBinaryPath)) {
+						return pnpmBinaryPath
+					}
+				}
+			} catch (err) {
+				// Ignore pnpm detection errors
+			}
+		}
+
+		// Method 4: Fallback to downloaded binary in main package
+		return path.join(__dirname, binaryName)
+	}
+}
+
+// Execute the binary directly (this entire file may be replaced with the actual binary)
+try {
+	execFileSync(getBinaryPath(), process.argv.slice(2), { stdio: 'inherit' });
+} catch (error) {
+	// If execFileSync fails, exit with the same code
+	process.exit(error.status || 1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "houdini-react",
-  "version": "2.0.0-next.2",
+  "version": "2.0.0-next.23",
   "description": "The React plugin for houdini",
   "keywords": [
     "typescript",
@@ -22,8 +22,7 @@
     "@types/estraverse": "^5.1.2",
     "@types/express": "^4.17.17",
     "@types/react": "^19.0.7",
-    "@types/react-dom": "^19.0.3",
-    "scripts": "^1.0.0"
+    "@types/react-dom": "^19.0.3"
   },
   "dependencies": {
     "@babel/parser": "^7.24.6",
@@ -34,43 +33,65 @@
     "cookies": "^0.8.0",
     "estraverse": "^5.3.0",
     "express": "^4.18.2",
-    "graphql": "^16.10.0",
     "graphql-yoga": "^4.0.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "react-streaming-compat": "^0.3.18",
+    "react-streaming": "^0.4.17",
     "recast": "^0.23.1",
-    "rollup": "^4.39.0",
-    "use-deep-compare-effect": "^1.8.1",
-    "houdini": "^2.0.0-next.2"
+    "rollup": "^4.28.1",
+    "use-deep-compare-effect": "^1.8.1"
+  },
+  "peerDependencies": {
+    "graphql": ">=16"
   },
   "files": [
-    "build"
+    "bin",
+    "postInstall.js",
+    "runtime",
+    "server",
+    "vite"
   ],
   "exports": {
     "./package.json": "./package.json",
-    ".": {
-      "types": "./build/plugin/index.d.ts",
-      "import": "./build/plugin-esm/index.js",
-      "require": "./build/plugin-cjs/index.js"
-    },
     "./server": {
-      "types": "./build/server/index.d.ts",
-      "import": "./build/server-esm/index.js",
-      "require": "./build/server-cjs/index.js"
+      "types": "./server/index.d.ts",
+      "import": "./server/index.js"
+    },
+    "./server/*": {
+      "types": "./server/*.d.ts",
+      "import": "./server/*.js"
+    },
+    "./vite": {
+      "types": "./vite/index.d.ts",
+      "import": "./vite/index.js"
+    },
+    "./vite/*": {
+      "types": "./vite/*.d.ts",
+      "import": "./vite/*.js"
     }
   },
   "typesVersions": {
     "*": {
       "server": [
-        "build/server/index.d.ts"
+        "./server/index.d.ts"
+      ],
+      "vite": [
+        "./vite/index.d.ts"
       ]
     }
   },
-  "main": "./build/plugin-cjs/index.js",
-  "types": "./build/plugin/index.d.ts",
+  "optionalDependencies": {
+    "houdini-react-darwin-x64": "2.0.0-next.23",
+    "houdini-react-darwin-arm64": "2.0.0-next.23",
+    "houdini-react-linux-x64": "2.0.0-next.23",
+    "houdini-react-linux-arm64": "2.0.0-next.23",
+    "houdini-react-win32-x64": "2.0.0-next.23",
+    "houdini-react-win32-arm64": "2.0.0-next.23"
+  },
+  "bin": "bin/houdini-react",
   "scripts": {
-    "compile": "scripts build --plugin",
-    "typedefs": "scripts typedefs --plugin"
+    "compile": "scripts build-go",
+    "typedefs": "scripts typedefs --plugin --go-package",
+    "postinstall": "node postInstall.js"
   }
 }

package/postInstall.js

@@ -0,0 +1,353 @@
+const fs = require('fs')
+const path = require('path')
+const zlib = require('zlib')
+const https = require('https')
+const child_process = require('child_process')
+
+// Adjust the version you want to install. You can also make this dynamic.
+const BINARY_DISTRIBUTION_VERSION = '2.0.0-next.23'
+
+// Windows binaries end with .exe so we need to special case them.
+const binaryName = process.platform === 'win32' ? 'houdini-react.exe' : 'houdini-react'
+
+// Determine package name for this platform
+const platformSpecificPackageName = `houdini-react-${process.platform}-${process.arch}`
+
+// Compute the path we want to emit the fallback binary to
+const fallbackBinaryPath = path.join(__dirname, binaryName)
+
+// Manual binary path override support
+const MANUAL_BINARY_PATH = process.env.HOUDINI_BINARY_PATH || process.env.HOUDINI_REACT_BINARY_PATH
+
+// Package version for validation
+const packageJSON = require(path.join(__dirname, 'package.json'))
+const expectedVersion = packageJSON.version
+
+// Track if shim is still JavaScript
+let isShimJS = true
+
+function makeRequest(url) {
+	return new Promise((resolve, reject) => {
+		https
+			.get(url, (response) => {
+				if (response.statusCode >= 200 && response.statusCode < 300) {
+					const chunks = []
+					response.on('data', (chunk) => chunks.push(chunk))
+					response.on('end', () => {
+						resolve(Buffer.concat(chunks))
+					})
+				} else if (
+					response.statusCode >= 300 &&
+					response.statusCode < 400 &&
+					response.headers.location
+				) {
+					// Follow redirects
+					makeRequest(response.headers.location).then(resolve, reject)
+				} else {
+					reject(
+						new Error(
+							`npm responded with status code ${response.statusCode} when downloading the package!`
+						)
+					)
+				}
+			})
+			.on('error', (error) => {
+				reject(error)
+			})
+	})
+}
+
+function extractFileFromTarball(tarballBuffer, filepath) {
+	// Tar archives are organized in 512 byte blocks.
+	// Blocks can either be header blocks or data blocks.
+	// Header blocks contain file names of the archive in the first 100 bytes, terminated by a null byte.
+	// The size of a file is contained in bytes 124-135 of a header block and in octal format.
+	// The following blocks will be data blocks containing the file.
+	let offset = 0
+	while (offset < tarballBuffer.length) {
+		const header = tarballBuffer.subarray(offset, offset + 512)
+		offset += 512
+
+		const fileName = header.toString('utf-8', 0, 100).replace(/\0.*/g, '')
+		const fileSize = parseInt(header.toString('utf-8', 124, 136).replace(/\0.*/g, ''), 8)
+
+		if (fileName === filepath) {
+			return tarballBuffer.subarray(offset, offset + fileSize)
+		}
+
+		// Clamp offset to the uppoer multiple of 512
+		offset = (offset + fileSize + 511) & ~511
+	}
+}
+
+function installUsingNPM() {
+	// Erase "npm_config_global" so that "npm install --global" works.
+	// Otherwise this nested "npm install" will also be global, and the install
+	// will deadlock waiting for the global installation lock.
+	const env = { ...process.env, npm_config_global: undefined };
+
+	// Create a temporary directory with an empty package.json
+	const tempDir = path.join(__dirname, 'npm-install-temp');
+
+	try {
+		fs.mkdirSync(tempDir);
+		fs.writeFileSync(path.join(tempDir, 'package.json'), '{}');
+
+		// Run npm install in the temporary directory
+		child_process.execSync(
+			`npm install --loglevel=error --prefer-offline --no-audit --progress=false ${platformSpecificPackageName}@${BINARY_DISTRIBUTION_VERSION}`,
+			{ cwd: tempDir, stdio: 'pipe', env }
+		);
+
+		// Move the downloaded binary to the fallback location
+		const installedBinaryPath = path.join(tempDir, 'node_modules', platformSpecificPackageName, 'bin', binaryName);
+		fs.renameSync(installedBinaryPath, fallbackBinaryPath);
+
+		return true;
+	} catch (err) {
+		console.error(`[${packageJSON.name}] npm install fallback failed: ${err.message}`);
+		return false;
+	} finally {
+		// Clean up temporary directory
+		try {
+			removeRecursive(tempDir);
+		} catch {
+			// Ignore cleanup errors
+		}
+	}
+}
+
+function removeRecursive(dir) {
+	if (!fs.existsSync(dir)) return;
+
+	for (const entry of fs.readdirSync(dir)) {
+		const entryPath = path.join(dir, entry);
+		const stats = fs.lstatSync(entryPath);
+
+		if (stats.isDirectory()) {
+			removeRecursive(entryPath);
+		} else {
+			fs.unlinkSync(entryPath);
+		}
+	}
+
+	fs.rmdirSync(dir);
+}
+
+async function downloadBinaryFromNpm() {
+	// First try nested npm install (like esbuild does)
+	if (installUsingNPM()) {
+		console.log(`[${packageJSON.name}] Downloaded binary via npm install`);
+		return;
+	}
+
+	// Fallback to direct HTTP download
+	console.log(`[${packageJSON.name}] Trying direct download from npm registry...`);
+
+	// Download the tarball of the right binary distribution package
+	const tarballDownloadBuffer = await makeRequest(
+		`https://registry.npmjs.org/${platformSpecificPackageName}/-/${platformSpecificPackageName}-${BINARY_DISTRIBUTION_VERSION}.tgz`
+	)
+
+	const tarballBuffer = zlib.unzipSync(tarballDownloadBuffer)
+
+	// Extract binary from package and write to disk
+	fs.writeFileSync(
+		fallbackBinaryPath,
+		extractFileFromTarball(tarballBuffer, `package/bin/${binaryName}`),
+		{ mode: 0o755 } // Make binary file executable
+	)
+
+	console.log(`[${packageJSON.name}] Downloaded binary via direct download`);
+}
+
+function isPlatformSpecificPackageInstalled() {
+	try {
+		// Try to resolve the platform package itself
+		require.resolve(`${platformSpecificPackageName}/package.json`)
+		return true
+	} catch (e) {
+		// Also check if it exists as a sibling directory
+		const siblingPath = path.join(__dirname, '..', platformSpecificPackageName)
+		const siblingBinaryPath = path.join(siblingPath, 'bin', binaryName)
+		return fs.existsSync(siblingBinaryPath)
+	}
+}
+
+if (!platformSpecificPackageName) {
+	throw new Error('Platform not supported!')
+}
+
+// Replace the JavaScript shim with the actual binary for optimal performance (skip Node.js overhead)
+// This is inspired by esbuild's approach: https://github.com/evanw/esbuild/blob/main/lib/npm/node-install.ts
+function maybeOptimizePackage() {
+	// This optimization doesn't work on Windows because the binary must be called with .exe extension
+	// It also doesn't work with Yarn due to various compatibility issues
+	if (process.platform === 'win32' || isYarn()) {
+		return
+	}
+
+	let binaryPath = null
+
+	try {
+		// Method 1: Use require.resolve to find the platform-specific package
+		const platformPackagePath = require.resolve(`${platformSpecificPackageName}/package.json`)
+		const platformPackageDir = path.dirname(platformPackagePath)
+		binaryPath = path.join(platformPackageDir, 'bin', binaryName)
+	} catch (error) {
+		// Method 2: Check if platform package is installed as a sibling directory
+		const siblingPath = path.join(__dirname, '..', platformSpecificPackageName)
+		binaryPath = path.join(siblingPath, 'bin', binaryName)
+
+		if (!fs.existsSync(binaryPath)) {
+			// Method 3: pnpm-specific structure
+			const pnpmMatch = __dirname.match(/(.+\/node_modules\/)\.pnpm\/([^\/]+)\/node_modules\//)
+			if (pnpmMatch) {
+				const [, nodeModulesRoot] = pnpmMatch
+				const pnpmDir = path.join(nodeModulesRoot, '.pnpm')
+
+				try {
+					const pnpmEntries = fs.readdirSync(pnpmDir)
+					// Look for the specific version that matches BINARY_DISTRIBUTION_VERSION
+					const expectedPnpmEntry = `${platformSpecificPackageName}@${BINARY_DISTRIBUTION_VERSION}`
+					const platformEntry = pnpmEntries.find(entry => entry === expectedPnpmEntry)
+
+					if (platformEntry) {
+						binaryPath = path.join(pnpmDir, platformEntry, 'node_modules', platformSpecificPackageName, 'bin', binaryName)
+					}
+				} catch (err) {
+					// Ignore errors
+				}
+			}
+		}
+	}
+
+	// If we found the binary, try to replace the shim with it
+	if (binaryPath && fs.existsSync(binaryPath)) {
+		// First validate the binary works correctly
+		if (!validateBinaryVersion(binaryPath)) {
+			console.error(`[${packageJSON.name}] Binary validation failed, keeping JavaScript shim`);
+			return;
+		}
+
+		const shimPath = path.join(__dirname, 'bin', packageJSON.name)
+		const tempPath = path.join(__dirname, 'bin', `${packageJSON.name}-temp`)
+
+		try {
+			// First create a hard link to avoid taking up additional disk space
+			fs.linkSync(binaryPath, tempPath)
+
+			// Then atomically replace the shim with the binary
+			fs.renameSync(tempPath, shimPath)
+
+			// Make sure it's executable
+			fs.chmodSync(shimPath, 0o755)
+
+			// Update state tracking
+			isShimJS = false
+
+			console.log(`[${packageJSON.name}] Binary optimization successful`);
+		} catch (err) {
+			console.error(`[${packageJSON.name}] Binary optimization failed: ${err.message}`);
+			// If optimization fails, clean up and continue with the shim
+			try {
+				fs.unlinkSync(tempPath)
+			} catch {}
+		}
+	}
+}
+
+function validateBinaryVersion(binaryPath) {
+	try {
+		// For our Go binaries, we just check if they execute without crashing
+		// We use -h flag which should work and exit cleanly
+		child_process.execFileSync(binaryPath, ['-h'], {
+			stdio: 'pipe',
+			timeout: 5000,
+			encoding: 'utf8'
+		});
+		return true;
+	} catch (err) {
+		// If the binary exits with code 0 or 2 (help), that's fine
+		if (err.status === 0 || err.status === 2) {
+			return true;
+		}
+		console.error(`[${packageJSON.name}] Binary validation failed: ${err.message}`);
+		return false;
+	}
+}
+
+function applyManualBinaryPathOverride(overridePath) {
+	console.log(`[${packageJSON.name}] Using manual binary path: ${overridePath}`);
+
+	const shimPath = path.join(__dirname, 'bin', packageJSON.name);
+	const shimContent = `#!/usr/bin/env node
+require('child_process').execFileSync(${JSON.stringify(overridePath)}, process.argv.slice(2), { stdio: 'inherit' });
+`;
+
+	try {
+		fs.writeFileSync(shimPath, shimContent, { mode: 0o755 });
+		isShimJS = true; // Keep as JS since it's a wrapper
+		return true;
+	} catch (err) {
+		console.error(`[${packageJSON.name}] Failed to apply manual binary override: ${err.message}`);
+		return false;
+	}
+}
+
+function isYarn() {
+	const { npm_config_user_agent } = process.env
+	if (npm_config_user_agent) {
+		return /\byarn\//.test(npm_config_user_agent)
+	}
+	return false
+}
+
+// Check for manual binary path override first
+if (MANUAL_BINARY_PATH) {
+	if (fs.existsSync(MANUAL_BINARY_PATH)) {
+		console.log(`[${packageJSON.name}] Using manual binary path override`);
+		if (applyManualBinaryPathOverride(MANUAL_BINARY_PATH)) {
+			process.exit(0);
+		}
+	} else {
+		console.warn(`[${packageJSON.name}] Ignoring invalid manual binary path: ${MANUAL_BINARY_PATH}`);
+	}
+}
+
+// Skip downloading the binary if it was already installed via optionalDependencies
+if (!isPlatformSpecificPackageInstalled()) {
+	console.log(`[${packageJSON.name}] Platform package not found, downloading binary...`);
+	downloadBinaryFromNpm().then(() => {
+		maybeOptimizePackage();
+
+		// Final validation
+		const shimPath = path.join(__dirname, 'bin', packageJSON.name);
+		if (isShimJS) {
+			// Validate the JavaScript shim can find and run the binary
+			if (!validateBinaryVersion(shimPath)) {
+				console.error(`[${packageJSON.name}] Installation may be incomplete`);
+			}
+		}
+	}).catch(err => {
+		console.error(`[${packageJSON.name}] Failed to download binary: ${err.message}`);
+		process.exit(1);
+	});
+} else {
+	console.log(`[${packageJSON.name}] Platform package found, optimizing...`);
+	maybeOptimizePackage();
+
+	// Final validation
+	const shimPath = path.join(__dirname, 'bin', packageJSON.name);
+	if (isShimJS) {
+		// Validate the JavaScript shim can find and run the binary
+		if (!validateBinaryVersion(shimPath)) {
+			console.error(`[${packageJSON.name}] Installation may be incomplete`);
+		}
+	} else {
+		// Binary was optimized, validate it directly
+		if (!validateBinaryVersion(shimPath)) {
+			console.error(`[${packageJSON.name}] Binary optimization may have failed`);
+		}
+	}
+}

package/runtime/client.ts

@@ -0,0 +1,5 @@
+import type { HoudiniClient } from '$houdini/runtime/client'
+
+// this file will be replaced by the code generation process
+
+export default (() => {}) as () => HoudiniClient

package/runtime/clientPlugin.ts

@@ -0,0 +1,17 @@
+import type { ClientPlugin } from 'houdini/runtime/client'
+
+const plugin: () => ClientPlugin = () => () => {
+	return {
+		start(ctx, { next }) {
+			next({
+				...ctx,
+				cacheParams: {
+					...ctx.cacheParams,
+					serverSideFallback: false,
+				},
+			})
+		},
+	}
+}
+
+export default plugin

package/runtime/componentFields.ts

@@ -0,0 +1,79 @@
+import { getFieldsForType } from 'houdini/runtime'
+import type { DocumentArtifact, GraphQLObject, GraphQLValue } from 'houdini/runtime'
+import { defaultComponentField, type Cache } from 'houdini/runtime/cache'
+
+export function injectComponents({
+	cache,
+	selection,
+	data,
+	variables,
+	parentType = 'Query',
+}: {
+	cache: Cache
+	selection: DocumentArtifact['selection']
+	data: GraphQLValue | null
+	variables: Record<string, GraphQLValue> | undefined | null
+	parentType?: string
+}) {
+	// if the value is null, we're done
+	if (data === null) {
+		return
+	}
+
+	// if the value is not an object (ie its a scalar) we're done
+	if (typeof data !== 'object') {
+		return
+	}
+	data = data as GraphQLObject
+
+	// if the value is an array we need to instantiate each item
+	if (Array.isArray(data)) {
+		data.forEach((item) => {
+			injectComponents({
+				cache,
+				selection,
+				data: item,
+				variables,
+				parentType,
+			})
+		})
+		return
+	}
+
+	// if the object has a subselection we need to walk down
+	const typename = '__typename' in data ? (data.__typename as string) : ''
+	const fields = getFieldsForType(selection, typename, false)
+	if (!fields) {
+		return
+	}
+
+	// walk down each field
+	for (const [field, subSelection] of Object.entries(fields)) {
+		// if the field is a component then we need to assign the value to the target
+		if (subSelection.component) {
+			// if the component is already in the cache, we're done
+			if (!cache._internal_unstable.componentCache[subSelection.component.key]) {
+				continue
+			}
+
+			data[field] = defaultComponentField({
+				variables,
+				parent: cache._internal_unstable.id(parentType, data) ?? '',
+				cache,
+				component: subSelection.component,
+			}) as any as GraphQLValue
+		}
+
+		// if there is a selection, we need to walk down
+		const dataValue = data[field]
+		if (subSelection.selection) {
+			injectComponents({
+				cache,
+				selection: subSelection.selection,
+				data: dataValue,
+				variables,
+				parentType: subSelection.type,
+			})
+		}
+	}
+}

package/runtime/hooks/index.ts

@@ -0,0 +1,9 @@
+export { useQuery } from './useQuery'
+export { useQueryHandle } from './useQueryHandle'
+export { useFragment } from './useFragment'
+export { useFragmentHandle } from './useFragmentHandle'
+export { useMutation } from './useMutation'
+export { useSubscription } from './useSubscription'
+
+export type { DocumentHandle } from './useDocumentHandle'
+export type { UseQueryConfig } from './useQueryHandle'