busroot-sdk 0.0.8-dev.2797155609 → 0.0.8-dev.2803109172

package/build/index.js

@@ -762,14 +762,14 @@ var require_base_station = __commonJS({
       idleCostPerMinute: zod_1.z.number().gte(0).lte(99999).nullish().describe("Idle Cost Per Minute: Cost per minute during idle time in account currency. Used for calculating scheduling losses, planned non-production losses, and downtime losses when SKU doesn't have a specific value."),
       // Downtime Settings
       downtimeDetectionMode: zod_1.z.nativeEnum(enums_1.DOWNTIME_DETECTION_MODE).default(enums_1.DOWNTIME_DETECTION_MODE.UTILISATION).nullish().describe("Downtime Detection Mode: How to detect when the station is down. Options: 'off' (no detection), 'production' (use production cycle data), 'utilisation' (use utilisation signals - most common), 'line_speed' (use line speed monitoring). Default: 'utilisation'"),
-      utilisationDowntimeThreshold: zod_1.z.number().int().gte(0).nullish().describe("Utilisation Downtime Threshold: Minimum period in minutes before registering downtime. Only stops longer than this threshold will be recorded. Defaults to 1 hour when not set; see DEFAULT_UTILISATION_DOWNTIME_THRESHOLD in cache-builder."),
+      utilisationDowntimeThreshold: zod_1.z.number().int().gte(0).nullish().describe("Utilisation Downtime Threshold: Minimum stop duration in milliseconds before registering downtime \u2014 only stops longer than this are recorded. Example: 120000 (2 minutes), 900000 (15 minutes). The admin UI presents this value in minutes. Defaults to 1 hour when not set; see DEFAULT_UTILISATION_DOWNTIME_THRESHOLD in cache-builder."),
       slowDurationThreshold: zod_1.z.number().int().gte(0).nullish().describe("Slow Duration Threshold: Duration threshold in milliseconds for detecting slow operation"),
       forceAllShiftTimeAsPlannedProduction: zod_1.z.boolean().nullish().describe("Force All Shift Time As Planned Production: Treat all shift time as planned production time"),
       // Productive Settings
       productiveStatusMode: zod_1.z.nativeEnum(enums_1.PRODUCTIVE_STATUS_MODE).default(enums_1.PRODUCTIVE_STATUS_MODE.PRODUCTIVE_SIGNAL).nullish().describe("Productive Status Mode: How to measure when the station is engaged in value-adding activity. Options: 'productive_signal' (use productive signal input), 'electrical_usage' (use electrical consumption), 'line_speed' (use line speed value). Default: 'productive_signal'"),
       electricalUsageStoppedThresholdKw: zod_1.z.number().gte(0).nullish().describe("Electrical Usage Stopped Threshold (kW): Minimum power consumption in kilowatts that indicates the station is active. Below this threshold, Busroot will regard the station as stopped/downtime. Example: 2.0, 1.0, 5.0"),
       lineSpeedStoppedThreshold: zod_1.z.number().gte(0).nullish().describe("Line Speed Stopped Threshold: Minimum speed value that indicates the station is running. Below this threshold, Busroot will regard the station as stopped/downtime. Example: 10, 5, 20"),
-      productiveHoldOnTime: zod_1.z.number().int().gte(0).lte(time_1.TimeIntervals["1d"].ms).nullish().describe("Productive Hold On Time: Time in minutes to consider station active after a productive signal. Each new signal restarts the hold-on timer."),
+      productiveHoldOnTime: zod_1.z.number().int().gte(0).lte(time_1.TimeIntervals["1d"].ms).nullish().describe("Productive Hold On Time: Time in milliseconds to keep considering the station active after a productive signal. Each new signal restarts the hold-on timer. Example: 300000 (5 minutes). The admin UI presents this value in minutes."),
       // Feature flags (allowManualProduction, allowQuickScheduleStart,
       // allowScheduleCutShort, allowRejectProduction, allowEditPartsPerCycle, schedulingOnly) are now
       // registry-managed tri-state `enable*` fields, added below via flagSchemaFieldsForLevel("station").
@@ -1422,40 +1422,39 @@ var require_times = __commonJS({
     function floorToPlantDayStart(instant, plant) {
       return (0, moment_timezone_1.default)(instant).tz(plant.timezone).subtract(plant.dayStartHour, "hours").startOf("day").add(plant.dayStartHour, "hours").valueOf();
     }
+    var CUSTOM_RANGE_MINUTE_STEPS = {
+      "5m": 5,
+      "15m": 15,
+      "30m": 30
+    };
+    var CUSTOM_RANGE_CALENDAR_UNITS = {
+      "1h": { startOf: "hour", step: "hour" },
+      "1d": { startOf: "day", step: "day" },
+      "7d": { startOf: "isoWeek", step: "week" }
+    };
+    function snapCustomRangeEdge(timestamp, timezone, aggregateWindow, direction) {
+      if (aggregateWindow == null) {
+        return timestamp;
+      }
+      const edge = (0, moment_timezone_1.default)(timestamp).tz(timezone).startOf("minute");
+      const minuteStep = CUSTOM_RANGE_MINUTE_STEPS[aggregateWindow];
+      if (minuteStep != null) {
+        const offsetFromBoundary = edge.minute() % minuteStep;
+        return direction === "backward" ? edge.subtract(offsetFromBoundary, "minutes").valueOf() : edge.add((minuteStep - offsetFromBoundary) % minuteStep, "minutes").valueOf();
+      }
+      const calendarUnit = CUSTOM_RANGE_CALENDAR_UNITS[aggregateWindow];
+      if (calendarUnit == null) {
+        return timestamp;
+      }
+      const boundary = edge.clone().startOf(calendarUnit.startOf);
+      return direction === "backward" || boundary.valueOf() === edge.valueOf() ? boundary.valueOf() : boundary.add(1, calendarUnit.step).valueOf();
+    }
     function getTimeRangeFromRangeCode(range, plant, aggregateWindow, now) {
       if (range.custom != null && range.custom.from != null && range.custom.to != null) {
-        let fromTimestamp = range.custom.from;
-        let toTimestamp = range.custom.to;
-        const fromTimestampMomentStartOfMinute = (0, moment_timezone_1.default)(fromTimestamp).tz(plant?.timezone || "UTC").startOf("minute");
-        const toTimestampMomentStartOfMinute = (0, moment_timezone_1.default)(toTimestamp).tz(plant?.timezone || "UTC").startOf("minute");
-        const currentFromTimestampMinute = fromTimestampMomentStartOfMinute.minute();
-        const currentToTimestampMinute = toTimestampMomentStartOfMinute.minute();
-        if (aggregateWindow === "5m") {
-          fromTimestamp = fromTimestampMomentStartOfMinute.add((5 - currentFromTimestampMinute % 5) % 5, "minutes").valueOf();
-          toTimestamp = toTimestampMomentStartOfMinute.add((5 - currentToTimestampMinute % 5) % 5, "minutes").valueOf();
-        } else if (aggregateWindow === "15m") {
-          fromTimestamp = fromTimestampMomentStartOfMinute.add((15 - currentFromTimestampMinute % 15) % 15, "minutes").valueOf();
-          toTimestamp = toTimestampMomentStartOfMinute.add((15 - currentToTimestampMinute % 15) % 15, "minutes").valueOf();
-        } else if (aggregateWindow === "30m") {
-          fromTimestamp = fromTimestampMomentStartOfMinute.add((30 - currentFromTimestampMinute % 30) % 30, "minutes").valueOf();
-          toTimestamp = toTimestampMomentStartOfMinute.add((30 - currentToTimestampMinute % 30) % 30, "minutes").valueOf();
-        } else if (aggregateWindow === "1h") {
-          const fromStartOfHour = fromTimestampMomentStartOfMinute.clone().startOf("hour");
-          const toStartOfHour = toTimestampMomentStartOfMinute.clone().startOf("hour");
-          fromTimestamp = fromTimestampMomentStartOfMinute.valueOf() === fromStartOfHour.valueOf() ? fromStartOfHour.valueOf() : fromStartOfHour.add(1, "hour").valueOf();
-          toTimestamp = toTimestampMomentStartOfMinute.valueOf() === toStartOfHour.valueOf() ? toStartOfHour.valueOf() : toStartOfHour.add(1, "hour").valueOf();
-        } else if (aggregateWindow === "1d") {
-          const fromStartOfDay = fromTimestampMomentStartOfMinute.clone().startOf("day");
-          const toStartOfDay = toTimestampMomentStartOfMinute.clone().startOf("day");
-          fromTimestamp = fromTimestampMomentStartOfMinute.valueOf() === fromStartOfDay.valueOf() ? fromStartOfDay.valueOf() : fromStartOfDay.add(1, "day").valueOf();
-          toTimestamp = toTimestampMomentStartOfMinute.valueOf() === toStartOfDay.valueOf() ? toStartOfDay.valueOf() : toStartOfDay.add(1, "day").valueOf();
-        } else if (aggregateWindow === "7d") {
-          const fromStartOfWeek = fromTimestampMomentStartOfMinute.clone().startOf("isoWeek");
-          const toStartOfWeek = toTimestampMomentStartOfMinute.clone().startOf("isoWeek");
-          fromTimestamp = fromTimestampMomentStartOfMinute.valueOf() === fromStartOfWeek.valueOf() ? fromStartOfWeek.valueOf() : fromStartOfWeek.add(1, "week").valueOf();
-          toTimestamp = toTimestampMomentStartOfMinute.valueOf() === toStartOfWeek.valueOf() ? toStartOfWeek.valueOf() : toStartOfWeek.add(1, "week").valueOf();
-        }
-        return timestampsToTimeRange({ from: fromTimestamp, to: toTimestamp });
+        const timezone = plant?.timezone || "UTC";
+        const fromTimestamp = snapCustomRangeEdge(range.custom.from, timezone, aggregateWindow, "forward");
+        const toTimestamp = snapCustomRangeEdge(range.custom.to, timezone, aggregateWindow, "backward");
+        return timestampsToTimeRange({ from: fromTimestamp, to: Math.max(fromTimestamp, toTimestamp) });
       }
       if (range.code == null) {
         throw new Error("Either Range Code or custom Time Range required");
@@ -2472,7 +2471,7 @@ var require_shared = __commonJS({
       production_count: zod_1.z.number().optional().describe("Alias for production_count_good."),
       production_count_bad: zod_1.z.number().optional().describe("The cumulative number of bad production cycles complete."),
       bad_production_count: zod_1.z.number().optional().describe("Alias for production_count_bad."),
-      bad_production_reason: zod_1.z.string().optional().describe("Quality reason code for the bad production reported in this message. Must match a reason code of type 'quality' configured on the account; unknown or missing codes are recorded as bad production with no reason."),
+      bad_production_reason: zod_1.z.string().optional().describe("Quality reason code for the bad production reported in this message. Should match a reason code of type 'quality' configured on the account, but an unrecognised code is still recorded verbatim and displayed as the raw code; a missing code records the bad production with no reason ('Unknown')."),
       non_production_reason: zod_1.z.string().optional().describe("Declares that this station is currently in a period of non-production, and gives the reason code for it. The presence of this field is the assertion - there is no separate boolean and no end signal; the sender simply stops sending it. Each message re-asserts non-production for the one-minute window it lands in, so senders must publish at least once per minute for continuous coverage. Should match a reason code of type 'non-production' configured on the account; unknown codes are still honoured and displayed as the raw code."),
       productive: zod_1.z.number().optional().describe("An indication that this station is productive. Any number greater than 0 is considered true."),
       line_speed: zod_1.z.number().optional().describe("A number indicating the speed of the station. No units are assumed, so could be percentage or speed such as m/s."),
@@ -10253,14 +10252,14 @@ var require_station4 = __commonJS({
       if (station.lastStationWindow != null) {
         if ((station.lastStationWindow.shiftMs || 0) === 0) {
           state = exports2.StationStates.out_of_shift;
-        } else if (!station.lastStationWindow.isAlive) {
-          state = exports2.StationStates.disconnected;
         } else if ((station.lastStationWindow.downtimeMs || 0) > 0) {
           state = exports2.StationStates.stopped;
         } else if (station.activeSchedule?.nonProductionReasonCode != null) {
           state = exports2.StationStates.non_production;
         } else if ((0, station_windows_1.signalNonProductionReasonCode)(station.lastStationWindow) != null) {
           state = exports2.StationStates.non_production;
+        } else if (!station.lastStationWindow.isAlive) {
+          state = exports2.StationStates.disconnected;
         } else if (station.activeSchedule?.skuCode != null) {
           state = exports2.StationStates.running;
         } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busroot-sdk",
-  "version": "0.0.8-dev.2797155609",
+  "version": "0.0.8-dev.2803109172",
   "description": "An SDK for accessing Busroot from output.industries",
   "homepage": "https://www.output.industries",
   "main": "./build/index.js",