@base44/functions-compiler 0.1.0 → 0.1.2

package/README.md

@@ -17,52 +17,91 @@ Two consumers share this one engine:
 Internal to Base44 — published **public** so apper's bundler service can install
 it, but it is not a supported public API: the CLI bundles it at build time so
 end users never install it, and it carries no compatibility promise to anyone
-outside this repo. It compiles functions and nothing else: shard planning, size
-splitting, artifact writing, version creation and deploy all live above it.
+outside this repo. Compilation is the whole of its job, and that now includes
+source assembly, shard planning, size measurement and splitting. Artifact
+writing, version creation, upload and deploy live above it.
 
 The package carries no credentials and reads no configuration of its own. It
 names the environment variables and headers the generated worker will use at
 runtime (`BASE44_*`, `X-Base44-*`) but holds none of their values, and the code
 it ships is the same code already compiled into every deployed user worker.
 
-## What is missing: shards, and whole-app CFW bundles
+## Shards and whole-app builds
 
-Today this package compiles **one module per call**. It does not decide which
-functions belong in which module, how large the result may be, or what to do
-when it is too large. That work is still Python in apper's
-`backend/app/cloudflare_functions/` and moves here next — it is what turns
-"compile this set of sources" into "produce the deployable Cloudflare Workers
-bundles for this app".
+This package turns an app's whole backend function set into deployable Cloudflare
+Workers: it assembles each function's sources, groups them into shards, compiles
+each shard, measures it against Cloudflare's ceilings, and halves any shard whose
+module is over one. `compileFunctionShards` is the entry point, and unlike
+`bundleApp` it refuses a partial result — a module missing a handler is a broken
+app, not a smaller success.
 
-| Missing piece | Where it lives today | What it has to do |
+Each piece came from apper, and the provenance is worth keeping:
+
+| Piece | Where it came from | Here |
 |---|---|---|
-| Source assembly | `function_bundle.py` — `cfw_bundle_input`, `collect_reachable_backend_files` | Turn a function's directory plus the shared files it reaches into the `entry` + `files` this package takes, keeping the flat single-file case and the refusal to escape into the frontend tree |
-| Fresh shard planning | `shard_planning.py` — `full_repartition`, `target_shard_count` | Group an app's functions into shards deterministically, and refuse a set that exceeds the supplied product capacity |
-| Size measurement | `cloudflare_wfp_runtime.py` — `measure_bundle_bytes`, `judge_bundle_size` | Raw UTF-8 bytes and level-6 gzip, against Cloudflare's 64 MiB uncompressed limit and our compressed cap |
-| Split on overflow | `cloudflare_wfp_runtime.py` — `_build_shard_with_split` | Halve an oversized multi-function shard deterministically and recompile; fail the build when one function alone is too big |
-| Whole-build validation | apper PR #23460 | Reject a partial result: every declared function in exactly one successful shard, or no build at all |
-
-Only the **fresh-build** slice comes across. Everything that remembers a
-previous deploy stays in apper: incremental shard reuse (it needs the previous
-deployment map), the per-app `shard_size_override` ratchet, entitlement and
-settings reads, provider upload, binding resolution and secret delivery. Policy
-numbers — shard size, shard count, the gzip cap, whether the gate is enforced —
-arrive as inputs; the package never reads them itself.
-
-Two details from the Python that must survive the port, both verified against
-the current code:
-
-- The single-shard path builds in caller order while the multi-shard path sorts
-  by name. Function order changes the emitted bytes, so both branches carry
-  over as they are — normalising them is a byte change dressed as a cleanup.
-- Capacity is judged at the *global* shard size while packing may use a smaller
-  ratcheted one, so a legal plan can hold more shards than `max_shards`. A
-  final "shard count ≤ max_shards" assertion would lock out apps that deploy
-  fine today.
-
-Also deliberately out of scope for the new lane: Deno deployment targets,
-existing-Worker reuse, incremental deploy state, and actors — though the engine
-keeps its actor support for the legacy service that still uses it.
+| Source assembly | `function_bundle.py` — `cfw_bundle_input`, `collect_reachable_backend_files` | `src/assembly.ts` |
+| Fresh shard planning | `shard_planning.py` — `full_repartition`, `target_shard_count` | `src/shards/plan.ts` |
+| Size measurement | `cloudflare_wfp_runtime.py` — `measure_bundle_bytes`, `judge_bundle_size` | `src/shards/size.ts` |
+| Split on overflow | `cloudflare_wfp_runtime.py` — `_build_shard_with_split` | `src/shards/build.ts` |
+| Whole-build validation | apper PR #23460 | `src/shards/build.ts` |
+
+Policy numbers — shard size, shard count, the compressed cap — arrive as inputs.
+The package reads no settings and no feature flags, and the two wrapper flags
+(`postResponseTelemetry`, `runtimeSecrets`) are handed to it, because both change
+the emitted bytes and only the platform knows their value for an app.
+
+Deliberately not here: Deno deployment targets, existing-Worker reuse, provider
+upload, binding resolution, secret delivery, and incremental shard reuse — every
+version is built from scratch, so nothing here remembers a previous deploy. The
+engine keeps its actor support for the legacy service that still uses it.
+
+### What a bundle says about itself
+
+The first line of a compiled shard is its own manifest:
+
+```js
+//!b44:1 {"functions":["cleanupForgottenDepartures","health","sendReminder"],"telemetry":false,"runtimeSecrets":false,"compiler":"0.1.0"}
+```
+
+`//!b44:<format>` is a fixed sentinel, so `head -1` on a script pulled from
+Cloudflare answers "what is in this?" without executing or parsing anything, and
+the payload is JSON so a tool parses it in one call. Only the app path emits it;
+the legacy single-function `bundle()` stays bannerless, which keeps that lane
+byte-comparable with the engine apper still runs.
+
+`functions` is sorted whatever order the shard was built in. `telemetry` and
+`runtimeSecrets` are there because they change the emitted bytes and a deploy has
+to pair its secrets delivery with them. `compiler` is this package's version.
+
+Nothing volatile may be added: a timestamp or build id would re-mint a version
+for unchanged code, the app id would make the same functions compile differently
+per app, and the shard's position would make two identical shards differ.
+
+### Reproducibility is a contract, not a nicety
+
+A version's identity is the hash of the **compiled artifacts**, never of the
+sources. Anything that shifts the emitted bytes therefore mints a new version of
+code that did not change, and all of these do:
+
+- the version of this package, and the depth of the `node_modules` it was built
+  against — esbuild writes each vendored chunk's relative path into the minified
+  output, so building one directory shallower changes every user Worker's bytes;
+- the order the caller hands functions over in, for a single shard: that path
+  builds in caller order, while a multi-shard plan sorts by name. Both branches
+  are as apper has them, and `shard-build.e2e.test.ts` pins the difference;
+- either wrapper flag.
+
+Two behaviours differ from apper's Python on purpose, and both are tested:
+
+- **An unparseable source.** apper reads each file on its own, so a file it
+  cannot parse contributes no edges while the rest of the set still assembles.
+  esbuild's walk is one build over the whole graph, so anything unparseable in it
+  rejects — the fallback is the flat single-file submission, and the compiler then
+  reports the error itself.
+- **Compressed size.** Node's gzip reads about 0.7% heavier than Python's on
+  identical input: 43,057 bytes against 42,765 on a real 122,324-byte module. The
+  direction is the safe one, since this lane refuses slightly earlier than the
+  service would.
 
 ## Using it
 
