@suss/manifest-aws 0.0.1 → 0.1.0

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(index_exports, {
   CLOUDFORMATION_YAML_TAGS: () => CLOUDFORMATION_YAML_TAGS,
   loadCloudFormationTemplate: () => loadCloudFormationTemplate,
   parseHandler: () => parseHandler,
+  readAppSyncResolvers: () => readAppSyncResolvers,
   readServerlessFunctions: () => readServerlessFunctions,
   refTarget: () => refTarget
 });
@@ -100,6 +101,165 @@ function refTarget(value) {
   return null;
 }
 
+// src/appsyncResolvers.ts
+var LAMBDA_CATEGORIES = ["Lambda", "Lambdas"];
+function readAppSyncResolvers(template) {
+  const resources = template.Resources ?? {};
+  return [
+    ...fromServerlessShorthand(resources),
+    ...fromRawResources(resources)
+  ];
+}
+function fromServerlessShorthand(resources) {
+  const bindings = [];
+  for (const resource of Object.values(resources)) {
+    if (resource?.Type !== "AWS::Serverless::GraphQLApi") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const lambdaByDataSource = shorthandDataSources(props.DataSources);
+    const dataSourceByFunction = shorthandFunctions(props.Functions);
+    for (const [typeName, fields] of entriesOf(props.Resolvers)) {
+      for (const [fieldName, config] of entriesOf(fields)) {
+        const dataSources = dataSourcesReached(config, dataSourceByFunction);
+        bindings.push({
+          typeName,
+          fieldName,
+          lambdaFunctionLogicalIds: dataSources.map((name) => lambdaByDataSource.get(name) ?? null).filter((id) => id !== null)
+        });
+      }
+    }
+  }
+  return bindings;
+}
+function shorthandDataSources(block) {
+  const out = /* @__PURE__ */ new Map();
+  for (const [category, entries] of entriesOf(block)) {
+    if (!LAMBDA_CATEGORIES.includes(category)) {
+      continue;
+    }
+    for (const [name, config] of entriesOf(entries)) {
+      const props = asRecord(config);
+      out.set(name, props === null ? null : refTarget(props.FunctionArn));
+    }
+  }
+  return out;
+}
+function shorthandFunctions(block) {
+  const out = /* @__PURE__ */ new Map();
+  for (const [name, config] of entriesOf(block)) {
+    const props = asRecord(config);
+    const dataSource = props === null ? null : stringOf(props.DataSource);
+    if (dataSource !== null) {
+      out.set(name, dataSource);
+    }
+  }
+  return out;
+}
+function dataSourcesReached(config, dataSourceByFunction) {
+  const props = asRecord(config);
+  if (props === null) {
+    return [];
+  }
+  const direct = stringOf(props.DataSource);
+  if (direct !== null) {
+    return [direct];
+  }
+  const pipeline = Array.isArray(props.Pipeline) ? props.Pipeline : [];
+  return pipeline.map((name) => dataSourceByFunction.get(String(name))).filter((name) => name !== void 0);
+}
+function fromRawResources(resources) {
+  const lambdaByLogicalId = /* @__PURE__ */ new Map();
+  const lambdaByApiAndName = /* @__PURE__ */ new Map();
+  for (const [logicalId, resource] of Object.entries(resources)) {
+    if (resource?.Type !== "AWS::AppSync::DataSource") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const lambdaConfig = asRecord(props.LambdaConfig);
+    const lambda = lambdaConfig === null ? null : refTarget(lambdaConfig.LambdaFunctionArn);
+    if (lambda === null) {
+      continue;
+    }
+    lambdaByLogicalId.set(logicalId, lambda);
+    const name = stringOf(props.Name);
+    if (name !== null) {
+      lambdaByApiAndName.set(
+        apiScopedKey(refTarget(props.ApiId), name),
+        lambda
+      );
+    }
+  }
+  const dataSourceByLogicalId = /* @__PURE__ */ new Map();
+  const dataSourceByApiAndName = /* @__PURE__ */ new Map();
+  for (const [logicalId, resource] of Object.entries(resources)) {
+    if (resource?.Type !== "AWS::AppSync::FunctionConfiguration") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const dataSource = refTarget(props.DataSourceName);
+    if (dataSource === null) {
+      continue;
+    }
+    dataSourceByLogicalId.set(logicalId, dataSource);
+    const name = stringOf(props.Name);
+    if (name !== null) {
+      dataSourceByApiAndName.set(
+        apiScopedKey(refTarget(props.ApiId), name),
+        dataSource
+      );
+    }
+  }
+  const bindings = [];
+  for (const resource of Object.values(resources)) {
+    if (resource?.Type !== "AWS::AppSync::Resolver") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const typeName = stringOf(props.TypeName);
+    const fieldName = stringOf(props.FieldName);
+    if (typeName === null || fieldName === null) {
+      continue;
+    }
+    const apiId = refTarget(props.ApiId);
+    const lookup = (byLogicalId, byName) => (reference) => byLogicalId.get(reference) ?? byName.get(apiScopedKey(apiId, reference));
+    bindings.push({
+      typeName,
+      fieldName,
+      lambdaFunctionLogicalIds: rawDataSourcesReached(
+        props,
+        lookup(dataSourceByLogicalId, dataSourceByApiAndName)
+      ).map(lookup(lambdaByLogicalId, lambdaByApiAndName)).filter((id) => id !== void 0)
+    });
+  }
+  return bindings;
+}
+function apiScopedKey(apiId, name) {
+  return `${apiId ?? ""}::${name}`;
+}
+function rawDataSourcesReached(props, dataSourceOf) {
+  const direct = refTarget(props.DataSourceName);
+  if (direct !== null) {
+    return [direct];
+  }
+  const pipeline = asRecord(props.PipelineConfig);
+  const functions = Array.isArray(pipeline?.Functions) ? pipeline.Functions : [];
+  return functions.map((fn) => {
+    const reference = refTarget(fn);
+    return reference === null ? void 0 : dataSourceOf(reference);
+  }).filter((name) => name !== void 0);
+}
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function entriesOf(value) {
+  const record = asRecord(value);
+  return record === null ? [] : Object.entries(record);
+}
+function stringOf(value) {
+  return typeof value === "string" ? value : null;
+}
+
 // src/serverlessFunctions.ts
 function parseHandler(handler) {
   const trimmed = handler.trim();
@@ -201,6 +361,7 @@ function readServerlessFunctions(template) {
   CLOUDFORMATION_YAML_TAGS,
   loadCloudFormationTemplate,
   parseHandler,
+  readAppSyncResolvers,
   readServerlessFunctions,
   refTarget
 });

