@trillboards/edge-sdk 0.2.3 → 0.2.6

package/dist/PairClient.d.ts

@@ -0,0 +1,106 @@
+import { type HttpPoster } from './AudienceAnalyzeClient';
+import type { EdgeAgentConfig, MosaicTile } from './config';
+/**
+ * PairClient — exchanges a short-TTL claim code for the connector's full
+ * config via `POST {apiBaseUrl}/v2/earner/cameras/pair`.
+ *
+ * This is the security conduit for the one-click installer: the device token
+ * is NEVER baked into the downloadable binary. Instead the operator generates
+ * a claim code in the portal (bound to the camera screens they just
+ * provisioned), the installer asks for that code once on first run, and this
+ * client trades it for `{ apiBaseUrl, cloudSensing, cameras: [{ screenId,
+ * deviceToken, rtspUrl? }] }` — which is written verbatim to
+ * trillboards.config.json.
+ *
+ * The claim code IS the credential, so the request carries NO device-token
+ * headers (mirrors the unauthenticated, rate-limited
+ * `POST /v2/mdm/enrollment/device` enrollment endpoint). Uses the same
+ * built-in-http poster as AudienceAnalyzeClient (no extra dep → survives
+ * bundling into a self-contained binary; trivially mockable in tests).
+ */
+export interface PairClientOptions {
+    /** Base URL, e.g. https://api.trillboards.com (no trailing slash needed). */
+    apiBaseUrl: string;
+    /** Request timeout in ms. Default: 30000. */
+    timeoutMs?: number;
+}
+export interface PairRequest {
+    /** The claim code from the portal (with or without the XXXX-XXXX dash). */
+    claimCode: string;
+    /** Stable per-host fingerprint, sent for correlation/audit. Optional. */
+    deviceFingerprint?: string;
+    /** Connector version string, for server-side compat checks. Optional. */
+    connectorVersion?: string;
+}
+/**
+ * The config the server returns for a valid claim code — exactly the shape the
+ * connector persists to trillboards.config.json and then runs `cloud-sense`
+ * against. `rtspUrl` is OPTIONAL per camera: the portal MAY deliver it
+ * (stored encrypted) or the operator enters it locally so credentials never
+ * leave the venue.
+ */
+export interface PairedConfig {
+    apiBaseUrl: string;
+    cloudSensing: {
+        enabled: true;
+        periodicIntervalMs?: number;
+        faceTriggeredIntervalMs?: number;
+        jpegQuality?: number;
+        feedStaggerMs?: number;
+        maxFeedStaggerMs?: number;
+        cameraHealthFailureGraceCount?: number;
+    };
+    cameras: Array<{
+        name: string;
+        screenId: string;
+        deviceToken: string;
+        rtspUrl?: string;
+        /**
+         * Mosaic tiling (carve one composite/quad RTSP into per-screen tiles).
+         * `id` marks a SOURCE feed (carries the rtspUrl); `sourceFeedId` points a
+         * tile at that source so it shares the single RTSP pull; `tile` is the crop
+         * rect (source pixels). All optional — absent for whole-frame feeds. These
+         * MUST survive pairing or a DVR-mosaic feed can't be split into N screens.
+         */
+        id?: string;
+        sourceFeedId?: string;
+        tile?: MosaicTile;
+        width?: number;
+        height?: number;
+        fps?: number;
+        transport?: 'tcp' | 'udp';
+    }>;
+}
+export interface PairResponse {
+    /** HTTP status code. */
+    statusCode: number;
+    /** Whether pairing succeeded (2xx with a usable config). */
+    ok: boolean;
+    /** The connector config to persist, when ok. */
+    config: PairedConfig | null;
+    /** Server error code/message when not ok (e.g. INVALID_CODE, EXPIRED_CODE). */
+    error?: string;
+    /** Raw response text. */
+    rawBody: string;
+}
+/** Normalize a user-entered claim code: strip spaces/dashes, upper-case. */
+export declare function normalizeClaimCode(code: string): string;
+export declare class PairClient {
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly poster;
+    constructor(options: PairClientOptions, poster?: HttpPoster);
+    /** The resolved POST URL (exposed for assertions / logging). */
+    getEndpoint(): string;
+    /** Exchange a claim code for the connector config. */
+    pair(request: PairRequest): Promise<PairResponse>;
+}
+/**
+ * Validate + shape the server payload into a PairedConfig. Accepts either the
+ * config at the top level or nested under `config`. Requires at least one
+ * camera with a screenId + deviceToken (rtspUrl optional — creds-local mode).
+ */
+export declare function extractPairedConfig(body: Record<string, unknown> | null): PairedConfig | null;
+/** Build the EdgeAgentConfig-compatible object written to disk after pairing. */
+export declare function pairedConfigToFile(config: PairedConfig): Partial<EdgeAgentConfig>;
+//# sourceMappingURL=PairClient.d.ts.map

package/dist/PairClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PairClient.d.ts","sourceRoot":"","sources":["../src/PairClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE;QACZ,OAAO,EAAE,IAAI,CAAC;QACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,6BAA6B,CAAC,EAAE,MAAM,CAAC;KACxC,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;;;WAMG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,UAAU;IAU3D,gEAAgE;IAChE,WAAW,IAAI,MAAM;IAIrB,sDAAsD;IAChD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAwDxD;AAoBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACnC,YAAY,GAAG,IAAI,CA8DrB;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBjF"}

package/dist/PairClient.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PairClient = void 0;
+exports.normalizeClaimCode = normalizeClaimCode;
+exports.extractPairedConfig = extractPairedConfig;
+exports.pairedConfigToFile = pairedConfigToFile;
+const AudienceAnalyzeClient_1 = require("./AudienceAnalyzeClient");
+/** Normalize a user-entered claim code: strip spaces/dashes, upper-case. */
+function normalizeClaimCode(code) {
+    return String(code || '')
+        .replace(/[\s-]+/g, '')
+        .toUpperCase();
+}
+class PairClient {
+    constructor(options, poster) {
+        if (!options.apiBaseUrl) {
+            throw new Error('apiBaseUrl is required for PairClient');
+        }
+        const base = options.apiBaseUrl.replace(/\/+$/, '');
+        this.endpoint = `${base}/v2/earner/cameras/pair`;
+        this.timeoutMs = options.timeoutMs ?? 30000;
+        this.poster = poster ?? AudienceAnalyzeClient_1.defaultHttpPoster;
+    }
+    /** The resolved POST URL (exposed for assertions / logging). */
+    getEndpoint() {
+        return this.endpoint;
+    }
+    /** Exchange a claim code for the connector config. */
+    async pair(request) {
+        const claimCode = normalizeClaimCode(request?.claimCode);
+        if (!claimCode) {
+            throw new Error('pair() requires a non-empty claimCode');
+        }
+        const payload = {
+            claimCode,
+            ...(request.deviceFingerprint ? { deviceFingerprint: request.deviceFingerprint } : {}),
+            ...(request.connectorVersion ? { connectorVersion: request.connectorVersion } : {}),
+        };
+        const result = await this.poster(this.endpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+            timeoutMs: this.timeoutMs,
+        }, JSON.stringify(payload));
+        let parsed = null;
+        try {
+            parsed = result.body ? JSON.parse(result.body) : null;
+        }
+        catch {
+            parsed = null;
+        }
+        const ok = result.statusCode >= 200 && result.statusCode < 300;
+        if (!ok) {
+            return {
+                statusCode: result.statusCode,
+                ok: false,
+                config: null,
+                error: (parsed && parsed.error) ||
+                    (parsed && parsed.message) ||
+                    `pair failed (HTTP ${result.statusCode})`,
+                rawBody: result.body,
+            };
+        }
+        const config = extractPairedConfig(parsed);
+        if (!config) {
+            return {
+                statusCode: result.statusCode,
+                ok: false,
+                config: null,
+                error: 'pair response did not contain a usable camera config',
+                rawBody: result.body,
+            };
+        }
+        return { statusCode: result.statusCode, ok: true, config, rawBody: result.body };
+    }
+}
+exports.PairClient = PairClient;
+/**
+ * Sanitize a mosaic tile rectangle (source pixels) → { x, y, w, h } with
+ * non-negative integer offsets + positive integer dimensions, or null when the
+ * shape is absent/invalid. Mirrors the server-side cameraClaimCodeService
+ * sanitizeTile so a malformed rect never reaches the connector's ffmpeg crop.
+ */
+function sanitizeTile(tile) {
+    if (!tile || typeof tile !== 'object')
+        return null;
+    const t = tile;
+    const x = Math.trunc(Number(t.x));
+    const y = Math.trunc(Number(t.y));
+    const w = Math.trunc(Number(t.w));
+    const h = Math.trunc(Number(t.h));
+    if (![x, y, w, h].every(Number.isFinite))
+        return null;
+    if (x < 0 || y < 0 || w <= 0 || h <= 0)
+        return null;
+    return { x, y, w, h };
+}
+/**
+ * Validate + shape the server payload into a PairedConfig. Accepts either the
+ * config at the top level or nested under `config`. Requires at least one
+ * camera with a screenId + deviceToken (rtspUrl optional — creds-local mode).
+ */
+function extractPairedConfig(body) {
+    if (!body)
+        return null;
+    const src = (body.config && typeof body.config === 'object'
+        ? body.config
+        : body);
+    const rawCameras = Array.isArray(src.cameras) ? src.cameras : [];
+    const cameras = rawCameras
+        .map((c) => (c && typeof c === 'object' ? c : null))
+        .filter((c) => !!c && !!c.screenId && !!c.deviceToken)
+        .map((c) => {
+        // Re-sanitize the tile defensively: the connector feeds these coords
+        // straight into the ffmpeg crop filter, so a malformed rect from any
+        // source must never reach it (mirrors the server-side sanitizeTile).
+        const tile = sanitizeTile(c.tile);
+        return {
+            name: String(c.name || c.screenId),
+            screenId: String(c.screenId),
+            deviceToken: String(c.deviceToken),
+            ...(c.rtspUrl ? { rtspUrl: String(c.rtspUrl) } : {}),
+            // Mosaic tiling: carry the source link + crop so a composite/quad feed
+            // can be carved into per-tile screens (config.ts resolveConfig groups
+            // tiles by sourceFeedId and inherits the source's single RTSP pull).
+            ...(c.id ? { id: String(c.id) } : {}),
+            ...(c.sourceFeedId ? { sourceFeedId: String(c.sourceFeedId) } : {}),
+            ...(tile ? { tile } : {}),
+            ...(typeof c.width === 'number' ? { width: c.width } : {}),
+            ...(typeof c.height === 'number' ? { height: c.height } : {}),
+            ...(typeof c.fps === 'number' ? { fps: c.fps } : {}),
+            ...(c.transport === 'udp' || c.transport === 'tcp'
+                ? { transport: c.transport }
+                : {}),
+        };
+    });
+    if (cameras.length === 0)
+        return null;
+    const cs = (src.cloudSensing && typeof src.cloudSensing === 'object'
+        ? src.cloudSensing
+        : {});
+    return {
+        apiBaseUrl: String(src.apiBaseUrl || 'https://api.trillboards.com'),
+        cloudSensing: {
+            enabled: true,
+            ...(typeof cs.periodicIntervalMs === 'number'
+                ? { periodicIntervalMs: cs.periodicIntervalMs }
+                : {}),
+            ...(typeof cs.faceTriggeredIntervalMs === 'number'
+                ? { faceTriggeredIntervalMs: cs.faceTriggeredIntervalMs }
+                : {}),
+            ...(typeof cs.jpegQuality === 'number' ? { jpegQuality: cs.jpegQuality } : {}),
+            ...(typeof cs.feedStaggerMs === 'number' ? { feedStaggerMs: cs.feedStaggerMs } : {}),
+            ...(typeof cs.maxFeedStaggerMs === 'number'
+                ? { maxFeedStaggerMs: cs.maxFeedStaggerMs }
+                : {}),
+            ...(typeof cs.cameraHealthFailureGraceCount === 'number'
+                ? { cameraHealthFailureGraceCount: cs.cameraHealthFailureGraceCount }
+                : {}),
+        },
+        cameras,
+    };
+}
+/** Build the EdgeAgentConfig-compatible object written to disk after pairing. */
+function pairedConfigToFile(config) {
+    return {
+        apiBaseUrl: config.apiBaseUrl,
+        cloudSensing: config.cloudSensing,
+        cameras: config.cameras.map((c) => ({
+            name: c.name,
+            screenId: c.screenId,
+            deviceToken: c.deviceToken,
+            rtspUrl: c.rtspUrl || '',
+            // Mosaic tiling — persist the source link + crop so loadConfig/resolveConfig
+            // can reconstitute the tile feeds (a tile inherits its source's rtspUrl via
+            // the id→rtspUrl map). A tile's own rtspUrl stays '' (inherited on load).
+            ...(c.id ? { id: c.id } : {}),
+            ...(c.sourceFeedId ? { sourceFeedId: c.sourceFeedId } : {}),
+            ...(c.tile ? { tile: c.tile } : {}),
+            ...(c.width ? { width: c.width } : {}),
+            ...(c.height ? { height: c.height } : {}),
+            ...(c.fps ? { fps: c.fps } : {}),
+            ...(c.transport ? { transport: c.transport } : {}),
+        })),
+    };
+}
+//# sourceMappingURL=PairClient.js.map

package/dist/PairClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PairClient.js","sourceRoot":"","sources":["../src/PairClient.ts"],"names":[],"mappings":"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"}

package/dist/RecorderAddressRecovery.d.ts

@@ -0,0 +1,53 @@
+import type { EdgeAgentConfig, CameraFeedConfig } from './config';
+import type { ResolvedFeed } from './CloudSensingManager';
+import { discoverOnvifHosts, sweepLanForRecorders, type OnvifHost } from './discovery';
+export interface RecorderAddressRecoveryOptions {
+    configPath?: string;
+    log?: (message: string) => void;
+    cooldownMs?: number;
+    now?: () => number;
+    discover?: typeof discoverOnvifHosts;
+    sweep?: typeof sweepLanForRecorders;
+    validateStream?: (url: string, feed: CameraFeedConfig) => Promise<boolean>;
+    matchSerial?: (candidate: OnvifHost, expectedSerial: string, credentials: {
+        username: string;
+        password: string;
+    }) => Promise<boolean>;
+    lookupMac?: (host: string) => Promise<string | null>;
+}
+export declare function normalizeMacAddress(value: string): string | null;
+/** Read one already-contacted LAN host from the operating system's neighbor table. */
+export declare function lookupMacAddress(host: string): Promise<string | null>;
+/** Replace only the host, preserving credentials, port, path, query, and RTSPS. */
+export declare function rewriteStreamHost(streamUrl: string, host: string): string;
+export declare function shouldAttemptRecorderAddressRecovery(error: unknown): boolean;
+/**
+ * Finds a recorder again after DHCP changes its address.
+ *
+ * Recovery is deliberately conservative: the MAC address must match before
+ * credentials are used. An ONVIF serial is then verified when setup captured
+ * one; otherwise an existing channel recipe validates the matched recorder.
+ * Credentials are never tried against an unmatched LAN device.
+ */
+export declare class RecorderAddressRecovery {
+    private readonly groups;
+    private readonly currentHost;
+    private readonly inFlight;
+    private readonly lastFailedAt;
+    private readonly configPath?;
+    private readonly log;
+    private readonly cooldownMs;
+    private readonly now;
+    private readonly discover;
+    private readonly sweep;
+    private readonly validateStream;
+    private readonly matchSerial;
+    private readonly lookupMac;
+    constructor(config: EdgeAgentConfig, options?: RecorderAddressRecoveryOptions);
+    canRecover(feed: ResolvedFeed): boolean;
+    recover(feed: ResolvedFeed, currentUrl: string, error: unknown): Promise<string | null>;
+    private findCurrentHost;
+    private updateGroupUrls;
+    private persistGroupUrls;
+}
+//# sourceMappingURL=RecorderAddressRecovery.d.ts.map

package/dist/RecorderAddressRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecorderAddressRecovery.d.ts","sourceRoot":"","sources":["../src/RecorderAddressRecovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAoB,MAAM,UAAU,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAavF,MAAM,WAAW,8BAA8B;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,WAAW,CAAC,EAAE,CACZ,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAChD,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE;AAaD,sFAAsF;AACtF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoB3E;AA4BD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG5E;AAuCD;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4D;IAC3F,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6D;IACzF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2D;gBAEzE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,8BAAmC;IA4BjF,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAMjC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAwC/E,eAAe;IAmD7B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;CAuCzB"}