node-red-contrib-s2 0.1.1

package/dist/lib/s2/messages.js

@@ -0,0 +1,330 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RevokableObjects = exports.InstructionStatus = exports.ReceptionStatusResult = exports.GRID_CONNECTIONS = exports.ControlType = exports.MessageType = void 0;
+exports.gridConnectionToWatts = gridConnectionToWatts;
+exports.parse = parse;
+exports.serialize = serialize;
+exports.makeReceptionStatus = makeReceptionStatus;
+exports.makeHandshake = makeHandshake;
+exports.makeResourceManagerDetails = makeResourceManagerDetails;
+exports.makeOMBCSystemDescription = makeOMBCSystemDescription;
+exports.makeOMBCStatus = makeOMBCStatus;
+exports.makePowerMeasurement = makePowerMeasurement;
+exports.makePEBCPowerConstraints = makePEBCPowerConstraints;
+exports.makePowerForecast = makePowerForecast;
+exports.makeInstructionStatusUpdate = makeInstructionStatusUpdate;
+exports.generateId = generateId;
+const crypto_1 = require("crypto");
+/**
+ * S2 protocol message type constants (EN 50491-12-2).
+ * These are the message_type values used in S2 JSON messages.
+ */
+exports.MessageType = Object.freeze({
+    // Handshake
+    HANDSHAKE: 'Handshake',
+    HANDSHAKE_RESPONSE: 'HandshakeResponse',
+    // Session
+    SESSION_REQUEST: 'SessionRequest',
+    // Resource Manager -> CEM
+    RESOURCE_MANAGER_DETAILS: 'ResourceManagerDetails',
+    POWER_MEASUREMENT: 'PowerMeasurement',
+    RECEPTION_STATUS: 'ReceptionStatus',
+    REVOKE_OBJECT: 'RevokeObject',
+    SELECT_CONTROL_TYPE: 'SelectControlType',
+    // CEM -> Resource Manager
+    INSTRUCTION: 'Instruction',
+    // Fill-rate Based Control (FRBC)
+    FRBC_ACTUATOR_STATUS: 'FRBC.ActuatorStatus',
+    FRBC_FILL_LEVEL_TARGET_PROFILE: 'FRBC.FillLevelTargetProfile',
+    FRBC_LEAKAGE_BEHAVIOUR: 'FRBC.LeakagebBehaviour',
+    FRBC_STORAGE_STATUS: 'FRBC.StorageStatus',
+    FRBC_SYSTEM_DESCRIPTION: 'FRBC.SystemDescription',
+    FRBC_TIMER_STATUS: 'FRBC.TimerStatus',
+    FRBC_USAGE_FORECAST: 'FRBC.UsageForecast',
+    FRBC_INSTRUCTION: 'FRBC.Instruction',
+    // Demand Driven Based Control (DDBC)
+    DDBC_ACTUAL_POWER: 'DDBC.ActualPower',
+    DDBC_AVERAGE_DEMAND_RATE_FORECAST: 'DDBC.AverageDemandRateForecast',
+    DDBC_SYSTEM_DESCRIPTION: 'DDBC.SystemDescription',
+    DDBC_TIMER_STATUS: 'DDBC.TimerStatus',
+    DDBC_INSTRUCTION: 'DDBC.Instruction',
+    // Power Profile Based Control (PPBC)
+    PPBC_POWER_PROFILE_STATUS: 'PPBC.PowerProfileStatus',
+    PPBC_SCHEDULE_INSTRUCTION: 'PPBC.ScheduleInstruction',
+    PPBC_START_INTERRUPTION_INSTRUCTION: 'PPBC.StartInterruptionInstruction',
+    PPBC_END_INTERRUPTION_INSTRUCTION: 'PPBC.EndInterruptionInstruction',
+    PPBC_POWER_PROFILE: 'PPBC.PowerProfileDefinition',
+    // Operation Mode Based Control (OMBC)
+    OMBC_SYSTEM_DESCRIPTION: 'OMBC.SystemDescription',
+    OMBC_STATUS: 'OMBC.Status',
+    OMBC_INSTRUCTION: 'OMBC.Instruction',
+    // Power Envelope Based Control (PEBC)
+    PEBC_POWER_CONSTRAINTS: 'PEBC.PowerConstraints',
+    PEBC_DEVICE_CONSTRAINTS: 'PEBC.DeviceConstraints',
+    PEBC_ENERGY_CONSTRAINT: 'PEBC.EnergyConstraint',
+    PEBC_INSTRUCTION: 'PEBC.Instruction',
+    // Common
+    POWER_FORECAST: 'PowerForecast',
+    INSTRUCTION_STATUS_UPDATE: 'InstructionStatusUpdate'
+});
+/**
+ * S2 control type identifiers (full names as used in s2python / s2-ws-json).
+ */
+exports.ControlType = Object.freeze({
+    NOT_CONTROLABLE: 'NOT_CONTROLABLE',
+    OMBC: 'OPERATION_MODE_BASED_CONTROL',
+    FRBC: 'FILL_RATE_BASED_CONTROL',
+    DDBC: 'DEMAND_DRIVEN_BASED_CONTROL',
+    PPBC: 'POWER_PROFILE_BASED_CONTROL',
+    PEBC: 'POWER_ENVELOPE_BASED_CONTROL',
+    NO_SELECTION: 'NO_SELECTION'
+});
+/**
+ * ReceptionStatus result values (matches s2python ReceptionStatusValues).
+ */
+/**
+ * Standard European grid connection types with their max power capacity at 230V nominal.
+ * Used to set PEBC power constraint outer limits (bidirectional: [-maxWatts, +maxWatts]).
+ */
+exports.GRID_CONNECTIONS = Object.freeze({
+    '1x16A': { phases: 1, ampsPerPhase: 16, maxWatts: 3680 },
+    '3x16A': { phases: 3, ampsPerPhase: 16, maxWatts: 11040 },
+    '3x25A': { phases: 3, ampsPerPhase: 25, maxWatts: 17250 },
+    '3x32A': { phases: 3, ampsPerPhase: 32, maxWatts: 22080 },
+    '3x40A': { phases: 3, ampsPerPhase: 40, maxWatts: 27600 },
+    '3x63A': { phases: 3, ampsPerPhase: 63, maxWatts: 43470 }
+});
+/**
+ * Returns the max power in watts for a given grid connection.
+ * For 'custom', returns customMaxPowerW if provided.
+ * Returns null if the connection is unknown or unset.
+ */
+function gridConnectionToWatts(gridConnection, customMaxPowerW) {
+    if (!gridConnection)
+        return null;
+    if (gridConnection === 'custom')
+        return customMaxPowerW !== null && customMaxPowerW !== void 0 ? customMaxPowerW : null;
+    const conn = exports.GRID_CONNECTIONS[gridConnection];
+    return conn ? conn.maxWatts : null;
+}
+exports.ReceptionStatusResult = Object.freeze({
+    OK: 'OK',
+    INVALID_DATA: 'INVALID_DATA',
+    INVALID_MESSAGE: 'INVALID_MESSAGE',
+    INVALID_CONTENT: 'INVALID_CONTENT',
+    TEMPORARY_ERROR: 'TEMPORARY_ERROR',
+    PERMANENT_ERROR: 'PERMANENT_ERROR'
+});
+exports.InstructionStatus = Object.freeze({
+    NEW: 'NEW',
+    ACCEPTED: 'ACCEPTED',
+    REJECTED: 'REJECTED',
+    REVOKED: 'REVOKED',
+    STARTED: 'STARTED',
+    SUCCEEDED: 'SUCCEEDED',
+    ABORTED: 'ABORTED'
+});
+exports.RevokableObjects = Object.freeze({
+    DDBC_AVERAGE_DEMAND_RATE_FORECAST: 'DDBC.AverageDemandRateForecast',
+    DDBC_INSTRUCTION: 'DDBC.Instruction',
+    DDBC_SYSTEM_DESCRIPTION: 'DDBC.SystemDescription',
+    FRBC_FILL_LEVEL_TARGET_PROFILE: 'FRBC.FillLevelTargetProfile',
+    FRBC_INSTRUCTION: 'FRBC.Instruction',
+    FRBC_LEAKAGE_BEHAVIOUR: 'FRBC.LeakageBehaviour',
+    FRBC_SYSTEM_DESCRIPTION: 'FRBC.SystemDescription',
+    FRBC_USAGE_FORECAST: 'FRBC.UsageForecast',
+    OMBC_INSTRUCTION: 'OMBC.Instruction',
+    OMBC_SYSTEM_DESCRIPTION: 'OMBC.SystemDescription',
+    PEBC_ENERGY_CONSTRAINT: 'PEBC.EnergyConstraint',
+    PEBC_INSTRUCTION: 'PEBC.Instruction',
+    PEBC_POWER_CONSTRAINTS: 'PEBC.PowerConstraints',
+    PPBC_END_INTERRUPTION_INSTRUCTION: 'PPBC.EndInterruptionInstruction',
+    PPBC_POWER_PROFILE_DEFINITION: 'PPBC.PowerProfileDefinition',
+    PPBC_SCHEDULE_INSTRUCTION: 'PPBC.ScheduleInstruction',
+    PPBC_START_INTERRUPTION_INSTRUCTION: 'PPBC.StartInterruptionInstruction'
+});
+/**
+ * Parse a raw WebSocket message string into an S2 message object.
+ * Returns null and calls onError if parsing fails.
+ *
+ * @param raw - raw JSON string
+ * @param onError - called with an Error if parsing fails
+ */
+function parse(raw, onError) {
+    try {
+        const msg = JSON.parse(raw);
+        if (!msg.message_type) {
+            onError(new Error('S2 message missing message_type'));
+            return null;
+        }
+        return msg;
+    }
+    catch (err) {
+        onError(new Error(`Failed to parse S2 message: ${err.message}`));
+        return null;
+    }
+}
+/**
+ * Serialize an S2 message object to a string for sending over the wire.
+ */
+function serialize(msg) {
+    return JSON.stringify(msg);
+}
+/**
+ * Create a ReceptionStatus message acknowledging a received message.
+ *
+ * @param subjectMessageId - message_id of the message being acknowledged
+ * @param status - one of ReceptionStatusResult values
+ * @param diagnosticLabel - optional human-readable diagnostic
+ */
+function makeReceptionStatus(subjectMessageId, status, diagnosticLabel) {
+    const msg = {
+        message_type: exports.MessageType.RECEPTION_STATUS,
+        subject_message_id: subjectMessageId,
+        status
+    };
+    if (diagnosticLabel) {
+        msg.diagnostic_label = diagnosticLabel;
+    }
+    return msg;
+}
+/**
+ * Create a Handshake message (sent by RM on connect).
+ *
+ * @param rmId - unique ID identifying this Resource Manager
+ */
+function makeHandshake(rmId) {
+    void rmId; // included in API for symmetry; not sent in Handshake per spec
+    return {
+        message_type: exports.MessageType.HANDSHAKE,
+        message_id: generateId(),
+        role: 'RM',
+        supported_protocol_versions: ['0.0.2-beta']
+    };
+}
+/**
+ * Create a ResourceManagerDetails message (sent by RM after HandshakeResponse).
+ */
+function makeResourceManagerDetails(details) {
+    return {
+        message_type: exports.MessageType.RESOURCE_MANAGER_DETAILS,
+        message_id: generateId(),
+        resource_id: details.resourceId,
+        name: details.name,
+        roles: details.roles,
+        manufacturer: details.manufacturer || '',
+        model: details.model || '',
+        serial_number: details.serialNumber || '',
+        firmware_version: details.firmwareVersion || '',
+        available_control_types: details.availableControlTypes,
+        provides_forecast: details.providesForecast || false,
+        provides_power_measurement_types: details.providesPowerMeasurementTypes || [],
+        instruction_processing_delay: details.instructionProcessingDelay || 0
+    };
+}
+/**
+ * Create an OMBC.SystemDescription message.
+ */
+function makeOMBCSystemDescription(config) {
+    return {
+        message_type: exports.MessageType.OMBC_SYSTEM_DESCRIPTION,
+        message_id: generateId(),
+        valid_from: new Date().toISOString(),
+        operation_modes: config.operationModes || [],
+        transitions: config.transitions || [],
+        timers: config.timers || []
+    };
+}
+/**
+ * Create an OMBC.Status message.
+ */
+function makeOMBCStatus(status) {
+    const msg = {
+        message_type: exports.MessageType.OMBC_STATUS,
+        message_id: generateId(),
+        active_operation_mode_id: status.activeOperationModeId,
+        operation_mode_factor: status.operationModeFactor !== undefined ? status.operationModeFactor : 1
+    };
+    if (status.previousOperationModeId) {
+        msg.previous_operation_mode_id = status.previousOperationModeId;
+    }
+    if (status.transitionTimestamp) {
+        msg.transition_timestamp = status.transitionTimestamp;
+    }
+    return msg;
+}
+/**
+ * Create a PowerMeasurement message (sent by RM to report current power).
+ *
+ * @param values - array of { commodity_quantity, value } objects
+ */
+function makePowerMeasurement(values) {
+    return {
+        message_type: exports.MessageType.POWER_MEASUREMENT,
+        message_id: generateId(),
+        measurement_timestamp: new Date().toISOString(),
+        values
+    };
+}
+/**
+ * Build a PEBC.PowerConstraints message with matching LOWER_LIMIT and
+ * UPPER_LIMIT ranges and consequence_type DEFER.
+ *
+ * Wire format (s2-ws-json 0.0.2-beta):
+ *   id + allowed_limit_ranges are top-level fields on the message itself,
+ *   not nested under a power_constraints array.
+ */
+function makePEBCPowerConstraints(input) {
+    var _a;
+    const validFrom = (_a = input.validFrom) !== null && _a !== void 0 ? _a : new Date().toISOString();
+    const rangeBoundary = { start_of_range: input.minPower, end_of_range: input.maxPower };
+    return {
+        message_type: exports.MessageType.PEBC_POWER_CONSTRAINTS,
+        message_id: generateId(),
+        id: generateId(),
+        valid_from: validFrom,
+        valid_until: null,
+        consequence_type: 'DEFER',
+        allowed_limit_ranges: [
+            { commodity_quantity: input.commodityQuantity, limit_type: 'LOWER_LIMIT', range_boundary: rangeBoundary, abnormal_condition_only: false },
+            { commodity_quantity: input.commodityQuantity, limit_type: 'UPPER_LIMIT', range_boundary: rangeBoundary, abnormal_condition_only: false }
+        ]
+    };
+}
+/**
+ * Build a PowerForecast message from pre-formed elements.
+ *
+ * @param input.startTime - ISO 8601 timezone-aware datetime for the first element
+ * @param input.elements - array of { duration (ms), power_values: [{ commodity_quantity, value_expected }] }
+ */
+function makePowerForecast(input) {
+    return {
+        message_type: exports.MessageType.POWER_FORECAST,
+        message_id: generateId(),
+        start_time: input.startTime,
+        elements: input.elements
+    };
+}
+/**
+ * Create an InstructionStatusUpdate message reporting the current lifecycle state of an instruction.
+ *
+ * @param instructionId - the `id` field of the instruction (not its message_id)
+ * @param status - one of InstructionStatus values
+ */
+function makeInstructionStatusUpdate(instructionId, status) {
+    return {
+        message_type: exports.MessageType.INSTRUCTION_STATUS_UPDATE,
+        message_id: generateId(),
+        instruction_id: instructionId,
+        status_type: status,
+        timestamp: new Date().toISOString()
+    };
+}
+/**
+ * Generate a UUID v4 message ID.
+ * Node >=14.17.4 is required, which includes crypto.randomUUID.
+ */
+function generateId() {
+    return (0, crypto_1.randomUUID)();
+}
+//# sourceMappingURL=messages.js.map

