@mostlyrightmd/core 1.1.2 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @mostlyrightmd/core
 
-Core types, schemas, and primitives for the [mostlyright](https://github.com/mostlyrightmd/mostlyright-sdk) TypeScript SDK: the `research()` join, snapshot primitives, mode-2 source-pinned selectors, transforms, QC, discovery, temporal-safety, validators, formats, merge logic, and the full exception hierarchy. Mirrors the Python `mostlyrightmd` distribution.
+The TypeScript core of the [mostlyright](https://github.com/mostlyrightmd/mostlyright-sdk) SDK — for quants, ML pipelines, and AI agents working with public weather data + prediction-market settlements. Provides core types, schemas, validators, temporal-safety primitives, the `research()` join, snapshot primitives, mode-2 source-pinned selectors, transforms, QC, discovery, formats, merge logic, and the full exception hierarchy. Mirrors the Python `mostlyrightmd` distribution.
 
 ## Install
 

package/dist/discovery/index.cjs

@@ -1100,6 +1100,40 @@ var TradewindsError = class extends Error {
     return safe;
   }
 };
+var DATA_AVAILABILITY_REASONS = [
+  "model_unavailable",
+  "out_of_window",
+  "cache_miss",
+  "source_404",
+  "source_5xx",
+  "rate_limited"
+];
+var DataAvailabilityError = class extends TradewindsError {
+  static defaultErrorCode = "DATA_AVAILABILITY";
+  reason;
+  hint;
+  constructor(options) {
+    if (!DATA_AVAILABILITY_REASONS.includes(options.reason)) {
+      throw new RangeError(
+        `DataAvailabilityError: unknown reason "${String(options.reason)}". Valid reasons: ${DATA_AVAILABILITY_REASONS.join(", ")}`
+      );
+    }
+    if (typeof options.hint !== "string" || options.hint.length === 0) {
+      throw new TypeError("DataAvailabilityError: hint is required and must be a non-empty string");
+    }
+    const message = `[${options.reason}] ${options.hint}`;
+    super(message, options);
+    this.reason = options.reason;
+    this.hint = options.hint;
+  }
+  payload() {
+    return {
+      ...super.payload(),
+      reason: this.reason,
+      hint: this.hint
+    };
+  }
+};
 
 // src/formats/toon.ts
 var SAFE_KEY_RE = /^[A-Za-z_][A-Za-z0-9_.]*$/;
@@ -1617,17 +1651,20 @@ var FEATURE_NAMES = Object.freeze([
 function featureCatalog() {
   return FEATURE_NAMES;
 }
+var CLIMATE_GAPS_HINT = "climateGaps() is server-only in v1.x. Architectural reason: GHCNh CSVs are 10+ MB per station-year; browser fetch doesn't slice (no HTTP Range) and IndexedDB quotas don't fit the working set. Use the Python SDK (mostlyright.discover.climate_gaps) for v1.x, or wait for the hosted climate-gap-precompute API (target: post-v1.x). See https://mostlyright.md/docs/sdk/typescript/climate-gaps for details.";
 function climateGaps(_station, _fromDate, _toDate) {
-  throw new ClimateGapsNotImplementedError(
-    "climateGaps is Python-only in v0.1.0; the TS climate cache lands in v0.2"
-  );
+  throw new ClimateGapsNotImplementedError();
 }
-var ClimateGapsNotImplementedError = class extends TradewindsError {
-  constructor(message) {
-    super(message);
+var ClimateGapsNotImplementedError = class extends DataAvailabilityError {
+  static defaultErrorCode = "DATA_AVAILABILITY";
+  constructor() {
+    super({
+      reason: "model_unavailable",
+      source: "climate-cache-browser",
+      hint: CLIMATE_GAPS_HINT
+    });
     this.name = "ClimateGapsNotImplementedError";
   }
-  static defaultErrorCode = "NOT_IMPLEMENTED";
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {