kirby-ocpp 0.1.2 → 0.2.0

package/dist/station/charging-profile-registry.js

@@ -1,125 +0,0 @@
-import { canStoreChargingProfile, effectiveChargingProfiles, isChargingProfileExpired, limitTransitionOffsets, matchesChargingProfileFilter, periodAt, readChargingProfile, readChargingRateUnit } from "./smart-charging.js";
-import { readNumber } from "./payload.js";
-export class ChargingProfileRegistry {
-    profiles = [];
-    get length() {
-        return this.profiles.length;
-    }
-    entries() {
-        return [...this.profiles];
-    }
-    replace(entries) {
-        this.profiles.splice(0, this.profiles.length, ...entries);
-    }
-    set(connectorId, profilePayload, options) {
-        const profile = readChargingProfile(profilePayload);
-        if (!profile || !canStoreChargingProfile(connectorId, profile, options)) {
-            return "Rejected";
-        }
-        const existingIndex = this.profiles.findIndex((entry) => entry.profile.chargingProfileId === profile.chargingProfileId);
-        if (existingIndex >= 0) {
-            this.profiles.splice(existingIndex, 1);
-        }
-        this.profiles.push({ connectorId, profile });
-        return "Accepted";
-    }
-    clear(payload) {
-        this.pruneExpired();
-        const before = this.profiles.length;
-        const remaining = this.profiles.filter((entry) => !matchesChargingProfileFilter(entry, payload));
-        this.profiles.splice(0, this.profiles.length, ...remaining);
-        return before - this.profiles.length > 0 ? "Accepted" : "Unknown";
-    }
-    clearForTransaction(transactionId) {
-        const before = this.profiles.length;
-        const remaining = this.profiles.filter((entry) => entry.profile.chargingProfilePurpose !== "TxProfile" || entry.profile.transactionId !== transactionId);
-        this.profiles.splice(0, this.profiles.length, ...remaining);
-        return this.profiles.length !== before;
-    }
-    pruneExpired(at = new Date()) {
-        const before = this.profiles.length;
-        const remaining = this.profiles.filter((entry) => !isChargingProfileExpired(entry.profile, at));
-        this.profiles.splice(0, this.profiles.length, ...remaining);
-        return this.profiles.length !== before;
-    }
-    compositeSchedulePayload(payload, transactionId, transactionStartedAt) {
-        const prunedExpired = this.pruneExpired();
-        const connectorId = readNumber(payload.connectorId, -1);
-        const duration = readNumber(payload.duration, 0);
-        const requestedUnit = readChargingRateUnit(payload.chargingRateUnit);
-        if (duration <= 0) {
-            return undefined;
-        }
-        const scheduleStart = new Date();
-        const defaultUnit = requestedUnit ?? effectiveChargingProfiles(this.profiles, connectorId, transactionId, scheduleStart)[0]?.profile.chargingSchedule.chargingRateUnit ?? "A";
-        const unit = defaultUnit;
-        const relativeStart = transactionStartedAt ? new Date(transactionStartedAt) : undefined;
-        const composite = compositeSchedule(this.profiles, connectorId, transactionId, unit, scheduleStart, duration, relativeStart);
-        if (composite.chargingSchedulePeriod.length === 0) {
-            return undefined;
-        }
-        const chargingSchedule = {
-            duration,
-            startSchedule: scheduleStart.toISOString(),
-            chargingRateUnit: unit,
-            chargingSchedulePeriod: composite.chargingSchedulePeriod
-        };
-        if (composite.minChargingRate !== undefined) {
-            chargingSchedule.minChargingRate = composite.minChargingRate;
-        }
-        return {
-            prunedExpired,
-            payload: {
-                status: "Accepted",
-                connectorId,
-                scheduleStart: scheduleStart.toISOString(),
-                chargingSchedule
-            }
-        };
-    }
-}
-function compositeSchedule(entries, connectorId, transactionId, unit, scheduleStart, duration, relativeStart) {
-    const offsets = new Set([0]);
-    const unitEntries = entries.filter((entry) => entry.profile.chargingSchedule.chargingRateUnit === unit);
-    for (const entry of unitEntries) {
-        for (const offset of limitTransitionOffsets(entry.profile, scheduleStart, duration, relativeStart)) {
-            offsets.add(offset);
-        }
-    }
-    let minChargingRate;
-    const chargingSchedulePeriod = [...offsets]
-        .sort((left, right) => left - right)
-        .map((offset) => {
-        const at = new Date(scheduleStart.getTime() + offset * 1000);
-        const activeProfiles = effectiveChargingProfiles(unitEntries, connectorId, transactionId, at, unit);
-        const activePeriods = activeProfiles
-            .map((entry) => ({ entry, period: periodAt(entry.profile, at, relativeStart, scheduleStart) }))
-            .filter((item) => item.period !== undefined);
-        for (const { entry } of activePeriods) {
-            const profileMin = entry.profile.chargingSchedule.minChargingRate;
-            if (profileMin !== undefined) {
-                minChargingRate = minChargingRate === undefined ? profileMin : Math.max(minChargingRate, profileMin);
-            }
-        }
-        if (activePeriods.length === 0) {
-            return undefined;
-        }
-        const limit = Math.min(...activePeriods.map(({ period }) => period.limit));
-        const limitingPhases = activePeriods
-            .filter(({ period }) => period.limit === limit)
-            .map(({ period }) => period.numberPhases)
-            .filter((numberPhases) => typeof numberPhases === "number" && Number.isFinite(numberPhases));
-        const period = { startPeriod: offset, limit };
-        if (limitingPhases.length > 0) {
-            period.numberPhases = Math.min(...limitingPhases);
-        }
-        return period;
-    })
-        .filter((period) => period !== undefined);
-    return {
-        chargingSchedulePeriod: chargingSchedulePeriod.filter((period, index) => index === 0 ||
-            period.limit !== chargingSchedulePeriod[index - 1]?.limit ||
-            period.numberPhases !== chargingSchedulePeriod[index - 1]?.numberPhases),
-        minChargingRate
-    };
-}

