okmodel 0.7.0 → 0.9.0

package/dist/runtime/pg/neon.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `connect` for Neon (`okmodel/pg/neon`).
+ *
+ * A string or an existing pool is one endpoint. A `{ primary, replicas }` object
+ * loads the topology module. The client is typed by the schema passed in.
+ * `mode` is `websocket` (the default) or `http`.
+ */
+import type { DriverPool } from "../../contracts/driver.js";
+import type { QuerySchema } from "../../dialects/pg/model.js";
+import { type NeonConfig } from "../../adapters/pg/neon.js";
+import type { RoutedClient, TopologyInput, TopologyOptions } from "../topology.js";
+import type { ConnectOptions, Connected } from "../types.js";
+export { open, type NeonConfig, type NeonMode } from "../../adapters/pg/neon.js";
+export { capabilities, hasCapability, httpCapabilities, readCapability, } from "../../adapters/pg/neon.js";
+export { DriverError } from "../../adapters/error.js";
+/** A connection string or a pool from {@link open}. */
+export type NeonTarget = string | DriverPool;
+/** Driver options `connect` forwards to {@link open}. */
+export type NeonConnectOptions<S extends QuerySchema> = ConnectOptions<S> & Omit<NeonConfig, "url"> & TopologyOptions;
+/**
+ * Connects one Neon endpoint, or a primary and its replicas.
+ *
+ * A string or a pool is one endpoint. A topology loads on demand and the promise
+ * resolves to the client. Reads use the first healthy replica.
+ *
+ * `mode: "websocket"` is the default. Interactive `tx()` needs it. `mode: "http"`
+ * is one-shot HTTP: `batch()` is atomic and `tx()` is refused.
+ *
+ * Named prepared statements are off unless `prepared` is `"named"`.
+ * `prepared: "named"` is not for transaction-mode poolers.
+ *
+ * @typeParam S - Schema
+ * @param target - URL, an existing pool, or `{ primary, replicas }`
+ * @param options - Schema, mode, errors, logger, and driver options
+ * @returns The client. A topology returns a promise. Await `connected` for the dialect check
+ */
+export declare function connect<const S extends QuerySchema>(target: TopologyInput, options: NeonConnectOptions<S>): Promise<RoutedClient<S>>;
+export declare function connect<const S extends QuerySchema>(target: NeonTarget, options: NeonConnectOptions<S>): Promise<Connected<S>>;

package/dist/runtime/pg/neon.js

@@ -0,0 +1,64 @@
+import {
+  DriverError2
+} from "../../shared/cm3w0ywp.js";
+import {
+  open6
+} from "../../shared/mazpbcdj.js";
+import {
+  NEON_WEBSOCKET_CAPABILITIES,
+  NEON_HTTP_CAPABILITIES,
+  readCapability2,
+  hasCapability2
+} from "../../shared/mfvx6kjx.js";
+import {
+  createClient
+} from "../../shared/npdftanb.js";
+
+// src/runtime/pg/neon.ts
+function connect(target, options) {
+  if (typeof target === "object" && !isPool(target)) {
+    return import("../../shared/71n0jmhc.js").then((mod) => mod.default(target, options, (config) => open6({
+      url: config.url,
+      ...options.mode !== undefined ? { mode: options.mode } : {},
+      ...config.max !== undefined ? { max: config.max } : {},
+      ...config.timeouts !== undefined ? { timeouts: config.timeouts } : {},
+      ...config.prepared !== undefined ? { prepared: config.prepared } : {},
+      ...config.searchPath !== undefined ? { searchPath: config.searchPath } : {}
+    })));
+  }
+  const owned = !isPool(target);
+  const opened = isPool(target) ? Promise.resolve(target) : open6({
+    url: target,
+    ...options.mode !== undefined ? { mode: options.mode } : {},
+    ...options.max !== undefined ? { max: options.max } : {},
+    ...options.timeouts !== undefined ? { timeouts: options.timeouts } : {},
+    ...options.prepared !== undefined ? { prepared: options.prepared } : {},
+    ...options.searchPath !== undefined ? { searchPath: options.searchPath } : {}
+  });
+  return opened.then((pool) => createClient(options.schema, pool, {
+    ownsPool: owned,
+    http: options.errors?.http,
+    includeValues: options.errors?.includeValues,
+    logger: options.logger,
+    signal: options.signal,
+    timeout: options.timeout,
+    timeouts: options.timeouts,
+    hookm: options.hookm,
+    catalog: options.catalog,
+    catalogDir: options.catalogDir,
+    requireMeta: options.requireMeta,
+    generators: options.generators
+  }));
+}
+function isPool(target) {
+  return typeof target === "object" && "execute" in target && "capabilities" in target;
+}
+export {
+  DriverError2 as DriverError,
+  NEON_WEBSOCKET_CAPABILITIES as capabilities,
+  connect,
+  hasCapability2 as hasCapability,
+  NEON_HTTP_CAPABILITIES as httpCapabilities,
+  open6 as open,
+  readCapability2 as readCapability
+};

package/dist/runtime/pg/pg.js

@@ -3,20 +3,20 @@ import {
 } from "../../shared/cm3w0ywp.js";
 import {
   open4
-} from "../../shared/w79hsckn.js";
+} from "../../shared/1mxm04fy.js";
 import {
   NODE_POSTGRES_CAPABILITIES,
   readCapability2,
   hasCapability2
-} from "../../shared/kb2sdhfb.js";
+} from "../../shared/mfvx6kjx.js";
 import {
   createClient
-} from "../../shared/tbrvgw6z.js";
+} from "../../shared/npdftanb.js";
 
 // src/runtime/pg/pg.ts
 function connect(target, options) {
   if (typeof target === "object" && !isPool(target)) {
-    return import("../../shared/mtaszv5a.js").then((mod) => mod.default(target, options, open4));
+    return import("../../shared/71n0jmhc.js").then((mod) => mod.default(target, options, open4));
   }
   const owned = !isPool(target);
   const pool = isPool(target) ? target : open4({

package/dist/runtime/pg/pglite.js

@@ -4,20 +4,20 @@ import {
 import {
   open3,
   seal2
-} from "../../shared/81ebdx9p.js";
+} from "../../shared/0j6qe91y.js";
 import {
   PGLITE_CAPABILITIES,
   readCapability2,
   hasCapability2
-} from "../../shared/kb2sdhfb.js";
+} from "../../shared/mfvx6kjx.js";
 import {
   createClient
-} from "../../shared/tbrvgw6z.js";
+} from "../../shared/npdftanb.js";
 
 // src/runtime/pg/pglite.ts
 async function connect(target, options) {
   if (typeof target === "object" && !isPool(target)) {
-    return import("../../shared/mtaszv5a.js").then((mod) => mod.default(target, options, open3));
+    return import("../../shared/71n0jmhc.js").then((mod) => mod.default(target, options, open3));
   }
   const pool = isPool(target) ? seal2(target) : await open3({
     ...target !== undefined ? { dataDir: target } : {},

package/dist/runtime/pg/postgresjs.js

@@ -3,20 +3,20 @@ import {
 } from "../../shared/cm3w0ywp.js";
 import {
   open2
-} from "../../shared/14vx95q4.js";
+} from "../../shared/dd5pmnky.js";
 import {
   POSTGRESJS_CAPABILITIES,
   readCapability2,
   hasCapability2
-} from "../../shared/kb2sdhfb.js";
+} from "../../shared/mfvx6kjx.js";
 import {
   createClient
-} from "../../shared/tbrvgw6z.js";
+} from "../../shared/npdftanb.js";
 
 // src/runtime/pg/postgresjs.ts
 function connect(target, options) {
   if (typeof target === "object" && !isPool(target)) {
-    return import("../../shared/mtaszv5a.js").then((mod) => mod.default(target, options, open2));
+    return import("../../shared/71n0jmhc.js").then((mod) => mod.default(target, options, open2));
   }
   const owned = !isPool(target);
   const pool = isPool(target) ? target : open2({

package/dist/runtime/plan.d.ts

@@ -195,7 +195,7 @@ export declare function readOptionNames(op: ReadOp): readonly string[];
  * `order` is set when the operator is an `orderBy` value. `relevance` writes
  * its direction there; the same operator in `where` is refused by that module.
  */
-type OperatorEmit = (column: ColumnModel, ref: string, name: OperatorName, value: unknown, sink: Sink, order?: true) => void;
+type OperatorEmit = (table: Indexed, column: ColumnModel, ref: string, name: OperatorName, value: unknown, sink: Sink, order?: true) => void;
 /**
  * Installs the 0.2 operator compiler.
  *

package/dist/runtime/server-check.d.ts

@@ -15,20 +15,50 @@ import type { CatalogArtifact } from "./types.js";
  */
 export declare const versionQuery = "select current_setting('server_version_num'), version(), (select (xpath('//catalog_hash/text()', query_to_xml('select catalog_hash from okm_meta where id = ''head''', true, false, '')))[1]::text where to_regclass('okm_meta') is not null)";
 /**
- * Accepts the `server_version_num` row, or throws OKM1801, OKM1520, OKM1802, or OKM1803.
+ * Startup query for the namespace `okm build` recorded.
  *
- * A declared floor is the minimum. With no floor, the minimum is 15.
- * A major below 15 is refused when the schema is built.
+ * `public` returns {@link versionQuery}, the same string as before.
+ * Another namespace qualifies `okm_meta`. `to_regclass` still lets a
+ * database with no such table plan.
  *
- * @param pool - Connection that ran the version query
+ * @param namespace - Catalog schema. `public` is unqualified
+ * @returns The version, dialect, and hash query
+ */
+export declare function versionSql(namespace: string): Promise<string>;
+/**
+ * History query used when the catalog hashes differ.
+ *
+ * `public` stays unqualified, so a search path still finds that table.
+ *
+ * @param namespace - Catalog schema. `public` is unqualified
+ * @returns The `okm_history` select
+ */
+export declare function historySql(namespace: string): Promise<string>;
+/**
+ * Namespace stored beside the catalog hash.
+ *
+ * A missing file means `public`. `okm build` writes the file only when
+ * `defineConfig({ namespace })` is not `public`.
+ *
+ * @param catalogDir - Directory `connect` was given, or the default `.okm`
+ * @returns The schema name
+ */
+export declare function recordedNamespace(catalogDir: string | undefined): Promise<string>;
+/**
+ * Accepts the server row, or throws OKM1801, OKM1520, OKM1802, or OKM1803.
+ *
+ * The first statement reads `okm_meta` in the catalog namespace. A declared
+ * floor is the minimum. With no floor, the minimum is 15. A major below 15
+ * is refused when the schema is built.
+ *
+ * @param pool - Connection that runs the version query
  * @param schema - Schema whose floor is the declared minimum
- * @param rows - `server_version_num`, `version()`, and the `okm_meta` hash
  * @param http - Status overrides from `connect`
  * @param requireMeta - When true, a missing hash is OKM1520
  * @param options - Signal and timeout for the compatibility read
  * @param source - Trusted catalog used when the hash does not match
  */
-export declare function acceptServer(pool: DriverPool, schema: QuerySchema, rows: readonly (readonly (string | null)[])[], http: ErrorStatuses | undefined, requireMeta: boolean, options: ExecuteOptions | undefined, source: {
+export declare function acceptServer(pool: DriverPool, schema: QuerySchema, http: ErrorStatuses | undefined, requireMeta: boolean, options: ExecuteOptions | undefined, source: {
     readonly catalog?: CatalogArtifact;
     readonly catalogDir?: string;
 }): Promise<void>;

package/dist/runtime/sql-fragment.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SQL for a composed fragment.
+ *
+ * Loaded with the operator compiler and with a `select` that contains a
+ * fragment. A featureless read does not import it. Parameters are bound.
+ * `ident` names the TypeScript field, the same name `where` uses. The compiler
+ * quotes that column's SQL name. A hidden field is refused. The fragment is
+ * parenthesized so it cannot remove the tenant predicate.
+ */
+import { type FragmentPart } from "../dialects/pg/ops/fragment.js";
+import { type Indexed, type Sink } from "./plan.js";
+/**
+ * Writes a where fragment.
+ *
+ * `ref` is the field the fragment is attached to, already quoted and aliased.
+ * `fragment.column` emits that reference.
+ *
+ * @param table - The table the where field belongs to
+ * @param ref - `alias."column"`
+ * @param value - Parts the template stored
+ * @param sink - Statement builder
+ */
+export declare function emitSqlValue(table: Indexed, ref: string, value: unknown, sink: Sink): void;
+/**
+ * Writes a select fragment.
+ *
+ * There is no where field, so `fragment.column` is OKM1125.
+ *
+ * @param table - The read table
+ * @param parts - Parts the template stored
+ * @param sink - Statement builder
+ * @param alias - Table alias, `t` on a root read
+ */
+export declare function emitSqlSelect(table: Indexed, parts: readonly FragmentPart[], sink: Sink, alias: string): void;
+/**
+ * Reads a select fragment as a number.
+ *
+ * The wire is text. A value that is not a finite number is OKM1125.
+ *
+ * @param wire - Driver text
+ * @returns The number
+ */
+export declare function decodeSqlNumber(wire: string): number;

package/dist/runtime/tenancy/index.js

@@ -2,24 +2,24 @@ import {
   markPathEndpoint
 } from "../../shared/rhs3xe4k.js";
 import {
-  tenantPolicyExpression,
-  unscopedPolicyExpression,
-  policyObject
-} from "../../shared/bdk4sty6.js";
+  uuid2
+} from "../../shared/ecn8mfdq.js";
 import {
   isRelationCall
 } from "../../shared/exn3sd90.js";
-import {
-  uuid2
-} from "../../shared/hyh73qk6.js";
 import {
   index2,
   snakeCase
-} from "../../shared/rpycarcr.js";
+} from "../../shared/gcefca6p.js";
 import {
   ColumnBuilder2,
   retarget
-} from "../../shared/ywr8hmey.js";
+} from "../../shared/606g0nbf.js";
+import {
+  tenantPolicyExpression,
+  unscopedPolicyExpression,
+  policyObject
+} from "../../shared/bdk4sty6.js";
 import {
   definition
 } from "../../shared/tmbdywx0.js";
@@ -28,7 +28,7 @@ import {
 } from "../../shared/94ez8kzh.js";
 import {
   quote
-} from "../../shared/67txcrcw.js";
+} from "../../shared/kgwp4jdd.js";
 import {
   assertIdentifier2
 } from "../../shared/nfzc5z0w.js";

package/dist/runtime/topology.d.ts

@@ -14,7 +14,7 @@ export type RouteName = "primary" | "replica";
 /**
  * One routing choice.
  *
- * `onRoute` receives this. `inspect()` does not, until the dev inspector (M2).
+ * `onRoute` receives this. `inspect()` on a topology client shows the same reason.
  */
 export type RouteEvent = {
     /** What the statement was classified as. */

package/dist/runtime/traits/index.js

@@ -1,4 +1,10 @@
-import"../../shared/qq3899ht.js";
+import {
+  functionObject,
+  triggerObject
+} from "../../shared/12z7aznj.js";
+import {
+  quoteIdent2
+} from "../../shared/fk9vef30.js";
 import {
   checkPresetNames,
   duplicatePreset
@@ -6,30 +12,23 @@ import {
 import {
   checkTrait
 } from "../../shared/n0dgs0pb.js";
-import {
-  quoteIdent
-} from "../../shared/9s0ypp87.js";
 import {
   pathEndpoint
 } from "../../shared/rhs3xe4k.js";
-import {
-  functionObject,
-  triggerObject
-} from "../../shared/y34a8714.js";
 import {
   integer2,
   timestamptz2
-} from "../../shared/vqrjpcqn.js";
+} from "../../shared/nmnsgj7x.js";
 import {
   uuid2
-} from "../../shared/hyh73qk6.js";
+} from "../../shared/ecn8mfdq.js";
 import {
   snakeCase
-} from "../../shared/rpycarcr.js";
+} from "../../shared/gcefca6p.js";
 import {
   ColumnBuilder2,
   retarget
-} from "../../shared/ywr8hmey.js";
+} from "../../shared/606g0nbf.js";
 import {
   definition,
   unavailable
@@ -42,12 +41,12 @@ import {
   queryHandle,
   attachHttp,
   settleCall
-} from "../../shared/tbrvgw6z.js";
+} from "../../shared/npdftanb.js";
 import {
   installArchiveInspect,
   indexes,
   isRecord
-} from "../../shared/67txcrcw.js";
+} from "../../shared/kgwp4jdd.js";
 import {
   fitIdentifier2
 } from "../../shared/nfzc5z0w.js";
@@ -300,7 +299,7 @@ function timestampRecords(built) {
         returns: "trigger",
         language: "plpgsql",
         volatility: "volatile",
-        body: `begin new.${quoteIdent(column)} = now(); return new; end`,
+        body: `begin new.${quoteIdent2(column)} = now(); return new; end`,
         provenance: { origin: "trait", name: "timestamps" },
         dependencies: []
       }));
@@ -468,7 +467,7 @@ function refuse(host, table) {
 }
 var archiveMod;
 function loadArchive() {
-  archiveMod ??= import("../../shared/bm22fvzr.js");
+  archiveMod ??= import("../../shared/qfw14tna.js");
   return archiveMod;
 }
 async function settle(host, table, mods) {
@@ -736,7 +735,7 @@ function attachSort(target, ctx) {
   wrapOrder(target, "find", order);
   wrapOrder(target, "page", order);
   const view = ctx.view;
-  target.move = (id, place) => import("../../shared/9y3mmmh1.js").then((mod) => mod.move(host, tableName, id, place, view));
+  target.move = (id, place) => import("../../shared/xfhe73sb.js").then((mod) => mod.move(host, tableName, id, place, view));
 }
 function wrapOrder(target, key, order) {
   const previous = target[key];

package/dist/runtime/types.d.ts

@@ -120,7 +120,7 @@ export type Selected<Row, Sel> = [Sel] extends [readonly (infer P)[]] ? [P] exte
 type HasWindow<P> = P extends Window<string, string | number> ? true : false;
 /** Result keys a window helper adds. A field name contributes nothing. */
 type WindowFields<Row, P> = Intersect<P extends Window<infer A, infer V> ? {
-    readonly [K in A]: V extends keyof Row ? NonNullable<Row[V]> | null : number;
+    readonly [K in A]: V extends keyof Row ? NonNullable<Row[V]> | null : V extends number ? number : string;
 } : {}>;
 type IncludeRows<S extends QuerySchema, K extends keyof S["~byName"], Inc> = [Inc] extends [
     Record<string, unknown>
@@ -637,6 +637,20 @@ export type TableApi<S extends QuerySchema, K extends keyof S["~byName"] & strin
         readonly allow: Allow;
     }): Write<Show<RowOf<S, K>>>;
     insert(data: RequiredInsert<InsertOf<S, K>> & OptionalInsert<InsertOf<S, K>>, options?: InsertOptions<S, K>): Write<Show<RowOf<S, K>>>;
+    /**
+     * Inserts a list in one transaction. Unknown keys are dropped.
+     *
+     * `{ allow: ["id"] }` may set `id` on a client-generator primary key.
+     * A row that omits `id` still takes the generator. A longer `allow` list
+     * does not open `id` in this type.
+     *
+     * @param data - Rows. `id` is optional when `allow` is exactly `["id"]`
+     * @param options - Must set `allow` to `["id"]`
+     * @returns The inserted rows
+     */
+    insert(data: readonly (RequiredInsert<InsertOf<S, K>> & OptionalInsert<InsertOf<S, K>> & Partial<Pick<RowOf<S, K>, "id" & keyof RowOf<S, K>>>)[], options: InsertOptions<S, K> & {
+        readonly allow: readonly ["id"];
+    }): Write<readonly Show<RowOf<S, K>>[]>;
     /**
      * Inserts a list in one transaction. Unknown keys are dropped.
      *

package/dist/runtime/validate/index.js

@@ -1,12 +1,12 @@
 import {
   validationGate
-} from "../../shared/ze4hxsmy.js";
+} from "../../shared/w9ejzaqf.js";
 import {
   addSchemaHook
-} from "../../shared/xnxsed62.js";
+} from "../../shared/9dr2qnx7.js";
 import {
   queryHandle
-} from "../../shared/tbrvgw6z.js";
+} from "../../shared/npdftanb.js";
 import {
   OkmError2
 } from "../../shared/52szzakm.js";
@@ -14,7 +14,7 @@ import {
 // src/runtime/validate/load.ts
 var engine;
 function loadEngine() {
-  engine ??= import("../../shared/h15jx9bc.js");
+  engine ??= import("../../shared/9dvh1dr6.js");
   return engine;
 }
 

package/dist/shared/{81ebdx9p.js → 0j6qe91y.js}

@@ -1,6 +1,6 @@
 import {
   noTimeout
-} from "./79dt02vc.js";
+} from "./tr64w5p0.js";
 import {
   PGLITE_CAPABILITIES,
   driverErrors,
@@ -11,12 +11,12 @@ import {
   runCall,
   EMPTY_NOTICES,
   resultFrom
-} from "./kb2sdhfb.js";
+} from "./mfvx6kjx.js";
 
 // src/adapters/pg/pglite.ts
 import { PGlite } from "@electric-sql/pglite";
 async function open3(config = {}) {
-  const wire = await import("./g6evj1j3.js");
+  const wire = await import("./g89fmz5s.js");
   const db = new PGlite({
     dataDir: config.dataDir ?? "memory://",
     parsers: wire.parsers,
@@ -67,7 +67,7 @@ async function open3(config = {}) {
           return;
         released = true;
         try {
-          const { resetQueried } = await import("./5fe3kbsh.js");
+          const { resetQueried } = await import("./pgsak1yw.js");
           await resetQueried(session);
         } finally {
           slot.release();