@salesforce/b2c-tooling-sdk 1.1.0 → 1.3.0

package/dist/esm/operations/debug/debug-session.js

@@ -0,0 +1,219 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Debug session manager for the SDAPI.
+ *
+ * Manages the debugger lifecycle, polls for halted threads, and sends periodic
+ * keepalive resets to prevent the 60-second halt timeout. State changes are
+ * communicated via callbacks.
+ *
+ * @module operations/debug/debug-session
+ */
+import { getLogger } from '../../logging/logger.js';
+import { SdapiClient, SdapiError } from './sdapi-client.js';
+const DEFAULT_POLL_INTERVAL = 500;
+const DEFAULT_KEEPALIVE_INTERVAL = 15_000;
+export class DebugSessionManager {
+    client;
+    config;
+    callbacks;
+    logger = getLogger();
+    pollTimer;
+    keepaliveTimer;
+    /** Last known thread states keyed by thread id */
+    knownThreads = new Map();
+    connected = false;
+    constructor(config, callbacks = {}) {
+        this.config = config;
+        this.callbacks = callbacks;
+        this.client = new SdapiClient({
+            hostname: config.hostname,
+            username: config.username,
+            password: config.password,
+            clientId: config.clientId,
+        });
+    }
+    /**
+     * Connect to the debugger: enable the client, start polling and keepalive.
+     */
+    async connect() {
+        this.logger.debug({ hostname: this.config.hostname }, 'Connecting to script debugger');
+        // Take over any existing session (same pattern as Python reference)
+        try {
+            await this.client.deleteClient();
+        }
+        catch {
+            // Ignore — client may not exist yet
+        }
+        await this.client.createClient();
+        this.connected = true;
+        // Start keepalive timer
+        const keepaliveInterval = this.config.keepaliveInterval ?? DEFAULT_KEEPALIVE_INTERVAL;
+        this.keepaliveTimer = setInterval(() => void this.keepalive(), keepaliveInterval);
+        // Start thread poller
+        const pollInterval = this.config.pollInterval ?? DEFAULT_POLL_INTERVAL;
+        this.pollTimer = setInterval(() => void this.pollThreads(), pollInterval);
+        this.logger.debug('Script debugger connected');
+        this.callbacks.onConnected?.(this.config.hostname);
+    }
+    /**
+     * Disconnect: stop timers, delete client.
+     */
+    async disconnect() {
+        this.stopTimers();
+        if (this.connected) {
+            try {
+                await this.client.deleteClient();
+            }
+            catch (error) {
+                this.logger.warn({ error }, 'Error deleting debugger client during disconnect');
+            }
+            this.connected = false;
+        }
+        this.knownThreads.clear();
+        this.logger.debug('Script debugger disconnected');
+        this.callbacks.onDisconnected?.();
+    }
+    /**
+     * Set breakpoints (replaces all current breakpoints).
+     */
+    async setBreakpoints(breakpoints) {
+        await this.client.deleteBreakpoints();
+        if (breakpoints.length === 0)
+            return [];
+        return this.client.setBreakpoints(breakpoints);
+    }
+    /**
+     * Resume a halted thread.
+     */
+    async resume(threadId) {
+        await this.client.resume(threadId);
+    }
+    /**
+     * Step over (next line).
+     */
+    async stepOver(threadId) {
+        await this.client.stepOver(threadId);
+    }
+    /**
+     * Step into function.
+     */
+    async stepInto(threadId) {
+        await this.client.stepInto(threadId);
+    }
+    /**
+     * Step out of function.
+     */
+    async stepOut(threadId) {
+        await this.client.stepOut(threadId);
+    }
+    /**
+     * Get the current list of known threads (from last poll).
+     */
+    getKnownThreads() {
+        return [...this.knownThreads.values()];
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    stopTimers() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = undefined;
+        }
+        if (this.keepaliveTimer) {
+            clearInterval(this.keepaliveTimer);
+            this.keepaliveTimer = undefined;
+        }
+    }
+    async keepalive() {
+        try {
+            await this.client.resetThreads();
+        }
+        catch (error) {
+            this.logger.debug({ error }, 'Keepalive reset failed');
+        }
+    }
+    haltLocationChanged(prev, curr) {
+        const prevLoc = prev.call_stack?.[0]?.location;
+        const currLoc = curr.call_stack?.[0]?.location;
+        if (!prevLoc || !currLoc)
+            return prevLoc !== currLoc;
+        return prevLoc.script_path !== currLoc.script_path || prevLoc.line_number !== currLoc.line_number;
+    }
+    logThreadHalted(thread) {
+        const topFrame = thread.call_stack?.[0];
+        if (topFrame) {
+            const loc = topFrame.location;
+            const fn = loc.function_name || '<anonymous>';
+            this.logger.debug(`Thread ${thread.id} halted at ${loc.script_path}:${loc.line_number} (${fn})`);
+        }
+        else {
+            this.logger.debug(`Thread ${thread.id} halted`);
+        }
+    }
+    async pollThreads() {
+        try {
+            const threads = await this.client.getThreads();
+            const currentIds = new Set();
+            for (const thread of threads) {
+                currentIds.add(thread.id);
+                const previous = this.knownThreads.get(thread.id);
+                if (!previous) {
+                    // New thread appeared
+                    this.knownThreads.set(thread.id, thread);
+                    if (thread.status === 'halted') {
+                        this.logThreadHalted(thread);
+                        this.callbacks.onThreadStopped?.(thread);
+                    }
+                }
+                else if (previous.status !== thread.status) {
+                    // State changed
+                    this.knownThreads.set(thread.id, thread);
+                    if (thread.status === 'halted') {
+                        this.logThreadHalted(thread);
+                        this.callbacks.onThreadStopped?.(thread);
+                    }
+                    else {
+                        this.logger.debug(`Thread ${thread.id} resumed`);
+                        this.callbacks.onThreadContinued?.(thread.id);
+                    }
+                }
+                else if (thread.status === 'halted' && this.haltLocationChanged(previous, thread)) {
+                    // Still halted but at a different location (hit another breakpoint or stepped)
+                    this.knownThreads.set(thread.id, thread);
+                    this.logThreadHalted(thread);
+                    this.callbacks.onThreadStopped?.(thread);
+                }
+                else {
+                    this.knownThreads.set(thread.id, thread);
+                }
+            }
+            // Detect threads that disappeared
+            for (const [id] of this.knownThreads) {
+                if (!currentIds.has(id)) {
+                    this.knownThreads.delete(id);
+                    this.logger.debug(`Thread ${id} exited`);
+                    this.callbacks.onThreadExited?.(id);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof SdapiError && error.status === 412) {
+                // Debugger disabled — stop polling
+                this.logger.warn('Debugger was disabled externally');
+                this.stopTimers();
+                this.connected = false;
+                this.callbacks.onDebuggerDisabled?.();
+            }
+            else {
+                this.logger.debug({ error }, 'Thread poll error');
+                this.callbacks.onError?.(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+}
+//# sourceMappingURL=debug-session.js.map

package/dist/esm/operations/debug/debug-session.js.map

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

package/dist/esm/operations/debug/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * B2C Commerce Script Debugger operations.
+ *
+ * Provides the SDAPI client, debug session manager, DAP adapter, and supporting
+ * utilities for source mapping and variable reference management.
+ *
+ * @module operations/debug
+ */
+export { SdapiClient, SdapiError, createSdapiClient } from './sdapi-client.js';
+export type { SdapiClientConfig } from './sdapi-client.js';
+export { DebugSessionManager } from './debug-session.js';
+export { B2CScriptDebugAdapter } from './dap-adapter.js';
+export { createSourceMapper } from './source-mapping.js';
+export type { SourceMapper } from './source-mapping.js';
+export { VariableStore } from './variable-store.js';
+export type { VariableRef } from './variable-store.js';
+export type { SdapiLocation, SdapiStackFrame, SdapiScriptThread, SdapiBreakpoint, SdapiBreakpoints, SdapiObjectMember, SdapiObjectMembers, SdapiEvalResult, SdapiFault, BreakpointInput, DebugSessionConfig, DebugSessionCallbacks, } from './types.js';

package/dist/esm/operations/debug/index.js

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * B2C Commerce Script Debugger operations.
+ *
+ * Provides the SDAPI client, debug session manager, DAP adapter, and supporting
+ * utilities for source mapping and variable reference management.
+ *
+ * @module operations/debug
+ */
+export { SdapiClient, SdapiError, createSdapiClient } from './sdapi-client.js';
+export { DebugSessionManager } from './debug-session.js';
+export { B2CScriptDebugAdapter } from './dap-adapter.js';
+export { createSourceMapper } from './source-mapping.js';
+export { VariableStore } from './variable-store.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/operations/debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;GAOG;AACH,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAC,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAC,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC"}

package/dist/esm/operations/debug/sdapi-client.d.ts

@@ -0,0 +1,44 @@
+import type { SdapiBreakpoint, SdapiEvalResult, SdapiFault, SdapiObjectMembers, SdapiScriptThread, BreakpointInput } from './types.js';
+/**
+ * Error thrown when the SDAPI returns a fault response.
+ */
+export declare class SdapiError extends Error {
+    readonly fault: SdapiFault;
+    readonly status: number;
+    constructor(fault: SdapiFault, status: number);
+}
+export interface SdapiClientConfig {
+    hostname: string;
+    username: string;
+    password: string;
+    clientId?: string;
+}
+/**
+ * Creates a new SDAPI client.
+ */
+export declare function createSdapiClient(config: SdapiClientConfig): SdapiClient;
+export declare class SdapiClient {
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly logger;
+    constructor(config: SdapiClientConfig);
+    createClient(): Promise<void>;
+    deleteClient(): Promise<void>;
+    getBreakpoints(): Promise<SdapiBreakpoint[]>;
+    setBreakpoints(breakpoints: BreakpointInput[]): Promise<SdapiBreakpoint[]>;
+    deleteBreakpoints(): Promise<void>;
+    deleteBreakpoint(id: number): Promise<void>;
+    getThreads(): Promise<SdapiScriptThread[]>;
+    getThread(threadId: number): Promise<SdapiScriptThread>;
+    resetThreads(): Promise<void>;
+    resume(threadId: number): Promise<SdapiScriptThread>;
+    stepOver(threadId: number): Promise<SdapiScriptThread>;
+    stepInto(threadId: number): Promise<SdapiScriptThread>;
+    stepOut(threadId: number): Promise<SdapiScriptThread>;
+    stopThread(threadId: number): Promise<void>;
+    getVariables(threadId: number, frameIndex: number): Promise<SdapiObjectMembers>;
+    getMembers(threadId: number, frameIndex: number, objectPath?: string, start?: number, count?: number): Promise<SdapiObjectMembers>;
+    evaluate(threadId: number, frameIndex: number, expr: string): Promise<SdapiEvalResult>;
+    private request;
+    private throwSdapiError;
+}

package/dist/esm/operations/debug/sdapi-client.js

@@ -0,0 +1,169 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Stateless HTTP client for the B2C Commerce Script Debugger API (SDAPI 2.0).
+ *
+ * All methods use global `fetch()` with Basic auth and the required
+ * `x-dw-client-id` header. The client is stateless — callers are responsible
+ * for session lifecycle (create/delete client, polling, keepalive).
+ *
+ * @module operations/debug/sdapi-client
+ */
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Error thrown when the SDAPI returns a fault response.
+ */
+export class SdapiError extends Error {
+    fault;
+    status;
+    constructor(fault, status) {
+        super(`${fault.type}: ${fault.message}`);
+        this.name = 'SdapiError';
+        this.fault = fault;
+        this.status = status;
+    }
+}
+/**
+ * Creates a new SDAPI client.
+ */
+export function createSdapiClient(config) {
+    return new SdapiClient(config);
+}
+export class SdapiClient {
+    baseUrl;
+    headers;
+    logger = getLogger();
+    constructor(config) {
+        this.baseUrl = `https://${config.hostname}/s/-/dw/debugger/v2_0`;
+        const credentials = btoa(`${config.username}:${config.password}`);
+        this.headers = {
+            Authorization: `Basic ${credentials}`,
+            'x-dw-client-id': config.clientId ?? 'b2c-cli',
+            'Content-Type': 'application/json',
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Client resource (debugger lifecycle)
+    // -----------------------------------------------------------------------
+    async createClient() {
+        await this.request('POST', '/client', { expect204: true });
+    }
+    async deleteClient() {
+        await this.request('DELETE', '/client', { expect204: true });
+    }
+    // -----------------------------------------------------------------------
+    // Breakpoints
+    // -----------------------------------------------------------------------
+    async getBreakpoints() {
+        const data = await this.request('GET', '/breakpoints');
+        return data.breakpoints ?? [];
+    }
+    async setBreakpoints(breakpoints) {
+        const data = await this.request('POST', '/breakpoints', {
+            body: { breakpoints },
+        });
+        return data.breakpoints ?? [];
+    }
+    async deleteBreakpoints() {
+        await this.request('DELETE', '/breakpoints', { expect204: true });
+    }
+    async deleteBreakpoint(id) {
+        await this.request('DELETE', `/breakpoints/${id}`, { expect204: true });
+    }
+    // -----------------------------------------------------------------------
+    // Threads
+    // -----------------------------------------------------------------------
+    async getThreads() {
+        const data = await this.request('GET', '/threads');
+        return data.script_threads ?? [];
+    }
+    async getThread(threadId) {
+        return this.request('GET', `/threads/${threadId}`);
+    }
+    async resetThreads() {
+        await this.request('POST', '/threads/reset', { expect204: true });
+    }
+    // -----------------------------------------------------------------------
+    // Execution control
+    // -----------------------------------------------------------------------
+    async resume(threadId) {
+        return this.request('POST', `/threads/${threadId}/resume`);
+    }
+    async stepOver(threadId) {
+        return this.request('POST', `/threads/${threadId}/over`);
+    }
+    async stepInto(threadId) {
+        return this.request('POST', `/threads/${threadId}/into`);
+    }
+    async stepOut(threadId) {
+        return this.request('POST', `/threads/${threadId}/out`);
+    }
+    async stopThread(threadId) {
+        await this.request('DELETE', `/threads/${threadId}/stop`, { expect204: true });
+    }
+    // -----------------------------------------------------------------------
+    // Variables & evaluation
+    // -----------------------------------------------------------------------
+    async getVariables(threadId, frameIndex) {
+        return this.request('GET', `/threads/${threadId}/frames/${frameIndex}/variables`);
+    }
+    async getMembers(threadId, frameIndex, objectPath, start, count) {
+        const params = new URLSearchParams();
+        if (objectPath)
+            params.set('object_path', objectPath);
+        if (start !== undefined)
+            params.set('start', String(start));
+        if (count !== undefined)
+            params.set('count', String(count));
+        const qs = params.toString();
+        const suffix = qs ? `?${qs}` : '';
+        return this.request('GET', `/threads/${threadId}/frames/${frameIndex}/members${suffix}`);
+    }
+    async evaluate(threadId, frameIndex, expr) {
+        const params = new URLSearchParams({ expr });
+        return this.request('GET', `/threads/${threadId}/frames/${frameIndex}/eval?${params.toString()}`);
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    async request(method, path, options) {
+        const url = `${this.baseUrl}${path}`;
+        this.logger.trace({ method, path }, 'SDAPI request');
+        const response = await fetch(url, {
+            method,
+            headers: this.headers,
+            body: options?.body ? JSON.stringify(options.body) : undefined,
+        });
+        if (options?.expect204) {
+            if (!response.ok) {
+                await this.throwSdapiError(response);
+            }
+            return undefined;
+        }
+        if (!response.ok) {
+            await this.throwSdapiError(response);
+        }
+        return (await response.json());
+    }
+    async throwSdapiError(response) {
+        let fault;
+        try {
+            const body = (await response.json());
+            // SDAPI may return fault at top level or nested under a "fault" property
+            const faultData = body.fault ?? body;
+            fault = {
+                _v: String(faultData._v ?? body._v ?? '2.0'),
+                type: String(faultData.type ?? 'UnknownError'),
+                message: String(faultData.message ?? `HTTP ${response.status} ${response.statusText}`),
+            };
+        }
+        catch {
+            fault = { _v: '2.0', type: 'UnknownError', message: `HTTP ${response.status} ${response.statusText}` };
+        }
+        throw new SdapiError(fault, response.status);
+    }
+}
+//# sourceMappingURL=sdapi-client.js.map

package/dist/esm/operations/debug/sdapi-client.js.map

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

package/dist/esm/operations/debug/source-mapping.d.ts

@@ -0,0 +1,13 @@
+import type { CartridgeMapping } from '../code/cartridges.js';
+export interface SourceMapper {
+    /** Convert a local filesystem path to an SDAPI script_path. */
+    toServerPath(localPath: string): string | undefined;
+    /** Convert an SDAPI script_path to a local filesystem path. */
+    toLocalPath(scriptPath: string): string | undefined;
+}
+/**
+ * Creates a SourceMapper from discovered cartridge mappings.
+ *
+ * @param cartridges - Array of cartridge mappings from `findCartridges()`
+ */
+export declare function createSourceMapper(cartridges: CartridgeMapping[]): SourceMapper;

package/dist/esm/operations/debug/source-mapping.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Maps local filesystem paths to SDAPI server script paths and vice-versa.
+ *
+ * SDAPI script paths are cartridge-relative, e.g. `/app_storefront/cartridge/controllers/Cart.js`.
+ * Local paths are absolute filesystem paths resolved from discovered cartridge directories.
+ *
+ * @module operations/debug/source-mapping
+ */
+import path from 'node:path';
+/**
+ * Creates a SourceMapper from discovered cartridge mappings.
+ *
+ * @param cartridges - Array of cartridge mappings from `findCartridges()`
+ */
+export function createSourceMapper(cartridges) {
+    // Pre-compute normalized cartridge source paths for fast comparison
+    const mappings = cartridges.map((c) => ({
+        name: c.name,
+        // Normalize and ensure trailing separator for prefix matching
+        srcPrefix: path.resolve(c.src) + path.sep,
+        src: path.resolve(c.src),
+    }));
+    // Index by cartridge name for fast server→local lookup
+    const byName = new Map(mappings.map((m) => [m.name, m]));
+    return {
+        toServerPath(localPath) {
+            const resolved = path.resolve(localPath);
+            for (const m of mappings) {
+                if (resolved.startsWith(m.srcPrefix) || resolved === m.src) {
+                    const relative = resolved.slice(m.srcPrefix.length);
+                    // SDAPI paths use forward slashes
+                    return `/${m.name}/${relative.split(path.sep).join('/')}`;
+                }
+            }
+            return undefined;
+        },
+        toLocalPath(scriptPath) {
+            // scriptPath format: /cartridge_name/rest/of/path.js
+            const withoutLeadingSlash = scriptPath.startsWith('/') ? scriptPath.slice(1) : scriptPath;
+            const slashIndex = withoutLeadingSlash.indexOf('/');
+            if (slashIndex === -1)
+                return undefined;
+            const cartridgeName = withoutLeadingSlash.slice(0, slashIndex);
+            const rest = withoutLeadingSlash.slice(slashIndex + 1);
+            const mapping = byName.get(cartridgeName);
+            if (!mapping)
+                return undefined;
+            return path.join(mapping.src, rest);
+        },
+    };
+}
+//# sourceMappingURL=source-mapping.js.map

package/dist/esm/operations/debug/source-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-mapping.js","sourceRoot":"","sources":["../../../../src/operations/debug/source-mapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;GAOG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA8B;IAC/D,oEAAoE;IACpE,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,8DAA8D;QAC9D,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG;QACzC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;KACzB,CAAC,CAAC,CAAC;IAEJ,uDAAuD;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,OAAO;QACL,YAAY,CAAC,SAAiB;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;oBAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;oBACpD,kCAAkC;oBAClC,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5D,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,WAAW,CAAC,UAAkB;YAC5B,qDAAqD;YACrD,MAAM,mBAAmB,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC1F,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,UAAU,KAAK,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC;YAExC,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YAEvD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAC;YAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC"}