@forzalabs/remora 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -6,12 +6,19 @@ The format is based on Keep a Changelog, and this project adheres to Semantic Ve
 
 ## Unreleased
 
+## V 1.8.0 - 2026-08-05
+
 ### Added
+- Added `synth.min` / `synth.max` on a producer dimension to bound the values `synth` generates. Both ends are inclusive and either can be given alone, in which case the other spans the default range's width from it. On a `number` dimension they replace the name-based generator, so a column whose real-world range the field name can't imply (`"synth": { "min": 18, "max": 90, "decimals": 0 }`) stays inside it instead of getting a generic 0–1000 draw; values stay whole unless `decimals` asks for more, except where the range spans less than one whole number (e.g. `0.4`–`0.6`), which is generated fractionally so it doesn't collapse to a single value. On a `datetime` dimension they are date strings that replace the default 2020–2024 window — written the way the column's own values are, so with the dimension's `format` when it declares one (`"min": "20240101"` for `"YYYYMMDD"`) and as a plain/ISO date otherwise. A date bound that names a day covers that whole day, so `20240101`–`20240131` includes the 31st rather than stopping at its first instant; give a time to end the window at a precise one. Bounds apply only to `number`/`datetime` dimensions and only where the value is actually generated: setting them alongside `allowedValues`, `codeSet` or `references`, or on a key field served from a shared key pool, is rejected with an error naming the dimension rather than being silently ignored, as are an inverted range and a bound of the wrong kind for the dimension's type. `synth` only; no effect on a real producer read
+- Synthetic `datetime` values are now rendered in UTC, the timezone their bounds are parsed in, instead of the host's local timezone. A formatted date (e.g. `"format": "YYYYMMDD"`) generated west of UTC could otherwise render as the previous day — which would also put it outside a declared `synth` window — and the same seed produced different output on machines in different timezones
 - Added a new producer input type for **fixed-width (positional) flat files**: `"fileType": "FIXED"`. Such a file has no delimiter and no header, so each dimension declares where its value sits in the line with `position` — `{ "start": 21, "length": 10 }` or `{ "start": 21, "end": 30 }`, 1-based and inclusive, the way a layout spec is written ("columns 21-30"). Values are trimmed, so space- and zero-padded fields read as their real value (`"0000123.45"` → `123.45`) and an all-padding field reads as `null`; gaps (unmapped filler columns) and overlaps (a composite field plus its subfields) are both allowed; `format` still applies, so a date written as bare digits parses with `"format": "YYYYMMDD"`; and a `sourceFilename` dimension needs no position. Works everywhere a flat file already does — local and S3 sources, wildcard `fileKey` patterns, compression, chunked parallel reads, `sample`, `mock` and `synth`
 - Added `settings.recordSelector` for flat files that interleave record types in one file (a header, many detail records, a trailer). It reads only the lines whose marker at a given position matches — `{ "position": { "start": 1, "length": 1 }, "equals": "D" }`, or a list of values — so one producer describes exactly one record layout and every other line is dropped before parsing. Applied per line, so it is unaffected by how a file is chunked across workers
 
 ### Fixed
