viyv-db-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 viyv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapter.d.ts

@@ -0,0 +1,31 @@
+import type { ViyvClient } from './client.js';
+/** Structurally compatible with viyv-agent-ui DataSourceMeta */
+export interface ViyvDataSourceMeta {
+    id: string;
+    name: string;
+    type: 'sql';
+    description?: string;
+    tables: Array<{
+        name: string;
+        columns: Array<{
+            name: string;
+            type: string;
+            nullable: boolean;
+            description?: string;
+        }>;
+        rowCount?: number;
+        description?: string;
+    }>;
+}
+/** Structurally compatible with viyv-agent-ui DataConnector */
+export interface ViyvDataConnector {
+    readonly meta: ViyvDataSourceMeta;
+    describe(): Promise<ViyvDataSourceMeta>;
+    query(params: Record<string, unknown>): Promise<unknown>;
+}
+export declare function createDataConnector(client: ViyvClient, options: {
+    id: string;
+    name: string;
+    description?: string;
+}): ViyvDataConnector;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACH;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,iBAAiB,CA8CnB"}

package/dist/adapter.js

@@ -0,0 +1,44 @@
+export function createDataConnector(client, options) {
+    let cachedMeta = null;
+    async function buildMeta() {
+        const tables = await client.overview();
+        return {
+            id: options.id,
+            name: options.name,
+            type: 'sql',
+            description: options.description,
+            tables: tables.map((t) => ({
+                name: t.name,
+                columns: t.columns.map((c) => ({
+                    name: c.name,
+                    type: c.type,
+                    nullable: c.nullable,
+                    description: c.description ?? undefined,
+                })),
+                rowCount: t.rowCount,
+                description: t.purpose ?? undefined,
+            })),
+        };
+    }
+    return {
+        get meta() {
+            return (cachedMeta ?? {
+                id: options.id,
+                name: options.name,
+                type: 'sql',
+                tables: [],
+            });
+        },
+        async describe() {
+            cachedMeta = await buildMeta();
+            return cachedMeta;
+        },
+        async query(params) {
+            if (typeof params.sql !== 'string' || params.sql.length === 0) {
+                throw new Error('Missing "sql" parameter');
+            }
+            return client.sql(params.sql);
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,mBAAmB,CAClC,MAAkB,EAClB,OAA2D;IAE3D,IAAI,UAAU,GAA8B,IAAI,CAAC;IAEjD,KAAK,UAAU,SAAS;QACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO;YACN,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,SAAS;iBACvC,CAAC,CAAC;gBACH,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,WAAW,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS;aACnC,CAAC,CAAC;SACH,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,IAAI;YACP,OAAO,CACN,UAAU,IAAI;gBACb,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,KAAc;gBACpB,MAAM,EAAE,EAAE;aACV,CACD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,QAAQ;YACb,UAAU,GAAG,MAAM,SAAS,EAAE,CAAC;YAC/B,OAAO,UAAU,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,MAA+B;YAC1C,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import type { IDatabaseService, QueryResult, SemanticSearchOptions, SemanticSearchResult, TableDetail, TableInfo } from 'viyv-db-core';
+import { QueryBuilder } from './query-builder.js';
+/** Minimal subset of IDatabaseService used by ViyvClient */
+export type ReadOnlyService = Pick<IDatabaseService, 'getSchema' | 'query' | 'queryTable' | 'close'> & {
+    semanticSearch?: IDatabaseService['semanticSearch'];
+};
+export declare class ViyvClient {
+    private readonly service;
+    constructor(service: ReadOnlyService);
+    listTables(): Promise<TableInfo[]>;
+    describeTable(name: string): Promise<TableDetail>;
+    overview(): Promise<TableDetail[]>;
+    from(table: string): QueryBuilder;
+    sql(query: string, params?: unknown[]): Promise<QueryResult>;
+    search(options: SemanticSearchOptions): Promise<SemanticSearchResult[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG,IAAI,CACjC,gBAAgB,EAChB,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAC9C,GAAG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;CACpD,CAAC;AAEF,qBAAa,UAAU;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAI/C,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKlC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMjD,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAOxC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAM3B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAM5D,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IASvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/client.js

@@ -0,0 +1,42 @@
+import { QueryBuilder } from './query-builder.js';
+export class ViyvClient {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    // ── Schema（read-only）──
+    async listTables() {
+        const result = await this.service.getSchema('list');
+        return result.mode === 'list' ? result.tables : [];
+    }
+    async describeTable(name) {
+        const result = await this.service.getSchema('detail', { tableName: name });
+        if (result.mode !== 'detail')
+            throw new Error('Unexpected result');
+        return result.table;
+    }
+    async overview() {
+        const result = await this.service.getSchema('overview');
+        return result.mode === 'overview' ? result.tables : [];
+    }
+    // ── Structured query（main API）──
+    from(table) {
+        return new QueryBuilder(this.service, table);
+    }
+    // ── SQL query（SELECT only）──
+    async sql(query, params) {
+        return this.service.query(query, params);
+    }
+    // ── Semantic search ──
+    async search(options) {
+        if (!this.service.semanticSearch) {
+            throw new Error('Semantic search is not available on this service');
+        }
+        return this.service.semanticSearch(options);
+    }
+    // ── Lifecycle ──
+    async close() {
+        await this.service.close();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,MAAM,OAAO,UAAU;IACO;IAA7B,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAEzD,yBAAyB;IAEzB,KAAK,CAAC,UAAU;QACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ;QACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,kCAAkC;IAElC,IAAI,CAAC,KAAa;QACjB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,8BAA8B;IAE9B,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,MAAkB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,wBAAwB;IAExB,KAAK,CAAC,MAAM,CAAC,OAA8B;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,kBAAkB;IAElB,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import type { ReadOnlyService } from './client.js';
+import { ViyvClient } from './client.js';
+import type { ClientConfig } from './types.js';
+/** Main factory: PG connection → ViyvClient */
+export declare function createViyvClient(config: ClientConfig): Promise<ViyvClient>;
+/** DI factory: existing IDatabaseService (or subset) → ViyvClient */
+export declare function createViyvClientFromService(service: ReadOnlyService): ViyvClient;
+export { ViyvClient } from './client.js';
+export type { ReadOnlyService } from './client.js';
+export { QueryBuilder } from './query-builder.js';
+export { createDataConnector } from './adapter.js';
+export type { ViyvDataConnector, ViyvDataSourceMeta } from './adapter.js';
+export type { ClientConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,+CAA+C;AAC/C,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAchF;AAED,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,UAAU,CAEhF;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+import { PostgresConfigSchema, createPostgresService } from 'viyv-db-postgres';
+import { ViyvClient } from './client.js';
+/** Main factory: PG connection → ViyvClient */
+export async function createViyvClient(config) {
+    // Client defaults differ from MCP server: read-only, smaller pool
+    const pgConfig = PostgresConfigSchema.parse({
+        postgresUrl: config.postgresUrl,
+        tenantId: config.tenantId,
+        accessLevel: config.accessLevel ?? 'read',
+        rowLimit: config.rowLimit,
+        queryTimeoutMs: config.queryTimeoutMs,
+        autoInitialize: config.autoInitialize,
+        poolMin: config.poolMin ?? 1,
+        poolMax: config.poolMax ?? 5,
+    });
+    const service = await createPostgresService(pgConfig, config.embeddingProvider);
+    return new ViyvClient(service);
+}
+/** DI factory: existing IDatabaseService (or subset) → ViyvClient */
+export function createViyvClientFromService(service) {
+    return new ViyvClient(service);
+}
+export { ViyvClient } from './client.js';
+export { QueryBuilder } from './query-builder.js';
+export { createDataConnector } from './adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAoB;IAC1D,kEAAkE;IAClE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC;QAC3C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM;QACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAChF,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,2BAA2B,CAAC,OAAwB;IACnE,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/query-builder.d.ts

@@ -0,0 +1,19 @@
+import type { IDatabaseService, QueryResult } from 'viyv-db-core';
+type QueryService = Pick<IDatabaseService, 'queryTable'>;
+export declare class QueryBuilder {
+    private readonly service;
+    private readonly table;
+    private readonly options;
+    constructor(service: QueryService, table: string);
+    select(columns: string[]): this;
+    where(conditions: Record<string, unknown>): this;
+    orderBy(column: string, direction?: 'asc' | 'desc'): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    execute(): Promise<QueryResult>;
+    rows(): Promise<Record<string, unknown>[]>;
+    /** Execute with limit=1, return first row or null. Does NOT mutate the builder. */
+    first(): Promise<Record<string, unknown> | null>;
+}
+export {};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAqB,MAAM,cAAc,CAAC;AAErF,KAAK,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;AAEzD,qBAAa,YAAY;IAIvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAG/B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM;IAG/B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAK/B,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKhD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAMhE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKjB,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAI/B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAKhD,mFAAmF;IAC7E,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAItD"}

package/dist/query-builder.js

@@ -0,0 +1,43 @@
+export class QueryBuilder {
+    service;
+    table;
+    options = {};
+    constructor(service, table) {
+        this.service = service;
+        this.table = table;
+    }
+    select(columns) {
+        this.options.columns = columns;
+        return this;
+    }
+    where(conditions) {
+        this.options.where = { ...this.options.where, ...conditions };
+        return this;
+    }
+    orderBy(column, direction = 'asc') {
+        const existing = this.options.orderBy ?? [];
+        this.options.orderBy = [...existing, { column, direction }];
+        return this;
+    }
+    limit(n) {
+        this.options.limit = n;
+        return this;
+    }
+    offset(n) {
+        this.options.offset = n;
+        return this;
+    }
+    async execute() {
+        return this.service.queryTable(this.table, this.options);
+    }
+    async rows() {
+        const result = await this.execute();
+        return result.rows;
+    }
+    /** Execute with limit=1, return first row or null. Does NOT mutate the builder. */
+    async first() {
+        const result = await this.service.queryTable(this.table, { ...this.options, limit: 1 });
+        return result.rows[0] ?? null;
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,YAAY;IAIN;IACA;IAJD,OAAO,GAAsB,EAAE,CAAC;IAEjD,YACkB,OAAqB,EACrB,KAAa;QADb,YAAO,GAAP,OAAO,CAAc;QACrB,UAAK,GAAL,KAAK,CAAQ;IAC5B,CAAC;IAEJ,MAAM,CAAC,OAAiB;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,UAAmC;QACxC,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,YAA4B,KAAK;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,GAAG,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,CAAS;QACd,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,CAAC,CAAS;QACf,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,IAAI;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,KAAK;QACV,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACxF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC/B,CAAC;CACD"}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+import type { AccessLevel, IEmbeddingProvider } from 'viyv-db-core';
+export interface ClientConfig {
+    postgresUrl: string;
+    tenantId?: string;
+    accessLevel?: AccessLevel;
+    rowLimit?: number;
+    queryTimeoutMs?: number;
+    autoInitialize?: boolean;
+    poolMin?: number;
+    poolMax?: number;
+    embeddingProvider?: IEmbeddingProvider;
+}
+//# 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;CACvC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "viyv-db-client",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Client library for querying viyv-db",
+  "license": "MIT",
+  "author": "viyv",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__"
+  ],
+  "dependencies": {
+    "viyv-db-postgres": "0.1.0",
+    "viyv-db-core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}