@semilayer/bridge-postgres 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SemiLayer
+
+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/README.md

@@ -0,0 +1,128 @@
+# @semilayer/bridge-postgres
+
+First-party PostgreSQL adapter for [SemiLayer](https://semilayer.com) — the intelligence layer for any database.
+
+This package implements the SemiLayer `Bridge` interface for PostgreSQL, enabling ingest, search, similarity, and direct queries against any Postgres database (including hosted flavors like Neon, Supabase, CockroachDB, and others that speak the Postgres wire protocol).
+
+## Installation
+
+```bash
+npm install @semilayer/bridge-postgres
+# or
+pnpm add @semilayer/bridge-postgres
+```
+
+## Usage
+
+```typescript
+import { PostgresBridge } from '@semilayer/bridge-postgres'
+
+const bridge = new PostgresBridge({
+  url: 'postgresql://user:pass@host:5432/db',
+  pool: { min: 0, max: 5 }, // optional
+})
+
+await bridge.connect()
+
+// Paginated read with keyset cursor
+const result = await bridge.read('articles', {
+  limit: 100,
+  cursor: undefined, // first page
+})
+
+console.log(result.rows)        // BridgeRow[]
+console.log(result.nextCursor)  // string | undefined
+console.log(result.total)       // total row count
+
+// Direct query with filters
+const { rows } = await bridge.query('articles', {
+  where: { status: 'published', views: { $gt: 100 } },
+  orderBy: [{ field: 'created_at', dir: 'desc' }],
+  limit: 20,
+})
+
+await bridge.disconnect()
+```
+
+## Schema Introspection
+
+```typescript
+import { introspect, listTables } from '@semilayer/bridge-postgres'
+import pg from 'pg'
+
+const pool = new pg.Pool({ connectionString: '...' })
+
+const tables = await listTables(pool)
+const info = await introspect(pool, 'articles')
+// info.columns: ColumnInfo[] with type, nullable, primaryKey
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `url` | `string` | **required** | Postgres connection string |
+| `pool.min` | `number` | `0` | Minimum pool connections |
+| `pool.max` | `number` | `3` | Maximum pool connections |
+
+Accepts `connectionString` as an alias for `url`.
+
+## Query Operators
+
+The `query()` method supports MongoDB-style operators in the `where` clause:
+
+| Operator | SQL | Example |
+|----------|-----|---------|
+| `$eq` | `=` | `{ status: { $eq: 'active' } }` |
+| `$gt` | `>` | `{ age: { $gt: 18 } }` |
+| `$gte` | `>=` | `{ score: { $gte: 50 } }` |
+| `$lt` | `<` | `{ age: { $lt: 65 } }` |
+| `$lte` | `<=` | `{ score: { $lte: 100 } }` |
+| `$in` | `= ANY(...)` | `{ status: { $in: ['a', 'b'] } }` |
+
+Bare values default to `$eq`: `{ status: 'active' }` is equivalent to `{ status: { $eq: 'active' } }`.
+
+## Incremental Ingest
+
+`read()` supports `changedSince` for incremental reads, tracking a configurable column (default `updated_at`):
+
+```typescript
+await bridge.read('articles', {
+  changedSince: new Date('2026-01-01'),
+  changeTrackingColumn: 'modified_at', // optional
+  limit: 1000,
+})
+```
+
+If the column does not exist on the table, the `changedSince` filter is silently dropped and a full read is performed.
+
+## Requirements
+
+- Node.js 20+
+- PostgreSQL 13+ (any version supported by the `pg` driver)
+- `@semilayer/core` (peer-compatible version)
+
+## Compliance Testing
+
+This package passes the SemiLayer bridge compliance suite:
+
+```typescript
+import { createBridgeTestSuite } from '@semilayer/bridge-sdk'
+import { PostgresBridge } from '@semilayer/bridge-postgres'
+
+createBridgeTestSuite(
+  () => new PostgresBridge({ url: process.env.DATABASE_URL! }),
+)
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details on running tests.
+
+## Links
+
+- [SemiLayer documentation](https://semilayer.dev)
+- [Bridge authoring guide](https://semilayer.dev/guides/bridges)
+- [Bridge resolver & community bridges](https://github.com/semilayer/bridge-resolver)
+
+## License
+
+MIT © SemiLayer

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { Bridge, ReadOptions, ReadResult, QueryOptions, QueryResult, BridgeRow, TargetSchema } from '@semilayer/core';
+import pg from 'pg';
+
+interface PostgresBridgeConfig {
+    url: string;
+    pool?: {
+        min?: number;
+        max?: number;
+    };
+}
+declare class PostgresBridge implements Bridge {
+    private pool;
+    private config;
+    private pkCache;
+    constructor(config: Record<string, unknown>);
+    connect(): Promise<void>;
+    read(target: string, options?: ReadOptions): Promise<ReadResult>;
+    count(target: string): Promise<number>;
+    disconnect(): Promise<void>;
+    query(target: string, options: QueryOptions): Promise<QueryResult<BridgeRow>>;
+    listTargets(): Promise<string[]>;
+    introspectTarget(target: string): Promise<TargetSchema>;
+    private assertPool;
+    private getPrimaryKey;
+    private hasColumn;
+}
+
+interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+    primaryKey: boolean;
+}
+interface TableInfo {
+    name: string;
+    schema: string;
+    columns: ColumnInfo[];
+    rowCount: number;
+}
+declare function introspect(pool: pg.Pool, table: string, schema?: string): Promise<TableInfo>;
+declare function listTables(pool: pg.Pool, schema?: string): Promise<string[]>;
+
+export { type ColumnInfo, PostgresBridge, type PostgresBridgeConfig, type TableInfo, introspect, listTables };

package/dist/index.js

@@ -0,0 +1,303 @@
+// src/bridge.ts
+import pg from "pg";
+
+// src/introspect.ts
+async function introspect(pool, table, schema = "public") {
+  const colResult = await pool.query(
+    `SELECT
+       c.column_name,
+       c.data_type,
+       c.is_nullable,
+       CASE WHEN kcu.column_name IS NOT NULL THEN true ELSE false END AS is_pk
+     FROM information_schema.columns c
+     LEFT JOIN information_schema.table_constraints tc
+       ON tc.table_name = c.table_name
+       AND tc.table_schema = c.table_schema
+       AND tc.constraint_type = 'PRIMARY KEY'
+     LEFT JOIN information_schema.key_column_usage kcu
+       ON kcu.constraint_name = tc.constraint_name
+       AND kcu.table_schema = tc.table_schema
+       AND kcu.column_name = c.column_name
+     WHERE c.table_name = $1
+       AND c.table_schema = $2
+     ORDER BY c.ordinal_position`,
+    [table, schema]
+  );
+  const columns = colResult.rows.map((row) => ({
+    name: row.column_name,
+    type: row.data_type,
+    nullable: row.is_nullable === "YES",
+    primaryKey: row.is_pk
+  }));
+  const countResult = await pool.query(
+    `SELECT count(*)::int AS total FROM "${schema}"."${table}"`
+  );
+  const rowCount = countResult.rows[0].total;
+  return { name: table, schema, columns, rowCount };
+}
+async function listTables(pool, schema = "public") {
+  const result = await pool.query(
+    `SELECT table_name
+     FROM information_schema.tables
+     WHERE table_schema = $1
+       AND table_type = 'BASE TABLE'
+     ORDER BY table_name`,
+    [schema]
+  );
+  return result.rows.map(
+    (r) => r.table_name
+  );
+}
+
+// src/bridge.ts
+var TABLE_NAME_RE = /^[a-zA-Z_][a-zA-Z0-9_.]*$/;
+var PostgresBridge = class {
+  pool = null;
+  config;
+  pkCache = /* @__PURE__ */ new Map();
+  constructor(config) {
+    const url = config["url"] ?? config["connectionString"];
+    if (!url || typeof url !== "string") {
+      throw new Error('PostgresBridge requires a "url" config string');
+    }
+    this.config = {
+      url,
+      pool: config["pool"]
+    };
+  }
+  async connect() {
+    this.pool = new pg.Pool({
+      connectionString: this.config.url,
+      min: this.config.pool?.min ?? 0,
+      max: this.config.pool?.max ?? 3
+    });
+    const client = await this.pool.connect();
+    try {
+      await client.query("SELECT 1");
+    } finally {
+      client.release();
+    }
+  }
+  async read(target, options) {
+    const pool = this.assertPool();
+    const table = target;
+    assertTableName(table);
+    const pk = await this.getPrimaryKey(table);
+    const fields = options?.fields;
+    const selectClause = fields ? fields.map(quote).join(", ") : "*";
+    const limit = options?.limit ?? 1e3;
+    const conditions = [];
+    const params = [];
+    let paramIdx = 1;
+    if (options?.cursor) {
+      conditions.push(`${quote(pk)} > $${paramIdx}`);
+      params.push(options.cursor);
+      paramIdx++;
+    }
+    if (options?.changedSince) {
+      const col = options.changeTrackingColumn ?? "updated_at";
+      const hasCol = await this.hasColumn(table, col);
+      if (hasCol) {
+        conditions.push(`${quote(col)} > $${paramIdx}`);
+        params.push(options.changedSince);
+        paramIdx++;
+      }
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    params.push(limit + 1);
+    const sql = `SELECT ${selectClause} FROM ${quote(table)} ${whereClause} ORDER BY ${quote(pk)} ASC LIMIT $${paramIdx}`;
+    const result = await pool.query(sql, params);
+    const allRows = result.rows;
+    const hasMore = allRows.length > limit;
+    const rows = hasMore ? allRows.slice(0, limit) : allRows;
+    const nextCursor = hasMore ? String(rows[rows.length - 1][pk]) : void 0;
+    const countResult = await pool.query(
+      `SELECT count(*)::int AS total FROM ${quote(table)}`
+    );
+    const total = countResult.rows[0].total;
+    return { rows, nextCursor, total };
+  }
+  async count(target) {
+    const pool = this.assertPool();
+    const table = target;
+    assertTableName(table);
+    const result = await pool.query(
+      `SELECT count(*)::int AS total FROM ${quote(table)}`
+    );
+    return result.rows[0].total;
+  }
+  async disconnect() {
+    if (this.pool) {
+      await this.pool.end();
+      this.pool = null;
+    }
+    this.pkCache.clear();
+  }
+  async query(target, options) {
+    const pool = this.assertPool();
+    const table = target;
+    assertTableName(table);
+    const selectClause = options.select ? options.select.map(quote).join(", ") : "*";
+    const params = [];
+    let paramIdx = 1;
+    const conditions = [];
+    if (options.where) {
+      for (const [key, value] of Object.entries(options.where)) {
+        if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+          const ops = value;
+          for (const [op, opVal] of Object.entries(ops)) {
+            switch (op) {
+              case "$eq":
+                conditions.push(`${quote(key)} = $${paramIdx}`);
+                params.push(opVal);
+                paramIdx++;
+                break;
+              case "$gt":
+                conditions.push(`${quote(key)} > $${paramIdx}`);
+                params.push(opVal);
+                paramIdx++;
+                break;
+              case "$gte":
+                conditions.push(`${quote(key)} >= $${paramIdx}`);
+                params.push(opVal);
+                paramIdx++;
+                break;
+              case "$lt":
+                conditions.push(`${quote(key)} < $${paramIdx}`);
+                params.push(opVal);
+                paramIdx++;
+                break;
+              case "$lte":
+                conditions.push(`${quote(key)} <= $${paramIdx}`);
+                params.push(opVal);
+                paramIdx++;
+                break;
+              case "$in":
+                conditions.push(
+                  `${quote(key)} = ANY($${paramIdx})`
+                );
+                params.push(opVal);
+                paramIdx++;
+                break;
+              default:
+                throw new Error(`Unknown operator "${op}" on field "${key}"`);
+            }
+          }
+        } else {
+          conditions.push(`${quote(key)} = $${paramIdx}`);
+          params.push(value);
+          paramIdx++;
+        }
+      }
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    let orderByClause = "";
+    if (options.orderBy) {
+      const clauses = Array.isArray(options.orderBy) ? options.orderBy : [options.orderBy];
+      const parts = clauses.map(
+        (c) => `${quote(c.field)} ${c.dir === "desc" ? "DESC" : "ASC"}`
+      );
+      orderByClause = `ORDER BY ${parts.join(", ")}`;
+    }
+    let limitClause = "";
+    if (options.limit != null) {
+      limitClause = `LIMIT $${paramIdx}`;
+      params.push(options.limit);
+      paramIdx++;
+    }
+    let offsetClause = "";
+    if (options.offset != null) {
+      offsetClause = `OFFSET $${paramIdx}`;
+      params.push(options.offset);
+      paramIdx++;
+    }
+    const sql = [
+      `SELECT ${selectClause} FROM ${quote(table)}`,
+      whereClause,
+      orderByClause,
+      limitClause,
+      offsetClause
+    ].filter(Boolean).join(" ");
+    const countSql = `SELECT count(*)::int AS total FROM ${quote(table)} ${whereClause}`;
+    const countParams = options.where ? params.slice(0, conditions.length) : [];
+    const [dataResult, countResult] = await Promise.all([
+      pool.query(sql, params),
+      pool.query(countSql, countParams)
+    ]);
+    return {
+      rows: dataResult.rows,
+      total: countResult.rows[0].total
+    };
+  }
+  // -------------------------------------------------------------------
+  // Introspection
+  // -------------------------------------------------------------------
+  async listTargets() {
+    const pool = this.assertPool();
+    return listTables(pool);
+  }
+  async introspectTarget(target) {
+    const pool = this.assertPool();
+    const info = await introspect(pool, target);
+    return {
+      name: info.name,
+      columns: info.columns,
+      rowCount: info.rowCount
+    };
+  }
+  // -------------------------------------------------------------------
+  // Internal helpers
+  // -------------------------------------------------------------------
+  assertPool() {
+    if (!this.pool) throw new Error("PostgresBridge is not connected");
+    return this.pool;
+  }
+  async getPrimaryKey(table) {
+    const cached = this.pkCache.get(table);
+    if (cached) return cached;
+    const pool = this.assertPool();
+    const result = await pool.query(
+      `SELECT kcu.column_name
+       FROM information_schema.table_constraints tc
+       JOIN information_schema.key_column_usage kcu
+         ON tc.constraint_name = kcu.constraint_name
+         AND tc.table_schema = kcu.table_schema
+       WHERE tc.constraint_type = 'PRIMARY KEY'
+         AND tc.table_name = $1
+       LIMIT 1`,
+      [table]
+    );
+    const row = result.rows[0];
+    if (!row) {
+      throw new Error(
+        `Could not detect primary key for table "${table}"`
+      );
+    }
+    this.pkCache.set(table, row.column_name);
+    return row.column_name;
+  }
+  async hasColumn(table, column) {
+    const pool = this.assertPool();
+    const result = await pool.query(
+      `SELECT 1 FROM information_schema.columns
+       WHERE table_name = $1 AND column_name = $2
+       LIMIT 1`,
+      [table, column]
+    );
+    return result.rowCount != null && result.rowCount > 0;
+  }
+};
+function quote(identifier) {
+  return `"${identifier.replace(/"/g, '""')}"`;
+}
+function assertTableName(table) {
+  if (!TABLE_NAME_RE.test(table)) {
+    throw new Error(`Invalid table name: "${table}"`);
+  }
+}
+export {
+  PostgresBridge,
+  introspect,
+  listTables
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge.ts","../src/introspect.ts"],"sourcesContent":["import pg from 'pg'\nimport type {\n  Bridge,\n  BridgeRow,\n  ReadOptions,\n  ReadResult,\n  QueryOptions,\n  QueryResult,\n  TargetSchema,\n} from '@semilayer/core'\nimport { introspect, listTables } from './introspect.js'\n\nconst TABLE_NAME_RE = /^[a-zA-Z_][a-zA-Z0-9_.]*$/\n\nexport interface PostgresBridgeConfig {\n  url: string\n  pool?: { min?: number; max?: number }\n}\n\nexport class PostgresBridge implements Bridge {\n  private pool: pg.Pool | null = null\n  private config: PostgresBridgeConfig\n  private pkCache = new Map<string, string>()\n\n  constructor(config: Record<string, unknown>) {\n    const url = (config['url'] ?? config['connectionString']) as string | undefined\n    if (!url || typeof url !== 'string') {\n      throw new Error('PostgresBridge requires a \"url\" config string')\n    }\n    this.config = {\n      url,\n      pool: config['pool'] as PostgresBridgeConfig['pool'],\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.pool = new pg.Pool({\n      connectionString: this.config.url,\n      min: this.config.pool?.min ?? 0,\n      max: this.config.pool?.max ?? 3,\n    })\n    const client = await this.pool.connect()\n    try {\n      await client.query('SELECT 1')\n    } finally {\n      client.release()\n    }\n  }\n\n  async read(target: string, options?: ReadOptions): Promise<ReadResult> {\n    const pool = this.assertPool()\n    const table = target\n    assertTableName(table)\n\n    const pk = await this.getPrimaryKey(table)\n    const fields = options?.fields\n    const selectClause = fields ? fields.map(quote).join(', ') : '*'\n    const limit = options?.limit ?? 1000\n\n    const conditions: string[] = []\n    const params: unknown[] = []\n    let paramIdx = 1\n\n    if (options?.cursor) {\n      conditions.push(`${quote(pk)} > $${paramIdx}`)\n      params.push(options.cursor)\n      paramIdx++\n    }\n\n    if (options?.changedSince) {\n      const col = options.changeTrackingColumn ?? 'updated_at'\n      const hasCol = await this.hasColumn(table, col)\n      if (hasCol) {\n        conditions.push(`${quote(col)} > $${paramIdx}`)\n        params.push(options.changedSince)\n        paramIdx++\n      }\n    }\n\n    const whereClause =\n      conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : ''\n\n    // Fetch limit+1 to detect whether there's a next page\n    params.push(limit + 1)\n\n    const sql = `SELECT ${selectClause} FROM ${quote(table)} ${whereClause} ORDER BY ${quote(pk)} ASC LIMIT $${paramIdx}`\n\n    const result = await pool.query(sql, params)\n    const allRows: BridgeRow[] = result.rows as BridgeRow[]\n\n    const hasMore = allRows.length > limit\n    const rows = hasMore ? allRows.slice(0, limit) : allRows\n    const nextCursor = hasMore\n      ? String(rows[rows.length - 1]![pk])\n      : undefined\n\n    const countResult = await pool.query(\n      `SELECT count(*)::int AS total FROM ${quote(table)}`,\n    )\n    const total = (countResult.rows as Array<{ total: number }>)[0]!.total\n\n    return { rows, nextCursor, total }\n  }\n\n  async count(target: string): Promise<number> {\n    const pool = this.assertPool()\n    const table = target\n    assertTableName(table)\n\n    const result = await pool.query(\n      `SELECT count(*)::int AS total FROM ${quote(table)}`,\n    )\n    return (result.rows as Array<{ total: number }>)[0]!.total\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.pool) {\n      await this.pool.end()\n      this.pool = null\n    }\n    this.pkCache.clear()\n  }\n\n  async query(\n    target: string,\n    options: QueryOptions,\n  ): Promise<QueryResult<BridgeRow>> {\n    const pool = this.assertPool()\n    const table = target\n    assertTableName(table)\n\n    const selectClause = options.select\n      ? options.select.map(quote).join(', ')\n      : '*'\n\n    const params: unknown[] = []\n    let paramIdx = 1\n\n    // WHERE\n    const conditions: string[] = []\n    if (options.where) {\n      for (const [key, value] of Object.entries(options.where)) {\n        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\n          const ops = value as Record<string, unknown>\n          for (const [op, opVal] of Object.entries(ops)) {\n            switch (op) {\n              case '$eq':\n                conditions.push(`${quote(key)} = $${paramIdx}`)\n                params.push(opVal)\n                paramIdx++\n                break\n              case '$gt':\n                conditions.push(`${quote(key)} > $${paramIdx}`)\n                params.push(opVal)\n                paramIdx++\n                break\n              case '$gte':\n                conditions.push(`${quote(key)} >= $${paramIdx}`)\n                params.push(opVal)\n                paramIdx++\n                break\n              case '$lt':\n                conditions.push(`${quote(key)} < $${paramIdx}`)\n                params.push(opVal)\n                paramIdx++\n                break\n              case '$lte':\n                conditions.push(`${quote(key)} <= $${paramIdx}`)\n                params.push(opVal)\n                paramIdx++\n                break\n              case '$in':\n                conditions.push(\n                  `${quote(key)} = ANY($${paramIdx})`,\n                )\n                params.push(opVal)\n                paramIdx++\n                break\n              default:\n                throw new Error(`Unknown operator \"${op}\" on field \"${key}\"`)\n            }\n          }\n        } else {\n          conditions.push(`${quote(key)} = $${paramIdx}`)\n          params.push(value)\n          paramIdx++\n        }\n      }\n    }\n\n    const whereClause =\n      conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : ''\n\n    // ORDER BY\n    let orderByClause = ''\n    if (options.orderBy) {\n      const clauses = Array.isArray(options.orderBy)\n        ? options.orderBy\n        : [options.orderBy]\n      const parts = clauses.map(\n        (c) => `${quote(c.field)} ${c.dir === 'desc' ? 'DESC' : 'ASC'}`,\n      )\n      orderByClause = `ORDER BY ${parts.join(', ')}`\n    }\n\n    // LIMIT / OFFSET\n    let limitClause = ''\n    if (options.limit != null) {\n      limitClause = `LIMIT $${paramIdx}`\n      params.push(options.limit)\n      paramIdx++\n    }\n\n    let offsetClause = ''\n    if (options.offset != null) {\n      offsetClause = `OFFSET $${paramIdx}`\n      params.push(options.offset)\n      paramIdx++\n    }\n\n    const sql = [\n      `SELECT ${selectClause} FROM ${quote(table)}`,\n      whereClause,\n      orderByClause,\n      limitClause,\n      offsetClause,\n    ]\n      .filter(Boolean)\n      .join(' ')\n\n    // Get total count (with same WHERE, without LIMIT/OFFSET)\n    const countSql = `SELECT count(*)::int AS total FROM ${quote(table)} ${whereClause}`\n    const countParams = options.where ? params.slice(0, conditions.length) : []\n\n    const [dataResult, countResult] = await Promise.all([\n      pool.query(sql, params),\n      pool.query(countSql, countParams),\n    ])\n\n    return {\n      rows: dataResult.rows as BridgeRow[],\n      total: (countResult.rows as Array<{ total: number }>)[0]!.total,\n    }\n  }\n\n  // -------------------------------------------------------------------\n  // Introspection\n  // -------------------------------------------------------------------\n\n  async listTargets(): Promise<string[]> {\n    const pool = this.assertPool()\n    return listTables(pool)\n  }\n\n  async introspectTarget(target: string): Promise<TargetSchema> {\n    const pool = this.assertPool()\n    const info = await introspect(pool, target)\n    return {\n      name: info.name,\n      columns: info.columns,\n      rowCount: info.rowCount,\n    }\n  }\n\n  // -------------------------------------------------------------------\n  // Internal helpers\n  // -------------------------------------------------------------------\n\n  private assertPool(): pg.Pool {\n    if (!this.pool) throw new Error('PostgresBridge is not connected')\n    return this.pool\n  }\n\n  private async getPrimaryKey(table: string): Promise<string> {\n    const cached = this.pkCache.get(table)\n    if (cached) return cached\n\n    const pool = this.assertPool()\n    const result = await pool.query(\n      `SELECT kcu.column_name\n       FROM information_schema.table_constraints tc\n       JOIN information_schema.key_column_usage kcu\n         ON tc.constraint_name = kcu.constraint_name\n         AND tc.table_schema = kcu.table_schema\n       WHERE tc.constraint_type = 'PRIMARY KEY'\n         AND tc.table_name = $1\n       LIMIT 1`,\n      [table],\n    )\n\n    const row = (result.rows as Array<{ column_name: string }>)[0]\n    if (!row) {\n      throw new Error(\n        `Could not detect primary key for table \"${table}\"`,\n      )\n    }\n    this.pkCache.set(table, row.column_name)\n    return row.column_name\n  }\n\n  private async hasColumn(table: string, column: string): Promise<boolean> {\n    const pool = this.assertPool()\n    const result = await pool.query(\n      `SELECT 1 FROM information_schema.columns\n       WHERE table_name = $1 AND column_name = $2\n       LIMIT 1`,\n      [table, column],\n    )\n    return result.rowCount != null && result.rowCount > 0\n  }\n}\n\nfunction quote(identifier: string): string {\n  return `\"${identifier.replace(/\"/g, '\"\"')}\"`\n}\n\nfunction assertTableName(table: string): void {\n  if (!TABLE_NAME_RE.test(table)) {\n    throw new Error(`Invalid table name: \"${table}\"`)\n  }\n}\n","import type pg from 'pg'\n\nexport interface ColumnInfo {\n  name: string\n  type: string\n  nullable: boolean\n  primaryKey: boolean\n}\n\nexport interface TableInfo {\n  name: string\n  schema: string\n  columns: ColumnInfo[]\n  rowCount: number\n}\n\nexport async function introspect(\n  pool: pg.Pool,\n  table: string,\n  schema = 'public',\n): Promise<TableInfo> {\n  const colResult = await pool.query(\n    `SELECT\n       c.column_name,\n       c.data_type,\n       c.is_nullable,\n       CASE WHEN kcu.column_name IS NOT NULL THEN true ELSE false END AS is_pk\n     FROM information_schema.columns c\n     LEFT JOIN information_schema.table_constraints tc\n       ON tc.table_name = c.table_name\n       AND tc.table_schema = c.table_schema\n       AND tc.constraint_type = 'PRIMARY KEY'\n     LEFT JOIN information_schema.key_column_usage kcu\n       ON kcu.constraint_name = tc.constraint_name\n       AND kcu.table_schema = tc.table_schema\n       AND kcu.column_name = c.column_name\n     WHERE c.table_name = $1\n       AND c.table_schema = $2\n     ORDER BY c.ordinal_position`,\n    [table, schema],\n  )\n\n  const columns: ColumnInfo[] = (\n    colResult.rows as Array<{\n      column_name: string\n      data_type: string\n      is_nullable: string\n      is_pk: boolean\n    }>\n  ).map((row) => ({\n    name: row.column_name,\n    type: row.data_type,\n    nullable: row.is_nullable === 'YES',\n    primaryKey: row.is_pk,\n  }))\n\n  const countResult = await pool.query(\n    `SELECT count(*)::int AS total FROM \"${schema}\".\"${table}\"`,\n  )\n  const rowCount = (countResult.rows as Array<{ total: number }>)[0]!.total\n\n  return { name: table, schema, columns, rowCount }\n}\n\nexport async function listTables(\n  pool: pg.Pool,\n  schema = 'public',\n): Promise<string[]> {\n  const result = await pool.query(\n    `SELECT table_name\n     FROM information_schema.tables\n     WHERE table_schema = $1\n       AND table_type = 'BASE TABLE'\n     ORDER BY table_name`,\n    [schema],\n  )\n  return (result.rows as Array<{ table_name: string }>).map(\n    (r) => r.table_name,\n  )\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@semilayer/bridge-postgres",
+  "version": "1.0.0",
+  "description": "SemiLayer Postgres Bridge — first-party adapter for connecting SemiLayer to PostgreSQL databases",
+  "keywords": [
+    "semilayer",
+    "bridge",
+    "postgres",
+    "postgresql",
+    "adapter"
+  ],
+  "license": "MIT",
+  "author": "SemiLayer",
+  "homepage": "https://github.com/semilayer/bridge-postgres#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/semilayer/bridge-postgres.git"
+  },
+  "bugs": {
+    "url": "https://github.com/semilayer/bridge-postgres/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@semilayer/core": "^0.1.0",
+    "pg": "^8.13.0"
+  },
+  "peerDependencies": {
+    "@semilayer/bridge-sdk": "^0.1.1"
+  },
+  "peerDependenciesMeta": {
+    "@semilayer/bridge-sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@semilayer/bridge-sdk": "^0.1.1",
+    "@types/node": "^20.0.0",
+    "@types/pg": "^8.11.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}