dirsql 0.4.37 → 0.4.39

package/dist/cli/keep-signals-fatal.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Keep Ctrl-C fatal while the CLI runs in-process.
+ *
+ * The core installs tokio signal handlers for `dirsql server`, and
+ * signal-hook (which tokio uses) *chains*: it runs its own actions and then
+ * the handler installed before it. CPython installs `default_int_handler` at
+ * startup, so the pip launcher gets a terminating disposition for free —
+ * bare Node leaves `SIG_DFL`, which signal-hook does not emulate, so the
+ * signal is swallowed and the process becomes SIGKILL-only (measured: a
+ * probe ignored SIGTERM for 143 seconds).
+ *
+ * Registering a JS listener first gives signal-hook a real prior handler to
+ * chain to. This cannot be fixed after the fact: `removeAllListeners` only
+ * drops JS listeners and cannot touch a disposition installed by native
+ * code, and `unregister_signal` leaves the OS handler in place. One listener
+ * is the whole remedy — no `unsafe`, no `sigaction`.
+ */
+export declare function keepSignalsFatal(): void;

package/dist/cli/keep-signals-fatal.js

@@ -0,0 +1,24 @@
+/**
+ * Keep Ctrl-C fatal while the CLI runs in-process.
+ *
+ * The core installs tokio signal handlers for `dirsql server`, and
+ * signal-hook (which tokio uses) *chains*: it runs its own actions and then
+ * the handler installed before it. CPython installs `default_int_handler` at
+ * startup, so the pip launcher gets a terminating disposition for free —
+ * bare Node leaves `SIG_DFL`, which signal-hook does not emulate, so the
+ * signal is swallowed and the process becomes SIGKILL-only (measured: a
+ * probe ignored SIGTERM for 143 seconds).
+ *
+ * Registering a JS listener first gives signal-hook a real prior handler to
+ * chain to. This cannot be fixed after the fact: `removeAllListeners` only
+ * drops JS listeners and cannot touch a disposition installed by native
+ * code, and `unregister_signal` leaves the OS handler in place. One listener
+ * is the whole remedy — no `unsafe`, no `sigaction`.
+ */
+export function keepSignalsFatal() {
+    // While the core is running, its own handler drives shutdown and this
+    // listener is the tail of the chain; it matters for signals arriving
+    // outside that window, where exiting is exactly right.
+    process.on("SIGINT", () => process.exit(130));
+    process.on("SIGTERM", () => process.exit(143));
+}

package/dist/cli/main.js

@@ -6,51 +6,10 @@
 // `@dirsql/lib-*` addon the SDK loads carries the CLI, so a package ships one
 // copy of the core instead of two (#739).
 import { mainInProcess } from "bin-shim";
-import { loadNativeCore } from "../load-native-core.js";
 import { die } from "./die.js";
+import { keepSignalsFatal } from "./keep-signals-fatal.js";
 import { withResolvedExtensions } from "./resolve-config-extensions.js";
