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

package/dist/modules/devices/services/property-command-admission.registry.service.js

@@ -0,0 +1,70 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyCommandAdmissionRegistryService = void 0;
+const common_1 = require("@nestjs/common");
+let PropertyCommandAdmissionRegistryService = class PropertyCommandAdmissionRegistryService {
+    constructor() {
+        this.guards = new Set();
+        this.revision = 0;
+    }
+    register(guard) {
+        if (!this.guards.has(guard))
+            this.revision++;
+        this.guards.add(guard);
+        return () => {
+            if (this.guards.delete(guard))
+                this.revision++;
+        };
+    }
+    hasGuards() {
+        return this.guards.size > 0;
+    }
+    requiresGuardedDispatch(update) {
+        return [...this.guards].some((guard) => guard.requiresGuardedDispatch?.(update));
+    }
+    capture() {
+        const guards = [...this.guards];
+        const snapshots = guards.map((guard) => guard.capture?.());
+        const revision = this.revision;
+        const hasCurrentMembership = () => revision === this.revision;
+        const effectsCurrent = (effect) => hasCurrentMembership() &&
+            guards.every((guard, index) => (snapshots[index] ?? guard).isEffectCurrent?.(effect) === true);
+        return {
+            isEffectCurrent: effectsCurrent,
+            assertEffectAllowed: async (effect) => {
+                if (!effectsCurrent(effect))
+                    throw new Error('Cover effect admission changed or is unsupported');
+                for (const [index, guard] of guards.entries()) {
+                    const policy = snapshots[index] ?? guard;
+                    if (!policy.assertEffectAllowed)
+                        throw new Error('Guard does not support cover effect admission');
+                    await policy.assertEffectAllowed(effect);
+                }
+            },
+            isCurrent: (update) => hasCurrentMembership() && snapshots.every((snapshot) => snapshot?.isCurrent(update) ?? true),
+            isRequestCurrent: () => hasCurrentMembership() &&
+                snapshots.every((snapshot) => snapshot?.isRequestCurrent?.() ?? snapshot?.isCurrent() ?? true),
+            assertAllowed: async (update) => {
+                if (!hasCurrentMembership())
+                    throw new Error('Command admission guard membership changed');
+                for (const [index, guard] of guards.entries())
+                    await (snapshots[index] ?? guard).assertAllowed(update);
+            },
+        };
+    }
+    async assertAllowed(update) {
+        for (const guard of this.guards)
+            await guard.assertAllowed(update);
+    }
+};
+exports.PropertyCommandAdmissionRegistryService = PropertyCommandAdmissionRegistryService;
+exports.PropertyCommandAdmissionRegistryService = PropertyCommandAdmissionRegistryService = __decorate([
+    (0, common_1.Injectable)()
+], PropertyCommandAdmissionRegistryService);
+//# sourceMappingURL=property-command-admission.registry.service.js.map

package/dist/modules/devices/services/property-command-admission.registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-command-admission.registry.service.js","sourceRoot":"","sources":["../../../../src/modules/devices/services/property-command-admission.registry.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/devices/services/property-command-dispatch.service.d.ts

@@ -1,24 +1,36 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { EventEmitter2 } from '@nestjs/event-emitter';
 import { PropertyValueState } from '../models/property-value-state.model';
 import { IDevicePropertyData } from '../platforms/device.platform';
 import { ChannelsService } from './channels.service';
 import { CommandLatencyTraceCollectorService } from './command-latency-trace-collector.service';
+import { CompositeCommandOutcome, CompositePropertyCommandRegistryService } from './composite-property-command.registry.service';
 import { DeviceStructureLockService } from './device-structure-lock.service';
 import { DevicesService } from './devices.service';
 import { PlatformRegistryService } from './platform.registry.service';
+import { PropertyCommandAdmissionRegistryService } from './property-command-admission.registry.service';
+import { PropertyCommandEntrySnapshot } from './property-command-entry-snapshot';
 import { PropertyCommandWindowHandle, PropertyCommandWindowService } from './property-command-window.service';
 import { PropertyMetadataService } from './property-metadata.service';
 import { PropertyStateCoordinatorService } from './property-state-coordinator.service';
 import { PropertyValueSourceRegistryService } from './property-value-source.registry.service';
 import { PropertyValueService } from './property-value.service';
+export declare const COMPOSITE_INTENT_FINISH_MARGIN_MS = 100;
 export interface PropertyCommandDispatchOptions {
     readonly intentId?: string;
+    readonly requestId?: string;
+    readonly commandEntry?: PropertyCommandEntrySnapshot;
+    readonly isRequestCurrent?: () => boolean;
     readonly ttlMs?: number;
+    readonly deadlineAt?: number;
+    readonly requiresLiveEvidence?: boolean;
     readonly prepared?: boolean;
     readonly windowHandles?: readonly PropertyCommandWindowHandle[];
 }
 export interface PropertyCommandDispatchResult {
     readonly success: boolean;
     readonly reason?: string;
+    readonly composite?: CompositeCommandOutcome;
 }
 export interface PreparedApiPropertyCommand {
     readonly handle: PropertyCommandWindowHandle;
@@ -26,7 +38,7 @@ export interface PreparedApiPropertyCommand {
     readonly baseline: PropertyValueState | null;
     readonly optimisticEligible: boolean;
 }
-export declare class PropertyCommandDispatchService {
+export declare class PropertyCommandDispatchService implements OnModuleDestroy {
     private readonly propertyMetadata;
     private readonly propertyValues;
     private readonly channelsService;
@@ -37,8 +49,22 @@ export declare class PropertyCommandDispatchService {
     private readonly propertyStateCoordinator;
     private readonly commandWindowService;
     private readonly commandLatencyTraceCollector;
-    constructor(propertyMetadata: PropertyMetadataService, propertyValues: PropertyValueService, channelsService: ChannelsService, devicesService: DevicesService, platformRegistryService: PlatformRegistryService, valueSourceRegistry: PropertyValueSourceRegistryService, structureLock: DeviceStructureLockService, propertyStateCoordinator: PropertyStateCoordinatorService, commandWindowService: PropertyCommandWindowService, commandLatencyTraceCollector?: CommandLatencyTraceCollectorService);
+    private readonly composites?;
+    private readonly events?;
+    private readonly admissionGuards?;
+    private readonly eventEpoch;
+    private eventSequence;
+    private disposed;
+    private activeComposites;
+    private readonly compositeCleanups;
+    onModuleDestroy(): void;
+    constructor(propertyMetadata: PropertyMetadataService, propertyValues: PropertyValueService, channelsService: ChannelsService, devicesService: DevicesService, platformRegistryService: PlatformRegistryService, valueSourceRegistry: PropertyValueSourceRegistryService, structureLock: DeviceStructureLockService, propertyStateCoordinator: PropertyStateCoordinatorService, commandWindowService: PropertyCommandWindowService, commandLatencyTraceCollector?: CommandLatencyTraceCollectorService, composites?: CompositePropertyCommandRegistryService, events?: EventEmitter2, admissionGuards?: PropertyCommandAdmissionRegistryService);
     dispatchBatch(updates: readonly IDevicePropertyData[], options?: PropertyCommandDispatchOptions): Promise<PropertyCommandDispatchResult>;
+    private canonicalOrdinaryUpdates;
+    private dispatchComposite;
+    private executeComposite;
+    private dispatchPreparedComposite;
+    private withCompositeDeadline;
     prepareApiCommand(update: IDevicePropertyData, ttlMs: number): Promise<PreparedApiPropertyCommand | null>;
     private admitWindows;
     private createAdmission;