kirby-ocpp 0.1.2 → 0.2.0

package/dist/ocpp/schemas/json/StatusNotificationResponse.json

@@ -1,8 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:StatusNotificationResponse",
-    "title": "StatusNotificationResponse",
-    "type": "object",
-    "properties": {},
-    "additionalProperties": false
-}

package/dist/ocpp/schemas/json/StopTransaction.json

@@ -1,177 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2025:04:StopTransactionRequest",
-    "title": "StopTransactionRequest",
-    "type": "object",
-    "properties": {
-        "idTag": {
-            "type": "string",
-            "maxLength": 20
-        },
-        "meterStop": {
-            "type": "integer"
-        },
-        "timestamp": {
-            "type": "string",
-            "format": "date-time"
-        },
-        "transactionId": {
-            "type": "integer"
-        },
-        "reason": {
-            "type": "string",
-            "additionalProperties": false,
-            "enum": [
-                "EmergencyStop",
-                "EVDisconnected",
-                "HardReset",
-                "Local",
-                "Other",
-                "PowerLoss",
-                "Reboot",
-                "Remote",
-                "SoftReset",
-                "UnlockCommand",
-                "DeAuthorized"
-            ]
-        },
-        "transactionData": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "timestamp": {
-                        "type": "string",
-                        "format": "date-time"
-                    },
-                    "sampledValue": {
-                        "type": "array",
-                        "items": {
-                            "type": "object",
-                            "properties": {
-                                "value": {
-                                    "type": "string"
-                                },
-                                "context": {
-                                    "type": "string",
-                                    "additionalProperties": false,
-                                    "enum": [
-                                        "Interruption.Begin",
-                                        "Interruption.End",
-                                        "Sample.Clock",
-                                        "Sample.Periodic",
-                                        "Transaction.Begin",
-                                        "Transaction.End",
-                                        "Trigger",
-                                        "Other"
-                                    ]
-                                },  
-                                "format": {
-                                    "type": "string",
-                                    "additionalProperties": false,
-                                    "enum": [
-                                        "Raw",
-                                        "SignedData"
-                                    ]
-                                },
-                                "measurand": {
-                                    "type": "string",
-                                    "additionalProperties": false,
-                                    "enum": [
-                                        "Energy.Active.Export.Register",
-                                        "Energy.Active.Import.Register",
-                                        "Energy.Reactive.Export.Register",
-                                        "Energy.Reactive.Import.Register",
-                                        "Energy.Active.Export.Interval",
-                                        "Energy.Active.Import.Interval",
-                                        "Energy.Reactive.Export.Interval",
-                                        "Energy.Reactive.Import.Interval",
-                                        "Power.Active.Export",
-                                        "Power.Active.Import",
-                                        "Power.Offered",
-                                        "Power.Reactive.Export",
-                                        "Power.Reactive.Import",
-                                        "Power.Factor",
-                                        "Current.Import",
-                                        "Current.Export",
-                                        "Current.Offered",
-                                        "Voltage",
-                                        "Frequency",
-                                        "Temperature",
-                                        "SoC",
-                                        "RPM"
-                                    ]
-                                },
-                                "phase": {
-                                    "type": "string",
-                                    "additionalProperties": false,
-                                    "enum": [
-                                        "L1",
-                                        "L2",
-                                        "L3",
-                                        "N",
-                                        "L1-N",
-                                        "L2-N",
-                                        "L3-N",
-                                        "L1-L2",
-                                        "L2-L3",
-                                        "L3-L1"
-                                    ]
-                                },
-                                "location": {
-                                    "type": "string",
-                                    "additionalProperties": false,
-                                    "enum": [
-                                        "Cable",
-                                        "EV",
-                                        "Inlet",
-                                        "Outlet",
-                                        "Body"
-                                    ]
-                                },
-                                "unit": {
-                                    "type": "string",
-                                    "additionalProperties": false,
-                                    "enum": [
-                                        "Wh",
-                                        "kWh",
-                                        "varh",
-                                        "kvarh",
-                                        "W",
-                                        "kW",
-                                        "VA",
-                                        "kVA",
-                                        "var",
-                                        "kvar",
-                                        "A",
-                                        "V",
-                                        "K",
-                                        "Celcius",
-                                        "Celsius",
-                                        "Fahrenheit",
-                                        "Percent"
-                                    ]
-                                }
-                            },
-                            "additionalProperties": false,
-                            "required": [
-                                "value"
-                            ]
-                        }
-                    }
-                },
-                "additionalProperties": false,
-                "required": [
-                    "timestamp",
-                    "sampledValue"
-                ]
-            }
-        }
-    },
-    "additionalProperties": false,
-    "required": [
-        "transactionId",
-        "timestamp",
-        "meterStop"
-    ]
-}