package/dist/lib/s2/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/lib/s2/messages.ts"],"names":[],"mappings":"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"}

package/dist/lib/s2/schedule.d.ts

@@ -0,0 +1,35 @@
+import type { PowerForecastInput } from './messages';
+export interface ScheduleElement {
+    startMs: number;
+    endMs: number;
+    duration: number;
+    lowerBound: number | null;
+    upperBound: number | null;
+}
+export interface PebcSchedule {
+    receivedAt: number;
+    cemId: string;
+    instructionId: string;
+    commodityQuantity: string;
+    elements: ScheduleElement[];
+}
+/**
+ * Parse a PEBC.Instruction message into a PebcSchedule with absolute timestamps.
+ * Returns null if the message contains no usable power_envelopes.
+ */
+export declare function parsePebcInstruction(msg: Record<string, unknown>, receivedAt: number, cemId?: string): PebcSchedule | null;
+/**
+ * Return the element active at nowMs, or null if outside the schedule window.
+ */
+export declare function getActiveElement(schedule: PebcSchedule, nowMs: number): ScheduleElement | null;
+/**
+ * Return the start time (ms) of the element that follows the currently active one,
+ * or null if in the last element or outside the schedule window.
+ */
+export declare function getNextElementStart(schedule: PebcSchedule, nowMs: number): number | null;
+/**
+ * Return a copy of forecast with value_expected (and value_upper/lower_limit when present)
+ * clamped to the tightest PEBC bounds overlapping each forecast element's time window.
+ * Elements with no overlapping PEBC bound are passed through unchanged.
+ */
+export declare function capForecastToSchedule(forecast: PowerForecastInput, schedule: PebcSchedule): PowerForecastInput;

