houdini-core 2.0.0-next.15 → 2.0.0-next.17

package/bin/houdini-core

@@ -1,88 +1,173 @@
 #!/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_CORE_BINARY_PATH;
+const binaryName = process.platform === 'win32' ? 'houdini-core.exe' : 'houdini-core';
+
+const BINARY_DISTRIBUTION_PACKAGES = {
+	'linux-x64':   'houdini-core-linux-x64',
+	'linux-arm64': 'houdini-core-linux-arm64',
+	'win32-x64':   'houdini-core-win32-x64',
+	'win32-arm64': 'houdini-core-win32-arm64',
+	'darwin-x64':  'houdini-core-darwin-x64',
+	'darwin-arm64':'houdini-core-darwin-arm64',
+};
+
+const PLATFORM_OVERRIDE = process.env.HOUDINI_PLATFORM;
+const MANUAL_BINARY_PATH = process.env.HOUDINI_CORE_BINARY_PATH || process.env.HOUDINI_BINARY_PATH;
+
+// --- WASM path ---
+if (PLATFORM_OVERRIDE === 'wasm') {
+	const wasmPackage = 'houdini-core-wasm';
+	const wasmBinaryName = 'houdini-core.wasm';
+	let wasmBin = null;
+
+	try {
+		const pkgPath = require.resolve(`${wasmPackage}/package.json`);
+		wasmBin = path.join(path.dirname(pkgPath), 'bin', wasmBinaryName);
+	} catch {
+		const sibling = path.join(__dirname, '..', wasmPackage, 'bin', wasmBinaryName);
+		if (fs.existsSync(sibling)) wasmBin = sibling;
+	}
+
+	if (!wasmBin || !fs.existsSync(wasmBin)) {
+		process.stderr.write(`[houdini-core] WASM package not installed. Try: npm install ${wasmPackage}\n`);
+		process.exit(1);
+	}
+
+	// In WebContainers, fs.readSync on a pipe fd is not supported in any thread
+	// (the child gets EBADF). Instead:
+	//   Main thread  — async process.stdin.on('data') works fine (event loop)
+	//   Worker thread — Atomics.wait + receiveMessageOnPort provides real blocking
+	// A custom fd_read override feeds WASM stdin from the message channel so WASI
+	// never touches fd 0 directly.
+	const { Worker, isMainThread, workerData, MessageChannel, receiveMessageOnPort } = require('worker_threads');
+
+	if (isMainThread) {
+		const { port1: stdinMain, port2: stdinWorker } = new MessageChannel();
+		// Counter: main increments (Atomics.add) per message so rapid bursts
+		// (two frames in the same tick) produce two distinct wakeups.
+		const syncBuf = new Int32Array(new SharedArrayBuffer(4));
+
+		process.stdin.on('error', () => {});
+		process.stdin.on('data', data => {
+			stdinMain.postMessage(data);
+			Atomics.add(syncBuf, 0, 1);
+			Atomics.notify(syncBuf, 0);
+		});
+		process.stdin.on('end', () => {
+			stdinMain.postMessage(null); // EOF sentinel
+			Atomics.add(syncBuf, 0, 1);
+			Atomics.notify(syncBuf, 0);
+		});
+
+		const worker = new Worker(__filename, {
+			workerData: { wasmBin, args: process.argv.slice(2), stdinPort: stdinWorker, syncBuf },
+			transferList: [stdinWorker],
+		});
+		worker.on('exit', code => process.exit(code ?? 0));
+		return; // prevent fallthrough to native binary path
+	} else {
+		const { wasmBin: wb, args, stdinPort, syncBuf } = workerData;
+		const { WASI } = require('node:wasi');
+
+		const wasi = new WASI({
+			args: [wb, ...args],
+			env: process.env,
+			preopens: { '/': '/' },
+			version: 'preview1',
+		});
+
+		let wasmMem = null;
+		const importObj = wasi.getImportObject();
+		const realFdRead = importObj.wasi_snapshot_preview1.fd_read;
+
+		// Override fd_read for stdin (fd 0) only: block via Atomics until the main
+		// thread delivers a chunk, then copy it into WASM memory via iov buffers.
+		importObj.wasi_snapshot_preview1.fd_read = (fd, iovs, iovsLen, nread) => {
+			if (fd !== 0 || !wasmMem) return realFdRead(fd, iovs, iovsLen, nread);
 
+			while (Atomics.load(syncBuf, 0) === 0) {
+				Atomics.wait(syncBuf, 0, 0);
+			}
+			const msg = receiveMessageOnPort(stdinPort);
+			Atomics.sub(syncBuf, 0, 1);
+
+			const view = new DataView(wasmMem.buffer);
+			if (!msg || msg.message === null) {
+				view.setUint32(nread, 0, true); // EOF
+				return 0;
+			}
+
+			const chunk = msg.message;
+			const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+			let written = 0;
+			for (let i = 0; i < iovsLen; i++) {
+				const ptr = view.getUint32(iovs + i * 8, true);
+				const len = view.getUint32(iovs + i * 8 + 4, true);
+				const n = Math.min(len, buf.length - written);
+				if (n <= 0) break;
+				new Uint8Array(wasmMem.buffer, ptr, n).set(buf.subarray(written, written + n));
+				written += n;
+			}
+			view.setUint32(nread, written, true);
+			return 0;
+		};
+
+		const mod = new WebAssembly.Module(fs.readFileSync(wb));
+		const inst = new WebAssembly.Instance(mod, importObj);
+		wasmMem = inst.exports.memory;
+		wasi.start(inst);
+		process.exit(0);
+	}
+}
+
+// --- Native 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-core-linux-x64',
-		'linux-arm64': 'houdini-core-linux-arm64',
-		'win32-x64': 'houdini-core-win32-x64',
-		'win32-arm64': 'houdini-core-win32-arm64',
-		'darwin-x64': 'houdini-core-darwin-x64',
-		'darwin-arm64': 'houdini-core-darwin-arm64',
-	}
-
-	const binaryName = process.platform === 'win32' ? 'houdini-core.exe' : 'houdini-core'
-	const platformSpecificPackageName = BINARY_DISTRIBUTION_PACKAGES[`${process.platform}-${process.arch}`]
+	const platformKey = PLATFORM_OVERRIDE || `${process.platform}-${process.arch}`;
+	const platformSpecificPackageName = BINARY_DISTRIBUTION_PACKAGES[platformKey];
 
 	if (!platformSpecificPackageName) {
-		// Fallback to downloaded binary if platform not supported
-		return path.join(__dirname, binaryName)
+		if (PLATFORM_OVERRIDE) {
+			process.stderr.write(`[houdini-core] Unknown platform "${PLATFORM_OVERRIDE}". Valid values: ${Object.keys(BINARY_DISTRIBUTION_PACKAGES).join(', ')}, wasm\n`);
+			process.exit(1);
+		}
+		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
-		}
+		const platformPackagePath = require.resolve(`${platformSpecificPackageName}/package.json`);
+		return path.join(path.dirname(platformPackagePath), 'bin', binaryName);
+	} catch {
+		const siblingPath = path.join(__dirname, '..', platformSpecificPackageName, 'bin', binaryName);
+		if (fs.existsSync(siblingPath)) return siblingPath;
 
-		// Method 3: Check pnpm structure
-		const pnpmMatch = __dirname.match(/(.+\/node_modules\/)\.pnpm\/([^\/]+)\/node_modules\//)
+		const pnpmMatch = __dirname.match(/(.+\/node_modules\/)\.pnpm\/[^/]+\/node_modules\//);
 		if (pnpmMatch) {
-			const [, nodeModulesRoot] = pnpmMatch
-			const pnpmDir = path.join(nodeModulesRoot, '.pnpm')
-
+			const pnpmDir = path.join(pnpmMatch[1], '.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
-					}
+				const packageJSON = require(path.join(__dirname, '..', 'package.json'));
+				const entry = `${platformSpecificPackageName}@${packageJSON.version}`;
+				const found = fs.readdirSync(pnpmDir).find(e => e === entry);
+				if (found) {
+					const p = path.join(pnpmDir, found, 'node_modules', platformSpecificPackageName, 'bin', binaryName);
+					if (fs.existsSync(p)) return p;
 				}
-			} catch (err) {
-				// Ignore pnpm detection errors
-			}
+			} catch {}
 		}
 
-		// Method 4: Fallback to downloaded binary in main package
-		return path.join(__dirname, binaryName)
+		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-core",
-  "version": "2.0.0-next.15",
+  "version": "2.0.0-next.17",
   "description": "The core GraphQL client for Houdini",
   "keywords": [
     "graphql",
@@ -16,19 +16,19 @@
   "license": "MIT",
   "devDependencies": {},
   "dependencies": {
-    "@whatwg-node/server": "^0.9.14",
-    "graphql-yoga": "^4.0.4",
-    "minimatch": "^5.1.0"
+    "@whatwg-node/server": "^0.11.0",
+    "graphql-yoga": "^5.21.1",
+    "minimatch": "^10.2.5"
   },
   "optionalDependencies": {
-    "houdini-core-darwin-x64": "2.0.0-next.15",
-    "houdini-core-darwin-arm64": "2.0.0-next.15",
-    "houdini-core-linux-x64": "2.0.0-next.15",
-    "houdini-core-linux-arm64": "2.0.0-next.15",
-    "houdini-core-win32-x64": "2.0.0-next.15",
-    "houdini-core-win32-arm64": "2.0.0-next.15"
+    "houdini-core-darwin-x64": "2.0.0-next.17",
+    "houdini-core-darwin-arm64": "2.0.0-next.17",
+    "houdini-core-linux-x64": "2.0.0-next.17",
+    "houdini-core-linux-arm64": "2.0.0-next.17",
+    "houdini-core-win32-x64": "2.0.0-next.17",
+    "houdini-core-win32-arm64": "2.0.0-next.17",
+    "houdini-core-wasm": "2.0.0-next.17"
   },
-  "bin": "bin/houdini-core",
   "files": [
     "bin",
     "postInstall.js",
@@ -38,5 +38,8 @@
     "compile": "scripts build-go",
     "typedefs": "scripts typedefs --go-package",
     "postinstall": "node postInstall.js"
+  },
+  "bin": {
+    "houdini-core": "bin/houdini-core"
   }
 }

package/postInstall.js

@@ -5,7 +5,7 @@ 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.15'
+const BINARY_DISTRIBUTION_VERSION = '2.0.0-next.17'
 
 // Windows binaries end with .exe so we need to special case them.
 const binaryName = process.platform === 'win32' ? 'houdini-core.exe' : 'houdini-core'
@@ -181,6 +181,13 @@ if (!platformSpecificPackageName) {
 // 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() {
+	// Allow callers to opt out of the optimization (e.g. when building a snapshot
+	// for an environment that can't run native binaries, like WebContainers).
+	if (process.env.HOUDINI_SKIP_SHIM_INSTALL) {
+		console.log(`[${packageJSON.name}] HOUDINI_SKIP_SHIM_INSTALL set, keeping JavaScript shim`)
+		return
+	}
+
 	// 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()) {

package/runtime/cache.ts

@@ -1,6 +1,6 @@
 import { Cache } from 'houdini/runtime/cache'
 
-import { getCurrentConfig } from './config'
+import { getCurrentConfig } from './config.js'
 
 export type { Cache }
 export default new Cache(getCurrentConfig())

package/runtime/client.ts

@@ -10,9 +10,9 @@ import type {
 	GraphQLVariables,
 } from 'houdini/runtime/types'
 
-import cacheRef from './cache'
-import { getCurrentConfig, localApiEndpoint } from './config'
-import type { FetchParamFn, ThrowOnErrorParams } from './plugins'
+import cacheRef from './cache.js'
+import { getCurrentConfig, localApiEndpoint } from './config.js'
+import type { FetchParamFn, ThrowOnErrorParams } from './plugins/index.js'
 import {
 	fetch as fetchPlugin,
 	fetchParams as fetchParamsPlugin,
@@ -22,11 +22,11 @@ import {
 	throwOnError as throwOnErrorPlugin,
 	optimisticKeys,
 	cachePolicy,
-} from './plugins'
-import pluginsFromPlugins from './plugins/injectedPlugins'
+} from './plugins/index.js'
+import pluginsFromPlugins from './plugins/injectedPlugins.js'
 
 // export the plugin constructors
-export { fetch, mutation, query, subscription } from './plugins'
+export { fetch, mutation, query, subscription } from './plugins/index.js'
 export { DocumentStore, type ClientPlugin, type SendParams } from 'houdini/runtime/documentStore'
 
 export type HoudiniClientConstructorArgs = {

package/runtime/config.ts

@@ -1,7 +1,7 @@
 import type { ConfigFile } from 'houdini'
 
-import config from './imports/config'
-import pluginConfigs from './imports/pluginConfig'
+import config from './imports/config.js'
+import pluginConfigs from './imports/pluginConfig.js'
 
 let mockConfig: ConfigFile | null = null
 

package/runtime/index.ts

@@ -1,14 +1,14 @@
 import type { Cache as InternalCache } from 'houdini/runtime/cache'
 
-import _cache from './cache'
-import type { CacheTypeDef } from './generated'
-import { Cache } from './public'
+import _cache from './cache.js'
+import type { CacheTypeDef } from './generated.js'
+import { Cache } from './public/index.js'
 
 export { CachePolicy, PendingValue } from 'houdini/runtime'
 export type { QueryArtifact, GraphQLVariables } from 'houdini/runtime'
 
-export * from './client'
-export { getCurrentConfig } from './config'
+export * from './client.js'
+export { getCurrentConfig } from './config.js'
 
 // this template tag gets removed by the preprocessor so it should never be invoked.
 // this function must return any so that we can assign it a type in a variable declaration (ie an inline store)

package/runtime/plugins/cache.ts

@@ -2,7 +2,7 @@ import { Cache } from 'houdini/runtime/cache'
 import type { ClientPlugin } from 'houdini/runtime/documentStore'
 import { ArtifactKind, CachePolicy, DataSource, type GraphQLObject } from 'houdini/runtime/types'
 
-import cache from '../cache'
+import cache from '../cache.js'
 
 const serverSide = typeof globalThis.window === 'undefined'
 

package/runtime/plugins/fragment.ts

@@ -2,7 +2,7 @@ import { deepEquals } from 'houdini/runtime'
 import type { Cache } from 'houdini/runtime/cache'
 import { type SubscriptionSpec, ArtifactKind, DataSource } from 'houdini/runtime/types'
 
-import { documentPlugin } from './utils'
+import { documentPlugin } from './utils/index.js'
 
 // the purpose of the fragment plugin is to provide fine-reactivity for cache updates
 // there are no network requests that get sent. send() always returns the initial value

package/runtime/plugins/index.ts

@@ -1,9 +1,9 @@
-export * from './fetch'
-export * from './cache'
-export * from './query'
-export * from './fragment'
-export * from './mutation'
-export * from './subscription'
-export * from './throwOnError'
-export * from './fetchParams'
-export { optimisticKeys } from './optimisticKeys'
+export * from './fetch.js'
+export * from './cache.js'
+export * from './query.js'
+export * from './fragment.js'
+export * from './mutation.js'
+export * from './subscription.js'
+export * from './throwOnError.js'
+export * from './fetchParams.js'
+export { optimisticKeys } from './optimisticKeys.js'

package/runtime/plugins/mutation.ts

@@ -3,7 +3,7 @@ import type { SubscriptionSpec } from 'houdini/runtime'
 import { ArtifactKind } from 'houdini/runtime'
 import type { Cache } from 'houdini/runtime/cache'
 
-import { documentPlugin } from './utils'
+import { documentPlugin } from './utils/index.js'
 
 export const mutation = (cache: Cache) =>
 	documentPlugin(ArtifactKind.Mutation, () => {

package/runtime/plugins/optimisticKeys.ts

@@ -9,7 +9,7 @@ import type {
 } from 'houdini/runtime/types'
 import { ArtifactKind } from 'houdini/runtime/types'
 
-import configFile from '../imports/config'
+import configFile from '../imports/config.js'
 
 // This plugin is responsible for coordinating requests that have optimistic keys.
 // When a mutation contains optimistically generated keys as inputs, we need to block

package/runtime/plugins/query.ts

@@ -2,7 +2,7 @@ import type { RuntimeScalarPayload } from 'houdini'
 import type { Cache } from 'houdini/runtime/cache'
 import { type SubscriptionSpec, ArtifactKind, DataSource } from 'houdini/runtime/types'
 
-import { documentPlugin } from './utils'
+import { documentPlugin } from './utils/index.js'
 
 export const query = (cache: Cache) =>
 	documentPlugin(ArtifactKind.Query, () => {

package/runtime/plugins/subscription.ts

@@ -2,7 +2,7 @@ import { deepEquals } from 'houdini/runtime'
 import type { ClientPluginContext } from 'houdini/runtime/documentStore'
 import { ArtifactKind, DataSource } from 'houdini/runtime/types'
 
-import { documentPlugin } from './utils'
+import { documentPlugin } from './utils/index.js'
 
 export function subscription(factory: SubscriptionHandler) {
 	return documentPlugin(ArtifactKind.Subscription, () => {

package/runtime/plugins/utils/index.ts

@@ -1 +1 @@
-export * from './documentPlugins'
+export * from './documentPlugins.js'

package/runtime/public/cache.ts

@@ -2,9 +2,9 @@ import type { Cache as _Cache } from 'houdini/runtime/cache'
 import { marshalInputs } from 'houdini/runtime/scalars'
 import type { QueryArtifact } from 'houdini/runtime/types'
 
-import { getCurrentConfig } from '../config'
-import { ListCollection } from './list'
-import { Record } from './record'
+import { getCurrentConfig } from '../config.js'
+import { ListCollection } from './list.js'
+import { Record } from './record.js'
 import type {
 	ArgType,
 	CacheTypeDef,
@@ -15,7 +15,7 @@ import type {
 	TypeFieldNames,
 	TypeNames,
 	ValidLists,
-} from './types'
+} from './types.js'
 
 export class Cache<Def extends CacheTypeDef> {
 	_internal_unstable: _Cache

package/runtime/public/index.ts

@@ -1 +1 @@
-export { Cache } from './cache'
+export { Cache } from './cache.js'

package/runtime/public/list.ts

@@ -1,9 +1,9 @@
 import type { GraphQLObject, SubscriptionSelection } from 'houdini/runtime'
 import type { ListCollection as _Collection } from 'houdini/runtime/cache/lists'
 
-import type { Cache } from './cache'
-import { Record } from './record'
-import type { CacheTypeDef, ListType, ValidLists, ListFilters } from './types'
+import type { Cache } from './cache.js'
+import { Record } from './record.js'
+import type { CacheTypeDef, ListType, ValidLists, ListFilters } from './types.js'
 
 export class ListCollection<Def extends CacheTypeDef, ListName extends ValidLists<Def>> {
 	#parentID: string | undefined

package/runtime/public/record.ts

@@ -3,7 +3,7 @@ import { keyFieldsForType } from 'houdini/runtime'
 import type { FragmentArtifact, GraphQLObject } from 'houdini/runtime'
 import { rootID } from 'houdini/runtime/cache/stuff'
 
-import type { Cache } from './cache'
+import type { Cache } from './cache.js'
 import type {
 	ArgType,
 	CacheTypeDef,
@@ -12,7 +12,7 @@ import type {
 	FragmentVariables,
 	TypeFieldNames,
 	ValidTypes,
-} from './types'
+} from './types.js'
 
 export class Record<Def extends CacheTypeDef, Type extends ValidTypes<Def>> {
 	#id: string

package/runtime/public/types.ts

@@ -1,4 +1,4 @@
-import type { Record } from './record'
+import type { Record } from './record.js'
 
 export type CacheTypeDef = {
 	types: {