package/dist/station/configuration-commands.d.ts

@@ -1,11 +0,0 @@
-import type { ConfigurationRegistry } from "./configuration-registry.js";
-export interface ChangeConfigurationResult {
-    status: "Accepted" | "Rejected" | "NotSupported";
-    key: string;
-    value: string;
-}
-export declare function changeConfiguration(configuration: ConfigurationRegistry, payload: Record<string, unknown>): ChangeConfigurationResult;
-export declare function getConfiguration(configuration: ConfigurationRegistry, payload: Record<string, unknown>): {
-    configurationKey: Record<string, unknown>[];
-    unknownKey: string[];
-};

package/dist/station/configuration-commands.js

@@ -1,29 +0,0 @@
-import { readString } from "./payload.js";
-export function changeConfiguration(configuration, payload) {
-    const key = readString(payload.key, "");
-    const value = readString(payload.value, "");
-    const existing = configuration.get(key);
-    if (!existing) {
-        return { status: "NotSupported", key, value };
-    }
-    if (existing.readonly || (existing.validate && !existing.validate(value))) {
-        return { status: "Rejected", key, value };
-    }
-    configuration.setValue(key, value);
-    return { status: "Accepted", key, value };
-}
-export function getConfiguration(configuration, payload) {
-    const requestedKeys = Array.isArray(payload.key) ? payload.key.filter((key) => typeof key === "string") : [];
-    const keys = requestedKeys.length > 0 ? requestedKeys : configuration.keys();
-    const configurationKey = [];
-    const unknownKey = [];
-    for (const key of keys) {
-        const entry = configuration.get(key);
-        if (!entry) {
-            unknownKey.push(key);
-            continue;
-        }
-        configurationKey.push({ key, readonly: entry.readonly, value: entry.value });
-    }
-    return { configurationKey, unknownKey };
-}

package/dist/station/configuration-registry.d.ts

@@ -1,13 +0,0 @@
-import type { StationConfig } from "../ocpp/types.js";
-import { type ConfigurationKey } from "./configuration.js";
-import { type Measurand, type MeteringConfigurationKey } from "./metering.js";
-export declare class ConfigurationRegistry {
-    readonly values: Map<string, ConfigurationKey>;
-    constructor(config: StationConfig);
-    get(key: string): ConfigurationKey | undefined;
-    keys(): string[];
-    setValue(key: string, value: string): void;
-    boolean(key: string, fallback: boolean): boolean;
-    integer(key: string, fallback: number): number;
-    measurands(key: MeteringConfigurationKey): Measurand[];
-}

