@kernlang/python 3.5.2

package/dist/fastapi-raw-handler.js

@@ -0,0 +1,282 @@
+/**
+ * Detection + emission helpers for raw `<<<...>>>` handler bodies when the
+ * target is FastAPI/Python.
+ *
+ * Raw handler bodies are usually JavaScript/TypeScript — the legacy authoring
+ * form before native KERN body-stmts existed. The TS codegen path can emit
+ * them verbatim (it's already TypeScript), but the Python codegen must either
+ * lower them or refuse them; emitting raw JS inside a Python `def` produces
+ * invalid Python that breaks `ast.parse` on the generated module.
+ *
+ * Two helpers exposed:
+ *   - `isUnsupportedJsHandlerBody`: returns true if the body uses
+ *     JS-specific idioms that Python cannot accept verbatim (`res.X`,
+ *     backtick template literals, optional chaining `?.`, nullish
+ *     coalescing `??`, arrow functions `=>`, object shorthand inside
+ *     literals).
+ *   - `unsupportedRawHandlerBody`: returns the boilerplate Python that
+ *     replaces an unsupported body with a `NotImplementedError` raise,
+ *     so the route file still parses + imports cleanly.
+ *
+ * Co-locating these here (instead of inside fastapi-route.ts) lets the
+ * portable-handler path in fastapi-portable.ts apply the same guard without
+ * introducing an import cycle between portable and route.
+ */
+// Sticky-flag (`y`) regex that finds a candidate JS private-field-start
+// at the `lastIndex` position. Either:
+//   - A JS identifier-start codepoint directly: ASCII letters/`_`/`$`
+//     plus the full Unicode `ID_Start` category (matches whole
+//     codepoints via `u` flag, so non-BMP surrogate pairs work).
+//   - A `\uXXXX` (4 hex digits) or `\u{...}` Unicode-escape sequence —
+//     the FORM JS uses for escaped identifier characters. Note: the
+//     escape's decoded codepoint must still be `ID_Start`-valid; that
+//     check happens in `isPrivateFieldStartAt` below per Codex fix-up
+//     17 review (`#0` decodes to `0` which is NOT ID_Start).
+// Sticky `y` (not anchored `^` on a slice) avoids O(N²) string allocation
+// per `#` encounter (Gemini fix-up 15 perf review).
+const PRIVATE_FIELD_START_AT_RE = /[$_\p{ID_Start}]|\\u(?:[0-9A-Fa-f]{4}|\{[0-9A-Fa-f]+\})/uy;
+const ID_START_RE = /[$_\p{ID_Start}]/u;
+// Tests whether `code[pos]` begins a JS private-field-name (i.e., the
+// character/sequence after a `#`). Returns true only when the matched
+// thing is a real JS identifier-start: either a literal ID_Start
+// codepoint, OR a `\u`-escape whose decoded codepoint IS ID_Start.
+function isPrivateFieldStartAt(code, pos) {
+    PRIVATE_FIELD_START_AT_RE.lastIndex = pos;
+    const matched = code.match(PRIVATE_FIELD_START_AT_RE);
+    if (!matched || matched.index !== pos)
+        return false;
+    const matchedText = matched[0];
+    if (!matchedText.startsWith('\\u'))
+        return true; // direct ID_Start codepoint
+    // `\uXXXX` or `\u{...}` — decode the hex and re-validate the resulting
+    // codepoint against `ID_Start`. Without this, `#0` (decodes to
+    // `0`, not an identifier-start) would be preserved as code.
+    const hex = matchedText.startsWith('\\u{') ? matchedText.slice(3, -1) : matchedText.slice(2);
+    const codepoint = Number.parseInt(hex, 16);
+    if (!Number.isFinite(codepoint) || codepoint > 0x10ffff)
+        return false;
+    return ID_START_RE.test(String.fromCodePoint(codepoint));
+}
+// Replace contents of every string literal AND comment with `_` so
+// JS-keyword detection regexes don't false-positive on tokens that
+// appear only inside strings or comments. Preserves quote delimiters,
+// newlines, and code outside strings. Honors backslash escapes so
+// `"\""` doesn't terminate the string early.
+//
+// Comment forms recognized:
+//   - Python line comments: `# ...` to end of line
+//   - JS line comments: `// ...` to end of line
+//   - JS block comments: `/* ... */`
+//
+// Review fix: Codex flagged on commit 68565826 that the original
+// version stripped strings but NOT comments — a `lang="python"` body
+// containing `# const x = 1` (a comment mentioning JS syntax) would
+// still trip the `\bconst\s+\w+\s*=` regex and emit a NotImplementedError
+// for valid Python.
+export function stripStringsForJsCheck(code) {
+    let result = '';
+    let i = 0;
+    // null | quote-char | '//' (JS line) | '#' (Python line) | '/*' (JS block)
+    let mode = null;
+    let escaped = false;
+    while (i < code.length) {
+        const ch = code[i];
+        const next = code[i + 1];
+        if (mode === '"' || mode === "'" || mode === '`') {
+            if (escaped) {
+                escaped = false;
+                result += '_';
+            }
+            else if (ch === '\\') {
+                escaped = true;
+                result += '_';
+            }
+            else if (ch === mode) {
+                mode = null;
+                result += ch;
+            }
+            else {
+                result += ch === '\n' ? '\n' : '_';
+            }
+            i += 1;
+            continue;
+        }
+        if (mode === '//' || mode === '#') {
+            if (ch === '\n') {
+                mode = null;
+                result += '\n';
+            }
+            else {
+                result += '_';
+            }
+            i += 1;
+            continue;
+        }
+        if (mode === '/*') {
+            if (ch === '*' && next === '/') {
+                mode = null;
+                result += '__';
+                i += 2;
+                continue;
+            }
+            result += ch === '\n' ? '\n' : '_';
+            i += 1;
+            continue;
+        }
+        // mode is null — code mode
+        if (ch === '"' || ch === "'" || ch === '`') {
+            mode = ch;
+            result += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '/' && next === '/') {
+            mode = '//';
+            result += '__';
+            i += 2;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            mode = '/*';
+            result += '__';
+            i += 2;
+            continue;
+        }
+        if (ch === '#') {
+            // `#` is a Python line comment ONLY when not directly followed by
+            // a JS identifier-start character (or a valid Unicode-escape
+            // identifier-escape sequence). Modern JS uses `#x` for private
+            // class fields; treating those as comments would hide real JS.
+            //
+            // The sticky regex tests at exactly position `i + 1` without
+            // creating a slice — O(1) per `#` (Gemini fix-up 15 perf review).
+            const isPrivateFieldStart = next !== undefined && isPrivateFieldStartAt(code, i + 1);
+            if (isPrivateFieldStart) {
+                result += ch;
+                i += 1;
+                continue;
+            }
+            mode = '#';
+            result += '_';
+            i += 1;
+            continue;
+        }
+        result += ch;
+        i += 1;
+    }
+    return result;
+}
+export function hasObjectShorthandOutsideStrings(expr) {
+    let index = 0;
+    let quote = null;
+    let escaped = false;
+    while (index < expr.length) {
+        const char = expr[index];
+        if (quote) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (char === '\\') {
+                escaped = true;
+            }
+            else if (char === quote) {
+                quote = null;
+            }
+            index += 1;
+            continue;
+        }
+        if (char === '"' || char === "'" || char === '`') {
+            quote = char;
+            index += 1;
+            continue;
+        }
+        if (char !== '{' && char !== ',') {
+            index += 1;
+            continue;
+        }
+        index += 1;
+        while (index < expr.length && /\s/.test(expr[index]))
+            index += 1;
+        if (index >= expr.length || !/[A-Za-z_$]/.test(expr[index]))
+            continue;
+        index += 1;
+        while (index < expr.length && /[\w$]/.test(expr[index]))
+            index += 1;
+        while (index < expr.length && /\s/.test(expr[index]))
+            index += 1;
+        if (expr[index] === ',' || expr[index] === '}')
+            return true;
+    }
+    return false;
+}
+// NOTE on cross-file asymmetry: `isUnsupportedJsHandlerBody` (this
+// function) inspects FULL HANDLER BODIES which contain multiple
+// statements — Python like `return new\nDate()` is two statements
+// and must NOT false-positive. Hence the `new` regexes here use
+// horizontal-whitespace-only `[^\S\r\n]+`.
+//
+// The sister guard `isLowerableJsValueExpression` in fastapi-route.ts
+// inspects EXPRESSION CONTENT (e.g., the X in `res.json(X)`) — a single
+// syntactic unit with no statement boundaries, so it can safely use
+// `\s+` (newlines OK) to catch `new\nDate()` etc. The asymmetry is
+// principled per Codex fix-up 16 review.
+export function isUnsupportedJsHandlerBody(code) {
+    // Run JS-keyword detection on a string-stripped view so a Python body
+    // like `text = "uses res.send pattern"` or `msg = "const x = ..."`
+    // doesn't false-positive. Backticks INSIDE strings are stripped to `_`,
+    // but unmatched backticks outside strings (i.e., JS template literals)
+    // still trip the check.
+    //
+    // M1 (Codex+Gemini on ae9663cf): the const/let/var detection used to
+    // only match `\bKEYWORD\s+\w+\s*=` — missed destructuring forms
+    // (`const {x} = obj`, `const [a] = arr`) and for-loop variants
+    // (`for (var x of list)`, `for (let x in obj)`). Both are common JS
+    // and produce invalid Python. Adding two more alternatives below.
+    // The `var x;` no-init form is intentionally NOT detected: broadening
+    // there would false-positive on Python `for var in items:` where `var`
+    // is a Python loop variable name (not a keyword).
+    //
+    // M2 (Gemini+Codex on 85593a3f): drop the `[A-Z]` PascalCase constraint
+    // on the `new` check and broaden to dotted callables — `new foo()`,
+    // `new globalThis.Date()`, etc. all produce SyntaxError in Python.
+    const stripped = stripStringsForJsCheck(code);
+    return (/\bres\./.test(stripped) ||
+        /`/.test(stripped) ||
+        /\?\./.test(stripped) ||
+        /\?\?/.test(stripped) ||
+        /=>/.test(stripped) ||
+        /\b(?:const|let|var)\s+[A-Za-z_$][\w$]*\s*=/.test(stripped) || // assignment form ($-identifiers; JS identifiers don't start with digits)
+        /\b(?:const|let|var)\s+[{[]/.test(stripped) || // destructuring form
+        /\bfor(?:\s+await)?\s*\(\s*(?:var|let|const)\s+/.test(stripped) || // for / for-await loop variant
+        // Parens form `new X(...)`. Horizontal-whitespace-only `[^\S\r\n]+`
+        // between `new` and the identifier — even though JS allows `new\n
+        // Date()`, Python `return new\nDate()` IS valid (two statements:
+        // `return new`, then `Date()`). Codex's fix-up 14 review correctly
+        // pointed out that the cross-newline match false-flags the Python
+        // case. The trade-off: a prettier-formatted JS source with
+        // `new\nLongConstructor()` slips the leak guard. Acceptable because:
+        //   1. Most JS authoring keeps `new Foo()` on one line.
+        //   2. The slipped JS still produces invalid Python downstream
+        //      (Python's `new` keyword doesn't exist), so the failure mode
+        //      is "generated module fails to import" — visible, not silent.
+        //   3. Python correctness > JS-edge-detection per the cross-target
+        //      safety doctrine of this arc.
+        /\bnew[^\S\r\n]+[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*\s*\(/.test(stripped) || // ctor with parens
+        // `new Foo` without parens is also valid JS (e.g., `return new Date`)
+        // and produces SyntaxError in Python. Two false-positive guards
+        // address review on fix-up 8 (Codex+Gemini, gemini-blocking):
+        //   1. Variable-width lookbehind `(?<!\bfor\s+)` — handles
+        //      `for  new in items:` with any whitespace between `for` and
+        //      `new` (was single-space only).
+        //   2. Negative lookahead for Python keywords after `new` — excludes
+        //      `new is None`, `new in items`, `new for x in seq`,
+        //      `new if cond else other`, `new and other`, `new or other`,
+        //      `new not other`. These are all valid Python where `new` is
+        //      a local variable name, not a JS construction.
+        /(?<!\bfor[^\S\r\n]+)\bnew[^\S\r\n]+(?!(?:is|in|for|if|else|and|or|not)\b)[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*\b/.test(stripped) ||
+        hasObjectShorthandOutsideStrings(code));
+}
+export function unsupportedRawHandlerBody(indent) {
+    return [`${indent}raise NotImplementedError("Unsupported raw JavaScript handler syntax for FastAPI target")`];
+}
+//# sourceMappingURL=fastapi-raw-handler.js.map

package/dist/fastapi-raw-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastapi-raw-handler.js","sourceRoot":"","sources":["../src/fastapi-raw-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wEAAwE;AACxE,uCAAuC;AACvC,sEAAsE;AACtE,+DAA+D;AAC/D,iEAAiE;AACjE,uEAAuE;AACvE,oEAAoE;AACpE,sEAAsE;AACtE,sEAAsE;AACtE,6DAA6D;AAC7D,0EAA0E;AAC1E,oDAAoD;AACpD,MAAM,yBAAyB,GAAG,2DAA2D,CAAC;AAC9F,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,sEAAsE;AACtE,sEAAsE;AACtE,iEAAiE;AACjE,mEAAmE;AACnE,SAAS,qBAAqB,CAAC,IAAY,EAAE,GAAW;IACtD,yBAAyB,CAAC,SAAS,GAAG,GAAG,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,4BAA4B;IAC7E,uEAAuE;IACvE,+DAA+D;IAC/D,4DAA4D;IAC5D,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtE,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,mEAAmE;AACnE,mEAAmE;AACnE,sEAAsE;AACtE,kEAAkE;AAClE,6CAA6C;AAC7C,EAAE;AACF,4BAA4B;AAC5B,mDAAmD;AACnD,gDAAgD;AAChD,qCAAqC;AACrC,EAAE;AACF,iEAAiE;AACjE,qEAAqE;AACrE,oEAAoE;AACpE,0EAA0E;AAC1E,oBAAoB;AACpB,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,2EAA2E;IAC3E,IAAI,IAAI,GAA+C,IAAI,CAAC;IAC5D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,GAAG,KAAK,CAAC;gBAChB,MAAM,IAAI,GAAG,CAAC;YAChB,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACvB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,IAAI,GAAG,CAAC;YAChB,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM,IAAI,EAAE,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACrC,CAAC;YACD,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAClC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM,IAAI,IAAI,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,CAAC;YAChB,CAAC;YACD,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAC/B,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM,IAAI,IAAI,CAAC;gBACf,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,MAAM,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACnC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,2BAA2B;QAC3B,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3C,IAAI,GAAG,EAAE,CAAC;YACV,MAAM,IAAI,EAAE,CAAC;YACb,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC/B,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM,IAAI,IAAI,CAAC;YACf,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC/B,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM,IAAI,IAAI,CAAC;YACf,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,kEAAkE;YAClE,6DAA6D;YAC7D,+DAA+D;YAC/D,+DAA+D;YAC/D,EAAE;YACF,6DAA6D;YAC7D,kEAAkE;YAClE,MAAM,mBAAmB,GAAG,IAAI,KAAK,SAAS,IAAI,qBAAqB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACrF,IAAI,mBAAmB,EAAE,CAAC;gBACxB,MAAM,IAAI,EAAE,CAAC;gBACb,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,GAAG,GAAG,CAAC;YACX,MAAM,IAAI,GAAG,CAAC;YACd,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,IAAI,EAAE,CAAC;QACb,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAAY;IAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAA2B,IAAI,CAAC;IACzC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC1B,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjD,KAAK,GAAG,IAAI,CAAC;YACb,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QACjE,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,SAAS;QACtE,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QACpE,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;IAC9D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mEAAmE;AACnE,gEAAgE;AAChE,kEAAkE;AAClE,gEAAgE;AAChE,2CAA2C;AAC3C,EAAE;AACF,sEAAsE;AACtE,wEAAwE;AACxE,oEAAoE;AACpE,mEAAmE;AACnE,yCAAyC;AACzC,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,sEAAsE;IACtE,mEAAmE;IACnE,wEAAwE;IACxE,uEAAuE;IACvE,wBAAwB;IACxB,EAAE;IACF,qEAAqE;IACrE,gEAAgE;IAChE,+DAA+D;IAC/D,oEAAoE;IACpE,kEAAkE;IAClE,sEAAsE;IACtE,uEAAuE;IACvE,kDAAkD;IAClD,EAAE;IACF,wEAAwE;IACxE,oEAAoE;IACpE,mEAAmE;IACnE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CACL,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QACnB,4CAA4C,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,0EAA0E;QACzI,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,qBAAqB;QACpE,gDAAgD,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,+BAA+B;QAClG,oEAAoE;QACpE,kEAAkE;QAClE,iEAAiE;QACjE,mEAAmE;QACnE,kEAAkE;QAClE,2DAA2D;QAC3D,qEAAqE;QACrE,wDAAwD;QACxD,+DAA+D;QAC/D,mEAAmE;QACnE,oEAAoE;QACpE,mEAAmE;QACnE,oCAAoC;QACpC,6DAA6D,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,mBAAmB;QACnG,sEAAsE;QACtE,gEAAgE;QAChE,8DAA8D;QAC9D,2DAA2D;QAC3D,kEAAkE;QAClE,sCAAsC;QACtC,qEAAqE;QACrE,0DAA0D;QAC1D,kEAAkE;QAClE,kEAAkE;QAClE,qDAAqD;QACrD,oHAAoH,CAAC,IAAI,CACvH,QAAQ,CACT;QACD,gCAAgC,CAAC,IAAI,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,OAAO,CAAC,GAAG,MAAM,2FAA2F,CAAC,CAAC;AAChH,CAAC"}

package/dist/fastapi-response.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Response helpers for the FastAPI transpiler.
+ *
+ * generateRespondFastAPI — IR respond node → Python return/raise statements
+ * rewriteFastAPIExpr    — rewrite portable request references to FastAPI equivalents
+ * extractExprCode       — extract expression code from IR prop
+ * addRespondImports     — add necessary imports for respond node
+ */
+import type { IRNode } from '@kernlang/core';
+export declare function generateRespondFastAPI(respondNode: IRNode, indent: string): string[];
+export declare function rewriteFastAPIExpr(expr: string, pathParams: string[]): string;
+export declare function extractExprCode(prop: unknown): string;
+export declare function addRespondImports(respondNode: IRNode, imports: Set<string>): void;

package/dist/fastapi-response.js

@@ -0,0 +1,150 @@
+/**
+ * Response helpers for the FastAPI transpiler.
+ *
+ * generateRespondFastAPI — IR respond node → Python return/raise statements
+ * rewriteFastAPIExpr    — rewrite portable request references to FastAPI equivalents
+ * extractExprCode       — extract expression code from IR prop
+ * addRespondImports     — add necessary imports for respond node
+ */
+import { getProps } from '@kernlang/core';
+import { escapePyStr } from './fastapi-utils.js';
+import { toSnakeCase } from './type-map.js';
+export function generateRespondFastAPI(respondNode, indent) {
+    const p = getProps(respondNode);
+    const status = typeof p.status === 'number' ? p.status : undefined;
+    const json = p.json;
+    const error = p.error;
+    const text = p.text;
+    const redirect = p.redirect;
+    if (redirect) {
+        return [`${indent}return RedirectResponse(url="${escapePyStr(String(redirect))}")`];
+    }
+    if (error) {
+        return [`${indent}raise HTTPException(status_code=${status || 500}, detail="${escapePyStr(String(error))}")`];
+    }
+    if (json) {
+        if (!status || status === 200) {
+            return [`${indent}return ${json}`];
+        }
+        return [`${indent}return JSONResponse(content=${json}, status_code=${status})`];
+    }
+    if (text) {
+        if (!status || status === 200) {
+            return [`${indent}return PlainTextResponse(content=${text})`];
+        }
+        return [`${indent}return PlainTextResponse(content=${text}, status_code=${status})`];
+    }
+    if (status === 204) {
+        return [`${indent}return Response(status_code=204)`];
+    }
+    if (status) {
+        return [`${indent}return Response(status_code=${status})`];
+    }
+    return [`${indent}return Response(status_code=200)`];
+}
+// One level of nested parens inside the arrow body: matches `(u.age > 18)`,
+// `Math.max(a, b)`, etc. Two-or-more levels still fall through (acceptable
+// fallback per the lift-rate metric).
+const ARROW_BODY = '((?:[^()]|\\([^()]*\\))+)';
+// Receiver allows brackets + spaces so chained calls work after the inner
+// call has already been rewritten to a list-comprehension (which contains
+// brackets). The outer iteration re-runs the regex on the rewritten form.
+const ARROW_RECEIVER = '([\\w.\\[\\] ]+?)';
+const FILTER_RE = new RegExp(`${ARROW_RECEIVER}\\.filter\\(\\((\\w+)\\)\\s*=>\\s*${ARROW_BODY}\\)`, 'g');
+const MAP_RE = new RegExp(`${ARROW_RECEIVER}\\.map\\(\\((\\w+)\\)\\s*=>\\s*${ARROW_BODY}\\)`, 'g');
+const FIND_RE = new RegExp(`${ARROW_RECEIVER}\\.find\\(\\((\\w+)\\)\\s*=>\\s*${ARROW_BODY}\\)`, 'g');
+// Quoted strings absorbed by the alternation; only literal `===`/`!==`
+// outside strings get rewritten. Both single and double quotes AND
+// backtick template literals are covered so a message like
+// `` `use ===` `` is preserved (review fix — Codex+Gemini on 0ddfcc3d
+// flagged backticks as missing). Escape sequences are honored so
+// `"\""` / `` `\`` `` etc. don't terminate the string early.
+const STRING_LITERAL_ALT = '"(?:[^"\\\\]|\\\\.)*"|\'(?:[^\'\\\\]|\\\\.)*\'|`(?:[^`\\\\]|\\\\.)*`';
+const STRICT_EQ_RE = new RegExp(`${STRING_LITERAL_ALT}|===|!==`, 'g');
+// Same trick for JS-literal lowering: any literal text inside a quoted
+// string OR after a `.` (property accessor — `obj.true` must NOT become
+// `obj.True`, which is a Python SyntaxError) is preserved untouched.
+// Variable-width lookbehind `(?<!\.\s*)` handles both tight (`obj.true`)
+// and loose (`obj . true`) forms; the latter caught by Codex review on
+// commit 68565826.
+const JS_LITERAL_RE = new RegExp(`${STRING_LITERAL_ALT}|(?<!\\.\\s*)\\b(?:undefined|null|true|false)\\b`, 'g');
+function lowerJsArrayMethods(expr) {
+    // Iterate so chained calls (`.filter(...).map(...)`) collapse fully.
+    // Each pass rewrites the innermost matchable call; the broadened
+    // receiver picks up the list-comprehension produced by the prior pass.
+    // Bounded at 8 iterations to prevent any accidental infinite-loop bug;
+    // realistic chains rarely exceed 3-4 calls.
+    let prev = '';
+    let next = expr;
+    let i = 0;
+    while (prev !== next && i < 8) {
+        prev = next;
+        next = next
+            .replace(FILTER_RE, (_m, arr, varName, pred) => `[${varName} for ${varName} in ${arr} if ${pred}]`)
+            .replace(MAP_RE, (_m, arr, varName, body) => `[${body} for ${varName} in ${arr}]`)
+            .replace(FIND_RE, (_m, arr, varName, pred) => `next((${varName} for ${varName} in ${arr} if ${pred}), None)`);
+        i += 1;
+    }
+    return next;
+}
+export function rewriteFastAPIExpr(expr, pathParams) {
+    let result = expr;
+    // params.X → X (function param) for path params
+    for (const param of pathParams) {
+        result = result.replace(new RegExp(`\\bparams\\.${param}\\b`, 'g'), param);
+    }
+    // Fallback: any remaining params.X → X (for query params not in pathParams)
+    result = result.replace(/\bparams\.([A-Za-z_]\w*)/g, '$1');
+    // body.X → body.X (Pydantic model — already correct)
+    // query.X → X (function param)
+    result = result.replace(/\bquery\.([A-Za-z_]\w*)/g, '$1');
+    // headers.X → request.headers.get("X")
+    result = result.replace(/\bheaders\.([A-Za-z_][\w-]*)/g, (_m, key) => `request.headers.get("${key}")`);
+    // effectName.result → effect_name (effect variables hold the result directly, snake_cased)
+    result = result.replace(/\b([A-Za-z_]\w*)\.result\b/g, (_m, name) => toSnakeCase(name));
+    // ── JS-to-Python expression lowerings ─────────────────────────────────
+    // Array methods first (so any `===` inside an arrow body is hoisted into
+    // a list-comprehension predicate that the strict-equality pass below
+    // then catches).
+    result = lowerJsArrayMethods(result);
+    // Strict equality: skip text inside quoted strings so a user message
+    // like `"use === for strict equality"` doesn't get mangled to `==`.
+    result = result.replace(STRICT_EQ_RE, (match) => {
+        if (match === '===')
+            return '==';
+        if (match === '!==')
+            return '!=';
+        return match; // quoted string — return unchanged
+    });
+    // JS literals → Python equivalents. Same string-skip trick — a message
+    // like `"undefined behavior"` must not be rewritten to `"None behavior"`.
+    result = result.replace(JS_LITERAL_RE, (match) => {
+        if (match === 'undefined' || match === 'null')
+            return 'None';
+        if (match === 'true')
+            return 'True';
+        if (match === 'false')
+            return 'False';
+        return match; // quoted string
+    });
+    return result;
+}
+export function extractExprCode(prop) {
+    if (typeof prop === 'object' && prop !== null && prop.__expr)
+        return prop.code;
+    return typeof prop === 'string' ? prop : '';
+}
+export function addRespondImports(respondNode, imports) {
+    const rp = getProps(respondNode);
+    if (rp.redirect)
+        imports.add('from fastapi.responses import RedirectResponse');
+    if (rp.text)
+        imports.add('from fastapi.responses import PlainTextResponse');
+    if (typeof rp.status === 'number' && rp.status !== 200 && rp.json)
+        imports.add('from fastapi.responses import JSONResponse');
+    if (typeof rp.status === 'number' && !rp.json && !rp.text && !rp.redirect && !rp.error)
+        imports.add('from fastapi.responses import Response');
+    if (rp.error)
+        imports.add('from fastapi import HTTPException');
+}
+//# sourceMappingURL=fastapi-response.js.map

package/dist/fastapi-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastapi-response.js","sourceRoot":"","sources":["../src/fastapi-response.ts"],"names":[],"mappings":"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"}

package/dist/fastapi-route.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Route artifact builders for the FastAPI transpiler.
+ *
+ * generateStreamRoute  — SSE streaming route
+ * generateTimerRoute   — timeout-wrapped route
+ * buildRouteArtifact   — main route artifact builder
+ */
+import type { IRNode, SourceMapEntry } from '@kernlang/core';
+import type { RouteArtifactRef, RouteCapabilities } from './fastapi-types.js';
+export declare function generateStreamRoute(_routeNode: IRNode, caps: RouteCapabilities, method: string, fastapiPath: string, pathParams: string[]): string[];
+export declare function generateTimerRoute(_routeNode: IRNode, caps: RouteCapabilities, method: string, fastapiPath: string, pathParams: string[], handlerCode: string): string[];
+export declare function buildRouteArtifact(routeNode: IRNode, routeIndex: number, sourceMap: SourceMapEntry[]): RouteArtifactRef;