@de-otio/trellis 0.7.1 → 0.10.0

package/dist/lib/graph/dual-write.d.ts

@@ -1,396 +0,0 @@
-/**
- * Dual-Write Service Interface
- *
- * Manages the consistency between Postgres (source of truth) and
- * the graph database (Neo4j AuraDB / Docker Neo4j locally). Handlers
- * call DualWriteService methods after a successful Prisma write to sync
- * the corresponding graph state.
- *
- * Write flow:
- *   1. Handler writes to Postgres via Prisma (source of truth)
- *   2. Handler calls DualWriteService.sync* (graph projection)
- *   3. DualWriteService calls GraphService.sync* with inline retry
- *   4. On failure: enqueues for async retry (non-critical) or throws (critical)
- *
- * Handlers never call GraphService.sync* directly — all dual-writes
- * go through this service so retry and failure handling are centralized.
- *
- * @see ./dual-write-strategy.md for the full design rationale
- * @see ./graph-service.ts for the underlying GraphService interface
- */
-import type { SyncUserInput, SyncEntityInput, SyncPostInput, SyncPostSubjectsInput, SyncOwnershipInput } from "./types";
-/** Configuration for the DualWriteService */
-export interface DualWriteConfig {
-    /**
-     * Maximum number of inline retry attempts (excluding the initial attempt).
-     * Default: 2 (total of 3 attempts).
-     */
-    maxRetries?: number;
-    /**
-     * Base delay in milliseconds for exponential backoff between retries.
-     * Actual delay is baseRetryDelayMs * 2^(attempt-1) + random jitter.
-     * Default: 100.
-     */
-    baseRetryDelayMs?: number;
-    /**
-     * Whether to enqueue failed non-critical syncs for async retry.
-     * When false, failures are logged but not queued (useful for local dev
-     * where there is no SQS queue).
-     * Default: true.
-     */
-    enableAsyncRetry?: boolean;
-}
-/** Serializable record of a failed dual-write, sent to the async retry queue */
-export interface DualWriteFailure {
-    /** Unique ID for this failure (for deduplication) */
-    id: string;
-    /** Which sync operation failed */
-    operation: DualWriteOperation;
-    /** The input payload for the sync method (JSON-serializable) */
-    payload: DualWritePayload;
-    /** ISO timestamp of the original Postgres write */
-    postgresWriteAt: string;
-    /** ISO timestamp of the last failed attempt */
-    lastAttemptAt: string;
-    /** Number of inline attempts made before queuing */
-    inlineAttempts: number;
-    /** The error message from the last failed attempt */
-    lastError: string;
-}
-/** All dual-write operation types (maps to GraphService sync methods) */
-export type DualWriteOperation = "syncUser" | "removeUser" | "syncEntity" | "removeEntity" | "syncPost" | "removePost" | "syncPostSubjects" | "syncOwnership" | "removeOwnership";
-/**
- * Discriminated union of all possible sync payloads.
- * Each variant carries the data needed to call the corresponding
- * GraphService method.
- */
-export type DualWritePayload = {
-    operation: "syncUser";
-    input: SyncUserInput;
-} | {
-    operation: "removeUser";
-    userId: string;
-} | {
-    operation: "syncEntity";
-    input: SyncEntityInput;
-} | {
-    operation: "removeEntity";
-    entityId: string;
-} | {
-    operation: "syncPost";
-    input: SyncPostInput;
-} | {
-    operation: "removePost";
-    postId: string;
-} | {
-    operation: "syncPostSubjects";
-    input: SyncPostSubjectsInput;
-} | {
-    operation: "syncOwnership";
-    input: SyncOwnershipInput;
-} | {
-    operation: "removeOwnership";
-    entityId: string;
-    userId: string;
-};
-/**
- * Records a pending deletion that must be propagated to the graph database.
- *
- * When a user or entity is deleted from Postgres, a tombstone is created to
- * track whether the corresponding graph node has been removed. A daily
- * reconciliation job processes unsynced tombstones to ensure GDPR compliance
- * ("without undue delay" — target: within 24-48 hours).
- *
- * @see dual-write-strategy.md — "Tombstone Pattern for Deletions"
- */
-export interface DeletionTombstone {
-    /** Unique tombstone ID */
-    id: string;
-    /** What type of node was deleted */
-    targetType: "user" | "entity" | "post";
-    /** ID of the deleted node */
-    targetId: string;
-    /** When the Postgres deletion occurred */
-    deletedAt: string;
-    /** Whether the graph node has been successfully removed */
-    graphSynced: boolean;
-    /** When the graph node was successfully removed (null if not yet synced) */
-    graphSyncedAt: string | null;
-}
-/** Outcome of a dual-write attempt */
-export type DualWriteSyncResult = {
-    status: "synced";
-} | {
-    status: "queued";
-    failureId: string;
-} | {
-    status: "failed";
-    error: string;
-};
-/** Progress callback for reconciliation (for logging/UI) */
-export interface ReconciliationProgress {
-    /** Which model is currently being reconciled */
-    model: "user" | "entity" | "post" | "postSubject" | "ownership";
-    /** Records processed so far for this model */
-    processed: number;
-    /** Total records to process for this model (may be approximate) */
-    total: number;
-    /** Records that failed to sync */
-    errors: number;
-}
-/** Final result of a full reconciliation run */
-export interface ReconciliationResult {
-    /** Whether reconciliation completed without fatal errors */
-    success: boolean;
-    /** Per-model statistics */
-    models: {
-        users: {
-            synced: number;
-            failed: number;
-            total: number;
-        };
-        entities: {
-            synced: number;
-            failed: number;
-            total: number;
-        };
-        posts: {
-            synced: number;
-            failed: number;
-            total: number;
-        };
-        postSubjects: {
-            synced: number;
-            failed: number;
-            total: number;
-        };
-        ownership: {
-            synced: number;
-            failed: number;
-            total: number;
-        };
-    };
-    /** Total time in milliseconds */
-    durationMs: number;
-    /** Errors encountered (truncated to first 100) */
-    errors: Array<{
-        model: string;
-        recordId: string;
-        error: string;
-    }>;
-}
-/** Result of a lightweight consistency check */
-export interface ConsistencyCheckResult {
-    /** Whether counts match across both databases */
-    consistent: boolean;
-    /** Per-model count comparison */
-    counts: {
-        users: {
-            postgres: number;
-            graph: number;
-            match: boolean;
-        };
-        entities: {
-            postgres: number;
-            graph: number;
-            match: boolean;
-        };
-        posts: {
-            postgres: number;
-            graph: number;
-            match: boolean;
-        };
-    };
-    /** Sample mismatches found (if any) */
-    mismatches: Array<{
-        model: string;
-        recordId: string;
-        issue: string;
-    }>;
-}
-/**
- * Manages dual-writes between Postgres and the graph database.
- *
- * Each sync method corresponds to a Postgres write that needs to be
- * reflected in the graph. The service handles inline retry and async
- * fallback so handlers don't need to worry about graph sync failures.
- *
- * Critical operations (deletions, ownership changes) throw on failure
- * so the handler can return an error to the client. Non-critical
- * operations (user/entity/post sync) return success even if the graph
- * write fails, because the data can be synced later.
- */
-export interface DualWriteService {
-    /**
-     * Sync a user node to the graph after Postgres create/update.
-     *
-     * Non-critical: returns success even if graph sync fails.
-     * The graph node is a lightweight reference (id, email, role).
-     *
-     * @param input - User data from the Postgres write
-     * @returns Sync outcome (synced, queued, or failed)
-     */
-    syncUser(input: SyncUserInput): Promise<DualWriteSyncResult>;
-    /**
-     * Sync an entity node to the graph after Postgres create/update.
-     *
-     * Non-critical: returns success even if graph sync fails.
-     * The graph node includes properties needed for graph-side filtering
-     * (entityType, breed, lifeStage, lat/lng).
-     *
-     * @param input - Entity data from the Postgres write
-     * @returns Sync outcome
-     */
-    syncEntity(input: SyncEntityInput): Promise<DualWriteSyncResult>;
-    /**
-     * Sync a post node to the graph after Postgres create.
-     *
-     * Non-critical: returns success even if graph sync fails.
-     * The graph node is a reference (id, authorId, radius, createdAt).
-     * Post content stays in Postgres.
-     *
-     * @param input - Post data from the Postgres write
-     * @returns Sync outcome
-     */
-    syncPost(input: SyncPostInput): Promise<DualWriteSyncResult>;
-    /**
-     * Sync post-subject edges to the graph after PostSubject create/update/delete.
-     *
-     * Non-critical: returns success even if graph sync fails.
-     * This is an idempotent "set" operation — all existing ABOUT edges for
-     * the post are replaced with the given entity IDs.
-     *
-     * @param input - Post subject data (postId + all entityIds)
-     * @returns Sync outcome
-     */
-    syncPostSubjects(input: SyncPostSubjectsInput): Promise<DualWriteSyncResult>;
-    /**
-     * Remove a user node from the graph after Postgres deletion.
-     *
-     * Critical: throws if graph sync fails after all retries.
-     * Removing a user cascades to all their relationship edges in the graph.
-     *
-     * @param userId - User ID to remove
-     * @throws GraphSyncError if the graph write fails after all retries
-     */
-    removeUser(userId: string): Promise<void>;
-    /**
-     * Remove an entity node from the graph after Postgres deletion.
-     *
-     * Critical: throws if graph sync fails after all retries.
-     * Removing an entity cascades to all connected edges (RELATES_TO,
-     * OWNS, ABOUT, entity-to-entity relationships).
-     *
-     * @param entityId - Entity ID to remove
-     * @throws GraphSyncError if the graph write fails after all retries
-     */
-    removeEntity(entityId: string): Promise<void>;
-    /**
-     * Remove a post node from the graph after Postgres deletion.
-     *
-     * Non-critical: returns success even if graph sync fails.
-     * An orphan post node in the graph is harmless — it will be
-     * cleaned up by reconciliation.
-     *
-     * @param postId - Post ID to remove
-     * @returns Sync outcome
-     */
-    removePost(postId: string): Promise<DualWriteSyncResult>;
-    /**
-     * Sync an ownership edge to the graph after Postgres create/update.
-     *
-     * Critical: throws if graph sync fails after all retries.
-     * Ownership affects circle tier resolution (owned entities are always
-     * pinned at tier 0 with score 1.0), so stale ownership in the graph
-     * would cause incorrect visibility.
-     *
-     * @param input - Ownership data from the Postgres write
-     * @throws GraphSyncError if the graph write fails after all retries
-     */
-    syncOwnership(input: SyncOwnershipInput): Promise<void>;
-    /**
-     * Remove an ownership edge from the graph after Postgres deletion.
-     *
-     * Critical: throws if graph sync fails after all retries.
-     * Removing ownership unpins the entity from tier 0 and removes
-     * the OWNS edge. The RELATES_TO edge is kept (the user may still
-     * want to follow the entity).
-     *
-     * @param entityId - Entity ID
-     * @param userId - User ID
-     * @throws GraphSyncError if the graph write fails after all retries
-     */
-    removeOwnership(entityId: string, userId: string): Promise<void>;
-    /**
-     * Process a single failed dual-write from the async retry queue.
-     *
-     * Called by the queue worker (Lambda or ECS task) when it receives
-     * a DualWriteFailure message from the GRAPH_SYNC_QUEUE.
-     *
-     * @param failure - The serialized failure record from the queue
-     * @throws If the sync still fails (SQS will retry based on visibility timeout)
-     */
-    processRetry(failure: DualWriteFailure): Promise<void>;
-    /**
-     * Full reconciliation: rebuild all graph DB state from Postgres.
-     *
-     * Processes all records in dependency order:
-     *   Users -> Entities -> Ownership -> Posts -> PostSubjects
-     *
-     * Uses cursor-based pagination to avoid loading all records into memory.
-     * Batches graph writes (configurable batch size, default 100).
-     * Reports progress via the optional callback.
-     *
-     * This is a heavy operation — run it as a one-off task (ECS RunTask),
-     * not inline with API requests.
-     *
-     * @param options - Reconciliation options
-     * @returns Summary of the reconciliation run
-     */
-    reconcile(options?: {
-        /** Batch size for graph writes. Default: 100. */
-        batchSize?: number;
-        /** Maximum records per model (circuit breaker). Default: 1_000_000. */
-        maxRecordsPerModel?: number;
-        /** Clear all graph DB data before rebuilding. Default: false. */
-        clearFirst?: boolean;
-        /** Progress callback (called after each batch). */
-        onProgress?: (progress: ReconciliationProgress) => void;
-    }): Promise<ReconciliationResult>;
-    /**
-     * Lightweight consistency check without modifying data.
-     *
-     * Compares record counts between Postgres and the graph DB, and samples
-     * a set of records to verify graph properties match Postgres.
-     *
-     * Suitable for scheduled runs (daily cron — daily frequency ensures
-     * deletion tombstones are resolved within GDPR timelines).
-     *
-     * @param sampleSize - Number of records to sample per model. Default: 100.
-     * @returns Consistency check results
-     */
-    checkConsistency(sampleSize?: number): Promise<ConsistencyCheckResult>;
-}
-/**
- * Thrown by critical dual-write operations when the graph sync fails
- * after all inline retries.
- *
- * The Postgres write has already committed. The handler should return
- * an error indicating partial failure and the operation should be
- * retried via the async queue.
- */
-export declare class GraphSyncError extends Error {
-    /** Which operation failed */
-    readonly operation: DualWriteOperation;
-    /** Number of retry attempts made */
-    readonly attempts: number;
-    readonly code = "GRAPH_SYNC_ERROR";
-    constructor(
-    /** Which operation failed */
-    operation: DualWriteOperation, 
-    /** The underlying error message */
-    message: string, 
-    /** Number of retry attempts made */
-    attempts: number, options?: ErrorOptions);
-}
-//# sourceMappingURL=dual-write.d.ts.map