package/dist/station/configuration-registry.js

@@ -1,39 +0,0 @@
-import { createDefaultConfiguration } from "./configuration.js";
-import { readConfiguredMeasurands } from "./metering.js";
-export class ConfigurationRegistry {
-    values;
-    constructor(config) {
-        this.values = createDefaultConfiguration(config);
-    }
-    get(key) {
-        return this.values.get(key);
-    }
-    keys() {
-        return [...this.values.keys()];
-    }
-    setValue(key, value) {
-        const existing = this.values.get(key);
-        if (!existing) {
-            return;
-        }
-        this.values.set(key, { ...existing, value });
-    }
-    boolean(key, fallback) {
-        const value = this.values.get(key)?.value;
-        if (value === undefined) {
-            return fallback;
-        }
-        return value.toLowerCase() === "true";
-    }
-    integer(key, fallback) {
-        const value = this.values.get(key)?.value;
-        if (value === undefined) {
-            return fallback;
-        }
-        const parsed = Number.parseInt(value, 10);
-        return Number.isSafeInteger(parsed) ? parsed : fallback;
-    }
-    measurands(key) {
-        return readConfiguredMeasurands(this.values.get(key)?.value);
-    }
-}

package/dist/station/configuration.d.ts

@@ -1,7 +0,0 @@
-import type { StationConfig } from "../ocpp/types.js";
-export interface ConfigurationKey {
-    readonly: boolean;
-    value: string;
-    validate?: (value: string) => boolean;
-}
-export declare function createDefaultConfiguration(config: StationConfig): Map<string, ConfigurationKey>;

package/dist/station/configuration.js

