Aws/event Topology
Event topology observation — discovers the directed graph of event relationships across EventBridge, SNS, SQS, and Lambda event source mappings. Produces a unified graph of nodes and edges with connected component analysis, boundary detection, and hub identification.
Methods
- discover — Single fan-out observation: queries all 4 services in parallel, produces unified graph with nodes, edges, and computed statistics
- analyze — Pure data-layer queries against stored graph: hubs, boundaries, orphans, connected components, and node-centric path queries
2026.07.24.1
Changed: Bump AWS SDK from 3.1091.0 to 3.1094.0 (patch-level update).
Global Arguments
| Argument | Type | Description |
|---|---|---|
| profile? | string | AWS profile to use |
| region? | string | AWS region |
| Argument | Type | Description |
|---|---|---|
| maxRulesPerBus? | number | Max EventBridge rules to fetch per bus |
| maxTopics? | number | Max SNS topics to enumerate |
| maxQueues? | number | Max SQS queues to enumerate |
| Argument | Type | Description |
|---|---|---|
| query | enum | Analysis query type |
| nodeId? | string | Node ID for path queries |
| threshold? | number | Degree threshold for hub detection |
Resources
2026.07.21.1
Changed: Bumped AWS SDK dependencies to 3.1091.0 (from 3.1090.0).
Upgrade note: No behavioral changes. Routine dependency maintenance.
2026.07.18.2
Added: An upgrades array entry (no-op) to event_topology.ts for proper
typeVersion tracking on existing instances. No schema or behavior changes.
2026.07.18.1
Changed: Bumped @aws-sdk/client-eventbridge, @aws-sdk/client-lambda,
@aws-sdk/client-sns, @aws-sdk/client-sqs, @aws-sdk/client-sts, and
@aws-sdk/credential-providers from 3.1069.0 to 3.1090.0 for dependency
freshness. No behavior change.
2026.07.13.1
Changed: Upgraded the AWS SDK v3 client pins from 3.821.0 to 3.1069.0
(eventbridge, sns, sqs, lambda, sts, credential-providers), bringing this
extension in line with the rest of the repo's AWS models.
Fixed: The per-topic SNS subscription listing and the Lambda event-source
mapping listing paginated with no upper bound. Both now stop after a defensive
MAX_PAGES (50) ceiling and log a warning, preventing an unbounded discovery
loop on pathological accounts. Rule/topic/queue listings were already bounded by
their max* arguments and are unchanged.
Added: A truncated boolean on the graph resource. It is set to true
whenever either pagination cap fires, so downstream consumers can distinguish an
incomplete graph from a complete one. The field defaults to false, so graphs
stored before this release still validate on read.
2026.07.18.1
Changed: Bumped @aws-sdk/client-eventbridge, @aws-sdk/client-lambda,
@aws-sdk/client-sns, @aws-sdk/client-sqs, @aws-sdk/client-sts, and
@aws-sdk/credential-providers from 3.1069.0 to 3.1090.0 for dependency
freshness. No behavior change.
2026.07.13.1
Changed: Upgraded the AWS SDK v3 client pins from 3.821.0 to 3.1069.0
(eventbridge, sns, sqs, lambda, sts, credential-providers), bringing this
extension in line with the rest of the repo's AWS models.
Fixed: The per-topic SNS subscription listing and the Lambda event-source
mapping listing paginated with no upper bound. Both now stop after a defensive
MAX_PAGES (50) ceiling and log a warning, preventing an unbounded discovery
loop on pathological accounts. Rule/topic/queue listings were already bounded by
their max* arguments and are unchanged.
Added: A truncated boolean on the graph resource. It is set to true
whenever either pagination cap fires, so downstream consumers can distinguish an
incomplete graph from a complete one. The field defaults to false, so graphs
stored before this release still validate on read.
2026.07.13.1
Changed: Upgraded the AWS SDK v3 client pins from 3.821.0 to 3.1069.0
(eventbridge, sns, sqs, lambda, sts, credential-providers), bringing this
extension in line with the rest of the repo's AWS models.
Fixed: The per-topic SNS subscription listing and the Lambda event-source
mapping listing paginated with no upper bound. Both now stop after a defensive
MAX_PAGES (50) ceiling and log a warning, preventing an unbounded discovery
loop on pathological accounts. Rule/topic/queue listings were already bounded by
their max* arguments and are unchanged.
Added: A truncated boolean on the graph resource. It is set to true
whenever either pagination cap fires, so downstream consumers can distinguish an
incomplete graph from a complete one. The field defaults to false, so graphs
stored before this release still validate on read.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned