hoffmation-base 3.8.0 → 4.0.0

package/lib/interfaces/dachs/KeyListEntity.d.ts

@@ -3,8 +3,3 @@ export interface KeyListEntity {
     doc: string;
     unit: (x: string) => boolean | string | number;
 }
-export interface KeyListEntityResponse<V> {
-    key?: KeyListEntity;
-    rawValue?: string;
-    value: V;
-}

package/lib/interfaces/dachs/KeyListEntityResponse.d.ts

@@ -0,0 +1,6 @@
+import { KeyListEntity } from './KeyListEntity';
+export interface KeyListEntityResponse<V> {
+    key?: KeyListEntity;
+    rawValue?: string;
+    value: V;
+}

package/lib/interfaces/dachs/KeyListEntityResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/dachs/index.d.ts

@@ -4,3 +4,4 @@ export * from './influxDbConnectionOptions';
 export * from './IReadKeyList';
 export * from './IWriteKeyList';
 export * from './KeyListEntity';
+export * from './KeyListEntityResponse';

package/lib/interfaces/dachs/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./influxDbConnectionOptions"), exports);
 __exportStar(require("./IReadKeyList"), exports);
 __exportStar(require("./IWriteKeyList"), exports);
 __exportStar(require("./KeyListEntity"), exports);
+__exportStar(require("./KeyListEntityResponse"), exports);

package/lib/interfaces/deviceSettings/iDachsDeviceSettings.d.ts

