Pooler | OKModel

allowPooler skips the pooler-host refusal.

Apply holds an advisory lock on one session. A transaction-mode pooler can hand the next statement a different backend.

Field	Required	Default	Role
`allowPooler`	no	`false`	Skip the refusal. `--allow-pooler` does the same for that invocation. Either one is enough.

okmodel.config.ts

import { defineConfig } from "okmodel/migrate";

export default defineConfig({
  schema: "./schema.ts",
  database: process.env.DATABASE_URL!,
  allowPooler: true, 
});

The host is lowercased before the check. The message is Refusing pooler host <host>. Apply needs a direct connection. The code is invalid.

Shape	Result
Host contains `pooler`	Refused.
Host contains `pgbouncer`	Refused.
Port `6543` or `6432`	Refused.
Query `pgbouncer=true`	Refused by the migrate guard. Migrate strips that parameter before the URL becomes a startup parameter; other pooler hints are not interpreted.
A direct `postgres://` URL	Allowed. The flag is not required.

Command	Pooler host
`okm migrate apply`, `okm migrate check`, `okm push`, `okm seed`	Refused until `allowPooler` or `--allow-pooler`.
`okm check`, when it compares one database	Refused until `allowPooler` or `--allow-pooler`.
`provision()`	Refused until `allowPooler` in the config. The call takes no flag.
`okm migrate status`, `okm migrate plan`, `okm doctor`, `okm ext`	Not refused.
`connect()`	Not refused.

OKM1854

Apply, push, seed, provision, and a one-database okm check read pg_backend_pid() eight times on the reserved session and hold another backend between reads so a LIFO pooler cannot reuse one server. okm migrate check does the same inside the scratch replay. The reads are not one transaction. Two or more distinct pids are OKM1854. The same opt-in that skips the host check skips the probe.

Connection pool size is max.