@friggframework/core 2.0.0--canary.596.6355e72.0 → 2.0.0--canary.596.fc8739c.0

package/core/create-handler.js

@@ -80,10 +80,7 @@ const createHandler = (optionByName = {}) => {
             // If enabled (i.e. if SECRET_ARN is set in process.env) Fetch secrets from AWS Secrets Manager, and set them as environment variables.
             await secretsToEnv();
 
-            // Open the database connection up front when the handler needs it.
-            // Lazy-required so DB-free handlers (e.g. extension webhook
-            // receivers with useDatabase:false) never load the Prisma client.
-            // $connect is idempotent, so this safely reuses a warm connection.
+            // Lazy-required so DB-free handlers never load the Prisma client.
             if (shouldUseDatabase) {
                 const { connectPrisma } = require('../database/prisma');
                 await connectPrisma();

package/handlers/routers/health.js

@@ -511,6 +511,8 @@ router.get('/health/ready', async (_req, res) => {
     });
 });
 
-const handler = createAppHandler('HTTP Event: Health', router);
+// DB-free: /health/ready probes the DB itself and degrades to 503. Eager-connect
+// here would turn a DB outage into a 500, killing otherwise-healthy containers.
+const handler = createAppHandler('HTTP Event: Health', router, false);
 
 module.exports = { handler, router };

package/handlers/routers/integration-defined-routers.js

@@ -56,11 +56,8 @@ for (const IntegrationClass of integrationClasses) {
         }
     }
 
-    // Tier 3 Integration Extension routes — each binding gets a dedicated
-    // handler, namespaced under /{bindingName}, so multiple modules' extensions
-    // can declare the same relative path (e.g. two /webhooks) without colliding.
-    // Each per-binding handler carries its own shouldUseDatabase (resolved from
-    // the extension/binding `useDatabase`, default false → DB-free receiver).
+    // Each extension binding gets its own namespaced handler (/{bindingName}),
+    // so two modules' extensions can share a path like /webhooks without colliding.
     const bindingGroups = new Map();
     for (const extRoute of getExtensionRoutes(IntegrationClass)) {
         const namespacedPath = `/${extRoute.bindingName}${extRoute.path}`;
@@ -94,9 +91,19 @@ for (const IntegrationClass of integrationClasses) {
     };
 
     for (const [bindingName, group] of bindingGroups) {
+        // Wire contract: integration-builder.js (devtools) derives the identical
+        // function key for the serverless config. Keep both in sync.
         const fnKey = `${IntegrationClass.Definition.name}__${sanitizeBindingKey(
             bindingName
         )}`;
+        // Distinct binding keys can sanitize to the same fnKey — fail loud rather than overwrite.
+        if (Object.prototype.hasOwnProperty.call(handlers, fnKey)) {
+            throw new Error(
+                `Integration "${IntegrationClass.Definition.name}" extension handler conflict: ` +
+                    `binding "${bindingName}" sanitizes to "${fnKey}", which is already taken. ` +
+                    `Use binding keys that are distinct after stripping non-alphanumeric characters.`
+            );
+        }
         handlers[fnKey] = {
             handler: createAppHandler(
                 `HTTP Event: ${IntegrationClass.Definition.name} extension ${bindingName}`,

package/integrations/EXTENSIONS.md

@@ -55,6 +55,8 @@ Each extension binding is mounted under its **binding key**, on its own dedicate
 
 So the full URL is `/api/{integration-name}-integration/{bindingKey}{route.path}`. Register that URL with the upstream provider (e.g. paste it into your HubSpot app's webhook settings). Hit it and the bound method (`onHubSpotEvent`) fires on the resolved per-account integration instance.
 
+> **⚠️ Breaking:** extension routes used to mount un-namespaced (`/api/{x}-integration/webhooks`). They are now namespaced under the binding key. Any provider webhook already registered against the old path must be re-pointed at the new `/{bindingKey}` URL — and for signature schemes that sign the full URL (e.g. HubSpot v3), the old registration will also fail verification until updated.
+
 ## `useDatabase` — does the receiver open a DB connection?
 
 Each extension declares whether its route handler should open a database connection:
@@ -72,6 +74,7 @@ module.exports = {
 - **Default is `false`** — a webhook receiver that only verifies a signature and enqueues should not pay for a DB connection (faster cold start; at build time its Lambda doesn't get the Prisma layer).
 - Set `useDatabase: true` at the **extension level** if the receiver itself needs the DB. A binding may override it locally (`extensions: { x: { extension, useDatabase: true } }`), though that's rarely needed.
 - Resolution order: `binding.useDatabase ?? extension.useDatabase ?? false`.
+- Scope note: `false` is the default **for extension routes**. `createHandler` itself still defaults `shouldUseDatabase: true` for the integration's own catch-all handler and the legacy `Definition.webhooks: true` path — those connect as before. The `false` default applies only to the per-binding extension handler.
 
 If `useDatabase` is `false`, the receiver must not touch the database. Work that needs the DB (e.g. resolving `portalId → integrationId`) belongs in the queue worker that processes the dispatched event, not in the receiver.
 

package/integrations/extension.js

@@ -199,8 +199,6 @@ function getExtensionRoutes(IntegrationClass) {
             integrationName,
             binding
         );
-        // useDatabase is resolved at the binding level, falling back to the
-        // extension's declared value, then to false (DB-free by default).
         const useDatabase =
             binding.useDatabase ?? binding.extension.useDatabase ?? false;
         const routes = binding.extension.routes || [];

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@friggframework/core",
     "prettier": "@friggframework/prettier-config",
-    "version": "2.0.0--canary.596.6355e72.0",
+    "version": "2.0.0--canary.596.fc8739c.0",
     "dependencies": {
         "@aws-sdk/client-apigatewaymanagementapi": "^3.588.0",
         "@aws-sdk/client-kms": "^3.588.0",
@@ -38,9 +38,9 @@
         }
     },
     "devDependencies": {
-        "@friggframework/eslint-config": "2.0.0--canary.596.6355e72.0",
-        "@friggframework/prettier-config": "2.0.0--canary.596.6355e72.0",
-        "@friggframework/test": "2.0.0--canary.596.6355e72.0",
+        "@friggframework/eslint-config": "2.0.0--canary.596.fc8739c.0",
+        "@friggframework/prettier-config": "2.0.0--canary.596.fc8739c.0",
+        "@friggframework/test": "2.0.0--canary.596.fc8739c.0",
         "@prisma/client": "^6.17.0",
         "@types/lodash": "4.17.15",
         "@typescript-eslint/eslint-plugin": "^8.0.0",
@@ -80,5 +80,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "6355e7230ef1f29f10e5336c88d4ddd257dffe18"
+    "gitHead": "fc8739c1c49a9731b8465e0d5e864c71db20c581"
 }