@living-architecture/riviere-query 0.2.1

package/dist/depth-queries.js

@@ -0,0 +1,54 @@
+import { parseComponentId } from './domain-types';
+export function queryNodeDepths(graph) {
+    const depths = new Map();
+    const entryPoints = findEntryPointIds(graph);
+    if (entryPoints.length === 0) {
+        return depths;
+    }
+    const outgoingEdges = buildOutgoingEdges(graph);
+    const queue = entryPoints.map((id) => ({ id, depth: 0 }));
+    processQueue(queue, depths, outgoingEdges);
+    return depths;
+}
+function processQueue(queue, depths, outgoingEdges) {
+    const current = queue.shift();
+    if (current === undefined)
+        return;
+    const existingDepth = depths.get(current.id);
+    const shouldProcess = existingDepth === undefined || existingDepth > current.depth;
+    if (shouldProcess) {
+        depths.set(current.id, current.depth);
+        enqueueChildren(outgoingEdges, current, queue);
+    }
+    processQueue(queue, depths, outgoingEdges);
+}
+function enqueueChildren(outgoingEdges, current, queue) {
+    const edges = outgoingEdges.get(current.id);
+    if (edges) {
+        for (const targetId of edges) {
+            queue.push({ id: targetId, depth: current.depth + 1 });
+        }
+    }
+}
+function findEntryPointIds(graph) {
+    const targets = new Set(graph.links.map((link) => link.target));
+    const entryPointTypes = new Set(['UI', 'API', 'EventHandler', 'Custom']);
+    return graph.components
+        .filter((c) => entryPointTypes.has(c.type) && !targets.has(c.id))
+        .map((c) => parseComponentId(c.id));
+}
+function buildOutgoingEdges(graph) {
+    const edges = new Map();
+    for (const link of graph.links) {
+        const sourceId = parseComponentId(link.source);
+        const targetId = parseComponentId(link.target);
+        const existing = edges.get(sourceId);
+        if (existing) {
+            existing.push(targetId);
+        }
+        else {
+            edges.set(sourceId, [targetId]);
+        }
+    }
+    return edges;
+}

package/dist/domain-queries.d.ts

@@ -0,0 +1,10 @@
+import type { RiviereGraph, DomainOpComponent } from '@living-architecture/riviere-schema';
+import type { Entity, EntityTransition } from './event-types';
+import type { State, Domain } from './domain-types';
+export declare function queryDomains(graph: RiviereGraph): Domain[];
+export declare function operationsForEntity(graph: RiviereGraph, entityName: string): DomainOpComponent[];
+export declare function queryEntities(graph: RiviereGraph, domainName?: string): Entity[];
+export declare function businessRulesForEntity(graph: RiviereGraph, entityName: string): string[];
+export declare function transitionsForEntity(graph: RiviereGraph, entityName: string): EntityTransition[];
+export declare function statesForEntity(graph: RiviereGraph, entityName: string): State[];
+//# sourceMappingURL=domain-queries.d.ts.map

package/dist/domain-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-queries.d.ts","sourceRoot":"","sources":["../src/domain-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAmB,MAAM,gBAAgB,CAAA;AAIpE,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAU1D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAEhG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAchF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAQxF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAUhG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,EAAE,CAWhF"}

package/dist/domain-queries.js

