@dotdo/postgres 0.1.2 → 0.1.3

package/dist/do/sql.js

@@ -0,0 +1,204 @@
+/**
+ * SQL Tagged Template & Database Client
+ *
+ * Execute PostgreSQL queries with a simple API.
+ * Automatically routes to the Postgres Durable Object using cloudflare:workers env.
+ *
+ * @example
+ * ```typescript
+ * import { sql, db } from '@dotdo/postgres'
+ *
+ * // Tagged template (safe from SQL injection)
+ * const posts = await sql`SELECT * FROM posts WHERE id = ${id}`
+ *
+ * // db.query for dynamic queries
+ * const result = await db.query('SELECT * FROM posts')
+ * ```
+ */
+/**
+ * Build a parameterized SQL query from template literals
+ */
+function buildQuery(strings, values) {
+    let sql = '';
+    const params = [];
+    for (let i = 0; i < strings.length; i++) {
+        sql += strings[i];
+        if (i < values.length) {
+            params.push(values[i]);
+            sql += `$${params.length}`;
+        }
+    }
+    return { sql, params };
+}
+// Cached env and stub
+let cachedEnv = null;
+let cachedStub = null;
+async function getStub(config = {}) {
+    if (cachedStub)
+        return cachedStub;
+    if (!cachedEnv) {
+        try {
+            const mod = await import('cloudflare:workers');
+            cachedEnv = mod.env;
+        }
+        catch {
+            throw new Error('Could not import cloudflare:workers. ' +
+                'Ensure you are running in Cloudflare Workers with nodejs_compat.');
+        }
+    }
+    const binding = config.binding || 'POSTGRES';
+    const instance = config.instance || 'default';
+    const namespace = cachedEnv[binding];
+    if (!namespace) {
+        throw new Error(`Postgres binding "${binding}" not found. Add it to wrangler.toml.`);
+    }
+    cachedStub = namespace.get(namespace.idFromName(instance));
+    return cachedStub;
+}
+async function executeQuery(sql, params) {
+    const stub = await getStub();
+    const response = await stub.fetch(new Request('http://do/query', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ sql, params }),
+    }));
+    if (!response.ok) {
+        const error = await response.json();
+        throw new Error(error.error || 'Query failed');
+    }
+    return response.json();
+}
+// =============================================================================
+// sql - Tagged Template API
+// =============================================================================
+/**
+ * SQL tagged template - safe parameterized queries
+ *
+ * @example
+ * ```typescript
+ * import { sql } from '@dotdo/postgres'
+ *
+ * const posts = await sql`SELECT * FROM posts`
+ * const post = await sql`SELECT * FROM posts WHERE id = ${id}`
+ * const newPost = await sql`INSERT INTO posts (title) VALUES (${title}) RETURNING *`
+ * ```
+ */
+export async function sql(strings, ...values) {
+    const { sql: query, params } = buildQuery(strings, values);
+    return executeQuery(query, params);
+}
+/**
+ * Execute raw SQL (use with caution - ensure input is sanitized)
+ */
+sql.unsafe = async function (query, params) {
+    return executeQuery(query, params);
+};
+// =============================================================================
+// db - Database Client API
+// =============================================================================
+/**
+ * Database client for programmatic access
+ *
+ * @example
+ * ```typescript
+ * import { db } from '@dotdo/postgres'
+ *
+ * const result = await db.query('SELECT * FROM posts')
+ * await db.exec('CREATE TABLE posts (id SERIAL PRIMARY KEY, title TEXT)')
+ * ```
+ */
+export const db = {
+    /**
+     * Execute a query and return results
+     */
+    async query(sql, params) {
+        return executeQuery(sql, params);
+    },
+    /**
+     * Execute SQL without returning results (DDL, etc.)
+     */
+    async exec(sql) {
+        await executeQuery(sql);
+    },
+    /**
+     * Get raw access to the DO stub for advanced use cases
+     */
+    async getStub() {
+        return getStub();
+    },
+};
+// =============================================================================
+// Factory Functions (for custom binding/instance)
+// =============================================================================
+/**
+ * Create a sql function bound to a specific binding/instance
+ */
+export function createSql(env, config = {}) {
+    const binding = config.binding || 'POSTGRES';
+    const instance = config.instance || 'default';
+    const namespace = env[binding];
+    if (!namespace) {
+        throw new Error(`Postgres binding "${binding}" not found in env.`);
+    }
+    const stub = namespace.get(namespace.idFromName(instance));
+    async function boundSql(strings, ...values) {
+        const { sql: query, params } = buildQuery(strings, values);
+        const response = await stub.fetch(new Request('http://do/query', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ sql: query, params }),
+        }));
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.error || 'Query failed');
+        }
+        return response.json();
+    }
+    boundSql.unsafe = async function (query, params) {
+        const response = await stub.fetch(new Request('http://do/query', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ sql: query, params }),
+        }));
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.error || 'Query failed');
+        }
+        return response.json();
+    };
+    return boundSql;
+}
+/**
+ * Create a db client bound to a specific binding/instance
+ */
+export function createDb(env, config = {}) {
+    const binding = config.binding || 'POSTGRES';
+    const instance = config.instance || 'default';
+    const namespace = env[binding];
+    if (!namespace) {
+        throw new Error(`Postgres binding "${binding}" not found in env.`);
+    }
+    const stub = namespace.get(namespace.idFromName(instance));
+    return {
+        async query(sql, params) {
+            const response = await stub.fetch(new Request('http://do/query', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ sql, params }),
+            }));
+            if (!response.ok) {
+                const error = await response.json();
+                throw new Error(error.error || 'Query failed');
+            }
+            return response.json();
+        },
+        async exec(sql) {
+            await this.query(sql);
+        },
+        getStub() {
+            return stub;
+        },
+    };
+}
+export default sql;
+//# sourceMappingURL=sql.js.map

package/dist/do/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/do/sql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA0BH;;GAEG;AACH,SAAS,UAAU,CAAC,OAA6B,EAAE,MAAiB;IAClE,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,MAAM,MAAM,GAAc,EAAE,CAAA;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;QACjB,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;YACtB,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;AACxB,CAAC;AAED,sBAAsB;AACtB,IAAI,SAAS,GAAmC,IAAI,CAAA;AACpD,IAAI,UAAU,GAAkB,IAAI,CAAA;AAEpC,KAAK,UAAU,OAAO,CAAC,SAAoB,EAAE;IAC3C,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IAEjC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;YAC9C,SAAS,GAAG,GAAG,CAAC,GAA8B,CAAA;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,uCAAuC;gBACvC,kEAAkE,CACnE,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,UAAU,CAAA;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAA;IAE7C,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAkC,CAAA;IACrE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,uCAAuC,CAAC,CAAA;IACtF,CAAC;IAED,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1D,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,KAAK,UAAU,YAAY,CAAI,GAAW,EAAE,MAAkB;IAC5D,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAA;IAE5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,iBAAiB,EAAE;QAC/D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;KACtC,CAAC,CAAC,CAAA;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAA;QACxD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,CAAC,CAAA;IAChD,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAA2B,CAAA;AACjD,CAAC;AAED,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,OAA6B,EAC7B,GAAG,MAAiB;IAEpB,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1D,OAAO,YAAY,CAAI,KAAK,EAAE,MAAM,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,GAAG,CAAC,MAAM,GAAG,KAAK,WAChB,KAAa,EACb,MAAkB;IAElB,OAAO,YAAY,CAAI,KAAK,EAAE,MAAM,CAAC,CAAA;AACvC,CAAC,CAAA;AAED,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB;;OAEG;IACH,KAAK,CAAC,KAAK,CAA8B,GAAW,EAAE,MAAkB;QACtE,OAAO,YAAY,CAAI,GAAG,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,YAAY,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,OAAO,OAAO,EAAE,CAAA;IAClB,CAAC;CACF,CAAA;AAED,gFAAgF;AAChF,kDAAkD;AAClD,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAA4B,EAAE,SAAoB,EAAE;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,UAAU,CAAA;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAA;IAE7C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAkC,CAAA;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,qBAAqB,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE1D,KAAK,UAAU,QAAQ,CACrB,OAA6B,EAC7B,GAAG,MAAiB;QAEpB,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAE1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,iBAAiB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;SAC7C,CAAC,CAAC,CAAA;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAA;YACxD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,CAAC,CAAA;QAChD,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAA2B,CAAA;IACjD,CAAC;IAED,QAAQ,CAAC,MAAM,GAAG,KAAK,WACrB,KAAa,EACb,MAAkB;QAElB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,iBAAiB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;SAC7C,CAAC,CAAC,CAAA;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAA;YACxD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,CAAC,CAAA;QAChD,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAA2B,CAAA;IACjD,CAAC,CAAA;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAA4B,EAAE,SAAoB,EAAE;IAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,UAAU,CAAA;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAA;IAE7C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAkC,CAAA;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,qBAAqB,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE1D,OAAO;QACL,KAAK,CAAC,KAAK,CAA8B,GAAW,EAAE,MAAkB;YACtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,iBAAiB,EAAE;gBAC/D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;aACtC,CAAC,CAAC,CAAA;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAA;gBACxD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,CAAC,CAAA;YAChD,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,EAA2B,CAAA;QACjD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAW;YACpB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACvB,CAAC;QAED,OAAO;YACL,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,GAAG,CAAA"}

