@utiliread/primitives 1.0.0-5 → 1.0.0-50

package/src/register-id.ts

@@ -1,191 +1,197 @@
-export type RegisterId =
-    "none" |
-    
-    "heatEnergy" |
-    "diffHeatEnergy" |
-
-    "heatEnergyVolumeInInlet" |
-    "diffHeatEnergyVolumeInInlet" |
-
-    "heatEnergyVolumeInOutlet" |
-    "diffHeatEnergyVolumeInOutlet" |
-
-    "coolingEnergy" |
-    "diffCoolingEnergy" |
-
-    "coolingEnergyVolumeInInlet" |
-    "diffCoolingEnergyVolumeInInlet" |
-
-    "coolingEnergyVolumeInOutlet" |
-    "diffCoolingEnergyVolumeInOutlet" |
-
-    "electricalEnergy" |
-    "diffElectricalEnergy" |
-
-    "reactiveEnergy" |
-    "diffReactiveEnergy" |
-
-    "volume" |
-    "diffVolume" |
-
-    "inletVolume" |
-    "diffInletVolume" |
-
-    "outletVolume" |
-    "diffOutletVolume" |
-
-    "pulseInputAVolume" |
-    "diffPulseInputAVolume" |
-
-    "pulseInputBVolume" |
-    "diffPulseInputBVolume" |
-
-    "mass" |
-    "diffMass" |
-
-    "inletMass" |
-    "diffInletMass" |
-
-    "outletMass" |
-    "diffOutletMass" |
-
-    "power" |
-    "maxPower" |
-    "minPower" |
-    "avgPower" |
-
-    "inletPower" |
-    "maxInletPower" |
-    "minInletPower" |
-    "avgInletPower" |
-
-    "outletPower" |
-    "maxOutletPower" |
-    "minOutletPower" |
-    "avgOutletPower" |
-
-    "volumeFlow" |
-    "maxVolumeFlow" |
-    "minVolumeFlow" |
-    "avgVolumeFlow" |
-
-    "inletVolumeFlow" |
-    "maxInletVolumeFlow" |
-    "minInletVolumeFlow" |
-    "avgInletVolumeFlow" |
-
-    "outletVolumeFlow" |
-    "maxOutletVolumeFlow" |
-    "minOutletVolumeFlow" |
-    "avgOutletVolumeFlow" |
-
-    "massFlow" |
-    "maxMassFlow" |
-    "minMassFlow" |
-    "avgMassFlow" |
-
-    "inletMassFlow" |
-    "maxInletMassFlow" |
-    "minInletMassFlow" |
-    "avgInletMassFlow" |
-
-    "outletMassFlow" |
-    "maxOutletMassFlow" |
-    "minOutletMassFlow" |
-    "avgOutletMassFlow" |
-
-    "flowTemperature" |
-    "maxFlowTemperature" |
-    "minFlowTemperature" |
-    "avgFlowTemperature" |
-
-    "inletFlowTemperature" |
-    "maxInletFlowTemperature" |
-    "minInletFlowTemperature" |
-    "avgInletFlowTemperature" |
-
-    "outletFlowTemperature" |
-    "maxOutletFlowTemperature" |
-    "minOutletFlowTemperature" |
-    "avgOutletFlowTemperature" |
-
-    "inletMinusOutletFlowTemperatureDifference" |
-    "maxInletMinusOutletFlowTemperatureDifference" |
-    "minInletMinusOutletFlowTemperatureDifference" |
-    "avgInletMinusOutletFlowTemperatureDifference" |
-
-    "outletMinusInletFlowTemperatureDifference" |
-    "maxOutletMinusInletFlowTemperatureDifference" |
-    "minOutletMinusInletFlowTemperatureDifference" |
-    "avgOutletMinusInletFlowTemperatureDifference" |
-
-    "ambientTemperature" |
-    "maxAmbientTemperature" |
-    "minAmbientTemperature" |
-    "avgAmbientTemperature" |
-
-    "radiatorTemperature" |
-    "maxRadiatorTemperature" |
-    "minRadiatorTemperature" |
-    "avgRadiatorTemperature" |
-
-    "relativeHumidity" |
-
-    "kamstrupE8Inlet" |
-    "diffKamstrupE8Inlet" |
-    "kamstrupE9Outlet" |
-    "diffKamstrupE9Outlet" |
-
-    "operatingTime" |
-    "diffOperatingTime" |
-
-    "remainingBatteryTime" |
-    "diffRemainingBatteryTime" |
-
-    "deviceDate" |
-    "deviceTime" |
-    "deviceDateTime" |
-
-    "timeSinceLastExactOverhearingArrived" |
-    "timeAtLastExactOverhearingArrived" |
-
-    "timeSinceLastPossibleCandidateOverhearingArrived" |
-    "timeAtLastPossibleCandidateOverhearingArrived" |
-    
-    "timeSinceLastSampled" |
-    "timeAtLastSampled" |
-    
-    "timeSinceLastInstallationMounted" |
-    "timeAtLastInstallationMounted" |
-
-    "basetime" |
-
-    "device" |
-    "wMBusDeviceAddresses" |
-    "kamdraftDeviceAddresses" |
-    "tchlrDeviceAddresses" |
-    "kamdaDeviceAddresses" |
-    "msisdnDeviceAddresses" |
-    "deviceRegisters" |
-    "consumptionZone" |
-
-    "mBusFormatStringSignature" |
-
-    "kamstrupMulticalInfocodeType1" |
-    "kamstrupMulticalInfocodeType2" |
-    "kamstrupMulticalInfocodeType3" |
-    "kamstrupMulticalInfocodeType4" |
-    "kamstrupMulticalInfocode" |
-    "kamstrupModuleType" |
-    
-    "diehlInfocodeType1" |
-    "diehlInfocode" |
-
-    "landisGyrMBusStatusType1" |
-    "landisGyrMBusStatusType2" |
-    "landisGyrMBusStatus" |
-    "landisGyrInfocodeType1" |
-    "landisGyrInfocodeType2" |
-    "landisGyrInfocode" |
-    
-    "infocode";
+export type RegisterId =
+    "none" |
+    
+    "heatEnergy" |
+    "diffHeatEnergy" |
+
+    "heatEnergyVolumeInInlet" |
+    "diffHeatEnergyVolumeInInlet" |
+
+    "heatEnergyVolumeInOutlet" |
+    "diffHeatEnergyVolumeInOutlet" |
+
+    "coolingEnergy" |
+    "diffCoolingEnergy" |
+
+    "coolingEnergyVolumeInInlet" |
+    "diffCoolingEnergyVolumeInInlet" |
+
+    "coolingEnergyVolumeInOutlet" |
+    "diffCoolingEnergyVolumeInOutlet" |
+
+    "electricalEnergy" |
+    "diffElectricalEnergy" |
+
+    "reactiveEnergy" |
+    "diffReactiveEnergy" |
+
+    "volume" |
+    "diffVolume" |
+
+    "inletVolume" |
+    "diffInletVolume" |
+
+    "outletVolume" |
+    "diffOutletVolume" |
+
+    "pulseInputAVolume" |
+    "diffPulseInputAVolume" |
+
+    "pulseInputBVolume" |
+    "diffPulseInputBVolume" |
+
+    "mass" |
+    "diffMass" |
+
+    "inletMass" |
+    "diffInletMass" |
+
+    "outletMass" |
+    "diffOutletMass" |
+
+    "power" |
+    "maxPower" |
+    "minPower" |
+    "avgPower" |
+
+    "inletPower" |
+    "maxInletPower" |
+    "minInletPower" |
+    "avgInletPower" |
+
+    "outletPower" |
+    "maxOutletPower" |
+    "minOutletPower" |
+    "avgOutletPower" |
+
+    "volumeFlow" |
+    "maxVolumeFlow" |
+    "minVolumeFlow" |
+    "avgVolumeFlow" |
+
+    "inletVolumeFlow" |
+    "maxInletVolumeFlow" |
+    "minInletVolumeFlow" |
+    "avgInletVolumeFlow" |
+
+    "outletVolumeFlow" |
+    "maxOutletVolumeFlow" |
+    "minOutletVolumeFlow" |
+    "avgOutletVolumeFlow" |
+
+    "massFlow" |
+    "maxMassFlow" |
+    "minMassFlow" |
+    "avgMassFlow" |
+
+    "inletMassFlow" |
+    "maxInletMassFlow" |
+    "minInletMassFlow" |
+    "avgInletMassFlow" |
+
+    "outletMassFlow" |
+    "maxOutletMassFlow" |
+    "minOutletMassFlow" |
+    "avgOutletMassFlow" |
+
+    "flowTemperature" |
+    "maxFlowTemperature" |
+    "minFlowTemperature" |
+    "avgFlowTemperature" |
+
+    "inletFlowTemperature" |
+    "maxInletFlowTemperature" |
+    "minInletFlowTemperature" |
+    "avgInletFlowTemperature" |
+
+    "outletFlowTemperature" |
+    "maxOutletFlowTemperature" |
+    "minOutletFlowTemperature" |
+    "avgOutletFlowTemperature" |
+
+    "inletMinusOutletFlowTemperatureDifference" |
+    "maxInletMinusOutletFlowTemperatureDifference" |
+    "minInletMinusOutletFlowTemperatureDifference" |
+    "avgInletMinusOutletFlowTemperatureDifference" |
+
+    "outletMinusInletFlowTemperatureDifference" |
+    "maxOutletMinusInletFlowTemperatureDifference" |
+    "minOutletMinusInletFlowTemperatureDifference" |
+    "avgOutletMinusInletFlowTemperatureDifference" |
+
+    "ambientTemperature" |
+    "maxAmbientTemperature" |
+    "minAmbientTemperature" |
+    "avgAmbientTemperature" |
+
+    "radiatorTemperature" |
+    "maxRadiatorTemperature" |
+    "minRadiatorTemperature" |
+    "avgRadiatorTemperature" |
+
+    "relativeHumidity" |
+
+    "kamstrupE8Inlet" |
+    "diffKamstrupE8Inlet" |
+    "kamstrupE9Outlet" |
+    "diffKamstrupE9Outlet" |
+
+    "operatingTime" |
+    "diffOperatingTime" |
+
+    "remainingBatteryTime" |
+    "diffRemainingBatteryTime" |
+
+    "deviceDate" |
+    "deviceTime" |
+    "deviceDateTime" |
+
+    "timeSinceLastExactOverhearingArrived" |
+    "timeAtLastExactOverhearingArrived" |
+
+    "timeSinceLastPossibleCandidateOverhearingArrived" |
+    "timeAtLastPossibleCandidateOverhearingArrived" |
+    
+    "timeSinceLastSampled" |
+    "timeAtLastSampled" |
+    
+    "timeSinceLastInstallationMounted" |
+    "timeAtLastInstallationMounted" |
+
+    "basetime" |
+    "instantTime" |
+    "periodStartTime" |
+    "periodEndTime" |
+    "instantOrPeriodStartTime" |
+    "instantOrPeriodEndTime" |
+
+    "device" |
+    "wMBusDeviceAddresses" |
+    "kamdraftDeviceAddresses" |
+    "tchlrDeviceAddresses" |
+    "kamdaDeviceAddresses" |
+    "msisdnDeviceAddresses" |
+    "deviceRegisters" |
+    "consumptionZone" |
+
+    "mBusFormatStringSignature" |
+    "deviceSoftwareVersion" |
+
+    "kamstrupMulticalInfocodeType1" |
+    "kamstrupMulticalInfocodeType2" |
+    "kamstrupMulticalInfocodeType3" |
+    "kamstrupMulticalInfocodeType4" |
+    "kamstrupMulticalInfocode" |
+    "kamstrupModuleType" |
+    
+    "diehlInfocodeType1" |
+    "diehlInfocode" |
+
+    "landisGyrMBusStatusType1" |
+    "landisGyrMBusStatusType2" |
+    "landisGyrMBusStatus" |
+    "landisGyrInfocodeType1" |
+    "landisGyrInfocodeType2" |
+    "landisGyrInfocode" |
+    
+    "infocode";

