@suss/packs 0.36.0 → 0.37.1

package/dist/activejob.d.ts

@@ -0,0 +1,60 @@
+export { declares, default, optionsSchema } from '@suss/framework-activejob';
+import '@suss/framework-activerecord';
+import '@suss/client-aiohttp';
+import '@suss/client-apollo';
+import '@suss/framework-apollo';
+import '@suss/framework-aws-dynamodb';
+import '@suss/framework-aws-eventbridge';
+import '@suss/framework-aws-lambda';
+import '@suss/framework-aws-s3';
+import '@suss/framework-aws-secrets-manager';
+import '@suss/framework-aws-sns';
+import '@suss/framework-aws-sqs';
+import '@suss/framework-aws-ssm';
+import '@suss/client-axios';
+import '@suss/framework-bigquery-python';
+import '@suss/framework-bigquery-ruby';
+import '@suss/framework-bigquery';
+import '@suss/framework-bullmq';
+import '@suss/framework-celery';
+import '@suss/framework-cloudflare-workers';
+import '@suss/framework-drizzle';
+import '@suss/framework-express';
+import '@suss/framework-fabrication';
+import '@suss/framework-factory-bot';
+import '@suss/client-faraday';
+import '@suss/framework-fastapi';
+import '@suss/framework-fastify';
+import '@suss/client-web';
+import '@suss/framework-flask-restx';
+import '@suss/framework-gcs';
+import '@suss/framework-graphql-ruby';
+import '@suss/framework-hono';
+import '@suss/client-httpx';
+import '@suss/framework-minitest';
+import '@suss/framework-mongoose';
+import '@suss/framework-nestjs-graphql';
+import '@suss/framework-nestjs-microservices';
+import '@suss/framework-nestjs-rest';
+import '@suss/client-net-http';
+import '@suss/framework-nextjs';
+import '@suss/runtime-node';
+import '@suss/framework-package-exports';
+import '@suss/framework-pg-ruby';
+import '@suss/framework-pg';
+import '@suss/framework-prisma';
+import '@suss/framework-pytest';
+import '@suss/framework-rails';
+import '@suss/framework-react-query';
+import '@suss/framework-react-router';
+import '@suss/framework-react';
+import '@suss/framework-redis';
+import '@suss/client-requests';
+import '@suss/framework-rspec';
+import '@suss/framework-sidekiq';
+import '@suss/framework-sqlalchemy';
+import '@suss/framework-sqlmodel';
+import '@suss/framework-ts-rest';
+import '@suss/framework-typeorm';
+import '@suss/framework-vitest';
+import '@suss/framework-zustand';

package/dist/activejob.js

@@ -0,0 +1,48 @@
+// ../framework/activejob/dist/index.js
+import { z } from "zod";
+var optionsSchema = z.object({}).strict();
+function activeJobFramework(_options = {}) {
+  return {
+    name: "activejob",
+    protocol: "activejob",
+    discovery: [],
+    jobs: [
+      {
+        type: "jobClasses",
+        messageBus: "activejob",
+        // A scaffolded app puts ApplicationJob in between. Listing it too
+        // covers a run that does not read app/jobs/application_job.rb.
+        baseClasses: ["ActiveJob::Base", "ApplicationJob"],
+        modules: [],
+        performMethod: "perform",
+        enqueueMethods: { perform_later: 0, perform_now: 0 },
+        optionMethods: ["set"],
+        queueDeclarations: [{ call: "queue_as", queue: { at: 0 } }]
+      },
+      {
+        type: "mailers",
+        messageBus: "activejob",
+        baseClasses: ["ActionMailer::Base", "ApplicationMailer"],
+        // `deliver_later!` skips the checks that `deliver_later` runs first.
+        enqueueMethods: ["deliver_later", "deliver_later!"],
+        optionMethods: ["with"]
+      }
+    ]
+  };
+}
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-activejob",
+  // An app that depends on the Rails gems one at a time lists activejob.
+  dependencies: [
+    { ecosystem: "rubygems", name: "rails" },
+    { ecosystem: "rubygems", name: "activejob" }
+  ],
+  reads: "ActiveJob jobs and ActionMailer messages (Ruby): each job's perform and each mailer method is a consumer of an activejob channel, and perform_later or deliver_later a send to it."
+};
+var index_default = activeJobFramework;
+export {
+  declares,
+  index_default as default,
+  optionsSchema
+};

