@suss/packs 0.22.4 → 0.24.0

package/README.md

@@ -1,5 +1,7 @@
 # @suss/packs
 
+Part of [suss](https://github.com/nimbuscloud-ai/suss), which reads both sides of every call in a repository and says where the two disagree.
+
 Every pack suss ships, as one package with a subpath per pack.
 
 ```bash

package/dist/activerecord.d.ts

@@ -1,4 +1,5 @@
-export { default, optionsSchema } from '@suss/framework-activerecord';
+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';
@@ -13,6 +14,7 @@ import '@suss/client-axios';
 import '@suss/framework-cloudflare-workers';
 import '@suss/framework-drizzle';
 import '@suss/framework-express';
+import '@suss/client-faraday';
 import '@suss/framework-fastapi';
 import '@suss/framework-fastify';
 import '@suss/client-web';
@@ -20,10 +22,12 @@ 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-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';
@@ -33,6 +37,7 @@ 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-sqlalchemy';
 import '@suss/framework-ts-rest';
 import '@suss/framework-zustand';

package/dist/activerecord.js

@@ -48,8 +48,18 @@ function activeRecordFramework(options) {
     storage: activeRecordStorage(options)
   };
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-activerecord",
+  dependencies: [
+    { ecosystem: "rubygems", name: "activerecord" },
+    { ecosystem: "rubygems", name: "rails" }
+  ],
+  reads: "ActiveRecord calls (Ruby): a call matches when the constant its receivers start at reaches `ActiveRecord::Base`, following what each class extends through the project."
+};
 var index_default = activeRecordFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/aiohttp.d.ts

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

package/dist/aiohttp.js

@@ -0,0 +1,43 @@
+// ../client/aiohttp/dist/index.js
+var VERB_METHODS = {
+  get: "GET",
+  post: "POST",
+  put: "PUT",
+  patch: "PATCH",
+  delete: "DELETE",
+  head: "HEAD",
+  options: "OPTIONS"
+};
+function aiohttpClient() {
+  return {
+    name: "aiohttp",
+    protocol: "http",
+    discovery: [],
+    clients: [
+      {
+        type: "clientCall",
+        importModule: ["aiohttp"],
+        verbAttributeNames: VERB_METHODS,
+        url: { position: 0, keyword: "url" },
+        methodCall: {
+          attribute: "request",
+          methodPosition: 0,
+          methodKeyword: "method",
+          urlPosition: 1
+        },
+        receiverConstructors: ["ClientSession"]
+      }
+    ]
+  };
+}
+var declares = {
+  kind: "client",
+  package: "@suss/client-aiohttp",
+  dependencies: [{ ecosystem: "pypi", name: "aiohttp" }],
+  reads: "aiohttp call sites (Python): the request methods on a `ClientSession`, opened with `async with` or held in an assignment."
+};
+var index_default = aiohttpClient;
+export {
+  declares,
+  index_default as default
+};

package/dist/apollo-client.d.ts

@@ -1 +1 @@
-export { default, optionsSchema } from '@suss/client-apollo';
+export { declares, default, optionsSchema } from '@suss/client-apollo';

package/dist/apollo-client.js

@@ -153,8 +153,15 @@ function apolloClientPack(options = {}) {
     }
   };
 }
+var declares = {
+  kind: "client",
+  package: "@suss/client-apollo",
+  dependencies: [{ ecosystem: "npm", name: "@apollo/client" }],
+  reads: "`@apollo/client` hooks + imperative `client.query`."
+};
 var index_default = apolloClientPack;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/apollo.d.ts

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

package/dist/apollo.js

@@ -84,7 +84,14 @@ function apolloFramework() {
     }
   };
 }
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-apollo",
+  dependencies: [{ ecosystem: "npm", name: "@apollo/server" }],
+  reads: "Apollo Server resolvers (code-first)."
+};
 var index_default = apolloFramework;
 export {
+  declares,
   index_default as default
 };

package/dist/aws-dynamodb.d.ts

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

package/dist/aws-dynamodb.js

@@ -328,8 +328,18 @@ function dynamoFramework(options = {}) {
     ...options.requiresImport === void 0 ? {} : { requiresImport: options.requiresImport }
   });
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-aws-dynamodb",
+  dependencies: [
+    { ecosystem: "npm", name: "@aws-sdk/lib-dynamodb" },
+    { ecosystem: "npm", name: "@aws-sdk/client-dynamodb" }
+  ],
+  reads: "AWS SDK v3 DynamoDB calls, emits storage-access interactions."
+};
 var index_default = dynamoFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/aws-eventbridge.d.ts

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

package/dist/aws-eventbridge.js

@@ -88,8 +88,15 @@ function eventBridgeFramework(options = {}) {
     }
   );
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-aws-eventbridge",
+  dependencies: [{ ecosystem: "npm", name: "@aws-sdk/client-eventbridge" }],
+  reads: "AWS EventBridge `PutEvents` producer calls, emits message-bus interactions."
+};
 var index_default = eventBridgeFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/aws-lambda.d.ts

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

package/dist/aws-lambda.js

@@ -430,8 +430,15 @@ function awsLambdaFramework(_options = {}) {
     declarations: declarationsIn(invokes)
   };
 }
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-aws-lambda",
+  dependencies: [{ ecosystem: "npm", name: "@types/aws-lambda" }],
+  reads: "AWS Lambda HTTP handlers, paired to SAM / CloudFormation-declared routes."
+};
 var index_default = awsLambdaFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/aws-s3.d.ts

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

package/dist/aws-s3.js

@@ -34,7 +34,14 @@ function s3Framework() {
     protocol: "s3"
   });
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-aws-s3",
+  dependencies: [{ ecosystem: "npm", name: "@aws-sdk/client-s3" }],
+  reads: "AWS SDK v3 S3 object calls, emits storage-access interactions."
+};
 var index_default = s3Framework;
 export {
+  declares,
   index_default as default
 };

package/dist/aws-secrets-manager.d.ts

@@ -1 +1 @@
-export { default } from '@suss/framework-aws-secrets-manager';
+export { declares, default } from '@suss/framework-aws-secrets-manager';

package/dist/aws-secrets-manager.js

@@ -28,7 +28,14 @@ function secretsManagerFramework() {
     protocol: "aws.secretsmanager"
   });
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-aws-secrets-manager",
+  dependencies: [{ ecosystem: "npm", name: "@aws-sdk/client-secrets-manager" }],
+  reads: "AWS Secrets Manager calls, emits storage-access interactions against the secret."
+};
 var index_default = secretsManagerFramework;
 export {
+  declares,
   index_default as default
 };

package/dist/aws-sns.d.ts

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

package/dist/aws-sns.js

@@ -44,7 +44,14 @@ function snsFramework() {
     protocol: "sns"
   });
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-aws-sns",
+  dependencies: [{ ecosystem: "npm", name: "@aws-sdk/client-sns" }],
+  reads: "AWS SDK v3 SNS `Publish` and `PublishBatch` calls, emits message-send interactions on the topic."
+};
 var index_default = snsFramework;
 export {
+  declares,
   index_default as default
 };

package/dist/aws-sqs.d.ts

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

package/dist/aws-sqs.js

@@ -203,8 +203,15 @@ function sqsFramework(options = {}) {
     ]
   });
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-aws-sqs",
+  dependencies: [{ ecosystem: "npm", name: "@aws-sdk/client-sqs" }],
+  reads: "AWS SDK v3 SQS producer calls, emits message-send interactions."
+};
 var index_default = sqsFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/aws-ssm.d.ts

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

package/dist/aws-ssm.js

@@ -25,7 +25,14 @@ function ssmFramework() {
     protocol: "aws.ssm"
   });
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-aws-ssm",
+  dependencies: [{ ecosystem: "npm", name: "@aws-sdk/client-ssm" }],
+  reads: "AWS SSM Parameter Store calls, emits storage-access interactions against the parameter."
+};
 var index_default = ssmFramework;
 export {
+  declares,
   index_default as default
 };

package/dist/axios.d.ts

@@ -1 +1 @@
-export { default, optionsSchema } from '@suss/client-axios';
+export { declares, default, optionsSchema } from '@suss/client-axios';

package/dist/axios.js

@@ -118,8 +118,15 @@ function axiosPack(options = {}) {
     failureDelivery: "exception"
   };
 }
+var declares = {
+  kind: "client",
+  package: "@suss/client-axios",
+  dependencies: [{ ecosystem: "npm", name: "axios" }],
+  reads: "axios call sites + `axios.create` factories."
+};
 var index_default = axiosPack;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/cloudflare-workers.d.ts

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

package/dist/cloudflare-workers.js

@@ -566,8 +566,18 @@ function cloudflareWorkersFramework(options = {}) {
     invocationRecognizers: [storeBindingRecognizer]
   };
 }
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-cloudflare-workers",
+  dependencies: [
+    { ecosystem: "npm", name: "wrangler" },
+    { ecosystem: "npm", name: "@cloudflare/workers-types" }
+  ],
+  reads: "A Cloudflare Workers entrypoint: one unit per trigger the default export defines, and the bindings its code reads off the argument they arrive in."
+};
 var index_default = cloudflareWorkersFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/drizzle.d.ts

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

package/dist/drizzle.js

@@ -336,8 +336,15 @@ function drizzleFramework(options = {}) {
     declarations: declarationsIn([raw])
   };
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-drizzle",
+  dependencies: [{ ecosystem: "npm", name: "drizzle-orm" }],
+  reads: "Drizzle ORM query-builder and relational-query calls, emits storage-access interactions with SQL table names."
+};
 var index_default = drizzleFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/express.d.ts

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

package/dist/express.js

@@ -166,8 +166,15 @@ function expressFramework(_options = {}) {
     }
   };
 }
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-express",
+  dependencies: [{ ecosystem: "npm", name: "express" }],
+  reads: "Express handlers."
+};
 var index_default = expressFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/faraday.d.ts

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

package/dist/faraday.js

@@ -0,0 +1,48 @@
+// ../client/faraday/dist/index.js
+var VERB_METHODS = {
+  get: "GET",
+  post: "POST",
+  put: "PUT",
+  patch: "PATCH",
+  delete: "DELETE",
+  head: "HEAD",
+  options: "OPTIONS"
+};
+function faradayClient() {
+  return {
+    name: "faraday",
+    protocol: "http",
+    discovery: [],
+    clients: [
+      {
+        constantName: "Faraday",
+        verbMethodNames: VERB_METHODS,
+        // Every one of them takes the URL first.
+        url: { position: 0 },
+        receiverBuilders: ["new"],
+        // `Faraday.new(url: "https://api.example.com/v1")` serves every
+        // call on that connection under the path of its own URL.
+        builderUrlKeyword: "url",
+        // What a caller reads off the response it got back. A test on
+        // one of these says which statuses the caller handles.
+        response: {
+          statusCode: ["status"],
+          success: ["success?"],
+          body: ["body"],
+          failureDelivery: "response"
+        }
+      }
+    ]
+  };
+}
+var declares = {
+  kind: "client",
+  package: "@suss/client-faraday",
+  dependencies: [{ ecosystem: "rubygems", name: "faraday" }],
+  reads: `Faraday call sites (Ruby): a request method on the module itself or on a connection \`Faraday.new\` built, served under the path that connection's own URL states.`
+};
+var index_default = faradayClient;
+export {
+  declares,
+  index_default as default
+};

