@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/factories/index.js

@@ -0,0 +1,350 @@
+/**
+ * Device Factory Functions
+ * Create UniversalDevice instances with appropriate features
+ */
+import { UniversalDevice } from '../device/device.classes.device.js';
+import { ScanFeature } from '../features/feature.scan.js';
+import { PrintFeature } from '../features/feature.print.js';
+import { PlaybackFeature } from '../features/feature.playback.js';
+import { VolumeFeature } from '../features/feature.volume.js';
+import { PowerFeature } from '../features/feature.power.js';
+import { SnmpFeature } from '../features/feature.snmp.js';
+/**
+ * Create a scanner device (UniversalDevice with ScanFeature)
+ */
+export function createScanner(info, retryOptions) {
+    const protocol = info.protocol === 'ipp' ? 'escl' : info.protocol;
+    const isSecure = info.txtRecords['TLS'] === '1' || (protocol === 'escl' && info.port === 443);
+    // Parse capabilities from TXT records
+    const formats = parseScanFormats(info.txtRecords);
+    const resolutions = parseScanResolutions(info.txtRecords);
+    const colorModes = parseScanColorModes(info.txtRecords);
+    const sources = parseScanSources(info.txtRecords);
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        manufacturer: info.txtRecords['usb_MFG'] || info.txtRecords['mfg'],
+        model: info.txtRecords['usb_MDL'] || info.txtRecords['mdl'] || info.txtRecords['ty'],
+        retryOptions,
+    });
+    // Override the generated ID with discovery ID
+    device.id = info.id;
+    // Add scan feature
+    const scanFeature = new ScanFeature(device.getDeviceReference(), info.port, {
+        protocol: protocol,
+        secure: isSecure,
+        supportedFormats: formats,
+        supportedResolutions: resolutions,
+        supportedColorModes: colorModes,
+        supportedSources: sources,
+        hasAdf: sources.includes('adf') || sources.includes('adf-duplex'),
+        hasDuplex: sources.includes('adf-duplex'),
+    });
+    device.addFeature(scanFeature);
+    return device;
+}
+/**
+ * Create a printer device (UniversalDevice with PrintFeature)
+ */
+export function createPrinter(info, retryOptions) {
+    const ippPath = info.txtRecords['rp'] || info.txtRecords['rfo'] || '/ipp/print';
+    const uri = `ipp://${info.address}:${info.port}${ippPath.startsWith('/') ? '' : '/'}${ippPath}`;
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        manufacturer: info.txtRecords['usb_MFG'] || info.txtRecords['mfg'],
+        model: info.txtRecords['usb_MDL'] || info.txtRecords['mdl'] || info.txtRecords['ty'],
+        retryOptions,
+    });
+    // Override the generated ID with discovery ID
+    device.id = info.id;
+    // Add print feature
+    const printFeature = new PrintFeature(device.getDeviceReference(), info.port, {
+        protocol: 'ipp',
+        uri,
+        supportsColor: info.txtRecords['Color'] === 'T' || info.txtRecords['color'] === 'true',
+        supportsDuplex: info.txtRecords['Duplex'] === 'T' || info.txtRecords['duplex'] === 'true',
+    });
+    device.addFeature(printFeature);
+    return device;
+}
+/**
+ * Create an SNMP device (UniversalDevice with SnmpFeature)
+ */
+export function createSnmpDevice(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    // Override the generated ID with discovery ID
+    device.id = info.id;
+    // Add SNMP feature
+    const snmpFeature = new SnmpFeature(device.getDeviceReference(), info.port, {
+        community: info.community ?? 'public',
+    });
+    device.addFeature(snmpFeature);
+    return device;
+}
+/**
+ * Create a UPS device (UniversalDevice with PowerFeature)
+ */
+export function createUpsDevice(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    // Override the generated ID with discovery ID
+    device.id = info.id;
+    // Add power feature
+    const powerFeature = new PowerFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        upsName: info.upsName,
+        community: info.community,
+    });
+    device.addFeature(powerFeature);
+    return device;
+}
+/**
+ * Create a speaker device (UniversalDevice with PlaybackFeature and VolumeFeature)
+ */
+export function createSpeaker(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        model: info.modelName,
+        retryOptions,
+    });
+    // Override the generated ID with discovery ID
+    device.id = info.id;
+    // Add playback feature
+    const playbackFeature = new PlaybackFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        supportsQueue: info.protocol === 'sonos',
+        supportsSeek: info.protocol !== 'airplay',
+    });
+    device.addFeature(playbackFeature);
+    // Add volume feature
+    const volumeFeature = new VolumeFeature(device.getDeviceReference(), info.port, {
+        volumeProtocol: info.protocol,
+        minVolume: 0,
+        maxVolume: 100,
+        supportsMute: true,
+    });
+    device.addFeature(volumeFeature);
+    return device;
+}
+/**
+ * Create a DLNA renderer device (UniversalDevice with PlaybackFeature)
+ */
+export function createDlnaRenderer(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.friendlyName || info.name,
+        manufacturer: info.manufacturer,
+        model: info.modelName,
+        retryOptions,
+    });
+    // Override the generated ID with discovery ID
+    device.id = info.id;
+    // Add playback feature for DLNA
+    const playbackFeature = new PlaybackFeature(device.getDeviceReference(), info.port, {
+        protocol: 'dlna',
+        supportsQueue: false,
+        supportsSeek: true,
+    });
+    device.addFeature(playbackFeature);
+    // Add volume feature
+    const volumeFeature = new VolumeFeature(device.getDeviceReference(), info.port, {
+        volumeProtocol: 'dlna',
+        minVolume: 0,
+        maxVolume: 100,
+        supportsMute: true,
+    });
+    device.addFeature(volumeFeature);
+    return device;
+}
+// ============================================================================
+// Parsing Helpers
+// ============================================================================
+function parseScanFormats(txtRecords) {
+    const formats = [];
+    const pdl = txtRecords['pdl'] || txtRecords['DocumentFormat'] || '';
+    if (pdl.includes('jpeg') || pdl.includes('jpg'))
+        formats.push('jpeg');
+    if (pdl.includes('png'))
+        formats.push('png');
+    if (pdl.includes('pdf'))
+        formats.push('pdf');
+    if (pdl.includes('tiff'))
+        formats.push('tiff');
+    return formats.length > 0 ? formats : ['jpeg', 'png'];
+}
+function parseScanResolutions(txtRecords) {
+    const rs = txtRecords['rs'] || '';
+    const parts = rs.split(',').map((s) => parseInt(s.trim())).filter((n) => !isNaN(n) && n > 0);
+    return parts.length > 0 ? parts : [75, 150, 300, 600];
+}
+function parseScanColorModes(txtRecords) {
+    const cs = txtRecords['cs'] || txtRecords['ColorSpace'] || '';
+    const modes = [];
+    if (cs.includes('color') || cs.includes('RGB'))
+        modes.push('color');
+    if (cs.includes('gray') || cs.includes('grayscale'))
+        modes.push('grayscale');
+    if (cs.includes('binary') || cs.includes('bw'))
+        modes.push('blackwhite');
+    return modes.length > 0 ? modes : ['color', 'grayscale'];
+}
+function parseScanSources(txtRecords) {
+    const is = txtRecords['is'] || txtRecords['InputSource'] || '';
+    const sources = [];
+    if (is.includes('platen') || is.includes('flatbed') || is === '') {
+        sources.push('flatbed');
+    }
+    if (is.includes('adf') || is.includes('feeder')) {
+        sources.push('adf');
+    }
+    if (is.includes('duplex')) {
+        sources.push('adf-duplex');
+    }
+    return sources.length > 0 ? sources : ['flatbed'];
+}
+// ============================================================================
+// Smart Home Factories
+// ============================================================================
+import { SwitchFeature } from '../features/feature.switch.js';
+import { SensorFeature } from '../features/feature.sensor.js';
+import { LightFeature } from '../features/feature.light.js';
+import { CoverFeature } from '../features/feature.cover.js';
+import { LockFeature } from '../features/feature.lock.js';
+import { FanFeature } from '../features/feature.fan.js';
+import { ClimateFeature } from '../features/feature.climate.js';
+import { CameraFeature } from '../features/feature.camera.js';
+export function createSmartSwitch(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const switchFeature = new SwitchFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        deviceClass: info.deviceClass,
+    });
+    device.addFeature(switchFeature);
+    return device;
+}
+export function createSmartSensor(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const sensorFeature = new SensorFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        deviceClass: info.deviceClass,
+        stateClass: info.stateClass,
+        unit: info.unit,
+    });
+    device.addFeature(sensorFeature);
+    return device;
+}
+export function createSmartLight(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const lightFeature = new LightFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        capabilities: info.capabilities,
+    });
+    device.addFeature(lightFeature);
+    return device;
+}
+export function createSmartCover(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const coverFeature = new CoverFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        deviceClass: info.deviceClass,
+        capabilities: info.capabilities,
+    });
+    device.addFeature(coverFeature);
+    return device;
+}
+export function createSmartLock(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const lockFeature = new LockFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        supportsOpen: info.supportsOpen,
+    });
+    device.addFeature(lockFeature);
+    return device;
+}
+export function createSmartFan(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const fanFeature = new FanFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        capabilities: info.capabilities,
+    });
+    device.addFeature(fanFeature);
+    return device;
+}
+export function createSmartClimate(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const climateFeature = new ClimateFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        capabilities: info.capabilities,
+    });
+    device.addFeature(climateFeature);
+    return device;
+}
+export function createSmartCamera(info, retryOptions) {
+    const device = new UniversalDevice(info.address, info.port, {
+        name: info.name,
+        retryOptions,
+    });
+    device.id = info.id;
+    const cameraFeature = new CameraFeature(device.getDeviceReference(), info.port, {
+        protocol: info.protocol,
+        entityId: info.entityId,
+        protocolClient: info.protocolClient,
+        capabilities: info.capabilities,
+    });
+    device.addFeature(cameraFeature);
+    return device;
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export { 
+// Re-export device and feature types for convenience
+UniversalDevice, ScanFeature, PrintFeature, PlaybackFeature, VolumeFeature, PowerFeature, SnmpFeature, 
+// Smart home features
+SwitchFeature, SensorFeature, LightFeature, CoverFeature, LockFeature, FanFeature, ClimateFeature, CameraFeature, };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mYWN0b3JpZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxFQUFFLGVBQWUsRUFBNkIsTUFBTSxvQ0FBb0MsQ0FBQztBQUNoRyxPQUFPLEVBQUUsV0FBVyxFQUE0QixNQUFNLDZCQUE2QixDQUFDO0FBQ3BGLE9BQU8sRUFBRSxZQUFZLEVBQTZCLE1BQU0sOEJBQThCLENBQUM7QUFDdkYsT0FBTyxFQUFFLGVBQWUsRUFBZ0MsTUFBTSxpQ0FBaUMsQ0FBQztBQUNoRyxPQUFPLEVBQUUsYUFBYSxFQUE4QixNQUFNLCtCQUErQixDQUFDO0FBQzFGLE9BQU8sRUFBRSxZQUFZLEVBQTZCLE1BQU0sOEJBQThCLENBQUM7QUFDdkYsT0FBTyxFQUFFLFdBQVcsRUFBNEIsTUFBTSw2QkFBNkIsQ0FBQztBQXVCcEY7O0dBRUc7QUFDSCxNQUFNLFVBQVUsYUFBYSxDQUMzQixJQUEyQixFQUMzQixZQUE0QjtJQUU1QixNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsUUFBUSxLQUFLLEtBQUssQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDO0lBQ2xFLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxVQUFVLENBQUMsS0FBSyxDQUFDLEtBQUssR0FBRyxJQUFJLENBQUMsUUFBUSxLQUFLLE1BQU0sSUFBSSxJQUFJLENBQUMsSUFBSSxLQUFLLEdBQUcsQ0FBQyxDQUFDO0lBRTlGLHNDQUFzQztJQUN0QyxNQUFNLE9BQU8sR0FBRyxnQkFBZ0IsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDbEQsTUFBTSxXQUFXLEdBQUcsb0JBQW9CLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQzFELE1BQU0sVUFBVSxHQUFHLG1CQUFtQixDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsQ0FB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

package/dist_ts/features/feature.abstract.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Abstract Feature base class
+ * Features are composable capabilities that can be attached to devices
+ */
+import * as plugins from '../plugins.js';
+import type { TFeatureType, TFeatureState, IFeature, IFeatureInfo, IFeatureOptions } from '../interfaces/feature.interfaces.js';
+import type { IRetryOptions } from '../interfaces/index.js';
+/**
+ * Forward reference to Device to avoid circular dependency
+ * The actual Device class will set this reference
+ */
+export type TDeviceReference = {
+    id: string;
+    name: string;
+    address: string;
+    port: number;
+};
+/**
+ * Abstract base class for all features
+ * Provides common functionality for connection management, state tracking, and retry logic
+ */
+export declare abstract class Feature extends plugins.events.EventEmitter implements IFeature {
+    /**
+     * The feature type identifier
+     */
+    abstract readonly type: TFeatureType;
+    /**
+     * The protocol used by this feature
+     */
+    abstract readonly protocol: string;
+    /**
+     * The port used by this feature
+     */
+    protected _port: number;
+    /**
+     * Current feature state
+     */
+    protected _state: TFeatureState;
+    /**
+     * Last error encountered
+     */
+    protected _lastError?: Error;
+    /**
+     * Reference to the parent device
+     */
+    protected _device: TDeviceReference;
+    /**
+     * Retry configuration
+     */
+    protected _retryConfig: Required<IRetryOptions>;
+    /**
+     * Additional metadata from discovery
+     */
+    protected _metadata: Record<string, unknown>;
+    constructor(device: TDeviceReference, port: number, options?: IFeatureOptions);
+    /**
+     * Get the feature port
+     */
+    get port(): number;
+    /**
+     * Get the current feature state
+     */
+    get state(): TFeatureState;
+    /**
+     * Check if the feature is connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the last error
+     */
+    get lastError(): Error | undefined;
+    /**
+     * Get the device address
+     */
+    get address(): string;
+    /**
+     * Get the device ID
+     */
+    get deviceId(): string;
+    /**
+     * Connect to the feature endpoint
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the feature endpoint
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Perform the actual connection logic
+     * Implemented by each feature subclass
+     */
+    protected abstract doConnect(): Promise<void>;
+    /**
+     * Perform the actual disconnection logic
+     * Implemented by each feature subclass
+     */
+    protected abstract doDisconnect(): Promise<void>;
+    /**
+     * Get feature-specific info for serialization
+     */
+    abstract getFeatureInfo(): IFeatureInfo;
+    /**
+     * Set the feature state and emit change event
+     */
+    protected setState(state: TFeatureState): void;
+    /**
+     * Execute an operation with retry logic
+     */
+    protected withRetry<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * Get base feature info
+     */
+    protected getBaseFeatureInfo(): IFeatureInfo;
+    /**
+     * Clear error state
+     */
+    clearError(): void;
+}

package/dist_ts/features/feature.abstract.js

@@ -0,0 +1,172 @@
+/**
+ * Abstract Feature base class
+ * Features are composable capabilities that can be attached to devices
+ */
+import * as plugins from '../plugins.js';
+import { withRetry } from '../helpers/helpers.retry.js';
+/**
+ * Abstract base class for all features
+ * Provides common functionality for connection management, state tracking, and retry logic
+ */
+export class Feature extends plugins.events.EventEmitter {
+    /**
+     * The port used by this feature
+     */
+    _port;
+    /**
+     * Current feature state
+     */
+    _state = 'disconnected';
+    /**
+     * Last error encountered
+     */
+    _lastError;
+    /**
+     * Reference to the parent device
+     */
+    _device;
+    /**
+     * Retry configuration
+     */
+    _retryConfig;
+    /**
+     * Additional metadata from discovery
+     */
+    _metadata;
+    constructor(device, port, options) {
+        super();
+        this._device = device;
+        this._port = port;
+        this._metadata = options?.metadata ?? {};
+        // Setup retry config
+        const retryOpts = options?.retryOptions ?? {};
+        this._retryConfig = {
+            maxRetries: retryOpts.maxRetries ?? 3,
+            baseDelay: retryOpts.baseDelay ?? 1000,
+            maxDelay: retryOpts.maxDelay ?? 30000,
+            multiplier: retryOpts.multiplier ?? 2,
+            jitter: retryOpts.jitter ?? true,
+        };
+    }
+    // ============================================================================
+    // Public Properties
+    // ============================================================================
+    /**
+     * Get the feature port
+     */
+    get port() {
+        return this._port;
+    }
+    /**
+     * Get the current feature state
+     */
+    get state() {
+        return this._state;
+    }
+    /**
+     * Check if the feature is connected
+     */
+    get isConnected() {
+        return this._state === 'connected';
+    }
+    /**
+     * Get the last error
+     */
+    get lastError() {
+        return this._lastError;
+    }
+    /**
+     * Get the device address
+     */
+    get address() {
+        return this._device.address;
+    }
+    /**
+     * Get the device ID
+     */
+    get deviceId() {
+        return this._device.id;
+    }
+    // ============================================================================
+    // Connection Management
+    // ============================================================================
+    /**
+     * Connect to the feature endpoint
+     */
+    async connect() {
+        if (this._state === 'connected') {
+            return;
+        }
+        if (this._state === 'connecting') {
+            throw new Error(`Feature ${this.type} is already connecting`);
+        }
+        this.setState('connecting');
+        this._lastError = undefined;
+        try {
+            await this.withRetry(() => this.doConnect());
+            this.setState('connected');
+            this.emit('connected');
+        }
+        catch (error) {
+            this._lastError = error instanceof Error ? error : new Error(String(error));
+            this.setState('error');
+            this.emit('error', this._lastError);
+            throw this._lastError;
+        }
+    }
+    /**
+     * Disconnect from the feature endpoint
+     */
+    async disconnect() {
+        if (this._state === 'disconnected') {
+            return;
+        }
+        try {
+            await this.doDisconnect();
+        }
+        finally {
+            this.setState('disconnected');
+            this.emit('disconnected');
+        }
+    }
+    // ============================================================================
+    // Helper Methods
+    // ============================================================================
+    /**
+     * Set the feature state and emit change event
+     */
+    setState(state) {
+        if (this._state !== state) {
+            const oldState = this._state;
+            this._state = state;
+            this.emit('state:changed', { oldState, newState: state });
+        }
+    }
+    /**
+     * Execute an operation with retry logic
+     */
+    async withRetry(operation) {
+        return withRetry(operation, this._retryConfig);
+    }
+    /**
+     * Get base feature info
+     */
+    getBaseFeatureInfo() {
+        return {
+            type: this.type,
+            protocol: this.protocol,
+            port: this._port,
+            state: this._state,
+        };
+    }
+    /**
+     * Clear error state
+     */
+    clearError() {
+        this._lastError = undefined;
+        if (this._state === 'error') {
+            this.setState('disconnected');
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5hYnN0cmFjdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2ZlYXR1cmVzL2ZlYXR1cmUuYWJzdHJhY3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUM7QUFTekMsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBYXhEOzs7R0FHRztBQUNILE1BQU0sT0FBZ0IsT0FBUSxTQUFRLE9BQU8sQ0FBQyxNQUFNLENBQUMsWUFBWTtJQVcvRDs7T0FFRztJQUNPLEtBQUssQ0FBUztJQUV4Qjs7T0FFRztJQUNPLE1BQU0sR0FBa0IsY0FBYyxDQUFDO0lBRWpEOztPQUVHO0lBQ08sVUFBVSxDQUFTO0lBRTdCOztPQUVHO0lBQ08sT0FBTyxDQUFtQjtJQUVwQzs7T0FFRztJQUNPLFlBQVksQ0FBMEI7SUFFaEQ7O09BRUc7SUFDTyxTQUFTLENBQTBCO0lBRTdDLFlBQ0UsTUFBd0IsRUFDeEIsSUFBWSxFQUNaLE9BQXlCO1FBRXpCLEtBQUssRUFBRSxDQUFDO1FBQ1IsSUFBSSxDQUFDLE9BQU8sR0FBRyxNQUFNLENBQUM7UUFDdEIsSUFBSSxDQUFDLEtBQUssR0FBRyxJQUFJLENBQUM7UUFDbEIsSUFBSSxDQUFDLFNBQVMsR0FBRyxPQUFPLEVBQUUsUUFBUSxJQUFJLEVBQUUsQ0FBQztRQUV6QyxxQkFBcUI7UUFDckIsTUFBTSxTQUFTLEdBQUcsT0FBTyxFQUFFLFlBQVksSUFBSSxFQUFFLENBQUM7UUFDOUMsSUFBSSxDQUFDLFlBQVksR0FBRztZQUNsQixVQUFVLEVBQUUsU0FBUyxDQUFDLFVBQVUsSUFBSSxDQUFDO1lBQ3JDLFNBQVMsRUFBRSxTQUFTLENBQUMsU0FBUyxJQUFJLElBQUk7WUFDdEMsUUFBUSxFQUFFLFNBQVMsQ0FBQyxRQUFRLElBQUksS0FBSztZQUNyQyxVQUFVLEVBQUUsU0FBUyxDQUFDLFVBQVUsSUFBSSxD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