@farm.js/core 0.1.0-beta.18 → 0.1.0-beta.19

package/dist/integrations.mjs

@@ -4,6 +4,7 @@ import {
   defineIntegration,
   defineIntegrationSchema,
   dispatchIntegrationRequest,
+  getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime,
   getIntegrationDocumentNavigationMatchers,
   getIntegrationProviders,
@@ -17,7 +18,7 @@ import {
   matchIntegrationRoute,
   matchRegisteredIntegrationRoute,
   resolveIntegrationPlugins
-} from "./chunk-SBLHLAE3.mjs";
+} from "./chunk-ZYDQS2TT.mjs";
 import "./chunk-QGOHVJ6J.mjs";
 import "./chunk-YTMDIHQN.mjs";
 import {
@@ -35,6 +36,7 @@ export {
   defineIntegrationAPIOperation,
   defineIntegrationSchema,
   dispatchIntegrationRequest,
+  getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime,
   getIntegrationDocumentNavigationMatchers,
   getIntegrationProviders,

package/dist/internal/build-runtime.cjs

@@ -45,6 +45,26 @@ var init_integration_api = __esm({
   }
 });
 
+// src/plugin-integration-context.ts
+function setFarmPluginIntegrationContext(plugin, integration) {
+  Object.defineProperty(plugin, FARM_PLUGIN_INTEGRATION_CONTEXT, {
+    value: integration
+  });
+}
+function getFarmPluginIntegrationContext(plugin) {
+  const value = plugin[FARM_PLUGIN_INTEGRATION_CONTEXT];
+  return value && typeof value === "object" ? value : void 0;
+}
+var FARM_PLUGIN_INTEGRATION_CONTEXT;
+var init_plugin_integration_context = __esm({
+  "src/plugin-integration-context.ts"() {
+    "use strict";
+    FARM_PLUGIN_INTEGRATION_CONTEXT = /* @__PURE__ */ Symbol.for("@farm.js/core/plugin-integration-context");
+    __name(setFarmPluginIntegrationContext, "setFarmPluginIntegrationContext");
+    __name(getFarmPluginIntegrationContext, "getFarmPluginIntegrationContext");
+  }
+});
+
 // src/request-context.ts
 function getRequestContextStore() {
   const globalState2 = globalThis;
@@ -1062,6 +1082,10 @@ function getFarmIntegrationPluginServerRuntime(plugin) {
   const value = plugin[FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME];
   return typeof value === "boolean" ? value : void 0;
 }
+function getFarmIntegrationPluginOwner(plugin) {
+  const value = plugin[FARM_INTEGRATION_PLUGIN_OWNER];
+  return value && typeof value === "object" ? value : void 0;
+}
 function defineTypedIntegrationRoute(method, path31, input) {
   return {
     path: path31,
@@ -1156,13 +1180,70 @@ function resolveIntegrationPlugins(integrations) {
     if (!integration || !isFarmIntegration(integration)) {
       continue;
     }
-    plugins.push(createIntegrationPlugin(key, integration));
-    if (integration.plugins?.length) {
-      plugins.push(...integration.plugins);
-    }
+    const owner = createIntegrationPluginOwner(key, integration, "lifecycle");
+    plugins.push(withIntegrationPluginOwner(createIntegrationPlugin(key, integration), owner));
+    plugins.push(...resolveIntegrationPluginContributions(key, integration));
   }
   return plugins;
 }
+function resolveIntegrationPluginContributions(key, integration) {
+  const contributions = integration.plugins;
+  if (!contributions) return [];
+  if (!Array.isArray(contributions)) {
+    throw new TypeError(`Integration "${key}" plugins must be an array`);
+  }
+  const names = /* @__PURE__ */ new Set();
+  return contributions.map((plugin, index) => {
+    if (!plugin || typeof plugin !== "object" || typeof plugin.name !== "string") {
+      throw new TypeError(`Integration "${key}" plugin at index ${index} is invalid`);
+    }
+    const name = plugin.name.trim();
+    if (!name) {
+      throw new TypeError(`Integration "${key}" plugin at index ${index} requires a name`);
+    }
+    if (names.has(name)) {
+      throw new Error(`Integration "${key}" contributes duplicate plugin name "${name}"`);
+    }
+    names.add(name);
+    return withIntegrationPluginOwner(
+      plugin,
+      createIntegrationPluginOwner(key, integration, "contribution"),
+      createIntegrationPluginContext(key, integration)
+    );
+  });
+}
+function createIntegrationPluginOwner(key, integration, source) {
+  return Object.freeze({
+    key,
+    category: integration.category,
+    type: integration.type,
+    source,
+    serverRuntime: integration.serverRuntime !== false
+  });
+}
+function createIntegrationPluginContext(key, integration) {
+  return Object.freeze({
+    key,
+    category: integration.category,
+    type: integration.type,
+    instance: integration.instance,
+    serverRuntime: integration.serverRuntime !== false
+  });
+}
+function withIntegrationPluginOwner(plugin, owner, integration) {
+  const descriptors = Object.getOwnPropertyDescriptors(plugin);
+  Reflect.deleteProperty(descriptors, FARM_INTEGRATION_PLUGIN_OWNER);
+  Reflect.deleteProperty(descriptors, FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME);
+  const ownedPlugin = Object.create(Object.getPrototypeOf(plugin), descriptors);
+  Object.defineProperty(ownedPlugin, FARM_INTEGRATION_PLUGIN_OWNER, { value: owner });
+  Object.defineProperty(ownedPlugin, FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME, {
+    value: owner.serverRuntime
+  });
+  if (integration) {
+    setFarmPluginIntegrationContext(ownedPlugin, integration);
+  }
+  return ownedPlugin;
+}
 function getIntegrationProviders(integrations) {
   if (!integrations) {
     return [];
@@ -2713,11 +2794,12 @@ function normalizeMatcher(matcher) {
   }
   return typeof matcher === "string" ? matcher : matcher.join(", ");
 }
-var FARM_INTEGRATION_INTERNAL_DISPATCH_CONTEXT_KEY, FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME, integrationRoute, INTEGRATION_RUNTIME_REGISTRY_KEY, INTEGRATION_REQUEST_DISPATCHER_KEY, INTEGRATION_DATA_HEADER, INTEGRATION_DATA_HEADER_MAX_LENGTH, BLOCKED_INTEGRATION_DATA_KEYS;
+var FARM_INTEGRATION_INTERNAL_DISPATCH_CONTEXT_KEY, FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME, FARM_INTEGRATION_PLUGIN_OWNER, integrationRoute, INTEGRATION_RUNTIME_REGISTRY_KEY, INTEGRATION_REQUEST_DISPATCHER_KEY, INTEGRATION_DATA_HEADER, INTEGRATION_DATA_HEADER_MAX_LENGTH, BLOCKED_INTEGRATION_DATA_KEYS;
 var init_integrations = __esm({
   "src/integrations.ts"() {
     "use strict";
     init_integration_api();
+    init_plugin_integration_context();
     init_request_context();
     init_response();
     init_server_http();
@@ -2726,7 +2808,9 @@ var init_integrations = __esm({
     FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME = /* @__PURE__ */ Symbol.for(
       "@farm.js/core/integration-plugin-server-runtime"
     );
+    FARM_INTEGRATION_PLUGIN_OWNER = /* @__PURE__ */ Symbol.for("@farm.js/core/integration-plugin-owner");
     __name(getFarmIntegrationPluginServerRuntime, "getFarmIntegrationPluginServerRuntime");
+    __name(getFarmIntegrationPluginOwner, "getFarmIntegrationPluginOwner");
     __name(defineTypedIntegrationRoute, "defineTypedIntegrationRoute");
     __name(createIntegrationRouteFactory, "createIntegrationRouteFactory");
     integrationRoute = createIntegrationRouteFactory();
@@ -2735,6 +2819,10 @@ var init_integrations = __esm({
     __name(getIntegrationRuntimeRegistry, "getIntegrationRuntimeRegistry");
     __name(isFarmIntegration, "isFarmIntegration");
     __name(resolveIntegrationPlugins, "resolveIntegrationPlugins");
+    __name(resolveIntegrationPluginContributions, "resolveIntegrationPluginContributions");
+    __name(createIntegrationPluginOwner, "createIntegrationPluginOwner");
+    __name(createIntegrationPluginContext, "createIntegrationPluginContext");
+    __name(withIntegrationPluginOwner, "withIntegrationPluginOwner");
     __name(getIntegrationProviders, "getIntegrationProviders");
     __name(getIntegrationDocumentNavigationMatchers, "getIntegrationDocumentNavigationMatchers");
     __name(getRegisteredIntegrations, "getRegisteredIntegrations");
@@ -17986,7 +18074,7 @@ var init_type_artifacts = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.1.0-beta.18";
+    version = "0.1.0-beta.19";
   }
 });
 
@@ -25963,7 +26051,15 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             const startTime2 = Date.now();
             try {
               if (pm) {
-                await pm.runHookParallel("beforeRequest", req, res);
+                await pm.runHookParallelFiltered(
+                  "beforeRequest",
+                  (plugin) => {
+                    const owner = getFarmIntegrationPluginOwner(plugin);
+                    return owner?.source !== "lifecycle" || owner.key !== matchedRoute.key;
+                  },
+                  req,
+                  res
+                );
               }
               if (res.writableEnded) {
                 const duration2 = Date.now() - startTime2;
@@ -29079,6 +29175,7 @@ var init_plugin = __esm({
     "use strict";
     init_env();
     init_request_context();
+    init_plugin_integration_context();
     init_vite();
     _FarmRuntimeShutdownError = class _FarmRuntimeShutdownError extends Error {
       constructor(message, errors) {
@@ -29145,10 +29242,14 @@ var init_plugin = __esm({
           }
         };
       }
-      createRequestHookContext(target) {
+      createPluginHookContext(plugin, context = this.context) {
+        const integration = getFarmPluginIntegrationContext(plugin);
+        return integration ? { ...context, integration } : context;
+      }
+      createRequestHookContext(target, plugin) {
         const requestContext = this.context.requestContext;
         return {
-          ...this.context,
+          ...this.createPluginHookContext(plugin),
           req: {
             set(key, value, options) {
               requestContext.set(target, key, value, options);
@@ -29191,7 +29292,7 @@ var init_plugin = __esm({
         return {
           ...this.createStateHookContext(plugin),
           request,
-          req: this.createRequestHookContext(request).req,
+          req: this.createRequestHookContext(request, plugin).req,
           kind: options.kind ?? "request",
           route: options.route,
           signal: request.signal,
@@ -29257,7 +29358,7 @@ var init_plugin = __esm({
       }
       createStateHookContext(plugin, context = this.context) {
         return {
-          ...context,
+          ...this.createPluginHookContext(plugin, context),
           state: this.pluginStates.get(plugin)
         };
       }
@@ -29385,14 +29486,14 @@ var init_plugin = __esm({
         }
         return hooks;
       }
-      getHookContext(hookName, args) {
+      getHookContext(plugin, hookName, args) {
         if (hookName === "beforeRequest" || hookName === "afterResponse" || hookName === "beforeApiHandler") {
           const target = args[0];
           if (target && typeof target === "object") {
-            return this.createRequestHookContext(target);
+            return this.createRequestHookContext(target, plugin);
           }
         }
-        return this.context;
+        return this.createPluginHookContext(plugin);
       }
       addPlugin(plugin) {
         this.plugins.push(plugin);
@@ -29441,7 +29542,7 @@ var init_plugin = __esm({
         for (const plugin of this.getSortedPlugins()) {
           if (!plugin.setup) continue;
           const state = await plugin.setup({
-            ...this.context,
+            ...this.createPluginHookContext(plugin),
             env: getResolvedEnv()
           });
           this.pluginStates.set(plugin, state);
@@ -29612,7 +29713,7 @@ var init_plugin = __esm({
         const plugins = this.getSortedPlugins();
         for (const plugin of plugins) {
           for (const hook of this.getPluginHooks(plugin, hookName)) {
-            const hookContext = this.getHookContext(hookName, args);
+            const hookContext = this.getHookContext(plugin, hookName, args);
             const result = await hook.apply(plugin, [...args, hookContext]);
             if (result !== void 0) {
               return result;
@@ -29626,7 +29727,7 @@ var init_plugin = __esm({
         for (const plugin of plugins) {
           for (const hook of this.getPluginHooks(plugin, hookName)) {
             const hookArgs = [value, ...args];
-            const hookContext = this.getHookContext(hookName, hookArgs);
+            const hookContext = this.getHookContext(plugin, hookName, hookArgs);
             const result = await hook.apply(plugin, [...hookArgs, hookContext]);
             if (result !== void 0) {
               if (hookName === "beforeApiHandler" && result !== value && value && result && typeof value === "object" && typeof result === "object") {
@@ -29639,11 +29740,15 @@ var init_plugin = __esm({
         return value;
       }
       async runHookParallel(hookName, ...args) {
+        return this.runHookParallelFiltered(hookName, () => true, ...args);
+      }
+      /** @internal Runs hooks for only the plugins selected by the runtime adapter. */
+      async runHookParallelFiltered(hookName, include, ...args) {
         if (hookName === "shutdown" && !this.runtimeShutdownHooksRunning) {
           await this.closeRuntime(args[0]?.reason);
           return false;
         }
-        const plugins = this.getSortedPlugins();
+        const plugins = this.getSortedPlugins().filter(include);
         const sequentialHooks = /* @__PURE__ */ new Set([
           "ready",
           "shutdown",
@@ -29666,7 +29771,7 @@ var init_plugin = __esm({
                   return true;
                 }
               }
-              const hookContext = this.getHookContext(hookName, args);
+              const hookContext = this.getHookContext(plugin, hookName, args);
               try {
                 await hook.apply(plugin, [...args, hookContext]);
               } catch (error) {
@@ -29688,7 +29793,7 @@ var init_plugin = __esm({
           const promises3 = [];
           for (const plugin of plugins) {
             for (const hook of this.getPluginHooks(plugin, hookName)) {
-              const hookContext = this.getHookContext(hookName, args);
+              const hookContext = this.getHookContext(plugin, hookName, args);
               promises3.push(hook.apply(plugin, [...args, hookContext]));
             }
           }
@@ -29709,6 +29814,15 @@ var init_plugin = __esm({
     __name(_PluginManager, "PluginManager");
     PluginManager = _PluginManager;
     __name(definePlugin, "definePlugin");
+    ((definePlugin2) => {
+      function forIntegration() {
+        return /* @__PURE__ */ __name(function defineBoundPlugin(plugin) {
+          return plugin;
+        }, "defineBoundPlugin");
+      }
+      definePlugin2.forIntegration = forIntegration;
+      __name(forIntegration, "forIntegration");
+    })(definePlugin || (definePlugin = {}));
   }
 });