@@ -1,88 +0,0 @@
-import { DEFAULT_SAMPLED_DATA, isValidSampledDataConfiguration, MEASURANDS } from "./metering.js";
-const SUPPORTED_FEATURE_PROFILES = [
-    "Core",
-    "FirmwareManagement",
-    "LocalAuthListManagement",
-    "Reservation",
-    "RemoteTrigger",
-    "SmartCharging"
-];
-const CONNECTOR_PHASE_ROTATIONS = new Set([
-    "NotApplicable",
-    "Unknown",
-    "RST",
-    "RTS",
-    "SRT",
-    "STR",
-    "TRS",
-    "TSR"
-]);
-const DEFAULT_SAMPLED_DATA_CONFIGURATION = DEFAULT_SAMPLED_DATA.join(",");
-export function createDefaultConfiguration(config) {
-    const configuration = new Map();
-    const boolean = (value) => isBooleanConfigurationValue(value);
-    const nonNegativeInteger = (value) => isIntegerConfigurationValue(value, 0);
-    const positiveInteger = (value) => isIntegerConfigurationValue(value, 1);
-    const sampledData = (value) => isValidSampledDataConfiguration(value);
-    const set = (key, readonly, value, validate) => {
-        configuration.set(key, { readonly, value, validate });
-    };
-    set("AllowOfflineTxForUnknownId", false, "false", boolean);
-    set("AuthorizationCacheEnabled", false, "true", boolean);
-    set("AuthorizeRemoteTxRequests", false, "false", boolean);
-    set("BlinkRepeat", false, "0", nonNegativeInteger);
-    set("ChargePointModel", true, config.model);
-    set("ChargePointSerialNumber", true, config.chargePointId);
-    set("ChargePointVendor", true, config.vendor);
-    set("ClockAlignedDataInterval", false, "0", nonNegativeInteger);
-    set("ConnectionTimeOut", false, "60", positiveInteger);
-    set("ConnectorPhaseRotation", false, "Unknown", isConnectorPhaseRotationConfiguration);
-    set("ConnectorPhaseRotationMaxLength", true, String(Math.max(1, config.connectorCount)));
-    set("GetConfigurationMaxKeys", true, "50");
-    set("HeartbeatInterval", false, String(config.heartbeatIntervalSeconds), positiveInteger);
-    set("LightIntensity", false, "0", nonNegativeInteger);
-    set("LocalAuthListEnabled", false, "true", boolean);
-    set("LocalAuthListMaxLength", true, "1000");
-    set("LocalAuthorizeOffline", false, "false", boolean);
-    set("LocalPreAuthorize", false, "false", boolean);
-    set("MaxEnergyOnInvalidId", false, "0", nonNegativeInteger);
-    set("MeterValuesAlignedData", false, DEFAULT_SAMPLED_DATA_CONFIGURATION, sampledData);
-    set("MeterValuesAlignedDataMaxLength", true, String(MEASURANDS.size));
-    set("MeterValuesSampledData", false, DEFAULT_SAMPLED_DATA_CONFIGURATION, sampledData);
-    set("MeterValuesSampledDataMaxLength", true, String(MEASURANDS.size));
-    set("MeterValueSampleInterval", false, "60", nonNegativeInteger);
-    set("MinimumStatusDuration", false, "0", nonNegativeInteger);
-    set("NumberOfConnectors", true, String(config.connectorCount));
-    set("ResetRetries", false, "0", nonNegativeInteger);
-    set("SendLocalListMaxLength", true, "1000");
-    set("StopTransactionOnEVSideDisconnect", false, "true", boolean);
-    set("StopTransactionOnInvalidId", false, "false", boolean);
-    set("StopTxnAlignedData", false, DEFAULT_SAMPLED_DATA_CONFIGURATION, sampledData);
-    set("StopTxnAlignedDataMaxLength", true, String(MEASURANDS.size));
-    set("StopTxnSampledData", false, DEFAULT_SAMPLED_DATA_CONFIGURATION, sampledData);
-    set("StopTxnSampledDataMaxLength", true, String(MEASURANDS.size));
-    set("SupportedFeatureProfiles", true, SUPPORTED_FEATURE_PROFILES.join(","));
-    set("SupportedFeatureProfilesMaxLength", true, String(SUPPORTED_FEATURE_PROFILES.length));
-    set("TransactionMessageAttempts", false, "1", positiveInteger);
-    set("TransactionMessageRetryInterval", false, "30", positiveInteger);
-    set("UnlockConnectorOnEVSideDisconnect", false, "false", boolean);
-    set("WebSocketPingInterval", false, "0", nonNegativeInteger);
-    return configuration;
-}
-function isBooleanConfigurationValue(value) {
-    return value === "true" || value === "false";
-}
-function isIntegerConfigurationValue(value, minimum) {
-    if (!/^\d+$/.test(value)) {
-        return false;
-    }
-    const parsed = Number.parseInt(value, 10);
-    return Number.isSafeInteger(parsed) && parsed >= minimum;
-}
-function isConnectorPhaseRotationConfiguration(value) {
-    const items = value
-        .split(",")
-        .map((item) => item.trim())
-        .filter(Boolean);
-    return items.length > 0 && items.every((item) => CONNECTOR_PHASE_ROTATIONS.has(item));
-}

package/dist/station/connector-registry.d.ts

@@ -1,25 +0,0 @@
-import type { ConnectorState } from "../ocpp/types.js";
-export declare class ConnectorRegistry {
-    private readonly primaryConnectorId;
-    private readonly connectors;
-    private onChange?;
-    constructor(primaryConnectorId: number, count: number);
-    setOnChange(onChange: () => void): void;
-    get size(): number;
-    has(id: number): boolean;
-    get(id: number): ConnectorState;
-    find(id: number): ConnectorState | undefined;
-    all(): ConnectorState[];
-    add(): ConnectorState;
-    ensureCount(count: number): void;
-    patch(id: number, patch: Partial<ConnectorState>): void;
-    snapshot(): {
-        connectors: ConnectorState[];
-        primary?: ConnectorState;
-    };
-    findAvailable(): ConnectorState | undefined;
-    findByTransaction(transactionId: number): ConnectorState | undefined;
-    findByReservation(reservationId: number): ConnectorState | undefined;
-    private nextId;
-    private notifyChange;
-}

package/dist/station/connector-registry.js

