@tickernelz/paperclip-pro-adapter-utils 2026.925.0 → 2026.925.2

package/node_modules/bare-fs/index.d.ts

@@ -262,7 +262,7 @@ export type WatcherEventType = 'rename' | 'change'
 
 export interface WatcherEvents<T extends string | Buffer = string | Buffer> extends EventMap {
   error: [err: Error]
-  change: [eventType: WatcherEventType, filename: T]
+  change: [eventType: WatcherEventType, filename: T | null]
   /** Emitted once the watcher has stopped watching. */
   close: []
 }
@@ -270,7 +270,7 @@ export interface WatcherEvents<T extends string | Buffer = string | Buffer> exte
 export interface Watcher<T extends string | Buffer = string | Buffer>
   extends
     EventEmitter<WatcherEvents<T>>,
-    AsyncIterable<{ eventType: WatcherEventType; filename: T }> {
+    AsyncIterable<{ eventType: WatcherEventType; filename: T | null }> {
   /** Stop watching for further changes. Once closed, a `close` event is emitted. */
   close(): void
   /** Prevent the event loop from exiting while the watcher is active. */
@@ -1306,7 +1306,9 @@ export function unlinkSync(filepath: Path): void
 
 /**
  * Watch a file or directory for changes. Returns a `Watcher` object. The `callback`, if provided,
- * is called with `(eventType, filename)` on each change.
+ * is called with `(eventType, filename)` on each change. `filename` is `null` when the platform
+ * could not report which file changed, such as when events were dropped, in which case the watched
+ * path should be rescanned.
  * @param opts - `persistent` defaults to `true`; `recursive` (default `false`) also watches
  * subdirectories; `encoding` defaults to `'utf8'`.
  * @param cb - Called with `(eventType, filename)` on each change; equivalent to listening for the
@@ -1315,42 +1317,42 @@ export function unlinkSync(filepath: Path): void
 export function watch(
   filepath: Path,
   opts: WatcherOptions & { encoding?: BufferEncoding },
-  cb: (eventType: WatcherEventType, filename: string) => void
+  cb: (eventType: WatcherEventType, filename: string | null) => void
 ): Watcher<string>
 
 export function watch(
   filepath: Path,
   opts: WatcherOptions & { encoding: 'buffer' },
-  cb: (eventType: WatcherEventType, filename: Buffer) => void
+  cb: (eventType: WatcherEventType, filename: Buffer | null) => void
 ): Watcher<Buffer>
 
 export function watch(
   filepath: Path,
   opts: WatcherOptions,
-  cb: (eventType: WatcherEventType, filename: string | Buffer) => void
+  cb: (eventType: WatcherEventType, filename: string | Buffer | null) => void
 ): Watcher
 
 export function watch(
   filepath: Path,
   encoding: BufferEncoding,
-  cb: (eventType: WatcherEventType, filename: string) => void
+  cb: (eventType: WatcherEventType, filename: string | null) => void
 ): Watcher<string>
 
 export function watch(
   filepath: Path,
   encoding: 'buffer',
-  cb: (eventType: WatcherEventType, filename: Buffer) => void
+  cb: (eventType: WatcherEventType, filename: Buffer | null) => void
 ): Watcher<Buffer>
 
 export function watch(
   filepath: Path,
   encoding: BufferEncoding | 'buffer',
-  cb: (eventType: WatcherEventType, filename: string | Buffer) => void
+  cb: (eventType: WatcherEventType, filename: string | Buffer | null) => void
 ): Watcher
 
 export function watch(
   filepath: Path,
-  cb: (eventType: WatcherEventType, filename: string) => void
+  cb: (eventType: WatcherEventType, filename: string | null) => void
 ): Watcher<string>
 
 /**

package/node_modules/bare-fs/index.js

@@ -2592,7 +2592,14 @@ class Watcher extends EventEmitter {
 
     this._closed = false
     this._encoding = encoding
-    this._handle = binding.watcherInit(path, recursive, this, this._onevent, this._onclose)
+    this._handle = binding.watcherInit(this, this._onevent, this._onclose)
+
+    try {
+      binding.watcherStart(this._handle, path, recursive)
+    } catch (err) {
+      this.close()
+      throw err
+    }
 
     if (!persistent) this.unref()
 
@@ -2668,9 +2675,11 @@ class Watcher extends EventEmitter {
       this.emit('error', err)
     } else {
       const path =
-        this._encoding === 'buffer'
-          ? Buffer.from(filename)
-          : Buffer.from(filename).toString(this._encoding)
+        filename === null
+          ? null
+          : this._encoding === 'buffer'
+            ? Buffer.from(filename)
+            : Buffer.from(filename).toString(this._encoding)
 
       if (events & binding.UV_RENAME) {
         this.emit('change', 'rename', path)

package/node_modules/bare-fs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-fs",
-  "version": "4.8.1",
+  "version": "4.8.2",
   "description": "Native file system operations for Bare",
   "exports": {
     "./package": "./package.json",
@@ -57,6 +57,7 @@
   "devDependencies": {
     "bare-buffer": "^3.0.2",
     "bare-crypto": "^1.11.2",
+    "bare-thread": "^1.2.6",
     "brittle": "^3.1.1",
     "cmake-bare": "^1.1.7",
     "lunte": "^1.6.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tickernelz/paperclip-pro-adapter-utils",
-  "version": "2026.925.0",
+  "version": "2026.925.2",
   "license": "MIT",
   "homepage": "https://github.com/tickernelz/paperclip-pro",
   "bugs": {
@@ -34,7 +34,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@tickernelz/paperclip-pro-shared": "2026.925.0",
+    "@tickernelz/paperclip-pro-shared": "2026.925.2",
     "acpx": "0.12.0",
     "picocolors": "^1.1.1"
   },