@mybuildex/pkg 0.9.0 → 0.10.0

package/README.md

@@ -51,6 +51,24 @@ createAuthMiddleware({
 createTenantMiddleware({getTenantClient, defaultClient, strictTenant: true});
 ```
 
+## 0.10.0 — bundle da API e boot antecipado
+
+Tudo opt-in: API que não usa não muda. Medido no piloto da `v3_peoples` (04/10/2026): boot do código da API de 4,8 s para 1,45 s e primeiro GET em instância fria de 4,6 s para 0,79 s.
+
+- **`mybuildex-bundle`** (comando de build) — empacota `dist/index.js` em `dist/bundle.js` com o esbuild. No Cloud Run cada `require()` custa ~3 ms e o boot lia ~1.280 arquivos; o bundle troca isso por um arquivo. O `@fastify/autoload` não funciona dentro de um bundle (ele varre a pasta de módulos em runtime), então o comando faz a mesma varredura no build e gera um plugin estático equivalente (`dist/autoload-static.js`), com as regras do autoload 5.x. Depois **confere** que as rotas do bundle são idênticas às do autoload (compara o swagger das duas entradas) e quebra o build se divergirem. `src/app.ts` não muda; dev e teste seguem no autoload de verdade.
+
+  ```jsonc
+  // package.json da API
+  "main": "dist/bundle.js",
+  "scripts": { "build": "tsc && mybuildex-bundle", "gcp-build": "npm run build" },
+  "devDependencies": { "esbuild": "^0.28.2" },
+  // opcional: libs que a API só carrega sob demanda ficam fora do bundle
+  "mybuildex": { "bundle": { "external": ["exceljs", "pdf-lib"] } }
+  ```
+
+  Ficam sempre fora do bundle (vêm do `node_modules`): `@fastify/swagger-ui`, `firebase-admin`, `@google-cloud/storage`, `redis`, `@google/genai` e o WASM do Prisma. A verificação sobe a API com banco falso (porta morta) e precisa do que ela precisa para carregar (ex.: `firebase.json`); `verifyEnv` passa env a mais, `--no-verify` pula. Não cobre `autoHooks` (o comando lança). Stack trace passa a apontar para o `bundle.js`.
+- **`createGcfHandler({server, eagerBoot: true})`** — dispara o `ready()` logo depois da carga do módulo, em vez de esperar a primeira request: a instância que sobe antes do tráfego chega pronta. As garantias do wrapper valem igual (sem `unhandledRejection`; falha de boot vira 503 + saída na request seguinte).
+
 ## 0.9.0 — cold start e tamanho do bundle
 
 **Muda a instalação** (⚠️): a CLI `prisma` saiu das `dependencies` do pacote.

package/dist/build/autoload-static.d.ts

@@ -0,0 +1,10 @@
+export interface AutoloadEntry {
+    /** Caminho absoluto do arquivo. */
+    file: string;
+    /** Prefixo de diretório que o autoload daria (undefined na raiz). */
+    prefix: string | undefined;
+}
+/** A mesma varredura do findPlugins do autoload (dirNameRoutePrefix: true, sem autoHooks). */
+export declare function findAutoloadEntries(dir: string, prefix?: string, found?: AutoloadEntry[]): AutoloadEntry[];
+/** Código-fonte (CommonJS) do plugin estático; `fromDir` é a pasta onde ele será gravado. */
+export declare function renderAutoloadStatic(entries: AutoloadEntry[], fromDir: string): string;

package/dist/build/autoload-static.js

@@ -0,0 +1,155 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findAutoloadEntries = findAutoloadEntries;
+exports.renderAutoloadStatic = renderAutoloadStatic;
+// Equivalente ESTÁTICO do @fastify/autoload, gerado em tempo de build.
+//
+// O autoload varre a pasta de módulos em RUNTIME (readdir) e dá require() em
+// cada arquivo pelo caminho. Dentro de um bundle essa pasta não é lida — os
+// módulos estão embutidos — então o autoload não acharia rota nenhuma (ou
+// acharia os arquivos soltos e carregaria tudo de novo, fora do bundle).
+//
+// Aqui a MESMA varredura roda no build (findAutoloadEntries) e vira um plugin
+// com um require() fixo por arquivo (renderAutoloadStatic), que o bundler
+// embute. As regras de "é plugin?", autoPrefix, prefixOverride, autoConfig e
+// dependências são as do autoload 5.x (loadPlugin/registerPlugin), copiadas.
+// Não cobre autoHooks: a varredura lança se encontrar um.
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+// Padrões copiados dos defaults do @fastify/autoload 5.x.
+const scriptPattern = /(?:(?:^.?|\.[^d]|[^.]d|[^.][^d])\.ts|\.js|\.cjs|\.mjs|\.cts|\.mts)$/iu;
+const indexPattern = /^index(?:\.ts|\.js|\.cjs|\.mjs|\.cts|\.mts)$/iu;
+const autoHooksPattern = /^[_.]?auto_?hooks(?:\.ts|\.js|\.cjs|\.mjs|\.cts|\.mts)$/iu;
+/** A mesma varredura do findPlugins do autoload (dirNameRoutePrefix: true, sem autoHooks). */
+function findAutoloadEntries(dir, prefix, found = []) {
+    const list = node_fs_1.default.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+    if (list.some((d) => autoHooksPattern.test(d.name))) {
+        throw new Error(`autohooks em ${dir}: o autoload estático não cobre autoHooks`);
+    }
+    const indexDirent = list.find((d) => indexPattern.test(d.name));
+    if (indexDirent) {
+        found.push({ file: node_path_1.default.join(dir, indexDirent.name), prefix });
+        if (!list.some((d) => d.isDirectory()))
+            return found;
+    }
+    if (list.some((d) => d.name === "package.json") && !indexDirent) {
+        throw new Error(`@fastify/autoload não importaria o plugin em '${dir}' (package.json sem index)`);
+    }
+    for (const dirent of list) {
+        const file = node_path_1.default.join(dir, dirent.name);
+        if (dirent.isDirectory()) {
+            findAutoloadEntries(file, (prefix ? `${prefix}/` : "/") + dirent.name, found);
+            continue;
+        }
+        if (indexDirent)
+            continue;
+        if (dirent.isFile() && scriptPattern.test(dirent.name))
+            found.push({ file, prefix });
+    }
+    return found;
+}
+/** Código-fonte (CommonJS) do plugin estático; `fromDir` é a pasta onde ele será gravado. */
+function renderAutoloadStatic(entries, fromDir) {
+    const rel = (file) => {
+        const r = node_path_1.default.relative(fromDir, file).split(node_path_1.default.sep).join("/");
+        return r.startsWith(".") ? r : `./${r}`;
+    };
+    const lines = entries.map((e) => `    {file: ${JSON.stringify(rel(e.file))}, prefix: ${JSON.stringify(e.prefix)}, load: () => require(${JSON.stringify(rel(e.file))})},`);
+    return `// GERADO pelo mybuildex-bundle (@mybuildex/pkg) — NÃO EDITAR.
+// Equivalente estático do @fastify/autoload: lista fixa de arquivos (um
+// require por arquivo, que o bundler embute) com as regras do autoload 5.x.
+"use strict";
+
+const entries = [
+${lines.join("\n")}
+];
+
+function isRouteObject(input) {
+    return !!input && Object.prototype.toString.call(input) === "[object Object]" &&
+        Object.prototype.hasOwnProperty.call(input, "method");
+}
+
+function isPluginOrModule(input) {
+    const inputType = Object.prototype.toString.call(input);
+    if (/\\[object (?:AsyncFunction|Function|Module)\\]/u.test(inputType)) return true;
+    if (Object.prototype.hasOwnProperty.call(input, "default")) return isPluginOrModule(input.default);
+    return isRouteObject(input);
+}
+
+function wrapRoutes(content) {
+    if (isRouteObject(content)) {
+        return async function (fastify) {
+            fastify.route(content);
+        };
+    }
+    return content;
+}
+
+function loadPlugin(entry, overrideConfig) {
+    const content = entry.load();
+    if (isPluginOrModule(content) === false) return undefined;
+
+    const plugin = wrapRoutes(content.default || content);
+    const pluginConfig = (content.default && content.default.autoConfig) || content.autoConfig || {};
+    const pluginOptions = Object.assign({}, pluginConfig, overrideConfig);
+    const pluginMeta = plugin[Symbol.for("plugin-meta")] || {};
+
+    if (plugin.autoload === false || content.autoload === false) return undefined;
+    if (plugin.autoConfig !== undefined) plugin.autoConfig = undefined;
+
+    pluginOptions.prefix = (pluginOptions.prefix && pluginOptions.prefix.endsWith("/")) ? pluginOptions.prefix.slice(0, -1) : pluginOptions.prefix;
+    const prefixOverride = plugin.prefixOverride !== undefined ? plugin.prefixOverride : content.prefixOverride !== undefined ? content.prefixOverride : undefined;
+    const prefix = (plugin.autoPrefix !== undefined ? plugin.autoPrefix : content.autoPrefix !== undefined ? content.autoPrefix : undefined) || entry.prefix;
+    if (prefixOverride !== undefined) {
+        pluginOptions.prefix = prefixOverride;
+    } else if (prefix) {
+        pluginOptions.prefix = (pluginOptions.prefix || "") + prefix.replace(/\\/+/gu, "/");
+    }
+
+    return {
+        plugin,
+        filename: entry.file,
+        name: pluginMeta.name || entry.file,
+        dependencies: pluginMeta.dependencies,
+        options: pluginOptions,
+        registered: false,
+    };
+}
+
+function registerPlugin(fastify, meta, allPlugins, parentPlugins = {}) {
+    const {plugin, name, options, dependencies = []} = meta;
+    if (parentPlugins[name]) throw new Error("Cyclic dependency");
+    if (meta.registered) return;
+    parentPlugins[name] = true;
+    for (const dependency of dependencies) {
+        if (allPlugins[dependency]) registerPlugin(fastify, allPlugins[dependency], allPlugins, {...parentPlugins});
+    }
+    fastify.register(plugin, options);
+    meta.registered = true;
+}
+
+const autoloadStatic = async function autoloadStatic(fastify, options) {
+    const pluginsMeta = {};
+    for (const entry of entries) {
+        const meta = loadPlugin(entry, options && options.options);
+        if (meta) pluginsMeta[meta.name] = meta;
+    }
+    const metas = Object.values(pluginsMeta);
+    for (const entry of entries) {
+        const meta = metas.find((m) => m.filename === entry.file);
+        if (meta) registerPlugin(fastify, meta, pluginsMeta);
+    }
+};
+
+// não cria contexto novo, igual ao autoload (e ao fastify-plugin)
+autoloadStatic[Symbol.for("skip-override")] = true;
+
+module.exports = autoloadStatic;
+module.exports.fastifyAutoload = autoloadStatic;
+module.exports.default = autoloadStatic;
+`;
+}
+//# sourceMappingURL=autoload-static.js.map

package/dist/build/autoload-static.js.map

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

package/dist/build/bundle.d.ts

@@ -0,0 +1,28 @@
+/** Pacotes que ficam FORA do bundle (continuam vindo do node_modules em runtime). */
+export declare const DEFAULT_BUNDLE_EXTERNAL: readonly string[];
+export interface BundleOptions {
+    /** Raiz da API (default: process.cwd()). */
+    root?: string;
+    /** Pasta do compilado, relativa à raiz (default: "dist"). */
+    distDir?: string;
+    /** Entrada, relativa a distDir (default: "index.js"). */
+    entry?: string;
+    /** Saída, relativa a distDir (default: "bundle.js"). */
+    outfile?: string;
+    /** Pasta que o @fastify/autoload varre, relativa a distDir (default: "modules"). */
+    modulesDir?: string;
+    /** Pacotes a mais fora do bundle — tipicamente os que a API só carrega sob
+     *  demanda (`await import("exceljs")`). Somam aos DEFAULT_BUNDLE_EXTERNAL. */
+    external?: string[];
+    /** `target` do esbuild (default: "node22"). */
+    target?: string;
+    /** Log (default: console.log). */
+    log?: (message: string) => void;
+}
+export interface BundleResult {
+    outfile: string;
+    bytes: number;
+    inputs: number;
+    autoloadEntries: number;
+}
+export declare function bundleApi(options?: BundleOptions): Promise<BundleResult>;

package/dist/build/bundle.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BUNDLE_EXTERNAL = void 0;
+exports.bundleApi = bundleApi;
+// Empacota a API num arquivo só para o cold start.
+//
+// POR QUÊ: no Cloud Run cada require() custa ~3 ms (medido na v3_peoples em
+// 04/10/2026: 79% do boot era require de ~1.280 arquivos; com o bundle o boot
+// caiu de 4,8 s para 1,45 s). Um arquivo só troca mais de mil leituras por uma.
+//
+// O @fastify/autoload não funciona dentro de um bundle; aqui ele é trocado
+// (alias) pelo equivalente estático gerado em ./autoload-static. O código da
+// API não muda: dev e teste seguem no autoload de verdade.
+//
+// Só ferramenta de BUILD: nada daqui é exportado pelo index do pacote, e o
+// esbuild é dependência de desenvolvimento da API (peer opcional daqui).
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const autoload_static_1 = require("./autoload-static");
+/** Pacotes que ficam FORA do bundle (continuam vindo do node_modules em runtime). */
+exports.DEFAULT_BUNDLE_EXTERNAL = [
+    // serve arquivos estáticos da própria pasta (path.join(__dirname, "static"))
+    "@fastify/swagger-ui",
+    // carrega os serviços por require() sob demanda; no boot são poucos arquivos
+    "firebase-admin",
+    // só carregam quando usados: dentro do bundle só aumentariam o arquivo que
+    // o Node lê em todo cold start
+    "@google-cloud/storage",
+    "redis",
+    "@google/genai",
+    // WASM do query compiler do Prisma (MBs em base64): o client gerado só o
+    // importa na primeira query
+    "@prisma/client/runtime/*.wasm-base64.js",
+];
+function loadEsbuild(root) {
+    try {
+        /* eslint-disable @typescript-eslint/no-var-requires */
+        return require(require.resolve("esbuild", { paths: [root, __dirname] }));
+    }
+    catch {
+        throw new Error("mybuildex-bundle precisa do esbuild na API: npm i -D esbuild");
+    }
+}
+async function bundleApi(options = {}) {
+    const root = node_path_1.default.resolve(options.root ?? process.cwd());
+    const dist = node_path_1.default.join(root, options.distDir ?? "dist");
+    const entry = node_path_1.default.join(dist, options.entry ?? "index.js");
+    const outfile = node_path_1.default.join(dist, options.outfile ?? "bundle.js");
+    const modulesDir = node_path_1.default.join(dist, options.modulesDir ?? "modules");
+    const shim = node_path_1.default.join(dist, "autoload-static.js");
+    const log = options.log ?? ((message) => console.log(message));
+    if (!node_fs_1.default.existsSync(entry))
+        throw new Error(`${node_path_1.default.relative(root, entry)} não existe: rode o tsc antes`);
+    const alias = {};
+    let autoloadEntries = 0;
+    if (node_fs_1.default.existsSync(modulesDir)) {
+        const entries = (0, autoload_static_1.findAutoloadEntries)(modulesDir);
+        node_fs_1.default.writeFileSync(shim, (0, autoload_static_1.renderAutoloadStatic)(entries, dist));
+        alias["@fastify/autoload"] = shim;
+        autoloadEntries = entries.length;
+    }
+    const esbuild = loadEsbuild(root);
+    const result = await esbuild.build({
+        entryPoints: [entry],
+        outfile,
+        bundle: true,
+        platform: "node",
+        target: options.target ?? "node22",
+        format: "cjs",
+        external: [...exports.DEFAULT_BUNDLE_EXTERNAL, ...(options.external ?? [])],
+        alias,
+        legalComments: "none",
+        logLevel: "warning",
+        metafile: true,
+    });
+    const bytes = node_fs_1.default.statSync(outfile).size;
+    const inputs = Object.keys(result.metafile.inputs).length;
+    log(`bundle: ${node_path_1.default.relative(root, outfile)} ${(bytes / 1e6).toFixed(1)} MB (${inputs} arquivos embutidos, ${autoloadEntries} arquivos de módulo no autoload estático)`);
+    return { outfile, bytes, inputs, autoloadEntries };
+}
+//# sourceMappingURL=bundle.js.map

package/dist/build/bundle.js.map

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

package/dist/build/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/build/cli.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// mybuildex-bundle — empacota a API (dist/index.js -> dist/bundle.js) e confere
+// que as rotas do bundle são idênticas às do @fastify/autoload.
+//
+// Uso na API (package.json):
+//   "main": "dist/bundle.js",
+//   "scripts": { "build": "tsc && mybuildex-bundle" }
+//
+// Configuração opcional, no package.json da API:
+//   "mybuildex": { "bundle": {
+//       "external": ["exceljs", "pdf-lib"],      // libs que a API só carrega sob demanda
+//       "verifyEnv": {"MINHA_ENV": "x"},         // env a mais para a API carregar na verificação
+//       "swaggerPath": "/documentation/json",
+//       "entry": "index.js", "outfile": "bundle.js", "modulesDir": "modules", "distDir": "dist"
+//   } }
+//
+// Flags: --no-verify (só empacota). MYBUILDEX_BUNDLE_VERIFY=0 faz o mesmo.
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const bundle_1 = require("./bundle");
+const verify_bundle_1 = require("./verify-bundle");
+async function main() {
+    const root = process.cwd();
+    const pkgFile = node_path_1.default.join(root, "package.json");
+    const pkg = node_fs_1.default.existsSync(pkgFile) ? JSON.parse(node_fs_1.default.readFileSync(pkgFile, "utf8")) : {};
+    const config = pkg?.mybuildex?.bundle ?? {};
+    const skipVerify = process.argv.includes("--no-verify") || process.env.MYBUILDEX_BUNDLE_VERIFY === "0";
+    await (0, bundle_1.bundleApi)({
+        root,
+        distDir: config.distDir,
+        entry: config.entry,
+        outfile: config.outfile,
+        modulesDir: config.modulesDir,
+        external: config.external,
+        target: config.target,
+    });
+    if (skipVerify) {
+        console.log("verify-bundle: pulado (--no-verify)");
+        return;
+    }
+    const { routes } = (0, verify_bundle_1.verifyBundle)({
+        root,
+        distDir: config.distDir,
+        entry: config.entry,
+        outfile: config.outfile,
+        swaggerPath: config.swaggerPath,
+        env: config.verifyEnv,
+    });
+    console.log(`verify-bundle: ok — ${routes} rotas idênticas no autoload e no bundle`);
+}
+main().catch((error) => {
+    console.error(error?.message ?? error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/build/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/build/cli.ts"],"names":[],"mappings":";;;;;;AACA,gFAAgF;AAChF,gEAAgE;AAChE,EAAE;AACF,6BAA6B;AAC7B,8BAA8B;AAC9B,sDAAsD;AACtD,EAAE;AACF,iDAAiD;AACjD,+BAA+B;AAC/B,0FAA0F;AAC1F,kGAAkG;AAClG,8CAA8C;AAC9C,gGAAgG;AAChG,QAAQ;AACR,EAAE;AACF,2EAA2E;AAC3E,sDAAyB;AACzB,0DAA6B;AAC7B,qCAAmC;AACnC,mDAA6C;AAE7C,KAAK,UAAU,IAAI;IACf,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,iBAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,MAAM,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,CAAC;IAEvG,MAAM,IAAA,kBAAS,EAAC;QACZ,IAAI;QACJ,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;KACxB,CAAC,CAAC;IAEH,IAAI,UAAU,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO;IACX,CAAC;IACD,MAAM,EAAC,MAAM,EAAC,GAAG,IAAA,4BAAY,EAAC;QAC1B,IAAI;QACJ,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG,EAAE,MAAM,CAAC,SAAS;KACxB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,0CAA0C,CAAC,CAAC;AACzF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/build/verify-bundle.d.ts

@@ -0,0 +1,20 @@
+export interface VerifyBundleOptions {
+    /** Raiz da API (default: process.cwd()). */
+    root?: string;
+    /** Pasta do compilado, relativa à raiz (default: "dist"). */
+    distDir?: string;
+    /** Entrada original, relativa a distDir (default: "index.js"). */
+    entry?: string;
+    /** Bundle, relativo a distDir (default: "bundle.js"). */
+    outfile?: string;
+    /** Caminho do JSON do swagger (default: "/documentation/json"). */
+    swaggerPath?: string;
+    /** Variáveis de ambiente a mais para a API carregar na verificação. */
+    env?: Record<string, string>;
+    /** Tempo máximo por entrada, ms (default: 120000). */
+    timeoutMs?: number;
+}
+export interface VerifyBundleResult {
+    routes: number;
+}
+export declare function verifyBundle(options?: VerifyBundleOptions): VerifyBundleResult;

package/dist/build/verify-bundle.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyBundle = verifyBundle;
+// Confere que o bundle (autoload estático) expõe EXATAMENTE as mesmas rotas
+// que a entrada original com o @fastify/autoload de verdade.
+//
+// Sobe cada entrada num processo próprio, pede o JSON do swagger (ele lista
+// toda rota registrada, com método, caminho e schema) e compara. Também
+// garante que o bundle não leu arquivo solto do dist/ — se leu, o autoload
+// estático não está valendo. Qualquer diferença lança: um bundle com rota
+// faltando não pode chegar no deploy.
+//
+// Não toca em banco: DATABASE_URL aponta para uma porta morta e só o swagger
+// é chamado. Precisa do que a API precisa para CARREGAR (ex.: firebase.json).
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+// Roda dentro do processo filho: carrega a entrada e devolve o swagger.
+const WORKER = `
+const http = require("node:http");
+const path = require("node:path");
+const entry = path.resolve(process.argv[1]);
+const swaggerPath = process.argv[2];
+const silent = () => {};
+console.log = silent; console.warn = silent; console.error = silent;
+process.on("unhandledRejection", silent);
+const mod = require(entry);
+const handler = typeof mod === "function" ? mod : (mod.default || Object.values(mod).find((v) => typeof v === "function"));
+const server = http.createServer((req, res) => handler(req, res));
+server.listen(0, "127.0.0.1", () => {
+    http.get({host: "127.0.0.1", port: server.address().port, path: swaggerPath}, (res) => {
+        let body = "";
+        res.on("data", (c) => body += c);
+        res.on("end", () => {
+            const loose = Object.keys(require.cache).filter((f) => f.startsWith(path.dirname(entry) + path.sep) && f !== entry);
+            // sai só depois de o pipe aceitar tudo: exit() direto truncaria o JSON
+            process.stdout.write(JSON.stringify({status: res.statusCode, body, loose: loose.length}), () => process.exit(0));
+        });
+    }).on("error", (e) => { process.stderr.write(String(e)); process.exit(1); });
+});
+`;
+// JSON com as chaves ordenadas: a ORDEM das rotas no swagger não é estável
+// nem entre duas execuções do próprio autoload (ele varre as pastas em
+// paralelo), então só o conteúdo é comparado.
+function canonical(value) {
+    if (Array.isArray(value))
+        return value.map(canonical);
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.keys(value).sort().map((key) => [key, canonical(value[key])]));
+    }
+    return value;
+}
+function operations(doc) {
+    const list = [];
+    for (const [route, methods] of Object.entries(doc?.paths ?? {})) {
+        for (const method of Object.keys(methods))
+            list.push(`${method.toUpperCase()} ${route}`);
+    }
+    return list.sort();
+}
+function verifyBundle(options = {}) {
+    const root = node_path_1.default.resolve(options.root ?? process.cwd());
+    const dist = node_path_1.default.join(root, options.distDir ?? "dist");
+    const swaggerPath = options.swaggerPath ?? "/documentation/json";
+    const swaggerOf = (file) => {
+        const label = node_path_1.default.relative(root, file);
+        const result = (0, node_child_process_1.spawnSync)(process.execPath, ["-e", WORKER, file, swaggerPath], {
+            cwd: root,
+            encoding: "utf8",
+            timeout: options.timeoutMs ?? 120000,
+            maxBuffer: 64 * 1024 * 1024,
+            env: {
+                ...process.env,
+                DATABASE_URL: "mysql://verify:verify@127.0.0.1:1/verify_school_1?connection_limit=1",
+                HTTP: "https",
+                DOMAIN: "verify.local/api",
+                PROJECTID: process.env.PROJECTID || "verify",
+                APIKEY: process.env.APIKEY || "verify",
+                STORAGEBUCKET: process.env.STORAGEBUCKET || "verify.appspot.com",
+                REDIS: "",
+                ...(options.env ?? {}),
+            },
+        });
+        if (result.status !== 0 || !result.stdout) {
+            throw new Error(`verify-bundle: ${label} não subiu (status ${result.status}): ${(result.stderr || "").slice(0, 2000)}`);
+        }
+        const out = JSON.parse(result.stdout);
+        if (out.status !== 200)
+            throw new Error(`verify-bundle: ${label} respondeu ${out.status} em ${swaggerPath}`);
+        return { doc: JSON.parse(out.body), loose: out.loose };
+    };
+    const original = swaggerOf(node_path_1.default.join(dist, options.entry ?? "index.js"));
+    const bundle = swaggerOf(node_path_1.default.join(dist, options.outfile ?? "bundle.js"));
+    const a = operations(original.doc);
+    const b = operations(bundle.doc);
+    const missing = a.filter((op) => !b.includes(op));
+    const extra = b.filter((op) => !a.includes(op));
+    const problems = [];
+    if (a.length === 0)
+        problems.push("a entrada original não registrou rota nenhuma (o build está quebrado antes do bundle)");
+    if (missing.length)
+        problems.push(`rotas que o autoload registra e o bundle NÃO: ${missing.slice(0, 20).join(", ")}`);
+    if (extra.length)
+        problems.push(`rotas só no bundle: ${extra.slice(0, 20).join(", ")}`);
+    if (!missing.length && !extra.length && JSON.stringify(canonical(original.doc)) !== JSON.stringify(canonical(bundle.doc))) {
+        problems.push("mesmas rotas, mas o swagger (schemas/tags) difere entre o autoload e o bundle");
+    }
+    if (bundle.loose > 0)
+        problems.push(`o bundle carregou ${bundle.loose} arquivo(s) soltos de ${options.distDir ?? "dist"}/ — o autoload estático não está valendo`);
+    if (problems.length)
+        throw new Error("verify-bundle: FALHOU\n - " + problems.join("\n - "));
+    return { routes: a.length };
+}
+//# sourceMappingURL=verify-bundle.js.map

package/dist/build/verify-bundle.js.map

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

package/dist/http/gcf-handler.d.ts

@@ -23,5 +23,14 @@ export interface GcfHandlerOptions {
     exitDelayMs?: number;
     /** Função de saída (default: process.exit) — injetável para teste */
     exit?: (code: number) => void;
+    /** Boot antecipado (default: false). Dispara o ready() logo depois da
+     *  carga do módulo, em vez de esperar a primeira request: a instância que
+     *  sobe antes do tráfego (rollout, autoscaling) chega pronta, e o boot roda
+     *  na janela de CPU extra do startup do Cloud Run. Medido na v3_peoples em
+     *  04/10/2026: eram 2,6 s de boot DENTRO da primeira request. As três
+     *  garantias do wrapper valem igual — a rejeição do boot antecipado já
+     *  nasce com handler, e uma falha continua virando 503 + saída na request
+     *  seguinte. */
+    eagerBoot?: boolean;
 }
 export declare function createGcfHandler(options: GcfHandlerOptions): (req: any, res: any) => Promise<void>;

package/dist/http/gcf-handler.js

@@ -35,7 +35,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createGcfHandler = createGcfHandler;
 const plugin_1 = require("../cors/plugin");
 function createGcfHandler(options) {
-    const { server, origin = "*", methods = plugin_1.DEFAULT_CORS.methods.join(","), headers = "*", maxAge = "3600", handlePreflight = true, bootFailureStatus = 503, bootFailureMessage = "Serviço iniciando, tente novamente em instantes", exitOnBootFailure = true, exitDelayMs = 2000, exit = (code) => process.exit(code), } = options;
+    const { server, origin = "*", methods = plugin_1.DEFAULT_CORS.methods.join(","), headers = "*", maxAge = "3600", handlePreflight = true, bootFailureStatus = 503, bootFailureMessage = "Serviço iniciando, tente novamente em instantes", exitOnBootFailure = true, exitDelayMs = 2000, exit = (code) => process.exit(code), eagerBoot = false, } = options;
     // null = ainda não bootou (ou o boot anterior falhou e será re-tentado)
     let readyPromise = null;
     function getReady() {
@@ -49,6 +49,12 @@ function createGcfHandler(options) {
         }
         return readyPromise;
     }
+    // nextTick: só depois que o módulo da API terminou de carregar — registros
+    // feitos DEPOIS do createGcfHandler (plugins, content type parsers) ainda
+    // entram. O catch vazio é o que impede o unhandledRejection aqui: sem
+    // request esperando, ninguém mais trataria a falha.
+    if (eagerBoot)
+        process.nextTick(() => getReady().catch(() => { }));
     let exitScheduled = false;
     // Sai só DEPOIS que a resposta foi escrita no socket: process.exit() no
     // mesmo tick cortaria o 503 e o browser voltaria a ver "erro de CORS".

package/dist/http/gcf-handler.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mybuildex/pkg",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Infra comum das APIs MyBuilder: multitenancy Prisma (pool único), middleware de tenant e CORS",
   "license": "MIT",
   "repository": {
@@ -21,6 +21,9 @@
   ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "mybuildex-bundle": "dist/build/cli.js"
+  },
   "files": [
     "dist"
   ],
@@ -45,17 +48,23 @@
     "redis": "^5.12.1"
   },
   "peerDependencies": {
+    "esbuild": ">=0.20",
     "fastify": ">=4"
   },
   "peerDependenciesMeta": {
+    "esbuild": {
+      "optional": true
+    },
     "fastify": {
       "optional": true
     }
   },
   "devDependencies": {
+    "@fastify/autoload": "^5.0.0",
     "@google-cloud/functions-framework": "^3.5.1",
     "@types/express": "^4.17.25",
     "@types/node": "^22.0.0",
+    "esbuild": "^0.28.2",
     "express": "^4.22.2",
     "fastify": "^4.26.2",
     "typescript": "^5.5.0",