@noy-db/hub 0.3.0-pre.10 → 0.3.0-pre.11

package/dist/chunk-KNZB6JMR.js

@@ -1,129 +0,0 @@
-import {
-  ValidationError
-} from "./chunk-S7VFUQM2.js";
-
-// src/with-formula/derivations/with-derivation.ts
-function withDerivation(spec) {
-  if (!spec.source || spec.source.length === 0) {
-    throw new ValidationError("withDerivation: source collection name is required");
-  }
-  if (!spec.outputs || Object.keys(spec.outputs).length === 0) {
-    throw new ValidationError("withDerivation: outputs map must declare at least one output");
-  }
-  if (spec.deterministic !== true) {
-    throw new ValidationError("withDerivation: v1 only supports deterministic derivations");
-  }
-  if (typeof spec.derive !== "function") {
-    throw new ValidationError("withDerivation: derive must be a function");
-  }
-  if (spec.sources !== void 0) {
-    for (const extra of spec.sources) {
-      if (typeof extra !== "string" || extra.length === 0) {
-        throw new ValidationError("withDerivation: each entry in sources[] must be a non-empty string");
-      }
-      if (extra === spec.source) {
-        throw new ValidationError(
-          `withDerivation: sources[] must not contain the primary source "${spec.source}"`
-        );
-      }
-    }
-  }
-  if (spec.triggerBy !== void 0) {
-    for (const t of spec.triggerBy) {
-      if (typeof t?.collection !== "string" || t.collection.length === 0) {
-        throw new ValidationError("withDerivation: each triggerBy entry needs a non-empty `collection`");
-      }
-      if (t.collection === spec.source) {
-        throw new ValidationError(
-          `withDerivation: triggerBy.collection must not equal the source "${spec.source}" (use sources[] for same-id triggers)`
-        );
-      }
-      if (typeof t.on !== "string" || t.on.length === 0) {
-        throw new ValidationError(
-          `withDerivation: triggerBy on "${t.collection}" needs a non-empty \`on\` (the FK field on the source)`
-        );
-      }
-      if (t.maxFanout !== void 0 && (!Number.isInteger(t.maxFanout) || t.maxFanout < 1)) {
-        throw new ValidationError(
-          `withDerivation: triggerBy maxFanout on "${t.collection}" must be a positive integer (got ${String(t.maxFanout)}).`
-        );
-      }
-    }
-  }
-  const lifecycleMode = typeof spec.lifecycle === "string" ? spec.lifecycle : spec.lifecycle.mode;
-  for (const [outputKey, outputSpec] of Object.entries(spec.outputs)) {
-    if (outputSpec.shape === "record" && outputSpec.collection === spec.source) {
-      if (!outputSpec.denorm || outputSpec.denorm.length === 0) {
-        throw new ValidationError(
-          `withDerivation: self-write output "${outputKey}" (collection === source "${spec.source}") must declare \`denorm: [...]\` naming the fields it maintains.`
-        );
-      }
-    }
-    if (outputSpec.shape === "array") {
-      if (lifecycleMode !== "eager") {
-        throw new ValidationError(
-          `withDerivation: shape 'array' supports lifecycle 'eager' only in this release Output "${outputKey}" declared lifecycle '${lifecycleMode}'. Switch to \`lifecycle: "eager"\` or use shape: "record".`
-        );
-      }
-      if (typeof outputSpec.key !== "function") {
-        throw new ValidationError(
-          `withDerivation: shape 'array' output "${outputKey}" requires \`key: (out) => string\`.`
-        );
-      }
-      if (outputSpec.maxFanout !== void 0) {
-        if (!Number.isInteger(outputSpec.maxFanout) || outputSpec.maxFanout < 1) {
-          throw new ValidationError(
-            `withDerivation: maxFanout for output "${outputKey}" must be a positive integer (got ${String(outputSpec.maxFanout)}).`
-          );
-        }
-      }
-    }
-  }
-  return {
-    __noydb_strategy: "derivation",
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    spec
-  };
-}
-
-// src/with-formula/derivations/with-rollup.ts
-function withRollup(config) {
-  const { from, key, into, field, compute } = config;
-  if (!from || from.length === 0) {
-    throw new ValidationError("withRollup: `from` (child collection) is required");
-  }
-  if (!into || into.length === 0) {
-    throw new ValidationError("withRollup: `into` (parent collection) is required");
-  }
-  if (from === into) {
-    throw new ValidationError("withRollup: `from` and `into` must be different collections");
-  }
-  if (!key || key.length === 0) {
-    throw new ValidationError("withRollup: `key` (FK field on the child) is required");
-  }
-  if (!field || field.length === 0) {
-    throw new ValidationError("withRollup: `field` (target field on the parent) is required");
-  }
-  if (typeof compute !== "function") {
-    throw new ValidationError("withRollup: `compute` must be a function");
-  }
-  const spec = {
-    source: into,
-    // the parent record is what carries the rolled-up field
-    deterministic: true,
-    rollup: { from, key, field, compute },
-    // Synthetic self-write output for registry / cycle bookkeeping. Dispatch
-    // patches `field` directly (value-equality guarded); the executor is not run.
-    outputs: { value: { shape: "record", collection: into, denorm: [field] } },
-    derive: () => ({ value: {} }),
-    // never invoked for a rollup strategy
-    lifecycle: "eager"
-  };
-  return { __noydb_strategy: "derivation", spec };
-}
-
-export {
-  withDerivation,
-  withRollup
-};
-//# sourceMappingURL=chunk-KNZB6JMR.js.map