package/dist/lib/graph/dual-write.d.ts.map

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

package/dist/lib/graph/dual-write.js

@@ -1,53 +0,0 @@
-"use strict";
-/**
- * Dual-Write Service Interface
- *
- * Manages the consistency between Postgres (source of truth) and
- * the graph database (Neo4j AuraDB / Docker Neo4j locally). Handlers
- * call DualWriteService methods after a successful Prisma write to sync
- * the corresponding graph state.
- *
- * Write flow:
- *   1. Handler writes to Postgres via Prisma (source of truth)
- *   2. Handler calls DualWriteService.sync* (graph projection)
- *   3. DualWriteService calls GraphService.sync* with inline retry
- *   4. On failure: enqueues for async retry (non-critical) or throws (critical)
- *
- * Handlers never call GraphService.sync* directly — all dual-writes
- * go through this service so retry and failure handling are centralized.
- *
- * @see ./dual-write-strategy.md for the full design rationale
- * @see ./graph-service.ts for the underlying GraphService interface
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphSyncError = void 0;
-// ---------------------------------------------------------------------------
-// Error
-// ---------------------------------------------------------------------------
-/**
- * Thrown by critical dual-write operations when the graph sync fails
- * after all inline retries.
- *
- * The Postgres write has already committed. The handler should return
- * an error indicating partial failure and the operation should be
- * retried via the async queue.
- */
-class GraphSyncError extends Error {
-    operation;
-    attempts;
-    code = "GRAPH_SYNC_ERROR";
-    constructor(
-    /** Which operation failed */
-    operation, 
-    /** The underlying error message */
-    message, 
-    /** Number of retry attempts made */
-    attempts, options) {
-        super(`Graph sync failed for ${operation} after ${attempts} attempts: ${message}`, options);
-        this.operation = operation;
-        this.attempts = attempts;
-        this.name = "GraphSyncError";
-    }
-}
-exports.GraphSyncError = GraphSyncError;
-//# sourceMappingURL=dual-write.js.map