package/src/register-library.spec.ts

@@ -1,33 +1,41 @@
-import { expect } from "chai";
-import { RegisterDefinition } from ".";
-import { RegisterLibrary } from "./register-library";
-
-const volume: RegisterDefinition = {
-    id: "volume",
-    aggregate: "instant",
-    units: ["cubicMeter"]
-};
-
-describe("library", () => {
-    beforeEach(() => {
-        RegisterLibrary.reset();
-    });
-
-    it("should get added definition", () => {
-        RegisterLibrary.add(volume);
-        const definition = RegisterLibrary.get("volume");
-        expect(definition.id).to.equal("volume");
-    });
-
-    it("should add all definitions in pack", () => {
-        RegisterLibrary.add({
-            someRandomKey: volume
-        });
-        const definition = RegisterLibrary.get("volume");
-        expect(definition.id).to.equal("volume");
-    });
-
-    it("should throw when getting not added register", () => {
-        expect(() => RegisterLibrary.get("volume")).to.throw();
-    });
-});
+import { expect } from "chai";
+import { RegisterDefinition } from ".";
+import { RegisterLibrary } from "./register-library";
+
+const volume: RegisterDefinition = {
+    id: "volume",
+    measure: "volume",
+    aggregate: "instant",
+    units: ["cubicMeter"]
+};
+
+describe("library", () => {
+    beforeEach(() => {
+        RegisterLibrary.reset();
+    });
+
+    it("should get added definition", () => {
+        RegisterLibrary.add(volume);
+        const definition = RegisterLibrary.get("volume");
+        expect(definition.id).to.equal("volume");
+    });
+
+    it("should add all definitions in pack", () => {
+        RegisterLibrary.add({
+            someRandomKey: volume
+        });
+        const definition = RegisterLibrary.get("volume");
+        expect(definition.id).to.equal("volume");
+    });
+
+    it("should throw when getting not added register", () => {
+        expect(() => RegisterLibrary.get("volume")).to.throw();
+    });
+
+    it("should return all definitions when invoking all()", () => {
+        RegisterLibrary.add(volume);
+        RegisterLibrary.add(volume); // Only added once.
+        const all = RegisterLibrary.all();
+        expect(all.length).to.equal(1);
+    })
+});

