@suss/packs 0.22.2 → 0.22.3

package/dist/fastapi.js

@@ -37,6 +37,20 @@ function fastapiFramework(options = {}) {
         defaultStatusCode: 200,
         responseModelKeyword: "response_model",
         statusCodeKeyword: "status_code",
+        // FastAPI re-exports Starlette's class, and a project may import
+        // it from either module.
+        responseStatusCalls: [
+          {
+            callee: "fastapi.HTTPException",
+            statusKeyword: "status_code",
+            statusArgument: 0
+          },
+          {
+            callee: "starlette.exceptions.HTTPException",
+            statusKeyword: "status_code",
+            statusArgument: 0
+          }
+        ],
         routerComposition: {
           routerConstructorName: "APIRouter",
           includeMethodName: "include_router",

package/dist/flask-restx.js

@@ -57,8 +57,15 @@ function flaskRestxFramework(options = {}) {
         // and sets no status of its own.
         defaultStatusCode: 200,
         // Flask reads a status out of `return body, 201`, so the 200
-        // above only stands when the body writes no status of its own.
-        statusFromReturnedTuple: true
+        // above only applies where the body writes no status of its own.
+        statusFromReturnedTuple: true,
+        // flask-restx re-exports Flask's function, which re-exports
+        // Werkzeug's, and a project may import it from any of the three.
+        responseStatusCalls: [
+          { callee: "flask_restx.abort", statusArgument: 0 },
+          { callee: "flask.abort", statusArgument: 0 },
+          { callee: "werkzeug.exceptions.abort", statusArgument: 0 }
+        ]
       }
     ]
   };

package/dist/graphql-ruby.js