-- Fixed a deployed worker producing no logs. The whole run pipeline logged on the debug channel, which is dropped at `prod` level, so a deployment that did not set `REMORA_DEBUG_MODE=true` emitted nothing at all beyond startup lines and errors. The operational lifecycle events of a run are now logged at `INFO`, so they appear without turning debug on: worker-pool startup, consumer launch/completion, producers skipped as optional or empty, export start/finish per destination, downstream (`run-consumer`) triggers and cycle skips, and CRON/queue scheduler setup, per-trigger execution and stats. Per-line, per-chunk and per-worker detail stays on the debug channel, so `REMORA_DEBUG_MODE=true` is still what you set to see it. File logging is unchanged and remains exclusive: when it is enabled these lines go to the log file rather than stdout
+- Fixed a deployed worker producing no logs. The whole run pipeline logged on the debug channel, which is dropped at `prod` level, so a deployment that did not set `REMORA_DEBUG_MODE=true` emitted nothing at all beyond startup lines and errors. The operational lifecycle events of a run are now logged at `INFO`, so they appear without turning debug on: worker-pool startup, consumer launch/completion, producers skipped as optional or empty, export start/finish per destination, downstream (`run-consumer`) triggers and cycle skips, and CRON/queue scheduler setup, per-trigger execution and stats. Per-line, per-chunk and per-worker detail stays on the debug channel, so `REMORA_DEBUG_MODE=true` is still what you set to see it. These lines follow the log file's existing exclusivity, so a deployment that enables file logging still gets a quiet stdout: `INFO` now goes to the file *instead of* the console (previously it went to both), while `warn`/`error` always stay on the console so a failure can never be silent
+- Fixed the CLI progress bar erasing log lines. The bar redraws in place by moving the cursor up one line, which overwrote whatever had been printed since its last frame — now that the run pipeline logs at `INFO`, that was the log messages themselves. The logger counts what it writes to the console and the renderer only reclaims the previous line when it is still its own bar, so a log line printed mid-run survives and the bar continues below it
+- Fixed the periodic configuration refresh ignoring IAM-role authentication for S3. `Environment.refreshIfNeeded` still fetched the config archive over plain HTTP even for an `s3` URI, so a deployment loading its project from S3 with the ambient IAM role (added in 1.7.0) succeeded at startup and then failed on every refresh. Refresh now takes the same S3 path as the initial load; non-S3 remote URIs keep using the HTTP download with ETag caching
+- API queue execution failures now include the underlying error text in the log message, not just the queue URL, matching the poll-failure logging fixed in 1.7.0
 - Fixed JSON/JSONL producer dimensions ignoring their `format` when casting. The flat-file read path passed the dimension's `format` to the type cast but the JSON path did not, so a date written as a formatted string (e.g. `"20211213"` with `"format": "YYYYMMDD"`) failed to parse with `Invalid time value`. Both paths now cast identically
 - Fixed the `sample` command emitting the header row of a CSV/Excel producer as if it were a data row when `hasHeaderRow` was not set explicitly. Deciding where the data starts is now one shared rule for the run path and the sample path, so the two can no longer disagree
 - Fixed a multi-file (wildcard `fileKey`) read of a headerless flat file failing with a "different header line than the other files" error: the first line of each file was compared as a header even for file types that don't have one, where it is data and legitimately differs

package/index.js