@@ -135,3 +174,30 @@ bun run build        # shims + tsc -> lib/ + assets; what gets published
 a sibling workspace — needs `bun run build` here first. There is deliberately
 no source-resolving export condition: the tarball ships `lib/` alone, and a
 second resolution path would mean two answers to "which code ran".
+
+## Releasing
+
+Run the **Manual Functions Compiler Publish** workflow
+(`.github/workflows/functions-compiler-publish.yml`) from the Actions tab. It
+bumps the version, syncs the `COMPILER_VERSION` literal, builds `lib/`,
+publishes to npm, and pushes a `functions-compiler-v<version>` tag plus the
+release commit.
+
+A version lives in two files — `package.json` and the literal in
+`src/version.ts` that goes into every compiled shard's banner. Bumping by hand
+means running `bun run scripts/sync-version.ts` after editing `package.json`;
+`version.test.ts` fails the build if the two drift apart. The CLI's own
+release train is a separate workflow with its own `v<version>` tags; the two
+never move together.
+
+Authentication is npm **trusted publishing** (OIDC) — no token in the repo. The
+registry keys a trusted publisher on the repo *and the workflow filename*, so
+`@base44/functions-compiler` needs its own entry on npmjs.com pointing at
+`functions-compiler-publish.yml`; the entries for `manual-publish.yml` do not
+cover it.
+
+The workflow only builds and publishes. What proves the tarball actually works —
+`scripts/verify-package.ts`, which packs, installs the tarball into a throwaway
+directory and compiles a real function there — runs in `functions-compiler.yml`
+on every push to `main`, behind the Wix embargo gateway. Publish from a commit
+that went green there.

