@gajae-code/natives 0.18.12 → 0.19.0

package/native/diagnostic-artifact.json

@@ -1,12 +1,12 @@
 {
   "schema": "gjc.diagnostic-artifact",
-  "version": "0.18.12",
+  "version": "0.19.0",
   "artifacts": {
-    "pi_natives.darwin-arm64.node": "afc623540979280ece88b16c57c5a5941407a98bc0344f6fd851537d886dcfee",
-    "pi_natives.darwin-x64-baseline.node": "a1aee260794c49ed6ce8590f23ac89e899e20d93dae95900bb0b1503ff4ea159",
-    "pi_natives.linux-arm64.node": "2d695e63e7d1f89eff9a0809bb2f417cb65c91ae75161e5fd58a405d29689322",
-    "pi_natives.linux-x64-baseline.node": "7cada23a1841fe89670a80853ca8c35905f80783d8bb19a284a3f45821d9e56e",
-    "pi_natives.linux-x64-modern.node": "75e7f945bf27526f1d833f6c80490d9600fabc6700de70e5eb83eea6ef8cd8ea",
-    "pi_natives.win32-x64-baseline.node": "a88258561c1027a3d6e8477de335f903182f300091700cd3d6cfd96abc53ce95"
+    "pi_natives.darwin-arm64.node": "bcb20db50a480de66eed5448d63d530ce708ab84d77ab1cb1620132772690af5",
+    "pi_natives.darwin-x64-baseline.node": "3de5a046531495e0a0afdff4d6f0bcd4c8639fcd30fd6cff8ea9ec2efd43b63f",
+    "pi_natives.linux-arm64.node": "3eb72a1956e59f3134d45690c61c79a24e0eddcb9627b238deb32540ec0433ce",
+    "pi_natives.linux-x64-baseline.node": "d6282ea56f7c47bf659fbb1aef7f8df3fb798c9b828abc5dc3b6cf4334f3c651",
+    "pi_natives.linux-x64-modern.node": "8d1fd3d3bc98cc479c75cea158b6059dbed4dbd7a614a6a8c9ad60a12b7a4dae",
+    "pi_natives.win32-x64-baseline.node": "7d9ed748b9b6eb6e14a2c87afccbe1590498512f2830fb1e813aa3529b715bb2"
   }
 }

package/native/index.d.ts

@@ -687,7 +687,7 @@ export declare function __piNativesPublishOutcomeV1(): void
  * `packages/natives/native/index.js` (which derives the name from
  * `package.json#version`).
  */
