@suss/extractor 0.5.7 → 0.5.9

package/dist/index.cjs

@@ -969,7 +969,7 @@ var terminalConverters = {
     return { type: "response", statusCode, body, headers: {} };
   },
   throw: (t) => {
-    if (t.statusCode) {
+    if (t.statusCode && t.producesResponse === true) {
       const statusCode = t.statusCode.type === "literal" ? { type: "literal", value: t.statusCode.value } : { type: "unresolved", sourceText: t.statusCode.sourceText };
       return {
         type: "response",

package/dist/index.d.cts

@@ -922,6 +922,13 @@ interface TerminalPattern {
     kind: "response" | "throw" | "return" | "render";
     match: TerminalMatch;
     extraction: TerminalExtraction;
+    /**
+     * On a throw terminal: the framework turns the thrown status into
+     * the wire response, so a resolved status makes the output a
+     * response. HTTP packs state this; a pack reading a non-HTTP code
+     * space off throws leaves it off and the throw stays a throw (#149).
+     */
+    producesResponse?: boolean;
 }
 interface ContractPattern {
     /** How to find the contract object. A contract is a data structure rather
@@ -938,6 +945,19 @@ interface ContractPattern {
     paramsExtraction?: {
         property: string;
     };
+    /**
+     * Where the reader finds one endpoint's contract object. Left out,
+     * the ts-rest shape applies: one contract object contains every
+     * endpoint keyed by handler name, and the reader walks up from the
+     * handler to the enclosing router call. With `registrationArgument`,
+     * the zod-openapi shape applies instead: `app.openapi(route, handler)`
+     * passes the endpoint's own contract as the handler's sibling
+     * argument.
+     */
+    endpoint?: {
+        from: "registrationArgument";
+        position: number;
+    };
 }
 type InputMappingPattern = {
     /** Single object parameter, e.g. React Router LoaderFunctionArgs */
@@ -1227,6 +1247,24 @@ interface PatternPack {
      * available without importing anything).
      */
     requiresImport?: string[];
+    /**
+     * Environment variables the pack's library reads from inside
+     * node_modules, where no walk ever looks. Declaring them keeps the
+     * checker from telling a template that a variable is unused when the
+     * library reads it on every invocation. The adapter emits one marker
+     * summary per entry whose `module` some project file imports, and
+     * the runtime-config pairing consults the markers before it accuses.
+     * The module match is a specifier prefix, so one entry covers a
+     * scoped family like `@aws-lambda-powertools/`.
+     */
+    libraryEnvVars?: Array<{
+        /** Module-specifier prefix the library's imports start with. */
+        module: string;
+        /** Env-var name prefixes the library reads, e.g. "POWERTOOLS_". */
+        prefixes?: string[];
+        /** Exact env-var names the library reads. */
+        names?: string[];
+    }>;
     /**
      * Library wrappers that return the function they wrapped. The adapter
      * works this out on its own for a factory inside the project by reading
@@ -1596,6 +1634,8 @@ interface RawTerminal {
     } | null;
     exceptionType: string | null;
     message: string | null;
+    /** Set on a throw whose pack declared the thrown status is the wire response. */
+    producesResponse?: boolean;
     component: string | null;
     /** Null when the pack read only the root element name, not the tree under it. */
     renderTree: RenderNode | null;

package/dist/index.d.ts

@@ -922,6 +922,13 @@ interface TerminalPattern {
     kind: "response" | "throw" | "return" | "render";
     match: TerminalMatch;
     extraction: TerminalExtraction;
+    /**
+     * On a throw terminal: the framework turns the thrown status into
+     * the wire response, so a resolved status makes the output a
+     * response. HTTP packs state this; a pack reading a non-HTTP code
+     * space off throws leaves it off and the throw stays a throw (#149).
+     */
+    producesResponse?: boolean;
 }
 interface ContractPattern {
     /** How to find the contract object. A contract is a data structure rather
@@ -938,6 +945,19 @@ interface ContractPattern {
     paramsExtraction?: {
         property: string;
     };
+    /**
+     * Where the reader finds one endpoint's contract object. Left out,
+     * the ts-rest shape applies: one contract object contains every
+     * endpoint keyed by handler name, and the reader walks up from the
+     * handler to the enclosing router call. With `registrationArgument`,
+     * the zod-openapi shape applies instead: `app.openapi(route, handler)`
+     * passes the endpoint's own contract as the handler's sibling
+     * argument.
+     */
+    endpoint?: {
+        from: "registrationArgument";
+        position: number;
+    };
 }
 type InputMappingPattern = {
     /** Single object parameter, e.g. React Router LoaderFunctionArgs */
@@ -1227,6 +1247,24 @@ interface PatternPack {
      * available without importing anything).
      */
     requiresImport?: string[];
+    /**
+     * Environment variables the pack's library reads from inside
+     * node_modules, where no walk ever looks. Declaring them keeps the
+     * checker from telling a template that a variable is unused when the
+     * library reads it on every invocation. The adapter emits one marker
+     * summary per entry whose `module` some project file imports, and
+     * the runtime-config pairing consults the markers before it accuses.
+     * The module match is a specifier prefix, so one entry covers a
+     * scoped family like `@aws-lambda-powertools/`.
+     */
+    libraryEnvVars?: Array<{
+        /** Module-specifier prefix the library's imports start with. */
+        module: string;
+        /** Env-var name prefixes the library reads, e.g. "POWERTOOLS_". */
+        prefixes?: string[];
+        /** Exact env-var names the library reads. */
+        names?: string[];
+    }>;
     /**
      * Library wrappers that return the function they wrapped. The adapter
      * works this out on its own for a factory inside the project by reading
@@ -1596,6 +1634,8 @@ interface RawTerminal {
     } | null;
     exceptionType: string | null;
     message: string | null;
+    /** Set on a throw whose pack declared the thrown status is the wire response. */
+    producesResponse?: boolean;
     component: string | null;
     /** Null when the pack read only the root element name, not the tree under it. */
     renderTree: RenderNode | null;

package/dist/index.js

@@ -927,7 +927,7 @@ var terminalConverters = {
     return { type: "response", statusCode, body, headers: {} };
   },
   throw: (t) => {
-    if (t.statusCode) {
+    if (t.statusCode && t.producesResponse === true) {
       const statusCode = t.statusCode.type === "literal" ? { type: "literal", value: t.statusCode.value } : { type: "unresolved", sourceText: t.statusCode.sourceText };
       return {
         type: "response",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/extractor",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "type": "module",
   "description": "Framework-agnostic extraction pipeline that turns raw extractions into suss behavioral summaries.",
   "keywords": [
@@ -45,7 +45,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/behavioral-ir": "0.5.7"
+    "@suss/behavioral-ir": "0.5.9"
   },
   "devDependencies": {
     "tsup": "*",