@suss/packs 0.14.1 → 0.15.0

package/dist/aws-eventbridge.js

@@ -1,190 +1,8 @@
 // ../framework/aws-eventbridge/dist/index.js
-import {
-  Node as N
-} from "ts-morph";
-import { readConfiguredCall, rootIdentifier } from "@suss/adapter-typescript";
-import { formatChannel, messageBusBinding } from "@suss/behavioral-ir";
-import { unwrapJsonStringify } from "@suss/extractor";
-var SEND_COMMANDS = {
-  PutEventsCommand: "putEvents"
-};
-function eventBridgeRecognizer(call, ctx) {
-  const callNode = call;
-  const recognizerCtx = ctx;
-  const resolveValue = recognizerCtx.resolveWrittenValue ?? (() => null);
-  const calleeExpr = callNode.getExpression();
-  if (!N.isPropertyAccessExpression(calleeExpr)) {
-    return null;
-  }
-  if (calleeExpr.getName() !== "send") {
-    return null;
-  }
-  const args = callNode.getArguments();
-  if (args.length === 0) {
-    return null;
-  }
-  const firstArg = args[0];
-  if (!N.isNewExpression(firstArg)) {
-    return null;
-  }
-  const ctorExpr = firstArg.getExpression();
-  const ctorLeafName = N.isPropertyAccessExpression(ctorExpr) ? ctorExpr.getName() : ctorExpr.getText();
-  if (SEND_COMMANDS[ctorLeafName] === void 0) {
-    return null;
-  }
-  const importCheckTarget = N.isPropertyAccessExpression(ctorExpr) ? rootIdentifier(ctorExpr) : ctorExpr;
-  if (importCheckTarget === null || !recognizerCtx.isImportedFrom(
-    importCheckTarget,
-    "@aws-sdk/client-eventbridge"
-  )) {
-    return null;
-  }
-  const callArgs = recognizerCtx.extractArgs();
-  const entries = readEntries(callArgs);
-  if (entries === null) {
-    return null;
-  }
-  const callee = callNode.getExpression().getText();
-  const astEntries = readAstEntries(firstArg);
-  const effects = [];
-  for (const [index, entry] of entries.entries()) {
-    const effect = buildEntryEffect(
-      entry,
-      callee,
-      astEntries?.[index],
-      resolveValue
-    );
-    if (effect !== null) {
-      effects.push(effect);
-    }
-  }
-  return effects.length > 0 ? effects : null;
-}
-function readAstEntries(command) {
-  if (!N.isNewExpression(command)) {
-    return null;
-  }
-  const input = command.getArguments()[0];
-  if (input === void 0 || !N.isObjectLiteralExpression(input)) {
-    return null;
-  }
-  for (const prop of input.getProperties()) {
-    if (!N.isPropertyAssignment(prop) || prop.getName() !== "Entries") {
-      continue;
-    }
-    const init = prop.getInitializer();
-    if (init === void 0 || !N.isArrayLiteralExpression(init)) {
-      return null;
-    }
-    return init.getElements();
-  }
-  return null;
-}
-function astField(entry, name) {
-  if (entry === void 0 || !N.isObjectLiteralExpression(entry)) {
-    return null;
-  }
-  for (const prop of entry.getProperties()) {
-    if (N.isPropertyAssignment(prop) && prop.getName() === name) {
-      return prop.getInitializer() ?? null;
-    }
-  }
-  return null;
-}
-function busTokenOf(expr) {
-  if (N.isStringLiteral(expr)) {
-    const value = expr.getLiteralValue();
-    return value === "" ? null : value;
-  }
-  const match = expr.getText().match(/^process\.env\.(\w+)$/);
-  return match === null ? null : match[1] ?? null;
-}
-function detailTypeOf(expr) {
-  if (!N.isStringLiteral(expr)) {
-    return null;
-  }
-  const value = expr.getLiteralValue();
-  return value === "" ? null : value;
-}
-function resolvedHalf(entry, name, readToken, resolve) {
-  const expr = astField(entry, name);
-  if (expr === null) {
-    return null;
-  }
-  const direct = readToken(expr);
-  if (direct !== null) {
-    return direct;
-  }
-  const resolved = resolve(expr);
-  return resolved === null ? null : readToken(resolved);
-}
-function readEntries(callArgs) {
-  const commandArg = callArgs[0];
-  if (!isEffectArgOfKind(commandArg, "call")) {
-    return null;
-  }
-  const ctorArgs = commandArg.args ?? [];
-  const inputArg = ctorArgs[0];
-  if (!isEffectArgOfKind(inputArg, "object")) {
-    return null;
-  }
-  const fields = inputArg.fields;
-  const entriesArg = fields?.Entries;
-  if (!isEffectArgOfKind(entriesArg, "array")) {
-    return null;
-  }
-  return entriesArg.items ?? [];
-}
-function buildEntryEffect(entry, callee, astEntry, resolve) {
-  if (!isEffectArgOfKind(entry, "object")) {
-    return null;
-  }
-  const fields = entry.fields;
-  const bus = fields.EventBusName === void 0 ? readBusToken(void 0) : resolvedHalf(astEntry, "EventBusName", busTokenOf, resolve) ?? readBusToken(fields.EventBusName);
-  const detailType = resolvedHalf(astEntry, "DetailType", detailTypeOf, resolve) ?? readLiteralString(fields.DetailType);
-  const channel = bus === null || detailType === null ? null : formatChannel(bus, detailType);
-  const body = unwrapJsonStringify(fields.Detail ?? null);
-  const source = readLiteralString(fields.Source);
-  return {
-    type: "interaction",
-    binding: messageBusBinding({
-      recognition: "@suss/framework-aws-eventbridge",
-      messageBus: "eventbridge",
-      channel
-    }),
-    callee,
-    interaction: {
-      class: "message-send",
-      ...body !== null ? { body } : {},
-      ...source !== null ? { routingKey: source } : {}
-    }
-  };
-}
-function readBusToken(arg) {
-  if (arg === void 0) {
-    return "default";
-  }
-  if (isEffectArgOfKind(arg, "string")) {
-    const value = arg.value;
-    return value === "" ? null : value;
-  }
-  if (isEffectArgOfKind(arg, "identifier")) {
-    const name = arg.name;
-    const match = name.match(/^process\.env\.(\w+)$/);
-    return match !== null ? match[1] : null;
-  }
-  return null;
-}
-function readLiteralString(arg) {
-  if (isEffectArgOfKind(arg, "string")) {
-    const value = arg.value;
-    return value === "" ? null : value;
-  }
-  return null;
-}
-function isEffectArgOfKind(arg, kind) {
-  return arg !== null && arg !== void 0 && typeof arg === "object" && arg.kind === kind;
-}
+import { readConfiguredCall } from "@suss/adapter-typescript";
+import { messageBusBinding } from "@suss/behavioral-ir";
+import { constructedFrom, messageSends, pack } from "@suss/recognize";
+var EVENTBRIDGE = "@aws-sdk/client-eventbridge";
 function configuredProducerRecognizer(spec) {
   return ((call, ctx) => {
     const read = readConfiguredCall(
@@ -214,25 +32,52 @@ function configuredProducerRecognizer(spec) {
 }
 function eventBridgeFramework(options = {}) {
   const producers = options.producers ?? [];
-  return {
-    name: "eventbridge",
-    protocol: "eventbridge",
-    languages: ["typescript", "javascript"],
-    discovery: [],
-    terminals: [],
-    inputMapping: { type: "positionalParams", params: [] },
-    // Skip files that don't import `@aws-sdk/client-eventbridge`.
-    requiresImport: [
-      .../* @__PURE__ */ new Set([
-        "@aws-sdk/client-eventbridge",
-        ...producers.map((p) => p.module)
-      ])
+  return pack(
+    "eventbridge",
+    [
+      messageSends({
+        wire: "eventbridge",
+        client: constructedFrom(EVENTBRIDGE),
+        messages: { each: "in", property: "Entries" },
+        channel: [
+          {
+            property: "EventBusName",
+            whenAbsent: "default",
+            unsettled: "reference"
+          },
+          { property: "DetailType", unsettled: "nothing" }
+        ],
+        unsettledName: "nothing",
+        routingKey: "Source",
+        body: "Detail"
+      }).methods({
+        send: {
+          input: {
+            at: 0,
+            of: [
+              {
+                to: "argument",
+                at: 0,
+                origin: constructedFrom({
+                  from: [EVENTBRIDGE],
+                  named: ["PutEventsCommand"]
+                })
+              }
+            ]
+          }
+        }
+      }).example(
+        'client.send(new PutEventsCommand({ Entries: [{ DetailType: "OrderPlaced", Detail: "{}" }] }))'
+      )
     ],
-    invocationRecognizers: [
-      eventBridgeRecognizer,
-      ...producers.map(configuredProducerRecognizer)
-    ]
-  };
+    {
+      languages: ["typescript", "javascript"],
+      recognizedAs: "@suss/framework-aws-eventbridge",
+      protocol: "eventbridge",
+      requiresImport: producers.map((p) => p.module),
+      recognizers: producers.map(configuredProducerRecognizer)
+    }
+  );
 }
 var index_default = eventBridgeFramework;
 export {

package/dist/aws-sqs.js

@@ -1,130 +1,46 @@
 // ../framework/aws-sqs/dist/index.js
-import {
-  Node as N
-} from "ts-morph";
-import { readConfiguredCall, rootIdentifier } from "@suss/adapter-typescript";
+import { Node as N } from "ts-morph";
+import { readConfiguredCall } from "@suss/adapter-typescript";
 import { messageBusBinding } from "@suss/behavioral-ir";
-import { unwrapJsonStringify } from "@suss/extractor";
-var SEND_COMMANDS = {
-  SendMessageCommand: "send",
-  SendMessageBatchCommand: "sendBatch"
-};
-function sqsRecognizer(call, ctx) {
-  const callNode = call;
-  const recognizerCtx = ctx;
-  const calleeExpr = callNode.getExpression();
-  if (!N.isPropertyAccessExpression(calleeExpr)) {
-    return null;
-  }
-  if (calleeExpr.getName() !== "send") {
-    return null;
-  }
-  const args = callNode.getArguments();
-  if (args.length === 0) {
-    return null;
-  }
-  const firstArg = args[0];
-  if (!N.isNewExpression(firstArg)) {
-    return null;
-  }
-  const ctorExpr = firstArg.getExpression();
-  const ctorLeafName = N.isPropertyAccessExpression(ctorExpr) ? ctorExpr.getName() : ctorExpr.getText();
-  const operation = SEND_COMMANDS[ctorLeafName];
-  if (operation === void 0) {
-    return null;
-  }
-  const importCheckTarget = N.isPropertyAccessExpression(ctorExpr) ? rootIdentifier(ctorExpr) : ctorExpr;
-  if (importCheckTarget === null || !recognizerCtx.isImportedFrom(importCheckTarget, "@aws-sdk/client-sqs")) {
-    return null;
-  }
-  const ctorArgs = firstArg.getArguments();
-  if (ctorArgs.length === 0) {
-    return null;
-  }
-  const input = ctorArgs[0];
-  if (!N.isObjectLiteralExpression(input)) {
-    return null;
+import { constructedFrom, messageSends, pack } from "@suss/recognize";
+var SQS = "@aws-sdk/client-sqs";
+var INSIDE_THE_COMMAND = (named) => ({
+  send: {
+    input: {
+      at: 0,
+      of: [
+        {
+          to: "argument",
+          at: 0,
+          origin: constructedFrom({ from: [SQS], named })
+        }
+      ]
+    }
   }
-  const channel = readQueueUrlChannel(
-    input,
-    recognizerCtx.resolveWrittenValue ?? (() => null)
-  );
-  const rawBody = readPropertyArg(
-    input,
-    "MessageBody",
-    recognizerCtx.extractArgs,
-    callNode
-  );
-  const body = unwrapJsonStringify(rawBody);
+});
+function sendDeclarations() {
   return [
-    {
-      type: "interaction",
-      binding: messageBusBinding({
-        recognition: "@suss/framework-aws-sqs",
-        messageBus: "aws_sqs",
-        channel
-      }),
-      callee: callNode.getExpression().getText(),
-      interaction: {
-        class: "message-send",
-        ...body !== null ? { body } : {}
-        // routingKey unused for SQS standard queues. SQS FIFO uses
-        // MessageGroupId; future enhancement.
-      }
-    }
+    messageSends({
+      wire: "aws_sqs",
+      client: constructedFrom(SQS),
+      messages: { each: "theInput" },
+      channel: [{ property: "QueueUrl" }],
+      body: "MessageBody"
+    }).methods(INSIDE_THE_COMMAND(["SendMessageCommand"])).example(
+      'client.send(new SendMessageCommand({ QueueUrl: "orders", MessageBody: "{}" }))'
+    ),
+    messageSends({
+      wire: "aws_sqs",
+      client: constructedFrom(SQS),
+      messages: { each: "in", property: "Entries" },
+      // A batch states the queue once beside the list of messages.
+      channel: [{ property: "QueueUrl", on: "theInput" }],
+      body: "MessageBody"
+    }).methods(INSIDE_THE_COMMAND(["SendMessageBatchCommand"])).example(
+      'client.send(new SendMessageBatchCommand({ QueueUrl: "orders", Entries: [{ MessageBody: "{}" }] }))'
+    )
   ];
 }
-function readQueueUrlChannel(input, resolveWrittenValue) {
-  if (!N.isObjectLiteralExpression(input)) {
-    return null;
-  }
-  for (const prop of input.getProperties()) {
-    if (!N.isPropertyAssignment(prop)) {
-      continue;
-    }
-    if (prop.getName() !== "QueueUrl") {
-      continue;
-    }
-    const initializer = prop.getInitializer();
-    if (initializer === void 0) {
-      return null;
-    }
-    const named = channelNamedBy(initializer);
-    if (named !== null) {
-      return named;
-    }
-    const resolved = resolveWrittenValue(initializer);
-    return resolved === null ? null : channelNamedBy(resolved);
-  }
-  return null;
-}
-function channelNamedBy(expr) {
-  if (N.isPropertyAccessExpression(expr)) {
-    const text = expr.getText();
-    const match = text.match(/^process\.env\.(\w+)$/);
-    return match === null ? null : match[1] ?? null;
-  }
-  if (N.isStringLiteral(expr)) {
-    return expr.getLiteralValue();
-  }
-  return null;
-}
-function readPropertyArg(input, propName, extractCallArgs, callNode) {
-  const callArgs = extractCallArgs();
-  const first = callArgs[0];
-  if (first === null || typeof first !== "object" || first.kind !== "call") {
-    return null;
-  }
-  const ctorArgs = first.args ?? [];
-  const inputArg = ctorArgs[0];
-  if (inputArg === null || typeof inputArg !== "object" || inputArg.kind !== "object") {
-    return null;
-  }
-  const fields = inputArg.fields ?? {};
-  void input;
-  void callNode;
-  return fields[propName] ?? null;
-}
 function messageReceiveRecognizer(call, ctx) {
   const callNode = call;
   void ctx;
@@ -265,30 +181,18 @@ function configuredProducerRecognizer(spec) {
 }
 function sqsFramework(options = {}) {
   const producers = options.producers ?? [];
-  return {
-    name: "sqs",
-    protocol: "sqs",
+  return pack("sqs", sendDeclarations(), {
     languages: ["typescript", "javascript"],
-    discovery: [],
-    terminals: [],
-    inputMapping: { type: "positionalParams", params: [] },
-    // Skip files that don't import either `@aws-sdk/client-sqs`
-    // (producer side) or `aws-lambda` (consumer side; SQSEvent type).
-    // The recognizers' structural checks are quick but the import
-    // gate spares walking SQS-irrelevant files in monorepos.
-    requiresImport: [
-      .../* @__PURE__ */ new Set([
-        "@aws-sdk/client-sqs",
-        "aws-lambda",
-        ...producers.map((p) => p.module)
-      ])
-    ],
-    invocationRecognizers: [
-      sqsRecognizer,
+    recognizedAs: "@suss/framework-aws-sqs",
+    protocol: "sqs",
+    // The consumer side reads SQSEvent handlers, whose files import
+    // aws-lambda rather than the SQS client.
+    requiresImport: ["aws-lambda", ...producers.map((p) => p.module)],
+    recognizers: [
       messageReceiveRecognizer,
       ...producers.map(configuredProducerRecognizer)
     ]
-  };
+  });
 }
 var index_default = sqsFramework;
 export {

package/dist/express.js

@@ -1,6 +1,9 @@
 // ../framework/express/dist/index.js
-import { httpRouteDiscovery } from "@suss/extractor";
-function expressFramework() {
+import {
+  httpRouteDiscovery,
+  registrationHelperDiscovery
+} from "@suss/extractor";
+function expressFramework(options = {}) {
   return {
     name: "express",
     protocol: "http",
@@ -11,12 +14,15 @@ function expressFramework() {
     // Either can also be mounted onto another with `app.use(prefix,
     // router)`, so a route declared on the mounted router summarizes
     // with the mount's prefix composed in.
-    discovery: httpRouteDiscovery({
-      importModule: "express",
-      importNames: ["Router", "express"],
-      methods: [".get", ".post", ".put", ".delete", ".patch", ".all"],
-      mount: { method: "use", prefixPosition: 0, targetPosition: 1 }
-    }),
+    discovery: [
+      ...httpRouteDiscovery({
+        importModule: "express",
+        importNames: ["Router", "express"],
+        methods: [".get", ".post", ".put", ".delete", ".patch", ".all"],
+        mount: { method: "use", prefixPosition: 0, targetPosition: 1 }
+      }),
+      ...registrationHelperDiscovery(options.registrationHelpers ?? [])
+    ],
     terminals: [
       {
         // res.status(N).json(body)

package/dist/fastify.js

@@ -1,6 +1,9 @@
 // ../framework/fastify/dist/index.js
-import { httpRouteDiscovery } from "@suss/extractor";
-function fastifyFramework() {
+import {
+  httpRouteDiscovery,
+  registrationHelperDiscovery
+} from "@suss/extractor";
+function fastifyFramework(options = {}) {
   return {
     name: "fastify",
     protocol: "http",
@@ -8,20 +11,23 @@ function fastifyFramework() {
     // Fastify exposes the routable via either default `Fastify` or
     // named `fastify()`. Both drive handler registration the same way.
     // Unlike Express, Fastify's router supports `.head` and `.options`.
-    discovery: httpRouteDiscovery({
-      importModule: "fastify",
-      importNames: ["Fastify", "fastify"],
-      methods: [
-        ".get",
-        ".post",
-        ".put",
-        ".delete",
-        ".patch",
-        ".head",
-        ".options",
-        ".all"
-      ]
-    }),
+    discovery: [
+      ...httpRouteDiscovery({
+        importModule: "fastify",
+        importNames: ["Fastify", "fastify"],
+        methods: [
+          ".get",
+          ".post",
+          ".put",
+          ".delete",
+          ".patch",
+          ".head",
+          ".options",
+          ".all"
+        ]
+      }),
+      ...registrationHelperDiscovery(options.registrationHelpers ?? [])
+    ],
     terminals: [
       {
         // reply.code(N).send(body)

package/dist/hono.js

@@ -1,9 +1,12 @@
 // ../framework/hono/dist/index.js
-import { httpRouteDiscovery } from "@suss/extractor";
+import {
+  httpRouteDiscovery,
+  registrationHelperDiscovery
+} from "@suss/extractor";
 var HTTP_EXCEPTION_CODES = {
   HTTPException: 500
 };
-function honoFramework() {
+function honoFramework(options = {}) {
   return {
     name: "hono",
     protocol: "http",
@@ -74,7 +77,8 @@ function honoFramework() {
           path: { type: "fromArgumentProperty", position: 0, property: "path" }
         },
         requiresImport: ["@hono/zod-openapi"]
-      }
+      },
+      ...registrationHelperDiscovery(options.registrationHelpers ?? [])
     ],
     // The createRoute object registered alongside the handler declares
     // the endpoint's responses, so a handler returning a status the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/packs",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "type": "module",
   "description": "Every pack suss ships, as one package with a subpath per pack.",
   "keywords": [
@@ -157,15 +157,15 @@
     "ts-morph": "^23.0.0"
   },
   "dependencies": {
-    "@suss/adapter-python": "0.14.1",
-    "@suss/adapter-ruby": "0.14.1",
-    "@suss/adapter-typescript": "0.14.1",
-    "@suss/behavioral-ir": "0.14.1",
-    "@suss/contract-graphql": "0.14.1",
-    "@suss/extractor": "0.14.1",
-    "@suss/manifest-aws": "0.14.1",
-    "@suss/recognize": "0.14.1",
-    "@suss/sql": "0.14.1"
+    "@suss/adapter-python": "0.15.0",
+    "@suss/adapter-ruby": "0.15.0",
+    "@suss/adapter-typescript": "0.15.0",
+    "@suss/behavioral-ir": "0.15.0",
+    "@suss/contract-graphql": "0.15.0",
+    "@suss/extractor": "0.15.0",
+    "@suss/manifest-aws": "0.15.0",
+    "@suss/recognize": "0.15.0",
+    "@suss/sql": "0.15.0"
   },
   "devDependencies": {
     "@suss/client-apollo": "*",