package/lib/src/assembly.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Turn a backend function into the `{entry, files}` the compiler takes.
+ *
+ * A function may import a helper beside it or a module shared across functions
+ * (`../../shared/x.ts`). The compiler resolves relative imports by exact match
+ * inside `files`, so anything the function reaches has to be submitted with it —
+ * otherwise the import has no target and the build fails with "can't reach
+ * outside the function".
+ *
+ * Ported from apper's `backend/app/cloudflare_functions/function_bundle.py`.
+ * That walks the import graph with a tree-sitter parse, as a stand-in for what
+ * the bundler would see; here esbuild does the walk, so it is not a stand-in —
+ * the file set is what the compiler itself reaches. Verified against the Python
+ * fixtures in assembly.test.ts.
+ */
+export interface BundleInput {
+    entry: string;
+    files: Record<string, string>;
+}
+/**
+ * Every backend file reachable from `entryPath` through `./` and `../` imports,
+ * including the entry. A specifier with no target in `backendFiles` — a typo, or
+ * a frontend file the caller deliberately excluded — is left out, so it stays
+ * forbidden by the compiler rather than being resolved here. `npm:`, `jsr:`,
+ * `node:` and bare specifiers are not edges into the project and are ignored.
+ *
+ * A source the walk cannot parse yields the entry alone, so the function
+ * compiles as the flat single-file submission and the compiler reports the
+ * error itself.
+ */
+export declare function collectReachableFiles(entryPath: string, backendFiles: Record<string, string>): Promise<Record<string, string>>;
+/**
+ * The `{entry, files}` to compile for one function.
+ *
+ * A function that reaches nothing beyond its own entry keeps the flat
+ * `main.ts` submission, byte-identical to how it compiles today. One that
+ * reaches a helper or a shared module gets its real project path as the entry,
+ * so `../../shared/x.ts` resolves against the files beside it.
+ *
+ * `backendFiles` must hold the backend tree only. A frontend path left in it
+ * would resolve, and a function would silently bundle frontend code.
+ */
+export declare function cfwBundleInput(entryPath: string, entryContent: string, backendFiles: Record<string, string>): Promise<BundleInput>;

package/lib/src/assembly.js