@@ -11,8 +11,10 @@ var optionsSchema = z.object({
    */
   root: z.string(),
   /**
-   * The directory of the config file these options came from. Whatever read
-   * that file supplies this; it is not written in the file itself.
+   * The directory a relative `root` is read against: the config file's
+   * own directory, or the directory the run reads when the options came
+   * without one. The CLI supplies this; it is not written in the file
+   * itself.
    */
   configDirectory: z.string().optional(),
   /** Base classes beyond `Types::BaseObject` that also mark a class as declaring GraphQL fields. */

package/dist/nestjs-rest.js

@@ -65,10 +65,9 @@ function nestjsRestFramework(options = {}) {
         extraction: {}
       },
       {
-        // Many controllers fall through (return undefined) when the
-        // operation is fire-and-forget (`@HttpCode(204)` for
-        // delete-style). Keep a default transition so
-        // `transitions: []` isn't the surface shape.
+        // A method that runs off the end returns undefined, and Nest
+        // sends the same 200 with an empty body it sends for a bare
+        // `return;`. Only `@HttpCode(N)` changes that.
         kind: "response",
         match: { type: "functionFallthrough" },
         extraction: {

package/dist/rails.js

@@ -136,7 +136,9 @@ function joinKey(prefix, segment) {
   return prefix === "" ? segment : `${prefix}/${segment}`;
 }
 function joinPath(prefix, segment) {
-  return `${prefix}/${segment}`;
+  const trimmed = segment.replace(/^\/+/, "").replace(/\/+$/, "");
+  const base = prefix.replace(/\/+$/, "");
+  return trimmed === "" ? base || "/" : `${base}/${trimmed}`;
 }
 function handleResourceCall(call, ctx, out, plural) {
   const args = readSimpleArgs(call);
@@ -144,10 +146,10 @@ function handleResourceCall(call, ctx, out, plural) {
   if (symbol === null) {
     return;
   }
-  const controllerSegment = plural ? symbol : pluralize(symbol);
+  const controllerSegment = wordValue(args.keyword.controller) ?? (plural ? symbol : pluralize(symbol));
   const controllerKey = joinKey(ctx.modulePrefix, controllerSegment);
   const prefixBase = ctx.resource !== void 0 ? ctx.resource.nestedBase : ctx.pathPrefix;
-  const base = joinPath(prefixBase, symbol);
+  const base = joinPath(prefixBase, wordValue(args.keyword.path) ?? symbol);
   const only = readSymbolList(args.keyword.only);
   const except = readSymbolList(args.keyword.except);
   const table = plural ? RESTFUL_ROUTES_PLURAL : RESTFUL_ROUTES_SINGULAR;
@@ -165,12 +167,13 @@ function handleResourceCall(call, ctx, out, plural) {
   if (body === null) {
     return;
   }
+  const nestedBase = plural ? `${base}/:${singularize(symbol)}_id` : base;
   const nested = {
     controllerKey,
     collectionBase: base,
     memberBase: plural ? `${base}/:id` : base,
-    nestedBase: `${base}/:${singularize(symbol)}_id`,
-    ambientBase: null
+    nestedBase,
+    ambientBase: nestedBase
   };
   walkBody(body, { ...ctx, resource: nested }, out);
 }
@@ -186,6 +189,15 @@ function handleOnBlock(call, ctx, out, isMember) {
   const ambientBase = isMember ? ctx.resource.memberBase : ctx.resource.collectionBase;
   walkBody(body, { ...ctx, resource: { ...ctx.resource, ambientBase } }, out);
 }
+function baseForOn(resource, on) {
+  if (on === "collection") {
+    return resource.collectionBase;
+  }
+  if (on === "member") {
+    return resource.memberBase;
+  }
+  return resource.ambientBase;
+}
 function handleVerb(call, ctx, out, method) {
   const args = readSimpleArgs(call);
   const target = readRouteTarget(args);
@@ -193,9 +205,9 @@ function handleVerb(call, ctx, out, method) {
     const literalPath = args.positional[0] ? stringValueOf(args.positional[0]) : null;
     const path2 = target.path ?? literalPath;
     if (path2 !== null) {
-      out.add(target.controllerKey, target.action, {
+      out.add(joinKey(ctx.modulePrefix, target.controllerKey), target.action, {
         method,
-        path: `${ctx.pathPrefix}${path2}`
+        path: joinPath(ctx.pathPrefix, path2)
       });
     }
     return;
@@ -207,11 +219,7 @@ function handleVerb(call, ctx, out, method) {
   if (symbol === null) {
     return;
   }
-  const on = wordValue(args.keyword.on);
-  const base = on === "collection" ? ctx.resource.collectionBase : on === "member" ? ctx.resource.memberBase : ctx.resource.ambientBase;
-  if (base === null) {
-    return;
-  }
+  const base = baseForOn(ctx.resource, wordValue(args.keyword.on));
   out.add(ctx.resource.controllerKey, symbol, {
     method,
     path: `${base}/${symbol}`
@@ -221,7 +229,7 @@ function handleRoot(call, ctx, out) {
   const args = readSimpleArgs(call);
   const target = readRouteTarget(args) ?? (args.positional[0] ? splitControllerAction(stringValueOf(args.positional[0]) ?? "") : null);
   if (target !== null) {
-    out.add(target.controllerKey, target.action, {
+    out.add(joinKey(ctx.modulePrefix, target.controllerKey), target.action, {
       method: "GET",
       path: ctx.pathPrefix === "" ? "/" : ctx.pathPrefix
     });
@@ -247,7 +255,7 @@ function handleNamespace(call, ctx, out) {
 function handleScope(call, ctx, out) {
   const args = readSimpleArgs(call);
   const moduleName = wordValue(args.keyword.module);
-  const pathSegment = wordValue(args.keyword.path);
+  const pathSegment = wordValue(args.keyword.path) ?? (args.positional[0] ? wordValue(args.positional[0]) : null);
   const block = field(call, "block");
   const body = block !== null ? field(block, "body") : null;
   if (body === null) {
@@ -329,16 +337,92 @@ function readRoutesFile(absRoutesPath, displayPath) {
     gaps: out.gapsAgainst(displayPath)
   };
 }
+var RACK_STATUS_CODE_NAMES = {
+  continue: 100,
+  switching_protocols: 101,
+  processing: 102,
+  early_hints: 103,
+  ok: 200,
+  created: 201,
+  accepted: 202,
+  non_authoritative_information: 203,
+  no_content: 204,
+  reset_content: 205,
+  partial_content: 206,
+  multi_status: 207,
+  already_reported: 208,
+  im_used: 226,
+  multiple_choices: 300,
+  moved_permanently: 301,
+  found: 302,
+  see_other: 303,
+  not_modified: 304,
+  use_proxy: 305,
+  temporary_redirect: 307,
+  permanent_redirect: 308,
+  bad_request: 400,
+  unauthorized: 401,
+  payment_required: 402,
+  forbidden: 403,
+  not_found: 404,
+  method_not_allowed: 405,
+  not_acceptable: 406,
+  proxy_authentication_required: 407,
+  request_timeout: 408,
+  conflict: 409,
+  gone: 410,
+  length_required: 411,
+  precondition_failed: 412,
+  request_entity_too_large: 413,
+  payload_too_large: 413,
+  content_too_large: 413,
+  request_uri_too_long: 414,
+  uri_too_long: 414,
+  unsupported_media_type: 415,
+  requested_range_not_satisfiable: 416,
+  range_not_satisfiable: 416,
+  expectation_failed: 417,
+  misdirected_request: 421,
+  unprocessable_entity: 422,
+  unprocessable_content: 422,
+  locked: 423,
+  failed_dependency: 424,
+  too_early: 425,
+  upgrade_required: 426,
+  precondition_required: 428,
+  too_many_requests: 429,
+  request_header_fields_too_large: 431,
+  unavailable_for_legal_reasons: 451,
+  internal_server_error: 500,
+  not_implemented: 501,
+  bad_gateway: 502,
+  service_unavailable: 503,
+  gateway_timeout: 504,
+  http_version_not_supported: 505,
+  variant_also_negotiates: 506,
+  insufficient_storage: 507,
+  loop_detected: 508,
+  not_extended: 510,
+  network_authentication_required: 511
+};
 var optionsSchema = z.object({
   /** The app directory a bare controller name is looked up under. Every Rails app scaffolds this at `app`. */
   root: z.string().optional(),
   /**
-   * The directory of the config file these options came from. Whatever
-   * read that file supplies this; it is not written in the file itself.
+   * The directory a relative `root` or `routesFile` is read against: the
+   * config file's own directory, or the directory the run reads when the
+   * options came without one. The CLI supplies this; it is not written in
+   * the file itself.
    */
   configDirectory: z.string().optional(),
   /** Base classes beyond `ApplicationController` that also mark a class as a controller. */
   baseClassNames: z.array(z.string()).optional(),
+  /**
+   * Methods beyond Rails' own that every controller in this project
+   * gets without defining them, from a gem such as Devise. They are
+   * left off an action's effects the same way Rails' own are.
+   */
+  inheritedMethodNames: z.array(z.string()).optional(),
   /** Where this project's routes live, relative to `configDirectory` when there is one. Every Rails app scaffolds this at `config/routes.rb`. */
   routesFile: z.string().optional()
 }).strict();
@@ -355,6 +439,33 @@ var RESTFUL_ACTIONS = {
   update: { method: "PATCH", pathTemplate: "/:resource/:id" },
   destroy: { method: "DELETE", pathTemplate: "/:resource/:id" }
 };
+var RESPONSE_STATUS_CALLS = [
+  { name: "render", statusKeyword: "status" },
+  { name: "head", statusArgument: 0, statusKeyword: "status" },
+  { name: "redirect_to", statusKeyword: "status", defaultStatusCode: 302 },
+  { name: "redirect_back", statusKeyword: "status", defaultStatusCode: 302 }
+];
+var RAILS_CONTROLLER_METHODS = [
+  "params",
+  "request",
+  "response",
+  "session",
+  "cookies",
+  "flash",
+  "headers",
+  "render",
+  "head",
+  "redirect_to",
+  "redirect_back",
+  "respond_to",
+  "render_to_string",
+  "url_for",
+  "helpers",
+  "logger",
+  "action_name",
+  "controller_name",
+  "controller_path"
+];
 function controllerKeyFromQualified(qualifiedName) {
   const withoutSuffix = qualifiedName.endsWith("Controller") ? qualifiedName.slice(0, -"Controller".length) : qualifiedName;
   return underscoreConstantPath(withoutSuffix);
@@ -400,6 +511,12 @@ function railsFramework(options = {}) {
     pathConvention: "railsUnderscore",
     ancestryRootClassNames: [...RAILS_ROOT_CLASS_NAMES],
     defaultStatusCode: 200,
+    responseStatusCalls: RESPONSE_STATUS_CALLS,
+    statusCodeNames: RACK_STATUS_CODE_NAMES,
+    inheritedMethodNames: [
+      ...RAILS_CONTROLLER_METHODS,
+      ...options.inheritedMethodNames ?? []
+    ],
     routesFile,
     routeFor: (controllerQualifiedName, actionName) => {
       const key = controllerKeyFromQualified(controllerQualifiedName);

package/dist/sqlalchemy.js

@@ -14,7 +14,32 @@ function sqlalchemyStorage(options) {
     {
       module: "sqlalchemy.orm",
       queryTypes: ["Query", "Session"],
-      writes: ["update", "delete", "add", "add_all", "merge", "commit"],
+      writes: [
+        "update",
+        "delete",
+        "add",
+        "add_all",
+        "merge",
+        "flush",
+        "commit",
+        "bulk_save_objects",
+        "bulk_insert_mappings",
+        "bulk_update_mappings"
+      ],
+      // A Session runs a statement built by `select`/`update`/... whose
+      // own chain is read, and the rest of these manage the session.
+      recordsNothing: [
+        "execute",
+        "scalars",
+        "scalar",
+        "begin",
+        "rollback",
+        "close",
+        "expire",
+        "expire_all",
+        "expunge",
+        "expunge_all"
+      ],
       storageSystem: options.storageSystem
     },
     {
@@ -25,6 +50,7 @@ function sqlalchemyStorage(options) {
       // constructor rather than reaching it through a mapped class, so there
       // is no project method in between whose return says what it is.
       queryFunctions: ["select", "insert", "update", "delete"],
+      valueMethods: ["values"],
       storageSystem: options.storageSystem
     }
   ];

package/package.json

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