@typesql/postgres 0.2.8 → 0.2.10

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @typesql/postgres
 
+## 0.2.10
+
+### Patch Changes
+
+- Breaking: TypeSQL is split into a dialect-neutral core and a PostgreSQL dialect. `@typesql/core` keeps what dialects share (`createSql`, queries, fragments, executors, row keys, transactions, migrations, the schema markers `Col`, `Nullable`, `Generated`, `View`, … and the type cache) and adds a dialect contract. PostgreSQL moves to `@typesql/core/postgres`: create a `sql` with `createSql<DB>(postgres, executor?)`, import `Json`, `PgCatalog`, `migrations()`, type maps and the function catalog from `@typesql/core/postgres` (which also re-exports the schema markers), and the engine types from `@typesql/core/postgres/engine` (was `@typesql/core/engine`). The Kysely, Drizzle and Prisma packages take the dialect the same way and read the schema from the client's type: `createSql(postgres, db)` (`createSql<DB>(postgres, db)` still picks a schema explicitly). `typesql introspect` and the Prisma generator import the column helpers from `@typesql/core/postgres` by default.
+
+- Updated dependencies:
+  - @typesql/core@0.8.0
+
+## 0.2.9
+
+### Patch Changes
+
+- Validate packages against PostgreSQL behavior and built outputs instead of hand-written test suites.
+
+- Reorganize core internals and remove source comments and inline API documentation without changing SQL behavior.
+
+- Updated dependencies:
+  - @typesql/core@0.7.6
+
 ## 0.2.8
 
 ### Patch Changes

package/README.md

@@ -18,7 +18,6 @@ import type { DB } from "./schema";
 const sql = createSql<DB>(postgres(process.env.DATABASE_URL!));
 
 const posts = await sql("SELECT id, title FROM posts WHERE author_id = $1", 1).execute();
-// { id: string; title: string }[]   (int8 is a string by default)
 
 await sql.transaction(async (tx) => {
   await tx("UPDATE posts SET title = upper(title) WHERE author_id = $1", 1).execute();
@@ -27,7 +26,7 @@ await sql.transaction(async (tx) => {
 
 If your connection parses `int8` to `bigint` (`types: { bigint: postgres.BigInt }`), pass `{ bigint: true }` as the second argument of `createSql`.
 
-[Open an example in the TypeScript Playground](https://www.typescriptlang.org/play/#code/PTAEBUE8AcFMGUCKAZUB3AlgFwBamgPYDOWA5gE6xEB0AVkaABQACWMVAjgDbCEkVUAlNVCIArrHIYqocmIB26bHiLdqCogEMAZrEZZYADywAaUADdNXCUUFnN8gCayCaIgCgQoTZVBs4zgBGkOg4mlj4xGSUNPT4PkRUAFygGPJYABypDJqgJFLypGYE5N6ggRikaRGYuKAAQpUAkunx5ERppKAE8tTu7hgAtoTkEf6woADeoADCBFxmAOKw8pLhsI5mAHJiXFyagVwTAL6g2uQEg6AARKzsqjwAxiWw1wDcA8MlEdOPlOvwbigU7nS43O5wB68KICIjvT4jMbsKagQFcYFnC5Xa58aJUeEDdKSbSaR4TAAi9Sm7gAkGJEu0UpNaTSMI4UstVuR1o4ADzXaoAFmuAD4PjSabBBpoMFwUnMuPyDMZReKaY4MERoPtIAB9eSaQawFI7PYHI5KoxYVUsv6wHm68IclZrAx865YIZULCG6BYABeNppx3FuKITJZbOdXJ5-OqGSDNM0YlwJV1Udm8zj6WFYpZnqwR3lWY9VsTPtI4czitLxgA2gBdIMh9zHfqOWCPfa+Z7yEigRyBFJot6gLy42GMHEwmJJEBcAiPKw4KLATTQaDXQTuXv9h6gAC8oDtAO4vMpIsYg8EHx3PX7YcP3jQMoiD0YtIABvAAKLIH8zOAqSbH42BHGYFYMAAYgASgA8gAspEJAMAA6gAEj+ME-qAAAkACMT4AIJbAAmkwkGCJ+Ji0tcDzXDRwhGJ2KZ6DenhgKAXEAHoAPz9F4cGKLkvarI8no9EodSfuMVbTBUVTpCkE4xNQjSkC0ETHNRqTpFkDjOM8ChYIwABUgjHpcEyBKSADW3gMAp1R9B2XY+BMu4RIO6nDme8mVNUKROa0xx5p55SVE+J4GGi571Je3mVGY-mKVgKRYHIJzseFRnpAwR6aC+2ARaQH40t+f4AUByapuQ6YgblJnmaARHwKAiiwYhyFYAwizwQAqgACg05E1SudVstR7hMYYLEGIw7FeFxoB8QJYAPNQGUOFo4kYJJmp5GogSwIpo5YIYm3cn2pISYoB25Fo5iwIQznuIVr6HVwl3bTde3yIwmhEJA8iPBRhgWQeIrUkmRVjIYZXlUN5JEeAOGPr+QEFkcT5iBukj6GBsAWRhWE4WNaZsk+BFTRKADsNE0jNc1seK4WKAVsN+PDLKfuSlWo6AnVIY+JPYcePgagaXDYJA+iaJWEOgAADDTTOPKxczGQt4pLTx-HHOx7jvhV-6AcBgvwcLURoZhYuQaAzBQ9TZh0dwW6jl4kgXOQ6Xywwjt+JotkyLkypYI27hAA) <!-- playground:postgres --> to hover the types and edit the SQL, with nothing to install.
+[Open an example in the TypeScript Playground](https://www.typescriptlang.org/play/#code/JYWwDg9gTgLgBDAnmApnA3nAwhANgGjgHEUA7FKAQxhQBNCA5AV110oCNc0BfOAMygQQcAEQABJKgDOAR1wB6AMbQU8yFJgBzKCikiA3AChQkWBjiKd1FAGU5cXgKGiJyXXLUQN23QePhoeEk0TDtcB35BYRF1LR09I2NSGig+SkU0ABEAIQxDAEgmKQopAC48-PzgWnKScioaWgAeEWBkgBYRAD4jSpQQSmBccpxcFpoADxhu3vzaYCkwNkQAfVJKEBRy5lYOLnGUKZmC-MsUa1oV6lqyCgvx0F0YDbAYAC9j-O5e2LKKqpqxFuDToLTaMAAHJ98pQmDAABbQFbVEZ4MEdaEwYAwLiosYiSbTHonZ6aP6jA5TADaAF1Pt9DNxDIZaChFGwdBYIKQNHBaOxymEjMoefBZOEALwWKw0MJNHJdAAU-IAlIkRbzfnApZQAO6DMVyRUFAAGNgAogAZc1YAAqcGqhCxOJQTsoZLgADEAEoAeQAsnAtQB1AAS5u95rgABIAIzauAAQQYAE04IrSVIVSb8AUROKRLmVQA6Q5suEoRVq5ms9mUTka+D87LATSCuRNTDsVvg8rdzTghzExtwfsJs7WOUK5XsFuaQhdnvJcowKBMHjVkfKJjJKQJvUG0et435M1Wm322EIpGOrk7mCKgBUKqTNjgpC9fsDWqIfoAqgACnA2RpleiJQMitA5oYJZlooFZVokB7YnA4rFqulA8ukWLcoqlBSIgpCKOmMATC+EpdBUyFBBMJ6noBmSJraUZaha9rOlwCZMGAqBQBm2JcC+YYRlGYE3rQCZxtBlQAOy5vksETOWNCIQUI4fjq+ooaRdEmpk57MZ+AZBl4MB7sJkYWPW8zrLg2KIBm7pZgmAAM0mKcpKA4PeqncNWhjioqZ7WnaDoST6xkhuGlmZnAYiUVJhD5nIIjVkAA) <span data-playground="postgres"></span> to hover the types and edit the SQL, with nothing to install.
 
 ## Documentation
 

package/dist/client.d.ts

@@ -1,41 +1,21 @@
 import type { Executor } from "@typesql/core";
 import type { SqlDriver } from "@typesql/core/adapter";
-/**
- * The shape of a resolved `sql.unsafe()` result the adapter relies on: an array with `count`
- * (`null` for statements without a count, such as DDL).
- */
 export type PostgresJsRows = readonly unknown[] & {
     readonly count: number | null;
 };
-/**
- * Anything with postgres.js' `unsafe(query, parameters)` method: the `Sql` instance,
- * a `TransactionSql` inside `begin`, a `ReservedSql`, or a fake in tests.
- */
 export interface PostgresJsQueryable {
     unsafe(query: string, parameters?: unknown[], options?: {
         readonly prepare: boolean;
         readonly simple: boolean;
     }): PromiseLike<PostgresJsRows>;
 }
-/** Anything with postgres.js' `begin(fn)`: the `Sql` instance or a `ReservedSql`. */
 export interface PostgresJsTransactable<Tx extends PostgresJsQueryable = PostgresJsQueryable> {
     begin(fn: (tx: Tx) => Promise<unknown>): Promise<unknown>;
 }
-/**
- * An `Executor` for core's `q.execute()`: runs queries through `sql.unsafe` and resolves to
- * `{ rows, rowCount }` (postgres.js' `.count`, so `q.executeCount()` works).
- */
 export declare function executor(sql: PostgresJsQueryable): Executor;
-/** How `createSql(sql)` runs queries and transactions. */
 export declare const driver: SqlDriver<PostgresJsQueryable>;
-/** Anything carrying an ordered list of DDL statements, e.g. a `migrations()` builder from core. */
 export interface MigrationSource {
     readonly statements: readonly string[];
 }
-/**
- * Run a migration's statements in order inside one transaction (`sql.begin`), all or nothing.
- * Each statement goes through `unsafe` without parameters (simple protocol), so scripts with
- * `$$`-quoted function bodies work.
- */
 export declare function migrate<Tx extends PostgresJsQueryable>(sql: PostgresJsTransactable<Tx>, m: MigrationSource): Promise<void>;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,OAAO,EAAE,GAAG;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,CACL,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAC/D,WAAW,CAAC,cAAc,CAAC,CAAC;CAC/B;AAED,qFAAqF;AACrF,MAAM,WAAW,sBAAsB,CACtC,EAAE,SAAS,mBAAmB,GAAG,mBAAmB;IAEpD,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AASD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,QAAQ,CAc3D;AAsBD,0DAA0D;AAC1D,eAAO,MAAM,MAAM,EAAE,SAAS,CAAC,mBAAmB,CAA6B,CAAC;AAEhF,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAC3D,GAAG,EAAE,sBAAsB,CAAC,EAAE,CAAC,EAC/B,CAAC,EAAE,eAAe,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,SAAS,OAAO,EAAE,GAAG;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IACnC,MAAM,CACL,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAC/D,WAAW,CAAC,cAAc,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB,CACtC,EAAE,SAAS,mBAAmB,GAAG,mBAAmB;IAEpD,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAQD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,QAAQ,CAc3D;AAiBD,eAAO,MAAM,MAAM,EAAE,SAAS,CAAC,mBAAmB,CAA6B,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,wBAAsB,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAC3D,GAAG,EAAE,sBAAsB,CAAC,EAAE,CAAC,EAC/B,CAAC,EAAE,eAAe,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/client.js

@@ -1,7 +1,3 @@
-/**
- * An `Executor` for core's `q.execute()`: runs queries through `sql.unsafe` and resolves to
- * `{ rows, rowCount }` (postgres.js' `.count`, so `q.executeCount()` works).
- */
 export function executor(sql) {
     const run = async (text, values) => {
         const result = await sql.unsafe(text, Array.from(values));
@@ -17,11 +13,6 @@ export function executor(sql) {
         },
     });
 }
-/**
- * Run `fn` inside a transaction: `tx.savepoint(fn)` on a `TransactionSql` (only those have it),
- * otherwise `sql.begin(fn)`. postgres.js issues BEGIN (or SAVEPOINT), runs the callback with a
- * transaction-bound `sql`, then COMMIT, or ROLLBACK and rethrow when the callback throws.
- */
 async function transaction(sql, _depth, fn) {
     const { savepoint, begin } = sql;
     if (savepoint)
@@ -30,13 +21,7 @@ async function transaction(sql, _depth, fn) {
         return (await begin.call(sql, fn));
     throw new Error("typesql: sql.transaction() needs a postgres.js Sql, ReservedSql or TransactionSql (with begin or savepoint)");
 }
-/** How `createSql(sql)` runs queries and transactions. */
 export const driver = { executor, transaction };
-/**
- * Run a migration's statements in order inside one transaction (`sql.begin`), all or nothing.
- * Each statement goes through `unsafe` without parameters (simple protocol), so scripts with
- * `$$`-quoted function bodies work.
- */
 export async function migrate(sql, m) {
     await sql.begin(async (tx) => {
         for (const statement of m.statements)

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAqCA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAwB;IAChD,MAAM,GAAG,GAAa,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;IACrE,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QACzB,OAAO,EAAE,GAAa,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;gBACzD,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,KAAK;aACb,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;QACrE,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,WAAW,CACzB,GAAwB,EACxB,MAAc,EACd,EAA2C;IAE3C,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAE5B,CAAC;IACF,IAAI,SAAS;QAAE,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAM,CAAC;IAC3D,IAAI,KAAK;QAAE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAM,CAAC;IACnD,MAAM,IAAI,KAAK,CACd,6GAA6G,CAC7G,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,MAAM,GAAmC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAOhF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,GAA+B,EAC/B,CAAkB;IAElB,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAC5B,KAAK,MAAM,SAAS,IAAI,CAAC,CAAC,UAAU;YAAE,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,QAAQ,CAAC,GAAwB;IAChD,MAAM,GAAG,GAAa,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;IACrE,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QACzB,OAAO,EAAE,GAAa,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;gBACzD,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,KAAK;aACb,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;QACrE,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CACzB,GAAwB,EACxB,MAAc,EACd,EAA2C;IAE3C,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAE5B,CAAC;IACF,IAAI,SAAS;QAAE,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAM,CAAC;IAC3D,IAAI,KAAK;QAAE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAM,CAAC;IACnD,MAAM,IAAI,KAAK,CACd,6GAA6G,CAC7G,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAmC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAMhF,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,GAA+B,EAC/B,CAAkB;IAElB,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAC5B,KAAK,MAAM,SAAS,IAAI,CAAC,CAAC,UAAU;YAAE,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,18 +1,10 @@
-import type { RowKeys, TransactionalSql } from "@typesql/core";
+import type { RowKeys } from "@typesql/core";
+import { type TransactionalSql } from "@typesql/core/postgres";
 import { type PostgresJsQueryable } from "./client.js";
 import type { PostgresJsBigIntTypeMap, PostgresJsTypeMap } from "./type-map.js";
 export { executor, type MigrationSource, migrate, type PostgresJsQueryable, type PostgresJsRows, type PostgresJsTransactable, } from "./client.js";
 export type { PostgresJsBigIntTypeMap, PostgresJsParamTypeMap, PostgresJsTypeMap, } from "./type-map.js";
-/** What `createSql<DB>(sql)` returns: core's `Sql` under `PostgresJsTypeMap` (or `TM`), with `transaction(fn)`. */
 export type PostgresJsSql<DB, Keys extends RowKeys = "preserve", TM = PostgresJsTypeMap> = TransactionalSql<DB, TM, Keys>;
-/**
- * `createSql<DB>()` from core, pre-bound to `PostgresJsTypeMap` (default parsers: `int8` and `count(*)` are `string`).
- * The queries' `execute*` methods run on the postgres.js `sql` instance (or a `TransactionSql`,
- * `ReservedSql`), and `sql.transaction(fn)` runs `fn` with a `sql` bound to one transaction.
- * `{ rowKeys: "camelCase" }` camelCases the rows' keys, in the types and at runtime.
- * `{ bigint: true }` is for `postgres({ types: { bigint: postgres.BigInt } })` connections:
- * `int8` and `count(*)` are `bigint` (`PostgresJsBigIntTypeMap`).
- */
 export declare function createSql<DB>(sql: PostgresJsQueryable | undefined, options: {
     readonly rowKeys: "camelCase";
     readonly bigint: true;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAc,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAU,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EACN,QAAQ,EACR,KAAK,eAAe,EACpB,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,eAAe,CAAC;AAEvB,mHAAmH;AACnH,MAAM,MAAM,aAAa,CACxB,EAAE,EACF,IAAI,SAAS,OAAO,GAAG,UAAU,EACjC,EAAE,GAAG,iBAAiB,IACnB,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AAOnC;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,EAAE,mBAAmB,GAAG,SAAS,EACpC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GAC/D,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,uBAAuB,CAAC,CAAC;AAC3D,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,EAAE,mBAAmB,GAAG,SAAS,EACpC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GAC/D,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC;AAC1D,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,EAAE,mBAAmB,GAAG,SAAS,EACpC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GACjE,aAAa,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;AAClC,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,CAAC,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAClE,aAAa,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,eAAe,CAAC;AAEzD,OAAO,EAGN,KAAK,gBAAgB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAU,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EACN,QAAQ,EACR,KAAK,eAAe,EACpB,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,aAAa,CACxB,EAAE,EACF,IAAI,SAAS,OAAO,GAAG,UAAU,EACjC,EAAE,GAAG,iBAAiB,IACnB,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AAMnC,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,EAAE,mBAAmB,GAAG,SAAS,EACpC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GAC/D,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,uBAAuB,CAAC,CAAC;AAC3D,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,EAAE,mBAAmB,GAAG,SAAS,EACpC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GAC/D,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC;AAC1D,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,EAAE,mBAAmB,GAAG,SAAS,EACpC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GACjE,aAAa,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;AAClC,wBAAgB,SAAS,CAAC,EAAE,EAC3B,GAAG,CAAC,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAClE,aAAa,CAAC,EAAE,CAAC,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
 import { createTransactionalSql } from "@typesql/core/adapter";
+import { postgres, } from "@typesql/core/postgres";
 import { driver } from "./client.js";
 export { executor, migrate, } from "./client.js";
 export function createSql(sql, options) {
-    return createTransactionalSql(sql, driver, options);
+    return createTransactionalSql(postgres, sql, driver, options);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAA4B,MAAM,aAAa,CAAC;AAG/D,OAAO,EACN,QAAQ,EAER,OAAO,GAIP,MAAM,aAAa,CAAC;AA2CrB,MAAM,UAAU,SAAS,CACxB,GAAyB,EACzB,OAA8B;IAE9B,OAAO,sBAAsB,CAC5B,GAAG,EACH,MAAM,EACN,OAAO,CACP,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAEN,QAAQ,GAER,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAA4B,MAAM,aAAa,CAAC;AAG/D,OAAO,EACN,QAAQ,EAER,OAAO,GAIP,MAAM,aAAa,CAAC;AAiCrB,MAAM,UAAU,SAAS,CACxB,GAAyB,EACzB,OAA8B;IAE9B,OAAO,sBAAsB,CAK3B,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/type-map.d.ts

@@ -1,66 +1,18 @@
-import type { DefaultParamTypeMap, DefaultTypeMap } from "@typesql/core";
-/**
- * Canonical Postgres type name → TS type as postgres.js 3.x returns it with its default
- * parsers. Verified against `postgres/src/types.js` (3.4.9), which parses only:
- *
- *   number   int2 (21), int4 (23), oid (26), float4 (700), float8 (701)
- *   boolean  bool (16)
- *   Date     date (1082), timestamp (1114), timestamptz (1184) — all three via `new Date(x)`
- *   unknown  json (114), jsonb (3802): `JSON.parse`d
- *   Buffer   bytea (17)
- *
- * Everything else — including int8 (20) and numeric (1700) — is left as the text Postgres
- * sent, so it is `string`. Unlike `pg`, postgres.js has no parsers for interval, point and
- * circle, so those are strings here.
- *
- * This settles PLAN.md open question 3: postgres.js does return `Date` for `date` (and for
- * `timestamp`), the same as `pg`. Note that `date` has no time zone, and `new Date("2024-01-02")`
- * is parsed as UTC midnight (pg's `postgres-date` yields local midnight instead).
- *
- * Arrays: postgres.js fetches `pg_type` on connect (`fetch_types: true`, the default) and
- * registers an element-wise array parser for every array type, so core's `T[]` →
- * element-type[] mapping is exact (int8[] → string[], timestamptz[] → Date[], ...).
- */
+import type { DefaultParamTypeMap, DefaultTypeMap } from "@typesql/core/postgres";
 export interface PostgresJsTypeMap extends Omit<DefaultTypeMap, "bytea" | "interval" | "point" | "circle" | "record" | "void"> {
-    /** What parameters accept on top of the row types. */
     $params: PostgresJsParamTypeMap;
     bytea: Buffer;
-    /** No default parser: the Postgres text form, e.g. `"1 day 02:00:00"`. */
     interval: string;
-    /** No default parser: `"(1,2)"`. */
     point: string;
-    /** No default parser: `"<(1,2),3>"`. */
     circle: string;
-    /** Anonymous `ROW(...)` results: raw text such as `"(1,foo)"`. */
     record: string;
-    /** `void`-returning functions (`pg_sleep`) yield an empty string. */
     void: string;
 }
-/**
- * TS types postgres.js parameters accept on top of the row type
- * (`PostgresJsTypeMap["$params"]`). Verified against `postgres/src/types.js` and `Bind` in
- * `connection.js` (3.4.9): a value is serialized by the serializer of the parameter type the
- * server reports, and types without one (int8, numeric, money, interval, …) with `'' + x`.
- *
- *   int8, numeric, money          number | bigint | string
- *   date, timestamp, timestamptz  Date | string | number: serialized as `new Date(x).toISOString()`,
- *                                 so a string must be one JS `Date` parses, a number is epoch ms
- *   interval                      string
- *   bytea                         Uint8Array, besides `Buffer`
- *
- * `bool` takes only booleans: its serializer sends `'f'` for anything but `true`.
- */
 export interface PostgresJsParamTypeMap extends Omit<DefaultParamTypeMap, "date" | "timestamp" | "timestamptz"> {
     date: Date | string | number;
     timestamp: Date | string | number;
     timestamptz: Date | string | number;
 }
-/**
- * Type map for connections created with `postgres({ types: { bigint: postgres.BigInt } })`,
- * which registers a parser for int8 (20) that returns JS `bigint`. `count(*)`, `sum(int4)`
- * and `int8` columns become `bigint`; `int8[]` becomes `bigint[]`. Everything else is as in
- * `PostgresJsTypeMap`.
- */
 export interface PostgresJsBigIntTypeMap extends Omit<PostgresJsTypeMap, "int8"> {
     int8: bigint;
 }

package/dist/type-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-map.d.ts","sourceRoot":"","sources":["../src/type-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,iBAChB,SAAQ,IAAI,CACX,cAAc,EACd,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAC7D;IACD,sDAAsD;IACtD,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,sBAChB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC;IACvE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,WAAW,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAChB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"type-map.d.ts","sourceRoot":"","sources":["../src/type-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EACnB,cAAc,EACd,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,iBAChB,SAAQ,IAAI,CACX,cAAc,EACd,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAC7D;IACD,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAChB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC;IACvE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,WAAW,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,uBAChB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;CACb"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typesql/postgres",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "postgres.js adapter for TypeSQL.",
   "license": "MIT",
   "repository": {
@@ -28,7 +28,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@typesql/core": "0.7.5"
+    "@typesql/core": "0.8.0"
   },
   "peerDependencies": {
     "postgres": ">=3"
@@ -36,8 +36,7 @@
   "devDependencies": {
     "postgres": "^3.4.9",
     "tsrs": "0.18.0-ts7.1.0-dev.20260929",
-    "typescript": "7.1.0-beta",
-    "vitest": "^5.0.4"
+    "typescript": "7.1.0-beta"
   },
   "homepage": "https://typesql.karsli.net/adapters/postgres",
   "bugs": {
@@ -58,7 +57,6 @@
   ],
   "scripts": {
     "build": "tsrs -p tsconfig.build.json",
-    "typecheck": "tsrs -p tsconfig.json --noEmit",
-    "test": "vitest run"
+    "typecheck": "tsrs -p tsconfig.json --noEmit"
   }
 }

package/src/client.ts

@@ -1,18 +1,10 @@
 import type { Executor } from "@typesql/core";
 import type { SqlDriver } from "@typesql/core/adapter";
 
-/**
- * The shape of a resolved `sql.unsafe()` result the adapter relies on: an array with `count`
- * (`null` for statements without a count, such as DDL).
- */
 export type PostgresJsRows = readonly unknown[] & {
 	readonly count: number | null;
 };
 
-/**
- * Anything with postgres.js' `unsafe(query, parameters)` method: the `Sql` instance,
- * a `TransactionSql` inside `begin`, a `ReservedSql`, or a fake in tests.
- */
 export interface PostgresJsQueryable {
 	unsafe(
 		query: string,
@@ -21,24 +13,18 @@ export interface PostgresJsQueryable {
 	): PromiseLike<PostgresJsRows>;
 }
 
-/** Anything with postgres.js' `begin(fn)`: the `Sql` instance or a `ReservedSql`. */
 export interface PostgresJsTransactable<
 	Tx extends PostgresJsQueryable = PostgresJsQueryable,
 > {
 	begin(fn: (tx: Tx) => Promise<unknown>): Promise<unknown>;
 }
 
-/** A `TransactionSql`'s `savepoint(fn)`. */
 interface PostgresJsSavepointable {
 	savepoint(
 		fn: (tx: PostgresJsQueryable) => Promise<unknown>,
 	): Promise<unknown>;
 }
 
-/**
- * An `Executor` for core's `q.execute()`: runs queries through `sql.unsafe` and resolves to
- * `{ rows, rowCount }` (postgres.js' `.count`, so `q.executeCount()` works).
- */
 export function executor(sql: PostgresJsQueryable): Executor {
 	const run: Executor = async (text, values) => {
 		const result = await sql.unsafe(text, Array.from(values));
@@ -55,11 +41,6 @@ export function executor(sql: PostgresJsQueryable): Executor {
 	});
 }
 
-/**
- * Run `fn` inside a transaction: `tx.savepoint(fn)` on a `TransactionSql` (only those have it),
- * otherwise `sql.begin(fn)`. postgres.js issues BEGIN (or SAVEPOINT), runs the callback with a
- * transaction-bound `sql`, then COMMIT, or ROLLBACK and rethrow when the callback throws.
- */
 async function transaction<T>(
 	sql: PostgresJsQueryable,
 	_depth: number,
@@ -75,19 +56,12 @@ async function transaction<T>(
 	);
 }
 
-/** How `createSql(sql)` runs queries and transactions. */
 export const driver: SqlDriver<PostgresJsQueryable> = { executor, transaction };
 
-/** Anything carrying an ordered list of DDL statements, e.g. a `migrations()` builder from core. */
 export interface MigrationSource {
 	readonly statements: readonly string[];
 }
 
-/**
- * Run a migration's statements in order inside one transaction (`sql.begin`), all or nothing.
- * Each statement goes through `unsafe` without parameters (simple protocol), so scripts with
- * `$$`-quoted function bodies work.
- */
 export async function migrate<Tx extends PostgresJsQueryable>(
 	sql: PostgresJsTransactable<Tx>,
 	m: MigrationSource,

package/src/index.ts

@@ -1,5 +1,10 @@
-import type { RowKeys, SqlOptions, TransactionalSql } from "@typesql/core";
+import type { RowKeys, SqlOptions } from "@typesql/core";
 import { createTransactionalSql } from "@typesql/core/adapter";
+import {
+	type Postgres,
+	postgres,
+	type TransactionalSql,
+} from "@typesql/core/postgres";
 import { driver, type PostgresJsQueryable } from "./client.js";
 import type { PostgresJsBigIntTypeMap, PostgresJsTypeMap } from "./type-map.js";
 
@@ -17,26 +22,16 @@ export type {
 	PostgresJsTypeMap,
 } from "./type-map.js";
 
-/** What `createSql<DB>(sql)` returns: core's `Sql` under `PostgresJsTypeMap` (or `TM`), with `transaction(fn)`. */
 export type PostgresJsSql<
 	DB,
 	Keys extends RowKeys = "preserve",
 	TM = PostgresJsTypeMap,
 > = TransactionalSql<DB, TM, Keys>;
 
-/** `createSql`'s options: core's `rowKeys`, and `bigint: true` for a connection that parses `int8` as `bigint`. */
 interface PostgresJsSqlOptions extends SqlOptions {
 	readonly bigint?: boolean;
 }
 
-/**
- * `createSql<DB>()` from core, pre-bound to `PostgresJsTypeMap` (default parsers: `int8` and `count(*)` are `string`).
- * The queries' `execute*` methods run on the postgres.js `sql` instance (or a `TransactionSql`,
- * `ReservedSql`), and `sql.transaction(fn)` runs `fn` with a `sql` bound to one transaction.
- * `{ rowKeys: "camelCase" }` camelCases the rows' keys, in the types and at runtime.
- * `{ bigint: true }` is for `postgres({ types: { bigint: postgres.BigInt } })` connections:
- * `int8` and `count(*)` are `bigint` (`PostgresJsBigIntTypeMap`).
- */
 export function createSql<DB>(
 	sql: PostgresJsQueryable | undefined,
 	options: { readonly rowKeys: "camelCase"; readonly bigint: true },
@@ -57,9 +52,10 @@ export function createSql<DB>(
 	sql?: PostgresJsQueryable,
 	options?: PostgresJsSqlOptions,
 ): PostgresJsSql<DB, RowKeys, PostgresJsTypeMap | PostgresJsBigIntTypeMap> {
-	return createTransactionalSql<DB, PostgresJsTypeMap, PostgresJsQueryable>(
-		sql,
-		driver,
-		options,
-	);
+	return createTransactionalSql<
+		Postgres,
+		DB,
+		PostgresJsTypeMap,
+		PostgresJsQueryable
+	>(postgres, sql, driver, options);
 }

package/src/type-map.ts

@@ -1,61 +1,22 @@
-import type { DefaultParamTypeMap, DefaultTypeMap } from "@typesql/core";
+import type {
+	DefaultParamTypeMap,
+	DefaultTypeMap,
+} from "@typesql/core/postgres";
 
-/**
- * Canonical Postgres type name → TS type as postgres.js 3.x returns it with its default
- * parsers. Verified against `postgres/src/types.js` (3.4.9), which parses only:
- *
- *   number   int2 (21), int4 (23), oid (26), float4 (700), float8 (701)
- *   boolean  bool (16)
- *   Date     date (1082), timestamp (1114), timestamptz (1184) — all three via `new Date(x)`
- *   unknown  json (114), jsonb (3802): `JSON.parse`d
- *   Buffer   bytea (17)
- *
- * Everything else — including int8 (20) and numeric (1700) — is left as the text Postgres
- * sent, so it is `string`. Unlike `pg`, postgres.js has no parsers for interval, point and
- * circle, so those are strings here.
- *
- * This settles PLAN.md open question 3: postgres.js does return `Date` for `date` (and for
- * `timestamp`), the same as `pg`. Note that `date` has no time zone, and `new Date("2024-01-02")`
- * is parsed as UTC midnight (pg's `postgres-date` yields local midnight instead).
- *
- * Arrays: postgres.js fetches `pg_type` on connect (`fetch_types: true`, the default) and
- * registers an element-wise array parser for every array type, so core's `T[]` →
- * element-type[] mapping is exact (int8[] → string[], timestamptz[] → Date[], ...).
- */
 export interface PostgresJsTypeMap
 	extends Omit<
 		DefaultTypeMap,
 		"bytea" | "interval" | "point" | "circle" | "record" | "void"
 	> {
-	/** What parameters accept on top of the row types. */
 	$params: PostgresJsParamTypeMap;
 	bytea: Buffer;
-	/** No default parser: the Postgres text form, e.g. `"1 day 02:00:00"`. */
 	interval: string;
-	/** No default parser: `"(1,2)"`. */
 	point: string;
-	/** No default parser: `"<(1,2),3>"`. */
 	circle: string;
-	/** Anonymous `ROW(...)` results: raw text such as `"(1,foo)"`. */
 	record: string;
-	/** `void`-returning functions (`pg_sleep`) yield an empty string. */
 	void: string;
 }
 
-/**
- * TS types postgres.js parameters accept on top of the row type
- * (`PostgresJsTypeMap["$params"]`). Verified against `postgres/src/types.js` and `Bind` in
- * `connection.js` (3.4.9): a value is serialized by the serializer of the parameter type the
- * server reports, and types without one (int8, numeric, money, interval, …) with `'' + x`.
- *
- *   int8, numeric, money          number | bigint | string
- *   date, timestamp, timestamptz  Date | string | number: serialized as `new Date(x).toISOString()`,
- *                                 so a string must be one JS `Date` parses, a number is epoch ms
- *   interval                      string
- *   bytea                         Uint8Array, besides `Buffer`
- *
- * `bool` takes only booleans: its serializer sends `'f'` for anything but `true`.
- */
 export interface PostgresJsParamTypeMap
 	extends Omit<DefaultParamTypeMap, "date" | "timestamp" | "timestamptz"> {
 	date: Date | string | number;
@@ -63,12 +24,6 @@ export interface PostgresJsParamTypeMap
 	timestamptz: Date | string | number;
 }
 
-/**
- * Type map for connections created with `postgres({ types: { bigint: postgres.BigInt } })`,
- * which registers a parser for int8 (20) that returns JS `bigint`. `count(*)`, `sum(int4)`
- * and `int8` columns become `bigint`; `int8[]` becomes `bigint[]`. Everything else is as in
- * `PostgresJsTypeMap`.
- */
 export interface PostgresJsBigIntTypeMap
 	extends Omit<PostgresJsTypeMap, "int8"> {
 	int8: bigint;