@anvailabs/proximadb-client 0.3.0

package/dist/collection.js.map

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

package/dist/esm/client.js

@@ -0,0 +1,674 @@
+/**
+ * ProximaDB TypeScript SDK - Client
+ *
+ * Main entry point for connecting to ProximaDB servers.
+ *
+ * Copyright 2025 ProximaDB Contributors
+ * Licensed under the Apache License, Version 2.0
+ */
+import { ProximaDBError, ErrorCode, } from "./types";
+import { CollectionBuilder, CollectionHandle } from "./collection";
+import { GraphBuilder, GraphHandle } from "./graph";
+import { createTransport } from "./transport";
+/**
+ * Default client configuration
+ */
+const DEFAULT_CONFIG = {
+    url: "http://localhost:5678",
+    timeoutMs: 30000,
+    maxRetries: 3,
+    apiKey: "",
+    poolConnections: true,
+    maxIdleConnections: 10,
+};
+/**
+ * Get the global fetch function
+ */
+function getFetch() {
+    if (typeof globalThis.fetch === "function") {
+        return globalThis.fetch.bind(globalThis);
+    }
+    throw new Error("No fetch implementation available. " +
+        "Node.js 18+ includes fetch natively. " +
+        "For older versions, install node-fetch.");
+}
+/**
+ * ProximaDB client for connecting to a remote server
+ */
+export class ProximaDBClient {
+    config;
+    fetchFn;
+    /**
+     * Generated typed REST transport (TD-126 Phase 4). Core collection / record
+     * / search operations route through this; it owns URL/path/query/body
+     * encoding per the OpenAPI spec. Auth, retries, and error mapping are
+     * injected via the facade's own fetch (see `transportFetch`).
+     */
+    gen;
+    /**
+     * Create a new client with the given URL
+     */
+    static connect(url) {
+        return new ProximaDBClient({ url });
+    }
+    /**
+     * Create a new client builder
+     */
+    static builder() {
+        return new ClientBuilder();
+    }
+    /**
+     * Create a client with configuration
+     */
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.fetchFn = getFetch();
+        // Validate URL
+        try {
+            new URL(this.config.url);
+        }
+        catch {
+            throw new ProximaDBError("Invalid URL: " + this.config.url, ErrorCode.InvalidConfig);
+        }
+        // Wire the generated typed transport. Every request the generated client
+        // issues is funneled through `transportFetch`, the facade's own fetch that
+        // applies bearer auth, retries, and error mapping — exactly as the legacy
+        // generic `request<T>` path does.
+        this.gen = createTransport(this.config.url, (req) => this.transportFetch(req));
+    }
+    /**
+     * Transport `fetch` handed to the generated client.
+     *
+     * The generated client assembles a resolved `Request` (URL + method + body);
+     * this normalizes it back to the facade's `(url, init)` retry/auth/error
+     * pipeline so the wire plumbing and transport policy compose. The returned
+     * value is a `Response`-shaped object the generated client parses; on an
+     * unsuccessful response a `ProximaDBError` is thrown (matching the generic
+     * path), so callers never see a non-2xx body.
+     */
+    async transportFetch(req) {
+        const method = (req.method || "GET").toUpperCase();
+        let body = undefined;
+        if (method !== "GET" && method !== "DELETE") {
+            const text = await req.clone().text();
+            if (text.length > 0) {
+                body = JSON.parse(text);
+            }
+        }
+        const data = await this.request(method, req.url, body);
+        // Re-wrap the already-parsed, validated body as a Response so the
+        // generated client can read `.json()`/`.ok` without re-issuing I/O.
+        return new Response(JSON.stringify(data ?? null), {
+            status: 200,
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    /**
+     * Get the server URL
+     */
+    url() {
+        return this.config.url;
+    }
+    /**
+     * Get the client configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    // =========================================================================
+    // HTTP Methods
+    // =========================================================================
+    /**
+     * Make a GET request
+     */
+    async get(requestUrl) {
+        return this.request("GET", requestUrl);
+    }
+    /**
+     * Make a POST request
+     */
+    async post(requestUrl, body) {
+        return this.request("POST", requestUrl, body);
+    }
+    /**
+     * Make a PUT request
+     */
+    async put(requestUrl, body) {
+        return this.request("PUT", requestUrl, body);
+    }
+    /**
+     * Make a DELETE request
+     */
+    async delete(requestUrl) {
+        return this.request("DELETE", requestUrl);
+    }
+    /**
+     * Make an HTTP request with retry logic
+     */
+    async request(method, requestUrl, body) {
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (this.config.apiKey) {
+            headers["Authorization"] = "Bearer " + this.config.apiKey;
+        }
+        const buildInit = (signal) => {
+            const init = {
+                method,
+                headers,
+                signal,
+            };
+            if (body !== undefined) {
+                init.body = JSON.stringify(body);
+            }
+            return init;
+        };
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+            try {
+                const response = await this.fetchFn(requestUrl, buildInit(controller.signal));
+                return await this.handleResponse(response);
+            }
+            catch (e) {
+                lastError = e instanceof Error ? e : new Error(String(e));
+                // Don't retry on client errors (4xx)
+                if (lastError instanceof ProximaDBError) {
+                    if (lastError.statusCode && lastError.statusCode >= 400 && lastError.statusCode < 500) {
+                        throw lastError;
+                    }
+                }
+                // Wait before retry with exponential backoff
+                if (attempt < this.config.maxRetries) {
+                    const delay = Math.min(1000 * Math.pow(2, attempt), 10000);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        throw lastError ?? new Error("Request failed after retries");
+    }
+    /**
+     * Handle HTTP response
+     */
+    async handleResponse(response) {
+        if (response.ok) {
+            try {
+                return (await response.json());
+            }
+            catch {
+                throw new ProximaDBError("Failed to parse response JSON", ErrorCode.ServerError, response.status);
+            }
+        }
+        const statusCode = response.status;
+        let message = response.statusText;
+        try {
+            message = await response.text();
+        }
+        catch {
+            // Use statusText if text() fails
+        }
+        switch (statusCode) {
+            case 401:
+                throw new ProximaDBError(message, ErrorCode.AuthenticationFailed, statusCode);
+            case 403:
+                throw new ProximaDBError(message, ErrorCode.AuthorizationDenied, statusCode);
+            case 404:
+                throw new ProximaDBError(message, ErrorCode.CollectionNotFound, statusCode);
+            case 409:
+                throw new ProximaDBError(message, ErrorCode.CollectionExists, statusCode);
+            case 429:
+                throw new ProximaDBError(message, ErrorCode.RateLimited, statusCode);
+            default:
+                throw new ProximaDBError(message, ErrorCode.ServerError, statusCode);
+        }
+    }
+    // =========================================================================
+    // Collection Operations
+    // =========================================================================
+    /**
+     * Get a handle to a collection for fluent operations
+     */
+    collection(name) {
+        return new CollectionHandle(this, name);
+    }
+    /**
+     * Create a collection builder
+     */
+    createCollection(name) {
+        return new CollectionBuilder(this, name);
+    }
+    /**
+     * Delete a collection
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: DELETE /api/v2/collections/{collection_id}
+     * OpenAPI operationId: deleteCollection
+     */
+    async deleteCollection(name) {
+        await this.gen.DELETE("/api/v2/collections/{collection_id}", {
+            params: { path: { collection_id: name } },
+        });
+    }
+    /**
+     * List all collections
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: GET /api/v2/collections
+     * OpenAPI operationId: listCollections
+     */
+    async listCollections() {
+        const { data } = await this.gen.GET("/api/v2/collections", {});
+        return (data?.collections ?? []);
+    }
+    /**
+     * Get the schema for a collection
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: GET /api/v2/collections/{collection_id}/schema
+     * OpenAPI operationId: getCollectionSchema
+     */
+    async getCollectionSchema(collectionId) {
+        const { data } = await this.gen.GET("/api/v2/collections/{collection_id}/schema", { params: { path: { collection_id: collectionId } } });
+        return data;
+    }
+    /**
+     * Update the schema for a collection
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: PUT /api/v2/collections/{collection_id}/schema
+     * OpenAPI operationId: updateCollectionSchema
+     */
+    async updateCollectionSchema(collectionId, schema) {
+        const { data } = await this.gen.PUT("/api/v2/collections/{collection_id}/schema", {
+            params: { path: { collection_id: collectionId } },
+            body: schema,
+        });
+        return data;
+    }
+    // =========================================================================
+    // Query Facade (AQL / UQL)
+    // =========================================================================
+    /**
+     * Execute an AQL or UQL query through the shared query facade
+     *
+     * Wire endpoint: POST /api/v2/query
+     * OpenAPI operationId: executeQuery
+     */
+    async executeQuery(req) {
+        const { data } = await this.gen.POST("/api/v2/query", {
+            body: req,
+        });
+        return data;
+    }
+    /**
+     * Explain an AQL or UQL query through the shared query facade
+     *
+     * Wire endpoint: POST /api/v2/query/explain
+     * OpenAPI operationId: explainQuery
+     */
+    async explainQuery(req) {
+        const { data } = await this.gen.POST("/api/v2/query/explain", {
+            body: req,
+        });
+        return data;
+    }
+    // =========================================================================
+    // Typed transport for core collection / record / search ops (TD-126 Phase 4)
+    //
+    // These route the builders' wire calls through the generated typed client.
+    // The builders (collection.ts / search.ts) call these instead of hand-building
+    // URL strings, so the core CRUD + search paths are spec-generated end to end.
+    // =========================================================================
+    /**
+     * Create a collection.
+     * Wire endpoint: POST /api/v2/collections (createCollection)
+     */
+    async createCollectionRequest(body) {
+        const { data } = await this.gen.POST("/api/v2/collections", {
+            body: body,
+        });
+        return data;
+    }
+    /**
+     * Get collection details.
+     * Wire endpoint: GET /api/v2/collections/{collection_id} (getCollection)
+     */
+    async getCollectionRequest(collectionId) {
+        const { data } = await this.gen.GET("/api/v2/collections/{collection_id}", {
+            params: { path: { collection_id: collectionId } },
+        });
+        return data;
+    }
+    /**
+     * Insert / upsert records in a batch.
+     * Wire endpoint: POST /api/v2/collections/{collection_id}/records/batch (insertRecords)
+     */
+    async insertRecordsRequest(collectionId, body) {
+        const { data } = await this.gen.POST("/api/v2/collections/{collection_id}/records/batch", {
+            params: { path: { collection_id: collectionId } },
+            body: body,
+        });
+        return data;
+    }
+    /**
+     * Get a single record by ID.
+     * Wire endpoint: GET /api/v2/collections/{collection_id}/records/{record_id} (getRecord)
+     */
+    async getRecordRequest(collectionId, recordId, includeVector, includeText) {
+        const { data } = await this.gen.GET("/api/v2/collections/{collection_id}/records/{record_id}", {
+            params: {
+                path: { collection_id: collectionId, record_id: recordId },
+                query: { include_vector: includeVector, include_text: includeText },
+            },
+        });
+        return data;
+    }
+    /**
+     * Delete a single record by ID.
+     * Wire endpoint: DELETE /api/v2/collections/{collection_id}/records/{record_id} (deleteRecord)
+     */
+    async deleteRecordRequest(collectionId, recordId) {
+        await this.gen.DELETE("/api/v2/collections/{collection_id}/records/{record_id}", {
+            params: { path: { collection_id: collectionId, record_id: recordId } },
+        });
+    }
+    /**
+     * Vector similarity search.
+     * Wire endpoint: POST /api/v2/collections/{collection_id}/search (searchRecords)
+     */
+    async searchRecordsRequest(collectionId, body) {
+        const { data } = await this.gen.POST("/api/v2/collections/{collection_id}/search", {
+            params: { path: { collection_id: collectionId } },
+            body: body,
+        });
+        return data;
+    }
+    // =========================================================================
+    // Graph Operations
+    // =========================================================================
+    /**
+     * Get a handle to a graph for fluent operations
+     */
+    graph(name) {
+        return new GraphHandle(this, name);
+    }
+    /**
+     * Create a graph builder.
+     *
+     * Wire endpoint: POST /api/v2/graphs
+     * OpenAPI operationId: createGraph
+     *
+     * The argument is the server-true `graph_id` (unique identifier). Use
+     * `.name(...)` on the returned builder to set the optional display name.
+     */
+    createGraph(graphId) {
+        return new GraphBuilder(this, graphId);
+    }
+    /**
+     * Delete a graph
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: DELETE /api/v2/graphs/{graph_id}
+     * OpenAPI operationId: deleteGraph
+     */
+    async deleteGraph(name) {
+        await this.gen.DELETE("/api/v2/graphs/{graph_id}", {
+            params: { path: { graph_id: name } },
+        });
+    }
+    /**
+     * List all graphs
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: GET /api/v2/graphs
+     * OpenAPI operationId: listGraphs
+     */
+    async listGraphs() {
+        const { data } = await this.gen.GET("/api/v2/graphs", {});
+        return (data?.graphs ?? []);
+    }
+    // =========================================================================
+    // Typed transport for graph ops (TD-126 Phase 4)
+    //
+    // Seam methods routing the graph builders' / handle's wire calls through the
+    // generated typed client, mirroring the core collection / record / search
+    // seams above. The public graph API (graph.ts builders + handle) is
+    // unchanged; only the wire dispatch moves off hand-built URL strings.
+    // =========================================================================
+    /**
+     * Create a graph collection.
+     * Wire endpoint: POST /api/v2/graphs (createGraph)
+     */
+    async createGraphRequest(body) {
+        const { data } = await this.gen.POST("/api/v2/graphs", {
+            body: body,
+        });
+        return data;
+    }
+    /**
+     * Get a graph collection by id.
+     * Wire endpoint: GET /api/v2/graphs/{graph_id} (getGraph)
+     */
+    async getGraphRequest(graphId) {
+        const { data } = await this.gen.GET("/api/v2/graphs/{graph_id}", {
+            params: { path: { graph_id: graphId } },
+        });
+        return data;
+    }
+    /**
+     * Get graph statistics.
+     * Wire endpoint: GET /api/v2/graphs/{graph_id}/stats (getGraphStats)
+     */
+    async getGraphStatsRequest(graphId) {
+        const { data } = await this.gen.GET("/api/v2/graphs/{graph_id}/stats", {
+            params: { path: { graph_id: graphId } },
+        });
+        return data;
+    }
+    /**
+     * Create a node in a graph.
+     * Wire endpoint: POST /api/v2/graphs/{graph_id}/nodes (createNode)
+     */
+    async createNodeRequest(graphId, body) {
+        const { data } = await this.gen.POST("/api/v2/graphs/{graph_id}/nodes", {
+            params: { path: { graph_id: graphId } },
+            body: body,
+        });
+        return data;
+    }
+    /**
+     * Create multiple nodes in a single call.
+     * Wire endpoint: POST /api/v2/graphs/{graph_id}/nodes/batch (batchCreateNodes)
+     */
+    async batchCreateNodesRequest(graphId, body) {
+        const { data } = await this.gen.POST("/api/v2/graphs/{graph_id}/nodes/batch", {
+            params: { path: { graph_id: graphId } },
+            body: body,
+        });
+        return data;
+    }
+    /**
+     * Get a node by id.
+     * Wire endpoint: GET /api/v2/graphs/{graph_id}/nodes/{node_id} (getNode)
+     */
+    async getNodeRequest(graphId, nodeId) {
+        const { data } = await this.gen.GET("/api/v2/graphs/{graph_id}/nodes/{node_id}", {
+            params: { path: { graph_id: graphId, node_id: nodeId } },
+        });
+        return data;
+    }
+    /**
+     * Delete a node by id.
+     * Wire endpoint: DELETE /api/v2/graphs/{graph_id}/nodes/{node_id} (deleteNode)
+     */
+    async deleteNodeRequest(graphId, nodeId) {
+        await this.gen.DELETE("/api/v2/graphs/{graph_id}/nodes/{node_id}", {
+            params: { path: { graph_id: graphId, node_id: nodeId } },
+        });
+    }
+    /**
+     * Create an edge in a graph.
+     * Wire endpoint: POST /api/v2/graphs/{graph_id}/edges (createEdge)
+     */
+    async createEdgeRequest(graphId, body) {
+        const { data } = await this.gen.POST("/api/v2/graphs/{graph_id}/edges", {
+            params: { path: { graph_id: graphId } },
+            body: body,
+        });
+        return data;
+    }
+    /**
+     * Create multiple edges in a single call.
+     * Wire endpoint: POST /api/v2/graphs/{graph_id}/edges/batch (batchCreateEdges)
+     */
+    async batchCreateEdgesRequest(graphId, body) {
+        const { data } = await this.gen.POST("/api/v2/graphs/{graph_id}/edges/batch", {
+            params: { path: { graph_id: graphId } },
+            body: body,
+        });
+        return data;
+    }
+    /**
+     * Traverse a graph from a start node.
+     * Wire endpoint: POST /api/v2/graphs/{graph_id}/traverse (traverseGraph)
+     */
+    async traverseGraphRequest(graphId, body) {
+        const { data } = await this.gen.POST("/api/v2/graphs/{graph_id}/traverse", {
+            params: { path: { graph_id: graphId } },
+            body: body,
+        });
+        return data;
+    }
+    // =========================================================================
+    // Health and Monitoring
+    // =========================================================================
+    /**
+     * Check if the server is healthy
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: GET /health
+     * OpenAPI operationId: getHealth
+     */
+    async health() {
+        const { data } = await this.gen.GET("/health", {});
+        return data;
+    }
+    /**
+     * Kubernetes-style liveness probe
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: GET /health/live
+     * OpenAPI operationId: getLiveness
+     */
+    async healthLive() {
+        const { data } = await this.gen.GET("/health/live", {});
+        return data;
+    }
+    /**
+     * Kubernetes-style readiness probe
+     *
+     * Routed through the generated typed transport (TD-126 Phase 4).
+     * Wire endpoint: GET /health/ready
+     * OpenAPI operationId: getReadiness
+     */
+    async healthReady() {
+        const { data } = await this.gen.GET("/health/ready", {});
+        return data;
+    }
+    /**
+     * Check if the server is reachable
+     */
+    async ping() {
+        try {
+            await this.health();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ============================================================================
+// CLIENT BUILDER
+// ============================================================================
+/**
+ * Builder for creating a ProximaDB client with custom configuration
+ */
+export class ClientBuilder {
+    config = {};
+    /**
+     * Set the server URL
+     */
+    url(serverUrl) {
+        this.config.url = serverUrl;
+        return this;
+    }
+    /**
+     * Set the request timeout in milliseconds
+     */
+    timeoutMs(timeout) {
+        this.config.timeoutMs = timeout;
+        return this;
+    }
+    /**
+     * Set the maximum number of retries
+     */
+    maxRetries(retries) {
+        this.config.maxRetries = retries;
+        return this;
+    }
+    /**
+     * Set the API key for authentication
+     */
+    apiKey(key) {
+        this.config.apiKey = key;
+        return this;
+    }
+    /**
+     * Enable or disable connection pooling
+     */
+    poolConnections(enable) {
+        this.config.poolConnections = enable;
+        return this;
+    }
+    /**
+     * Set maximum idle connections in pool
+     */
+    maxIdleConnections(max) {
+        this.config.maxIdleConnections = max;
+        return this;
+    }
+    /**
+     * Build the ProximaDB client
+     */
+    build() {
+        return new ProximaDBClient(this.config);
+    }
+    /**
+     * Connect to the server (alias for build)
+     */
+    connect() {
+        return this.build();
+    }
+}
+// ============================================================================
+// CONVENIENCE FUNCTIONS
+// ============================================================================
+/**
+ * Create a ProximaDB client connected to the given URL
+ */
+export function connect(url = "http://localhost:5678") {
+    return ProximaDBClient.connect(url);
+}
+/**
+ * Create a ProximaDB client with REST protocol
+ */
+export function connectRest(url = "http://localhost:5678") {
+    return ProximaDBClient.connect(url);
+}
+//# sourceMappingURL=client.js.map