local-serverless-stack 1.0.0 → 1.1.0

package/dist/server/services/service-graph.d.ts

@@ -0,0 +1,76 @@
+import type { Resource } from './cloudformation-parser.js';
+import type { RegisteredFunction, HttpRoute, AuthorizerConfig } from './serverless-state-parser.js';
+/**
+ * What a node stands for. `route` and `iam-role` have no counterpart in the
+ * parser's `Resource` union: a route is declared in `serverless-state.json`
+ * (never as a CFN resource LSS parses), and a role is deliberately not parsed.
+ * `external` is anything this service references but does not declare — the
+ * cross-service edges, which are the whole reason a monorepo needs one stack.
+ */
+export type GraphNodeKind = 'lambda' | 'dynamodb' | 'sqs' | 'sns' | 's3' | 'eventbus' | 'event-rule' | 'opensearch' | 'secret' | 'route' | 'iam-role' | 'external';
+export interface GraphNode {
+    id: string;
+    kind: GraphNodeKind;
+    label: string;
+    logicalId?: string;
+    method?: string;
+    path?: string;
+    fullName?: string;
+    handler?: string;
+    arn?: string;
+    service?: string;
+}
+/**
+ * How an edge was established. The distinction is the point of the whole
+ * payload: `iam` and `env` are far weaker evidence than the rest, and a
+ * diagram that draws them identically lies about what it knows.
+ */
+export type GraphEdgeKind = 'http-route' | 'authorizer' | 'event-source' | 's3-notification' | 'event-rule-target' | 'event-bus-rule' | 'sns-subscription' | 'redrive' | 'iam' | 'env';
+export interface GraphEdge {
+    id: string;
+    from: string;
+    to: string;
+    kind: GraphEdgeKind;
+    detail?: string;
+    confidence: 'declared' | 'inferred';
+    serviceWide?: boolean;
+}
+export interface ServiceGraph {
+    service: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    edgeKinds: GraphEdgeKind[];
+    warnings: string[];
+}
+export interface BuildServiceGraphInput {
+    serviceName: string;
+    template: unknown;
+    resources: Resource[];
+    region?: string;
+    functions?: RegisteredFunction[];
+    routes?: HttpRoute[];
+    authorizers?: AuthorizerConfig[];
+}
+/**
+ * Reduce an ARN to the (aws service, resource name) pair a declared resource
+ * would be indexed under.
+ *
+ * The sub-resource suffixes matter: a policy that grants `dynamodb:Query` on
+ * `…:table/Orders/index/*` is about the Orders TABLE, and a stream ARN carries
+ * a creation timestamp nobody can predict at synth time. Secrets are the one
+ * kind that cannot be matched exactly — AWS appends six random characters at
+ * create time — so they match by prefix at the call site.
+ */
+export declare function parseResourceArn(arn: string): {
+    service: string;
+    name: string;
+} | null;
+/**
+ * Builds the wiring graph for one service.
+ *
+ * Pure: no I/O, no engine calls, no clock. Everything it needs is the template
+ * the registrar cached and the metadata that came with it — which is what lets
+ * the unit suite cover every edge kind from hand-written templates.
+ */
+export declare function buildServiceGraph(input: BuildServiceGraphInput): ServiceGraph;
+//# sourceMappingURL=service-graph.d.ts.map

package/dist/server/services/service-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-graph.d.ts","sourceRoot":"","sources":["../../../src/server/services/service-graph.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,QAAQ,EAYT,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAepG;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,UAAU,GACV,KAAK,GACL,KAAK,GACL,IAAI,GACJ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IAIxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IAIpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,GAClB,SAAS,GACT,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IAGpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAIhB,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;IAMpC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IAGnB,SAAS,EAAE,aAAa,EAAE,CAAC;IAI3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,OAAO,CAAC;IAElB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AA4DD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkCtF;AAkDD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CA6I7E"}