@jaepil/usqldb 0.3.0

package/README.md

@@ -0,0 +1,225 @@
+# usqldb-js
+
+PostgreSQL 17-compatible layer for [UQA](https://github.com/cognica-io/uqa-js) — system catalogs, psql-style CLI, and wire protocol server.
+
+usqldb-js extends the UQA SQL engine with a comprehensive set of PostgreSQL system catalog views so that standard PostgreSQL tools — psql, SQLAlchemy, DBeaver, DataGrip, Django, and others — can introspect the database as if it were a real PostgreSQL 17 instance.
+
+TypeScript port of [usqldb](https://github.com/cognica-io/usqldb) that runs in **web browsers** and Node.js.
+
+## Features
+
+- **23 information_schema views** — schemata, tables, columns, constraints, views, sequences, routines, foreign tables, triggers, and more.
+- **35 pg_catalog tables** — pg_class, pg_attribute, pg_type, pg_constraint, pg_index, pg_proc, pg_settings, statistics views, and more, with consistent OID cross-references across all of them.
+- **PostgreSQL v3 wire protocol server** — full Simple Query and Extended Query support with SCRAM-SHA-256 / MD5 / trust authentication. Connect with psql, DBeaver, DataGrip, JDBC, psycopg, asyncpg, node-postgres, and any other PostgreSQL client.
+- **Interactive SQL shell** — psql-style REPL with backslash commands (`\d`, `\dt`, `\di`, `\dv`, `\ds`, `\df`, `\dn`, `\du`, `\l`, `\det`, `\des`, `\dew`, `\x`, `\timing`, `\o`, `\i`, `\e`), tab-completion, expanded display, query timing, multi-line editing, and ANSI color output (automatically disabled when piped).
+- **Drop-in engine** — `USQLEngine` is a drop-in replacement for `Engine` from `@jaepil/uqa`. Import it, and every query gets full catalog support.
+- **Persistent storage** — file-based SQLite databases that survive across process restarts.
+- **Browser-compatible** — ESM and UMD builds with no Node.js-specific APIs.
+
+## Requirements
+
+- Node.js 20+ (for development and testing)
+- `@jaepil/uqa` >= 0.3.7
+
+## Installation
+
+```bash
+npm install @jaepil/usqldb
+```
+
+## Quick Start
+
+### As a library
+
+```typescript
+import { USQLEngine } from "@jaepil/usqldb";
+
+const engine = new USQLEngine();
+await engine.sql("CREATE TABLE users (id SERIAL PRIMARY KEY, name TEXT)");
+await engine.sql("INSERT INTO users (name) VALUES ('Alice')");
+
+// information_schema
+const cols = await engine.sql(
+  "SELECT column_name, data_type " +
+  "FROM information_schema.columns " +
+  "WHERE table_name = 'users'"
+);
+
+// pg_catalog with OID joins
+const types = await engine.sql(
+  "SELECT c.relname, a.attname, t.typname " +
+  "FROM pg_catalog.pg_class c " +
+  "JOIN pg_catalog.pg_attribute a ON c.oid = a.attrelid " +
+  "JOIN pg_catalog.pg_type t ON a.atttypid = t.oid " +
+  "WHERE c.relname = 'users' AND a.attnum > 0"
+);
+```
+
+### Wire protocol server
+
+```typescript
+import { PGWireServer, createConfig, AuthMethod } from "@jaepil/usqldb/net/pgwire";
+
+const config = createConfig({
+  host: "0.0.0.0",
+  port: 5432,
+  authMethod: AuthMethod.SCRAM_SHA_256,
+  credentials: { admin: "secret123" },
+});
+const server = new PGWireServer(config);
+await server.start();
+```
+
+Then connect with any PostgreSQL client:
+
+```bash
+psql -h localhost -p 5432 -U admin
+```
+
+### As a CLI
+
+```bash
+# In-memory database
+npx usqldb
+
+# Persistent storage
+npx usqldb --db mydata.db
+
+# Execute a single command and exit
+npx usqldb -c "SELECT 1"
+```
+
+### Backslash Commands
+
+```
+General
+  \q                  Quit
+  \? [commands]       Show help
+  \conninfo           Display connection info
+  \encoding           Show client encoding
+  \! [COMMAND]        Execute shell command
+
+Informational
+  \d [NAME]           Describe table/view/index or list all
+  \dt[+] [PATTERN]    List tables
+  \di[+] [PATTERN]    List indexes
+  \dv[+] [PATTERN]    List views
+  \ds[+] [PATTERN]    List sequences
+  \df[+] [PATTERN]    List functions
+  \dn[+]              List schemas
+  \du                 List roles
+  \l[+]               List databases
+  \det                List foreign tables
+  \des                List foreign servers
+  \dew                List foreign data wrappers
+
+Formatting
+  \x                  Toggle expanded display
+  \timing             Toggle timing of commands
+
+Input/Output
+  \o [FILE]           Send output to file or stdout
+  \i FILE             Execute commands from file
+  \e [FILE]           Edit query or file with $EDITOR
+```
+
+### Browser Usage
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@jaepil/uqa/dist/uqa.umd.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@jaepil/usqldb/dist/usqldb.umd.js"></script>
+<script>
+  const engine = new usqldb.USQLEngine();
+  // ... use engine.sql() as above
+</script>
+```
+
+## Project Structure
+
+```
+src/
+  index.ts                          Public API exports
+  core/
+    engine.ts                       USQLEngine — drop-in replacement for Engine
+    compiler.ts                     Row normalization utilities
+  pg-compat/
+    oid.ts                          OID allocation and PostgreSQL type mapping
+    information-schema.ts           23 information_schema view builders
+    pg-catalog.ts                   35 pg_catalog table builders
+  net/
+    pgwire/
+      index.ts                     Wire protocol public API
+      server.ts                    TCP server with connection management
+      connection.ts                Per-client connection handler
+      query-executor.ts            Simple Query and Extended Query executor
+      server-cli.ts                Standalone server entry point
+      auth.ts                      SCRAM-SHA-256 / MD5 / trust authentication
+      config.ts                    Server configuration
+      message-codec.ts             Frontend/backend message encoding/decoding
+      messages.ts                  Message type definitions
+      type-codec.ts                PostgreSQL type serialization/deserialization
+      read-buffer.ts               Streaming TCP read buffer
+      write-buffer.ts              Binary write buffer
+      constants.ts                 Protocol constants and format codes
+      errors.ts                    PostgreSQL error response builder
+  cli/
+    index.ts                       CLI public API
+    shell.ts                       Interactive SQL shell
+    shell-cli.ts                   CLI entry point
+    command-handler.ts             Backslash command handlers
+    completer.ts                   Context-aware SQL tab-completion
+    formatter.ts                   psql-compatible tabular and expanded output
+tests/
+  pg-compat.test.ts                74 tests covering all catalog views
+  catalog-completeness.test.ts     94 tests for catalog query correctness
+  cli/
+    cli.test.ts                    38 tests for CLI and backslash commands
+  net/pgwire/
+    server.test.ts                 17 tests for wire protocol server
+    auth.test.ts                   12 tests for authentication
+    message-codec.test.ts          35 tests for message encoding/decoding
+    type-codec.test.ts             53 tests for type serialization
+    buffer.test.ts                 20 tests for read/write buffers
+    errors.test.ts                 13 tests for error responses
+examples/
+  01_basic_usage.ts                Basic SQL operations
+  02_persistent_storage.ts         File-based persistent database
+  03_catalog_introspection.ts      information_schema and pg_catalog queries
+  04_pgwire_server.ts              Wire protocol server
+  05_pgwire_auth.ts                SCRAM-SHA-256 authentication
+  06_pgwire_client.ts              Connecting with node-postgres
+  07_pgwire_persistent.ts          Wire protocol with persistent storage
+  08_pgwire_shared_engine.ts       Shared engine across connections
+  09_advanced_schema.ts            Complex schema with constraints
+  10_usqldb_server_cli.sh          Server CLI usage
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Type check
+npm run check
+
+# Run tests
+npm test
+
+# Build (type check + Vite bundle + type declarations)
+npm run build
+
+# Lint
+npm run lint
+
+# Format
+npm run format
+```
+
+## License
+
+AGPL-3.0-only
+
+## Author
+
+Jaepil Jeong (jaepil@cognica.io) — [Cognica, Inc.](https://github.com/cognica-io)

package/dist/types/cli/command-handler.d.ts

@@ -0,0 +1,52 @@
+import type { Formatter } from "./formatter.js";
+import type { USQLEngine } from "../core/engine.js";
+/**
+ * Dispatches and executes backslash commands.
+ */
+export declare class CommandHandler {
+    readonly engine: USQLEngine;
+    readonly formatter: Formatter;
+    private readonly _output;
+    showTiming: boolean;
+    outputFile: string | null;
+    dbPath: string | null;
+    executeFileFn: ((filePath: string) => void) | null;
+    constructor(engine: USQLEngine, formatter: Formatter, outputFn: (text: string) => void);
+    handle(cmdLine: string): Promise<boolean>;
+    output(text: string): void;
+    private _query;
+    private _printRows;
+    private _cmdDescribe;
+    private _cmdListRelations;
+    private _describeRelation;
+    private _describeTable;
+    private _buildFKLines;
+    private _buildReferencedBy;
+    private _describeView;
+    private _describeIndex;
+    private _describeSequence;
+    private _describeForeignTable;
+    private _cmdListTables;
+    private _cmdListTablesPlus;
+    private _cmdListIndexes;
+    private _cmdListViews;
+    private _cmdListSequences;
+    private _cmdListFunctions;
+    private _cmdListSchemas;
+    private _cmdListRoles;
+    private _cmdListDatabases;
+    private _cmdListForeignTables;
+    private _cmdListForeignServers;
+    private _cmdListForeignDataWrappers;
+    private _cmdListGraphs;
+    private _cmdToggleExpanded;
+    private _cmdToggleTiming;
+    private _cmdOutput;
+    private _cmdInclude;
+    private _cmdEdit;
+    private _cmdConninfo;
+    private _cmdEncoding;
+    private _cmdShell;
+    private _cmdHelp;
+}
+//# sourceMappingURL=command-handler.d.ts.map

package/dist/types/cli/command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../src/cli/command-handler.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AASpD;;GAEG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAGjD,UAAU,EAAE,OAAO,CAAS;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG7B,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAGxD,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAW5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiE/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;YAQZ,MAAM;IAKpB,OAAO,CAAC,UAAU;YAQJ,YAAY;YAQZ,iBAAiB;YAiDjB,iBAAiB;YAkCjB,cAAc;YAuHd,aAAa;YAoDb,kBAAkB;YAoClB,aAAa;YA4Db,cAAc;YAoBd,iBAAiB;YAqBjB,qBAAqB;YA8CrB,cAAc;YAwBd,kBAAkB;YAqClB,eAAe;YA6Bf,aAAa;YA4Bb,iBAAiB;YA4BjB,iBAAiB;YA0BjB,eAAe;YAgBf,aAAa;YAoCb,iBAAiB;YAuBjB,qBAAqB;YAoBrB,sBAAsB;YAwBtB,2BAA2B;IAsBzC,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,QAAQ;IAqChB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,QAAQ;CAkCjB"}

package/dist/types/cli/completer.d.ts

@@ -0,0 +1,23 @@
+import type { USQLEngine } from "../core/engine.js";
+/**
+ * Context-aware SQL completer with dynamic table/column names.
+ *
+ * Adapts to Node.js readline's completer interface, returning
+ * [completions, original] tuples.
+ */
+export declare class Completer {
+    private readonly _engine;
+    constructor(engine: USQLEngine);
+    /**
+     * Node.js readline-compatible completer function.
+     *
+     * Returns [matchingCompletions, originalSubstring].
+     */
+    complete(line: string): [string[], string];
+    private _tableCompletions;
+    private _getWordBeforeCursor;
+    private _getCompiler;
+    private _getMap;
+    private _getColumnNames;
+}
+//# sourceMappingURL=completer.d.ts.map

package/dist/types/cli/completer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completer.d.ts","sourceRoot":"","sources":["../../../src/cli/completer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgPpD;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAEzB,MAAM,EAAE,UAAU;IAI9B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC;IA2H1C,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,eAAe;CAcxB"}

package/dist/types/cli/formatter.d.ts

@@ -0,0 +1,39 @@
+type Row = Record<string, unknown>;
+interface SQLResult {
+    readonly columns: string[];
+    readonly rows: Row[];
+}
+export declare const ANSI: {
+    reset: string;
+    bold: string;
+    dim: string;
+    red: string;
+    cyan: string;
+};
+/**
+ * Stateful output formatter matching psql display conventions.
+ *
+ * Supports two modes:
+ *   - aligned (default): columnar table with | separators
+ *   - expanded (\x): vertical, one column per line
+ */
+export declare class Formatter {
+    expanded: boolean;
+    nullDisplay: string;
+    useColor: boolean;
+    private _wrap;
+    /**
+     * Format a SQLResult for terminal display.
+     */
+    formatResult(result: SQLResult, title?: string): string;
+    /**
+     * Format raw column/row data for terminal display.
+     */
+    formatRows(columns: string[], rows: Row[], title?: string): string;
+    private _formatAligned;
+    private _formatExpanded;
+    private _colorizeCell;
+    private _formatValue;
+}
+export {};
+//# sourceMappingURL=formatter.d.ts.map

package/dist/types/cli/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/cli/formatter.ts"],"names":[],"mappings":"AAOA,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,UAAU,SAAS;IACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,IAAI;;;;;;CAMhB,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,QAAQ,EAAE,OAAO,CAAS;IAC1B,WAAW,EAAE,MAAM,CAAM;IACzB,QAAQ,EAAE,OAAO,CAAQ;IAEzB,OAAO,CAAC,KAAK;IAWb;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAWvD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAWlE,OAAO,CAAC,cAAc;IA8EtB,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,YAAY;CAarB"}

package/dist/types/cli/index.d.ts

@@ -0,0 +1,4 @@
+export { USQLShell } from "./shell.js";
+export { CommandHandler } from "./command-handler.js";
+export { Formatter } from "./formatter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/cli/shell-cli.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Entry point for the usqldb interactive shell command.
+ */
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=shell-cli.d.ts.map

package/dist/types/cli/shell-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-cli.d.ts","sourceRoot":"","sources":["../../../src/cli/shell-cli.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EzD"}

package/dist/types/cli/shell.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Interactive SQL shell backed by a USQLEngine.
+ */
+export declare class USQLShell {
+    private readonly _dbPath;
+    private readonly _engine;
+    private readonly _formatter;
+    private readonly _commands;
+    private readonly _completer;
+    private readonly _useColor;
+    private _rl;
+    constructor(opts?: {
+        dbPath?: string;
+    });
+    /**
+     * Execute every statement in a SQL script file.
+     */
+    runFile(filePath: string): void;
+    /**
+     * Execute every statement in a SQL script file (async version).
+     */
+    runFileAsync(filePath: string): Promise<void>;
+    /**
+     * Enter the read-eval-print loop.
+     */
+    run(): Promise<void>;
+    /**
+     * Close the engine and clean up.
+     */
+    close(): Promise<void>;
+    _executeText(text: string): Promise<void>;
+    private _executeSQL;
+    private _printResult;
+    private _print;
+    private _colorError;
+    private _colorDim;
+    private static _historyPath;
+    private _ensureReadline;
+    private _printBanner;
+}
+//# sourceMappingURL=shell.d.ts.map

package/dist/types/cli/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/cli/shell.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,GAAG,CAAmC;gBAElC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAoBtC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ/B;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAiBjC,WAAW;IAiBzB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,MAAM,CAAC,YAAY;IAM3B,OAAO,CAAC,eAAe;IA8CvB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/types/core/compiler.d.ts

@@ -0,0 +1,4 @@
+type Row = Record<string, unknown>;
+export declare function normalizeRows(rows: Row[]): Row[];
+export {};
+//# sourceMappingURL=compiler.d.ts.map

package/dist/types/core/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/core/compiler.ts"],"names":[],"mappings":"AAYA,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAoBhD"}

package/dist/types/core/engine.d.ts

@@ -0,0 +1,14 @@
+import { Engine } from "@jaepil/uqa";
+import type { SQLResult } from "@jaepil/uqa";
+export declare class USQLEngine extends Engine {
+    private _oidAllocator;
+    constructor(opts?: {
+        dbPath?: string;
+        parallelWorkers?: number;
+        spillThreshold?: number;
+    });
+    private _patchCompiler;
+    private _getOids;
+    sql(query: string, params?: unknown[]): Promise<SQLResult | null>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/types/core/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/core/engine.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAyD7C,qBAAa,UAAW,SAAQ,MAAM;IACpC,OAAO,CAAC,aAAa,CAA6B;gBAEtC,IAAI,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAKD,OAAO,CAAC,cAAc;IA4StB,OAAO,CAAC,QAAQ;IAQD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAWjF"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export { USQLEngine } from "./core/engine.js";
+export { normalizeRows } from "./core/compiler.js";
+export { OIDAllocator } from "./pg-compat/oid.js";
+export { InformationSchemaProvider } from "./pg-compat/information-schema.js";
+export { PGCatalogProvider } from "./pg-compat/pg-catalog.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types/net/pgwire/auth.d.ts

@@ -0,0 +1,46 @@
+export declare enum AuthMethod {
+    TRUST = "trust",
+    CLEARTEXT = "password",
+    MD5 = "md5",
+    SCRAM_SHA_256 = "scram-sha-256"
+}
+export declare abstract class Authenticator {
+    protected readonly _username: string;
+    protected readonly _password: string | null;
+    constructor(username: string, password: string | null);
+    /** Produce the first server authentication message. */
+    abstract initial(): [Buffer, boolean];
+    /** Process a client authentication message. */
+    abstract step(data: Buffer): [Buffer, boolean];
+}
+export declare class TrustAuthenticator extends Authenticator {
+    initial(): [Buffer, boolean];
+    step(_data: Buffer): [Buffer, boolean];
+}
+export declare class CleartextAuthenticator extends Authenticator {
+    initial(): [Buffer, boolean];
+    step(data: Buffer): [Buffer, boolean];
+}
+export declare class MD5Authenticator extends Authenticator {
+    private readonly _salt;
+    constructor(username: string, password: string | null);
+    initial(): [Buffer, boolean];
+    step(data: Buffer): [Buffer, boolean];
+}
+export declare class ScramSHA256Authenticator extends Authenticator {
+    private static readonly _ITERATIONS;
+    private _serverNonce;
+    private _combinedNonce;
+    private _salt;
+    private _clientFirstBare;
+    private _serverFirst;
+    private _storedKey;
+    private _serverKey;
+    _phase: number;
+    initial(): [Buffer, boolean];
+    step(data: Buffer): [Buffer, boolean];
+    private _handleClientFirst;
+    private _handleClientFinal;
+}
+export declare function createAuthenticator(method: string, username: string, credentials: Record<string, string> | null): Authenticator;
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/net/pgwire/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/net/pgwire/auth.ts"],"names":[],"mappings":"AA6BA,oBAAY,UAAU;IACpB,KAAK,UAAU;IACf,SAAS,aAAa;IACtB,GAAG,QAAQ;IACX,aAAa,kBAAkB;CAChC;AAMD,8BAAsB,aAAa;IACjC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEhC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrD,uDAAuD;IACvD,QAAQ,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;IAErC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;CAC/C;AAMD,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;CAGvC;AAMD,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;CAiBtC;AAMD,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrD,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;CAiCtC;AAMD,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAE3C,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,UAAU,CAA2B;IAC7C,MAAM,SAAK;IAEX,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAYrC,OAAO,CAAC,kBAAkB;IA8E1B,OAAO,CAAC,kBAAkB;CAoE3B;AA8CD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GACzC,aAAa,CAiBf"}

package/dist/types/net/pgwire/config.d.ts

@@ -0,0 +1,24 @@
+/** Configuration for a PGWireServer instance. */
+export interface PGWireConfig {
+    /** Bind address for the TCP listener. */
+    readonly host: string;
+    /** Bind port. Use 0 for an OS-assigned ephemeral port. */
+    readonly port: number;
+    /** Path passed to USQLEngine for persistent storage. null creates an in-memory engine per connection. */
+    readonly dbPath: string | null;
+    /** Authentication method name: "trust", "password", "md5", or "scram-sha-256". */
+    readonly authMethod: string;
+    /** Mapping of {username: password} for password-based auth. */
+    readonly credentials: Record<string, string> | null;
+    /** Path to an SSL certificate file (PEM). When set together with sslKeyfile, the server accepts SSL connections. */
+    readonly sslCertfile: string | null;
+    /** Path to an SSL private key file (PEM). */
+    readonly sslKeyfile: string | null;
+    /** Maximum number of concurrent client connections. */
+    readonly maxConnections: number;
+    /** Optional callable that returns a USQLEngine instance. When provided, this overrides dbPath. */
+    readonly engineFactory: (() => unknown) | null;
+}
+/** Create a PGWireConfig with defaults for omitted fields. */
+export declare function createConfig(overrides?: Partial<PGWireConfig>): PGWireConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/net/pgwire/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/net/pgwire/config.ts"],"names":[],"mappings":"AAKA,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yGAAyG;IACzG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACpD,oHAAoH;IACpH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kGAAkG;IAClG,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC;CAChD;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAY5E"}

package/dist/types/net/pgwire/connection.d.ts

@@ -0,0 +1,84 @@
+import type * as net from "node:net";
+import * as tls from "node:tls";
+import type { USQLEngine } from "../../core/engine.js";
+export declare class SocketReader {
+    private _socket;
+    private _buffer;
+    private _pendingResolve;
+    private _pendingReject;
+    private _pendingBytes;
+    private _closed;
+    private _error;
+    constructor(socket: net.Socket);
+    /** Replace the underlying socket (e.g. after TLS upgrade). */
+    replaceSocket(socket: net.Socket): void;
+    /** Read exactly n bytes, returning a Promise that resolves when enough data is available. */
+    readExactly(n: number): Promise<Buffer>;
+    private _tryResolve;
+}
+export declare class PGWireConnection {
+    private _reader;
+    private _socket;
+    private readonly _engine;
+    private readonly _executor;
+    private readonly _authMethod;
+    private readonly _credentials;
+    private readonly _processId;
+    private readonly _secretKey;
+    private readonly _cancelCallback;
+    private readonly _secureContext;
+    private _txStatus;
+    private _statements;
+    private _portals;
+    private _sessionParams;
+    private _username;
+    private _database;
+    private _closed;
+    private _canceled;
+    private _backendStart;
+    private _queryStart;
+    private _stateChange;
+    private _currentQuery;
+    private _state;
+    private _clientAddr;
+    private _clientPort;
+    private _applicationName;
+    private _registryInfo;
+    constructor(socket: net.Socket, engine: USQLEngine, options?: {
+        authMethod?: string;
+        credentials?: Record<string, string> | null;
+        processId?: number;
+        secretKey?: number;
+        cancelCallback?: ((processId: number, secretKey: number) => void) | null;
+        secureContext?: tls.SecureContext | null;
+    });
+    get processId(): number;
+    get secretKey(): number;
+    /** Mark this connection's current query as canceled. */
+    cancel(): void;
+    run(): Promise<void>;
+    private _handleStartup;
+    private _authenticate;
+    private _sendStartupParameters;
+    private _mainLoop;
+    private _handleQuery;
+    private _sendQueryResult;
+    private _handleParse;
+    private _handleBind;
+    private _handleDescribe;
+    private _handleExecute;
+    private _handleClose;
+    private _handleSync;
+    private _handleFlush;
+    private _readMessage;
+    private _sendError;
+    private _sendReadyForQuery;
+    private _invalidatePortalsForStatement;
+    private static _applyFormatCodes;
+    /** Await the socket 'drain' event when backpressure occurs. */
+    private _drain;
+    private _close;
+    private _registerWithRegistry;
+    private _updateRegistryState;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/types/net/pgwire/connection.d.ts.map

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