@fastybird/smart-panel-backend 1.1.0-alpha.64 → 1.1.0-alpha.65

package/dist/plugins/devices-shelly-ng/services/shelly-cover-recovery-lane.service.js

@@ -0,0 +1,166 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShellyCoverRecoveryLaneService = void 0;
+const node_crypto_1 = require("node:crypto");
+const common_1 = require("@nestjs/common");
+const devices_constants_1 = require("../../../modules/devices/devices.constants");
+const property_command_admission_registry_service_1 = require("../../../modules/devices/services/property-command-admission.registry.service");
+const property_command_window_service_1 = require("../../../modules/devices/services/property-command-window.service");
+let ShellyCoverRecoveryLaneService = class ShellyCoverRecoveryLaneService {
+    constructor(admission, windows) {
+        this.admission = admission;
+        this.windows = windows;
+        this.motors = new Map();
+        this.stopped = false;
+        this.preparations = new Map();
+        this.active = new Map();
+    }
+    scope(update) {
+        const mac = update.device.canonicalMac;
+        return update.device.type === 'devices-shelly-ng' &&
+            mac &&
+            /^cover:\d+$/.test(update.channel.identifier ?? '') &&
+            [devices_constants_1.PropertyCategory.COMMAND, devices_constants_1.PropertyCategory.POSITION, devices_constants_1.PropertyCategory.TILT].includes(update.property.category)
+            ? `${mac.toUpperCase()}|cover:${Number(update.channel.identifier.split(':')[1])}`
+            : null;
+    }
+    onModuleInit() {
+        this.unregister = this.admission.register({
+            capture: () => {
+                const epochs = new Map([...this.motors].map(([scope, state]) => [scope, state.epoch]));
+                const current = (update) => {
+                    const scope = this.scope(update);
+                    return (!scope ||
+                        (!this.stopped &&
+                            !this.motors.get(scope)?.recovering &&
+                            epochs.get(scope) === this.motors.get(scope)?.epoch));
+                };
+                const assert = (update) => {
+                    if (!current(update))
+                        return Promise.reject(new common_1.ConflictException('Cover recovery invalidated captured command authority'));
+                    return Promise.resolve();
+                };
+                return {
+                    isCurrent: (update) => !update || current(update),
+                    isEffectCurrent: current,
+                    assertAllowed: assert,
+                    assertEffectAllowed: assert,
+                };
+            },
+            isEffectCurrent: (effect) => !this.motors.get(this.scope(effect))?.recovering,
+            assertEffectAllowed: (effect) => this.assertOpen(this.scope(effect)),
+            assertAllowed: (update) => this.assertOpen(this.scope(update)),
+        });
+    }
+    assertOpen(scope) {
+        return scope && this.motors.get(scope)?.recovering
+            ? Promise.reject(new common_1.ConflictException('Cover operator recovery is in progress'))
+            : Promise.resolve();
+    }
+    state(scope) {
+        let state = this.motors.get(scope);
+        if (!state) {
+            if (this.motors.size >= 4096)
+                throw new common_1.ConflictException('Cover recovery lane capacity exceeded');
+            state = { epoch: (0, node_crypto_1.randomUUID)(), recovering: false };
+            this.motors.set(scope, state);
+        }
+        return state;
+    }
+    prepare(scope) {
+        const state = this.motors.get(scope);
+        if (this.stopped || state?.recovering || (!this.preparations.has(scope) && this.preparations.size >= 4096))
+            return null;
+        const epoch = state?.epoch;
+        this.preparations.set(scope, (this.preparations.get(scope) ?? 0) + 1);
+        let disposed = false;
+        return {
+            isCurrent: () => !disposed && !this.stopped && !this.motors.get(scope)?.recovering && this.motors.get(scope)?.epoch === epoch,
+            enter: () => {
+                if (disposed || this.stopped || this.motors.get(scope)?.recovering || this.motors.get(scope)?.epoch !== epoch)
+                    throw new common_1.ConflictException('Cover preparation expired');
+                this.active.set(scope, (this.active.get(scope) ?? 0) + 1);
+                return () => {
+                    const remaining = (this.active.get(scope) ?? 1) - 1;
+                    if (remaining > 0)
+                        this.active.set(scope, remaining);
+                    else
+                        this.active.delete(scope);
+                };
+            },
+            dispose: () => {
+                if (!disposed) {
+                    disposed = true;
+                    const remaining = (this.preparations.get(scope) ?? 1) - 1;
+                    if (remaining > 0)
+                        this.preparations.set(scope, remaining);
+                    else
+                        this.preparations.delete(scope);
+                }
+            },
+        };
+    }
+    isRecovering(scope) {
+        return this.stopped || this.motors.get(scope)?.recovering === true;
+    }
+    begin(scope, retire) {
+        if (this.stopped)
+            throw new common_1.ConflictException('Cover recovery is shutting down');
+        const state = this.state(scope);
+        if (state.recovering)
+            throw new common_1.ConflictException('Cover recovery already in progress');
+        state.epoch = (0, node_crypto_1.randomUUID)();
+        const effect = `shelly-ng:${scope}`;
+        const handle = this.windows.reserveCoverEffect(effect);
+        if (handle === null)
+            throw new common_1.ConflictException('Cover effect capacity exceeded');
+        try {
+            retire?.();
+        }
+        catch (error) {
+            this.windows.releaseCoverEffectReservation(effect, handle);
+            throw error;
+        }
+        if ((this.preparations.get(scope) ?? 0) > 0 || (this.active.get(scope) ?? 0) > 0) {
+            this.windows.releaseCoverEffectReservation(effect, handle);
+            throw new common_1.ConflictException('Cover has active or prepared local dispatch; retry after it settles');
+        }
+        state.recovering = true;
+        const epoch = state.epoch;
+        return {
+            epoch,
+            isCurrent: () => state.recovering && state.epoch === epoch && this.windows.isCoverEffectCurrent(effect, handle),
+            dispose: () => {
+                if (state.epoch === epoch) {
+                    state.epoch = (0, node_crypto_1.randomUUID)();
+                    state.recovering = false;
+                }
+                this.windows.releaseCoverEffectReservation(effect, handle);
+            },
+        };
+    }
+    onModuleDestroy() {
+        this.stopped = true;
+        this.unregister?.();
+        for (const state of this.motors.values()) {
+            state.epoch = (0, node_crypto_1.randomUUID)();
+            state.recovering = true;
+        }
+    }
+};
+exports.ShellyCoverRecoveryLaneService = ShellyCoverRecoveryLaneService;
+exports.ShellyCoverRecoveryLaneService = ShellyCoverRecoveryLaneService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [property_command_admission_registry_service_1.PropertyCommandAdmissionRegistryService,
+        property_command_window_service_1.PropertyCommandWindowService])
+], ShellyCoverRecoveryLaneService);
+//# sourceMappingURL=shelly-cover-recovery-lane.service.js.map

package/dist/plugins/devices-shelly-ng/services/shelly-cover-recovery-lane.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shelly-cover-recovery-lane.service.js","sourceRoot":"","sources":["../../../../src/plugins/devices-shelly-ng/services/shelly-cover-recovery-lane.service.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices-shelly-ng/services/shelly-cover-recovery.service.d.ts

@@ -0,0 +1,21 @@
+import { DataSource } from 'typeorm';
+import { DeviceStructureLockService } from '../../../modules/devices/services/device-structure-lock.service';
+import { PropertyMetadataService } from '../../../modules/devices/services/property-metadata.service';
+import { PropertyValueSourceRegistryService } from '../../../modules/devices/services/property-value-source.registry.service';
+import { DelegatesManagerService } from '../delegates/delegates-manager.service';
+import { RecoverCoverOrderingDto } from '../dto/cover-recovery.dto';
+import { CoverRecoveryContextModel, CoverRecoveryModel } from '../models/cover-recovery.model';
+import { ShellyCoverRecoveryLaneService } from './shelly-cover-recovery-lane.service';
+export declare class ShellyCoverRecoveryService {
+    private readonly database;
+    private readonly metadata;
+    private readonly sources;
+    private readonly delegates;
+    private readonly lane;
+    private readonly structure;
+    private readonly contexts;
+    constructor(database: DataSource, metadata: PropertyMetadataService, sources: PropertyValueSourceRegistryService, delegates: DelegatesManagerService, lane: ShellyCoverRecoveryLaneService, structure: DeviceStructureLockService);
+    private load;
+    context(actorId: string, deviceId: string, channelId: string, propertyId: string): Promise<CoverRecoveryContextModel>;
+    recover(actorId: string, deviceId: string, channelId: string, propertyId: string, dto: RecoverCoverOrderingDto): Promise<CoverRecoveryModel>;
+}

