@absolutejs/rag-postgres 0.0.5

package/README.md

@@ -0,0 +1,49 @@
+# @absolutejs/rag-postgres
+
+PostgreSQL vector-store adapter for [`@absolutejs/rag`](https://github.com/absolutejs/rag),
+with `pgvector` as the first vector implementation. Native vector search, server-side
+filtering, and inspectable schema/migration plans.
+
+## Install
+
+```bash
+bun add @absolutejs/rag @absolutejs/rag-postgres postgres
+```
+
+## Usage
+
+```ts
+import { createPostgresRAG } from '@absolutejs/rag-postgres';
+import { ragPlugin } from '@absolutejs/rag';
+
+const rag = createPostgresRAG({
+	connectionString: process.env.DATABASE_URL,
+	vector: {
+		provider: 'pgvector',
+		dimensions: 1536,
+		distanceMetric: 'cosine',
+		autoCreateExtension: true,
+		autoCreateSchema: true,
+		autoCreateTables: true,
+		autoCreateIndex: true,
+		index: { type: 'hnsw', efSearch: 100, efConstruction: 64, m: 16 }
+	},
+	schema: { schemaName: 'absolute_rag', chunkTableName: 'chunks' }
+});
+
+app.use(ragPlugin({ path: '/rag', collection: rag.collection }));
+```
+
+### Schema and migrations
+
+Inspect the generated SQL or apply migrations explicitly:
+
+```ts
+const schemaPlan = rag.getSchemaPlan();
+const migrationPlan = rag.getMigrationPlan();
+await rag.applyMigrations();
+```
+
+## License
+
+CC BY-NC 4.0

package/dist/index.d.ts

@@ -0,0 +1,122 @@
+import type { RAGBackendCapabilities, RAGCollection, RAGVectorStore, RAGVectorStoreStatus } from '@absolutejs/rag';
+export declare const ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME = "@absolutejs/rag-postgres";
+export declare const POSTGRESQL_RAG_IMPLEMENTATIONS: readonly ["pgvector"];
+export declare const PGVECTOR_DISTANCE_METRICS: readonly ["cosine", "l2", "inner_product"];
+export declare const PGVECTOR_INDEX_TYPES: readonly ["none", "hnsw", "ivfflat"];
+export type PostgreSQLRAGVectorImplementation = 'pgvector';
+export type PgvectorDistanceMetric = 'cosine' | 'l2' | 'inner_product';
+export type PgvectorIndexType = 'none' | 'hnsw' | 'ivfflat';
+export type PostgreSQLRAGClient = {
+    query: <TRow = Record<string, unknown>>(sql: string, params?: unknown[]) => Promise<{
+        rows: TRow[];
+        rowCount?: number;
+    }>;
+    transaction?: <T>(run: (client: PostgreSQLRAGClient) => Promise<T>) => Promise<T>;
+    close?: () => Promise<void>;
+};
+export type PostgreSQLRAGClientFactory = () => Promise<PostgreSQLRAGClient> | PostgreSQLRAGClient;
+export type PostgreSQLRAGSchemaConfig = {
+    schemaName?: string;
+    chunkTableName?: string;
+    migrationTableName?: string;
+};
+export type PgvectorHNSWConfig = {
+    type: 'hnsw';
+    m?: number;
+    efConstruction?: number;
+    efSearch?: number;
+    iterativeScan?: 'off' | 'strict_order' | 'relaxed_order';
+};
+export type PgvectorIVFFlatConfig = {
+    type: 'ivfflat';
+    lists?: number;
+    probes?: number;
+    maxProbes?: number;
+    iterativeScan?: 'off' | 'strict_order' | 'relaxed_order';
+};
+export type PgvectorNoIndexConfig = {
+    type: 'none';
+};
+export type PgvectorIndexConfig = PgvectorNoIndexConfig | PgvectorHNSWConfig | PgvectorIVFFlatConfig;
+export type PgvectorConfig = {
+    provider: 'pgvector';
+    dimensions: number;
+    distanceMetric?: PgvectorDistanceMetric;
+    extensionName?: 'vector' | string;
+    autoCreateExtension?: boolean;
+    autoCreateSchema?: boolean;
+    autoCreateTables?: boolean;
+    autoCreateIndex?: boolean;
+    index?: PgvectorIndexConfig;
+};
+export type PostgreSQLDriverOptions = {
+    max?: number;
+    prepare?: boolean;
+    idle_timeout?: number;
+    connect_timeout?: number;
+    max_lifetime?: number;
+    ssl?: boolean | 'require' | 'allow' | 'prefer' | 'verify-full';
+};
+export type PostgreSQLRAGOptions = {
+    connectionString?: string;
+    client?: PostgreSQLRAGClient;
+    clientFactory?: PostgreSQLRAGClientFactory;
+    driver?: PostgreSQLDriverOptions;
+    schema?: PostgreSQLRAGSchemaConfig;
+    vector: PgvectorConfig;
+    embedding?: RAGVectorStore['embed'];
+};
+export type PostgreSQLSchemaPlan = {
+    implementation: PostgreSQLRAGVectorImplementation;
+    extensionSql: string[];
+    schemaSql: string[];
+    tableSql: string[];
+    indexSql: string[];
+    querySessionSql: string[];
+    migrationTableQualifiedName: string;
+};
+export type PostgreSQLMigrationStage = 'extension' | 'table' | 'index';
+export type PostgreSQLMigrationEntry = {
+    name: string;
+    stage: PostgreSQLMigrationStage;
+    sql: string;
+};
+export type PostgreSQLMigrationPlan = {
+    implementation: PostgreSQLRAGVectorImplementation;
+    schemaName: string;
+    migrationTableName: string;
+    migrationTableQualifiedName: string;
+    bootstrapSql: string[];
+    migrations: PostgreSQLMigrationEntry[];
+    schemaPlan: PostgreSQLSchemaPlan;
+};
+export type PostgreSQLApplyMigrationsOptions = {
+    client?: PostgreSQLRAGClient;
+    dryRun?: boolean;
+};
+export type PostgreSQLApplyMigrationsResult = {
+    migrationPlan: PostgreSQLMigrationPlan;
+    appliedNames: string[];
+    skippedNames: string[];
+    pendingNames: string[];
+    appliedCount: number;
+    pendingCount: number;
+    dryRun: boolean;
+};
+export type PostgreSQLRAG = {
+    store: RAGVectorStore;
+    collection: RAGCollection;
+    getStatus: () => RAGVectorStoreStatus | undefined;
+    getCapabilities: () => RAGBackendCapabilities | undefined;
+    getSchemaPlan: () => PostgreSQLSchemaPlan;
+    getMigrationPlan: () => PostgreSQLMigrationPlan;
+    applyMigrations: (options?: PostgreSQLApplyMigrationsOptions) => Promise<PostgreSQLApplyMigrationsResult>;
+};
+export declare const createPostgresSchemaPlan: (options: PostgreSQLRAGOptions) => PostgreSQLSchemaPlan;
+export declare const createPostgresMigrationPlan: (options: PostgreSQLRAGOptions) => PostgreSQLMigrationPlan;
+export declare const applyPostgresMigrations: (options: PostgreSQLRAGOptions, applyOptions?: PostgreSQLApplyMigrationsOptions) => Promise<PostgreSQLApplyMigrationsResult>;
+export declare const applyPostgresSchemaPlan: typeof applyPostgresMigrations;
+export declare const createPgvectorStore: (options: PostgreSQLRAGOptions) => RAGVectorStore;
+export declare const createPostgresRAGCollection: (options: PostgreSQLRAGOptions) => RAGCollection;
+export declare const createPostgresRAG: (options: PostgreSQLRAGOptions) => PostgreSQLRAG;
+export declare const createPostgreSQLRAG: typeof createPostgresRAG;

package/dist/index.js

@@ -0,0 +1,622 @@
+// @bun
+var __require = import.meta.require;
+
+// src/index.ts
+import {
+  createRAGCollection,
+  createRAGVector,
+  normalizeVector
+} from "@absolutejs/rag";
+var ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME = "@absolutejs/rag-postgres";
+var POSTGRESQL_RAG_IMPLEMENTATIONS = ["pgvector"];
+var PGVECTOR_DISTANCE_METRICS = [
+  "cosine",
+  "l2",
+  "inner_product"
+];
+var PGVECTOR_INDEX_TYPES = ["none", "hnsw", "ivfflat"];
+var DEFAULT_SCHEMA_NAME = "absolute_rag";
+var DEFAULT_CHUNK_TABLE_NAME = "chunks";
+var DEFAULT_MIGRATION_TABLE_NAME = "migrations";
+var DEFAULT_DIMENSIONS = 1536;
+var IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+var assertIdentifier = (value, label) => {
+  if (typeof value !== "string" || !IDENTIFIER_RE.test(value)) {
+    throw new Error(`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: invalid ${label} "${String(value)}"`);
+  }
+};
+var quoteIdentifier = (value) => {
+  assertIdentifier(value, "identifier");
+  return `"${value}"`;
+};
+var qualifiedTable = (schemaName, tableName) => `${quoteIdentifier(schemaName)}.${quoteIdentifier(tableName)}`;
+var escapeLiteral = (value) => value.replace(/'/g, "''");
+var vectorLiteral = (vector) => {
+  if (!Array.isArray(vector) || vector.length === 0) {
+    throw new Error(`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: vector values must be a non-empty array`);
+  }
+  return `[${vector.map((value) => {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+      throw new Error(`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: vector values must be finite numbers`);
+    }
+    return String(value);
+  }).join(",")}]`;
+};
+var makePlaceholder = (params, value, cast = "") => {
+  params.push(value);
+  const suffix = cast ? `::${cast}` : "";
+  return `$${params.length}${suffix}`;
+};
+var normalizeMetric = (metric) => {
+  if (metric === "l2" || metric === "inner_product") {
+    return metric;
+  }
+  return "cosine";
+};
+var normalizeIndex = (index) => {
+  if (!index || index.type === undefined) {
+    return { type: "none" };
+  }
+  if (index.type === "hnsw" || index.type === "ivfflat" || index.type === "none") {
+    return index;
+  }
+  throw new Error(`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: unsupported pgvector index type "${String(index.type)}"`);
+};
+var resolveSchemaConfig = (options) => {
+  const schemaName = options.schema?.schemaName ?? DEFAULT_SCHEMA_NAME;
+  const chunkTableName = options.schema?.chunkTableName ?? DEFAULT_CHUNK_TABLE_NAME;
+  const migrationTableName = options.schema?.migrationTableName ?? DEFAULT_MIGRATION_TABLE_NAME;
+  assertIdentifier(schemaName, "schema name");
+  assertIdentifier(chunkTableName, "chunk table name");
+  assertIdentifier(migrationTableName, "migration table name");
+  return {
+    schemaName,
+    chunkTableName,
+    migrationTableName
+  };
+};
+var resolveVectorConfig = (options) => {
+  const vector = options?.vector;
+  if (!vector || vector.provider !== "pgvector") {
+    throw new Error(`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: PostgreSQL RAG currently requires vector.provider = "pgvector"`);
+  }
+  const dimensions = vector.dimensions ?? DEFAULT_DIMENSIONS;
+  if (!Number.isInteger(dimensions) || dimensions <= 0) {
+    throw new Error(`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: dimensions must be a positive integer`);
+  }
+  const distanceMetric = normalizeMetric(vector.distanceMetric);
+  const index = normalizeIndex(vector.index);
+  return {
+    ...vector,
+    dimensions,
+    distanceMetric,
+    extensionName: vector.extensionName ?? "vector",
+    index
+  };
+};
+var operatorForMetric = (distanceMetric) => {
+  switch (distanceMetric) {
+    case "l2":
+      return "<->";
+    case "inner_product":
+      return "<#>";
+    case "cosine":
+    default:
+      return "<=>";
+  }
+};
+var operatorClassForMetric = (distanceMetric) => {
+  switch (distanceMetric) {
+    case "l2":
+      return "vector_l2_ops";
+    case "inner_product":
+      return "vector_ip_ops";
+    case "cosine":
+    default:
+      return "vector_cosine_ops";
+  }
+};
+var scoreFromDistance = (distance, distanceMetric) => {
+  if (typeof distance !== "number" || !Number.isFinite(distance)) {
+    return 0;
+  }
+  switch (distanceMetric) {
+    case "inner_product":
+      return -distance;
+    case "l2":
+      return 1 / (1 + Math.abs(distance));
+    case "cosine":
+    default:
+      return 1 - distance;
+  }
+};
+var createIndexSql = ({
+  schemaName,
+  chunkTableName,
+  distanceMetric,
+  index
+}) => {
+  if (!index || index.type === "none") {
+    return [];
+  }
+  const qualifiedChunkTable = qualifiedTable(schemaName, chunkTableName);
+  const opClass = operatorClassForMetric(distanceMetric);
+  const indexName = `${chunkTableName}_embedding_${index.type}_${distanceMetric}_idx`;
+  const withParts = [];
+  if (index.type === "hnsw") {
+    if (Number.isInteger(index.m) && (index.m ?? 0) > 0) {
+      withParts.push(`m = ${index.m}`);
+    }
+    if (Number.isInteger(index.efConstruction) && (index.efConstruction ?? 0) > 0) {
+      withParts.push(`ef_construction = ${index.efConstruction}`);
+    }
+  }
+  if (index.type === "ivfflat" && Number.isInteger(index.lists) && (index.lists ?? 0) > 0) {
+    withParts.push(`lists = ${index.lists}`);
+  }
+  const withClause = withParts.length > 0 ? ` WITH (${withParts.join(", ")})` : "";
+  return [
+    `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(indexName)} ON ${qualifiedChunkTable} USING ${index.type} (embedding ${opClass})${withClause}`
+  ];
+};
+var createQuerySessionSql = ({
+  index
+}) => {
+  if (!index || index.type === "none") {
+    return [];
+  }
+  const sql = [];
+  if (index.type === "hnsw") {
+    if (Number.isInteger(index.efSearch) && (index.efSearch ?? 0) > 0) {
+      sql.push(`SET LOCAL hnsw.ef_search = ${index.efSearch}`);
+    }
+    if (index.iterativeScan && index.iterativeScan !== "off") {
+      sql.push(`SET LOCAL hnsw.iterative_scan = '${escapeLiteral(index.iterativeScan)}'`);
+    }
+  }
+  if (index.type === "ivfflat") {
+    if (Number.isInteger(index.probes) && (index.probes ?? 0) > 0) {
+      sql.push(`SET LOCAL ivfflat.probes = ${index.probes}`);
+    }
+    if (Number.isInteger(index.maxProbes) && (index.maxProbes ?? 0) > 0) {
+      sql.push(`SET LOCAL ivfflat.max_probes = ${index.maxProbes}`);
+    }
+    if (index.iterativeScan && index.iterativeScan !== "off") {
+      sql.push(`SET LOCAL ivfflat.iterative_scan = '${escapeLiteral(index.iterativeScan)}'`);
+    }
+  }
+  return sql;
+};
+var stageOrder = [
+  "extension",
+  "schema",
+  "table",
+  "index"
+];
+var buildMigrationName = (stage, stageIndex, sql) => {
+  const normalized = sql.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 48) || "statement";
+  const globalOrder = String(stageOrder.indexOf(stage) + 1).padStart(2, "0");
+  const localOrder = String(stageIndex + 1).padStart(3, "0");
+  return `${globalOrder}_${stage}_${localOrder}_${normalized}`;
+};
+var createMigrationTableSql = (schemaName, migrationTableName) => `CREATE TABLE IF NOT EXISTS ${qualifiedTable(schemaName, migrationTableName)} (name TEXT PRIMARY KEY, applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW())`;
+var filterTrackedTableSql = (tableSql, schemaName, migrationTableName) => {
+  const migrationTableTarget = qualifiedTable(schemaName, migrationTableName);
+  return tableSql.filter((sql) => !sql.includes(migrationTableTarget));
+};
+var createPostgresSchemaPlan = (options) => {
+  const schema = resolveSchemaConfig(options ?? {});
+  const vector = resolveVectorConfig(options ?? {});
+  const qualifiedChunkTable = qualifiedTable(schema.schemaName, schema.chunkTableName);
+  const qualifiedMigrationTable = qualifiedTable(schema.schemaName, schema.migrationTableName);
+  const extensionSql = vector.autoCreateExtension === false ? [] : [
+    `CREATE EXTENSION IF NOT EXISTS ${quoteIdentifier(vector.extensionName)}`
+  ];
+  const schemaSql = vector.autoCreateSchema === false ? [] : [
+    `CREATE SCHEMA IF NOT EXISTS ${quoteIdentifier(schema.schemaName)}`
+  ];
+  const tableSql = vector.autoCreateTables === false ? [] : [
+    `CREATE TABLE IF NOT EXISTS ${qualifiedChunkTable} (id BIGSERIAL PRIMARY KEY, chunk_id TEXT NOT NULL UNIQUE, text TEXT NOT NULL, title TEXT, source TEXT, metadata JSONB NOT NULL DEFAULT '{}'::jsonb, embedding VECTOR(${vector.dimensions}) NOT NULL, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW())`,
+    `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(`${schema.chunkTableName}_chunk_id_idx`)} ON ${qualifiedChunkTable} (chunk_id)`,
+    `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(`${schema.chunkTableName}_source_idx`)} ON ${qualifiedChunkTable} (source)`,
+    `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(`${schema.chunkTableName}_metadata_idx`)} ON ${qualifiedChunkTable} USING GIN (metadata)`,
+    createMigrationTableSql(schema.schemaName, schema.migrationTableName)
+  ];
+  const indexSql = vector.autoCreateIndex === false ? [] : createIndexSql({
+    schemaName: schema.schemaName,
+    chunkTableName: schema.chunkTableName,
+    distanceMetric: vector.distanceMetric,
+    index: vector.index
+  });
+  return {
+    implementation: "pgvector",
+    extensionSql,
+    schemaSql,
+    tableSql,
+    indexSql,
+    querySessionSql: createQuerySessionSql({ index: vector.index }),
+    migrationTableQualifiedName: qualifiedMigrationTable
+  };
+};
+var createPostgresMigrationPlan = (options) => {
+  const schema = resolveSchemaConfig(options ?? {});
+  const schemaPlan = createPostgresSchemaPlan(options ?? {});
+  const bootstrapSql = [];
+  if (schemaPlan.schemaSql.length > 0) {
+    bootstrapSql.push(...schemaPlan.schemaSql);
+  }
+  const migrationTableSql = createMigrationTableSql(schema.schemaName, schema.migrationTableName);
+  if (!bootstrapSql.includes(migrationTableSql)) {
+    bootstrapSql.push(migrationTableSql);
+  }
+  const migrations = [
+    ...schemaPlan.extensionSql.map((sql, index) => ({
+      stage: "extension",
+      sql,
+      stageIndex: index
+    })),
+    ...filterTrackedTableSql(schemaPlan.tableSql, schema.schemaName, schema.migrationTableName).map((sql, index) => ({
+      stage: "table",
+      sql,
+      stageIndex: index
+    })),
+    ...schemaPlan.indexSql.map((sql, index) => ({
+      stage: "index",
+      sql,
+      stageIndex: index
+    }))
+  ].map((entry) => ({
+    name: buildMigrationName(entry.stage, entry.stageIndex, entry.sql),
+    stage: entry.stage,
+    sql: entry.sql
+  }));
+  return {
+    implementation: schemaPlan.implementation,
+    schemaName: schema.schemaName,
+    migrationTableName: schema.migrationTableName,
+    migrationTableQualifiedName: qualifiedTable(schema.schemaName, schema.migrationTableName),
+    bootstrapSql,
+    migrations,
+    schemaPlan
+  };
+};
+var createWrappedPostgresClient = (sql, rootSql = sql) => ({
+  query: async (queryText, params = []) => {
+    const rows = await sql.unsafe(queryText, params);
+    return {
+      rows,
+      rowCount: typeof rows.count === "number" ? rows.count : rows.length
+    };
+  },
+  transaction: async (run) => rootSql.begin(async (transactionSql) => run(createWrappedPostgresClient(transactionSql, transactionSql))),
+  close: async () => {
+    if (typeof rootSql.end === "function") {
+      await rootSql.end({ timeout: 5 });
+    }
+  }
+});
+var createDefaultPostgresClientFactory = (options) => {
+  const connectionString = typeof options.connectionString === "string" ? options.connectionString.trim() : "";
+  if (connectionString.length === 0) {
+    return;
+  }
+  let clientPromise;
+  return async () => {
+    if (!clientPromise) {
+      clientPromise = (async () => {
+        const postgresModule = await import("postgres");
+        const postgres = postgresModule.default;
+        const sql = postgres(connectionString, {
+          onnotice: () => {},
+          ...options.driver ?? {}
+        });
+        return createWrappedPostgresClient(sql, sql);
+      })();
+    }
+    return clientPromise;
+  };
+};
+var resolveClientFactory = (options) => {
+  if (typeof options.clientFactory === "function") {
+    const { clientFactory } = options;
+    return async () => clientFactory();
+  }
+  if (options.client) {
+    const { client } = options;
+    return async () => client;
+  }
+  const defaultFactory = createDefaultPostgresClientFactory(options);
+  if (defaultFactory) {
+    return defaultFactory;
+  }
+  return async () => {
+    throw new Error(`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: createPostgresRAG requires connectionString, client, or clientFactory.`);
+  };
+};
+var buildMetadataFilter = (filter) => {
+  if (!filter) {
+    return;
+  }
+  const metadataEntries = Object.entries(filter).filter(([key]) => key !== "chunkId" && key !== "title" && key !== "source");
+  if (metadataEntries.length === 0) {
+    return;
+  }
+  return Object.fromEntries(metadataEntries);
+};
+var parseMetadataValue = (value) => {
+  if (value === null || value === undefined) {
+    return;
+  }
+  if (typeof value === "string") {
+    try {
+      const parsed = JSON.parse(value);
+      if (parsed && typeof parsed === "object") {
+        return parsed;
+      }
+    } catch {
+      return;
+    }
+  }
+  if (typeof value === "object") {
+    return value;
+  }
+  return;
+};
+var createPgvectorStoreStatus = ({
+  vector,
+  schema,
+  diagnostics,
+  initialized
+}) => ({
+  backend: "postgres",
+  vectorMode: "native_pgvector",
+  dimensions: vector.dimensions,
+  native: {
+    requested: true,
+    available: initialized && !diagnostics.lastInitError,
+    active: initialized && !diagnostics.lastInitError,
+    mode: "pgvector",
+    extensionName: vector.extensionName,
+    schemaName: schema.schemaName,
+    tableName: schema.chunkTableName,
+    distanceMetric: vector.distanceMetric,
+    indexType: vector.index.type,
+    fallbackReason: diagnostics.fallbackReason,
+    lastInitError: diagnostics.lastInitError,
+    lastQueryError: diagnostics.lastQueryError,
+    lastUpsertError: diagnostics.lastUpsertError,
+    lastMigrationError: diagnostics.lastMigrationError
+  }
+});
+var getAppliedMigrationNames = async (client, migrationPlan) => {
+  const result = await client.query(`SELECT name FROM ${migrationPlan.migrationTableQualifiedName} ORDER BY name ASC`);
+  return new Set(result.rows.map((row) => String(row.name)));
+};
+var insertAppliedMigration = async (client, migrationPlan, name) => {
+  await client.query(`INSERT INTO ${migrationPlan.migrationTableQualifiedName} (name) VALUES ($1) ON CONFLICT (name) DO NOTHING`, [name]);
+};
+var executeMigrationSequence = async (client, migrationPlan, migrations) => {
+  const appliedNames = [];
+  for (const migration of migrations) {
+    await client.query(migration.sql);
+    await insertAppliedMigration(client, migrationPlan, migration.name);
+    appliedNames.push(migration.name);
+  }
+  return appliedNames;
+};
+var applyPostgresMigrations = async (options, applyOptions = {}) => {
+  const migrationPlan = createPostgresMigrationPlan(options ?? {});
+  const injectedClient = applyOptions.client;
+  const getClient = injectedClient ? async () => injectedClient : resolveClientFactory(options ?? {});
+  const client = await getClient();
+  for (const sql of migrationPlan.bootstrapSql) {
+    await client.query(sql);
+  }
+  const alreadyApplied = await getAppliedMigrationNames(client, migrationPlan);
+  const pendingMigrations = migrationPlan.migrations.filter((migration) => !alreadyApplied.has(migration.name));
+  const skippedNames = migrationPlan.migrations.filter((migration) => alreadyApplied.has(migration.name)).map((migration) => migration.name);
+  if (applyOptions.dryRun === true) {
+    return {
+      migrationPlan,
+      appliedNames: [],
+      skippedNames,
+      pendingNames: pendingMigrations.map((migration) => migration.name),
+      appliedCount: 0,
+      pendingCount: pendingMigrations.length,
+      dryRun: true
+    };
+  }
+  const run = async (activeClient) => {
+    const names = await executeMigrationSequence(activeClient, migrationPlan, pendingMigrations);
+    return {
+      migrationPlan,
+      appliedNames: names,
+      skippedNames,
+      pendingNames: pendingMigrations.map((migration) => migration.name),
+      appliedCount: names.length,
+      pendingCount: pendingMigrations.length,
+      dryRun: false
+    };
+  };
+  if (typeof client.transaction === "function" && pendingMigrations.length > 0) {
+    return client.transaction(async (transactionClient) => run(transactionClient));
+  }
+  return run(client);
+};
+var applyPostgresSchemaPlan = applyPostgresMigrations;
+var createPgvectorStore = (options) => {
+  const vector = resolveVectorConfig(options ?? {});
+  const schema = resolveSchemaConfig(options ?? {});
+  const plan = createPostgresSchemaPlan(options ?? {});
+  const getClient = resolveClientFactory(options ?? {});
+  const diagnostics = {
+    fallbackReason: undefined,
+    lastInitError: undefined,
+    lastQueryError: undefined,
+    lastUpsertError: undefined,
+    lastMigrationError: undefined
+  };
+  let initialized = false;
+  let initPromise;
+  const ensureInitialized = async () => {
+    if (initialized) {
+      return;
+    }
+    if (!initPromise) {
+      initPromise = (async () => {
+        try {
+          const client = await getClient();
+          await applyPostgresMigrations(options ?? {}, { client });
+          initialized = true;
+          diagnostics.lastInitError = undefined;
+          diagnostics.lastMigrationError = undefined;
+          diagnostics.fallbackReason = undefined;
+        } catch (error) {
+          initialized = false;
+          const message = error instanceof Error ? error.message : String(error);
+          diagnostics.lastInitError = message;
+          diagnostics.lastMigrationError = message;
+          diagnostics.fallbackReason = message;
+          throw error;
+        }
+      })();
+    }
+    return initPromise;
+  };
+  const embed = async (input) => {
+    if (typeof options.embedding === "function") {
+      const result = await options.embedding(input);
+      return normalizeVector(result);
+    }
+    return normalizeVector([
+      ...createRAGVector(input.text, vector.dimensions)
+    ]);
+  };
+  const query = async (input) => {
+    await ensureInitialized();
+    const client = await getClient();
+    const params = [];
+    const qualifiedChunkTable = qualifiedTable(schema.schemaName, schema.chunkTableName);
+    const operator = operatorForMetric(vector.distanceMetric);
+    const vectorPlaceholder = makePlaceholder(params, vectorLiteral(normalizeVector(input.queryVector)), "vector");
+    const limitPlaceholder = makePlaceholder(params, input.topK);
+    const whereParts = [];
+    const filter = input.filter;
+    if (filter?.chunkId !== undefined) {
+      whereParts.push(`chunk_id = ${makePlaceholder(params, filter.chunkId)}`);
+    }
+    if (filter?.title !== undefined) {
+      whereParts.push(`title = ${makePlaceholder(params, filter.title)}`);
+    }
+    if (filter?.source !== undefined) {
+      whereParts.push(`source = ${makePlaceholder(params, filter.source)}`);
+    }
+    const metadataFilter = buildMetadataFilter(filter);
+    if (metadataFilter) {
+      whereParts.push(`metadata @> ${makePlaceholder(params, JSON.stringify(metadataFilter), "jsonb")}`);
+    }
+    const whereSql = whereParts.length > 0 ? `WHERE ${whereParts.join(" AND ")}` : "";
+    const sessionSql = plan.querySessionSql;
+    const selectSql = `SELECT chunk_id, text, title, source, metadata, embedding ${operator} ${vectorPlaceholder} AS distance FROM ${qualifiedChunkTable} ${whereSql} ORDER BY distance ASC LIMIT ${limitPlaceholder}`;
+    try {
+      for (const sql of sessionSql) {
+        await client.query(sql);
+      }
+      const result = await client.query(selectSql, params);
+      return result.rows.map((row) => ({
+        chunkId: row.chunk_id,
+        chunkText: row.text,
+        title: row.title ?? undefined,
+        source: row.source ?? undefined,
+        metadata: parseMetadataValue(row.metadata),
+        score: scoreFromDistance(Number(row.distance), vector.distanceMetric)
+      }));
+    } catch (error) {
+      diagnostics.lastQueryError = error instanceof Error ? error.message : String(error);
+      throw error;
+    }
+  };
+  const upsert = async (input) => {
+    await ensureInitialized();
+    const client = await getClient();
+    const qualifiedChunkTable = qualifiedTable(schema.schemaName, schema.chunkTableName);
+    const sql = `INSERT INTO ${qualifiedChunkTable} (chunk_id, text, title, source, metadata, embedding, updated_at) VALUES ($1, $2, $3, $4, $5::jsonb, $6::vector, NOW()) ON CONFLICT (chunk_id) DO UPDATE SET text = EXCLUDED.text, title = EXCLUDED.title, source = EXCLUDED.source, metadata = EXCLUDED.metadata, embedding = EXCLUDED.embedding, updated_at = NOW()`;
+    try {
+      for (const chunk of input.chunks) {
+        const vectorValue = Array.isArray(chunk.embedding) && chunk.embedding.length > 0 ? normalizeVector(chunk.embedding) : await embed({ text: chunk.text });
+        await client.query(sql, [
+          chunk.chunkId,
+          chunk.text,
+          chunk.title ?? null,
+          chunk.source ?? null,
+          JSON.stringify(chunk.metadata ?? {}),
+          vectorLiteral(vectorValue)
+        ]);
+      }
+    } catch (error) {
+      diagnostics.lastUpsertError = error instanceof Error ? error.message : String(error);
+      throw error;
+    }
+  };
+  const clear = async () => {
+    await ensureInitialized();
+    const client = await getClient();
+    const qualifiedChunkTable = qualifiedTable(schema.schemaName, schema.chunkTableName);
+    await client.query(`DELETE FROM ${qualifiedChunkTable}`);
+  };
+  return {
+    embed,
+    query,
+    upsert,
+    clear,
+    getCapabilities: () => ({
+      backend: "postgres",
+      persistence: "external",
+      nativeVectorSearch: true,
+      serverSideFiltering: true,
+      streamingIngestStatus: false
+    }),
+    getStatus: () => createPgvectorStoreStatus({
+      vector,
+      schema,
+      diagnostics,
+      initialized
+    })
+  };
+};
+var createPostgresRAGCollection = (options) => createRAGCollection({
+  store: createPgvectorStore(options)
+});
+var createPostgresRAG = (options) => {
+  const store = createPgvectorStore(options);
+  const collection = createRAGCollection({ store });
+  const schemaPlan = createPostgresSchemaPlan(options);
+  const migrationPlan = createPostgresMigrationPlan(options);
+  return {
+    store,
+    collection,
+    getStatus: () => store.getStatus?.(),
+    getCapabilities: () => store.getCapabilities?.(),
+    getSchemaPlan: () => schemaPlan,
+    getMigrationPlan: () => migrationPlan,
+    applyMigrations: (applyOptions) => applyPostgresMigrations(options, applyOptions)
+  };
+};
+var createPostgreSQLRAG = createPostgresRAG;
+export {
+  createPostgresSchemaPlan,
+  createPostgresRAGCollection,
+  createPostgresRAG,
+  createPostgresMigrationPlan,
+  createPostgreSQLRAG,
+  createPgvectorStore,
+  applyPostgresSchemaPlan,
+  applyPostgresMigrations,
+  POSTGRESQL_RAG_IMPLEMENTATIONS,
+  PGVECTOR_INDEX_TYPES,
+  PGVECTOR_DISTANCE_METRICS,
+  ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME
+};
+
+//# debugId=22931C2F3EFA23C264756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "import type {\n\tRAGBackendCapabilities,\n\tRAGCollection,\n\tRAGQueryInput,\n\tRAGQueryResult,\n\tRAGUpsertInput,\n\tRAGVectorStore,\n\tRAGVectorStoreStatus\n} from '@absolutejs/rag';\nimport {\n\tcreateRAGCollection,\n\tcreateRAGVector,\n\tnormalizeVector\n} from '@absolutejs/rag';\n\nexport const ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME = '@absolutejs/rag-postgres';\n\nexport const POSTGRESQL_RAG_IMPLEMENTATIONS = ['pgvector'] as const;\nexport const PGVECTOR_DISTANCE_METRICS = [\n\t'cosine',\n\t'l2',\n\t'inner_product'\n] as const;\nexport const PGVECTOR_INDEX_TYPES = ['none', 'hnsw', 'ivfflat'] as const;\n\nexport type PostgreSQLRAGVectorImplementation = 'pgvector';\nexport type PgvectorDistanceMetric = 'cosine' | 'l2' | 'inner_product';\nexport type PgvectorIndexType = 'none' | 'hnsw' | 'ivfflat';\n\nexport type PostgreSQLRAGClient = {\n\tquery: <TRow = Record<string, unknown>>(\n\t\tsql: string,\n\t\tparams?: unknown[]\n\t) => Promise<{\n\t\trows: TRow[];\n\t\trowCount?: number;\n\t}>;\n\ttransaction?: <T>(\n\t\trun: (client: PostgreSQLRAGClient) => Promise<T>\n\t) => Promise<T>;\n\tclose?: () => Promise<void>;\n};\n\nexport type PostgreSQLRAGClientFactory = () =>\n\t| Promise<PostgreSQLRAGClient>\n\t| PostgreSQLRAGClient;\n\nexport type PostgreSQLRAGSchemaConfig = {\n\tschemaName?: string;\n\tchunkTableName?: string;\n\tmigrationTableName?: string;\n};\n\nexport type PgvectorHNSWConfig = {\n\ttype: 'hnsw';\n\tm?: number;\n\tefConstruction?: number;\n\tefSearch?: number;\n\titerativeScan?: 'off' | 'strict_order' | 'relaxed_order';\n};\n\nexport type PgvectorIVFFlatConfig = {\n\ttype: 'ivfflat';\n\tlists?: number;\n\tprobes?: number;\n\tmaxProbes?: number;\n\titerativeScan?: 'off' | 'strict_order' | 'relaxed_order';\n};\n\nexport type PgvectorNoIndexConfig = {\n\ttype: 'none';\n};\n\nexport type PgvectorIndexConfig =\n\t| PgvectorNoIndexConfig\n\t| PgvectorHNSWConfig\n\t| PgvectorIVFFlatConfig;\n\nexport type PgvectorConfig = {\n\tprovider: 'pgvector';\n\tdimensions: number;\n\tdistanceMetric?: PgvectorDistanceMetric;\n\textensionName?: 'vector' | string;\n\tautoCreateExtension?: boolean;\n\tautoCreateSchema?: boolean;\n\tautoCreateTables?: boolean;\n\tautoCreateIndex?: boolean;\n\tindex?: PgvectorIndexConfig;\n};\n\nexport type PostgreSQLDriverOptions = {\n\tmax?: number;\n\tprepare?: boolean;\n\tidle_timeout?: number;\n\tconnect_timeout?: number;\n\tmax_lifetime?: number;\n\tssl?: boolean | 'require' | 'allow' | 'prefer' | 'verify-full';\n};\n\nexport type PostgreSQLRAGOptions = {\n\tconnectionString?: string;\n\tclient?: PostgreSQLRAGClient;\n\tclientFactory?: PostgreSQLRAGClientFactory;\n\tdriver?: PostgreSQLDriverOptions;\n\tschema?: PostgreSQLRAGSchemaConfig;\n\tvector: PgvectorConfig;\n\tembedding?: RAGVectorStore['embed'];\n};\n\nexport type PostgreSQLSchemaPlan = {\n\timplementation: PostgreSQLRAGVectorImplementation;\n\textensionSql: string[];\n\tschemaSql: string[];\n\ttableSql: string[];\n\tindexSql: string[];\n\tquerySessionSql: string[];\n\tmigrationTableQualifiedName: string;\n};\n\nexport type PostgreSQLMigrationStage = 'extension' | 'table' | 'index';\n\nexport type PostgreSQLMigrationEntry = {\n\tname: string;\n\tstage: PostgreSQLMigrationStage;\n\tsql: string;\n};\n\nexport type PostgreSQLMigrationPlan = {\n\timplementation: PostgreSQLRAGVectorImplementation;\n\tschemaName: string;\n\tmigrationTableName: string;\n\tmigrationTableQualifiedName: string;\n\tbootstrapSql: string[];\n\tmigrations: PostgreSQLMigrationEntry[];\n\tschemaPlan: PostgreSQLSchemaPlan;\n};\n\nexport type PostgreSQLApplyMigrationsOptions = {\n\tclient?: PostgreSQLRAGClient;\n\tdryRun?: boolean;\n};\n\nexport type PostgreSQLApplyMigrationsResult = {\n\tmigrationPlan: PostgreSQLMigrationPlan;\n\tappliedNames: string[];\n\tskippedNames: string[];\n\tpendingNames: string[];\n\tappliedCount: number;\n\tpendingCount: number;\n\tdryRun: boolean;\n};\n\nexport type PostgreSQLRAG = {\n\tstore: RAGVectorStore;\n\tcollection: RAGCollection;\n\tgetStatus: () => RAGVectorStoreStatus | undefined;\n\tgetCapabilities: () => RAGBackendCapabilities | undefined;\n\tgetSchemaPlan: () => PostgreSQLSchemaPlan;\n\tgetMigrationPlan: () => PostgreSQLMigrationPlan;\n\tapplyMigrations: (\n\t\toptions?: PostgreSQLApplyMigrationsOptions\n\t) => Promise<PostgreSQLApplyMigrationsResult>;\n};\n\ntype ResolvedSchemaConfig = {\n\tschemaName: string;\n\tchunkTableName: string;\n\tmigrationTableName: string;\n};\n\ntype ResolvedPgvectorConfig = PgvectorConfig & {\n\tdimensions: number;\n\tdistanceMetric: PgvectorDistanceMetric;\n\textensionName: string;\n\tindex: PgvectorIndexConfig;\n};\n\ntype PgvectorDiagnostics = {\n\tfallbackReason: string | undefined;\n\tlastInitError: string | undefined;\n\tlastQueryError: string | undefined;\n\tlastUpsertError: string | undefined;\n\tlastMigrationError: string | undefined;\n};\n\nconst DEFAULT_SCHEMA_NAME = 'absolute_rag';\nconst DEFAULT_CHUNK_TABLE_NAME = 'chunks';\nconst DEFAULT_MIGRATION_TABLE_NAME = 'migrations';\nconst DEFAULT_DIMENSIONS = 1536;\n\nconst IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\nconst assertIdentifier = (value: unknown, label: string): void => {\n\tif (typeof value !== 'string' || !IDENTIFIER_RE.test(value)) {\n\t\tthrow new Error(\n\t\t\t`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: invalid ${label} \"${String(\n\t\t\t\tvalue\n\t\t\t)}\"`\n\t\t);\n\t}\n};\n\nconst quoteIdentifier = (value: string): string => {\n\tassertIdentifier(value, 'identifier');\n\n\treturn `\"${value}\"`;\n};\n\nconst qualifiedTable = (schemaName: string, tableName: string): string =>\n\t`${quoteIdentifier(schemaName)}.${quoteIdentifier(tableName)}`;\n\nconst escapeLiteral = (value: string): string => value.replace(/'/g, \"''\");\n\nconst vectorLiteral = (vector: unknown): string => {\n\tif (!Array.isArray(vector) || vector.length === 0) {\n\t\tthrow new Error(\n\t\t\t`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: vector values must be a non-empty array`\n\t\t);\n\t}\n\n\treturn `[${vector\n\t\t.map((value) => {\n\t\t\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: vector values must be finite numbers`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\treturn String(value);\n\t\t})\n\t\t.join(',')}]`;\n};\n\nconst makePlaceholder = (\n\tparams: unknown[],\n\tvalue: unknown,\n\tcast = ''\n): string => {\n\tparams.push(value);\n\tconst suffix = cast ? `::${cast}` : '';\n\n\treturn `$${params.length}${suffix}`;\n};\n\nconst normalizeMetric = (\n\tmetric: PgvectorDistanceMetric | undefined\n): PgvectorDistanceMetric => {\n\tif (metric === 'l2' || metric === 'inner_product') {\n\t\treturn metric;\n\t}\n\n\treturn 'cosine';\n};\n\nconst normalizeIndex = (\n\tindex: PgvectorIndexConfig | undefined\n): PgvectorIndexConfig => {\n\tif (!index || index.type === undefined) {\n\t\treturn { type: 'none' };\n\t}\n\n\tif (\n\t\tindex.type === 'hnsw' ||\n\t\tindex.type === 'ivfflat' ||\n\t\tindex.type === 'none'\n\t) {\n\t\treturn index;\n\t}\n\n\tthrow new Error(\n\t\t`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: unsupported pgvector index type \"${String(\n\t\t\t(index as { type: unknown }).type\n\t\t)}\"`\n\t);\n};\n\nconst resolveSchemaConfig = (\n\toptions: Partial<PostgreSQLRAGOptions>\n): ResolvedSchemaConfig => {\n\tconst schemaName = options.schema?.schemaName ?? DEFAULT_SCHEMA_NAME;\n\tconst chunkTableName =\n\t\toptions.schema?.chunkTableName ?? DEFAULT_CHUNK_TABLE_NAME;\n\tconst migrationTableName =\n\t\toptions.schema?.migrationTableName ?? DEFAULT_MIGRATION_TABLE_NAME;\n\n\tassertIdentifier(schemaName, 'schema name');\n\tassertIdentifier(chunkTableName, 'chunk table name');\n\tassertIdentifier(migrationTableName, 'migration table name');\n\n\treturn {\n\t\tschemaName,\n\t\tchunkTableName,\n\t\tmigrationTableName\n\t};\n};\n\nconst resolveVectorConfig = (\n\toptions: Partial<PostgreSQLRAGOptions>\n): ResolvedPgvectorConfig => {\n\tconst vector = options?.vector;\n\n\tif (!vector || vector.provider !== 'pgvector') {\n\t\tthrow new Error(\n\t\t\t`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: PostgreSQL RAG currently requires vector.provider = \"pgvector\"`\n\t\t);\n\t}\n\n\tconst dimensions = vector.dimensions ?? DEFAULT_DIMENSIONS;\n\tif (!Number.isInteger(dimensions) || dimensions <= 0) {\n\t\tthrow new Error(\n\t\t\t`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: dimensions must be a positive integer`\n\t\t);\n\t}\n\n\tconst distanceMetric = normalizeMetric(vector.distanceMetric);\n\tconst index = normalizeIndex(vector.index);\n\n\treturn {\n\t\t...vector,\n\t\tdimensions,\n\t\tdistanceMetric,\n\t\textensionName: vector.extensionName ?? 'vector',\n\t\tindex\n\t};\n};\n\nconst operatorForMetric = (distanceMetric: PgvectorDistanceMetric): string => {\n\tswitch (distanceMetric) {\n\t\tcase 'l2':\n\t\t\treturn '<->';\n\t\tcase 'inner_product':\n\t\t\treturn '<#>';\n\t\tcase 'cosine':\n\t\tdefault:\n\t\t\treturn '<=>';\n\t}\n};\n\nconst operatorClassForMetric = (\n\tdistanceMetric: PgvectorDistanceMetric\n): string => {\n\tswitch (distanceMetric) {\n\t\tcase 'l2':\n\t\t\treturn 'vector_l2_ops';\n\t\tcase 'inner_product':\n\t\t\treturn 'vector_ip_ops';\n\t\tcase 'cosine':\n\t\tdefault:\n\t\t\treturn 'vector_cosine_ops';\n\t}\n};\n\nconst scoreFromDistance = (\n\tdistance: unknown,\n\tdistanceMetric: PgvectorDistanceMetric\n): number => {\n\tif (typeof distance !== 'number' || !Number.isFinite(distance)) {\n\t\treturn 0;\n\t}\n\n\tswitch (distanceMetric) {\n\t\tcase 'inner_product':\n\t\t\treturn -distance;\n\t\tcase 'l2':\n\t\t\treturn 1 / (1 + Math.abs(distance));\n\t\tcase 'cosine':\n\t\tdefault:\n\t\t\treturn 1 - distance;\n\t}\n};\n\nconst createIndexSql = ({\n\tschemaName,\n\tchunkTableName,\n\tdistanceMetric,\n\tindex\n}: {\n\tschemaName: string;\n\tchunkTableName: string;\n\tdistanceMetric: PgvectorDistanceMetric;\n\tindex: PgvectorIndexConfig;\n}): string[] => {\n\tif (!index || index.type === 'none') {\n\t\treturn [];\n\t}\n\n\tconst qualifiedChunkTable = qualifiedTable(schemaName, chunkTableName);\n\tconst opClass = operatorClassForMetric(distanceMetric);\n\tconst indexName = `${chunkTableName}_embedding_${index.type}_${distanceMetric}_idx`;\n\tconst withParts: string[] = [];\n\n\tif (index.type === 'hnsw') {\n\t\tif (Number.isInteger(index.m) && (index.m ?? 0) > 0) {\n\t\t\twithParts.push(`m = ${index.m}`);\n\t\t}\n\t\tif (\n\t\t\tNumber.isInteger(index.efConstruction) &&\n\t\t\t(index.efConstruction ?? 0) > 0\n\t\t) {\n\t\t\twithParts.push(`ef_construction = ${index.efConstruction}`);\n\t\t}\n\t}\n\n\tif (\n\t\tindex.type === 'ivfflat' &&\n\t\tNumber.isInteger(index.lists) &&\n\t\t(index.lists ?? 0) > 0\n\t) {\n\t\twithParts.push(`lists = ${index.lists}`);\n\t}\n\n\tconst withClause =\n\t\twithParts.length > 0 ? ` WITH (${withParts.join(', ')})` : '';\n\n\treturn [\n\t\t`CREATE INDEX IF NOT EXISTS ${quoteIdentifier(\n\t\t\tindexName\n\t\t)} ON ${qualifiedChunkTable} USING ${index.type} (embedding ${opClass})${withClause}`\n\t];\n};\n\nconst createQuerySessionSql = ({\n\tindex\n}: {\n\tindex: PgvectorIndexConfig;\n}): string[] => {\n\tif (!index || index.type === 'none') {\n\t\treturn [];\n\t}\n\n\tconst sql: string[] = [];\n\n\tif (index.type === 'hnsw') {\n\t\tif (Number.isInteger(index.efSearch) && (index.efSearch ?? 0) > 0) {\n\t\t\tsql.push(`SET LOCAL hnsw.ef_search = ${index.efSearch}`);\n\t\t}\n\t\tif (index.iterativeScan && index.iterativeScan !== 'off') {\n\t\t\tsql.push(\n\t\t\t\t`SET LOCAL hnsw.iterative_scan = '${escapeLiteral(\n\t\t\t\t\tindex.iterativeScan\n\t\t\t\t)}'`\n\t\t\t);\n\t\t}\n\t}\n\n\tif (index.type === 'ivfflat') {\n\t\tif (Number.isInteger(index.probes) && (index.probes ?? 0) > 0) {\n\t\t\tsql.push(`SET LOCAL ivfflat.probes = ${index.probes}`);\n\t\t}\n\t\tif (Number.isInteger(index.maxProbes) && (index.maxProbes ?? 0) > 0) {\n\t\t\tsql.push(`SET LOCAL ivfflat.max_probes = ${index.maxProbes}`);\n\t\t}\n\t\tif (index.iterativeScan && index.iterativeScan !== 'off') {\n\t\t\tsql.push(\n\t\t\t\t`SET LOCAL ivfflat.iterative_scan = '${escapeLiteral(\n\t\t\t\t\tindex.iterativeScan\n\t\t\t\t)}'`\n\t\t\t);\n\t\t}\n\t}\n\n\treturn sql;\n};\n\nconst stageOrder: PostgreSQLMigrationStage[] = [\n\t'extension',\n\t'schema' as PostgreSQLMigrationStage,\n\t'table',\n\t'index'\n];\n\nconst buildMigrationName = (\n\tstage: PostgreSQLMigrationStage,\n\tstageIndex: number,\n\tsql: string\n): string => {\n\tconst normalized =\n\t\tsql\n\t\t\t.toLowerCase()\n\t\t\t.replace(/[^a-z0-9]+/g, '_')\n\t\t\t.replace(/^_+|_+$/g, '')\n\t\t\t.slice(0, 48) || 'statement';\n\tconst globalOrder = String(stageOrder.indexOf(stage) + 1).padStart(2, '0');\n\tconst localOrder = String(stageIndex + 1).padStart(3, '0');\n\n\treturn `${globalOrder}_${stage}_${localOrder}_${normalized}`;\n};\n\nconst createMigrationTableSql = (\n\tschemaName: string,\n\tmigrationTableName: string\n): string =>\n\t`CREATE TABLE IF NOT EXISTS ${qualifiedTable(\n\t\tschemaName,\n\t\tmigrationTableName\n\t)} (name TEXT PRIMARY KEY, applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW())`;\n\nconst filterTrackedTableSql = (\n\ttableSql: string[],\n\tschemaName: string,\n\tmigrationTableName: string\n): string[] => {\n\tconst migrationTableTarget = qualifiedTable(schemaName, migrationTableName);\n\n\treturn tableSql.filter((sql) => !sql.includes(migrationTableTarget));\n};\n\nexport const createPostgresSchemaPlan = (\n\toptions: PostgreSQLRAGOptions\n): PostgreSQLSchemaPlan => {\n\tconst schema = resolveSchemaConfig(options ?? {});\n\tconst vector = resolveVectorConfig(options ?? {});\n\tconst qualifiedChunkTable = qualifiedTable(\n\t\tschema.schemaName,\n\t\tschema.chunkTableName\n\t);\n\tconst qualifiedMigrationTable = qualifiedTable(\n\t\tschema.schemaName,\n\t\tschema.migrationTableName\n\t);\n\n\tconst extensionSql =\n\t\tvector.autoCreateExtension === false\n\t\t\t? []\n\t\t\t: [\n\t\t\t\t\t`CREATE EXTENSION IF NOT EXISTS ${quoteIdentifier(\n\t\t\t\t\t\tvector.extensionName\n\t\t\t\t\t)}`\n\t\t\t\t];\n\n\tconst schemaSql =\n\t\tvector.autoCreateSchema === false\n\t\t\t? []\n\t\t\t: [\n\t\t\t\t\t`CREATE SCHEMA IF NOT EXISTS ${quoteIdentifier(\n\t\t\t\t\t\tschema.schemaName\n\t\t\t\t\t)}`\n\t\t\t\t];\n\n\tconst tableSql =\n\t\tvector.autoCreateTables === false\n\t\t\t? []\n\t\t\t: [\n\t\t\t\t\t`CREATE TABLE IF NOT EXISTS ${qualifiedChunkTable} (id BIGSERIAL PRIMARY KEY, chunk_id TEXT NOT NULL UNIQUE, text TEXT NOT NULL, title TEXT, source TEXT, metadata JSONB NOT NULL DEFAULT '{}'::jsonb, embedding VECTOR(${vector.dimensions}) NOT NULL, created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW())`,\n\t\t\t\t\t`CREATE INDEX IF NOT EXISTS ${quoteIdentifier(\n\t\t\t\t\t\t`${schema.chunkTableName}_chunk_id_idx`\n\t\t\t\t\t)} ON ${qualifiedChunkTable} (chunk_id)`,\n\t\t\t\t\t`CREATE INDEX IF NOT EXISTS ${quoteIdentifier(\n\t\t\t\t\t\t`${schema.chunkTableName}_source_idx`\n\t\t\t\t\t)} ON ${qualifiedChunkTable} (source)`,\n\t\t\t\t\t`CREATE INDEX IF NOT EXISTS ${quoteIdentifier(\n\t\t\t\t\t\t`${schema.chunkTableName}_metadata_idx`\n\t\t\t\t\t)} ON ${qualifiedChunkTable} USING GIN (metadata)`,\n\t\t\t\t\tcreateMigrationTableSql(\n\t\t\t\t\t\tschema.schemaName,\n\t\t\t\t\t\tschema.migrationTableName\n\t\t\t\t\t)\n\t\t\t\t];\n\n\tconst indexSql =\n\t\tvector.autoCreateIndex === false\n\t\t\t? []\n\t\t\t: createIndexSql({\n\t\t\t\t\tschemaName: schema.schemaName,\n\t\t\t\t\tchunkTableName: schema.chunkTableName,\n\t\t\t\t\tdistanceMetric: vector.distanceMetric,\n\t\t\t\t\tindex: vector.index\n\t\t\t\t});\n\n\treturn {\n\t\timplementation: 'pgvector',\n\t\textensionSql,\n\t\tschemaSql,\n\t\ttableSql,\n\t\tindexSql,\n\t\tquerySessionSql: createQuerySessionSql({ index: vector.index }),\n\t\tmigrationTableQualifiedName: qualifiedMigrationTable\n\t};\n};\n\nexport const createPostgresMigrationPlan = (\n\toptions: PostgreSQLRAGOptions\n): PostgreSQLMigrationPlan => {\n\tconst schema = resolveSchemaConfig(options ?? {});\n\tconst schemaPlan = createPostgresSchemaPlan(options ?? ({} as PostgreSQLRAGOptions));\n\tconst bootstrapSql: string[] = [];\n\n\tif (schemaPlan.schemaSql.length > 0) {\n\t\tbootstrapSql.push(...schemaPlan.schemaSql);\n\t}\n\n\tconst migrationTableSql = createMigrationTableSql(\n\t\tschema.schemaName,\n\t\tschema.migrationTableName\n\t);\n\tif (!bootstrapSql.includes(migrationTableSql)) {\n\t\tbootstrapSql.push(migrationTableSql);\n\t}\n\n\tconst migrations: PostgreSQLMigrationEntry[] = [\n\t\t...schemaPlan.extensionSql.map((sql, index) => ({\n\t\t\tstage: 'extension' as PostgreSQLMigrationStage,\n\t\t\tsql,\n\t\t\tstageIndex: index\n\t\t})),\n\t\t...filterTrackedTableSql(\n\t\t\tschemaPlan.tableSql,\n\t\t\tschema.schemaName,\n\t\t\tschema.migrationTableName\n\t\t).map((sql, index) => ({\n\t\t\tstage: 'table' as PostgreSQLMigrationStage,\n\t\t\tsql,\n\t\t\tstageIndex: index\n\t\t})),\n\t\t...schemaPlan.indexSql.map((sql, index) => ({\n\t\t\tstage: 'index' as PostgreSQLMigrationStage,\n\t\t\tsql,\n\t\t\tstageIndex: index\n\t\t}))\n\t].map((entry) => ({\n\t\tname: buildMigrationName(entry.stage, entry.stageIndex, entry.sql),\n\t\tstage: entry.stage,\n\t\tsql: entry.sql\n\t}));\n\n\treturn {\n\t\timplementation: schemaPlan.implementation,\n\t\tschemaName: schema.schemaName,\n\t\tmigrationTableName: schema.migrationTableName,\n\t\tmigrationTableQualifiedName: qualifiedTable(\n\t\t\tschema.schemaName,\n\t\t\tschema.migrationTableName\n\t\t),\n\t\tbootstrapSql,\n\t\tmigrations,\n\t\tschemaPlan\n\t};\n};\n\ntype RawPostgresClient = {\n\tunsafe: (\n\t\tqueryText: string,\n\t\tparams?: unknown[]\n\t) => Promise<unknown[] & { count?: number }>;\n\tbegin: <T>(run: (transactionSql: RawPostgresClient) => Promise<T>) => Promise<T>;\n\tend?: (options?: { timeout?: number }) => Promise<void>;\n};\n\nconst createWrappedPostgresClient = (\n\tsql: RawPostgresClient,\n\trootSql: RawPostgresClient = sql\n): PostgreSQLRAGClient => ({\n\tquery: async <TRow = Record<string, unknown>>(\n\t\tqueryText: string,\n\t\tparams: unknown[] = []\n\t) => {\n\t\tconst rows = await sql.unsafe(queryText, params);\n\n\t\treturn {\n\t\t\trows: rows as TRow[],\n\t\t\trowCount: typeof rows.count === 'number' ? rows.count : rows.length\n\t\t};\n\t},\n\ttransaction: async <T>(run: (client: PostgreSQLRAGClient) => Promise<T>) =>\n\t\trootSql.begin(async (transactionSql) =>\n\t\t\trun(createWrappedPostgresClient(transactionSql, transactionSql))\n\t\t),\n\tclose: async () => {\n\t\tif (typeof rootSql.end === 'function') {\n\t\t\tawait rootSql.end({ timeout: 5 });\n\t\t}\n\t}\n});\n\nconst createDefaultPostgresClientFactory = (\n\toptions: PostgreSQLRAGOptions\n): (() => Promise<PostgreSQLRAGClient>) | undefined => {\n\tconst connectionString =\n\t\ttypeof options.connectionString === 'string'\n\t\t\t? options.connectionString.trim()\n\t\t\t: '';\n\n\tif (connectionString.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tlet clientPromise: Promise<PostgreSQLRAGClient> | undefined;\n\n\treturn async () => {\n\t\tif (!clientPromise) {\n\t\t\tclientPromise = (async () => {\n\t\t\t\tconst postgresModule = await import('postgres');\n\t\t\t\tconst postgres = postgresModule.default;\n\t\t\t\tconst sql = postgres(connectionString, {\n\t\t\t\t\tonnotice: () => {},\n\t\t\t\t\t...(options.driver ?? {})\n\t\t\t\t}) as unknown as RawPostgresClient;\n\n\t\t\t\treturn createWrappedPostgresClient(sql, sql);\n\t\t\t})();\n\t\t}\n\n\t\treturn clientPromise;\n\t};\n};\n\nconst resolveClientFactory = (\n\toptions: PostgreSQLRAGOptions\n): (() => Promise<PostgreSQLRAGClient>) => {\n\tif (typeof options.clientFactory === 'function') {\n\t\tconst { clientFactory } = options;\n\n\t\treturn async () => clientFactory();\n\t}\n\n\tif (options.client) {\n\t\tconst { client } = options;\n\n\t\treturn async () => client;\n\t}\n\n\tconst defaultFactory = createDefaultPostgresClientFactory(options);\n\tif (defaultFactory) {\n\t\treturn defaultFactory;\n\t}\n\n\treturn async () => {\n\t\tthrow new Error(\n\t\t\t`${ABSOLUTE_POSTGRESQL_RAG_PACKAGE_NAME}: createPostgresRAG requires connectionString, client, or clientFactory.`\n\t\t);\n\t};\n};\n\nconst buildMetadataFilter = (\n\tfilter: Record<string, unknown> | undefined\n): Record<string, unknown> | undefined => {\n\tif (!filter) {\n\t\treturn undefined;\n\t}\n\n\tconst metadataEntries = Object.entries(filter).filter(\n\t\t([key]) => key !== 'chunkId' && key !== 'title' && key !== 'source'\n\t);\n\n\tif (metadataEntries.length === 0) {\n\t\treturn undefined;\n\t}\n\n\treturn Object.fromEntries(metadataEntries);\n};\n\nconst parseMetadataValue = (\n\tvalue: unknown\n): Record<string, unknown> | undefined => {\n\tif (value === null || value === undefined) {\n\t\treturn undefined;\n\t}\n\n\tif (typeof value === 'string') {\n\t\ttry {\n\t\t\tconst parsed = JSON.parse(value);\n\t\t\tif (parsed && typeof parsed === 'object') {\n\t\t\t\treturn parsed as Record<string, unknown>;\n\t\t\t}\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tif (typeof value === 'object') {\n\t\treturn value as Record<string, unknown>;\n\t}\n\n\treturn undefined;\n};\n\nconst createPgvectorStoreStatus = ({\n\tvector,\n\tschema,\n\tdiagnostics,\n\tinitialized\n}: {\n\tvector: ResolvedPgvectorConfig;\n\tschema: ResolvedSchemaConfig;\n\tdiagnostics: PgvectorDiagnostics;\n\tinitialized: boolean;\n}): RAGVectorStoreStatus =>\n\t({\n\t\tbackend: 'postgres',\n\t\tvectorMode: 'native_pgvector',\n\t\tdimensions: vector.dimensions,\n\t\tnative: {\n\t\t\trequested: true,\n\t\t\tavailable: initialized && !diagnostics.lastInitError,\n\t\t\tactive: initialized && !diagnostics.lastInitError,\n\t\t\tmode: 'pgvector',\n\t\t\textensionName: vector.extensionName,\n\t\t\tschemaName: schema.schemaName,\n\t\t\ttableName: schema.chunkTableName,\n\t\t\tdistanceMetric: vector.distanceMetric,\n\t\t\tindexType: vector.index.type,\n\t\t\tfallbackReason: diagnostics.fallbackReason,\n\t\t\tlastInitError: diagnostics.lastInitError,\n\t\t\tlastQueryError: diagnostics.lastQueryError,\n\t\t\tlastUpsertError: diagnostics.lastUpsertError,\n\t\t\tlastMigrationError: diagnostics.lastMigrationError\n\t\t}\n\t}) as unknown as RAGVectorStoreStatus;\n\nconst getAppliedMigrationNames = async (\n\tclient: PostgreSQLRAGClient,\n\tmigrationPlan: PostgreSQLMigrationPlan\n): Promise<Set<string>> => {\n\tconst result = await client.query<{ name: unknown }>(\n\t\t`SELECT name FROM ${migrationPlan.migrationTableQualifiedName} ORDER BY name ASC`\n\t);\n\n\treturn new Set(result.rows.map((row) => String(row.name)));\n};\n\nconst insertAppliedMigration = async (\n\tclient: PostgreSQLRAGClient,\n\tmigrationPlan: PostgreSQLMigrationPlan,\n\tname: string\n): Promise<void> => {\n\tawait client.query(\n\t\t`INSERT INTO ${migrationPlan.migrationTableQualifiedName} (name) VALUES ($1) ON CONFLICT (name) DO NOTHING`,\n\t\t[name]\n\t);\n};\n\nconst executeMigrationSequence = async (\n\tclient: PostgreSQLRAGClient,\n\tmigrationPlan: PostgreSQLMigrationPlan,\n\tmigrations: PostgreSQLMigrationEntry[]\n): Promise<string[]> => {\n\tconst appliedNames: string[] = [];\n\n\tfor (const migration of migrations) {\n\t\tawait client.query(migration.sql);\n\t\tawait insertAppliedMigration(client, migrationPlan, migration.name);\n\t\tappliedNames.push(migration.name);\n\t}\n\n\treturn appliedNames;\n};\n\nexport const applyPostgresMigrations = async (\n\toptions: PostgreSQLRAGOptions,\n\tapplyOptions: PostgreSQLApplyMigrationsOptions = {}\n): Promise<PostgreSQLApplyMigrationsResult> => {\n\tconst migrationPlan = createPostgresMigrationPlan(\n\t\toptions ?? ({} as PostgreSQLRAGOptions)\n\t);\n\tconst injectedClient = applyOptions.client;\n\tconst getClient = injectedClient\n\t\t? async () => injectedClient\n\t\t: resolveClientFactory(options ?? ({} as PostgreSQLRAGOptions));\n\tconst client = await getClient();\n\n\tfor (const sql of migrationPlan.bootstrapSql) {\n\t\tawait client.query(sql);\n\t}\n\n\tconst alreadyApplied = await getAppliedMigrationNames(client, migrationPlan);\n\tconst pendingMigrations = migrationPlan.migrations.filter(\n\t\t(migration) => !alreadyApplied.has(migration.name)\n\t);\n\tconst skippedNames = migrationPlan.migrations\n\t\t.filter((migration) => alreadyApplied.has(migration.name))\n\t\t.map((migration) => migration.name);\n\n\tif (applyOptions.dryRun === true) {\n\t\treturn {\n\t\t\tmigrationPlan,\n\t\t\tappliedNames: [],\n\t\t\tskippedNames,\n\t\t\tpendingNames: pendingMigrations.map((migration) => migration.name),\n\t\t\tappliedCount: 0,\n\t\t\tpendingCount: pendingMigrations.length,\n\t\t\tdryRun: true\n\t\t};\n\t}\n\n\tconst run = async (\n\t\tactiveClient: PostgreSQLRAGClient\n\t): Promise<PostgreSQLApplyMigrationsResult> => {\n\t\tconst names = await executeMigrationSequence(\n\t\t\tactiveClient,\n\t\t\tmigrationPlan,\n\t\t\tpendingMigrations\n\t\t);\n\n\t\treturn {\n\t\t\tmigrationPlan,\n\t\t\tappliedNames: names,\n\t\t\tskippedNames,\n\t\t\tpendingNames: pendingMigrations.map((migration) => migration.name),\n\t\t\tappliedCount: names.length,\n\t\t\tpendingCount: pendingMigrations.length,\n\t\t\tdryRun: false\n\t\t};\n\t};\n\n\tif (\n\t\ttypeof client.transaction === 'function' &&\n\t\tpendingMigrations.length > 0\n\t) {\n\t\treturn client.transaction(async (transactionClient) =>\n\t\t\trun(transactionClient)\n\t\t);\n\t}\n\n\treturn run(client);\n};\n\nexport const applyPostgresSchemaPlan: typeof applyPostgresMigrations =\n\tapplyPostgresMigrations;\n\nexport const createPgvectorStore = (\n\toptions: PostgreSQLRAGOptions\n): RAGVectorStore => {\n\tconst vector = resolveVectorConfig(options ?? {});\n\tconst schema = resolveSchemaConfig(options ?? {});\n\tconst plan = createPostgresSchemaPlan(options ?? ({} as PostgreSQLRAGOptions));\n\tconst getClient = resolveClientFactory(options ?? ({} as PostgreSQLRAGOptions));\n\tconst diagnostics: PgvectorDiagnostics = {\n\t\tfallbackReason: undefined,\n\t\tlastInitError: undefined,\n\t\tlastQueryError: undefined,\n\t\tlastUpsertError: undefined,\n\t\tlastMigrationError: undefined\n\t};\n\tlet initialized = false;\n\tlet initPromise: Promise<void> | undefined;\n\n\tconst ensureInitialized = async (): Promise<void> => {\n\t\tif (initialized) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (!initPromise) {\n\t\t\tinitPromise = (async () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst client = await getClient();\n\t\t\t\t\tawait applyPostgresMigrations(options ?? {}, { client });\n\t\t\t\t\tinitialized = true;\n\t\t\t\t\tdiagnostics.lastInitError = undefined;\n\t\t\t\t\tdiagnostics.lastMigrationError = undefined;\n\t\t\t\t\tdiagnostics.fallbackReason = undefined;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tinitialized = false;\n\t\t\t\t\tconst message =\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error);\n\t\t\t\t\tdiagnostics.lastInitError = message;\n\t\t\t\t\tdiagnostics.lastMigrationError = message;\n\t\t\t\t\tdiagnostics.fallbackReason = message;\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t})();\n\t\t}\n\n\t\treturn initPromise;\n\t};\n\n\tconst embed: RAGVectorStore['embed'] = async (input) => {\n\t\tif (typeof options.embedding === 'function') {\n\t\t\tconst result = await options.embedding(input);\n\n\t\t\treturn normalizeVector(result);\n\t\t}\n\n\t\treturn normalizeVector([\n\t\t\t...createRAGVector(input.text, vector.dimensions)\n\t\t]);\n\t};\n\n\tconst query = async (input: RAGQueryInput): Promise<RAGQueryResult[]> => {\n\t\tawait ensureInitialized();\n\t\tconst client = await getClient();\n\t\tconst params: unknown[] = [];\n\t\tconst qualifiedChunkTable = qualifiedTable(\n\t\t\tschema.schemaName,\n\t\t\tschema.chunkTableName\n\t\t);\n\t\tconst operator = operatorForMetric(vector.distanceMetric);\n\t\tconst vectorPlaceholder = makePlaceholder(\n\t\t\tparams,\n\t\t\tvectorLiteral(normalizeVector(input.queryVector)),\n\t\t\t'vector'\n\t\t);\n\t\tconst limitPlaceholder = makePlaceholder(params, input.topK);\n\t\tconst whereParts: string[] = [];\n\t\tconst filter = input.filter as Record<string, unknown> | undefined;\n\n\t\tif (filter?.chunkId !== undefined) {\n\t\t\twhereParts.push(\n\t\t\t\t`chunk_id = ${makePlaceholder(params, filter.chunkId)}`\n\t\t\t);\n\t\t}\n\t\tif (filter?.title !== undefined) {\n\t\t\twhereParts.push(`title = ${makePlaceholder(params, filter.title)}`);\n\t\t}\n\t\tif (filter?.source !== undefined) {\n\t\t\twhereParts.push(\n\t\t\t\t`source = ${makePlaceholder(params, filter.source)}`\n\t\t\t);\n\t\t}\n\n\t\tconst metadataFilter = buildMetadataFilter(filter);\n\t\tif (metadataFilter) {\n\t\t\twhereParts.push(\n\t\t\t\t`metadata @> ${makePlaceholder(\n\t\t\t\t\tparams,\n\t\t\t\t\tJSON.stringify(metadataFilter),\n\t\t\t\t\t'jsonb'\n\t\t\t\t)}`\n\t\t\t);\n\t\t}\n\n\t\tconst whereSql =\n\t\t\twhereParts.length > 0 ? `WHERE ${whereParts.join(' AND ')}` : '';\n\t\tconst sessionSql = plan.querySessionSql;\n\t\tconst selectSql = `SELECT chunk_id, text, title, source, metadata, embedding ${operator} ${vectorPlaceholder} AS distance FROM ${qualifiedChunkTable} ${whereSql} ORDER BY distance ASC LIMIT ${limitPlaceholder}`;\n\n\t\ttry {\n\t\t\tfor (const sql of sessionSql) {\n\t\t\t\tawait client.query(sql);\n\t\t\t}\n\n\t\t\tconst result = await client.query<{\n\t\t\t\tchunk_id: string;\n\t\t\t\ttext: string;\n\t\t\t\ttitle: string | null;\n\t\t\t\tsource: string | null;\n\t\t\t\tmetadata: unknown;\n\t\t\t\tdistance: unknown;\n\t\t\t}>(selectSql, params);\n\n\t\t\treturn result.rows.map((row) => ({\n\t\t\t\tchunkId: row.chunk_id,\n\t\t\t\tchunkText: row.text,\n\t\t\t\ttitle: row.title ?? undefined,\n\t\t\t\tsource: row.source ?? undefined,\n\t\t\t\tmetadata: parseMetadataValue(row.metadata),\n\t\t\t\tscore: scoreFromDistance(\n\t\t\t\t\tNumber(row.distance),\n\t\t\t\t\tvector.distanceMetric\n\t\t\t\t)\n\t\t\t}));\n\t\t} catch (error) {\n\t\t\tdiagnostics.lastQueryError =\n\t\t\t\terror instanceof Error ? error.message : String(error);\n\t\t\tthrow error;\n\t\t}\n\t};\n\n\tconst upsert = async (input: RAGUpsertInput): Promise<void> => {\n\t\tawait ensureInitialized();\n\t\tconst client = await getClient();\n\t\tconst qualifiedChunkTable = qualifiedTable(\n\t\t\tschema.schemaName,\n\t\t\tschema.chunkTableName\n\t\t);\n\t\tconst sql = `INSERT INTO ${qualifiedChunkTable} (chunk_id, text, title, source, metadata, embedding, updated_at) VALUES ($1, $2, $3, $4, $5::jsonb, $6::vector, NOW()) ON CONFLICT (chunk_id) DO UPDATE SET text = EXCLUDED.text, title = EXCLUDED.title, source = EXCLUDED.source, metadata = EXCLUDED.metadata, embedding = EXCLUDED.embedding, updated_at = NOW()`;\n\n\t\ttry {\n\t\t\tfor (const chunk of input.chunks) {\n\t\t\t\tconst vectorValue =\n\t\t\t\t\tArray.isArray(chunk.embedding) && chunk.embedding.length > 0\n\t\t\t\t\t\t? normalizeVector(chunk.embedding)\n\t\t\t\t\t\t: await embed({ text: chunk.text });\n\t\t\t\tawait client.query(sql, [\n\t\t\t\t\tchunk.chunkId,\n\t\t\t\t\tchunk.text,\n\t\t\t\t\tchunk.title ?? null,\n\t\t\t\t\tchunk.source ?? null,\n\t\t\t\t\tJSON.stringify(chunk.metadata ?? {}),\n\t\t\t\t\tvectorLiteral(vectorValue)\n\t\t\t\t]);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tdiagnostics.lastUpsertError =\n\t\t\t\terror instanceof Error ? error.message : String(error);\n\t\t\tthrow error;\n\t\t}\n\t};\n\n\tconst clear = async (): Promise<void> => {\n\t\tawait ensureInitialized();\n\t\tconst client = await getClient();\n\t\tconst qualifiedChunkTable = qualifiedTable(\n\t\t\tschema.schemaName,\n\t\t\tschema.chunkTableName\n\t\t);\n\t\tawait client.query(`DELETE FROM ${qualifiedChunkTable}`);\n\t};\n\n\treturn {\n\t\tembed,\n\t\tquery,\n\t\tupsert,\n\t\tclear,\n\t\tgetCapabilities: () => ({\n\t\t\tbackend: 'postgres',\n\t\t\tpersistence: 'external',\n\t\t\tnativeVectorSearch: true,\n\t\t\tserverSideFiltering: true,\n\t\t\tstreamingIngestStatus: false\n\t\t}),\n\t\tgetStatus: () =>\n\t\t\tcreatePgvectorStoreStatus({\n\t\t\t\tvector,\n\t\t\t\tschema,\n\t\t\t\tdiagnostics,\n\t\t\t\tinitialized\n\t\t\t})\n\t} as RAGVectorStore;\n};\n\nexport const createPostgresRAGCollection = (\n\toptions: PostgreSQLRAGOptions\n): RAGCollection =>\n\tcreateRAGCollection({\n\t\tstore: createPgvectorStore(options)\n\t});\n\nexport const createPostgresRAG = (\n\toptions: PostgreSQLRAGOptions\n): PostgreSQLRAG => {\n\tconst store = createPgvectorStore(options);\n\tconst collection = createRAGCollection({ store });\n\tconst schemaPlan = createPostgresSchemaPlan(options);\n\tconst migrationPlan = createPostgresMigrationPlan(options);\n\n\treturn {\n\t\tstore,\n\t\tcollection,\n\t\tgetStatus: () => store.getStatus?.(),\n\t\tgetCapabilities: () => store.getCapabilities?.(),\n\t\tgetSchemaPlan: () => schemaPlan,\n\t\tgetMigrationPlan: () => migrationPlan,\n\t\tapplyMigrations: (applyOptions) =>\n\t\t\tapplyPostgresMigrations(options, applyOptions)\n\t};\n};\n\nexport const createPostgreSQLRAG: typeof createPostgresRAG = createPostgresRAG;\n"
+  ],
+  "mappings": "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",
+  "debugId": "22931C2F3EFA23C264756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+	"name": "@absolutejs/rag-postgres",
+	"version": "0.0.5",
+	"description": "PostgreSQL (pgvector) vector-store adapter for @absolutejs/rag",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/rag-adapters.git",
+		"directory": "postgres"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"license": "CC BY-NC 4.0",
+	"author": "Alex Kahn",
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"absolutejs",
+		"rag",
+		"postgresql",
+		"pgvector",
+		"vector"
+	],
+	"scripts": {
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/rag --external postgres && tsc --project tsconfig.build.json",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"format": "prettier --write \"./**/*.{ts,json,md}\"",
+		"release": "bun run format && bun run build && bun publish"
+	},
+	"dependencies": {
+		"@absolutejs/rag": "^0.0.19"
+	},
+	"peerDependencies": {
+		"postgres": ">= 3.4.0"
+	},
+	"devDependencies": {
+		"@types/bun": "1.2.9",
+		"postgres": "3.4.9",
+		"prettier": "3.5.3",
+		"typescript": "5.8.3"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	]
+}