@@ -1,89 +0,0 @@
-export class ConnectorRegistry {
-    primaryConnectorId;
-    connectors = new Map();
-    onChange;
-    constructor(primaryConnectorId, count) {
-        this.primaryConnectorId = primaryConnectorId;
-        const connectorCount = Math.max(validConnectorCount(count), primaryConnectorId);
-        for (let connectorId = 1; connectorId <= connectorCount; connectorId += 1) {
-            this.connectors.set(connectorId, createConnector(connectorId));
-        }
-    }
-    setOnChange(onChange) {
-        this.onChange = onChange;
-    }
-    get size() {
-        return this.connectors.size;
-    }
-    has(id) {
-        return this.connectors.has(id);
-    }
-    get(id) {
-        const connector = this.connectors.get(id);
-        if (!connector) {
-            throw new Error(`Connector ${id} does not exist`);
-        }
-        return connector;
-    }
-    find(id) {
-        return this.connectors.get(id);
-    }
-    all() {
-        return [...this.connectors.values()].sort((left, right) => left.id - right.id);
-    }
-    add() {
-        const connector = createConnector(this.nextId());
-        this.connectors.set(connector.id, connector);
-        this.notifyChange();
-        return connector;
-    }
-    ensureCount(count) {
-        const initialSize = this.connectors.size;
-        while (this.connectors.size < count) {
-            const connector = createConnector(this.nextId());
-            this.connectors.set(connector.id, connector);
-        }
-        if (this.connectors.size !== initialSize) {
-            this.notifyChange();
-        }
-    }
-    patch(id, patch) {
-        Object.assign(this.get(id), patch);
-        this.notifyChange();
-    }
-    snapshot() {
-        const connectors = this.all().map((connector) => ({ ...connector }));
-        const primary = this.connectors.get(this.primaryConnectorId) ?? connectors[0];
-        return { connectors, primary };
-    }
-    findAvailable() {
-        return this.all().find((connector) => !connector.transactionId &&
-            connector.availability === "Operative" &&
-            connector.status === "Available");
-    }
-    findByTransaction(transactionId) {
-        return this.all().find((connector) => connector.transactionId === transactionId);
-    }
-    findByReservation(reservationId) {
-        return this.all().find((connector) => connector.reservationId === reservationId);
-    }
-    nextId() {
-        return Math.max(0, ...this.connectors.keys()) + 1;
-    }
-    notifyChange() {
-        this.onChange?.();
-    }
-}
-function validConnectorCount(count) {
-    return Number.isInteger(count) && count > 0 ? count : 1;
-}
-function createConnector(id) {
-    return {
-        id,
-        status: "Available",
-        availability: "Operative",
-        errorCode: "NoError",
-        evConnected: false,
-        meterWh: 0
-    };
-}

package/dist/station/connector-status.d.ts

@@ -1,7 +0,0 @@
-import type { AvailabilityType, ChargePointErrorCode, ConnectorState, ConnectorStatus } from "../ocpp/types.js";
-export declare const CONNECTOR_STATUS_SEQUENCE: ConnectorStatus[];
-export declare function nextConnectorStatus(status: ConnectorStatus): ConnectorStatus;
-export declare function faultErrorCode(connector: ConnectorState): ChargePointErrorCode;
-export declare function statusAfterReservationClear(connector: ConnectorState): ConnectorStatus;
-export declare function statusAfterFaultClear(connector: ConnectorState): ConnectorStatus;
-export declare function statusAfterAvailabilityChange(connector: ConnectorState, availability: AvailabilityType): ConnectorStatus;

package/dist/station/connector-status.js

@@ -1,66 +0,0 @@
-export const CONNECTOR_STATUS_SEQUENCE = [
-    "Available",
-    "Preparing",
-    "Charging",
-    "SuspendedEVSE",
-    "SuspendedEV",
-    "Finishing",
-    "Reserved",
-    "Unavailable",
-    "Faulted"
-];
-export function nextConnectorStatus(status) {
-    const currentIndex = CONNECTOR_STATUS_SEQUENCE.indexOf(status);
-    return CONNECTOR_STATUS_SEQUENCE[(currentIndex + 1) % CONNECTOR_STATUS_SEQUENCE.length] ?? "Available";
-}
-export function faultErrorCode(connector) {
-    return connector.errorCode === "NoError" ? "OtherError" : connector.errorCode;
-}
-export function statusAfterReservationClear(connector) {
-    if (connector.availability === "Inoperative" || connector.status === "Unavailable") {
-        return "Unavailable";
-    }
-    if (connector.status === "Faulted") {
-        return "Faulted";
-    }
-    if (connector.transactionId) {
-        return "Charging";
-    }
-    if (connector.evConnected) {
-        return "Preparing";
-    }
-    return "Available";
-}
-export function statusAfterFaultClear(connector) {
-    if (connector.availability === "Inoperative") {
-        return "Unavailable";
-    }
-    if (connector.transactionId) {
-        return "Charging";
-    }
-    if (connector.evConnected) {
-        return "Preparing";
-    }
-    if (connector.reservationId) {
-        return "Reserved";
-    }
-    return "Available";
-}
-export function statusAfterAvailabilityChange(connector, availability) {
-    if (connector.status === "Faulted") {
-        return "Faulted";
-    }
-    if (availability === "Inoperative") {
-        return "Unavailable";
-    }
-    if (connector.status === "Finishing") {
-        return "Finishing";
-    }
-    if (connector.reservationId) {
-        return "Reserved";
-    }
-    if (connector.evConnected) {
-        return "Preparing";
-    }
-    return "Available";
-}