package/dist/fastapi.d.ts

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

package/dist/fastapi.js

@@ -51,18 +51,66 @@ function fastapiFramework(options = {}) {
             statusArgument: 0
           }
         ],
+        // A route may respond by returning one of these built with a status.
+        responseConstructors: [
+          { callee: "fastapi.Response", statusKeyword: "status_code" },
+          {
+            callee: "starlette.responses.Response",
+            statusKeyword: "status_code"
+          },
+          {
+            callee: "fastapi.responses.JSONResponse",
+            statusKeyword: "status_code"
+          },
+          {
+            callee: "starlette.responses.JSONResponse",
+            statusKeyword: "status_code"
+          }
+        ],
         routerComposition: {
           routerConstructorName: "APIRouter",
           includeMethodName: "include_router",
           routerKeyword: "router",
           prefixKeyword: "prefix"
-        }
+        },
+        wrappers: [
+          {
+            type: "dependency",
+            callees: ["Depends", "Security"],
+            keyword: "dependencies",
+            registrars: [
+              { constructorName: "FastAPI", covers: "everyRoute" },
+              { constructorName: "APIRouter", covers: "ownRoutes" }
+            ]
+          },
+          {
+            type: "decoratedWrapper",
+            attribute: "middleware",
+            registrars: [{ constructorName: "FastAPI", covers: "everyRoute" }],
+            // `async def m(request, call_next)`.
+            continuationParam: 1
+          },
+          {
+            type: "decoratedWrapper",
+            attribute: "exception_handler",
+            registrars: [{ constructorName: "FastAPI", covers: "everyRoute" }],
+            // `async def h(request, exc)`.
+            throwParam: 1
+          }
+        ]
       }
     ]
   };
 }
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-fastapi",
+  dependencies: [{ ecosystem: "pypi", name: "fastapi" }],
+  reads: `FastAPI routes (Python): the verb comes from the decorator's own attribute name, \`APIRouter\` prefixes are composed one \`include_router\` hop deep, and \`response_model\` / \`status_code\` are taken as the declared contract.`
+};
 var index_default = fastapiFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/fastify.d.ts

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