package/dist/index.d.cts

@@ -44,6 +44,24 @@ declare function loadCloudFormationTemplate(templatePath: string): CloudFormatio
  */
 declare function refTarget(value: unknown): string | null;
 
+/** One GraphQL field and the Lambdas behind it. */
+interface AppSyncResolverBinding {
+    typeName: string;
+    fieldName: string;
+    /**
+     * Every Lambda a request for this field runs, in pipeline order.
+     * Usually one. A pipeline can chain several, and nothing in the
+     * template says which of them is the one that produces the value:
+     * the first is as often an auth step as it is the resolver, and the
+     * last is as often a formatter. So all of them are reported, and a
+     * reader that needs to pick says so itself.
+     *
+     * Empty when the field is served by something other than a Lambda.
+     */
+    lambdaFunctionLogicalIds: string[];
+}
+declare function readAppSyncResolvers(template: CloudFormationTemplate): AppSyncResolverBinding[];
+
 /** A route-bearing SAM Event (`Type: Api` or `Type: HttpApi`). */
 interface ServerlessHttpRoute {
     /** Key of the event in the function's `Events` map. */
@@ -104,4 +122,4 @@ declare function parseHandler(handler: string): ParsedHandler | null;
  */
 declare function readServerlessFunctions(template: CloudFormationTemplate): ServerlessFunctionInfo[];
 
-export { CLOUDFORMATION_YAML_TAGS, type CloudFormationResource, type CloudFormationTemplate, type ParsedHandler, type ServerlessFunctionInfo, type ServerlessHttpRoute, type ServerlessNonHttpEvent, loadCloudFormationTemplate, parseHandler, readServerlessFunctions, refTarget };
+export { type AppSyncResolverBinding, CLOUDFORMATION_YAML_TAGS, type CloudFormationResource, type CloudFormationTemplate, type ParsedHandler, type ServerlessFunctionInfo, type ServerlessHttpRoute, type ServerlessNonHttpEvent, loadCloudFormationTemplate, parseHandler, readAppSyncResolvers, readServerlessFunctions, refTarget };

package/dist/index.d.ts

@@ -44,6 +44,24 @@ declare function loadCloudFormationTemplate(templatePath: string): CloudFormatio
  */
 declare function refTarget(value: unknown): string | null;
 
+/** One GraphQL field and the Lambdas behind it. */
+interface AppSyncResolverBinding {
+    typeName: string;
+    fieldName: string;
+    /**
+     * Every Lambda a request for this field runs, in pipeline order.
+     * Usually one. A pipeline can chain several, and nothing in the
+     * template says which of them is the one that produces the value:
+     * the first is as often an auth step as it is the resolver, and the
+     * last is as often a formatter. So all of them are reported, and a
+     * reader that needs to pick says so itself.
+     *
+     * Empty when the field is served by something other than a Lambda.
+     */
+    lambdaFunctionLogicalIds: string[];
+}
+declare function readAppSyncResolvers(template: CloudFormationTemplate): AppSyncResolverBinding[];
+
 /** A route-bearing SAM Event (`Type: Api` or `Type: HttpApi`). */
 interface ServerlessHttpRoute {
     /** Key of the event in the function's `Events` map. */
@@ -104,4 +122,4 @@ declare function parseHandler(handler: string): ParsedHandler | null;
  */
 declare function readServerlessFunctions(template: CloudFormationTemplate): ServerlessFunctionInfo[];
 
-export { CLOUDFORMATION_YAML_TAGS, type CloudFormationResource, type CloudFormationTemplate, type ParsedHandler, type ServerlessFunctionInfo, type ServerlessHttpRoute, type ServerlessNonHttpEvent, loadCloudFormationTemplate, parseHandler, readServerlessFunctions, refTarget };
+export { type AppSyncResolverBinding, CLOUDFORMATION_YAML_TAGS, type CloudFormationResource, type CloudFormationTemplate, type ParsedHandler, type ServerlessFunctionInfo, type ServerlessHttpRoute, type ServerlessNonHttpEvent, loadCloudFormationTemplate, parseHandler, readAppSyncResolvers, readServerlessFunctions, refTarget };

package/dist/index.js

@@ -60,6 +60,165 @@ function refTarget(value) {
   return null;
 }
 
+// src/appsyncResolvers.ts
+var LAMBDA_CATEGORIES = ["Lambda", "Lambdas"];
+function readAppSyncResolvers(template) {
+  const resources = template.Resources ?? {};
+  return [
+    ...fromServerlessShorthand(resources),
+    ...fromRawResources(resources)
+  ];
+}
+function fromServerlessShorthand(resources) {
+  const bindings = [];
+  for (const resource of Object.values(resources)) {
+    if (resource?.Type !== "AWS::Serverless::GraphQLApi") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const lambdaByDataSource = shorthandDataSources(props.DataSources);
+    const dataSourceByFunction = shorthandFunctions(props.Functions);
+    for (const [typeName, fields] of entriesOf(props.Resolvers)) {
+      for (const [fieldName, config] of entriesOf(fields)) {
+        const dataSources = dataSourcesReached(config, dataSourceByFunction);
+        bindings.push({
+          typeName,
+          fieldName,
+          lambdaFunctionLogicalIds: dataSources.map((name) => lambdaByDataSource.get(name) ?? null).filter((id) => id !== null)
+        });
+      }
+    }
+  }
+  return bindings;
+}
+function shorthandDataSources(block) {
+  const out = /* @__PURE__ */ new Map();
+  for (const [category, entries] of entriesOf(block)) {
+    if (!LAMBDA_CATEGORIES.includes(category)) {
+      continue;
+    }
+    for (const [name, config] of entriesOf(entries)) {
+      const props = asRecord(config);
+      out.set(name, props === null ? null : refTarget(props.FunctionArn));
+    }
+  }
+  return out;
+}
+function shorthandFunctions(block) {
+  const out = /* @__PURE__ */ new Map();
+  for (const [name, config] of entriesOf(block)) {
+    const props = asRecord(config);
+    const dataSource = props === null ? null : stringOf(props.DataSource);
+    if (dataSource !== null) {
+      out.set(name, dataSource);
+    }
+  }
+  return out;
+}
+function dataSourcesReached(config, dataSourceByFunction) {
+  const props = asRecord(config);
+  if (props === null) {
+    return [];
+  }
+  const direct = stringOf(props.DataSource);
+  if (direct !== null) {
+    return [direct];
+  }
+  const pipeline = Array.isArray(props.Pipeline) ? props.Pipeline : [];
+  return pipeline.map((name) => dataSourceByFunction.get(String(name))).filter((name) => name !== void 0);
+}
+function fromRawResources(resources) {
+  const lambdaByLogicalId = /* @__PURE__ */ new Map();
+  const lambdaByApiAndName = /* @__PURE__ */ new Map();
+  for (const [logicalId, resource] of Object.entries(resources)) {
+    if (resource?.Type !== "AWS::AppSync::DataSource") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const lambdaConfig = asRecord(props.LambdaConfig);
+    const lambda = lambdaConfig === null ? null : refTarget(lambdaConfig.LambdaFunctionArn);
+    if (lambda === null) {
+      continue;
+    }
+    lambdaByLogicalId.set(logicalId, lambda);
+    const name = stringOf(props.Name);
+    if (name !== null) {
+      lambdaByApiAndName.set(
+        apiScopedKey(refTarget(props.ApiId), name),
+        lambda
+      );
+    }
+  }
+  const dataSourceByLogicalId = /* @__PURE__ */ new Map();
+  const dataSourceByApiAndName = /* @__PURE__ */ new Map();
+  for (const [logicalId, resource] of Object.entries(resources)) {
+    if (resource?.Type !== "AWS::AppSync::FunctionConfiguration") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const dataSource = refTarget(props.DataSourceName);
+    if (dataSource === null) {
+      continue;
+    }
+    dataSourceByLogicalId.set(logicalId, dataSource);
+    const name = stringOf(props.Name);
+    if (name !== null) {
+      dataSourceByApiAndName.set(
+        apiScopedKey(refTarget(props.ApiId), name),
+        dataSource
+      );
+    }
+  }
+  const bindings = [];
+  for (const resource of Object.values(resources)) {
+    if (resource?.Type !== "AWS::AppSync::Resolver") {
+      continue;
+    }
+    const props = asRecord(resource.Properties) ?? {};
+    const typeName = stringOf(props.TypeName);
+    const fieldName = stringOf(props.FieldName);
+    if (typeName === null || fieldName === null) {
+      continue;
+    }
+    const apiId = refTarget(props.ApiId);
+    const lookup = (byLogicalId, byName) => (reference) => byLogicalId.get(reference) ?? byName.get(apiScopedKey(apiId, reference));
+    bindings.push({
+      typeName,
+      fieldName,
+      lambdaFunctionLogicalIds: rawDataSourcesReached(
+        props,
+        lookup(dataSourceByLogicalId, dataSourceByApiAndName)
+      ).map(lookup(lambdaByLogicalId, lambdaByApiAndName)).filter((id) => id !== void 0)
+    });
+  }
+  return bindings;
+}
+function apiScopedKey(apiId, name) {
+  return `${apiId ?? ""}::${name}`;
+}
+function rawDataSourcesReached(props, dataSourceOf) {
+  const direct = refTarget(props.DataSourceName);
+  if (direct !== null) {
+    return [direct];
+  }
+  const pipeline = asRecord(props.PipelineConfig);
+  const functions = Array.isArray(pipeline?.Functions) ? pipeline.Functions : [];
+  return functions.map((fn) => {
+    const reference = refTarget(fn);
+    return reference === null ? void 0 : dataSourceOf(reference);
+  }).filter((name) => name !== void 0);
+}
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function entriesOf(value) {
+  const record = asRecord(value);
+  return record === null ? [] : Object.entries(record);
+}
+function stringOf(value) {
+  return typeof value === "string" ? value : null;
+}
+
 // src/serverlessFunctions.ts
 function parseHandler(handler) {
   const trimmed = handler.trim();
@@ -160,6 +319,7 @@ export {
   CLOUDFORMATION_YAML_TAGS,
   loadCloudFormationTemplate,
   parseHandler,
+  readAppSyncResolvers,
   readServerlessFunctions,
   refTarget
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/manifest-aws",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "type": "module",
   "description": "Parse AWS CloudFormation / SAM templates into plain data — the shared facts layer contract readers and manifest-driven framework packs both consume.",
   "keywords": [