@aglyn/aglyn 1.0.0-beta.221 → 1.0.0-beta.222

package/src/lib/app-utils/dataset-models.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/dataset-models.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { validateCustomFieldValue } from '../plugin-manager/custom-fields'\nimport { type DatasetFieldEntry, humanizeDatasetFieldId } from './datasets'\n\n/**\n * Dataset models (AGL-177): the runtime promotion of the type-level\n * blueprint in `libs/shared/data/types/src/lib/dod.ts` (kept as the\n * referenced design doc — this module is the single runtime source of\n * truth). A model lives on the dataset doc\n * (`orgs/{orgId}/datasets/{id}.model`) and drives the typed editor, import\n * and site-restore validation, and every record write — the console, `/v1`,\n * a bound form's submission and an automation step — through the shared\n * `validateDocument`/`coerceDocumentValues` pair so they can't disagree. The\n * form and the automation step reach the pair through\n * `prepareDatasetRecordWrite` (AGL-2773).\n *\n * Storage conventions (Firestore-safe): timestamps as epoch millis\n * numbers, coordinates as `{ latitude, longitude }`, `sorted` as arrays,\n * `map` as plain objects, references as target-document id strings.\n */\n\n/** dod.ts `FT.Tag` vocabulary plus `reference` (AGL-180 builds on it). */\nexport type DatasetFieldType =\n  | 'bool'\n  | 'bytes'\n  | 'timestamp'\n  | 'float'\n  | 'int32'\n  | 'int64'\n  | 'nil'\n  | 'text'\n  | 'coordinates'\n  | 'map'\n  | 'sorted'\n  | 'reference'\n\nexport const DATASET_FIELD_TYPES: DatasetFieldType[] = [\n  'text',\n  'bool',\n  'int32',\n  'int64',\n  'float',\n  'timestamp',\n  'coordinates',\n  'map',\n  'sorted',\n  'bytes',\n  'nil',\n  'reference',\n]\n\n/** Display names, mirroring dod.ts `lbl`. */\nexport const DATASET_FIELD_TYPE_LABELS: Record<DatasetFieldType, string> = {\n  text: 'Text',\n  bool: 'Boolean',\n  int32: 'Integer',\n  int64: 'Big integer',\n  float: 'Number',\n  timestamp: 'Date & time',\n  coordinates: 'Coordinates',\n  map: 'Map',\n  sorted: 'List',\n  bytes: 'Bytes',\n  nil: 'Null',\n  reference: 'Reference',\n}\n\n/**\n * Plain-JSON validation vocabulary (the dod.ts `Eval` shape, extended\n * with min/max and options, serialized flat instead of enum-keyed).\n */\nexport interface DatasetFieldValidation {\n  required?: boolean\n  /** Source of a RegExp applied to text values. */\n  regex?: string\n  /** Numbers/timestamps: value bound. Text: length bound. */\n  min?: number\n  max?: number\n  /** Enum: value must be one of these (text fields). */\n  options?: string[]\n}\n\nexport interface DatasetFieldDefinition {\n  /**\n   * Human-facing display label only. The stable reference id is the KEY in\n   * `DatasetModel.fields` (and `order`), NOT this name — bindings resolve\n   * `{{item.<fieldId>}}` against that key. The default id is derived from\n   * this name once at creation but is user-overridable (AGL-578); renaming\n   * the label afterwards never changes the id.\n   */\n  name: string\n  type: DatasetFieldType\n  /**\n   * Plugin-declared custom type riding this base type (AGL-434) — see\n   * plugin-manager/custom-fields. Unknown names degrade to the base type.\n   */\n  customType?: string\n  description?: string\n  required?: boolean\n  /** Default applied by editors when creating documents; never coerced. */\n  default?: unknown\n  validation?: DatasetFieldValidation\n  /**\n   * Reference fields (AGL-180): target collection + display field id.\n   * `multiple` stores a `sorted` array of FKeys (small-cardinality\n   * many-to-many per the dod.ts guidance); `onDelete` is the referenced-\n   * document delete policy (default `setNull` — never cascade in v2).\n   */\n  reference?: {\n    datasetId: string\n    displayFieldId?: string\n    multiple?: boolean\n    onDelete?: 'restrict' | 'setNull'\n  }\n}\n\nexport interface DatasetModel {\n  fields: Record<string, DatasetFieldDefinition>\n  /** Field ids in display order. */\n  order: string[]\n}\n\n/**\n * Migration shim (v1 → v2): datasets created before models carry flat\n * `fields: string[]` — derive a model where every column is an optional\n * text field whose id is the column name, so the editor and AGL-103\n * bindings keep working on unmigrated docs during rollout.\n */\nexport function deriveModelFromFields(fields: string[]): DatasetModel {\n  const model: DatasetModel = { fields: {}, order: [] }\n  for (const name of fields) {\n    // Raw snake_case ids read as titles in table headers and pickers;\n    // the id stays the stable key (AGL-558).\n    model.fields[name] = { name: humanizeDatasetFieldId(name), type: 'text' }\n    model.order.push(name)\n  }\n  return model\n}\n\n/**\n * Model from quick-creator entries (AGL-558): stable slug ids with the\n * human display names preserved — \"Roast preference\" → id\n * `roast_preference`, name \"Roast preference\".\n */\nexport function modelFromFieldEntries(\n  entries: readonly DatasetFieldEntry[],\n): DatasetModel {\n  const model: DatasetModel = { fields: {}, order: [] }\n  for (const entry of entries) {\n    model.fields[entry.id] = { name: entry.name, type: 'text' }\n    model.order.push(entry.id)\n  }\n  return model\n}\n\n/** The dataset's model, deriving one from v1 `fields` when absent. */\nexport function effectiveDatasetModel(dataset: {\n  model?: DatasetModel\n  fields?: string[]\n}): DatasetModel {\n  if (dataset.model?.fields && dataset.model.order?.length) {\n    return dataset.model\n  }\n  return deriveModelFromFields(dataset.fields ?? [])\n}\n\nconst isFiniteNumber = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isFinite(value)\n\n/**\n * Validates a document's values against a model, returning fieldId →\n * human-readable error (empty object = valid). Values are expected in\n * storage form (see the module doc); use `coerceDocumentValues` first\n * when starting from user input strings.\n */\nexport function validateDocument(\n  model: DatasetModel,\n  values: Record<string, unknown>,\n): Record<string, string> {\n  const errors: Record<string, string> = {}\n  for (const fieldId of model.order) {\n    const field = model.fields[fieldId]\n    if (!field) continue\n    const value = values[fieldId]\n    const required = field.required || field.validation?.required\n    if (value == null || value === '') {\n      if (required) errors[fieldId] = `${field.name} is required`\n      continue\n    }\n    const rules = field.validation ?? {}\n    switch (field.type) {\n      case 'text': {\n        if (typeof value !== 'string') {\n          errors[fieldId] = `${field.name} must be text`\n          break\n        }\n        if (rules.min != null && value.length < rules.min) {\n          errors[fieldId] = `${field.name} must be at least ${rules.min} characters`\n        } else if (rules.max != null && value.length > rules.max) {\n          errors[fieldId] = `${field.name} must be at most ${rules.max} characters`\n        } else if (rules.regex) {\n          try {\n            if (!new RegExp(rules.regex).test(value)) {\n              errors[fieldId] = `${field.name} has an invalid format`\n            }\n          } catch {\n            // Broken pattern in the model never blocks writes.\n          }\n        }\n        if (\n          !errors[fieldId] &&\n          rules.options?.length &&\n          !rules.options.includes(value)\n        ) {\n          errors[fieldId] = `${field.name} must be one of: ${rules.options.join(', ')}`\n        }\n        break\n      }\n      case 'bool':\n        if (typeof value !== 'boolean') {\n          errors[fieldId] = `${field.name} must be true or false`\n        }\n        break\n      case 'int32':\n      case 'int64':\n        if (!isFiniteNumber(value) || !Number.isInteger(value)) {\n          errors[fieldId] = `${field.name} must be a whole number`\n          break\n        }\n        if (rules.min != null && value < rules.min) {\n          errors[fieldId] = `${field.name} must be ≥ ${rules.min}`\n        } else if (rules.max != null && value > rules.max) {\n          errors[fieldId] = `${field.name} must be ≤ ${rules.max}`\n        }\n        break\n      case 'float':\n      case 'timestamp':\n        if (!isFiniteNumber(value)) {\n          errors[fieldId] =\n            field.type === 'timestamp'\n              ? `${field.name} must be a date`\n              : `${field.name} must be a number`\n          break\n        }\n        if (rules.min != null && value < rules.min) {\n          errors[fieldId] = `${field.name} must be ≥ ${rules.min}`\n        } else if (rules.max != null && value > rules.max) {\n          errors[fieldId] = `${field.name} must be ≤ ${rules.max}`\n        }\n        break\n      case 'coordinates': {\n        const coordinates = value as { latitude?: unknown; longitude?: unknown }\n        if (\n          !isFiniteNumber(coordinates?.latitude) ||\n          !isFiniteNumber(coordinates?.longitude) ||\n          Math.abs(coordinates.latitude) > 90 ||\n          Math.abs(coordinates.longitude) > 180\n        ) {\n          errors[fieldId] = `${field.name} must be valid coordinates`\n        }\n        break\n      }\n      case 'sorted':\n        if (!Array.isArray(value)) {\n          errors[fieldId] = `${field.name} must be a list`\n        }\n        break\n      case 'map':\n        if (typeof value !== 'object' || Array.isArray(value)) {\n          errors[fieldId] = `${field.name} must be a map`\n        }\n        break\n      case 'reference':\n        if (field.reference?.multiple) {\n          if (\n            !Array.isArray(value) ||\n            value.some((entry) => typeof entry !== 'string' || !entry)\n          ) {\n            errors[fieldId] = `${field.name} must reference documents`\n          }\n        } else if (typeof value !== 'string' || !value) {\n          errors[fieldId] = `${field.name} must reference a document`\n        }\n        break\n      case 'bytes':\n      case 'nil':\n        break\n    }\n  }\n  // Custom field types (AGL-434): plugin validators run after the base\n  // checks, only on fields that passed them.\n  for (const fieldId of model.order) {\n    const field = model.fields[fieldId]\n    if (!field?.customType || errors[fieldId]) continue\n    const customError = validateCustomFieldValue(\n      field.customType,\n      values[fieldId],\n    )\n    if (customError) errors[fieldId] = `${field.name}: ${customError}`\n  }\n  return errors\n}\n\n/** Storage value → grid display string (AGL-179). */\nexport function formatDatasetValue(\n  field: DatasetFieldDefinition,\n  value: unknown,\n): string {\n  if (value == null || value === '') return ''\n  switch (field.type) {\n    case 'bool':\n      return value === true ? '✓' : value === false ? '—' : String(value)\n    case 'timestamp':\n      return isFiniteNumber(value)\n        ? new Date(value).toISOString().slice(0, 16).replace('T', ' ')\n        : String(value)\n    case 'coordinates': {\n      const coordinates = value as { latitude?: number; longitude?: number }\n      return isFiniteNumber(coordinates?.latitude) &&\n        isFiniteNumber(coordinates?.longitude)\n        ? `${coordinates.latitude}, ${coordinates.longitude}`\n        : String(value)\n    }\n    case 'sorted':\n      return Array.isArray(value) ? value.join(', ') : String(value)\n    case 'map':\n      try {\n        return JSON.stringify(value)\n      } catch {\n        return String(value)\n      }\n    default:\n      return String(value)\n  }\n}\n\n/**\n * Storage value → form-input string (AGL-179): the inverse of\n * `coerceDocumentValues` for populating type-appropriate inputs\n * (timestamps as `datetime-local` values, coordinates as \"lat, lon\").\n */\nexport function datasetValueToInput(\n  field: DatasetFieldDefinition,\n  value: unknown,\n): string {\n  if (value == null) return ''\n  if (field.type === 'timestamp' && isFiniteNumber(value)) {\n    return new Date(value).toISOString().slice(0, 16)\n  }\n  if (field.type === 'bool') {\n    return value === true ? 'true' : value === false ? 'false' : String(value)\n  }\n  if (field.type === 'coordinates' || field.type === 'sorted') {\n    return formatDatasetValue(field, value)\n  }\n  if (field.type === 'map') return formatDatasetValue(field, value)\n  return String(value)\n}\n\nconst BOOL_TRUE_WORDS = new Set(['true', 'yes', 'on', '1'])\nconst BOOL_FALSE_WORDS = new Set(['false', 'no', 'off', '0'])\n\n/**\n * Coerces user-input strings (form fields, CSV cells) into storage form\n * per the field type. Unparseable input is passed through untouched so\n * `validateDocument` reports it instead of silently mangling it.\n */\nexport function coerceDocumentValues(\n  model: DatasetModel,\n  input: Record<string, unknown>,\n): Record<string, unknown> {\n  const values: Record<string, unknown> = {}\n  for (const fieldId of model.order) {\n    const field = model.fields[fieldId]\n    const raw = input[fieldId]\n    if (!field || raw == null || raw === '') continue\n    if (typeof raw !== 'string') {\n      values[fieldId] = raw\n      continue\n    }\n    switch (field.type) {\n      case 'bool': {\n        // The words a form control or a CSV cell says yes and no with: a\n        // lone checkbox posts `on`, a spreadsheet exports `TRUE` or `1`.\n        const word = raw.trim().toLowerCase()\n        values[fieldId] = BOOL_TRUE_WORDS.has(word)\n          ? true\n          : BOOL_FALSE_WORDS.has(word)\n            ? false\n            : raw\n        break\n      }\n      case 'int32':\n      case 'int64': {\n        const parsed = Number(raw)\n        values[fieldId] = Number.isInteger(parsed) ? parsed : raw\n        break\n      }\n      case 'float': {\n        const parsed = Number(raw)\n        values[fieldId] = Number.isFinite(parsed) ? parsed : raw\n        break\n      }\n      case 'timestamp': {\n        const millis = Date.parse(raw)\n        values[fieldId] = Number.isFinite(millis) ? millis : raw\n        break\n      }\n      case 'coordinates': {\n        const [latitude, longitude] = raw.split(',').map((part) => Number(part.trim()))\n        values[fieldId] =\n          Number.isFinite(latitude) && Number.isFinite(longitude)\n            ? { latitude, longitude }\n            : raw\n        break\n      }\n      case 'sorted':\n        values[fieldId] = raw\n          .split(',')\n          .map((part) => part.trim())\n          .filter(Boolean)\n        break\n      case 'map':\n        try {\n          values[fieldId] = JSON.parse(raw)\n        } catch {\n          values[fieldId] = raw\n        }\n        break\n      case 'reference':\n        values[fieldId] = field.reference?.multiple\n          ? raw\n              .split(',')\n              .map((part) => part.trim())\n              .filter(Boolean)\n          : raw\n        break\n      default:\n        values[fieldId] = raw\n    }\n  }\n  return values\n}\n\n/**\n * Every reference id a record holds, flattened out of its `reference` fields\n * into one de-duplicated list.\n *\n * A reference field stores either a single target id or — when\n * `reference.multiple` is set — an array of them, and a model may declare\n * several. Both shapes flatten into the same list because the question asked\n * of it is never \"which field\", it is \"does this record still point at that\n * document\".\n *\n * Fields are read from `order` UNIONED with the keys of `fields`. Every other\n * pass over a model walks `order` alone, which is right for anything the user\n * sees — but a reference declared without a display slot still holds a real\n * FKey, and an integrity index that skipped it would under-report.\n */\nexport function datasetReferencedIds(\n  model: DatasetModel,\n  values: Record<string, unknown> | undefined,\n): string[] {\n  const ids = new Set<string>()\n  const fieldIds = new Set([\n    ...(model.order ?? []),\n    ...Object.keys(model.fields ?? {}),\n  ])\n  for (const fieldId of fieldIds) {\n    if (model.fields?.[fieldId]?.type !== 'reference') continue\n    const stored = values?.[fieldId]\n    for (const entry of Array.isArray(stored) ? stored : [stored]) {\n      const id = typeof entry === 'string' ? entry.trim() : ''\n      if (id) ids.add(id)\n    }\n  }\n  return [...ids]\n}\n\n/**\n * The integrity index a record write carries, so referential integrity can be\n * decided by a QUERY rather than by the rows a listener happened to fetch.\n *\n * Deleting a record has to answer \"is anything still pointing at this?\", and\n * `restrict` refuses the delete on a yes while `setNull` strips the FKey. That\n * question cannot be asked where the answer is stored: dataset fields are\n * user-defined, so `records.values` carries a deliberate index exemption in\n * `cloud/firebase-firestore.indexes.json` — auto-indexing an unbounded map\n * blows Firestore's per-document index-entry limit — and\n * `where('values.<fieldId>', '==', id)` is therefore FAILED_PRECONDITION.\n * Reading a page of records and filtering them in the browser answers only for\n * the rows in that page, which is a browse window standing in for a\n * correctness check: a reference held outside it reads as no reference at all,\n * the delete proceeds, and `restrict` silently fails to restrict.\n *\n * `referencedIds` is that same reference, denormalized to a top-level array\n * Firestore will index, so one `array-contains` reaches every record.\n *\n * ⚠️ OMITTED when a record references nothing, rather than written as `[]`.\n * `isNotEmpty` is served as `!= null` and an empty array is not null, so a\n * record stamped `[]` answers \"holds a reference\" for a dataset that holds\n * none.\n *\n * ⚠️ Spread this at EVERY write that sets a record's `values`. A write that\n * sets values without it leaves the index describing the PREVIOUS values, and\n * a stale integrity index is the exact failure it exists to prevent — with the\n * UI reporting the record as safe to delete. On a merging write use\n * `datasetIntegrityUpdate` instead: omission leaves a stale array in place\n * where clearing the last reference has to remove the field.\n */\nexport function datasetIntegrityFields(\n  model: DatasetModel,\n  values: Record<string, unknown> | undefined,\n): {\n  referencedIds?: string[]\n  filterKeys?: string[]\n  filterValues?: DatasetFilterValues\n} {\n  const referencedIds = datasetReferencedIds(model, values)\n  // The records table's filter fields (`datasetFilterKeys`,\n  // `datasetFilterValues`) travel on the same writes for the same reason: a\n  // record written without them is invisible to every filter the query\n  // serves. Omitted when empty, like `referencedIds`.\n  const filterKeys = datasetFilterKeys(model, values)\n  const filterValues = datasetFilterValues(model, values)\n  return {\n    ...(referencedIds.length ? { referencedIds } : {}),\n    ...(filterKeys.length ? { filterKeys } : {}),\n    ...(Object.keys(filterValues).length ? { filterValues } : {}),\n  }\n}\n\n/**\n * `datasetIntegrityFields` for a MERGING write (`update`, `set` with\n * `mergeFields`), where leaving the field out preserves what is stored\n * rather than clearing it.\n *\n * A record whose last reference is cleared has to have the field REMOVED, or\n * it goes on answering the `array-contains` for a document it no longer points\n * at — a `restrict` that refuses a delete nothing is holding. `clear` is the\n * caller's delete sentinel: `deleteField()` in the web SDK,\n * `FieldValue.delete()` in the Admin SDK. It is passed in rather than imported\n * because this module is shared by both and must stay SDK-free. The filter\n * fields are cleared the same way, so a record emptied of every filterable\n * value stops answering the filters its old values did.\n *\n * ⚠️ `filterValues` is a MAP, and it is written WHOLE: `update` and\n * `mergeFields` replace a field outright, so a value cleared since the last\n * write leaves the map with it. `set(…, { merge: true })` does NOT — it merges\n * maps key by key and would keep the cleared value answering its old\n * equality — so a record write never uses it; list the fields in\n * `mergeFields` instead.\n */\nexport function datasetIntegrityUpdate<TClear>(\n  model: DatasetModel,\n  values: Record<string, unknown> | undefined,\n  clear: TClear,\n): {\n  referencedIds: string[] | TClear\n  filterKeys: string[] | TClear\n  filterValues: DatasetFilterValues | TClear\n} {\n  const referencedIds = datasetReferencedIds(model, values)\n  const filterKeys = datasetFilterKeys(model, values)\n  const filterValues = datasetFilterValues(model, values)\n  return {\n    referencedIds: referencedIds.length ? referencedIds : clear,\n    filterKeys: filterKeys.length ? filterKeys : clear,\n    filterValues: Object.keys(filterValues).length ? filterValues : clear,\n  }\n}\n\n/**\n * A dataset record's FILTER TOKENS: every word-level question the records\n * table can ask of a record, flattened into one array of strings Firestore\n * indexes on its own. Its twin, {@link datasetFilterValues}, holds the\n * equalities.\n *\n * ## Why these fields, and not the values\n *\n * A record's fields live under `values`, a user-defined, unbounded map that\n * the index configuration exempts from indexing — auto-indexing it can exceed\n * Firestore's per-document index-entry limit — so `where('values.<field>', …)`\n * is refused. A composite index per dataset would need an admin call per\n * dataset, runs into the project's composite-index cap, and is deleted by the\n * next `firestore:indexes` deploy of a file that does not list it.\n *\n * `filterKeys` and `filterValues` need none of that. Firestore's AUTOMATIC\n * single-field indexes serve `where('filterKeys', 'array-contains', token)`\n * and `where('filterValues.<field>', '==', value)`, and every automatic index\n * ends in the document name — so any number of those equalities and ONE\n * `array-contains`, under `orderBy(documentId())`, compose by index merging,\n * with no composite index and no index deploy, on any dataset of any project\n * (AGL-3321).\n *\n * ## The token grammar\n *\n *   `f:<fieldId>=<value>`   a field equals a value. Enum (a text field with\n *                           `validation.options`) values are kept exactly;\n *                           plain text is lower-cased, trimmed and clipped to\n *                           {@link DATASET_FILTER_VALUE_MAX} characters;\n *                           booleans are `true`/`false`; numbers are\n *                           `String(number)`; a `sorted` list contributes one\n *                           token per member.\n *   `f:<fieldId>^<prefix>`  a word of a plain text field starts with this.\n *   `s:<prefix>`            a word of ANY text value (enums and list members\n *                           included) starts with this — the quick search.\n *\n * Timestamps, references, maps, bytes, coordinates and nil fields carry no\n * field tokens: a timestamp is asked in ranges, which one token cannot serve,\n * and the rest are not asked about by value.\n *\n * The array is sorted, de-duplicated and capped at\n * {@link DATASET_FILTER_KEYS_MAX}. Past the cap, the `=` tokens are kept\n * first, then the per-field word prefixes, then the search prefixes, so a\n * very long record loses search reach before it loses exact matches.\n */\nexport const DATASET_FILTER_KEYS_MAX = 500\n\n/** Plain text values are clipped to this many characters in an `=` token. */\nexport const DATASET_FILTER_VALUE_MAX = 64\n/** Word prefixes run from 1 to this many characters. */\nexport const DATASET_FILTER_PREFIX_MAX = 12\n/** Only the first this-many words of a value contribute prefixes. */\nexport const DATASET_FILTER_WORDS_MAX = 40\n\n/** One clause of the records table's filter: `{ field, op, value }`. */\nexport interface DatasetFilterClause {\n  field: string\n  op: string\n  value: string\n}\n\n/**\n * The words of a text value: split on anything that is not a letter or a\n * digit, lower-cased, at most {@link DATASET_FILTER_WORDS_MAX} of them.\n */\nexport function datasetFilterWords(text: string): string[] {\n  return String(text)\n    .toLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean)\n    .slice(0, DATASET_FILTER_WORDS_MAX)\n}\n\n/** A word's prefixes, 1 to {@link DATASET_FILTER_PREFIX_MAX} characters. */\nfunction prefixes(word: string): string[] {\n  const chars = Array.from(word).slice(0, DATASET_FILTER_PREFIX_MAX)\n  return chars.map((_char, at) => chars.slice(0, at + 1).join(''))\n}\n\n/** A word clipped the way its stored prefixes are. */\nfunction clipWord(word: string): string {\n  return Array.from(word).slice(0, DATASET_FILTER_PREFIX_MAX).join('')\n}\n\nconst isEnum = (field: DatasetFieldDefinition): boolean =>\n  field.type === 'text' && (field.validation?.options?.length ?? 0) > 0\n\nconst isNumeric = (field: DatasetFieldDefinition): boolean =>\n  field.type === 'int32' || field.type === 'int64' || field.type === 'float'\n\n/**\n * A stored value as text, or null. Numbers are accepted because a form or an\n * automation stores every value as text and an import may do the reverse.\n */\nfunction asText(value: unknown): string | null {\n  if (typeof value === 'string') return value\n  if (typeof value === 'number' && Number.isFinite(value)) return String(value)\n  return null\n}\n\n/**\n * Plain text as its stored key — its `=` token's value and its\n * `filterValues` entry: lower-cased, trimmed, clipped to\n * {@link DATASET_FILTER_VALUE_MAX} characters. What the records table asks a\n * typed value to equal.\n */\nexport function datasetFilterTextKey(value: string): string {\n  return Array.from(value.trim().toLowerCase())\n    .slice(0, DATASET_FILTER_VALUE_MAX)\n    .join('')\n}\nconst textKey = datasetFilterTextKey\n\n/** A stored number (or its text form) as its `=` token's value. */\nfunction numberKey(value: unknown): string | null {\n  const number =\n    typeof value === 'number'\n      ? value\n      : typeof value === 'string' && value.trim() !== ''\n        ? Number(value)\n        : Number.NaN\n  return Number.isFinite(number) ? String(number) : null\n}\n\n/** A stored boolean (or its text form) as its `=` token's value. */\nfunction boolKey(value: unknown): string | null {\n  if (typeof value === 'boolean') return String(value)\n  if (value === 'true' || value === 'false') return value\n  return null\n}\n\n/** Every field a model declares, in display order and then the rest. */\nfunction modelFieldIds(model: DatasetModel): string[] {\n  return [...new Set([...(model.order ?? []), ...Object.keys(model.fields ?? {})])]\n}\n\n/** The tokens described in {@link DATASET_FILTER_KEYS_MAX}'s comment. */\nexport function datasetFilterKeys(\n  model: DatasetModel,\n  values: Record<string, unknown> | undefined,\n): string[] {\n  const exact: string[] = []\n  const fieldWords: string[] = []\n  const search: string[] = []\n  const searchable = (text: string) => {\n    for (const word of datasetFilterWords(text)) {\n      for (const prefix of prefixes(word)) search.push(`s:${prefix}`)\n    }\n  }\n  for (const fieldId of modelFieldIds(model)) {\n    const field = model.fields?.[fieldId]\n    const stored = values?.[fieldId]\n    if (!field || stored == null) continue\n    if (field.type === 'text') {\n      const text = asText(stored)\n      if (text == null || !text.trim()) continue\n      if (isEnum(field)) {\n        exact.push(`f:${fieldId}=${text}`)\n      } else {\n        exact.push(`f:${fieldId}=${textKey(text)}`)\n        for (const word of datasetFilterWords(text)) {\n          for (const prefix of prefixes(word)) {\n            fieldWords.push(`f:${fieldId}^${prefix}`)\n          }\n        }\n      }\n      searchable(text)\n    } else if (field.type === 'bool') {\n      const key = boolKey(stored)\n      if (key) exact.push(`f:${fieldId}=${key}`)\n    } else if (isNumeric(field)) {\n      const key = numberKey(stored)\n      if (key) exact.push(`f:${fieldId}=${key}`)\n    } else if (field.type === 'sorted') {\n      for (const member of Array.isArray(stored) ? stored : [stored]) {\n        const text = asText(member)?.trim()\n        if (!text) continue\n        exact.push(`f:${fieldId}=${text}`)\n        searchable(text)\n      }\n    }\n  }\n  const kept = [...new Set([...exact, ...fieldWords, ...search])].slice(\n    0,\n    DATASET_FILTER_KEYS_MAX,\n  )\n  return kept.sort()\n}\n\n/** A record's `filterValues`: field id → the value an equality asks for. */\nexport type DatasetFilterValues = Record<string, string | number | boolean>\n\n/**\n * Field ids a query can name as `filterValues.<id>`. A path string splits on\n * `.`, and the SDKs refuse `~ * / [ ]` in one; the model editor allows only\n * letters, digits and underscores, but a v1 dataset's column names were\n * never checked. Backticks are refused too, as the escape a path would need.\n */\nconst FILTER_VALUE_ID = /^[^.~*/[\\]`]+$/\n\n/**\n * The query path of a field's `filterValues` entry, or null for a field id\n * no path can name — such a field is stamped no entry, and the records table\n * offers it no equality (its `contains`, served by `filterKeys`, stands).\n */\nexport function datasetFilterValuePath(fieldId: string): string | null {\n  return FILTER_VALUE_ID.test(fieldId) && !/^__.*__$/.test(fieldId)\n    ? `filterValues.${fieldId}`\n    : null\n}\n\n/**\n * A dataset record's FILTER VALUES: `{ [fieldId]: value }`, one scalar per\n * field an equality can be asked of, so the records table puts every\n * equality on its query (AGL-3321).\n *\n *   enum text (`validation.options`)  the value exactly, as its `=` token;\n *   plain text                        {@link datasetFilterTextKey};\n *   bool                              a boolean;\n *   int32 / int64 / float             a number.\n *\n * A form or an automation stores every value as text, so `'19.50'` is the\n * number 19.5 and `'true'` the boolean, as in {@link datasetFilterKeys}.\n * Fields with no value, and timestamps, lists, references, maps, bytes,\n * coordinates and nil fields, carry no entry: a list is asked by member\n * (`f:<id>=<member>` in `filterKeys`), and the rest are not asked about by\n * value.\n *\n * ## What it costs\n *\n * Unlike `values`, this map is NOT exempt from indexing — that is its whole\n * point. Each entry is a scalar and costs two automatic index entries\n * (ascending, descending), so a record costs at most two per model field —\n * bounded by the model's field count (the `/v1` API caps a model at 100\n * fields), far inside Firestore's 40,000 entries per document, where\n * `values` was unbounded because a `map` or `sorted` value may hold anything.\n */\nexport function datasetFilterValues(\n  model: DatasetModel,\n  values: Record<string, unknown> | undefined,\n): DatasetFilterValues {\n  const out: DatasetFilterValues = {}\n  for (const fieldId of modelFieldIds(model)) {\n    const field = model.fields?.[fieldId]\n    const stored = values?.[fieldId]\n    if (!field || stored == null || !datasetFilterValuePath(fieldId)) continue\n    if (field.type === 'text') {\n      const text = asText(stored)\n      if (text == null || !text.trim()) continue\n      out[fieldId] = isEnum(field) ? text : textKey(text)\n    } else if (field.type === 'bool') {\n      const key = boolKey(stored)\n      if (key) out[fieldId] = key === 'true'\n    } else if (isNumeric(field)) {\n      const key = numberKey(stored)\n      if (key) out[fieldId] = Number(key)\n    }\n  }\n  return out\n}\n\n/**\n * The `filterKeys` token a word-level clause asks for, or null when it is\n * not one:\n *\n *  - plain text `contains` → the `^` token of the value's FIRST word, so a\n *    `contains` is a word-prefix match, not a mid-string one, and one word\n *    of several is asked (the records table says so);\n *  - list `contains` (and `equals`) → the member's `=` token;\n *  - enum, boolean, number and plain text `equals` → the `=` token of the\n *    value. The records table asks these of `filterValues` instead, which\n *    composes with a `contains`; the token remains what the quick search and\n *    older readers match.\n *  - everything else — ranges, dates, `isEmpty`, `isAnyOf`, negations — null.\n *\n * `clause.field` is the field id. The operator names are the grid's: a\n * select's `equals`, a number's `=`, a boolean's `is`, a list's `contains`.\n */\nexport function datasetFilterToken(\n  model: DatasetModel,\n  clause: DatasetFilterClause,\n): string | null {\n  const field = model.fields?.[clause.field]\n  if (!field) return null\n  const { op } = clause\n  const value = String(clause.value ?? '')\n  if (!value.trim()) return null\n  const equals = op === 'equals' || op === '=' || op === 'is'\n  if (field.type === 'text') {\n    if (isEnum(field)) return equals ? `f:${clause.field}=${value}` : null\n    if (equals) return `f:${clause.field}=${textKey(value)}`\n    if (op === 'contains') {\n      const [first] = datasetFilterWords(value)\n      return first ? `f:${clause.field}^${clipWord(first)}` : null\n    }\n    return null\n  }\n  if (field.type === 'bool') {\n    const key = boolKey(value.trim())\n    return equals && key ? `f:${clause.field}=${key}` : null\n  }\n  if (isNumeric(field)) {\n    const key = numberKey(value)\n    return equals && key ? `f:${clause.field}=${key}` : null\n  }\n  if (field.type === 'sorted') {\n    return equals || op === 'contains' ? `f:${clause.field}=${value.trim()}` : null\n  }\n  return null\n}\n\n/**\n * The quick-search token for one typed word, or null for a word with no\n * letters or digits. A word with punctuation inside it is asked by its first\n * run — split the search text with {@link datasetFilterWords} to ask for\n * every run.\n */\nexport function datasetSearchToken(word: string): string | null {\n  const [first] = datasetFilterWords(word)\n  return first ? `s:${clipWord(first)}` : null\n}\n"],"names":["validateCustomFieldValue","humanizeDatasetFieldId","DATASET_FIELD_TYPES","DATASET_FIELD_TYPE_LABELS","text","bool","int32","int64","float","timestamp","coordinates","map","sorted","bytes","nil","reference","deriveModelFromFields","fields","model","order","name","type","push","modelFromFieldEntries","entries","entry","id","effectiveDatasetModel","dataset","length","isFiniteNumber","value","Number","isFinite","validateDocument","values","errors","fieldId","field","required","validation","rules","min","max","regex","RegExp","test","options","includes","join","isInteger","latitude","longitude","Math","abs","Array","isArray","multiple","some","customType","customError","formatDatasetValue","String","Date","toISOString","slice","replace","JSON","stringify","datasetValueToInput","BOOL_TRUE_WORDS","Set","BOOL_FALSE_WORDS","coerceDocumentValues","input","raw","word","trim","toLowerCase","has","parsed","millis","parse","split","part","filter","Boolean","datasetReferencedIds","ids","fieldIds","Object","keys","stored","add","datasetIntegrityFields","referencedIds","filterKeys","datasetFilterKeys","filterValues","datasetFilterValues","datasetIntegrityUpdate","clear","DATASET_FILTER_KEYS_MAX","DATASET_FILTER_VALUE_MAX","DATASET_FILTER_PREFIX_MAX","DATASET_FILTER_WORDS_MAX","datasetFilterWords","prefixes","chars","from","_char","at","clipWord","isEnum","isNumeric","asText","datasetFilterTextKey","textKey","numberKey","number","NaN","boolKey","modelFieldIds","exact","fieldWords","search","searchable","prefix","key","member","kept","sort","FILTER_VALUE_ID","datasetFilterValuePath","out","datasetFilterToken","clause","op","equals","first","datasetSearchToken"],"mappings":"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"}

package/src/lib/app-utils/datasets.d.ts

@@ -1,171 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * Datasets (AGL-102): tabular data at `orgs/{orgId}/datasets/{id}` with a
- * `records` subcollection, edited in the console Data card and consumed by
- * repeatable components (AGL-103) via `{{item.field}}` bindings.
- */
-import { type DatasetModel } from './dataset-models';
-/** Dataset field name: starts with a letter; letters/digits/underscores. */
-export declare const DATASET_FIELD_PATTERN: RegExp;
-export interface HostDataset {
-    $id?: string;
-    displayName?: string;
-    /** Column names, in display order (v1; superseded by `model`). */
-    fields?: string[];
-    /** Typed model (AGL-177); when absent, derive from `fields`. */
-    model?: import('./dataset-models').DatasetModel;
-    /** dod.ts Schema.Name shape (AGL-178). */
-    names?: {
-        singular?: string;
-        plural?: string;
-    };
-    /**
-     * Which sites may see this dataset (AGL-1037). Absent = org-wide, until
-     * the AGL-1040 backfill stamps it. See `app-utils/scope-tokens`.
-     */
-    visibleTo?: import('../foundation').ScopeToken[];
-}
-export interface HostDatasetRecord {
-    $id?: string;
-    /**
-     * Field → value, in storage form per the field's type (see
-     * `dataset-models`). Rows written by a form or an automation step before
-     * AGL-2773 hold every value as text; readers accept both.
-     */
-    values?: Record<string, unknown>;
-    /** Row position in the editor and in repeated output. */
-    order?: number;
-}
-/**
- * A human field entry from the quick creator: the stable id plus the
- * display name shown in table headers and bindings pickers (AGL-558).
- */
-export interface DatasetFieldEntry {
-    id: string;
-    name: string;
-}
-/**
- * Stable field id from a human name: "Roast preference" → "roast_preference".
- * Mirrors DATASET_FIELD_PATTERN; returns '' when nothing salvageable.
- */
-export declare function slugifyDatasetFieldId(name: string): string;
-/**
- * Default reference id for a new field (AGL-578): the `slugifyDatasetFieldId`
- * slug, suffixed (`_2`, `_3`, …) to stay unique within the dataset. `taken`
- * holds the ids already in use (compared case-insensitively). Returns '' when
- * the name yields nothing valid. The user can override the result.
- */
-export declare function defaultDatasetFieldId(name: string, taken: ReadonlySet<string>): string;
-/**
- * Validate a user-entered reference id (AGL-578): non-empty, matches
- * `DATASET_FIELD_PATTERN`, and unique within the dataset (`taken` = ids already
- * used, compared case-insensitively). Returns an error message, or null when
- * the id is usable.
- */
-export declare function validateDatasetFieldId(id: string, taken: ReadonlySet<string>): string | null;
-/** Display fallback for raw ids: "roast_preference" → "Roast preference". */
-export declare function humanizeDatasetFieldId(id: string): string;
-/**
- * Parses a comma/newline separated list of HUMAN field names into
- * {id, name} entries — "Roast preference" keeps its pretty name and gets
- * the stable id `roast_preference` (AGL-558). Plain snake_case keys
- * still work and pick up a humanized display name. Duplicate ids and
- * unsalvageable entries are dropped rather than failing the set.
- */
-export declare function parseDatasetFieldEntries(input: string): DatasetFieldEntry[];
-/**
- * Parses a comma/newline separated field list into valid unique names;
- * invalid entries are dropped rather than failing the whole set.
- */
-export declare function parseDatasetFields(input: string): string[];
-/** Record values restricted to the dataset's declared fields. */
-export declare function sanitizeRecordValues(fields: string[], input: Record<string, unknown> | null | undefined): Record<string, string>;
-/**
- * The submitted values a dataset write would store, picked by field id and
- * left as they arrived (AGL-556). With a `fieldMap` (submitted key → stable
- * model fieldId), mapped values land under the mapped fieldId — so renamed
- * schema fields keep receiving data — and entries whose fieldId isn't in the
- * model are dropped. Submitted keys without a mapping (and calls without a
- * map) fall back to the legacy name-intersection against the model's field
- * ids, matching `sanitizeRecordValues`.
- */
-export declare function pickDatasetRecordInput(dataset: {
-    model?: DatasetModel;
-    fields?: string[];
-}, input: Record<string, unknown> | null | undefined, fieldMap?: Record<string, string> | null): Record<string, unknown>;
-/** A dataset record write, checked against the dataset's model. */
-export interface DatasetRecordWrite {
-    /**
-     * The model fields this write supplied a value for, before coercion. Empty
-     * means nothing submitted matched a field of the dataset.
-     */
-    matched: string[];
-    /**
-     * The values to store, in storage form (see `dataset-models`): numbers,
-     * booleans, epoch millis and so on per the field's type. For a merge, the
-     * existing values with this write's laid over them.
-     */
-    values: Record<string, unknown>;
-    /** fieldId → the reason it was refused. Empty when the write may land. */
-    errors: Record<string, string>;
-}
-/**
- * A record write from a form submission or an automation step, coerced and
- * validated against the dataset's model (AGL-2773, option B).
- *
- * These writes used to store `String(value)` for every field and check
- * nothing, so a form could put `abc` in a number column and skip a required
- * one. They now run the same `coerceDocumentValues` + `validateDocument` pair
- * the console and `/v1` do: a value is stored in its field's type, and a
- * record with any refused field is not written at all. The caller decides
- * what a refusal costs — a form keeps the Inbox submission, a run records a
- * failed step.
- *
- * `existing` makes it a merge (update-or-append's update leg): this write's
- * values are laid over the stored ones, and only the fields THIS write
- * supplied are held to the model. A stored row written as text before this
- * change keeps its text values and is not refused for them — the reads have
- * always rendered them, and a merge that touched `email` must not fail over a
- * legacy `price` of `"12"` it never sent.
- *
- * Custom field types validate only once registered: call
- * `ensureDeclaredCustomFieldTypes(model)` before this on a server path.
- */
-export declare function prepareDatasetRecordWrite(dataset: {
-    model?: DatasetModel;
-    fields?: string[];
-}, input: Record<string, unknown> | null | undefined, options?: {
-    fieldMap?: Record<string, string> | null;
-    existing?: Record<string, unknown> | null;
-}): DatasetRecordWrite;
-/**
- * A refused write's errors as one line, in the model's field order:
- * `Stars must be a whole number; Email is required`.
- */
-export declare function describeDatasetRecordErrors(errors: Record<string, string>): string;
-/**
- * The name a dataset is shown under: `displayName`, which is what every create
- * path writes (AGL-536), then the pre-migration `name`. Blank when the document
- * carries neither.
- */
-export declare function datasetDisplayName(dataset: {
-    displayName?: unknown;
-    name?: unknown;
-} | null | undefined): string;
-/** Records sorted by their editor order (then id for stability). */
-export declare function sortDatasetRecords<T extends HostDatasetRecord>(records: T[]): T[];

package/src/lib/app-utils/datasets.js

@@ -1,227 +0,0 @@
-import { _ as _extends } from "@swc/helpers/_/_extends";
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ /**
- * Datasets (AGL-102): tabular data at `orgs/{orgId}/datasets/{id}` with a
- * `records` subcollection, edited in the console Data card and consumed by
- * repeatable components (AGL-103) via `{{item.field}}` bindings.
- */ import { coerceDocumentValues, effectiveDatasetModel, validateDocument } from "./dataset-models.js";
-/** Dataset field name: starts with a letter; letters/digits/underscores. */ export const DATASET_FIELD_PATTERN = /^[A-Za-z][A-Za-z0-9_]*$/;
-/**
- * Stable field id from a human name: "Roast preference" → "roast_preference".
- * Mirrors DATASET_FIELD_PATTERN; returns '' when nothing salvageable.
- */ export function slugifyDatasetFieldId(name) {
-    const slug = name.trim().toLowerCase().replace(/[\s-]+/g, '_').replace(/[^a-z0-9_]/g, '').replace(/^[0-9_]+/, '').replace(/_+$/, '');
-    return DATASET_FIELD_PATTERN.test(slug) ? slug : '';
-}
-/**
- * Default reference id for a new field (AGL-578): the `slugifyDatasetFieldId`
- * slug, suffixed (`_2`, `_3`, …) to stay unique within the dataset. `taken`
- * holds the ids already in use (compared case-insensitively). Returns '' when
- * the name yields nothing valid. The user can override the result.
- */ export function defaultDatasetFieldId(name, taken) {
-    const base = slugifyDatasetFieldId(name);
-    if (!base) return '';
-    const used = new Set([
-        ...taken
-    ].map((id)=>id.toLowerCase()));
-    let candidate = base;
-    let suffix = 2;
-    while(used.has(candidate.toLowerCase()))candidate = `${base}_${suffix++}`;
-    return candidate;
-}
-/**
- * Validate a user-entered reference id (AGL-578): non-empty, matches
- * `DATASET_FIELD_PATTERN`, and unique within the dataset (`taken` = ids already
- * used, compared case-insensitively). Returns an error message, or null when
- * the id is usable.
- */ export function validateDatasetFieldId(id, taken) {
-    const trimmed = id.trim();
-    if (!trimmed) return 'A reference ID is required';
-    if (!DATASET_FIELD_PATTERN.test(trimmed)) return 'Start with a letter; use only letters, numbers, and underscores';
-    const used = new Set([
-        ...taken
-    ].map((existing)=>existing.toLowerCase()));
-    if (used.has(trimmed.toLowerCase())) return 'Another field already uses this reference ID';
-    return null;
-}
-/** Display fallback for raw ids: "roast_preference" → "Roast preference". */ export function humanizeDatasetFieldId(id) {
-    const words = id.replace(/_/g, ' ').trim();
-    return words ? words.charAt(0).toUpperCase() + words.slice(1) : id;
-}
-/**
- * Parses a comma/newline separated list of HUMAN field names into
- * {id, name} entries — "Roast preference" keeps its pretty name and gets
- * the stable id `roast_preference` (AGL-558). Plain snake_case keys
- * still work and pick up a humanized display name. Duplicate ids and
- * unsalvageable entries are dropped rather than failing the set.
- */ export function parseDatasetFieldEntries(input) {
-    const seen = new Set();
-    const entries = [];
-    for (const raw of input.split(/[,\n]/)){
-        const trimmed = raw.trim();
-        if (!trimmed) continue;
-        const id = slugifyDatasetFieldId(trimmed);
-        if (!id || seen.has(id)) continue;
-        seen.add(id);
-        entries.push({
-            id,
-            name: DATASET_FIELD_PATTERN.test(trimmed) ? humanizeDatasetFieldId(trimmed) : trimmed
-        });
-    }
-    return entries;
-}
-/**
- * Parses a comma/newline separated field list into valid unique names;
- * invalid entries are dropped rather than failing the whole set.
- */ export function parseDatasetFields(input) {
-    const seen = new Set();
-    const fields = [];
-    for (const raw of input.split(/[,\n]/)){
-        const name = raw.trim();
-        if (!DATASET_FIELD_PATTERN.test(name)) continue;
-        const key = name.toLowerCase();
-        if (seen.has(key)) continue;
-        seen.add(key);
-        fields.push(name);
-    }
-    return fields;
-}
-/** Record values restricted to the dataset's declared fields. */ export function sanitizeRecordValues(fields, input) {
-    const values = {};
-    for (const field of fields){
-        const value = input == null ? void 0 : input[field];
-        if (value == null) continue;
-        values[field] = String(value);
-    }
-    return values;
-}
-/**
- * The submitted values a dataset write would store, picked by field id and
- * left as they arrived (AGL-556). With a `fieldMap` (submitted key → stable
- * model fieldId), mapped values land under the mapped fieldId — so renamed
- * schema fields keep receiving data — and entries whose fieldId isn't in the
- * model are dropped. Submitted keys without a mapping (and calls without a
- * map) fall back to the legacy name-intersection against the model's field
- * ids, matching `sanitizeRecordValues`.
- */ export function pickDatasetRecordInput(dataset, input, fieldMap) {
-    const model = effectiveDatasetModel(dataset);
-    const map = fieldMap != null ? fieldMap : {};
-    const values = {};
-    for (const fieldId of model.order){
-        if (!model.fields[fieldId]) continue;
-        // A submitted key with an explicit mapping never doubles as a
-        // name-match — the mapping decides where it lands.
-        if (fieldId in map) continue;
-        const value = input == null ? void 0 : input[fieldId];
-        if (value == null) continue;
-        values[fieldId] = value;
-    }
-    for (const [submittedKey, fieldId] of Object.entries(map)){
-        if (typeof fieldId !== 'string' || !model.fields[fieldId]) continue;
-        const value = input == null ? void 0 : input[submittedKey];
-        if (value == null) continue;
-        values[fieldId] = value;
-    }
-    return values;
-}
-/**
- * A text field takes what an event payload carries as a number or a boolean
- * as the text it reads as, which is what these writes always stored.
- */ function asTextInput(model, picked) {
-    const values = {};
-    for (const [fieldId, value] of Object.entries(picked)){
-        var _model_fields_fieldId;
-        const type = (_model_fields_fieldId = model.fields[fieldId]) == null ? void 0 : _model_fields_fieldId.type;
-        values[fieldId] = (type === 'text' || type === 'reference') && (typeof value === 'number' || typeof value === 'boolean') ? String(value) : value;
-    }
-    return values;
-}
-/**
- * A record write from a form submission or an automation step, coerced and
- * validated against the dataset's model (AGL-2773, option B).
- *
- * These writes used to store `String(value)` for every field and check
- * nothing, so a form could put `abc` in a number column and skip a required
- * one. They now run the same `coerceDocumentValues` + `validateDocument` pair
- * the console and `/v1` do: a value is stored in its field's type, and a
- * record with any refused field is not written at all. The caller decides
- * what a refusal costs — a form keeps the Inbox submission, a run records a
- * failed step.
- *
- * `existing` makes it a merge (update-or-append's update leg): this write's
- * values are laid over the stored ones, and only the fields THIS write
- * supplied are held to the model. A stored row written as text before this
- * change keeps its text values and is not refused for them — the reads have
- * always rendered them, and a merge that touched `email` must not fail over a
- * legacy `price` of `"12"` it never sent.
- *
- * Custom field types validate only once registered: call
- * `ensureDeclaredCustomFieldTypes(model)` before this on a server path.
- */ export function prepareDatasetRecordWrite(dataset, input, options = {}) {
-    const model = effectiveDatasetModel(dataset);
-    const picked = pickDatasetRecordInput(dataset, input, options.fieldMap);
-    const matched = Object.keys(picked);
-    const coerced = coerceDocumentValues(model, asTextInput(model, picked));
-    if (!options.existing) {
-        return {
-            matched,
-            values: coerced,
-            errors: validateDocument(model, coerced)
-        };
-    }
-    const values = _extends({}, options.existing, coerced);
-    const errors = {};
-    for (const [fieldId, error] of Object.entries(validateDocument(model, values))){
-        if (fieldId in coerced) errors[fieldId] = error;
-    }
-    return {
-        matched,
-        values,
-        errors
-    };
-}
-/**
- * A refused write's errors as one line, in the model's field order:
- * `Stars must be a whole number; Email is required`.
- */ export function describeDatasetRecordErrors(errors) {
-    return Object.values(errors).join('; ');
-}
-/**
- * The name a dataset is shown under: `displayName`, which is what every create
- * path writes (AGL-536), then the pre-migration `name`. Blank when the document
- * carries neither.
- */ export function datasetDisplayName(dataset) {
-    for (const candidate of [
-        dataset == null ? void 0 : dataset.displayName,
-        dataset == null ? void 0 : dataset.name
-    ]){
-        if (typeof candidate === 'string' && candidate.trim()) {
-            return candidate.trim();
-        }
-    }
-    return '';
-}
-/** Records sorted by their editor order (then id for stability). */ export function sortDatasetRecords(records) {
-    return [
-        ...records
-    ].sort((a, b)=>{
-        var _a_order, _b_order, _a_$id, _b_$id;
-        return ((_a_order = a.order) != null ? _a_order : Number.MAX_SAFE_INTEGER) - ((_b_order = b.order) != null ? _b_order : Number.MAX_SAFE_INTEGER) || String((_a_$id = a.$id) != null ? _a_$id : '').localeCompare(String((_b_$id = b.$id) != null ? _b_$id : ''));
-    });
-}
-
-//# sourceMappingURL=datasets.js.map

package/src/lib/app-utils/datasets.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/datasets.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Datasets (AGL-102): tabular data at `orgs/{orgId}/datasets/{id}` with a\n * `records` subcollection, edited in the console Data card and consumed by\n * repeatable components (AGL-103) via `{{item.field}}` bindings.\n */\n\nimport {\n  coerceDocumentValues,\n  type DatasetModel,\n  effectiveDatasetModel,\n  validateDocument,\n} from './dataset-models'\n\n/** Dataset field name: starts with a letter; letters/digits/underscores. */\nexport const DATASET_FIELD_PATTERN = /^[A-Za-z][A-Za-z0-9_]*$/\n\nexport interface HostDataset {\n  $id?: string\n  displayName?: string\n  /** Column names, in display order (v1; superseded by `model`). */\n  fields?: string[]\n  /** Typed model (AGL-177); when absent, derive from `fields`. */\n  model?: import('./dataset-models').DatasetModel\n  /** dod.ts Schema.Name shape (AGL-178). */\n  names?: { singular?: string; plural?: string }\n  /**\n   * Which sites may see this dataset (AGL-1037). Absent = org-wide, until\n   * the AGL-1040 backfill stamps it. See `app-utils/scope-tokens`.\n   */\n  visibleTo?: import('../foundation').ScopeToken[]\n}\n\nexport interface HostDatasetRecord {\n  $id?: string\n  /**\n   * Field → value, in storage form per the field's type (see\n   * `dataset-models`). Rows written by a form or an automation step before\n   * AGL-2773 hold every value as text; readers accept both.\n   */\n  values?: Record<string, unknown>\n  /** Row position in the editor and in repeated output. */\n  order?: number\n}\n\n/**\n * A human field entry from the quick creator: the stable id plus the\n * display name shown in table headers and bindings pickers (AGL-558).\n */\nexport interface DatasetFieldEntry {\n  id: string\n  name: string\n}\n\n/**\n * Stable field id from a human name: \"Roast preference\" → \"roast_preference\".\n * Mirrors DATASET_FIELD_PATTERN; returns '' when nothing salvageable.\n */\nexport function slugifyDatasetFieldId(name: string): string {\n  const slug = name\n    .trim()\n    .toLowerCase()\n    .replace(/[\\s-]+/g, '_')\n    .replace(/[^a-z0-9_]/g, '')\n    .replace(/^[0-9_]+/, '')\n    .replace(/_+$/, '')\n  return DATASET_FIELD_PATTERN.test(slug) ? slug : ''\n}\n\n/**\n * Default reference id for a new field (AGL-578): the `slugifyDatasetFieldId`\n * slug, suffixed (`_2`, `_3`, …) to stay unique within the dataset. `taken`\n * holds the ids already in use (compared case-insensitively). Returns '' when\n * the name yields nothing valid. The user can override the result.\n */\nexport function defaultDatasetFieldId(\n  name: string,\n  taken: ReadonlySet<string>,\n): string {\n  const base = slugifyDatasetFieldId(name)\n  if (!base) return ''\n  const used = new Set([...taken].map((id) => id.toLowerCase()))\n  let candidate = base\n  let suffix = 2\n  while (used.has(candidate.toLowerCase())) candidate = `${base}_${suffix++}`\n  return candidate\n}\n\n/**\n * Validate a user-entered reference id (AGL-578): non-empty, matches\n * `DATASET_FIELD_PATTERN`, and unique within the dataset (`taken` = ids already\n * used, compared case-insensitively). Returns an error message, or null when\n * the id is usable.\n */\nexport function validateDatasetFieldId(\n  id: string,\n  taken: ReadonlySet<string>,\n): string | null {\n  const trimmed = id.trim()\n  if (!trimmed) return 'A reference ID is required'\n  if (!DATASET_FIELD_PATTERN.test(trimmed))\n    return 'Start with a letter; use only letters, numbers, and underscores'\n  const used = new Set([...taken].map((existing) => existing.toLowerCase()))\n  if (used.has(trimmed.toLowerCase()))\n    return 'Another field already uses this reference ID'\n  return null\n}\n\n/** Display fallback for raw ids: \"roast_preference\" → \"Roast preference\". */\nexport function humanizeDatasetFieldId(id: string): string {\n  const words = id.replace(/_/g, ' ').trim()\n  return words ? words.charAt(0).toUpperCase() + words.slice(1) : id\n}\n\n/**\n * Parses a comma/newline separated list of HUMAN field names into\n * {id, name} entries — \"Roast preference\" keeps its pretty name and gets\n * the stable id `roast_preference` (AGL-558). Plain snake_case keys\n * still work and pick up a humanized display name. Duplicate ids and\n * unsalvageable entries are dropped rather than failing the set.\n */\nexport function parseDatasetFieldEntries(input: string): DatasetFieldEntry[] {\n  const seen = new Set<string>()\n  const entries: DatasetFieldEntry[] = []\n  for (const raw of input.split(/[,\\n]/)) {\n    const trimmed = raw.trim()\n    if (!trimmed) continue\n    const id = slugifyDatasetFieldId(trimmed)\n    if (!id || seen.has(id)) continue\n    seen.add(id)\n    entries.push({\n      id,\n      name: DATASET_FIELD_PATTERN.test(trimmed)\n        ? humanizeDatasetFieldId(trimmed)\n        : trimmed,\n    })\n  }\n  return entries\n}\n\n/**\n * Parses a comma/newline separated field list into valid unique names;\n * invalid entries are dropped rather than failing the whole set.\n */\nexport function parseDatasetFields(input: string): string[] {\n  const seen = new Set<string>()\n  const fields: string[] = []\n  for (const raw of input.split(/[,\\n]/)) {\n    const name = raw.trim()\n    if (!DATASET_FIELD_PATTERN.test(name)) continue\n    const key = name.toLowerCase()\n    if (seen.has(key)) continue\n    seen.add(key)\n    fields.push(name)\n  }\n  return fields\n}\n\n/** Record values restricted to the dataset's declared fields. */\nexport function sanitizeRecordValues(\n  fields: string[],\n  input: Record<string, unknown> | null | undefined,\n): Record<string, string> {\n  const values: Record<string, string> = {}\n  for (const field of fields) {\n    const value = input?.[field]\n    if (value == null) continue\n    values[field] = String(value)\n  }\n  return values\n}\n\n/**\n * The submitted values a dataset write would store, picked by field id and\n * left as they arrived (AGL-556). With a `fieldMap` (submitted key → stable\n * model fieldId), mapped values land under the mapped fieldId — so renamed\n * schema fields keep receiving data — and entries whose fieldId isn't in the\n * model are dropped. Submitted keys without a mapping (and calls without a\n * map) fall back to the legacy name-intersection against the model's field\n * ids, matching `sanitizeRecordValues`.\n */\nexport function pickDatasetRecordInput(\n  dataset: { model?: DatasetModel; fields?: string[] },\n  input: Record<string, unknown> | null | undefined,\n  fieldMap?: Record<string, string> | null,\n): Record<string, unknown> {\n  const model = effectiveDatasetModel(dataset)\n  const map = fieldMap ?? {}\n  const values: Record<string, unknown> = {}\n  for (const fieldId of model.order) {\n    if (!model.fields[fieldId]) continue\n    // A submitted key with an explicit mapping never doubles as a\n    // name-match — the mapping decides where it lands.\n    if (fieldId in map) continue\n    const value = input?.[fieldId]\n    if (value == null) continue\n    values[fieldId] = value\n  }\n  for (const [submittedKey, fieldId] of Object.entries(map)) {\n    if (typeof fieldId !== 'string' || !model.fields[fieldId]) continue\n    const value = input?.[submittedKey]\n    if (value == null) continue\n    values[fieldId] = value\n  }\n  return values\n}\n\n/** A dataset record write, checked against the dataset's model. */\nexport interface DatasetRecordWrite {\n  /**\n   * The model fields this write supplied a value for, before coercion. Empty\n   * means nothing submitted matched a field of the dataset.\n   */\n  matched: string[]\n  /**\n   * The values to store, in storage form (see `dataset-models`): numbers,\n   * booleans, epoch millis and so on per the field's type. For a merge, the\n   * existing values with this write's laid over them.\n   */\n  values: Record<string, unknown>\n  /** fieldId → the reason it was refused. Empty when the write may land. */\n  errors: Record<string, string>\n}\n\n/**\n * A text field takes what an event payload carries as a number or a boolean\n * as the text it reads as, which is what these writes always stored.\n */\nfunction asTextInput(\n  model: DatasetModel,\n  picked: Record<string, unknown>,\n): Record<string, unknown> {\n  const values: Record<string, unknown> = {}\n  for (const [fieldId, value] of Object.entries(picked)) {\n    const type = model.fields[fieldId]?.type\n    values[fieldId] =\n      (type === 'text' || type === 'reference') &&\n      (typeof value === 'number' || typeof value === 'boolean')\n        ? String(value)\n        : value\n  }\n  return values\n}\n\n/**\n * A record write from a form submission or an automation step, coerced and\n * validated against the dataset's model (AGL-2773, option B).\n *\n * These writes used to store `String(value)` for every field and check\n * nothing, so a form could put `abc` in a number column and skip a required\n * one. They now run the same `coerceDocumentValues` + `validateDocument` pair\n * the console and `/v1` do: a value is stored in its field's type, and a\n * record with any refused field is not written at all. The caller decides\n * what a refusal costs — a form keeps the Inbox submission, a run records a\n * failed step.\n *\n * `existing` makes it a merge (update-or-append's update leg): this write's\n * values are laid over the stored ones, and only the fields THIS write\n * supplied are held to the model. A stored row written as text before this\n * change keeps its text values and is not refused for them — the reads have\n * always rendered them, and a merge that touched `email` must not fail over a\n * legacy `price` of `\"12\"` it never sent.\n *\n * Custom field types validate only once registered: call\n * `ensureDeclaredCustomFieldTypes(model)` before this on a server path.\n */\nexport function prepareDatasetRecordWrite(\n  dataset: { model?: DatasetModel; fields?: string[] },\n  input: Record<string, unknown> | null | undefined,\n  options: {\n    fieldMap?: Record<string, string> | null\n    existing?: Record<string, unknown> | null\n  } = {},\n): DatasetRecordWrite {\n  const model = effectiveDatasetModel(dataset)\n  const picked = pickDatasetRecordInput(dataset, input, options.fieldMap)\n  const matched = Object.keys(picked)\n  const coerced = coerceDocumentValues(model, asTextInput(model, picked))\n  if (!options.existing) {\n    return {\n      matched,\n      values: coerced,\n      errors: validateDocument(model, coerced),\n    }\n  }\n  const values = { ...options.existing, ...coerced }\n  const errors: Record<string, string> = {}\n  for (const [fieldId, error] of Object.entries(\n    validateDocument(model, values),\n  )) {\n    if (fieldId in coerced) errors[fieldId] = error\n  }\n  return { matched, values, errors }\n}\n\n/**\n * A refused write's errors as one line, in the model's field order:\n * `Stars must be a whole number; Email is required`.\n */\nexport function describeDatasetRecordErrors(\n  errors: Record<string, string>,\n): string {\n  return Object.values(errors).join('; ')\n}\n\n/**\n * The name a dataset is shown under: `displayName`, which is what every create\n * path writes (AGL-536), then the pre-migration `name`. Blank when the document\n * carries neither.\n */\nexport function datasetDisplayName(\n  dataset: { displayName?: unknown; name?: unknown } | null | undefined,\n): string {\n  for (const candidate of [dataset?.displayName, dataset?.name]) {\n    if (typeof candidate === 'string' && candidate.trim()) {\n      return candidate.trim()\n    }\n  }\n  return ''\n}\n\n/** Records sorted by their editor order (then id for stability). */\nexport function sortDatasetRecords<T extends HostDatasetRecord>(\n  records: T[],\n): T[] {\n  return [...records].sort(\n    (a, b) =>\n      (a.order ?? Number.MAX_SAFE_INTEGER) -\n        (b.order ?? Number.MAX_SAFE_INTEGER) ||\n      String(a.$id ?? '').localeCompare(String(b.$id ?? '')),\n  )\n}\n"],"names":["coerceDocumentValues","effectiveDatasetModel","validateDocument","DATASET_FIELD_PATTERN","slugifyDatasetFieldId","name","slug","trim","toLowerCase","replace","test","defaultDatasetFieldId","taken","base","used","Set","map","id","candidate","suffix","has","validateDatasetFieldId","trimmed","existing","humanizeDatasetFieldId","words","charAt","toUpperCase","slice","parseDatasetFieldEntries","input","seen","entries","raw","split","add","push","parseDatasetFields","fields","key","sanitizeRecordValues","values","field","value","String","pickDatasetRecordInput","dataset","fieldMap","model","fieldId","order","submittedKey","Object","asTextInput","picked","type","prepareDatasetRecordWrite","options","matched","keys","coerced","errors","error","describeDatasetRecordErrors","join","datasetDisplayName","displayName","sortDatasetRecords","records","sort","a","b","Number","MAX_SAFE_INTEGER","$id","localeCompare"],"mappings":"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"}