@@ -0,0 +1,101 @@
+import { parseEntityName, parseDomainName, parseState, parseOperationName } from './domain-types';
+import { componentsInDomain } from './component-queries';
+export function queryDomains(graph) {
+    return Object.entries(graph.metadata.domains).map(([name, metadata]) => {
+        const dc = componentsInDomain(graph, name);
+        const count = (type) => dc.filter((c) => c.type === type).length;
+        const componentCounts = {
+            UI: count('UI'), API: count('API'), UseCase: count('UseCase'), DomainOp: count('DomainOp'),
+            Event: count('Event'), EventHandler: count('EventHandler'), Custom: count('Custom'), total: dc.length,
+        };
+        return { name, description: metadata.description, systemType: metadata.systemType, componentCounts };
+    });
+}
+export function operationsForEntity(graph, entityName) {
+    return graph.components.filter((c) => c.type === 'DomainOp' && c.entity === entityName);
+}
+export function queryEntities(graph, domainName) {
+    const domainOps = graph.components.filter((c) => c.type === 'DomainOp' && c.entity !== undefined);
+    const filtered = domainName ? domainOps.filter((op) => op.domain === domainName) : domainOps;
+    const entityMap = new Map();
+    for (const op of filtered) {
+        const key = `${op.domain}:${op.entity}`;
+        const existing = entityMap.get(key);
+        if (existing) {
+            entityMap.set(key, { ...existing, operations: [...existing.operations, op] });
+        }
+        else {
+            entityMap.set(key, { name: parseEntityName(op.entity), domain: parseDomainName(op.domain), operations: [op] });
+        }
+    }
+    return Array.from(entityMap.values());
+}
+export function businessRulesForEntity(graph, entityName) {
+    const operations = operationsForEntity(graph, entityName);
+    const allRules = [];
+    for (const op of operations) {
+        if (op.businessRules === undefined)
+            continue;
+        allRules.push(...op.businessRules);
+    }
+    return [...new Set(allRules)];
+}
+export function transitionsForEntity(graph, entityName) {
+    const operations = operationsForEntity(graph, entityName);
+    const transitions = [];
+    for (const op of operations) {
+        if (op.stateChanges === undefined)
+            continue;
+        for (const sc of op.stateChanges) {
+            transitions.push({ from: parseState(sc.from), to: parseState(sc.to), triggeredBy: parseOperationName(op.operationName) });
+        }
+    }
+    return transitions;
+}
+export function statesForEntity(graph, entityName) {
+    const operations = operationsForEntity(graph, entityName);
+    const states = new Set();
+    for (const op of operations) {
+        if (op.stateChanges === undefined)
+            continue;
+        for (const sc of op.stateChanges) {
+            if (sc.from !== '*')
+                states.add(sc.from);
+            states.add(sc.to);
+        }
+    }
+    return orderStatesByTransitions(states, operations);
+}
+function orderStatesByTransitions(states, operations) {
+    const fromStates = new Set();
+    const toStates = new Set();
+    const transitionMap = new Map();
+    for (const op of operations) {
+        if (op.stateChanges === undefined)
+            continue;
+        for (const t of op.stateChanges) {
+            if (t.from !== '*') {
+                fromStates.add(t.from);
+                transitionMap.set(t.from, t.to);
+            }
+            toStates.add(t.to);
+        }
+    }
+    const ordered = [];
+    const visited = new Set();
+    const follow = (s) => {
+        if (visited.has(s))
+            return;
+        visited.add(s);
+        ordered.push(parseState(s));
+        const next = transitionMap.get(s);
+        if (next)
+            follow(next);
+    };
+    [...fromStates].filter((s) => !toStates.has(s)).forEach(follow);
+    states.forEach((s) => {
+        if (!visited.has(s))
+            ordered.push(parseState(s));
+    });
+    return ordered;
+}

package/dist/domain-types.d.ts

@@ -0,0 +1,307 @@
+import type { Component, Link, ExternalLink } from '@living-architecture/riviere-schema';
+import { z } from 'zod';
+/** @internal */
+declare const componentIdSchema: z.core.$ZodBranded<z.ZodString, "ComponentId">;
+/** @internal */
+declare const linkIdSchema: z.core.$ZodBranded<z.ZodString, "LinkId">;
+/** @internal */
+declare const entityNameSchema: z.core.$ZodBranded<z.ZodString, "EntityName">;
+/** @internal */
+declare const domainNameSchema: z.core.$ZodBranded<z.ZodString, "DomainName">;
+/** @internal */
+declare const stateSchema: z.core.$ZodBranded<z.ZodString, "State">;
+/** @internal */
+declare const operationNameSchema: z.core.$ZodBranded<z.ZodString, "OperationName">;
+/** @internal */
+declare const eventIdSchema: z.core.$ZodBranded<z.ZodString, "EventId">;
+/** @internal */
+declare const eventNameSchema: z.core.$ZodBranded<z.ZodString, "EventName">;
+/** @internal */
+declare const handlerIdSchema: z.core.$ZodBranded<z.ZodString, "HandlerId">;
+/** @internal */
+declare const handlerNameSchema: z.core.$ZodBranded<z.ZodString, "HandlerName">;
+/** Branded type for component identifiers. */
+export type ComponentId = z.infer<typeof componentIdSchema>;
+/** Branded type for link identifiers. */
+export type LinkId = z.infer<typeof linkIdSchema>;
+/** Branded type for entity names. */
+export type EntityName = z.infer<typeof entityNameSchema>;
+/** Branded type for domain names. */
+export type DomainName = z.infer<typeof domainNameSchema>;
+/** Branded type for state names in entity state machines. */
+export type State = z.infer<typeof stateSchema>;
+/** Branded type for operation names. */
+export type OperationName = z.infer<typeof operationNameSchema>;
+/** Branded type for event identifiers. */
+export type EventId = z.infer<typeof eventIdSchema>;
+/** Branded type for event names. */
+export type EventName = z.infer<typeof eventNameSchema>;
+/** Branded type for event handler identifiers. */
+export type HandlerId = z.infer<typeof handlerIdSchema>;
+/** Branded type for event handler names. */
+export type HandlerName = z.infer<typeof handlerNameSchema>;
+/** Error codes for graph validation failures. */
+export type ValidationErrorCode = 'INVALID_LINK_SOURCE' | 'INVALID_LINK_TARGET' | 'INVALID_TYPE';
+/**
+ * A validation error found in the graph.
+ */
+export interface ValidationError {
+    /** JSON path to the error location. */
+    path: string;
+    /** Human-readable error description. */
+    message: string;
+    /** Machine-readable error code. */
+    code: ValidationErrorCode;
+}
+/**
+ * Result of graph validation.
+ */
+export interface ValidationResult {
+    /** Whether the graph passed validation. */
+    valid: boolean;
+    /** List of validation errors (empty if valid). */
+    errors: ValidationError[];
+}
+/**
+ * Component counts by type within a domain.
+ */
+export interface ComponentCounts {
+    /** Number of UI components. */
+    UI: number;
+    /** Number of API components. */
+    API: number;
+    /** Number of UseCase components. */
+    UseCase: number;
+    /** Number of DomainOp components. */
+    DomainOp: number;
+    /** Number of Event components. */
+    Event: number;
+    /** Number of EventHandler components. */
+    EventHandler: number;
+    /** Number of Custom components. */
+    Custom: number;
+    /** Total number of components. */
+    total: number;
+}
+/**
+ * Domain information with metadata and component counts.
+ */
+export interface Domain {
+    /** Domain name. */
+    name: string;
+    /** Domain description from graph metadata. */
+    description: string;
+    /** System type classification. */
+    systemType: 'domain' | 'bff' | 'ui' | 'other';
+    /** Counts of components by type. */
+    componentCounts: ComponentCounts;
+}
+/**
+ * A component that was modified between graph versions.
+ */
+export interface ComponentModification {
+    /** The component ID. */
+    id: ComponentId;
+    /** The component state before modification. */
+    before: Component;
+    /** The component state after modification. */
+    after: Component;
+    /** List of field names that changed. */
+    changedFields: string[];
+}
+/**
+ * Summary statistics of differences between graphs.
+ */
+export interface DiffStats {
+    /** Number of components added. */
+    componentsAdded: number;
+    /** Number of components removed. */
+    componentsRemoved: number;
+    /** Number of components modified. */
+    componentsModified: number;
+    /** Number of links added. */
+    linksAdded: number;
+    /** Number of links removed. */
+    linksRemoved: number;
+}
+/**
+ * Complete diff between two graph versions.
+ */
+export interface GraphDiff {
+    /** Component changes. */
+    components: {
+        /** Components present in new graph but not old. */
+        added: Component[];
+        /** Components present in old graph but not new. */
+        removed: Component[];
+        /** Components present in both with different values. */
+        modified: ComponentModification[];
+    };
+    /** Link changes. */
+    links: {
+        /** Links present in new graph but not old. */
+        added: Link[];
+        /** Links present in old graph but not new. */
+        removed: Link[];
+    };
+    /** Summary statistics. */
+    stats: DiffStats;
+}
+/** Type of link between components. */
+export type LinkType = 'sync' | 'async';
+/**
+ * A step in an execution flow.
+ */
+export interface FlowStep {
+    /** The component at this step. */
+    component: Component;
+    /** Type of link leading to this step (undefined for entry point). */
+    linkType: LinkType | undefined;
+    /** Depth from entry point (0 = entry point). */
+    depth: number;
+    /** External links from this component to external systems. */
+    externalLinks: ExternalLink[];
+}
+/**
+ * An execution flow from entry point through the graph.
+ */
+export interface Flow {
+    /** The entry point component. */
+    entryPoint: Component;
+    /** Steps in the flow including entry point. */
+    steps: FlowStep[];
+}
+/**
+ * Result of searchWithFlow containing matches and their flow context.
+ */
+export interface SearchWithFlowResult {
+    /** IDs of components that matched the search. */
+    matchingIds: ComponentId[];
+    /** IDs of all components visible in the matching flows. */
+    visibleIds: ComponentId[];
+}
+/**
+ * A link that crosses domain boundaries.
+ */
+export interface CrossDomainLink {
+    /** The target domain name. */
+    targetDomain: DomainName;
+    /** Type of the cross-domain link. */
+    linkType: LinkType | undefined;
+}
+/**
+ * Summary of connections between domains.
+ */
+export interface DomainConnection {
+    /** The connected domain name. */
+    targetDomain: DomainName;
+    /** Direction relative to the queried domain. */
+    direction: 'outgoing' | 'incoming';
+    /** Number of API-based connections. */
+    apiCount: number;
+    /** Number of event-based connections. */
+    eventCount: number;
+}
+/**
+ * Aggregate statistics about a graph.
+ */
+export interface GraphStats {
+    /** Total number of components. */
+    componentCount: number;
+    /** Total number of links. */
+    linkCount: number;
+    /** Number of domains. */
+    domainCount: number;
+    /** Number of API components. */
+    apiCount: number;
+    /** Number of unique entities. */
+    entityCount: number;
+    /** Number of Event components. */
+    eventCount: number;
+}
+/**
+ * An external domain that components connect to.
+ *
+ * External domains are any systems not represented in the graph—third-party
+ * services (Stripe, Twilio) or internal domains outside the current scope.
+ */
+export interface ExternalDomain {
+    /** Name of the external domain (e.g., "Stripe", "Twilio"). */
+    name: string;
+    /** Domains that have connections to this external domain. */
+    sourceDomains: DomainName[];
+    /** Total number of connections to this external domain. */
+    connectionCount: number;
+}
+/**
+ * Parses a string as a ComponentId.
+ *
+ * @param id - The string to parse
+ * @returns A branded ComponentId
+ */
+export declare function parseComponentId(id: string): ComponentId;
+/**
+ * Parses a string as a LinkId.
+ *
+ * @param id - The string to parse
+ * @returns A branded LinkId
+ */
+export declare function parseLinkId(id: string): LinkId;
+/**
+ * Parses a string as an EntityName.
+ *
+ * @param value - The string to parse
+ * @returns A branded EntityName
+ */
+export declare function parseEntityName(value: string): EntityName;
+/**
+ * Parses a string as a DomainName.
+ *
+ * @param value - The string to parse
+ * @returns A branded DomainName
+ */
+export declare function parseDomainName(value: string): DomainName;
+/**
+ * Parses a string as a State.
+ *
+ * @param value - The string to parse
+ * @returns A branded State
+ */
+export declare function parseState(value: string): State;
+/**
+ * Parses a string as an OperationName.
+ *
+ * @param value - The string to parse
+ * @returns A branded OperationName
+ */
+export declare function parseOperationName(value: string): OperationName;
+/**
+ * Parses a string as an EventId.
+ *
+ * @param value - The string to parse
+ * @returns A branded EventId
+ */
+export declare function parseEventId(value: string): EventId;
+/**
+ * Parses a string as an EventName.
+ *
+ * @param value - The string to parse
+ * @returns A branded EventName
+ */
+export declare function parseEventName(value: string): EventName;
+/**
+ * Parses a string as a HandlerId.
+ *
+ * @param value - The string to parse
+ * @returns A branded HandlerId
+ */
+export declare function parseHandlerId(value: string): HandlerId;
+/**
+ * Parses a string as a HandlerName.
+ *
+ * @param value - The string to parse
+ * @returns A branded HandlerName
+ */
+export declare function parseHandlerName(value: string): HandlerName;
+export {};
+//# sourceMappingURL=domain-types.d.ts.map