package/dist/station/local-auth-list.d.ts

@@ -1,8 +0,0 @@
-export interface LocalAuthListUpdateResult {
-    status: "Accepted" | "Failed" | "NotSupported" | "VersionMismatch";
-    listVersion: number;
-}
-export declare function applyLocalAuthListUpdate(localAuthorizationList: Map<string, Record<string, unknown> | undefined>, currentVersion: number, payload: Record<string, unknown>, options: {
-    enabled: boolean;
-    maxLength: number;
-}): LocalAuthListUpdateResult;

package/dist/station/local-auth-list.js

@@ -1,31 +0,0 @@
-import { readNumber, readObject, readString } from "./payload.js";
-export function applyLocalAuthListUpdate(localAuthorizationList, currentVersion, payload, options) {
-    const listVersion = readNumber(payload.listVersion, currentVersion);
-    const updateType = readString(payload.updateType, "Full");
-    const entries = Array.isArray(payload.localAuthorizationList) ? payload.localAuthorizationList : [];
-    if (!options.enabled) {
-        return { status: "NotSupported", listVersion: currentVersion };
-    }
-    if (entries.length > options.maxLength) {
-        return { status: "Failed", listVersion: currentVersion };
-    }
-    if (updateType === "Differential" && listVersion <= currentVersion) {
-        return { status: "VersionMismatch", listVersion: currentVersion };
-    }
-    if (updateType === "Full") {
-        localAuthorizationList.clear();
-    }
-    for (const item of entries) {
-        const entry = readObject(item);
-        const idTag = readString(entry.idTag, "");
-        if (!idTag) {
-            continue;
-        }
-        if (updateType === "Differential" && !("idTagInfo" in entry)) {
-            localAuthorizationList.delete(idTag);
-            continue;
-        }
-        localAuthorizationList.set(idTag, "idTagInfo" in entry ? readObject(entry.idTagInfo) : undefined);
-    }
-    return { status: "Accepted", listVersion };
-}

package/dist/station/maintenance-lifecycle.d.ts

@@ -1,25 +0,0 @@
-import type { DiagnosticsStatus, FirmwareStatus } from "../ocpp/types.js";
-export type DiagnosticsOutcome = "success" | "uploadFailure";
-export type FirmwareOutcome = "success" | "downloadFailure" | "installationFailure";
-export declare class MaintenanceLifecycle {
-    private readonly options;
-    private diagnosticsTimers;
-    private firmwareTimers;
-    private diagnosticsOutcome;
-    private firmwareOutcome;
-    constructor(options: {
-        run: (task: () => Promise<void>) => void;
-        diagnosticsStatus: (status: DiagnosticsStatus) => Promise<void>;
-        firmwareStatus: (status: FirmwareStatus) => Promise<void>;
-        log: (level: "info" | "warn", message: string) => void;
-    });
-    setDiagnosticsOutcome(outcome: DiagnosticsOutcome): void;
-    setFirmwareOutcome(outcome: FirmwareOutcome): void;
-    startDiagnostics(payload: Record<string, unknown>): string;
-    startFirmware(payload: Record<string, unknown>): void;
-    clearAll(): void;
-    private clearDiagnostics;
-    private clearFirmware;
-    private schedule;
-    private clear;
-}