@palbase/backend 30.0.1 → 33.0.0

package/dist/db/index.cjs

@@ -777,9 +777,48 @@ var ColumnBuilder = class _ColumnBuilder {
   * A transform is a PROJECTION, never a constraint: it lives only in this
   * process, so it can neither validate nor migrate what is stored.
   */
+  /**
+  * Surface this exact-precision column as a JS `number` (FR-001).
+  *
+  * `numeric`/`bigint` arrive as strings because a JS number cannot hold their
+  * full range — correct, and exactly why this exists: application code that
+  * does arithmetic on the column otherwise rewrites the same `Number(row.x)` /
+  * `String(v)` pair in every caller, and each rewrite is a place the two
+  * directions can drift apart.
+  */
+  asNumber() {
+    return this.withCodec("number", "asNumber");
+  }
+  /**
+  * Surface this exact-precision column as a `string` — the value Postgres
+  * sent, DECLARED rather than defaulted (FR-001).
+  */
+  asDecimal() {
+    return this.withCodec("decimal", "asDecimal");
+  }
+  withCodec(codec, method) {
+    if (this._def.type !== "bigint" && this._def.type !== "numeric") {
+      throw new Error(`${this._def.type} column: .${method}() is only available on bigint()/numeric() \u2014 those are the exact-precision types that surface as string.`);
+    }
+    if (this._def.transform !== void 0) {
+      throw new Error(`.${method}() and .transform() are two ways to say the same thing on one column \u2014 keep .${method}().`);
+    }
+    if (this._def.codec !== void 0) {
+      throw new Error(`column already declares .as${this._def.codec === "number" ? "Number" : "Decimal"}(); a column has ONE codec.`);
+    }
+    return new _ColumnBuilder(this._def.type, {
+      ...this._def,
+      codec
+    });
+  }
   transform(fns) {
-    this._def.transform = fns;
-    return new _ColumnBuilder(this._def.type, this._def);
+    if (this._def.codec !== void 0) {
+      throw new Error(`column already declares a named codec; .transform() and .as*() are two ways to say the same thing \u2014 keep the codec.`);
+    }
+    return new _ColumnBuilder(this._def.type, {
+      ...this._def,
+      transform: fns
+    });
   }
 };
 function uuid() {