@noy-db/hub 0.3.0-pre.8 → 0.3.0-pre.9

package/dist/{chunk-6Z435B6N.js → chunk-7HAPHVRJ.js}

@@ -1,21 +1,18 @@
 import {
   reducerBuilder
-} from "./chunk-5GQE5IDB.js";
+} from "./chunk-2XE6LIXT.js";
 import {
   evaluateClause,
   hasFnClause,
-  moneyRuntime,
   readPath
-} from "./chunk-6P5AJ2ZS.js";
-import {
-  applyI18nLocale
-} from "./chunk-BASCPHNM.js";
+} from "./chunk-KCG3BHFG.js";
 import {
   CrossJoinSourceUnknownError,
   CrossJoinTooLargeError,
   DanglingReferenceError,
+  FieldNotQueryableError,
   JoinTooLargeError
-} from "./chunk-OJ64XMPJ.js";
+} from "./chunk-CU62BBRB.js";
 
 // src/kernel/query/join.ts
 var DEFAULT_JOIN_MAX_ROWS = 5e4;
@@ -109,26 +106,26 @@ function applyOneJoin(leftRows, leg, context, locale) {
     warnCeilingApproaching(leg.target, "right", rightSnapshot.length, maxRows);
   }
   const effLocale = locale ?? context.defaultLocale;
-  const i18nResolve = effLocale !== void 0 && source.i18nFields !== void 0 ? (right) => right !== null && typeof right === "object" ? applyI18nLocale(right, source.i18nFields, effLocale, void 0, "join") : right : void 0;
+  const presentResolve = effLocale !== void 0 && source.presentForJoin !== void 0 ? (right) => right !== null && typeof right === "object" ? source.presentForJoin(right, effLocale) : right : void 0;
   const strategy = leg.strategy ?? (source.lookupById ? "nested" : "hash");
   if (strategy === "nested" && source.lookupById) {
     const lookup = (id) => source.lookupById?.(id);
-    return nestedLoopJoin(leftRows, leg, lookup, i18nResolve);
+    return nestedLoopJoin(leftRows, leg, lookup, presentResolve);
   }
-  return hashJoin(leftRows, leg, rightSnapshot, i18nResolve);
+  return hashJoin(leftRows, leg, rightSnapshot, presentResolve);
 }
