turbine-orm 0.76.0 → 0.77.0

package/dist/cjs/powql.js

@@ -73,7 +73,7 @@ exports.PowqlInterface = exports.MAX_POWQL_DATETIME_TERMS = void 0;
 const node_crypto_1 = require("node:crypto");
 const errors_js_1 = require("./errors.js");
 const nested_write_js_1 = require("./nested-write.js");
-const powdb_js_1 = require("./powdb.js");
+const powdb_shared_js_1 = require("./powdb-shared.js");
 const aggregates_js_1 = require("./query/aggregates.js");
 const compound_unique_js_1 = require("./query/compound-unique.js");
 const filters_js_1 = require("./query/filters.js");
@@ -225,7 +225,7 @@ class PowqlInterface {
         this.options = options;
         const meta = schema.tables[table];
         if (!meta) {
-            throw new errors_js_1.ValidationError(`[turbine] Unknown table "${table}". ${(0, utils_js_1.availableClause)(Object.keys(schema.tables), 'The schema has no tables.')}`);
+            throw new errors_js_1.ValidationError(`Unknown table "${table}". ${(0, utils_js_1.availableClause)(Object.keys(schema.tables), 'The schema has no tables.')}`);
         }
         this.meta = meta;
         this.defaultLimit = options.defaultLimit;
@@ -258,7 +258,7 @@ class PowqlInterface {
         const snake = resolved ?? (0, utils_js_1.ownLookup)(this.meta.columnMap, field) ?? field;
         const col = this.meta.columns.find((c) => c.name === snake || c.field === field);
         if (!col) {
-            throw new errors_js_1.ValidationError(`[turbine] Unknown column "${field}" on table "${this.table}". Known: ${this.meta.columns
+            throw new errors_js_1.ValidationError(`Unknown column "${field}" on table "${this.table}". Known: ${this.meta.columns
                 .map((c) => c.field)
                 .join(', ')}`);
         }
@@ -325,7 +325,7 @@ class PowqlInterface {
      * included, so no existing schema sees a different statement.
      */
     colRefName(name, alias) {
-        return alias ? `${alias}.${(0, powdb_js_1.quotePowqlIdent)(name)}` : `.${(0, powdb_js_1.quotePowqlDotted)(name)}`;
+        return alias ? `${alias}.${(0, powdb_shared_js_1.quotePowqlIdent)(name)}` : `.${(0, powdb_shared_js_1.quotePowqlDotted)(name)}`;
     }
     /**
      * Push a value into the param array and return its `$N` placeholder. When the
@@ -339,13 +339,13 @@ class PowqlInterface {
         let tagged = value;
         if (col && typeof value === 'number' && this.isFloatCol(col)) {
             // Float column: force a float-form literal even for an integer value.
-            tagged = new powdb_js_1.PowdbFloatParam(value);
+            tagged = new powdb_shared_js_1.PowdbFloatParam(value);
         }
-        else if (col && value !== null && typeof value === 'object' && !(value instanceof Date) && (0, powdb_js_1.isJsonColumn)(col)) {
+        else if (col && value !== null && typeof value === 'object' && !(value instanceof Date) && (0, powdb_shared_js_1.isJsonColumn)(col)) {
             // json document column: a JS object/array is serialized to canonical JSON
             // text and stored as a json document (a JS string passes through raw, same
             // contract as pg jsonb; `null` stays `null`).
-            tagged = new powdb_js_1.PowdbJsonParam(value, col.name);
+            tagged = new powdb_shared_js_1.PowdbJsonParam(value, col.name);
         }
         params.push(tagged);
         return `$${params.length}`;
@@ -362,13 +362,13 @@ class PowqlInterface {
      */
     writeRef(value, col, params) {
         if (typeof value === 'number' && !Number.isFinite(value) && this.isFloatCol(col)) {
-            throw new errors_js_1.ValidationError(`[turbine] Non-finite value for float column "${col.name}" on "${this.table}".`);
+            throw new errors_js_1.ValidationError(`Non-finite value for float column "${col.name}" on "${this.table}".`);
         }
         return this.param(value, params, col);
     }
     isFloatCol(col) {
         try {
-            return (0, powdb_js_1.powqlColumnType)(col) === 'float';
+            return (0, powdb_shared_js_1.powqlColumnType)(col) === 'float';
         }
         catch {
             return false;
@@ -381,7 +381,7 @@ class PowqlInterface {
      * default so a hand-built test pool never crashes the version gates.
      */
     get capabilities() {
-        return this.pool.capabilities ?? powdb_js_1.ALL_POWDB_CAPABILITIES;
+        return this.pool.capabilities ?? powdb_shared_js_1.ALL_POWDB_CAPABILITIES;
     }
     /**
      * The `limit` a query actually emits: the explicit `limit`, then the
@@ -488,7 +488,7 @@ class PowqlInterface {
             ['offset', offset],
         ]) {
             if (value !== undefined && value !== null && value < 0) {
-                throw new errors_js_1.ValidationError(`[turbine] ${context} on "${this.table}": \`${name}\` must not be negative (got ${value}).`);
+                throw new errors_js_1.ValidationError(`${context} on "${this.table}": \`${name}\` must not be negative (got ${value}).`);
             }
         }
     }
