@totemsdk/act-ocpp 0.0.0-stage → 0.1.0

package/dist/cjs/adapter.js

@@ -0,0 +1,537 @@
+"use strict";
+/**
+ * RFC-024 §5.3 — governed OCPP operations.
+ *
+ * Each definition prepares a deterministic, commitment-bound OCPP command and
+ * derives its physical effects from that prepared command (never from hints).
+ * `startSession`/`stopSession` are asynchronous: acceptance is not completion,
+ * and completion is established by charger meter/transaction readback.
+ *
+ * Configuration writes (`setLimit`, `clearProfile`, `reserveConnector`) use
+ * `confirmation: 'completed'` because the CSMS acknowledgement *is* the terminal
+ * state for a profile/ reservation change; only a session has a later physical
+ * outcome to observe.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOcppDefinitions = createOcppDefinitions;
+exports.errorCodeOf = errorCodeOf;
+const act_core_1 = require("@totemsdk/act-core");
+const effects_js_1 = require("./effects.js");
+const meter_js_1 = require("./meter.js");
+const profile_js_1 = require("./profile.js");
+const transport_js_1 = require("./transport.js");
+function decimal(value) {
+    return Number.isInteger(value) ? String(value) : String(Number(value.toFixed(9)));
+}
+function quantityValue(value, unit, units) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'object' && 'value' in value && 'unit' in value) {
+        return units.convert(value, unit).value;
+    }
+    return undefined;
+}
+function numberParameter(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    throw new transport_js_1.OcppTransportError('Invalid', `expected a number, got '${String(value)}'`);
+}
+function stringParameter(value) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    throw new transport_js_1.OcppTransportError('Invalid', `expected a non-empty string, got '${String(value)}'`);
+}
+function commandOf(op) {
+    return op.command;
+}
+function findConnector(options, connectorId) {
+    const connector = options.connectors.find((candidate) => candidate.connectorId === connectorId);
+    if (!connector) {
+        throw new transport_js_1.OcppTransportError('Invalid', `connector ${connectorId} is not registered`);
+    }
+    return connector;
+}
+function responseData(response) {
+    return { status: response.status ?? 'Accepted', ...(response.payload ?? {}) };
+}
+function acceptedResult(response) {
+    (0, transport_js_1.assertAccepted)(response, 'OCPP operation');
+    return { ok: true, data: responseData(response) };
+}
+function transactionIdOf(record) {
+    const data = record.result;
+    return typeof data?.transactionId === 'number' ? data.transactionId : undefined;
+}
+function createOcppDefinitions(options) {
+    const units = options.units ?? (0, act_core_1.defaultUnitRegistry)();
+    const taxonomy = (0, profile_js_1.ocppErrorTaxonomy)();
+    const transport = options.transport;
+    function profileDigest(command) {
+        if (command.maxPowerWatts === undefined)
+            return undefined;
+        return (0, act_core_1.hashCanonical)('TOTEM_ACT_OCPP_CHARGING_PROFILE_V1', {
+            connectorId: command.connectorId,
+            maxPowerWatts: command.maxPowerWatts,
+            maxEnergyWattHours: command.maxEnergyWattHours ?? null,
+            maxSessionSeconds: command.maxSessionSeconds ?? null,
+        });
+    }
+    function resourceFor(connectorId) {
+        return (0, act_core_1.resourceIdKey)((0, profile_js_1.chargingResourceId)(options.site, connectorId));
+    }
+    const definitions = [
+        {
+            kind: 'charging:startSession',
+            description: 'Start a bounded charging session on a connector through the governed runtime.',
+            version: 1,
+            capability: 'industrial:action',
+            effect: 'write',
+            protocol: profile_js_1.OCPP_PROTOCOL,
+            errorTaxonomy: taxonomy,
+            schema: {
+                parameters: [
+                    { name: 'connectorId', type: 'number', required: true, description: 'Target connector id.' },
+                    { name: 'idTag', type: 'string', required: true, description: 'Contract/authorization tag.' },
+                    {
+                        name: 'maxPowerWatts', type: 'quantity', required: true,
+                        dimension: 'power', unit: 'W', description: 'Instantaneous power ceiling.',
+                    },
+                    {
+                        name: 'maxEnergyWattHours', type: 'quantity', required: false,
+                        dimension: 'energy', unit: 'Wh', description: 'Session energy ceiling.',
+                    },
+                    {
+                        name: 'maxSessionSeconds', type: 'quantity', required: false,
+                        dimension: 'time', unit: 's', description: 'Session duration ceiling.',
+                    },
+                ],
+                context: [],
+            },
+            policy: { failureMode: 'fail-safe', timeoutMs: 30000 },
+            safeState: async (op) => {
+                const command = commandOf(op);
+                if (!transport.stopConnector) {
+                    return { ok: false, error: 'transport cannot stop an active connector session' };
+                }
+                return acceptedResult(await transport.stopConnector(command.connectorId));
+            },
+            async prepare(params) {
+                const connectorId = numberParameter(params.connectorId);
+                findConnector(options, connectorId);
+                const maxPowerWatts = quantityValue(params.maxPowerWatts, 'W', units);
+                if (maxPowerWatts === undefined) {
+                    throw new transport_js_1.OcppTransportError('Invalid', 'maxPowerWatts is required');
+                }
+                const command = {
+                    action: 'RemoteStartTransaction',
+                    connectorId,
+                    idTag: stringParameter(params.idTag),
+                    maxPowerWatts: decimal(maxPowerWatts),
+                };
+                const maxEnergy = quantityValue(params.maxEnergyWattHours, 'Wh', units);
+                if (maxEnergy !== undefined)
+                    command.maxEnergyWattHours = decimal(maxEnergy);
+                const maxSeconds = quantityValue(params.maxSessionSeconds, 's', units);
+                if (maxSeconds !== undefined)
+                    command.maxSessionSeconds = decimal(maxSeconds);
+                return { resourceId: resourceFor(connectorId), command };
+            },
+            deriveEffects(op) {
+                const command = commandOf(op);
+                return (0, effects_js_1.deriveChargingEffects)({
+                    resource: resourceFor(command.connectorId),
+                    maxPowerWatts: String(command.maxPowerWatts),
+                    ...(command.maxEnergyWattHours !== undefined
+                        ? { maxEnergyWattHours: String(command.maxEnergyWattHours) }
+                        : {}),
+                    ...(command.maxSessionSeconds !== undefined
+                        ? { maxSessionSeconds: String(command.maxSessionSeconds) }
+                        : {}),
+                    profileId: `connector:${command.connectorId}`,
+                    profileDigest: profileDigest(command) ?? 'none',
+                });
+            },
+            async actuate(op) {
+                const command = commandOf(op);
+                const response = await transport.remoteStartTransaction({
+                    connectorId: command.connectorId,
+                    idTag: String(command.idTag),
+                    ...(command.maxPowerWatts !== undefined ? { maxPowerWatts: String(command.maxPowerWatts) } : {}),
+                    ...(command.maxEnergyWattHours !== undefined
+                        ? { maxEnergyWattHours: String(command.maxEnergyWattHours) }
+                        : {}),
+                    ...(command.maxSessionSeconds !== undefined
+                        ? { maxSessionSeconds: String(command.maxSessionSeconds) }
+                        : {}),
+                });
+                return acceptedResult(response);
+            },
+            async: {
+                confirmation: 'accepted',
+                async reconcile(op, record) {
+                    const command = commandOf(op);
+                    const transactionId = transactionIdOf(record);
+                    if (transactionId === undefined) {
+                        return { status: 'unknown', error: 'no transaction id available for reconciliation' };
+                    }
+                    const reading = await (0, meter_js_1.reconcileChargingSession)(transport, {
+                        operationId: record.operationId,
+                        connectorId: command.connectorId,
+                        transactionId,
+                    });
+                    if (reading.status === 'confirmed') {
+                        return {
+                            status: 'confirmed',
+                            handle: { transactionId },
+                            progress: { fraction: 1, detail: 'transaction ended', at: Date.now() },
+                            result: reading.evidence,
+                        };
+                    }
+                    if (reading.status === 'running') {
+                        return {
+                            status: 'running',
+                            handle: { transactionId },
+                            progress: { detail: reading.detail ?? 'charging', at: Date.now() },
+                        };
+                    }
+                    return { status: 'unknown', error: reading.detail };
+                },
+                async cancel(op, record) {
+                    const command = commandOf(op);
+                    const transactionId = transactionIdOf(record);
+                    if (transactionId !== undefined) {
+                        await stopSession(command.connectorId, transactionId);
+                        return;
+                    }
+                    if (!transport.stopConnector) {
+                        throw new transport_js_1.OcppTransportError('Invalid', 'cannot cancel without a transaction id');
+                    }
+                    await transport.stopConnector(command.connectorId);
+                },
+            },
+        },
+        {
+            kind: 'charging:stopSession',
+            description: 'Stop a charging session; completion is confirmed by meter readback.',
+            version: 1,
+            capability: 'industrial:action',
+            effect: 'write',
+            protocol: profile_js_1.OCPP_PROTOCOL,
+            errorTaxonomy: taxonomy,
+            schema: {
+                parameters: [
+                    { name: 'connectorId', type: 'number', required: true },
+                    { name: 'transactionId', type: 'number', required: true },
+                ],
+                context: [],
+            },
+            policy: { failureMode: 'fail-safe', timeoutMs: 30000 },
+            safeState: async (op) => {
+                const command = commandOf(op);
+                return stopSession(command.connectorId, numberParameter(command.transactionId));
+            },
+            async prepare(params) {
+                const connectorId = numberParameter(params.connectorId);
+                findConnector(options, connectorId);
+                const command = {
+                    action: 'RemoteStopTransaction',
+                    connectorId,
+                    transactionId: numberParameter(params.transactionId),
+                };
+                return { resourceId: resourceFor(connectorId), command };
+            },
+            deriveEffects(op) {
+                const command = commandOf(op);
+                return { spends: [], physical: { duration: [{ resource: resourceFor(command.connectorId), seconds: '0' }] } };
+            },
+            async actuate(op) {
+                const command = commandOf(op);
+                const response = await transport.remoteStopTransaction({
+                    connectorId: command.connectorId,
+                    transactionId: numberParameter(command.transactionId),
+                });
+                return acceptedResult(response);
+            },
+            async: {
+                confirmation: 'accepted',
+                async reconcile(op, record) {
+                    const command = commandOf(op);
+                    const transactionId = numberParameter(command.transactionId);
+                    const reading = await (0, meter_js_1.reconcileChargingSession)(transport, {
+                        operationId: record.operationId,
+                        connectorId: command.connectorId,
+                        transactionId,
+                    });
+                    if (reading.status === 'confirmed') {
+                        return {
+                            status: 'confirmed',
+                            handle: { transactionId },
+                            progress: { fraction: 1, detail: 'transaction ended', at: Date.now() },
+                            result: reading.evidence,
+                        };
+                    }
+                    return {
+                        status: reading.status === 'running' ? 'running' : 'unknown',
+                        handle: { transactionId },
+                        ...(reading.detail !== undefined ? { error: reading.detail } : {}),
+                    };
+                },
+                async cancel(op) {
+                    const command = commandOf(op);
+                    await stopSession(command.connectorId, numberParameter(command.transactionId));
+                },
+            },
+        },
+        {
+            kind: 'charging:setLimit',
+            description: 'Apply a bounded charging profile to a connector.',
+            version: 1,
+            capability: 'industrial:action',
+            effect: 'write',
+            protocol: profile_js_1.OCPP_PROTOCOL,
+            errorTaxonomy: taxonomy,
+            schema: {
+                parameters: [
+                    { name: 'connectorId', type: 'number', required: true },
+                    { name: 'profileId', type: 'number', required: true },
+                    {
+                        name: 'maxPowerWatts', type: 'quantity', required: true,
+                        dimension: 'power', unit: 'W',
+                    },
+                    {
+                        name: 'maxEnergyWattHours', type: 'quantity', required: false,
+                        dimension: 'energy', unit: 'Wh',
+                    },
+                    {
+                        name: 'maxSessionSeconds', type: 'quantity', required: false,
+                        dimension: 'time', unit: 's',
+                    },
+                ],
+                context: [],
+            },
+            policy: { failureMode: 'fail-safe', timeoutMs: 30000 },
+            safeState: async (op) => {
+                const command = commandOf(op);
+                return clearProfile(command.connectorId, Number(command.profileId));
+            },
+            async prepare(params) {
+                const connectorId = numberParameter(params.connectorId);
+                findConnector(options, connectorId);
+                const maxPowerWatts = quantityValue(params.maxPowerWatts, 'W', units);
+                if (maxPowerWatts === undefined) {
+                    throw new transport_js_1.OcppTransportError('Invalid', 'maxPowerWatts is required');
+                }
+                const command = {
+                    action: 'SetChargingProfile',
+                    connectorId,
+                    profileId: numberParameter(params.profileId),
+                    maxPowerWatts: decimal(maxPowerWatts),
+                };
+                const maxEnergy = quantityValue(params.maxEnergyWattHours, 'Wh', units);
+                if (maxEnergy !== undefined)
+                    command.maxEnergyWattHours = decimal(maxEnergy);
+                const maxSeconds = quantityValue(params.maxSessionSeconds, 's', units);
+                if (maxSeconds !== undefined)
+                    command.maxSessionSeconds = decimal(maxSeconds);
+                return { resourceId: resourceFor(connectorId), command };
+            },
+            deriveEffects(op) {
+                const command = commandOf(op);
+                return (0, effects_js_1.deriveChargingEffects)({
+                    resource: resourceFor(command.connectorId),
+                    maxPowerWatts: String(command.maxPowerWatts),
+                    ...(command.maxEnergyWattHours !== undefined
+                        ? { maxEnergyWattHours: String(command.maxEnergyWattHours) }
+                        : {}),
+                    ...(command.maxSessionSeconds !== undefined
+                        ? { maxSessionSeconds: String(command.maxSessionSeconds) }
+                        : {}),
+                    profileId: String(command.profileId),
+                    profileDigest: profileDigest(command) ?? 'none',
+                });
+            },
+            async actuate(op) {
+                const command = commandOf(op);
+                const response = await transport.setChargingProfile({
+                    connectorId: command.connectorId,
+                    profileId: numberParameter(command.profileId),
+                    maxPowerWatts: String(command.maxPowerWatts),
+                    ...(command.maxEnergyWattHours !== undefined
+                        ? { maxEnergyWattHours: String(command.maxEnergyWattHours) }
+                        : {}),
+                    ...(command.maxSessionSeconds !== undefined
+                        ? { maxSessionSeconds: String(command.maxSessionSeconds) }
+                        : {}),
+                });
+                return acceptedResult(response);
+            },
+            async: { confirmation: 'completed' },
+        },
+        {
+            kind: 'charging:reserveConnector',
+            description: 'Reserve a connector for a bounded window before a session starts.',
+            version: 1,
+            capability: 'industrial:action',
+            effect: 'write',
+            protocol: profile_js_1.OCPP_PROTOCOL,
+            errorTaxonomy: taxonomy,
+            schema: {
+                parameters: [
+                    { name: 'connectorId', type: 'number', required: true },
+                    { name: 'idTag', type: 'string', required: true },
+                    { name: 'reservationId', type: 'number', required: true },
+                    {
+                        name: 'expiresInSeconds', type: 'quantity', required: true,
+                        dimension: 'time', unit: 's',
+                    },
+                ],
+                context: [],
+            },
+            // A reservation that cannot be proven is refused; the window is bounded.
+            policy: { failureMode: 'fail-closed', timeoutMs: 30000 },
+            async prepare(params) {
+                const connectorId = numberParameter(params.connectorId);
+                findConnector(options, connectorId);
+                const expiresInSeconds = quantityValue(params.expiresInSeconds, 's', units);
+                if (expiresInSeconds === undefined) {
+                    throw new transport_js_1.OcppTransportError('Invalid', 'expiresInSeconds is required');
+                }
+                const command = {
+                    action: 'ReserveNow',
+                    connectorId,
+                    idTag: stringParameter(params.idTag),
+                    reservationId: numberParameter(params.reservationId),
+                    expiresInSeconds: decimal(expiresInSeconds),
+                };
+                return { resourceId: resourceFor(connectorId), command };
+            },
+            deriveEffects(op) {
+                const command = commandOf(op);
+                return {
+                    spends: [],
+                    physical: {
+                        duration: [{ resource: resourceFor(command.connectorId), seconds: String(command.expiresInSeconds) }],
+                    },
+                };
+            },
+            async actuate(op) {
+                const command = commandOf(op);
+                const response = await transport.reserveNow({
+                    connectorId: command.connectorId,
+                    idTag: String(command.idTag),
+                    reservationId: numberParameter(command.reservationId),
+                    expiresInSeconds: Number(command.expiresInSeconds),
+                });
+                return acceptedResult(response);
+            },
+            async: { confirmation: 'completed' },
+        },
+        {
+            kind: 'charging:clearProfile',
+            description: 'Clear a charging profile from a connector.',
+            version: 1,
+            capability: 'industrial:action',
+            effect: 'write',
+            protocol: profile_js_1.OCPP_PROTOCOL,
+            errorTaxonomy: taxonomy,
+            schema: {
+                parameters: [
+                    { name: 'connectorId', type: 'number', required: true },
+                    { name: 'profileId', type: 'number', required: false },
+                ],
+                context: [],
+            },
+            policy: { failureMode: 'fail-safe', timeoutMs: 30000 },
+            safeState: async (op) => {
+                const command = commandOf(op);
+                return clearProfile(command.connectorId, Number(command.profileId ?? 0));
+            },
+            async prepare(params) {
+                const connectorId = numberParameter(params.connectorId);
+                findConnector(options, connectorId);
+                const command = { action: 'ClearChargingProfile', connectorId };
+                if (params.profileId !== undefined)
+                    command.profileId = numberParameter(params.profileId);
+                return { resourceId: resourceFor(connectorId), command };
+            },
+            deriveEffects(op) {
+                const command = commandOf(op);
+                return { spends: [], physical: { power: [{ resource: resourceFor(command.connectorId), watts: '0' }] } };
+            },
+            async actuate(op) {
+                const command = commandOf(op);
+                const response = await transport.clearChargingProfile({
+                    connectorId: command.connectorId,
+                    ...(command.profileId !== undefined
+                        ? { profileId: numberParameter(command.profileId) }
+                        : {}),
+                });
+                return acceptedResult(response);
+            },
+            async: { confirmation: 'completed' },
+        },
+        {
+            kind: 'charging:readMeter',
+            description: 'Read the charger meter values for a connector or transaction.',
+            version: 1,
+            capability: 'industrial:read',
+            effect: 'read',
+            protocol: profile_js_1.OCPP_PROTOCOL,
+            errorTaxonomy: taxonomy,
+            schema: {
+                parameters: [
+                    { name: 'connectorId', type: 'number', required: true },
+                    { name: 'transactionId', type: 'number', required: false },
+                ],
+                context: [],
+            },
+            async prepare(params) {
+                const connectorId = numberParameter(params.connectorId);
+                findConnector(options, connectorId);
+                const command = { action: 'MeterValues', connectorId };
+                if (params.transactionId !== undefined) {
+                    command.transactionId = numberParameter(params.transactionId);
+                }
+                return { resourceId: resourceFor(connectorId), command };
+            },
+            deriveEffects() {
+                return { spends: [] };
+            },
+            async actuate(op) {
+                const command = commandOf(op);
+                const readings = await transport.readMeterValues({
+                    connectorId: command.connectorId,
+                    ...(command.transactionId !== undefined
+                        ? { transactionId: numberParameter(command.transactionId) }
+                        : {}),
+                });
+                return { ok: true, data: { readings } };
+            },
+        },
+    ];
+    // Capability-gated definitions are not selectable when the negotiated set
+    // does not include them (RFC-024 §5.8); registration fails closed.
+    for (const definition of definitions) {
+        const capability = options.capabilities;
+        if (capability && !capability.profiles.includes(definition.kind)) {
+            throw new Error(`OCPP ${capability.version} does not provide '${definition.kind}'; refusing to register a capability-gated definition`);
+        }
+    }
+    async function stopSession(connectorId, transactionId) {
+        const response = await transport.remoteStopTransaction({ connectorId, transactionId });
+        return acceptedResult(response);
+    }
+    async function clearProfile(connectorId, profileId) {
+        const response = await transport.clearChargingProfile({
+            connectorId,
+            ...(profileId > 0 ? { profileId } : {}),
+        });
+        return acceptedResult(response);
+    }
+    return definitions;
+}
+function errorCodeOf(error) {
+    return error instanceof transport_js_1.OcppTransportError ? error.code : undefined;
+}

package/dist/cjs/capabilities.d.ts

@@ -0,0 +1,32 @@
+/**
+ * RFC-024 §5.8 — explicit, versioned OCPP capability negotiation.
+ *
+ * A capability change is a new profile version, never a silent upgrade. A
+ * definition that needs a feature which was not negotiated is not selectable.
+ */
+export type OcppVersion = '1.6J' | '2.0.1' | '2.1';
+/** Highest first; negotiation picks the newest mutually supported version. */
+export declare const OCPP_VERSION_PREFERENCE: readonly OcppVersion[];
+export interface OcppCapabilitySet {
+    readonly version: OcppVersion;
+    /** Negotiated profile/feature names. */
+    readonly profiles: readonly string[];
+}
+/** Definition kinds provided by this package. */
+export declare const OCPP_CORE_PROFILES: readonly ["charging:startSession", "charging:stopSession", "charging:setLimit", "charging:reserveConnector", "charging:clearProfile", "charging:readMeter"];
+export type OcppProfileName = (typeof OCPP_CORE_PROFILES)[number];
+export interface NegotiateOptions {
+    /** Versions the deployment can offer (CSMS/charger). */
+    offered: readonly OcppVersion[];
+    /** Versions this adapter supports. Defaults to 1.6J and 2.0.1. */
+    supported?: readonly OcppVersion[];
+    /** Profiles the deployment requires; absent features fail closed. */
+    requiredProfiles?: readonly string[];
+}
+/**
+ * Select the newest mutually supported version and assert the required profiles
+ * are available. Throws `ActionDefinitionError` (registration-time failure)
+ * rather than silently degrading.
+ */
+export declare function negotiateOcppCapabilities(options: NegotiateOptions): OcppCapabilitySet;
+export declare function supportsOcppProfile(capabilities: OcppCapabilitySet, profile: string): boolean;