package/dist/activerecord.d.ts

@@ -1,56 +1 @@
 export { declares, default, optionsSchema } from '@suss/framework-activerecord';
-import '@suss/client-aiohttp';
-import '@suss/client-apollo';
-import '@suss/framework-apollo';
-import '@suss/framework-aws-dynamodb';
-import '@suss/framework-aws-eventbridge';
-import '@suss/framework-aws-lambda';
-import '@suss/framework-aws-s3';
-import '@suss/framework-aws-secrets-manager';
-import '@suss/framework-aws-sns';
-import '@suss/framework-aws-sqs';
-import '@suss/framework-aws-ssm';
-import '@suss/client-axios';
-import '@suss/framework-bigquery-python';
-import '@suss/framework-bigquery-ruby';
-import '@suss/framework-bigquery';
-import '@suss/framework-cloudflare-workers';
-import '@suss/framework-drizzle';
-import '@suss/framework-express';
-import '@suss/framework-fabrication';
-import '@suss/framework-factory-bot';
-import '@suss/client-faraday';
-import '@suss/framework-fastapi';
-import '@suss/framework-fastify';
-import '@suss/client-web';
-import '@suss/framework-flask-restx';
-import '@suss/framework-gcs';
-import '@suss/framework-graphql-ruby';
-import '@suss/framework-hono';
-import '@suss/client-httpx';
-import '@suss/framework-minitest';
-import '@suss/framework-mongoose';
-import '@suss/framework-nestjs-graphql';
-import '@suss/framework-nestjs-microservices';
-import '@suss/framework-nestjs-rest';
-import '@suss/client-net-http';
-import '@suss/framework-nextjs';
-import '@suss/runtime-node';
-import '@suss/framework-package-exports';
-import '@suss/framework-pg-ruby';
-import '@suss/framework-pg';
-import '@suss/framework-prisma';
-import '@suss/framework-pytest';
-import '@suss/framework-rails';
-import '@suss/framework-react-query';
-import '@suss/framework-react-router';
-import '@suss/framework-react';
-import '@suss/framework-redis';
-import '@suss/client-requests';
-import '@suss/framework-rspec';
-import '@suss/framework-sqlalchemy';
-import '@suss/framework-sqlmodel';
-import '@suss/framework-ts-rest';
-import '@suss/framework-typeorm';
-import '@suss/framework-vitest';
-import '@suss/framework-zustand';

package/dist/aws-lambda-python.js