@@ -11256,7 +11256,7 @@ var CONSTANTS, Constants_default;
 var init_Constants = __esm({
   "../../packages/constants/src/Constants.ts"() {
     CONSTANTS = {
-      cliVersion: "1.7.0",
+      cliVersion: "1.8.0",
       backendVersion: 1,
       backendPort: 5088,
       workerVersion: 2,
@@ -45240,17 +45240,24 @@ var init_BuiltinCodeSets = __esm({
 });
 
 // ../../packages/engines/src/mock/MockDataFactory.ts
-var import_dayjs3, DATE_FROM, DATE_TO, MAX_SEED, MockKeyRegistry, PAYERS, PLAN_SUFFIXES, ORG_SUFFIXES, MBI_LETTERS, pickCh, mbi, npi, icd10, oid, HEALTHCARE_STRING_TOPICS, HEALTHCARE_NUMBER_TOPICS, STRING_TOPICS, NUMBER_TOPICS, MockDataFactoryClass, MockDataFactory, MockDataFactory_default;
+var import_dayjs3, import_utc2, DATE_FROM, DATE_TO, DATE_FROM_MS, DATE_TO_MS, DATE_SPAN_MS, MAX_SEED, DEFAULT_SPAN, DEFAULT_FRACTION_DIGITS, MockKeyRegistry, PAYERS, PLAN_SUFFIXES, ORG_SUFFIXES, MBI_LETTERS, pickCh, mbi, npi, icd10, oid, HEALTHCARE_STRING_TOPICS, HEALTHCARE_NUMBER_TOPICS, STRING_TOPICS, NUMBER_TOPICS, MockDataFactoryClass, MockDataFactory, MockDataFactory_default;
 var init_MockDataFactory = __esm({
   "../../packages/engines/src/mock/MockDataFactory.ts"() {
     import_dayjs3 = __toESM(require("dayjs"), 1);
+    import_utc2 = __toESM(require("dayjs/plugin/utc"), 1);
     init_dist();
     init_src();
     init_RandomEngine();
     init_BuiltinCodeSets();
+    import_dayjs3.default.extend(import_utc2.default);
     DATE_FROM = "2020-01-01T00:00:00.000Z";
     DATE_TO = "2024-12-31T23:59:59.999Z";
+    DATE_FROM_MS = new Date(DATE_FROM).valueOf();
+    DATE_TO_MS = new Date(DATE_TO).valueOf();
+    DATE_SPAN_MS = DATE_TO_MS - DATE_FROM_MS;
     MAX_SEED = 2147483647;
+    DEFAULT_SPAN = 1e3;
+    DEFAULT_FRACTION_DIGITS = 4;
     MockKeyRegistry = class {
       constructor() {
         this.pools = /* @__PURE__ */ new Map();
@@ -45416,18 +45423,44 @@ var init_MockDataFactory = __esm({
           return spec.decimals === void 0 ? value : this._round(value, spec.decimals);
         };
         this._rawNumber = (spec) => {
-          if (spec.min !== void 0 || spec.max !== void 0)
-            return r6.number.int({ min: Math.round(spec.min ?? 0), max: Math.round(spec.max ?? 1e3) });
+          if (spec.min !== void 0 || spec.max !== void 0) return this._bounded(spec);
           const topic = this._match(NUMBER_TOPICS, spec.name);
-          return topic ? topic.gen() : r6.number.int({ min: 0, max: 1e3 });
+          return topic ? topic.gen() : r6.number.int({ min: 0, max: DEFAULT_SPAN });
+        };
+        /**
+         * A value inside the declared bounds, both ends inclusive. An open end spans the default width from
+         * the bound that was given — never the given bound itself, which would collapse the range to one
+         * value. An open lower end still starts at 0 where that leaves a usable range, since a column
+         * capped at (say) 12 is far more likely to mean 0-12 than to want negatives. Whole numbers unless
+         * the dimension asks for decimals — or the range spans less than one whole number (e.g. 0.4-0.6),
+         * where an integer draw would collapse to a single value or an empty range.
+         */
+        this._bounded = (spec) => {
+          const min = spec.min ?? (spec.max >= 0 ? 0 : spec.max - DEFAULT_SPAN);
+          const max = spec.max ?? min + DEFAULT_SPAN;
+          const low = Math.ceil(min);
+          const high = Math.floor(max);
+          if (spec.decimals || low >= high)
+            return r6.number.float({ min, max, fractionDigits: spec.decimals ?? DEFAULT_FRACTION_DIGITS });
+          return r6.number.int({ min: low, max: high });
         };
         this._round = (value, decimals) => {
           const factor = Math.pow(10, decimals);
           return Math.round(value * factor) / factor;
         };
         this._datetime = (spec) => {
-          const date2 = r6.date.between({ from: DATE_FROM, to: DATE_TO });
-          return spec.format ? (0, import_dayjs3.default)(date2).format(spec.format) : date2.toISOString();
+          const date2 = r6.date.between(this._dateRange(spec));
+          return spec.format ? import_dayjs3.default.utc(date2).format(spec.format) : date2.toISOString();
+        };
+        /**
+         * The window a datetime is drawn from: the default realistic window, moved/narrowed by whichever
+         * bounds the dimension declares. A one-sided bound keeps the default window's width, so a `min`
+         * past the default window still yields a spread of dates rather than an inverted or single-day range.
+         */
+        this._dateRange = (spec) => {
+          if (spec.min === void 0 && spec.max === void 0) return { from: DATE_FROM_MS, to: DATE_TO_MS };
+          const from = spec.min ?? spec.max - DATE_SPAN_MS;
+          return { from, to: spec.max ?? from + DATE_SPAN_MS };
         };
         // First topic whose key is a substring of the lowercased field name.
         this._match = (topics, name) => {
@@ -45443,18 +45476,23 @@ var init_MockDataFactory = __esm({
 });
 
 // ../../packages/engines/src/mock/SyntheticInputEngine.ts
-var import_promises12, import_os, import_path18, POOL_CAP, SyntheticInputEngineClass, SyntheticInputEngine, SyntheticInputEngine_default;
+var import_promises12, import_os, import_path18, import_dayjs4, import_customParseFormat3, import_utc3, POOL_CAP, SyntheticInputEngineClass, SyntheticInputEngine, SyntheticInputEngine_default;
 var init_SyntheticInputEngine = __esm({
   "../../packages/engines/src/mock/SyntheticInputEngine.ts"() {
     import_promises12 = __toESM(require("fs/promises"), 1);
     import_os = __toESM(require("os"), 1);
     import_path18 = __toESM(require("path"), 1);
+    import_dayjs4 = __toESM(require("dayjs"), 1);
+    import_customParseFormat3 = __toESM(require("dayjs/plugin/customParseFormat"), 1);
+    import_utc3 = __toESM(require("dayjs/plugin/utc"), 1);
     init_src();
     init_src2();
     init_src4();
     init_MockDataFactory();
     init_BuiltinCodeSets();
     init_RandomEngine();
+    import_dayjs4.default.extend(import_customParseFormat3.default);
+    import_dayjs4.default.extend(import_utc3.default);
     POOL_CAP = 1e5;
     SyntheticInputEngineClass = class {
       constructor() {
@@ -45579,19 +45617,63 @@ var init_SyntheticInputEngine = __esm({
           const { enumValues, codeSet } = this._resolveCodeSet(dim, name, codeSetMap);
           const reference = synth2.references ? { producer: synth2.references.producer, field: this._outputName(this._parentDim(synth2.references, producerMap)) } : void 0;
           const isValue = enumValues !== void 0 || codeSet !== void 0 || reference !== void 0;
+          const isKey = !isValue && (dim.pk === true || this._isKeyName(name));
+          const refOwner = refTargets.has(this._refKey(producerName, name));
+          const { min, max } = this._resolveBounds(dim, !isValue && !isKey && !refOwner);
           return {
             name,
             type: dim.type ?? "string",
             format: dim.format,
             decimals: synth2.decimals,
+            min,
+            max,
             isPk: dim.pk === true,
-            isKey: !isValue && (dim.pk === true || this._isKeyName(name)),
+            isKey,
             enumValues,
             codeSet,
             reference,
-            refOwner: refTargets.has(this._refKey(producerName, name))
+            refOwner
           };
         };
+        // Bounds for a generated value — a numeric range for a `number`, a date window for a `datetime` —
+        // which replace the name-based topic generator. Silently dropping a declared range would emit
+        // out-of-range data, so a dimension whose value comes from somewhere else (an enum/code set, a
+        // foreign key, or a coordinated key pool) is rejected instead.
+        this._resolveBounds = (dim, isGenerated) => {
+          const { min, max } = this._synth(dim);
+          if (min === void 0 && max === void 0) return {};
+          const type = dim.type ?? "string";
+          Affirm_default(type === "number" || type === "datetime", `Dimension "${dim.name}" sets synth "min"/"max", which only applies to "number" and "datetime" dimensions (its type is "${type}")`);
+          Affirm_default(isGenerated, `Dimension "${dim.name}" cannot combine synth "min"/"max" with a value drawn from elsewhere ("allowedValues", "codeSet", "references", or a key field served from a shared key pool)`);
+          const bounds = { min: this._bound(dim, min, "min"), max: this._bound(dim, max, "max") };
+          if (typeof max === "string" && this._isDayGranular(max, dim.format))
+            bounds.max = import_dayjs4.default.utc(bounds.max).endOf("day").valueOf();
+          Affirm_default(bounds.min === void 0 || bounds.max === void 0 || bounds.min <= bounds.max, `Dimension "${dim.name}" has synth "min" (${min}) ${type === "datetime" ? "later than" : "greater than"} "max" (${max})`);
+          return bounds;
+        };
+        // True when a date bound names a day rather than an instant — neither the value nor the dimension's
+        // format carries a time. Both have to agree: the value alone can't tell `"20240131"` from a compact
+        // `YYYYMMDDHHmmss` instant, and the format alone can't tell that an ISO value overrode it.
+        this._isDayGranular = (value, format3) => !/[T ]\d{1,2}:/.test(value) && !/[HhmsSAa]/.test(format3 ?? "");
+        /**
+         * One bound in the units the generator works in: the number itself, or epoch milliseconds for a
+         * `datetime`. A date bound is read with the dimension's own `format` first, so it can be written the
+         * same way the column's values are (`"20240101"` for `"YYYYMMDD"`), and as a plain/ISO date
+         * otherwise. Parsed in UTC like the real cast path, so the window never shifts with the host's
+         * timezone and generation stays reproducible.
+         */
+        this._bound = (dim, value, prop) => {
+          if (value === void 0) return void 0;
+          if (dim.type === "number") {
+            Affirm_default(typeof value === "number", `Dimension "${dim.name}" synth "${prop}" must be a number on a "number" dimension (got ${JSON.stringify(value)})`);
+            return value;
+          }
+          Affirm_default(typeof value === "string", `Dimension "${dim.name}" synth "${prop}" must be a date string on a "datetime" dimension (got ${JSON.stringify(value)})`);
+          const formatted = dim.format ? import_dayjs4.default.utc(value, dim.format, true) : void 0;
+          const date2 = formatted?.isValid() ? formatted : import_dayjs4.default.utc(value);
+          Affirm_default(date2.isValid(), `Dimension "${dim.name}" synth "${prop}" ("${value}") is not a valid date${dim.format ? ` for format "${dim.format}" or as an ISO date` : ""}`);
+          return date2.valueOf();
+        };
         // Resolve a dimension into a flat enum or a structured binding. Explicit `synth.allowedValues` /
         // `synth.codeSet` always win; otherwise the field name is matched against the built-in code sets.
         // Fails fast (affirm) on unknown sets or shape/field mismatches so bad config never silently emits

package/json_schemas/producer-schema.json

@@ -122,6 +122,14 @@
                                 "minimum": 0,
                                 "description": "How many decimal places generated number values should have: 0 forces whole integers (so values load into an integer column); a positive value rounds to that many decimals. Omit to keep the generator's own value."
                             },
+                            "min": {
+                                "type": ["number", "string"],
+                                "description": "Inclusive lower bound for generated values, so the column stays inside its real-world range. A number for a 'number' dimension; a date string for a 'datetime' dimension (read with the dimension's own 'format' when it has one, ISO otherwise). Only for 'number' and 'datetime' dimensions, and mutually exclusive with 'allowedValues', 'codeSet' and 'references'."
+                            },
+                            "max": {
+                                "type": ["number", "string"],
+                                "description": "Inclusive upper bound for generated values, so the column stays inside its real-world range. A number for a 'number' dimension; a date string for a 'datetime' dimension (read with the dimension's own 'format' when it has one, ISO otherwise). Only for 'number' and 'datetime' dimensions, and mutually exclusive with 'allowedValues', 'codeSet' and 'references'."
+                            },
                             "allowedValues": {
                                 "type": "array",
                                 "minItems": 1,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@forzalabs/remora",
-    "version": "1.7.0",
+    "version": "1.8.0",
     "description": "A powerful CLI tool for seamless data translation.",
     "main": "index.js",
     "private": false,

package/workers/ExecutorWorker.js

@@ -11255,7 +11255,7 @@ var CONSTANTS, Constants_default;
 var init_Constants = __esm({
   "../../packages/constants/src/Constants.ts"() {
     CONSTANTS = {
-      cliVersion: "1.7.0",
+      cliVersion: "1.8.0",
       backendVersion: 1,
       backendPort: 5088,
       workerVersion: 2,
@@ -44947,17 +44947,24 @@ var init_BuiltinCodeSets = __esm({
 });
 
 // ../../packages/engines/src/mock/MockDataFactory.ts
-var import_dayjs3, DATE_FROM, DATE_TO, MAX_SEED, MockKeyRegistry, PAYERS, PLAN_SUFFIXES, ORG_SUFFIXES, MBI_LETTERS, pickCh, mbi, npi, icd10, oid, HEALTHCARE_STRING_TOPICS, HEALTHCARE_NUMBER_TOPICS, STRING_TOPICS, NUMBER_TOPICS, MockDataFactoryClass, MockDataFactory, MockDataFactory_default;
+var import_dayjs3, import_utc2, DATE_FROM, DATE_TO, DATE_FROM_MS, DATE_TO_MS, DATE_SPAN_MS, MAX_SEED, DEFAULT_SPAN, DEFAULT_FRACTION_DIGITS, MockKeyRegistry, PAYERS, PLAN_SUFFIXES, ORG_SUFFIXES, MBI_LETTERS, pickCh, mbi, npi, icd10, oid, HEALTHCARE_STRING_TOPICS, HEALTHCARE_NUMBER_TOPICS, STRING_TOPICS, NUMBER_TOPICS, MockDataFactoryClass, MockDataFactory, MockDataFactory_default;
 var init_MockDataFactory = __esm({
   "../../packages/engines/src/mock/MockDataFactory.ts"() {
     import_dayjs3 = __toESM(require("dayjs"), 1);
+    import_utc2 = __toESM(require("dayjs/plugin/utc"), 1);
     init_dist();
     init_src();
     init_RandomEngine();
     init_BuiltinCodeSets();
+    import_dayjs3.default.extend(import_utc2.default);
     DATE_FROM = "2020-01-01T00:00:00.000Z";
     DATE_TO = "2024-12-31T23:59:59.999Z";
+    DATE_FROM_MS = new Date(DATE_FROM).valueOf();
+    DATE_TO_MS = new Date(DATE_TO).valueOf();
+    DATE_SPAN_MS = DATE_TO_MS - DATE_FROM_MS;
     MAX_SEED = 2147483647;
+    DEFAULT_SPAN = 1e3;
+    DEFAULT_FRACTION_DIGITS = 4;
     MockKeyRegistry = class {
       constructor() {
         this.pools = /* @__PURE__ */ new Map();
@@ -45123,18 +45130,44 @@ var init_MockDataFactory = __esm({
           return spec.decimals === void 0 ? value : this._round(value, spec.decimals);
         };
         this._rawNumber = (spec) => {
-          if (spec.min !== void 0 || spec.max !== void 0)
-            return r6.number.int({ min: Math.round(spec.min ?? 0), max: Math.round(spec.max ?? 1e3) });
+          if (spec.min !== void 0 || spec.max !== void 0) return this._bounded(spec);
           const topic = this._match(NUMBER_TOPICS, spec.name);
-          return topic ? topic.gen() : r6.number.int({ min: 0, max: 1e3 });
+          return topic ? topic.gen() : r6.number.int({ min: 0, max: DEFAULT_SPAN });
+        };
+        /**
+         * A value inside the declared bounds, both ends inclusive. An open end spans the default width from
+         * the bound that was given — never the given bound itself, which would collapse the range to one
+         * value. An open lower end still starts at 0 where that leaves a usable range, since a column
+         * capped at (say) 12 is far more likely to mean 0-12 than to want negatives. Whole numbers unless
+         * the dimension asks for decimals — or the range spans less than one whole number (e.g. 0.4-0.6),
+         * where an integer draw would collapse to a single value or an empty range.
+         */
+        this._bounded = (spec) => {
+          const min = spec.min ?? (spec.max >= 0 ? 0 : spec.max - DEFAULT_SPAN);
+          const max = spec.max ?? min + DEFAULT_SPAN;
+          const low = Math.ceil(min);
+          const high = Math.floor(max);
+          if (spec.decimals || low >= high)
+            return r6.number.float({ min, max, fractionDigits: spec.decimals ?? DEFAULT_FRACTION_DIGITS });
+          return r6.number.int({ min: low, max: high });
         };
         this._round = (value, decimals) => {
           const factor = Math.pow(10, decimals);
           return Math.round(value * factor) / factor;
         };
         this._datetime = (spec) => {
-          const date2 = r6.date.between({ from: DATE_FROM, to: DATE_TO });
-          return spec.format ? (0, import_dayjs3.default)(date2).format(spec.format) : date2.toISOString();
+          const date2 = r6.date.between(this._dateRange(spec));
+          return spec.format ? import_dayjs3.default.utc(date2).format(spec.format) : date2.toISOString();
+        };
+        /**
+         * The window a datetime is drawn from: the default realistic window, moved/narrowed by whichever
+         * bounds the dimension declares. A one-sided bound keeps the default window's width, so a `min`
+         * past the default window still yields a spread of dates rather than an inverted or single-day range.
+         */
+        this._dateRange = (spec) => {
+          if (spec.min === void 0 && spec.max === void 0) return { from: DATE_FROM_MS, to: DATE_TO_MS };
+          const from = spec.min ?? spec.max - DATE_SPAN_MS;
+          return { from, to: spec.max ?? from + DATE_SPAN_MS };
         };
         // First topic whose key is a substring of the lowercased field name.
         this._match = (topics, name) => {
@@ -45150,18 +45183,23 @@ var init_MockDataFactory = __esm({
 });
 
 // ../../packages/engines/src/mock/SyntheticInputEngine.ts
-var import_promises12, import_os, import_path15, POOL_CAP, SyntheticInputEngineClass, SyntheticInputEngine;
+var import_promises12, import_os, import_path15, import_dayjs4, import_customParseFormat3, import_utc3, POOL_CAP, SyntheticInputEngineClass, SyntheticInputEngine;
 var init_SyntheticInputEngine = __esm({
   "../../packages/engines/src/mock/SyntheticInputEngine.ts"() {
     import_promises12 = __toESM(require("fs/promises"), 1);
     import_os = __toESM(require("os"), 1);
     import_path15 = __toESM(require("path"), 1);
+    import_dayjs4 = __toESM(require("dayjs"), 1);
+    import_customParseFormat3 = __toESM(require("dayjs/plugin/customParseFormat"), 1);
+    import_utc3 = __toESM(require("dayjs/plugin/utc"), 1);
     init_src();
     init_src2();
     init_src4();
     init_MockDataFactory();
     init_BuiltinCodeSets();
     init_RandomEngine();
+    import_dayjs4.default.extend(import_customParseFormat3.default);
+    import_dayjs4.default.extend(import_utc3.default);
     POOL_CAP = 1e5;
     SyntheticInputEngineClass = class {
       constructor() {
@@ -45286,19 +45324,63 @@ var init_SyntheticInputEngine = __esm({
           const { enumValues, codeSet } = this._resolveCodeSet(dim, name, codeSetMap);
           const reference = synth.references ? { producer: synth.references.producer, field: this._outputName(this._parentDim(synth.references, producerMap)) } : void 0;
           const isValue = enumValues !== void 0 || codeSet !== void 0 || reference !== void 0;
+          const isKey = !isValue && (dim.pk === true || this._isKeyName(name));
+          const refOwner = refTargets.has(this._refKey(producerName, name));
+          const { min, max } = this._resolveBounds(dim, !isValue && !isKey && !refOwner);
           return {
             name,
             type: dim.type ?? "string",
             format: dim.format,
             decimals: synth.decimals,
+            min,
+            max,
             isPk: dim.pk === true,
-            isKey: !isValue && (dim.pk === true || this._isKeyName(name)),
+            isKey,
             enumValues,
             codeSet,
             reference,
-            refOwner: refTargets.has(this._refKey(producerName, name))
+            refOwner
           };
         };
+        // Bounds for a generated value — a numeric range for a `number`, a date window for a `datetime` —
+        // which replace the name-based topic generator. Silently dropping a declared range would emit
+        // out-of-range data, so a dimension whose value comes from somewhere else (an enum/code set, a
+        // foreign key, or a coordinated key pool) is rejected instead.
+        this._resolveBounds = (dim, isGenerated) => {
+          const { min, max } = this._synth(dim);
+          if (min === void 0 && max === void 0) return {};
+          const type = dim.type ?? "string";
+          Affirm_default(type === "number" || type === "datetime", `Dimension "${dim.name}" sets synth "min"/"max", which only applies to "number" and "datetime" dimensions (its type is "${type}")`);
+          Affirm_default(isGenerated, `Dimension "${dim.name}" cannot combine synth "min"/"max" with a value drawn from elsewhere ("allowedValues", "codeSet", "references", or a key field served from a shared key pool)`);
+          const bounds = { min: this._bound(dim, min, "min"), max: this._bound(dim, max, "max") };
+          if (typeof max === "string" && this._isDayGranular(max, dim.format))
+            bounds.max = import_dayjs4.default.utc(bounds.max).endOf("day").valueOf();
+          Affirm_default(bounds.min === void 0 || bounds.max === void 0 || bounds.min <= bounds.max, `Dimension "${dim.name}" has synth "min" (${min}) ${type === "datetime" ? "later than" : "greater than"} "max" (${max})`);
+          return bounds;
+        };
+        // True when a date bound names a day rather than an instant — neither the value nor the dimension's
+        // format carries a time. Both have to agree: the value alone can't tell `"20240131"` from a compact
+        // `YYYYMMDDHHmmss` instant, and the format alone can't tell that an ISO value overrode it.
+        this._isDayGranular = (value, format3) => !/[T ]\d{1,2}:/.test(value) && !/[HhmsSAa]/.test(format3 ?? "");
+        /**
+         * One bound in the units the generator works in: the number itself, or epoch milliseconds for a
+         * `datetime`. A date bound is read with the dimension's own `format` first, so it can be written the
+         * same way the column's values are (`"20240101"` for `"YYYYMMDD"`), and as a plain/ISO date
+         * otherwise. Parsed in UTC like the real cast path, so the window never shifts with the host's
+         * timezone and generation stays reproducible.
+         */
+        this._bound = (dim, value, prop) => {
+          if (value === void 0) return void 0;
+          if (dim.type === "number") {
+            Affirm_default(typeof value === "number", `Dimension "${dim.name}" synth "${prop}" must be a number on a "number" dimension (got ${JSON.stringify(value)})`);
+            return value;
+          }
+          Affirm_default(typeof value === "string", `Dimension "${dim.name}" synth "${prop}" must be a date string on a "datetime" dimension (got ${JSON.stringify(value)})`);
+          const formatted = dim.format ? import_dayjs4.default.utc(value, dim.format, true) : void 0;
+          const date2 = formatted?.isValid() ? formatted : import_dayjs4.default.utc(value);
+          Affirm_default(date2.isValid(), `Dimension "${dim.name}" synth "${prop}" ("${value}") is not a valid date${dim.format ? ` for format "${dim.format}" or as an ISO date` : ""}`);
+          return date2.valueOf();
+        };
         // Resolve a dimension into a flat enum or a structured binding. Explicit `synth.allowedValues` /
         // `synth.codeSet` always win; otherwise the field name is matched against the built-in code sets.
         // Fails fast (affirm) on unknown sets or shape/field mismatches so bad config never silently emits