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

package/dist/index.mjs

@@ -9,7 +9,7 @@ import {
 } from "./chunk-VCANOYFI.mjs";
 import {
   build
-} from "./chunk-DGJPXXVL.mjs";
+} from "./chunk-ZYHIM7O7.mjs";
 import "./chunk-4S3ORGFA.mjs";
 import "./chunk-SL6HTIOK.mjs";
 import {
@@ -30,7 +30,7 @@ import {
   isFarmDocsRequest,
   loadFarmDocsPage,
   resolveFarmDocsContentDir
-} from "./chunk-TWOCKYU7.mjs";
+} from "./chunk-5VHPEW6N.mjs";
 import "./chunk-V7RBCSDJ.mjs";
 import {
   UnsupportedRateLimitStorageError,
@@ -74,7 +74,7 @@ import {
   resolveDeployConfig,
   resolveDeployOutputPath,
   resolveMigrationsConfig
-} from "./chunk-ZCTTYTRZ.mjs";
+} from "./chunk-7BX7NEA7.mjs";
 import {
   defineConfig,
   defineFarmConfig
@@ -83,7 +83,7 @@ import {
   FarmRuntimeShutdownError,
   PluginManager,
   definePlugin
-} from "./chunk-6OKRBYDC.mjs";
+} from "./chunk-UNDUIGWC.mjs";
 import {
   env,
   getEnv,
@@ -150,7 +150,7 @@ import {
   parseRouteRenderingDirective,
   resolveRouteRenderingConfig,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-PWLQWGXD.mjs";
+} from "./chunk-JUQB43GK.mjs";
 import {
   APITypeGenerator
 } from "./chunk-LGHEOHBU.mjs";
@@ -276,6 +276,7 @@ import {
   defineIntegration,
   defineIntegrationSchema,
   dispatchIntegrationRequest,
+  getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime,
   getIntegrationDocumentNavigationMatchers,
   getIntegrationProviders,
@@ -289,7 +290,7 @@ import {
   matchIntegrationRoute,
   matchRegisteredIntegrationRoute,
   resolveIntegrationPlugins
-} from "./chunk-SBLHLAE3.mjs";
+} from "./chunk-ZYDQS2TT.mjs";
 import {
   createFarmStorage,
   createStorageClient,
@@ -402,7 +403,7 @@ import {
   getCurrentRequest
 } from "./chunk-RHIFZZUI.mjs";
 import "./chunk-LM2YNO4U.mjs";
-import "./chunk-XFYFRBX5.mjs";
+import "./chunk-MFH7BNPY.mjs";
 import {
   SPARouter,
   getRouter,
@@ -889,6 +890,7 @@ export {
   getFarmDeploymentMismatch,
   getFarmDocsDocumentNavigationMatchers,
   getFarmDocsRouteTypeEntries,
+  getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime,
   getFarmLayerAliases,
   getFarmPresetRuntime,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/provider.tsx","../src/hmr.ts","../src/openapi/scalar-component.tsx","../src/openapi/docs-route.tsx"],"sourcesContent":["import React, { createContext, useContext, type ReactNode } from \"react\";\nimport type { FarmConfig } from \"./types\";\n\ninterface FarmContextValue {\n  config: FarmConfig;\n  basePath: string;\n}\n\nconst FarmContext = createContext<FarmContextValue | null>(null);\n\ninterface FarmProviderProps {\n  children: ReactNode;\n  config: FarmConfig;\n}\n\n/**\n * Farm.js context provider for client-side components\n */\nexport function FarmProvider({ children, config }: FarmProviderProps) {\n  const value: FarmContextValue = {\n    config,\n    basePath: config.basePath || \"/\",\n  };\n\n  return <FarmContext.Provider value={value}>{children}</FarmContext.Provider>;\n}\n\n/**\n * Hook to access Farm.js configuration and utilities\n */\nexport function useFarm(): FarmContextValue {\n  const context = useContext(FarmContext);\n\n  if (!context) {\n    throw new Error(\"useFarm must be used within a FarmProvider\");\n  }\n\n  return context;\n}\n\n/**\n * Hook to get the current base path\n */\nexport function useBasePath(): string {\n  const { basePath } = useFarm();\n  return basePath;\n}\n","import type { ViteDevServer, ModuleNode } from \"vite\";\nimport { logger } from \"./utils\";\n\nexport class HMRManager {\n  private server: ViteDevServer;\n\n  constructor(server: ViteDevServer) {\n    this.server = server;\n  }\n\n  /**\n   * Send HMR update to client\n   */\n  async send(payload: any) {\n    this.server.ws.send(payload);\n  }\n\n  /**\n   * Trigger full page reload\n   */\n  async reloadPage() {\n    this.server.ws.send({\n      type: \"full-reload\",\n      path: \"*\",\n    });\n  }\n\n  /**\n   * Handle file change and trigger HMR\n   */\n  async handleFileChange(file: string) {\n    const module = await this.server.moduleGraph.getModuleByUrl(file);\n\n    if (!module) {\n      return;\n    }\n\n    // Invalidate module\n    this.server.moduleGraph.invalidateModule(module);\n\n    // Get affected modules\n    const affectedModules = this.getAffectedModules(module);\n\n    if (affectedModules.size === 0) {\n      return;\n    }\n\n    if (file.includes(\"/app/\") && (file.endsWith(\"page.tsx\") || file.endsWith(\"page.ts\"))) {\n      await this.reloadPage();\n      return;\n    }\n\n    if (file.includes(\"/app/\") && (file.endsWith(\"layout.tsx\") || file.endsWith(\"layout.ts\"))) {\n      await this.reloadPage();\n      return;\n    }\n    // Send update for other files\n    this.send({\n      type: \"update\",\n      updates: Array.from(affectedModules).map((m) => ({\n        type: m.type === \"css\" ? \"css-update\" : \"js-update\",\n        path: m.url,\n        acceptedPath: m.url,\n        timestamp: Date.now(),\n      })),\n    });\n  }\n\n  /**\n   * Get all affected modules in the dependency graph\n   */\n  private getAffectedModules(module: ModuleNode): Set<ModuleNode> {\n    const affected = new Set<ModuleNode>();\n    const seen = new Set<ModuleNode>();\n\n    const traverse = (mod: ModuleNode) => {\n      if (seen.has(mod)) return;\n      seen.add(mod);\n      affected.add(mod);\n\n      // Traverse importers\n      for (const importer of mod.importers) {\n        if (!importer.isSelfAccepting) {\n          traverse(importer);\n        }\n      }\n    };\n\n    traverse(module);\n    return affected;\n  }\n\n  /**\n   * Handle custom HMR events from client\n   */\n  onClientMessage(event: string, callback: (data: any) => void) {\n    // Vite handles this via ws.on\n  }\n}\n\n/**\n * Create HMR client code for injection\n */\nexport function createHMRClientCode(): string {\n  return `\n// Farm.js HMR Client\nif (import.meta.hot) {\n  // Accept HMR updates for this module\n  import.meta.hot.accept((newModule) => {\n    if (newModule) {\n      // Module updated, trigger re-render\n      window.location.reload();\n    }\n  });\n\n  // Listen for custom Farm.js events\n  import.meta.hot.on('farm:route-update', (data) => {\n    console.log('Route updated:', data.path);\n    window.location.reload();\n  });\n\n  // Handle CSS updates\n  import.meta.hot.on('vite:beforeUpdate', () => {\n    console.log('[Farm.js] HMR update incoming...');\n  });\n\n  import.meta.hot.on('vite:afterUpdate', () => {\n    console.log('[Farm.js] HMR update applied ✓');\n  });\n\n  // Handle errors\n  import.meta.hot.on('vite:error', (err) => {\n    console.error('[Farm.js] HMR error:', err);\n  });\n}\n`;\n}\n","import React from \"react\";\n\ninterface ScalarAPIDocumentationProps {\n  spec: any;\n  config?: {\n    theme?: \"default\" | \"purple\" | \"blue\" | \"green\" | \"red\" | \"yellow\";\n    layout?: \"modern\" | \"classic\";\n    showSidebar?: boolean;\n    hideDownloadButton?: boolean;\n    hideTryItPanel?: boolean;\n  };\n}\n\nexport function ScalarAPIDocumentation({ spec, config = {} }: ScalarAPIDocumentationProps) {\n  const [isLoaded, setIsLoaded] = React.useState(false);\n\n  React.useEffect(() => {\n    // Dynamically import Scalar components\n    const loadScalar = async () => {\n      try {\n        // Load Scalar CSS\n        const cssLink = document.createElement(\"link\");\n        cssLink.rel = \"stylesheet\";\n        cssLink.href = \"https://cdn.jsdelivr.net/npm/@scalar/api-reference@latest/dist/style.css\";\n        document.head.appendChild(cssLink);\n\n        // Load Scalar JS\n        const script = document.createElement(\"script\");\n        script.src =\n          \"https://cdn.jsdelivr.net/npm/@scalar/api-reference@latest/dist/browser/standalone.js\";\n        script.onload = () => setIsLoaded(true);\n        document.head.appendChild(script);\n      } catch (error) {\n        console.error(\"Failed to load Scalar:\", error);\n      }\n    };\n\n    loadScalar();\n  }, []);\n\n  React.useEffect(() => {\n    if (isLoaded && window.ScalarApiReference) {\n      // Initialize Scalar\n      const container = document.getElementById(\"scalar-api-reference\");\n      if (container) {\n        window.ScalarApiReference({\n          spec,\n          theme: config.theme || \"default\",\n          layout: config.layout || \"modern\",\n          showSidebar: config.showSidebar !== false,\n          hideDownloadButton: config.hideDownloadButton || false,\n          hideTryItPanel: config.hideTryItPanel || false,\n        });\n      }\n    }\n  }, [isLoaded, spec, config]);\n\n  return (\n    <div className=\"scalar-container\">\n      <div id=\"scalar-api-reference\" style={{ height: \"100vh\", width: \"100%\" }} />\n    </div>\n  );\n}\n\n// Extend window type for Scalar\ndeclare global {\n  interface Window {\n    ScalarApiReference: (config: any) => void;\n  }\n}\n","import React from \"react\";\nimport { ScalarAPIDocumentation } from \"./scalar-component\";\n\ninterface DocsRouteProps {\n  spec: any;\n  config?: any;\n}\n\nexport function DocsRoute({ spec, config }: DocsRouteProps) {\n  return (\n    <html lang=\"en\">\n      <head>\n        <meta charSet=\"utf-8\" />\n        <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n        <link rel=\"icon\" href=\"data:,\" />\n        <title>{config?.title || \"API Documentation\"}</title>\n        <style>{`\n          body {\n            margin: 0;\n            padding: 0;\n            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;\n          }\n          .scalar-container {\n            height: 100vh;\n            width: 100%;\n          }\n        `}</style>\n      </head>\n      <body>\n        <ScalarAPIDocumentation spec={spec} config={config} />\n      </body>\n    </html>\n  );\n}\n"],"mappings":"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","names":["createContext","createContext","React","jsx","React","jsx"]}
+{"version":3,"sources":["../src/provider.tsx","../src/hmr.ts","../src/openapi/scalar-component.tsx","../src/openapi/docs-route.tsx"],"sourcesContent":["import React, { createContext, useContext, type ReactNode } from \"react\";\nimport type { FarmConfig } from \"./types\";\n\ninterface FarmContextValue {\n  config: FarmConfig;\n  basePath: string;\n}\n\nconst FarmContext = createContext<FarmContextValue | null>(null);\n\ninterface FarmProviderProps {\n  children: ReactNode;\n  config: FarmConfig;\n}\n\n/**\n * Farm.js context provider for client-side components\n */\nexport function FarmProvider({ children, config }: FarmProviderProps) {\n  const value: FarmContextValue = {\n    config,\n    basePath: config.basePath || \"/\",\n  };\n\n  return <FarmContext.Provider value={value}>{children}</FarmContext.Provider>;\n}\n\n/**\n * Hook to access Farm.js configuration and utilities\n */\nexport function useFarm(): FarmContextValue {\n  const context = useContext(FarmContext);\n\n  if (!context) {\n    throw new Error(\"useFarm must be used within a FarmProvider\");\n  }\n\n  return context;\n}\n\n/**\n * Hook to get the current base path\n */\nexport function useBasePath(): string {\n  const { basePath } = useFarm();\n  return basePath;\n}\n","import type { ViteDevServer, ModuleNode } from \"vite\";\nimport { logger } from \"./utils\";\n\nexport class HMRManager {\n  private server: ViteDevServer;\n\n  constructor(server: ViteDevServer) {\n    this.server = server;\n  }\n\n  /**\n   * Send HMR update to client\n   */\n  async send(payload: any) {\n    this.server.ws.send(payload);\n  }\n\n  /**\n   * Trigger full page reload\n   */\n  async reloadPage() {\n    this.server.ws.send({\n      type: \"full-reload\",\n      path: \"*\",\n    });\n  }\n\n  /**\n   * Handle file change and trigger HMR\n   */\n  async handleFileChange(file: string) {\n    const module = await this.server.moduleGraph.getModuleByUrl(file);\n\n    if (!module) {\n      return;\n    }\n\n    // Invalidate module\n    this.server.moduleGraph.invalidateModule(module);\n\n    // Get affected modules\n    const affectedModules = this.getAffectedModules(module);\n\n    if (affectedModules.size === 0) {\n      return;\n    }\n\n    if (file.includes(\"/app/\") && (file.endsWith(\"page.tsx\") || file.endsWith(\"page.ts\"))) {\n      await this.reloadPage();\n      return;\n    }\n\n    if (file.includes(\"/app/\") && (file.endsWith(\"layout.tsx\") || file.endsWith(\"layout.ts\"))) {\n      await this.reloadPage();\n      return;\n    }\n    // Send update for other files\n    this.send({\n      type: \"update\",\n      updates: Array.from(affectedModules).map((m) => ({\n        type: m.type === \"css\" ? \"css-update\" : \"js-update\",\n        path: m.url,\n        acceptedPath: m.url,\n        timestamp: Date.now(),\n      })),\n    });\n  }\n\n  /**\n   * Get all affected modules in the dependency graph\n   */\n  private getAffectedModules(module: ModuleNode): Set<ModuleNode> {\n    const affected = new Set<ModuleNode>();\n    const seen = new Set<ModuleNode>();\n\n    const traverse = (mod: ModuleNode) => {\n      if (seen.has(mod)) return;\n      seen.add(mod);\n      affected.add(mod);\n\n      // Traverse importers\n      for (const importer of mod.importers) {\n        if (!importer.isSelfAccepting) {\n          traverse(importer);\n        }\n      }\n    };\n\n    traverse(module);\n    return affected;\n  }\n\n  /**\n   * Handle custom HMR events from client\n   */\n  onClientMessage(event: string, callback: (data: any) => void) {\n    // Vite handles this via ws.on\n  }\n}\n\n/**\n * Create HMR client code for injection\n */\nexport function createHMRClientCode(): string {\n  return `\n// Farm.js HMR Client\nif (import.meta.hot) {\n  // Accept HMR updates for this module\n  import.meta.hot.accept((newModule) => {\n    if (newModule) {\n      // Module updated, trigger re-render\n      window.location.reload();\n    }\n  });\n\n  // Listen for custom Farm.js events\n  import.meta.hot.on('farm:route-update', (data) => {\n    console.log('Route updated:', data.path);\n    window.location.reload();\n  });\n\n  // Handle CSS updates\n  import.meta.hot.on('vite:beforeUpdate', () => {\n    console.log('[Farm.js] HMR update incoming...');\n  });\n\n  import.meta.hot.on('vite:afterUpdate', () => {\n    console.log('[Farm.js] HMR update applied ✓');\n  });\n\n  // Handle errors\n  import.meta.hot.on('vite:error', (err) => {\n    console.error('[Farm.js] HMR error:', err);\n  });\n}\n`;\n}\n","import React from \"react\";\n\ninterface ScalarAPIDocumentationProps {\n  spec: any;\n  config?: {\n    theme?: \"default\" | \"purple\" | \"blue\" | \"green\" | \"red\" | \"yellow\";\n    layout?: \"modern\" | \"classic\";\n    showSidebar?: boolean;\n    hideDownloadButton?: boolean;\n    hideTryItPanel?: boolean;\n  };\n}\n\nexport function ScalarAPIDocumentation({ spec, config = {} }: ScalarAPIDocumentationProps) {\n  const [isLoaded, setIsLoaded] = React.useState(false);\n\n  React.useEffect(() => {\n    // Dynamically import Scalar components\n    const loadScalar = async () => {\n      try {\n        // Load Scalar CSS\n        const cssLink = document.createElement(\"link\");\n        cssLink.rel = \"stylesheet\";\n        cssLink.href = \"https://cdn.jsdelivr.net/npm/@scalar/api-reference@latest/dist/style.css\";\n        document.head.appendChild(cssLink);\n\n        // Load Scalar JS\n        const script = document.createElement(\"script\");\n        script.src =\n          \"https://cdn.jsdelivr.net/npm/@scalar/api-reference@latest/dist/browser/standalone.js\";\n        script.onload = () => setIsLoaded(true);\n        document.head.appendChild(script);\n      } catch (error) {\n        console.error(\"Failed to load Scalar:\", error);\n      }\n    };\n\n    loadScalar();\n  }, []);\n\n  React.useEffect(() => {\n    if (isLoaded && window.ScalarApiReference) {\n      // Initialize Scalar\n      const container = document.getElementById(\"scalar-api-reference\");\n      if (container) {\n        window.ScalarApiReference({\n          spec,\n          theme: config.theme || \"default\",\n          layout: config.layout || \"modern\",\n          showSidebar: config.showSidebar !== false,\n          hideDownloadButton: config.hideDownloadButton || false,\n          hideTryItPanel: config.hideTryItPanel || false,\n        });\n      }\n    }\n  }, [isLoaded, spec, config]);\n\n  return (\n    <div className=\"scalar-container\">\n      <div id=\"scalar-api-reference\" style={{ height: \"100vh\", width: \"100%\" }} />\n    </div>\n  );\n}\n\n// Extend window type for Scalar\ndeclare global {\n  interface Window {\n    ScalarApiReference: (config: any) => void;\n  }\n}\n","import React from \"react\";\nimport { ScalarAPIDocumentation } from \"./scalar-component\";\n\ninterface DocsRouteProps {\n  spec: any;\n  config?: any;\n}\n\nexport function DocsRoute({ spec, config }: DocsRouteProps) {\n  return (\n    <html lang=\"en\">\n      <head>\n        <meta charSet=\"utf-8\" />\n        <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n        <link rel=\"icon\" href=\"data:,\" />\n        <title>{config?.title || \"API Documentation\"}</title>\n        <style>{`\n          body {\n            margin: 0;\n            padding: 0;\n            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;\n          }\n          .scalar-container {\n            height: 100vh;\n            width: 100%;\n          }\n        `}</style>\n      </head>\n      <body>\n        <ScalarAPIDocumentation spec={spec} config={config} />\n      </body>\n    </html>\n  );\n}\n"],"mappings":"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","names":["createContext","createContext","React","jsx","React","jsx"]}

package/dist/integrations.cjs

@@ -638,6 +638,7 @@ __export(integrations_exports, {
   defineIntegrationAPIOperation: () => defineIntegrationAPIOperation,
   defineIntegrationSchema: () => defineIntegrationSchema,
   dispatchIntegrationRequest: () => dispatchIntegrationRequest,
+  getFarmIntegrationPluginOwner: () => getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime: () => getFarmIntegrationPluginServerRuntime,
   getIntegrationDocumentNavigationMatchers: () => getIntegrationDocumentNavigationMatchers,
   getIntegrationProviders: () => getIntegrationProviders,
@@ -861,6 +862,15 @@ var api = {
   }
 };
 
+// src/plugin-integration-context.ts
+var FARM_PLUGIN_INTEGRATION_CONTEXT = /* @__PURE__ */ Symbol.for("@farm.js/core/plugin-integration-context");
+function setFarmPluginIntegrationContext(plugin, integration) {
+  Object.defineProperty(plugin, FARM_PLUGIN_INTEGRATION_CONTEXT, {
+    value: integration
+  });
+}
+__name(setFarmPluginIntegrationContext, "setFarmPluginIntegrationContext");
+
 // src/request-context.ts
 var REQUEST_CONTEXT_STORE_KEY = /* @__PURE__ */ Symbol.for("farm.requestContextStore");
 function getRequestContextStore() {
@@ -1268,11 +1278,17 @@ __name(defineIntegrationSchema, "defineIntegrationSchema");
 var FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME = /* @__PURE__ */ Symbol.for(
   "@farm.js/core/integration-plugin-server-runtime"
 );
+var FARM_INTEGRATION_PLUGIN_OWNER = /* @__PURE__ */ Symbol.for("@farm.js/core/integration-plugin-owner");
 function getFarmIntegrationPluginServerRuntime(plugin) {
   const value = plugin[FARM_INTEGRATION_PLUGIN_SERVER_RUNTIME];
   return typeof value === "boolean" ? value : void 0;
 }
 __name(getFarmIntegrationPluginServerRuntime, "getFarmIntegrationPluginServerRuntime");
+function getFarmIntegrationPluginOwner(plugin) {
+  const value = plugin[FARM_INTEGRATION_PLUGIN_OWNER];
+  return value && typeof value === "object" ? value : void 0;
+}
+__name(getFarmIntegrationPluginOwner, "getFarmIntegrationPluginOwner");
 function defineTypedIntegrationRoute(method, path, input) {
   return {
     path,
@@ -1432,14 +1448,75 @@ 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;
 }
 __name(resolveIntegrationPlugins, "resolveIntegrationPlugins");
+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)
+    );
+  });
+}
+__name(resolveIntegrationPluginContributions, "resolveIntegrationPluginContributions");
+function createIntegrationPluginOwner(key, integration, source) {
+  return Object.freeze({
+    key,
+    category: integration.category,
+    type: integration.type,
+    source,
+    serverRuntime: integration.serverRuntime !== false
+  });
+}
+__name(createIntegrationPluginOwner, "createIntegrationPluginOwner");
+function createIntegrationPluginContext(key, integration) {
+  return Object.freeze({
+    key,
+    category: integration.category,
+    type: integration.type,
+    instance: integration.instance,
+    serverRuntime: integration.serverRuntime !== false
+  });
+}
+__name(createIntegrationPluginContext, "createIntegrationPluginContext");
+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;
+}
+__name(withIntegrationPluginOwner, "withIntegrationPluginOwner");
 function getIntegrationProviders(integrations) {
   if (!integrations) {
     return [];
@@ -3084,6 +3161,7 @@ __name(normalizeMatcher, "normalizeMatcher");
   defineIntegrationAPIOperation,
   defineIntegrationSchema,
   dispatchIntegrationRequest,
+  getFarmIntegrationPluginOwner,
   getFarmIntegrationPluginServerRuntime,
   getIntegrationDocumentNavigationMatchers,
   getIntegrationProviders,