package/dist/fastify.js

@@ -122,8 +122,15 @@ function fastifyFramework(_options = {}) {
     }
   };
 }
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-fastify",
+  dependencies: [{ ecosystem: "npm", name: "fastify" }],
+  reads: "Fastify handlers."
+};
 var index_default = fastifyFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/fetch.d.ts

@@ -1 +1 @@
-export { default } from '@suss/client-web';
+export { declares, default } from '@suss/client-web';

package/dist/fetch.js

@@ -58,7 +58,15 @@ function webFetchPack() {
     ]
   };
 }
+var declares = {
+  kind: "client",
+  package: "@suss/client-web",
+  dependencies: [],
+  shippedWith: "typescript",
+  reads: "Global `fetch` call sites."
+};
 var index_default = webFetchPack;
 export {
+  declares,
   index_default as default
 };

package/dist/flask-restx.d.ts

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

package/dist/flask-restx.js

@@ -65,13 +65,53 @@ function flaskRestxFramework(options = {}) {
           { callee: "flask_restx.abort", statusArgument: 0 },
           { callee: "flask.abort", statusArgument: 0 },
           { callee: "werkzeug.exceptions.abort", statusArgument: 0 }
+        ],
+        wrappers: [
+          {
+            type: "decoratedWrapper",
+            attribute: "before_request",
+            // A blueprint's own hook is not read: a route is decorated on
+            // a namespace, and the blueprint it is served under is a mount.
+            registrars: [
+              {
+                constructorName: "Flask",
+                importModule: ["flask"],
+                covers: "everyRoute"
+              }
+            ],
+            // Flask sends whatever a before_request hook returns, and
+            // goes on to the view only when it returns None.
+            returnedValueResponds: true
+          },
+          {
+            type: "decoratedWrapper",
+            attribute: "errorhandler",
+            registrars: [
+              {
+                constructorName: "Flask",
+                importModule: ["flask"],
+                covers: "everyRoute"
+              },
+              { constructorName: "Api", covers: "everyRoute" },
+              { constructorName: "Namespace", covers: "ownRoutes" }
+            ],
+            // `def handle(error)`.
+            throwParam: 0
+          }
         ]
       }
     ]
   };
 }
+var declares = {
+  kind: "framework",
+  package: "@suss/framework-flask-restx",
+  dependencies: [{ ecosystem: "pypi", name: "flask-restx" }],
+  reads: `flask-restx \`Resource\` routes (Python), including a project's own wrapper module that re-exports the route decorator.`
+};
 var index_default = flaskRestxFramework;
 export {
+  declares,
   index_default as default,
   optionsSchema
 };

package/dist/gcs.d.ts

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

package/dist/gcs.js

@@ -49,7 +49,14 @@ function gcsFramework() {
     recognizedAs: "@suss/framework-gcs"
   });
 }
+var declares = {
+  kind: "effects",
+  package: "@suss/framework-gcs",
+  dependencies: [{ ecosystem: "npm", name: "@google-cloud/storage" }],
+  reads: "Google Cloud Storage calls, emits storage-access interactions."
+};
 var index_default = gcsFramework;
 export {
+  declares,
   index_default as default
 };