turbine-orm 0.76.0 → 0.77.0

package/dist/cjs/powdb.js

@@ -90,25 +90,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PowqlInterface = exports.introspectPowdbDatabase = exports.PowdbEmbeddedPool = exports.POWQL_LEXER_TESTED_CEILING = exports.PowdbPool = exports.DEFAULT_TX_QUEUE_TIMEOUT_MS = exports.POWQL_KEYWORDS = exports.ALL_POWDB_CAPABILITIES = exports.POWQL_MAX_NESTING_DEPTH = exports.MIN_POWDB_VERSION = exports.PowdbJsonParam = exports.PowdbFloatParam = exports.powdbDialect = void 0;
+exports.PowqlInterface = exports.introspectPowdbDatabase = exports.PowdbEmbeddedPool = exports.POWQL_LEXER_TESTED_CEILING = exports.PowdbPool = exports.DEFAULT_TX_QUEUE_TIMEOUT_MS = exports.POWQL_MAX_NESTING_DEPTH = exports.MIN_POWDB_VERSION = exports.powdbDialect = exports.rowToEntity = exports.requireCapability = exports.quotePowqlIdent = exports.quotePowqlDotted = exports.powqlColumnType = exports.PowdbJsonParam = exports.PowdbFloatParam = exports.POWQL_KEYWORDS = exports.isStaleFramePowdbError = exports.isPowdbDatetimeColumn = exports.isJsonColumn = exports.coerceValue = exports.coerceNativeValue = exports.ALL_POWDB_CAPABILITIES = void 0;
 exports.parsePowdbUrl = parsePowdbUrl;
 exports.assertSupportedPowdbVersion = assertSupportedPowdbVersion;
 exports.capabilitiesFromVersion = capabilitiesFromVersion;
-exports.requireCapability = requireCapability;
-exports.isJsonColumn = isJsonColumn;
-exports.powqlColumnType = powqlColumnType;
-exports.isPowdbDatetimeColumn = isPowdbDatetimeColumn;
-exports.quotePowqlIdent = quotePowqlIdent;
-exports.quotePowqlDotted = quotePowqlDotted;
 exports.deriveDesiredLinks = deriveDesiredLinks;
 exports.powdbLinkStatement = powdbLinkStatement;
 exports.powqlSchemaDDL = powqlSchemaDDL;
 exports.applyPowdbLinks = applyPowdbLinks;
-exports.coerceValue = coerceValue;
-exports.coerceNativeValue = coerceNativeValue;
-exports.rowToEntity = rowToEntity;
 exports.wrapPowdbError = wrapPowdbError;
-exports.isStaleFramePowdbError = isStaleFramePowdbError;
 exports.encodePowqlLiteral = encodePowqlLiteral;
 exports.materializePowql = materializePowql;
 exports.turbinePowDB = turbinePowDB;
@@ -117,8 +107,29 @@ const client_js_1 = require("./client.js");
 const dialect_js_1 = require("./dialect.js");
 const errors_js_1 = require("./errors.js");
 const optional_peer_import_cjs_1 = __importDefault(require("./optional-peer-import.cjs"));
+const powdb_shared_js_1 = require("./powdb-shared.js");
 const warn_registry_js_1 = require("./query/warn-registry.js");
 const schema_js_1 = require("./schema.js");
+// The shared PowDB primitives live in a leaf module (see powdb-shared.ts): this
+// file re-exports from powql.ts and powdb-introspect.ts, and both of those need
+// the primitives, so keeping them here made the three a runtime cycle. Re-export
+// every name that was public before the split, under its original name, so the
+// `turbine-orm/powdb` surface is unchanged.
+var powdb_shared_js_2 = require("./powdb-shared.js");
+Object.defineProperty(exports, "ALL_POWDB_CAPABILITIES", { enumerable: true, get: function () { return powdb_shared_js_2.ALL_POWDB_CAPABILITIES; } });
+Object.defineProperty(exports, "coerceNativeValue", { enumerable: true, get: function () { return powdb_shared_js_2.coerceNativeValue; } });
+Object.defineProperty(exports, "coerceValue", { enumerable: true, get: function () { return powdb_shared_js_2.coerceValue; } });
+Object.defineProperty(exports, "isJsonColumn", { enumerable: true, get: function () { return powdb_shared_js_2.isJsonColumn; } });
+Object.defineProperty(exports, "isPowdbDatetimeColumn", { enumerable: true, get: function () { return powdb_shared_js_2.isPowdbDatetimeColumn; } });
+Object.defineProperty(exports, "isStaleFramePowdbError", { enumerable: true, get: function () { return powdb_shared_js_2.isStaleFramePowdbError; } });
+Object.defineProperty(exports, "POWQL_KEYWORDS", { enumerable: true, get: function () { return powdb_shared_js_2.POWQL_KEYWORDS; } });
+Object.defineProperty(exports, "PowdbFloatParam", { enumerable: true, get: function () { return powdb_shared_js_2.PowdbFloatParam; } });
+Object.defineProperty(exports, "PowdbJsonParam", { enumerable: true, get: function () { return powdb_shared_js_2.PowdbJsonParam; } });
+Object.defineProperty(exports, "powqlColumnType", { enumerable: true, get: function () { return powdb_shared_js_2.powqlColumnType; } });
+Object.defineProperty(exports, "quotePowqlDotted", { enumerable: true, get: function () { return powdb_shared_js_2.quotePowqlDotted; } });
+Object.defineProperty(exports, "quotePowqlIdent", { enumerable: true, get: function () { return powdb_shared_js_2.quotePowqlIdent; } });
+Object.defineProperty(exports, "requireCapability", { enumerable: true, get: function () { return powdb_shared_js_2.requireCapability; } });
+Object.defineProperty(exports, "rowToEntity", { enumerable: true, get: function () { return powdb_shared_js_2.rowToEntity; } });
 /**
  * Capability descriptor for PowDB. PowQL generation is owned by
  * {@link PowqlInterface} (not the SQL `Dialect`), so this dialect exists only to
@@ -177,40 +188,6 @@ function throwNoNestedTransaction() {
     throw new errors_js_1.UnsupportedFeatureError('nested transactions', 'powdb', 'PowDB is single-writer, it has one global write lock and no savepoints. ' +
         'Complete the open transaction before starting another; do not nest `$transaction` calls.');
 }
-/**
- * Marker wrapper for a value bound to a `float` column. The networked driver
- * unwraps it to the plain number (the wire param is unchanged), but the
- * *embedded* literal encoder reads it to emit a float-form PowQL literal (`42`
- * → `42.0`) so an integer-valued float column stays unambiguously a float.
- * Constructed in {@link PowqlInterface.param}.
- */
-class PowdbFloatParam {
-    value;
-    constructor(value) {
-        this.value = value;
-    }
-}
-exports.PowdbFloatParam = PowdbFloatParam;
-/**
- * Marker wrapper for a JS object/array bound to a `json` document column. Both
- * transports serialize `value` with `JSON.stringify` and send the text as a
- * `str` param / string literal, exactly how the PowDB docs insert a json
- * document (the engine validates it as JSON text and stores the canonical
- * binary form). Constructed in {@link PowqlInterface.param} when the target
- * column is `json` and the value is a non-null object/array; a JS string
- * written to a json column passes through RAW (same contract as pg jsonb,
- * pass `'"x"'` to store the JSON string `"x"`), and `null` stays `null`.
- */
-class PowdbJsonParam {
-    value;
-    column;
-    /** `column` is diagnostic only: it names the target column when serialization fails. */
-    constructor(value, column) {
-        this.value = value;
-        this.column = column;
-    }
-}
-exports.PowdbJsonParam = PowdbJsonParam;
 /** Minimum PowDB server version the networked transport requires. */
 exports.MIN_POWDB_VERSION = '0.7.0';
 /**
@@ -228,7 +205,7 @@ function parsePowdbUrl(connectionString) {
         throw new errors_js_1.ConnectionError((0, errors_js_1.malformedConnectionStringMessage)('PowDB', 'powdb://user:password@127.0.0.1:5433/app'));
     }
     if (u.protocol !== 'powdb:') {
-        throw new errors_js_1.ConnectionError(`[turbine] PowDB connection string must use the powdb:// scheme (got "${u.protocol}//…").`);
+        throw new errors_js_1.ConnectionError(`PowDB connection string must use the powdb:// scheme (got "${u.protocol}//…").`);
     }
     const opts = {
         host: u.hostname || '127.0.0.1',
@@ -259,9 +236,12 @@ function assertSupportedPowdbVersion(version) {
     // 0.7.0 is the floor; >= 0.7 (or any 1.x+) passes.
     if (major > 0 || (major === 0 && minor >= 7))
         return;
-    throw new errors_js_1.ConnectionError(`[turbine] turbine-orm/powdb requires PowDB >= ${exports.MIN_POWDB_VERSION}; the server reports "${version}". ` +
+    throw new errors_js_1.ConnectionError(`turbine-orm/powdb requires PowDB >= ${exports.MIN_POWDB_VERSION}; the server reports "${version}". ` +
         'Upgrade the PowDB server (0.7.0 added the `returning` keyword and the int->float coercion fix Turbine relies on).');
 }
+// ---------------------------------------------------------------------------
+// Capability gating: per-version / per-transport feature flags
+// ---------------------------------------------------------------------------
 /**
  * PowQL's parser bounds the SHAPE of the AST it produces, not just its own
  * recursion: an `and` / `or` chain is parsed iteratively but re-wraps its
@@ -290,66 +270,6 @@ function assertSupportedPowdbVersion(version) {
  * powql.ts.
  */
 exports.POWQL_MAX_NESTING_DEPTH = 64;
