@delali/narsil 0.2.4-next.51 → 0.2.4-next.54

package/dist/chunk-UTOFOJOR.mjs

@@ -0,0 +1,135 @@
+import { NarsilError, ErrorCodes } from './chunk-FRQVMFY7.mjs';
+import { existsSync } from 'fs';
+import { createRequire } from 'module';
+import { join, dirname } from 'path';
+
+// src/vector/hnsw/constants.ts
+var MAX_LAYER_CAP = 32;
+var MAX_M = 512;
+var INITIAL_UPPER_SLOTS = 64;
+var INITIAL_LIST_CAPACITY = 64;
+var PLACEMENT_ROOM_REQUESTS = 8;
+var COMPACTION_TOMBSTONE_RATIO = 0.1;
+var COMPACTION_ABSOLUTE_THRESHOLD = 1e3;
+var DEFAULT_EF_SEARCH = 50;
+
+// src/vector/native/backend.ts
+var nativeSearchCoreEnabled = true;
+function nativeSearchCoreIsEnabled() {
+  return nativeSearchCoreEnabled;
+}
+function stopUsingTheNativeSearchCore(error) {
+  if (!nativeSearchCoreEnabled) return;
+  nativeSearchCoreEnabled = false;
+  console.warn(
+    "The native search core raised an error, so this thread searches through WebAssembly from now on:",
+    error instanceof Error ? error.message : String(error)
+  );
+}
+function noteFallback(operation) {
+}
+var NATIVE_CORE_ABI_VERSION = 2;
+var BINARY_FILE_NAME = "narsil-core.node";
+var MUSL_DIRECTORY = "musl";
+var PLATFORMS_WITH_A_BINARY = /* @__PURE__ */ new Set([
+  "darwin-arm64",
+  "darwin-x64",
+  "linux-arm64",
+  "linux-x64",
+  "win32-arm64",
+  "win32-x64"
+]);
+var loaded;
+function usesMuslLibc() {
+  try {
+    const report = process.report.getReport();
+    return report.header?.glibcVersionRuntime === void 0;
+  } catch {
+    return false;
+  }
+}
+function isUnavailable(value) {
+  return "missing" in value;
+}
+function binaryFileSegments() {
+  return process.platform === "linux" && usesMuslLibc() ? [MUSL_DIRECTORY, BINARY_FILE_NAME] : [BINARY_FILE_NAME];
+}
+function publishedCoreLocation(target) {
+  const packageName = `@delali/narsil-native-${target}`;
+  let manifest;
+  try {
+    manifest = createRequire(import.meta.url).resolve(`${packageName}/package.json`);
+  } catch {
+    return { missing: `this installation has no "${packageName}" package` };
+  }
+  const path = join(dirname(manifest), ...binaryFileSegments());
+  if (!existsSync(path)) return { missing: `the "${packageName}" package has no search core at ${path}` };
+  return { path };
+}
+function coreLocation() {
+  const named = process.env.NARSIL_NATIVE_CORE_PATH;
+  if (named !== void 0 && named.length > 0) {
+    if (!existsSync(named)) {
+      return { missing: `this process sets NARSIL_NATIVE_CORE_PATH to ${named}, where no file exists` };
+    }
+    return { path: named };
+  }
+  const target = `${process.platform}-${process.arch}`;
+  if (!PLATFORMS_WITH_A_BINARY.has(target)) {
+    return { missing: `the Narsil release includes no search core for ${target}` };
+  }
+  return publishedCoreLocation(target);
+}
+function refuseToSearchWithoutTheCore(reason) {
+  throw new NarsilError(ErrorCodes.CONFIG_INVALID, `NARSIL_REQUIRE_NATIVE_CORE is 1, yet ${reason}`, {
+    platform: `${process.platform}-${process.arch}`
+  });
+}
+function requestedBackend() {
+  const raw = process.env.NARSIL_SEARCH_BACKEND;
+  if (raw === void 0 || raw.trim().length === 0) return null;
+  const named = raw.trim().toLowerCase();
+  if (named === "native" || named === "wasm") return named;
+  throw new NarsilError(
+    ErrorCodes.CONFIG_INVALID,
+    `NARSIL_SEARCH_BACKEND takes either "native" or "wasm", while this environment sets it to "${raw}"`,
+    { value: raw, backends: ["native", "wasm"] }
+  );
+}
+function reportMissingCore(reason, announce) {
+  if (process.env.NARSIL_REQUIRE_NATIVE_CORE === "1") refuseToSearchWithoutTheCore(reason);
+  loaded = null;
+  if (announce) console.warn(`Narsil searches through WebAssembly on this thread, because ${reason}.`);
+  return null;
+}
+function coreAt(path) {
+  let core;
+  try {
+    core = createRequire(import.meta.url)(path);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { missing: `node raised "${message}" while loading the search core at ${path}` };
+  }
+  if (typeof core.abiVersion !== "function") return { missing: `the file at ${path} is no Narsil search core` };
+  const reported = core.abiVersion();
+  if (reported !== NATIVE_CORE_ABI_VERSION) {
+    return {
+      missing: `the search core at ${path} reports ABI version ${reported}, while this build of Narsil needs ${NATIVE_CORE_ABI_VERSION}`
+    };
+  }
+  return core;
+}
+function loadNativeCore() {
+  if (loaded !== void 0) return loaded;
+  if (requestedBackend() === "wasm") {
+    return reportMissingCore("this process sets NARSIL_SEARCH_BACKEND to the WebAssembly search", false);
+  }
+  const location = coreLocation();
+  if (isUnavailable(location)) return reportMissingCore(location.missing, true);
+  const core = coreAt(location.path);
+  if (isUnavailable(core)) return reportMissingCore(core.missing, true);
+  loaded = core;
+  return loaded;
+}
+
+export { COMPACTION_ABSOLUTE_THRESHOLD, COMPACTION_TOMBSTONE_RATIO, DEFAULT_EF_SEARCH, INITIAL_LIST_CAPACITY, INITIAL_UPPER_SLOTS, MAX_LAYER_CAP, MAX_M, PLACEMENT_ROOM_REQUESTS, loadNativeCore, nativeSearchCoreIsEnabled, noteFallback, stopUsingTheNativeSearchCore };