@bastani/atomic-natives 0.9.19 → 0.9.20-alpha.10

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [0.9.20-alpha.4] - 2026-09-20
+
+### Fixed
+
+- Supervised commands no longer fail when retained output files collide after process IDs are reused; other output-file creation failures now include the operating-system error ([#3105](https://github.com/bastani-inc/atomic/issues/3105)).
+- Command output files use timestamped random names and bounded collision retries, preventing retained files from indefinitely delaying startup without overwriting existing output.
+- Corrected the binding-target diagnostic type to allow an absent marker when a native override or exports hook returns a non-extensible binding.
+
 ## [0.9.19] - 2026-09-13
 
 Cumulative release of the `0.9.19-alpha.2` through `0.9.19-alpha.4` prereleases. Per-change details remain in the unchanged prerelease sections below.

package/README.md

@@ -4,4 +4,4 @@ Native Rust bindings for Atomic via N-API.
 
 Rust code lives in `crates/atomic-natives`, while this package contains the generated NAPI-RS JavaScript loader (`native/index.js`), generated TypeScript declarations (`native/index.d.ts`), and release-time optional platform packages.
 
-Native surfaces include a Rust-backed PTY session used by the `bash` tool when `pty: true` is requested and oh-my-pi-derived `glob`/`grep`/`search` bindings used by Atomic's built-in `find` and `search` tools for full-level parity.
+The bindings provide a Rust-backed PTY session for `bash` calls with `pty: true`, plus native `glob`, `grep`, and `search` operations for Atomic's built-in `find` and `search` tools.

package/native/index.d.ts

@@ -1,12 +1,17 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
-export declare class HostSession {
 
-}
+/**
+ * Which binding artifact the generated loader actually loaded: `'native'` for
+ * a native addon, otherwise the `platformArchABI` of the WASI flavor. Every
+ * flavor napi-rs can build is listed, because `NAPI_RS_NATIVE_LIBRARY_PATH`
+ * can point the loader at a WASI artifact this package does not build itself.
+ */
+export declare const __napiBindingTarget: 'native' | 'wasm32-wasi' | 'wasm32-wasip1' | undefined
 
-export declare class OwnerLease {
+export declare class HostSession {}
 
-}
+export declare class OwnerLease {}
 
 export declare class PtySession {
   constructor()
@@ -31,13 +36,16 @@ export declare class RetainedPostgres {
   release(): void
 }
 
-export declare class RunnerLease {
-
+/** Available only on Windows. */
+export declare class WindowsPostgresProcessGuard {
+  get status(): 'live' | 'absent' | 'mismatch'
+  exited(): boolean
+  close(): void
 }
 
-export declare class StdinLease {
+export declare class RunnerLease {}
 
-}
+export declare class StdinLease {}
 
 /**
  * N-API wrapper around the root-scoped Rust control plane. The host marker is
@@ -61,69 +69,65 @@ export declare class SubagentControl {
 }
 export type NapiSubagentControl = SubagentControl
 
-export declare class SubscriptionLease {
-
-}
-
-export declare class TaskLease {
+export declare class SubscriptionLease {}
 
-}
+export declare class TaskLease {}
 
 /** A single serialized native actor is shared by all instances in this environment. */
 export declare class TaskSupervisor {
   constructor()
   /** Trusted-host seam only. Host authorization must run before admission. */
   bindHostSession(scope: OwnerScope): HostSession
-openTaskOwner(host: HostSession, scope: OwnerScope): {ok:true,value:OwnerLease}|{ok:false,error:TaskFailure}
-startAgentTask(owner: OwnerLease, intent: AgentIntent, operation: string): {ok:true,value:TaskLease}|{ok:false,error:TaskFailure}
-/** Admits one owned command; waiting for this setup never imposes an execution deadline. */
-startCommandTask(owner: OwnerLease, intent: CommandIntent, operation: string, options?: CommandResourceOptions | undefined | null): Promise<{ok:true,value:TaskLease}|{ok:false,error:TaskFailure}>
-resizeTaskTerminal(task: TaskLease, columns: number, rows: number): {ok:true,value:undefined}|{ok:false,error:TaskFailure}
-taskStdin(task: TaskLease): {ok:true,value:StdinLease}|{ok:false,error:TaskFailure}
-writeTaskInput(input: StdinLease, operation: string, data: InputData): Promise<{ok:true,value:InputReceipt}|{ok:false,error:TaskFailure}>
-readTaskOutput(task: TaskLease, range: OutputRange): Promise<{ok:true,value:OutputPage}|{ok:false,error:TaskFailure}>
-/** Claim once after host dispatch setup; operation replay never grants a second runner. */
-claimTaskRunner(task: TaskLease): {ok:true,value:RunnerLease}|{ok:false,error:TaskFailure}
-taskReference(task: TaskLease): {ok:true,value:NativeTaskRef}|{ok:false,error:TaskFailure}
-/** Read the retained terminal receipt without registering an observation or replaying execution. */
-taskSettlement(task: TaskLease): {ok:true,value:SettlementReceipt}|{ok:false,error:TaskFailure}
-lookupTask(owner: OwnerLease, taskId: string): {ok:true,value:TaskLease}|{ok:false,error:TaskFailure}
-/**
- * Registers the observation before returning. Await observeTaskWait separately.
- * Accepts the host-resolved numeric budget without u32 narrowing; omission arms no timer.
- */
-waitForTask(task: TaskLease, budgetMs?: number | undefined | null, designation?: HostSession | undefined | null): {ok:true,value:WaitLease}|{ok:false,error:TaskFailure}
-foregroundTask(task: TaskLease, host: HostSession, budgetMs?: number | undefined | null): {ok:true,value:WaitLease}|{ok:false,error:TaskFailure}
-observeTaskWait(wait: WaitLease): Promise<{ok:true,value:WaitOutcome}|{ok:false,error:TaskFailure}>
-yieldTaskWait(wait: WaitLease, reason: YieldReason): {ok:true,value:WaitOutcome}|{ok:false,error:TaskFailure}
-disposeTaskWait(wait: WaitLease): {ok:true,value:undefined}|{ok:false,error:TaskFailure}
-cancelTask(task: TaskLease, cause: CancelCause): {ok:true,value:CancelReceipt}|{ok:false,error:TaskFailure}
-/** Seals synchronously, then awaits independent runner cleanup acknowledgements. */
-closeTaskOwner(owner: OwnerLease, cause: OwnerCloseCause): Promise<{ok:true,value:OwnerCloseReceipt}|{ok:false,error:TaskFailure}>
-/**
- * Retains the latest 256 accepted activity IDs with SHA-256 hashes and receipts per task.
- * Identical replay is duplicate; conflicts emit no events and neither refreshes retention.
- * Evicted IDs are fresh reports subject to terminal/owner guards. Terminal receipts never expire
- * while the task record exists; this is not a total task-history byte cap or persistence layer.
- */
-reportTaskActivity(runner: RunnerLease, report: ActivityReport): {ok:true,value:ReportReceipt}|{ok:false,error:TaskFailure}
-reportTaskOutcome(runner: RunnerLease, report: OutcomeReport): {ok:true,value:SettlementReceipt}|{ok:false,error:TaskFailure}
-/**
- * Private trusted-runner support, not a model/facade domain door.
- * Allocates an unused terminal report ID atomically within the bounded activity window.
- * Caller report IDs are never reserved or rewritten. Replay retains the terminal receipt;
- * conflicting results and cancellation still use the report_task_outcome acceptance rules.
- */
-reportRunnerOutcome(runner: RunnerLease, result: TaskResult): {ok:true,value:SettlementReceipt}|{ok:false,error:TaskFailure}
-/** Private trusted-runner support, not a model/facade domain door. Outcome is not cleanup. */
-acknowledgeTaskCleanup(runner: RunnerLease, cleanup: Cleanup): {ok:true,value:Cleanup}|{ok:false,error:TaskFailure}
-/**
- * The callback wakes a drain. The host must also keep one bounded reconciliation poll
- * until disposal/owner closure: an oversized evicted event has no authentic wake payload.
- */
-watchOwnerTasks(owner: OwnerLease, callback: (event: NativeEvent) => void, cursor?: Cursor | undefined | null): {ok:true,value:NativeTaskSubscription}|{ok:false,error:TaskFailure}
-drainOwnerTasks(lease: SubscriptionLease): {ok:true,value:SubscriptionDrain}|{ok:false,error:TaskFailure}
-disposeSubscription(lease: SubscriptionLease): void
+  openTaskOwner(host: HostSession, scope: OwnerScope): {ok:true,value:OwnerLease}|{ok:false,error:TaskFailure}
+  startAgentTask(owner: OwnerLease, intent: AgentIntent, operation: string): {ok:true,value:TaskLease}|{ok:false,error:TaskFailure}
+  /** Admits one owned command; waiting for this setup never imposes an execution deadline. */
+  startCommandTask(owner: OwnerLease, intent: CommandIntent, operation: string, options?: CommandResourceOptions | undefined | null): Promise<{ok:true,value:TaskLease}|{ok:false,error:TaskFailure}>
+  resizeTaskTerminal(task: TaskLease, columns: number, rows: number): {ok:true,value:undefined}|{ok:false,error:TaskFailure}
+  taskStdin(task: TaskLease): {ok:true,value:StdinLease}|{ok:false,error:TaskFailure}
+  writeTaskInput(input: StdinLease, operation: string, data: InputData): Promise<{ok:true,value:InputReceipt}|{ok:false,error:TaskFailure}>
+  readTaskOutput(task: TaskLease, range: OutputRange): Promise<{ok:true,value:OutputPage}|{ok:false,error:TaskFailure}>
+  /** Claim once after host dispatch setup; operation replay never grants a second runner. */
+  claimTaskRunner(task: TaskLease): {ok:true,value:RunnerLease}|{ok:false,error:TaskFailure}
+  taskReference(task: TaskLease): {ok:true,value:NativeTaskRef}|{ok:false,error:TaskFailure}
+  /** Read the retained terminal receipt without registering an observation or replaying execution. */
+  taskSettlement(task: TaskLease): {ok:true,value:SettlementReceipt}|{ok:false,error:TaskFailure}
+  lookupTask(owner: OwnerLease, taskId: string): {ok:true,value:TaskLease}|{ok:false,error:TaskFailure}
+  /**
+   * Registers the observation before returning. Await observeTaskWait separately.
+   * Accepts the host-resolved numeric budget without u32 narrowing; omission arms no timer.
+   */
+  waitForTask(task: TaskLease, budgetMs?: number | undefined | null, designation?: HostSession | undefined | null): {ok:true,value:WaitLease}|{ok:false,error:TaskFailure}
+  foregroundTask(task: TaskLease, host: HostSession, budgetMs?: number | undefined | null): {ok:true,value:WaitLease}|{ok:false,error:TaskFailure}
+  observeTaskWait(wait: WaitLease): Promise<{ok:true,value:WaitOutcome}|{ok:false,error:TaskFailure}>
+  yieldTaskWait(wait: WaitLease, reason: YieldReason): {ok:true,value:WaitOutcome}|{ok:false,error:TaskFailure}
+  disposeTaskWait(wait: WaitLease): {ok:true,value:undefined}|{ok:false,error:TaskFailure}
+  cancelTask(task: TaskLease, cause: CancelCause): {ok:true,value:CancelReceipt}|{ok:false,error:TaskFailure}
+  /** Seals synchronously, then awaits independent runner cleanup acknowledgements. */
+  closeTaskOwner(owner: OwnerLease, cause: OwnerCloseCause): Promise<{ok:true,value:OwnerCloseReceipt}|{ok:false,error:TaskFailure}>
+  /**
+   * Retains the latest 256 accepted activity IDs with SHA-256 hashes and receipts per task.
+   * Identical replay is duplicate; conflicts emit no events and neither refreshes retention.
+   * Evicted IDs are fresh reports subject to terminal/owner guards. Terminal receipts never expire
+   * while the task record exists; this is not a total task-history byte cap or persistence layer.
+   */
+  reportTaskActivity(runner: RunnerLease, report: ActivityReport): {ok:true,value:ReportReceipt}|{ok:false,error:TaskFailure}
+  reportTaskOutcome(runner: RunnerLease, report: OutcomeReport): {ok:true,value:SettlementReceipt}|{ok:false,error:TaskFailure}
+  /**
+   * Private trusted-runner support, not a model/facade domain door.
+   * Allocates an unused terminal report ID atomically within the bounded activity window.
+   * Caller report IDs are never reserved or rewritten. Replay retains the terminal receipt;
+   * conflicting results and cancellation still use the report_task_outcome acceptance rules.
+   */
+  reportRunnerOutcome(runner: RunnerLease, result: TaskResult): {ok:true,value:SettlementReceipt}|{ok:false,error:TaskFailure}
+  /** Private trusted-runner support, not a model/facade domain door. Outcome is not cleanup. */
+  acknowledgeTaskCleanup(runner: RunnerLease, cleanup: Cleanup): {ok:true,value:Cleanup}|{ok:false,error:TaskFailure}
+  /**
+   * The callback wakes a drain. The host must also keep one bounded reconciliation poll
+   * until disposal/owner closure: an oversized evicted event has no authentic wake payload.
+   */
+  watchOwnerTasks(owner: OwnerLease, callback: (event: NativeEvent) => void, cursor?: Cursor | undefined | null): {ok:true,value:NativeTaskSubscription}|{ok:false,error:TaskFailure}
+  drainOwnerTasks(lease: SubscriptionLease): {ok:true,value:SubscriptionDrain}|{ok:false,error:TaskFailure}
+  disposeSubscription(lease: SubscriptionLease): void
 }
 export type NapiTaskSupervisor = TaskSupervisor
 
@@ -132,24 +136,19 @@ export declare class WaitLease {
 }
 
 export type ActivityChange =
-  | { kind: 'action', tool: string, text: string }
-  | { kind: 'model', model?: string, thinking?: string }
-  | { kind: 'metrics', elapsedMs?: number, toolCount?: number, tokenCount?: number }
-  | { kind: 'output', offset: string, bytesBase64: string }
-  | { kind: 'attention-set', attention: Attention }
-  | { kind: 'attention-clear', requestId: string }
+  | { kind: 'action'; tool: string; text: string }
+  | { kind: 'model'; model?: string; thinking?: string }
+  | { kind: 'metrics'; elapsedMs?: number; toolCount?: number; tokenCount?: number }
+  | { kind: 'output'; offset: string; bytesBase64: string }
+  | { kind: 'attention-set'; attention: Attention }
+  | { kind: 'attention-clear'; requestId: string }
 
 export interface ActivityReport {
   reportId: string
   change: ActivityChange
 }
 
-export type AdmissionRefusalKind =  'depthExceeded'|
-'capacityExhausted'|
-'dispatchGuardBusy'|
-'invalidCwd'|
-'unknownAgent'|
-'terminalChild';
+export type AdmissionRefusalKind = 'depthExceeded' | 'capacityExhausted' | 'dispatchGuardBusy' | 'invalidCwd' | 'unknownAgent' | 'terminalChild'
 
 /** Caller-provided strings retain their exact JavaScript UTF-16 code units. */
 export interface AgentIntent {
@@ -162,19 +161,14 @@ export interface AgentIntent {
 }
 
 /** The only statuses emitted by a child status watch. */
-export type AgentStatus =  'pending'|
-'running'|
-'ok'|
-'error'|
-'interrupted'|
-'continued';
+export type AgentStatus = 'pending' | 'running' | 'ok' | 'error' | 'interrupted' | 'continued'
 
-export type AgentTaskKind =  'agent';
+export type AgentTaskKind = 'agent'
 
 export type Attention =
   | { kind: 'none' }
-  | { kind: 'input-needed', requestId: string, prompt: string, route: PromptRoute }
-  | { kind: 'no-recent-activity', lastActivityAt?: string }
+  | { kind: 'input-needed'; requestId: string; prompt: string; route: PromptRoute }
+  | { kind: 'no-recent-activity'; lastActivityAt?: string }
 
 export interface BlockRange {
   /** 1-indexed inclusive first line of the resolved block. */
@@ -199,12 +193,7 @@ export interface BlockRangeOptions {
   line: number
 }
 
-export type CancelCause =  'user'|
-'owner-close'|
-'execution-timeout'|
-'output-limit'|
-'parent-handoff'|
-'shutdown';
+export type CancelCause = 'user' | 'owner-close' | 'execution-timeout' | 'output-limit' | 'parent-handoff' | 'shutdown'
 
 export interface CancelReceipt {
   taskId: string
@@ -228,7 +217,7 @@ export type Cleanup =
   | { kind: 'active' }
   | { kind: 'draining' }
   | { kind: 'reaped' }
-  | { kind: 'failed', resources: Array<ResourceFailure> }
+  | { kind: 'failed'; resources: Array<ResourceFailure> }
 
 export interface CommandIntent {
   kind: CommandTaskKind
@@ -244,8 +233,7 @@ export interface CommandIntent {
   parentTaskId?: string
 }
 
-export type CommandOutputSink =  'file-spool'|
-'drained';
+export type CommandOutputSink = 'file-spool' | 'drained'
 
 /** Trusted native adapter configuration, never model input or CommandIntent fields. */
 export interface CommandResourceOptions {
@@ -262,11 +250,11 @@ export interface CommandShell {
   args: string[]
 }
 
-export type CommandTaskKind =  'command';
+export type CommandTaskKind = 'command'
 
 export type CommandTerminal =
   | { kind: 'pipe' }
-  | { kind: 'pty', columns: number, rows: number }
+  | { kind: 'pty'; columns: number; rows: number }
 
 /** A context line (before or after a match). */
 export interface ContextLine {
@@ -289,8 +277,8 @@ export interface Cursor {
 export type Execution =
   | { kind: 'queued' }
   | { kind: 'running' }
-  | { kind: 'cancelling', cause: CancelCause }
-  | { kind: 'settled', result: TaskResult }
+  | { kind: 'cancelling'; cause: CancelCause }
+  | { kind: 'settled'; result: TaskResult }
 
 /** Resolved filesystem entry kind for glob filters and match metadata. */
 export declare enum FileType {
@@ -299,7 +287,7 @@ export declare enum FileType {
   /** Directory. */
   Dir = 2,
   /** Symbolic link. */
-  Symlink = 3
+  Symlink = 3,
 }
 
 /**
@@ -455,12 +443,7 @@ export interface GrepOptions {
 }
 
 /** Output mode for [`search`] and [`grep`] (string values match JS callers). */
-export type GrepOutputMode = /** Emit matched lines (and optional context lines). */
-'content'|
-/** Emit per-file or total counts instead of line content. */
-'count'|
-/** Emit one row per file that matched| without line content. */
-'filesWithMatches';
+export type GrepOutputMode = 'content' | 'count' | 'filesWithMatches'
 
 /** Result of searching files. */
 export interface GrepResult {
@@ -496,12 +479,12 @@ export interface GrepResult {
 export declare function hasMatch(content: string | Uint8Array, pattern: string | Uint8Array, ignoreCase?: boolean | undefined | null, multiline?: boolean | undefined | null): boolean
 
 export type HostObservation =
-  | { kind: 'foreground', waitId: string }
-  | { kind: 'background', reason: string }
-  | { kind: 'none', reason: string }
+  | { kind: 'foreground'; waitId: string }
+  | { kind: 'background'; reason: string }
+  | { kind: 'none'; reason: string }
 
 export type InputData =
-  | { kind: 'bytes', bytes: Buffer }
+  | { kind: 'bytes'; bytes: Buffer }
   | { kind: 'eof' }
 
 export interface InputReceipt {
@@ -634,9 +617,7 @@ export interface OutputRef {
   omittedRanges: Array<OmittedRange>
 }
 
-export type OwnerCloseCause =  'session-close'|
-'stage-close'|
-'app-shutdown';
+export type OwnerCloseCause = 'session-close' | 'stage-close' | 'app-shutdown'
 
 export interface OwnerCloseReceipt {
   ownerId: string
@@ -645,8 +626,8 @@ export interface OwnerCloseReceipt {
 }
 
 export type OwnerScope =
-  | { kind: 'session', sessionId: string }
-  | { kind: 'workflow-stage', sessionId: string, runId: string, stageId: string, stageAttemptId: string }
+  | { kind: 'session'; sessionId: string }
+  | { kind: 'workflow-stage'; sessionId: string; runId: string; stageId: string; stageAttemptId: string }
 
 export interface OwnerSnapshot {
   ownerId: string
@@ -657,6 +638,13 @@ export interface OwnerSnapshot {
   cursor: Cursor
 }
 
+export interface PostgresProcessIdentity {
+  found: boolean
+  startTime?: number
+}
+
+export declare function postgresProcessStartTime(pid: number): PostgresProcessIdentity
+
 export interface PromptRoute {
   sessionId: string
   promptId: string
@@ -766,6 +754,8 @@ export interface SettlementReceipt {
   completionId: string
 }
 
+export declare function signalVerifiedPostgres(pid: number, expectedStartTime: number, mode: string): string
+
 export declare function spawnRetainedPostgres(options: RetainedPostgresSpawnOptions): RetainedPostgres
 
 export interface SubscriptionDrain {
@@ -777,15 +767,15 @@ export interface SubscriptionDrain {
 }
 
 export type TaskEvent =
-  | { kind: 'task-admitted', task: TaskRecord }
-  | { kind: 'task-started', ref: NativeTaskRef }
-  | { kind: 'wait-yielded', ref: NativeTaskRef, waitId: string, reason: YieldReason }
-  | { kind: 'wait-started', ref: NativeTaskRef, waitId: string, observer: string }
-  | { kind: 'host-observation-changed', ref: NativeTaskRef, observation: HostObservation }
-  | { kind: 'task-activity', ref: NativeTaskRef, activity: ActivityReport }
-  | { kind: 'task-cancelling', ref: NativeTaskRef, cause: CancelCause }
-  | { kind: 'task-settled', ref: NativeTaskRef, result: TaskResult, completionId: string }
-  | { kind: 'cleanup-changed', ref: NativeTaskRef, cleanup: Cleanup }
+  | { kind: 'task-admitted'; task: TaskRecord }
+  | { kind: 'task-started'; ref: NativeTaskRef }
+  | { kind: 'wait-yielded'; ref: NativeTaskRef; waitId: string; reason: YieldReason }
+  | { kind: 'wait-started'; ref: NativeTaskRef; waitId: string; observer: string }
+  | { kind: 'host-observation-changed'; ref: NativeTaskRef; observation: HostObservation }
+  | { kind: 'task-activity'; ref: NativeTaskRef; activity: ActivityReport }
+  | { kind: 'task-cancelling'; ref: NativeTaskRef; cause: CancelCause }
+  | { kind: 'task-settled'; ref: NativeTaskRef; result: TaskResult; completionId: string }
+  | { kind: 'cleanup-changed'; ref: NativeTaskRef; cleanup: Cleanup }
   | { kind: 'owner-closing' }
   | { kind: 'owner-closed' }
 
@@ -825,25 +815,21 @@ export interface TaskRecord {
 
 /** Terminal numeric exit codes retain JavaScript number values without i32 narrowing. */
 export type TaskResult =
-  | { kind: 'completed', output: OutputRef, exitCode?: number }
-  | { kind: 'failed', code: string, message: string, output?: OutputRef, exitCode?: number }
-  | { kind: 'cancelled', cause: CancelCause, output?: OutputRef }
+  | { kind: 'completed'; output: OutputRef; exitCode?: number }
+  | { kind: 'failed'; code: string; message: string; output?: OutputRef; exitCode?: number }
+  | { kind: 'cancelled'; cause: CancelCause; output?: OutputRef }
 
 /**
  * Explicit termination causes. Timer/idle/wall-clock causes are intentionally
  * absent, making timer-driven termination unrepresentable.
  */
-export type TerminationCause =  'abort'|
-'interrupt'|
-'fail-fast-skip'|
-'parent-shutdown';
+export type TerminationCause = 'abort' | 'interrupt' | 'fail-fast-skip' | 'parent-shutdown'
 
 export type WaitOutcome =
-  | { kind: 'settled', taskId: string, result: TaskResult }
-  | { kind: 'yielded', taskId: string, waitId: string, reason: YieldReason }
-
-export type YieldReason =  'explicit'|
-'default-background'|
-'elapsed'|
-'intercom-coordination'|
-'input-needed';
+  | { kind: 'settled'; taskId: string; result: TaskResult }
+  | { kind: 'yielded'; taskId: string; waitId: string; reason: YieldReason }
+
+export type YieldReason = 'explicit' | 'default-background' | 'elapsed' | 'intercom-coordination' | 'input-needed'
+
+/** Available only on Windows. */
+export declare function guardWindowsPostgresProcess(pid: number, expectedStartTime: number): WindowsPostgresProcessGuard

package/native/index.js

@@ -1,10 +1,13 @@
-// prettier-ignore
 /* eslint-disable */
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
 
 const { readFileSync } = require('fs')
 let nativeBinding = null
+// Which artifact actually loaded. The WASI fallback chain overwrites it with
+// the flavor it resolved; the late native retry below leaves it alone because
+// it only runs while no WASI candidate has been loaded.
+let __napiLoadedBindingTarget = 'native'
 const loadErrors = []
 
 const isMusl = () => {
@@ -63,7 +66,16 @@ const isMuslFromChildProcess = () => {
 function requireNative() {
   if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
     try {
-      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+      const overrideBinding = require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH)
+      // The override may be a generated WASI loader, which already reports its
+      // own flavor. Adopt it: `module.exports` aliases this object, so claiming
+      // 'native' would both misreport the artifact and overwrite the loader's
+      // marker through the alias.
+      __napiLoadedBindingTarget =
+        overrideBinding && typeof overrideBinding.__napiBindingTarget === 'string'
+          ? overrideBinding.__napiBindingTarget
+          : 'native'
+      return overrideBinding
     } catch (err) {
       loadErrors.push(err)
     }
@@ -77,8 +89,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-android-arm64')
         const bindingPackageVersion = require('@bastani/atomic-natives-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +105,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-android-arm-eabi')
         const bindingPackageVersion = require('@bastani/atomic-natives-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -107,36 +119,36 @@ function requireNative() {
     if (process.arch === 'x64') {
       if ((process.config && process.config.variables && process.config.variables.shlib_suffix === 'dll.a') || (process.config && process.config.variables && process.config.variables.node_target_type === 'shared_library')) {
         try {
-        return require('./atomic_natives.win32-x64-gnu.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        const binding = require('@bastani/atomic-natives-win32-x64-gnu')
-        const bindingPackageVersion = require('@bastani/atomic-natives-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          return require('./atomic_natives.win32-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@bastani/atomic-natives-win32-x64-gnu')
+          const bindingPackageVersion = require('@bastani/atomic-natives-win32-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
         }
-        return binding
-      } catch (e) {
-        loadErrors.push(e)
-      }
       } else {
         try {
-        return require('./atomic_natives.win32-x64-msvc.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        const binding = require('@bastani/atomic-natives-win32-x64-msvc')
-        const bindingPackageVersion = require('@bastani/atomic-natives-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          return require('./atomic_natives.win32-x64-msvc.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@bastani/atomic-natives-win32-x64-msvc')
+          const bindingPackageVersion = require('@bastani/atomic-natives-win32-x64-msvc/package.json').version
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
         }
-        return binding
-      } catch (e) {
-        loadErrors.push(e)
-      }
       }
     } else if (process.arch === 'ia32') {
       try {
@@ -147,8 +159,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-win32-ia32-msvc')
         const bindingPackageVersion = require('@bastani/atomic-natives-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +175,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-win32-arm64-msvc')
         const bindingPackageVersion = require('@bastani/atomic-natives-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +194,8 @@ function requireNative() {
     try {
       const binding = require('@bastani/atomic-natives-darwin-universal')
       const bindingPackageVersion = require('@bastani/atomic-natives-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +210,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-darwin-x64')
         const bindingPackageVersion = require('@bastani/atomic-natives-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +226,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-darwin-arm64')
         const bindingPackageVersion = require('@bastani/atomic-natives-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +246,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-freebsd-x64')
         const bindingPackageVersion = require('@bastani/atomic-natives-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +262,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-freebsd-arm64')
         const bindingPackageVersion = require('@bastani/atomic-natives-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +283,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-x64-musl')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +299,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-x64-gnu')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +317,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-arm64-musl')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +333,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-arm64-gnu')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +351,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-arm-musleabihf')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +367,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +385,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-loong64-musl')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +401,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-loong64-gnu')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +419,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-riscv64-musl')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +435,8 @@ function requireNative() {
         try {
           const binding = require('@bastani/atomic-natives-linux-riscv64-gnu')
           const bindingPackageVersion = require('@bastani/atomic-natives-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +452,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-linux-ppc64-gnu')
         const bindingPackageVersion = require('@bastani/atomic-natives-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +468,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-linux-s390x-gnu')
         const bindingPackageVersion = require('@bastani/atomic-natives-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +488,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-openharmony-arm64')
         const bindingPackageVersion = require('@bastani/atomic-natives-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +504,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-openharmony-x64')
         const bindingPackageVersion = require('@bastani/atomic-natives-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +520,8 @@ function requireNative() {
       try {
         const binding = require('@bastani/atomic-natives-openharmony-arm')
         const bindingPackageVersion = require('@bastani/atomic-natives-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.9.19' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.19 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.20-alpha.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.20-alpha.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -550,7 +562,7 @@ function createLoadErrorChain(errors) {
 //
 // NAPI_RS_WASI_FLAVOR selects one exact generated flavor and implies strict
 // WASI loading. It never crosses into another flavor or falls back to native.
-const __napiWasiFlavors = ["wasm32-wasi"]
+const __napiWasiFlavors = ['wasm32-wasi']
 const __napiWasiFlavor = process.env.NAPI_RS_WASI_FLAVOR
 const __napiWasiFlavorRequested =
   typeof __napiWasiFlavor === 'string' && __napiWasiFlavor.length > 0
@@ -619,15 +631,16 @@ if (!nativeBinding || forceWasi) {
     }
     return null
   }
-  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+  if (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi') {
     let candidateError = null
     let candidateFailed = false
     try {
-      candidateError = __napiWasiResolveCandidate('./atomic_natives.wasi.cjs', false, ["./atomic_natives.wasm32-wasi.debug.wasm","./atomic_natives.wasm32-wasi.wasm"])
+      candidateError = __napiWasiResolveCandidate('./atomic_natives.wasi.cjs', false, ['./atomic_natives.wasm32-wasi.debug.wasm', './atomic_natives.wasm32-wasi.wasm'])
       candidateFailed = candidateError !== null
       if (!candidateFailed) {
         wasiBinding = require('./atomic_natives.wasi.cjs')
         nativeBinding = wasiBinding
+        __napiLoadedBindingTarget = 'wasm32-wasi'
         wasiBindingLoaded = true
       }
     } catch (err) {
@@ -639,7 +652,7 @@ if (!nativeBinding || forceWasi) {
       loadErrors.push(candidateError)
     }
   }
-  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi')) {
     let candidateError = null
     let candidateFailed = false
     try {
@@ -654,6 +667,7 @@ if (!nativeBinding || forceWasi) {
         }
         wasiBinding = require('@bastani/atomic-natives-wasm32-wasi')
         nativeBinding = wasiBinding
+        __napiLoadedBindingTarget = 'wasm32-wasi'
         wasiBindingLoaded = true
       }
     } catch (err) {
@@ -699,6 +713,70 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
+function __napiStampBindingTarget(exportsObject, target) {
+  if (
+    Object.prototype.hasOwnProperty.call(exportsObject, '__napiBindingTarget')
+  ) {
+    if (exportsObject.__napiBindingTarget === target) {
+      // Already ours: the root entry aliases the object it loaded, so a WASI
+      // fallback candidate — or a `NAPI_RS_NATIVE_LIBRARY_PATH` override that
+      // is a generated loader — arrives already stamped with this same value.
+      return target
+    }
+    const error = new Error(
+      '`__napiBindingTarget` is reserved by the generated binding loader, but the loaded binding already exports it. Rename the export, e.g. #[napi(js_name = "...")].',
+    )
+    error.code = 'ERR_NAPI_BINDING_TARGET_CONFLICT'
+    throw error
+  }
+  if (!Object.isExtensible(exportsObject)) {
+    // A `#[napi(module_exports)]` hook may seal or freeze this object
+    // (`Object::seal` / `Object::freeze`). Reporting the artifact is metadata,
+    // never a reason to fail an otherwise successful load, so the stamp is
+    // skipped. What a consumer still sees then follows the entry point: the
+    // browser and deferred loaders declare `__napiBindingTarget` at module
+    // level and go on reporting it, while the CommonJS entries hand back this
+    // very object as `module.exports`, so there the value is absent.
+    return target
+  }
+  try {
+    // [[Define]], not [[Set]]: an ordinary assignment walks the prototype
+    // chain, so an inherited accessor could swallow the value or throw and
+    // fail an otherwise successful load. The descriptor is what a successful
+    // assignment would have produced.
+    Object.defineProperty(exportsObject, '__napiBindingTarget', {
+      configurable: true,
+      enumerable: true,
+      value: target,
+      writable: true,
+    })
+  } catch {
+    // Same rule as the non-extensible skip above: reporting the artifact is
+    // metadata, never a reason to fail an otherwise successful load. An exotic
+    // object (a Proxy whose defineProperty trap refuses) is skipped, not
+    // thrown over.
+  }
+  // The CommonJS loaders assign this return value so `cjs-module-lexer` — and
+  // therefore Node's CJS -> ESM named export detection — can see
+  // `__napiBindingTarget` statically.
+  return target
+}
+// Stamp before the alias, not after. The guard only reads `nativeBinding`
+// (`hasOwnProperty` plus a comparison), which is safe against any addon
+// accessor; an assignment is not, because a `#[napi(module_exports)]` hook can
+// expose a getter reporting this very value and a setter that throws. So the
+// assignment lands on the loader's own `module.exports`, still the original
+// object here, and the alias below replaces it.
+//
+// The assignment is what keeps the marker a statically visible CommonJS export:
+// `cjs-module-lexer` is Node's CJS -> ESM named export detection, it cannot see
+// a bare call, and the later `module.exports = nativeBinding` does not undo the
+// detection. The assignment itself always succeeds — its target is this
+// loader's own, still extensible `module.exports` — and the alias below then
+// discards the value it wrote. What a consumer reads is whatever the guard put
+// on `nativeBinding`, so on a frozen binding, where the guard skips, the
+// linked import resolves to `undefined`.
+module.exports.__napiBindingTarget = __napiStampBindingTarget(nativeBinding, __napiLoadedBindingTarget)
 module.exports = nativeBinding
 module.exports.HostSession = nativeBinding.HostSession
 module.exports.OwnerLease = nativeBinding.OwnerLease
@@ -727,7 +805,14 @@ module.exports.GrepOutputMode = nativeBinding.GrepOutputMode
 module.exports.hasMatch = nativeBinding.hasMatch
 module.exports.invalidateFsScanCache = nativeBinding.invalidateFsScanCache
 module.exports.OwnerCloseCause = nativeBinding.OwnerCloseCause
+module.exports.postgresProcessStartTime = nativeBinding.postgresProcessStartTime
 module.exports.search = nativeBinding.search
+module.exports.signalVerifiedPostgres = nativeBinding.signalVerifiedPostgres
 module.exports.spawnRetainedPostgres = nativeBinding.spawnRetainedPostgres
 module.exports.TerminationCause = nativeBinding.TerminationCause
 module.exports.YieldReason = nativeBinding.YieldReason
+
+if (process.platform === 'win32') {
+  module.exports.WindowsPostgresProcessGuard = nativeBinding.WindowsPostgresProcessGuard
+  module.exports.guardWindowsPostgresProcess = nativeBinding.guardWindowsPostgresProcess
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic-natives",
-  "version": "0.9.19",
+  "version": "0.9.20-alpha.10",
   "description": "Native Rust bindings for Atomic via N-API",
   "homepage": "https://github.com/bastani-inc/atomic",
   "author": "Bastani",
@@ -28,7 +28,7 @@
     "prepublish:native": "napi prepublish --npm-dir npm --tag-style npm --no-gh-release"
   },
   "devDependencies": {
-    "@napi-rs/cli": "3.9.0"
+    "@napi-rs/cli": "3.10.4"
   },
   "engines": {
     "bun": ">=1.4.2",
@@ -59,13 +59,13 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@bastani/atomic-natives-win32-x64-msvc": "0.9.19",
-    "@bastani/atomic-natives-darwin-x64": "0.9.19",
-    "@bastani/atomic-natives-linux-x64-gnu": "0.9.19",
-    "@bastani/atomic-natives-linux-arm64-gnu": "0.9.19",
-    "@bastani/atomic-natives-darwin-arm64": "0.9.19",
-    "@bastani/atomic-natives-win32-arm64-msvc": "0.9.19",
-    "@bastani/atomic-natives-linux-x64-musl": "0.9.19",
-    "@bastani/atomic-natives-linux-arm64-musl": "0.9.19"
+    "@bastani/atomic-natives-win32-x64-msvc": "0.9.20-alpha.10",
+    "@bastani/atomic-natives-darwin-x64": "0.9.20-alpha.10",
+    "@bastani/atomic-natives-linux-x64-gnu": "0.9.20-alpha.10",
+    "@bastani/atomic-natives-linux-arm64-gnu": "0.9.20-alpha.10",
+    "@bastani/atomic-natives-darwin-arm64": "0.9.20-alpha.10",
+    "@bastani/atomic-natives-win32-arm64-msvc": "0.9.20-alpha.10",
+    "@bastani/atomic-natives-linux-x64-musl": "0.9.20-alpha.10",
+    "@bastani/atomic-natives-linux-arm64-musl": "0.9.20-alpha.10"
   }
-}
+}