-export declare function __piNativesV0_18_12(): void
+export declare function __piNativesV0_19_0(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.
@@ -795,6 +795,59 @@ export interface AstFindResult {
  */
 export declare function astGrep(options: AstFindOptions): Promise<AstFindResult>
 
+/**
+ * Match ast-grep patterns against an in-memory source string; returns a
+ * promise resolved on a worker thread.
+ *
+ * This is the file-free counterpart to [`ast_grep`]: callers that already hold
+ * the source (streaming buffers, generated code, editor contents) avoid a
+ * temp-file round trip. `lang` is required since there is no path to infer it
+ * from.
+ */
+export declare function astMatch(options: AstMatchOptions): Promise<AstMatchResult>
+
+/**
+ * Options for `astMatch`: run ast-grep patterns against an in-memory source
+ * string instead of files on disk.
+ */
+export interface AstMatchOptions {
+  /** Source code to match against (parsed in memory, never read from disk). */
+  source: string
+  /**
+   * Language of `source` (required): an alias ("ts", "rust", "python") or a
+   * file extension ("scss"), resolved like a path's extension.
+   */
+  lang: string
+  /** ast-grep patterns to search for (OR across patterns). */
+  patterns: Array<string>
+  /** Rule selector for multi-rule ast-grep configurations. */
+  selector?: string
+  /** Pattern strictness; defaults to smart matching when omitted. */
+  strictness?: AstMatchStrictness
+  /** Maximum matches to return after `offset` (default applies when omitted). */
+  limit?: number
+  /** Number of leading matches to skip before applying `limit`. */
+  offset?: number
+  /** When true, include meta-variable bindings per match. */
+  includeMeta?: boolean
+  /** Optional cancellation handle (library-specific). */
+  signal?: unknown
+  /** Wall-clock timeout for the worker task in milliseconds. */
+  timeoutMs?: number
+}
+
+/** Result of an in-memory `astMatch` run. */
+export interface AstMatchResult {
+  /** Page of matches after sort, offset, and limit. */
+  matches: Array<AstFindMatch>
+  /** Total matches found before paging (can exceed `matches.length`). */
+  totalMatches: number
+  /** True when results were truncated by `limit`. */
+  limitReached: boolean
+  /** Non-fatal parse or pattern-compile errors collected during the run. */
+  parseErrors?: Array<string>
+}
+
 /** ast-grep pattern strictness (controls how patterns match syntax). */
 export declare enum AstMatchStrictness {
   /** Match at the concrete syntax tree level. */
@@ -1189,10 +1242,11 @@ export declare function encodeSixel(bytes: Uint8Array, targetWidthPx: number, ta
 
 /**
  * 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.
+ * exactly equals the persisted snapshot. POSIX removal no-replace detaches the
+ * verified root to its deterministic `.removing` sibling before scrubbing. On
+ * Windows, callers that need retirement semantics must request a detach-only
+ * pass, then replay exact removal at the returned sibling; ordinary Windows
+ * removal never vacates the caller's path before scrubbing completes.
  */
 export declare function exactRemoveDirectoryTree(path: string, snapshot: NativeDirectoryTreeSnapshot, parentIdentity?: NativeDirectoryParentIdentity | undefined | null, detachOnly?: boolean | undefined | null): NativeExactUnlinkResult
 
@@ -1295,6 +1349,17 @@ export declare function exactUnlinkDirect(path: string, identity: NativeExactFil
  */
 export declare function exactUnlinkDirectDetached(path: string, identity: NativeExactFileIdentity): boolean
 
+/**
+ * Delete only the empty regular file opened by the caller's retained
+ * descriptor.
+ *
+ * This is used when a newly created staging file cannot be statted through the
+ * host API. Native code derives identity from the open descriptor and verifies
+ * the public entry still names that object before using the platform's exact
+ * unlink protocol.
+ */
+export declare function exactUnlinkOpenFile(path: string, callerFd: number, quarantineName: string): NativeExactUnlinkResult
+
 /**
  * Execute a brush shell command.
  *
@@ -2106,7 +2171,7 @@ export type NativeCanonicalDirectoryIdentity =
 			ok: false;
 			platform?: never;
 			canonicalPath?: never;
-			code: "not_found" | "not_directory" | "not_utf8" | "network_unsupported" | "identity_unavailable" | "io_error";
+			code: "access_denied" | "not_found" | "not_directory" | "not_utf8" | "network_unsupported" | "identity_unavailable" | "io_error";
 	  }
 
 /** Bytes copied out of one read-only broker publication observation. */
@@ -2322,6 +2387,7 @@ export type NativeOwnerOnlySecurityResult =
 	| {
 			ok: false;
 			code:
+				| "access_denied"
 				| "not_found"
 				| "not_directory"
 				| "network_unsupported"

package/native/index.js

@@ -35,12 +35,13 @@ export const TtyWriter = nativeBindings.TtyWriter;
 // functions
 export const __gjcInstallTokioRuntime = nativeBindings.__gjcInstallTokioRuntime;
 export const __piNativesPublishOutcomeV1 = nativeBindings.__piNativesPublishOutcomeV1;
-export const __piNativesV0_18_12 = nativeBindings.__piNativesV0_18_12;
+export const __piNativesV0_19_0 = nativeBindings.__piNativesV0_19_0;
 export const applyBashFixups = nativeBindings.applyBashFixups;
 export const applyOwnerOnlyFdSecurity = nativeBindings.applyOwnerOnlyFdSecurity;
 export const applyOwnerOnlyPathSecurity = nativeBindings.applyOwnerOnlyPathSecurity;
 export const astEdit = nativeBindings.astEdit;
 export const astGrep = nativeBindings.astGrep;
+export const astMatch = nativeBindings.astMatch;
 export const canonicalExistingDirectoryIdentity = nativeBindings.canonicalExistingDirectoryIdentity;
 export const computerScreenshot = nativeBindings.computerScreenshot;
 export const copyToClipboard = nativeBindings.copyToClipboard;
@@ -64,6 +65,7 @@ export const exactSwapManagedLink = nativeBindings.exactSwapManagedLink;
 export const exactUnlink = nativeBindings.exactUnlink;
 export const exactUnlinkDirect = nativeBindings.exactUnlinkDirect;
 export const exactUnlinkDirectDetached = nativeBindings.exactUnlinkDirectDetached;
+export const exactUnlinkOpenFile = nativeBindings.exactUnlinkOpenFile;
 export const executeShell = nativeBindings.executeShell;
 export const extractSegments = nativeBindings.extractSegments;
 export const fuzzyFind = nativeBindings.fuzzyFind;

package/package.json

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