@gajae-code/natives 0.17.2 → 0.17.5

package/native/index.d.ts

@@ -442,6 +442,12 @@ export declare class RecoveryFsFile {
 export declare class RecoveryFsRoot {
   /** Return the stable identity of the retained root descriptor. */
   identity(): RecoveryFsResult
+  /**
+   * Return the latest bounded managed-recovery sweep metrics and lifetime
+   * removal counters. The per-root sweep remains throttled to once per
+   * minute.
+   */
+  recoveryReaperMetrics(): RecoveryFsReaperMetrics
   /**
    * Derive a retained child-directory capability from this root and exact
    * identity evidence.
@@ -583,7 +589,7 @@ export declare function __piNativesPublishOutcomeV1(): void
  * `packages/natives/native/index.js` (which derives the name from
  * `package.json#version`).
  */
-export declare function __piNativesV0_17_2(): void
+export declare function __piNativesV0_17_5(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.
@@ -1962,6 +1968,12 @@ export interface NativeExactFileIdentity {
    * hard links. Remaining links are retained after exact quarantine cleanup.
    */
   allowHardLink?: boolean
+  /**
+   * Require the authorized regular file to retain at least two hard links at
+   * every identity check. This is used by cleanup paths that remove only a
+   * surplus alias while preserving the live transcript link.
+   */
+  requireHardLink?: boolean
 }
 
 /** Typed result of an identity-bound regular-file deletion or directory detach. */
@@ -2251,6 +2263,8 @@ export interface PtyStartOptions {
   cwd?: string
   /** Environment variables for this command. */
   env?: Record<string, string>
+  /** Environment variable names to remove from the child process. */
+  unsetEnv?: Array<string>
   /** Timeout in milliseconds before cancelling. */
   timeoutMs?: number
   /** Abort signal for cancelling the operation. */
@@ -2320,6 +2334,24 @@ export interface RecoveryFsPublishSyncFailure {
   kind: string
 }
 
+/**
+ * Bounded managed-recovery reaper counters. Large counters are decimal strings
+ * so JavaScript callers do not lose precision above `Number.MAX_SAFE_INTEGER`.
+ */
+export interface RecoveryFsReaperMetrics {
+  ok: boolean
+  code?: string
+  scannedEntries: string
+  reapedFiles: string
+  reapedBytes: string
+  preservedEntries: string
+  failures: string
+  scanLimited: boolean
+  totalReapedFiles: string
+  totalReapedBytes: string
+  totalFailures: string
+}
+
 export interface RecoveryFsResult {
   ok: boolean
   code?: string
@@ -2516,6 +2548,8 @@ export interface ShellRunOptions {
   cwd?: string
   /** Environment variables to apply for this command only. */
   env?: Record<string, string>
+  /** Environment variable names to mask for this command only. */
+  unsetEnv?: Array<string>
   /** Timeout in milliseconds before cancelling the command. */
   timeoutMs?: number
   /** Abort signal for cancelling the operation. */

package/native/index.js

@@ -31,7 +31,7 @@ export const Shell = nativeBindings.Shell;
 
 // functions
 export const __piNativesPublishOutcomeV1 = nativeBindings.__piNativesPublishOutcomeV1;
-export const __piNativesV0_17_2 = nativeBindings.__piNativesV0_17_2;
+export const __piNativesV0_17_5 = nativeBindings.__piNativesV0_17_5;
 export const applyBashFixups = nativeBindings.applyBashFixups;
 export const applyOwnerOnlyFdSecurity = nativeBindings.applyOwnerOnlyFdSecurity;
 export const applyOwnerOnlyPathSecurity = nativeBindings.applyOwnerOnlyPathSecurity;

package/package.json

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