package/dist/chunk-LEJIKBBB.js

@@ -1,124 +0,0 @@
-import {
-  DerivationCapExceededError,
-  DerivationOutputShapeError
-} from "./chunk-S7VFUQM2.js";
-
-// src/with-formula/derivations/executor.ts
-var DerivationExecutor = {
-  /**
-   * Run `derive` once, validate output shape against the spec, stamp
-   * `_derivedFrom` onto every output. Returns per-output success or
-   * failure; throws only for shape mismatches (a contract violation).
-   */
-  async run(strategy, source, sourceVersion, strategyHash, ctx) {
-    const outputs = {};
-    let derived;
-    try {
-      derived = await Promise.resolve(strategy.derive(source, ctx));
-    } catch (err) {
-      for (const key of Object.keys(strategy.outputs)) {
-        outputs[key] = {
-          kind: "failed",
-          value: {},
-          ok: false,
-          error: err instanceof Error ? err : new Error(String(err))
-        };
-      }
-      return { outputs, failed: true };
-    }
-    const meta = {
-      source: strategy.source,
-      sourceId: source.id,
-      sourceVersion,
-      derivedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      strategyHash
-    };
-    for (const key of Object.keys(strategy.outputs)) {
-      const outSpec = strategy.outputs[key];
-      if (!outSpec) continue;
-      const value = derived[key];
-      if (outSpec.shape === "array") {
-        if (value === void 0 || value === null) {
-          outputs[key] = { kind: "array", ok: true, entries: [] };
-          continue;
-        }
-        if (!Array.isArray(value)) {
-          throw new DerivationOutputShapeError(
-            key,
-            `shape 'array' expects an array, got ${typeof value}`
-          );
-        }
-        const maxFanout = outSpec.maxFanout ?? 64;
-        if (value.length > maxFanout) {
-          throw new DerivationCapExceededError(key, value.length, maxFanout);
-        }
-        const entries = [];
-        const seenKeys = /* @__PURE__ */ new Set();
-        for (let i = 0; i < value.length; i++) {
-          const row = value[i];
-          if (row === null || typeof row !== "object") {
-            throw new DerivationOutputShapeError(
-              key,
-              `array member at index ${i} must be a non-null object (got ${row === null ? "null" : typeof row})`
-            );
-          }
-          let derivedKey;
-          try {
-            derivedKey = outSpec.key(row);
-          } catch (err) {
-            throw new DerivationOutputShapeError(
-              key,
-              `key extractor threw on array member at index ${i}: ` + (err instanceof Error ? err.message : String(err))
-            );
-          }
-          if (typeof derivedKey !== "string" || derivedKey.length === 0) {
-            throw new DerivationOutputShapeError(
-              key,
-              `key extractor returned ${typeof derivedKey === "string" ? "empty string" : typeof derivedKey} at index ${i}; expected non-empty string`
-            );
-          }
-          if (seenKeys.has(derivedKey)) {
-            throw new DerivationOutputShapeError(
-              key,
-              `duplicate key "${derivedKey}" in array output (index ${i}); each derived row must have a unique key within a single derive() invocation`
-            );
-          }
-          seenKeys.add(derivedKey);
-          entries.push({
-            key: derivedKey,
-            value: { ...row, _derivedFrom: meta }
-          });
-        }
-        outputs[key] = { kind: "array", ok: true, entries };
-        continue;
-      }
-      if (value === void 0 || value === null) {
-        if (outSpec.optional === true) {
-          outputs[key] = { kind: "record", value: {}, ok: true, skipped: true };
-          continue;
-        }
-        throw new DerivationOutputShapeError(
-          key,
-          `expected object, got ${value === void 0 ? "undefined" : "null"}`
-        );
-      }
-      if (typeof value !== "object") {
-        throw new DerivationOutputShapeError(
-          key,
-          `expected object, got ${typeof value}`
-        );
-      }
-      outputs[key] = {
-        kind: "record",
-        value: { ...value, _derivedFrom: meta },
-        ok: true
-      };
-    }
-    return { outputs, failed: false };
-  }
-};
-
-export {
-  DerivationExecutor
-};
-//# sourceMappingURL=chunk-LEJIKBBB.js.map