package/src/register-library.ts

@@ -1,37 +1,57 @@
-import { RegisterDefinition } from "./register-definition";
-import { RegisterId } from "./register-id";
-import { RegisterPack } from "./register-pack";
-
-class Library {
-    private definitions: Partial<{ [id in RegisterId]: RegisterDefinition }> = {};
-    public add(...definitions: (RegisterDefinition | RegisterPack)[]) {
-        for (const definition of definitions) {
-            if (isDefinition(definition)) {
-                this.definitions[definition.id] = definition;
-            }
-            else {
-                for (const definitionInPack of Object.values(definition)) {
-                    this.definitions[definitionInPack.id] = definitionInPack;
-                }
-            }
-        }
-    }
-
-    public get(id: RegisterId) {
-        const definition = this.definitions[id];
-        if (!definition) {
-            throw new Error(`Defintion was not loaded for register ${id}`);
-        }
-        return definition;
-    }
-
-    public reset() {
-        this.definitions = {};
-    }
-}
-
-function isDefinition(definitionOrPack: RegisterDefinition | RegisterPack): definitionOrPack is RegisterDefinition {
-    return !!(definitionOrPack.id && definitionOrPack.aggregate && definitionOrPack.units);
-}
-
-export const RegisterLibrary = new Library();
+import { RegisterDefinition } from "./register-definition";
+import { RegisterId } from "./register-id";
+import { RegisterPack } from "./register-pack";
+
+class Library {
+    private definitions: Partial<{ [id in RegisterId]: RegisterDefinition }> = {};
+    public add(...definitions: (RegisterDefinition | RegisterPack)[]) {
+        for (const definition of definitions) {
+            if (isDefinition(definition)) {
+                this.tryAdd(definition);
+            }
+            else {
+                for (const definitionInPack of Object.values(definition)) {
+                    this.tryAdd(definitionInPack);
+                }
+            }
+        }
+    }
+
+    private tryAdd(definition: RegisterDefinition) {
+        if (!this.definitions[definition.id]) {
+            this.definitions[definition.id] = definition;
+            return true;
+        }
+        return false;
+    }
+
+    public has(id: RegisterId) {
+        return !!this.definitions[id];
+    }
+
+    public tryGet(id: RegisterId) {
+        return this.definitions[id];
+    }
+
+    public get(id: RegisterId) {
+        const definition = this.definitions[id];
+        if (!definition) {
+            throw new Error(`Defintion was not loaded for register ${id}`);
+        }
+        return definition;
+    }
+
+    public all() {
+        return Object.values(this.definitions).map(x => x!);
+    }
+
+    public reset() {
+        this.definitions = {};
+    }
+}
+
+function isDefinition(definitionOrPack: RegisterDefinition | RegisterPack): definitionOrPack is RegisterDefinition {
+    return !!(definitionOrPack.id && definitionOrPack.aggregate && definitionOrPack.units);
+}
+
+export const RegisterLibrary = new Library();

