@mybuildex/pkg 0.3.3 → 0.3.4

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

@@ -0,0 +1,20 @@
+export interface GcfHandlerOptions {
+    /** Instância Fastify já com os plugins registrados (server.register(app)) */
+    server: any;
+    /** Access-Control-Allow-Origin do fallback (default: "*") */
+    origin?: string;
+    /** Access-Control-Allow-Methods do fallback (default: métodos do DEFAULT_CORS) */
+    methods?: string;
+    /** Access-Control-Allow-Headers do fallback (default: "*") */
+    headers?: string;
+    /** Access-Control-Max-Age do preflight, em segundos (default: "3600") */
+    maxAge?: string;
+    /** Responder OPTIONS no wrapper, sem depender do boot (default: true).
+     *  Garante que o preflight funcione mesmo com o Fastify ainda subindo. */
+    handlePreflight?: boolean;
+    /** Status quando o boot falha (default: 503 — é transitório e re-tentável) */
+    bootFailureStatus?: number;
+    /** Mensagem quando o boot falha (nunca expõe o erro cru ao cliente) */
+    bootFailureMessage?: string;
+}
+export declare function createGcfHandler(options: GcfHandlerOptions): (req: any, res: any) => Promise<void>;

package/dist/http/gcf-handler.js

@@ -0,0 +1,81 @@
+"use strict";
+// Wrapper do handler das Cloud Functions. Nasceu do incidente de 01/09/2026
+// ("ora erro 500, ora erro de CORS" em todas as APIs).
+//
+// CADEIA REAL DA FALHA (confirmada nos logs e reproduzida em laboratório):
+// 1. As APIs faziam `const readyPromise = server.ready()` no CARREGAMENTO DO
+//    MÓDULO, sem anexar handler de rejeição no mesmo tick.
+// 2. Num cold start estrangulado (0,58 vCPU, concurrency=1, maxScale=3) o boot
+//    estoura o pluginTimeout — default do Fastify v4 é apenas 10s.
+// 3. A rejeição sem handler vira unhandledRejection. O functions-framework
+//    escuta esse evento e chama sendCrashResponse -> process.exit(16).
+// 4. A instância MORRE no meio da resposta. O browser não recebe headers nem
+//    status: reporta "erro de CORS"/ERR_FAILED — mascarando o 500 real.
+//    Daí o sintoma intermitente "ora 500, ora CORS".
+//
+// TRÊS GARANTIAS DESTE WRAPPER:
+// 1. O boot nunca gera unhandledRejection — o .catch() é anexado no mesmo tick
+//    em que a promise é criada, e o ready() só dispara na primeira request.
+// 2. Falha de boot NÃO é cacheada: a próxima request re-tenta. Sem o reset, a
+//    instância servia a MESMA promise rejeitada até morrer de velhice.
+// 3. CORS em TODA resposta, inclusive 404 e falha de boot. O @fastify/cors é
+//    registrado dentro do plugin `app`, que é encapsulado — então o handler de
+//    404 da RAIZ respondia sem Access-Control-Allow-Origin (verificado em
+//    produção e reproduzido byte a byte).
+//
+// Os headers vão no `res` CRU antes de entregar ao Fastify. `setHeader`
+// SOBRESCREVE, então o @fastify/cors não duplica o header nas rotas normais.
+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", } = options;
+    // null = ainda não bootou (ou o boot anterior falhou e será re-tentado)
+    let readyPromise = null;
+    function getReady() {
+        if (!readyPromise) {
+            // o .catch() nasce junto com a promise: nunca há um tick em que a
+            // rejeição fique sem handler (era isso que matava a instância).
+            readyPromise = server.ready().catch((e) => {
+                readyPromise = null;
+                throw e;
+            });
+        }
+        return readyPromise;
+    }
+    function applyCors(res) {
+        if (typeof res?.setHeader !== "function")
+            return;
+        res.setHeader("Access-Control-Allow-Origin", origin);
+        res.setHeader("Access-Control-Allow-Methods", methods);
+        res.setHeader("Access-Control-Allow-Headers", headers);
+        res.setHeader("Access-Control-Max-Age", maxAge);
+        // origin fixo específico varia por origem: sem Vary o cache do browser
+        // (e o CDN) serviria a resposta de uma origem para outra.
+        if (origin !== "*")
+            res.setHeader("Vary", "Origin");
+    }
+    return async function gcfHandler(req, res) {
+        applyCors(res);
+        if (handlePreflight && req?.method === "OPTIONS") {
+            res.statusCode = 204;
+            res.end();
+            return;
+        }
+        try {
+            await getReady();
+        }
+        catch (e) {
+            // Log completo para o Cloud Logging; resposta sanitizada e COM CORS,
+            // para o browser mostrar o erro real em vez de "erro de CORS".
+            console.error("[gcf] boot do Fastify falhou:", e);
+            res.statusCode = bootFailureStatus;
+            res.setHeader?.("Content-Type", "application/json; charset=utf-8");
+            res.setHeader?.("Retry-After", "1");
+            res.end(JSON.stringify({ statusCode: bootFailureStatus, message: bootFailureMessage }));
+            return;
+        }
+        server.server.emit("request", req, res);
+    };
+}
+//# sourceMappingURL=gcf-handler.js.map

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

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

package/dist/index.d.ts

@@ -20,4 +20,6 @@ export { initFirebaseAdmin, getTenantAuth, getDefaultAuth, getBucket } from "./f
 export type { FirebaseAdminOptions } from "./firebase/admin";
 export { createErrorHandler, isInternalError } from "./http/error-handler";
 export type { ErrorHandlerOptions } from "./http/error-handler";