package/dist/plugins/devices-shelly-ng/services/shelly-cover-recovery.service.js

@@ -0,0 +1,207 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShellyCoverRecoveryService = void 0;
+const node_crypto_1 = require("node:crypto");
+const typeorm_1 = require("typeorm");
+const common_1 = require("@nestjs/common");
+const device_structure_lock_service_1 = require("../../../modules/devices/services/device-structure-lock.service");
+const property_metadata_service_1 = require("../../../modules/devices/services/property-metadata.service");
+const property_value_source_registry_service_1 = require("../../../modules/devices/services/property-value-source.registry.service");
+const delegates_manager_service_1 = require("../delegates/delegates-manager.service");
+const devices_shelly_ng_constants_1 = require("../devices-shelly-ng.constants");
+const cover_recovery_dto_1 = require("../dto/cover-recovery.dto");
+const shelly_cover_ordering_entity_1 = require("../entities/shelly-cover-ordering.entity");
+const shelly_cover_recovery_entity_1 = require("../entities/shelly-cover-recovery.entity");
+const cover_recovery_model_1 = require("../models/cover-recovery.model");
+const shelly_cover_recovery_lane_service_1 = require("./shelly-cover-recovery-lane.service");
+let ShellyCoverRecoveryService = class ShellyCoverRecoveryService {
+    constructor(database, metadata, sources, delegates, lane, structure) {
+        this.database = database;
+        this.metadata = metadata;
+        this.sources = sources;
+        this.delegates = delegates;
+        this.lane = lane;
+        this.structure = structure;
+        this.contexts = new Map();
+    }
+    async load(deviceId, channelId, propertyId) {
+        const generation = this.metadata.getGeneration();
+        const property = await this.metadata.findOne(propertyId);
+        const channel = property?.channel;
+        const device = channel?.device;
+        if (!property ||
+            device?.id !== deviceId ||
+            channel.id !== channelId ||
+            device.type !== devices_shelly_ng_constants_1.DEVICES_SHELLY_NG_TYPE ||
+            !device.enabled ||
+            this.sources.resolve(property) !== property.id)
+            throw new common_1.NotFoundException('Current canonical ordinary Shelly cover target unavailable');
+        const update = { device, channel, property, value: 'stop' };
+        const target = await this.delegates.captureCoverRecoveryTarget(update);
+        if (!target || !target.isCurrent() || generation !== this.metadata.getGeneration())
+            throw new common_1.ConflictException('Cover metadata/connection changed or no guarded calibrated cover adapter exists');
+        const revision = (0, node_crypto_1.createHash)('sha256')
+            .update(JSON.stringify([
+            generation,
+            device.id,
+            device.identifier,
+            device.enabled,
+            device.category,
+            channel.id,
+            channel.identifier,
+            channel.category,
+            this.sources.resolve(property),
+            target.revision,
+        ]))
+            .digest('hex');
+        return { target, revision, metadataGeneration: generation };
+    }
+    async context(actorId, deviceId, channelId, propertyId) {
+        for (const [id, value] of this.contexts)
+            if (value.expiresAt <= Date.now())
+                this.contexts.delete(id);
+        if (this.contexts.size >= 1024)
+            throw new common_1.ConflictException('Recovery context capacity exceeded');
+        const current = await this.load(deviceId, channelId, propertyId);
+        if (this.lane.isRecovering(current.target.physicalIdentity))
+            throw new common_1.ConflictException('Cover recovery already in progress');
+        const row = await this.database.manager.findOneBy(shelly_cover_ordering_entity_1.ShellyCoverOrderingEntity, {
+            physicalIdentity: current.target.physicalIdentity,
+        });
+        if (!row)
+            throw new common_1.NotFoundException('No unresolved cover ordering reservation');
+        if (this.lane.isRecovering(current.target.physicalIdentity) ||
+            !current.target.isCurrent() ||
+            current.metadataGeneration !== this.metadata.getGeneration())
+            throw new common_1.ConflictException('Cover context changed');
+        const id = (0, node_crypto_1.randomUUID)(), expiresAt = Date.now() + 30_000;
+        this.contexts.set(id, {
+            actorId,
+            deviceId,
+            channelId,
+            propertyId,
+            ...current,
+            token: row.token,
+            startedAt: row.startedAt,
+            expiresAt,
+        });
+        return Object.assign(new cover_recovery_model_1.CoverRecoveryContextModel(), {
+            context_id: id,
+            physical_identity: row.physicalIdentity,
+            expected_token: row.token,
+            expected_revision: current.revision,
+            started_at: row.startedAt.toISOString(),
+            expires_at: new Date(expiresAt).toISOString(),
+        });
+    }
+    async recover(actorId, deviceId, channelId, propertyId, dto) {
+        const context = this.contexts.get(dto.context_id);
+        if (!context ||
+            context.actorId !== actorId ||
+            context.deviceId !== deviceId ||
+            context.channelId !== channelId ||
+            context.propertyId !== propertyId ||
+            context.token !== dto.expected_token ||
+            context.revision !== dto.expected_revision ||
+            context.expiresAt <= Date.now())
+            throw new common_1.ConflictException('Cover recovery context expired or changed; reload');
+        if (dto.acknowledgement !== cover_recovery_dto_1.COVER_RECOVERY_ACKNOWLEDGEMENT || !dto.reason?.trim() || dto.reason.length > 500)
+            throw new common_1.ConflictException('Explicit uncertainty acknowledgement and bounded operator reason required');
+        this.contexts.delete(dto.context_id);
+        const lease = this.lane.begin(context.target.physicalIdentity, () => {
+            context.target.retire();
+            for (const [id, issued] of this.contexts)
+                if (issued.target.physicalIdentity === context.target.physicalIdentity)
+                    this.contexts.delete(id);
+        });
+        let probe;
+        let committed = false;
+        const current = () => lease.isCurrent() &&
+            context.target.isCurrent() &&
+            context.expiresAt > Date.now() &&
+            context.metadataGeneration === this.metadata.getGeneration();
+        try {
+            if (!current())
+                throw new common_1.ConflictException('Cover recovery authority changed');
+            probe = context.target.begin();
+            const fresh = await probe.session
+                .read(() => current() && probe.isCurrent())
+                .catch(() => {
+                throw new common_1.ConflictException('Fresh guarded cover status unavailable; ordering remains unresolved');
+            });
+            if (!fresh || !['open', 'closed', 'stopped'].includes(fresh.raw.state) || !current() || !probe.isCurrent())
+                throw new common_1.ConflictException('Fresh calibrated, tag-capable, fault-free nonmoving cover status required');
+            const live = await this.load(deviceId, channelId, propertyId);
+            if (live.revision !== context.revision || !current() || !probe.isCurrent())
+                throw new common_1.ConflictException('Cover mapping/source/configuration/connection changed');
+            await this.structure.runExclusive(() => this.database.transaction(async (manager) => {
+                if (!current() || !probe.isCurrent())
+                    throw new common_1.ConflictException('Cover recovery authority changed');
+                const row = await manager.findOneBy(shelly_cover_ordering_entity_1.ShellyCoverOrderingEntity, {
+                    physicalIdentity: context.target.physicalIdentity,
+                });
+                if (!row || row.token !== context.token)
+                    throw new common_1.ConflictException('Unresolved reservation changed');
+                const removed = await manager.delete(shelly_cover_ordering_entity_1.ShellyCoverOrderingEntity, {
+                    physicalIdentity: row.physicalIdentity,
+                    token: context.token,
+                });
+                if (removed.affected !== 1)
+                    throw new common_1.ConflictException('Unresolved reservation compare-and-set failed');
+                await manager.insert(shelly_cover_recovery_entity_1.ShellyCoverRecoveryEntity, {
+                    id: lease.epoch,
+                    actorId,
+                    createdAt: new Date(),
+                    physicalIdentity: row.physicalIdentity,
+                    deviceId,
+                    channelId,
+                    propertyId,
+                    oldToken: row.token,
+                    oldStartedAt: row.startedAt,
+                    contextRevision: context.revision,
+                    reason: dto.reason.trim(),
+                    observedState: fresh.raw.state,
+                    observedPosition: fresh.raw.current_pos,
+                    observedAt: fresh.observedAt,
+                    advisory: 'operator_overridden_unresolved_ordering',
+                });
+                if (!current() || !probe.isCurrent())
+                    throw new common_1.ConflictException('Cover changed during recovery audit');
+                probe.install();
+            }));
+            committed = true;
+            return Object.assign(new cover_recovery_model_1.CoverRecoveryModel(), {
+                override_epoch: lease.epoch,
+                advisory: 'operator_overridden_unresolved_ordering',
+                observed_state: fresh.raw.state,
+                observed_at: fresh.observedAt.toISOString(),
+            });
+        }
+        finally {
+            if (!committed)
+                probe?.session.retire();
+            probe?.dispose();
+            lease.dispose();
+        }
+    }
+};
+exports.ShellyCoverRecoveryService = ShellyCoverRecoveryService;
+exports.ShellyCoverRecoveryService = ShellyCoverRecoveryService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource,
+        property_metadata_service_1.PropertyMetadataService,
+        property_value_source_registry_service_1.PropertyValueSourceRegistryService,
+        delegates_manager_service_1.DelegatesManagerService,
+        shelly_cover_recovery_lane_service_1.ShellyCoverRecoveryLaneService,
+        device_structure_lock_service_1.DeviceStructureLockService])
+], ShellyCoverRecoveryService);
+//# sourceMappingURL=shelly-cover-recovery.service.js.map

package/dist/plugins/devices-shelly-ng/services/shelly-cover-recovery.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shelly-cover-recovery.service.js","sourceRoot":"","sources":["../../../../src/plugins/devices-shelly-ng/services/shelly-cover-recovery.service.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices-shelly-ng/services/shelly-cover-session.d.ts

@@ -0,0 +1,25 @@
+import { NativeCoverStatus } from '../contracts/cover-action.contract';
+import { GuardedShellyRpcHandler } from './guarded-shelly-rpc';
+import { ShellyCoverOrderingService } from './shelly-cover-ordering.service';
+export declare class ShellyCoverSession {
+    private readonly rpc;
+    private readonly componentId;
+    private readonly identityCurrent;
+    private readonly ordering;
+    private readonly physicalIdentity;
+    private submitting;
+    private uncertain;
+    private retired;
+    private activeDispatches;
+    hasActiveDispatch(): boolean;
+    retire(): void;
+    constructor(rpc: GuardedShellyRpcHandler, componentId: number, identityCurrent: () => boolean, ordering: ShellyCoverOrderingService, physicalIdentity: string);
+    identityIsCurrent(): boolean;
+    isReady(): boolean;
+    read(isCurrent: () => boolean, invalid?: (raw: Readonly<Record<string, unknown>>, observedAt: Date) => Promise<void>): Promise<{
+        raw: NativeCoverStatus;
+        observedAt: Date;
+    } | null>;
+    dispatch(...args: Parameters<ShellyCoverSession['dispatchAction']>): Promise<boolean>;
+    private dispatchAction;
+}

package/dist/plugins/devices-shelly-ng/services/shelly-cover-session.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShellyCoverSession = void 0;
+const cover_action_contract_1 = require("../contracts/cover-action.contract");
+class ShellyCoverSession {
+    hasActiveDispatch() {
+        return this.activeDispatches > 0;
+    }
+    retire() {
+        this.retired = true;
+    }
+    constructor(rpc, componentId, identityCurrent, ordering, physicalIdentity) {
+        this.rpc = rpc;
+        this.componentId = componentId;
+        this.identityCurrent = identityCurrent;
+        this.ordering = ordering;
+        this.physicalIdentity = physicalIdentity;
+        this.submitting = false;
+        this.uncertain = false;
+        this.retired = false;
+        this.activeDispatches = 0;
+    }
+    identityIsCurrent() {
+        return !this.retired && this.identityCurrent() && this.rpc.connected;
+    }
+    isReady() {
+        return this.identityIsCurrent() && this.rpc.connected && !this.submitting && !this.uncertain;
+    }
+    async read(isCurrent, invalid) {
+        if (!isCurrent() || !this.identityIsCurrent())
+            return null;
+        const observedAt = new Date();
+        const raw = await this.rpc.withSendGuard(() => isCurrent() && this.identityIsCurrent(), () => this.rpc.request('Cover.GetStatus', { id: this.componentId }));
+        if (!isCurrent() || !this.identityIsCurrent())
+            return null;
+        const validated = (0, cover_action_contract_1.nativeCoverStatus)(raw, this.componentId);
+        if (validated && Object.hasOwn(validated, 'tag') && (validated.tag === null || typeof validated.tag === 'string'))
+            return { raw: validated, observedAt };
+        await invalid?.(raw && typeof raw === 'object' ? raw : {}, observedAt);
+        return null;
+    }
+    async dispatch(...args) {
+        if (this.retired)
+            return false;
+        this.activeDispatches++;
+        try {
+            return await this.dispatchAction(...args);
+        }
+        finally {
+            this.activeDispatches--;
+        }
+    }
+    async dispatchAction(action, context, admit, invalid) {
+        if (!this.isReady() || !context.isCurrent())
+            return false;
+        this.submitting = true;
+        let preflight;
+        let reservation = null;
+        let possiblySent = false;
+        try {
+            preflight = await this.read(context.isCurrent, invalid);
+            if (!preflight ||
+                !Object.hasOwn(preflight.raw, 'tag') ||
+                !(preflight.raw.tag === null || typeof preflight.raw.tag === 'string') ||
+                !context.isCurrent() ||
+                (typeof action === 'object' &&
+                    'tilt' in action &&
+                    (typeof preflight.raw.slat_pos !== 'number' ||
+                        !Number.isFinite(preflight.raw.slat_pos) ||
+                        preflight.raw.slat_pos < 0 ||
+                        preflight.raw.slat_pos > 100)))
+                return false;
+            const token = await this.ordering.reserve(this.physicalIdentity);
+            reservation = token;
+            if (!token)
+                return false;
+            if (!context.isCurrent()) {
+                await this.ordering.settle(this.physicalIdentity, token);
+                return false;
+            }
+            this.uncertain = true;
+            const result = await this.rpc.withSendGuard(() => context.isCurrent() && this.identityIsCurrent(), () => this.rpc.request(`Cover.${typeof action === 'object' ? 'GoToPosition' : action === 'open' ? 'Open' : action === 'close' ? 'Close' : 'Stop'}`, {
+                id: this.componentId,
+                ...(typeof action === 'object'
+                    ? 'position' in action
+                        ? { pos: action.position }
+                        : { slat_pos: action.tilt }
+                    : {}),
+                tag: context.tag,
+            }), () => {
+                possiblySent = true;
+            });
+            if (result !== null)
+                return false;
+            await this.ordering.settle(this.physicalIdentity, token);
+            this.uncertain = false;
+            if (!context.isCurrent())
+                return false;
+            context.accepted();
+        }
+        catch {
+            return false;
+        }
+        finally {
+            try {
+                if (reservation && !possiblySent) {
+                    await this.ordering.settle(this.physicalIdentity, reservation);
+                    this.uncertain = false;
+                }
+            }
+            finally {
+                this.submitting = false;
+            }
+        }
+        while (context.isCurrent() && this.identityIsCurrent()) {
+            try {
+                const status = await this.read(context.isCurrent, invalid);
+                if (!context.isCurrent())
+                    return false;
+                if (status && (await admit(status.raw, status.observedAt, preflight.raw.state)))
+                    return true;
+            }
+            catch {
+                return false;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+        return false;
+    }
+}
+exports.ShellyCoverSession = ShellyCoverSession;
+//# sourceMappingURL=shelly-cover-session.js.map

package/dist/plugins/devices-shelly-ng/services/shelly-cover-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shelly-cover-session.js","sourceRoot":"","sources":["../../../../src/plugins/devices-shelly-ng/services/shelly-cover-session.ts"],"names":[],"mappings":"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"}

package/dist/plugins/devices-shelly-ng/services/shelly-cover-telemetry.d.ts

@@ -0,0 +1,9 @@
+import { GuardedShellyRpcHandler } from './guarded-shelly-rpc';
+export declare function coverDeltaNeedsRefresh(raw: Record<string, unknown>, id: number): boolean;
+export declare class ShellyCoverTelemetry {
+    private readonly rpc;
+    private readonly emit;
+    private readonly pending;
+    constructor(rpc: GuardedShellyRpcHandler, emit: (key: string, raw: Record<string, unknown>, observedAt: Date, current: () => boolean, sourceCurrent: () => boolean) => void);
+    refresh(key: string, revision: number, current: () => boolean, latest: () => number): void;
+}