@@ -538,7 +538,7 @@ class PowqlInterface {
                 // Relation filters are pre-resolved to scalar in/notIn by
                 // resolveRelationFilters() before buildWhere runs, reaching here means
                 // a caller skipped that step (an internal bug, not user error).
-                throw new errors_js_1.ValidationError(`[turbine] internal: relation filter "${key}" reached buildWhere unresolved (missing resolveRelationFilters()).`);
+                throw new errors_js_1.ValidationError(`internal: relation filter "${key}" reached buildWhere unresolved (missing resolveRelationFilters()).`);
             }
             else {
                 // A JsonFilter (or a bare `{ path }`) can compile to zero clauses; skip
@@ -581,9 +581,9 @@ class PowqlInterface {
      * read through `introspectPowdbDatabase`, or hand-written metadata.
      */
     assertDatetimePredicateSupported(col) {
-        if (!(0, powdb_js_1.isPowdbDatetimeColumn)(col))
+        if (!(0, powdb_shared_js_1.isPowdbDatetimeColumn)(col))
             return;
-        (0, powdb_js_1.requireCapability)(this.capabilities, 'datetimeCompare', `comparisons on the PowDB datetime column "${col.name}"`, 'Reading that column is unaffected, and so are ordering, grouping and `is null` checks; only comparing it ' +
+        (0, powdb_shared_js_1.requireCapability)(this.capabilities, 'datetimeCompare', `comparisons on the PowDB datetime column "${col.name}"`, 'Reading that column is unaffected, and so are ordering, grouping and `is null` checks; only comparing it ' +
             'against a bound timestamp needs the fix. A nested `with` (the default nested-projection / join paths) ' +
             'correlates column to column, so it loads the relation without any such comparison.');
     }
@@ -602,8 +602,8 @@ class PowqlInterface {
         // path filters (≥ 0.12). `isJsonFilter` matches `path`/`equals`/`contains`/
         // `hasKey`; on a NON-json column those fall through to the scalar operator
         // path below (e.g. `equals` stays a plain equality), exactly like SQL.
-        if ((0, powdb_js_1.isJsonColumn)(colMeta) && (0, filters_js_1.isJsonFilter)(value)) {
-            (0, powdb_js_1.requireCapability)(this.capabilities, 'jsonDocs', 'JSON path filters');
+        if ((0, powdb_shared_js_1.isJsonColumn)(colMeta) && (0, filters_js_1.isJsonFilter)(value)) {
+            (0, powdb_shared_js_1.requireCapability)(this.capabilities, 'jsonDocs', 'JSON path filters');
             return this.buildJsonPathCondition(colMeta, value, params, alias);
         }
         rejectUnsupportedFilter(op, field);
@@ -668,7 +668,7 @@ class PowqlInterface {
                     conds.push(`${lhs} like ${this.bindLike(`%${(0, utils_js_1.escapeLike)(String(opVal))}`, params, insensitive)}`);
                     break;
                 default:
-                    throw new errors_js_1.ValidationError(`[turbine] Unsupported operator "${opName}" on PowDB.`);
+                    throw new errors_js_1.ValidationError(`Unsupported operator "${opName}" on PowDB.`);
             }
         }
         return conds.length > 1 ? `(${conds.join(' and ')})` : (conds[0] ?? this.alwaysFalse());
@@ -756,14 +756,14 @@ class PowqlInterface {
             if (v === undefined)
                 continue;
             if (filter.path === undefined) {
-                throw new errors_js_1.ValidationError(`[turbine] JSON range operator '${op}' on ${col.name} requires a \`path\` ` +
+                throw new errors_js_1.ValidationError(`JSON range operator '${op}' on ${col.name} requires a \`path\` ` +
                     `(e.g. { path: ['meta', 'score'], ${op}: ${JSON.stringify(v)} }).`);
             }
             if (typeof v !== 'number' && typeof v !== 'string') {
-                throw new errors_js_1.ValidationError(`[turbine] JSON range operator '${op}' on ${col.name} requires a number or string, got ${JSON.stringify(v)}.`);
+                throw new errors_js_1.ValidationError(`JSON range operator '${op}' on ${col.name} requires a number or string, got ${JSON.stringify(v)}.`);
             }
             if (typeof v === 'number' && !Number.isFinite(v)) {
-                throw new errors_js_1.ValidationError(`[turbine] JSON range operator '${op}' on ${col.name} requires a finite number.`);
+                throw new errors_js_1.ValidationError(`JSON range operator '${op}' on ${col.name} requires a finite number.`);
             }
             conds.push(`${pathP()} ${powOp} ${this.param(v, params)}`);
         }
@@ -779,7 +779,7 @@ class PowqlInterface {
         // generator bug rather than a user error, and must not silently widen the
         // query the way it used to.
         if (!conds.length) {
-            throw new errors_js_1.ValidationError(`[turbine] internal: JSON filter on "${col.name}" compiled to no condition. This is a bug in turbine-orm.`);
+            throw new errors_js_1.ValidationError(`internal: JSON filter on "${col.name}" compiled to no condition. This is a bug in turbine-orm.`);
         }
         return conds.length > 1 ? `(${conds.join(' and ')})` : conds[0];
     }
@@ -805,7 +805,7 @@ class PowqlInterface {
             // missing-value row to match `notIn []`, so NO presence guard is appended here).
             return negate ? '(1 = 1)' : this.alwaysFalse();
         }
-        if (col && (0, powdb_js_1.isPowdbDatetimeColumn)(col))
+        if (col && (0, powdb_shared_js_1.isPowdbDatetimeColumn)(col))
             return this.buildDatetimeInList(lhs, values, params, negate, col);
         const items = values.map((v) => this.bind(v, params, insensitive)).join(', ');
         if (negate) {
@@ -871,7 +871,7 @@ class PowqlInterface {
      * identically however the statement was assembled.
      */
     inClause(ref, values, params, col) {
-        if (col && (0, powdb_js_1.isPowdbDatetimeColumn)(col)) {
+        if (col && (0, powdb_shared_js_1.isPowdbDatetimeColumn)(col)) {
             this.assertDatetimePredicateSupported(col);
             return this.buildDatetimeInList(ref, values, params, false, col);
         }
@@ -885,7 +885,7 @@ class PowqlInterface {
      */
     keyChunkSize(meta, colName) {
         const col = meta?.columns.find((c) => c.name === colName);
-        return col && (0, powdb_js_1.isPowdbDatetimeColumn)(col) ? exports.MAX_POWQL_DATETIME_TERMS : MAX_RELATION_KEYS;
+        return col && (0, powdb_shared_js_1.isPowdbDatetimeColumn)(col) ? exports.MAX_POWQL_DATETIME_TERMS : MAX_RELATION_KEYS;
     }
     /**
      * Pre-resolve every relation filter (`some`/`none`/`every`) in a where clause
@@ -945,7 +945,7 @@ class PowqlInterface {
         }
         const targetMeta = this.schema.tables[rel.to];
         if (!targetMeta)
-            throw new errors_js_1.ValidationError(`[turbine] Relation "${rel.name}" targets unknown table "${rel.to}".`);
+            throw new errors_js_1.ValidationError(`Relation "${rel.name}" targets unknown table "${rel.to}".`);
         // hasMany/hasOne: localKey = our referenceKey, collect the child's foreignKey.
         // belongsTo:      localKey = our foreignKey,   collect the target's referenceKey.
         const localCol = rel.type === 'belongsTo' ? fk[0] : rk[0];
@@ -974,13 +974,13 @@ class PowqlInterface {
     async resolveManyToManyCondition(rel, mode, innerWhere, innerEmpty, timeout) {
         const through = rel.through;
         if (!through)
-            throw new errors_js_1.ValidationError(`[turbine] manyToMany relation "${rel.name}" is missing its junction (\`through\`).`);
+            throw new errors_js_1.ValidationError(`manyToMany relation "${rel.name}" is missing its junction (\`through\`).`);
         const sourceJ = (0, schema_js_1.normalizeKeyColumns)(through.sourceKey);
         const targetJ = (0, schema_js_1.normalizeKeyColumns)(through.targetKey);
         const sourceRef = (0, schema_js_1.normalizeKeyColumns)(rel.referenceKey);
         const targetMeta = this.schema.tables[rel.to];
         if (!targetMeta)
-            throw new errors_js_1.ValidationError(`[turbine] Relation "${rel.name}" targets unknown table "${rel.to}".`);
+            throw new errors_js_1.ValidationError(`Relation "${rel.name}" targets unknown table "${rel.to}".`);
         if (sourceJ.length > 1 || targetJ.length > 1 || sourceRef.length > 1 || targetMeta.primaryKey.length > 1) {
             throw new errors_js_1.UnsupportedFeatureError('composite-key manyToMany filters', 'PowDB', `relation "${rel.name}", PowQL has no tuple-\`in\` for composite junction/target keys`);
         }
@@ -1012,7 +1012,7 @@ class PowqlInterface {
                 const chunk = targetPks.slice(i, i + junctionChunk);
                 const params = [];
                 const keyClause = this.inClause(this.colRefName(targetJCol), chunk, params, targetJColMeta);
-                const { rows } = await this.exec(`${(0, powdb_js_1.quotePowqlIdent)(through.table)} filter ${keyClause} { ${this.colRefName(sourceJCol)} }`, params, timeout, 'findMany');
+                const { rows } = await this.exec(`${(0, powdb_shared_js_1.quotePowqlIdent)(through.table)} filter ${keyClause} { ${this.colRefName(sourceJCol)} }`, params, timeout, 'findMany');
                 for (const r of rows) {
                     const v = r[sourceJCol];
                     if (v != null)
@@ -1289,10 +1289,10 @@ class PowqlInterface {
     /** Compile one {@link JsonPathOrderBy} entry to `order .col->$n asc` (+ optional numeric cast). */
     buildJsonPathOrder(field, spec, params, alias) {
         const col = this.column(field);
-        if (!(0, powdb_js_1.isJsonColumn)(col)) {
+        if (!(0, powdb_shared_js_1.isJsonColumn)(col)) {
             throw new errors_js_1.UnsupportedFeatureError('JSON-path ordering', 'PowDB', `field "${field}" is not a json column`);
         }
-        (0, powdb_js_1.requireCapability)(this.capabilities, 'jsonDocs', 'JSON path ordering');
+        (0, powdb_shared_js_1.requireCapability)(this.capabilities, 'jsonDocs', 'JSON path ordering');
         if (spec.nulls === 'first') {
             throw new errors_js_1.UnsupportedFeatureError('NULLS FIRST placement', 'PowDB', `field "${field}": PowDB orders missing / JSON-null keys LAST in both directions`);
         }
@@ -1318,9 +1318,9 @@ class PowqlInterface {
     }
     /** Build the E018 refusal for a write / `begin` on a read-only pool. */
     readOnlyError(operation) {
-        // Pass a clean detail: the ReadOnlyError constructor owns both the
-        // `[turbine] ` prefix and the "Route writes to a writable primary." hint,
-        // so adding either here would double them.
+        // Pass a clean detail: the ReadOnlyError constructor owns the "Route writes
+        // to a writable primary." hint, so adding it here would double it. The
+        // `[TURBINE_E018]` tag is added once, later, by formatErrorMessage.
         return new errors_js_1.ReadOnlyError(`${operation} on "${this.table}" refused: this PowDB connection is read-only.`);
     }
     /**
@@ -1382,7 +1382,7 @@ class PowqlInterface {
             return false;
         if (!POWQL_READ_ACTIONS.has(action))
             return false;
-        return (0, powdb_js_1.isStaleFramePowdbError)(err);
+        return (0, powdb_shared_js_1.isStaleFramePowdbError)(err);
     }
     emit(action, sql, params, duration, rows, error) {
         if (!this.onQuery)
@@ -1428,7 +1428,7 @@ class PowqlInterface {
      * coerces its string cells correctly. Defaults to the pool capability for the
      * rare caller with no per-result flag (hand-built test pools). */
     shape(rows, native = Boolean(this.capabilities.nativeRaw)) {
-        return rows.map((r) => (0, powdb_js_1.rowToEntity)(r, this.meta, native));
+        return rows.map((r) => (0, powdb_shared_js_1.rowToEntity)(r, this.meta, native));
     }
     // -------------------------------------------------------------------------
     // Reads
@@ -1556,7 +1556,7 @@ class PowqlInterface {
             // Aliased scan: every parent column keys itself (`col: t0.col`) so the
             // result columns keep their bare snake names, then the nested blocks.
             const aliasCtr = { n: 1 };
-            const parts = cols.map((c) => `${(0, powdb_js_1.quotePowqlIdent)(c)}: t0.${(0, powdb_js_1.quotePowqlIdent)(c)}`);
+            const parts = cols.map((c) => `${(0, powdb_shared_js_1.quotePowqlIdent)(c)}: t0.${(0, powdb_shared_js_1.quotePowqlIdent)(c)}`);
             for (const plan of nestedPlans) {
                 parts.push(await this.buildNestedBlock(plan, 't0', aliasCtr, params, args.timeout));
             }
@@ -1687,7 +1687,7 @@ class PowqlInterface {
      */
     async loadRelations(parents, withClause, timeout, depth = 0, parent, includePii = false) {
         if (depth >= 10) {
-            throw new errors_js_1.ValidationError(`[turbine] Nested 'with' on PowDB exceeded depth 10 (relation cycle?).`);
+            throw new errors_js_1.ValidationError(`Nested 'with' on PowDB exceeded depth 10 (relation cycle?).`);
         }
         if (!parents.length)
             return;
@@ -1702,7 +1702,7 @@ class PowqlInterface {
                 continue;
             const rel = this.meta.relations[relName];
             if (!rel)
-                throw new errors_js_1.ValidationError(`[turbine] Unknown relation "${relName}" on "${this.table}".`);
+                throw new errors_js_1.ValidationError(`Unknown relation "${relName}" on "${this.table}".`);
             if (strategyIsJoin && parent && this.joinEligible(rel, opt, parent.args, parents.length)) {
                 if (this.capabilities.serverJoins) {
                     await this.loadRelationViaJoin(parents, rel, relName, opt, parent, timeout, includePii);
@@ -1713,7 +1713,7 @@ class PowqlInterface {
                 // E017; a CLIENT-LEVEL default silently falls back to the keyed loaders
                 // (so pointing an existing app at an older engine keeps working).
                 if (parent.args.relationLoadStrategy === 'join') {
-                    (0, powdb_js_1.requireCapability)(this.capabilities, 'serverJoins', 'native PowQL relation joins');
+                    (0, powdb_shared_js_1.requireCapability)(this.capabilities, 'serverJoins', 'native PowQL relation joins');
                 }
             }
             if (rel.type === 'manyToMany') {
@@ -1829,13 +1829,13 @@ class PowqlInterface {
     async loadManyToMany(parents, rel, relName, opt, timeout, includePii = false) {
         const through = rel.through;
         if (!through)
-            throw new errors_js_1.ValidationError(`[turbine] manyToMany relation "${relName}" is missing its junction (\`through\`).`);
+            throw new errors_js_1.ValidationError(`manyToMany relation "${relName}" is missing its junction (\`through\`).`);
         const sourceJ = (0, schema_js_1.normalizeKeyColumns)(through.sourceKey);
         const targetJ = (0, schema_js_1.normalizeKeyColumns)(through.targetKey);
         const sourceRef = (0, schema_js_1.normalizeKeyColumns)(rel.referenceKey);
         const targetMeta = this.schema.tables[rel.to];
         if (!targetMeta)
-            throw new errors_js_1.ValidationError(`[turbine] Relation "${relName}" targets unknown table "${rel.to}".`);
+            throw new errors_js_1.ValidationError(`Relation "${relName}" targets unknown table "${rel.to}".`);
         if (sourceJ.length > 1 || targetJ.length > 1 || sourceRef.length > 1 || targetMeta.primaryKey.length > 1) {
             throw new errors_js_1.UnsupportedFeatureError('composite-key manyToMany', 'PowDB', `relation "${relName}", PowQL has no tuple-\`in\`, so composite junction/target keys can't be loaded`);
         }
@@ -1864,7 +1864,7 @@ class PowqlInterface {
             const chunk = parentKeys.slice(i, i + junctionChunk);
             const params = [];
             const keyClause = this.inClause(this.colRefName(sourceJCol), chunk, params, sourceJColMeta);
-            const powql = `${(0, powdb_js_1.quotePowqlIdent)(through.table)} filter ${keyClause} ` +
+            const powql = `${(0, powdb_shared_js_1.quotePowqlIdent)(through.table)} filter ${keyClause} ` +
                 `{ ${this.colRefName(sourceJCol)}, ${this.colRefName(targetJCol)} }`;
             const { rows } = await this.exec(powql, params, timeout, 'findMany');
             for (const row of rows) {
@@ -2069,7 +2069,7 @@ class PowqlInterface {
         const options = (opt === true ? {} : opt);
         const targetMeta = this.schema.tables[rel.to];
         if (!targetMeta)
-            throw new errors_js_1.ValidationError(`[turbine] Relation "${relName}" targets unknown table "${rel.to}".`);
+            throw new errors_js_1.ValidationError(`Relation "${relName}" targets unknown table "${rel.to}".`);
         const targetQi = new PowqlInterface(this.pool, rel.to, this.schema, [], this.options);
         const fk = (0, schema_js_1.normalizeKeyColumns)(rel.foreignKey);
         const rk = (0, schema_js_1.normalizeKeyColumns)(rel.referenceKey);
@@ -2087,9 +2087,9 @@ class PowqlInterface {
         this.assertPagination(options.limit, options.offset, `relation "${relName}"`);
         const limitClause = options.limit !== undefined ? ` limit ${this.param(options.limit, params)}` : '';
         const offsetClause = options.offset ? ` offset ${this.param(options.offset, params)}` : '';
-        const proj = this.joinProjection(childCols, `p.${(0, powdb_js_1.quotePowqlIdent)(parentKeyCol)}`, 'c');
+        const proj = this.joinProjection(childCols, `p.${(0, powdb_shared_js_1.quotePowqlIdent)(parentKeyCol)}`, 'c');
         const powql = `${targetQi.qt} as c join ${this.qt} as p ` +
-            `on c.${(0, powdb_js_1.quotePowqlIdent)(childKeyCol)} = p.${(0, powdb_js_1.quotePowqlIdent)(parentKeyCol)}` +
+            `on c.${(0, powdb_shared_js_1.quotePowqlIdent)(childKeyCol)} = p.${(0, powdb_shared_js_1.quotePowqlIdent)(parentKeyCol)}` +
             `${filter}${order}${limitClause}${offsetClause} ${proj}`;
         // A READ: thread a read-shaped action through the exec seam.
         const { rows, native } = await targetQi.exec(powql, params, timeout, 'findMany');
@@ -2109,11 +2109,11 @@ class PowqlInterface {
     async loadManyToManyViaJoin(parents, rel, relName, opt, parent, timeout, includePii = false) {
         const through = rel.through;
         if (!through)
-            throw new errors_js_1.ValidationError(`[turbine] manyToMany relation "${relName}" is missing its junction (\`through\`).`);
+            throw new errors_js_1.ValidationError(`manyToMany relation "${relName}" is missing its junction (\`through\`).`);
         const options = (opt === true ? {} : opt);
         const targetMeta = this.schema.tables[rel.to];
         if (!targetMeta)
-            throw new errors_js_1.ValidationError(`[turbine] Relation "${relName}" targets unknown table "${rel.to}".`);
+            throw new errors_js_1.ValidationError(`Relation "${relName}" targets unknown table "${rel.to}".`);
         const targetQi = new PowqlInterface(this.pool, rel.to, this.schema, [], this.options);
         const sourceJCol = (0, schema_js_1.normalizeKeyColumns)(through.sourceKey)[0];
         const targetJCol = (0, schema_js_1.normalizeKeyColumns)(through.targetKey)[0];
@@ -2123,10 +2123,10 @@ class PowqlInterface {
         const params = [];
         const { cols: childCols, forcedPk: childForcedPk } = this.joinChildCols(targetQi, options, includePii);
         const filter = await this.joinFilter(targetQi, parent.resolvedWhere, options.where, 't', params, options.timeout ?? timeout);
-        const proj = this.joinProjection(childCols, `j.${(0, powdb_js_1.quotePowqlIdent)(sourceJCol)}`, 't');
+        const proj = this.joinProjection(childCols, `j.${(0, powdb_shared_js_1.quotePowqlIdent)(sourceJCol)}`, 't');
         const powql = `${targetQi.qt} as t ` +
-            `join ${(0, powdb_js_1.quotePowqlIdent)(through.table)} as j on t.${(0, powdb_js_1.quotePowqlIdent)(targetPkCol)} = j.${(0, powdb_js_1.quotePowqlIdent)(targetJCol)} ` +
-            `join ${this.qt} as p on j.${(0, powdb_js_1.quotePowqlIdent)(sourceJCol)} = p.${(0, powdb_js_1.quotePowqlIdent)(sourceRefCol)}` +
+            `join ${(0, powdb_shared_js_1.quotePowqlIdent)(through.table)} as j on t.${(0, powdb_shared_js_1.quotePowqlIdent)(targetPkCol)} = j.${(0, powdb_shared_js_1.quotePowqlIdent)(targetJCol)} ` +
+            `join ${this.qt} as p on j.${(0, powdb_shared_js_1.quotePowqlIdent)(sourceJCol)} = p.${(0, powdb_shared_js_1.quotePowqlIdent)(sourceRefCol)}` +
             `${filter} ${proj}`;
         const { rows, native } = await targetQi.exec(powql, params, timeout, 'findMany');
         const byKey = this.bucketByTpk(targetQi, rows, native, childForcedPk);
@@ -2143,7 +2143,7 @@ class PowqlInterface {
     joinChildCols(targetQi, options, includePii = false) {
         const plan = targetQi.projectionPlan(options.select, options.omit, includePii);
         if (plan.cols.includes('__tpk')) {
-            throw new errors_js_1.ValidationError(`[turbine] relation target "${targetQi.table}" has a column named "__tpk", which collides with the reserved ` +
+            throw new errors_js_1.ValidationError(`relation target "${targetQi.table}" has a column named "__tpk", which collides with the reserved ` +
                 `join correlation alias. Rename the column or load this relation with relationLoadStrategy: 'batched'.`);
         }
         return plan;
@@ -2156,7 +2156,7 @@ class PowqlInterface {
     joinProjection(childCols, tpkExpr, childAlias) {
         const parts = [
             `__tpk: ${tpkExpr}`,
-            ...childCols.map((c) => `${(0, powdb_js_1.quotePowqlIdent)(c)}: ${childAlias}.${(0, powdb_js_1.quotePowqlIdent)(c)}`),
+            ...childCols.map((c) => `${(0, powdb_shared_js_1.quotePowqlIdent)(c)}: ${childAlias}.${(0, powdb_shared_js_1.quotePowqlIdent)(c)}`),
         ];
         return `{ ${parts.join(', ')} }`;
     }
@@ -2278,7 +2278,7 @@ class PowqlInterface {
         const { cols, forcedPk } = targetQi.projectionPlan(options.select, options.omit, includePii);
         const byName = new Map(targetQi.meta.columns.map((c) => [c.name, c]));
         for (const c of cols) {
-            const ts = (byName.get(c)?.tsType ?? '').replace(/\s*\|\s*null$/i, '').trim();
+            const ts = (0, powdb_shared_js_1.baseTsType)(byName.get(c)?.tsType ?? '');
             if (ts === 'bigint' || ts === 'Uint8Array')
                 return null;
         }
@@ -2326,7 +2326,7 @@ class PowqlInterface {
         // Exactly one equi-correlation predicate (the 0.18 correlation rule); the
         // child where chains behind it as a parenthesized `and` group, which the
         // grammar accepts even when the group itself contains `or`.
-        const correlation = `${alias}.${(0, powdb_js_1.quotePowqlIdent)(childKeyCol)} = ${parentAlias}.${(0, powdb_js_1.quotePowqlIdent)(parentKeyCol)}`;
+        const correlation = `${alias}.${(0, powdb_shared_js_1.quotePowqlIdent)(childKeyCol)} = ${parentAlias}.${(0, powdb_shared_js_1.quotePowqlIdent)(parentKeyCol)}`;
         const resolved = await targetQi.resolveRelationFilters(options.where, timeout);
         const childWhere = targetQi.buildWhere(resolved, params, alias);
         const filter = childWhere ? `${correlation} and (${childWhere})` : correlation;
@@ -2337,11 +2337,11 @@ class PowqlInterface {
                 ? ` limit ${this.param(options.limit, params)}`
                 : '';
         const offsetClause = !single && options.offset ? ` offset ${this.param(options.offset, params)}` : '';
-        const parts = plan.cols.map((c) => `${(0, powdb_js_1.quotePowqlIdent)(c)}: ${alias}.${(0, powdb_js_1.quotePowqlIdent)(c)}`);
+        const parts = plan.cols.map((c) => `${(0, powdb_shared_js_1.quotePowqlIdent)(c)}: ${alias}.${(0, powdb_shared_js_1.quotePowqlIdent)(c)}`);
         for (const child of plan.children) {
             parts.push(await targetQi.buildNestedBlock(child, alias, aliasCtr, params, timeout));
         }
-        return (`${(0, powdb_js_1.quotePowqlIdent)(relName)}: ${targetQi.qt} as ${alias} ` +
+        return (`${(0, powdb_shared_js_1.quotePowqlIdent)(relName)}: ${targetQi.qt} as ${alias} ` +
             `filter ${filter}${order}${limitClause}${offsetClause} { ${parts.join(', ')} }`);
     }
     /**
@@ -2370,7 +2370,7 @@ class PowqlInterface {
             }
         }
         const items = Array.isArray(value) ? value : [];
-        const shaped = items.map((o) => (0, powdb_js_1.rowToEntity)(o, plan.targetQi.meta, true));
+        const shaped = items.map((o) => (0, powdb_shared_js_1.rowToEntity)(o, plan.targetQi.meta, true));
         for (const child of shaped) {
             for (const sub of plan.children)
                 plan.targetQi.attachOneNested(child, sub);
@@ -2415,7 +2415,7 @@ class PowqlInterface {
     }
     /** True when `name` is a bare PowQL identifier (quoting leaves it unchanged). */
     isBareIdent(name) {
-        return (0, powdb_js_1.quotePowqlIdent)(name) === name;
+        return (0, powdb_shared_js_1.quotePowqlIdent)(name) === name;
     }
     /**
      * Find the declared to-one link on THIS table that matches `rel` exactly: same
@@ -2485,7 +2485,7 @@ class PowqlInterface {
         // at least one projected child column is bigint/bytes. Otherwise nested
         // projections already handle it (and cache), so leave it to them.
         const hasCarrierBlockedCol = userCols.some((c) => {
-            const ts = (byName.get(c)?.tsType ?? '').replace(/\s*\|\s*null$/i, '').trim();
+            const ts = (0, powdb_shared_js_1.baseTsType)(byName.get(c)?.tsType ?? '');
             return ts === 'bigint' || ts === 'Uint8Array';
         });
         if (!hasCarrierBlockedCol)
@@ -2530,8 +2530,8 @@ class PowqlInterface {
      * parse exactly like their bare forms and yield the same result-column names.
      */
     linkPathFields(plan, parentAlias) {
-        const link = (0, powdb_js_1.quotePowqlDotted)(plan.linkName);
-        return plan.cols.map((c) => `${(0, powdb_js_1.quotePowqlIdent)(`${plan.keyPrefix}${c}`)}: ${parentAlias}.${link}.${(0, powdb_js_1.quotePowqlDotted)(c)}`);
+        const link = (0, powdb_shared_js_1.quotePowqlDotted)(plan.linkName);
+        return plan.cols.map((c) => `${(0, powdb_shared_js_1.quotePowqlIdent)(`${plan.keyPrefix}${c}`)}: ${parentAlias}.${link}.${(0, powdb_shared_js_1.quotePowqlDotted)(c)}`);
     }
     /**
      * Reconstruct each link-path relation's child entity from its flat hop fields
@@ -2553,7 +2553,7 @@ class PowqlInterface {
                     raw[c] = row[`${plan.keyPrefix}${c}`];
                     delete row[`${plan.keyPrefix}${c}`];
                 }
-                const child = (0, powdb_js_1.rowToEntity)(raw, plan.targetQi.meta, native);
+                const child = (0, powdb_shared_js_1.rowToEntity)(raw, plan.targetQi.meta, native);
                 if (child[pkField] == null) {
                     row[plan.relName] = null;
                     continue;
@@ -2610,7 +2610,7 @@ class PowqlInterface {
      * statement; plain `this.table` stays in error messages.
      */
     get qt() {
-        return (0, powdb_js_1.quotePowqlIdent)(this.table);
+        return (0, powdb_shared_js_1.quotePowqlIdent)(this.table);
     }
     async create(args) {
         return this.withMiddleware('create', args, async () => {
@@ -2621,7 +2621,7 @@ class PowqlInterface {
             const assigns = this.scalarData(data);
             const params = [];
             const body = assigns
-                .map((a) => `${(0, powdb_js_1.quotePowqlIdent)(a.col.name)} := ${this.writeRef(a.value, a.col, params)}`)
+                .map((a) => `${(0, powdb_shared_js_1.quotePowqlIdent)(a.col.name)} := ${this.writeRef(a.value, a.col, params)}`)
                 .join(', ');
             // `returning` surfaces the inserted row (all columns, schema order) in one round-trip.
             const { rows, native } = await this.exec(`insert ${this.qt} { ${body} } returning`, params, args.timeout, 'create');
@@ -2669,7 +2669,7 @@ class PowqlInterface {
                 parts.push(`does not supply ${quoteList(missing)}`);
             if (unexpected.length > 0)
                 parts.push(`supplies ${quoteList(unexpected)}, which the first row does not`);
-            throw new errors_js_1.ValidationError(`[turbine] createMany on "${this.table}": row ${i} ${parts.join(' and ')}. ` +
+            throw new errors_js_1.ValidationError(`createMany on "${this.table}": row ${i} ${parts.join(' and ')}. ` +
                 'Every row must supply the same fields (a field set to `undefined` counts as omitted, exactly as it does ' +
                 'in `create`). PowQL itself would insert the ragged rows, but the SQL engines build ONE statement whose ' +
                 "column list comes from the first row, so there a later row's extra field is dropped and a field it " +
@@ -2691,7 +2691,7 @@ class PowqlInterface {
             const params = [];
             const tuples = inputs.map((d) => {
                 const assigns = this.scalarData(d);
-                return `{ ${assigns.map((a) => `${(0, powdb_js_1.quotePowqlIdent)(a.col.name)} := ${this.writeRef(a.value, a.col, params)}`).join(', ')} }`;
+                return `{ ${assigns.map((a) => `${(0, powdb_shared_js_1.quotePowqlIdent)(a.col.name)} := ${this.writeRef(a.value, a.col, params)}`).join(', ')} }`;
             });
             // Multi-row insert with `returning` hands back every inserted row in one round-trip.
             const { rows, native } = await this.exec(`insert ${this.qt} ${tuples.join(', ')} returning`, params, args.timeout, 'createMany');
@@ -2721,7 +2721,7 @@ class PowqlInterface {
             // by a caller who believed they held the lock.
             const lock = args.optimisticLock;
             if (lock) {
-                const versionCol = (0, powdb_js_1.quotePowqlIdent)(this.column(lock.field).name);
+                const versionCol = (0, powdb_shared_js_1.quotePowqlIdent)(this.column(lock.field).name);
                 setClause += `, ${versionCol} := ${this.ref(lock.field)} + 1`;
                 params.push(lock.expected);
                 const check = `${this.ref(lock.field)} = $${params.length}`;
@@ -2767,7 +2767,7 @@ class PowqlInterface {
             }
             const colMeta = this.column(field);
             const ref = this.ref(field);
-            const col = (0, powdb_js_1.quotePowqlIdent)(colMeta.name);
+            const col = (0, powdb_shared_js_1.quotePowqlIdent)(colMeta.name);
             if (value !== null && typeof value === 'object' && !(value instanceof Date)) {
                 const opObj = value;
                 if ('set' in opObj)
@@ -2781,14 +2781,14 @@ class PowqlInterface {
                 else if ('divide' in opObj)
                     parts.push(`${col} := ${ref} / ${this.writeRef(opObj.divide, colMeta, params)}`);
                 else
-                    throw new errors_js_1.ValidationError(`[turbine] Unsupported update operator on "${field}".`);
+                    throw new errors_js_1.ValidationError(`Unsupported update operator on "${field}".`);
             }
             else {
                 parts.push(`${col} := ${this.writeRef(value, colMeta, params)}`);
             }
         }
         if (!parts.length)
-            throw new errors_js_1.ValidationError(`[turbine] update on "${this.table}" has no fields to set.`);
+            throw new errors_js_1.ValidationError(`update on "${this.table}" has no fields to set.`);
         return parts.join(', ');
     }
     // -------------------------------------------------------------------------
@@ -2918,7 +2918,7 @@ class PowqlInterface {
             }
             const params = [];
             const createBody = this.scalarData(createData)
-                .map((a) => `${(0, powdb_js_1.quotePowqlIdent)(a.col.name)} := ${this.writeRef(a.value, a.col, params)}`)
+                .map((a) => `${(0, powdb_shared_js_1.quotePowqlIdent)(a.col.name)} := ${this.writeRef(a.value, a.col, params)}`)
                 .join(', ');
             const updateBody = this.buildUpdateAssignments(args.update, params);
             // PowDB 0.7.0's `upsert` statement does NOT accept a trailing `returning`
@@ -2950,7 +2950,7 @@ class PowqlInterface {
             return { field, value: createData[field] ?? createData[pk] };
         });
         if (pkPairs.some((p) => p.value == null)) {
-            throw new errors_js_1.ValidationError(`[turbine] upsert on "${this.table}" needs every composite-PK field in \`create\` (${pkPairs
+            throw new errors_js_1.ValidationError(`upsert on "${this.table}" needs every composite-PK field in \`create\` (${pkPairs
                 .map((p) => p.field)
                 .join(', ')}).`);
         }
@@ -3003,7 +3003,7 @@ class PowqlInterface {
         const col = this.column(field);
         if (!col.nullable)
             return;
-        (0, powdb_js_1.requireCapability)(this.capabilities, 'projectedCountNonNull', `per-field \`_count\` of the nullable column "${col.name}"`, 'Below that version the engine ignored the column projection and returned the ROW count, which differs from ' +
+        (0, powdb_shared_js_1.requireCapability)(this.capabilities, 'projectedCountNonNull', `per-field \`_count\` of the nullable column "${col.name}"`, 'Below that version the engine ignored the column projection and returned the ROW count, which differs from ' +
             'every SQL engine exactly when the column is nullable. `_count: true` (a row count) and a per-field ' +
             '`_count` of a NOT NULL column are correct on every version and are never refused.');
     }
@@ -3068,7 +3068,7 @@ class PowqlInterface {
                     return spec !== undefined && Object.values(spec).some((v) => v != null && typeof v === 'object');
                 });
             if (usesJson) {
-                (0, powdb_js_1.requireCapability)(this.capabilities, 'jsonDocs', 'JSON-path groupBy keys / aggregate targets');
+                (0, powdb_shared_js_1.requireCapability)(this.capabilities, 'jsonDocs', 'JSON-path groupBy keys / aggregate targets');
             }
             // `emitNative` decides whether the query GENERATION needs the legacy-wire
             // `json_type` discriminator (pool-level capability). The DECODE side reads
@@ -3086,7 +3086,7 @@ class PowqlInterface {
             const usedKeys = new Set();
             const claim = (key, what) => {
                 if (key === '_count' || usedKeys.has(key)) {
-                    throw new errors_js_1.ValidationError(`[turbine] groupBy output name "${key}" (${what}) collides with another output column on table ` +
+                    throw new errors_js_1.ValidationError(`groupBy output name "${key}" (${what}) collides with another output column on table ` +
                         `"${this.table}": set an explicit \`alias\` (or rename the aggregate key) to disambiguate.`);
                 }
                 usedKeys.add(key);
@@ -3116,8 +3116,8 @@ class PowqlInterface {
                 }
                 else {
                     const col = this.column(entry.field);
-                    if (!(0, powdb_js_1.isJsonColumn)(col)) {
-                        throw new errors_js_1.ValidationError(`[turbine] groupBy JSON group key on "${entry.field}" (table "${this.table}") requires a json column.`);
+                    if (!(0, powdb_shared_js_1.isJsonColumn)(col)) {
+                        throw new errors_js_1.ValidationError(`groupBy JSON group key on "${entry.field}" (table "${this.table}") requires a json column.`);
                     }
                     (0, aggregates_js_1.assertAggregatePiiOptIn)(this.table, this.meta, entry.field, col.name, 'groupBy JSON `by` key', (0, types_js_1.resolveUnsafeFlag)(args.includePii, 'includePii'));
                     this.assertJsonPath('group key', entry.field, entry.path);
@@ -3222,8 +3222,8 @@ class PowqlInterface {
                     }
                     else {
                         const col = this.column(target.field);
-                        if (!(0, powdb_js_1.isJsonColumn)(col)) {
-                            throw new errors_js_1.ValidationError(`[turbine] groupBy ${fn} target "${key}" on "${target.field}" (table "${this.table}") requires a json column.`);
+                        if (!(0, powdb_shared_js_1.isJsonColumn)(col)) {
+                            throw new errors_js_1.ValidationError(`groupBy ${fn} target "${key}" on "${target.field}" (table "${this.table}") requires a json column.`);
                         }
                         if (fn === '_min' || fn === '_max') {
                             (0, aggregates_js_1.assertAggregatePiiOptIn)(this.table, this.meta, target.field, col.name, `groupBy ${fn} JSON target`, (0, types_js_1.resolveUnsafeFlag)(args.includePii, 'includePii'));
@@ -3231,7 +3231,7 @@ class PowqlInterface {
                         this.assertJsonPath(`${fn} target "${key}"`, target.field, target.path);
                         const alwaysNumeric = fn === '_sum' || fn === '_avg';
                         if (alwaysNumeric && target.type === 'text') {
-                            throw new errors_js_1.ValidationError(`[turbine] groupBy ${fn} target "${key}" on table "${this.table}": ` +
+                            throw new errors_js_1.ValidationError(`groupBy ${fn} target "${key}" on table "${this.table}": ` +
                                 `${fn} over a JSON path is always numeric: remove \`type: 'text'\`.`);
                         }
                         const numeric = alwaysNumeric || target.type === 'numeric';
@@ -3270,7 +3270,7 @@ class PowqlInterface {
                     if (r.kind === 'plain') {
                         const cell = raw[r.rowKey];
                         out[r.resultKey] = resultNative
-                            ? (0, powdb_js_1.coerceNativeValue)(cell, r.col)
+                            ? (0, powdb_shared_js_1.coerceNativeValue)(cell, r.col)
                             : typeof cell === 'string'
                                 ? coerceScalar(cell, r.col.tsType)
                                 : cell;
@@ -3299,7 +3299,7 @@ class PowqlInterface {
         if (!Array.isArray(path) ||
             path.length === 0 ||
             path.some((el) => typeof el !== 'string' && !(typeof el === 'number' && Number.isFinite(el)))) {
-            throw new errors_js_1.ValidationError(`[turbine] groupBy ${context} on "${field}" (table "${this.table}") requires a non-empty \`path\` ` +
+            throw new errors_js_1.ValidationError(`groupBy ${context} on "${field}" (table "${this.table}") requires a non-empty \`path\` ` +
                 `array of keys/indexes (e.g. { field: '${field}', path: ['category'] }).`);
         }
     }
@@ -3351,7 +3351,7 @@ class PowqlInterface {
                     // must come from the fixed allowlist, never from the caller's key.
                     const fn = POWQL_HAVING_AGG_FNS.get(aggKey);
                     if (!fn) {
-                        throw new errors_js_1.ValidationError(`[turbine] Unknown aggregate "${aggKey}" in having for field "${key}" on table "${this.table}". ` +
+                        throw new errors_js_1.ValidationError(`Unknown aggregate "${aggKey}" in having for field "${key}" on table "${this.table}". ` +
                             `Supported: ${[...POWQL_HAVING_AGG_FNS.keys()].join(', ')}.`);
                     }
                     const inner = this.lookupGroupKey(aggInner, key) ?? this.ref(key);
@@ -3389,14 +3389,14 @@ class PowqlInterface {
                 if (key === '_count') {
                     const expr = aggOrderExprs.get('_count');
                     if (!expr) {
-                        throw new errors_js_1.ValidationError(`[turbine] Cannot order groupBy by "_count" on table "${this.table}": _count is not selected. ` +
+                        throw new errors_js_1.ValidationError(`Cannot order groupBy by "_count" on table "${this.table}": _count is not selected. ` +
                             `Orderable keys: ${validKeys()}.`);
                     }
                     parts.push(`${expr} ${this.groupOrderDir(value, '_count')}`);
                     continue;
                 }
                 if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-                    throw new errors_js_1.ValidationError(`[turbine] Invalid groupBy orderBy for "${key}" on table "${this.table}": ` +
+                    throw new errors_js_1.ValidationError(`Invalid groupBy orderBy for "${key}" on table "${this.table}": ` +
                         `expected a field map like { ${key}: { amount: 'desc' } }.`);
                 }
                 for (const [field, dirSpec] of Object.entries(value)) {
@@ -3406,7 +3406,7 @@ class PowqlInterface {
                     // the registry is keyed by the canonical one.
                     const expr = aggOrderExprs.get(`${key}:${field}`) ?? this.aggOrderExpr(aggOrderExprs, key, field);
                     if (!expr) {
-                        throw new errors_js_1.ValidationError(`[turbine] Cannot order groupBy by "${key}.${field}" on table "${this.table}": ` +
+                        throw new errors_js_1.ValidationError(`Cannot order groupBy by "${key}.${field}" on table "${this.table}": ` +
                             `that aggregate is not requested in this call. Orderable keys: ${validKeys()}.`);
                     }
                     parts.push(`${expr} ${this.groupOrderDir(dirSpec, `${key}.${field}`)}`);
@@ -3415,7 +3415,7 @@ class PowqlInterface {
             }
             const expr = this.lookupGroupKey(byOrderExprs, key);
             if (!expr) {
-                throw new errors_js_1.ValidationError(`[turbine] Unknown field "${key}" in groupBy orderBy on table "${this.table}". Orderable keys: ${validKeys()}.`);
+                throw new errors_js_1.ValidationError(`Unknown field "${key}" in groupBy orderBy on table "${this.table}". Orderable keys: ${validKeys()}.`);
             }
             parts.push(`${expr} ${this.groupOrderDir(value, key)}`);
         }
@@ -3505,7 +3505,7 @@ class PowqlInterface {
             return;
         if (compiledWhere.length > 0)
             return;
-        throw new errors_js_1.ValidationError(`[turbine] ${action} on "${this.table}" refused: the \`where\` clause is empty. ` +
+        throw new errors_js_1.ValidationError(`${action} on "${this.table}" refused: the \`where\` clause is empty. ` +
             "Pass `allowFullTableScan: UNSAFE` to opt in (import { UNSAFE } from 'turbine-orm'), " +
             'or check that your filter values are defined.');
     }
@@ -3513,7 +3513,7 @@ class PowqlInterface {
 exports.PowqlInterface = PowqlInterface;
 /** Coerce a group-key scalar string by the column's TS type (numbers/bools). */
 function coerceScalar(raw, tsType) {
-    const ts = tsType.replace(/\s*\|\s*null$/i, '').trim();
+    const ts = (0, powdb_shared_js_1.baseTsType)(tsType);
     if (raw === 'null')
         return null;
     if (ts === 'number' || ts === 'bigint') {