package/dist/ocpp/schemas/json/StopTransactionResponse.json

@@ -1,37 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:StopTransactionResponse",
-    "title": "StopTransactionResponse",
-    "type": "object",
-    "properties": {
-        "idTagInfo": {
-            "type": "object",
-            "properties": {
-                "expiryDate": {
-                    "type": "string",
-                    "format": "date-time"
-                },
-                "parentIdTag": {
-                    "type": "string",
-                    "maxLength": 20
-                },
-                "status": {
-                    "type": "string",
-                    "additionalProperties": false,
-                    "enum": [
-                        "Accepted",
-                        "Blocked",
-                        "Expired",
-                        "Invalid",
-                        "ConcurrentTx"
-                    ]
-                }
-            },
-            "additionalProperties": false,
-            "required": [
-                "status"
-            ]
-        }
-    },
-    "additionalProperties": false
-}

package/dist/ocpp/schemas/json/TriggerMessage.json

@@ -1,27 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:TriggerMessageRequest",
-    "title": "TriggerMessageRequest",
-    "type": "object",
-    "properties": {
-        "requestedMessage": {
-            "type": "string",
-            "additionalProperties": false,
-            "enum": [
-                "BootNotification",
-                "DiagnosticsStatusNotification",
-                "FirmwareStatusNotification",
-                "Heartbeat",
-                "MeterValues",
-                "StatusNotification"
-            ]
-        },
-        "connectorId": {
-            "type": "integer"
-        }
-    },
-    "additionalProperties": false,
-    "required": [
-        "requestedMessage"
-    ]
-}

package/dist/ocpp/schemas/json/TriggerMessageResponse.json

@@ -1,21 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:TriggerMessageResponse",
-    "title": "TriggerMessageResponse",
-    "type": "object",
-    "properties": {
-        "status": {
-            "type": "string",
-            "additionalProperties": false,
-            "enum": [
-                "Accepted",
-                "Rejected",
-                "NotImplemented"
-            ]
-        }
-    },
-    "additionalProperties": false,
-    "required": [
-        "status"
-    ]
-}

package/dist/ocpp/schemas/json/UnlockConnector.json

@@ -1,15 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:UnlockConnectorRequest",
-    "title": "UnlockConnectorRequest",
-    "type": "object",
-    "properties": {
-        "connectorId": {
-            "type": "integer"
-        }
-    },
-    "additionalProperties": false,
-    "required": [
-        "connectorId"
-    ]
-}

package/dist/ocpp/schemas/json/UnlockConnectorResponse.json

@@ -1,21 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:UnlockConnectorResponse",
-    "title": "UnlockConnectorResponse",
-    "type": "object",
-    "properties": {
-        "status": {
-            "type": "string",
-            "additionalProperties": false,
-            "enum": [
-                "Unlocked",
-                "UnlockFailed",
-                "NotSupported"
-            ]
-        }
-    },
-    "additionalProperties": false,
-    "required": [
-        "status"
-    ]
-}

package/dist/ocpp/schemas/json/UpdateFirmware.json

@@ -1,27 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:UpdateFirmwareRequest",
-    "title": "UpdateFirmwareRequest",
-    "type": "object",
-    "properties": {
-        "location": {
-            "type": "string",
-            "format": "uri"
-        },
-        "retries": {
-            "type": "integer"
-        },
-        "retrieveDate": {
-            "type": "string",
-            "format": "date-time"
-        },
-        "retryInterval": {
-            "type": "integer"
-        }
-    },
-    "additionalProperties": false,
-    "required": [
-        "location",
-        "retrieveDate"
-    ]
-}

package/dist/ocpp/schemas/json/UpdateFirmwareResponse.json

@@ -1,8 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-    "id": "urn:OCPP:1.6:2019:12:UpdateFirmwareResponse",
-    "title": "UpdateFirmwareResponse",
-    "type": "object",
-    "properties": {},
-    "additionalProperties": false
-}

package/dist/ocpp/types.d.ts

