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

package/dist/docs.mjs

@@ -9,9 +9,9 @@ import {
   isFarmDocsRequest,
   loadFarmDocsPage,
   resolveFarmDocsContentDir
-} from "./chunk-TWOCKYU7.mjs";
+} from "./chunk-5VHPEW6N.mjs";
 import "./chunk-V7RBCSDJ.mjs";
-import "./chunk-ZCTTYTRZ.mjs";
+import "./chunk-7BX7NEA7.mjs";
 import "./chunk-UVCIEUJC.mjs";
 import "./chunk-RQ633A5I.mjs";
 import "./chunk-USLFXFFH.mjs";
@@ -26,7 +26,7 @@ import "./chunk-ZVWA4ZQ3.mjs";
 import "./chunk-7FBJLMQH.mjs";
 import "./chunk-4E6VRJ6P.mjs";
 import "./chunk-GXASWWJU.mjs";
-import "./chunk-SBLHLAE3.mjs";
+import "./chunk-ZYDQS2TT.mjs";
 import "./chunk-QGOHVJ6J.mjs";
 import "./chunk-FQYDHKKU.mjs";
 import "./chunk-GQVGIUSN.mjs";

package/dist/index.cjs

@@ -875,6 +875,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;
@@ -1434,6 +1454,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, path32, input) {
   return {
     path: path32,
@@ -1582,13 +1606,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 [];
@@ -3158,11 +3239,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();
@@ -3172,7 +3254,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");
     __name(createIntegrationRoute, "createIntegrationRoute");
@@ -3185,6 +3269,10 @@ var init_integrations = __esm({
     __name(defineIntegration, "defineIntegration");
     __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(getIntegrationSchemas, "getIntegrationSchemas");
@@ -19758,7 +19846,7 @@ var init_environment_vite = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.1.0-beta.18";
+    version = "0.1.0-beta.19";
   }
 });
 
@@ -28800,7 +28888,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;
@@ -31916,6 +32012,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) {
@@ -31982,10 +32079,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);
@@ -32028,7 +32129,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,
@@ -32094,7 +32195,7 @@ var init_plugin = __esm({
       }
       createStateHookContext(plugin, context = this.context) {
         return {
-          ...context,
+          ...this.createPluginHookContext(plugin, context),
           state: this.pluginStates.get(plugin)
         };
       }
@@ -32222,14 +32323,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);
@@ -32278,7 +32379,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);
@@ -32449,7 +32550,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;
@@ -32463,7 +32564,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") {
@@ -32476,11 +32577,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",
@@ -32503,7 +32608,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) {
@@ -32525,7 +32630,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]));
             }
           }
@@ -32546,6 +32651,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 = {}));
   }
 });
 
@@ -33431,6 +33545,7 @@ __export(src_exports, {
   getFarmDeploymentMismatch: () => getFarmDeploymentMismatch,
   getFarmDocsDocumentNavigationMatchers: () => getFarmDocsDocumentNavigationMatchers,
   getFarmDocsRouteTypeEntries: () => getFarmDocsRouteTypeEntries,
+  getFarmIntegrationPluginOwner: () => getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime: () => getFarmIntegrationPluginServerRuntime,
   getFarmLayerAliases: () => getFarmLayerAliases,
   getFarmPresetRuntime: () => getFarmPresetRuntime,
@@ -46705,6 +46820,7 @@ __name(decodeCookiePart, "decodeCookiePart");
   getFarmDeploymentMismatch,
   getFarmDocsDocumentNavigationMatchers,
   getFarmDocsRouteTypeEntries,
+  getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime,
   getFarmLayerAliases,
   getFarmPresetRuntime,