package/dist/domain-types.d.ts.map

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

package/dist/domain-types.js

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+/** @internal */
+const componentIdSchema = z.string().brand();
+/** @internal */
+const linkIdSchema = z.string().brand();
+/** @internal */
+const entityNameSchema = z.string().brand();
+/** @internal */
+const domainNameSchema = z.string().brand();
+/** @internal */
+const stateSchema = z.string().brand();
+/** @internal */
+const operationNameSchema = z.string().brand();
+/** @internal */
+const eventIdSchema = z.string().brand();
+/** @internal */
+const eventNameSchema = z.string().brand();
+/** @internal */
+const handlerIdSchema = z.string().brand();
+/** @internal */
+const handlerNameSchema = z.string().brand();
+/**
+ * Parses a string as a ComponentId.
+ *
+ * @param id - The string to parse
+ * @returns A branded ComponentId
+ */
+export function parseComponentId(id) {
+    return componentIdSchema.parse(id);
+}
+/**
+ * Parses a string as a LinkId.
+ *
+ * @param id - The string to parse
+ * @returns A branded LinkId
+ */
+export function parseLinkId(id) {
+    return linkIdSchema.parse(id);
+}
+/**
+ * Parses a string as an EntityName.
+ *
+ * @param value - The string to parse
+ * @returns A branded EntityName
+ */
+export function parseEntityName(value) {
+    return entityNameSchema.parse(value);
+}
+/**
+ * Parses a string as a DomainName.
+ *
+ * @param value - The string to parse
+ * @returns A branded DomainName
+ */
+export function parseDomainName(value) {
+    return domainNameSchema.parse(value);
+}
+/**
+ * Parses a string as a State.
+ *
+ * @param value - The string to parse
+ * @returns A branded State
+ */
+export function parseState(value) {
+    return stateSchema.parse(value);
+}
+/**
+ * Parses a string as an OperationName.
+ *
+ * @param value - The string to parse
+ * @returns A branded OperationName
+ */
+export function parseOperationName(value) {
+    return operationNameSchema.parse(value);
+}
+/**
+ * Parses a string as an EventId.
+ *
+ * @param value - The string to parse
+ * @returns A branded EventId
+ */
+export function parseEventId(value) {
+    return eventIdSchema.parse(value);
+}
+/**
+ * Parses a string as an EventName.
+ *
+ * @param value - The string to parse
+ * @returns A branded EventName
+ */
+export function parseEventName(value) {
+    return eventNameSchema.parse(value);
+}
+/**
+ * Parses a string as a HandlerId.
+ *
+ * @param value - The string to parse
+ * @returns A branded HandlerId
+ */
+export function parseHandlerId(value) {
+    return handlerIdSchema.parse(value);
+}
+/**
+ * Parses a string as a HandlerName.
+ *
+ * @param value - The string to parse
+ * @returns A branded HandlerName
+ */
+export function parseHandlerName(value) {
+    return handlerNameSchema.parse(value);
+}

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class ComponentNotFoundError extends Error {
+    readonly componentId: string;
+    readonly suggestions: string[];
+    constructor(componentId: string, suggestions?: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAA;gBAElB,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO;CAM5D"}

package/dist/errors.js

@@ -0,0 +1,10 @@
+export class ComponentNotFoundError extends Error {
+    componentId;
+    suggestions;
+    constructor(componentId, suggestions = []) {
+        super(`Component '${componentId}' not found`);
+        this.name = 'ComponentNotFoundError';
+        this.componentId = componentId;
+        this.suggestions = suggestions;
+    }
+}

package/dist/event-queries.d.ts

@@ -0,0 +1,5 @@
+import type { RiviereGraph } from '@living-architecture/riviere-schema';
+import type { PublishedEvent, EventHandlerInfo } from './event-types';
+export declare function queryPublishedEvents(graph: RiviereGraph, domainName?: string): PublishedEvent[];
+export declare function queryEventHandlers(graph: RiviereGraph, eventName?: string): EventHandlerInfo[];
+//# sourceMappingURL=event-queries.d.ts.map

package/dist/event-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-queries.d.ts","sourceRoot":"","sources":["../src/event-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAyC,MAAM,qCAAqC,CAAA;AAC9G,OAAO,KAAK,EAAE,cAAc,EAAmB,gBAAgB,EAAwC,MAAM,eAAe,CAAA;AAG5H,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAU/F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAK9F"}

package/dist/event-queries.js

@@ -0,0 +1,32 @@
+import { parseDomainName, parseEventId, parseEventName, parseHandlerId, parseHandlerName } from './domain-types';
+export function queryPublishedEvents(graph, domainName) {
+    const eventComponents = graph.components.filter((c) => c.type === 'Event');
+    const filtered = domainName ? eventComponents.filter((e) => e.domain === domainName) : eventComponents;
+    const handlers = graph.components.filter((c) => c.type === 'EventHandler');
+    return filtered.map((event) => {
+        const subscribers = handlers.filter((h) => h.subscribedEvents.includes(event.eventName))
+            .map((h) => ({ handlerId: parseHandlerId(h.id), handlerName: parseHandlerName(h.name), domain: parseDomainName(h.domain) }));
+        return { id: parseEventId(event.id), eventName: parseEventName(event.eventName), domain: parseDomainName(event.domain), handlers: subscribers };
+    });
+}
+export function queryEventHandlers(graph, eventName) {
+    const eventByName = buildEventNameMap(graph);
+    const handlers = findEventHandlerComponents(graph);
+    const filtered = eventName ? handlers.filter((h) => h.subscribedEvents.includes(eventName)) : handlers;
+    return filtered.map((h) => buildEventHandlerInfo(h, eventByName));
+}
+function buildEventNameMap(graph) {
+    return new Map(graph.components.filter((c) => c.type === 'Event').map((e) => [e.eventName, e]));
+}
+function findEventHandlerComponents(graph) {
+    return graph.components.filter((c) => c.type === 'EventHandler');
+}
+function buildEventHandlerInfo(handler, eventByName) {
+    const subscribedEventsWithDomain = handler.subscribedEvents.map((name) => {
+        const event = eventByName.get(name);
+        if (event)
+            return { eventName: parseEventName(name), sourceDomain: parseDomainName(event.domain), sourceKnown: true };
+        return { eventName: parseEventName(name), sourceKnown: false };
+    });
+    return { id: parseHandlerId(handler.id), handlerName: parseHandlerName(handler.name), domain: parseDomainName(handler.domain), subscribedEvents: handler.subscribedEvents.map(parseEventName), subscribedEventsWithDomain };
+}