-/**
- * Minimum engine version each gated feature needs, for the E017 hint text.
- * Most gates carry a `major.minor` floor (patch-insensitive); the two link
- * lanes carry a `major.minor.patch` floor (`0.19.1`) because the listing
- * statement and the safe traversal semantics landed in the PATCH release, not
- * in 0.19.0. {@link atLeastVersion} compares all three components, so a
- * `major.minor` floor still matches every patch of that minor.
- */
-const POWDB_FEATURE_MIN_VERSION = {
-    introspection: '0.10',
-    jsonDocs: '0.12',
-    docFieldIndexes: '0.13',
-    serverJoins: '0.13',
-    nestedProjections: '0.18',
-    entityLinks: '0.19',
-    linkIntrospection: '0.19.1',
-    linkPaths: '0.19.1',
-    datetimeCompare: '0.20',
-    projectedCountNonNull: '0.20',
-};
-/**
- * Trusted-caller default: every FEATURE gate on, engine version unknown. Used
- * for a directly-constructed {@link PowdbPool} / {@link PowdbEmbeddedPool} that
- * did not go through {@link turbinePowDB}'s version probe (e.g. an injected
- * pool, or a unit-test pool). `nativeRaw` stays OFF here because it flips the
- * actual wire path and must only be enabled after a real server-version probe,
- * never inferred from a bare construction. `nestedProjections` stays OFF for
- * the same reason: it changes the generated PowQL for every `with` query, and
- * an unprobed engine below 0.18 would reject the syntax outright.
- * `entityLinks` stays OFF for a stronger reason still: declaring a link
- * one-way-upgrades the on-disk catalog to v7 and locks out pre-0.19 binaries,
- * so it must only ever light up behind a real version probe.
- * `linkIntrospection` / `linkPaths` stay OFF for the same probe-only discipline:
- * `linkPaths` flips real query generation (a to-one `with` compiling to link
- * projections), and `linkIntrospection` is only meaningful once genuinely
- * probed, so both must come from a real version resolution, never a bare
- * construction.
- * `datetimeCompare` / `projectedCountNonNull` stay ON here for the same
- * trusted-caller reason as `jsonDocs` and `serverJoins`. Neither is a fallback
- * gate: with the flag OFF the affected query is REFUSED, not served by some
- * other statement, so defaulting them off would break working queries rather
- * than protect anything. Every path that can learn the engine version
- * (`turbinePowDB`, embedded or networked) resolves them from a real probe; this
- * fallback only covers a hand-constructed or injected pool, whose owner is
- * asserting the engine is current.
- */
-exports.ALL_POWDB_CAPABILITIES = {
-    engineVersion: null,
-    jsonDocs: true,
-    docFieldIndexes: true,
-    introspection: true,
-    serverJoins: true,
-    nestedProjections: false,
-    entityLinks: false,
-    linkIntrospection: false,
-    linkPaths: false,
-    datetimeCompare: true,
-    projectedCountNonNull: true,
-    nativeRaw: false,
-};
 /** Parse a PowDB semver prefix (`0.13.0`, `0.13`, `1.2.3-rc`) into components, or `null`. */
 function parsePowdbSemver(version) {
     const m = /^(\d+)\.(\d+)(?:\.(\d+))?/.exec(String(version ?? '').trim());
@@ -414,270 +334,6 @@ function capabilitiesFromVersion(version, opts = {}) {
         nativeRaw: Boolean(opts.hasNativeRaw) && atLeastVersion(sem, 0, 13),
     };
 }
