@photostructure/sqlite-vec 0.0.1

package/index.cjs

@@ -0,0 +1,74 @@
+const { join } = require("node:path");
+const { arch, platform } = require("node:process");
+const { readdirSync, statSync } = require("node:fs");
+
+const ENTRYPOINT_BASE_NAME = "vec0";
+
+function extensionSuffix(platform) {
+  if (platform === "win32") return "dll";
+  if (platform === "darwin") return "dylib";
+  return "so";
+}
+
+/**
+ * Detect if running on musl libc (Alpine Linux, etc.)
+ * Uses detect-libc's primary heuristic: check for musl dynamic linker
+ */
+function isMusl() {
+  if (platform !== "linux") return false;
+  try {
+    const files = readdirSync("/lib");
+    return files.some((f) => f.startsWith("ld-musl-"));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * When running inside an Electron app packaged with ASAR, native extensions
+ * are unpacked to app.asar.unpacked/. Replace the path segment so
+ * db.loadExtension() can find the real file on disk.
+ * Outside Electron this is a no-op (paths never contain "app.asar").
+ */
+function asarUnpack(filePath) {
+  return filePath.replace("app.asar", "app.asar.unpacked");
+}
+
+function getLoadablePath() {
+  // Platform-specific subdirectory (e.g., darwin-arm64, linux-x64, linux-x64-musl)
+  const platformDir =
+    platform === "linux" && isMusl()
+      ? `${platform}-${arch}-musl`
+      : `${platform}-${arch}`;
+  const loadablePath = join(
+    __dirname,
+    "dist",
+    platformDir,
+    `${ENTRYPOINT_BASE_NAME}.${extensionSuffix(platform)}`
+  );
+
+  if (!statSync(loadablePath, { throwIfNoEntry: false })) {
+    const supported = [
+      "darwin-x64",
+      "darwin-arm64",
+      "linux-x64",
+      "linux-x64-musl",
+      "linux-arm64",
+      "linux-arm64-musl",
+      "win32-x64",
+      "win32-arm64",
+    ];
+    throw new Error(
+      `Loadable extension for sqlite-vec not found for ${platformDir} at ${loadablePath}. ` +
+        `Supported platforms: ${supported.join(", ")}.`
+    );
+  }
+
+  return asarUnpack(loadablePath);
+}
+
+function load(db) {
+  db.loadExtension(getLoadablePath());
+}
+
+module.exports = { getLoadablePath, load };

package/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns the full path to the sqlite-vec loadable extension bundled with this package
+ */
+export declare function getLoadablePath(): string;
+
+interface Db {
+    loadExtension(file: string, entrypoint?: string | undefined): void;
+}
+
+/**
+ * Load the sqlite-vec extension into a SQLite database connection
+ */
+export declare function load(db: Db): void;

package/index.mjs

@@ -0,0 +1,75 @@
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { arch, platform } from "node:process";
+import { readdirSync, statSync } from "node:fs";
+
+const ENTRYPOINT_BASE_NAME = "vec0";
+
+function extensionSuffix(platform) {
+  if (platform === "win32") return "dll";
+  if (platform === "darwin") return "dylib";
+  return "so";
+}
+
+/**
+ * Detect if running on musl libc (Alpine Linux, etc.)
+ * Uses detect-libc's primary heuristic: check for musl dynamic linker
+ */
+function isMusl() {
+  if (platform !== "linux") return false;
+  try {
+    const files = readdirSync("/lib");
+    return files.some((f) => f.startsWith("ld-musl-"));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * When running inside an Electron app packaged with ASAR, native extensions
+ * are unpacked to app.asar.unpacked/. Replace the path segment so
+ * db.loadExtension() can find the real file on disk.
+ * Outside Electron this is a no-op (paths never contain "app.asar").
+ */
+function asarUnpack(filePath) {
+  return filePath.replace("app.asar", "app.asar.unpacked");
+}
+
+function getLoadablePath() {
+  // Platform-specific subdirectory (e.g., darwin-arm64, linux-x64, linux-x64-musl)
+  const platformDir =
+    platform === "linux" && isMusl()
+      ? `${platform}-${arch}-musl`
+      : `${platform}-${arch}`;
+  const loadablePath = join(
+    fileURLToPath(new URL(".", import.meta.url)),
+    "dist",
+    platformDir,
+    `${ENTRYPOINT_BASE_NAME}.${extensionSuffix(platform)}`
+  );
+
+  if (!statSync(loadablePath, { throwIfNoEntry: false })) {
+    const supported = [
+      "darwin-x64",
+      "darwin-arm64",
+      "linux-x64",
+      "linux-x64-musl",
+      "linux-arm64",
+      "linux-arm64-musl",
+      "win32-x64",
+      "win32-arm64",
+    ];
+    throw new Error(
+      `Loadable extension for sqlite-vec not found for ${platformDir} at ${loadablePath}. ` +
+        `Supported platforms: ${supported.join(", ")}.`
+    );
+  }
+
+  return asarUnpack(loadablePath);
+}
+
+function load(db) {
+  db.loadExtension(getLoadablePath());
+}
+
+export { getLoadablePath, load };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@photostructure/sqlite-vec",
+  "version": "0.0.1",
+  "description": "A vector search SQLite extension that runs anywhere - PhotoStructure's production-ready fork",
+  "main": "./index.cjs",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./index.cjs",
+      "import": "./index.mjs",
+      "types": "./index.d.ts"
+    }
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/photostructure/sqlite-vec.git"
+  },
+  "keywords": [
+    "sqlite",
+    "vector",
+    "search",
+    "embedding",
+    "similarity"
+  ],
+  "author": "Alex Garcia <alex@alex.garcia>",
+  "contributors": [
+    "Vlad Lasky",
+    "Matthew McEachen"
+  ],
+  "license": "(MIT OR Apache-2.0)",
+  "bugs": {
+    "url": "https://github.com/photostructure/sqlite-vec/issues"
+  },
+  "homepage": "https://github.com/photostructure/sqlite-vec#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "files": [
+    "index.cjs",
+    "index.mjs",
+    "index.d.ts",
+    "dist/"
+  ]
+}