@oh-my-pi/pi-natives 18.15.0 → 18.16.0

package/native/index.d.ts

@@ -428,6 +428,24 @@ export declare class MacAppearanceObserver {
   stop(): void
 }
 
+/** The app the user had in front when `macOSFrontApp()` read it. */
+export declare class MacOSFrontApp {
+  /**
+   * Puts this app back in front, without raising its windows, each time the
+   * app that took the front from it takes it again during the next
+   * `durationMs`. Ends early once a hardware mouse button or ⌘/⌃ is used
+   * after the app was read, the app came from a launcher or Spotlight panel,
+   * or a different app comes forward: that is the user picking an app.
+   * Typing does not end it, and a hand-back macOS refuses for a key typed
+   * meanwhile is asked again. Holds nothing when called over a second after
+   * the latest read, as picks made since then went unwatched. Owns desktop
+   * input/focus control only for each hand-back, and rejects if another
+   * operation owns it then. Resolves how many times it put the app back.
+   */
+  keepInFront(durationMs: number): Promise<number>
+}
+export type MacosFrontApp = MacOSFrontApp
+
 /** A transactional, process-owned native OAuth callback receiver. */
 export declare class NativeOAuthCallback {
   /** Create a receiver without touching the filesystem or OS registration. */
@@ -2377,6 +2395,25 @@ export declare function hashlineStripPrefixes(lines: Array<string>): Array<strin
  */
 export declare function hasMatch(content: string | Uint8Array, pattern: string | Uint8Array, ignoreCase?: boolean | undefined | null, multiline?: boolean | undefined | null): boolean
 
+/**
+ * How `path` is held by this process: open through another descriptor and
+ * locked. `null` when it is not, and always outside Linux.
+ *
+ * Looks at the path's inode through the descriptors already open, without
+ * opening the file.
+ */
+export declare function heldFileKind(path: string): HeldFileKind | null
+
+/** What a file this process holds locked is. */
+export declare enum HeldFileKind {
+  /** A SQLite database this process has open with its locks. */
+  Database = 'database',
+  /** A SQLite WAL-index (`-shm`) file this process has open with its locks. */
+  WalIndex = 'wal-index',
+  /** Another file this process holds open with a record lock. */
+  Locked = 'locked'
+}
+
 /**
  * Highlight code and return ANSI-colored lines.
  *
@@ -2467,6 +2504,15 @@ export interface InlineSloppyRegion {
   payload: string
 }
 
+/**
+ * Moves this process's SQLite record locks onto open-file-description locks.
+ *
+ * No other close of the file can release those (see `ofd_locks.rs`). Call it
+ * before the process opens any SQLite database. Returns whether SQLite now
+ * uses them: `false` outside Linux, or when Bun's SQLite is not found.
+ */
+export declare function installSqliteLockShim(): boolean
+
 /** Options for `IpcConnection.connect`. */
 export interface IpcConnectOptions {
   /**
@@ -2739,6 +2785,12 @@ export declare function macOSAutocorrectWord(text: string, start: number, length
  */
 export declare function macOSCheckSpelling(text: string): Promise<Array<SpellingRange>>
 
+/**
+ * The app macOS `WindowServer` has in front. `null` off macOS and when the
+ * front-process SPI is unavailable.
+ */
+export declare function macOSFrontApp(): MacOSFrontApp | null
+
 /** Whether the host can use Apple's native spelling service. */
 export declare function macOSSpellCheckerAvailable(): boolean
 

package/native/index.js

@@ -36,6 +36,7 @@ export const IpcServer = nativeBindings.IpcServer;
 export const LineMatcher = nativeBindings.LineMatcher;
 export const LiveWebRtcPeer = nativeBindings.LiveWebRtcPeer;
 export const MacAppearanceObserver = nativeBindings.MacAppearanceObserver;
+export const MacOSFrontApp = nativeBindings.MacOSFrontApp;
 export const NativeOAuthCallback = nativeBindings.NativeOAuthCallback;
 export const PipeStreams = nativeBindings.PipeStreams;
 export const PowerAssertion = nativeBindings.PowerAssertion;
@@ -100,8 +101,10 @@ export const hashlineFormatNumberedLines = nativeBindings.hashlineFormatNumbered
 export const hashlineIsReadTruncationNotice = nativeBindings.hashlineIsReadTruncationNotice ?? missingNativeExport("hashlineIsReadTruncationNotice");
 export const hashlineStripPrefixes = nativeBindings.hashlineStripPrefixes ?? missingNativeExport("hashlineStripPrefixes");
 export const hasMatch = nativeBindings.hasMatch ?? missingNativeExport("hasMatch");
+export const heldFileKind = nativeBindings.heldFileKind ?? missingNativeExport("heldFileKind");
 export const highlightCode = nativeBindings.highlightCode ?? missingNativeExport("highlightCode");
 export const htmlToMarkdown = nativeBindings.htmlToMarkdown ?? missingNativeExport("htmlToMarkdown");
+export const installSqliteLockShim = nativeBindings.installSqliteLockShim ?? missingNativeExport("installSqliteLockShim");
 export const ipcEndpoint = nativeBindings.ipcEndpoint ?? missingNativeExport("ipcEndpoint");
 export const isoBackend = nativeBindings.isoBackend ?? missingNativeExport("isoBackend");
 export const isoDiff = nativeBindings.isoDiff ?? missingNativeExport("isoDiff");
@@ -113,6 +116,7 @@ export const isoStop = nativeBindings.isoStop ?? missingNativeExport("isoStop");
 export const listWorkspace = nativeBindings.listWorkspace ?? missingNativeExport("listWorkspace");
 export const macOSAutocorrectWord = nativeBindings.macOSAutocorrectWord ?? missingNativeExport("macOSAutocorrectWord");
 export const macOSCheckSpelling = nativeBindings.macOSCheckSpelling ?? missingNativeExport("macOSCheckSpelling");
+export const macOSFrontApp = nativeBindings.macOSFrontApp ?? missingNativeExport("macOSFrontApp");
 export const macOSSpellCheckerAvailable = nativeBindings.macOSSpellCheckerAvailable ?? missingNativeExport("macOSSpellCheckerAvailable");
 export const macOSSpellingGuesses = nativeBindings.macOSSpellingGuesses ?? missingNativeExport("macOSSpellingGuesses");
 export const matchesKey = nativeBindings.matchesKey ?? missingNativeExport("matchesKey");
@@ -198,6 +202,11 @@ export const GrepOutputMode = {
 	Count: "count",
 	FilesWithMatches: "filesWithMatches",
 };
+export const HeldFileKind = {
+	Database: "database",
+	WalIndex: "wal-index",
+	Locked: "locked",
+};
 export const IsoBackendKind = {
 	Apfs: 0,
 	Btrfs: 1,

package/native/sqlite-locks.d.ts

@@ -0,0 +1,12 @@
+import type { HeldFileKind } from "./index.js";
+
+/**
+ * Lazily loading forms of the SQLite lock exports in `index.d.ts`: the addon
+ * loads on the first call instead of at import.
+ */
+
+/** Moves this process's SQLite record locks onto open-file-description locks; `false` when unavailable. */
+export declare function installSqliteLockShim(): boolean;
+
+/** How `path` is held by this process (open elsewhere and locked), or `null`. */
+export declare function heldFileKind(path: string): HeldFileKind | null;

package/native/sqlite-locks.js

@@ -0,0 +1,26 @@
+import { loadNative } from "./loader-state.js";
+
+let bindings;
+
+/**
+ * Load the addon on first use, so importing this module (pi-utils' SQLite
+ * helpers) costs nothing in processes that never open a database. An addon
+ * built before these exports existed (a stale local build, or PR CI, which
+ * tests against main's newest addon) yields `undefined`: the store still opens,
+ * unprotected, and `ensureSqliteLockShim` reports it.
+ */
+function native(symbolName) {
+	bindings ??= loadNative();
+	const value = bindings[symbolName];
+	return typeof value === "function" ? value : undefined;
+}
+
+/** See `installSqliteLockShim` in `index.d.ts`; `false` from an addon predating it. */
+export function installSqliteLockShim() {
+	return native("installSqliteLockShim")?.() ?? false;
+}
+
+/** See `heldFileKind` in `index.d.ts`; `null` from an addon predating it. */
+export function heldFileKind(path) {
+	return native("heldFileKind")?.(path) ?? null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-natives",
-	"version": "18.15.0",
+	"version": "18.16.0",
 	"description": "Native Rust bindings for PDF conversion, audio, WebRTC, grep, clipboard, image processing, syntax highlighting, PTY, and shell operations via N-API",
 	"type": "module",
 	"homepage": "https://omp.sh",
@@ -78,6 +78,8 @@
 		"native/loader-state.d.ts",
 		"native/path.js",
 		"native/path.d.ts",
+		"native/sqlite-locks.js",
+		"native/sqlite-locks.d.ts",
 		"native/vcs.js",
 		"native/vcs.d.ts",
 		"native/embedded-addon.js",
@@ -111,14 +113,19 @@
 			"types": "./native/vcs.d.ts",
 			"import": "./native/vcs.js",
 			"default": "./native/vcs.js"
+		},
+		"./sqlite-locks": {
+			"types": "./native/sqlite-locks.d.ts",
+			"import": "./native/sqlite-locks.js",
+			"default": "./native/sqlite-locks.js"
 		}
 	},
 	"optionalDependencies": {
-		"@oh-my-pi/pi-natives-linux-x64": "18.15.0",
-		"@oh-my-pi/pi-natives-linux-arm64": "18.15.0",
-		"@oh-my-pi/pi-natives-darwin-x64": "18.15.0",
-		"@oh-my-pi/pi-natives-darwin-arm64": "18.15.0",
-		"@oh-my-pi/pi-natives-win32-x64": "18.15.0",
-		"@oh-my-pi/pi-natives-win32-arm64": "18.15.0"
+		"@oh-my-pi/pi-natives-linux-x64": "18.16.0",
+		"@oh-my-pi/pi-natives-linux-arm64": "18.16.0",
+		"@oh-my-pi/pi-natives-darwin-x64": "18.16.0",
+		"@oh-my-pi/pi-natives-darwin-arm64": "18.16.0",
+		"@oh-my-pi/pi-natives-win32-x64": "18.16.0",
+		"@oh-my-pi/pi-natives-win32-arm64": "18.16.0"
 	}
 }