@welldot/core 0.4.0-next.20261015.d7c7365 → 0.5.0

package/dist/index.cjs

@@ -24,6 +24,8 @@ __export(index_exports, {
   AirliftEventSchema: () => AirliftEventSchema,
   AquiferAnalysisSchema: () => AquiferAnalysisSchema,
   AttachmentSchema: () => AttachmentSchema,
+  BAROMETRIC_COMPENSATIONS: () => BAROMETRIC_COMPENSATIONS,
+  BAROMETRIC_COMPENSATION_VALUES: () => BAROMETRIC_COMPENSATION_VALUES,
   BLANK_SAMPLE_TYPES: () => BLANK_SAMPLE_TYPES,
   BR_GM_MS_888_2021: () => BR_GM_MS_888_2021,
   BoreHoleSchema: () => BoreHoleSchema,
@@ -59,6 +61,8 @@ __export(index_exports, {
   LithologySchema: () => LithologySchema,
   LocationPropertiesSchema: () => LocationPropertiesSchema,
   LocationSchema: () => LocationSchema,
+  LoggerReadingSchema: () => LoggerReadingSchema,
+  LoggerSeriesEventSchema: () => LoggerSeriesEventSchema,
   MAINTENANCE_TYPES: () => MAINTENANCE_TYPES,
   MEASURED_IN_VALUES: () => MEASURED_IN_VALUES,
   MEASUREMENT_LOCATIONS: () => MEASUREMENT_LOCATIONS,
@@ -93,6 +97,8 @@ __export(index_exports, {
   PurgeReadingSchema: () => PurgeReadingSchema,
   PurgeSchema: () => PurgeSchema,
   QUALIFIER_VALUES: () => QUALIFIER_VALUES,
+  READING_AGGREGATIONS: () => READING_AGGREGATIONS,
+  READING_AGGREGATION_VALUES: () => READING_AGGREGATION_VALUES,
   READING_SOURCES: () => READING_SOURCES,
   RESULT_FRACTIONS: () => RESULT_FRACTIONS,
   RESULT_QUALIFIERS: () => RESULT_QUALIFIERS,
@@ -124,6 +130,7 @@ __export(index_exports, {
   WATER_QUALITY_UNITS: () => WATER_QUALITY_UNITS,
   WATER_QUALITY_VOCABULARY_VERSION: () => WATER_QUALITY_VOCABULARY_VERSION,
   WATER_USES: () => WATER_USES,
+  WELL_FORMAT_VERSION: () => WELL_FORMAT_VERSION,
   WELL_PURPOSES: () => WELL_PURPOSES,
   WELL_STATUSES: () => WELL_STATUSES,
   WELL_STATUS_VALUES: () => WELL_STATUS_VALUES,
@@ -138,6 +145,7 @@ __export(index_exports, {
   WellStatusSchema: () => WellStatusSchema,
   calculatedWellDepth: () => calculatedWellDepth,
   checkIfProfileIsEmpty: () => checkIfProfileIsEmpty,
+  compareFormatVersions: () => compareFormatVersions,
   concentrationFromCanonical: () => concentrationFromCanonical,
   concentrationToCanonical: () => concentrationToCanonical,
   convertProfileFromJSON: () => convertProfileFromJSON,
@@ -165,6 +173,7 @@ __export(index_exports, {
   hoursToMinutes: () => hoursToMinutes,
   hpToKilowatts: () => hpToKilowatts,
   inchesToMm: () => inchesToMm,
+  isIanaTimeZone: () => isIanaTimeZone,
   isKnownParameter: () => isKnownParameter,
   isVocabValue: () => isVocabValue,
   isWellEmpty: () => isWellEmpty,
@@ -181,6 +190,7 @@ __export(index_exports, {
   mmToSlotNumber: () => mmToSlotNumber,
   normalizeColorUnit: () => normalizeColorUnit,
   parameterKey: () => parameterKey,
+  parseFormatVersion: () => parseFormatVersion,
   parseWell: () => parseWell,
   powerFromCanonical: () => powerFromCanonical,
   powerToCanonical: () => powerToCanonical,
@@ -204,6 +214,215 @@ module.exports = __toCommonJS(index_exports);
 // src/validators/well.validators.ts
 var import_defu = require("defu");
 var import_zod = require("zod");
+
+// src/utils/timezone.utils.ts
+var IANA_SHAPE = /^[A-Za-z][A-Za-z0-9_+\-/]*$/;
+function isIanaTimeZone(value) {
+  if (!IANA_SHAPE.test(value)) return false;
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: value });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/utils/version.utils.ts
+var WELL_FORMAT_VERSION = "2.4";
+var VERSION_PATTERN = /^(\d+)\.(\d+)$/;
+function parseFormatVersion(value) {
+  if (typeof value === "number") {
+    return Number.isInteger(value) && value >= 0 ? { major: value, minor: void 0 } : void 0;
+  }
+  if (typeof value === "string") {
+    const match = VERSION_PATTERN.exec(value);
+    if (match) return { major: Number(match[1]), minor: Number(match[2]) };
+  }
+  return void 0;
+}
+function compareFormatVersions(a, b) {
+  const pa = parseFormatVersion(a);
+  const pb = parseFormatVersion(b);
+  if (!pa || pb === void 0 || pa.minor === void 0 || pb.minor === void 0) {
+    throw new Error(
+      `Malformed .well format version: ${JSON.stringify(pa?.minor === void 0 ? a : b)}`
+    );
+  }
+  return pa.major - pb.major || pa.minor - pb.minor;
+}
+
+// src/vocab/closed.vocab.ts
+function closedVocab() {
+  return (entries) => entries;
+}
+var valuesOf = (vocab) => vocab.map((entry) => entry.value);
+var WELL_STATUSES = closedVocab()([
+  { value: "active", label: { en: "Active", pt: "Ativo" } },
+  {
+    value: "maintenance",
+    label: { en: "Under maintenance", pt: "Em manuten\xE7\xE3o" }
+  },
+  { value: "inactive", label: { en: "Inactive", pt: "Paralisado" } },
+  {
+    value: "decommissioned",
+    label: { en: "Decommissioned", pt: "Desativado" }
+  },
+  { value: "abandoned", label: { en: "Abandoned", pt: "Abandonado" } }
+]);
+var PERMIT_ADMINISTRATIVE_STATUSES = closedVocab()([
+  { value: "requested", label: { en: "Requested", pt: "Requerida" } },
+  { value: "granted", label: { en: "Granted", pt: "Concedida" } },
+  { value: "suspended", label: { en: "Suspended", pt: "Suspensa" } },
+  { value: "revoked", label: { en: "Revoked", pt: "Revogada" } },
+  { value: "denied", label: { en: "Denied", pt: "Indeferida" } },
+  { value: "withdrawn", label: { en: "Withdrawn", pt: "Cancelada" } }
+]);
+var VOLUME_LIMIT_PERIODS = closedVocab()([
+  { value: "daily", label: { en: "Daily", pt: "Di\xE1rio" } },
+  { value: "monthly", label: { en: "Monthly", pt: "Mensal" } },
+  { value: "annual", label: { en: "Annual", pt: "Anual" } }
+]);
+var PRODUCTION_ENTRY_TYPES = closedVocab()([
+  {
+    value: "meter_reading",
+    label: { en: "Meter reading", pt: "Leitura de hidr\xF4metro" }
+  },
+  {
+    value: "estimated_volume",
+    label: { en: "Estimated volume", pt: "Volume estimado" }
+  }
+]);
+var RESULT_QUALIFIERS = closedVocab()([
+  { value: "<", label: { en: "< less than", pt: "< menor que" } },
+  { value: ">", label: { en: "> greater than", pt: "> maior que" } },
+  { value: "not_detected", label: { en: "Not detected", pt: "N\xE3o detectado" } },
+  { value: "estimated", label: { en: "Estimated", pt: "Estimado" } }
+]);
+var RESULT_FRACTIONS = closedVocab()([
+  { value: "total", label: { en: "Total", pt: "Total" } },
+  { value: "dissolved", label: { en: "Dissolved", pt: "Dissolvida" } },
+  { value: "suspended", label: { en: "Suspended", pt: "Suspensa" } }
+]);
+var MEASUREMENT_LOCATIONS = closedVocab()([
+  { value: "field", label: { en: "Field", pt: "Campo" } },
+  { value: "lab", label: { en: "Lab", pt: "Laborat\xF3rio" } }
+]);
+var VALIDATION_STATUSES = closedVocab()([
+  { value: "unvalidated", label: { en: "Unvalidated", pt: "N\xE3o validado" } },
+  { value: "validated", label: { en: "Validated", pt: "Validado" } },
+  { value: "qualified", label: { en: "Qualified", pt: "Qualificado" } },
+  { value: "rejected", label: { en: "Rejected", pt: "Rejeitado" } }
+]);
+var PARAMETER_GROUPS = closedVocab()([
+  {
+    value: "physical",
+    label: { en: "Physical / field", pt: "F\xEDsico / campo" }
+  },
+  { value: "aggregate", label: { en: "Aggregate", pt: "Agregados" } },
+  { value: "major_ion", label: { en: "Major ions", pt: "\xCDons maiores" } },
+  { value: "nutrient", label: { en: "Nutrients", pt: "Nutrientes" } },
+  { value: "organic", label: { en: "Organic", pt: "Org\xE2nicos" } },
+  { value: "disinfection", label: { en: "Disinfection", pt: "Desinfec\xE7\xE3o" } },
+  {
+    value: "mining_redox",
+    label: { en: "Mining and redox", pt: "Minera\xE7\xE3o e redox" }
+  },
+  { value: "metal", label: { en: "Metals / trace", pt: "Metais / tra\xE7o" } },
+  { value: "microbiology", label: { en: "Microbiology", pt: "Microbiologia" } },
+  {
+    value: "radioactivity",
+    label: { en: "Radioactivity", pt: "Radioatividade" }
+  }
+]);
+var BAROMETRIC_COMPENSATIONS = closedVocab()([
+  { value: "barologger", label: { en: "Barologger", pt: "Barologger" } },
+  { value: "vented", label: { en: "Vented cable", pt: "Cabo ventilado" } },
+  { value: "none", label: { en: "None", pt: "Nenhuma" } }
+]);
+var READING_AGGREGATIONS = closedVocab()([
+  { value: "none", label: { en: "Raw readings", pt: "Leituras brutas" } },
+  { value: "hourly", label: { en: "Hourly", pt: "Hor\xE1ria" } },
+  { value: "daily", label: { en: "Daily", pt: "Di\xE1ria" } }
+]);
+var WELL_STATUS_VALUES = valuesOf(WELL_STATUSES);
+var PERMIT_ADMINISTRATIVE_STATUS_VALUES = valuesOf(
+  PERMIT_ADMINISTRATIVE_STATUSES
+);
+var QUALIFIER_VALUES = valuesOf(RESULT_QUALIFIERS);
+var FRACTION_VALUES = valuesOf(RESULT_FRACTIONS);
+var MEASURED_IN_VALUES = valuesOf(MEASUREMENT_LOCATIONS);
+var FILTRATION_LOCATION_VALUES = valuesOf(MEASUREMENT_LOCATIONS);
+var VALIDATION_STATUS_VALUES = valuesOf(VALIDATION_STATUSES);
+var PARAMETER_GROUP_VALUES = valuesOf(PARAMETER_GROUPS);
+var BAROMETRIC_COMPENSATION_VALUES = valuesOf(
+  BAROMETRIC_COMPENSATIONS
+);
+var READING_AGGREGATION_VALUES = valuesOf(READING_AGGREGATIONS);
+var NUMERIC_QUALIFIERS = [
+  "<",
+  ">",
+  "estimated"
+];
+var PARENT_SAMPLE_TYPES = [
+  "field_duplicate",
+  "split_sample"
+];
+var BLANK_SAMPLE_TYPES = [
+  "field_blank",
+  "trip_blank",
+  "equipment_blank"
+];
+
+// src/vocab/hydrodynamic.vocab.ts
+var HYDRODYNAMIC_EVENT_TYPES = [
+  {
+    value: "spot_measurement",
+    label: { en: "Spot measurement", pt: "Medi\xE7\xE3o pontual" }
+  },
+  {
+    value: "constant_rate",
+    label: { en: "Constant rate", pt: "Vaz\xE3o constante" }
+  },
+  { value: "step_drawdown", label: { en: "Step drawdown", pt: "Escalonada" } },
+  { value: "airlift", label: { en: "Air-lift", pt: "Air-lift" } },
+  {
+    value: "recovery_only",
+    label: { en: "Recovery only", pt: "Recupera\xE7\xE3o" }
+  },
+  {
+    value: "logger_series",
+    label: { en: "Logger series", pt: "S\xE9rie de datalogger" }
+  }
+];
+var MEASUREMENT_METHODS = [
+  {
+    value: "electric_probe",
+    label: { en: "Electric probe", pt: "Sonda el\xE9trica" }
+  },
+  {
+    value: "pressure_transducer",
+    label: { en: "Pressure transducer", pt: "Transdutor de press\xE3o" }
+  },
+  { value: "air_line", label: { en: "Air line", pt: "Linha de ar" } },
+  { value: "tape", label: { en: "Tape", pt: "Trena" } }
+];
+var AQUIFER_ANALYSIS_METHODS = [
+  { value: "cooper_jacob", label: { en: "Cooper-Jacob", pt: "Cooper-Jacob" } },
+  { value: "theis", label: { en: "Theis", pt: "Theis" } },
+  { value: "neuman", label: { en: "Neuman", pt: "Neuman" } },
+  { value: "hantush", label: { en: "Hantush", pt: "Hantush" } },
+  {
+    value: "birsoy_summers",
+    label: { en: "Birsoy-Summers", pt: "Birsoy-Summers" }
+  },
+  { value: "eden_hazel", label: { en: "Eden-Hazel", pt: "Eden-Hazel" } },
+  {
+    value: "visual_inspection",
+    label: { en: "Visual inspection", pt: "Inspe\xE7\xE3o visual" }
+  }
+];
+
+// src/validators/well.validators.ts
 var mergeWell = (0, import_defu.createDefu)((obj, key, value) => {
   if (Array.isArray(value)) {
     obj[key] = value;
@@ -246,7 +465,8 @@ var LocationPropertiesSchema = import_zod.z.object({
   lat_precision: import_zod.z.number().optional(),
   lng_precision: import_zod.z.number().optional(),
   elevation_precision: import_zod.z.number().optional(),
-  original_crs: import_zod.z.string().optional()
+  original_crs: import_zod.z.string().optional(),
+  timezone: import_zod.z.string().refine(isIanaTimeZone, "timezone must be an IANA time zone name").optional()
 });
 var LocationSchema = import_zod.z.object({
   lat: import_zod.z.number(),
@@ -337,6 +557,7 @@ var CaveSchema = import_zod.z.object({
 });
 var LevelReadingSchema = import_zod.z.object({
   elapsed: import_zod.z.number(),
+  datetime: rfc3339().optional(),
   depth: import_zod.z.number(),
   depth_precision: import_zod.z.number().optional(),
   pressure: import_zod.z.number().optional()
@@ -366,14 +587,16 @@ var SpotMeasurementEventSchema = HydrodynamicEventBaseSchema.extend({
   static_level: import_zod.z.number(),
   static_level_precision: import_zod.z.number().optional(),
   measurement_method: import_zod.z.string().optional(),
-  steps: import_zod.z.array(PumpingStepSchema).max(1).optional(),
+  // SHOULD carry at most one step; another count is valid (v2.4).
+  steps: import_zod.z.array(PumpingStepSchema).optional(),
   recovery: RecoveryPhaseSchema.optional()
 });
 var ConstantRateEventSchema = HydrodynamicEventBaseSchema.extend({
   type: import_zod.z.literal("constant_rate"),
   static_level: import_zod.z.number().optional(),
   static_level_precision: import_zod.z.number().optional(),
-  steps: import_zod.z.tuple([PumpingStepSchema]).optional(),
+  // SHOULD carry exactly one step; another count is valid (v2.4).
+  steps: import_zod.z.array(PumpingStepSchema).optional(),
   recovery: RecoveryPhaseSchema.optional()
 });
 var StepDrawdownEventSchema = HydrodynamicEventBaseSchema.extend({
@@ -394,13 +617,62 @@ var RecoveryOnlyEventSchema = HydrodynamicEventBaseSchema.extend({
   pumping_duration: import_zod.z.number().optional(),
   recovery: RecoveryPhaseSchema
 });
+var LoggerReadingSchema = import_zod.z.object({
+  datetime: rfc3339(),
+  elapsed: import_zod.z.undefined({ message: "logger_series readings use datetime, not elapsed" }).optional(),
+  depth: import_zod.z.number(),
+  depth_precision: import_zod.z.number().optional(),
+  pressure: import_zod.z.number().optional(),
+  depth_min: import_zod.z.number().optional(),
+  depth_max: import_zod.z.number().optional()
+});
+var closedEnum = (values) => import_zod.z.enum(values);
+var LoggerSeriesEventSchema = HydrodynamicEventBaseSchema.extend({
+  type: import_zod.z.literal("logger_series"),
+  measurement_method: import_zod.z.string().optional(),
+  sensor_depth: import_zod.z.number().optional(),
+  interval: import_zod.z.number().positive().optional(),
+  barometric_compensation: closedEnum(
+    BAROMETRIC_COMPENSATION_VALUES
+  ).optional(),
+  aggregation: closedEnum(READING_AGGREGATION_VALUES).optional(),
+  readings: import_zod.z.array(LoggerReadingSchema).min(1),
+  steps: import_zod.z.undefined({ message: "logger_series carries no steps" }).optional(),
+  recovery: import_zod.z.undefined({ message: "logger_series carries no recovery" }).optional()
+});
+var HYDRODYNAMIC_TYPES = HYDRODYNAMIC_EVENT_TYPES.map(
+  (t) => t.value
+);
 var HydrodynamicEventSchema = import_zod.z.discriminatedUnion("type", [
   SpotMeasurementEventSchema,
   ConstantRateEventSchema,
   StepDrawdownEventSchema,
   AirliftEventSchema,
-  RecoveryOnlyEventSchema
-]).or(HydrodynamicEventBaseSchema.passthrough());
+  RecoveryOnlyEventSchema,
+  LoggerSeriesEventSchema
+]).or(
+  HydrodynamicEventBaseSchema.passthrough().refine(
+    (e) => !HYDRODYNAMIC_TYPES.includes(e.type),
+    { message: "malformed hydrodynamic event" }
+  )
+).superRefine((e, ctx) => {
+  if (e.type !== "logger_series") return;
+  const series = e;
+  if (series.aggregation !== "hourly" && series.aggregation !== "daily") {
+    return;
+  }
+  series.readings.forEach((r, i) => {
+    for (const key of ["depth_min", "depth_max"]) {
+      if (r[key] === void 0) {
+        ctx.addIssue({
+          code: import_zod.z.ZodIssueCode.custom,
+          path: ["readings", i, key],
+          message: `${key} is required in an aggregated logger_series`
+        });
+      }
+    }
+  });
+});
 var WellStatusSchema = import_zod.z.enum([
   "active",
   "maintenance",
@@ -442,7 +714,7 @@ var AquiferAnalysisSchema = import_zod.z.object({
   max_flow_rate_basis: import_zod.z.string().optional(),
   specific_capacity: import_zod.z.number().optional(),
   transmissivity: import_zod.z.number().optional(),
-  storativity: import_zod.z.number().nullable().optional(),
+  storativity: import_zod.z.number().optional(),
   hydraulic_conductivity: import_zod.z.number().optional(),
   aquifer_thickness: import_zod.z.number().optional(),
   jacob_b: import_zod.z.number().optional(),
@@ -603,7 +875,7 @@ var OperatingRegimeSchema = import_zod.z.object({
   id: import_zod.z.string(),
   effective_from: rfc3339(),
   flow_rate: import_zod.z.number().nonnegative().optional(),
-  daily_operating_time: import_zod.z.number().min(0).max(24).optional(),
+  daily_operating_time: import_zod.z.number().nonnegative().optional(),
   days_per_week: import_zod.z.number().int().min(1).max(7).optional(),
   notes: import_zod.z.string().optional(),
   updated_at: rfc3339().optional()
@@ -740,7 +1012,10 @@ var WaterSampleSchema = import_zod.z.object({
   results: import_zod.z.array(WaterQualityResultSchema).min(1)
 });
 var WellSchema = import_zod.z.object({
-  version: import_zod.z.number().int(),
+  version: import_zod.z.union([
+    import_zod.z.number().int().nonnegative(),
+    import_zod.z.string().regex(/^\d+\.\d+$/, 'version must be "M.m"')
+  ]),
   "@context": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.unknown()), import_zod.z.record(import_zod.z.unknown())]).optional(),
   well_id: import_zod.z.array(WellIdSchema).optional(),
   location: LocationSchema.optional(),
@@ -844,28 +1119,39 @@ function normalizeV1Fields(raw) {
 }
 function parseWell(json) {
   const raw = JSON.parse(json);
-  const version = raw.version;
-  if (version !== void 0 && typeof version === "number") {
-    if (version !== 1 && version !== 2) {
-      throw new Error(`Unsupported .well format version: ${version}`);
+  if (raw.version === void 0) {
+    raw.version = 2;
+  } else {
+    const parsed = parseFormatVersion(raw.version);
+    if (!parsed) {
+      throw new Error(
+        `Malformed .well format version: ${JSON.stringify(raw.version)}`
+      );
     }
-    if (version === 1) {
+    if (parsed.major === 1) {
       const normalized = normalizeV1Fields(raw);
       return mergeParsed(
         WellSchema.parse(normalized),
         normalized
       );
     }
-  } else if (version !== void 0) {
-    throw new Error(`Unsupported .well format version: ${String(version)}`);
-  } else {
-    raw.version = 2;
+    if (parsed.major !== 2) {
+      throw new Error(
+        `Unsupported .well format version: ${JSON.stringify(raw.version)}`
+      );
+    }
+  }
+  if (raw.version === 2 && Array.isArray(raw.aquifer_analysis)) {
+    for (const item of raw.aquifer_analysis) {
+      if (isPlainObject(item) && item.storativity === null) {
+        delete item.storativity;
+      }
+    }
   }
   return mergeParsed(WellSchema.parse(raw), raw);
 }
 
 // src/utils/well.utils.ts
-var WELL_FORMAT_VERSION = 2;
 var INCHES_TO_MM = 25.4;
 var LEGACY_ROOT_KEYS = /* @__PURE__ */ new Set([
   "lat",
@@ -912,7 +1198,7 @@ var VISIBILITY_LEAF_KEYS = SECTION_KEYS.flatMap(
   (section) => VISIBILITY_TREE[section].length ? VISIBILITY_TREE[section] : [section]
 );
 var EMPTY_WELL = {
-  version: 2,
+  version: WELL_FORMAT_VERSION,
   bore_hole: [],
   well_case: [],
   reduction: [],
@@ -1008,7 +1294,9 @@ function decodeV2Well(raw) {
   const rawScreens = raw.well_screen ?? [];
   const decoded = {
     ...createEmptyWell(),
-    ...raw.version !== void 0 && { version: raw.version },
+    ...raw.version !== void 0 && {
+      version: raw.version
+    },
     ...raw["@context"] !== void 0 && {
       "@context": raw["@context"]
     },
@@ -1124,6 +1412,19 @@ function unknownRootKeys(well) {
     (key) => !(key in WellSchema.shape) && !LEGACY_ROOT_KEYS.has(key)
   );
 }
+function omitNulls(value) {
+  if (Array.isArray(value)) return value.map(omitNulls);
+  if (typeof value !== "object" || value === null) return value;
+  const out = {};
+  for (const [key, member] of Object.entries(value)) {
+    if (key.startsWith("x-") || key === "@context") {
+      out[key] = member;
+    } else if (member !== null) {
+      out[key] = omitNulls(member);
+    }
+  }
+  return out;
+}
 function serializeWell(well) {
   const payload = {
     version: WELL_FORMAT_VERSION,
@@ -1180,7 +1481,7 @@ function serializeWell(well) {
     const value = well[key];
     if (value !== void 0) payload[key] = value;
   }
-  return JSON.stringify(payload);
+  return JSON.stringify(omitNulls(payload));
 }
 function isWellEmpty(well) {
   if (!well) return true;
@@ -1263,10 +1564,18 @@ function deserializeWell(jsonString) {
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
     throw new Error("Invalid profile format");
   }
-  if (typeof raw.version === "number") {
-    if (raw.version === 2) return withCalculatedWellDepth(decodeV2Well(raw));
-    if (raw.version === 1) return withCalculatedWellDepth(decodeV1Well(raw));
-    throw new Error(`Unsupported .well format version: ${raw.version}`);
+  if (raw.version !== void 0) {
+    const parsed = parseFormatVersion(raw.version);
+    if (!parsed) {
+      throw new Error(
+        `Malformed .well format version: ${JSON.stringify(raw.version)}`
+      );
+    }
+    if (parsed.major === 2) return withCalculatedWellDepth(decodeV2Well(raw));
+    if (parsed.major === 1) return withCalculatedWellDepth(decodeV1Well(raw));
+    throw new Error(
+      `Unsupported .well format version: ${JSON.stringify(raw.version)}`
+    );
   }
   if (isWellEmpty(raw)) return null;
   const constructiveSource = raw.constructive ?? raw;
@@ -2676,51 +2985,6 @@ var HISTORY_LOG_SEVERITIES = [
   { value: "critical", label: { en: "Critical", pt: "Cr\xEDtica" } }
 ];
 
-// src/vocab/hydrodynamic.vocab.ts
-var HYDRODYNAMIC_EVENT_TYPES = [
-  {
-    value: "spot_measurement",
-    label: { en: "Spot measurement", pt: "Medi\xE7\xE3o pontual" }
-  },
-  {
-    value: "constant_rate",
-    label: { en: "Constant rate", pt: "Vaz\xE3o constante" }
-  },
-  { value: "step_drawdown", label: { en: "Step drawdown", pt: "Escalonada" } },
-  { value: "airlift", label: { en: "Air-lift", pt: "Air-lift" } },
-  {
-    value: "recovery_only",
-    label: { en: "Recovery only", pt: "Recupera\xE7\xE3o" }
-  }
-];
-var MEASUREMENT_METHODS = [
-  {
-    value: "electric_probe",
-    label: { en: "Electric probe", pt: "Sonda el\xE9trica" }
-  },
-  {
-    value: "pressure_transducer",
-    label: { en: "Pressure transducer", pt: "Transdutor de press\xE3o" }
-  },
-  { value: "air_line", label: { en: "Air line", pt: "Linha de ar" } },
-  { value: "tape", label: { en: "Tape", pt: "Trena" } }
-];
-var AQUIFER_ANALYSIS_METHODS = [
-  { value: "cooper_jacob", label: { en: "Cooper-Jacob", pt: "Cooper-Jacob" } },
-  { value: "theis", label: { en: "Theis", pt: "Theis" } },
-  { value: "neuman", label: { en: "Neuman", pt: "Neuman" } },
-  { value: "hantush", label: { en: "Hantush", pt: "Hantush" } },
-  {
-    value: "birsoy_summers",
-    label: { en: "Birsoy-Summers", pt: "Birsoy-Summers" }
-  },
-  { value: "eden_hazel", label: { en: "Eden-Hazel", pt: "Eden-Hazel" } },
-  {
-    value: "visual_inspection",
-    label: { en: "Visual inspection", pt: "Inspe\xE7\xE3o visual" }
-  }
-];
-
 // src/vocab/operation.vocab.ts
 var PUMP_TYPES = [
   {
@@ -2931,114 +3195,6 @@ function vocabValues(vocab, { includeDeprecated = false } = {}) {
   return vocab.filter((entry) => includeDeprecated || !entry.deprecated).map((entry) => entry.value);
 }
 
-// src/vocab/closed.vocab.ts
-function closedVocab() {
-  return (entries) => entries;
-}
-var valuesOf = (vocab) => vocab.map((entry) => entry.value);
-var WELL_STATUSES = closedVocab()([
-  { value: "active", label: { en: "Active", pt: "Ativo" } },
-  {
-    value: "maintenance",
-    label: { en: "Under maintenance", pt: "Em manuten\xE7\xE3o" }
-  },
-  { value: "inactive", label: { en: "Inactive", pt: "Paralisado" } },
-  {
-    value: "decommissioned",
-    label: { en: "Decommissioned", pt: "Desativado" }
-  },
-  { value: "abandoned", label: { en: "Abandoned", pt: "Abandonado" } }
-]);
-var PERMIT_ADMINISTRATIVE_STATUSES = closedVocab()([
-  { value: "requested", label: { en: "Requested", pt: "Requerida" } },
-  { value: "granted", label: { en: "Granted", pt: "Concedida" } },
-  { value: "suspended", label: { en: "Suspended", pt: "Suspensa" } },
-  { value: "revoked", label: { en: "Revoked", pt: "Revogada" } },
-  { value: "denied", label: { en: "Denied", pt: "Indeferida" } },
-  { value: "withdrawn", label: { en: "Withdrawn", pt: "Cancelada" } }
-]);
-var VOLUME_LIMIT_PERIODS = closedVocab()([
-  { value: "daily", label: { en: "Daily", pt: "Di\xE1rio" } },
-  { value: "monthly", label: { en: "Monthly", pt: "Mensal" } },
-  { value: "annual", label: { en: "Annual", pt: "Anual" } }
-]);
-var PRODUCTION_ENTRY_TYPES = closedVocab()([
-  {
-    value: "meter_reading",
-    label: { en: "Meter reading", pt: "Leitura de hidr\xF4metro" }
-  },
-  {
-    value: "estimated_volume",
-    label: { en: "Estimated volume", pt: "Volume estimado" }
-  }
-]);
-var RESULT_QUALIFIERS = closedVocab()([
-  { value: "<", label: { en: "< less than", pt: "< menor que" } },
-  { value: ">", label: { en: "> greater than", pt: "> maior que" } },
-  { value: "not_detected", label: { en: "Not detected", pt: "N\xE3o detectado" } },
-  { value: "estimated", label: { en: "Estimated", pt: "Estimado" } }
-]);
-var RESULT_FRACTIONS = closedVocab()([
-  { value: "total", label: { en: "Total", pt: "Total" } },
-  { value: "dissolved", label: { en: "Dissolved", pt: "Dissolvida" } },
-  { value: "suspended", label: { en: "Suspended", pt: "Suspensa" } }
-]);
-var MEASUREMENT_LOCATIONS = closedVocab()([
-  { value: "field", label: { en: "Field", pt: "Campo" } },
-  { value: "lab", label: { en: "Lab", pt: "Laborat\xF3rio" } }
-]);
-var VALIDATION_STATUSES = closedVocab()([
-  { value: "unvalidated", label: { en: "Unvalidated", pt: "N\xE3o validado" } },
-  { value: "validated", label: { en: "Validated", pt: "Validado" } },
-  { value: "qualified", label: { en: "Qualified", pt: "Qualificado" } },
-  { value: "rejected", label: { en: "Rejected", pt: "Rejeitado" } }
-]);
-var PARAMETER_GROUPS = closedVocab()([
-  {
-    value: "physical",
-    label: { en: "Physical / field", pt: "F\xEDsico / campo" }
-  },
-  { value: "aggregate", label: { en: "Aggregate", pt: "Agregados" } },
-  { value: "major_ion", label: { en: "Major ions", pt: "\xCDons maiores" } },
-  { value: "nutrient", label: { en: "Nutrients", pt: "Nutrientes" } },
-  { value: "organic", label: { en: "Organic", pt: "Org\xE2nicos" } },
-  { value: "disinfection", label: { en: "Disinfection", pt: "Desinfec\xE7\xE3o" } },
-  {
-    value: "mining_redox",
-    label: { en: "Mining and redox", pt: "Minera\xE7\xE3o e redox" }
-  },
-  { value: "metal", label: { en: "Metals / trace", pt: "Metais / tra\xE7o" } },
-  { value: "microbiology", label: { en: "Microbiology", pt: "Microbiologia" } },
-  {
-    value: "radioactivity",
-    label: { en: "Radioactivity", pt: "Radioatividade" }
-  }
-]);
-var WELL_STATUS_VALUES = valuesOf(WELL_STATUSES);
-var PERMIT_ADMINISTRATIVE_STATUS_VALUES = valuesOf(
-  PERMIT_ADMINISTRATIVE_STATUSES
-);
-var QUALIFIER_VALUES = valuesOf(RESULT_QUALIFIERS);
-var FRACTION_VALUES = valuesOf(RESULT_FRACTIONS);
-var MEASURED_IN_VALUES = valuesOf(MEASUREMENT_LOCATIONS);
-var FILTRATION_LOCATION_VALUES = valuesOf(MEASUREMENT_LOCATIONS);
-var VALIDATION_STATUS_VALUES = valuesOf(VALIDATION_STATUSES);
-var PARAMETER_GROUP_VALUES = valuesOf(PARAMETER_GROUPS);
-var NUMERIC_QUALIFIERS = [
-  "<",
-  ">",
-  "estimated"
-];
-var PARENT_SAMPLE_TYPES = [
-  "field_duplicate",
-  "split_sample"
-];
-var BLANK_SAMPLE_TYPES = [
-  "field_blank",
-  "trip_blank",
-  "equipment_blank"
-];
-
 // src/vocab/waterSample.vocab.ts
 var SAMPLE_TYPES = [
   { value: "routine", label: { en: "Routine", pt: "Rotina" } },
@@ -3304,6 +3460,8 @@ function expandedToStandardUncertainty(expanded, coverageFactor = 2) {
   AirliftEventSchema,
   AquiferAnalysisSchema,
   AttachmentSchema,
+  BAROMETRIC_COMPENSATIONS,
+  BAROMETRIC_COMPENSATION_VALUES,
   BLANK_SAMPLE_TYPES,
   BR_GM_MS_888_2021,
   BoreHoleSchema,
@@ -3339,6 +3497,8 @@ function expandedToStandardUncertainty(expanded, coverageFactor = 2) {
   LithologySchema,
   LocationPropertiesSchema,
   LocationSchema,
+  LoggerReadingSchema,
+  LoggerSeriesEventSchema,
   MAINTENANCE_TYPES,
   MEASURED_IN_VALUES,
   MEASUREMENT_LOCATIONS,
@@ -3373,6 +3533,8 @@ function expandedToStandardUncertainty(expanded, coverageFactor = 2) {
   PurgeReadingSchema,
   PurgeSchema,
   QUALIFIER_VALUES,
+  READING_AGGREGATIONS,
+  READING_AGGREGATION_VALUES,
   READING_SOURCES,
   RESULT_FRACTIONS,
   RESULT_QUALIFIERS,
@@ -3404,6 +3566,7 @@ function expandedToStandardUncertainty(expanded, coverageFactor = 2) {
   WATER_QUALITY_UNITS,
   WATER_QUALITY_VOCABULARY_VERSION,
   WATER_USES,
+  WELL_FORMAT_VERSION,
   WELL_PURPOSES,
   WELL_STATUSES,
   WELL_STATUS_VALUES,
@@ -3418,6 +3581,7 @@ function expandedToStandardUncertainty(expanded, coverageFactor = 2) {
   WellStatusSchema,
   calculatedWellDepth,
   checkIfProfileIsEmpty,
+  compareFormatVersions,
   concentrationFromCanonical,
   concentrationToCanonical,
   convertProfileFromJSON,
@@ -3445,6 +3609,7 @@ function expandedToStandardUncertainty(expanded, coverageFactor = 2) {
   hoursToMinutes,
   hpToKilowatts,
   inchesToMm,
+  isIanaTimeZone,
   isKnownParameter,
   isVocabValue,
   isWellEmpty,
@@ -3461,6 +3626,7 @@ function expandedToStandardUncertainty(expanded, coverageFactor = 2) {
   mmToSlotNumber,
   normalizeColorUnit,
   parameterKey,
+  parseFormatVersion,
   parseWell,
   powerFromCanonical,
   powerToCanonical,