dirsql 0.4.34 → 0.4.36

package/dist/package-dir.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `require.resolve`-shaped seam. Injectable so unit tests can fake module
+ * resolution without a real `node_modules` layout.
+ */
+export interface PackageResolver {
+    /** Resolve a specifier to an on-disk path (`require.resolve`). */
+    resolve(specifier: string): string;
+    /** Candidate `node_modules` dirs for a specifier (`require.resolve.paths`). */
+    paths(specifier: string): string[] | null;
+}
+/** Locate the on-disk package directory for a bare name. */
+export declare function packageDir(name: string, resolver: PackageResolver): string;

package/dist/package-dir.js

@@ -0,0 +1,24 @@
+// Locate an installed package's directory from a bare name, for extension
+// resolution.
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+/** Locate the on-disk package directory for a bare name. */
+export function packageDir(name, resolver) {
+    // The package.json's directory is the package root. Preferred because it is
+    // unaffected by an `exports` map that hides the main entry.
+    try {
+        const pkgJson = resolver.resolve(`${name}/package.json`);
+        return pkgJson.slice(0, pkgJson.length - "/package.json".length);
+    }
+    catch {
+        // `exports` may forbid resolving package.json; fall back to scanning the
+        // candidate node_modules dirs for `<dir>/<name>`.
+    }
+    for (const dir of resolver.paths(name) ?? []) {
+        const candidate = join(dir, name);
+        if (existsSync(candidate) && statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+    }
+    throw new Error(`could not resolve extension package '${name}': not installed`);
+}

package/dist/resolve-extension.d.ts

@@ -1,13 +1,4 @@
-/**
- * `require.resolve`-shaped seam. Injectable so unit tests can fake module
- * resolution without a real `node_modules` layout.
- */
-export interface PackageResolver {
-    /** Resolve a specifier to an on-disk path (`require.resolve`). */
-    resolve(specifier: string): string;
-    /** Candidate `node_modules` dirs for a specifier (`require.resolve.paths`). */
-    paths(specifier: string): string[] | null;
-}
+import { type PackageResolver } from "./package-dir.js";
 /** True when `path` is a bare package name rather than a file path. */
 export declare function isBareName(path: string): boolean;
 /**

package/dist/resolve-extension.js

@@ -14,6 +14,7 @@
 import { existsSync, readdirSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { isAbsolute, join, resolve as resolvePath } from "node:path";
+import { packageDir } from "./package-dir.js";
 // Suffixes that mark a value as "already a file path" (so package resolution is
 // never attempted).
 const LOADABLE_SUFFIXES = [".so", ".dylib", ".dll", ".node"];
@@ -41,26 +42,6 @@ export function isBareName(path) {
     }
     return !LOADABLE_SUFFIXES.some((s) => path.endsWith(s));
 }
-/** Locate the on-disk package directory for a bare name. */
-function packageDir(name, resolver) {
-    // The package.json's directory is the package root. Preferred because it is
-    // unaffected by an `exports` map that hides the main entry.
-    try {
-        const pkgJson = resolver.resolve(`${name}/package.json`);
-        return pkgJson.slice(0, pkgJson.length - "/package.json".length);
-    }
-    catch {
-        // `exports` may forbid resolving package.json; fall back to scanning the
-        // candidate node_modules dirs for `<dir>/<name>`.
-    }
-    for (const dir of resolver.paths(name) ?? []) {
-        const candidate = join(dir, name);
-        if (existsSync(candidate) && statSync(candidate).isDirectory()) {
-            return candidate;
-        }
-    }
-    throw new Error(`could not resolve extension package '${name}': not installed`);
-}
 /** Glob the platform loadable inside a bare name's package dir. */
 function resolvePackage(name, resolver) {
     const dir = packageDir(name, resolver);

package/docs/reference/cli.md

@@ -498,6 +498,24 @@ and, when the query ends:
 dirsql: ran 41231 worker calls in 2m41s
 ```
 
+A worker that keeps a cache of its own can say so per response
+(`{"meta": {"cached": true}}` — see [Worker
+protocol](./config.md#worker-protocol)), and those round trips are then split
+out, because the number that answers *"will this be fast next time"* is not
+the total:
+
+```
+dirsql: running 9204 worker calls (8811 cached)
+dirsql: ran 41231 worker calls in 2m41s (38104 cached)
+```
+
+Both figures count **worker round trips, not rows**. A function declared
+`deterministic = true` lets SQLite reuse one answer for identical arguments
+within a query, so repeated content never reaches the worker at all and both
+numbers sit below the row count on a corpus with duplicates. The split covers
+only what the worker itself reports serving from cache. A worker that sends no
+`meta` gets the unsplit line above, not a `(0 cached)`.
+
 A query that calls no worker prints nothing, whatever the setting — the
 reporting only ever speaks when there is something to report.
 

package/docs/reference/config.md

@@ -161,6 +161,15 @@ request line in, one response line out, per call:
   JSON-text vectors) — or `{"err": "message"}`, which **fails the query**
   with that message. An `{"err": ...}` response leaves the healthy worker
   running; only transport failures (timeout, crash) recycle it.
+- **Optional `"meta"`**, alongside `"ok"`: a second top-level object carrying
+  facts about how the answer was produced rather than what it is. One key is
+  read today — `{"ok": [...], "meta": {"cached": true}}` says the worker
+  answered from a cache of its own, which dirsql reports as the `(N cached)`
+  split on its [worker-call progress line](./cli.md#progress-reporting). The
+  field is **optional and advisory**: a worker that omits it is a worker that
+  reports no cache hits, keys dirsql does not recognize are ignored (they
+  always have been), and a `meta` of an unexpected shape is ignored too rather
+  than failing a query over a progress counter.
 - **stderr passes through** to `dirsql`'s stderr, so a worker's progress
   bars and download logs reach the terminal.
 

package/package.json

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