@@ -2,7 +2,7 @@ import {
   awsLambdaPython,
   declaresPython,
   optionsSchema
-} from "./chunk-63BQSSQT.js";
+} from "./chunk-SH7CMRMX.js";
 export {
   declaresPython as declares,
   awsLambdaPython as default,

package/dist/aws-lambda-ruby.js

@@ -2,7 +2,7 @@ import {
   awsLambdaRuby,
   declaresRuby,
   optionsSchema
-} from "./chunk-63BQSSQT.js";
+} from "./chunk-SH7CMRMX.js";
 export {
   declaresRuby as declares,
   awsLambdaRuby as default,

package/dist/aws-lambda.js

@@ -2,7 +2,7 @@ import {
   declares,
   index_default,
   optionsSchema
-} from "./chunk-63BQSSQT.js";
+} from "./chunk-SH7CMRMX.js";
 export {
   declares,
   index_default as default,

package/dist/bullmq.d.ts

@@ -0,0 +1 @@
+export { declares, default } from '@suss/framework-bullmq';

package/dist/bullmq.js

@@ -0,0 +1,138 @@
+// ../framework/bullmq/dist/index.js
+import { constructedFrom, messageSends, pack } from "@suss/recognize";
+var BULLMQ = "bullmq";
+var QUEUE = constructedFrom({ from: [BULLMQ], named: ["Queue"] });
+var FLOW_PRODUCER = constructedFrom({
+  from: [BULLMQ],
+  named: ["FlowProducer"]
+});
+var QUEUE_BUILT_WITH = [
+  { argument: { of: [{ to: "receiver" }], at: 0 } }
+];
+var QUEUE_NAMED_IN_THE_FLOW = [
+  { property: ["queueName"] }
+];
+function sendDeclarations() {
+  return [
+    messageSends({
+      wire: "bullmq",
+      client: QUEUE,
+      messages: { each: "theInput" },
+      channel: QUEUE_BUILT_WITH,
+      body: { whole: "message" },
+      routingKey: { at: 0 },
+      unsettledName: "nothing"
+    }).methods({ add: { input: { at: 1 } } }).example('queue.add("welcome", { userId })'),
+    messageSends({
+      wire: "bullmq",
+      client: QUEUE,
+      messages: { each: "inTheInput" },
+      channel: QUEUE_BUILT_WITH,
+      body: "data",
+      routingKey: "name",
+      unsettledName: "nothing"
+    }).methods({ addBulk: { input: { at: 0 } } }).example('queue.addBulk([{ name: "welcome", data: { userId } }])'),
+    // A job scheduler adds a job on every tick, from the template it is
+    // given here.
+    messageSends({
+      wire: "bullmq",
+      client: QUEUE,
+      messages: { each: "theInput" },
+      channel: QUEUE_BUILT_WITH,
+      body: "data",
+      routingKey: "name",
+      unsettledName: "nothing"
+    }).methods({ upsertJobScheduler: { input: { at: 2 } } }).example(
+      'queue.upsertJobScheduler("nightly", { pattern: "0 0 * * *" }, { name: "digest", data: {} })'
+    ),
+    messageSends({
+      wire: "bullmq",
+      client: FLOW_PRODUCER,
+      messages: { each: "theInput" },
+      channel: QUEUE_NAMED_IN_THE_FLOW,
+      body: "data",
+      routingKey: "name",
+      unsettledName: "nothing"
+    }).methods({ add: { input: { at: 0 } } }).example(
+      'flow.add({ name: "render", queueName: "renders", data: { id } })'
+    ),
+    messageSends({
+      wire: "bullmq",
+      client: FLOW_PRODUCER,
+      messages: { each: "inTheInput" },
+      channel: QUEUE_NAMED_IN_THE_FLOW,
+      body: "data",
+      routingKey: "name",
+      unsettledName: "nothing"
+    }).methods({ addBulk: { input: { at: 0 } } }).example(
+      'flow.addBulk([{ name: "render", queueName: "renders", data: { id } }])'
+    )
+  ];
+}
+function bullmqFramework() {
+  const sends = pack("bullmq", sendDeclarations(), {
+    languages: ["typescript", "javascript"],
+    recognizedAs: "@suss/framework-bullmq"
+  });
+  return {
+    ...sends,
+    discovery: [
+      {
+        kind: "consumer",
+        match: {
+          type: "callbackArgument",
+          importModule: BULLMQ,
+          importName: "Worker",
+          callbackPosition: 1
+        },
+        binding: {
+          semantics: "message-bus",
+          messageBus: "bullmq",
+          channel: { from: "callArgument", position: 0 }
+        },
+        requiresImport: [BULLMQ]
+      }
+    ],
+    terminals: [
+      // A processor's return value is the job's result, which BullMQ
+      // stores and nothing here pairs yet.
+      {
+        kind: "return",
+        match: { type: "returnStatement", excludeCallReturns: false },
+        extraction: {}
+      },
+      {
+        kind: "throw",
+        match: { type: "throwExpression" },
+        extraction: {}
+      },
+      // Most processors return nothing, and a job completes when its
+      // processor runs off the end.
+      {
+        kind: "return",
+        match: { type: "functionFallthrough" },
+        extraction: {}
+      }
+    ],
+    // The job is not the message: what the add sent is `job.data`, so
+    // the job keeps a role of its own rather than the one a message has.
+    inputMapping: {
+      type: "positionalParams",
+      params: [
+        { position: 0, role: "job" },
+        { position: 1, role: "token" }
+      ]
+    }
+  };
+}
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-bullmq",
+  dependencies: [{ ecosystem: "npm", name: "bullmq" }],
+  reads: "BullMQ workers and queues: each worker's processor is a consumer on its queue, and each add to a queue is a message send on it."
+};
+var index_default = bullmqFramework;
+export {
+  declares,
+  index_default as default
+};

package/dist/celery.d.ts

@@ -0,0 +1 @@
+export { declares, default } from '@suss/framework-celery';

package/dist/celery.js

@@ -0,0 +1,53 @@
+// ../framework/celery/dist/index.js
+function celeryJobQueue() {
+  return {
+    messageBus: "celery",
+    module: "celery",
+    taskDecorators: ["task", "shared_task"],
+    nameKeyword: "name",
+    queueKeyword: "queue",
+    defaultName: "modulePath",
+    enqueueMethods: [
+      { method: "delay", arguments: { type: "spread" } },
+      {
+        method: "apply_async",
+        arguments: {
+          type: "packed",
+          args: { argument: 0, keyword: "args" },
+          kwargs: { argument: 1, keyword: "kwargs" }
+        }
+      }
+    ],
+    sendByName: [
+      {
+        method: "send_task",
+        name: { argument: 0, keyword: "name" },
+        arguments: {
+          type: "packed",
+          args: { argument: 1, keyword: "args" },
+          kwargs: { argument: 2, keyword: "kwargs" }
+        }
+      }
+    ],
+    apps: ["Celery", "current_app"]
+  };
+}
+function celeryFramework() {
+  return {
+    name: "celery",
+    protocol: "celery",
+    discovery: [],
+    jobQueues: [celeryJobQueue()]
+  };
+}
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-celery",
+  dependencies: [{ ecosystem: "pypi", name: "celery" }],
+  reads: "Celery tasks (Python). A function under `@app.task` or `@shared_task` is the consumer of its task, and `.delay`, `.apply_async` and `send_task` are sends to it, so a route that enqueues a task reaches what the task does."
+};
+var index_default = celeryFramework;
+export {
+  declares,
+  index_default as default
+};

package/dist/{chunk-63BQSSQT.js → chunk-SH7CMRMX.js}

@@ -15,7 +15,11 @@ import {
   readServerlessFunctions,
   unfollowedStackMessage
 } from "@suss/manifest-aws";