-/**
- * Throw a version-hinting {@link UnsupportedFeatureError} (E017) when a gated
- * PowQL feature is used on an engine that does not support it. Keeps old engines
- * getting clean typed errors instead of raw PowQL parse failures.
- *
- * The error's first sentence already names the feature (`<feature> is
- * unsupported on "PowDB".`), so the hint says "Requires PowDB >= x" rather than
- * repeating the label: a long feature description read twice in one message
- * (`per-field \`_count\` … is unsupported … per-field \`_count\` … requires …`)
- * buries the version floor that is the actionable part.
- *
- * `extra` appends one more sentence for gates that have a workaround worth
- * naming (e.g. the read path that answers the same query without the gated
- * comparison).
- */
-function requireCapability(caps, key, feature, extra) {
-    if (caps[key])
-        return;
-    const min = POWDB_FEATURE_MIN_VERSION[key];
-    const reported = caps.engineVersion
-        ? `this connection reports ${caps.engineVersion}`
-        : 'this connection could not report a version';
-    throw new errors_js_1.UnsupportedFeatureError(feature, 'PowDB', `Requires PowDB >= ${min}; ${reported}. Upgrade powdb-server / @zvndev/powdb-embedded ` +
-        `(or pass \`assumeEngineVersion\` if the version cannot be detected).${extra ? ` ${extra}` : ''}`);
-}
-/**
- * Does this column map to PowDB's native `json` document type? A Postgres
- * `json`/`jsonb` type (via `dialectType`/`pgType`) is authoritative; otherwise
- * the tsType heuristic (`Record<…>`, `object`, `unknown`, an object/array
- * literal) that the four scalar branches do not claim. Array columns never map
- * to json, a PowDB array only exists INSIDE a json document, so a Postgres
- * array column has no PowDB shape and still throws in {@link powqlColumnType}.
- */
-function isJsonColumn(col) {
-    if (col.isArray)
-        return false;
-    const dbType = (col.dialectType ?? col.pgType ?? '').toLowerCase();
-    if (dbType === 'json' || dbType === 'jsonb')
-        return true;
-    const ts = col.tsType.replace(/\s*\|\s*null$/i, '').trim();
-    if (ts === 'Date' || ts === 'boolean' || ts === 'number' || ts === 'bigint' || ts === 'string')
-        return false;
-    if (ts === 'Buffer' || ts === 'Uint8Array')
-        return false;
-    return /Record<|object|unknown|\[\]|\{/.test(ts);
-}
-/**
- * Map a Turbine column to the PowQL DDL type used in `defineSchema` →
- * `type T { … }`. Turbine never emits PowDB's `uuid`/`datetime`/`bytes` types,
- * which cannot hold client-supplied values on the wire (no literal, no cast):
- *   - `Date` → `int` (epoch micros)   - `boolean` → `bool`
- *   - integral `number`/`bigint` → `int`   - fractional `number` → `float`
- *   - JSON / object columns → `json` (native PowDB document type, ≥ 0.12)
- *   - everything else (incl. UUID/PK strings) → `str`
- * Array (non-json) and bytes columns throw, they have no PowDB equivalent.
- */
-function powqlColumnType(col) {
-    if (col.isArray) {
-        throw new errors_js_1.ValidationError(`[turbine] Column "${col.name}" is an array, PowDB has no array type. Arrays are unsupported on the PowDB backend.`);
-    }
-    if (isJsonColumn(col))
-        return 'json';
-    const ts = col.tsType.replace(/\s*\|\s*null$/i, '').trim();
-    if (ts === 'Date')
-        return 'int'; // epoch micros
-    if (ts === 'boolean')
-        return 'bool';
-    if (ts === 'number')
-        return isFloatColumn(col) ? 'float' : 'int';
-    if (ts === 'bigint')
-        return 'int';
-    if (ts === 'string')
-        return 'str';
-    if (ts === 'Buffer' || ts === 'Uint8Array') {
-        throw new errors_js_1.ValidationError(`[turbine] Column "${col.name}" is binary, PowDB cannot store client-supplied bytes on the wire. Use a string (e.g. base64) instead.`);
-    }
-    return 'str';
-}
-/** Heuristic: does this numeric column hold fractional values (→ PowQL `float`)? */
-function isFloatColumn(col) {
-    const t = (col.dialectType ?? col.pgType ?? '').toLowerCase();
-    return /float|double|real|numeric|decimal|money/.test(t);
-}
-/** Is a column stored as `int` epoch micros but surfaced as a JS `Date`? */
-function isDateColumn(col) {
-    return col.tsType.replace(/\s*\|\s*null$/i, '').trim() === 'Date';
-}
-/**
- * Is this column stored in PowDB's NATIVE `datetime` type (as opposed to the
- * `int` epoch micros Turbine's own DDL emits for a `Date` column)?
- *
- * Only the literal PowQL type name counts. `powqlColumnType` never returns
- * `datetime`, so a Turbine-provisioned table can never have one; the shapes that
- * do are a table created outside Turbine and read back through
- * `introspectPowdbDatabase` (which maps `datetime` → `{ tsType: 'Date',
- * dialectType: 'datetime' }`), or hand-written metadata declaring it. Deliberately
- * strict: a Postgres-sourced `timestamptz` column is DDL'd as PowQL `int`, so it
- * is NOT a PowDB datetime and must not be caught here.
- *
- * Matters because comparing a datetime column against the integer timestamp
- * literal Turbine binds was silently wrong below engine 0.20 (see
- * {@link PowdbCapabilities.datetimeCompare}).
- */
-function isPowdbDatetimeColumn(col) {
-    return (col.dialectType ?? col.pgType ?? '').toLowerCase() === 'datetime';
-}
-/**
- * Generate PowQL DDL (`type T { … }`) for every table in a schema. Used to
- * provision a PowDB database from a code-first `defineSchema`/`SchemaMetadata`
- * (PowDB has no migration runner yet). The primary key column is declared
- * `required unique`; non-nullable columns are `required`. A server-generated
- * column ({@link ColumnMetadata.isGenerated}) that maps to PowQL `int` gets the
- * `auto` modifier, so PowDB assigns a monotonic id on insert and Turbine stops
- * synthesizing a client-side value for it.
- */
-/**
- * PowQL reserved words, the v0.10 lexer keyword table from POWQL.md's
- * "Reserved Words and Quoting" section, including the v0.10 additions
- * `schema` and `describe`. Keyword matching is case-sensitive in the lexer,
- * so only the exact lowercase form collides.
- */
-exports.POWQL_KEYWORDS = new Set([
-    'abs',
-    'add',
-    'alter',
-    'and',
-    'as',
-    'asc',
-    'auto',
-    'avg',
-    'begin',
-    'between',
-    'case',
-    'cast',
-    'ceil',
-    'column',
-    'commit',
-    'concat',
-    'conflict',
-    'count',
-    'cross',
-    'date_add',
-    'date_diff',
-    'default',
-    'delete',
-    'dense_rank',
-    'desc',
-    'describe',
-    'distinct',
-    'drop',
-    'else',
-    'end',
-    'exists',
-    'explain',
-    'extract',
-    'false',
-    'filter',
-    'floor',
-    'group',
-    'having',
-    'in',
-    'index',
-    'inner',
-    'insert',
-    'is',
-    'join',
-    'left',
-    'length',
-    'let',
-    'like',
-    'limit',
-    'link',
-    'lower',
-    'match',
-    'materialize',
-    'materialized',
-    'max',
-    'min',
-    'multi',
-    'not',
-    'now',
-    'null',
-    'offset',
-    'on',
-    'or',
-    'order',
-    'outer',
-    'over',
-    'partition',
-    'pow',
-    'rank',
-    'refresh',
-    'required',
-    'returning',
-    'right',
-    'rollback',
-    'round',
-    'row_number',
-    'schema',
-    'select',
-    'sqrt',
-    'substring',
-    'sum',
-    'then',
-    'transaction',
-    'trim',
-    'true',
-    'type',
-    'union',
-    'unique',
-    'update',
-    'upper',
-    'upsert',
-    'view',
-    'when',
-]);
-const POWQL_BARE_IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
-/**
- * Backtick-quote an identifier when PowQL would otherwise lex it as a keyword
- * (or when it contains characters outside the bare-identifier grammar).
- * Applied only in bare-identifier positions, DDL type/field names, index DDL,
- * and `insert`/`update`/`upsert` assignment targets. Dotted references
- * (`.col` in filters/projections/ordering) bypass keyword lookup on every
- * engine version and deliberately stay bare for ≤0.9 compatibility. Backticks
- * parse on PowDB ≥ 0.10; on older engines these names were already parse
- * errors when emitted bare, so quoting is strictly an improvement.
- */
-function quotePowqlIdent(name) {
-    if (name.includes('`')) {
-        // The lexer has no backtick escape inside a quoted identifier.
-        throw new errors_js_1.ValidationError(`[turbine] Identifier "${name}" contains a backtick, which PowQL cannot represent.`);
-    }
-    return exports.POWQL_KEYWORDS.has(name) || !POWQL_BARE_IDENT.test(name) ? `\`${name}\`` : name;
-}
-/**
- * The DOTTED-position spelling of {@link quotePowqlIdent}: quote a name that
- * falls outside the bare-identifier grammar, and only that.
- *
- * A dotted reference (`.col` in a filter, projection, `order`, `group`, or an
- * `upsert on`) bypasses keyword lookup, so `.order` parses on every engine
- * version and stays bare here, which is the ≤0.9 compatibility decision
- * {@link quotePowqlIdent} documents and which this must not undo.
- *
- * What it does NOT excuse is interpolating the name RAW, which is what these
- * sites used to do. Keyword-ness is a parsing question; a name outside
- * `POWQL_BARE_IDENT` is a statement-integrity one, and that name is the only
- * thing that can carry PowQL syntax into a statement whose values are all bound
- * as `$N` params. Reaching it needs a hostile column name (an introspected
- * database, a generator, a migration authored elsewhere) since names come from
- * schema metadata, but "the names are trusted" is not the invariant the rest of
- * this engine is written to. So: bare when the grammar allows it (byte-identical
- * output for every ordinary and every keyword name), quoted when it does not,
- * where the bare form was a parse error anyway. Verified against the engine that
- * a quoted dotted reference parses everywhere the bare one does and yields the
- * same result-column name.
- */
-function quotePowqlDotted(name) {
-    if (POWQL_BARE_IDENT.test(name))
-        return name;
-    if (name.includes('`')) {
-        throw new errors_js_1.ValidationError(`[turbine] Identifier "${name}" contains a backtick, which PowQL cannot represent.`);
-    }
-    return `\`${name}\``;
-}
 /**
  * Derive the entity links Turbine would declare from a schema's relations. One
  * link per single-column hasMany / hasOne / belongsTo relation, owned by the
@@ -717,9 +373,18 @@ function deriveDesiredLinks(schema, onCollision) {
 }
 /** Render one {@link PowdbDesiredLink} as its create-only `link ...` DDL statement. */
 function powdbLinkStatement(link) {
-    return (`link ${quotePowqlIdent(link.owner)}.${quotePowqlIdent(link.name)} -> ` +
-        `${quotePowqlIdent(link.target)} on ${quotePowqlIdent(link.localKey)} = ${quotePowqlIdent(link.targetKey)}`);
+    return (`link ${(0, powdb_shared_js_1.quotePowqlIdent)(link.owner)}.${(0, powdb_shared_js_1.quotePowqlIdent)(link.name)} -> ` +
+        `${(0, powdb_shared_js_1.quotePowqlIdent)(link.target)} on ${(0, powdb_shared_js_1.quotePowqlIdent)(link.localKey)} = ${(0, powdb_shared_js_1.quotePowqlIdent)(link.targetKey)}`);
 }
+/**
+ * Generate PowQL DDL (`type T { … }`) for every table in a schema. Used to
+ * provision a PowDB database from a code-first `defineSchema`/`SchemaMetadata`
+ * (PowDB has no migration runner yet). The primary key column is declared
+ * `required unique`; non-nullable columns are `required`. A server-generated
+ * column ({@link ColumnMetadata.isGenerated}) that maps to PowQL `int` gets the
+ * `auto` modifier, so PowDB assigns a monotonic id on insert and Turbine stops
+ * synthesizing a client-side value for it.
+ */
 function powqlSchemaDDL(schema, opts = {}) {
     const caps = opts.capabilities;
     const stmts = [];
@@ -732,12 +397,12 @@ function powqlSchemaDDL(schema, opts = {}) {
         // cannot enforce the tuple's uniqueness at the engine level.
         const pkIsSingle = meta.primaryKey.length === 1;
         const fields = meta.columns.map((col) => {
-            const powqlType = powqlColumnType(col);
+            const powqlType = (0, powdb_shared_js_1.powqlColumnType)(col);
             // Gate `json` columns behind the engine's jsonDocs capability when a
             // caller supplied one, an old engine has no `json` type and would reject
             // the DDL. Pure-function callers (no opts) emit unconditionally.
             if (powqlType === 'json' && caps)
-                requireCapability(caps, 'jsonDocs', 'JSON document columns');
+                (0, powdb_shared_js_1.requireCapability)(caps, 'jsonDocs', 'JSON document columns');
             const mods = [];
             if (!col.nullable || pkSet.has(col.name))
                 mods.push('required');
@@ -748,9 +413,9 @@ function powqlSchemaDDL(schema, opts = {}) {
             // a plain typed column (Turbine assigns the value client-side instead).
             if (col.isGenerated && powqlType === 'int')
                 mods.push('auto');
-            return `  ${mods.join(' ')}${mods.length ? ' ' : ''}${quotePowqlIdent(col.name)}: ${powqlType}`;
+            return `  ${mods.join(' ')}${mods.length ? ' ' : ''}${(0, powdb_shared_js_1.quotePowqlIdent)(col.name)}: ${powqlType}`;
         });
-        stmts.push(`type ${quotePowqlIdent(meta.name)} {\n${fields.join(',\n')}\n}`);
+        stmts.push(`type ${(0, powdb_shared_js_1.quotePowqlIdent)(meta.name)} {\n${fields.join(',\n')}\n}`);
         // Track which single columns already carry a unique constraint (the
         // single-column PK is inlined `required unique` in the type body above) so
         // a redundant `add unique .col` is never emitted twice.
@@ -760,7 +425,7 @@ function powqlSchemaDDL(schema, opts = {}) {
         // Secondary unique constraints (beyond the PK) become unique indexes.
         for (const uniq of meta.uniqueColumns) {
             if (uniq.length === 1 && !pkSet.has(uniq[0])) {
-                stmts.push(`alter ${quotePowqlIdent(meta.name)} add unique .${quotePowqlIdent(uniq[0])}`);
+                stmts.push(`alter ${(0, powdb_shared_js_1.quotePowqlIdent)(meta.name)} add unique .${(0, powdb_shared_js_1.quotePowqlIdent)(uniq[0])}`);
                 emittedUnique.add(uniq[0]);
             }
         }
@@ -775,13 +440,13 @@ function powqlSchemaDDL(schema, opts = {}) {
             const kind = idx.unique ? 'unique' : 'index';
             if (idx.docPath) {
                 if (caps)
-                    requireCapability(caps, 'docFieldIndexes', 'JSON doc-field expression indexes');
+                    (0, powdb_shared_js_1.requireCapability)(caps, 'docFieldIndexes', 'JSON doc-field expression indexes');
                 const column = idx.columns[0];
                 if (column === undefined) {
-                    throw new errors_js_1.ValidationError(`[turbine] Doc-field index "${idx.name}" on ${meta.name} has no target json column.`);
+                    throw new errors_js_1.ValidationError(`Doc-field index "${idx.name}" on ${meta.name} has no target json column.`);
                 }
                 const segs = idx.docPath.map((s) => (typeof s === 'number' ? `->${s}` : `->${encodePowqlString(s)}`)).join('');
-                stmts.push(`alter ${quotePowqlIdent(meta.name)} add ${kind} (.${quotePowqlIdent(column)}${segs})`);
+                stmts.push(`alter ${(0, powdb_shared_js_1.quotePowqlIdent)(meta.name)} add ${kind} (.${(0, powdb_shared_js_1.quotePowqlIdent)(column)}${segs})`);
             }
             else {
                 // Plain column index. PowDB has no composite index (`add index` takes a
@@ -795,7 +460,7 @@ function powqlSchemaDDL(schema, opts = {}) {
                 // PK, or a column-level unique) would be a redundant duplicate, so skip it.
                 if (idx.unique && emittedUnique.has(column))
                     continue;
-                stmts.push(`alter ${quotePowqlIdent(meta.name)} add ${kind} .${quotePowqlIdent(column)}`);
+                stmts.push(`alter ${(0, powdb_shared_js_1.quotePowqlIdent)(meta.name)} add ${kind} .${(0, powdb_shared_js_1.quotePowqlIdent)(column)}`);
                 if (idx.unique)
                     emittedUnique.add(column);
             }
@@ -806,7 +471,7 @@ function powqlSchemaDDL(schema, opts = {}) {
     // when a caller supplied one (an old engine has no `link` statement).
     if (opts.emitLinks) {
         if (caps)
-            requireCapability(caps, 'entityLinks', 'entity link DDL (`emitLinks`)');
+            (0, powdb_shared_js_1.requireCapability)(caps, 'entityLinks', 'entity link DDL (`emitLinks`)');
         const links = deriveDesiredLinks(schema, (owner, name) => {
             if ((0, warn_registry_js_1.shouldWarnOnce)(warn_registry_js_1.WARN_NS.powdbLinks, `collide:${owner}.${name}`)) {
                 console.warn(`[turbine] powqlSchemaDDL(emitLinks): relation "${name}" on "${owner}" collides with a column of the ` +
@@ -839,8 +504,8 @@ function powqlSchemaDDL(schema, opts = {}) {
 async function applyPowdbLinks(exec, schema, options = {}) {
     const caps = options.capabilities;
     if (caps) {
-        requireCapability(caps, 'entityLinks', 'entity link DDL (`applyPowdbLinks`)');
-        requireCapability(caps, 'linkIntrospection', 'PowDB `schema links` introspection');
+        (0, powdb_shared_js_1.requireCapability)(caps, 'entityLinks', 'entity link DDL (`applyPowdbLinks`)');
+        (0, powdb_shared_js_1.requireCapability)(caps, 'linkIntrospection', 'PowDB `schema links` introspection');
     }
     const existing = await listPowdbLinks(exec);
     const byOwnerName = new Map(existing.map((l) => [`${l.owner}\u0000${l.name}`, l]));
@@ -903,10 +568,10 @@ function powdbJsonText(param, position) {
         json = JSON.stringify(param.value);
     }
     catch (err) {
-        throw new errors_js_1.ValidationError(`[turbine] The json value ${where} cannot be serialized for PowDB: ${err.message}`);
+        throw new errors_js_1.ValidationError(`The json value ${where} cannot be serialized for PowDB: ${err.message}`);
     }
     if (json === undefined) {
-        throw new errors_js_1.ValidationError(`[turbine] The json value ${where} serializes to nothing (JSON.stringify returned undefined); ` +
+        throw new errors_js_1.ValidationError(`The json value ${where} serializes to nothing (JSON.stringify returned undefined); ` +
             'write `null` explicitly instead.');
     }
     return json;
@@ -915,23 +580,23 @@ function powdbJsonText(param, position) {
 function powdbDateMicros(value, position) {
     const ms = value.getTime();
     if (!Number.isFinite(ms)) {
-        throw new errors_js_1.ValidationError(`[turbine] Invalid Date${position ? ` (${position})` : ''} cannot be encoded as a PowDB timestamp.`);
+        throw new errors_js_1.ValidationError(`Invalid Date${position ? ` (${position})` : ''} cannot be encoded as a PowDB timestamp.`);
     }
     return BigInt(ms) * 1000n;
 }
 /** Coerce a JS value into a PowDB positional param (the write side). */
 function toPowdbParam(value, col) {
-    if (value instanceof PowdbFloatParam)
+    if (value instanceof powdb_shared_js_1.PowdbFloatParam)
         return value.value; // wire-side: a float column takes the plain number
     // json document: serialize to canonical JSON text and bind as a str param,
     // the engine validates it as JSON and stores the canonical binary form.
-    if (value instanceof PowdbJsonParam)
+    if (value instanceof powdb_shared_js_1.PowdbJsonParam)
         return powdbJsonText(value);
     if (value === undefined || value === null)
         return null;
     if (value instanceof Date)
         return powdbDateMicros(value); // ms → micros (int column)
-    if (col && isDateColumn(col) && typeof value === 'number')
+    if (col && (0, powdb_shared_js_1.isDateColumn)(col) && typeof value === 'number')
         return BigInt(value) * 1000n;
     if (typeof value === 'boolean' ||
         typeof value === 'number' ||
@@ -940,116 +605,7 @@ function toPowdbParam(value, col) {
         return value;
     }
     // Objects/arrays have no PowDB representation.
-    throw new errors_js_1.ValidationError(`[turbine] Value of type ${typeof value} cannot be bound as a PowDB parameter.`);
-}
-/**
- * Coerce a single PowDB wire string into the JS value its column type implies.
- * Every PowDB value arrives as a string; NULL arrives as the bareword `"null"`.
- * Metadata resolves the `"null"` ambiguity for nullable non-string columns.
- */
-function coerceValue(raw, col) {
-    const ts = col.tsType.replace(/\s*\|\s*null$/i, '').trim();
-    const json = isJsonColumn(col);
-    // NULL bareword: unambiguous for non-string columns; for `str` we cannot tell a
-    // literal "null" from SQL NULL, so a nullable str of value "null" reads as null.
-    // For a `json` column the bareword `null` (a legacy-wire rendering shared by an
-    // absent value AND a top-level JSON-null document, documented residual,
-    // resolved on the native transport by the WireValue path) maps to null; a JSON
-    // string document "null" renders WITH quotes (`"null"`) and parses distinctly.
-    if (raw === 'null' && (json || ts !== 'string' || col.nullable))
-        return null;
-    if (json) {
-        try {
-            return JSON.parse(raw);
-        }
-        catch {
-            return raw; // defensive: canonical JSON text always parses
-        }
-    }
-    if (ts === 'Date') {
-        const micros = Number(raw);
-        return Number.isFinite(micros) ? new Date(micros / 1000) : null;
-    }
-    if (ts === 'boolean')
-        return raw === 'true';
-    if (ts === 'number') {
-        const n = Number(raw);
-        // int8 policy: keep precision-losing big integers as strings.
-        return Number.isSafeInteger(n) || !Number.isInteger(n) ? n : raw;
-    }
-    if (ts === 'bigint')
-        return BigInt(raw);
-    return raw; // string / uuid-as-string
-}
-/**
- * Coerce a single cell that arrived over the NATIVE typed wire (decoded from a
- * {@link PowdbWireValue}, so already a JS `bigint`/`number`/`boolean`/`string`/
- * `NativeJson`/`Uint8Array`/`null`, never a bare `"null"` string). Unlike
- * {@link coerceValue} this NEVER collapses the string `"null"` to `null`: an
- * absent value already decoded to `null` (from the `empty` cell), so a genuine
- * str `"null"` stays the string `"null"` (fixes the legacy-wire wart on the
- * native transport). `datetime`-shaped cells (int micros) become `Date`; a
- * bigint on a `number` column follows the int8 safe-integer policy.
- *
- * A date cell can also arrive as a DIGIT STRING: a nested-projection block's
- * children ride a JSON array, and micros exceed `Number.MAX_SAFE_INTEGER`'s
- * decimal comfort, so the engine renders them as a JSON string. Before that
- * string was parsed here, a nested `with` handed back the raw micros text while
- * the batched loader and the native join both handed back a `Date` (the same
- * relation, three answers). Only an all-digit string is parsed; any other text
- * on a date column passes through untouched.
- */
-function coerceNativeValue(value, col) {
-    if (value === undefined || value === null)
-        return null;
-    if (isDateColumn(col)) {
-        if (typeof value === 'bigint')
-            return new Date(Number(value) / 1000);
-        if (typeof value === 'number')
-            return new Date(value / 1000);
-        if (typeof value === 'string' && /^-?\d+$/.test(value))
-            return new Date(Number(value) / 1000);
-        return value;
-    }
-    const ts = col.tsType.replace(/\s*\|\s*null$/i, '').trim();
-    if (typeof value === 'bigint') {
-        if (ts === 'bigint')
-            return value;
-        if (ts === 'number') {
-            const n = Number(value);
-            return Number.isSafeInteger(n) ? n : value.toString(); // int8 policy: keep big ints as strings
-        }
-        return value;
-    }
-    return value; // number / boolean / string / NativeJson document / Uint8Array
-}
-/**
- * Map one raw PowDB row into a typed entity (camelCase fields, coerced values).
- * Only the columns present in `raw` are emitted, so partial `select`
- * projections round-trip unchanged. `native` selects the coercion policy: the
- * default `false` handles the legacy string wire (every cell is a string, via
- * {@link coerceValue}); `true` handles the native typed wire, where non-string
- * cells arrive pre-typed and go through {@link coerceNativeValue} (see F3).
- * Callers on the native transport pass `this.pool.capabilities.nativeRaw`.
- */
-function rowToEntity(raw, meta, native = false) {
-    const byName = new Map(meta.columns.map((c) => [c.name, c]));
-    const out = {};
-    for (const snake of Object.keys(raw)) {
-        const col = byName.get(snake);
-        const field = meta.reverseColumnMap[snake] ?? snake;
-        const value = raw[snake];
-        if (!col) {
-            out[field] = value;
-        }
-        else if (native) {
-            out[field] = coerceNativeValue(value, col);
-        }
-        else {
-            out[field] = typeof value === 'string' ? coerceValue(value, col) : value;
-        }
-    }
-    return out;
+    throw new errors_js_1.ValidationError(`Value of type ${typeof value} cannot be bound as a PowDB parameter.`);
 }
 // ---------------------------------------------------------------------------
 // Error translation
@@ -1072,7 +628,7 @@ function rowToEntity(raw, meta, native = false) {
  */
 function wrapPowdbError(err) {
     if (!err || typeof err !== 'object')
-        return new errors_js_1.ConnectionError(`[turbine] PowDB error: ${String(err)}`);
+        return new errors_js_1.ConnectionError(`PowDB error: ${String(err)}`);
     const e = err;
     const msg = e.message ?? 'unknown PowDB error';
     // Unique-constraint, message-based on both transports.
@@ -1090,7 +646,7 @@ function wrapPowdbError(err) {
     // statement reaching an already-closed embedded handle) carry no .code:
     // classify by message so both transports surface E004.
     if (/pool closed|pool acquire timeout|database is closed/i.test(msg)) {
-        return new errors_js_1.ConnectionError(`[turbine] PowDB connection unavailable: ${msg}`, { cause: err });
+        return new errors_js_1.ConnectionError(`PowDB connection unavailable: ${msg}`, { cause: err });
     }
     // Server-side transaction-gate wait bound (PowDB ≥ 0.10, default 5s): another
     // connection held the single global write lock past the server's
@@ -1109,7 +665,7 @@ function wrapPowdbError(err) {
     // callers (and the opt-in stale-read retry) can inspect the driver code.
     if (e.code === 'protocol_error' ||
         /received unexpected frame|unknown message type|truncated payload|bad framing/i.test(msg)) {
-        return new errors_js_1.ConnectionError(`[turbine] PowDB connection is in an invalid state: ${msg}`, { cause: err });
+        return new errors_js_1.ConnectionError(`PowDB connection is in an invalid state: ${msg}`, { cause: err });
     }
     // Read-only refusal → ReadOnlyError (E018). Two engine shapes, both mapped by
     // substring (the networked transport prefixes the message with `query failed:
@@ -1135,7 +691,7 @@ function wrapPowdbError(err) {
     // not empty …`). It is a connection failure (E004), not a query defect, the
     // fix is to recover the directory with a writable open first.
     if (/cannot open read-only: the WAL is not empty/i.test(msg)) {
-        return new errors_js_1.ConnectionError(`[turbine] PowDB could not open the directory read-only: ${msg}. Open it once with a writable handle to ` +
+        return new errors_js_1.ConnectionError(`PowDB could not open the directory read-only: ${msg}. Open it once with a writable handle to ` +
             'flush the WAL (recover the directory), then reopen it read-only for snapshot serving.', { cause: err });
     }
     // Catalog-version mismatch → ConnectionError (E004). A pre-0.19 binary/addon
@@ -1144,7 +700,7 @@ function wrapPowdbError(err) {
     // not a query defect, so it runs among the connection families BEFORE the
     // generic validation regexes below.
     if (/unsupported catalog version/i.test(msg)) {
-        return new errors_js_1.ConnectionError(`[turbine] PowDB could not open the data directory: ${msg}. This directory uses a newer PowDB catalog ` +
+        return new errors_js_1.ConnectionError(`PowDB could not open the data directory: ${msg}. This directory uses a newer PowDB catalog ` +
             'format (a `link` declaration upgrades it to v7); upgrade the PowDB addon/server to a version that can read it.', { cause: err });
     }
     // Per-query deadline → TimeoutError (E002). Message-path so it fires on the
@@ -1153,20 +709,20 @@ function wrapPowdbError(err) {
     // transaction-gate timeout below) so the real "query timeout after <n>ms"
     // survives instead of rendering the placeholder "timed out after 0ms".
     if (/query timeout after/i.test(msg)) {
-        return new errors_js_1.TimeoutError(0, 'PowDB query', { message: `[turbine] PowDB ${msg}`, cause: err });
+        return new errors_js_1.TimeoutError(0, 'PowDB query', { message: `PowDB ${msg}`, cause: err });
     }
     // Client-initiated cancellation → ConnectionError (E004). This is FINAL: the
     // issuing client disconnected, so the query was a clean early return, never
     // auto-retry it (the opt-in stale-read retry only replays stale-FRAME reads).
     if (/query cancelled by client disconnect/i.test(msg)) {
-        return new errors_js_1.ConnectionError(`[turbine] PowDB query cancelled by client disconnect: ${msg}`, { cause: err });
+        return new errors_js_1.ConnectionError(`PowDB query cancelled by client disconnect: ${msg}`, { cause: err });
     }
     // Bounded join rejection → ValidationError (E003). The engine rejects a pure
     // nested-loop join whose candidate-pair count (or result row count) exceeds
     // the safety bound BEFORE executing, and names the fix in the message, keep
     // that fix-hint intact so the caller knows how to make the join eligible.
     if (/nested-loop join would evaluate|join result exceeds row limit/i.test(msg)) {
-        return new errors_js_1.ValidationError(`[turbine] PowDB join rejected: ${msg}`);
+        return new errors_js_1.ValidationError(`PowDB join rejected: ${msg}`);
     }
     // Entity-link misuse hard errors (0.19.1 turned the two silent-wrong-results
     // 0.19.0 behaviors into hard errors) → ValidationError (E003), a query defect
@@ -1178,7 +734,7 @@ function wrapPowdbError(err) {
     // always aliases and never aggregates over a link), so these fire only for a
     // raw user PowQL string; mapping them keeps that path typed.
     if (/is ambiguous in a projection|aggregates over a nested or link projection/i.test(msg)) {
-        return new errors_js_1.ValidationError(`[turbine] PowDB query rejected: ${msg}`);
+        return new errors_js_1.ValidationError(`PowDB query rejected: ${msg}`);
     }
     // Corrupt storage → ConnectionError (E004). PowDB 0.20 verifies page checksums
     // at table-OPEN time and fails closed (previously the open scan skipped the bad
@@ -1188,7 +744,7 @@ function wrapPowdbError(err) {
     // token would otherwise class it E003). There is no salvage mode: restoring
     // from a backup is the documented recovery, so say so.
     if (/page corrupt|catalog corrupt|corrupt heap superblock|CRC32 mismatch/i.test(msg)) {
-        return new errors_js_1.ConnectionError(`[turbine] PowDB refused to open a corrupt data directory: ${msg}. PowDB verifies page checksums on open ` +
+        return new errors_js_1.ConnectionError(`PowDB refused to open a corrupt data directory: ${msg}. PowDB verifies page checksums on open ` +
             'and fails closed rather than serving partial data; there is no skip-corrupt-pages mode, so recover by ' +
             'restoring the directory from a backup.', { cause: err });
     }
@@ -1202,7 +758,7 @@ function wrapPowdbError(err) {
         const m = /column '([^']+)' not found(?: in table '([^']+)')?/i.exec(msg);
         if (m) {
             const where = m[2] ? ` on table "${m[2]}"` : '';
-            return new errors_js_1.ValidationError(`[turbine] PowDB rejected column "${m[1]}"${where}: it does not exist in the live catalog. ` +
+            return new errors_js_1.ValidationError(`PowDB rejected column "${m[1]}"${where}: it does not exist in the live catalog. ` +
                 'The schema metadata Turbine is using has drifted from the database; re-derive it ' +
                 '(`schemaDefToMetadata` / `introspectPowdbDatabase`) or apply the missing DDL. ' +
                 `(engine: ${msg})`);
@@ -1215,7 +771,7 @@ function wrapPowdbError(err) {
     {
         const m = /type mismatch for column '([^']+)': expected ([^,]+), got (\w+)/i.exec(msg);
         if (m) {
-            return new errors_js_1.ValidationError(`[turbine] PowDB rejected a comparison on column "${m[1]}": the column is ${m[2]} but the bound value is ` +
+            return new errors_js_1.ValidationError(`PowDB rejected a comparison on column "${m[1]}": the column is ${m[2]} but the bound value is ` +
                 `${m[3]}. PowQL never coerces across types in a comparison (before engine 0.20 this silently matched ` +
                 "every row), so bind a value of the column's own type.");
         }
@@ -1225,7 +781,7 @@ function wrapPowdbError(err) {
     // nested parentheses, so a machine-built predicate with very many terms is now
     // rejected outright (see POWQL_MAX_NESTING_DEPTH).
     if (/nesting depth exceeds maximum/i.test(msg)) {
-        return new errors_js_1.ValidationError(`[turbine] PowDB rejected the query: ${msg}. PowQL bounds the shape of the predicate tree, and a flat ` +
+        return new errors_js_1.ValidationError(`PowDB rejected the query: ${msg}. PowQL bounds the shape of the predicate tree, and a flat ` +
             `\`OR\` / \`AND\` array counts one level per term (roughly ${exports.POWQL_MAX_NESTING_DEPTH - 1} terms at the top ` +
             'level, fewer inside a nested `with` block). Split a large `OR` / `AND` array into several queries and ' +
             'merge the results, or express it as a single `in` list, which is one flat node and does not count ' +
@@ -1234,7 +790,7 @@ function wrapPowdbError(err) {
     // Negative limit / offset → ValidationError (E003). Turbine validates these
     // client-side before emitting, so this is the backstop for a raw PowQL string.
     if (/(limit|offset) must not be negative/i.test(msg)) {
-        return new errors_js_1.ValidationError(`[turbine] PowDB rejected the query: ${msg}. Pass a non-negative \`limit\` / \`offset\` ` +
+        return new errors_js_1.ValidationError(`PowDB rejected the query: ${msg}. Pass a non-negative \`limit\` / \`offset\` ` +
             '(before engine 0.20 a negative limit was ignored and returned every row).');
     }
     // Client-side result-frame cell cap (`@zvndev/powdb-client` >= 0.20 rejects a
@@ -1243,7 +799,7 @@ function wrapPowdbError(err) {
     // Error with no code, so match the message and give the caller the two real
     // remedies instead of letting it fall through untyped.
     if (/result too large: \d+ cells/i.test(msg)) {
-        return new errors_js_1.ValidationError(`[turbine] PowDB result too large to decode: ${msg}. The client caps one result frame at 2,000,000 cells ` +
+        return new errors_js_1.ValidationError(`PowDB result too large to decode: ${msg}. The client caps one result frame at 2,000,000 cells ` +
             '(rows x columns). Page the query with `limit` / `offset`, or narrow the row with `select` so each row ' +
             'carries fewer columns.');
     }
@@ -1261,28 +817,28 @@ function wrapPowdbError(err) {
     if (typeof wireClass === 'number') {
         switch (wireClass) {
             case 3: // timeout (per-query budget, gate wait, idle timeout), retryable
-                return new errors_js_1.TimeoutError(0, 'PowDB query', { message: `[turbine] PowDB ${msg}`, cause: err });
+                return new errors_js_1.TimeoutError(0, 'PowDB query', { message: `PowDB ${msg}`, cause: err });
             case 4: // limit_exceeded (memory / size budget), a query-shape defect
-                return new errors_js_1.ValidationError(`[turbine] PowDB resource limit exceeded: ${msg}`);
+                return new errors_js_1.ValidationError(`PowDB resource limit exceeded: ${msg}`);
             case 5: // readonly_refused, the snapshot-serving routing signal
                 return new errors_js_1.ReadOnlyError(`PowDB refused a write on a read-only database: ${msg}.`, {
                     cause: err,
                     reason: 'snapshot',
                 });
             case 6: // auth_failed at CONNECT
-                return new errors_js_1.ConnectionError(`[turbine] PowDB authentication failed: ${msg} (check the user / password / dbName for this connection).`, { cause: err });
+                return new errors_js_1.ConnectionError(`PowDB authentication failed: ${msg} (check the user / password / dbName for this connection).`, { cause: err });
             case 7: // rate_limited (repeated bad auth), connection-establishment class
-                return new errors_js_1.ConnectionError(`[turbine] PowDB rate-limited this address after repeated failed authentication: ${msg}. Wait before retrying.`, { cause: err });
+                return new errors_js_1.ConnectionError(`PowDB rate-limited this address after repeated failed authentication: ${msg}. Wait before retrying.`, { cause: err });
             case 8: {
                 // constraint_violation, today that is always a unique index
                 const m = /on\s+\S+\.(\w+)/i.exec(msg);
                 return new errors_js_1.UniqueConstraintError({ constraint: m?.[1], cause: err });
             }
             case 9: // cancelled (issuing client disconnected), final, never retry
-                return new errors_js_1.ConnectionError(`[turbine] PowDB query cancelled by client disconnect: ${msg}`, { cause: err });
+                return new errors_js_1.ConnectionError(`PowDB query cancelled by client disconnect: ${msg}`, { cause: err });
             case 1: // parse
             case 2: // execution
-                return new errors_js_1.ValidationError(`[turbine] PowDB query rejected: ${msg}`);
+                return new errors_js_1.ValidationError(`PowDB query rejected: ${msg}`);
             default: // internal (0) or an unknown future class: fall through
                 break;
         }
@@ -1292,45 +848,28 @@ function wrapPowdbError(err) {
     // signal we get (code is always 'GenericFailure'); on the networked path they
     // are a safety net before the .code switch.
     if (/type mismatch|\bParse\b|\bExecution\b|StorageError|unexpected|row too large/i.test(msg)) {
-        return new errors_js_1.ValidationError(`[turbine] PowDB query rejected: ${msg}`);
+        return new errors_js_1.ValidationError(`PowDB query rejected: ${msg}`);
     }
     switch (e.code) {
         case 'connect_failed':
         case 'closed':
-            return new errors_js_1.ConnectionError(`[turbine] PowDB connection failed: ${msg}`, { cause: err });
+            return new errors_js_1.ConnectionError(`PowDB connection failed: ${msg}`, { cause: err });
         case 'auth_failed':
             // Connection-establishment class, non-retryable: the handshake was
             // rejected. Surface E004 with a concrete remediation hint instead of
             // letting it fall through to the raw error.
-            return new errors_js_1.ConnectionError(`[turbine] PowDB authentication failed: ${msg} (check the user / password / dbName for this connection).`, { cause: err });
+            return new errors_js_1.ConnectionError(`PowDB authentication failed: ${msg} (check the user / password / dbName for this connection).`, { cause: err });
         case 'timeout':
         case 'aborted':
             return new errors_js_1.TimeoutError(0, 'PowDB query', { cause: err });
         case 'query_failed':
         case 'type_coercion_failed':
         case 'size_exceeded':
-            return new errors_js_1.ValidationError(`[turbine] PowDB query rejected: ${msg}`);
+            return new errors_js_1.ValidationError(`PowDB query rejected: ${msg}`);
         default:
-            return err instanceof Error ? err : new errors_js_1.ConnectionError(`[turbine] PowDB error: ${msg}`, { cause: err });
+            return err instanceof Error ? err : new errors_js_1.ConnectionError(`PowDB error: ${msg}`, { cause: err });
     }
 }
-/**
- * True when `err` is the stale-wire-frame {@link ConnectionError} produced by
- * {@link wrapPowdbError} (its `.cause` is a `protocol_error` PowDBError, or the
- * message carries the invalid-state signature). The opt-in read retry
- * (`retryStaleReads`, evaluated in {@link PowqlInterface}'s exec seam) uses this
- * to decide whether a first-statement READ may be replayed once on a fresh
- * connection; writes are NEVER retried (an ambiguous mutation reply is unsafe
- * to replay, matching the client's own native-path policy).
- */
-function isStaleFramePowdbError(err) {
-    if (!(err instanceof errors_js_1.ConnectionError))
-        return false;
-    const cause = err.cause;
-    if (cause && typeof cause === 'object' && cause.code === 'protocol_error')
-        return true;
-    return /PowDB connection is in an invalid state/.test(err.message);
-}
 function normalizeQueryArgs(arg, values) {
     if (typeof arg === 'string')
         return { text: arg, params: values ?? [] };
@@ -1638,7 +1177,7 @@ class PowdbPool {
         this.pool = pool;
         this.toParam = toParam;
         this.txGate = new PowdbTxGate(options.transactionQueueTimeoutMs ?? exports.DEFAULT_TX_QUEUE_TIMEOUT_MS);
-        this.capabilities = options.capabilities ?? exports.ALL_POWDB_CAPABILITIES;
+        this.capabilities = options.capabilities ?? powdb_shared_js_1.ALL_POWDB_CAPABILITIES;
         this.retryStaleReads = options.retryStaleReads ?? false;
         this.readonly = options.readonly ?? false;
     }
@@ -1697,7 +1236,7 @@ class PowdbPool {
      */
     assertOpen() {
         if (this.closed) {
-            throw new errors_js_1.ConnectionError('[turbine] The PowDB pool is closed, disconnect() was already called on this client.');
+            throw new errors_js_1.ConnectionError('The PowDB pool is closed, disconnect() was already called on this client.');
         }
     }
     async connect() {
@@ -1866,17 +1405,17 @@ function normalizeEmbeddedResult(r) {
  */
 function encodePowqlLiteral(value, position) {
     const at = position ? ` (${position})` : '';
-    if (value instanceof PowdbFloatParam) {
+    if (value instanceof powdb_shared_js_1.PowdbFloatParam) {
         const n = value.value;
         if (!Number.isFinite(n))
-            throw new errors_js_1.ValidationError(`[turbine] Non-finite float cannot be encoded for PowDB${at}.`);
+            throw new errors_js_1.ValidationError(`Non-finite float cannot be encoded for PowDB${at}.`);
         // Force a float-form literal so an integer-valued float column stays a float.
         const text = powqlNumberText(n);
         return text.includes('.') ? text : `${text}.0`;
     }
     // json document: emit the canonical JSON text as a PowQL string literal (the
     // embedded engine validates and stores it as a json document).
-    if (value instanceof PowdbJsonParam)
+    if (value instanceof powdb_shared_js_1.PowdbJsonParam)
         return encodePowqlString(powdbJsonText(value, position), position);
     if (value === undefined || value === null)
         return 'null';
@@ -1888,14 +1427,14 @@ function encodePowqlLiteral(value, position) {
         return value.toString();
     if (typeof value === 'number') {
         if (!Number.isFinite(value))
-            throw new errors_js_1.ValidationError(`[turbine] Non-finite number cannot be encoded for PowDB${at}.`);
+            throw new errors_js_1.ValidationError(`Non-finite number cannot be encoded for PowDB${at}.`);
         // Renders an integer as an int literal (`42`) and a fractional number as a
         // float literal (`4.2`); PowQL distinguishes them by the dot.
         return powqlNumberText(value);
     }
     if (typeof value === 'string')
         return encodePowqlString(value, position);
-    throw new errors_js_1.ValidationError(`[turbine] Value of type ${typeof value} cannot be encoded as a PowDB literal${at}.`);
+    throw new errors_js_1.ValidationError(`Value of type ${typeof value} cannot be encoded as a PowDB literal${at}.`);
 }
 /**
  * Render a finite JS number as PowQL numeric text.
@@ -1916,7 +1455,7 @@ function powqlNumberText(n) {
         return BigInt(n).toString();
     const m = /^(-?)(\d+)(?:\.(\d+))?[eE]([+-]?\d+)$/.exec(s);
     if (!m) {
-        throw new errors_js_1.ValidationError(`[turbine] Number ${s} cannot be rendered as a PowDB literal.`);
+        throw new errors_js_1.ValidationError(`Number ${s} cannot be rendered as a PowDB literal.`);
     }
     const sign = m[1] ?? '';
     const intPart = m[2] ?? '';
@@ -1983,7 +1522,7 @@ exports.POWQL_LEXER_TESTED_CEILING = '0.20';
  */
 function encodePowqlString(s, position) {
     if (s.includes('\0')) {
-        throw new errors_js_1.ValidationError(`[turbine] String value${position ? ` (${position})` : ''} contains a NUL byte (U+0000), which PowQL string ` +
+        throw new errors_js_1.ValidationError(`String value${position ? ` (${position})` : ''} contains a NUL byte (U+0000), which PowQL string ` +
             'literals cannot represent. Strip it before writing.');
     }
     let out = '"';
@@ -2013,7 +1552,7 @@ function materializePowql(powql, params) {
     return powql.replace(/\$(\d+)/g, (_m, n) => {
         const idx = Number(n) - 1;
         if (idx < 0 || idx >= params.length) {
-            throw new errors_js_1.ValidationError(`[turbine] PowQL placeholder $${n} has no bound parameter (have ${params.length}).`);
+            throw new errors_js_1.ValidationError(`PowQL placeholder $${n} has no bound parameter (have ${params.length}).`);
         }
         return encodePowqlLiteral(params[idx], `parameter $${n}`);
     });
@@ -2067,7 +1606,7 @@ class PowdbEmbeddedPool {
     constructor(db, options = {}) {
         this.db = db;
         this.txGate = new PowdbTxGate(options.transactionQueueTimeoutMs ?? exports.DEFAULT_TX_QUEUE_TIMEOUT_MS);
-        this.capabilities = options.capabilities ?? exports.ALL_POWDB_CAPABILITIES;
+        this.capabilities = options.capabilities ?? powdb_shared_js_1.ALL_POWDB_CAPABILITIES;
         this.retryStaleReads = options.retryStaleReads ?? false;
         this.readonly = options.readonly ?? false;
     }
@@ -2100,7 +1639,7 @@ class PowdbEmbeddedPool {
         if (engineSem &&
             ceiling &&
             (engineSem.major > ceiling.major || (engineSem.major === ceiling.major && engineSem.minor > ceiling.minor))) {
-            throw new errors_js_1.ValidationError(`[turbine] Refusing the PowDB legacy string wire: this embedded addon reports engine ` +
+            throw new errors_js_1.ValidationError(`Refusing the PowDB legacy string wire: this embedded addon reports engine ` +
                 `${this.capabilities.engineVersion}, which is newer than the escaper's verified lexer range ` +
                 `(<= ${exports.POWQL_LEXER_TESTED_CEILING}) AND such an addon exposes the parameterized native API, so ` +
                 `reaching the legacy materialize path means the queryWithParams feature-detect failed. Upgrade ` +
@@ -2117,7 +1656,7 @@ class PowdbEmbeddedPool {
      */
     async run(powql, params, holdRef) {
         if (this.closed) {
-            throw new errors_js_1.ConnectionError('[turbine] The PowDB embedded pool is closed: disconnect() was already called on this client.');
+            throw new errors_js_1.ConnectionError('The PowDB embedded pool is closed: disconnect() was already called on this client.');
         }
         const ctl = txControl(powql);
         if (ctl === 'begin') {
@@ -2132,7 +1671,7 @@ class PowdbEmbeddedPool {
             if (this.closed) {
                 holdRef.hold.finish();
                 holdRef.hold = null;
-                throw new errors_js_1.ConnectionError('[turbine] The PowDB embedded pool is closed: disconnect() was already called on this client.');
+                throw new errors_js_1.ConnectionError('The PowDB embedded pool is closed: disconnect() was already called on this client.');
             }
         }
         if ((ctl === 'commit' || ctl === 'rollback') && holdRef.hold === null) {
@@ -2241,7 +1780,7 @@ async function loadPowdb() {
         return (await (0, optional_peer_import_cjs_1.default)('@zvndev/powdb-client'));
     }
     catch (err) {
-        throw new errors_js_1.ConnectionError("[turbine] turbine-orm/powdb requires the optional peer dependency '@zvndev/powdb-client'. Install it: npm i @zvndev/powdb-client, " +
+        throw new errors_js_1.ConnectionError("turbine-orm/powdb requires the optional peer dependency '@zvndev/powdb-client'. Install it: npm i @zvndev/powdb-client, " +
             'or construct the PowDB pool yourself and inject it: turbinePowDB(pool, schema). ' +
             `(${err.message})`);
     }
@@ -2261,7 +1800,7 @@ async function loadPowdbEmbedded() {
         mod = (await (0, optional_peer_import_cjs_1.default)('@zvndev/powdb-embedded'));
     }
     catch (err) {
-        throw new errors_js_1.ConnectionError("[turbine] turbine-orm/powdb embedded mode requires the optional peer '@zvndev/powdb-embedded'. " +
+        throw new errors_js_1.ConnectionError("turbine-orm/powdb embedded mode requires the optional peer '@zvndev/powdb-embedded'. " +
             'Install it: npm i @zvndev/powdb-embedded. If install succeeded but loading failed, your platform has no ' +
             'prebuilt binary (prebuilts ship for macOS arm64/x64 and Linux glibc x64/arm64; Intel-mac/musl/Windows ' +
             'build from source), build it with `npm run build` in the addon, then retry. You can also construct the ' +
@@ -2269,7 +1808,7 @@ async function loadPowdbEmbedded() {
             `(${err.message})`);
     }
     if (!mod || typeof mod.Database?.open !== 'function') {
-        throw new errors_js_1.ConnectionError("[turbine] '@zvndev/powdb-embedded' loaded but did not export Database.open, the installed version is " +
+        throw new errors_js_1.ConnectionError("'@zvndev/powdb-embedded' loaded but did not export Database.open, the installed version is " +
             'likely incompatible (turbine-orm/powdb embedded requires @zvndev/powdb-embedded ^0.7.0).');
     }
     return mod;
@@ -2293,7 +1832,7 @@ async function openEmbeddedPool(target, poolOptions = {}, assumeEngineVersion, i
     // A read-only engine never writes, so a durability selector is meaningless
     // there, reject the combination loudly rather than silently ignoring one.
     if (readonly && syncMode !== undefined) {
-        throw new errors_js_1.ValidationError('[turbine] embedded `syncMode` is meaningless with `readonly: true` (a read-only database never writes). Remove one.');
+        throw new errors_js_1.ValidationError('embedded `syncMode` is meaningless with `readonly: true` (a read-only database never writes). Remove one.');
     }
     let db;
     try {
@@ -2303,20 +1842,20 @@ async function openEmbeddedPool(target, poolOptions = {}, assumeEngineVersion, i
             // installed addon predates them.
             if (memoryLimit !== undefined) {
                 if (typeof mod.Database.openReadOnlyWithMemoryLimit !== 'function') {
-                    throw new errors_js_1.ConnectionError('[turbine] embedded `readonly` + `memoryLimit` requires @zvndev/powdb-embedded >= 0.14 (openReadOnlyWithMemoryLimit).');
+                    throw new errors_js_1.ConnectionError('embedded `readonly` + `memoryLimit` requires @zvndev/powdb-embedded >= 0.14 (openReadOnlyWithMemoryLimit).');
                 }
                 db = mod.Database.openReadOnlyWithMemoryLimit(dir, memoryLimit);
             }
             else {
                 if (typeof mod.Database.openReadOnly !== 'function') {
-                    throw new errors_js_1.ConnectionError('[turbine] embedded `readonly: true` requires @zvndev/powdb-embedded >= 0.14 (the installed addon has no openReadOnly).');
+                    throw new errors_js_1.ConnectionError('embedded `readonly: true` requires @zvndev/powdb-embedded >= 0.14 (the installed addon has no openReadOnly).');
                 }
                 db = mod.Database.openReadOnly(dir);
             }
         }
         else if (memoryLimit !== undefined) {
             if (typeof mod.Database.openWithMemoryLimit !== 'function') {
-                throw new errors_js_1.ConnectionError('[turbine] embedded `memoryLimit` requires @zvndev/powdb-embedded ≥ 0.7.1.');
+                throw new errors_js_1.ConnectionError('embedded `memoryLimit` requires @zvndev/powdb-embedded ≥ 0.7.1.');
             }
             db = mod.Database.openWithMemoryLimit(dir, memoryLimit);
         }
@@ -2327,11 +1866,11 @@ async function openEmbeddedPool(target, poolOptions = {}, assumeEngineVersion, i
     catch (err) {
         if (err instanceof errors_js_1.ConnectionError)
             throw err;
-        throw new errors_js_1.ConnectionError(`[turbine] PowDB embedded could not open data dir "${dir}": ${err.message}`);
+        throw new errors_js_1.ConnectionError(`PowDB embedded could not open data dir "${dir}": ${err.message}`);
     }
     if (syncMode !== undefined) {
         if (typeof db.setSyncMode !== 'function') {
-            throw new errors_js_1.ConnectionError('[turbine] embedded `syncMode` requires @zvndev/powdb-embedded ≥ 0.7.1 (the installed addon has no setSyncMode).');
+            throw new errors_js_1.ConnectionError('embedded `syncMode` requires @zvndev/powdb-embedded ≥ 0.7.1 (the installed addon has no setSyncMode).');
         }
         db.setSyncMode(syncMode);
     }