ydb-qdrant 2.1.0 → 2.1.3

package/README.md

@@ -1,15 +1,23 @@
-<img src="./logo.svg" alt="YDB Qdrant logo" height="56"> 
+<img src="https://ydb-qdrant.tech/logo.svg" alt="YDB Qdrant logo" height="56"> 
 
-# YDB Qdrant-compatible Service (Node.js)
+[![CI](https://github.com/astandrik/ydb-qdrant/actions/workflows/ci-ydb-qdrant.yml/badge.svg)](https://github.com/astandrik/ydb-qdrant/actions/workflows/ci-ydb-qdrant.yml)
+[![npm version](https://img.shields.io/npm/v/ydb-qdrant.svg)](https://www.npmjs.com/package/ydb-qdrant)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
 
-Qdrant-compatible Node.js/TypeScript service exposing a minimal REST API that stores and searches vectors in YDB using single‑phase top‑k with an automatic YDB vector index (`vector_kmeans_tree`) and table‑scan fallback. Topics: ydb, vector-search, qdrant-compatible, nodejs, typescript, express, yql, ann, semantic-search, rag.
+# YDB Qdrant-compatible Service
+
+Qdrant-compatible Node.js/TypeScript **service and npm library** that stores and searches vectors in YDB using single‑phase top‑k with an automatic YDB vector index (`vector_kmeans_tree`) and table‑scan fallback. Topics: ydb, vector-search, qdrant-compatible, nodejs, typescript, express, yql, ann, semantic-search, rag.
+
+Modes:
+- **HTTP server**: Qdrant-compatible REST API (`/collections`, `/points/*`) on top of YDB.
+- **Node.js package**: programmatic client via `createYdbQdrantClient` for direct YDB-backed vector search without running a separate service.
 
 Promo site: [ydb-qdrant.tech](http://ydb-qdrant.tech)  
 Architecture diagrams: [docs page](http://ydb-qdrant.tech/docs/)
 
 ## How it works
 
-![Architecture diagram](./diagram.svg)
+![Architecture diagram](https://ydb-qdrant.tech/assets/diagram.svg)
 
 ## Requirements
 - Node.js 18+

package/dist/SmokeTest.js

@@ -1,5 +1,5 @@
 import "dotenv/config";
-import { createYdbQdrantClient } from "./Api.js";
+import { createYdbQdrantClient } from "./package/Api.js";
 async function main() {
     const tenant = process.env.SMOKE_TENANT ?? "smoke";
     const collection = process.env.SMOKE_COLLECTION ?? "demo";
@@ -30,11 +30,9 @@ async function main() {
         top: 2,
         with_payload: true,
     });
-    // eslint-disable-next-line no-console
     console.log(JSON.stringify(result, null, 2));
 }
 void main().catch((err) => {
-    // eslint-disable-next-line no-console
     console.error(err);
     process.exitCode = 1;
 });

package/dist/index.js

@@ -4,7 +4,6 @@ import { PORT } from "./config/env.js";
 import { logger } from "./logging/logger.js";
 import { readyOrThrow } from "./ydb/client.js";
 import { ensureMetaTable } from "./ydb/schema.js";
-let server;
 async function start() {
     try {
         await readyOrThrow();
@@ -14,7 +13,7 @@ async function start() {
         logger.error({ err }, "YDB not ready; startup continues, requests may fail until configured.");
     }
     const app = buildServer();
-    server = app.listen(PORT, () => {
+    app.listen(PORT, () => {
         logger.info({ port: PORT }, "ydb-qdrant proxy listening");
     });
 }

package/dist/{Api.d.ts → package/Api.d.ts}

@@ -1,6 +1,7 @@
-import { createCollection as serviceCreateCollection, deleteCollection as serviceDeleteCollection, getCollection as serviceGetCollection, putCollectionIndex as servicePutCollectionIndex, upsertPoints as serviceUpsertPoints, searchPoints as serviceSearchPoints, deletePoints as serviceDeletePoints } from "./services/QdrantService.js";
-export { QdrantServiceError } from "./services/QdrantService.js";
-export { CreateCollectionReq, UpsertPointsReq, SearchReq, DeletePointsReq, } from "./types.js";
+import type { IAuthService } from "ydb-sdk";
+import { createCollection as serviceCreateCollection, deleteCollection as serviceDeleteCollection, getCollection as serviceGetCollection, putCollectionIndex as servicePutCollectionIndex, upsertPoints as serviceUpsertPoints, searchPoints as serviceSearchPoints, deletePoints as serviceDeletePoints } from "../services/QdrantService.js";
+export { QdrantServiceError } from "../services/QdrantService.js";
+export { CreateCollectionReq, UpsertPointsReq, SearchReq, DeletePointsReq, } from "../types.js";
 type CreateCollectionResult = Awaited<ReturnType<typeof serviceCreateCollection>>;
 type GetCollectionResult = Awaited<ReturnType<typeof serviceGetCollection>>;
 type DeleteCollectionResult = Awaited<ReturnType<typeof serviceDeleteCollection>>;
@@ -10,6 +11,10 @@ type SearchPointsResult = Awaited<ReturnType<typeof serviceSearchPoints>>;
 type DeletePointsResult = Awaited<ReturnType<typeof serviceDeletePoints>>;
 export interface YdbQdrantClientOptions {
     defaultTenant?: string;
+    endpoint?: string;
+    database?: string;
+    connectionString?: string;
+    authService?: IAuthService;
 }
 export interface YdbQdrantTenantClient {
     createCollection(collection: string, body: unknown): Promise<CreateCollectionResult>;

package/dist/{Api.js → package/Api.js}

@@ -1,9 +1,20 @@
-import { readyOrThrow } from "./ydb/client.js";
-import { ensureMetaTable } from "./ydb/schema.js";
-import { createCollection as serviceCreateCollection, deleteCollection as serviceDeleteCollection, getCollection as serviceGetCollection, putCollectionIndex as servicePutCollectionIndex, upsertPoints as serviceUpsertPoints, searchPoints as serviceSearchPoints, deletePoints as serviceDeletePoints, } from "./services/QdrantService.js";
-export { QdrantServiceError } from "./services/QdrantService.js";
-export { CreateCollectionReq, UpsertPointsReq, SearchReq, DeletePointsReq, } from "./types.js";
+import { readyOrThrow, configureDriver } from "../ydb/client.js";
+import { ensureMetaTable } from "../ydb/schema.js";
+import { createCollection as serviceCreateCollection, deleteCollection as serviceDeleteCollection, getCollection as serviceGetCollection, putCollectionIndex as servicePutCollectionIndex, upsertPoints as serviceUpsertPoints, searchPoints as serviceSearchPoints, deletePoints as serviceDeletePoints, } from "../services/QdrantService.js";
+export { QdrantServiceError } from "../services/QdrantService.js";
+export { CreateCollectionReq, UpsertPointsReq, SearchReq, DeletePointsReq, } from "../types.js";
 export async function createYdbQdrantClient(options = {}) {
+    if (options.endpoint !== undefined ||
+        options.database !== undefined ||
+        options.connectionString !== undefined ||
+        options.authService !== undefined) {
+        configureDriver({
+            endpoint: options.endpoint,
+            database: options.database,
+            connectionString: options.connectionString,
+            authService: options.authService,
+        });
+    }
     await readyOrThrow();
     await ensureMetaTable();
     const defaultTenant = options.defaultTenant ?? "default";
@@ -38,7 +49,7 @@ export async function createYdbQdrantClient(options = {}) {
             return await serviceDeletePoints({ tenant, collection }, body);
         },
         forTenant(tenantId) {
-            const tenant = resolveTenant(tenantId);
+            const tenant = tenantId;
             return {
                 createCollection(collection, body) {
                     return serviceCreateCollection({ tenant, collection }, body);

package/dist/repositories/collectionsRepo.js

@@ -72,12 +72,13 @@ export async function buildVectorIndex(tableName, dimension, distance, vectorTyp
     await withSession(async (s) => {
         // Drop existing index if present
         const dropDdl = `ALTER TABLE ${tableName} DROP INDEX emb_idx;`;
+        const rawSession = s;
         try {
-            const dropReq = { sessionId: s.sessionId, yqlText: dropDdl };
-            await s.api.executeSchemeQuery(dropReq);
+            const dropReq = { sessionId: rawSession.sessionId, yqlText: dropDdl };
+            await rawSession.api.executeSchemeQuery(dropReq);
         }
         catch (e) {
-            const msg = String(e?.message ?? e);
+            const msg = e instanceof Error ? e.message : String(e);
             // ignore if index doesn't exist
             if (!/not found|does not exist|no such index/i.test(msg)) {
                 throw e;
@@ -98,8 +99,8 @@ export async function buildVectorIndex(tableName, dimension, distance, vectorTyp
         levels=${levels}
       );
     `;
-        const createReq = { sessionId: s.sessionId, yqlText: createDdl };
-        await s.api.executeSchemeQuery(createReq);
+        const createReq = { sessionId: rawSession.sessionId, yqlText: createDdl };
+        await rawSession.api.executeSchemeQuery(createReq);
     });
 }
 function mapDistanceToIndexParam(distance) {

package/dist/repositories/pointsRepo.js

@@ -1,7 +1,6 @@
 import { TypedValues, withSession } from "../ydb/client.js";
 import { buildJsonOrEmpty, buildVectorParam } from "../ydb/helpers.js";
 import { logger } from "../logging/logger.js";
-import { APPROX_PRESELECT } from "../config/env.js";
 import { notifyUpsert } from "../indexing/IndexScheduler.js";
 export async function upsertPoints(tableName, points, vectorType, dimension) {
     let upserted = 0;
@@ -30,14 +29,13 @@ export async function upsertPoints(tableName, points, vectorType, dimension) {
             // Retry on transient schema/metadata mismatches during index rebuild
             const maxRetries = 6; // ~ up to ~ (0.25 + jitter) * 2^5 ≈ few seconds
             let attempt = 0;
-            // eslint-disable-next-line no-constant-condition
             while (true) {
                 try {
                     await s.executeQuery(ddl, params);
                     break;
                 }
                 catch (e) {
-                    const msg = String(e?.message ?? e);
+                    const msg = e instanceof Error ? e.message : String(e);
                     const isTransient = /Aborted|schema version mismatch|Table metadata loading|Failed to load metadata/i.test(msg);
                     if (!isTransient || attempt >= maxRetries) {
                         throw e;
@@ -63,7 +61,6 @@ export async function searchPoints(tableName, queryVector, top, withPayload, dis
     }
     const { fn, order } = mapDistanceToKnnFn(distance);
     // Single-phase search over embedding using vector index if present
-    const preselect = Math.min(APPROX_PRESELECT, Math.max(top * 10, top));
     const qf = buildVectorParam(queryVector, vectorType);
     const params = {
         $qf: qf,
@@ -87,7 +84,7 @@ export async function searchPoints(tableName, queryVector, top, withPayload, dis
         logger.info({ tableName }, "vector index found; using index for search");
     }
     catch (e) {
-        const msg = String(e?.message ?? e);
+        const msg = e instanceof Error ? e.message : String(e);
         // Fallback to table scan if index not found or not ready
         if (/not found|does not exist|no such index|no global index|is not ready to use/i.test(msg)) {
             logger.info({ tableName }, "vector index not available (missing or building); falling back to table scan");
@@ -103,6 +100,9 @@ export async function searchPoints(tableName, queryVector, top, withPayload, dis
     const rows = (rowset?.rows ?? []);
     return rows.map((row) => {
         const id = row.items?.[0]?.textValue;
+        if (typeof id !== "string") {
+            throw new Error("point_id is missing in YDB search result");
+        }
         let payload;
         let scoreIdx = 1;
         if (withPayload) {
@@ -129,7 +129,10 @@ export async function deletePoints(tableName, ids) {
         DECLARE $id AS Utf8;
         DELETE FROM ${tableName} WHERE point_id = $id;
       `;
-            await s.executeQuery(yql, { $id: TypedValues.utf8(String(id)) });
+            const params = {
+                $id: TypedValues.utf8(String(id)),
+            };
+            await s.executeQuery(yql, params);
             deleted += 1;
         }
     });

package/dist/routes/collections.js

@@ -16,9 +16,8 @@ collectionsRouter.put("/:collection/index", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "build index failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });
 collectionsRouter.put("/:collection", async (req, res) => {
@@ -33,9 +32,8 @@ collectionsRouter.put("/:collection", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "create collection failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });
 collectionsRouter.get("/:collection", async (req, res) => {
@@ -50,9 +48,8 @@ collectionsRouter.get("/:collection", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "get collection failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });
 collectionsRouter.delete("/:collection", async (req, res) => {
@@ -67,8 +64,7 @@ collectionsRouter.delete("/:collection", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "delete collection failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });

package/dist/routes/points.js

@@ -16,9 +16,8 @@ pointsRouter.put("/:collection/points", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "upsert points (PUT) failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });
 pointsRouter.post("/:collection/points/upsert", async (req, res) => {
@@ -34,9 +33,8 @@ pointsRouter.post("/:collection/points/upsert", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "upsert points failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });
 pointsRouter.post("/:collection/points/search", async (req, res) => {
@@ -52,9 +50,8 @@ pointsRouter.post("/:collection/points/search", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "search points failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });
 // Compatibility: some clients call POST /collections/:collection/points/query
@@ -71,9 +68,8 @@ pointsRouter.post("/:collection/points/query", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "search points (query) failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });
 pointsRouter.post("/:collection/points/delete", async (req, res) => {
@@ -89,8 +85,7 @@ pointsRouter.post("/:collection/points/delete", async (req, res) => {
             return res.status(err.statusCode).json(err.payload);
         }
         logger.error({ err }, "delete points failed");
-        res
-            .status(500)
-            .json({ status: "error", error: String(err?.message ?? err) });
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ status: "error", error: errorMessage });
     }
 });

package/dist/services/QdrantService.d.ts

@@ -30,8 +30,7 @@ export declare function getCollection(ctx: CollectionContextInput): Promise<{
 export declare function deleteCollection(ctx: CollectionContextInput): Promise<{
     acknowledged: boolean;
 }>;
-interface PointsContextInput extends CollectionContextInput {
-}
+type PointsContextInput = CollectionContextInput;
 export declare function upsertPoints(ctx: PointsContextInput, body: unknown): Promise<{
     upserted: number;
 }>;

package/dist/services/QdrantService.js

@@ -101,10 +101,10 @@ function extractVectorLoose(body, depth = 0) {
         return obj.embedding;
     const query = obj.query;
     if (query) {
-        const queryVector = query.vector;
+        const queryVector = query["vector"];
         if (isNumberArray(queryVector))
             return queryVector;
-        const nearest = query.nearest;
+        const nearest = query["nearest"];
         if (nearest && isNumberArray(nearest.vector)) {
             return nearest.vector;
         }
@@ -131,39 +131,68 @@ function extractVectorLoose(body, depth = 0) {
     return undefined;
 }
 function normalizeSearchBodyForSearch(body) {
+    if (!body || typeof body !== "object") {
+        return {
+            vector: undefined,
+            top: undefined,
+            withPayload: undefined,
+            scoreThreshold: undefined,
+        };
+    }
     const b = body;
-    const vector = Array.isArray(b?.vector) ? b.vector : undefined;
-    const topFromTop = typeof b?.top === "number" ? b.top : undefined;
-    const topFromLimit = typeof b?.limit === "number" ? b.limit : undefined;
+    const rawVector = b["vector"];
+    const vector = isNumberArray(rawVector) ? rawVector : undefined;
+    const rawTop = b["top"];
+    const rawLimit = b["limit"];
+    const topFromTop = typeof rawTop === "number" ? rawTop : undefined;
+    const topFromLimit = typeof rawLimit === "number" ? rawLimit : undefined;
     const top = topFromTop ?? topFromLimit;
     let withPayload;
-    const rawWithPayload = b?.with_payload;
+    const rawWithPayload = b["with_payload"];
     if (typeof rawWithPayload === "boolean") {
         withPayload = rawWithPayload;
     }
-    else if (Array.isArray(rawWithPayload) || typeof rawWithPayload === "object") {
+    else if (Array.isArray(rawWithPayload) ||
+        typeof rawWithPayload === "object") {
         withPayload = true;
     }
-    const thresholdValue = Number(b?.score_threshold);
-    const scoreThreshold = Number.isFinite(thresholdValue) ? thresholdValue : undefined;
+    const thresholdRaw = b["score_threshold"];
+    const thresholdValue = typeof thresholdRaw === "number" ? thresholdRaw : Number(thresholdRaw);
+    const scoreThreshold = Number.isFinite(thresholdValue)
+        ? thresholdValue
+        : undefined;
     return { vector, top, withPayload, scoreThreshold };
 }
 function normalizeSearchBodyForQuery(body) {
+    if (!body || typeof body !== "object") {
+        return {
+            vector: undefined,
+            top: undefined,
+            withPayload: undefined,
+            scoreThreshold: undefined,
+        };
+    }
     const b = body;
     const vector = extractVectorLoose(b);
-    const topFromTop = typeof b?.top === "number" ? b.top : undefined;
-    const topFromLimit = typeof b?.limit === "number" ? b.limit : undefined;
+    const rawTop = b["top"];
+    const rawLimit = b["limit"];
+    const topFromTop = typeof rawTop === "number" ? rawTop : undefined;
+    const topFromLimit = typeof rawLimit === "number" ? rawLimit : undefined;
     const top = topFromTop ?? topFromLimit;
     let withPayload;
-    const rawWithPayload = b?.with_payload;
+    const rawWithPayload = b["with_payload"];
     if (typeof rawWithPayload === "boolean") {
         withPayload = rawWithPayload;
     }
-    else if (Array.isArray(rawWithPayload) || typeof rawWithPayload === "object") {
+    else if (Array.isArray(rawWithPayload) ||
+        typeof rawWithPayload === "object") {
         withPayload = true;
     }
-    const thresholdValue = Number(b?.score_threshold);
-    const scoreThreshold = Number.isFinite(thresholdValue) ? thresholdValue : undefined;
+    const thresholdRaw = b["score_threshold"];
+    const thresholdValue = typeof thresholdRaw === "number" ? thresholdRaw : Number(thresholdRaw);
+    const scoreThreshold = Number.isFinite(thresholdValue)
+        ? thresholdValue
+        : undefined;
     return { vector, top, withPayload, scoreThreshold };
 }
 export async function upsertPoints(ctx, body) {
@@ -193,7 +222,11 @@ async function executeSearch(ctx, normalizedSearch, source) {
     logger.info({ tenant: normalized.tenant, collection: normalized.collection }, `${source}: resolve collection meta`);
     const meta = await getCollectionMeta(normalized.metaKey);
     if (!meta) {
-        logger.warn({ tenant: normalized.tenant, collection: normalized.collection, metaKey: normalized.metaKey }, `${source}: collection not found`);
+        logger.warn({
+            tenant: normalized.tenant,
+            collection: normalized.collection,
+            metaKey: normalized.metaKey,
+        }, `${source}: collection not found`);
         throw new QdrantServiceError(404, {
             status: "error",
             error: "collection not found",
@@ -235,7 +268,11 @@ async function executeSearch(ctx, normalizedSearch, source) {
             }
             return hit.score <= threshold;
         });
-    logger.info({ tenant: normalized.tenant, collection: normalized.collection, hits: hits.length }, `${source}: completed`);
+    logger.info({
+        tenant: normalized.tenant,
+        collection: normalized.collection,
+        hits: hits.length,
+    }, `${source}: completed`);
     return { points: filtered };
 }
 export async function searchPoints(ctx, body) {

package/dist/ydb/client.d.ts

@@ -1,6 +1,12 @@
-import type { Session } from "ydb-sdk";
-declare const Types: any, TypedValues: any, TableDescription: any, Column: any;
+import type { Session, IAuthService } from "ydb-sdk";
+declare const Types: typeof import("ydb-sdk").Types, TypedValues: typeof import("ydb-sdk").TypedValues, TableDescription: typeof import("ydb-sdk").TableDescription, Column: typeof import("ydb-sdk").Column;
 export { Types, TypedValues, TableDescription, Column };
-export declare const driver: any;
+type DriverConfig = {
+    endpoint?: string;
+    database?: string;
+    connectionString?: string;
+    authService?: IAuthService;
+};
+export declare function configureDriver(config: DriverConfig): void;
 export declare function readyOrThrow(): Promise<void>;
 export declare function withSession<T>(fn: (s: Session) => Promise<T>): Promise<T>;

package/dist/ydb/client.js

@@ -1,20 +1,41 @@
 import { createRequire } from "module";
 import { YDB_DATABASE, YDB_ENDPOINT } from "../config/env.js";
 const require = createRequire(import.meta.url);
-// eslint-disable-next-line @typescript-eslint/no-var-requires
 const { Driver, getCredentialsFromEnv, Types, TypedValues, TableDescription, Column, } = require("ydb-sdk");
 export { Types, TypedValues, TableDescription, Column };
-export const driver = new Driver({
-    endpoint: YDB_ENDPOINT,
-    database: YDB_DATABASE,
-    authService: getCredentialsFromEnv(),
-});
+let overrideConfig;
+let driver;
+export function configureDriver(config) {
+    if (driver) {
+        // Driver already created; keep existing connection settings.
+        return;
+    }
+    overrideConfig = config;
+}
+function getOrCreateDriver() {
+    if (driver) {
+        return driver;
+    }
+    const base = overrideConfig?.connectionString != null
+        ? { connectionString: overrideConfig.connectionString }
+        : {
+            endpoint: overrideConfig?.endpoint ?? YDB_ENDPOINT,
+            database: overrideConfig?.database ?? YDB_DATABASE,
+        };
+    driver = new Driver({
+        ...base,
+        authService: overrideConfig?.authService ?? getCredentialsFromEnv(),
+    });
+    return driver;
+}
 export async function readyOrThrow() {
-    const ok = await driver.ready(10000);
+    const d = getOrCreateDriver();
+    const ok = await d.ready(10000);
     if (!ok) {
         throw new Error("YDB driver is not ready in 10s. Check connectivity and credentials.");
     }
 }
 export async function withSession(fn) {
-    return await driver.tableClient.withSession(fn, 15000);
+    const d = getOrCreateDriver();
+    return await d.tableClient.withSession(fn, 15000);
 }

package/dist/ydb/helpers.d.ts

@@ -1,2 +1,2 @@
-export declare function buildVectorParam(vector: number[], vectorType: "float" | "uint8"): any;
-export declare function buildJsonOrEmpty(payload?: Record<string, unknown>): any;
+export declare function buildVectorParam(vector: number[], vectorType: "float" | "uint8"): import("ydb-sdk-proto").Ydb.ITypedValue;
+export declare function buildJsonOrEmpty(payload?: Record<string, unknown>): import("ydb-sdk-proto").Ydb.ITypedValue;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "ydb-qdrant",
-  "version": "2.1.0",
-  "main": "dist/Api.js",
-  "types": "dist/Api.d.ts",
+  "version": "2.1.3",
+  "main": "dist/package/Api.js",
+  "types": "dist/package/Api.d.ts",
   "exports": {
-    ".": "./dist/Api.js",
+    ".": "./dist/package/Api.js",
     "./server": "./dist/server.js"
   },
   "files": [
@@ -16,10 +16,12 @@
   "scripts": {
     "test": "vitest run",
     "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
     "dev": "tsx watch src/index.ts",
     "start": "node --experimental-specifier-resolution=node --enable-source-maps dist/index.js",
     "smoke": "npm run build && node --experimental-specifier-resolution=node --enable-source-maps dist/SmokeTest.js",
-    "lint": "biome check .",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "prepare": "husky",
     "prepublishOnly": "npm test && npm run build"
   },
   "keywords": [
@@ -62,13 +64,16 @@
     "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.2.7",
+    "@eslint/js": "^9.39.1",
     "@types/express": "^5.0.3",
     "@types/node": "^24.9.1",
     "docsify-cli": "^4.4.4",
+    "eslint": "^9.39.1",
+    "husky": "^9.1.7",
     "node-plantuml-latest": "^2.4.0",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
+    "typescript-eslint": "^8.47.0",
     "vitest": "^4.0.12"
   }
 }