package/src/register-pack.ts

@@ -1,5 +1,5 @@
-import { RegisterDefinition } from "./register-definition";
-
-export interface RegisterPack {
-    [key: string]: RegisterDefinition;
-}
+import { RegisterDefinition } from "./register-definition";
+
+export interface RegisterPack {
+    [key: string]: RegisterDefinition;
+}

package/src/register-utils.ts

@@ -0,0 +1,6 @@
+import { RegisterDefinition } from "./register-definition";
+import { RegisterId } from "./register-id";
+
+export function getRegisterId(register: RegisterId | RegisterDefinition) {
+    return typeof register === "string" ? register : register.id;
+}

package/src/repository.spec.ts

@@ -0,0 +1,20 @@
+import { expect } from "chai";
+import { Repository } from "./repository";
+
+describe("ctor", () => {
+    it("creates", () => {
+        expect(Repository("gpkv", "gjoel")).to.equal("gpkv/gjoel");
+        expect(Repository("gpkv/gjoel")).to.equal("gpkv/gjoel");
+    });
+    it("throws if wrong format", () => {
+        expect(() => Repository("invalid")).to.throw();
+    })
+});
+
+describe("split", () => {
+    it("splits into correct parts", () => {
+        const { team, name } = Repository.split(Repository("gpkv", "gjoel"));
+        expect(team).to.equal("gpkv");
+        expect(name).to.equal("gjoel");
+    });
+});

