dotdo 0.0.1 → 0.1.0

package/dist/workflows/visibility/index.js

@@ -0,0 +1,146 @@
+/**
+ * Workflow Visibility API
+ *
+ * Temporal-like visibility for listing and querying workflows.
+ *
+ * @example
+ * ```typescript
+ * import { listWorkflows, createWorkflowVisibilityStore } from './visibility'
+ *
+ * const store = createWorkflowVisibilityStore()
+ *
+ * // List all running order workflows
+ * const result = await listWorkflows(store, {
+ *   query: 'WorkflowType = "orderWorkflow" AND Status = "RUNNING"',
+ *   pageSize: 100,
+ * })
+ *
+ * for (const workflow of result.workflows) {
+ *   console.log(workflow.workflowId, workflow.status)
+ * }
+ * ```
+ */
+// Re-export store
+export { createWorkflowVisibilityStore, InMemoryWorkflowVisibilityStore, } from './store';
+// Re-export query parser
+export { parseQuery, buildQuery } from './query-parser';
+// ============================================================================
+// LIST WORKFLOWS
+// ============================================================================
+/**
+ * List workflows with optional query filter.
+ *
+ * @param store Visibility store instance
+ * @param options List options including query string and pagination
+ * @returns List of matching workflows with pagination info
+ *
+ * @example
+ * ```typescript
+ * // List all workflows
+ * const all = await listWorkflows(store, {})
+ *
+ * // List running order workflows
+ * const running = await listWorkflows(store, {
+ *   query: 'WorkflowType = "orderWorkflow" AND Status = "RUNNING"',
+ * })
+ *
+ * // Paginate through results
+ * let result = await listWorkflows(store, { pageSize: 10 })
+ * while (result.nextPageToken) {
+ *   result = await listWorkflows(store, {
+ *     pageSize: 10,
+ *     nextPageToken: result.nextPageToken,
+ *   })
+ * }
+ * ```
+ */
+export async function listWorkflows(store, options = {}) {
+    return store.list(options);
+}
+// ============================================================================
+// QUERY WORKFLOWS
+// ============================================================================
+/**
+ * Query workflows with structured filters.
+ *
+ * @param store Visibility store instance
+ * @param query Structured query with filter conditions
+ * @param options Pagination options
+ * @returns List of matching workflows with pagination info
+ *
+ * @example
+ * ```typescript
+ * const result = await queryWorkflows(store, {
+ *   filters: [
+ *     { field: 'WorkflowType', operator: '=', value: 'orderWorkflow' },
+ *     { field: 'Status', operator: '=', value: 'RUNNING' },
+ *   ],
+ * })
+ * ```
+ */
+export async function queryWorkflows(store, query, options = {}) {
+    return store.query(query, options);
+}
+// ============================================================================
+// WORKFLOW VISIBILITY CLIENT
+// ============================================================================
+/**
+ * Workflow visibility client for convenient access to visibility APIs.
+ *
+ * @example
+ * ```typescript
+ * const client = new WorkflowVisibilityClient(store)
+ *
+ * // List with query string
+ * const result = await client.list({
+ *   query: 'WorkflowType = "orderWorkflow" AND Status = "RUNNING"',
+ *   pageSize: 100,
+ * })
+ *
+ * // Iterate with async iterator
+ * for await (const workflow of client.iterate({ query: 'Status = "RUNNING"' })) {
+ *   console.log(workflow.workflowId)
+ * }
+ * ```
+ */
+export class WorkflowVisibilityClient {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * List workflows with optional query
+     */
+    async list(options = {}) {
+        return listWorkflows(this.store, options);
+    }
+    /**
+     * Query workflows with structured filters
+     */
+    async query(query, options = {}) {
+        return queryWorkflows(this.store, query, options);
+    }
+    /**
+     * Async iterator for paginating through all matching workflows
+     */
+    async *iterate(options = {}) {
+        let nextPageToken;
+        do {
+            const result = await this.list({
+                ...options,
+                nextPageToken,
+            });
+            for (const workflow of result.workflows) {
+                yield workflow;
+            }
+            nextPageToken = result.nextPageToken;
+        } while (nextPageToken);
+    }
+}
+/**
+ * Create a new workflow visibility client
+ */
+export function createWorkflowVisibilityClient(store) {
+    return new WorkflowVisibilityClient(store);
+}
+//# sourceMappingURL=index.js.map

