@gajae-code/natives 0.12.7 → 0.12.8

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_7(): void
+export declare function __piNativesV0_12_8(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.
@@ -835,13 +835,25 @@ export declare enum Ellipsis {
 export declare function encodeSixel(bytes: Uint8Array, targetWidthPx: number, targetHeightPx: number): string
 
 /**
- * Remove an already durably planned detached directory only when a fresh
- * descriptor-relative snapshot exactly equals the persisted snapshot. The
- * caller-planned root remains in place while its opened descriptor is
- * authoritative throughout recursive removal.
+ * Remove a directory tree only when a fresh descriptor-relative snapshot
+ * exactly equals the persisted snapshot. POSIX first no-replace detaches the
+ * verified root to its deterministic `.removing` sibling; the reopened
+ * detached descriptor remains authoritative throughout payload scrubbing and
+ * replay.
  */
 export declare function exactRemoveDirectoryTree(path: string, snapshot: NativeDirectoryTreeSnapshot, parentIdentity?: NativeDirectoryParentIdentity | undefined | null): NativeExactUnlinkResult
 
+/**
+ * Replace a staged regular file only after validating the exact staged source
+ * and deleting the exact expected destination.
+ *
+ * Both identities must describe regular files, not directories or detach-only
+ * requests. Publication uses the retained verified source handle and a
+ * no-replace rename, so source substitution is rejected and a destination
+ * successor is preserved.
+ */
+export declare function exactReplacePath(sourcePath: string, destinationPath: string, expectedSource: NativeExactFileIdentity, 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
@@ -1735,6 +1747,15 @@ export interface NativeExactFileIdentity {
 export interface NativeExactUnlinkResult {
   ok: boolean
   code?: string
+  /**
+   * True only when retained directory payloads were descriptor-scrubbed and
+   * every file plus containing directory namespace was fsynced before return.
+   */
+  payloadDurable?: boolean
+  /**
+   * 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
   /**
@@ -1988,6 +2009,7 @@ export declare function readImageFromClipboard(): Promise<ClipboardImage | undef
 export interface RecoveryFsIdentity {
   dev: string
   ino: string
+  nlink: string
   size: string
   mtimeNs: string
   ctimeNs: string

package/native/index.js

@@ -30,7 +30,7 @@ export const Shell = nativeBindings.Shell;
 
 // functions
 export const __piNativesPublishOutcomeV1 = nativeBindings.__piNativesPublishOutcomeV1;
-export const __piNativesV0_12_7 = nativeBindings.__piNativesV0_12_7;
+export const __piNativesV0_12_8 = nativeBindings.__piNativesV0_12_8;
 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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gajae-code/natives",
-	"version": "0.12.7",
+	"version": "0.12.8",
 	"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.7",
-		"@gajae-code/natives-darwin-x64": "0.12.7",
-		"@gajae-code/natives-linux-arm64": "0.12.7",
-		"@gajae-code/natives-linux-x64": "0.12.7",
-		"@gajae-code/natives-win32-x64": "0.12.7"
+		"@gajae-code/natives-darwin-arm64": "0.12.8",
+		"@gajae-code/natives-darwin-x64": "0.12.8",
+		"@gajae-code/natives-linux-arm64": "0.12.8",
+		"@gajae-code/natives-linux-x64": "0.12.8",
+		"@gajae-code/natives-win32-x64": "0.12.8"
 	},
 	"exports": {
 		".": {