@gajae-code/natives 0.14.2 → 0.15.0

package/native/index.d.ts

@@ -524,7 +524,7 @@ export declare function __piNativesPublishOutcomeV1(): void
  * `packages/natives/native/index.js` (which derives the name from
  * `package.json#version`).
  */
-export declare function __piNativesV0_14_2(): void
+export declare function __piNativesV0_15_0(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.

package/native/index.js

@@ -30,7 +30,7 @@ export const Shell = nativeBindings.Shell;
 
 // functions
 export const __piNativesPublishOutcomeV1 = nativeBindings.__piNativesPublishOutcomeV1;
-export const __piNativesV0_14_2 = nativeBindings.__piNativesV0_14_2;
+export const __piNativesV0_15_0 = nativeBindings.__piNativesV0_15_0;
 export const applyBashFixups = nativeBindings.applyBashFixups;
 export const applyOwnerOnlyFdSecurity = nativeBindings.applyOwnerOnlyFdSecurity;
 export const applyOwnerOnlyPathSecurity = nativeBindings.applyOwnerOnlyPathSecurity;

package/native/loader-state.d.ts

@@ -18,9 +18,16 @@ export interface DetectCompiledBinaryInput {
 
 export function detectCompiledBinary(input: DetectCompiledBinaryInput): boolean;
 
+export type Win32Avx2ProbeDiagnostic = "timeout" | "spawn_error" | "nonzero_exit" | "non_decisive_output";
+
 export function detectWin32Avx2Support(
 	probe?: () => boolean | undefined,
-	command?: (file: string, args: string[]) => string | null,
+	command?: (
+		file: string,
+		args: string[],
+		report?: (diagnostic: Win32Avx2ProbeDiagnostic) => void,
+	) => string | null,
+	report?: (diagnostic: Win32Avx2ProbeDiagnostic) => void,
 ): boolean;
 
 export interface GetAddonFilenamesInput {

package/native/loader-state.js

@@ -246,17 +246,46 @@ export function cachedEmbeddedExtractionIsFresh({ targetPath, embeddedPath, size
 // above pay nothing for variant detection, subprocess spawns, or fs probes.
 // =========================================================================
 
-function runCommand(command, args) {
+// Keep the synchronous fallback below Bun's default 5 s test budget. The
+// remaining margin covers spawnSync's return path after the kill is delivered
+// and prevents a wedged PowerShell process from starving native loading.
+const WIN32_AVX2_PROBE_TIMEOUT_MS = 4_000;
+const WIN32_AVX2_PROBE_MAX_BUFFER = 4 * 1024;
+const WIN32_AVX2_PROBE_WARNING_CODE = "GJC_WIN32_AVX2_PROBE";
+
+function emitWin32Avx2ProbeDiagnostic(kind) {
+	process.emitWarning(`Windows AVX2 probe inconclusive (${kind}); using baseline variant.`, {
+		code: WIN32_AVX2_PROBE_WARNING_CODE,
+	});
+}
+
+function spawnFailureDiagnostic(result) {
+	if (result.error?.code === "ETIMEDOUT" || result.signal === "SIGKILL") return "timeout";
+	if (result.error) return "spawn_error";
+	if (result.status !== 0) return "nonzero_exit";
+	return "non_decisive_output";
+}
+
+function runCommand(command, args, report) {
 	try {
 		// `windowsHide` keeps probes console-less: from a detached, console-less
 		// parent (e.g. the SDK broker) spawning a console app like powershell.exe
 		// would otherwise allocate and flash a visible console window per call
 		// (#4652). It is ignored on POSIX.
-		const result = childProcess.spawnSync(command, args, { encoding: "utf-8", windowsHide: true });
-		if (result.error) return null;
-		if (result.status !== 0) return null;
+		const result = childProcess.spawnSync(command, args, {
+			encoding: "utf-8",
+			windowsHide: true,
+			timeout: WIN32_AVX2_PROBE_TIMEOUT_MS,
+			killSignal: "SIGKILL",
+			maxBuffer: WIN32_AVX2_PROBE_MAX_BUFFER,
+		});
+		if (result.error || result.status !== 0) {
+			report?.(spawnFailureDiagnostic(result));
+			return null;
+		}
 		return (result.stdout || "").trim();
 	} catch {
+		report?.("spawn_error");
 		return null;
 	}
 }
@@ -287,21 +316,30 @@ function probeWin32Avx2InProcess() {
 // Hidden PowerShell fallback. `Add-Type` P/Invoke works on both stock Windows
 // PowerShell 5.1 (.NET Framework, which has no System.Runtime.Intrinsics) and
 // pwsh 7+. Any probe failure fails safe to `false` (baseline variant).
-function probeWin32Avx2ViaPowerShell(run = runCommand) {
+function probeWin32Avx2ViaPowerShell(run = runCommand, report = emitWin32Avx2ProbeDiagnostic) {
 	const output = run("powershell.exe", [
 		"-NoProfile",
 		"-NonInteractive",
 		"-Command",
 		"Add-Type -Namespace GjcNative -Name Cpu -MemberDefinition '[DllImport(\"kernel32.dll\")] public static extern bool IsProcessorFeaturePresent(int feature);'; " +
 			`[GjcNative.Cpu]::IsProcessorFeaturePresent(${WIN32_PF_AVX2_INSTRUCTIONS_AVAILABLE})`,
-	]);
-	return output !== null && output.toLowerCase() === "true";
+	], report);
+	if (output === null) return false;
+	const normalized = output.toLowerCase();
+	if (normalized === "true") return true;
+	if (normalized === "false") return false;
+	report("non_decisive_output");
+	return false;
 }
 
-export function detectWin32Avx2Support(probe = probeWin32Avx2InProcess, run = runCommand) {
+export function detectWin32Avx2Support(
+	probe = probeWin32Avx2InProcess,
+	run = runCommand,
+	report = emitWin32Avx2ProbeDiagnostic,
+) {
 	const probed = probe();
 	if (probed !== undefined) return probed;
-	return probeWin32Avx2ViaPowerShell(run);
+	return probeWin32Avx2ViaPowerShell(run, report);
 }
 
 function getVariantOverride() {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gajae-code/natives",
-	"version": "0.14.2",
+	"version": "0.15.0",
 	"description": "Native Rust bindings for grep, clipboard, image processing, syntax highlighting, PTY, and shell operations via N-API",
 	"type": "module",
 	"homepage": "https://gajae-code.com",
@@ -46,7 +46,7 @@
 		"@types/ws": "^8.5.13"
 	},
 	"engines": {
-		"bun": ">=1.3.14"
+		"bun": ">=1.4.0"
 	},
 	"napi": {
 		"binaryName": "pi_natives",
@@ -61,11 +61,11 @@
 		"README.md"
 	],
 	"optionalDependencies": {
-		"@gajae-code/natives-darwin-arm64": "0.14.2",
-		"@gajae-code/natives-darwin-x64": "0.14.2",
-		"@gajae-code/natives-linux-arm64": "0.14.2",
-		"@gajae-code/natives-linux-x64": "0.14.2",
-		"@gajae-code/natives-win32-x64": "0.14.2"
+		"@gajae-code/natives-darwin-arm64": "0.15.0",
+		"@gajae-code/natives-darwin-x64": "0.15.0",
+		"@gajae-code/natives-linux-arm64": "0.15.0",
+		"@gajae-code/natives-linux-x64": "0.15.0",
+		"@gajae-code/natives-win32-x64": "0.15.0"
 	},
 	"exports": {
 		".": {