package/dist/lib/s2/schedule.js

@@ -0,0 +1,109 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePebcInstruction = parsePebcInstruction;
+exports.getActiveElement = getActiveElement;
+exports.getNextElementStart = getNextElementStart;
+exports.capForecastToSchedule = capForecastToSchedule;
+/**
+ * Parse a PEBC.Instruction message into a PebcSchedule with absolute timestamps.
+ * Returns null if the message contains no usable power_envelopes.
+ */
+function parsePebcInstruction(msg, receivedAt, cemId = '') {
+    var _a;
+    const envelopes = msg.power_envelopes;
+    if (!Array.isArray(envelopes) || envelopes.length === 0)
+        return null;
+    const envelope = envelopes[0];
+    const rawElements = (_a = envelope.power_envelope_elements) !== null && _a !== void 0 ? _a : [];
+    const executionTimeMs = msg.execution_time
+        ? new Date(msg.execution_time).getTime()
+        : receivedAt;
+    let cursor = executionTimeMs;
+    const elements = rawElements.map((el) => {
+        var _a, _b;
+        const startMs = cursor;
+        const endMs = cursor + el.duration;
+        cursor = endMs;
+        return {
+            startMs,
+            endMs,
+            duration: el.duration,
+            lowerBound: (_a = el.lower_limit) !== null && _a !== void 0 ? _a : null,
+            upperBound: (_b = el.upper_limit) !== null && _b !== void 0 ? _b : null
+        };
+    });
+    return {
+        receivedAt,
+        cemId,
+        instructionId: msg.id,
+        commodityQuantity: envelope.commodity_quantity,
+        elements
+    };
+}
+/**
+ * Return the element active at nowMs, or null if outside the schedule window.
+ */
+function getActiveElement(schedule, nowMs) {
+    for (const el of schedule.elements) {
+        if (nowMs >= el.startMs && nowMs < el.endMs)
+            return el;
+    }
+    return null;
+}
+/**
+ * Return the start time (ms) of the element that follows the currently active one,
+ * or null if in the last element or outside the schedule window.
+ */
+function getNextElementStart(schedule, nowMs) {
+    for (let i = 0; i < schedule.elements.length - 1; i++) {
+        const el = schedule.elements[i];
+        if (nowMs >= el.startMs && nowMs < el.endMs)
+            return schedule.elements[i + 1].startMs;
+    }
+    return null;
+}
+/**
+ * Return a copy of forecast with value_expected (and value_upper/lower_limit when present)
+ * clamped to the tightest PEBC bounds overlapping each forecast element's time window.
+ * Elements with no overlapping PEBC bound are passed through unchanged.
+ */
+function capForecastToSchedule(forecast, schedule) {
+    let cursor = new Date(forecast.startTime).getTime();
+    const elements = forecast.elements.map(el => {
+        const elStart = cursor;
+        const elEnd = cursor + el.duration;
+        cursor = elEnd;
+        let effectiveUpper = null;
+        let effectiveLower = null;
+        for (const schedEl of schedule.elements) {
+            if (elEnd <= schedEl.startMs || elStart >= schedEl.endMs)
+                continue;
+            if (schedEl.upperBound !== null) {
+                effectiveUpper = effectiveUpper === null ? schedEl.upperBound : Math.min(effectiveUpper, schedEl.upperBound);
+            }
+            if (schedEl.lowerBound !== null) {
+                effectiveLower = effectiveLower === null ? schedEl.lowerBound : Math.max(effectiveLower, schedEl.lowerBound);
+            }
+        }
+        if (effectiveUpper === null && effectiveLower === null)
+            return el;
+        const power_values = el.power_values.map(pv => {
+            let expected = pv.value_expected;
+            if (effectiveUpper !== null)
+                expected = Math.min(expected, effectiveUpper);
+            if (effectiveLower !== null)
+                expected = Math.max(expected, effectiveLower);
+            const capped = { ...pv, value_expected: expected };
+            if (pv.value_upper_limit !== undefined && effectiveUpper !== null) {
+                capped.value_upper_limit = Math.min(pv.value_upper_limit, effectiveUpper);
+            }
+            if (pv.value_lower_limit !== undefined && effectiveLower !== null) {
+                capped.value_lower_limit = Math.max(pv.value_lower_limit, effectiveLower);
+            }
+            return capped;
+        });
+        return { ...el, power_values };
+    });
+    return { ...forecast, elements };
+}
+//# sourceMappingURL=schedule.js.map