@@ -73,6 +73,21 @@ export interface iDachsDeviceSettings extends iActuatorSettings {
      * Defines the desired minimum temperature for heat storage during winter.
      */
     winterMinimumPreNightHeatStorageTemp: number;
+    /**
+     * Defines the desired maximum temperature for warm water using dachs outside of winter heating mode.
+     * Applies in place of {@link warmWaterDesiredMaxTemp} whenever the heating mode is not winter.
+     */
+    summerWarmWaterDesiredMaxTemp: number;
+    /**
+     * The rated electrical output of the unit in watt, used to remove its own contribution from a historical day.
+     * @default 5500
+     */
+    dachsRatedElectricalWattage: number;
+    /**
+     * The share of the produced electrical energy that reaches the battery.
+     * @default 0.8
+     */
+    dachsConversionFactor: number;
     /**
      *
      */

package/lib/interfaces/iActuatorStateSample.d.ts

@@ -0,0 +1,13 @@
+/**
+ * One persisted actuator state change.
+ */
+export interface iActuatorStateSample {
+    /**
+     * Whether the actuator was on after this change
+     */
+    on: boolean;
+    /**
+     * The date of the state change
+     */
+    date: Date;
+}

package/lib/interfaces/iActuatorStateSample.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iBatteryLevelSample.d.ts

@@ -0,0 +1,13 @@
+/**
+ * One persisted battery level reading, as it is stored alongside each energy calculation interval.
+ */
+export interface iBatteryLevelSample {
+    /**
+     * State of charge in percent (0-100)
+     */
+    level: number;
+    /**
+     * The date of the reading
+     */
+    date: Date;
+}

package/lib/interfaces/iBatteryLevelSample.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iConsumptionWindowSample.d.ts

@@ -0,0 +1,26 @@
+/**
+ * House consumption over a stretch of time in kWh.
+ *
+ * The same shape serves both ends of the consumption calculation: a single persisted reading of one
+ * measuring interval, and the sum of those readings over a whole evaluation window. What separates
+ * the two is not the type but the step that produced it - see
+ * EnergyHistoryUtils.windowConsumptionSums, which turns the former into the latter.
+ *
+ * The distinction matters in exactly one place: the upper quantile is read from the distribution of
+ * window sums across the days, never from the individual readings. Summing per reading quantiles
+ * would apply the safety margin once per interval instead of once per window.
+ */
+export interface iConsumptionWindowSample {
+    /**
+     * House consumption over the interval or window in kWh
+     */
+    consumedKwh: number;
+    /**
+     * Which end of the stretch this is depends on which of the two kinds the sample is, and the two
+     * differ: a raw persisted reading is dated at the END of the measuring interval it closes, the way
+     * iPersist hands it over, while a window sum produced by EnergyHistoryUtils.windowConsumptionSums is
+     * dated at the START of its window. Producers of the raw kind must not switch to the start, and
+     * consumers must not assume one meaning for both.
+     */
+    date: Date;
+}

package/lib/interfaces/iConsumptionWindowSample.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iDachsHistoryGateResult.d.ts

@@ -0,0 +1,29 @@
+/**
+ * What the history based start gate decided in its last evaluation.
+ *
+ * The gate acts only on the plant's verdicts that need no fitted model - see
+ * {@link iMorningReserveVerdict.measured}. A modelled verdict lands here with both flags false and is
+ * reported for the operator alone.
+ */
+export interface iDachsHistoryGateResult {
+    /** True while the estimate suppresses an electricity driven start */
+    suppress: boolean;
+    /** True while the estimate asks for a start */
+    request: boolean;
+    /** The deciding stage and the numbers it decided on, for the log and for the operator */
+    reason: string;
+    /** State of charge in percent at the moment of the decision */
+    currentSoc: number;
+    /**
+     * Projected morning state of charge in percent at the lower band edge.
+     * Without a model there is no band; both edges then collapse onto {@link currentSoc} and
+     * {@link sampleDays} is zero.
+     */
+    lowerEdgeSoc: number;
+    /** Projected morning state of charge in percent at the upper band edge */
+    upperEdgeSoc: number;
+    /** The minimum morning state of charge in percent the decision was measured against */
+    reserve: number;
+    /** How many historical days the model was fitted on; zero while there is no model */
+    sampleDays: number;
+}

package/lib/interfaces/iDachsHistoryGateResult.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iEnergyHistoryBasis.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Which of the inputs of an outlook are present.
+ *
+ * This is the reason side of the answer: a caller that got no statement has to be able to say *why*,
+ * and the three ways an answer can be absent look alike from the outside. An operator who reads "no
+ * consumption history" while the history is there looks in the wrong place.
+ */
+export interface iEnergyHistoryBasis {
+    /** Whether the energy manager reports a usable battery capacity */
+    batteryCapacityKnown: boolean;
+    /** How many usable consumption window sums the history window yielded */
+    consumptionWindows: number;
+    /**
+     * How many of them the plant demands before an upper quantile of them means anything - reported alongside
+     * the count so a caller can say "three of the four required" without reading the plant's dials itself.
+     */
+    requiredConsumptionWindows: number;
+    /** Whether the last history read answered with any consumption readings at all */
+    consumptionReadingsSeen: boolean;
+    /** Whether a daily weather aggregate is stored for the running day */
+    weatherTodayKnown: boolean;
+    /** Whether a consumption reading of the running day is present */
+    consumptionTodayKnown: boolean;
+    /** Whether a model was fitted at all, with or without a feature row of the running day to apply it to */
+    modelFitted: boolean;
+}

package/lib/interfaces/iEnergyHistoryBasis.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iEnergyHistoryEstimate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A prediction with its uncertainty band.
+ */
+export interface iEnergyHistoryEstimate {
+    /**
+     * The point estimate of the change in percentage points
+     */
+    expectedDelta: number;
+    /**
+     * expectedDelta - bandSigma * residualSigma
+     */
+    lowerEdgeDelta: number;
+    /**
+     * expectedDelta + bandSigma * residualSigma
+     */
+    upperEdgeDelta: number;
+    /**
+     * How many observations the underlying model was built from
+     */
+    sampleDays: number;
+}

package/lib/interfaces/iEnergyHistoryEstimate.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iEnergyHistoryFeatures.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The four measured or forecast quantities a prediction is based on. Exactly four - no more.
+ */
+export interface iEnergyHistoryFeatures {
+    /**
+     * Hours of sunlight left until sunset at the moment of evaluation
+     */
+    remainingSunHours: number;
+    /**
+     * Cloud cover in percent for the remainder of the day
+     */
+    cloudCover: number;
+    /**
+     * House consumption since midnight in kWh at the moment of evaluation
+     */
+    consumedSoFarKwh: number;
+    /**
+     * The day's maximum temperature in degrees celsius
+     */
+    maxTemperature: number;
+}

package/lib/interfaces/iEnergyHistoryFeatures.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iEnergyHistoryModel.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The fitted model. Weights are never written by hand - they come out of the fit.
+ */
+export interface iEnergyHistoryModel {
+    /**
+     * One weight per feature, in the declaration order of iEnergyHistoryFeatures
+     */
+    weights: [number, number, number, number];
+    /**
+     * The constant term of the fit in percentage points
+     */
+    intercept: number;
+    /**
+     * Standard deviation of the residuals - this is what the band is made of
+     */
+    residualSigma: number;
+    /**
+     * How many observations the fit was built from
+     */
+    sampleDays: number;
+}

package/lib/interfaces/iEnergyHistoryModel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iEnergyHistoryOptions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * How the plant's recorded history is read, fitted and reported on.
+ *
+ * **All three describe the plant, not whoever asks**: every consumer asks the same question - where the state
+ * of charge bottoms out before the coming morning - and how much history is telling enough to answer it is a
+ * property of the recorded data. A second bundle would mean a second read, a second paid backfill and two half
+ * samples in the shadow record.
+ *
+ * Handed in rather than read off a global, so the reading service stays off any concrete energy manager class
+ * and can be built in isolation. **Every field is read anew on each use**: the owner hands in a live view of
+ * its settings rather than a snapshot, because all three are editable at runtime.
+ *
+ * The rest of what describes the plant lives elsewhere: how good its recorded data has to be is stated by the
+ * energy manager, and its fuel burning generators announce themselves as devices - see
+ * {@link Devices.fossilGenerators}.
+ */
+export interface iEnergyHistoryOptions {
+    /** Length of the sliding window in days that is read, fitted and backfilled. */
+    windowDays: number;
+    /**
+     * Below this many usable historical days no model is fitted at all.
+     *
+     * The floor below which a fit is not merely uncertain but meaningless is plant wide and sits in the
+     * arithmetic itself, which raises any lower number to it - this dial can only ask for more than that.
+     */
+    minimumModelDays: number;
+    /** How many residual sigmas each edge of the band lies away from the point estimate. */
+    bandSigma: number;
+}

package/lib/interfaces/iEnergyHistoryOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iEnergyHistoryOutlook.d.ts

@@ -0,0 +1,41 @@
+import { iEnergyHistoryBasis } from './iEnergyHistoryBasis';
+import { iProjectedSocBand } from './iProjectedSocBand';
+/**
+ * The raw quantities the plant can state about the coming morning low at one moment, with no arithmetic on
+ * them. The judgement made from them is {@link iMorningReserveVerdict}, which is what a consumer normally
+ * reads.
+ */
+export interface iEnergyHistoryOutlook {
+    /**
+     * The state of charge in percent every projection below starts from.
+     *
+     * Carried along rather than left to the reader, because a consumer that quoted its own charge level next to
+     * these projections could quote a different one than they were built on.
+     */
+    currentSoc: number;
+    /** Hours of sun left on the day of the moment asked about, never negative */
+    remainingSunHours: number;
+    /**
+     * Where the state of charge would bottom out if no further photovoltaic yield arrived at all, in
+     * percent - `undefined` while capacity or consumption history are missing, see {@link basis}.
+     */
+    worstCaseLowSoc: number | undefined;
+    /**
+     * The projected state of charge at the coming morning low at both edges of the residual band, in
+     * percent - `undefined` while there is no fitted model or no complete feature row for the running day.
+     */
+    band: iProjectedSocBand | undefined;
+    /**
+     * The standard deviation of the fitted model's residuals in percentage points - `undefined` while there is
+     * no fitted model.
+     *
+     * Reported alongside {@link band} rather than hidden inside it, so that a consumer which one day may act on
+     * the model can form edges of its own width from the two without a second reading of the same history. That
+     * is the whole reason it is here; nothing reads it yet and no mechanism is built for it.
+     */
+    residualSigma: number | undefined;
+    /** How many historical days the model was fitted on; zero while there is none */
+    sampleDays: number;
+    /** Which inputs the answer could be built from */
+    basis: iEnergyHistoryBasis;
+}

package/lib/interfaces/iEnergyHistoryOutlook.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iEnergyHistorySample.d.ts

@@ -0,0 +1,19 @@
+import { iEnergyHistoryFeatures } from './iEnergyHistoryFeatures';
+/**
+ * One historical observation: the features at a point in time and what happened afterwards.
+ */
+export interface iEnergyHistorySample {
+    /**
+     * The four quantities as they were at the moment of evaluation
+     */
+    features: iEnergyHistoryFeatures;
+    /**
+     * Change of state of charge in percentage points from the moment of evaluation to the next
+     * morning's low, already corrected for what the fossil generators contributed.
+     */
+    observedDelta: number;
+    /**
+     * The moment of evaluation this observation belongs to
+     */
+    date: Date;
+}

package/lib/interfaces/iEnergyHistorySample.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iFossilGeneratorRun.d.ts

@@ -0,0 +1,22 @@
+/**
+ * What one fuel burning generator contributed inside an observation window.
+ *
+ * The correction is additive across these, so a second block heat and power unit or a standby
+ * generator is one more entry rather than one more branch. Only fuel burning generators belong in
+ * here: the point of the correction is to leave behind what the photovoltaic system alone did, and a
+ * generator that runs on sunlight is part of that answer rather than something to subtract from it.
+ */
+export interface iFossilGeneratorRun {
+    /**
+     * How long the generator ran inside the window, in milliseconds
+     */
+    runMilliseconds: number;
+    /**
+     * Electrical rating of the generator in watt
+     */
+    ratedElectricalWattage: number;
+    /**
+     * Share of the generated energy that reached the battery, between 0 and 1
+     */
+    conversionFactor: number;
+}

package/lib/interfaces/iFossilGeneratorRun.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iFossilGeneratorSource.d.ts

@@ -0,0 +1,21 @@
+/**
+ * One fuel burning generator of the plant, seen from the history: the actuator whose recorded state
+ * changes say when it ran, plus what one hour of that run put into the battery.
+ *
+ * Implemented by the generator device itself, which is why the two numbers below are the device's own and
+ * not the asking caller's: what a unit is rated at and how much of that reaches the battery is a property of
+ * that machine, and nobody else can state it. Which generators the plant has is not asked here - a device
+ * carrying {@link DeviceCapability.fossilGenerator} is one, see {@link Devices.fossilGenerators}.
+ *
+ * Three values and no device surface, because the history only ever asks the persistence about them - a
+ * reader of this list is handed the generator's id, rating and factor and has no reason to know it is
+ * looking at a device at all.
+ */
+export interface iFossilGeneratorSource {
+    /** The device id the state changes of the generator are recorded under */
+    readonly actuatorId: string;
+    /** Electrical rating of the generator in watt */
+    readonly ratedElectricalWattage: number;
+    /** Share of the generated energy that reached the battery, between 0 and 1 */
+    readonly conversionFactor: number;
+}

package/lib/interfaces/iFossilGeneratorSource.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iMorningReserveVerdict.d.ts

@@ -0,0 +1,38 @@
+import { iProjectedSocBand } from './iProjectedSocBand';
+/**
+ * Whether the plant expects the coming morning low to stay above the reserve its battery must not fall below.
+ *
+ * A judgement about the plant, spoken by the plant: the reserve and the sun threshold it is measured against
+ * describe the battery, not whoever is asking. What a consumer does with a verdict - suppress, request, ignore -
+ * is that consumer's own risk appetite and stays with it.
+ */
+export interface iMorningReserveVerdict {
+    /**
+     * True while the coming morning holds the reserve, false while it misses it, undefined while the plant can
+     * say neither.
+     */
+    holds: boolean | undefined;
+    /**
+     * Whether {@link holds} rests on the plant's measured consumption alone.
+     *
+     * A verdict that needs the fitted model is reported but carries an unmeasured assumption: the window length
+     * of the fit has never been checked against recorded data. Consumers that move something act on the measured
+     * verdicts only; the modelled ones exist so an operator can see what the model would have said.
+     */
+    measured: boolean;
+    /** Whether a model was fitted at all when the verdict was formed, regardless of which rung answered */
+    modelFitted: boolean;
+    /** What made the plant answer this way, as one phrase for the asking consumer's log line */
+    reason: string;
+    /** The state of charge in percent every projection behind the verdict starts from */
+    currentSoc: number;
+    /**
+     * The projected morning state of charge at both band edges. Both edges collapse onto {@link currentSoc}
+     * wherever the verdict needed no band.
+     */
+    band: iProjectedSocBand;
+    /** The minimum morning state of charge in percent the verdict was measured against */
+    reserve: number;
+    /** How many historical days the model was fitted on; zero while there is none */
+    sampleDays: number;
+}

package/lib/interfaces/iMorningReserveVerdict.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iPersist.d.ts

@@ -6,6 +6,10 @@ import { iDesiredShutterPosition } from './IDesiredShutterPosition';
 import { iCountToday } from './iCountToday';
 import { iEnergyCalculation } from './iEnergyCalculation';
 import { iShutterCalibration } from './iShutterCalibration';
+import { iBatteryLevelSample } from './iBatteryLevelSample';
+import { iActuatorStateSample } from './iActuatorStateSample';
+import { iWeatherDaySummary } from './iWeatherDaySummary';
+import { iConsumptionWindowSample } from './iConsumptionWindowSample';
 /**
  * The interface to interact with the persistence layer.
  * In the past there was a mongo-db implementation, but this is now replaced by currently only postgresSql.
@@ -51,6 +55,53 @@ export interface iPersist {
      * @returns - The measurements
      */
     getTemperatureHistory(deviceId: string, startDate?: Date, endDate?: Date): Promise<iTemperatureMeasurement[]>;
+    /**
+     * Gets the recorded battery levels of the house battery within the given window, in percent, dated at the
+     * end of the interval each reading closes - the same time base the consumption readings use.
+     * An absent, unreachable or empty persistence is a defined state, not a failure: the answer is then an
+     * empty list. Readings without a usable level, and levels outside the range above 0 up to 100, are dropped
+     * rather than replaced by a substitute value - which means an energy manager that does not actually record
+     * the state of charge yields no history at all instead of a history of zeroes.
+     * @param startDate - Start of the window (inclusive)
+     * @param endDate - End of the window (inclusive)
+     * @returns - The readings, newest first
+     */
+    getBatteryLevelHistory(startDate: Date, endDate: Date): Promise<iBatteryLevelSample[]>;
+    /**
+     * Gets the recorded state changes of one actuator within the given window.
+     * An absent, unreachable or empty persistence is a defined state, not a failure: the answer is then an
+     * empty list.
+     * @param deviceId - The ID of the device to load the state changes for
+     * @param startDate - Start of the window (inclusive)
+     * @param endDate - End of the window (inclusive)
+     * @returns - The state changes, newest first
+     */
+    getActuatorHistory(deviceId: string, startDate: Date, endDate: Date): Promise<iActuatorStateSample[]>;
+    /**
+     * Gets the recorded house consumption within the given window. Each reading carries the energy consumed
+     * since the preceding one and is dated at the end of the interval it closes, so readings can be added up
+     * over a window without counting an interval into the wrong one.
+     * An absent, unreachable or empty persistence is a defined state, not a failure: the answer is then an
+     * empty list. Readings without a usable value are dropped rather than replaced by a substitute value.
+     * @param startDate - Start of the window (inclusive)
+     * @param endDate - End of the window (inclusive)
+     * @returns - The readings, newest first
+     */
+    getEnergyConsumptionHistory(startDate: Date, endDate: Date): Promise<iConsumptionWindowSample[]>;
+    /**
+     * Gets the stored daily weather aggregates within the given window.
+     * An absent, unreachable or empty persistence is a defined state, not a failure: the answer is then an
+     * empty list. Aggregates missing a value are dropped rather than completed with a substitute value.
+     * @param startDate - Start of the window (inclusive)
+     * @param endDate - End of the window (inclusive)
+     * @returns - The aggregates, newest first
+     */
+    getWeatherDaySummaries(startDate: Date, endDate: Date): Promise<iWeatherDaySummary[]>;
+    /**
+     * Persists one daily weather aggregate. Writing the same day twice updates the existing record.
+     * @param summary - The aggregate to persist
+     */
+    persistWeatherDaySummary(summary: iWeatherDaySummary): void;
     /**
      * Initializes the database-connection and prepares the database
      * @returns - The promise that resolves when the database is initialized

package/lib/interfaces/iProjectedSocBand.d.ts

@@ -0,0 +1,7 @@
+/** A projected state of charge at both edges of a band, in percent. */
+export interface iProjectedSocBand {
+    /** The lower edge in percent */
+    lower: number;
+    /** The upper edge in percent */
+    upper: number;
+}

package/lib/interfaces/iProjectedSocBand.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/iWeatherDaySummary.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The daily weather aggregate a historical day is characterised by.
+ */
+export interface iWeatherDaySummary {
+    /**
+     * The day this aggregate describes, at local midnight
+     */
+    date: Date;
+    /**
+     * Cloud cover in percent (0-100)
+     */
+    cloudCover: number;
+    /**
+     * The day's minimum temperature in degrees celsius
+     */
+    tempMin: number;
+    /**
+     * The day's maximum temperature in degrees celsius
+     */
+    tempMax: number;
+}

package/lib/interfaces/iWeatherDaySummary.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/index.d.ts

@@ -44,6 +44,22 @@ export * from './p-i-d-options';
 export { iDesiredShutterPosition } from './IDesiredShutterPosition';
 export { iCountToday } from './iCountToday';
 export { iEnergyCalculation } from './iEnergyCalculation';
+export * from './iConsumptionWindowSample';
+export * from './iEnergyHistoryBasis';
+export * from './iEnergyHistoryEstimate';
+export * from './iEnergyHistoryFeatures';
+export * from './iEnergyHistoryModel';
+export * from './iEnergyHistoryOptions';
+export * from './iEnergyHistoryOutlook';
+export * from './iEnergyHistorySample';
+export * from './iFossilGeneratorRun';
+export * from './iFossilGeneratorSource';
+export * from './iProjectedSocBand';
+export * from './iMorningReserveVerdict';
+export * from './iDachsHistoryGateResult';
+export * from './iBatteryLevelSample';
+export * from './iActuatorStateSample';
+export * from './iWeatherDaySummary';
 export { iShutterCalibration } from './iShutterCalibration';
 export { iDeviceList } from './iDeviceList';
 export { iIoBrokerBaseDevice } from './iIoBrokerBaseDevice';

package/lib/interfaces/index.js

@@ -57,3 +57,19 @@ __exportStar(require("./iProximityCallback"), exports);
 __exportStar(require("./iUnifiConnectionOptions"), exports);
 __exportStar(require("./iUnifiProtectOptions"), exports);
 __exportStar(require("./p-i-d-options"), exports);
+__exportStar(require("./iConsumptionWindowSample"), exports);
+__exportStar(require("./iEnergyHistoryBasis"), exports);
+__exportStar(require("./iEnergyHistoryEstimate"), exports);
+__exportStar(require("./iEnergyHistoryFeatures"), exports);
+__exportStar(require("./iEnergyHistoryModel"), exports);
+__exportStar(require("./iEnergyHistoryOptions"), exports);
+__exportStar(require("./iEnergyHistoryOutlook"), exports);
+__exportStar(require("./iEnergyHistorySample"), exports);
+__exportStar(require("./iFossilGeneratorRun"), exports);
+__exportStar(require("./iFossilGeneratorSource"), exports);
+__exportStar(require("./iProjectedSocBand"), exports);
+__exportStar(require("./iMorningReserveVerdict"), exports);
+__exportStar(require("./iDachsHistoryGateResult"), exports);
+__exportStar(require("./iBatteryLevelSample"), exports);
+__exportStar(require("./iActuatorStateSample"), exports);
+__exportStar(require("./iWeatherDaySummary"), exports);

package/lib/services/dbo/actuator-state-row.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The raw shape the driver hands back for one recorded actuator state change.
+ *
+ * The boolean column may arrive as a string depending on how it was written; the timestamp is a Date built
+ * from naive components because the column carries no zone.
+ *
+ * Not part of the published surface - a database row shape is not an interface anyone implements.
+ */
+export type ActuatorStateRow = {
+    /** Whether the actuator was on, as the driver hands it back */
+    on: boolean | string | null;
+    /** When the change was recorded, built from naive components */
+    date: Date | null;
+};

package/lib/services/dbo/actuator-state-row.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });