@quenty/nevermore-cli 4.42.0 → 4.42.1-canary.783.30683606415.0

package/dist/utils/watch/http-watch-registry.js

@@ -0,0 +1,262 @@
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * `WatchRegistry` over the Roblox Analytics Watch API.
+ *
+ * One `POST /v1/register/{lease}` per invocation. The endpoint is whatever URL
+ * `--watch` resolved to, so nothing here assumes a host, and the lease is
+ * already the last path segment of that URL.
+ *
+ * The endpoint takes no `Authorization` header — the GitHub token travels in
+ * `auth.github.token`, because the service holds it to dispatch with later
+ * rather than using it to authenticate this call.
+ */
+export class HttpWatchRegistry {
+    _registerUrl;
+    _timeoutMs;
+    _fetch;
+    constructor(options) {
+        this._registerUrl = options.registerUrl;
+        this._timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this._fetch = options.fetchImpl ?? fetch;
+    }
+    async registerAsync(request) {
+        const body = {
+            name: request.monitorName,
+            auth: {
+                github: {
+                    token: request.githubToken,
+                    repository: request.repository,
+                },
+                ...(request.robloxApiKey
+                    ? { robloxOpenCloud: { apiKey: request.robloxApiKey } }
+                    : {}),
+            },
+            watches: request.watches.map((watch) => ({
+                name: watch.name,
+                source: {
+                    type: watch.source.type,
+                    universeId: watch.source.universeId,
+                    placeId: watch.source.placeId,
+                    versionType: watch.source.versionType,
+                },
+                // The kind travels with the value or not at all. Without it the service
+                // ignores a baseline outright on the one transition it matters for —
+                // the first registration that supplies an Open Cloud key — and the 422
+                // that should catch a vocabulary mismatch can never fire.
+                ...(watch.baselineVersion == null
+                    ? {}
+                    : {
+                        baselineVersion: watch.baselineVersion,
+                        ...(watch.baselineVersionKind == null
+                            ? {}
+                            : { baselineVersionKind: watch.baselineVersionKind }),
+                    }),
+                action: watch.action,
+            })),
+            ...(request.cooldownSeconds == null
+                ? {}
+                : { cooldownSeconds: request.cooldownSeconds }),
+        };
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this._timeoutMs);
+        let response;
+        try {
+            response = await this._fetch(this._registerUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            if (controller.signal.aborted) {
+                throw new Error(`Watch registration timed out after ${this._timeoutMs}ms: ${this._registerUrl}`);
+            }
+            throw new Error(`Watch registration could not reach ${this._registerUrl}: ` +
+                (err instanceof Error ? err.message : String(err)));
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        const text = await _readTextAsync(response);
+        if (!response.ok) {
+            throw new Error(_describeFailure(response, text, request));
+        }
+        return _parseResult(text);
+    }
+    async triggerAsync(monitorId, credential, options = {}) {
+        const url = `${this._apiBase()}/v1/monitors/${encodeURIComponent(monitorId)}/trigger`;
+        const response = await this._fetchWithTimeoutAsync(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                // Unlike register, this endpoint authenticates the caller — the token
+                // is the identity, so it travels as a bearer rather than in the body.
+                Authorization: `Bearer ${credential}`,
+            },
+            body: JSON.stringify(options.watchName == null ? {} : { watchName: options.watchName }),
+        });
+        const text = await _readTextAsync(response);
+        if (!response.ok) {
+            const detail = _extractError(text);
+            throw new Error(`Forcing a dispatch failed (${response.status} ${response.statusText})` +
+                (detail ? `: ${detail}` : ''));
+        }
+        try {
+            const parsed = JSON.parse(text);
+            return { results: Array.isArray(parsed.results) ? parsed.results : [] };
+        }
+        catch {
+            return { results: [] };
+        }
+    }
+    /**
+     * The API root, recovered from the register URL.
+     *
+     * `--watch` names the register endpoint because that is the one a user has to
+     * type; every other call is derived from it. The lease-bearing
+     * `/v1/register/<lease>/` suffix is the documented shape, so trimming it is
+     * how a single flag reaches the rest of the API.
+     */
+    _apiBase() {
+        const marker = '/v1/register/';
+        const index = this._registerUrl.indexOf(marker);
+        if (index === -1) {
+            throw new Error(`Cannot derive the watch API root from "${this._registerUrl}" — ` +
+                `expected it to contain "${marker}".`);
+        }
+        return this._registerUrl.slice(0, index);
+    }
+    async _fetchWithTimeoutAsync(url, init) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this._timeoutMs);
+        try {
+            return await this._fetch(url, { ...init, signal: controller.signal });
+        }
+        catch (err) {
+            if (controller.signal.aborted) {
+                throw new Error(`Watch request timed out after ${this._timeoutMs}ms: ${url}`);
+            }
+            throw new Error(`Watch request could not reach ${url}: ` +
+                (err instanceof Error ? err.message : String(err)));
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+/**
+ * Turn a status code into something actionable. The API documents exactly what
+ * each failure means, and every one of them has a different fix — a generic
+ * "registration failed (403)" would send someone to the wrong place.
+ *
+ * The service's own message wins when it has one, since it knows specifics we
+ * can only guess at; ours is the fallback for a bare status. Only the remedy is
+ * always ours, and it is what the service never supplies.
+ */
+function _describeFailure(response, text, request) {
+    const detail = _extractError(text);
+    const compose = (fallback, remedy) => {
+        const head = detail || fallback;
+        return remedy ? `${head}\n${remedy}` : head;
+    };
+    switch (response.status) {
+        case 400:
+            return compose('The watch service rejected the registration as invalid.', 'This is a bug in how the CLI built the request — please report it.');
+        case 401:
+            return compose('GitHub rejected the dispatch token.', 'Set NEVERMORE_WATCH_TOKEN to a valid, unexpired token.');
+        case 403:
+            return compose(`The dispatch token cannot write to ${request.repository}.`, `The token needs "actions: write" on ${request.repository}.`);
+        case 409:
+            return compose(`Watch quota exceeded for ${request.repository}.`, 'Release monitors you no longer need, or let their leases expire.');
+        case 422: {
+            // 422 is the service's "your config cannot work" answer, and it covers
+            // several unrelated causes now — a missing workflow, an Open Cloud key
+            // without universe.place:read, a "saved" watch with no key, a baseline in
+            // the wrong vocabulary. Its own message names which, so the only thing
+            // worth adding is a remedy that could not already be in it.
+            const workflows = [
+                ...new Set(request.watches.flatMap((w) => w.action.type === 'github-workflow-dispatch'
+                    ? [w.action.workflow]
+                    : [])),
+            ];
+            // Volunteering a workflow remedy for a monitor that dispatches none once
+            // produced "Referenced: ." under a message about an API key scope.
+            if (workflows.length === 0) {
+                return compose('The watch service rejected the configuration.');
+            }
+            return compose(`A referenced workflow does not exist in ${request.repository}.`, `Workflows referenced: ${workflows.join(', ')}. A "watch" path in ` +
+                'deploy.nevermore.json must name a workflow that exists on the ' +
+                'dispatched ref.');
+        }
+        default:
+            return compose(`Watch registration failed (${response.status} ${response.statusText}).`);
+    }
+}
+/** Pull the API's `{error, errors}` shape out, falling back to raw text. */
+function _extractError(text) {
+    if (text === '') {
+        return '';
+    }
+    try {
+        const parsed = JSON.parse(text);
+        const parts = [];
+        if (typeof parsed.error === 'string') {
+            parts.push(parsed.error);
+        }
+        if (Array.isArray(parsed.errors) && parsed.errors.length > 0) {
+            parts.push(JSON.stringify(parsed.errors));
+        }
+        return parts.length > 0 ? parts.join(' ') : text;
+    }
+    catch {
+        return text;
+    }
+}
+async function _readTextAsync(response) {
+    try {
+        return (await response.text()).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Read back the fields worth reporting. A 2xx whose body we cannot parse still
+ * counts as registered — the service accepted it, and failing here would claim
+ * otherwise.
+ */
+function _parseResult(text) {
+    if (text === '') {
+        return {};
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        return {};
+    }
+    const record = parsed;
+    const result = {};
+    if (typeof record['monitorId'] === 'string') {
+        result.monitorId = record['monitorId'];
+    }
+    if (typeof record['revision'] === 'string') {
+        result.revision = record['revision'];
+    }
+    if (typeof record['leaseExpiresAt'] === 'string') {
+        result.leaseExpiresAt = record['leaseExpiresAt'];
+    }
+    if (typeof record['changed'] === 'boolean') {
+        result.changed = record['changed'];
+    }
+    if (Array.isArray(record['watches'])) {
+        result.watchCount = record['watches'].length;
+    }
+    return result;
+}
+//# sourceMappingURL=http-watch-registry.js.map

package/dist/utils/watch/http-watch-registry.js.map

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

package/dist/utils/watch/http-watch-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-watch-registry.test.d.ts.map

package/dist/utils/watch/http-watch-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-watch-registry.test.d.ts","sourceRoot":"","sources":["../../../src/utils/watch/http-watch-registry.test.ts"],"names":[],"mappings":""}

package/dist/utils/watch/http-watch-registry.test.js

@@ -0,0 +1,211 @@
+import { describe, it, expect } from 'vitest';
+import { HttpWatchRegistry } from './http-watch-registry.js';
+const REGISTER_URL = 'https://watch.example.com/v1/register/7d/';
+function makeRequest(overrides = {}) {
+    return {
+        monitorName: 'integration',
+        repository: 'Quenty/egg-hunt-2026',
+        githubToken: 'token-value',
+        watches: [
+            {
+                name: 'quenty/hub/hub',
+                source: {
+                    type: 'roblox-place',
+                    universeId: 10,
+                    placeId: 20,
+                    versionType: 'published',
+                },
+                baselineVersion: '158',
+                baselineVersionKind: 'roblox-place-version',
+                action: {
+                    type: 'github-workflow-dispatch',
+                    workflow: '.github/workflows/build.yml',
+                    ref: 'main',
+                    inputs: { target: 'integration.places.hub' },
+                },
+            },
+        ],
+        ...overrides,
+    };
+}
+function makeResponse(body, init = {}) {
+    return {
+        ok: (init.status ?? 200) < 400,
+        status: init.status ?? 200,
+        statusText: init.statusText ?? 'OK',
+        text: async () => body,
+    };
+}
+function registryReturning(response, calls) {
+    return new HttpWatchRegistry({
+        registerUrl: REGISTER_URL,
+        fetchImpl: (async (url, init) => {
+            calls?.push({ url, init });
+            return response;
+        }),
+    });
+}
+describe('HttpWatchRegistry', () => {
+    it('posts a MonitorRequest to the register URL', async () => {
+        const calls = [];
+        await registryReturning(makeResponse('{}'), calls).registerAsync(makeRequest());
+        expect(calls).toHaveLength(1);
+        expect(calls[0].url).toBe(REGISTER_URL);
+        expect(calls[0].init.method).toBe('POST');
+        expect(JSON.parse(calls[0].init.body)).toEqual({
+            name: 'integration',
+            auth: {
+                github: {
+                    token: 'token-value',
+                    repository: 'Quenty/egg-hunt-2026',
+                },
+            },
+            watches: [
+                {
+                    name: 'quenty/hub/hub',
+                    source: {
+                        type: 'roblox-place',
+                        universeId: 10,
+                        placeId: 20,
+                        versionType: 'published',
+                    },
+                    baselineVersion: '158',
+                    baselineVersionKind: 'roblox-place-version',
+                    action: {
+                        type: 'github-workflow-dispatch',
+                        workflow: '.github/workflows/build.yml',
+                        ref: 'main',
+                        inputs: { target: 'integration.places.hub' },
+                    },
+                },
+            ],
+        });
+    });
+    it('sends every watch in one request', async () => {
+        const calls = [];
+        const base = makeRequest();
+        await registryReturning(makeResponse('{}'), calls).registerAsync({
+            ...base,
+            watches: [base.watches[0], { ...base.watches[0], name: 'pkg/lobby' }],
+        });
+        expect(calls).toHaveLength(1);
+        expect(JSON.parse(calls[0].init.body).watches).toHaveLength(2);
+    });
+    it('omits the Open Cloud key unless one was shared', async () => {
+        const calls = [];
+        await registryReturning(makeResponse('{}'), calls).registerAsync(makeRequest());
+        expect(JSON.parse(calls[0].init.body).auth).not.toHaveProperty('robloxOpenCloud');
+    });
+    it('includes the Open Cloud key when shared', async () => {
+        const calls = [];
+        await registryReturning(makeResponse('{}'), calls).registerAsync(makeRequest({ robloxApiKey: 'oc-key' }));
+        expect(JSON.parse(calls[0].init.body).auth.robloxOpenCloud).toEqual({ apiKey: 'oc-key' });
+    });
+    // The kind describes the value, so sending it alone would declare the
+    // vocabulary of a baseline that is not there.
+    it('omits the declared kind along with the baseline', async () => {
+        const calls = [];
+        const base = makeRequest();
+        await registryReturning(makeResponse('{}'), calls).registerAsync({
+            ...base,
+            watches: [{ ...base.watches[0], baselineVersion: undefined }],
+        });
+        expect(JSON.parse(calls[0].init.body).watches[0]).not.toHaveProperty('baselineVersionKind');
+    });
+    it('omits baselineVersion when there is no baseline', async () => {
+        const calls = [];
+        const base = makeRequest();
+        await registryReturning(makeResponse('{}'), calls).registerAsync({
+            ...base,
+            watches: [{ ...base.watches[0], baselineVersion: undefined }],
+        });
+        expect(JSON.parse(calls[0].init.body).watches[0]).not.toHaveProperty('baselineVersion');
+    });
+    it('reads back the monitor the service reports', async () => {
+        const result = await registryReturning(makeResponse(JSON.stringify({
+            monitorId: 'mon_9f2a',
+            revision: 'abc123',
+            leaseExpiresAt: '2026-08-06T00:00:00Z',
+            changed: true,
+            watches: [{ name: 'a' }, { name: 'b' }],
+            unexpected: 'ignored',
+        }))).registerAsync(makeRequest());
+        expect(result).toEqual({
+            monitorId: 'mon_9f2a',
+            revision: 'abc123',
+            leaseExpiresAt: '2026-08-06T00:00:00Z',
+            changed: true,
+            watchCount: 2,
+        });
+    });
+    it('reports an unchanged re-apply', async () => {
+        const result = await registryReturning(makeResponse(JSON.stringify({ monitorId: 'mon_1', changed: false }))).registerAsync(makeRequest());
+        expect(result.changed).toBe(false);
+    });
+    it('treats a 2xx with an unusable body as registered without details', async () => {
+        expect(await registryReturning(makeResponse('not json')).registerAsync(makeRequest())).toEqual({});
+    });
+    describe('failure messages', () => {
+        it('leads with the service message and adds our remedy on 401', async () => {
+            await expect(registryReturning(makeResponse(JSON.stringify({ error: 'bad credentials' }), {
+                status: 401,
+                statusText: 'Unauthorized',
+            })).registerAsync(makeRequest())).rejects.toThrowError(/^bad credentials\nSet NEVERMORE_WATCH_TOKEN/);
+        });
+        it('falls back to our own wording when the service says nothing', async () => {
+            await expect(registryReturning(makeResponse('', { status: 401, statusText: 'Unauthorized' })).registerAsync(makeRequest())).rejects.toThrowError(/^GitHub rejected the dispatch token\./);
+        });
+        it('names the repository and required scope on 403', async () => {
+            await expect(registryReturning(makeResponse('', { status: 403, statusText: 'Forbidden' })).registerAsync(makeRequest())).rejects.toThrowError(/cannot write to Quenty\/egg-hunt-2026.*actions: write/s);
+        });
+        it('explains a quota failure on 409', async () => {
+            await expect(registryReturning(makeResponse('', { status: 409, statusText: 'Conflict' })).registerAsync(makeRequest())).rejects.toThrowError(/quota exceeded for Quenty\/egg-hunt-2026/);
+        });
+        it('lists the workflows it referenced on 422', async () => {
+            await expect(registryReturning(makeResponse('', { status: 422, statusText: 'Unprocessable Entity' })).registerAsync(makeRequest())).rejects.toThrowError(/workflow does not exist.*\.github\/workflows\/build\.yml/s);
+        });
+        // Observed against prod: a notify-only monitor was refused 422 because the
+        // Open Cloud key lacked a scope, and the reply appended "Referenced: ." plus
+        // advice about a workflow path — under a message that had nothing to do with
+        // workflows. 422 now covers several causes and the service names which.
+        it('adds no workflow advice when the monitor dispatches none', async () => {
+            const request = makeRequest();
+            request.watches = request.watches.map((watch) => ({
+                ...watch,
+                action: { type: 'notify', payload: { target: 'x' } },
+            }));
+            await expect(registryReturning(makeResponse(JSON.stringify({
+                error: 'The Open Cloud key is not allowed to read place 1 (403).',
+            }), { status: 422, statusText: 'Unprocessable Entity' })).registerAsync(request)).rejects.toThrowError(/not allowed to read place 1/);
+            await expect(registryReturning(makeResponse(JSON.stringify({ error: 'nope' }), {
+                status: 422,
+                statusText: 'Unprocessable Entity',
+            })).registerAsync(request)).rejects.not.toThrowError(/Referenced|workflow/);
+        });
+        it('surfaces the API error body', async () => {
+            await expect(registryReturning(makeResponse(JSON.stringify({ error: 'lease too long' }), {
+                status: 400,
+                statusText: 'Bad Request',
+            })).registerAsync(makeRequest())).rejects.toThrowError(/lease too long/);
+        });
+        it('includes the API validation detail list', async () => {
+            await expect(registryReturning(makeResponse(JSON.stringify({
+                error: "request/body must have required property 'name'",
+                errors: [{ path: '/body/name', errorCode: 'required' }],
+            }), { status: 400, statusText: 'Bad Request' })).registerAsync(makeRequest())).rejects.toThrowError(/\/body\/name/);
+        });
+        it('falls back to status text on an unmapped code', async () => {
+            await expect(registryReturning(makeResponse('', { status: 503, statusText: 'Service Unavailable' })).registerAsync(makeRequest())).rejects.toThrowError(/503 Service Unavailable/);
+        });
+        it('reports the endpoint when the request cannot be made', async () => {
+            const registry = new HttpWatchRegistry({
+                registerUrl: REGISTER_URL,
+                fetchImpl: (async () => {
+                    throw new Error('ENOTFOUND');
+                }),
+            });
+            await expect(registry.registerAsync(makeRequest())).rejects.toThrowError(/could not reach https:\/\/watch\.example\.com/);
+        });
+    });
+});
+//# sourceMappingURL=http-watch-registry.test.js.map

package/dist/utils/watch/http-watch-registry.test.js.map

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

package/dist/utils/watch/local-watch-loop.d.ts

@@ -0,0 +1,50 @@
+import { type BasePlaceVersionKeyword, type PlaceVersionSource } from '@quenty/nevermore-deploy';
+/** One base place being watched, and what to rebuild when it moves. */
+export interface LocalWatchEntry {
+    /** Human label for output, e.g. `integration.places.hub`. */
+    label: string;
+    universeId: number;
+    placeId: number;
+    versionType: BasePlaceVersionKeyword;
+    /**
+     * Version this entry was last built from. Undefined means "adopt whatever
+     * the first poll sees", which avoids a rebuild on startup for a place that
+     * has never been locked.
+     */
+    baseline?: number;
+}
+export interface LocalWatchLoopOptions {
+    entries: LocalWatchEntry[];
+    source: PlaceVersionSource;
+    /** Stop watching after this long. */
+    durationMs: number;
+    pollIntervalMs?: number;
+    /** Rebuild and redeploy. Errors are reported and the loop continues. */
+    redeployAsync: (entry: LocalWatchEntry, version: number) => Promise<void>;
+    /** Lets a caller stop the loop; SIGINT is wired to one by default. */
+    signal?: AbortSignal;
+    /** Injected in tests. */
+    now?: () => number;
+    sleepAsync?: (ms: number, signal: AbortSignal) => Promise<void>;
+}
+export interface LocalWatchLoopResult {
+    /** Rebuilds that completed. */
+    redeploys: number;
+    /** Rebuilds that were attempted and threw. */
+    failures: number;
+    /** True when the duration ran out rather than the user interrupting. */
+    expired: boolean;
+}
+/**
+ * Poll base places and redeploy in-process when one moves.
+ *
+ * This is what `--watch` does outside CI. Registering with the watch service
+ * would be pointless on a laptop: the service's only action is dispatching a
+ * GitHub workflow, which would rebuild on a runner rather than here — so a
+ * local run keeps the loop in the terminal, where the developer can see it.
+ *
+ * Poll failures never end the loop. A watch is meant to be left running for
+ * hours, and a dropped connection is not a reason to stop watching.
+ */
+export declare function runLocalWatchLoopAsync(options: LocalWatchLoopOptions): Promise<LocalWatchLoopResult>;
+//# sourceMappingURL=local-watch-loop.d.ts.map

package/dist/utils/watch/local-watch-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-watch-loop.d.ts","sourceRoot":"","sources":["../../../src/utils/watch/local-watch-loop.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAKlC,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,uBAAuB,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAgH/B"}