@@ -0,0 +1,167 @@
+/**
+ * Turn a backend function into the `{entry, files}` the compiler takes.
+ *
+ * A function may import a helper beside it or a module shared across functions
+ * (`../../shared/x.ts`). The compiler resolves relative imports by exact match
+ * inside `files`, so anything the function reaches has to be submitted with it —
+ * otherwise the import has no target and the build fails with "can't reach
+ * outside the function".
+ *
+ * Ported from apper's `backend/app/cloudflare_functions/function_bundle.py`.
+ * That walks the import graph with a tree-sitter parse, as a stand-in for what
+ * the bundler would see; here esbuild does the walk, so it is not a stand-in —
+ * the file set is what the compiler itself reaches. Verified against the Python
+ * fixtures in assembly.test.ts.
+ */
+import path from "node:path";
+import { build } from "esbuild";
+const NAMESPACE = "base44-reachability";
+/** The flat shape a single-file function has always been submitted as. Keeping
+ *  it means those functions compile to the same bytes they do today. */
+const FLAT_ENTRY = "main.ts";
+function loaderFor(filePath) {
+    if (/\.(ts|mts|cts)$/.test(filePath))
+        return "ts";
+    if (filePath.endsWith(".tsx"))
+        return "tsx";
+    if (filePath.endsWith(".jsx"))
+        return "jsx";
+    if (filePath.endsWith(".json"))
+        return "json";
+    return "js";
+}
+function resolveRelative(importer, spec, files) {
+    const dir = importer.includes("/")
+        ? importer.slice(0, importer.lastIndexOf("/"))
+        : "";
+    const resolved = path.posix.normalize(path.posix.join(dir, spec));
+    return resolved in files ? resolved : null;
+}
+/** esbuild's own account of what the entry reaches: the metafile inputs, keyed
+ *  by the paths the plugin resolved. Its own function so a failure can be
+ *  handled by the caller. */
+async function walkInputs(entryPath, backendFiles) {
+    const result = await build({
+        entryPoints: [entryPath],
+        bundle: true,
+        write: false,
+        metafile: true,
+        logLevel: "silent",
+        // Only the metafile is read, never the output, so neither of these can
+        // change what the compiler emits. They decide what the walk ACCEPTS: the
+        // default iife format rejects top-level await, which a Deno function may
+        // legitimately use, and the walk would then reject a file the compiler
+        // itself compiles fine.
+        format: "esm",
+        platform: "neutral",
+        // Every path here is a project path served from memory and nothing resolves
+        // to the filesystem, so this only has to be a valid absolute path — and
+        // `path.sep` is not one on Windows, where esbuild refuses "\\".
+        absWorkingDir: process.cwd(),
+        // TypeScript drops an import whose bindings go unused, which would hide a
+        // file the function really does pull in. Keep every import as written.
+        tsconfigRaw: { compilerOptions: { verbatimModuleSyntax: true } },
+        plugins: [
+            {
+                name: "base44-reachability",
+                setup(pluginBuild) {
+                    pluginBuild.onResolve({ filter: /.*/ }, (args) => {
+                        if (args.kind === "entry-point") {
+                            return { path: entryPath, namespace: NAMESPACE };
+                        }
+                        if (args.path.startsWith("./") || args.path.startsWith("../")) {
+                            const target = resolveRelative(args.importer, args.path, backendFiles);
+                            if (target)
+                                return { path: target, namespace: NAMESPACE };
+                        }
+                        return { path: args.path, external: true };
+                    });
+                    pluginBuild.onLoad({ filter: /.*/, namespace: NAMESPACE }, (args) => ({
+                        contents: backendFiles[args.path],
+                        loader: loaderFor(args.path),
+                    }));
+                },
+            },
+        ],
+    });
+    return result.metafile.inputs;
+}
+/** Did this build fail on the user's code, rather than on how the walk was
+ *  set up? Every message esbuild raises about a source it loaded carries a
+ *  location in this plugin's namespace; a configuration fault carries no
+ *  location at all (verified against both shapes). */
+function isUserSourceFailure(error) {
+    const errors = error.errors;
+    return (Array.isArray(errors) &&
+        errors.length > 0 &&
+        errors.every((e) => e.location?.file?.startsWith(`${NAMESPACE}:`) === true));
+}
+/**
+ * Every backend file reachable from `entryPath` through `./` and `../` imports,
+ * including the entry. A specifier with no target in `backendFiles` — a typo, or
+ * a frontend file the caller deliberately excluded — is left out, so it stays
+ * forbidden by the compiler rather than being resolved here. `npm:`, `jsr:`,
+ * `node:` and bare specifiers are not edges into the project and are ignored.
+ *
+ * A source the walk cannot parse yields the entry alone, so the function
+ * compiles as the flat single-file submission and the compiler reports the
+ * error itself.
+ */
+export async function collectReachableFiles(entryPath, backendFiles) {
+    if (!(entryPath in backendFiles)) {
+        throw new Error(`entry "${entryPath}" is not among the backend files`);
+    }
+    let inputs;
+    try {
+        inputs = await walkInputs(entryPath, backendFiles);
+    }
+    catch (e) {
+        // apper's walk cannot fail this way: it reads each file on its own, so a
+        // file it cannot parse contributes no edges and the rest of the set still
+        // assembles. esbuild's walk is all-or-nothing — one unparseable source
+        // anywhere in the graph rejects here. Falling back to the entry alone keeps
+        // the flat submission a single-file function has always had, and the compile
+        // then fails with the compiler's own diagnostic, which the builder agent can
+        // act on. An exception out of assembly has nowhere to be reported at all.
+        //
+        // Only for the user's own sources, though. A fault in how this walk is
+        // configured also arrives here, and degrading it to a flat submission
+        // reports OUR bug as the user's unresolved import — which is how the format
+        // and working-directory defects above stayed invisible.
+        if (!isUserSourceFailure(e))
+            throw e;
+        return { [entryPath]: backendFiles[entryPath] };
+    }
+    const reached = {};
+    for (const input of Object.keys(inputs)) {
+        const filePath = input.startsWith(`${NAMESPACE}:`)
+            ? input.slice(NAMESPACE.length + 1)
+            : input;
+        if (filePath in backendFiles)
+            reached[filePath] = backendFiles[filePath];
+    }
+    return reached;
+}
+/**
+ * The `{entry, files}` to compile for one function.
+ *
+ * A function that reaches nothing beyond its own entry keeps the flat
+ * `main.ts` submission, byte-identical to how it compiles today. One that
+ * reaches a helper or a shared module gets its real project path as the entry,
+ * so `../../shared/x.ts` resolves against the files beside it.
+ *
+ * `backendFiles` must hold the backend tree only. A frontend path left in it
+ * would resolve, and a function would silently bundle frontend code.
+ */
+export async function cfwBundleInput(entryPath, entryContent, backendFiles) {
+    const files = await collectReachableFiles(entryPath, {
+        ...backendFiles,
+        [entryPath]: entryContent,
+    });
+    const reachedOnlyTheEntry = Object.keys(files).length === 1 && entryPath in files;
+    if (reachedOnlyTheEntry) {
+        return { entry: FLAT_ENTRY, files: { [FLAT_ENTRY]: entryContent } };
+    }
+    return { entry: entryPath, files };
+}
+//# sourceMappingURL=assembly.js.map