-/**
- * Resolve `runCli` off the same addon the SDK loads.
- *
- * bin-shim can resolve an addon itself, but its default naming is
- * `@{scope}/lib-{platform}-{arch}`, which cannot express the ABI suffix
- * dirsql's packages carry (`@dirsql/lib-linux-x64-gnu`). Reusing
- * `loadNativeCore` keeps one resolution rule for the SDK and the CLI —
- * including its dev fallback to a locally built `dirsql.node` — so a
- * monorepo checkout and a published install take the same path.
- */
-function resolveRunCli() {
-    const core = loadNativeCore();
-    if (typeof core.runCli !== "function") {
-        throw new Error("dirsql: the native addon has no callable `runCli` export; " +
-            "it was built without the `cli` feature.");
-    }
-    return core.runCli;
-}
-/**
- * Keep Ctrl-C fatal while the CLI runs in-process.
- *
- * The core installs tokio signal handlers for `dirsql server`, and
- * signal-hook (which tokio uses) *chains*: it runs its own actions and then
- * the handler installed before it. CPython installs `default_int_handler` at
- * startup, so the pip launcher gets a terminating disposition for free —
- * bare Node leaves `SIG_DFL`, which signal-hook does not emulate, so the
- * signal is swallowed and the process becomes SIGKILL-only (measured: a
- * probe ignored SIGTERM for 143 seconds).
- *
- * Registering a JS listener first gives signal-hook a real prior handler to
- * chain to. This cannot be fixed after the fact: `removeAllListeners` only
- * drops JS listeners and cannot touch a disposition installed by native
- * code, and `unregister_signal` leaves the OS handler in place. One listener
- * is the whole remedy — no `unsafe`, no `sigaction`.
- */
-function keepSignalsFatal() {
-    // While the core is running, its own handler drives shutdown and this
-    // listener is the tail of the chain; it matters for signals arriving
-    // outside that window, where exiting is exactly right.
-    process.on("SIGINT", () => process.exit(130));
-    process.on("SIGTERM", () => process.exit(143));
-}
+import { resolveRunCli } from "./resolve-run-cli.js";
 export async function main(argv = process.argv.slice(2)) {
     keepSignalsFatal();
     // Resolve any package-name extensions in a TOML config here (the core

package/dist/cli/resolve-run-cli.d.ts

@@ -0,0 +1,13 @@
+/** The addon's CLI entry point, as napi exports it. */
+export type RunCli = (argv: readonly string[]) => number;
+/**
+ * Resolve `runCli` off the same addon the SDK loads.
+ *
+ * bin-shim can resolve an addon itself, but its default naming is
+ * `@{scope}/lib-{platform}-{arch}`, which cannot express the ABI suffix
+ * dirsql's packages carry (`@dirsql/lib-linux-x64-gnu`). Reusing
+ * `loadNativeCore` keeps one resolution rule for the SDK and the CLI —
+ * including its dev fallback to a locally built `dirsql.node` — so a
+ * monorepo checkout and a published install take the same path.
+ */
+export declare function resolveRunCli(): RunCli;

package/dist/cli/resolve-run-cli.js

@@ -0,0 +1,19 @@
+import { loadNativeCore } from "../load-native-core.js";
+/**
+ * Resolve `runCli` off the same addon the SDK loads.
+ *
+ * bin-shim can resolve an addon itself, but its default naming is
+ * `@{scope}/lib-{platform}-{arch}`, which cannot express the ABI suffix
+ * dirsql's packages carry (`@dirsql/lib-linux-x64-gnu`). Reusing
+ * `loadNativeCore` keeps one resolution rule for the SDK and the CLI —
+ * including its dev fallback to a locally built `dirsql.node` — so a
+ * monorepo checkout and a published install take the same path.
+ */
+export function resolveRunCli() {
+    const core = loadNativeCore();
+    if (typeof core.runCli !== "function") {
+        throw new Error("dirsql: the native addon has no callable `runCli` export; " +
+            "it was built without the `cli` feature.");
+    }
+    return core.runCli;
+}

package/dist/default-resolver.d.ts

@@ -0,0 +1,3 @@
+import type { PackageResolver } from "./package-dir.js";
+/** `require.resolve`-backed resolver used when a caller injects none. */
+export declare function defaultResolver(): PackageResolver;

package/dist/default-resolver.js

@@ -0,0 +1,9 @@
+import { createRequire } from "node:module";
+/** `require.resolve`-backed resolver used when a caller injects none. */
+export function defaultResolver() {
+    const req = createRequire(import.meta.url);
+    return {
+        resolve: (s) => req.resolve(s),
+        paths: (s) => req.resolve.paths(s),
+    };
+}

package/dist/has-bare-name.d.ts

@@ -0,0 +1,3 @@
+import type { Toml } from "./load-extension-entries.js";
+/** True when some entry's `path` names an extension by bare package name. */
+export declare function hasBareName(entries: Toml[]): boolean;

package/dist/has-bare-name.js

@@ -0,0 +1,5 @@
+import { isBareName } from "./is-bare-name.js";
+/** True when some entry's `path` names an extension by bare package name. */
+export function hasBareName(entries) {
+    return entries.some((e) => typeof e.path === "string" && isBareName(e.path));
+}

package/dist/is-bare-name.d.ts

@@ -0,0 +1,2 @@
+/** True when `path` is a bare package name rather than a file path. */
+export declare function isBareName(path: string): boolean;

package/dist/is-bare-name.js

@@ -0,0 +1,10 @@
+/** True when `path` is a bare package name rather than a file path. */
+export function isBareName(path) {
+    // Suffixes that mark a value as "already a file path" (so package resolution is
+    // never attempted).
+    const loadableSuffixes = [".so", ".dylib", ".dll", ".node"];
+    if (path.includes("/") || path.includes("\\")) {
+        return false;
+    }
+    return !loadableSuffixes.some((s) => path.endsWith(s));
+}

package/dist/library-slug.d.ts

@@ -0,0 +1,8 @@
+import type { Platform } from "./platforms.js";
+/**
+ * Suffix used in the napi `.node` filename for a given triple. Follows the
+ * `@napi-rs/cli` convention: `dirsql.<platform>-<arch>[-<abi>].node`, e.g.
+ * `dirsql.linux-x64-gnu.node`. Derived from the sub-package name so the
+ * on-disk artifact name and the npm package name can't drift.
+ */
+export declare function librarySlug(p: Platform): string;

package/dist/library-slug.js

@@ -0,0 +1,13 @@
+/**
+ * Suffix used in the napi `.node` filename for a given triple. Follows the
+ * `@napi-rs/cli` convention: `dirsql.<platform>-<arch>[-<abi>].node`, e.g.
+ * `dirsql.linux-x64-gnu.node`. Derived from the sub-package name so the
+ * on-disk artifact name and the npm package name can't drift.
+ */
+export function librarySlug(p) {
+    const prefix = "@dirsql/lib-";
+    if (!p.libName.startsWith(prefix)) {
+        throw new Error(`libName ${p.libName} missing ${prefix} prefix`);
+    }
+    return p.libName.slice(prefix.length);
+}

package/dist/platform-suffixes.d.ts

@@ -0,0 +1,2 @@
+/** Loadable-file glob suffix(es) for the current platform. */
+export declare function platformSuffixes(): string[];

package/dist/platform-suffixes.js

@@ -0,0 +1,10 @@
+/** Loadable-file glob suffix(es) for the current platform. */
+export function platformSuffixes() {
+    if (process.platform === "darwin") {
+        return [".dylib", ".node"];
+    }
+    if (process.platform === "win32") {
+        return [".dll", ".node"];
+    }
+    return [".so", ".node"];
+}

package/dist/platforms.d.ts

@@ -17,10 +17,3 @@ export interface Platform {
 export declare const PLATFORMS: readonly Platform[];
 /** Node `${platform}-${arch}` → `@dirsql/lib-*` napi sub-package name. */
 export declare function libTriples(): Record<string, string>;
-/**
- * Suffix used in the napi `.node` filename for a given triple. Follows the
- * `@napi-rs/cli` convention: `dirsql.<platform>-<arch>[-<abi>].node`, e.g.
- * `dirsql.linux-x64-gnu.node`. Derived from the sub-package name so the
- * on-disk artifact name and the npm package name can't drift.
- */
-export declare function librarySlug(p: Platform): string;

package/dist/platforms.js

@@ -64,16 +64,3 @@ export function libTriples() {
     }
     return out;
 }
-/**
- * Suffix used in the napi `.node` filename for a given triple. Follows the
- * `@napi-rs/cli` convention: `dirsql.<platform>-<arch>[-<abi>].node`, e.g.
- * `dirsql.linux-x64-gnu.node`. Derived from the sub-package name so the
- * on-disk artifact name and the npm package name can't drift.
- */
-export function librarySlug(p) {
-    const prefix = "@dirsql/lib-";
-    if (!p.libName.startsWith(prefix)) {
-        throw new Error(`libName ${p.libName} missing ${prefix} prefix`);
-    }
-    return p.libName.slice(prefix.length);
-}

package/dist/resolve-config-extension-specs.d.ts

@@ -0,0 +1,13 @@
+import type { ExtensionSpec } from "./dirsql.js";
+/**
+ * Resolve a TOML config's `[[dirsql.extension]]` entries to literal paths.
+ *
+ * Returns the resolved specs — every entry resolved via
+ * `resolveExtensionPath` against the config file's parent directory — when at
+ * least one entry's `path` is a bare package name. Returns `null` when the
+ * caller should not intervene: the config is missing, malformed, declares no
+ * extensions, or uses only literal paths — leaving the core's own loading
+ * (and error reporting) untouched. Throws if a package name cannot be
+ * resolved.
+ */
+export declare function resolveConfigExtensionSpecs(configPath: string): ExtensionSpec[] | null;

package/dist/resolve-config-extension-specs.js

@@ -0,0 +1,21 @@
+import { hasBareName } from "./has-bare-name.js";
+import { loadExtensionEntries } from "./load-extension-entries.js";
+import { resolveEntries } from "./resolve-entries.js";
+/**
+ * Resolve a TOML config's `[[dirsql.extension]]` entries to literal paths.
+ *
+ * Returns the resolved specs — every entry resolved via
+ * `resolveExtensionPath` against the config file's parent directory — when at
+ * least one entry's `path` is a bare package name. Returns `null` when the
+ * caller should not intervene: the config is missing, malformed, declares no
+ * extensions, or uses only literal paths — leaving the core's own loading
+ * (and error reporting) untouched. Throws if a package name cannot be
+ * resolved.
+ */
+export function resolveConfigExtensionSpecs(configPath) {
+    const loaded = loadExtensionEntries(configPath);
+    if (loaded === null || !hasBareName(loaded.entries)) {
+        return null;
+    }
+    return resolveEntries(loaded.entries, loaded.base);
+}

package/dist/resolve-config-extensions.d.ts

@@ -1,16 +1,4 @@
 import type { ExtensionSpec } from "./dirsql.js";
-/**
- * Resolve a TOML config's `[[dirsql.extension]]` entries to literal paths.
- *
- * Returns the resolved specs — every entry resolved via
- * `resolveExtensionPath` against the config file's parent directory — when at
- * least one entry's `path` is a bare package name. Returns `null` when the
- * caller should not intervene: the config is missing, malformed, declares no
- * extensions, or uses only literal paths — leaving the core's own loading
- * (and error reporting) untouched. Throws if a package name cannot be
- * resolved.
- */
-export declare function resolveConfigExtensionSpecs(configPath: string): ExtensionSpec[] | null;
 /**
  * Resolve the `[[dirsql.extension]]` entries of several configs, in order.
  *

package/dist/resolve-config-extensions.js

@@ -7,35 +7,9 @@
 // own config-extension loading so the entries are not loaded twice.
 //
 // Shared by the `DirSQL` constructor (`config` option) and the CLI launcher.
+import { hasBareName } from "./has-bare-name.js";
 import { loadExtensionEntries } from "./load-extension-entries.js";
-import { isBareName, resolveExtensionPath } from "./resolve-extension.js";
-function hasBareName(entries) {
-    return entries.some((e) => typeof e.path === "string" && isBareName(e.path));
-}
-function resolveEntries(entries, base) {
-    return entries.map((e) => ({
-        path: resolveExtensionPath(e.path, base, true),
-        entrypoint: typeof e.entrypoint === "string" ? e.entrypoint : undefined,
-    }));
-}
-/**
- * Resolve a TOML config's `[[dirsql.extension]]` entries to literal paths.
- *
- * Returns the resolved specs — every entry resolved via
- * `resolveExtensionPath` against the config file's parent directory — when at
- * least one entry's `path` is a bare package name. Returns `null` when the
- * caller should not intervene: the config is missing, malformed, declares no
- * extensions, or uses only literal paths — leaving the core's own loading
- * (and error reporting) untouched. Throws if a package name cannot be
- * resolved.
- */
-export function resolveConfigExtensionSpecs(configPath) {
-    const loaded = loadExtensionEntries(configPath);
-    if (loaded === null || !hasBareName(loaded.entries)) {
-        return null;
-    }
-    return resolveEntries(loaded.entries, loaded.base);
-}
+import { resolveEntries } from "./resolve-entries.js";
 /**
  * Resolve the `[[dirsql.extension]]` entries of several configs, in order.
  *

package/dist/resolve-entries.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionSpec } from "./dirsql.js";
+import type { Toml } from "./load-extension-entries.js";
+/** Resolve a config's entries to specs, against that config's own directory. */
+export declare function resolveEntries(entries: Toml[], base: string): ExtensionSpec[];

package/dist/resolve-entries.js

@@ -0,0 +1,8 @@
+import { resolveExtensionPath } from "./resolve-extension.js";
+/** Resolve a config's entries to specs, against that config's own directory. */
+export function resolveEntries(entries, base) {
+    return entries.map((e) => ({
+        path: resolveExtensionPath(e.path, base, true),
+        entrypoint: typeof e.entrypoint === "string" ? e.entrypoint : undefined,
+    }));
+}

package/dist/resolve-extension.d.ts

@@ -1,6 +1,4 @@
 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;
 /**
  * Resolve an extension `path` to a concrete file. `base` is the directory a
  * relative path and the bare-name shadow probe resolve against (a config file's

package/dist/resolve-extension.js

@@ -12,26 +12,10 @@
 //      matches and multiple matches are both hard errors -- disambiguate
 //      with a literal path.
 import { existsSync, statSync } from "node:fs";
-import { createRequire } from "node:module";
 import { isAbsolute, resolve as resolvePath } from "node:path";
+import { defaultResolver } from "./default-resolver.js";
+import { isBareName } from "./is-bare-name.js";
 import { resolvePackage } from "./resolve-package.js";
-// Suffixes that mark a value as "already a file path" (so package resolution is
-// never attempted).
-const LOADABLE_SUFFIXES = [".so", ".dylib", ".dll", ".node"];
-function defaultResolver() {
-    const req = createRequire(import.meta.url);
-    return {
-        resolve: (s) => req.resolve(s),
-        paths: (s) => req.resolve.paths(s),
-    };
-}
-/** True when `path` is a bare package name rather than a file path. */
-export function isBareName(path) {
-    if (path.includes("/") || path.includes("\\")) {
-        return false;
-    }
-    return !LOADABLE_SUFFIXES.some((s) => path.endsWith(s));
-}
 /**
  * Resolve an extension `path` to a concrete file. `base` is the directory a
  * relative path and the bare-name shadow probe resolve against (a config file's

package/dist/resolve-package.js

@@ -2,16 +2,7 @@
 import { readdirSync } from "node:fs";
 import { join } from "node:path";
 import { packageDir } from "./package-dir.js";
-/** Loadable-file glob suffix(es) for the current platform. */
-function platformSuffixes() {
-    if (process.platform === "darwin") {
-        return [".dylib", ".node"];
-    }
-    if (process.platform === "win32") {
-        return [".dll", ".node"];
-    }
-    return [".so", ".node"];
-}
+import { platformSuffixes } from "./platform-suffixes.js";
 /** Glob the platform loadable inside a bare name's package dir. */
 export function resolvePackage(name, resolver) {
     const dir = packageDir(name, resolver);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.4.37",
+  "version": "0.4.39",
   "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.37",
-    "@dirsql/lib-linux-arm64-gnu": "0.4.37",
-    "@dirsql/lib-darwin-x64": "0.4.37",
-    "@dirsql/lib-darwin-arm64": "0.4.37",
-    "@dirsql/lib-win32-x64-msvc": "0.4.37"
+    "@dirsql/lib-linux-x64-gnu": "0.4.39",
+    "@dirsql/lib-linux-arm64-gnu": "0.4.39",
+    "@dirsql/lib-darwin-x64": "0.4.39",
+    "@dirsql/lib-darwin-arm64": "0.4.39",
+    "@dirsql/lib-win32-x64-msvc": "0.4.39"
   }
 }