@gajae-code/natives 0.12.1 → 0.12.2

package/native/index.d.ts

@@ -491,7 +491,7 @@ export declare function __piNativesPublishOutcomeV1(): void
  * `packages/natives/native/index.js` (which derives the name from
  * `package.json#version`).
  */
-export declare function __piNativesV0_12_1(): void
+export declare function __piNativesV0_12_2(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.
@@ -842,6 +842,16 @@ export declare function encodeSixel(bytes: Uint8Array, targetWidthPx: number, ta
  */
 export declare function exactRemoveDirectoryTree(path: string, snapshot: NativeDirectoryTreeSnapshot): NativeExactUnlinkResult
 
+/**
+ * Replace a staged regular file only after deleting the exact expected
+ *
+ * The expected destination identity must describe a regular file, not a
+ * directory or detach-only request.
+ * Publication uses a retained source handle and a no-replace rename, so a
+ * successor installed after deletion is preserved.
+ */
+export declare function exactReplacePath(sourcePath: string, destinationPath: string, expectedDestination: NativeExactFileIdentity): NativeExactUnlinkResult
+
 /**
  * Restore only the detached object that still has the supplied platform
  * identity. The detached and original paths must retain the same validated
@@ -1726,6 +1736,10 @@ export interface NativeExactFileIdentity {
 export interface NativeExactUnlinkResult {
   ok: boolean
   code?: string
+  /**
+   * On Windows this is returned in the caller's namespace; retained handle
+   * operations continue to use the volume-GUID canonical path internally.
+   */
   detachedPath?: string
   retainedSuccessorPath?: string
   /**

package/native/index.js

@@ -30,7 +30,7 @@ export const Shell = nativeBindings.Shell;
 
 // functions
 export const __piNativesPublishOutcomeV1 = nativeBindings.__piNativesPublishOutcomeV1;
-export const __piNativesV0_12_1 = nativeBindings.__piNativesV0_12_1;
+export const __piNativesV0_12_2 = nativeBindings.__piNativesV0_12_2;
 export const applyBashFixups = nativeBindings.applyBashFixups;
 export const applyOwnerOnlyFdSecurity = nativeBindings.applyOwnerOnlyFdSecurity;
 export const applyOwnerOnlyPathSecurity = nativeBindings.applyOwnerOnlyPathSecurity;
@@ -43,6 +43,7 @@ export const detectMacOSAppearance = nativeBindings.detectMacOSAppearance;
 export const diffLines = nativeBindings.diffLines;
 export const encodeSixel = nativeBindings.encodeSixel;
 export const exactRemoveDirectoryTree = nativeBindings.exactRemoveDirectoryTree;
+export const exactReplacePath = nativeBindings.exactReplacePath;
 export const exactRestore = nativeBindings.exactRestore;
 export const exactUnlink = nativeBindings.exactUnlink;
 export const executeShell = nativeBindings.executeShell;

package/native/loader-state.js

@@ -421,6 +421,9 @@ export function validateLoadedBindings(ctx, bindings, candidate) {
 	if (typeof bindings.probeWindowsJobMemory !== "function") {
 		throw new Error(`Loaded ${candidate} but it lacks required memory probe capability \`probeWindowsJobMemory\`.`);
 	}
+	if (typeof bindings.exactReplacePath !== "function") {
+		throw new Error(`Loaded ${candidate} but it lacks required exact replacement capability \`exactReplacePath\`.`);
+	}
 }
 
 function buildHelpMessage(ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gajae-code/natives",
-	"version": "0.12.1",
+	"version": "0.12.2",
 	"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",
@@ -61,11 +61,11 @@
 		"README.md"
 	],
 	"optionalDependencies": {
-		"@gajae-code/natives-darwin-arm64": "0.12.1",
-		"@gajae-code/natives-darwin-x64": "0.12.1",
-		"@gajae-code/natives-linux-arm64": "0.12.1",
-		"@gajae-code/natives-linux-x64": "0.12.1",
-		"@gajae-code/natives-win32-x64": "0.12.1"
+		"@gajae-code/natives-darwin-arm64": "0.12.2",
+		"@gajae-code/natives-darwin-x64": "0.12.2",
+		"@gajae-code/natives-linux-arm64": "0.12.2",
+		"@gajae-code/natives-linux-x64": "0.12.2",
+		"@gajae-code/natives-win32-x64": "0.12.2"
 	},
 	"exports": {
 		".": {