package/dist/workflows/visibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../workflows/visibility/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgBH,kBAAkB;AAClB,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,SAAS,CAAA;AAEhB,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAUvD,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA8B,EAC9B,UAAgC,EAAE;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA8B,EAC9B,KAAoB,EACpB,UAAyD,EAAE;IAE3D,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;AACpC,CAAC;AAED,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,KAA8B;QAA9B,UAAK,GAAL,KAAK,CAAyB;IAAG,CAAC;IAE/D;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAgC,EAAE;QAC3C,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,KAAoB,EACpB,UAAyD,EAAE;QAE3D,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,OAAO,CAAC,UAAgC,EAAE;QAC/C,IAAI,aAAiC,CAAA;QAErC,GAAG,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;gBAC7B,GAAG,OAAO;gBACV,aAAa;aACd,CAAC,CAAA;YAEF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACxC,MAAM,QAAQ,CAAA;YAChB,CAAC;YAED,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;QACtC,CAAC,QAAQ,aAAa,EAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAA8B;IAC3E,OAAO,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAA;AAC5C,CAAC"}

package/dist/workflows/visibility/query-parser.js

@@ -0,0 +1,150 @@
+/**
+ * Workflow Query Parser
+ *
+ * Parses Temporal-like SQL query strings into structured filters.
+ * Supports basic syntax: Field = "value" AND Field2 = "value2"
+ */
+// ============================================================================
+// QUERY PARSING
+// ============================================================================
+/**
+ * Parse a query string into structured filters.
+ *
+ * Supported syntax:
+ * - Simple equality: `WorkflowType = "orderWorkflow"`
+ * - Status filter: `Status = "RUNNING"`
+ * - Combined (AND): `WorkflowType = "orderWorkflow" AND Status = "RUNNING"`
+ * - Search attributes: `customerId = "cust-123"`
+ *
+ * @param query Query string in Temporal-like SQL syntax
+ * @returns Array of QueryFilter objects
+ */
+export function parseQuery(query) {
+    if (!query || query.trim() === '') {
+        return [];
+    }
+    const filters = [];
+    // Split by AND (case insensitive)
+    const conditions = query.split(/\s+AND\s+/i);
+    for (const condition of conditions) {
+        const filter = parseCondition(condition.trim());
+        if (filter) {
+            filters.push(filter);
+        }
+    }
+    return filters;
+}
+/**
+ * Parse a single condition into a QueryFilter
+ */
+function parseCondition(condition) {
+    // Match patterns like: Field = "value" or Field = 'value'
+    // Also supports: Field != "value", Field > 123, etc.
+    const operatorPattern = /^(\w+)\s*(=|!=|>=|<=|>|<|IN|NOT\s+IN)\s*(.+)$/i;
+    const match = condition.match(operatorPattern);
+    if (!match) {
+        return null;
+    }
+    const [, field, operatorRaw, valueRaw] = match;
+    const operator = normalizeOperator(operatorRaw.trim());
+    const value = parseValue(valueRaw.trim());
+    if (!field || !operator || value === undefined) {
+        return null;
+    }
+    return {
+        field,
+        operator,
+        value,
+    };
+}
+/**
+ * Normalize operator string to QueryOperator
+ */
+function normalizeOperator(op) {
+    const normalized = op.toUpperCase().replace(/\s+/g, ' ');
+    switch (normalized) {
+        case '=':
+            return '=';
+        case '!=':
+            return '!=';
+        case '>':
+            return '>';
+        case '<':
+            return '<';
+        case '>=':
+            return '>=';
+        case '<=':
+            return '<=';
+        case 'IN':
+            return 'IN';
+        case 'NOT IN':
+            return 'NOT IN';
+        default:
+            return '=';
+    }
+}
+/**
+ * Parse a value string into the appropriate type
+ */
+function parseValue(valueStr) {
+    // Handle quoted strings (double or single quotes)
+    const doubleQuoteMatch = valueStr.match(/^"([^"]*)"$/);
+    if (doubleQuoteMatch) {
+        return doubleQuoteMatch[1];
+    }
+    const singleQuoteMatch = valueStr.match(/^'([^']*)'$/);
+    if (singleQuoteMatch) {
+        return singleQuoteMatch[1];
+    }
+    // Handle array values for IN operator: (value1, value2, value3)
+    const arrayMatch = valueStr.match(/^\(([^)]+)\)$/);
+    if (arrayMatch) {
+        return arrayMatch[1].split(',').map(v => parseValue(v.trim()));
+    }
+    // Handle numbers
+    if (/^-?\d+\.?\d*$/.test(valueStr)) {
+        return parseFloat(valueStr);
+    }
+    // Handle booleans
+    if (valueStr.toLowerCase() === 'true')
+        return true;
+    if (valueStr.toLowerCase() === 'false')
+        return false;
+    // Return as-is (unquoted string)
+    return valueStr;
+}
+// ============================================================================
+// QUERY BUILDING
+// ============================================================================
+/**
+ * Build a query string from structured filters
+ */
+export function buildQuery(filters) {
+    if (filters.length === 0) {
+        return '';
+    }
+    return filters.map(filter => buildCondition(filter)).join(' AND ');
+}
+/**
+ * Build a single condition string
+ */
+function buildCondition(filter) {
+    const value = formatValue(filter.value);
+    return `${filter.field} ${filter.operator} ${value}`;
+}
+/**
+ * Format a value for query string
+ */
+function formatValue(value) {
+    if (Array.isArray(value)) {
+        return `(${value.map(v => formatValue(v)).join(', ')})`;
+    }
+    if (typeof value === 'string') {
+        return `"${value}"`;
+    }
+    if (value instanceof Date) {
+        return `"${value.toISOString()}"`;
+    }
+    return String(value);
+}
+//# sourceMappingURL=query-parser.js.map