package/dist/lib/graph/dual-write.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dual-write.js","sourceRoot":"","sources":["../../../src/lib/graph/dual-write.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAiYH,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAa,cAAe,SAAQ,KAAK;IAK5B;IAIA;IARF,IAAI,GAAG,kBAAkB,CAAC;IAEnC;IACE,6BAA6B;IACpB,SAA6B;IACtC,mCAAmC;IACnC,OAAe;IACf,oCAAoC;IAC3B,QAAgB,EACzB,OAAsB;QAEtB,KAAK,CAAC,yBAAyB,SAAS,UAAU,QAAQ,cAAc,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAPnF,cAAS,GAAT,SAAS,CAAoB;QAI7B,aAAQ,GAAR,QAAQ,CAAQ;QAIzB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAfD,wCAeC"}

package/dist/lib/graph/graph-schema-init.d.ts

@@ -1,31 +0,0 @@
-/**
- * Graph Schema Initialization
- *
- * Creates constraints and indexes in the graph database on first connect.
- * Idempotent — safe to run multiple times. Uses "CREATE ... IF NOT EXISTS"
- * syntax supported by Neo4j 5+ (AuraDB and Community).
- *
- * @see /analysis/redesign/07-graph-database/04-graph-schema.md
- */
-import type { Session } from "neo4j-driver";
-/**
- * Initialize all graph schema constraints and indexes.
- *
- * Each statement runs in its own implicit transaction (Neo4j requires
- * schema operations to be the only statement in a transaction).
- *
- * @param session - An open Neo4j session
- * @throws If any constraint or index creation fails (non-idempotent errors)
- */
-export declare function initGraphSchema(session: Session): Promise<void>;
-/**
- * Verify that all expected constraints and indexes exist.
- *
- * Useful for health checks and diagnostics. Returns the names of
- * any missing constraints or indexes.
- *
- * @param session - An open Neo4j session
- * @returns List of missing constraint/index names (empty if all present)
- */
-export declare function verifyGraphSchema(session: Session): Promise<string[]>;
-//# sourceMappingURL=graph-schema-init.d.ts.map

package/dist/lib/graph/graph-schema-init.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph-schema-init.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/graph-schema-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAuD5C;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0B3E"}

package/dist/lib/graph/graph-schema-init.js

@@ -1,105 +0,0 @@
-"use strict";
-/**
- * Graph Schema Initialization
- *
- * Creates constraints and indexes in the graph database on first connect.
- * Idempotent — safe to run multiple times. Uses "CREATE ... IF NOT EXISTS"
- * syntax supported by Neo4j 5+ (AuraDB and Community).
- *
- * @see /analysis/redesign/07-graph-database/04-graph-schema.md
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initGraphSchema = initGraphSchema;
-exports.verifyGraphSchema = verifyGraphSchema;
-// ---------------------------------------------------------------------------
-// Constraints (uniqueness + implicit index on id properties)
-// ---------------------------------------------------------------------------
-const CONSTRAINTS = [
-    {
-        name: "user_id_unique",
-        query: "CREATE CONSTRAINT user_id_unique IF NOT EXISTS FOR (u:User) REQUIRE u.id IS UNIQUE",
-    },
-    {
-        name: "entity_id_unique",
-        query: "CREATE CONSTRAINT entity_id_unique IF NOT EXISTS FOR (e:Entity) REQUIRE e.id IS UNIQUE",
-    },
-    {
-        name: "post_id_unique",
-        query: "CREATE CONSTRAINT post_id_unique IF NOT EXISTS FOR (p:Post) REQUIRE p.id IS UNIQUE",
-    },
-];
-// ---------------------------------------------------------------------------
-// Indexes (for discovery filtering and temporal ordering)
-// ---------------------------------------------------------------------------
-const INDEXES = [
-    {
-        name: "entity_type_breed",
-        query: "CREATE INDEX entity_type_breed IF NOT EXISTS FOR (e:Entity) ON (e.entityType, e.breed)",
-    },
-    {
-        name: "entity_type_lifestage",
-        query: "CREATE INDEX entity_type_lifestage IF NOT EXISTS FOR (e:Entity) ON (e.entityType, e.lifeStage)",
-    },
-    {
-        name: "entity_location",
-        query: "CREATE POINT INDEX entity_location IF NOT EXISTS FOR (e:Entity) ON (e.location)",
-    },
-    {
-        name: "post_created",
-        query: "CREATE INDEX post_created IF NOT EXISTS FOR (p:Post) ON (p.createdAt)",
-    },
-    {
-        name: "post_author",
-        query: "CREATE INDEX post_author IF NOT EXISTS FOR (p:Post) ON (p.authorId)",
-    },
-];
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Initialize all graph schema constraints and indexes.
- *
- * Each statement runs in its own implicit transaction (Neo4j requires
- * schema operations to be the only statement in a transaction).
- *
- * @param session - An open Neo4j session
- * @throws If any constraint or index creation fails (non-idempotent errors)
- */
-async function initGraphSchema(session) {
-    // Create constraints first (they create implicit indexes on the constrained property)
-    for (const constraint of CONSTRAINTS) {
-        await session.run(constraint.query);
-    }
-    // Create additional indexes for query performance
-    for (const index of INDEXES) {
-        await session.run(index.query);
-    }
-}
-/**
- * Verify that all expected constraints and indexes exist.
- *
- * Useful for health checks and diagnostics. Returns the names of
- * any missing constraints or indexes.
- *
- * @param session - An open Neo4j session
- * @returns List of missing constraint/index names (empty if all present)
- */
-async function verifyGraphSchema(session) {
-    const missing = [];
-    const constraintResult = await session.run("SHOW CONSTRAINTS");
-    const existingConstraints = new Set(constraintResult.records.map((r) => r.get("name")));
-    for (const constraint of CONSTRAINTS) {
-        if (!existingConstraints.has(constraint.name)) {
-            missing.push(constraint.name);
-        }
-    }
-    const indexResult = await session.run("SHOW INDEXES");
-    const existingIndexes = new Set(indexResult.records.map((r) => r.get("name")));
-    for (const index of INDEXES) {
-        if (!existingIndexes.has(index.name)) {
-            missing.push(index.name);
-        }
-    }
-    return missing;
-}
-//# sourceMappingURL=graph-schema-init.js.map

package/dist/lib/graph/graph-schema-init.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph-schema-init.js","sourceRoot":"","sources":["../../../src/lib/graph/graph-schema-init.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAkEH,0CAUC;AAWD,8CA0BC;AA7GD,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,MAAM,WAAW,GAAG;IAClB;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,oFAAoF;KAC5F;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EACH,wFAAwF;KAC3F;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,oFAAoF;KAC5F;CACF,CAAC;AAEF,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E,MAAM,OAAO,GAAG;IACd;QACE,IAAI,EAAE,mBAAmB;QACzB,KAAK,EACH,wFAAwF;KAC3F;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EACH,gGAAgG;KACnG;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,iFAAiF;KACzF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,uEAAuE;KAC/E;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,qEAAqE;KAC7E;CACF,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACI,KAAK,UAAU,eAAe,CAAC,OAAgB;IACpD,sFAAsF;IACtF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,kDAAkD;IAClD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,iBAAiB,CAAC,OAAgB;IACtD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC/D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CACjC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAW,CAAC,CAC7D,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAW,CAAC,CACxD,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}