-import { messageBusBinding, unitInvocationBinding } from "@suss/behavioral-ir";
+import {
+  graphqlResolverBinding,
+  messageBusBinding,
+  unitInvocationBinding
+} from "@suss/behavioral-ir";
 import { constructedFrom, unitInvokes } from "@suss/recognize";
 var TEMPLATE_NAMES = [
   "template.yaml",
@@ -34,7 +38,9 @@ function manifestTree(manifestPath) {
       {
         path: path.resolve(manifestPath),
         stackPath: [],
-        template: translated.functions
+        template: translated.functions,
+        resourceLines: /* @__PURE__ */ new Map(),
+        parameterTargets: /* @__PURE__ */ new Map()
       }
     ],
     unfollowed: []
@@ -364,9 +370,36 @@ function awsLambdaDiscovery() {
 function lambdaEntryPoints(recognition) {
   return (filePath) => handlersForFile(filePath).map((entry) => ({
     name: entry.exportName,
-    units: [handlerUnit(entry, recognition)]
+    units: entryUnits(entry, recognition)
   }));
 }
+function entryUnits(entry, recognition) {
+  const operations = operationFields(entry);
+  const fields = operations.map(
+    (field) => resolverUnit(entry, field, recognition)
+  );
+  const reachedOtherwise = entry.httpRoutes.length > 0 || entry.nonHttpEvents.length > 0 || entry.graphqlFields.length > operations.length;
+  return fields.length > 0 && !reachedOtherwise ? fields : [...fields, handlerUnit(entry, recognition)];
+}
+function resolverUnit(entry, field, recognition) {
+  return {
+    kind: "handler",
+    name: `${entry.functionLogicalId}.${entry.exportName}`,
+    binding: graphqlResolverBinding({
+      transport: "aws-https",
+      recognition,
+      typeName: field.typeName,
+      fieldName: field.fieldName
+    }),
+    deployableUnit: deployableUnit(entry),
+    metadata: {
+      [METADATA_NAMESPACE]: {
+        handler: entry.handler,
+        recognition: "appsync-resolver"
+      }
+    }
+  };
+}
 function handlerUnit(entry, recognition) {
   const eventTypes = [
     ...entry.httpRoutes.map((route) => route.eventType),

package/dist/graphql-ruby.js

@@ -45,6 +45,56 @@ var DEFAULT_BASE_CLASS_NAMES = [
   "Types::BaseUnion",
   "Types::BaseScalar"
 ];
+function orNull(shape) {
+  return { type: "union", variants: [shape, { type: "null" }] };
+}
+var PAGE_INFO_FIELDS = {
+  hasNextPage: { type: "boolean" },
+  hasPreviousPage: { type: "boolean" },
+  startCursor: orNull({ type: "text" }),
+  endCursor: orNull({ type: "text" })
+};
+var CONNECTION_TYPE = {
+  name: "{type}Connection",
+  types: {
+    "{type}Connection": {
+      edges: orNull({
+        type: "array",
+        items: orNull({ type: "ref", name: "{type}Edge" })
+      }),
+      nodes: orNull({
+        type: "array",
+        items: orNull({ type: "ref", name: "{type}" })
+      }),
+      pageInfo: { type: "ref", name: "PageInfo" }
+    },
+    "{type}Edge": {
+      cursor: { type: "text" },
+      node: orNull({ type: "ref", name: "{type}" })
+    }
+  }
+};
+var COLLECTION_METADATA_FIELDS = {
+  currentPage: { type: "number" },
+  limitValue: { type: "number" },
+  totalCount: { type: "number" },
+  totalPages: { type: "number" }
+};
+var COLLECTION_TYPE = {
+  name: "{type}Collection",
+  types: {
+    "{type}Collection": {
+      collection: { type: "array", items: { type: "ref", name: "{type}" } },
+      metadata: { type: "ref", name: "{metadata_type}" }
+    }
+  },
+  typeArguments: {
+    "{metadata_type}": {
+      keyword: "metadata_type",
+      fallback: "CollectionMetadata"
+    }
+  }
+};
 function rootDirectory(options) {
   if (options.configDirectory === void 0 || path.isAbsolute(options.root)) {
     return options.root;
@@ -76,8 +126,32 @@ function graphqlRubyFramework(options) {
     // and the payload comes back in its place.
     resolverHooks: {
       methods: ["ready?", "authorized?"],
-      answerIsListHead: true
+      answerIsListHead: true,
+      // A bare false from `ready?` resolves the field to null. One from
+      // `authorized?` raises, and the schema decides what the client sees.
+      refusalRaises: { "authorized?": "GraphQL::UnauthorizedFieldError" }
+    },
+    typeKeyword: "type",
+    typeNameCallName: "graphql_name",
+    // A field, and a mutation's or resolver's own type, can be null unless
+    // it says `null: false`. The items of a list cannot unless the list
+    // type says `[Type, null: true]`.
+    nullability: {
+      keyword: "null",
+      callName: "null",
+      nullableByDefault: true,
+      listItemsNullableByDefault: false
+    },
+    typeWrappers: {
+      connection_type: CONNECTION_TYPE,
+      collection_type: COLLECTION_TYPE
+    },
+    libraryTypes: {
+      PageInfo: PAGE_INFO_FIELDS,
+      CollectionMetadata: COLLECTION_METADATA_FIELDS
     },
+    // Returning one of these puts it in `errors[]` in place of the value.
+    returnedErrorClassNames: ["GraphQL::ExecutionError"],
     ancestryRootClassNames: [...GRAPHQL_RUBY_ROOT_CLASS_NAMES],
     requiredKeyword: "required",
     // graphql-ruby registers an argument as required unless the call
@@ -133,7 +207,7 @@ var declares = {
   kind: "framework",
   package: "@suss/framework-graphql-ruby",
   dependencies: [{ ecosystem: "rubygems", name: "graphql" }],
-  reads: "graphql-ruby class-based field DSL (Ruby). The pack follows `mutation:` and `resolver:` wiring to the referenced class, wherever the run declares it, and reads its arguments, its payload, its `resolve` method and the `ready?` and `authorized?` hooks that run first. It follows `resolver_method:` to the type's own method. It also records the model a resolver reads through `dataloader`, when a storage pack in the run recognizes that model.",
+  reads: "graphql-ruby class-based field DSL (Ruby). The pack follows `mutation:` and `resolver:` wiring to the referenced class, wherever the run declares it, and reads its arguments, its payload, its `resolve` method and the `ready?` and `authorized?` hooks that run first. It follows `resolver_method:` to the type's own method. Each path through that method records what the field returns, from its declared type with null where the schema allows it and the object type's fields, and the errors it raises or returns. It also records the model a resolver reads through `dataloader`, when a storage pack in the run recognizes that model.",
   configuration: {
     file: "suss.graphql-ruby.json",
     example: { root: "app/graphql" },

package/dist/node.js

@@ -7,8 +7,10 @@ import {
 import {
   declarationsBehind,
   dottedPathOf,
+  fallbackOf,
   functionTargetOf,
   isDefaultedAt,
+  scalarValueOf,
   stringValueOf,
   symbolBehind,
   toFunctionRoot
@@ -504,10 +506,11 @@ function directEnvRead(fn, parameter) {
 function readsBuildKey(read) {
   return read.object === IMPORT_META_ENV && read.name !== null && VITE_BUILD_KEYS.has(read.name);
 }
-function configReadEffect(read, where) {
+function configReadEffect(read, where, resolution) {
   if (readsBuildKey(read)) {
     return opaqueRuntimeRead(readName(read));
   }
+  const fallback = read.defaulted ? defaultValueAt(read.node, resolution) : null;
   return {
     type: "interaction",
     binding: configBinding(where),
@@ -515,16 +518,21 @@ function configReadEffect(read, where) {
     interaction: {
       class: "config-read",
       name: read.name,
-      defaulted: read.defaulted
+      defaulted: read.defaulted,
+      ...fallback === null ? {} : { default: fallback }
     }
   };
 }
+function defaultValueAt(read, resolution) {
+  const fallback = fallbackOf(read);
+  return fallback === null ? null : scalarValueOf(fallback, resolution);
+}
 function recognizeProcessEnvRead(access, where, resolution) {
   const reads = envReadsAt(access, resolution);
   if (reads.length === 0) {
     return null;
   }
-  return reads.map((read) => configReadEffect(read, where));
+  return reads.map((read) => configReadEffect(read, where, resolution));
 }
 function envVarRecognizer(opts = {}) {
   return (access, ctx) => recognizeProcessEnvRead(

package/dist/prisma.js

@@ -150,6 +150,55 @@ function textOf(file) {
     return "";
   }
 }
+function generatedClientInputs(walked) {
+  const roots = /* @__PURE__ */ new Set();
+  for (const dir of new Set(walked.map((file) => path3.dirname(file)))) {
+    const root = projectRootOf(dir);
+    if (root !== null) {
+      roots.add(root);
+    }
+  }
+  const inputs = /* @__PURE__ */ new Set();
+  for (const root of roots) {
+    const project = readProjectAt(root);
+    for (const file of project?.readFrom.keys() ?? []) {
+      inputs.add(file);
+    }
+    for (const dir of [...project?.dirs ?? [], ...defaultClientDirs(root)]) {
+      for (const file of clientTypeFiles(dir)) {
+        inputs.add(file);
+      }
+    }
+  }
+  return [...inputs].sort();
+}
+function defaultClientDirs(root) {
+  for (let dir = root; ; dir = path3.dirname(dir)) {
+    const client = path3.join(dir, "node_modules", ".prisma", "client");
+    if (fs3.existsSync(client)) {
+      return [client];
+    }
+    if (path3.dirname(dir) === dir) {
+      return [];
+    }
+  }
+}
+var CLIENT_TYPE_FILE = /(\.d\.[cm]?ts|\.[cm]?ts|\.prisma|^package\.json)$/;
+function clientTypeFiles(dir) {
+  let entries;
+  try {
+    entries = fs3.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  return entries.flatMap((entry) => {
+    const file = path3.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      return entry.name === "runtime" || entry.name === "node_modules" ? [] : clientTypeFiles(file);
+    }
+    return CLIENT_TYPE_FILE.test(entry.name) ? [file] : [];
+  });
+}
 function isInGeneratedClient(filePath) {
   return generatedClientDirs(path3.dirname(filePath)).some(
     (dir) => filePath.startsWith(`${dir}${path3.sep}`)
@@ -774,6 +823,7 @@ function prismaFramework(options = {}) {
     // `prisma-client` generator writes no schema beside it.
     generatedModuleMarkers: [GENERATED_CLIENT_MARKER],
     generatedModuleDirs: generatedClientDirs,
+    discoveryInputs: generatedClientInputs,
     invocationRecognizers: [makeRecognizer(options)],
     // A tagged template is not an invocation, so the raw chain runs on
     // the access walk, which visits calls as well.

package/dist/rails.js

@@ -29,7 +29,7 @@ import {
   symbolValue
 } from "@suss/adapter-ruby";
 
-// ../ir-core/dist/chunk-7IOGU4OC.js
+// ../ir-core/dist/chunk-OROVMQY2.js
 import { z as z13 } from "zod";
 import { z as z12 } from "zod";
 import { z } from "zod";
@@ -257,7 +257,11 @@ var MessageBusSemanticsSchema = z5.object({
     "aws_kinesis",
     "aws_firehose",
     "gcp_pubsub",
+    // Job queues. The header says what their channel is.
     "bullmq",
+    "activejob",
+    "sidekiq",
+    "celery",
     "kafka",
     "nats",
     "cloudflare-queues",
@@ -273,6 +277,26 @@ var MessageBusSemanticsSchema = z5.object({
    */
   channel: z5.string().min(1).nullable()
 });
+var MESSAGES = { jobQueue: false };
+var JOBS = { jobQueue: true };
+var MESSAGE_BUS_TRAITS = {
+  aws_sqs: MESSAGES,
+  "aws.sns": MESSAGES,
+  s3: MESSAGES,
+  eventbridge: MESSAGES,
+  aws_kinesis: MESSAGES,
+  aws_firehose: MESSAGES,
+  gcp_pubsub: MESSAGES,
+  bullmq: JOBS,
+  activejob: JOBS,
+  sidekiq: JOBS,
+  celery: JOBS,
+  kafka: MESSAGES,
+  nats: MESSAGES,
+  "cloudflare-queues": MESSAGES,
+  "cloudflare-cron": MESSAGES,
+  "cloudflare-tail": MESSAGES
+};
 var messageBusSemantics = defineBoundarySemantics({
   name: "message-bus",
   schema: MessageBusSemanticsSchema,
@@ -289,6 +313,8 @@ var messageBusSemantics = defineBoundarySemantics({
      * the generic unmatched list leaves them out.
      */
     reportsUnpairedItself: true,
+    consumedAs: ["reads"],
+    unsettledJob: (semantics) => semantics.channel === null && MESSAGE_BUS_TRAITS[semantics.messageBus].jobQueue,
     /**
      * A channel that is null here can still pair. The dedicated pass
      * follows environment variable chains before comparing, so a
@@ -1070,6 +1096,7 @@ var runtimeConfigSemantics = defineBoundarySemantics({
     // comes from outside the code.
     leavesTheProcess: true,
     reportsUnpairedItself: false,
+    findingsAreReadsByName: true,
     identityKey: () => null,
     // A reader sees which deployable's environment this is. Code that
     // reads a variable does not say which deployable runs it, so a read
@@ -1415,6 +1442,13 @@ var SuppressionRuleSchema = z22.object({
    * only intent findings about a scenario with that title.
    */
   scenario: z22.string().optional(),
+  /**
+   * The deployments, by name, that a finding about one environment read
+   * is accepted for. The rule takes them off the finding's list, and
+   * the finding stays while any deployment it lists is left. Without
+   * this, a rule covers every deployment.
+   */
+  deployments: z22.array(z22.string().min(1)).min(1).optional(),
   /**
    * "narrow", the default, requires `kind` plus one of `boundary`,
    * `scenario`, `consumer.transitionId` or `provider.transitionId`, so
@@ -2731,6 +2765,7 @@ function railsFramework(options = {}) {
     inflections,
     // An action reads the request through these, and is handed nothing.
     requestAccessors: ["params", "request"],
+    blankToNil: ["presence"],
     // Rails merges the path, the query string and the body into `params`,
     // so an action's read of one cannot be told from the others and all
     // of them are spelled `params`.

package/dist/sidekiq.d.ts

@@ -0,0 +1 @@
+export { declares, default, optionsSchema } from '@suss/framework-sidekiq';

package/dist/sidekiq.js

@@ -0,0 +1,37 @@
+// ../framework/sidekiq/dist/index.js
+import { z } from "zod";
+var optionsSchema = z.object({}).strict();
+function sidekiqFramework(_options = {}) {
+  return {
+    name: "sidekiq",
+    protocol: "sidekiq",
+    discovery: [],
+    jobs: [
+      {
+        type: "jobClasses",
+        messageBus: "sidekiq",
+        baseClasses: [],
+        modules: ["Sidekiq::Job", "Sidekiq::Worker"],
+        performMethod: "perform",
+        // `perform_in` and `perform_at` take the delay or the time first.
+        enqueueMethods: { perform_async: 0, perform_in: 1, perform_at: 1 },
+        optionMethods: ["set"],
+        queueDeclarations: [
+          { call: "sidekiq_options", queue: { at: 0, keyword: "queue" } }
+        ]
+      }
+    ]
+  };
+}
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-sidekiq",
+  dependencies: [{ ecosystem: "rubygems", name: "sidekiq" }],
+  reads: "Sidekiq jobs (Ruby): each job's perform is a consumer of a sidekiq channel, and perform_async, perform_in or perform_at a send to it."
+};
+var index_default = sidekiqFramework;
+export {
+  declares,
+  index_default as default,
+  optionsSchema
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/packs",
-  "version": "0.36.0",
+  "version": "0.37.1",
   "type": "module",
   "description": "Every pack suss ships in one install, so it can read Express, Hono, NestJS, FastAPI, Rails, Prisma, OpenAPI and the rest.",
   "keywords": [
@@ -93,6 +93,14 @@
       "types": "./dist/bigquery-python.d.ts",
       "import": "./dist/bigquery-python.js"
     },
+    "./celery": {
+      "types": "./dist/celery.d.ts",
+      "import": "./dist/celery.js"
+    },
+    "./bullmq": {
+      "types": "./dist/bullmq.d.ts",
+      "import": "./dist/bullmq.js"
+    },
     "./cloudflare-workers": {
       "types": "./dist/cloudflare-workers.d.ts",
       "import": "./dist/cloudflare-workers.js"
@@ -189,6 +197,14 @@
       "types": "./dist/rspec.d.ts",
       "import": "./dist/rspec.js"
     },
+    "./activejob": {
+      "types": "./dist/activejob.d.ts",
+      "import": "./dist/activejob.js"
+    },
+    "./sidekiq": {
+      "types": "./dist/sidekiq.d.ts",
+      "import": "./dist/sidekiq.js"
+    },
     "./factory-bot": {
       "types": "./dist/factory-bot.d.ts",
       "import": "./dist/factory-bot.js"
@@ -275,16 +291,16 @@
   },
   "dependencies": {
     "@mrleebo/prisma-ast": "^0.15.0",
-    "@suss/adapter-python": "0.36.0",
-    "@suss/adapter-ruby": "0.36.0",
-    "@suss/adapter-typescript": "0.36.0",
-    "@suss/behavioral-ir": "0.36.0",
-    "@suss/contract-graphql": "0.36.0",
-    "@suss/contract-serverless": "0.36.0",
-    "@suss/extractor": "0.36.0",
-    "@suss/manifest-aws": "0.36.0",
-    "@suss/recognize": "0.36.0",
-    "@suss/sql": "0.36.0",
+    "@suss/adapter-python": "0.37.1",
+    "@suss/adapter-ruby": "0.37.1",
+    "@suss/adapter-typescript": "0.37.1",
+    "@suss/behavioral-ir": "0.37.1",
+    "@suss/contract-graphql": "0.37.1",
+    "@suss/contract-serverless": "0.37.1",
+    "@suss/extractor": "0.37.1",
+    "@suss/manifest-aws": "0.37.1",
+    "@suss/recognize": "0.37.1",
+    "@suss/sql": "0.37.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {
@@ -309,6 +325,8 @@
     "@suss/framework-bigquery": "*",
     "@suss/framework-bigquery-python": "*",
     "@suss/framework-bigquery-ruby": "*",
+    "@suss/framework-bullmq": "*",
+    "@suss/framework-celery": "*",
     "@suss/framework-cloudflare-workers": "*",
     "@suss/framework-drizzle": "*",
     "@suss/framework-express": "*",
@@ -327,7 +345,9 @@
     "@suss/framework-pg": "*",
     "@suss/framework-pg-ruby": "*",
     "@suss/framework-rspec": "*",
+    "@suss/framework-activejob": "*",
     "@suss/framework-factory-bot": "*",
+    "@suss/framework-sidekiq": "*",
     "@suss/framework-fabrication": "*",
     "@suss/framework-minitest": "*",
     "@suss/framework-prisma": "*",