package/dist/cjs/capabilities.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * RFC-024 §5.8 — explicit, versioned OCPP capability negotiation.
+ *
+ * A capability change is a new profile version, never a silent upgrade. A
+ * definition that needs a feature which was not negotiated is not selectable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OCPP_CORE_PROFILES = exports.OCPP_VERSION_PREFERENCE = void 0;
+exports.negotiateOcppCapabilities = negotiateOcppCapabilities;
+exports.supportsOcppProfile = supportsOcppProfile;
+const act_core_1 = require("@totemsdk/act-core");
+/** Highest first; negotiation picks the newest mutually supported version. */
+exports.OCPP_VERSION_PREFERENCE = ['2.1', '2.0.1', '1.6J'];
+/** Definition kinds provided by this package. */
+exports.OCPP_CORE_PROFILES = [
+    'charging:startSession',
+    'charging:stopSession',
+    'charging:setLimit',
+    'charging:reserveConnector',
+    'charging:clearProfile',
+    'charging:readMeter',
+];
+/** Version-gated features. */
+const VERSION_FEATURES = {
+    // 1.6J and 2.0.1 expose the same governed operations under different action
+    // names; the adapter binds them through the transport port.
+    '1.6J': [...exports.OCPP_CORE_PROFILES],
+    '2.0.1': [...exports.OCPP_CORE_PROFILES],
+    '2.1': [...exports.OCPP_CORE_PROFILES, 'charging:bidirectional'],
+};
+/**
+ * Select the newest mutually supported version and assert the required profiles
+ * are available. Throws `ActionDefinitionError` (registration-time failure)
+ * rather than silently degrading.
+ */
+function negotiateOcppCapabilities(options) {
+    const supported = options.supported ?? ['2.0.1', '1.6J'];
+    const version = exports.OCPP_VERSION_PREFERENCE.find((candidate) => options.offered.includes(candidate) && supported.includes(candidate));
+    if (!version) {
+        throw new act_core_1.ActionDefinitionError(`no mutually supported OCPP version (offered: ${options.offered.join(', ') || 'none'}; supported: ${supported.join(', ')})`);
+    }
+    const profiles = VERSION_FEATURES[version];
+    for (const required of options.requiredProfiles ?? []) {
+        if (!profiles.includes(required)) {
+            throw new act_core_1.ActionDefinitionError(`OCPP ${version} does not provide required profile '${required}'`);
+        }
+    }
+    return { version, profiles };
+}
+function supportsOcppProfile(capabilities, profile) {
+    return capabilities.profiles.includes(profile);
+}

package/dist/cjs/effects.d.ts

@@ -0,0 +1,22 @@
+/**
+ * RFC-024 §5.5 — physical effects derived from the PREPARED charging command.
+ *
+ * These are the facts the authority layer commits to and RFC-023 enforces. They
+ * are computed from the prepared command only, never from caller-supplied
+ * hints, so a tampered or replayed command cannot widen the envelope.
+ */
+import type { StepEffects } from '@totemsdk/agent-policy';
+export interface ChargingLimits {
+    /** Target connector (ResourceId key). */
+    resource: string;
+    /** Instantaneous power ceiling implied by the command, in W. */
+    maxPowerWatts: string;
+    /** Total energy ceiling for the session/limit, in Wh. */
+    maxEnergyWattHours?: string;
+    /** Maximum wall-clock duration, in seconds. */
+    maxSessionSeconds?: string;
+    /** Charging profile id and schedule digest, when a profile is applied. */
+    profileId?: string;
+    profileDigest?: string;
+}
+export declare function deriveChargingEffects(limits: ChargingLimits): StepEffects;

package/dist/cjs/effects.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * RFC-024 §5.5 — physical effects derived from the PREPARED charging command.
+ *
+ * These are the facts the authority layer commits to and RFC-023 enforces. They
+ * are computed from the prepared command only, never from caller-supplied
+ * hints, so a tampered or replayed command cannot widen the envelope.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveChargingEffects = deriveChargingEffects;
+function deriveChargingEffects(limits) {
+    const physical = {
+        power: [{ resource: limits.resource, watts: limits.maxPowerWatts }],
+    };
+    if (limits.maxEnergyWattHours !== undefined) {
+        physical.energy = [{ resource: limits.resource, wattHours: limits.maxEnergyWattHours }];
+    }
+    if (limits.maxSessionSeconds !== undefined) {
+        physical.duration = [{ resource: limits.resource, seconds: limits.maxSessionSeconds }];
+    }
+    if (limits.profileId !== undefined && limits.profileDigest !== undefined) {
+        physical.envelopes = [
+            { envelopeId: limits.profileId, envelopeDigest: limits.profileDigest },
+        ];
+    }
+    return { spends: [], physical };
+}