@neutron-build/nucleus 0.1.0

package/dist/transport.js

@@ -0,0 +1,477 @@
+// ---------------------------------------------------------------------------
+// Nucleus client — transport implementations
+// ---------------------------------------------------------------------------
+import { NucleusAuthError, NucleusConflictError, NucleusConnectionError, NucleusNotFoundError, NucleusQueryError, NucleusTransactionError, } from './errors.js';
+// ---------------------------------------------------------------------------
+// URL sanitization
+// ---------------------------------------------------------------------------
+function sanitizeUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.username || parsed.password) {
+            parsed.username = '***';
+            parsed.password = '***';
+        }
+        return parsed.toString();
+    }
+    catch {
+        return url.replace(/\/\/[^@]+@/, '//***:***@');
+    }
+}
+async function request(url, body, headers, timeout) {
+    let res;
+    const controller = timeout != null ? new AbortController() : undefined;
+    const timer = controller ? setTimeout(() => controller.abort(), timeout) : undefined;
+    try {
+        res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', ...headers },
+            body: JSON.stringify(body),
+            signal: controller?.signal,
+            keepalive: true,
+        });
+    }
+    catch (err) {
+        throw new NucleusConnectionError('Failed to reach Nucleus server', {
+            cause: err instanceof Error ? err : undefined,
+            meta: { url: sanitizeUrl(url) },
+        });
+    }
+    finally {
+        if (timer != null)
+            clearTimeout(timer);
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        mapHttpError(res.status, text, url);
+    }
+    return (await res.json());
+}
+function mapHttpError(status, body, url) {
+    const meta = { status, url: sanitizeUrl(url) };
+    switch (status) {
+        case 401:
+        case 403:
+            throw new NucleusAuthError(body || 'Authentication failed', { meta });
+        case 404:
+            throw new NucleusNotFoundError(body || 'Resource not found', { meta });
+        case 409:
+            throw new NucleusConflictError(body || 'Conflict', { meta });
+        default:
+            throw new NucleusQueryError(body || `HTTP ${status}`, { meta });
+    }
+}
+// ---------------------------------------------------------------------------
+// HttpTransport
+// ---------------------------------------------------------------------------
+export class HttpTransport {
+    baseUrl;
+    headers;
+    timeout;
+    constructor(url, headers = {}, timeout) {
+        // Strip trailing slash for consistent URL building
+        this.baseUrl = url.replace(/\/+$/, '');
+        this.headers = headers;
+        this.timeout = timeout;
+        // Warn about insecure connections
+        if (this.baseUrl.startsWith('http://') && typeof process !== 'undefined' && process.env.NODE_ENV === 'production') {
+            console.warn('[neutron-nucleus] WARNING: Using unencrypted HTTP connection. Use HTTPS in production.');
+        }
+    }
+    async query(sql, params = []) {
+        const res = await request(`${this.baseUrl}/api/query`, { sql, params }, this.headers, this.timeout);
+        const rows = (res.data ?? []);
+        return { rows, rowCount: res.rowCount ?? rows.length };
+    }
+    async execute(sql, params = []) {
+        const res = await request(`${this.baseUrl}/api/execute`, { sql, params }, this.headers, this.timeout);
+        return res.affected ?? 0;
+    }
+    async fetchval(sql, params = []) {
+        const result = await this.query(sql, params);
+        if (result.rows.length === 0)
+            return null;
+        const first = result.rows[0];
+        const keys = Object.keys(first);
+        if (keys.length === 0)
+            return null;
+        return first[keys[0]];
+    }
+    async beginTransaction(isolationLevel) {
+        const res = await request(`${this.baseUrl}/api/transaction/begin`, { isolationLevel }, this.headers, this.timeout);
+        const txId = res.data?.txId;
+        if (!txId) {
+            throw new NucleusTransactionError('Server did not return a transaction ID');
+        }
+        return new HttpTransactionTransport(this.baseUrl, this.headers, txId, this.timeout);
+    }
+    async close() {
+        // HTTP is stateless — nothing to close.
+    }
+    async ping() {
+        await request(`${this.baseUrl}/api/query`, { sql: 'SELECT 1', params: [] }, this.headers, this.timeout);
+    }
+}
+// ---------------------------------------------------------------------------
+// HttpTransactionTransport
+// ---------------------------------------------------------------------------
+class HttpTransactionTransport {
+    baseUrl;
+    headers;
+    txId;
+    timeout;
+    finished = false;
+    constructor(baseUrl, headers, txId, timeout) {
+        this.baseUrl = baseUrl;
+        this.headers = { ...headers, 'X-Nucleus-TxId': txId };
+        this.txId = txId;
+        this.timeout = timeout;
+    }
+    assertOpen() {
+        if (this.finished) {
+            throw new NucleusTransactionError('Transaction has already been committed or rolled back');
+        }
+    }
+    async query(sql, params = []) {
+        this.assertOpen();
+        const res = await request(`${this.baseUrl}/api/query`, { sql, params, txId: this.txId }, this.headers, this.timeout);
+        const rows = (res.data ?? []);
+        return { rows, rowCount: res.rowCount ?? rows.length };
+    }
+    async execute(sql, params = []) {
+        this.assertOpen();
+        const res = await request(`${this.baseUrl}/api/execute`, { sql, params, txId: this.txId }, this.headers, this.timeout);
+        return res.affected ?? 0;
+    }
+    async fetchval(sql, params = []) {
+        const result = await this.query(sql, params);
+        if (result.rows.length === 0)
+            return null;
+        const first = result.rows[0];
+        const keys = Object.keys(first);
+        if (keys.length === 0)
+            return null;
+        return first[keys[0]];
+    }
+    async beginTransaction(_isolationLevel) {
+        throw new NucleusTransactionError('Nested transactions are not supported');
+    }
+    async commit() {
+        this.assertOpen();
+        await request(`${this.baseUrl}/api/transaction/commit`, { txId: this.txId }, this.headers, this.timeout);
+        this.finished = true;
+    }
+    async rollback() {
+        this.assertOpen();
+        await request(`${this.baseUrl}/api/transaction/rollback`, { txId: this.txId }, this.headers, this.timeout);
+        this.finished = true;
+    }
+    async close() {
+        if (!this.finished) {
+            await this.rollback();
+        }
+    }
+    async ping() {
+        this.assertOpen();
+        await this.query('SELECT 1');
+    }
+}
+/**
+ * Transport for mobile (React Native) environments.
+ *
+ * Wraps `HttpTransport` and adds:
+ * - Automatic retry with exponential backoff for transient failures
+ * - In-memory cache for SELECT queries
+ * - Offline write queue that flushes when connectivity is restored
+ */
+export class MobileTransport {
+    http;
+    cache;
+    cacheTTL;
+    cacheEnabled;
+    maxRetries;
+    retryDelay;
+    offlineQueueEnabled;
+    maxQueueSize;
+    offlineQueue = [];
+    isOnline;
+    constructor(config) {
+        this.http = new HttpTransport(config.url, config.headers, config.timeout);
+        this.cache = new Map();
+        this.cacheTTL = config.cacheTTL ?? 60_000;
+        this.cacheEnabled = config.cacheEnabled !== false;
+        this.maxRetries = config.maxRetries ?? 3;
+        this.retryDelay = config.retryDelay ?? 1_000;
+        this.offlineQueueEnabled = config.offlineQueueEnabled !== false;
+        this.maxQueueSize = config.maxQueueSize ?? 100;
+        this.isOnline = typeof navigator !== 'undefined' ? navigator.onLine : true;
+        if (typeof window !== 'undefined') {
+            window.addEventListener('online', () => {
+                this.isOnline = true;
+                void this.flushQueue();
+            });
+            window.addEventListener('offline', () => {
+                this.isOnline = false;
+            });
+        }
+    }
+    async query(sql, params = []) {
+        const isRead = sql.trimStart().toUpperCase().startsWith('SELECT');
+        // Check cache for read queries
+        if (isRead && this.cacheEnabled) {
+            const cacheKey = JSON.stringify({ sql, params });
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp < this.cacheTTL) {
+                return cached.data;
+            }
+        }
+        const result = await this.withRetry(() => this.http.query(sql, params));
+        // Cache read results
+        if (isRead && this.cacheEnabled) {
+            const cacheKey = JSON.stringify({ sql, params });
+            this.cache.set(cacheKey, { data: result, timestamp: Date.now() });
+            // Evict oldest entries when cache grows too large
+            if (this.cache.size > 500) {
+                const entries = [...this.cache.entries()].sort((a, b) => a[1].timestamp - b[1].timestamp);
+                for (let i = 0; i < 100; i++)
+                    this.cache.delete(entries[i][0]);
+            }
+        }
+        return result;
+    }
+    async execute(sql, params = []) {
+        if (!this.isOnline && this.offlineQueueEnabled) {
+            return new Promise((resolve, reject) => {
+                if (this.offlineQueue.length >= this.maxQueueSize) {
+                    reject(new NucleusConnectionError('Offline queue full', { meta: { queueSize: this.maxQueueSize } }));
+                    return;
+                }
+                this.offlineQueue.push({ resolve, reject, sql, params });
+            });
+        }
+        return this.withRetry(() => this.http.execute(sql, params));
+    }
+    async fetchval(sql, params = []) {
+        const result = await this.query(sql, params);
+        if (result.rows.length === 0)
+            return null;
+        const first = result.rows[0];
+        const keys = Object.keys(first);
+        if (keys.length === 0)
+            return null;
+        return first[keys[0]];
+    }
+    async beginTransaction(isolationLevel) {
+        // Transactions go through the underlying HTTP transport directly — no caching or queueing
+        return this.withRetry(() => this.http.beginTransaction(isolationLevel));
+    }
+    async close() {
+        this.cache.clear();
+        await this.http.close();
+    }
+    async ping() {
+        await this.withRetry(() => this.http.ping());
+    }
+    // -- Mobile-specific API --------------------------------------------------
+    /** Clear all cached query results, or only those matching `pattern`. */
+    invalidateCache(pattern) {
+        if (!pattern) {
+            this.cache.clear();
+            return;
+        }
+        for (const key of this.cache.keys()) {
+            if (key.includes(pattern))
+                this.cache.delete(key);
+        }
+    }
+    /** Number of operations waiting in the offline queue. */
+    get queueSize() {
+        return this.offlineQueue.length;
+    }
+    // -- Internals ------------------------------------------------------------
+    async withRetry(fn) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                // Don't retry client errors (4xx)
+                const status = err?.meta?.status;
+                if (status != null && status >= 400 && status < 500)
+                    throw err;
+                if (attempt < this.maxRetries) {
+                    await new Promise((r) => setTimeout(r, this.retryDelay * Math.pow(2, attempt)));
+                }
+            }
+        }
+        throw lastError;
+    }
+    async flushQueue() {
+        const queue = this.offlineQueue;
+        this.offlineQueue = [];
+        for (const item of queue) {
+            try {
+                const result = await this.http.execute(item.sql, item.params);
+                item.resolve(result);
+            }
+            catch (err) {
+                item.reject(err);
+            }
+        }
+    }
+}
+/**
+ * Transport for desktop environments where Nucleus is embedded via Tauri.
+ *
+ * Skips HTTP serialization overhead by calling Tauri's IPC `invoke()` directly.
+ * Falls back to the `neutron://` custom protocol when Tauri internals are not
+ * available.
+ */
+export class EmbeddedTransport {
+    invoke;
+    constructor() {
+        // Prefer Tauri's IPC invoke when available
+        if (typeof window !== 'undefined' && window.__TAURI_INTERNALS__) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.invoke = window.__TAURI_INTERNALS__.invoke;
+        }
+        else {
+            // Fallback to neutron:// custom protocol
+            this.invoke = async (cmd, args) => {
+                const res = await fetch(`neutron://localhost/api/${cmd}`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(args),
+                });
+                if (!res.ok) {
+                    const text = await res.text().catch(() => '');
+                    throw new NucleusQueryError(text || `Embedded call failed: ${res.status}`, {
+                        meta: { status: res.status, cmd },
+                    });
+                }
+                return res.json();
+            };
+        }
+    }
+    async query(sql, params = []) {
+        const result = (await this.invoke('nucleus_query', { sql, params }));
+        const rows = (result.rows ?? result.data ?? []);
+        return { rows, rowCount: result.rowCount ?? rows.length };
+    }
+    async execute(sql, params = []) {
+        const result = (await this.invoke('nucleus_execute', { sql, params }));
+        return result.affected ?? result.rowsAffected ?? 0;
+    }
+    async fetchval(sql, params = []) {
+        const result = await this.query(sql, params);
+        if (result.rows.length === 0)
+            return null;
+        const first = result.rows[0];
+        const keys = Object.keys(first);
+        if (keys.length === 0)
+            return null;
+        return first[keys[0]];
+    }
+    async beginTransaction(isolationLevel) {
+        const result = (await this.invoke('nucleus_transaction_begin', {
+            isolationLevel: isolationLevel ?? null,
+        }));
+        const txId = result.txId;
+        if (!txId) {
+            throw new NucleusTransactionError('Embedded Nucleus did not return a transaction ID');
+        }
+        return new EmbeddedTransactionTransport(this.invoke, txId);
+    }
+    async close() {
+        // Embedded — nothing to close from the client side.
+    }
+    async ping() {
+        await this.invoke('nucleus_query', { sql: 'SELECT 1', params: [] });
+    }
+}
+// ---------------------------------------------------------------------------
+// EmbeddedTransactionTransport
+// ---------------------------------------------------------------------------
+class EmbeddedTransactionTransport {
+    invoke;
+    txId;
+    finished = false;
+    constructor(invoke, txId) {
+        this.invoke = invoke;
+        this.txId = txId;
+    }
+    assertOpen() {
+        if (this.finished) {
+            throw new NucleusTransactionError('Transaction has already been committed or rolled back');
+        }
+    }
+    async query(sql, params = []) {
+        this.assertOpen();
+        const result = (await this.invoke('nucleus_query', { sql, params, txId: this.txId }));
+        const rows = (result.rows ?? result.data ?? []);
+        return { rows, rowCount: result.rowCount ?? rows.length };
+    }
+    async execute(sql, params = []) {
+        this.assertOpen();
+        const result = (await this.invoke('nucleus_execute', { sql, params, txId: this.txId }));
+        return result.affected ?? result.rowsAffected ?? 0;
+    }
+    async fetchval(sql, params = []) {
+        const result = await this.query(sql, params);
+        if (result.rows.length === 0)
+            return null;
+        const first = result.rows[0];
+        const keys = Object.keys(first);
+        if (keys.length === 0)
+            return null;
+        return first[keys[0]];
+    }
+    async beginTransaction(_isolationLevel) {
+        throw new NucleusTransactionError('Nested transactions are not supported');
+    }
+    async commit() {
+        this.assertOpen();
+        await this.invoke('nucleus_transaction_commit', { txId: this.txId });
+        this.finished = true;
+    }
+    async rollback() {
+        this.assertOpen();
+        await this.invoke('nucleus_transaction_rollback', { txId: this.txId });
+        this.finished = true;
+    }
+    async close() {
+        if (!this.finished) {
+            await this.rollback();
+        }
+    }
+    async ping() {
+        this.assertOpen();
+        await this.query('SELECT 1');
+    }
+}
+// ---------------------------------------------------------------------------
+// Auto-detection factory
+// ---------------------------------------------------------------------------
+/**
+ * Create the best transport for the current platform.
+ *
+ * Detection order:
+ * 1. Desktop with Tauri internals -> `EmbeddedTransport` (IPC, zero serialization overhead)
+ * 2. React Native -> `MobileTransport` (retries, caching, offline queue)
+ * 3. Everything else -> `HttpTransport` (standard fetch)
+ */
+export function createTransport(config) {
+    // Desktop with Tauri — use embedded transport (skips HTTP entirely)
+    if (typeof window !== 'undefined' && window.__TAURI_INTERNALS__) {
+        return new EmbeddedTransport();
+    }
+    // React Native — use mobile transport with retries, caching, and offline queue
+    if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+        return new MobileTransport(config);
+    }
+    // Web / Node / everything else — standard HTTP
+    return new HttpTransport(config.url, config.headers, config.timeout);
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+/** Transport interface for communicating with a Nucleus / PostgreSQL server. */
+export interface Transport {
+    /** Execute a SQL query and return typed rows. */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /** Execute a SQL statement (INSERT / UPDATE / DELETE) and return the affected row count. */
+    execute(sql: string, params?: unknown[]): Promise<number>;
+    /** Execute a query and return the first column of the first row, or null. */
+    fetchval<T = unknown>(sql: string, params?: unknown[]): Promise<T | null>;
+    /** Begin a transaction, returning a transport scoped to that transaction. */
+    beginTransaction(isolationLevel?: IsolationLevel): Promise<TransactionTransport>;
+    /** Close the transport and release resources. */
+    close(): Promise<void>;
+    /** Verify the server is reachable. */
+    ping(): Promise<void>;
+}
+/** A transport that lives inside a transaction and can commit / rollback. */
+export interface TransactionTransport extends Transport {
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+}
+/** Rows returned from a query. */
+export interface QueryResult<T> {
+    rows: T[];
+    rowCount: number;
+}
+/** SQL transaction isolation levels. */
+export type IsolationLevel = 'read_committed' | 'repeatable_read' | 'serializable';
+/** Feature flags detected from the connected database on connect. */
+export interface NucleusFeatures {
+    isNucleus: boolean;
+    hasKV: boolean;
+    hasVector: boolean;
+    hasTimeSeries: boolean;
+    hasDocument: boolean;
+    hasGraph: boolean;
+    hasFTS: boolean;
+    hasGeo: boolean;
+    hasBlob: boolean;
+    hasStreams: boolean;
+    hasColumnar: boolean;
+    hasDatalog: boolean;
+    hasCDC: boolean;
+    hasPubSub: boolean;
+    version: string;
+}
+/**
+ * Plugin interface for the `.use()` composition pattern.
+ *
+ * `T` is the shape that gets merged into the client when the plugin is used.
+ * For example `NucleusPlugin<{ sql: SQLModel }>` adds a `sql` property.
+ */
+export interface NucleusPlugin<T> {
+    /** Human-readable plugin name (used for diagnostics). */
+    name: string;
+    /** Called once when `.connect()` resolves. Must return the object to merge. */
+    init(transport: Transport, features: NucleusFeatures): T;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7F,4FAA4F;IAC5F,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1D,6EAA6E;IAC7E,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE1E,6EAA6E;IAC7E,gBAAgB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjF,iDAAiD;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,sCAAsC;IACtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAEnF,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,CAAC,CAAC;CAC1D"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Nucleus client — shared types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E"}