-function nestedLoopJoin(leftRows, leg, lookupById, i18nResolve) {
+function nestedLoopJoin(leftRows, leg, lookupById, presentResolve) {
   const out = [];
   for (const left of leftRows) {
     const rawId = readPath(left, leg.field);
     const key = coerceRefKey(rawId);
     let right = key === null ? void 0 : lookupById(key);
-    if (i18nResolve && right !== void 0) right = i18nResolve(right);
+    if (presentResolve && right !== void 0) right = presentResolve(right);
     out.push(attachJoin(left, leg, right, rawId));
   }
   return out;
 }
-function hashJoin(leftRows, leg, rightSnapshot, i18nResolve) {
+function hashJoin(leftRows, leg, rightSnapshot, presentResolve) {
   const rightMap = /* @__PURE__ */ new Map();
   for (const record of rightSnapshot) {
     const rawId = readPath(record, "id");
@@ -142,7 +139,7 @@ function hashJoin(leftRows, leg, rightSnapshot, i18nResolve) {
     const rawId = readPath(left, leg.field);
     const key = coerceRefKey(rawId);
     let right = key === null ? void 0 : rightMap.get(key);
-    if (i18nResolve && right !== void 0) right = i18nResolve(right);
+    if (presentResolve && right !== void 0) right = presentResolve(right);
     out.push(attachJoin(left, leg, right, rawId));
   }
   return out;
@@ -396,10 +393,28 @@ var Query = class _Query {
    * quantized into stored scaled-int space at build time and evaluated
    * BigInt-exact per record. A malformed operand or a string operator
    * (`contains`/`startsWith`) throws here, at the call site.
+   *
+   * Consults the Via pipeline's posture before building a clause (#629
+   * Task 8): a field whose posture is `queryable: 'none'` (e.g. a
+   * `blobFields` slot) throws `FieldNotQueryableError` here, at the call
+   * site. Every other posture is unaffected — the existing per-binding
+   * `buildClause` machinery runs exactly as before.
    */
   where(field, op, value) {
-    const desc = this.source.moneyFields?.[field];
-    const clause = desc ? moneyRuntime().moneyFieldClause(field, op, value, desc) : { type: "field", field, op, value };
+    const via = this.source.via;
+    if (via?.postureFor(field)?.queryable === "none") throw new FieldNotQueryableError(field);
+    const viaClause = via?.buildClause(field, op, value);
+    const clause = viaClause ? {
+      type: "field",
+      field,
+      op,
+      value,
+      via: {
+        brand: viaClause.brand,
+        payload: viaClause.payload,
+        evaluate: (actual, evalOp) => via.evaluateClause(viaClause, actual, evalOp)
+      }
+    } : { type: "field", field, op, value };
     return new _Query(
       this.source,
       { ...this.plan, clauses: [...this.plan.clauses, clause] },
@@ -469,8 +484,13 @@ var Query = class _Query {
    * Sort by a field. Subsequent calls are tie-breakers. Pass
    * `{ by: 'label' }` to sort a `dictKey`/`staticDict` field by its resolved
    * label at the query locale instead of the stored code.
+   *
+   * Consults the Via pipeline's posture (#629 Task 8): a field whose posture
+   * is `queryable: 'none'` throws `FieldNotQueryableError` here, at the call
+   * site — same gate as `where()`.
    */
   orderBy(field, direction = "asc", opts) {
+    if (this.source.via?.postureFor(field)?.queryable === "none") throw new FieldNotQueryableError(field);
     const entry = opts?.by === "label" ? { field, direction, by: "label" } : { field, direction };
     return new _Query(
       this.source,
@@ -684,7 +704,7 @@ var Query = class _Query {
    * (Left/base i18n fields are resolved by `get`/`list`, not here.)
    */
   toArray(opts) {
-    const base = this.decodeMoney(executePlanWithSource(this.source, this.plan, this.joinContext, opts?.locale));
+    const base = this.decodeVia(executePlanWithSource(this.source, this.plan, this.joinContext, opts?.locale));
     if (this.plan.joins.length === 0) return base;
     if (!this.joinContext) {
       throw new Error(
@@ -694,21 +714,23 @@ var Query = class _Query {
     return applyJoins(base, this.plan.joins, this.joinContext, opts?.locale);
   }
   /**
-   * Decode this source's money fields on read (stored scaled-int → canonical
-   * decimal), so `query().toArray()` agrees with `get()`/`sum()` on the value.
-   * No-op when the source declares no money fields.
+   * Decode this source's Via-covered fields on read (e.g. money: stored
+   * scaled-int → canonical decimal), so `query().toArray()` agrees with
+   * `get()`/`sum()` on the value. No-op when the source's Via pipeline
+   * declares no result decode.
    *
-   * The query layer carries no locale context, so we decode with `'raw'` —
-   * canonical decimal, WITHOUT fabricating locale-formatted `<field>Formatted`
-   * / `<field>Number` virtuals. Producing a guessed-locale string here would
-   * reintroduce a "two read paths disagree" failure on the virtual
-   * field (e.g. it-IT via `get()` vs en-US here). Consumers who need formatted
-   * money read through `get()`/`list()` with a locale.
+   * The query layer carries no locale context, so money decodes with
+   * `'raw'` — canonical decimal, WITHOUT fabricating locale-formatted
+   * `<field>Formatted` / `<field>Number` virtuals. Producing a
+   * guessed-locale string here would reintroduce a "two read paths
+   * disagree" failure on the virtual field (e.g. it-IT via `get()` vs
+   * en-US here). Consumers who need formatted money read through
+   * `get()`/`list()` with a locale.
    */
-  decodeMoney(records) {
-    const moneyFields = this.source.moneyFields;
-    if (!moneyFields || Object.keys(moneyFields).length === 0) return records;
-    return records.map((r) => moneyRuntime().decodeMoneyFields(r, moneyFields, "raw"));
+  decodeVia(records) {
+    const via = this.source.via;
+    if (!via || !via.hasResultDecode) return records;
+    return records.map((r) => via.decodeResults(r));
   }
   /** Return the first matching record, or null. Joins are applied. `opts.locale` resolves joined i18n fields. */
   first(opts) {
@@ -739,10 +761,7 @@ var Query = class _Query {
   }
   aggregate(specOrBuild) {
     let spec = typeof specOrBuild === "function" ? specOrBuild(reducerBuilder) : specOrBuild;
-    const moneyFields = this.source.moneyFields;
-    if (moneyFields) {
-      spec = moneyRuntime().wrapMoneyReducers(spec, moneyFields);
-    }
+    spec = this.source.via?.wrapReducers(spec) ?? spec;
     const source = this.source;
     const clauses = this.plan.clauses;
     const joinCtx = this.joinContext;
@@ -791,14 +810,14 @@ var Query = class _Query {
         field,
         upstreams,
         dictLabelResolver,
-        this.source.moneyFields
+        this.source.via
       );
     }
     return this.aggregateStrategy.groupByN(
       executeRecords,
       fields,
       upstreams,
-      this.source.moneyFields
+      this.source.via
     );
   }
   /**
@@ -931,8 +950,8 @@ function executePlanWithSource(source, plan, joinContext, locale) {
     result = remainingClauses.length === 0 ? [...candidates] : filterRecords(candidates, remainingClauses, fnViewDecoder(source));
   }
   if (plan.orderBy.length > 0) {
-    const labelMaps = buildOrderLabelMaps(plan.orderBy, joinContext, locale);
-    result = sortRecords(result, plan.orderBy, source.moneyFields, labelMaps);
+    const labelMaps = buildOrderLabelMaps(plan.orderBy, joinContext, locale, source.via);
+    result = sortRecords(result, plan.orderBy, source.via, labelMaps);
   }
   if (plan.offset > 0) {
     result = result.slice(plan.offset);
@@ -952,7 +971,7 @@ function candidateRecords(source, clauses) {
     const clause = clauses[i];
     if (clause.type !== "field") continue;
     if (!indexes.has(clause.field)) continue;
-    if (clause.money?.mode === "multi") continue;
+    if (clause.via) continue;
     let ids = null;
     if (clause.op === "==") {
       ids = indexes.lookupEqual(clause.field, clause.value);
@@ -999,9 +1018,9 @@ function executePlan(records, plan) {
   return result;
 }
 function fnViewDecoder(source) {
-  const mf = source.moneyFields;
-  if (!mf || Object.keys(mf).length === 0) return void 0;
-  return (r) => moneyRuntime().decodeMoneyFields(r, mf, "raw");
+  const via = source.via;
+  if (!via || !via.hasResultDecode) return void 0;
+  return (r) => via.decodeResults(r);
 }
 function filterRecords(records, clauses, decodeForFns) {
   if (clauses.length === 0) return [...records];
@@ -1089,55 +1108,55 @@ function applyCrossJoin(leftRel, clause, rightSource) {
   }
   return expanded;
 }
-function sortRecords(records, orderBy, moneyFields, labelMaps) {
+function sortRecords(records, orderBy, via, labelMaps) {
   return [...records].sort((a, b) => {
     for (const { field, direction, by } of orderBy) {
       let av = readField(a, field);
       let bv = readField(b, field);
-      const labelMap = by === "label" ? labelMaps?.get(field) : void 0;
-      if (labelMap) {
-        av = (typeof av === "string" ? labelMap.get(av) : void 0) ?? av;
-        bv = (typeof bv === "string" ? labelMap.get(bv) : void 0) ?? bv;
+      const labelResolver = by === "label" ? labelMaps?.get(field) : void 0;
+      if (labelResolver) {
+        av = (typeof av === "string" ? labelResolver(av) : void 0) ?? av;
+        bv = (typeof bv === "string" ? labelResolver(bv) : void 0) ?? bv;
         const cmp2 = compareValues(av, bv);
         if (cmp2 !== 0) return direction === "asc" ? cmp2 : -cmp2;
         continue;
       }
-      const desc = moneyFields?.[field];
-      const cmp = desc ? compareMoney(av, bv, desc) : compareValues(av, bv);
+      const viaCmp = via?.compareForOrder(field, av, bv);
+      const cmp = viaCmp !== void 0 ? viaCmp : compareValues(av, bv);
       if (cmp !== 0) return direction === "asc" ? cmp : -cmp;
     }
     return 0;
   });
 }
-function buildOrderLabelMaps(orderBy, joinContext, locale) {
-  if (!joinContext?.resolveDictSource) return void 0;
-  const resolveDict = joinContext.resolveDictSource.bind(joinContext);
+function buildOrderLabelMaps(orderBy, joinContext, locale, via) {
   let maps;
   for (const { field, by } of orderBy) {
     if (by !== "label") continue;
-    const dictSource = resolveDict(field);
-    if (!dictSource) continue;
-    const loc = locale ?? dictSource.displayLocale;
-    if (loc === void 0) continue;
-    const codeToLabel = /* @__PURE__ */ new Map();
-    for (const entry of dictSource.snapshot()) {
-      const k = entry["key"];
-      const labels = entry["labels"];
-      const label = labels?.[loc];
-      if (typeof k === "string" && typeof label === "string") codeToLabel.set(k, label);
+    const dictSource = joinContext?.resolveDictSource?.(field);
+    if (dictSource) {
+      const loc = locale ?? dictSource.displayLocale;
+      if (loc === void 0) continue;
+      const codeToLabel = /* @__PURE__ */ new Map();
+      for (const entry of dictSource.snapshot()) {
+        const k = entry["key"];
+        const labels = entry["labels"];
+        const label = labels?.[loc];
+        if (typeof k === "string" && typeof label === "string") codeToLabel.set(k, label);
+      }
+      ;
+      (maps ??= /* @__PURE__ */ new Map()).set(field, (code) => codeToLabel.get(code));
+      continue;
+    }
+    if (via) {
+      const cache = /* @__PURE__ */ new Map();
+      (maps ??= /* @__PURE__ */ new Map()).set(field, (code) => {
+        if (!cache.has(code)) cache.set(code, via.resolveOrderLabel(field, code, locale));
+        return cache.get(code);
+      });
     }
-    ;
-    (maps ??= /* @__PURE__ */ new Map()).set(field, codeToLabel);
   }
   return maps;
 }
-function compareMoney(a, b, desc) {
-  const av = moneyRuntime().moneyScaledValue(a, desc);
-  const bv = moneyRuntime().moneyScaledValue(b, desc);
-  if (av === null) return bv === null ? 0 : 1;
-  if (bv === null) return -1;
-  return av < bv ? -1 : av > bv ? 1 : 0;
-}
 function readField(record, field) {
   if (record === null || record === void 0) return void 0;
   if (!field.includes(".")) {
@@ -1279,28 +1298,30 @@ var ScanBuilder = class _ScanBuilder {
    */
   joinContext;
   /**
-   * Money field descriptors for the backing collection. When present, yielded
-   * records are decoded (stored scaled-int → canonical decimal) so `scan()`
-   * agrees with `get()`/`list()`/`query().toArray()`. Decoded with
-   * `'raw'` (canonical decimal, no locale-formatted virtuals) since the scan
-   * stream carries no locale context, mirroring `Query.toArray()`.
+   * The backing collection's compiled Via pipeline (money now; more Via
+   * features later). When it declares a result decode, yielded records
+   * are decoded (e.g. money: stored scaled-int → canonical decimal) so
+   * `scan()` agrees with `get()`/`list()`/`query().toArray()`. Decoded
+   * with `'raw'` (canonical decimal, no locale-formatted virtuals) since
+   * the scan stream carries no locale context, mirroring `Query.toArray()`.
    */
-  moneyFields;
-  constructor(pageProvider, pageSize = DEFAULT_SCAN_PAGE_SIZE, clauses = [], joins = [], joinContext, moneyFields) {
+  via;
+  constructor(pageProvider, pageSize = DEFAULT_SCAN_PAGE_SIZE, clauses = [], joins = [], joinContext, via) {
     this.pageProvider = pageProvider;
     this.pageSize = pageSize;
     this.clauses = clauses;
     this.joins = joins;
     this.joinContext = joinContext;
-    this.moneyFields = moneyFields;
+    this.via = via;
   }
   /**
-   * Decode this scan's money fields on a record (stored scaled-int → canonical
-   * decimal). No-op when no money fields are declared. See {@link moneyFields}.
+   * Decode this scan's Via-covered fields on a record (e.g. money: stored
+   * scaled-int → canonical decimal). No-op when the Via pipeline declares
+   * no result decode. See {@link via}.
    */
-  decodeMoney(record) {
-    if (!this.moneyFields || Object.keys(this.moneyFields).length === 0) return record;
-    return moneyRuntime().decodeMoneyFields(record, this.moneyFields, "raw");
+  decodeVia(record) {
+    if (!this.via || !this.via.hasResultDecode) return record;
+    return this.via.decodeResults(record);
   }
   /**
    * Add a field comparison. Runs per record as the scan stream
@@ -1314,17 +1335,34 @@ var ScanBuilder = class _ScanBuilder {
    * the in-memory cache where indexes live. Index-accelerated scans
    * are a future optimization — the current implementation
    * evaluates clauses per record in O(1) per clause.
+   *
+   * Consults the Via pipeline's posture before building a clause (#629
+   * Task 8): a field whose posture is `queryable: 'none'` throws
+   * `FieldNotQueryableError` here, at the call site — same gate as
+   * `Query.where()`.
    */
   where(field, op, value) {
-    const desc = this.moneyFields?.[field];
-    const clause = desc ? moneyRuntime().moneyFieldClause(field, op, value, desc) : { type: "field", field, op, value };
+    const via = this.via;
+    if (via?.postureFor(field)?.queryable === "none") throw new FieldNotQueryableError(field);
+    const viaClause = via?.buildClause(field, op, value);
+    const clause = viaClause ? {
+      type: "field",
+      field,
+      op,
+      value,
+      via: {
+        brand: viaClause.brand,
+        payload: viaClause.payload,
+        evaluate: (actual, evalOp) => via.evaluateClause(viaClause, actual, evalOp)
+      }
+    } : { type: "field", field, op, value };
     return new _ScanBuilder(
       this.pageProvider,
       this.pageSize,
       [...this.clauses, clause],
       this.joins,
       this.joinContext,
-      this.moneyFields
+      this.via
     );
   }
   /**
@@ -1344,7 +1382,7 @@ var ScanBuilder = class _ScanBuilder {
       [...this.clauses, clause],
       this.joins,
       this.joinContext,
-      this.moneyFields
+      this.via
     );
   }
   /**
@@ -1456,7 +1494,7 @@ var ScanBuilder = class _ScanBuilder {
       this.clauses,
       [...this.joins, leg],
       this.joinContext,
-      this.moneyFields
+      this.via
     );
   }
   /**
@@ -1473,7 +1511,7 @@ var ScanBuilder = class _ScanBuilder {
     while (true) {
       for (const record of page.items) {
         if (!this.recordMatches(record)) continue;
-        const decoded = this.decodeMoney(record);
+        const decoded = this.decodeVia(record);
         if (joinResolvers === null) {
           yield decoded;
         } else {
@@ -1603,6 +1641,7 @@ var ScanBuilder = class _ScanBuilder {
   }
   async aggregate(specOrBuild) {
     const spec = typeof specOrBuild === "function" ? specOrBuild(reducerBuilder) : specOrBuild;
+    this.via?.refuseUnqueryableReducers(spec);
     const keys = Object.keys(spec);
     const state = {};
     for (const key of keys) {
@@ -1628,7 +1667,7 @@ var ScanBuilder = class _ScanBuilder {
    */
   recordMatches(record) {
     if (this.clauses.length === 0) return true;
-    const fnView = this.moneyFields && Object.keys(this.moneyFields).length > 0 && hasFnClause(this.clauses) ? this.decodeMoney(record) : void 0;
+    const fnView = this.via?.hasResultDecode && hasFnClause(this.clauses) ? this.decodeVia(record) : void 0;
     for (const clause of this.clauses) {
       if (!evaluateClause(record, clause, fnView)) return false;
     }
@@ -1653,4 +1692,4 @@ export {
   executePlan,
   ScanBuilder
 };
-//# sourceMappingURL=chunk-6Z435B6N.js.map
+//# sourceMappingURL=chunk-7HAPHVRJ.js.map