package/dist/lib/s2/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../src/lib/s2/schedule.ts"],"names":[],"mappings":"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"}

package/dist/lib/s2/session.d.ts

@@ -0,0 +1,138 @@
+import { ControlTypeValue, InstructionStatusValue, S2IncomingMessage, RmDetails, OMBCSystemDescriptionConfig, OMBCStatusConfig, PEBCPowerConstraintsInput } from './messages';
+/**
+ * S2 session states.
+ */
+export declare const State: Readonly<{
+    readonly HANDSHAKING: "HANDSHAKING";
+    readonly CONNECTED: "CONNECTED";
+}>;
+export type StateValue = (typeof State)[keyof typeof State];
+export interface OMBCConfig {
+    systemDescription?: OMBCSystemDescriptionConfig;
+    status?: OMBCStatusConfig;
+}
+export interface ControlTypeConfig {
+    OMBC?: OMBCConfig;
+    [key: string]: unknown;
+}
+export interface S2SessionOptions {
+    cemId: string;
+    rmDetails?: RmDetails;
+    controlTypeConfig?: ControlTypeConfig;
+    onSend?: (msg: object) => void;
+    onStateChange?: (state: StateValue) => void;
+    onMessage?: (msg: S2IncomingMessage) => void;
+    onInstruction?: (msg: S2IncomingMessage) => void;
+    onError?: (err: Error) => void;
+    retryDelayMs?: number;
+    /** When true, skip auto-sending InstructionStatusUpdate(ACCEPTED) on instruction receipt.
+     * ReceptionStatus and OMBC.Status are still sent. Use to reduce D-Bus traffic when
+     * the CEM does not require acknowledgment messages. */
+    skipInstructionStatus?: boolean;
+}
+/**
+ * S2Session manages the S2 protocol state for a single CEM connection.
+ *
+ * The RM (us) initiates the Handshake immediately after the CEM connects.
+ * This applies to both transports:
+ * - D-Bus (acload): CEM calls Connect on D-Bus, RM sends Handshake via Message signal
+ * - WebSocket (future): CEM opens WS connection, RM sends Handshake over the socket
+ *
+ * Usage:
+ *   const session = new S2Session({
+ *     cemId,
+ *     rmDetails,
+ *     controlTypeConfig: {  // optional control type configuration
+ *       OMBC: {
+ *         systemDescription: { operationModes: [...], transitions: [], timers: [] },
+ *         status: { activeOperationModeId: 'mode-1', operationModeFactor: 1 }
+ *       }
+ *     },
+ *     onSend:        (msg) => <send S2 message object to CEM>,
+ *     onStateChange: (state) => ...,
+ *     onMessage:     (msg) => <forward received message downstream>,
+ *     onError:       (err) => ...
+ *   })
+ *
+ *   session.start()              // sends Handshake, call after Connect
+ *   session.handleMessage(msg)   // call for each Message from the CEM
+ *   session.send(msg)            // send an outbound S2 message (only when CONNECTED)
+ */
+export declare class S2Session {
+    private readonly _cemId;
+    private readonly _rmDetails;
+    private readonly _controlTypeConfig;
+    private readonly _onSend;
+    private readonly _onStateChange;
+    private readonly _onMessage;
+    private readonly _onInstruction;
+    private readonly _onError;
+    private readonly _retryDelayMs;
+    private readonly _skipInstructionStatus;
+    private readonly _sentMessages;
+    private readonly _retryTimers;
+    private _state;
+    private _selectedControlType;
+    private _lastKeepAlive;
+    private _pebcPowerConstraints;
+    private _currentOMBCStatus;
+    constructor({ cemId, rmDetails, controlTypeConfig, onSend, onStateChange, onMessage, onInstruction, onError, retryDelayMs, skipInstructionStatus }: S2SessionOptions);
+    get cemId(): string;
+    get state(): StateValue;
+    get selectedControlType(): ControlTypeValue | string;
+    get lastKeepAlive(): Date | null;
+    get currentOMBCStatus(): OMBCStatusConfig | null;
+    /**
+     * Cancel pending retry timers and clear the sent-message buffer.
+     * Call when the session is no longer needed (disconnect, node close).
+     */
+    dispose(): void;
+    /**
+     * Record that a keepalive was received from the CEM.
+     */
+    keepAlive(): void;
+    /**
+     * Send the initial Handshake to the CEM. Call once after the CEM connects.
+     */
+    start(): void;
+    /**
+     * Process an S2 message received from the CEM.
+     * Accepts a raw JSON string or an already-parsed object.
+     */
+    handleMessage(raw: string | S2IncomingMessage): void;
+    /**
+     * Send an S2 message object to the CEM. Only valid when CONNECTED.
+     */
+    send(msg: object): void;
+    /**
+     * Store PEBC power constraints and send them to the CEM immediately if
+     * PEBC is the active control type. Stored constraints are also sent
+     * automatically when SelectControlType(PEBC) is received.
+     */
+    setPEBCPowerConstraints(input: PEBCPowerConstraintsInput): void;
+    /**
+     * Update the tracked OMBC status and send OMBC.Status to the CEM.
+     * Call after an OMBC.Instruction is dispatched to inform the CEM of the new
+     * active operation mode. Also updates the status used when SELECT_CONTROL_TYPE
+     * is received again (e.g. after a CEM reconnect).
+     */
+    updateOMBCStatus(status: OMBCStatusConfig): void;
+    /**
+     * Send an InstructionStatusUpdate for an instruction previously received from the CEM.
+     * Use this to report STARTED, SUCCEEDED, ABORTED, etc. after ACCEPTED was auto-sent.
+     *
+     * @param instructionId - the `id` field of the instruction (not its message_id)
+     * @param status - one of InstructionStatus values
+     */
+    sendInstructionStatus(instructionId: string, status: InstructionStatusValue): void;
+    /**
+     * Buffer the message by its message_id (if present) and forward to onSend.
+     * Buffered messages can be retried when the CEM responds with TEMPORARY_ERROR.
+     */
+    private _send;
+    private _setState;
+    private _handleHandshakeResponse;
+    private _handleSelectControlType;
+    private _sendOMBCSystemDescriptionAndStatus;
+    private _ackAndForward;
+}