package/dist/workflows/visibility/query-parser.js.map

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

package/dist/workflows/visibility/store.js

@@ -0,0 +1,223 @@
+/**
+ * Workflow Visibility Store
+ *
+ * Storage implementation for workflow metadata.
+ * Provides in-memory storage for testing and base implementation
+ * that can be extended for D1/KV backends.
+ */
+import { parseQuery } from './query-parser';
+// ============================================================================
+// IN-MEMORY STORE
+// ============================================================================
+/**
+ * In-memory implementation of WorkflowVisibilityStore.
+ * Used for testing and development.
+ */
+export class InMemoryWorkflowVisibilityStore {
+    workflows = new Map();
+    async upsert(metadata) {
+        this.workflows.set(metadata.workflowId, { ...metadata });
+    }
+    async get(workflowId) {
+        const metadata = this.workflows.get(workflowId);
+        return metadata ? { ...metadata } : null;
+    }
+    async delete(workflowId) {
+        this.workflows.delete(workflowId);
+    }
+    async list(options) {
+        // Parse query string into structured filters
+        const filters = options.query ? parseQuery(options.query) : [];
+        // Get all workflows and apply filters
+        let workflows = Array.from(this.workflows.values());
+        // Apply filters
+        if (filters.length > 0) {
+            workflows = workflows.filter(w => matchesAllFilters(w, filters));
+        }
+        // Sort by startTime descending (most recent first)
+        workflows.sort((a, b) => b.startTime.getTime() - a.startTime.getTime());
+        // Apply pagination
+        return applyPagination(workflows, options);
+    }
+    async query(query, options = {}) {
+        // Get all workflows and apply filters
+        let workflows = Array.from(this.workflows.values());
+        if (query.filters.length > 0) {
+            workflows = workflows.filter(w => matchesAllFilters(w, query.filters));
+        }
+        // Sort by startTime descending
+        workflows.sort((a, b) => b.startTime.getTime() - a.startTime.getTime());
+        return applyPagination(workflows, options);
+    }
+    /**
+     * Clear all stored workflows (for testing)
+     */
+    clear() {
+        this.workflows.clear();
+    }
+    /**
+     * Get count of stored workflows (for testing)
+     */
+    count() {
+        return this.workflows.size;
+    }
+}
+// ============================================================================
+// FILTER MATCHING
+// ============================================================================
+/**
+ * Check if a workflow matches all filters (AND logic)
+ */
+function matchesAllFilters(workflow, filters) {
+    return filters.every(filter => matchesFilter(workflow, filter));
+}
+/**
+ * Check if a workflow matches a single filter
+ */
+function matchesFilter(workflow, filter) {
+    const value = getFieldValue(workflow, filter.field);
+    switch (filter.operator) {
+        case '=':
+            return compareEqual(value, filter.value);
+        case '!=':
+            return !compareEqual(value, filter.value);
+        case '>':
+            return compareGreater(value, filter.value);
+        case '<':
+            return compareLess(value, filter.value);
+        case '>=':
+            return compareEqual(value, filter.value) || compareGreater(value, filter.value);
+        case '<=':
+            return compareEqual(value, filter.value) || compareLess(value, filter.value);
+        case 'IN':
+            return Array.isArray(filter.value) && filter.value.some(v => compareEqual(value, v));
+        case 'NOT IN':
+            return !Array.isArray(filter.value) || !filter.value.some(v => compareEqual(value, v));
+        default:
+            return false;
+    }
+}
+/**
+ * Get a field value from workflow metadata
+ */
+function getFieldValue(workflow, field) {
+    // Standard fields (case-insensitive matching for common fields)
+    const normalizedField = field.toLowerCase();
+    switch (normalizedField) {
+        case 'workflowtype':
+            return workflow.workflowType;
+        case 'status':
+            return workflow.status;
+        case 'workflowid':
+            return workflow.workflowId;
+        case 'runid':
+            return workflow.runId;
+        case 'taskqueue':
+            return workflow.taskQueue;
+        case 'namespace':
+            return workflow.namespace;
+        case 'starttime':
+            return workflow.startTime;
+        case 'closetime':
+            return workflow.closeTime;
+        default:
+            // Check search attributes
+            return workflow.searchAttributes?.[field];
+    }
+}
+/**
+ * Compare two values for equality
+ */
+function compareEqual(a, b) {
+    if (a === undefined)
+        return false;
+    if (Array.isArray(b))
+        return false; // Single value comparison
+    // Handle Date comparison
+    if (a instanceof Date && b instanceof Date) {
+        return a.getTime() === b.getTime();
+    }
+    // String comparison (case-sensitive)
+    return String(a) === String(b);
+}
+/**
+ * Compare if a > b
+ */
+function compareGreater(a, b) {
+    if (a === undefined || Array.isArray(b))
+        return false;
+    // Handle Date comparison
+    if (a instanceof Date && b instanceof Date) {
+        return a.getTime() > b.getTime();
+    }
+    // Numeric comparison
+    if (typeof a === 'number' && typeof b === 'number') {
+        return a > b;
+    }
+    // String comparison
+    return String(a) > String(b);
+}
+/**
+ * Compare if a < b
+ */
+function compareLess(a, b) {
+    if (a === undefined || Array.isArray(b))
+        return false;
+    // Handle Date comparison
+    if (a instanceof Date && b instanceof Date) {
+        return a.getTime() < b.getTime();
+    }
+    // Numeric comparison
+    if (typeof a === 'number' && typeof b === 'number') {
+        return a < b;
+    }
+    // String comparison
+    return String(a) < String(b);
+}
+// ============================================================================
+// PAGINATION
+// ============================================================================
+/**
+ * Apply pagination to a list of workflows
+ */
+function applyPagination(workflows, options) {
+    const pageSize = options.pageSize ?? 100;
+    let startIndex = 0;
+    // Decode cursor (simple offset-based pagination)
+    if (options.nextPageToken) {
+        try {
+            const decoded = JSON.parse(atob(options.nextPageToken));
+            startIndex = decoded.offset ?? 0;
+        }
+        catch (error) {
+            // Log pagination token errors so users see why pagination might be wrong
+            console.warn('[workflows] Invalid pagination token - starting from beginning:', {
+                token: options.nextPageToken.slice(0, 50) + '...',
+                error: error instanceof Error ? error.message : 'unknown',
+            });
+            startIndex = 0;
+        }
+    }
+    // Slice results
+    const endIndex = startIndex + pageSize;
+    const pageWorkflows = workflows.slice(startIndex, endIndex);
+    // Generate next page token if there are more results
+    let nextPageToken;
+    if (endIndex < workflows.length) {
+        nextPageToken = btoa(JSON.stringify({ offset: endIndex }));
+    }
+    return {
+        workflows: pageWorkflows,
+        nextPageToken,
+    };
+}
+// ============================================================================
+// FACTORY
+// ============================================================================
+/**
+ * Create a new in-memory workflow visibility store
+ */
+export function createWorkflowVisibilityStore() {
+    return new InMemoryWorkflowVisibilityStore();
+}
+//# sourceMappingURL=store.js.map

