viyv-db-postgres 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/config.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const PostgresConfigSchema: z.ZodObject<{
+    postgresUrl: z.ZodString;
+    tenantId: z.ZodDefault<z.ZodString>;
+    accessLevel: z.ZodDefault<z.ZodEnum<["read", "data", "schema"]>>;
+    queryTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    rowLimit: z.ZodDefault<z.ZodNumber>;
+    autoInitialize: z.ZodDefault<z.ZodBoolean>;
+    poolMin: z.ZodDefault<z.ZodNumber>;
+    poolMax: z.ZodDefault<z.ZodNumber>;
+    embeddingDimensions: z.ZodOptional<z.ZodNumber>;
+    insertBatchSize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    postgresUrl: string;
+    tenantId: string;
+    accessLevel: "read" | "data" | "schema";
+    queryTimeoutMs: number;
+    rowLimit: number;
+    autoInitialize: boolean;
+    poolMin: number;
+    poolMax: number;
+    insertBatchSize: number;
+    embeddingDimensions?: number | undefined;
+}, {
+    postgresUrl: string;
+    tenantId?: string | undefined;
+    accessLevel?: "read" | "data" | "schema" | undefined;
+    queryTimeoutMs?: number | undefined;
+    rowLimit?: number | undefined;
+    autoInitialize?: boolean | undefined;
+    poolMin?: number | undefined;
+    poolMax?: number | undefined;
+    embeddingDimensions?: number | undefined;
+    insertBatchSize?: number | undefined;
+}>;
+export type PostgresConfig = z.infer<typeof PostgresConfigSchema>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/config.js