package/dist/index.d.ts

@@ -1,50 +1,45 @@
 /**
  * @module @dotdo/postgres
  *
- * PostgreSQL server for Cloudflare Workers/DOs with PGLite WASM and tiered storage.
+ * PostgreSQL for Cloudflare Workers - Simple, Persistent, Powerful.
  *
- * This package provides a complete PostgreSQL-compatible database solution
- * optimized for Cloudflare's edge infrastructure:
- *
- * - **Worker Module**: PostgresDO Durable Object with HTTP/WebSocket APIs
- * - **PGLite Module**: Tiered storage system (Cache/DO/R2) for PGLite
- * - **Extensions Module**: PGLite extension management and pgvector support
- * - **Routing Module**: Intelligent query routing based on CPU cost estimation
- * - **Read-Only Module**: Security-focused read-only deployment mode
- * - **Middleware Module**: Rate limiting with sliding window and token bucket algorithms
- *
- * @example
+ * @example Minimal API
  * ```typescript
- * import {
- *   PostgresDO,
- *   createRoutes,
- *   WebSocketHandler,
- * } from '@dotdo/postgres'
- *
- * // Export the Durable Object
- * export { PostgresDO }
- *
- * // Create Hono routes
- * const app = new Hono()
- * app.route('/api/sql', createRoutes(env))
+ * import { sql, Postgres } from '@dotdo/postgres'
+ * export { Postgres }
  *
  * export default {
- *   fetch: app.fetch,
+ *   fetch: () => Response.json(await sql`SELECT * FROM posts`)
  * }
  * ```
  *
- * @example
+ * @example With Hono
  * ```typescript
- * // Use tiered storage for PGLite
- * import { createDOVFS, TieredVFS, CacheLayer } from '@dotdo/postgres/pglite'
+ * import { Hono } from 'hono'
+ * import { sql, Postgres } from '@dotdo/postgres'
+ * export { Postgres }
  *
- * const vfs = createDOVFS(ctx.storage)
- * const pglite = await PGlite.create({ vfs })
+ * const app = new Hono()
+ * app.get('/posts', c => sql`SELECT * FROM posts`.then(r => c.json(r)))
+ * app.get('/posts/:id', c => sql`SELECT * FROM posts WHERE id = ${c.req.param('id')}`.then(r => c.json(r)))
+ *
+ * export default app
  * ```
+ *
+ * The Postgres Durable Object provides:
+ * - Full PostgreSQL via PGLite WASM
+ * - Automatic persistence via DO SQLite
+ * - Safe parameterized queries via tagged templates
+ *
+ * For advanced features (tiered storage, migrations, observability), see submodules.
  */
+export { sql, db, createSql, createDb, Postgres } from './do';
+export type { SqlConfig, SqlResult, PostgresEnv, QueryResult } from './do';
 export * from './config';
 export { createTenantId, createPageNumber, createMigrationVersion, createQueryId, createSnapshotId, createBlockId, createShardId, createIngestId, createReplicaId, createBatchId, isTenantId, isPageNumber, isMigrationVersion, isQueryId, isSnapshotId, isBlockId, isShardId, isIngestId, isReplicaId, isBatchId, unwrap, unsafeTenantId, unsafePageNumber, unsafeMigrationVersion, unsafeQueryId, unsafeSnapshotId, unsafeBlockId, unsafeShardId, unsafeIngestId, unsafeReplicaId, unsafeBatchId, TENANT_ID_MAX_LENGTH, TENANT_ID_PATTERN, MAX_PAGE_NUMBER, QUERY_ID_PATTERN, SNAPSHOT_ID_PATTERN, MAX_SNAPSHOT_ID, BLOCK_ID_PATTERN, SHARD_ID_PATTERN, SHARD_ID_MAX_LENGTH, INGEST_ID_PATTERN, INGEST_ID_MAX_LENGTH, REPLICA_ID_PATTERN, REPLICA_ID_MAX_LENGTH, BATCH_ID_PATTERN, BATCH_ID_MAX_LENGTH, } from './types/branded';
 export type { TenantId, PageNumber, MigrationVersion, QueryId, SnapshotId, BlockId, ShardId, IngestId, ReplicaId, BatchId, Branded, } from './types/branded';
 export { isDefined, isString, isNumber, isBoolean, isPlainObject, isArray, isFunction, isPromise, isError, assertDefined, assert, assertNever, success, failure, isSuccess, isFailure, toBodyInit, toArrayBuffer, isArrayBufferView, isUint8Array, narrowStorageValue, assertStorageValue, createDiscriminatorGuard, unsafeCast, safeCast, getProperty, hasProperty, hasProperties, } from './types/utilities';
 export type { Nullable, Optional, Maybe, NonNullish, Constructor, ConstructorWithArgs, AbstractConstructor, Success, Failure, Result, AsyncResult, DeepPartial, DeepRequired, DeepReadonly, DeepMutable, Awaited, MaybePromise, Awaitable, AsyncFunction, StringRecord, KeysOfType, PickByType, OmitByType, RequireKeys, OptionalKeys, ValueOf, AnyFunction, VoidFunction, Thunk, Predicate, TypeGuard, FirstParameter, LastParameter, Capitalize, Uncapitalize, Join, Head, Tail, Last, Length, DiscriminatedMessage, } from './types/utilities';
+export { PostgresClient, createPostgresClient, } from './client';
+export type { PostgresClientConfig, PostgresDORpcApi, RpcQueryResult, RpcBatchQuery, RpcBatchResult, RpcTransactionOptions, TransactionApi, ColumnInfo, DatabaseStats, ConnectionState, } from './client';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAMH,cAAc,UAAU,CAAA;AAMxB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,EACP,OAAO,GACR,MAAM,iBAAiB,CAAA;AAMxB,OAAO,EAEL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EAET,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EAEZ,kBAAkB,EAClB,kBAAkB,EAElB,wBAAwB,EAExB,UAAU,EACV,QAAQ,EAER,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EAEV,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAU,EAEV,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EAEnB,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,aAAa,EAEb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,OAAO,EAEP,WAAW,EACX,YAAY,EACZ,KAAK,EACL,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EAEb,UAAU,EACV,YAAY,EACZ,IAAI,EAEJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EAEN,oBAAoB,GACrB,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAC7D,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAM1E,cAAc,UAAU,CAAA;AAMxB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,EACP,OAAO,GACR,MAAM,iBAAiB,CAAA;AAMxB,OAAO,EAEL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EAET,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EAEZ,kBAAkB,EAClB,kBAAkB,EAElB,wBAAwB,EAExB,UAAU,EACV,QAAQ,EAER,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EAEV,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAU,EAEV,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EAEnB,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,aAAa,EAEb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,OAAO,EAEP,WAAW,EACX,YAAY,EACZ,KAAK,EACL,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EAEb,UAAU,EACV,YAAY,EACZ,IAAI,EAEJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EAEN,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAM1B,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,UAAU,CAAA;AAEjB,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -1,48 +1,43 @@
 /**
  * @module @dotdo/postgres
  *
- * PostgreSQL server for Cloudflare Workers/DOs with PGLite WASM and tiered storage.
+ * PostgreSQL for Cloudflare Workers - Simple, Persistent, Powerful.
  *
- * This package provides a complete PostgreSQL-compatible database solution
- * optimized for Cloudflare's edge infrastructure:
- *
- * - **Worker Module**: PostgresDO Durable Object with HTTP/WebSocket APIs
- * - **PGLite Module**: Tiered storage system (Cache/DO/R2) for PGLite
- * - **Extensions Module**: PGLite extension management and pgvector support
- * - **Routing Module**: Intelligent query routing based on CPU cost estimation
- * - **Read-Only Module**: Security-focused read-only deployment mode
- * - **Middleware Module**: Rate limiting with sliding window and token bucket algorithms
- *
- * @example
+ * @example Minimal API
  * ```typescript
- * import {
- *   PostgresDO,
- *   createRoutes,
- *   WebSocketHandler,
- * } from '@dotdo/postgres'
- *
- * // Export the Durable Object
- * export { PostgresDO }
- *
- * // Create Hono routes
- * const app = new Hono()
- * app.route('/api/sql', createRoutes(env))
+ * import { sql, Postgres } from '@dotdo/postgres'
+ * export { Postgres }
  *
  * export default {
- *   fetch: app.fetch,
+ *   fetch: () => Response.json(await sql`SELECT * FROM posts`)
  * }
  * ```
  *
- * @example
+ * @example With Hono
  * ```typescript
- * // Use tiered storage for PGLite
- * import { createDOVFS, TieredVFS, CacheLayer } from '@dotdo/postgres/pglite'
+ * import { Hono } from 'hono'
+ * import { sql, Postgres } from '@dotdo/postgres'
+ * export { Postgres }
+ *
+ * const app = new Hono()
+ * app.get('/posts', c => sql`SELECT * FROM posts`.then(r => c.json(r)))
+ * app.get('/posts/:id', c => sql`SELECT * FROM posts WHERE id = ${c.req.param('id')}`.then(r => c.json(r)))
  *
- * const vfs = createDOVFS(ctx.storage)
- * const pglite = await PGlite.create({ vfs })
+ * export default app
  * ```
+ *
+ * The Postgres Durable Object provides:
+ * - Full PostgreSQL via PGLite WASM
+ * - Automatic persistence via DO SQLite
+ * - Safe parameterized queries via tagged templates
+ *
+ * For advanced features (tiered storage, migrations, observability), see submodules.
  */
 // ============================================================================