package/dist/workflows/visibility/store.js.map

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

package/dist/workflows/visibility/types.js

@@ -0,0 +1,30 @@
+/**
+ * Workflow Visibility Types
+ *
+ * Type definitions for Temporal-like workflow visibility API.
+ * Enables listing and querying running workflows.
+ */
+// ============================================================================
+// WORKFLOW STATUS
+// ============================================================================
+/**
+ * Workflow execution status
+ */
+export var WorkflowStatus;
+(function (WorkflowStatus) {
+    /** Workflow is currently running */
+    WorkflowStatus["RUNNING"] = "RUNNING";
+    /** Workflow completed successfully */
+    WorkflowStatus["COMPLETED"] = "COMPLETED";
+    /** Workflow failed with an error */
+    WorkflowStatus["FAILED"] = "FAILED";
+    /** Workflow was cancelled */
+    WorkflowStatus["CANCELLED"] = "CANCELLED";
+    /** Workflow was terminated */
+    WorkflowStatus["TERMINATED"] = "TERMINATED";
+    /** Workflow timed out */
+    WorkflowStatus["TIMED_OUT"] = "TIMED_OUT";
+    /** Workflow continued as new */
+    WorkflowStatus["CONTINUED_AS_NEW"] = "CONTINUED_AS_NEW";
+})(WorkflowStatus || (WorkflowStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/workflows/visibility/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../workflows/visibility/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAN,IAAY,cAeX;AAfD,WAAY,cAAc;IACxB,oCAAoC;IACpC,qCAAmB,CAAA;IACnB,sCAAsC;IACtC,yCAAuB,CAAA;IACvB,oCAAoC;IACpC,mCAAiB,CAAA;IACjB,6BAA6B;IAC7B,yCAAuB,CAAA;IACvB,8BAA8B;IAC9B,2CAAyB,CAAA;IACzB,yBAAyB;IACzB,yCAAuB,CAAA;IACvB,gCAAgC;IAChC,uDAAqC,CAAA;AACvC,CAAC,EAfW,cAAc,KAAd,cAAc,QAezB"}

package/dist/workflows/workflow.js

@@ -0,0 +1,53 @@
+/**
+ * Workflow - Define durable workflows with magic syntax
+ *
+ * Provides a DSL for defining workflows that:
+ * - Use proxy-based domain resolution ($.Noun(id).verb())
+ * - Support conditional execution ($.when)
+ * - Enable batch processing via magic map
+ */
+/**
+ * Define a workflow
+ *
+ * @example
+ * ```typescript
+ * const MyWorkflow = Workflow('my-workflow', ($, input: MyInput) => {
+ *   const result = $.Service(input.id).doSomething()
+ *   $.when(result.success, {
+ *     then: () => $.Notification.send({ message: 'Success!' }),
+ *     else: () => $.Alert.trigger({ error: result.error })
+ *   })
+ *   return { processed: true }
+ * })
+ * ```
+ */
+export function Workflow(name, definition) {
+    return {
+        name,
+        execute: (context, input) => {
+            // Extend context with workflow helpers
+            const extendedContext = createExtendedContext(context);
+            return definition(extendedContext, input);
+        },
+    };
+}
+/**
+ * Create extended workflow context with helpers
+ */
+function createExtendedContext(baseContext) {
+    return new Proxy(baseContext, {
+        get(target, prop) {
+            if (prop === 'when') {
+                return (condition, branches) => {
+                    // In real implementation, this would be recorded and replayed
+                    // For now, just evaluate synchronously
+                    return condition ? branches.then() : branches.else();
+                };
+            }
+            // Delegate to base context
+            return target[prop];
+        },
+    });
+}
+export default Workflow;
+//# sourceMappingURL=workflow.js.map

package/dist/workflows/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../workflows/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,UAAkE;IAElE,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,CAAC,OAAwB,EAAE,KAAa,EAAE,EAAE;YACnD,uCAAuC;YACvC,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAA;YACtD,OAAO,UAAU,CAAC,eAAe,EAAE,KAAK,CAAC,CAAA;QAC3C,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,WAA4B;IACzD,OAAO,IAAI,KAAK,CAAC,WAAsC,EAAE;QACvD,GAAG,CAAC,MAAM,EAAE,IAAY;YACtB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,CAAO,SAAkB,EAAE,QAA0C,EAAS,EAAE;oBACrF,8DAA8D;oBAC9D,uCAAuC;oBACvC,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;gBACtD,CAAC,CAAA;YACH,CAAC;YAED,2BAA2B;YAC3B,OAAQ,MAA6C,CAAC,IAAI,CAAC,CAAA;QAC7D,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,eAAe,QAAQ,CAAA"}