+export { createGcfHandler } from "./http/gcf-handler";
+export type { GcfHandlerOptions } from "./http/gcf-handler";
 export { GeminiHelp, EMBED_DIM, GEMINI_MODEL, EMBED_MODEL } from "./ai/gemini";

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EMBED_MODEL = exports.GEMINI_MODEL = exports.EMBED_DIM = exports.GeminiHelp = exports.isInternalError = exports.createErrorHandler = exports.getBucket = exports.getDefaultAuth = exports.getTenantAuth = exports.initFirebaseAdmin = exports.getFirebaseStorage = exports.getFirebaseClientApp = exports.createFirebaseClientPlugin = exports.createSwaggerPlugin = exports.DEFAULT_CORS = exports.createCorsPlugin = exports.withTenantSchema = exports.createMultitenantPrismaMariaDb = exports.createMultitenantPrisma = exports.createAuthMiddleware = exports.createTenantMiddleware = exports.resolveTenantId = void 0;
+exports.EMBED_MODEL = exports.GEMINI_MODEL = exports.EMBED_DIM = exports.GeminiHelp = exports.createGcfHandler = exports.isInternalError = exports.createErrorHandler = exports.getBucket = exports.getDefaultAuth = exports.getTenantAuth = exports.initFirebaseAdmin = exports.getFirebaseStorage = exports.getFirebaseClientApp = exports.createFirebaseClientPlugin = exports.createSwaggerPlugin = exports.DEFAULT_CORS = exports.createCorsPlugin = exports.withTenantSchema = exports.createMultitenantPrismaMariaDb = exports.createMultitenantPrisma = exports.createAuthMiddleware = exports.createTenantMiddleware = exports.resolveTenantId = void 0;
 var resolve_1 = require("./tenant/resolve");
 Object.defineProperty(exports, "resolveTenantId", { enumerable: true, get: function () { return resolve_1.resolveTenantId; } });
 var middleware_1 = require("./tenant/middleware");
@@ -30,6 +30,8 @@ Object.defineProperty(exports, "getBucket", { enumerable: true, get: function ()
 var error_handler_1 = require("./http/error-handler");
 Object.defineProperty(exports, "createErrorHandler", { enumerable: true, get: function () { return error_handler_1.createErrorHandler; } });
 Object.defineProperty(exports, "isInternalError", { enumerable: true, get: function () { return error_handler_1.isInternalError; } });
+var gcf_handler_1 = require("./http/gcf-handler");
+Object.defineProperty(exports, "createGcfHandler", { enumerable: true, get: function () { return gcf_handler_1.createGcfHandler; } });
 var gemini_1 = require("./ai/gemini");
 Object.defineProperty(exports, "GeminiHelp", { enumerable: true, get: function () { return gemini_1.GeminiHelp; } });
 Object.defineProperty(exports, "EMBED_DIM", { enumerable: true, get: function () { return gemini_1.EMBED_DIM; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4CAAiD;AAAzC,0GAAA,eAAe,OAAA;AAGvB,kDAA2D;AAAnD,oHAAA,sBAAsB,OAAA;AAG9B,sCAAmD;AAA3C,4GAAA,oBAAoB,OAAA;AAG5B,oDAA6D;AAArD,sHAAA,uBAAuB,OAAA;AAC/B,4DAAwE;AAAhE,iIAAA,8BAA8B,OAAA;AAGtC,kDAAqD;AAA7C,8GAAA,gBAAgB,OAAA;AAUxB,wCAA6D;AAArD,0GAAA,gBAAgB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAGtC,2CAAqD;AAA7C,6GAAA,mBAAmB,OAAA;AAG3B,0DAA8G;AAAtG,2HAAA,0BAA0B,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAG5E,0CAA6F;AAArF,0GAAA,iBAAiB,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,kGAAA,SAAS,OAAA;AAGnE,sDAAyE;AAAjE,mHAAA,kBAAkB,OAAA;AAAE,gHAAA,eAAe,OAAA;AAG3C,sCAA6E;AAArE,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4CAAiD;AAAzC,0GAAA,eAAe,OAAA;AAGvB,kDAA2D;AAAnD,oHAAA,sBAAsB,OAAA;AAG9B,sCAAmD;AAA3C,4GAAA,oBAAoB,OAAA;AAG5B,oDAA6D;AAArD,sHAAA,uBAAuB,OAAA;AAC/B,4DAAwE;AAAhE,iIAAA,8BAA8B,OAAA;AAGtC,kDAAqD;AAA7C,8GAAA,gBAAgB,OAAA;AAUxB,wCAA6D;AAArD,0GAAA,gBAAgB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAGtC,2CAAqD;AAA7C,6GAAA,mBAAmB,OAAA;AAG3B,0DAA8G;AAAtG,2HAAA,0BAA0B,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAG5E,0CAA6F;AAArF,0GAAA,iBAAiB,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,kGAAA,SAAS,OAAA;AAGnE,sDAAyE;AAAjE,mHAAA,kBAAkB,OAAA;AAAE,gHAAA,eAAe,OAAA;AAG3C,kDAAoD;AAA5C,+GAAA,gBAAgB,OAAA;AAGxB,sCAA6E;AAArE,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mybuildex/pkg",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Infra comum das APIs MyBuilder: multitenancy Prisma (pool único), middleware de tenant e CORS",
   "license": "MIT",
   "repository": {
@@ -56,4 +56,4 @@
     "typescript": "^5.5.0",
     "vitest": "^3.0.0"
   }
-}
+}