dirsql 0.4.4 → 0.4.5

package/dist/core.d.ts

@@ -1,9 +1,10 @@
-import type { ExtensionSpec, RowEvent } from "./dirsql.js";
+import type { ExtensionSpec, RowEvent, ScanFailure } from "./dirsql.js";
 import type { TableDef } from "./table.js";
 export interface NativeDirSQL {
     query(sql: string): Promise<Record<string, unknown>[]>;
     startWatcher(): Promise<void>;
     pollEvents(timeoutMs: number): Promise<RowEvent[]>;
+    scanFailures(): ScanFailure[];
     close(): void;
 }
 export interface NativeDirSQLConstructor {

package/dist/dirsql.d.ts

@@ -75,6 +75,19 @@ export interface RowEvent {
     error?: string | null;
     filePath?: string | null;
 }
+/**
+ * One file the initial scan could not index.
+ *
+ * A scan failure is not a scan *error*: the other files are indexed and the
+ * database is usable. This is how a caller learns the index is incomplete,
+ * and which files are missing from it.
+ */
+export interface ScanFailure {
+    /** Path relative to the scan root. */
+    path: string;
+    /** The hook's error, as it rendered it. */
+    message: string;
+}
 /**
  * Ephemeral SQL index over a local directory.
  *
@@ -128,6 +141,18 @@ export declare class DirSQL {
      * even for large result sets or long-running queries.
      */
     query(sql: string): Promise<Record<string, unknown>[]>;
+    /**
+     * The files the initial scan could not index, each with its root-relative
+     * `path` and the hook's own `message`.
+     *
+     * Empty after a clean scan, which is the signal to check: a non-empty list
+     * means the index is *incomplete*, not wrong, and those files are retried
+     * on the next scan.
+     *
+     * Awaits the initial scan first, so a caller cannot see an empty list
+     * merely because the scan had not yet reached the failing file.
+     */
+    scanFailures(): Promise<ScanFailure[]>;
     /**
      * Start the file watcher. Must be called before {@link pollEvents}.
      * Idempotent — safe to call multiple times.

package/dist/dirsql.js

@@ -97,6 +97,21 @@ export class DirSQL {
         await this.ready;
         return this._inner.query(sql);
     }
+    /**
+     * The files the initial scan could not index, each with its root-relative
+     * `path` and the hook's own `message`.
+     *
+     * Empty after a clean scan, which is the signal to check: a non-empty list
+     * means the index is *incomplete*, not wrong, and those files are retried
+     * on the next scan.
+     *
+     * Awaits the initial scan first, so a caller cannot see an empty list
+     * merely because the scan had not yet reached the failing file.
+     */
+    async scanFailures() {
+        await this.ready;
+        return this._inner.scanFailures();
+    }
     /**
      * Start the file watcher. Must be called before {@link pollEvents}.
      * Idempotent — safe to call multiple times.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { DirSQL } from "./dirsql.js";
-export type { DirSQLOptions, ExtensionSpec, RowEvent, } from "./dirsql.js";
+export type { DirSQLOptions, ExtensionSpec, RowEvent, ScanFailure, } from "./dirsql.js";
 export { parseTableName } from "./parse-table-name.js";
 export { Table } from "./table.js";
 export type { TableDef } from "./table.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Ephemeral SQL index over a local directory",
   "license": "MIT",
   "repository": "https://github.com/thekevinscott/dirsql",
@@ -212,15 +212,15 @@
     ]
   },
   "optionalDependencies": {
-    "@dirsql/lib-linux-x64-gnu": "0.4.4",
-    "@dirsql/lib-linux-arm64-gnu": "0.4.4",
-    "@dirsql/lib-darwin-x64": "0.4.4",
-    "@dirsql/lib-darwin-arm64": "0.4.4",
-    "@dirsql/lib-win32-x64-msvc": "0.4.4",
-    "@dirsql/cli-linux-x64-gnu": "0.4.4",
-    "@dirsql/cli-linux-arm64-gnu": "0.4.4",
-    "@dirsql/cli-darwin-x64": "0.4.4",
-    "@dirsql/cli-darwin-arm64": "0.4.4",
-    "@dirsql/cli-win32-x64-msvc": "0.4.4"
+    "@dirsql/lib-linux-x64-gnu": "0.4.5",
+    "@dirsql/lib-linux-arm64-gnu": "0.4.5",
+    "@dirsql/lib-darwin-x64": "0.4.5",
+    "@dirsql/lib-darwin-arm64": "0.4.5",
+    "@dirsql/lib-win32-x64-msvc": "0.4.5",
+    "@dirsql/cli-linux-x64-gnu": "0.4.5",
+    "@dirsql/cli-linux-arm64-gnu": "0.4.5",
+    "@dirsql/cli-darwin-x64": "0.4.5",
+    "@dirsql/cli-darwin-arm64": "0.4.5",
+    "@dirsql/cli-win32-x64-msvc": "0.4.5"
   }
 }