package/dist/vector/index.d.ts

@@ -0,0 +1,34 @@
+import type { NucleusPlugin } from '../types.js';
+export type DistanceMetric = 'cosine' | 'l2' | 'inner';
+export interface VectorSearchResult<T = Record<string, unknown>> {
+    item: T;
+    score: number;
+    distance: number;
+}
+export interface VectorSearchOptions {
+    /** Maximum number of results (default 10). */
+    limit?: number;
+    /** Distance metric (default `'cosine'`). */
+    metric?: DistanceMetric;
+    /** Metadata key/value filters. */
+    filter?: Record<string, unknown>;
+}
+export interface VectorModel {
+    /** Create a collection (table) with a VECTOR column and index. */
+    createCollection(name: string, dimension: number, metric?: DistanceMetric): Promise<void>;
+    /** Insert a vector with metadata into a collection. */
+    insert(collection: string, id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    /** Delete a vector by ID from a collection. */
+    delete(collection: string, id: string): Promise<void>;
+    /** Perform a vector similarity search. */
+    search(collection: string, query: number[], opts?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    /** Return the dimensionality of a vector. */
+    dims(vector: number[]): Promise<number>;
+    /** Compute the distance between two vectors. */
+    distance(a: number[], b: number[], metric?: DistanceMetric): Promise<number>;
+}
+/** Plugin: adds `.vector` to the client. */
+export declare const withVector: NucleusPlugin<{
+    vector: VectorModel;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/vector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,aAAa,EAAmB,MAAM,aAAa,CAAC;AAO7E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1F,uDAAuD;IACvD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5G,+CAA+C;IAC/C,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,0CAA0C;IAC1C,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEvG,6CAA6C;IAC7C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC,gDAAgD;IAChD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9E;AAkID,4CAA4C;AAC5C,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAK7D,CAAC"}