@enyo-energy/energy-app-sdk 0.0.145 → 0.0.146

package/dist/cjs/packages/eebus/eebus-cevc-client.d.cts

@@ -62,23 +62,24 @@ export interface EebusCevcClient extends EebusUseCaseClient {
     publishIncentiveTable: (table: EebusOhpcfIncentiveTable) => Promise<void>;
     /**
      * Return the most recent time-series charging plan the SDK has
-     * observed on this peer, without dispatching a wire read.
-     * Synchronous and side-effect-free.
+     * observed on this peer, without dispatching a wire read. Resolves
+     * from the lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first plan notify has landed, and
-     * will keep returning `undefined` on peers that do not implement
-     * `TimeSeries` until that client lands in `@enyo-energy/eebus`.
+     * Resolves to `undefined` until the first plan notify has landed,
+     * and will keep resolving to `undefined` on peers that do not
+     * implement `TimeSeries` until that client lands in
+     * `@enyo-energy/eebus`.
      */
-    getLastTimeSeriesPlan: () => EebusCevcChargingPlan | undefined;
+    getLastTimeSeriesPlan: () => Promise<EebusCevcChargingPlan | undefined>;
     /**
      * Return the most recent incentive table the SDK has observed on
-     * this peer, without dispatching a wire read. Synchronous and
-     * side-effect-free.
+     * this peer, without dispatching a wire read. Resolves from the
+     * lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first `incentiveTableData` notify
-     * has landed.
+     * Resolves to `undefined` until the first `incentiveTableData`
+     * notify has landed.
      */
-    getLastIncentiveTable: () => EebusOhpcfIncentiveTable | undefined;
+    getLastIncentiveTable: () => Promise<EebusOhpcfIncentiveTable | undefined>;
     /**
      * Subscribe to plan-state updates published by the EV (e.g. revised
      * plan after the EV revised its capacity estimate).

package/dist/cjs/packages/eebus/eebus-evcc-client.d.cts

@@ -51,12 +51,13 @@ export interface EebusEvccClient extends EebusUseCaseClient {
     /**
      * Return the most recent EV identification (EVCCID + identification
      * type) the SDK has observed on this peer, without dispatching a
-     * wire read. Synchronous and side-effect-free.
+     * wire read. Resolves from the lib's cached snapshot —
+     * side-effect-free.
      *
-     * Returns `undefined` until the first `identificationListData`
+     * Resolves to `undefined` until the first `identificationListData`
      * notify has landed.
      */
-    getLastEvIdentification: () => EebusEvIdentification | undefined;
+    getLastEvIdentification: () => Promise<EebusEvIdentification | undefined>;
     /**
      * Return the most recent `DeviceConfiguration.keyValueListData`
      * snapshot the SDK has observed on this peer. Surfaces every
@@ -66,40 +67,41 @@ export interface EebusEvccClient extends EebusUseCaseClient {
      * {@link supportsAsymmetricCharging} which already narrow the
      * lookup.
      *
-     * Returns `undefined` until the first notify has landed.
+     * Resolves to `undefined` until the first notify has landed.
      */
-    getLastEvConfiguration: () => EebusEvConfigurationSnapshot | undefined;
+    getLastEvConfiguration: () => Promise<EebusEvConfigurationSnapshot | undefined>;
     /**
      * Return the most recent EV electrical permitted-value snapshot the
      * SDK has observed on this peer — per-phase minimum / maximum
      * current and total power the EV reports as allowable.
      *
-     * Returns `undefined` until the first
+     * Resolves to `undefined` until the first
      * `permittedValueSetListData` notify has landed.
      */
-    getLastEvElectricalLimits: () => EebusEvElectricalLimits | undefined;
+    getLastEvElectricalLimits: () => Promise<EebusEvElectricalLimits | undefined>;
     /**
      * Read the EV's negotiated communication standard from the cached
      * configuration snapshot — `'IEC61851'`, `'ISO15118-2'`,
-     * `'ISO15118-20'`, etc. Synchronous; does not hit the wire.
+     * `'ISO15118-20'`, etc. Resolves from the lib's cached snapshot;
+     * does not hit the wire.
      *
-     * Distinct from {@link getEvCommunicationStandard} (async, returns
-     * the typed enum) — this getter returns the raw wire string for
+     * Distinct from {@link getEvCommunicationStandard} which returns
+     * the typed enum — this getter returns the raw wire string for
      * vendor-specific values the enum doesn't cover, and `undefined`
      * when the key is not yet cached.
      */
-    getCommunicationStandard: () => string | undefined;
+    getCommunicationStandard: () => Promise<string | undefined>;
     /**
      * Read whether the EV advertises asymmetric (per-phase) charging
-     * support from the cached configuration snapshot. Synchronous;
-     * does not hit the wire.
+     * support from the cached configuration snapshot. Resolves from the
+     * lib's cached snapshot; does not hit the wire.
      *
-     * Returns `undefined` when the key is not yet cached (handshake
+     * Resolves to `undefined` when the key is not yet cached (handshake
      * still in progress, or the EV does not publish the key at all).
      * Callers that need a boolean-only answer should treat `undefined`
      * as `false` only after {@link ready} reports the client is bound.
      */
-    supportsAsymmetricCharging: () => boolean | undefined;
+    supportsAsymmetricCharging: () => Promise<boolean | undefined>;
     /**
      * Subscribe to EV-connect events (vehicle plugged in).
      */

package/dist/cjs/packages/eebus/eebus-evcem-client.d.cts

@@ -32,12 +32,12 @@ export interface EebusEvcemClient extends EebusUseCaseClient {
     getCurrentMeasurement: () => Promise<EebusEvcemReading>;
     /**
      * Return the most recent telemetry sample the SDK has observed on
-     * this peer, without dispatching a wire read. Synchronous and
-     * side-effect-free.
+     * this peer, without dispatching a wire read. Resolves from the
+     * lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first inbound notify has landed.
+     * Resolves to `undefined` until the first inbound notify has landed.
      */
-    getLastMeasurement: () => EebusEvcemReading | undefined;
+    getLastMeasurement: () => Promise<EebusEvcemReading | undefined>;
     /**
      * Subscribe to per-update telemetry samples.
      *

package/dist/cjs/packages/eebus/eebus-evsoc-client.d.cts

@@ -31,14 +31,14 @@ export interface EebusEvsocClient extends EebusUseCaseClient {
     getStateOfChargePercent: () => Promise<number>;
     /**
      * Return the most recent SoC sample the SDK has observed on this
-     * peer, without dispatching a wire read. Synchronous and
-     * side-effect-free.
+     * peer, without dispatching a wire read. Resolves from the lib's
+     * cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first SoC notify has landed — and
-     * may stay `undefined` indefinitely on vehicles that do not publish
-     * their SoC over EEBUS (see the class-level note).
+     * Resolves to `undefined` until the first SoC notify has landed —
+     * and may stay `undefined` indefinitely on vehicles that do not
+     * publish their SoC over EEBUS (see the class-level note).
      */
-    getLastStateOfCharge: () => EebusEvSocReading | undefined;
+    getLastStateOfCharge: () => Promise<EebusEvSocReading | undefined>;
     /**
      * Subscribe to SoC updates.
      *

package/dist/cjs/packages/eebus/eebus-lpc-client.d.cts

@@ -215,10 +215,10 @@ export interface EebusLpcClient extends EebusUseCaseClient {
     /**
      * Resolve the descriptor for a LoadControl limit slot on the peer,
      * using the SDK's cached `loadControlLimitDescriptionListData`.
-     * Synchronous; does not hit the wire.
+     * Resolves from the cached snapshot; does not hit the wire.
      *
-     * Returns the matching descriptor, or `undefined` when no slot on
-     * the resolved entity satisfies the requested
+     * Resolves to the matching descriptor, or `undefined` when no slot
+     * on the resolved entity satisfies the requested
      * {@link FindLpcLimitOptions.direction} (and, when supplied,
      * {@link FindLpcLimitOptions.category}). On peers that advertise
      * several matching slots the resolver returns the first one in
@@ -226,7 +226,7 @@ export interface EebusLpcClient extends EebusUseCaseClient {
      * should use {@link EebusFeatureCatalog.findFeatureAddressForClient}
      * + a per-slot enumeration.
      */
-    findLimit: (opts: FindLpcLimitOptions) => EebusLpcLimitDescriptor | undefined;
+    findLimit: (opts: FindLpcLimitOptions) => Promise<EebusLpcLimitDescriptor | undefined>;
     /**
      * Resolve the per-phase `limitId`s advertised by the peer for a
      * given limit {@link FindPerPhaseLimitIdsOptions.category}, in
@@ -234,9 +234,9 @@ export interface EebusLpcClient extends EebusUseCaseClient {
      * current limits over LoadControl (the OPEV / OSCEV path on
      * wallboxes that don't expose a dedicated OPEV feature).
      *
-     * Returns `undefined` when the peer does not advertise per-phase
-     * slots for the requested category. Synchronous; does not hit the
-     * wire.
+     * Resolves to `undefined` when the peer does not advertise
+     * per-phase slots for the requested category. Resolves from the
+     * cached snapshot; does not hit the wire.
      */
-    findPerPhaseLimitIds: (opts: FindPerPhaseLimitIdsOptions) => number[] | undefined;
+    findPerPhaseLimitIds: (opts: FindPerPhaseLimitIdsOptions) => Promise<number[] | undefined>;
 }

package/dist/cjs/packages/eebus/eebus-mgcp-client.d.cts

@@ -18,14 +18,15 @@ export interface EebusMgcpClient extends EebusUseCaseClient {
     getReading: () => Promise<EebusMgcpReading>;
     /**
      * Return the most recent reading the SDK has observed on this peer
-     * without dispatching a wire read. Synchronous and side-effect-free.
+     * without dispatching a wire read. Resolves from the lib's cached
+     * snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first inbound notify lands.
+     * Resolves to `undefined` until the first inbound notify lands.
      * Subsequent notifies update the snapshot — callers that only need
      * to poll the latest value can drop their {@link onReading}
      * subscription in favour of this getter.
      */
-    getLastReading: () => EebusMgcpReading | undefined;
+    getLastReading: () => Promise<EebusMgcpReading | undefined>;
     /**
      * Subscribe to updates whenever the grid connection point publishes new telemetry.
      * @param listener Callback invoked with each new reading

package/dist/cjs/packages/eebus/eebus-mpc-client.d.cts

@@ -87,16 +87,17 @@ export interface EebusMpcClient extends EebusUseCaseClient {
     getReading: () => Promise<EebusMpcReading>;
     /**
      * Return the most recent reading the SDK has observed on this peer
-     * without dispatching a wire read. Synchronous and side-effect-free.
+     * without dispatching a wire read. Resolves from the lib's cached
+     * snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first `measurementListData` notify
-     * lands after attach (the SPINE binding is in progress, or the peer
-     * has not pushed any sample yet). Once populated, the snapshot
-     * tracks every subsequent notify — callers do not need to combine
-     * this with a manual {@link onReading} subscription unless they
-     * want push-style delivery.
+     * Resolves to `undefined` until the first `measurementListData`
+     * notify lands after attach (the SPINE binding is in progress, or
+     * the peer has not pushed any sample yet). Once populated, the
+     * snapshot tracks every subsequent notify — callers do not need to
+     * combine this with a manual {@link onReading} subscription unless
+     * they want push-style delivery.
      */
-    getLastReading: () => EebusMpcReading | undefined;
+    getLastReading: () => Promise<EebusMpcReading | undefined>;
     /**
      * Subscribe to updates whenever the controllable system publishes new telemetry.
      * @param listener Callback invoked with each new reading
@@ -116,15 +117,15 @@ export interface EebusMpcClient extends EebusUseCaseClient {
     removeListener: (listenerId: string) => void;
     /**
      * Resolve the descriptor for a Measurement slot on the peer, using
-     * the SDK's cached `measurementDescriptionListData`. Synchronous;
-     * does not hit the wire.
+     * the SDK's cached `measurementDescriptionListData`. Resolves from
+     * the cached snapshot; does not hit the wire.
      *
-     * Returns the matching descriptor, or `undefined` when no slot on
-     * the resolved entity satisfies the requested
+     * Resolves to the matching descriptor, or `undefined` when no slot
+     * on the resolved entity satisfies the requested
      * {@link FindMpcMeasurementOptions.scope} (and, when supplied,
      * {@link FindMpcMeasurementOptions.commodity}). On peers that
      * advertise several matching slots the resolver returns the first
      * one in description-list order.
      */
-    findMeasurement: (opts: FindMpcMeasurementOptions) => EebusMpcMeasurementDescriptor | undefined;
+    findMeasurement: (opts: FindMpcMeasurementOptions) => Promise<EebusMpcMeasurementDescriptor | undefined>;
 }

package/dist/cjs/packages/eebus/eebus-use-case-client.d.cts

@@ -38,22 +38,26 @@ export interface EebusUseCaseReadiness {
  * readiness state so a consumer can answer "is this peer ready for me to
  * use this use case yet?" without firing any wire traffic.
  *
- * The probe is synchronous and side-effect-free: it neither triggers nor
- * waits for the handshake. Call it from a render path, an event handler,
- * or a polling loop without worrying about cost.
+ * The probe is side-effect-free: it neither triggers nor waits for the
+ * handshake — the returned promise resolves from the lib's cached state.
+ * The async signature is preserved for symmetry with the rest of the
+ * SDK surface (every other use-case method returns a promise) and to
+ * keep IPC bridges in consumer packages from having to special-case
+ * this one method.
  */
 export interface EebusUseCaseClient {
     /**
      * Probe the lib's cached readiness state for this use-case client.
      *
-     * Returns `{ ready: true }` once the peer is fully bound and
-     * subscribed. Returns `{ ready: false, reason }` while any
+     * Resolves to `{ ready: true }` once the peer is fully bound and
+     * subscribed. Resolves to `{ ready: false, reason }` while any
      * precondition is outstanding — {@link EebusUseCaseReadiness.reason}
      * carries the lib-published explanation so callers can distinguish
      * "peer is offline" from "peer does not support this use case" from
      * "binding is still in flight".
      *
-     * Synchronous and side-effect-free. Safe to call from hot paths.
+     * Side-effect-free and cached — resolves immediately. Safe to call
+     * from hot paths.
      */
-    ready: () => EebusUseCaseReadiness;
+    ready: () => Promise<EebusUseCaseReadiness>;
 }

package/dist/cjs/packages/eebus/eebus-vabd-client.d.cts

@@ -44,15 +44,15 @@ export interface EebusVabdClient extends EebusUseCaseClient {
     getBatteryNominalCapacityWh: () => Promise<number | undefined>;
     /**
      * Return the most recent consolidated battery telemetry the SDK has
-     * observed on this peer, without dispatching a wire read.
-     * Synchronous and side-effect-free.
+     * observed on this peer, without dispatching a wire read. Resolves
+     * from the lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first `measurementListData` notify
-     * has landed. Once populated, the snapshot tracks every subsequent
-     * notify — callers can drop their {@link onTelemetry} subscription
-     * if they only need to poll the latest value.
+     * Resolves to `undefined` until the first `measurementListData`
+     * notify has landed. Once populated, the snapshot tracks every
+     * subsequent notify — callers can drop their {@link onTelemetry}
+     * subscription if they only need to poll the latest value.
      */
-    getLastTelemetry: () => EebusVabdTelemetry | undefined;
+    getLastTelemetry: () => Promise<EebusVabdTelemetry | undefined>;
     /**
      * Subscribe to consolidated battery telemetry updates.
      */

package/dist/cjs/packages/eebus/eebus-vapd-client.d.cts

@@ -38,12 +38,12 @@ export interface EebusVapdClient extends EebusUseCaseClient {
     getPvNominalPeakPowerW: () => Promise<number | undefined>;
     /**
      * Return the most recent consolidated PV telemetry the SDK has
-     * observed on this peer, without dispatching a wire read.
-     * Synchronous and side-effect-free.
+     * observed on this peer, without dispatching a wire read. Resolves
+     * from the lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first inbound notify has landed.
+     * Resolves to `undefined` until the first inbound notify has landed.
      */
-    getLastTelemetry: () => EebusVapdTelemetry | undefined;
+    getLastTelemetry: () => Promise<EebusVapdTelemetry | undefined>;
     /**
      * Subscribe to consolidated PV telemetry updates.
      */

package/dist/cjs/version.cjs

@@ -9,7 +9,7 @@ exports.getSdkVersion = getSdkVersion;
 /**
  * Current version of the enyo Energy App SDK.
  */
-exports.SDK_VERSION = '0.0.145';
+exports.SDK_VERSION = '0.0.146';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/cjs/version.d.cts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.145";
+export declare const SDK_VERSION = "0.0.146";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/packages/eebus/eebus-cevc-client.d.ts

@@ -62,23 +62,24 @@ export interface EebusCevcClient extends EebusUseCaseClient {
     publishIncentiveTable: (table: EebusOhpcfIncentiveTable) => Promise<void>;
     /**
      * Return the most recent time-series charging plan the SDK has
-     * observed on this peer, without dispatching a wire read.
-     * Synchronous and side-effect-free.
+     * observed on this peer, without dispatching a wire read. Resolves
+     * from the lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first plan notify has landed, and
-     * will keep returning `undefined` on peers that do not implement
-     * `TimeSeries` until that client lands in `@enyo-energy/eebus`.
+     * Resolves to `undefined` until the first plan notify has landed,
+     * and will keep resolving to `undefined` on peers that do not
+     * implement `TimeSeries` until that client lands in
+     * `@enyo-energy/eebus`.
      */
-    getLastTimeSeriesPlan: () => EebusCevcChargingPlan | undefined;
+    getLastTimeSeriesPlan: () => Promise<EebusCevcChargingPlan | undefined>;
     /**
      * Return the most recent incentive table the SDK has observed on
-     * this peer, without dispatching a wire read. Synchronous and
-     * side-effect-free.
+     * this peer, without dispatching a wire read. Resolves from the
+     * lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first `incentiveTableData` notify
-     * has landed.
+     * Resolves to `undefined` until the first `incentiveTableData`
+     * notify has landed.
      */
-    getLastIncentiveTable: () => EebusOhpcfIncentiveTable | undefined;
+    getLastIncentiveTable: () => Promise<EebusOhpcfIncentiveTable | undefined>;
     /**
      * Subscribe to plan-state updates published by the EV (e.g. revised
      * plan after the EV revised its capacity estimate).

package/dist/packages/eebus/eebus-evcc-client.d.ts

@@ -51,12 +51,13 @@ export interface EebusEvccClient extends EebusUseCaseClient {
     /**
      * Return the most recent EV identification (EVCCID + identification
      * type) the SDK has observed on this peer, without dispatching a
-     * wire read. Synchronous and side-effect-free.
+     * wire read. Resolves from the lib's cached snapshot —
+     * side-effect-free.
      *
-     * Returns `undefined` until the first `identificationListData`
+     * Resolves to `undefined` until the first `identificationListData`
      * notify has landed.
      */
-    getLastEvIdentification: () => EebusEvIdentification | undefined;
+    getLastEvIdentification: () => Promise<EebusEvIdentification | undefined>;
     /**
      * Return the most recent `DeviceConfiguration.keyValueListData`
      * snapshot the SDK has observed on this peer. Surfaces every
@@ -66,40 +67,41 @@ export interface EebusEvccClient extends EebusUseCaseClient {
      * {@link supportsAsymmetricCharging} which already narrow the
      * lookup.
      *
-     * Returns `undefined` until the first notify has landed.
+     * Resolves to `undefined` until the first notify has landed.
      */
-    getLastEvConfiguration: () => EebusEvConfigurationSnapshot | undefined;
+    getLastEvConfiguration: () => Promise<EebusEvConfigurationSnapshot | undefined>;
     /**
      * Return the most recent EV electrical permitted-value snapshot the
      * SDK has observed on this peer — per-phase minimum / maximum
      * current and total power the EV reports as allowable.
      *
-     * Returns `undefined` until the first
+     * Resolves to `undefined` until the first
      * `permittedValueSetListData` notify has landed.
      */
-    getLastEvElectricalLimits: () => EebusEvElectricalLimits | undefined;
+    getLastEvElectricalLimits: () => Promise<EebusEvElectricalLimits | undefined>;
     /**
      * Read the EV's negotiated communication standard from the cached
      * configuration snapshot — `'IEC61851'`, `'ISO15118-2'`,
-     * `'ISO15118-20'`, etc. Synchronous; does not hit the wire.
+     * `'ISO15118-20'`, etc. Resolves from the lib's cached snapshot;
+     * does not hit the wire.
      *
-     * Distinct from {@link getEvCommunicationStandard} (async, returns
-     * the typed enum) — this getter returns the raw wire string for
+     * Distinct from {@link getEvCommunicationStandard} which returns
+     * the typed enum — this getter returns the raw wire string for
      * vendor-specific values the enum doesn't cover, and `undefined`
      * when the key is not yet cached.
      */
-    getCommunicationStandard: () => string | undefined;
+    getCommunicationStandard: () => Promise<string | undefined>;
     /**
      * Read whether the EV advertises asymmetric (per-phase) charging
-     * support from the cached configuration snapshot. Synchronous;
-     * does not hit the wire.
+     * support from the cached configuration snapshot. Resolves from the
+     * lib's cached snapshot; does not hit the wire.
      *
-     * Returns `undefined` when the key is not yet cached (handshake
+     * Resolves to `undefined` when the key is not yet cached (handshake
      * still in progress, or the EV does not publish the key at all).
      * Callers that need a boolean-only answer should treat `undefined`
      * as `false` only after {@link ready} reports the client is bound.
      */
-    supportsAsymmetricCharging: () => boolean | undefined;
+    supportsAsymmetricCharging: () => Promise<boolean | undefined>;
     /**
      * Subscribe to EV-connect events (vehicle plugged in).
      */

package/dist/packages/eebus/eebus-evcem-client.d.ts

@@ -32,12 +32,12 @@ export interface EebusEvcemClient extends EebusUseCaseClient {
     getCurrentMeasurement: () => Promise<EebusEvcemReading>;
     /**
      * Return the most recent telemetry sample the SDK has observed on
-     * this peer, without dispatching a wire read. Synchronous and
-     * side-effect-free.
+     * this peer, without dispatching a wire read. Resolves from the
+     * lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first inbound notify has landed.
+     * Resolves to `undefined` until the first inbound notify has landed.
      */
-    getLastMeasurement: () => EebusEvcemReading | undefined;
+    getLastMeasurement: () => Promise<EebusEvcemReading | undefined>;
     /**
      * Subscribe to per-update telemetry samples.
      *

package/dist/packages/eebus/eebus-evsoc-client.d.ts

@@ -31,14 +31,14 @@ export interface EebusEvsocClient extends EebusUseCaseClient {
     getStateOfChargePercent: () => Promise<number>;
     /**
      * Return the most recent SoC sample the SDK has observed on this
-     * peer, without dispatching a wire read. Synchronous and
-     * side-effect-free.
+     * peer, without dispatching a wire read. Resolves from the lib's
+     * cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first SoC notify has landed — and
-     * may stay `undefined` indefinitely on vehicles that do not publish
-     * their SoC over EEBUS (see the class-level note).
+     * Resolves to `undefined` until the first SoC notify has landed —
+     * and may stay `undefined` indefinitely on vehicles that do not
+     * publish their SoC over EEBUS (see the class-level note).
      */
-    getLastStateOfCharge: () => EebusEvSocReading | undefined;
+    getLastStateOfCharge: () => Promise<EebusEvSocReading | undefined>;
     /**
      * Subscribe to SoC updates.
      *

package/dist/packages/eebus/eebus-lpc-client.d.ts

@@ -215,10 +215,10 @@ export interface EebusLpcClient extends EebusUseCaseClient {
     /**
      * Resolve the descriptor for a LoadControl limit slot on the peer,
      * using the SDK's cached `loadControlLimitDescriptionListData`.
-     * Synchronous; does not hit the wire.
+     * Resolves from the cached snapshot; does not hit the wire.
      *
-     * Returns the matching descriptor, or `undefined` when no slot on
-     * the resolved entity satisfies the requested
+     * Resolves to the matching descriptor, or `undefined` when no slot
+     * on the resolved entity satisfies the requested
      * {@link FindLpcLimitOptions.direction} (and, when supplied,
      * {@link FindLpcLimitOptions.category}). On peers that advertise
      * several matching slots the resolver returns the first one in
@@ -226,7 +226,7 @@ export interface EebusLpcClient extends EebusUseCaseClient {
      * should use {@link EebusFeatureCatalog.findFeatureAddressForClient}
      * + a per-slot enumeration.
      */
-    findLimit: (opts: FindLpcLimitOptions) => EebusLpcLimitDescriptor | undefined;
+    findLimit: (opts: FindLpcLimitOptions) => Promise<EebusLpcLimitDescriptor | undefined>;
     /**
      * Resolve the per-phase `limitId`s advertised by the peer for a
      * given limit {@link FindPerPhaseLimitIdsOptions.category}, in
@@ -234,9 +234,9 @@ export interface EebusLpcClient extends EebusUseCaseClient {
      * current limits over LoadControl (the OPEV / OSCEV path on
      * wallboxes that don't expose a dedicated OPEV feature).
      *
-     * Returns `undefined` when the peer does not advertise per-phase
-     * slots for the requested category. Synchronous; does not hit the
-     * wire.
+     * Resolves to `undefined` when the peer does not advertise
+     * per-phase slots for the requested category. Resolves from the
+     * cached snapshot; does not hit the wire.
      */
-    findPerPhaseLimitIds: (opts: FindPerPhaseLimitIdsOptions) => number[] | undefined;
+    findPerPhaseLimitIds: (opts: FindPerPhaseLimitIdsOptions) => Promise<number[] | undefined>;
 }

package/dist/packages/eebus/eebus-mgcp-client.d.ts

@@ -18,14 +18,15 @@ export interface EebusMgcpClient extends EebusUseCaseClient {
     getReading: () => Promise<EebusMgcpReading>;
     /**
      * Return the most recent reading the SDK has observed on this peer
-     * without dispatching a wire read. Synchronous and side-effect-free.
+     * without dispatching a wire read. Resolves from the lib's cached
+     * snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first inbound notify lands.
+     * Resolves to `undefined` until the first inbound notify lands.
      * Subsequent notifies update the snapshot — callers that only need
      * to poll the latest value can drop their {@link onReading}
      * subscription in favour of this getter.
      */
-    getLastReading: () => EebusMgcpReading | undefined;
+    getLastReading: () => Promise<EebusMgcpReading | undefined>;
     /**
      * Subscribe to updates whenever the grid connection point publishes new telemetry.
      * @param listener Callback invoked with each new reading

package/dist/packages/eebus/eebus-mpc-client.d.ts

@@ -87,16 +87,17 @@ export interface EebusMpcClient extends EebusUseCaseClient {
     getReading: () => Promise<EebusMpcReading>;
     /**
      * Return the most recent reading the SDK has observed on this peer
-     * without dispatching a wire read. Synchronous and side-effect-free.
+     * without dispatching a wire read. Resolves from the lib's cached
+     * snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first `measurementListData` notify
-     * lands after attach (the SPINE binding is in progress, or the peer
-     * has not pushed any sample yet). Once populated, the snapshot
-     * tracks every subsequent notify — callers do not need to combine
-     * this with a manual {@link onReading} subscription unless they
-     * want push-style delivery.
+     * Resolves to `undefined` until the first `measurementListData`
+     * notify lands after attach (the SPINE binding is in progress, or
+     * the peer has not pushed any sample yet). Once populated, the
+     * snapshot tracks every subsequent notify — callers do not need to
+     * combine this with a manual {@link onReading} subscription unless
+     * they want push-style delivery.
      */
-    getLastReading: () => EebusMpcReading | undefined;
+    getLastReading: () => Promise<EebusMpcReading | undefined>;
     /**
      * Subscribe to updates whenever the controllable system publishes new telemetry.
      * @param listener Callback invoked with each new reading
@@ -116,15 +117,15 @@ export interface EebusMpcClient extends EebusUseCaseClient {
     removeListener: (listenerId: string) => void;
     /**
      * Resolve the descriptor for a Measurement slot on the peer, using
-     * the SDK's cached `measurementDescriptionListData`. Synchronous;
-     * does not hit the wire.
+     * the SDK's cached `measurementDescriptionListData`. Resolves from
+     * the cached snapshot; does not hit the wire.
      *
-     * Returns the matching descriptor, or `undefined` when no slot on
-     * the resolved entity satisfies the requested
+     * Resolves to the matching descriptor, or `undefined` when no slot
+     * on the resolved entity satisfies the requested
      * {@link FindMpcMeasurementOptions.scope} (and, when supplied,
      * {@link FindMpcMeasurementOptions.commodity}). On peers that
      * advertise several matching slots the resolver returns the first
      * one in description-list order.
      */
-    findMeasurement: (opts: FindMpcMeasurementOptions) => EebusMpcMeasurementDescriptor | undefined;
+    findMeasurement: (opts: FindMpcMeasurementOptions) => Promise<EebusMpcMeasurementDescriptor | undefined>;
 }

package/dist/packages/eebus/eebus-use-case-client.d.ts

@@ -38,22 +38,26 @@ export interface EebusUseCaseReadiness {
  * readiness state so a consumer can answer "is this peer ready for me to
  * use this use case yet?" without firing any wire traffic.
  *
- * The probe is synchronous and side-effect-free: it neither triggers nor
- * waits for the handshake. Call it from a render path, an event handler,
- * or a polling loop without worrying about cost.
+ * The probe is side-effect-free: it neither triggers nor waits for the
+ * handshake — the returned promise resolves from the lib's cached state.
+ * The async signature is preserved for symmetry with the rest of the
+ * SDK surface (every other use-case method returns a promise) and to
+ * keep IPC bridges in consumer packages from having to special-case
+ * this one method.
  */
 export interface EebusUseCaseClient {
     /**
      * Probe the lib's cached readiness state for this use-case client.
      *
-     * Returns `{ ready: true }` once the peer is fully bound and
-     * subscribed. Returns `{ ready: false, reason }` while any
+     * Resolves to `{ ready: true }` once the peer is fully bound and
+     * subscribed. Resolves to `{ ready: false, reason }` while any
      * precondition is outstanding — {@link EebusUseCaseReadiness.reason}
      * carries the lib-published explanation so callers can distinguish
      * "peer is offline" from "peer does not support this use case" from
      * "binding is still in flight".
      *
-     * Synchronous and side-effect-free. Safe to call from hot paths.
+     * Side-effect-free and cached — resolves immediately. Safe to call
+     * from hot paths.
      */
-    ready: () => EebusUseCaseReadiness;
+    ready: () => Promise<EebusUseCaseReadiness>;
 }

package/dist/packages/eebus/eebus-vabd-client.d.ts

@@ -44,15 +44,15 @@ export interface EebusVabdClient extends EebusUseCaseClient {
     getBatteryNominalCapacityWh: () => Promise<number | undefined>;
     /**
      * Return the most recent consolidated battery telemetry the SDK has
-     * observed on this peer, without dispatching a wire read.
-     * Synchronous and side-effect-free.
+     * observed on this peer, without dispatching a wire read. Resolves
+     * from the lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first `measurementListData` notify
-     * has landed. Once populated, the snapshot tracks every subsequent
-     * notify — callers can drop their {@link onTelemetry} subscription
-     * if they only need to poll the latest value.
+     * Resolves to `undefined` until the first `measurementListData`
+     * notify has landed. Once populated, the snapshot tracks every
+     * subsequent notify — callers can drop their {@link onTelemetry}
+     * subscription if they only need to poll the latest value.
      */
-    getLastTelemetry: () => EebusVabdTelemetry | undefined;
+    getLastTelemetry: () => Promise<EebusVabdTelemetry | undefined>;
     /**
      * Subscribe to consolidated battery telemetry updates.
      */

package/dist/packages/eebus/eebus-vapd-client.d.ts

@@ -38,12 +38,12 @@ export interface EebusVapdClient extends EebusUseCaseClient {
     getPvNominalPeakPowerW: () => Promise<number | undefined>;
     /**
      * Return the most recent consolidated PV telemetry the SDK has
-     * observed on this peer, without dispatching a wire read.
-     * Synchronous and side-effect-free.
+     * observed on this peer, without dispatching a wire read. Resolves
+     * from the lib's cached snapshot — side-effect-free.
      *
-     * Returns `undefined` until the first inbound notify has landed.
+     * Resolves to `undefined` until the first inbound notify has landed.
      */
-    getLastTelemetry: () => EebusVapdTelemetry | undefined;
+    getLastTelemetry: () => Promise<EebusVapdTelemetry | undefined>;
     /**
      * Subscribe to consolidated PV telemetry updates.
      */

package/dist/version.d.ts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.145";
+export declare const SDK_VERSION = "0.0.146";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/version.js

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export const SDK_VERSION = '0.0.145';
+export const SDK_VERSION = '0.0.146';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enyo-energy/energy-app-sdk",
-  "version": "0.0.145",
+  "version": "0.0.146",
   "description": "enyo Energy App SDK",
   "type": "module",
   "main": "dist/index.js",