@sqliteai/sqlite-vector 0.9.45

package/README.md

@@ -0,0 +1,326 @@
+# @sqliteai/sqlite-vector
+
+[![npm version](https://badge.fury.io/js/@sqliteai%2Fsqlite-vector.svg)](https://www.npmjs.com/package/@sqliteai/sqlite-vector)
+[![License](https://img.shields.io/badge/license-Elastic%202.0-blue.svg)](../../../LICENSE.md)
+
+> SQLite Vector extension for Node.js - Cross-platform vector embeddings and similarity search
+
+**SQLite Vector** brings powerful vector search capabilities to SQLite in Node.js. Perfect for Edge AI, semantic search, RAG applications, and similarity matching - all running locally without external dependencies.
+
+## Features
+
+- ✅ **Cross-platform** - Works on macOS, Linux (glibc/musl), and Windows
+- ✅ **Zero configuration** - Automatically detects and loads the correct binary for your platform
+- ✅ **TypeScript native** - Full type definitions included
+- ✅ **Modern ESM + CJS** - Works with both ES modules and CommonJS
+- ✅ **Small footprint** - Only downloads binaries for your platform (~30MB)
+- ✅ **Offline-ready** - No external services required
+
+## Installation
+
+```bash
+npm install @sqliteai/sqlite-vector
+```
+
+The package automatically downloads the correct native extension for your platform during installation.
+
+### Supported Platforms
+
+| Platform | Architecture | Package |
+|----------|-------------|---------|
+| macOS | ARM64 (Apple Silicon) | `@sqliteai/sqlite-vector-darwin-arm64` |
+| macOS | x86_64 (Intel) | `@sqliteai/sqlite-vector-darwin-x86_64` |
+| Linux | ARM64 (glibc) | `@sqliteai/sqlite-vector-linux-arm64` |
+| Linux | ARM64 (musl/Alpine) | `@sqliteai/sqlite-vector-linux-arm64-musl` |
+| Linux | x86_64 (glibc) | `@sqliteai/sqlite-vector-linux-x86_64` |
+| Linux | x86_64 (musl/Alpine) | `@sqliteai/sqlite-vector-linux-x86_64-musl` |
+| Windows | x86_64 | `@sqliteai/sqlite-vector-win32-x86_64` |
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { getExtensionPath } from '@sqliteai/sqlite-vector';
+import Database from 'better-sqlite3';
+
+// Get the path to the vector extension
+const extensionPath = getExtensionPath();
+
+// Load it into your SQLite database
+const db = new Database(':memory:');
+db.loadExtension(extensionPath);
+
+// Use vector functions
+db.exec(`
+  CREATE TABLE embeddings (
+    id INTEGER PRIMARY KEY,
+    vector BLOB,
+    text TEXT
+  );
+`);
+
+// Initialize vector search
+db.prepare("SELECT vector_init('embeddings', 'vector', 'type=FLOAT32,dimension=384')").run();
+
+// Insert vectors (using your embedding model)
+const embedding = new Float32Array(384);
+// ... fill embedding with your model's output
+
+db.prepare('INSERT INTO embeddings (vector, text) VALUES (?, ?)').run(
+  Buffer.from(embedding.buffer),
+  'Sample text'
+);
+
+// Perform similarity search
+const query = new Float32Array(384); // Your query embedding
+const results = db.prepare(`
+  SELECT e.id, e.text, v.distance
+  FROM embeddings AS e
+  JOIN vector_quantize_scan('embeddings', 'vector', ?, 10) AS v
+  ON e.id = v.rowid
+  ORDER BY v.distance ASC
+`).all(Buffer.from(query.buffer));
+
+console.log(results);
+```
+
+### CommonJS
+
+```javascript
+const { getExtensionPath } = require('@sqliteai/sqlite-vector');
+const Database = require('better-sqlite3');
+
+const db = new Database(':memory:');
+db.loadExtension(getExtensionPath());
+
+// Ready to use
+const version = db.prepare('SELECT vector_version()').pluck().get();
+console.log('Vector extension version:', version);
+```
+
+### Get Extension Information
+
+```typescript
+import { getExtensionInfo } from '@sqliteai/sqlite-vector';
+
+const info = getExtensionInfo();
+console.log(info);
+// {
+//   platform: 'darwin-arm64',
+//   packageName: '@sqliteai/sqlite-vector-darwin-arm64',
+//   binaryName: 'vector.dylib',
+//   path: '/path/to/node_modules/@sqliteai/sqlite-vector-darwin-arm64/vector.dylib'
+// }
+```
+
+## Examples
+
+For complete, runnable examples, see the [sqlite-extensions-guide](https://github.com/sqliteai/sqlite-extensions-guide/tree/main/examples/node):
+
+- **[basic-usage.js](https://github.com/sqliteai/sqlite-extensions-guide/blob/main/examples/node/basic-usage.js)** - Generic extension loading for any @sqliteai extension
+- **[semantic-search.js](https://github.com/sqliteai/sqlite-extensions-guide/blob/main/examples/node/semantic-search.js)** - Complete semantic search with OpenAI or on-device embeddings
+- **[with-multiple-extensions.js](https://github.com/sqliteai/sqlite-extensions-guide/blob/main/examples/node/with-multiple-extensions.js)** - Loading multiple extensions together (vector + sync + AI + js)
+
+These examples are generic and work with all SQLite extensions: `sqlite-vector`, `sqlite-sync`, `sqlite-js`, and `sqlite-ai`.
+
+## API Reference
+
+### `getExtensionPath(): string`
+
+Returns the absolute path to the SQLite Vector extension binary for the current platform.
+
+**Returns:** `string` - Absolute path to the extension file (`.so`, `.dylib`, or `.dll`)
+
+**Throws:** `ExtensionNotFoundError` - If the extension binary cannot be found for the current platform
+
+**Example:**
+```typescript
+import { getExtensionPath } from '@sqliteai/sqlite-vector';
+
+const path = getExtensionPath();
+// => '/path/to/node_modules/@sqliteai/sqlite-vector-darwin-arm64/vector.dylib'
+```
+
+---
+
+### `getExtensionInfo(): ExtensionInfo`
+
+Returns detailed information about the extension for the current platform.
+
+**Returns:** `ExtensionInfo` object with the following properties:
+- `platform: Platform` - Current platform identifier (e.g., `'darwin-arm64'`)
+- `packageName: string` - Name of the platform-specific npm package
+- `binaryName: string` - Filename of the binary (e.g., `'vector.dylib'`)
+- `path: string` - Full path to the extension binary
+
+**Throws:** `ExtensionNotFoundError` - If the extension binary cannot be found
+
+**Example:**
+```typescript
+import { getExtensionInfo } from '@sqliteai/sqlite-vector';
+
+const info = getExtensionInfo();
+console.log(`Running on ${info.platform}`);
+console.log(`Extension path: ${info.path}`);
+```
+
+---
+
+### `getCurrentPlatform(): Platform`
+
+Returns the current platform identifier.
+
+**Returns:** `Platform` - One of:
+- `'darwin-arm64'` - macOS ARM64
+- `'darwin-x86_64'` - macOS x86_64
+- `'linux-arm64'` - Linux ARM64 (glibc)
+- `'linux-arm64-musl'` - Linux ARM64 (musl)
+- `'linux-x86_64'` - Linux x86_64 (glibc)
+- `'linux-x86_64-musl'` - Linux x86_64 (musl)
+- `'win32-x86_64'` - Windows x86_64
+
+**Throws:** `Error` - If the platform is unsupported
+
+---
+
+### `isMusl(): boolean`
+
+Detects if the system uses musl libc (Alpine Linux, etc.).
+
+**Returns:** `boolean` - `true` if musl is detected, `false` otherwise
+
+---
+
+### `class ExtensionNotFoundError extends Error`
+
+Error thrown when the SQLite Vector extension cannot be found for the current platform.
+
+## Vector Search Guide
+
+For detailed information on how to use the vector search features, see the [main documentation](https://github.com/sqliteai/sqlite-vector/blob/main/README.md).
+
+### Quick Reference
+
+```sql
+-- Initialize vector column
+SELECT vector_init('table', 'column', 'type=FLOAT32,dimension=384');
+
+-- Quantize vectors for faster search
+SELECT vector_quantize('table', 'column');
+
+-- Preload into memory for 4-5x speedup
+SELECT vector_quantize_preload('table', 'column');
+
+-- Search for similar vectors
+SELECT * FROM table AS t
+JOIN vector_quantize_scan('table', 'column', <query_vector>, <limit>) AS v
+ON t.rowid = v.rowid
+ORDER BY v.distance;
+```
+
+### Distance Metrics
+
+Specify the distance metric during initialization:
+
+```sql
+-- L2 (Euclidean) - default
+SELECT vector_init('table', 'column', 'type=FLOAT32,dimension=384,distance=L2');
+
+-- Cosine similarity
+SELECT vector_init('table', 'column', 'type=FLOAT32,dimension=384,distance=COSINE');
+
+-- Dot product
+SELECT vector_init('table', 'column', 'type=FLOAT32,dimension=384,distance=DOT');
+
+-- L1 (Manhattan)
+SELECT vector_init('table', 'column', 'type=FLOAT32,dimension=384,distance=L1');
+```
+
+## Troubleshooting
+
+### Extension Not Found
+
+If you get `ExtensionNotFoundError`, try:
+
+```bash
+# Force reinstall dependencies
+npm install --force
+
+# Or manually install the platform package
+npm install @sqliteai/sqlite-vector-darwin-arm64  # Replace with your platform
+```
+
+### Platform Not Detected
+
+The package should automatically detect your platform. If detection fails, please [open an issue](https://github.com/sqliteai/sqlite-vector/issues) with:
+- Your OS and architecture
+- Node.js version
+- Output of `node -p "process.platform + '-' + process.arch"`
+
+### Alpine Linux / musl
+
+On Alpine Linux or other musl-based systems, the package automatically detects musl and installs the correct variant. If you encounter issues:
+
+```bash
+# Verify musl detection
+node -e "console.log(require('@sqliteai/sqlite-vector').isMusl())"
+
+# Should print: true
+```
+
+## Development
+
+### Building from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/sqliteai/sqlite-vector.git
+cd sqlite-vector/packages/node
+
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Run tests
+npm test
+```
+
+### Project Structure
+
+```
+packages/node/
+├── src/
+│   ├── index.ts                     # Main entry point
+│   ├── platform.ts                  # Platform detection logic
+│   └── index.test.ts                # Test suite
+├── dist/                            # Compiled JavaScript (generated)
+├── generate-platform-packages.js   # Platform package generator
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Related Projects
+
+- **[SQLite-AI](https://github.com/sqliteai/sqlite-ai)** - On-device AI inference and embedding generation
+- **[SQLite-Sync](https://github.com/sqliteai/sqlite-sync)** - Sync on-device databases with the cloud
+- **[SQLite-JS](https://github.com/sqliteai/sqlite-js)** - Define SQLite functions in JavaScript
+
+## License
+
+This project is licensed under the [Elastic License 2.0](../../../LICENSE.md).
+
+For production or managed service use, please [contact SQLite Cloud, Inc](mailto:info@sqlitecloud.io) for a commercial license.
+
+## Contributing
+
+Contributions are welcome! Please see the [main repository](https://github.com/sqliteai/sqlite-vector) for contribution guidelines.
+
+## Support
+
+- 📖 [Documentation](https://github.com/sqliteai/sqlite-vector/blob/main/API.md)
+- 🐛 [Report Issues](https://github.com/sqliteai/sqlite-vector/issues)
+- 💬 [Discussions](https://github.com/sqliteai/sqlite-vector/discussions)

package/dist/index.d.mts

@@ -0,0 +1,84 @@
+/**
+ * Supported platform identifiers
+ */
+type Platform = 'darwin-arm64' | 'darwin-x86_64' | 'linux-arm64' | 'linux-arm64-musl' | 'linux-x86_64' | 'linux-x86_64-musl' | 'win32-x86_64';
+/**
+ * Detects if the system uses musl libc (Alpine Linux, etc.)
+ * Uses multiple detection strategies for reliability
+ */
+declare function isMusl(): boolean;
+/**
+ * Gets the current platform identifier
+ * @throws {Error} If the platform is unsupported
+ */
+declare function getCurrentPlatform(): Platform;
+/**
+ * Gets the package name for the current platform
+ */
+declare function getPlatformPackageName(): string;
+/**
+ * Gets the binary filename for the current platform
+ */
+declare function getBinaryName(): string;
+
+/**
+ * Error thrown when the SQLite Vector extension cannot be found
+ */
+declare class ExtensionNotFoundError extends Error {
+    constructor(message: string);
+}
+/**
+ * Gets the absolute path to the SQLite Vector extension binary for the current platform
+ *
+ * @returns Absolute path to the extension binary (.so, .dylib, or .dll)
+ * @throws {ExtensionNotFoundError} If the extension binary cannot be found
+ *
+ * @example
+ * ```typescript
+ * import { getExtensionPath } from '@sqliteai/sqlite-vector';
+ *
+ * const extensionPath = getExtensionPath();
+ * // On macOS ARM64: /path/to/node_modules/@sqliteai/sqlite-vector-darwin-arm64/vector.dylib
+ * ```
+ */
+declare function getExtensionPath(): string;
+/**
+ * Information about the current platform and extension
+ */
+interface ExtensionInfo {
+    /** Current platform identifier (e.g., 'darwin-arm64') */
+    platform: Platform;
+    /** Name of the platform-specific npm package */
+    packageName: string;
+    /** Filename of the binary (e.g., 'vector.dylib') */
+    binaryName: string;
+    /** Full path to the extension binary */
+    path: string;
+}
+/**
+ * Gets detailed information about the SQLite Vector extension
+ *
+ * @returns Extension information object
+ *
+ * @example
+ * ```typescript
+ * import { getExtensionInfo } from '@sqliteai/sqlite-vector';
+ *
+ * const info = getExtensionInfo();
+ * console.log(info);
+ * // {
+ * //   platform: 'darwin-arm64',
+ * //   packageName: '@sqliteai/sqlite-vector-darwin-arm64',
+ * //   binaryName: 'vector.dylib',
+ * //   path: '/path/to/vector.dylib'
+ * // }
+ * ```
+ */
+declare function getExtensionInfo(): ExtensionInfo;
+declare const _default: {
+    getExtensionPath: typeof getExtensionPath;
+    getExtensionInfo: typeof getExtensionInfo;
+    ExtensionNotFoundError: typeof ExtensionNotFoundError;
+};
+
+export { type ExtensionInfo, ExtensionNotFoundError, type Platform, _default as default, getBinaryName, getCurrentPlatform, getExtensionInfo, getExtensionPath, getPlatformPackageName, isMusl };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Supported platform identifiers
+ */
+type Platform = 'darwin-arm64' | 'darwin-x86_64' | 'linux-arm64' | 'linux-arm64-musl' | 'linux-x86_64' | 'linux-x86_64-musl' | 'win32-x86_64';
+/**
+ * Detects if the system uses musl libc (Alpine Linux, etc.)
+ * Uses multiple detection strategies for reliability
+ */
+declare function isMusl(): boolean;
+/**
+ * Gets the current platform identifier
+ * @throws {Error} If the platform is unsupported
+ */
+declare function getCurrentPlatform(): Platform;
+/**
+ * Gets the package name for the current platform
+ */
+declare function getPlatformPackageName(): string;
+/**
+ * Gets the binary filename for the current platform
+ */
+declare function getBinaryName(): string;
+
+/**
+ * Error thrown when the SQLite Vector extension cannot be found
+ */
+declare class ExtensionNotFoundError extends Error {
+    constructor(message: string);
+}
+/**
+ * Gets the absolute path to the SQLite Vector extension binary for the current platform
+ *
+ * @returns Absolute path to the extension binary (.so, .dylib, or .dll)
+ * @throws {ExtensionNotFoundError} If the extension binary cannot be found
+ *
+ * @example
+ * ```typescript
+ * import { getExtensionPath } from '@sqliteai/sqlite-vector';
+ *
+ * const extensionPath = getExtensionPath();
+ * // On macOS ARM64: /path/to/node_modules/@sqliteai/sqlite-vector-darwin-arm64/vector.dylib
+ * ```
+ */
+declare function getExtensionPath(): string;
+/**
+ * Information about the current platform and extension
+ */
+interface ExtensionInfo {
+    /** Current platform identifier (e.g., 'darwin-arm64') */
+    platform: Platform;
+    /** Name of the platform-specific npm package */
+    packageName: string;
+    /** Filename of the binary (e.g., 'vector.dylib') */
+    binaryName: string;
+    /** Full path to the extension binary */
+    path: string;
+}
+/**
+ * Gets detailed information about the SQLite Vector extension
+ *
+ * @returns Extension information object
+ *
+ * @example
+ * ```typescript
+ * import { getExtensionInfo } from '@sqliteai/sqlite-vector';
+ *
+ * const info = getExtensionInfo();
+ * console.log(info);
+ * // {
+ * //   platform: 'darwin-arm64',
+ * //   packageName: '@sqliteai/sqlite-vector-darwin-arm64',
+ * //   binaryName: 'vector.dylib',
+ * //   path: '/path/to/vector.dylib'
+ * // }
+ * ```
+ */
+declare function getExtensionInfo(): ExtensionInfo;
+declare const _default: {
+    getExtensionPath: typeof getExtensionPath;
+    getExtensionInfo: typeof getExtensionInfo;
+    ExtensionNotFoundError: typeof ExtensionNotFoundError;
+};
+
+export { type ExtensionInfo, ExtensionNotFoundError, type Platform, _default as default, getBinaryName, getCurrentPlatform, getExtensionInfo, getExtensionPath, getPlatformPackageName, isMusl };

package/dist/index.js

@@ -0,0 +1,162 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var path = require('path');
+var fs = require('fs');
+var os = require('os');
+var child_process = require('child_process');
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var PLATFORM_EXTENSIONS = {
+  darwin: ".dylib",
+  linux: ".so",
+  win32: ".dll"
+};
+function isMusl() {
+  var _a, _b, _c;
+  if (os.platform() !== "linux") {
+    return false;
+  }
+  const muslFiles = [
+    "/lib/ld-musl-x86_64.so.1",
+    "/lib/ld-musl-aarch64.so.1",
+    "/lib/ld-musl-armhf.so.1"
+  ];
+  for (const file of muslFiles) {
+    if (fs.existsSync(file)) {
+      return true;
+    }
+  }
+  try {
+    const lddVersion = child_process.execSync("ldd --version 2>&1", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (lddVersion.includes("musl")) {
+      return true;
+    }
+  } catch {
+  }
+  try {
+    if (fs.existsSync("/etc/os-release")) {
+      const osRelease = fs.readFileSync("/etc/os-release", "utf-8");
+      if (osRelease.includes("Alpine") || osRelease.includes("musl")) {
+        return true;
+      }
+    }
+  } catch {
+  }
+  try {
+    const report = (_b = (_a = process.report) == null ? void 0 : _a.getReport) == null ? void 0 : _b.call(_a);
+    if (((_c = report == null ? void 0 : report.header) == null ? void 0 : _c.glibcVersionRuntime) === "") {
+      return true;
+    }
+  } catch {
+  }
+  return false;
+}
+function getCurrentPlatform() {
+  const platformName = os.platform();
+  const archName = os.arch();
+  if (platformName === "darwin") {
+    if (archName === "arm64") return "darwin-arm64";
+    if (archName === "x64" || archName === "ia32") return "darwin-x86_64";
+  }
+  if (platformName === "linux") {
+    const muslSuffix = isMusl() ? "-musl" : "";
+    if (archName === "arm64") {
+      return `linux-arm64${muslSuffix}`;
+    }
+    if (archName === "x64" || archName === "ia32") {
+      return `linux-x86_64${muslSuffix}`;
+    }
+  }
+  if (platformName === "win32") {
+    if (archName === "x64" || archName === "ia32") return "win32-x86_64";
+  }
+  throw new Error(
+    `Unsupported platform: ${platformName}-${archName}. Supported platforms: darwin-arm64, darwin-x86_64, linux-arm64, linux-x86_64, win32-x86_64 (with glibc or musl support for Linux)`
+  );
+}
+function getPlatformPackageName() {
+  const currentPlatform = getCurrentPlatform();
+  return `@sqliteai/sqlite-vector-${currentPlatform}`;
+}
+function getBinaryName() {
+  const platformName = os.platform();
+  const extension = PLATFORM_EXTENSIONS[platformName];
+  if (!extension) {
+    throw new Error(`Unknown platform: ${platformName}`);
+  }
+  return `vector${extension}`;
+}
+
+// src/index.ts
+var ExtensionNotFoundError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ExtensionNotFoundError";
+  }
+};
+function tryLoadPlatformPackage() {
+  try {
+    const packageName = getPlatformPackageName();
+    const platformPackage = __require(packageName);
+    if ((platformPackage == null ? void 0 : platformPackage.path) && typeof platformPackage.path === "string") {
+      if (fs.existsSync(platformPackage.path)) {
+        return platformPackage.path;
+      }
+    }
+  } catch (error) {
+  }
+  return null;
+}
+function getExtensionPath() {
+  const platformPath = tryLoadPlatformPackage();
+  if (platformPath) {
+    return path.resolve(platformPath);
+  }
+  const currentPlatform = getCurrentPlatform();
+  const packageName = getPlatformPackageName();
+  throw new ExtensionNotFoundError(
+    `SQLite Vector extension not found for platform: ${currentPlatform}
+
+The platform-specific package "${packageName}" is not installed.
+This usually happens when:
+  1. Your platform is not supported
+  2. npm failed to install optional dependencies
+  3. You're installing with --no-optional flag
+
+Try running: npm install --force`
+  );
+}
+function getExtensionInfo() {
+  return {
+    platform: getCurrentPlatform(),
+    packageName: getPlatformPackageName(),
+    binaryName: getBinaryName(),
+    path: getExtensionPath()
+  };
+}
+var index_default = {
+  getExtensionPath,
+  getExtensionInfo,
+  ExtensionNotFoundError
+};
+
+exports.ExtensionNotFoundError = ExtensionNotFoundError;
+exports.default = index_default;
+exports.getBinaryName = getBinaryName;
+exports.getCurrentPlatform = getCurrentPlatform;
+exports.getExtensionInfo = getExtensionInfo;
+exports.getExtensionPath = getExtensionPath;
+exports.getPlatformPackageName = getPlatformPackageName;
+exports.isMusl = isMusl;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform.ts","../src/index.ts"],"names":["platform","existsSync","execSync","readFileSync","arch","resolve"],"mappings":"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","file":"index.js","sourcesContent":["import { platform, arch } from 'node:os';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { execSync } from 'node:child_process';\n\n/**\n * Supported platform identifiers\n */\nexport type Platform =\n  | 'darwin-arm64'\n  | 'darwin-x86_64'\n  | 'linux-arm64'\n  | 'linux-arm64-musl'\n  | 'linux-x86_64'\n  | 'linux-x86_64-musl'\n  | 'win32-x86_64';\n\n/**\n * Binary extension for each platform\n */\nexport const PLATFORM_EXTENSIONS: Record<string, string> = {\n  darwin: '.dylib',\n  linux: '.so',\n  win32: '.dll',\n} as const;\n\n/**\n * Detects if the system uses musl libc (Alpine Linux, etc.)\n * Uses multiple detection strategies for reliability\n */\nexport function isMusl(): boolean {\n  // Only relevant for Linux\n  if (platform() !== 'linux') {\n    return false;\n  }\n\n  // Strategy 1: Check for musl-specific files\n  const muslFiles = [\n    '/lib/ld-musl-x86_64.so.1',\n    '/lib/ld-musl-aarch64.so.1',\n    '/lib/ld-musl-armhf.so.1',\n  ];\n\n  for (const file of muslFiles) {\n    if (existsSync(file)) {\n      return true;\n    }\n  }\n\n  // Strategy 2: Check ldd version output\n  try {\n    const lddVersion = execSync('ldd --version 2>&1', {\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    });\n\n    if (lddVersion.includes('musl')) {\n      return true;\n    }\n  } catch {\n    // ldd command failed, continue to next strategy\n  }\n\n  // Strategy 3: Check /etc/os-release for Alpine\n  try {\n    if (existsSync('/etc/os-release')) {\n      const osRelease = readFileSync('/etc/os-release', 'utf-8');\n      if (osRelease.includes('Alpine') || osRelease.includes('musl')) {\n        return true;\n      }\n    }\n  } catch {\n    // File read failed, continue to next strategy\n  }\n\n  // Strategy 4: Check process.report.getReport() for musl\n  try {\n    const report = (process as any).report?.getReport?.();\n    if (report?.header?.glibcVersionRuntime === '') {\n      // Empty glibc version often indicates musl\n      return true;\n    }\n  } catch {\n    // Report not available\n  }\n\n  return false;\n}\n\n/**\n * Gets the current platform identifier\n * @throws {Error} If the platform is unsupported\n */\nexport function getCurrentPlatform(): Platform {\n  const platformName = platform();\n  const archName = arch();\n\n  // macOS\n  if (platformName === 'darwin') {\n    if (archName === 'arm64') return 'darwin-arm64';\n    if (archName === 'x64' || archName === 'ia32') return 'darwin-x86_64';\n  }\n\n  // Linux (with musl detection)\n  if (platformName === 'linux') {\n    const muslSuffix = isMusl() ? '-musl' : '';\n\n    if (archName === 'arm64') {\n      return `linux-arm64${muslSuffix}` as Platform;\n    }\n    if (archName === 'x64' || archName === 'ia32') {\n      return `linux-x86_64${muslSuffix}` as Platform;\n    }\n  }\n\n  // Windows\n  if (platformName === 'win32') {\n    if (archName === 'x64' || archName === 'ia32') return 'win32-x86_64';\n  }\n\n  // Unsupported platform\n  throw new Error(\n    `Unsupported platform: ${platformName}-${archName}. ` +\n    `Supported platforms: darwin-arm64, darwin-x86_64, linux-arm64, linux-x86_64, win32-x86_64 ` +\n    `(with glibc or musl support for Linux)`\n  );\n}\n\n/**\n * Gets the package name for the current platform\n */\nexport function getPlatformPackageName(): string {\n  const currentPlatform = getCurrentPlatform();\n  return `@sqliteai/sqlite-vector-${currentPlatform}`;\n}\n\n/**\n * Gets the binary filename for the current platform\n */\nexport function getBinaryName(): string {\n  const platformName = platform();\n  const extension = PLATFORM_EXTENSIONS[platformName];\n\n  if (!extension) {\n    throw new Error(`Unknown platform: ${platformName}`);\n  }\n\n  return `vector${extension}`;\n}\n","import { resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport {\n  getCurrentPlatform,\n  getPlatformPackageName,\n  getBinaryName,\n  type Platform\n} from './platform.js';\n\n/**\n * Error thrown when the SQLite Vector extension cannot be found\n */\nexport class ExtensionNotFoundError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ExtensionNotFoundError';\n  }\n}\n\n/**\n * Attempts to load the platform-specific package\n * @returns The path to the extension binary, or null if not found\n */\nfunction tryLoadPlatformPackage(): string | null {\n  try {\n    const packageName = getPlatformPackageName();\n\n    // Try to dynamically import the platform package\n    // This works in both CommonJS and ESM\n    const platformPackage = require(packageName);\n\n    if (platformPackage?.path && typeof platformPackage.path === 'string') {\n      if (existsSync(platformPackage.path)) {\n        return platformPackage.path;\n      }\n    }\n  } catch (error) {\n    // Platform package not installed or failed to load\n    // This is expected when optionalDependencies fail\n  }\n\n  return null;\n}\n\n/**\n * Gets the absolute path to the SQLite Vector extension binary for the current platform\n *\n * @returns Absolute path to the extension binary (.so, .dylib, or .dll)\n * @throws {ExtensionNotFoundError} If the extension binary cannot be found\n *\n * @example\n * ```typescript\n * import { getExtensionPath } from '@sqliteai/sqlite-vector';\n *\n * const extensionPath = getExtensionPath();\n * // On macOS ARM64: /path/to/node_modules/@sqliteai/sqlite-vector-darwin-arm64/vector.dylib\n * ```\n */\nexport function getExtensionPath(): string {\n  // Try to load from platform-specific package\n  const platformPath = tryLoadPlatformPackage();\n  if (platformPath) {\n    return resolve(platformPath);\n  }\n\n  // If we reach here, the platform package wasn't installed\n  const currentPlatform = getCurrentPlatform();\n  const packageName = getPlatformPackageName();\n\n  throw new ExtensionNotFoundError(\n    `SQLite Vector extension not found for platform: ${currentPlatform}\\n\\n` +\n    `The platform-specific package \"${packageName}\" is not installed.\\n` +\n    `This usually happens when:\\n` +\n    `  1. Your platform is not supported\\n` +\n    `  2. npm failed to install optional dependencies\\n` +\n    `  3. You're installing with --no-optional flag\\n\\n` +\n    `Try running: npm install --force`\n  );\n}\n\n/**\n * Information about the current platform and extension\n */\nexport interface ExtensionInfo {\n  /** Current platform identifier (e.g., 'darwin-arm64') */\n  platform: Platform;\n  /** Name of the platform-specific npm package */\n  packageName: string;\n  /** Filename of the binary (e.g., 'vector.dylib') */\n  binaryName: string;\n  /** Full path to the extension binary */\n  path: string;\n}\n\n/**\n * Gets detailed information about the SQLite Vector extension\n *\n * @returns Extension information object\n *\n * @example\n * ```typescript\n * import { getExtensionInfo } from '@sqliteai/sqlite-vector';\n *\n * const info = getExtensionInfo();\n * console.log(info);\n * // {\n * //   platform: 'darwin-arm64',\n * //   packageName: '@sqliteai/sqlite-vector-darwin-arm64',\n * //   binaryName: 'vector.dylib',\n * //   path: '/path/to/vector.dylib'\n * // }\n * ```\n */\nexport function getExtensionInfo(): ExtensionInfo {\n  return {\n    platform: getCurrentPlatform(),\n    packageName: getPlatformPackageName(),\n    binaryName: getBinaryName(),\n    path: getExtensionPath(),\n  };\n}\n\n// Default export for CommonJS compatibility\nexport default {\n  getExtensionPath,\n  getExtensionInfo,\n  ExtensionNotFoundError,\n};\n\n// Re-export platform utilities\nexport { getCurrentPlatform, getPlatformPackageName, getBinaryName, isMusl } from './platform.js';\nexport type { Platform } from './platform.js';\n"]}

package/dist/index.mjs

@@ -0,0 +1,151 @@
+import { resolve } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { platform, arch } from 'os';
+import { execSync } from 'child_process';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var PLATFORM_EXTENSIONS = {
+  darwin: ".dylib",
+  linux: ".so",
+  win32: ".dll"
+};
+function isMusl() {
+  var _a, _b, _c;
+  if (platform() !== "linux") {
+    return false;
+  }
+  const muslFiles = [
+    "/lib/ld-musl-x86_64.so.1",
+    "/lib/ld-musl-aarch64.so.1",
+    "/lib/ld-musl-armhf.so.1"
+  ];
+  for (const file of muslFiles) {
+    if (existsSync(file)) {
+      return true;
+    }
+  }
+  try {
+    const lddVersion = execSync("ldd --version 2>&1", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (lddVersion.includes("musl")) {
+      return true;
+    }
+  } catch {
+  }
+  try {
+    if (existsSync("/etc/os-release")) {
+      const osRelease = readFileSync("/etc/os-release", "utf-8");
+      if (osRelease.includes("Alpine") || osRelease.includes("musl")) {
+        return true;
+      }
+    }
+  } catch {
+  }
+  try {
+    const report = (_b = (_a = process.report) == null ? void 0 : _a.getReport) == null ? void 0 : _b.call(_a);
+    if (((_c = report == null ? void 0 : report.header) == null ? void 0 : _c.glibcVersionRuntime) === "") {
+      return true;
+    }
+  } catch {
+  }
+  return false;
+}
+function getCurrentPlatform() {
+  const platformName = platform();
+  const archName = arch();
+  if (platformName === "darwin") {
+    if (archName === "arm64") return "darwin-arm64";
+    if (archName === "x64" || archName === "ia32") return "darwin-x86_64";
+  }
+  if (platformName === "linux") {
+    const muslSuffix = isMusl() ? "-musl" : "";
+    if (archName === "arm64") {
+      return `linux-arm64${muslSuffix}`;
+    }
+    if (archName === "x64" || archName === "ia32") {
+      return `linux-x86_64${muslSuffix}`;
+    }
+  }
+  if (platformName === "win32") {
+    if (archName === "x64" || archName === "ia32") return "win32-x86_64";
+  }
+  throw new Error(
+    `Unsupported platform: ${platformName}-${archName}. Supported platforms: darwin-arm64, darwin-x86_64, linux-arm64, linux-x86_64, win32-x86_64 (with glibc or musl support for Linux)`
+  );
+}
+function getPlatformPackageName() {
+  const currentPlatform = getCurrentPlatform();
+  return `@sqliteai/sqlite-vector-${currentPlatform}`;
+}
+function getBinaryName() {
+  const platformName = platform();
+  const extension = PLATFORM_EXTENSIONS[platformName];
+  if (!extension) {
+    throw new Error(`Unknown platform: ${platformName}`);
+  }
+  return `vector${extension}`;
+}
+
+// src/index.ts
+var ExtensionNotFoundError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ExtensionNotFoundError";
+  }
+};
+function tryLoadPlatformPackage() {
+  try {
+    const packageName = getPlatformPackageName();
+    const platformPackage = __require(packageName);
+    if ((platformPackage == null ? void 0 : platformPackage.path) && typeof platformPackage.path === "string") {
+      if (existsSync(platformPackage.path)) {
+        return platformPackage.path;
+      }
+    }
+  } catch (error) {
+  }
+  return null;
+}
+function getExtensionPath() {
+  const platformPath = tryLoadPlatformPackage();
+  if (platformPath) {
+    return resolve(platformPath);
+  }
+  const currentPlatform = getCurrentPlatform();
+  const packageName = getPlatformPackageName();
+  throw new ExtensionNotFoundError(
+    `SQLite Vector extension not found for platform: ${currentPlatform}
+
+The platform-specific package "${packageName}" is not installed.
+This usually happens when:
+  1. Your platform is not supported
+  2. npm failed to install optional dependencies
+  3. You're installing with --no-optional flag
+
+Try running: npm install --force`
+  );
+}
+function getExtensionInfo() {
+  return {
+    platform: getCurrentPlatform(),
+    packageName: getPlatformPackageName(),
+    binaryName: getBinaryName(),
+    path: getExtensionPath()
+  };
+}
+var index_default = {
+  getExtensionPath,
+  getExtensionInfo,
+  ExtensionNotFoundError
+};
+
+export { ExtensionNotFoundError, index_default as default, getBinaryName, getCurrentPlatform, getExtensionInfo, getExtensionPath, getPlatformPackageName, isMusl };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/platform.ts","../src/index.ts"],"names":["existsSync"],"mappings":";;;;;;;;;;;AAmBO,IAAM,mBAAA,GAA8C;AAAA,EACzD,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,KAAA;AAAA,EACP,KAAA,EAAO;AACT,CAAA;AAMO,SAAS,MAAA,GAAkB;AA7BlC,EAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AA+BE,EAAA,IAAI,QAAA,OAAe,OAAA,EAAS;AAC1B,IAAA,OAAO,KAAA;AAAA,EACT;AAGA,EAAA,MAAM,SAAA,GAAY;AAAA,IAChB,0BAAA;AAAA,IACA,2BAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,KAAA,MAAW,QAAQ,SAAA,EAAW;AAC5B,IAAA,IAAI,UAAA,CAAW,IAAI,CAAA,EAAG;AACpB,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI;AACF,IAAA,MAAM,UAAA,GAAa,SAAS,oBAAA,EAAsB;AAAA,MAChD,QAAA,EAAU,OAAA;AAAA,MACV,KAAA,EAAO,CAAC,MAAA,EAAQ,MAAA,EAAQ,MAAM;AAAA,KAC/B,CAAA;AAED,IAAA,IAAI,UAAA,CAAW,QAAA,CAAS,MAAM,CAAA,EAAG;AAC/B,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAGA,EAAA,IAAI;AACF,IAAA,IAAI,UAAA,CAAW,iBAAiB,CAAA,EAAG;AACjC,MAAA,MAAM,SAAA,GAAY,YAAA,CAAa,iBAAA,EAAmB,OAAO,CAAA;AACzD,MAAA,IAAI,UAAU,QAAA,CAAS,QAAQ,KAAK,SAAA,CAAU,QAAA,CAAS,MAAM,CAAA,EAAG;AAC9D,QAAA,OAAO,IAAA;AAAA,MACT;AAAA,IACF;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAGA,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAA,CAAU,EAAA,GAAA,CAAA,EAAA,GAAA,OAAA,CAAgB,MAAA,KAAhB,IAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAwB,SAAA,KAAxB,IAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,IAAA,CAAA,EAAA,CAAA;AAChB,IAAA,IAAA,CAAA,CAAI,EAAA,GAAA,MAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,MAAA,CAAQ,MAAA,KAAR,IAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAgB,mBAAA,MAAwB,EAAA,EAAI;AAE9C,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA,CAAA,MAAQ;AAAA,EAER;AAEA,EAAA,OAAO,KAAA;AACT;AAMO,SAAS,kBAAA,GAA+B;AAC7C,EAAA,MAAM,eAAe,QAAA,EAAS;AAC9B,EAAA,MAAM,WAAW,IAAA,EAAK;AAGtB,EAAA,IAAI,iBAAiB,QAAA,EAAU;AAC7B,IAAA,IAAI,QAAA,KAAa,SAAS,OAAO,cAAA;AACjC,IAAA,IAAI,QAAA,KAAa,KAAA,IAAS,QAAA,KAAa,MAAA,EAAQ,OAAO,eAAA;AAAA,EACxD;AAGA,EAAA,IAAI,iBAAiB,OAAA,EAAS;AAC5B,IAAA,MAAM,UAAA,GAAa,MAAA,EAAO,GAAI,OAAA,GAAU,EAAA;AAExC,IAAA,IAAI,aAAa,OAAA,EAAS;AACxB,MAAA,OAAO,cAAc,UAAU,CAAA,CAAA;AAAA,IACjC;AACA,IAAA,IAAI,QAAA,KAAa,KAAA,IAAS,QAAA,KAAa,MAAA,EAAQ;AAC7C,MAAA,OAAO,eAAe,UAAU,CAAA,CAAA;AAAA,IAClC;AAAA,EACF;AAGA,EAAA,IAAI,iBAAiB,OAAA,EAAS;AAC5B,IAAA,IAAI,QAAA,KAAa,KAAA,IAAS,QAAA,KAAa,MAAA,EAAQ,OAAO,cAAA;AAAA,EACxD;AAGA,EAAA,MAAM,IAAI,KAAA;AAAA,IACR,CAAA,sBAAA,EAAyB,YAAY,CAAA,CAAA,EAAI,QAAQ,CAAA,kIAAA;AAAA,GAGnD;AACF;AAKO,SAAS,sBAAA,GAAiC;AAC/C,EAAA,MAAM,kBAAkB,kBAAA,EAAmB;AAC3C,EAAA,OAAO,2BAA2B,eAAe,CAAA,CAAA;AACnD;AAKO,SAAS,aAAA,GAAwB;AACtC,EAAA,MAAM,eAAe,QAAA,EAAS;AAC9B,EAAA,MAAM,SAAA,GAAY,oBAAoB,YAAY,CAAA;AAElD,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kBAAA,EAAqB,YAAY,CAAA,CAAE,CAAA;AAAA,EACrD;AAEA,EAAA,OAAO,SAAS,SAAS,CAAA,CAAA;AAC3B;;;ACvIO,IAAM,sBAAA,GAAN,cAAqC,KAAA,CAAM;AAAA,EAChD,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,wBAAA;AAAA,EACd;AACF;AAMA,SAAS,sBAAA,GAAwC;AAC/C,EAAA,IAAI;AACF,IAAA,MAAM,cAAc,sBAAA,EAAuB;AAI3C,IAAA,MAAM,eAAA,GAAkB,UAAQ,WAAW,CAAA;AAE3C,IAAA,IAAA,CAAI,eAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,eAAA,CAAiB,IAAA,KAAQ,OAAO,eAAA,CAAgB,SAAS,QAAA,EAAU;AACrE,MAAA,IAAIA,UAAAA,CAAW,eAAA,CAAgB,IAAI,CAAA,EAAG;AACpC,QAAA,OAAO,eAAA,CAAgB,IAAA;AAAA,MACzB;AAAA,IACF;AAAA,EACF,SAAS,KAAA,EAAO;AAAA,EAGhB;AAEA,EAAA,OAAO,IAAA;AACT;AAgBO,SAAS,gBAAA,GAA2B;AAEzC,EAAA,MAAM,eAAe,sBAAA,EAAuB;AAC5C,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,OAAO,QAAQ,YAAY,CAAA;AAAA,EAC7B;AAGA,EAAA,MAAM,kBAAkB,kBAAA,EAAmB;AAC3C,EAAA,MAAM,cAAc,sBAAA,EAAuB;AAE3C,EAAA,MAAM,IAAI,sBAAA;AAAA,IACR,mDAAmD,eAAe;;AAAA,+BAAA,EAChC,WAAW,CAAA;AAAA;AAAA;AAAA;AAAA;;AAAA,gCAAA;AAAA,GAM/C;AACF;AAmCO,SAAS,gBAAA,GAAkC;AAChD,EAAA,OAAO;AAAA,IACL,UAAU,kBAAA,EAAmB;AAAA,IAC7B,aAAa,sBAAA,EAAuB;AAAA,IACpC,YAAY,aAAA,EAAc;AAAA,IAC1B,MAAM,gBAAA;AAAiB,GACzB;AACF;AAGA,IAAO,aAAA,GAAQ;AAAA,EACb,gBAAA;AAAA,EACA,gBAAA;AAAA,EACA;AACF","file":"index.mjs","sourcesContent":["import { platform, arch } from 'node:os';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { execSync } from 'node:child_process';\n\n/**\n * Supported platform identifiers\n */\nexport type Platform =\n  | 'darwin-arm64'\n  | 'darwin-x86_64'\n  | 'linux-arm64'\n  | 'linux-arm64-musl'\n  | 'linux-x86_64'\n  | 'linux-x86_64-musl'\n  | 'win32-x86_64';\n\n/**\n * Binary extension for each platform\n */\nexport const PLATFORM_EXTENSIONS: Record<string, string> = {\n  darwin: '.dylib',\n  linux: '.so',\n  win32: '.dll',\n} as const;\n\n/**\n * Detects if the system uses musl libc (Alpine Linux, etc.)\n * Uses multiple detection strategies for reliability\n */\nexport function isMusl(): boolean {\n  // Only relevant for Linux\n  if (platform() !== 'linux') {\n    return false;\n  }\n\n  // Strategy 1: Check for musl-specific files\n  const muslFiles = [\n    '/lib/ld-musl-x86_64.so.1',\n    '/lib/ld-musl-aarch64.so.1',\n    '/lib/ld-musl-armhf.so.1',\n  ];\n\n  for (const file of muslFiles) {\n    if (existsSync(file)) {\n      return true;\n    }\n  }\n\n  // Strategy 2: Check ldd version output\n  try {\n    const lddVersion = execSync('ldd --version 2>&1', {\n      encoding: 'utf-8',\n      stdio: ['pipe', 'pipe', 'pipe'],\n    });\n\n    if (lddVersion.includes('musl')) {\n      return true;\n    }\n  } catch {\n    // ldd command failed, continue to next strategy\n  }\n\n  // Strategy 3: Check /etc/os-release for Alpine\n  try {\n    if (existsSync('/etc/os-release')) {\n      const osRelease = readFileSync('/etc/os-release', 'utf-8');\n      if (osRelease.includes('Alpine') || osRelease.includes('musl')) {\n        return true;\n      }\n    }\n  } catch {\n    // File read failed, continue to next strategy\n  }\n\n  // Strategy 4: Check process.report.getReport() for musl\n  try {\n    const report = (process as any).report?.getReport?.();\n    if (report?.header?.glibcVersionRuntime === '') {\n      // Empty glibc version often indicates musl\n      return true;\n    }\n  } catch {\n    // Report not available\n  }\n\n  return false;\n}\n\n/**\n * Gets the current platform identifier\n * @throws {Error} If the platform is unsupported\n */\nexport function getCurrentPlatform(): Platform {\n  const platformName = platform();\n  const archName = arch();\n\n  // macOS\n  if (platformName === 'darwin') {\n    if (archName === 'arm64') return 'darwin-arm64';\n    if (archName === 'x64' || archName === 'ia32') return 'darwin-x86_64';\n  }\n\n  // Linux (with musl detection)\n  if (platformName === 'linux') {\n    const muslSuffix = isMusl() ? '-musl' : '';\n\n    if (archName === 'arm64') {\n      return `linux-arm64${muslSuffix}` as Platform;\n    }\n    if (archName === 'x64' || archName === 'ia32') {\n      return `linux-x86_64${muslSuffix}` as Platform;\n    }\n  }\n\n  // Windows\n  if (platformName === 'win32') {\n    if (archName === 'x64' || archName === 'ia32') return 'win32-x86_64';\n  }\n\n  // Unsupported platform\n  throw new Error(\n    `Unsupported platform: ${platformName}-${archName}. ` +\n    `Supported platforms: darwin-arm64, darwin-x86_64, linux-arm64, linux-x86_64, win32-x86_64 ` +\n    `(with glibc or musl support for Linux)`\n  );\n}\n\n/**\n * Gets the package name for the current platform\n */\nexport function getPlatformPackageName(): string {\n  const currentPlatform = getCurrentPlatform();\n  return `@sqliteai/sqlite-vector-${currentPlatform}`;\n}\n\n/**\n * Gets the binary filename for the current platform\n */\nexport function getBinaryName(): string {\n  const platformName = platform();\n  const extension = PLATFORM_EXTENSIONS[platformName];\n\n  if (!extension) {\n    throw new Error(`Unknown platform: ${platformName}`);\n  }\n\n  return `vector${extension}`;\n}\n","import { resolve } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport {\n  getCurrentPlatform,\n  getPlatformPackageName,\n  getBinaryName,\n  type Platform\n} from './platform.js';\n\n/**\n * Error thrown when the SQLite Vector extension cannot be found\n */\nexport class ExtensionNotFoundError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ExtensionNotFoundError';\n  }\n}\n\n/**\n * Attempts to load the platform-specific package\n * @returns The path to the extension binary, or null if not found\n */\nfunction tryLoadPlatformPackage(): string | null {\n  try {\n    const packageName = getPlatformPackageName();\n\n    // Try to dynamically import the platform package\n    // This works in both CommonJS and ESM\n    const platformPackage = require(packageName);\n\n    if (platformPackage?.path && typeof platformPackage.path === 'string') {\n      if (existsSync(platformPackage.path)) {\n        return platformPackage.path;\n      }\n    }\n  } catch (error) {\n    // Platform package not installed or failed to load\n    // This is expected when optionalDependencies fail\n  }\n\n  return null;\n}\n\n/**\n * Gets the absolute path to the SQLite Vector extension binary for the current platform\n *\n * @returns Absolute path to the extension binary (.so, .dylib, or .dll)\n * @throws {ExtensionNotFoundError} If the extension binary cannot be found\n *\n * @example\n * ```typescript\n * import { getExtensionPath } from '@sqliteai/sqlite-vector';\n *\n * const extensionPath = getExtensionPath();\n * // On macOS ARM64: /path/to/node_modules/@sqliteai/sqlite-vector-darwin-arm64/vector.dylib\n * ```\n */\nexport function getExtensionPath(): string {\n  // Try to load from platform-specific package\n  const platformPath = tryLoadPlatformPackage();\n  if (platformPath) {\n    return resolve(platformPath);\n  }\n\n  // If we reach here, the platform package wasn't installed\n  const currentPlatform = getCurrentPlatform();\n  const packageName = getPlatformPackageName();\n\n  throw new ExtensionNotFoundError(\n    `SQLite Vector extension not found for platform: ${currentPlatform}\\n\\n` +\n    `The platform-specific package \"${packageName}\" is not installed.\\n` +\n    `This usually happens when:\\n` +\n    `  1. Your platform is not supported\\n` +\n    `  2. npm failed to install optional dependencies\\n` +\n    `  3. You're installing with --no-optional flag\\n\\n` +\n    `Try running: npm install --force`\n  );\n}\n\n/**\n * Information about the current platform and extension\n */\nexport interface ExtensionInfo {\n  /** Current platform identifier (e.g., 'darwin-arm64') */\n  platform: Platform;\n  /** Name of the platform-specific npm package */\n  packageName: string;\n  /** Filename of the binary (e.g., 'vector.dylib') */\n  binaryName: string;\n  /** Full path to the extension binary */\n  path: string;\n}\n\n/**\n * Gets detailed information about the SQLite Vector extension\n *\n * @returns Extension information object\n *\n * @example\n * ```typescript\n * import { getExtensionInfo } from '@sqliteai/sqlite-vector';\n *\n * const info = getExtensionInfo();\n * console.log(info);\n * // {\n * //   platform: 'darwin-arm64',\n * //   packageName: '@sqliteai/sqlite-vector-darwin-arm64',\n * //   binaryName: 'vector.dylib',\n * //   path: '/path/to/vector.dylib'\n * // }\n * ```\n */\nexport function getExtensionInfo(): ExtensionInfo {\n  return {\n    platform: getCurrentPlatform(),\n    packageName: getPlatformPackageName(),\n    binaryName: getBinaryName(),\n    path: getExtensionPath(),\n  };\n}\n\n// Default export for CommonJS compatibility\nexport default {\n  getExtensionPath,\n  getExtensionInfo,\n  ExtensionNotFoundError,\n};\n\n// Re-export platform utilities\nexport { getCurrentPlatform, getPlatformPackageName, getBinaryName, isMusl } from './platform.js';\nexport type { Platform } from './platform.js';\n"]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@sqliteai/sqlite-vector",
+  "version": "0.9.45",
+  "description": "SQLite vector search extension for Node.js - Cross-platform vector embeddings and similarity search",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "generate-platforms": "node generate-platform-packages.js"
+  },
+  "keywords": [
+    "sqlite",
+    "vector",
+    "embedding",
+    "ai",
+    "machine-learning",
+    "similarity-search",
+    "semantic-search",
+    "vector-database",
+    "sqlite-extension"
+  ],
+  "author": "Gioele Cantoni (gioele@sqlitecloud.io)",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sqliteai/sqlite-vector.git",
+    "directory": "packages/node"
+  },
+  "homepage": "https://github.com/sqliteai/sqlite-vector#readme",
+  "bugs": {
+    "url": "https://github.com/sqliteai/sqlite-vector/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "optionalDependencies": {
+    "@sqliteai/sqlite-vector-darwin-arm64": "0.9.45",
+    "@sqliteai/sqlite-vector-darwin-x86_64": "0.9.45",
+    "@sqliteai/sqlite-vector-linux-arm64": "0.9.45",
+    "@sqliteai/sqlite-vector-linux-arm64-musl": "0.9.45",
+    "@sqliteai/sqlite-vector-linux-x86_64": "0.9.45",
+    "@sqliteai/sqlite-vector-linux-x86_64-musl": "0.9.45",
+    "@sqliteai/sqlite-vector-win32-x86_64": "0.9.45"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4"
+  }
+}