@@ -1,106 +0,0 @@
-export type OcppCall = [2, string, string, Record<string, unknown>];
-export type OcppCallResult = [3, string, Record<string, unknown>];
-export type OcppCallError = [4, string, string, string, Record<string, unknown>];
-export type OcppMessage = OcppCall | OcppCallResult | OcppCallError;
-export type ConnectorStatus = "Available" | "Preparing" | "Charging" | "SuspendedEVSE" | "SuspendedEV" | "Finishing" | "Reserved" | "Unavailable" | "Faulted";
-export type ChargePointErrorCode = "ConnectorLockFailure" | "EVCommunicationError" | "GroundFailure" | "HighTemperature" | "InternalError" | "LocalListConflict" | "NoError" | "OtherError" | "OverCurrentFailure" | "PowerMeterFailure" | "PowerSwitchFailure" | "ReaderFailure" | "ResetFailure" | "UnderVoltage" | "OverVoltage" | "WeakSignal";
-export type AvailabilityType = "Operative" | "Inoperative";
-export type RegistrationStatus = "Accepted" | "Pending" | "Rejected";
-export type DiagnosticsStatus = "Idle" | "Uploaded" | "UploadFailed" | "Uploading";
-export type FirmwareStatus = "Downloaded" | "DownloadFailed" | "Downloading" | "Idle" | "InstallationFailed" | "Installing" | "Installed";
-export type StopReason = "EmergencyStop" | "EVDisconnected" | "HardReset" | "Local" | "Other" | "PowerLoss" | "Reboot" | "Remote" | "SoftReset" | "UnlockCommand" | "DeAuthorized";
-export interface CallResponse {
-    messageId: string;
-    payload: Record<string, unknown>;
-}
-export interface CallErrorResponse {
-    messageId: string;
-    code: string;
-    description: string;
-    details: Record<string, unknown>;
-}
-export interface PendingCall {
-    action: string;
-    resolve: (response: CallResponse) => void;
-    reject: (error: Error) => void;
-    timeout: NodeJS.Timeout;
-}
-export interface StationConfig {
-    centralSystemUrl: string;
-    chargePointId: string;
-    vendor: string;
-    model: string;
-    connectorId: number;
-    connectorCount: number;
-    heartbeatIntervalSeconds: number;
-    persistState: boolean;
-    stateDirectory?: string;
-    webSocketSubprotocol: string;
-    webSocketPingIntervalSeconds: number;
-    webSocketReconnectEnabled: boolean;
-    webSocketReconnectInitialDelayMs: number;
-    webSocketReconnectMaxDelayMs: number;
-    webSocketReconnectMaxAttempts: number;
-    callTimeoutMs: number;
-    tlsRejectUnauthorized: boolean;
-    tlsCaFile?: string;
-    tlsCertFile?: string;
-    tlsKeyFile?: string;
-    tlsServerName?: string;
-}
-export interface ConnectorState {
-    id: number;
-    status: ConnectorStatus;
-    availability: AvailabilityType;
-    errorCode: ChargePointErrorCode;
-    info?: string;
-    vendorId?: string;
-    vendorErrorCode?: string;
-    evConnected: boolean;
-    transactionId?: number;
-    transactionStartedAt?: string;
-    reservationId?: number;
-    reservationIdTag?: string;
-    reservationParentIdTag?: string;
-    reservationExpiryDate?: string;
-    lastIdTag?: string;
-    stopTransactionAtWh?: number;
-    pendingStartTransaction?: PendingStartTransaction;
-    pendingStopTransaction?: PendingStopTransaction;
-    meterWh: number;
-}
-export interface PendingStartTransaction {
-    connectorId: number;
-    idTag: string;
-    meterStart: number;
-    timestamp: string;
-    reservationId?: number;
-}
-export interface PendingStopTransaction {
-    meterStop: number;
-    timestamp: string;
-    reason: StopReason;
-    idTag?: string;
-    transactionData: Record<string, unknown>[];
-}
-export interface StationState {
-    connected: boolean;
-    booted: boolean;
-    registrationStatus: RegistrationStatus | "Unknown";
-    connectorStatus: ConnectorStatus;
-    availability: AvailabilityType;
-    transactionId?: number;
-    reservationId?: number;
-    localListVersion: number;
-    meterWh: number;
-    connectors: ConnectorState[];
-    diagnosticsStatus?: DiagnosticsStatus;
-    firmwareStatus?: FirmwareStatus;
-    lastHeartbeatAt?: Date;
-}
-export interface LogEntry {
-    at: Date;
-    level: "info" | "success" | "warn" | "error" | "in" | "out";
-    message: string;
-    details?: string;
-}

package/dist/ocpp/types.js

@@ -1 +0,0 @@
-export {};

package/dist/station/authorization.d.ts