+// Core API - The Minimal Interface
+// ============================================================================
+export { sql, db, createSql, createDb, Postgres } from './do';
+// ============================================================================
 // Configuration Module - Centralized Constants
 // ============================================================================
 export * from './config';
@@ -66,4 +61,8 @@ createDiscriminatorGuard,
 unsafeCast, safeCast, 
 // Object property helpers
 getProperty, hasProperty, hasProperties, } from './types/utilities';
+// ============================================================================
+// Client Module - WebSocket client with rpc.do integration
+// ============================================================================
+export { PostgresClient, createPostgresClient, } from './client';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E,cAAc,UAAU,CAAA;AAExB,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAgBxB,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,OAAO;AACL,oBAAoB;AACpB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS;AACT,kBAAkB;AAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY;AACZ,kBAAkB;AAClB,kBAAkB,EAClB,kBAAkB;AAClB,8BAA8B;AAC9B,wBAAwB;AACxB,yBAAyB;AACzB,UAAU,EACV,QAAQ;AACR,0BAA0B;AAC1B,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAG7D,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E,cAAc,UAAU,CAAA;AAExB,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAgBxB,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,OAAO;AACL,oBAAoB;AACpB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS;AACT,kBAAkB;AAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY;AACZ,kBAAkB;AAClB,kBAAkB,EAClB,kBAAkB;AAClB,8BAA8B;AAC9B,wBAAwB;AACxB,yBAAyB;AACzB,UAAU,EACV,QAAQ;AACR,0BAA0B;AAC1B,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA;AAwD1B,+EAA+E;AAC/E,2DAA2D;AAC3D,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,UAAU,CAAA"}

package/dist/mcp/binding.d.ts