@@ -0,0 +1,15 @@
+import { AccessLevelSchema } from 'viyv-db-core';
+import { z } from 'zod';
+export const PostgresConfigSchema = z.object({
+    postgresUrl: z.string(),
+    tenantId: z.string().default('default'),
+    accessLevel: AccessLevelSchema.default('schema'),
+    queryTimeoutMs: z.number().positive().default(30_000),
+    rowLimit: z.number().positive().default(1_000),
+    autoInitialize: z.boolean().default(true),
+    poolMin: z.number().nonnegative().default(2),
+    poolMax: z.number().positive().default(10),
+    embeddingDimensions: z.number().positive().optional(),
+    insertBatchSize: z.number().int().min(100).max(5000).default(2000),
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC;IAChD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC9C,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACrD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;CAClE,CAAC,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,9 @@
+import * as schema from './schema.js';
+export type DrizzleDb = ReturnType<typeof createDb>['db'];
+export declare function createDb(connectionString: string, poolMin?: number, poolMax?: number): {
+    db: import("drizzle-orm/node-postgres").NodePgDatabase<typeof schema> & {
+        $client: import("pg").Pool;
+    };
+    pool: import("pg").Pool;
+};
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;AAE1D,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,SAAI,EAAE,OAAO,SAAK;;;;;EAQ3E"}

package/dist/db.js

@@ -0,0 +1,13 @@
+import { drizzle } from 'drizzle-orm/node-postgres';
+import pg from 'pg';
+import * as schema from './schema.js';
+export function createDb(connectionString, poolMin = 2, poolMax = 10) {
+    const pool = new pg.Pool({
+        connectionString,
+        min: poolMin,
+        max: poolMax,
+    });
+    const db = drizzle(pool, { schema });
+    return { db, pool };
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAItC,MAAM,UAAU,QAAQ,CAAC,gBAAwB,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE;IAC3E,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;QACxB,gBAAgB;QAChB,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,OAAO;KACZ,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACrB,CAAC"}

package/dist/error-mapper.d.ts

@@ -0,0 +1,2 @@
+export declare function mapPgError(error: unknown): never;
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../src/error-mapper.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAqBhD"}

package/dist/error-mapper.js

@@ -0,0 +1,24 @@
+import { MigrationError, SqlValidationError, TableNotFoundError } from 'viyv-db-core';
+export function mapPgError(error) {
+    if (error instanceof Error && 'code' in error) {
+        const pgError = error;
+        switch (pgError.code) {
+            case '23505': // unique_violation
+                throw new SqlValidationError(`Duplicate key: ${pgError.detail ?? ''}`);
+            case '23503': // foreign_key_violation
+                throw new SqlValidationError(`Foreign key violation: ${pgError.detail ?? ''}`);
+            case '42P01': // undefined_table
+                throw new TableNotFoundError(pgError.detail ?? 'unknown');
+            case '42703': // undefined_column
+                throw new SqlValidationError(`Undefined column: ${pgError.detail ?? ''}`);
+            case '42601': // syntax_error
+                throw new SqlValidationError(`SQL syntax error: ${error.message}`);
+            case '40001': // serialization_failure
+                throw new MigrationError(`Serialization failure: ${error.message}`);
+            case '57014': // query_canceled (timeout)
+                throw new SqlValidationError('Query timed out');
+        }
+    }
+    throw error;
+}
+//# sourceMappingURL=error-mapper.js.map

package/dist/error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.js","sourceRoot":"","sources":["../src/error-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEtF,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,KAA+D,CAAC;QAChF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,OAAO,EAAE,mBAAmB;gBAChC,MAAM,IAAI,kBAAkB,CAAC,kBAAkB,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;YACxE,KAAK,OAAO,EAAE,wBAAwB;gBACrC,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;YAChF,KAAK,OAAO,EAAE,kBAAkB;gBAC/B,MAAM,IAAI,kBAAkB,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;YAC3D,KAAK,OAAO,EAAE,mBAAmB;gBAChC,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;YAC3E,KAAK,OAAO,EAAE,eAAe;gBAC5B,MAAM,IAAI,kBAAkB,CAAC,qBAAsB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/E,KAAK,OAAO,EAAE,wBAAwB;gBACrC,MAAM,IAAI,cAAc,CAAC,0BAA2B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,KAAK,OAAO,EAAE,2BAA2B;gBACxC,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAClD,CAAC;IACF,CAAC;IACD,MAAM,KAAK,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { IEmbeddingProvider } from 'viyv-db-core';
+import type { PostgresConfig } from './config.js';
+import { PostgresService } from './services/postgres-service.js';
+export type { PostgresConfig } from './config.js';
+export { PostgresConfigSchema } from './config.js';
+export { PostgresService } from './services/postgres-service.js';
+export declare function createPostgresService(config: PostgresConfig, embeddingProvider?: IEmbeddingProvider): Promise<PostgresService>;
+//# 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":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,cAAc,EACtB,iBAAiB,CAAC,EAAE,kBAAkB,GACpC,OAAO,CAAC,eAAe,CAAC,CAe1B"}

package/dist/index.js

@@ -0,0 +1,19 @@
+import { createDb } from './db.js';
+import { LogicalTableRegistry } from './logical/registry.js';
+import { PostgresService } from './services/postgres-service.js';
+export { PostgresConfigSchema } from './config.js';
+export { PostgresService } from './services/postgres-service.js';
+export async function createPostgresService(config, embeddingProvider) {
+    const { db, pool } = createDb(config.postgresUrl, config.poolMin, config.poolMax);
+    const registry = new LogicalTableRegistry();
+    const service = new PostgresService(db, registry, config, config.tenantId);
+    service.setPool(pool);
+    if (config.autoInitialize) {
+        await service.initialize();
+    }
+    if (embeddingProvider) {
+        await service.enableEmbedding(embeddingProvider, config.embeddingDimensions ?? 384);
+    }
+    return service;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,MAAsB,EACtB,iBAAsC;IAEtC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3E,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,iBAAiB,EAAE,CAAC;QACvB,MAAM,OAAO,CAAC,eAAe,CAAC,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,IAAI,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/logical/cte-builder.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CTE 合成層: 論理テーブルの CTE 定義生成・複数 CTE 合成・ユーザー WITH 句マージ。
+ * DB 接続・config に一切依存しない純粋関数群。
+ */
+import type { TableCacheEntry } from './registry.js';
+export interface LogicalTableBinding {
+    tableName: string;
+    entry: TableCacheEntry;
+}
+export interface CteComposition {
+    sql: string;
+    params: unknown[];
+}
+/**
+ * 単一 CTE 定義を生成（WITH キーワードなし）。
+ * paramOffset: この CTE の $N 開始位置（0-based → $1 から, 2 → $3 から）
+ *
+ * 返却例: "prices" AS (SELECT ... FROM _viyv_logical_rows WHERE tenant_id = $3 AND table_id = $4)
+ */
+export declare function buildCteDef(tableName: string, columns: Array<{
+    name: string;
+    type: string;
+    position: number;
+}>, paramOffset: number): {
+    cteDef: string;
+    paramCount: number;
+};
+/**
+ * WITH 句を分離する。ユーザー SQL が WITH で始まる場合、
+ * CTE 定義部分とメインクエリを分離して返す。
+ */
+export declare function parseWithClause(sql: string): {
+    hasWith: boolean;
+    cteDefinitions: string;
+    mainQuery: string;
+    isRecursive: boolean;
+};
+/**
+ * 複数論理テーブルの CTE を合成し、完成 SQL を返す。
+ */
+export declare function composeCteQuery(bindings: LogicalTableBinding[], tenantId: string, userSql: string, userParams: unknown[] | undefined, rowLimit: number): CteComposition;
+/**
+ * @deprecated Use buildCteDef + composeCteQuery instead
+ */
+export declare function buildLogicalTableCte(tableName: string, columns: Array<{
+    name: string;
+    type: string;
+    position: number;
+}>): {
+    cte: string;
+    paramCount: number;
+};
+/**
+ * @deprecated Use offsetSqlParamsSafe instead
+ */
+export declare function offsetSqlParams(sqlStr: string, offset: number): string;
+//# sourceMappingURL=cte-builder.d.ts.map

package/dist/logical/cte-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cte-builder.d.ts","sourceRoot":"","sources":["../../src/logical/cte-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAChE,WAAW,EAAE,MAAM,GACjB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAiBxC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACrB,CA4FA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,EACjC,QAAQ,EAAE,MAAM,GACd,cAAc,CA2ChB;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9D;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAGrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAItE"}

package/dist/logical/cte-builder.js

@@ -0,0 +1,167 @@
+/**
+ * CTE 合成層: 論理テーブルの CTE 定義生成・複数 CTE 合成・ユーザー WITH 句マージ。
+ * DB 接続・config に一切依存しない純粋関数群。
+ */
+import { offsetSqlParamsSafe, tokenizeSql } from './sql-tokenizer.js';
+import { pgCastForType } from './type-utils.js';
+/**
+ * 単一 CTE 定義を生成（WITH キーワードなし）。
+ * paramOffset: この CTE の $N 開始位置（0-based → $1 から, 2 → $3 から）
+ *
+ * 返却例: "prices" AS (SELECT ... FROM _viyv_logical_rows WHERE tenant_id = $3 AND table_id = $4)
+ */
+export function buildCteDef(tableName, columns, paramOffset) {
+    const sorted = [...columns].sort((a, b) => a.position - b.position);
+    const colExprs = sorted.length > 0
+        ? sorted
+            .map((c) => {
+            const cast = pgCastForType(c.type);
+            return `(data->>'${c.name}')${cast} AS "${c.name}"`;
+        })
+            .join(', ')
+        : '1 AS _empty';
+    const p1 = paramOffset + 1;
+    const p2 = paramOffset + 2;
+    const cteDef = `"${tableName}" AS (SELECT ${colExprs} FROM _viyv_logical_rows WHERE tenant_id = $${p1} AND table_id = $${p2})`;
+    return { cteDef, paramCount: 2 };
+}
+/**
+ * WITH 句を分離する。ユーザー SQL が WITH で始まる場合、
+ * CTE 定義部分とメインクエリを分離して返す。
+ */
+export function parseWithClause(sql) {
+    const tokens = tokenizeSql(sql);
+    // 意味トークンのインデックス列
+    const semIdx = [];
+    for (let i = 0; i < tokens.length; i++) {
+        if (tokens[i].type !== 'whitespace' && tokens[i].type !== 'comment') {
+            semIdx.push(i);
+        }
+    }
+    if (semIdx.length === 0) {
+        return { hasWith: false, cteDefinitions: '', mainQuery: sql, isRecursive: false };
+    }
+    const first = tokens[semIdx[0]];
+    if (first.type !== 'word' || first.value.toUpperCase() !== 'WITH') {
+        return { hasWith: false, cteDefinitions: '', mainQuery: sql, isRecursive: false };
+    }
+    let si = 1;
+    let isRecursive = false;
+    if (si < semIdx.length &&
+        tokens[semIdx[si]].type === 'word' &&
+        tokens[semIdx[si]].value.toUpperCase() === 'RECURSIVE') {
+        isRecursive = true;
+        si++;
+    }
+    // Track the start of CTE definitions (after WITH [RECURSIVE])
+    const cteStartToken = si < semIdx.length ? tokens[semIdx[si]] : null;
+    if (!cteStartToken) {
+        return { hasWith: false, cteDefinitions: '', mainQuery: sql, isRecursive: false };
+    }
+    const cteStartOffset = cteStartToken.offset;
+    // Parse CTE definitions to find where main query begins
+    let mainQueryOffset = -1;
+    while (si < semIdx.length) {
+        const nameToken = tokens[semIdx[si]];
+        if (nameToken.type !== 'word' && nameToken.type !== 'quoted_ident')
+            break;
+        si++; // skip name
+        // Expect AS
+        if (si >= semIdx.length)
+            break;
+        const asToken = tokens[semIdx[si]];
+        if (asToken.type !== 'word' || asToken.value.toUpperCase() !== 'AS')
+            break;
+        si++; // skip AS
+        // Expect (
+        if (si >= semIdx.length)
+            break;
+        const parenToken = tokens[semIdx[si]];
+        if (parenToken.type !== 'punctuation' || parenToken.value !== '(')
+            break;
+        // Track paren depth
+        let depth = 1;
+        si++;
+        while (si < semIdx.length && depth > 0) {
+            const t = tokens[semIdx[si]];
+            if (t.type === 'punctuation' && t.value === '(')
+                depth++;
+            if (t.type === 'punctuation' && t.value === ')')
+                depth--;
+            si++;
+        }
+        // After closing ), check for comma → next CTE, or main query start
+        if (si < semIdx.length) {
+            const next = tokens[semIdx[si]];
+            if (next.type === 'punctuation' && next.value === ',') {
+                si++; // skip comma, continue to next CTE
+                continue;
+            }
+            // Main query starts here
+            mainQueryOffset = next.offset;
+        }
+        break;
+    }
+    if (mainQueryOffset === -1) {
+        return { hasWith: false, cteDefinitions: '', mainQuery: sql, isRecursive: false };
+    }
+    // cteDefinitions: from after WITH [RECURSIVE] to before main query, trimmed
+    const cteDefinitions = sql.slice(cteStartOffset, mainQueryOffset).trim();
+    // Remove trailing comma if present
+    const cleanCte = cteDefinitions.replace(/,\s*$/, '');
+    const mainQuery = sql.slice(mainQueryOffset);
+    return { hasWith: true, cteDefinitions: cleanCte, mainQuery, isRecursive };
+}
+/**
+ * 複数論理テーブルの CTE を合成し、完成 SQL を返す。
+ */
+export function composeCteQuery(bindings, tenantId, userSql, userParams, rowLimit) {
+    const cteParams = [];
+    const cteDefs = [];
+    // 1. 各 binding に対して CTE 定義生成
+    let paramOffset = 0;
+    for (const binding of bindings) {
+        const { cteDef, paramCount } = buildCteDef(binding.tableName, binding.entry.columns, paramOffset);
+        cteDefs.push(cteDef);
+        cteParams.push(tenantId, binding.entry.id);
+        paramOffset += paramCount;
+    }
+    // 2. ユーザー SQL のパラメータ番号をオフセット + セミコロン除去
+    const cleanSql = userSql.replace(/;\s*$/, '');
+    const offsetSql = offsetSqlParamsSafe(cleanSql, paramOffset);
+    // 3. ユーザー WITH 句を分離
+    const parsed = parseWithClause(offsetSql);
+    // 4. WITH マージ + メインクエリをサブクエリラップ + 外側 LIMIT
+    let withParts;
+    let isRecursive = false;
+    if (parsed.hasWith) {
+        // ユーザー CTE と生成 CTE をマージ
+        withParts = [...cteDefs, parsed.cteDefinitions];
+        isRecursive = parsed.isRecursive;
+    }
+    else {
+        withParts = cteDefs;
+    }
+    const mainQuery = parsed.hasWith ? parsed.mainQuery : offsetSql;
+    const recursive = isRecursive ? ' RECURSIVE' : '';
+    const fullSql = `WITH${recursive} ${withParts.join(',\n     ')} SELECT * FROM (${mainQuery}) AS _q LIMIT ${rowLimit + 1}`;
+    const allParams = [...cteParams, ...(userParams ?? [])];
+    return { sql: fullSql, params: allParams };
+}
+// === Backward compatibility exports (used by existing tests) ===
+/**
+ * @deprecated Use buildCteDef + composeCteQuery instead
+ */
+export function buildLogicalTableCte(tableName, columns) {
+    const { cteDef, paramCount } = buildCteDef(tableName, columns, 0);
+    return { cte: `WITH ${cteDef}`, paramCount };
+}
+/**
+ * @deprecated Use offsetSqlParamsSafe instead
+ */
+export function offsetSqlParams(sqlStr, offset) {
+    return sqlStr.replace(/\$(\d+)/g, (_match, num) => {
+        return `$${Number.parseInt(num, 10) + offset}`;
+    });
+}
+//# sourceMappingURL=cte-builder.js.map

package/dist/logical/cte-builder.js.map

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

package/dist/logical/data-ops.d.ts

@@ -0,0 +1,19 @@
+import type { DrizzleDb } from '../db.js';
+import type { LogicalTableRegistry } from './registry.js';
+export interface InsertInternalResult {
+    insertedCount: number;
+    rowIds: string[];
+}
+export interface InsertOptions {
+    batchSize?: number;
+    needsRowIds?: boolean;
+}
+export declare function insert(db: DrizzleDb, registry: LogicalTableRegistry, tenantId: string, table: string, rows: Record<string, unknown>[], options?: InsertOptions): Promise<InsertInternalResult>;
+export interface MutationInternalResult {
+    affectedRows: number;
+    rowIds: string[];
+}
+export declare function update(db: DrizzleDb, registry: LogicalTableRegistry, tenantId: string, table: string, set: Record<string, unknown>, where: Record<string, unknown>): Promise<MutationInternalResult>;
+export declare function deleteRows(db: DrizzleDb, registry: LogicalTableRegistry, tenantId: string, table: string, where: Record<string, unknown>): Promise<MutationInternalResult>;
+export declare function upsert(db: DrizzleDb, registry: LogicalTableRegistry, tenantId: string, table: string, rows: Record<string, unknown>[], conflictColumns: string[]): Promise<InsertInternalResult>;
+//# sourceMappingURL=data-ops.d.ts.map

package/dist/logical/data-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-ops.d.ts","sourceRoot":"","sources":["../../src/logical/data-ops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAG1D,MAAM,WAAW,oBAAoB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAkBD,wBAAsB,MAAM,CAC3B,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAiC/B;AAED,MAAM,WAAW,sBAAsB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,MAAM,CAC3B,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAsBjC;AAED,wBAAsB,UAAU,CAC/B,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,wBAAsB,MAAM,CAC3B,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,eAAe,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAqD/B"}

package/dist/logical/data-ops.js

@@ -0,0 +1,124 @@
+import { and, eq, sql } from 'drizzle-orm';
+import { TableNotFoundError } from 'viyv-db-core';
+import { logicalRows } from '../schema.js';
+import { buildWhereConditions } from './where-builder.js';
+/**
+ * Expand GIN pending list for large bulk inserts.
+ * SET LOCAL resets automatically at transaction end.
+ */
+async function bulkInsertHint(tx, rowCount) {
+    if (rowCount < 1000)
+        return;
+    try {
+        await tx.execute(sql `SET LOCAL gin_pending_list_limit = '32MB'`);
+    }
+    catch {
+        // PG permission denied — continue without hint
+    }
+}
+export async function insert(db, registry, tenantId, table, rows, options) {
+    const tableId = registry.getTableId(table);
+    if (!tableId)
+        throw new TableNotFoundError(table);
+    if (rows.length === 0)
+        return { insertedCount: 0, rowIds: [] };
+    const batchSize = options?.batchSize ?? 2000;
+    const needsRowIds = options?.needsRowIds ?? true;
+    const allIds = [];
+    await db.transaction(async (tx) => {
+        await bulkInsertHint(tx, rows.length);
+        for (let i = 0; i < rows.length; i += batchSize) {
+            const batch = rows.slice(i, i + batchSize);
+            const values = batch.map((row) => ({
+                tenantId,
+                tableId,
+                data: row,
+            }));
+            if (needsRowIds) {
+                const inserted = await tx
+                    .insert(logicalRows)
+                    .values(values)
+                    .returning({ id: logicalRows.id });
+                for (const r of inserted)
+                    allIds.push(r.id);
+            }
+            else {
+                await tx.insert(logicalRows).values(values);
+            }
+        }
+    });
+    return { insertedCount: rows.length, rowIds: allIds };
+}
+export async function update(db, registry, tenantId, table, set, where) {
+    const entry = registry.getTable(table);
+    if (!entry)
+        throw new TableNotFoundError(table);
+    const whereConditions = buildWhereConditions(where, entry.columns);
+    const result = await db
+        .update(logicalRows)
+        .set({
+        data: sql `${logicalRows.data} || ${JSON.stringify(set)}::jsonb`,
+        updatedAt: new Date(),
+    })
+        .where(and(eq(logicalRows.tenantId, tenantId), eq(logicalRows.tableId, entry.id), ...whereConditions))
+        .returning({ id: logicalRows.id });
+    return { affectedRows: result.length, rowIds: result.map((r) => r.id) };
+}
+export async function deleteRows(db, registry, tenantId, table, where) {
+    const entry = registry.getTable(table);
+    if (!entry)
+        throw new TableNotFoundError(table);
+    const whereConditions = buildWhereConditions(where, entry.columns);
+    const result = await db
+        .delete(logicalRows)
+        .where(and(eq(logicalRows.tenantId, tenantId), eq(logicalRows.tableId, entry.id), ...whereConditions))
+        .returning({ id: logicalRows.id });
+    return { affectedRows: result.length, rowIds: result.map((r) => r.id) };
+}
+export async function upsert(db, registry, tenantId, table, rows, conflictColumns) {
+    const entry = registry.getTable(table);
+    if (!entry)
+        throw new TableNotFoundError(table);
+    if (rows.length === 0)
+        return { insertedCount: 0, rowIds: [] };
+    let affected = 0;
+    const allIds = [];
+    await db.transaction(async (tx) => {
+        for (const row of rows) {
+            const conflictWhere = {};
+            for (const col of conflictColumns) {
+                conflictWhere[col] = row[col];
+            }
+            const whereConditions = buildWhereConditions(conflictWhere, entry.columns);
+            const existing = await tx
+                .select({ id: logicalRows.id })
+                .from(logicalRows)
+                .where(and(eq(logicalRows.tenantId, tenantId), eq(logicalRows.tableId, entry.id), ...whereConditions))
+                .limit(1);
+            if (existing.length > 0) {
+                await tx
+                    .update(logicalRows)
+                    .set({
+                    data: row,
+                    updatedAt: new Date(),
+                })
+                    .where(and(eq(logicalRows.id, existing[0].id), eq(logicalRows.tenantId, tenantId)));
+                allIds.push(existing[0].id);
+            }
+            else {
+                const inserted = await tx
+                    .insert(logicalRows)
+                    .values({
+                    tenantId,
+                    tableId: entry.id,
+                    data: row,
+                })
+                    .returning({ id: logicalRows.id });
+                allIds.push(...inserted.map((r) => r.id));
+            }
+            affected++;
+        }
+    });
+    return { insertedCount: affected, rowIds: allIds };
+}
+//# sourceMappingURL=data-ops.js.map

package/dist/logical/data-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-ops.js","sourceRoot":"","sources":["../../src/logical/data-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAY1D;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC5B,EAAqC,EACrC,QAAgB;IAEhB,IAAI,QAAQ,GAAG,IAAI;QAAE,OAAO;IAC5B,IAAI,CAAC;QACJ,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,2CAA2C,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACR,+CAA+C;IAChD,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC3B,EAAa,EACb,QAA8B,EAC9B,QAAgB,EAChB,KAAa,EACb,IAA+B,EAC/B,OAAuB;IAEvB,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE/D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IACjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACjC,MAAM,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAClC,QAAQ;gBACR,OAAO;gBACP,IAAI,EAAE,GAAG;aACT,CAAC,CAAC,CAAC;YAEJ,IAAI,WAAW,EAAE,CAAC;gBACjB,MAAM,QAAQ,GAAG,MAAM,EAAE;qBACvB,MAAM,CAAC,WAAW,CAAC;qBACnB,MAAM,CAAC,MAAM,CAAC;qBACd,SAAS,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,KAAK,MAAM,CAAC,IAAI,QAAQ;oBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACP,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7C,CAAC;QACF,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACvD,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,MAAM,CAC3B,EAAa,EACb,QAA8B,EAC9B,QAAgB,EAChB,KAAa,EACb,GAA4B,EAC5B,KAA8B;IAE9B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAEhD,MAAM,eAAe,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,MAAM,EAAE;SACrB,MAAM,CAAC,WAAW,CAAC;SACnB,GAAG,CAAC;QACJ,IAAI,EAAE,GAAG,CAAA,GAAG,WAAW,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS;QAC/D,SAAS,EAAE,IAAI,IAAI,EAAE;KACrB,CAAC;SACD,KAAK,CACL,GAAG,CACF,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAClC,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,EACjC,GAAG,eAAe,CAClB,CACD;SACA,SAAS,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,EAAa,EACb,QAA8B,EAC9B,QAAgB,EAChB,KAAa,EACb,KAA8B;IAE9B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAEhD,MAAM,eAAe,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,MAAM,EAAE;SACrB,MAAM,CAAC,WAAW,CAAC;SACnB,KAAK,CACL,GAAG,CACF,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAClC,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,EACjC,GAAG,eAAe,CAClB,CACD;SACA,SAAS,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC3B,EAAa,EACb,QAA8B,EAC9B,QAAgB,EAChB,KAAa,EACb,IAA+B,EAC/B,eAAyB;IAEzB,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE/D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,aAAa,GAA4B,EAAE,CAAC;YAClD,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;gBACnC,aAAa,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;YACD,MAAM,eAAe,GAAG,oBAAoB,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAE3E,MAAM,QAAQ,GAAG,MAAM,EAAE;iBACvB,MAAM,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC;iBAC9B,IAAI,CAAC,WAAW,CAAC;iBACjB,KAAK,CACL,GAAG,CACF,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAClC,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,EACjC,GAAG,eAAe,CAClB,CACD;iBACA,KAAK,CAAC,CAAC,CAAC,CAAC;YAEX,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,EAAE;qBACN,MAAM,CAAC,WAAW,CAAC;qBACnB,GAAG,CAAC;oBACJ,IAAI,EAAE,GAAG;oBACT,SAAS,EAAE,IAAI,IAAI,EAAE;iBACrB,CAAC;qBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACrF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACP,MAAM,QAAQ,GAAG,MAAM,EAAE;qBACvB,MAAM,CAAC,WAAW,CAAC;qBACnB,MAAM,CAAC;oBACP,QAAQ;oBACR,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,IAAI,EAAE,GAAG;iBACT,CAAC;qBACD,SAAS,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3C,CAAC;YACD,QAAQ,EAAE,CAAC;QACZ,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACpD,CAAC"}

package/dist/logical/embedding-ops.d.ts

@@ -0,0 +1,24 @@
+import type { DrizzleDb } from '../db.js';
+export interface EmbeddingEntry {
+    rowId: string;
+    tableId: string;
+    embedding: number[];
+    embeddingText: string;
+}
+export interface SimilarRow {
+    rowId: string;
+    tableId: string;
+    tableName: string;
+    tablePurpose: string | null;
+    data: Record<string, unknown>;
+    similarity: number;
+}
+export declare function initializeEmbeddingTable(db: DrizzleDb, dimensions: number): Promise<void>;
+export declare function storeEmbeddings(db: DrizzleDb, tenantId: string, entries: EmbeddingEntry[]): Promise<void>;
+export declare function searchSimilar(db: DrizzleDb, tenantId: string, queryVector: number[], options: {
+    tableIds?: string[];
+    limit: number;
+    threshold: number;
+}): Promise<SimilarRow[]>;
+export declare function deleteEmbeddingsByRowIds(db: DrizzleDb, tenantId: string, rowIds: string[]): Promise<void>;
+//# sourceMappingURL=embedding-ops.d.ts.map

package/dist/logical/embedding-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-ops.d.ts","sourceRoot":"","sources":["../../src/logical/embedding-ops.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB/F;AAED,wBAAsB,eAAe,CACpC,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,aAAa,CAClC,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB,GACC,OAAO,CAAC,UAAU,EAAE,CAAC,CAgDvB;AAED,wBAAsB,wBAAwB,CAC7C,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,IAAI,CAAC,CAMf"}