package/src/repository.ts

@@ -0,0 +1,24 @@
+// This is clearly not correct but it provides some amazing type safety
+export type Repository = "some/repo";
+
+export function Repository(repo: string): Repository;
+export function Repository(team: string, name: string): Repository;
+export function Repository(repoOrTeam: string, name?: string): Repository {
+    if (name) {
+        return <Repository>`${repoOrTeam}/${name}`;
+    } else if (repoOrTeam.indexOf("/") > 0) {
+        return <Repository>repoOrTeam;
+    } else {
+        throw new TypeError("Invalid repository format");
+    }
+}
+
+export namespace Repository {
+    export function split(repo: Repository) {
+        const parts = repo.split("/");
+        return {
+            team: parts[0],
+            name: parts[1],
+        };
+    }
+}

package/src/step.spec.ts

@@ -0,0 +1,30 @@
+import { expect } from "chai";
+import { DateTime } from "luxon";
+import { DayOfWeek, Step } from "./step";
+
+describe("startOf", () => {
+    it("returns start of day", () => {
+        const dt = DateTime.fromISO("2020-01-11T05:00:00+01:00");
+        const result = Step.startOf(dt, "day");
+        expect(+result).to.equal(+DateTime.fromISO("2020-01-11T00:00:00+01:00"));
+    });
+
+    it("returns previous monday from saturday", () => {
+        const dt = DateTime.fromISO("2020-01-11T05:00:00+01:00");
+        const result = Step.startOf(dt, "week", DayOfWeek.Monday);
+        expect(+result).to.equal(+DateTime.fromISO("2020-01-06T00:00:00+01:00"));
+    });
+
+    it("returns same monday from monday with hour", () => {
+        const dt = DateTime.fromISO("2020-01-13T05:00:00+01:00");
+        const result = Step.startOf(dt, "week", DayOfWeek.Monday);
+        expect(+result).to.equal(+DateTime.fromISO("2020-01-13T00:00:00+01:00"));
+    });
+});
+
+describe("asDuration", () => {
+    it("should return equivalent duration", () => {
+        const duration = Step.asDuration("week");
+        expect(duration.days).to.equal(7);
+    });
+});