@@ -0,0 +1,47 @@
+/**
+ * PostgreSQL Binding for MCP Do Tool
+ *
+ * Creates the `pg` binding that is available in the sandboxed code execution
+ * environment. Wraps PostgresDO RPC calls in a clean API.
+ */
+import type { PGBinding } from './types.js';
+/**
+ * Interface for the query executor (PostgresDO stub)
+ */
+export interface QueryExecutor {
+    rpcQuery(sql: string, params?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        fields: Array<{
+            name: string;
+            dataTypeID: number;
+        }>;
+        rowCount: number;
+    }>;
+    rpcBatchTransaction(queries: Array<{
+        sql: string;
+        params?: unknown[];
+    }>): Promise<{
+        results: Array<{
+            rows: Record<string, unknown>[];
+            fields: Array<{
+                name: string;
+                dataTypeID: number;
+            }>;
+            rowCount: number;
+        }>;
+        success: boolean;
+    }>;
+}
+/**
+ * Create the pg binding for the do tool
+ *
+ * @param executor - Query executor (PostgresDO stub)
+ * @returns The pg binding object
+ */
+export declare function createPGBinding(executor: QueryExecutor): PGBinding;
+/**
+ * TypeScript type definitions for the pg binding
+ * Used by the do tool to provide type information to LLMs
+ */
+export declare const PG_BINDING_TYPES = "\ninterface QueryResult<T = Record<string, unknown>> {\n  rows: T[]\n  rowCount: number\n  fields: Array<{ name: string; dataTypeID: number }>\n}\n\ninterface TableInfo {\n  name: string\n  schema: string\n  type: 'table' | 'view' | 'materialized_view'\n}\n\ninterface ColumnInfo {\n  name: string\n  type: string\n  nullable: boolean\n  default?: string\n  primaryKey: boolean\n}\n\ninterface PGTransaction {\n  query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>\n  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>\n}\n\ndeclare const pg: {\n  /**\n   * Execute a SQL query with optional parameters\n   * @example\n   * const users = await pg.query('SELECT * FROM users WHERE age > $1', [18])\n   * console.log(users.rows)\n   */\n  query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>\n\n  /**\n   * Execute a SQL statement (INSERT, UPDATE, DELETE)\n   * @example\n   * const result = await pg.execute('UPDATE users SET active = true WHERE id = $1', [1])\n   * console.log(result.rowCount)\n   */\n  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>\n\n  /**\n   * Execute multiple statements in a transaction\n   * @example\n   * await pg.transaction(async (tx) => {\n   *   await tx.execute('INSERT INTO orders (user_id) VALUES ($1)', [1])\n   *   await tx.execute('UPDATE users SET order_count = order_count + 1 WHERE id = $1', [1])\n   * })\n   */\n  transaction<T>(fn: (tx: PGTransaction) => Promise<T>): Promise<T>\n\n  /**\n   * List all tables in the database\n   * @example\n   * const tables = await pg.tables()\n   * tables.forEach(t => console.log(t.name))\n   */\n  tables(): Promise<TableInfo[]>\n\n  /**\n   * Get schema information for a table\n   * @example\n   * const columns = await pg.schema('users')\n   * columns.forEach(c => console.log(`${c.name}: ${c.type}`))\n   */\n  schema(tableName: string): Promise<ColumnInfo[]>\n}\n";
+//# sourceMappingURL=binding.d.ts.map

package/dist/mcp/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/mcp/binding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EAKV,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;QAC/B,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QACnD,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAC,CAAA;IACF,mBAAmB,CACjB,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,GAClD,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;YAC/B,MAAM,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;YACnD,QAAQ,EAAE,MAAM,CAAA;SACjB,CAAC,CAAA;QACF,OAAO,EAAE,OAAO,CAAA;KACjB,CAAC,CAAA;CACH;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAsHlE;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+7DAqE5B,CAAA"}

package/dist/mcp/binding.js

@@ -0,0 +1,183 @@
+/**
+ * PostgreSQL Binding for MCP Do Tool
+ *
+ * Creates the `pg` binding that is available in the sandboxed code execution
+ * environment. Wraps PostgresDO RPC calls in a clean API.
+ */
+/**
+ * Create the pg binding for the do tool
+ *
+ * @param executor - Query executor (PostgresDO stub)
+ * @returns The pg binding object
+ */
+export function createPGBinding(executor) {
+    return {
+        async query(sql, params) {
+            const result = await executor.rpcQuery(sql, params);
+            return {
+                rows: result.rows,
+                rowCount: result.rowCount,
+                fields: result.fields,
+            };
+        },
+        async execute(sql, params) {
+            const result = await executor.rpcQuery(sql, params);
+            return { rowCount: result.rowCount };
+        },
+        async transaction(fn) {
+            // Execute BEGIN, run function with transaction context, execute COMMIT/ROLLBACK
+            await executor.rpcQuery('BEGIN');
+            try {
+                const result = await fn({
+                    async query(sql, params) {
+                        const res = await executor.rpcQuery(sql, params);
+                        return {
+                            rows: res.rows,
+                            rowCount: res.rowCount,
+                            fields: res.fields,
+                        };
+                    },
+                    async execute(sql, params) {
+                        const res = await executor.rpcQuery(sql, params);
+                        return { rowCount: res.rowCount };
+                    },
+                });
+                await executor.rpcQuery('COMMIT');
+                return result;
+            }
+            catch (error) {
+                await executor.rpcQuery('ROLLBACK');
+                throw error;
+            }
+        },
+        async tables() {
+            const result = await executor.rpcQuery(`
+        SELECT
+          table_name as name,
+          table_schema as schema,
+          CASE table_type
+            WHEN 'BASE TABLE' THEN 'table'
+            WHEN 'VIEW' THEN 'view'
+            ELSE 'table'
+          END as type
+        FROM information_schema.tables
+        WHERE table_schema NOT IN ('pg_catalog', 'information_schema')
+        ORDER BY table_schema, table_name
+      `);
+            return result.rows.map((row) => ({
+                name: row.name,
+                schema: row.schema,
+                type: row.type,
+            }));
+        },
+        async schema(tableName) {
+            // Validate table name to prevent SQL injection
+            if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(tableName)) {
+                throw new Error('Invalid table name');
+            }
+            const result = await executor.rpcQuery(`
+        SELECT
+          c.column_name as name,
+          c.data_type as type,
+          c.is_nullable = 'YES' as nullable,
+          c.column_default as "default",
+          COALESCE(
+            (SELECT true FROM information_schema.key_column_usage kcu
+             JOIN information_schema.table_constraints tc
+               ON kcu.constraint_name = tc.constraint_name
+             WHERE tc.constraint_type = 'PRIMARY KEY'
+               AND kcu.table_name = c.table_name
+               AND kcu.column_name = c.column_name
+             LIMIT 1),
+            false
+          ) as "primaryKey"
+        FROM information_schema.columns c
+        WHERE c.table_name = $1
+          AND c.table_schema NOT IN ('pg_catalog', 'information_schema')
+        ORDER BY c.ordinal_position
+      `, [tableName]);
+            return result.rows.map((row) => ({
+                name: row.name,
+                type: row.type,
+                nullable: Boolean(row.nullable),
+                ...(row.default !== null && { default: row.default }),
+                primaryKey: Boolean(row.primaryKey),
+            }));
+        },
+    };
+}
+/**
+ * TypeScript type definitions for the pg binding
+ * Used by the do tool to provide type information to LLMs
+ */
+export const PG_BINDING_TYPES = `
+interface QueryResult<T = Record<string, unknown>> {
+  rows: T[]
+  rowCount: number
+  fields: Array<{ name: string; dataTypeID: number }>
+}
+
+interface TableInfo {
+  name: string
+  schema: string
+  type: 'table' | 'view' | 'materialized_view'
+}
+
+interface ColumnInfo {
+  name: string
+  type: string
+  nullable: boolean
+  default?: string
+  primaryKey: boolean
+}
+
+interface PGTransaction {
+  query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>
+  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>
+}
+
+declare const pg: {
+  /**
+   * Execute a SQL query with optional parameters
+   * @example
+   * const users = await pg.query('SELECT * FROM users WHERE age > $1', [18])
+   * console.log(users.rows)
+   */
+  query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>
+
+  /**
+   * Execute a SQL statement (INSERT, UPDATE, DELETE)
+   * @example
+   * const result = await pg.execute('UPDATE users SET active = true WHERE id = $1', [1])
+   * console.log(result.rowCount)
+   */
+  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>
+
+  /**
+   * Execute multiple statements in a transaction
+   * @example
+   * await pg.transaction(async (tx) => {
+   *   await tx.execute('INSERT INTO orders (user_id) VALUES ($1)', [1])
+   *   await tx.execute('UPDATE users SET order_count = order_count + 1 WHERE id = $1', [1])
+   * })
+   */
+  transaction<T>(fn: (tx: PGTransaction) => Promise<T>): Promise<T>
+
+  /**
+   * List all tables in the database
+   * @example
+   * const tables = await pg.tables()
+   * tables.forEach(t => console.log(t.name))
+   */
+  tables(): Promise<TableInfo[]>
+
+  /**
+   * Get schema information for a table
+   * @example
+   * const columns = await pg.schema('users')
+   * columns.forEach(c => console.log(\`\${c.name}: \${c.type}\`))
+   */
+  schema(tableName: string): Promise<ColumnInfo[]>
+}
+`;
+//# sourceMappingURL=binding.js.map

package/dist/mcp/binding.js.map

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