package/dist/chunk-LL2NIVUR.js

@@ -1,188 +0,0 @@
-import {
-  putDerivedOutput
-} from "./chunk-WZSCE6RM.js";
-import {
-  wrapDbWithPredicates
-} from "./chunk-3QSIU3UT.js";
-import {
-  canonicalGroupKey,
-  groupAndReduce
-} from "./chunk-DFVUTGT2.js";
-import {
-  applyI18nLocale
-} from "./chunk-EOXAAJTY.js";
-import {
-  LocaleNotSpecifiedError,
-  MaterializedViewTooLargeError
-} from "./chunk-S7VFUQM2.js";
-
-// src/with-formula/materialized-views/executor.ts
-var DEFAULT_MAX_ROWS = 1e5;
-async function materializeQueryResult(q, mvName, i18nLocale, i18nFields) {
-  if (typeof q?.toArray === "function") {
-    return await q.toArray();
-  }
-  if (typeof q?.run === "function") {
-    const runOpts = i18nLocale !== void 0 ? { locale: i18nLocale, i18nFields } : void 0;
-    const result = await Promise.resolve(q.run(runOpts));
-    if (Array.isArray(result)) {
-      return result;
-    }
-    return [result];
-  }
-  throw new Error(
-    `MV "${mvName}": query() must return a Query<T>, Aggregation, or GroupedAggregation. Got something without a .toArray() or .run() terminal.`
-  );
-}
-async function materializeUnionResult(spec, db) {
-  const unified = [];
-  for (const arm of spec.unionSources) {
-    const coll = db.collection(arm.collection);
-    let q = coll.query();
-    if (arm.join?.length) {
-      for (const leg of arm.join) {
-        q = q.join(leg.field, { as: leg.as, maxRows: leg.maxRows, strategy: leg.strategy });
-      }
-    }
-    const sourceRows = q.toArray();
-    for (const r of sourceRows) {
-      const mapped = arm.map(r);
-      if (mapped == null) continue;
-      unified.push(mapped);
-    }
-  }
-  if (!spec.groupBy) return unified;
-  const groupFields = typeof spec.groupBy === "string" ? [spec.groupBy] : spec.groupBy;
-  if (spec.i18nLocale !== void 0 && spec.i18nFields !== void 0) {
-    const groupI18n = {};
-    for (const f of groupFields) {
-      const d = spec.i18nFields[f];
-      if (d !== void 0) groupI18n[f] = d;
-    }
-    if (Object.keys(groupI18n).length > 0) {
-      for (let i = 0; i < unified.length; i++) {
-        unified[i] = applyI18nLocale(unified[i], groupI18n, spec.i18nLocale, void 0, "mv");
-      }
-    }
-  }
-  for (const f of groupFields) {
-    for (const row of unified) {
-      const v = row[f];
-      if (v !== null && typeof v === "object") {
-        throw new LocaleNotSpecifiedError(
-          f,
-          `Materialized view "${spec.name}" groups by "${f}", whose value is a raw i18n locale map \u2014 an unstable object group key. Declare { i18nLocale, i18nFields } on the MV to resolve it at the 'mv' layer, or group by a dictKey/staticDict code (the stable key) and resolve the label at read time.`
-        );
-      }
-    }
-  }
-  if (!spec.aggregate) {
-    const seen = /* @__PURE__ */ new Map();
-    for (const row of unified) {
-      const k = canonicalGroupKey(groupFields, row);
-      if (!seen.has(k)) seen.set(k, row);
-    }
-    return [...seen.values()];
-  }
-  return groupAndReduce(unified, groupFields, spec.aggregate, spec.moneyFields);
-}
-var MaterializedViewExecutor = {
-  async refresh(reg, accessor) {
-    const spec = reg.spec;
-    const outputColl = accessor.getCollection(reg.outputCollection);
-    const maxRows = spec.maxRows ?? DEFAULT_MAX_ROWS;
-    const onEmpty = spec.onEmpty ?? "delete";
-    const strict = spec.strict ?? false;
-    const baseCtx = accessor.getQueryContext();
-    const ctxForQuery = spec.predicates ? wrapDbWithPredicates(baseCtx, spec.predicates) : baseCtx;
-    let rows;
-    if (spec.unionSources) {
-      rows = await materializeUnionResult(spec, ctxForQuery);
-    } else {
-      const q = spec.query(ctxForQuery);
-      rows = await materializeQueryResult(q, spec.name, spec.i18nLocale, spec.i18nFields);
-    }
-    if (rows.length > maxRows) {
-      throw new MaterializedViewTooLargeError(spec.name, rows.length, maxRows);
-    }
-    const txCtx = accessor.getActiveTxContext();
-    const adapter = outputColl.adapter;
-    const vaultName = outputColl.vault;
-    const newIds = /* @__PURE__ */ new Set();
-    const enrichedRows = [];
-    for (const row of rows) {
-      const id = spec.rowKey(row);
-      newIds.add(id);
-      const meta = {
-        mvName: spec.name,
-        queryHash: reg.queryHash,
-        sourceVersions: {},
-        materializedAt: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      enrichedRows.push({ id, record: { ...row, _materializedFrom: meta } });
-    }
-    let written = 0;
-    let failed = 0;
-    for (const { id, record } of enrichedRows) {
-      try {
-        if (txCtx !== null) {
-          const prior = await adapter.get(vaultName, reg.outputCollection, id);
-          txCtx._executed.push({
-            op: { type: "put", vaultName, collectionName: reg.outputCollection, id },
-            priorEnvelope: prior
-          });
-        }
-        if (accessor.dispatchCtx) {
-          if (await putDerivedOutput(outputColl, id, record, accessor.dispatchCtx) === "written") written++;
-        } else {
-          await outputColl.put(id, record);
-          written++;
-        }
-      } catch (err) {
-        failed++;
-        if (strict) throw err;
-        console.warn(`[mv] "${spec.name}" row write failed:`, err);
-      }
-    }
-    let deleted = 0;
-    if (onEmpty === "delete") {
-      const priorIds = await listOutputIds(outputColl);
-      for (const priorId of priorIds) {
-        if (newIds.has(priorId)) continue;
-        try {
-          const outAny = outputColl;
-          if (typeof outAny._internalDelete === "function") {
-            await outAny._internalDelete(priorId, txCtx);
-            deleted++;
-          } else {
-            await outputColl.delete(priorId);
-            deleted++;
-          }
-        } catch (err) {
-          failed++;
-          if (strict) throw err;
-          console.warn(`[mv] "${spec.name}" tombstone failed for id="${priorId}":`, err);
-        }
-      }
-    }
-    return { written, deleted, failed };
-  }
-};
-async function listOutputIds(outputColl) {
-  const cAny = outputColl;
-  const adapter = cAny.adapter;
-  const vault = cAny.vault;
-  const name = cAny.name;
-  if (typeof adapter?.list !== "function") return [];
-  try {
-    const ids = await adapter.list(vault, name);
-    return [...ids];
-  } catch {
-    return [];
-  }
-}
-
-export {
-  MaterializedViewExecutor
-};
-//# sourceMappingURL=chunk-LL2NIVUR.js.map