@@ -1,20 +0,0 @@
-export type IdTagStatus = "Accepted" | "Blocked" | "Expired" | "Invalid" | "ConcurrentTx";
-export interface IdTagInfo {
-    status: IdTagStatus;
-    expiryDate?: string;
-    parentIdTag?: string;
-}
-export interface AuthorizationDecision {
-    accepted: boolean;
-    idTagInfo: IdTagInfo;
-    source: "CentralSystem" | "LocalList" | "AuthorizationCache" | "OfflineUnknown" | "None";
-}
-export declare function authorizeLocally(idTag: string, requireOfflinePermission: boolean, localAuthorizationList: Map<string, Record<string, unknown> | undefined>, authorizationCache: Map<string, Record<string, unknown> | undefined>, configuration: {
-    localAuthListEnabled: boolean;
-    localAuthorizeOffline: boolean;
-    authorizationCacheEnabled: boolean;
-    allowOfflineTxForUnknownId: boolean;
-}): AuthorizationDecision;
-export declare function normalizeIdTagInfo(value: Record<string, unknown> | undefined): IdTagInfo;
-export declare function serializeIdTagInfo(idTagInfo: IdTagInfo): Record<string, unknown>;
-export declare function isAcceptedIdTagInfo(idTagInfo: IdTagInfo): boolean;

package/dist/station/authorization.js

@@ -1,78 +0,0 @@
-export function authorizeLocally(idTag, requireOfflinePermission, localAuthorizationList, authorizationCache, configuration) {
-    if (requireOfflinePermission && !configuration.localAuthorizeOffline) {
-        return {
-            accepted: false,
-            idTagInfo: { status: "Invalid" },
-            source: "None"
-        };
-    }
-    const localListInfo = localAuthorizationList.get(idTag);
-    if (configuration.localAuthListEnabled && localAuthorizationList.has(idTag)) {
-        const idTagInfo = normalizeIdTagInfo(localListInfo);
-        return {
-            accepted: isAcceptedIdTagInfo(idTagInfo),
-            idTagInfo,
-            source: "LocalList"
-        };
-    }
-    if (configuration.authorizationCacheEnabled && authorizationCache.has(idTag)) {
-        const idTagInfo = normalizeIdTagInfo(authorizationCache.get(idTag));
-        return {
-            accepted: isAcceptedIdTagInfo(idTagInfo),
-            idTagInfo,
-            source: "AuthorizationCache"
-        };
-    }
-    if (requireOfflinePermission && configuration.allowOfflineTxForUnknownId) {
-        return {
-            accepted: true,
-            idTagInfo: { status: "Accepted" },
-            source: "OfflineUnknown"
-        };
-    }
-    return {
-        accepted: false,
-        idTagInfo: { status: "Invalid" },
-        source: "None"
-    };
-}
-export function normalizeIdTagInfo(value) {
-    const status = readIdTagStatus(value?.status, "Accepted");
-    const expiryDate = readOptionalString(value?.expiryDate);
-    const parentIdTag = readOptionalString(value?.parentIdTag);
-    const idTagInfo = {
-        status: expiryDate && Date.parse(expiryDate) <= Date.now() ? "Expired" : status
-    };
-    if (expiryDate) {
-        idTagInfo.expiryDate = expiryDate;
-    }
-    if (parentIdTag) {
-        idTagInfo.parentIdTag = parentIdTag;
-    }
-    return idTagInfo;
-}
-export function serializeIdTagInfo(idTagInfo) {
-    const output = { status: idTagInfo.status };
-    if (idTagInfo.expiryDate) {
-        output.expiryDate = idTagInfo.expiryDate;
-    }
-    if (idTagInfo.parentIdTag) {
-        output.parentIdTag = idTagInfo.parentIdTag;
-    }
-    return output;
-}
-export function isAcceptedIdTagInfo(idTagInfo) {
-    return idTagInfo.status === "Accepted";
-}
-function readIdTagStatus(value, fallback) {
-    return value === "Accepted" ||
-        value === "Blocked" ||
-        value === "Expired" ||
-        value === "Invalid" ||
-        value === "ConcurrentTx"
-        ? value
-        : fallback;
-}
-function readOptionalString(value) {
-    return typeof value === "string" ? value : undefined;
-}

package/dist/station/charging-profile-registry.d.ts

@@ -1,18 +0,0 @@
-import { type ChargingProfileEntry } from "./smart-charging.js";
-export declare class ChargingProfileRegistry {
-    private readonly profiles;
-    get length(): number;
-    entries(): ChargingProfileEntry[];
-    replace(entries: ChargingProfileEntry[]): void;
-    set(connectorId: number, profilePayload: unknown, options: {
-        hasConnector: (id: number) => boolean;
-        transactionIdForConnector: (id: number) => number | undefined;
-    }): "Accepted" | "Rejected";
-    clear(payload: Record<string, unknown>): "Accepted" | "Unknown";
-    clearForTransaction(transactionId: number): boolean;
-    pruneExpired(at?: Date): boolean;
-    compositeSchedulePayload(payload: Record<string, unknown>, transactionId: number | undefined, transactionStartedAt?: string): {
-        payload: Record<string, unknown>;
-        prunedExpired: boolean;
-    } | undefined;
-}