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

package/dist/plugins/devices-virtual/services/thermostat-installation.service.js

@@ -0,0 +1,263 @@
+"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.ThermostatInstallationService = void 0;
+exports.resolveInstallationSetup = resolveInstallationSetup;
+const typeorm_1 = require("typeorm");
+const common_1 = require("@nestjs/common");
+const devices_exceptions_1 = require("../../../modules/devices/devices.exceptions");
+const device_structure_lock_service_1 = require("../../../modules/devices/services/device-structure-lock.service");
+const thermostat_installation_entity_1 = require("../entities/thermostat-installation.entity");
+const thermostat_installation_artifact_1 = require("./thermostat-installation-artifact");
+const thermostat_installation_bindings_service_1 = require("./thermostat-installation-bindings.service");
+const virtual_numeric_transform_utils_1 = require("./virtual-numeric-transform.utils");
+const virtual_thermostat_claims_service_1 = require("./virtual-thermostat-claims.service");
+const virtual_thermostat_runtime_service_1 = require("./virtual-thermostat-runtime.service");
+let ThermostatInstallationService = class ThermostatInstallationService {
+    constructor(dataSource, lock, bindings, claims, runtime) {
+        this.dataSource = dataSource;
+        this.lock = lock;
+        this.bindings = bindings;
+        this.claims = claims;
+        this.runtime = runtime;
+    }
+    async stage(claimId, expectedRevision, setup, attestations, actorId, authoringFence) {
+        const release = this.beginMutation(claimId);
+        try {
+            await this.lock.runExclusive(async () => {
+                const binding = await this.bindings.resolve(this.dataSource.manager, claimId);
+                if (authoringFence &&
+                    ((authoringFence.configurationRevision !== undefined &&
+                        authoringFence.configurationRevision !== binding.config.revision) ||
+                        (authoringFence.claimRevision !== undefined && authoringFence.claimRevision !== binding.claim.revision) ||
+                        ('qualificationGeneration' in authoringFence &&
+                            authoringFence.qualificationGeneration !== binding.claim.qualificationGeneration)))
+                    throw new common_1.ConflictException('Reviewed configuration, claim or recovery generation changed; reload installation context.');
+                const resolvedSetup = resolveInstallationSetup(setup, binding);
+                (0, thermostat_installation_artifact_1.validateThermostatInstallation)(resolvedSetup, attestations, binding);
+                const prior = await this.dataSource.manager.findOneBy(thermostat_installation_entity_1.ThermostatInstallationEntity, { claimId });
+                if (!Number.isSafeInteger(expectedRevision) ||
+                    expectedRevision < 0 ||
+                    (prior?.revision ?? 0) !== expectedRevision)
+                    throw new common_1.ConflictException('Installation change rejected; prior stored profile and activation remain unchanged. Reload the current revision and retry.');
+                this.invalidate(binding.claim.physicalIdentity, binding.claim.controllerId);
+                await this.dataSource.transaction(async (manager) => {
+                    const row = manager.create(thermostat_installation_entity_1.ThermostatInstallationEntity, {
+                        claimId,
+                        revision: expectedRevision + 1,
+                        controllerId: binding.claim.controllerId,
+                        physicalIdentity: binding.claim.physicalIdentity,
+                        claimRevision: binding.claim.revision,
+                        configurationRevision: binding.config.revision,
+                        bindingFingerprint: binding.fingerprint,
+                        setup: resolvedSetup,
+                        attestations,
+                        updatedBy: actorId,
+                        updatedAt: new Date(),
+                        revokedAt: null,
+                        armedAt: null,
+                        lastMachineObservation: null,
+                    });
+                    const artifact = (0, thermostat_installation_artifact_1.thermostatInstallationArtifact)(row, binding);
+                    row.expectedScriptHash = artifact.sourceHash;
+                    row.artifactSource = artifact.source;
+                    if (prior) {
+                        const result = await manager.update(thermostat_installation_entity_1.ThermostatInstallationEntity, { claimId, revision: expectedRevision }, row);
+                        if (result.affected !== 1)
+                            throw new common_1.ConflictException('Installation change rejected; prior stored profile and activation remain unchanged. Reload the current revision and retry.');
+                    }
+                    else
+                        await manager.insert(thermostat_installation_entity_1.ThermostatInstallationEntity, row);
+                    await manager.save(thermostat_installation_entity_1.ThermostatInstallationAuditEntity, manager.create(thermostat_installation_entity_1.ThermostatInstallationAuditEntity, {
+                        claimId,
+                        revision: row.revision,
+                        action: 'staged',
+                        actorId,
+                        occurredAt: new Date(),
+                        snapshot: {
+                            setup: resolvedSetup,
+                            attestations,
+                            bindingFingerprint: binding.fingerprint,
+                            expectedScriptHash: row.expectedScriptHash,
+                        },
+                    }));
+                });
+            });
+        }
+        finally {
+            release();
+            await this.claims.refresh().catch(() => undefined);
+        }
+    }
+    async revoke(claimId, expectedRevision, actorId) {
+        const release = this.beginMutation(claimId);
+        try {
+            await this.lock.runExclusive(async () => {
+                const row = await this.dataSource.manager.findOneByOrFail(thermostat_installation_entity_1.ThermostatInstallationEntity, { claimId });
+                if (row.revision !== expectedRevision)
+                    throw new common_1.ConflictException('Installation change rejected; prior stored profile and activation remain unchanged. Reload the current revision and retry.');
+                this.invalidate(row.physicalIdentity, row.controllerId);
+                await this.dataSource.transaction(async (manager) => {
+                    const result = await manager.update(thermostat_installation_entity_1.ThermostatInstallationEntity, { claimId, revision: expectedRevision }, {
+                        revision: expectedRevision + 1,
+                        revokedAt: new Date(),
+                        armedAt: null,
+                        updatedAt: new Date(),
+                        updatedBy: actorId,
+                        lastMachineObservation: null,
+                    });
+                    if (result.affected !== 1)
+                        throw new common_1.ConflictException('Installation change rejected; prior stored profile and activation remain unchanged. Reload the current revision and retry.');
+                    await manager.save(thermostat_installation_entity_1.ThermostatInstallationAuditEntity, manager.create(thermostat_installation_entity_1.ThermostatInstallationAuditEntity, {
+                        claimId,
+                        revision: expectedRevision + 1,
+                        action: 'revoked',
+                        actorId,
+                        occurredAt: new Date(),
+                        snapshot: {
+                            setup: row.setup,
+                            attestations: row.attestations,
+                            bindingFingerprint: row.bindingFingerprint,
+                        },
+                    }));
+                });
+            });
+        }
+        finally {
+            release();
+            await this.claims.refresh().catch(() => undefined);
+        }
+    }
+    beginMutation(claimId) {
+        const release = this.claims.holdRecoveryFence();
+        this.claims.revokeAllQualifications();
+        this.onChanging?.(claimId);
+        this.runtime.fenceMember?.(claimId);
+        return release;
+    }
+    invalidate(identity, controllerId) {
+        this.claims.revokeQualification(identity);
+        void this.runtime.request(controllerId);
+    }
+    async inspect(claimId) {
+        const row = await this.dataSource.manager.findOneBy(thermostat_installation_entity_1.ThermostatInstallationEntity, { claimId });
+        if (!row)
+            throw new common_1.NotFoundException('No installation profile; stage equipment details first.');
+        const reasons = [];
+        try {
+            const binding = await this.bindings.resolve(this.dataSource.manager, claimId);
+            if (binding.fingerprint !== row.bindingFingerprint || binding.claim.revision !== row.claimRevision)
+                reasons.push('installation_bindings_changed');
+            (0, thermostat_installation_artifact_1.validateThermostatInstallation)(row.setup, row.attestations, binding);
+            reasons.push(...(0, thermostat_installation_artifact_1.installationAttestationReasons)(row, binding.opposed));
+            const artifact = (0, thermostat_installation_artifact_1.thermostatInstallationArtifact)(row, binding);
+            if (artifact.sourceHash !== row.expectedScriptHash)
+                reasons.push('reviewed_artifact_version_changed');
+            if (!this.claims.qualification(binding.claim, binding.opposed))
+                reasons.push('current_machine_verification_missing');
+        }
+        catch (error) {
+            reasons.push(error instanceof Error ? error.message : 'installation_bindings_unavailable');
+        }
+        if (row.revokedAt)
+            reasons.push('installation_revoked');
+        if (!row.armedAt)
+            reasons.push('operator_activation_required');
+        else if (this.isActivationPaused?.(claimId))
+            reasons.push('stored_activation_paused_reload_and_retry_failed_change_or_explicitly_verify');
+        return {
+            claim: row.claimId,
+            revision: row.revision,
+            activation_requested: row.armedAt !== null,
+            setup: row.setup,
+            operator_attestations: row.attestations,
+            machine_observation: row.lastMachineObservation,
+            physical_safety_certified: false,
+            readiness: reasons.length ? 'blocked' : 'metadata_verified_runtime_fence_required',
+            reasons,
+            artifact: row.artifactSource,
+            source_hash: row.expectedScriptHash,
+            audit: await this.dataSource.manager.find(thermostat_installation_entity_1.ThermostatInstallationAuditEntity, {
+                where: { claimId },
+                order: { occurredAt: 'DESC' },
+                take: 100,
+            }),
+        };
+    }
+};
+exports.ThermostatInstallationService = ThermostatInstallationService;
+exports.ThermostatInstallationService = ThermostatInstallationService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource,
+        device_structure_lock_service_1.DeviceStructureLockService,
+        thermostat_installation_bindings_service_1.ThermostatInstallationBindingsService,
+        virtual_thermostat_claims_service_1.VirtualThermostatClaimsService,
+        virtual_thermostat_runtime_service_1.VirtualThermostatRuntimeService])
+], ThermostatInstallationService);
+function resolveInstallationSetup(setup, binding) {
+    if (!binding.memberProtection) {
+        if (setup.formatVersion !== undefined)
+            throw new devices_exceptions_1.DevicesValidationException('Member format requires explicit protection adoption.');
+        return setup;
+    }
+    if (setup.formatVersion !== 2 || !binding.protectionSource?.metadata.installationSnapshot)
+        throw new devices_exceptions_1.DevicesValidationException('Explicit member format and current complete source catalog snapshot required.');
+    const allowed = [
+        'formatVersion',
+        'installedFloorCeilingC',
+        'deviceHardwareId',
+        'firmware',
+        'endpointHostname',
+        'scriptId',
+        'epochKey',
+        'heatingSetpointRange',
+        'coolingSetpointRange',
+        'minimumLeaseSeconds',
+        'maximumLeaseSeconds',
+        'watchdogMs',
+        'switchConfigurationJson',
+    ];
+    if (Object.keys(setup).some((key) => !allowed.includes(key)))
+        throw new devices_exceptions_1.DevicesValidationException('Member installation sensor metadata is derived, not authored.');
+    const source = binding.protectionSource;
+    const [component, id] = source.metadata.componentKey.split(':');
+    if (!['temperature', 'input', 'voltmeter'].includes(component))
+        throw new devices_exceptions_1.DevicesValidationException('Unsupported floor component.');
+    const candidate = source.transform?.policy;
+    const policy = candidate?.operator === virtual_numeric_transform_utils_1.VirtualNumericTransformOperator.STEINHART_HART ? candidate : null;
+    return {
+        ...setup,
+        floorDomainC: source.domain,
+        effectiveFloorCutoffC: Math.min(binding.config.policy.floor.limit, setup.installedFloorCeilingC),
+        floorMaximumAgeMs: binding.floorMaximumAgeMs,
+        floorComponentType: component,
+        floorComponentId: Number(id),
+        floorAttribute: source.leaf.identifier,
+        floorConfigurationJson: JSON.stringify(source.metadata.installationSnapshot.configuration),
+        peripheralsJson: JSON.stringify(source.metadata.installationSnapshot.peripherals),
+        ...(policy
+            ? {
+                floorConversion: {
+                    kind: 'steinhart_hart',
+                    referenceVoltage: policy.referenceVoltage,
+                    seriesResistance: policy.seriesResistance,
+                    a: policy.coefficientA,
+                    b: policy.coefficientB,
+                    c: policy.coefficientC,
+                    thermistorLeg: policy.thermistorLeg,
+                    inputRange: policy.inputRange,
+                    outputRange: policy.outputRange,
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=thermostat-installation.service.js.map

package/dist/plugins/devices-virtual/services/thermostat-installation.service.js.map

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

package/dist/plugins/devices-virtual/services/thermostat-installation.types.d.ts

@@ -0,0 +1,72 @@
+export declare const THERMOSTAT_ATTESTATION_KINDS: readonly ["commissioning_barrier", "writer_isolation", "restart_drain", "local_execution_bounds", "endpoint_authentication", "independent_protection", "opposed_interlock"];
+export type ThermostatAttestationKind = (typeof THERMOSTAT_ATTESTATION_KINDS)[number];
+export interface ThermostatOperatorAttestation {
+    kind: ThermostatAttestationKind;
+    equipment: string;
+    procedure: string;
+    evidenceReference: string;
+    testedAt: string;
+    maximumObservedMs?: number;
+}
+export interface ThermostatGuardSetup {
+    formatVersion?: 2;
+    installedFloorCeilingC?: number;
+    effectiveFloorCutoffC?: number;
+    floorDomainC?: {
+        minimum: number;
+        maximum: number;
+    };
+    deviceHardwareId: string;
+    firmware: string;
+    endpointHostname: string;
+    scriptId: number;
+    epochKey: string;
+    heatingSetpointRange: {
+        minimum: number;
+        maximum: number;
+    } | null;
+    coolingSetpointRange: {
+        minimum: number;
+        maximum: number;
+    } | null;
+    minimumLeaseSeconds: number;
+    maximumLeaseSeconds: number;
+    watchdogMs: number;
+    floorMaximumAgeMs: number;
+    floorComponentType: 'temperature' | 'voltmeter' | 'input';
+    floorComponentId: number;
+    floorAttribute: 'tC' | 'xvoltage' | 'xpercent' | 'voltage';
+    floorConfigurationJson: string;
+    switchConfigurationJson: string;
+    peripheralsJson: string;
+    floorConversion?: {
+        kind: 'steinhart_hart';
+        referenceVoltage: number;
+        seriesResistance: number;
+        a: number;
+        b: number;
+        c: number;
+        thermistorLeg: 'low' | 'high';
+        inputRange: {
+            minimum: number;
+            maximum: number;
+        };
+        outputRange: {
+            minimum: number;
+            maximum: number;
+        };
+    };
+}
+export interface ThermostatMachineObservation {
+    observedAt: string;
+    configurationRevision?: number;
+    state: 'verified_metadata' | 'blocked';
+    reasons: string[];
+    scriptHash?: string;
+    firmware?: string;
+    physicalSafetyCertified: false;
+}
+export type ThermostatMemberGuardSetup = Pick<ThermostatGuardSetup, 'deviceHardwareId' | 'firmware' | 'endpointHostname' | 'scriptId' | 'epochKey' | 'heatingSetpointRange' | 'coolingSetpointRange' | 'minimumLeaseSeconds' | 'maximumLeaseSeconds' | 'watchdogMs' | 'switchConfigurationJson'> & {
+    formatVersion: 2;
+    installedFloorCeilingC: number;
+};

package/dist/plugins/devices-virtual/services/thermostat-installation.types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THERMOSTAT_ATTESTATION_KINDS = void 0;
+exports.THERMOSTAT_ATTESTATION_KINDS = [
+    'commissioning_barrier',
+    'writer_isolation',
+    'restart_drain',
+    'local_execution_bounds',
+    'endpoint_authentication',
+    'independent_protection',
+    'opposed_interlock',
+];
+//# sourceMappingURL=thermostat-installation.types.js.map

package/dist/plugins/devices-virtual/services/thermostat-installation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thermostat-installation.types.js","sourceRoot":"","sources":["../../../../src/plugins/devices-virtual/services/thermostat-installation.types.ts"],"names":[],"mappings":";;;AAAa,QAAA,4BAA4B,GAAG;IAC3C,uBAAuB;IACvB,kBAAkB;IAClB,eAAe;IACf,wBAAwB;IACxB,yBAAyB;IACzB,wBAAwB;IACxB,mBAAmB;CACV,CAAC"}

package/dist/plugins/devices-virtual/services/thermostat-member-protection.service.d.ts

@@ -0,0 +1,45 @@
+import { DataSource } from 'typeorm';
+import { PropertyValueService } from '../../../modules/devices/services/property-value.service';
+import { ThermostatMemberProtectionEntity } from '../entities/thermostat-member-protection.entity';
+import { VirtualThermostatActuatorClaimEntity, VirtualThermostatConfigEntity } from '../entities/virtual-thermostat.entity';
+import { ThermostatProtectionSource } from './thermostat-protection-source.utils';
+export interface ThermostatMemberProtectionBinding {
+    claimId: string;
+    binding: ThermostatMemberProtectionEntity | null;
+    source: ThermostatProtectionSource | null;
+    cutoff: number | null;
+    hysteresis: number | null;
+    basis: string;
+}
+export interface ThermostatMemberProtectionDiagnostic {
+    claim: string;
+    source_property: string | null;
+    source_identity: string | null;
+    physical_property: string | null;
+    maximum_age_seconds: number | null;
+    status: 'fresh' | 'stale' | 'missing' | 'incompatible' | 'unavailable';
+    quality: 'good' | 'degraded' | 'unavailable';
+    expires_at: string | null;
+    temperature: number | null;
+    sampled_at: string | null;
+    age_seconds: number | null;
+    effective_cutoff: number | null;
+    latched: boolean;
+    ready: boolean;
+    reasons: string[];
+}
+export declare class ThermostatMemberProtectionService {
+    private readonly dataSource;
+    private readonly values;
+    private readonly latches;
+    private boundary;
+    private readonly controllerClaims;
+    private readonly dependencies;
+    constructor(dataSource: DataSource, values: PropertyValueService);
+    reset(): void;
+    invalidateSource(propertyId: string): void;
+    requiredReleaseAfter(bindings: ThermostatMemberProtectionBinding[]): number | null;
+    acknowledgeRelease(bindings: ThermostatMemberProtectionBinding[], now: number): void;
+    load(config: VirtualThermostatConfigEntity, claims: VirtualThermostatActuatorClaimEntity[]): Promise<ThermostatMemberProtectionBinding[]>;
+    read(bindings: ThermostatMemberProtectionBinding[], now: number): ThermostatMemberProtectionDiagnostic[];
+}

package/dist/plugins/devices-virtual/services/thermostat-member-protection.service.js

@@ -0,0 +1,235 @@
+"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.ThermostatMemberProtectionService = void 0;
+const typeorm_1 = require("typeorm");
+const common_1 = require("@nestjs/common");
+const property_value_service_1 = require("../../../modules/devices/services/property-value.service");
+const thermostat_installation_entity_1 = require("../entities/thermostat-installation.entity");
+const thermostat_member_protection_entity_1 = require("../entities/thermostat-member-protection.entity");
+const thermostat_protection_source_utils_1 = require("./thermostat-protection-source.utils");
+const virtual_thermostat_contract_utils_1 = require("./virtual-thermostat-contract.utils");
+let ThermostatMemberProtectionService = class ThermostatMemberProtectionService {
+    constructor(dataSource, values) {
+        this.dataSource = dataSource;
+        this.values = values;
+        this.latches = new Map();
+        this.boundary = Date.now();
+        this.controllerClaims = new Map();
+        this.dependencies = new Map();
+    }
+    reset() {
+        this.latches.clear();
+        this.dependencies.clear();
+        this.controllerClaims.clear();
+        this.boundary = Date.now();
+    }
+    invalidateSource(propertyId) {
+        for (const claimId of this.dependencies.get(propertyId) ?? []) {
+            const state = this.latches.get(claimId);
+            if (state) {
+                state.latched = true;
+                state.after = Date.now();
+                state.releaseAfter = state.after;
+                state.expires = 0;
+            }
+        }
+    }
+    requiredReleaseAfter(bindings) {
+        const barriers = bindings
+            .map((entry) => this.latches.get(entry.claimId)?.releaseAfter)
+            .filter((time) => time != null);
+        return barriers.length ? Math.max(...barriers) : null;
+    }
+    acknowledgeRelease(bindings, now) {
+        for (const entry of bindings) {
+            const state = this.latches.get(entry.claimId);
+            if (state?.basis === entry.basis && state.releaseAfter !== null) {
+                state.releaseAfter = null;
+                state.after = Math.max(state.after, now);
+            }
+        }
+    }
+    async load(config, claims) {
+        const result = [];
+        const activeIds = new Set(claims.map((claim) => claim.id));
+        const oldIds = this.controllerClaims.get(config.controllerId) ?? new Set();
+        for (const id of oldIds)
+            if (!activeIds.has(id))
+                this.latches.delete(id);
+        for (const [property, ids] of this.dependencies) {
+            for (const id of oldIds)
+                ids.delete(id);
+            if (!ids.size)
+                this.dependencies.delete(property);
+        }
+        this.controllerClaims.set(config.controllerId, activeIds);
+        const heating = claims.filter((claim) => claim.role === 'heating');
+        for (const claim of heating) {
+            const binding = await this.dataSource.manager.findOneBy(thermostat_member_protection_entity_1.ThermostatMemberProtectionEntity, { claimId: claim.id });
+            if (!binding && heating.length === 1)
+                continue;
+            let source = null;
+            try {
+                if (binding?.sourcePropertyId)
+                    source = await (0, thermostat_protection_source_utils_1.resolveThermostatProtectionSource)(this.dataSource.manager, binding.sourcePropertyId, claim.physicalIdentity);
+                if (source?.fingerprint !== binding?.contractFingerprint)
+                    source = null;
+            }
+            catch {
+                source = null;
+            }
+            for (const id of new Set([binding?.sourcePropertyIdentity, binding?.physicalPropertyIdentity].filter(Boolean))) {
+                const consumers = this.dependencies.get(id) ?? new Set();
+                consumers.add(claim.id);
+                this.dependencies.set(id, consumers);
+            }
+            const installation = binding && (await this.dataSource.manager.findOneBy(thermostat_installation_entity_1.ThermostatInstallationEntity, { claimId: claim.id }));
+            const ceiling = installation?.setup.formatVersion === 2 ? installation.setup.installedFloorCeilingC : null;
+            const cutoff = config.policy.floor && Number.isFinite(ceiling) ? Math.min(config.policy.floor.limit, ceiling) : null;
+            const hysteresis = config.policy.floor?.recoveryHysteresis ?? null;
+            result.push({
+                claimId: claim.id,
+                binding,
+                source,
+                cutoff,
+                hysteresis,
+                basis: (0, virtual_thermostat_contract_utils_1.thermostatFingerprint)({
+                    binding,
+                    source: source?.fingerprint,
+                    cutoff,
+                    hysteresis,
+                    config: config.revision,
+                    claim: claim.revision,
+                    generation: claim.qualificationGeneration,
+                    installation: installation?.revision,
+                }),
+            });
+        }
+        return result;
+    }
+    read(bindings, now) {
+        return bindings.map((entry) => {
+            const { binding, source, cutoff, hysteresis } = entry;
+            let state = this.latches.get(entry.claimId);
+            if (!state || state.basis !== entry.basis) {
+                state = {
+                    basis: entry.basis,
+                    latched: true,
+                    after: Math.max(this.boundary, now),
+                    expires: 0,
+                    releaseAfter: Math.max(this.boundary, now),
+                };
+                this.latches.set(entry.claimId, state);
+            }
+            const freshness = source && binding
+                ? this.values.readSampleFreshness?.(source.property, binding.maximumAgeSeconds * 1000, new Date(now))
+                : null;
+            const sample = source?.enabled &&
+                binding &&
+                this.values.readQualifiedSample(source.property, binding.maximumAgeSeconds * 1000, new Date(now));
+            const leaf = source?.enabled &&
+                binding &&
+                this.values.readQualifiedSample(source.leaf, binding.maximumAgeSeconds * 1000, new Date(now));
+            const reasons = [];
+            if (!binding)
+                reasons.push('member_protection_required');
+            if (!source)
+                reasons.push('member_protection_source_incompatible');
+            if (!sample ||
+                !leaf ||
+                sample.quality !== 'good' ||
+                leaf.quality !== 'good' ||
+                (source?.transform && sample.revision !== source.transform.revision) ||
+                typeof sample.value !== 'number' ||
+                !Number.isFinite(sample.value) ||
+                (source && (sample.value < source.domain.minimum || sample.value > source.domain.maximum)))
+                reasons.push('member_protection_sample_unavailable');
+            if (cutoff === null ||
+                hysteresis === null ||
+                !source ||
+                !(0, thermostat_protection_source_utils_1.protectionBoundsValid)(source.domain, cutoff, hysteresis))
+                reasons.push('member_protection_profile_required');
+            if (state.sourceGuard?.() === false) {
+                state.releaseAfter = Math.max(state.after, now);
+                state.latched = true;
+                state.after = Math.max(state.after, now);
+                state.expires = 0;
+                state.sourceGuard = undefined;
+            }
+            const expired = state.expires > 0 && now >= state.expires;
+            if (expired) {
+                state.releaseAfter = state.releaseAfter ?? now;
+                state.latched = true;
+                state.after = Math.max(state.after, state.expires);
+                state.expires = 0;
+            }
+            if (reasons.length) {
+                if (!state.latched)
+                    state.releaseAfter = now;
+                state.latched = true;
+                state.after = Math.max(state.after, now);
+                state.expires = 0;
+            }
+            else {
+                state.sourceGuard = this.values.captureSampleSourceGuard(source.leaf);
+                const value = sample.value;
+                const observed = Math.min(sample.receivedAt.getTime(), leaf.receivedAt.getTime());
+                if (value >= cutoff) {
+                    if (!state.latched)
+                        state.releaseAfter = now;
+                    state.latched = true;
+                }
+                else if (state.releaseAfter === null && value < cutoff - hysteresis && observed > state.after)
+                    state.latched = false;
+                state.expires =
+                    Math.min(sample.sampledAt.getTime(), leaf.sampledAt.getTime(), sample.receivedAt.getTime(), leaf.receivedAt.getTime()) +
+                        binding.maximumAgeSeconds * 1000;
+            }
+            if (state.releaseAfter !== null)
+                reasons.push('member_floor_release_required');
+            if (state.latched)
+                reasons.push('member_floor_latched');
+            return {
+                claim: entry.claimId,
+                source_property: binding?.sourcePropertyId ?? null,
+                source_identity: binding?.sourcePropertyIdentity ?? null,
+                physical_property: binding?.physicalPropertyIdentity ?? null,
+                maximum_age_seconds: binding?.maximumAgeSeconds ?? null,
+                status: !binding
+                    ? 'missing'
+                    : !source
+                        ? 'incompatible'
+                        : freshness?.status === 'stale'
+                            ? 'stale'
+                            : sample
+                                ? 'fresh'
+                                : 'unavailable',
+                quality: sample?.quality ?? 'unavailable',
+                expires_at: freshness?.expires_at ?? null,
+                temperature: typeof sample?.value === 'number' ? sample.value : null,
+                sampled_at: sample?.sampledAt.toISOString() ?? freshness?.sampled_at ?? null,
+                age_seconds: sample ? (now - sample.sampledAt.getTime()) / 1000 : (freshness?.age_seconds ?? null),
+                effective_cutoff: cutoff,
+                latched: state.latched,
+                ready: reasons.length === 0,
+                reasons,
+            };
+        });
+    }
+};
+exports.ThermostatMemberProtectionService = ThermostatMemberProtectionService;
+exports.ThermostatMemberProtectionService = ThermostatMemberProtectionService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource,
+        property_value_service_1.PropertyValueService])
+], ThermostatMemberProtectionService);
+//# sourceMappingURL=thermostat-member-protection.service.js.map