package/lib/src/assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly.js","sourceRoot":"","sources":["../../src/assembly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,SAAS,GAAG,qBAAqB,CAAC;AAExC;wEACwE;AACxE,MAAM,UAAU,GAAG,SAAS,CAAC;AAO7B,SAAS,SAAS,CAAC,QAAgB;IACjC,IAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAa,CAAC;IAC3D,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAc,CAAC;IACrD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAc,CAAC;IACrD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,MAAe,CAAC;IACvD,OAAO,IAAa,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CACtB,QAAgB,EAChB,IAAY,EACZ,KAA6B;IAE7B,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAChC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAClE,OAAO,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;6BAE6B;AAC7B,KAAK,UAAU,UAAU,CACvB,SAAiB,EACjB,YAAoC;IAEpC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,WAAW,EAAE,CAAC,SAAS,CAAC;QACxB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,QAAQ;QAClB,uEAAuE;QACvE,yEAAyE;QACzE,yEAAyE;QACzE,uEAAuE;QACvE,wBAAwB;QACxB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,SAAS;QACnB,4EAA4E;QAC5E,wEAAwE;QACxE,gEAAgE;QAChE,aAAa,EAAE,OAAO,CAAC,GAAG,EAAE;QAC5B,0EAA0E;QAC1E,uEAAuE;QACvE,WAAW,EAAE,EAAE,eAAe,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAE;QAChE,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,KAAK,CAAC,WAAW;oBACf,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;wBAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;4BAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;wBACnD,CAAC;wBACD,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;4BAC9D,MAAM,MAAM,GAAG,eAAe,CAC5B,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,IAAI,EACT,YAAY,CACb,CAAC;4BACF,IAAI,MAAM;gCAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;wBAC5D,CAAC;wBACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;oBAC7C,CAAC,CAAC,CAAC;oBAEH,WAAW,CAAC,MAAM,CAChB,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EACtC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBACT,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;wBACjC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;qBAC7B,CAAC,CACH,CAAC;gBACJ,CAAC;aACF;SACF;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;AAChC,CAAC;AAED;;;sDAGsD;AACtD,SAAS,mBAAmB,CAAC,KAAc;IACzC,MAAM,MAAM,GACV,KACD,CAAC,MAAM,CAAC;IACT,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACrB,MAAM,CAAC,MAAM,GAAG,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,KAAK,IAAI,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB,EACjB,YAAoC;IAEpC,IAAI,CAAC,CAAC,SAAS,IAAI,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,UAAU,SAAS,kCAAkC,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,yEAAyE;QACzE,0EAA0E;QAC1E,uEAAuE;QACvE,4EAA4E;QAC5E,6EAA6E;QAC7E,6EAA6E;QAC7E,0EAA0E;QAC1E,EAAE;QACF,uEAAuE;QACvE,sEAAsE;QACtE,4EAA4E;QAC5E,wDAAwD;QACxD,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,CAAC;QACrC,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC;YAChD,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;YACnC,CAAC,CAAC,KAAK,CAAC;QACV,IAAI,QAAQ,IAAI,YAAY;YAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,YAAoB,EACpB,YAAoC;IAEpC,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,SAAS,EAAE;QACnD,GAAG,YAAY;QACf,CAAC,SAAS,CAAC,EAAE,YAAY;KAC1B,CAAC,CAAC;IACH,MAAM,mBAAmB,GACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC;IACxD,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/lib/src/deno-bundle.js

@@ -54,6 +54,9 @@ export async function bundleToModule(prepared, nodeModulesDir = "none") {
                 // (npm/Emscripten glue), leaving loader-bound CJS locals intact.
                 define: { __dirname: '"/"', __filename: '"/index.js"' },
                 minify: true,
+                // Prepended verbatim and not minified away, which is the point: it is
+                // the one place a compiled module says what is inside it.
+                ...(prepared.banner ? { banner: { js: prepared.banner } } : {}),
                 sourcemap: false,
                 // Errors are surfaced structurally (return value / BuildFailure); keep
                 // esbuild from dumping diagnostics to the service's stderr.

package/lib/src/deno-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"deno-bundle.js","sourceRoot":"","sources":["../../src/deno-bundle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deno-bundle.js","sourceRoot":"","sources":["../../src/deno-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAqB,KAAK,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW1E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAwB,EACxB,iBAAkC,MAAM;IAExC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,yEAAyE;QACzE,0EAA0E;QAC1E,4DAA4D;QAC5D,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAC3B,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC,CACnC,CAAC;QAEF,IAAI,MAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,KAAK,CAAC;gBACnB,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC7B,aAAa,EAAE,GAAG;gBAClB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,QAAQ;gBAChB,qEAAqE;gBACrE,mEAAmE;gBACnE,uEAAuE;gBACvE,qEAAqE;gBACrE,iEAAiE;gBACjE,kEAAkE;gBAClE,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;gBAC9D,QAAQ,EAAE,CAAC,cAAc,CAAC;gBAC1B,yEAAyE;gBACzE,iEAAiE;gBACjE,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE;gBACvD,MAAM,EAAE,IAAI;gBACZ,sEAAsE;gBACtE,0DAA0D;gBAC1D,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,SAAS,EAAE,KAAK;gBAChB,uEAAuE;gBACvE,4DAA4D;gBAC5D,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE;oBACP,qEAAqE;oBACrE,kEAAkE;oBAClE,wBAAwB,EAAE;oBAC1B,eAAe,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;oBAC/C,+BAA+B,EAAE;oBACjC,2BAA2B,EAAE;oBAC7B,oBAAoB,EAAE;oBACtB,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC;iBAChE;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC1C,IAAI,MAAM;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACzC,MAAM,CAAC,CAAC;QACV,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,0EAA0E;YAC1E,wEAAwE;YACxE,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,CAAC,MAAM,UAAU,CAC/D,CAAC;QACJ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC7C,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;oEAEoE;AACpE,SAAS,kBAAkB,CAAC,CAAU,EAAE,GAAW;IACjD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,GAAG,GAAI,CAAkB,CAAC,MAAM,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,cAAc,CACrB,CAAwC,EACxC,GAAW;IAEX,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,cAAc,CAAC;IACzC,MAAM,IAAI,GAAoB,EAAE,OAAO,EAAE,CAAC;IAE1C,yEAAyE;IACzE,kDAAkD;IAClD,qEAAqE;IACrE,2EAA2E;IAC3E,wCAAwC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACnE,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,CAAC,QAMN,CAAC;IACT,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,GAAG,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,IAAI,GAAG,EAAE,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAChD,IAAI,GAAG,EAAE,UAAU;QAAE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IACtD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;2EAE2E;AAC3E,SAAS,cAAc,CAAC,IAAY,EAAE,GAAW;IAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAC7D,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

package/lib/src/index.d.ts

@@ -1,3 +1,5 @@
+export type { BundleInput } from "./assembly.js";
+export { cfwBundleInput, collectReachableFiles } from "./assembly.js";
 export type { AppErrorClassification, AppFunctionStatus, BundleAppResponse, BundleErrorStage, BundleResponse, } from "./bundler.js";
 export { bundle, bundleApp, classifyAppErrors, importsConflictingPackage, } from "./bundler.js";
 export type { AppFunctionInput, BundleAppRequest, BundleRequest, } from "./contracts.js";
@@ -7,6 +9,12 @@ export { DenoCompatError } from "./errors.js";
 export { createGuardedFetch, installFetchGuard } from "./fetch-guard.js";
 export type { Field, Level, LogSink } from "./log.js";
 export { setLogSink } from "./log.js";
+export type { CompiledShard, ShardBuildFailure, ShardBuildResult, } from "./shards/build.js";
+export { compileFunctionShards } from "./shards/build.js";
+export type { ShardPolicy } from "./shards/plan.js";
+export { assertWithinCapacity, planFreshShards, ShardCapacityError, targetShardCount, } from "./shards/plan.js";
+export type { BundleSize, SizeVerdict } from "./shards/size.js";
+export { BUNDLE_GZIP_LEVEL, judgeBundleSize, measureBundleBytes, WORKER_RAW_SIZE_CEILING_BYTES, workerGzipCapBreach, workerRawSizeBreach, } from "./shards/size.js";
 export { STATIC_EGRESS_ARTIFACT_MARKER } from "./static-egress-marker.js";
 export type { CompilerTracer } from "./tracing.js";
 export { setCompilerTracer } from "./tracing.js";

package/lib/src/index.js

@@ -1,11 +1,15 @@
 // Public surface of the production function compiler. Everything else under
 // src/ is either an internal engine module or a compile-time asset read as text
 // by the esbuild plugins.
+export { cfwBundleInput, collectReachableFiles } from "./assembly.js";
 export { bundle, bundleApp, classifyAppErrors, importsConflictingPackage, } from "./bundler.js";
 export { appFunctionSchema, bundleAppRequestSchema, bundleRequestSchema, } from "./contracts.js";
 export { DenoCompatError } from "./errors.js";
 export { createGuardedFetch, installFetchGuard } from "./fetch-guard.js";
 export { setLogSink } from "./log.js";
+export { compileFunctionShards } from "./shards/build.js";
+export { assertWithinCapacity, planFreshShards, ShardCapacityError, targetShardCount, } from "./shards/plan.js";
+export { BUNDLE_GZIP_LEVEL, judgeBundleSize, measureBundleBytes, WORKER_RAW_SIZE_CEILING_BYTES, workerGzipCapBreach, workerRawSizeBreach, } from "./shards/size.js";
 export { STATIC_EGRESS_ARTIFACT_MARKER } from "./static-egress-marker.js";
 export { setCompilerTracer } from "./tracing.js";
 //# sourceMappingURL=index.js.map

package/lib/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,0BAA0B;AAS1B,OAAO,EACL,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,0BAA0B;AAG1B,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAQtE,OAAO,EACL,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,6BAA6B,EAC7B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/lib/src/invocation-logs.d.ts

@@ -0,0 +1,6 @@
+export declare const CAPTURE_LOGS_HEADER = "X-B44-Capture-Logs";
+export declare const INVOCATION_LOGS_HEADER = "X-B44-Invocation-Logs";
+export declare const MAX_CAPTURED_LINES = 40;
+export declare const ASCII_ESCAPE = "const _b44Ascii = (s) => s.replace(/[\\u007f-\\uffff]/g, (c) => '\\\\u' + c.charCodeAt(0).toString(16).padStart(4, '0'));";
+export declare const CAPTURE_PATCH: string;
+export declare const INVOCATION_LOGS_PATCH: string;

package/lib/src/invocation-logs.js

@@ -0,0 +1,51 @@
+export const CAPTURE_LOGS_HEADER = "X-B44-Capture-Logs";
+export const INVOCATION_LOGS_HEADER = "X-B44-Invocation-Logs";
+// Budgets are in escaped bytes and stay under the 8 KB the backend accepts for
+// this header (INVOCATION_LOGS_MAX_HEADER_BYTES), with room for the function's
+// own headers.
+export const MAX_CAPTURED_LINES = 40;
+const MAX_CAPTURED_BYTES = 6144;
+const LINE_ENVELOPE_BYTES = 30;
+const RESPONSE_HEADER_BUDGET = 7168;
+const HEADER_LINE_OVERHEAD = 4;
+// workerd's headers.set throws on any code unit above 0xff, which would silently
+// cost the request its logs; escaped text also makes the byte budget exact.
+export const ASCII_ESCAPE = "const _b44Ascii = (s) => s.replace(/[\\u007f-\\uffff]/g, (c) => '\\\\u' + c.charCodeAt(0).toString(16).padStart(4, '0'));";
+export const CAPTURE_PATCH = [
+    "const _b44Capture = (c, lvl, msg) => {",
+    "  if (!c.invocationLogs) return;",
+    `  const cost = _b44Ascii(JSON.stringify(msg)).length + ${LINE_ENVELOPE_BYTES};`,
+    `  if (c.invocationLogs.length >= ${MAX_CAPTURED_LINES} || c.invocationLogsBytes + cost > ${MAX_CAPTURED_BYTES}) { c.invocationLogsDropped += 1; return; }`,
+    "  c.invocationLogsBytes += cost;",
+    "  c.invocationLogs.push({ level: lvl, message: msg });",
+    "};",
+].join("\n");
+export const INVOCATION_LOGS_PATCH = [
+    `const _b44CaptureStore = (request) => request.headers.get(${JSON.stringify(CAPTURE_LOGS_HEADER)}) === '1' ? { invocationLogs: [], invocationLogsBytes: 0, invocationLogsDropped: 0 } : {};`,
+    "const _b44AttachInvocationLogs = (res) => {",
+    "  const c = _b44Context();",
+    "  if (!c || !c.invocationLogs) return res;",
+    "  if (!(res instanceof Response) || res.status === 101 || res.webSocket) return res;",
+    `  let existingBytes = ${INVOCATION_LOGS_HEADER.length + HEADER_LINE_OVERHEAD};`,
+    `  res.headers.forEach((v, k) => { existingBytes += k.length + v.length + ${HEADER_LINE_OVERHEAD}; });`,
+    "  let payload = _b44Ascii(JSON.stringify({ lines: c.invocationLogs, dropped: c.invocationLogsDropped }));",
+    `  if (existingBytes + payload.length > ${RESPONSE_HEADER_BUDGET}) payload = JSON.stringify({ lines: [], dropped: c.invocationLogs.length + c.invocationLogsDropped });`,
+    `  if (existingBytes + payload.length > ${RESPONSE_HEADER_BUDGET}) return res;`,
+    "  let wrapped;",
+    "  try { wrapped = new Response(res.body, res); } catch (e) { return res; }",
+    `  try { wrapped.headers.set(${JSON.stringify(INVOCATION_LOGS_HEADER)}, payload); } catch (e) {}`,
+    "  return wrapped;",
+    "};",
+    // Same body as the dispatcher's user-exception answer (apps-dispatcher errors.ts:55);
+    // the dispatcher strips X-Base44-Cf-Error from user responses (run.ts:73), so this
+    // streams as a plain 500 without the dispatch_error metric. Errors the dispatcher
+    // classifies by message (errors.ts:41-45) rethrow so their 429 stands.
+    "const _b44CrashResponse = (e) => {",
+    "  const c = _b44Context();",
+    "  if (!c || !c.invocationLogs) return null;",
+    "  const m = String(e instanceof Error ? e.message : e).toLowerCase();",
+    "  if (m.includes('cpu time limit') || m.includes('too many subrequests')) return null;",
+    "  return _b44AttachInvocationLogs(new Response(JSON.stringify({ error: 'user-exception', detail: 'user worker threw an exception' }), { status: 500, headers: { 'Content-Type': 'application/json' } }));",
+    "};",
+].join("\n");
+//# sourceMappingURL=invocation-logs.js.map

package/lib/src/invocation-logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-logs.js","sourceRoot":"","sources":["../../src/invocation-logs.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AACxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAE9D,+EAA+E;AAC/E,+EAA+E;AAC/E,eAAe;AACf,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,iFAAiF;AACjF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GACvB,2HAA2H,CAAC;AAE9H,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,wCAAwC;IACxC,kCAAkC;IAClC,0DAA0D,mBAAmB,GAAG;IAChF,oCAAoC,kBAAkB,sCAAsC,kBAAkB,6CAA6C;IAC3J,kCAAkC;IAClC,wDAAwD;IACxD,IAAI;CACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,6DAA6D,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,4FAA4F;IAC5L,6CAA6C;IAC7C,4BAA4B;IAC5B,4CAA4C;IAC5C,sFAAsF;IACtF,yBAAyB,sBAAsB,CAAC,MAAM,GAAG,oBAAoB,GAAG;IAChF,4EAA4E,oBAAoB,OAAO;IACvG,2GAA2G;IAC3G,0CAA0C,sBAAsB,wGAAwG;IACxK,0CAA0C,sBAAsB,eAAe;IAC/E,gBAAgB;IAChB,4EAA4E;IAC5E,+BAA+B,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,4BAA4B;IACjG,mBAAmB;IACnB,IAAI;IACJ,sFAAsF;IACtF,mFAAmF;IACnF,kFAAkF;IAClF,uEAAuE;IACvE,oCAAoC;IACpC,4BAA4B;IAC5B,6CAA6C;IAC7C,uEAAuE;IACvE,wFAAwF;IACxF,2MAA2M;IAC3M,IAAI;CACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/lib/src/shards/build.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Compile an app's functions into the final Cloudflare Workers shards.
+ *
+ * The loop is: plan the partition, compile each shard, measure it, and halve any
+ * shard whose module is over a ceiling before anything is uploaded. Ported from
+ * `_build_shard_with_split` in apper's `cloudflare_wfp_runtime.py`.
+ *
+ * That function also splits on two exceptions, and neither is a trigger here.
+ * The bundler's 413 is its HTTP request-body cap — a property of the shard's
+ * packed SOURCE going over the wire, not of the module coming out, and there is
+ * no request to reject locally. Cloudflare's 10027 is a real Worker limit, but
+ * it is the same 64 MiB `workerRawSizeBreach` already computes from the bytes in
+ * hand, so reaching it from a rejected upload is a failsafe, not the design.
+ * Measuring is the design, and it happens here.
+ *
+ * Unlike the compiler's own `bundleApp`, this refuses a partial result. A module
+ * missing a handler is not a smaller success, it is a broken app.
+ */
+import type { AppFunctionInput } from "../contracts.js";
+import type { BundleErrorItem } from "../errors.js";
+import { type ShardPolicy } from "./plan.js";
+export interface CompiledShard {
+    /** Position in the emitted list. Not a deployment identity — the caller owns
+     *  placement, and a split makes more shards than the plan had. */
+    index: number;
+    /** Function names in this shard, in the order they were compiled. */
+    functions: string[];
+    module: string;
+    mainModule: string;
+    rawBytes: number;
+    gzipBytes: number;
+}
+export interface ShardBuildFailure {
+    /** The function this is about, when it belongs to one. */
+    function?: string;
+    message: string;
+    errors?: BundleErrorItem[];
+}
+export type ShardBuildResult = {
+    ok: true;
+    shards: CompiledShard[];
+} | {
+    ok: false;
+    failures: ShardBuildFailure[];
+};
+/**
+ * Compile every function into shards, or fail the whole build.
+ *
+ * Succeeds only when each declared function appears exactly once across the
+ * shards and every one of them compiled.
+ */
+export declare function compileFunctionShards(functions: AppFunctionInput[], policy: ShardPolicy, options?: {
+    postResponseTelemetry?: boolean;
+    runtimeSecrets?: boolean;
+}): Promise<ShardBuildResult>;