every-plugin 0.5.0 → 0.5.1

package/dist/runtime/errors.mjs

@@ -0,0 +1,41 @@
+import { Data } from "effect";
+import { ORPCError } from "@orpc/contract";
+
+//#region src/runtime/errors.ts
+var PluginRuntimeError = class extends Data.TaggedError("PluginRuntimeError") {};
+var ModuleFederationError = class extends Data.TaggedError("ModuleFederationError") {};
+var ValidationError = class extends Data.TaggedError("ValidationError") {};
+const isRetryableORPCCode = (code) => {
+	switch (code) {
+		case "TOO_MANY_REQUESTS":
+		case "SERVICE_UNAVAILABLE":
+		case "BAD_GATEWAY":
+		case "GATEWAY_TIMEOUT":
+		case "TIMEOUT": return true;
+		default: return false;
+	}
+};
+const wrapORPCError = (orpcError, pluginId, procedureName, operation) => {
+	return new PluginRuntimeError({
+		pluginId,
+		operation,
+		procedureName,
+		retryable: isRetryableORPCCode(orpcError.code),
+		cause: orpcError
+	});
+};
+const toPluginRuntimeError = (error, pluginId, procedureName, operation, defaultRetryable = false) => {
+	if (error instanceof ORPCError) return wrapORPCError(error, pluginId, procedureName, operation);
+	if (error instanceof PluginRuntimeError) return error;
+	return new PluginRuntimeError({
+		pluginId,
+		operation,
+		procedureName,
+		retryable: defaultRetryable,
+		cause: error instanceof Error ? error : new Error(String(error))
+	});
+};
+
+//#endregion
+export { ModuleFederationError, PluginRuntimeError, ValidationError, toPluginRuntimeError };
+//# sourceMappingURL=errors.mjs.map

package/dist/runtime/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/runtime/errors.ts"],"sourcesContent":["import { ORPCError } from \"@orpc/contract\";\nimport { Data } from \"effect\";\nimport type { z } from \"zod\";\n\nexport class PluginRuntimeError extends Data.TaggedError(\"PluginRuntimeError\")<{\n\treadonly pluginId?: string;\n\treadonly operation?: string;\n\treadonly procedureName?: string;\n\treadonly cause?: Error;\n\treadonly retryable: boolean;\n}> { }\n\nexport class ModuleFederationError extends Data.TaggedError(\n\t\"ModuleFederationError\",\n)<{\n\treadonly pluginId: string;\n\treadonly remoteUrl: string;\n\treadonly cause?: Error;\n}> { }\n\nexport class ValidationError extends Data.TaggedError(\"ValidationError\")<{\n\treadonly pluginId: string;\n\treadonly stage: \"config\" | \"input\" | \"output\" | \"state\";\n\treadonly zodError: z.ZodError;\n}> { }\n\n// Helper to determine if an oRPC error code is retryable\nexport const isRetryableORPCCode = (code: string): boolean => {\n\tswitch (code) {\n\t\tcase 'TOO_MANY_REQUESTS':\n\t\tcase 'SERVICE_UNAVAILABLE':\n\t\tcase 'BAD_GATEWAY':\n\t\tcase 'GATEWAY_TIMEOUT':\n\t\tcase 'TIMEOUT':\n\t\t\treturn true;\n\t\tdefault:\n\t\t\treturn false;\n\t}\n};\n\n// Convert ORPC errors from plugin procedures to PluginRuntimeError\nexport const wrapORPCError = (\n\torpcError: ORPCError<string, unknown>,\n\tpluginId?: string,\n\tprocedureName?: string,\n\toperation?: string\n): PluginRuntimeError => {\n\treturn new PluginRuntimeError({\n\t\tpluginId,\n\t\toperation,\n\t\tprocedureName,\n\t\tretryable: isRetryableORPCCode(orpcError.code),\n\t\tcause: orpcError as Error\n\t});\n};\n\n// Universal error converter for the runtime\nexport const toPluginRuntimeError = (\n\terror: unknown,\n\tpluginId?: string,\n\tprocedureName?: string,\n\toperation?: string,\n\tdefaultRetryable = false\n): PluginRuntimeError => {\n\tif (error instanceof ORPCError) {\n\t\treturn wrapORPCError(error, pluginId, procedureName, operation);\n\t}\n\n\tif (error instanceof PluginRuntimeError) {\n\t\treturn error; // Already converted\n\t}\n\n\treturn new PluginRuntimeError({\n\t\tpluginId,\n\t\toperation,\n\t\tprocedureName,\n\t\tretryable: defaultRetryable,\n\t\tcause: error instanceof Error ? error : new Error(String(error))\n\t});\n};\n"],"mappings":";;;;AAIA,IAAa,qBAAb,cAAwC,KAAK,YAAY,qBAAqB,CAM3E;AAEH,IAAa,wBAAb,cAA2C,KAAK,YAC/C,wBACA,CAIE;AAEH,IAAa,kBAAb,cAAqC,KAAK,YAAY,kBAAkB,CAIrE;AAGH,MAAa,uBAAuB,SAA0B;AAC7D,SAAQ,MAAR;EACC,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,UACJ,QAAO;EACR,QACC,QAAO;;;AAKV,MAAa,iBACZ,WACA,UACA,eACA,cACwB;AACxB,QAAO,IAAI,mBAAmB;EAC7B;EACA;EACA;EACA,WAAW,oBAAoB,UAAU,KAAK;EAC9C,OAAO;EACP,CAAC;;AAIH,MAAa,wBACZ,OACA,UACA,eACA,WACA,mBAAmB,UACK;AACxB,KAAI,iBAAiB,UACpB,QAAO,cAAc,OAAO,UAAU,eAAe,UAAU;AAGhE,KAAI,iBAAiB,mBACpB,QAAO;AAGR,QAAO,IAAI,mBAAmB;EAC7B;EACA;EACA;EACA,WAAW;EACX,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;EAChE,CAAC"}

package/dist/runtime/index.cjs

@@ -1,6 +1,158 @@
-const require_runtime = require('../runtime-BNcFgWDG.cjs');
-require('../normalize-D4Qh0wVk.cjs');
-require('../package-DyTuSutr.cjs');
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_errors = require('./errors.cjs');
+const require_plugin_service = require('./services/plugin.service.cjs');
+let effect = require("effect");
+let __orpc_server = require("@orpc/server");
 
-exports.PluginRuntime = require_runtime.PluginRuntime;
-exports.createPluginRuntime = require_runtime.createPluginRuntime;
+//#region src/runtime/index.ts
+var PluginRuntime = class {
+	["__registryType"];
+	pluginCache = /* @__PURE__ */ new Map();
+	constructor(runtime, registry) {
+		this.runtime = runtime;
+		this.registry = registry;
+	}
+	generateCacheKey(pluginId, config) {
+		return `${pluginId}:${effect.Hash.structure(config).toString()}`;
+	}
+	validatePluginId(pluginId) {
+		if (!(pluginId in this.registry)) return effect.Effect.fail(new require_errors.PluginRuntimeError({
+			pluginId: String(pluginId),
+			operation: "validate-plugin-id",
+			cause: /* @__PURE__ */ new Error(`Plugin ID '${String(pluginId)}' not found in registry.`),
+			retryable: false
+		}));
+		return effect.Effect.succeed(String(pluginId));
+	}
+	async runPromise(effect$1) {
+		const exit = await this.runtime.runPromiseExit(effect$1);
+		if (effect.Exit.isFailure(exit)) {
+			const error = effect.Cause.failureOption(exit.cause);
+			if (effect.Option.isSome(error)) throw error.value;
+			throw effect.Cause.squash(exit.cause);
+		}
+		return exit.value;
+	}
+	async usePlugin(pluginId, config) {
+		const cacheKey = this.generateCacheKey(pluginId, config);
+		let cachedPlugin = this.pluginCache.get(cacheKey);
+		if (!cachedPlugin) {
+			const operation = effect.Effect.gen(this, function* () {
+				const pluginService = yield* require_plugin_service.PluginService;
+				const validatedId = yield* this.validatePluginId(pluginId);
+				const ctor = yield* pluginService.loadPlugin(validatedId);
+				const instance = yield* pluginService.instantiatePlugin(pluginId, ctor);
+				return yield* pluginService.initializePlugin(instance, config);
+			}).pipe(effect.Effect.provide(this.runtime));
+			cachedPlugin = effect.Effect.cached(operation).pipe(effect.Effect.flatten);
+			this.pluginCache.set(cacheKey, cachedPlugin);
+		}
+		const initialized = await this.runPromise(cachedPlugin);
+		const router = initialized.plugin.createRouter(initialized.context);
+		return {
+			router,
+			client: (0, __orpc_server.createRouterClient)(router),
+			metadata: initialized.metadata,
+			initialized
+		};
+	}
+	async loadPlugin(pluginId) {
+		const effect$1 = effect.Effect.gen(function* () {
+			return yield* (yield* require_plugin_service.PluginService).loadPlugin(pluginId);
+		});
+		return this.runPromise(effect$1);
+	}
+	async instantiatePlugin(pluginId, loadedPlugin) {
+		const effect$1 = effect.Effect.gen(function* () {
+			return yield* (yield* require_plugin_service.PluginService).instantiatePlugin(pluginId, loadedPlugin);
+		});
+		return this.runPromise(effect$1);
+	}
+	async initializePlugin(instance, config) {
+		const effect$1 = effect.Effect.gen(function* () {
+			return yield* (yield* require_plugin_service.PluginService).initializePlugin(instance, config);
+		});
+		return this.runPromise(effect$1);
+	}
+	async shutdown() {
+		const effect$1 = effect.Effect.gen(function* () {
+			yield* (yield* require_plugin_service.PluginService).cleanup();
+		});
+		return this.runPromise(effect$1);
+	}
+	async evictPlugin(pluginId, config) {
+		const cacheKey = this.generateCacheKey(pluginId, config);
+		const effect$1 = effect.Effect.gen(this, function* () {
+			const pluginService = yield* require_plugin_service.PluginService;
+			const cachedPlugin = this.pluginCache.get(cacheKey);
+			if (cachedPlugin) {
+				this.pluginCache.delete(cacheKey);
+				const pluginResult = yield* cachedPlugin.pipe(effect.Effect.catchAll(() => effect.Effect.succeed(null)));
+				if (pluginResult) yield* pluginService.shutdownPlugin(pluginResult).pipe(effect.Effect.catchAll(() => effect.Effect.void));
+			}
+		}).pipe(effect.Effect.catchAll(() => effect.Effect.void));
+		return this.runPromise(effect$1);
+	}
+};
+/**
+* Normalizes a remote URL to ensure it points to remoteEntry.js
+* If the URL doesn't end with a file extension, appends /remoteEntry.js
+*/
+function normalizeRemoteUrl(url) {
+	if (!url) return url;
+	if (url.endsWith(".js")) return url;
+	return `${url.endsWith("/") ? url.slice(0, -1) : url}/remoteEntry.js`;
+}
+/**
+* Extract plugin map (module constructors) from registry entries
+*/
+function extractPluginMap(registry) {
+	const pluginMap = {};
+	for (const [pluginId, entry] of Object.entries(registry)) if ("module" in entry && entry.module) pluginMap[pluginId] = entry.module;
+	return pluginMap;
+}
+/**
+* Normalize registry entries - ensure remote URLs are properly formatted
+*/
+function normalizeRegistry(registry) {
+	const normalized = {};
+	for (const [pluginId, entry] of Object.entries(registry)) if ("module" in entry) normalized[pluginId] = {
+		...entry,
+		remote: entry.remote ? normalizeRemoteUrl(entry.remote) : void 0
+	};
+	else normalized[pluginId] = {
+		...entry,
+		remote: normalizeRemoteUrl(entry.remote)
+	};
+	return normalized;
+}
+/**
+* Creates a plugin runtime with support for both module and remote plugin entries.
+* 
+* @example
+* ```typescript
+* // With module entries (types inferred automatically)
+* const runtime = createPluginRuntime({
+*   registry: {
+*     telegram: { module: TelegramPlugin },
+*     gopher: { remote: "https://cdn.example.com/gopher/remoteEntry.js" }
+*   },
+*   secrets: { API_KEY: "..." }
+* });
+* 
+* // Types are automatically inferred from module entries!
+* const { client } = await runtime.usePlugin("telegram", config);
+* ```
+*/
+function createPluginRuntime(config) {
+	const secrets = config.secrets || {};
+	const normalizedRegistry = normalizeRegistry(config.registry);
+	const pluginMap = extractPluginMap(config.registry);
+	const layer = require_plugin_service.PluginService.Live(normalizedRegistry, secrets, pluginMap);
+	return new PluginRuntime(effect.ManagedRuntime.make(layer), normalizedRegistry);
+}
+
+//#endregion
+exports.PluginRuntime = PluginRuntime;
+exports.createPluginRuntime = createPluginRuntime;
+//# sourceMappingURL=index.cjs.map

package/dist/runtime/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["runtime: ManagedRuntime.ManagedRuntime<PluginService, never>","registry: PluginRegistry","Hash","Effect","PluginRuntimeError","effect","Exit","Cause","Option","PluginService","pluginMap: Record<string, AnyPluginConstructor>","normalized: Record<string, PluginRegistryEntry>","ManagedRuntime"],"sources":["../../src/runtime/index.ts"],"sourcesContent":["import { createRouterClient } from \"@orpc/server\";\nimport { Cause, Effect, Exit, Hash, ManagedRuntime, Option } from \"effect\";\nimport type {\n\tAnyPlugin,\n\tAnyPluginConstructor,\n\tInferRegistryFromEntries,\n\tInitializedPlugin,\n\tLoadedPlugin,\n\tPluginClientType,\n\tPluginConfigInput,\n\tPluginInstance,\n\tPluginRegistry,\n\tPluginRegistryEntry,\n\tPluginRouterType,\n\tPluginRuntimeConfig,\n\tRegisteredPlugin,\n\tRegisteredPlugins,\n\tUsePluginResult\n} from \"../types\";\nimport { PluginRuntimeError } from \"./errors\";\nimport { PluginService } from \"./services/plugin.service\";\n\nexport class PluginRuntime<R = RegisteredPlugins> {\n\treadonly ['__registryType']?: R;\n\t\n\tprivate pluginCache = new Map<string, Effect.Effect<InitializedPlugin<AnyPlugin>, PluginRuntimeError>>();\n\n\tconstructor(\n\t\tprivate runtime: ManagedRuntime.ManagedRuntime<PluginService, never>,\n\t\tprivate registry: PluginRegistry\n\t) { }\n\n\tprivate generateCacheKey(pluginId: string, config: unknown): string {\n\t\tconst configHash = Hash.structure(config as object).toString();\n\t\treturn `${pluginId}:${configHash}`;\n\t}\n\n\tprivate validatePluginId(\n\t\tpluginId: string\n\t): Effect.Effect<string, PluginRuntimeError> {\n\t\tif (!(pluginId in this.registry)) {\n\t\t\treturn Effect.fail(new PluginRuntimeError({\n\t\t\t\tpluginId: String(pluginId),\n\t\t\t\toperation: \"validate-plugin-id\",\n\t\t\t\tcause: new Error(`Plugin ID '${String(pluginId)}' not found in registry.`),\n\t\t\t\tretryable: false,\n\t\t\t}));\n\t\t}\n\t\treturn Effect.succeed(String(pluginId));\n\t}\n\n\tprivate async runPromise<A, E>(\n\t\teffect: Effect.Effect<A, E, PluginService>\n\t): Promise<A> {\n\t\tconst exit = await this.runtime.runPromiseExit(effect);\n\n\t\tif (Exit.isFailure(exit)) {\n\t\t\tconst error = Cause.failureOption(exit.cause);\n\t\t\tif (Option.isSome(error)) {\n\t\t\t\tthrow error.value;\n\t\t\t}\n\t\t\tthrow Cause.squash(exit.cause);\n\t\t}\n\n\t\treturn exit.value;\n\t}\n\n\tasync usePlugin<K extends keyof R & string>(\n\t\tpluginId: K,\n\t\tconfig: PluginConfigInput<R[K]>\n\t): Promise<UsePluginResult<K, R>> {\n\t\tconst cacheKey = this.generateCacheKey(pluginId, config);\n\n\t\tlet cachedPlugin = this.pluginCache.get(cacheKey);\n\t\tif (!cachedPlugin) {\n\t\t\tconst operation = Effect.gen(this, function* () {\n\t\t\t\tconst pluginService = yield* PluginService;\n\t\t\t\tconst validatedId = yield* this.validatePluginId(pluginId);\n\n\t\t\t\t// Load → Instantiate → Initialize\n\t\t\t\tconst ctor = yield* pluginService.loadPlugin(validatedId);\n\t\t\t\tconst instance = yield* pluginService.instantiatePlugin(pluginId, ctor);\n\t\t\t\tconst initialized = yield* pluginService.initializePlugin(instance, config);\n\n\t\t\t\treturn initialized;\n\t\t\t}).pipe(Effect.provide(this.runtime));\n\n\t\t\tcachedPlugin = Effect.cached(operation).pipe(Effect.flatten);\n\t\t\tthis.pluginCache.set(cacheKey, cachedPlugin);\n\t\t}\n\n\t\tconst initialized = await this.runPromise(cachedPlugin);\n\t\tconst router = initialized.plugin.createRouter(initialized.context);\n\t\tconst client = createRouterClient(router);\n\n\t\treturn {\n\t\t\trouter: router as PluginRouterType<R[K]>,\n\t\t\tclient: client as PluginClientType<R[K]>,\n\t\t\tmetadata: initialized.metadata,\n\t\t\tinitialized: initialized as InitializedPlugin<RegisteredPlugin<K, R>>\n\t\t} as UsePluginResult<K, R>;\n\t}\n\n\tasync loadPlugin<K extends keyof R & string>(\n\t\tpluginId: K\n\t): Promise<LoadedPlugin<RegisteredPlugin<K, R>>> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\treturn yield* pluginService.loadPlugin(pluginId);\n\t\t});\n\t\treturn this.runPromise(effect) as Promise<LoadedPlugin<RegisteredPlugin<K, R>>>;\n\t}\n\n\tasync instantiatePlugin<K extends keyof R & string>(\n\t\tpluginId: K,\n\t\tloadedPlugin: LoadedPlugin<RegisteredPlugin<K, R>>\n\t): Promise<PluginInstance<RegisteredPlugin<K, R>>> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\treturn yield* pluginService.instantiatePlugin(pluginId, loadedPlugin);\n\t\t});\n\t\treturn this.runPromise(effect) as Promise<PluginInstance<RegisteredPlugin<K, R>>>;\n\t}\n\n\tasync initializePlugin<T extends AnyPlugin>(\n\t\tinstance: PluginInstance<T>,\n\t\tconfig: any\n\t): Promise<InitializedPlugin<T>> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\treturn yield* pluginService.initializePlugin(instance, config);\n\t\t});\n\t\treturn this.runPromise(effect);\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\tyield* pluginService.cleanup();\n\t\t});\n\t\treturn this.runPromise(effect);\n\t}\n\n\tasync evictPlugin<K extends keyof R & string>(\n\t\tpluginId: K,\n\t\tconfig: PluginConfigInput<R[K]>\n\t): Promise<void> {\n\t\tconst cacheKey = this.generateCacheKey(pluginId, config);\n\n\t\tconst effect = Effect.gen(this, function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\tconst cachedPlugin = this.pluginCache.get(cacheKey);\n\n\t\t\tif (cachedPlugin) {\n\t\t\t\tthis.pluginCache.delete(cacheKey);\n\n\t\t\t\tconst pluginResult = yield* cachedPlugin.pipe(\n\t\t\t\t\tEffect.catchAll(() => Effect.succeed(null))\n\t\t\t\t);\n\n\t\t\t\tif (pluginResult) {\n\t\t\t\t\tyield* pluginService.shutdownPlugin(pluginResult).pipe(\n\t\t\t\t\t\tEffect.catchAll(() => Effect.void)\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}).pipe(Effect.catchAll(() => Effect.void));\n\n\t\treturn this.runPromise(effect);\n\t}\n}\n\n/**\n * Normalizes a remote URL to ensure it points to remoteEntry.js\n * If the URL doesn't end with a file extension, appends /remoteEntry.js\n */\nfunction normalizeRemoteUrl(url: string): string {\n\tif (!url) return url;\n\tif (url.endsWith('.js')) return url;\n\treturn `${url.endsWith('/') ? url.slice(0, -1) : url}/remoteEntry.js`;\n}\n\n/**\n * Extract plugin map (module constructors) from registry entries\n */\nfunction extractPluginMap(registry: Record<string, PluginRegistryEntry>): Record<string, AnyPluginConstructor> {\n\tconst pluginMap: Record<string, AnyPluginConstructor> = {};\n\t\n\tfor (const [pluginId, entry] of Object.entries(registry)) {\n\t\tif (\"module\" in entry && entry.module) {\n\t\t\tpluginMap[pluginId] = entry.module;\n\t\t}\n\t}\n\t\n\treturn pluginMap;\n}\n\n/**\n * Normalize registry entries - ensure remote URLs are properly formatted\n */\nfunction normalizeRegistry(registry: Record<string, PluginRegistryEntry>): PluginRegistry {\n\tconst normalized: Record<string, PluginRegistryEntry> = {};\n\t\n\tfor (const [pluginId, entry] of Object.entries(registry)) {\n\t\tif (\"module\" in entry) {\n\t\t\tnormalized[pluginId] = {\n\t\t\t\t...entry,\n\t\t\t\tremote: entry.remote ? normalizeRemoteUrl(entry.remote) : undefined,\n\t\t\t};\n\t\t} else {\n\t\t\tnormalized[pluginId] = {\n\t\t\t\t...entry,\n\t\t\t\tremote: normalizeRemoteUrl(entry.remote),\n\t\t\t};\n\t\t}\n\t}\n\t\n\treturn normalized as PluginRegistry;\n}\n\n/**\n * Creates a plugin runtime with support for both module and remote plugin entries.\n * \n * @example\n * ```typescript\n * // With module entries (types inferred automatically)\n * const runtime = createPluginRuntime({\n *   registry: {\n *     telegram: { module: TelegramPlugin },\n *     gopher: { remote: \"https://cdn.example.com/gopher/remoteEntry.js\" }\n *   },\n *   secrets: { API_KEY: \"...\" }\n * });\n * \n * // Types are automatically inferred from module entries!\n * const { client } = await runtime.usePlugin(\"telegram\", config);\n * ```\n */\nexport function createPluginRuntime<\n\tTRegistry extends Record<string, PluginRegistryEntry>\n>(\n\tconfig: PluginRuntimeConfig<TRegistry>\n): PluginRuntime<InferRegistryFromEntries<TRegistry>> {\n\tconst secrets = config.secrets || {};\n\tconst normalizedRegistry = normalizeRegistry(config.registry);\n\tconst pluginMap = extractPluginMap(config.registry);\n\n\tconst layer = PluginService.Live(normalizedRegistry, secrets, pluginMap);\n\tconst runtime = ManagedRuntime.make(layer);\n\n\treturn new PluginRuntime(runtime, normalizedRegistry) as PluginRuntime<InferRegistryFromEntries<TRegistry>>;\n}\n"],"mappings":"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"}

package/dist/runtime/index.d.cts

@@ -1,5 +1,43 @@
-import "../zod-A7Pti5IV.cjs";
-import "../errors-DKPPPYYT.cjs";
-import { n as createPluginRuntime, t as PluginRuntime } from "../index-DtTqwV4f.cjs";
-import "../normalize-BW7kk8Lk.cjs";
-export { PluginRuntime, createPluginRuntime };
+import { AnyPlugin, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, PluginConfigInput, PluginInstance, PluginRegistry, PluginRegistryEntry, PluginRuntimeConfig, RegisteredPlugin, RegisteredPlugins, UsePluginResult } from "../types.cjs";
+import { PluginService } from "./services/plugin.service.cjs";
+import { ManagedRuntime } from "effect";
+
+//#region src/runtime/index.d.ts
+declare class PluginRuntime<R = RegisteredPlugins> {
+  private runtime;
+  private registry;
+  readonly ['__registryType']?: R;
+  private pluginCache;
+  constructor(runtime: ManagedRuntime.ManagedRuntime<PluginService, never>, registry: PluginRegistry);
+  private generateCacheKey;
+  private validatePluginId;
+  private runPromise;
+  usePlugin<K extends keyof R & string>(pluginId: K, config: PluginConfigInput<R[K]>): Promise<UsePluginResult<K, R>>;
+  loadPlugin<K extends keyof R & string>(pluginId: K): Promise<LoadedPlugin<RegisteredPlugin<K, R>>>;
+  instantiatePlugin<K extends keyof R & string>(pluginId: K, loadedPlugin: LoadedPlugin<RegisteredPlugin<K, R>>): Promise<PluginInstance<RegisteredPlugin<K, R>>>;
+  initializePlugin<T extends AnyPlugin>(instance: PluginInstance<T>, config: any): Promise<InitializedPlugin<T>>;
+  shutdown(): Promise<void>;
+  evictPlugin<K extends keyof R & string>(pluginId: K, config: PluginConfigInput<R[K]>): Promise<void>;
+}
+/**
+ * Creates a plugin runtime with support for both module and remote plugin entries.
+ *
+ * @example
+ * ```typescript
+ * // With module entries (types inferred automatically)
+ * const runtime = createPluginRuntime({
+ *   registry: {
+ *     telegram: { module: TelegramPlugin },
+ *     gopher: { remote: "https://cdn.example.com/gopher/remoteEntry.js" }
+ *   },
+ *   secrets: { API_KEY: "..." }
+ * });
+ *
+ * // Types are automatically inferred from module entries!
+ * const { client } = await runtime.usePlugin("telegram", config);
+ * ```
+ */
+declare function createPluginRuntime<TRegistry extends Record<string, PluginRegistryEntry>>(config: PluginRuntimeConfig<TRegistry>): PluginRuntime<InferRegistryFromEntries<TRegistry>>;
+//#endregion
+export { PluginRuntime, createPluginRuntime };
+//# sourceMappingURL=index.d.cts.map

package/dist/runtime/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/runtime/index.ts"],"sourcesContent":[],"mappings":";;;;;cAsBa,kBAAkB;;EAAlB,QAAA,QAAa;EAAK,UAAA,gBAAA,EAAA,EACA,CADA;EACA,QAAA,WAAA;EAKkB,WAAA,CAAA,OAAA,EAA9B,cAAA,CAAe,cAAe,CAAA,aAAA,EAAA,KAAA,CAAA,EAAA,QAAA,EAC7B,cAD6B;EAA9B,QAAA,gBAAe;EACd,QAAA,gBAAA;EAsCa,QAAA,UAAA;EACrB,SAAA,CAAA,UAAA,MADqB,CACrB,GAAA,MAAA,CAAA,CAAA,QAAA,EAAA,CAAA,EAAA,MAAA,EACF,iBADE,CACgB,CADhB,CACkB,CADlB,CAAA,CAAA,CAAA,EAER,OAFQ,CAEA,eAFA,CAEgB,CAFhB,EAEmB,CAFnB,CAAA,CAAA;EACgB,UAAA,CAAA,UAAA,MAkCM,CAlCN,GAAA,MAAA,CAAA,CAAA,QAAA,EAmChB,CAnCgB,CAAA,EAoCxB,OApCwB,CAoChB,YApCgB,CAoCH,gBApCG,CAoCc,CApCd,EAoCiB,CApCjB,CAAA,CAAA,CAAA;EAAE,iBAAA,CAAA,UAAA,MA4CW,CA5CX,GAAA,MAAA,CAAA,CAAA,QAAA,EA6ClB,CA7CkB,EAAA,YAAA,EA8Cd,YA9Cc,CA8CD,gBA9CC,CA8CgB,CA9ChB,EA8CmB,CA9CnB,CAAA,CAAA,CAAA,EA+C1B,OA/C0B,CA+ClB,cA/CkB,CA+CH,gBA/CG,CA+Cc,CA/Cd,EA+CiB,CA/CjB,CAAA,CAAA,CAAA;EAApB,gBAAA,CAAA,UAuDwB,SAvDxB,CAAA,CAAA,QAAA,EAwDE,cAxDF,CAwDiB,CAxDjB,CAAA,EAAA,MAAA,EAAA,GAAA,CAAA,EA0DN,OA1DM,CA0DE,iBA1DF,CA0DoB,CA1DpB,CAAA,CAAA;EACkB,QAAA,CAAA,CAAA,EAiET,OAjES,CAAA,IAAA,CAAA;EAAG,WAAA,CAAA,UAAA,MAyEI,CAzEJ,GAAA,MAAA,CAAA,CAAA,QAAA,EA0EnB,CA1EmB,EAAA,MAAA,EA2ErB,iBA3EqB,CA2EH,CA3EG,CA2ED,CA3EC,CAAA,CAAA,CAAA,EA4E3B,OA5E2B,CAAA,IAAA,CAAA;;;;;;;;;;;;;;;;;;;;AA8C3B,iBA0HY,mBA1HZ,CAAA,kBA2He,MA3Hf,CAAA,MAAA,EA2H8B,mBA3H9B,CAAA,CAAA,CAAA,MAAA,EA6HK,mBA7HL,CA6HyB,SA7HzB,CAAA,CAAA,EA8HD,aA9HC,CA8Ha,wBA9Hb,CA8HsC,SA9HtC,CAAA,CAAA"}

package/dist/runtime/index.d.mts

@@ -1,5 +1,43 @@
-import "../zod-Zw8dlP3j.mjs";
-import "../errors-9sNpYLv5.mjs";
-import { n as createPluginRuntime, t as PluginRuntime } from "../index-Bu2wtZrA.mjs";
-import "../normalize-eB_j86fm.mjs";
-export { PluginRuntime, createPluginRuntime };
+import { AnyPlugin, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, PluginConfigInput, PluginInstance, PluginRegistry, PluginRegistryEntry, PluginRuntimeConfig, RegisteredPlugin, RegisteredPlugins, UsePluginResult } from "../types.mjs";
+import { PluginService } from "./services/plugin.service.mjs";
+import { ManagedRuntime } from "effect";
+
+//#region src/runtime/index.d.ts
+declare class PluginRuntime<R = RegisteredPlugins> {
+  private runtime;
+  private registry;
+  readonly ['__registryType']?: R;
+  private pluginCache;
+  constructor(runtime: ManagedRuntime.ManagedRuntime<PluginService, never>, registry: PluginRegistry);
+  private generateCacheKey;
+  private validatePluginId;
+  private runPromise;
+  usePlugin<K extends keyof R & string>(pluginId: K, config: PluginConfigInput<R[K]>): Promise<UsePluginResult<K, R>>;
+  loadPlugin<K extends keyof R & string>(pluginId: K): Promise<LoadedPlugin<RegisteredPlugin<K, R>>>;
+  instantiatePlugin<K extends keyof R & string>(pluginId: K, loadedPlugin: LoadedPlugin<RegisteredPlugin<K, R>>): Promise<PluginInstance<RegisteredPlugin<K, R>>>;
+  initializePlugin<T extends AnyPlugin>(instance: PluginInstance<T>, config: any): Promise<InitializedPlugin<T>>;
+  shutdown(): Promise<void>;
+  evictPlugin<K extends keyof R & string>(pluginId: K, config: PluginConfigInput<R[K]>): Promise<void>;
+}
+/**
+ * Creates a plugin runtime with support for both module and remote plugin entries.
+ *
+ * @example
+ * ```typescript
+ * // With module entries (types inferred automatically)
+ * const runtime = createPluginRuntime({
+ *   registry: {
+ *     telegram: { module: TelegramPlugin },
+ *     gopher: { remote: "https://cdn.example.com/gopher/remoteEntry.js" }
+ *   },
+ *   secrets: { API_KEY: "..." }
+ * });
+ *
+ * // Types are automatically inferred from module entries!
+ * const { client } = await runtime.usePlugin("telegram", config);
+ * ```
+ */
+declare function createPluginRuntime<TRegistry extends Record<string, PluginRegistryEntry>>(config: PluginRuntimeConfig<TRegistry>): PluginRuntime<InferRegistryFromEntries<TRegistry>>;
+//#endregion
+export { PluginRuntime, createPluginRuntime };
+//# sourceMappingURL=index.d.mts.map

package/dist/runtime/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/runtime/index.ts"],"sourcesContent":[],"mappings":";;;;;cAsBa,kBAAkB;;EAAlB,QAAA,QAAa;EAAK,UAAA,gBAAA,EAAA,EACA,CADA;EACA,QAAA,WAAA;EAKkB,WAAA,CAAA,OAAA,EAA9B,cAAA,CAAe,cAAe,CAAA,aAAA,EAAA,KAAA,CAAA,EAAA,QAAA,EAC7B,cAD6B;EAA9B,QAAA,gBAAe;EACd,QAAA,gBAAA;EAsCa,QAAA,UAAA;EACrB,SAAA,CAAA,UAAA,MADqB,CACrB,GAAA,MAAA,CAAA,CAAA,QAAA,EAAA,CAAA,EAAA,MAAA,EACF,iBADE,CACgB,CADhB,CACkB,CADlB,CAAA,CAAA,CAAA,EAER,OAFQ,CAEA,eAFA,CAEgB,CAFhB,EAEmB,CAFnB,CAAA,CAAA;EACgB,UAAA,CAAA,UAAA,MAkCM,CAlCN,GAAA,MAAA,CAAA,CAAA,QAAA,EAmChB,CAnCgB,CAAA,EAoCxB,OApCwB,CAoChB,YApCgB,CAoCH,gBApCG,CAoCc,CApCd,EAoCiB,CApCjB,CAAA,CAAA,CAAA;EAAE,iBAAA,CAAA,UAAA,MA4CW,CA5CX,GAAA,MAAA,CAAA,CAAA,QAAA,EA6ClB,CA7CkB,EAAA,YAAA,EA8Cd,YA9Cc,CA8CD,gBA9CC,CA8CgB,CA9ChB,EA8CmB,CA9CnB,CAAA,CAAA,CAAA,EA+C1B,OA/C0B,CA+ClB,cA/CkB,CA+CH,gBA/CG,CA+Cc,CA/Cd,EA+CiB,CA/CjB,CAAA,CAAA,CAAA;EAApB,gBAAA,CAAA,UAuDwB,SAvDxB,CAAA,CAAA,QAAA,EAwDE,cAxDF,CAwDiB,CAxDjB,CAAA,EAAA,MAAA,EAAA,GAAA,CAAA,EA0DN,OA1DM,CA0DE,iBA1DF,CA0DoB,CA1DpB,CAAA,CAAA;EACkB,QAAA,CAAA,CAAA,EAiET,OAjES,CAAA,IAAA,CAAA;EAAG,WAAA,CAAA,UAAA,MAyEI,CAzEJ,GAAA,MAAA,CAAA,CAAA,QAAA,EA0EnB,CA1EmB,EAAA,MAAA,EA2ErB,iBA3EqB,CA2EH,CA3EG,CA2ED,CA3EC,CAAA,CAAA,CAAA,EA4E3B,OA5E2B,CAAA,IAAA,CAAA;;;;;;;;;;;;;;;;;;;;AA8C3B,iBA0HY,mBA1HZ,CAAA,kBA2He,MA3Hf,CAAA,MAAA,EA2H8B,mBA3H9B,CAAA,CAAA,CAAA,MAAA,EA6HK,mBA7HL,CA6HyB,SA7HzB,CAAA,CAAA,EA8HD,aA9HC,CA8Ha,wBA9Hb,CA8HsC,SA9HtC,CAAA,CAAA"}

package/dist/runtime/index.mjs

@@ -1,5 +1,156 @@
-import { n as createPluginRuntime, t as PluginRuntime } from "../runtime-CAWcnrAk.mjs";
-import "../normalize-D7nae0Hn.mjs";
-import "../package-CaRYwbRi.mjs";
+import { PluginRuntimeError } from "./errors.mjs";
+import { PluginService } from "./services/plugin.service.mjs";
+import { Cause, Effect, Exit, Hash, ManagedRuntime, Option } from "effect";
+import { createRouterClient } from "@orpc/server";
 
-export { PluginRuntime, createPluginRuntime };
+//#region src/runtime/index.ts
+var PluginRuntime = class {
+	["__registryType"];
+	pluginCache = /* @__PURE__ */ new Map();
+	constructor(runtime, registry) {
+		this.runtime = runtime;
+		this.registry = registry;
+	}
+	generateCacheKey(pluginId, config) {
+		return `${pluginId}:${Hash.structure(config).toString()}`;
+	}
+	validatePluginId(pluginId) {
+		if (!(pluginId in this.registry)) return Effect.fail(new PluginRuntimeError({
+			pluginId: String(pluginId),
+			operation: "validate-plugin-id",
+			cause: /* @__PURE__ */ new Error(`Plugin ID '${String(pluginId)}' not found in registry.`),
+			retryable: false
+		}));
+		return Effect.succeed(String(pluginId));
+	}
+	async runPromise(effect) {
+		const exit = await this.runtime.runPromiseExit(effect);
+		if (Exit.isFailure(exit)) {
+			const error = Cause.failureOption(exit.cause);
+			if (Option.isSome(error)) throw error.value;
+			throw Cause.squash(exit.cause);
+		}
+		return exit.value;
+	}
+	async usePlugin(pluginId, config) {
+		const cacheKey = this.generateCacheKey(pluginId, config);
+		let cachedPlugin = this.pluginCache.get(cacheKey);
+		if (!cachedPlugin) {
+			const operation = Effect.gen(this, function* () {
+				const pluginService = yield* PluginService;
+				const validatedId = yield* this.validatePluginId(pluginId);
+				const ctor = yield* pluginService.loadPlugin(validatedId);
+				const instance = yield* pluginService.instantiatePlugin(pluginId, ctor);
+				return yield* pluginService.initializePlugin(instance, config);
+			}).pipe(Effect.provide(this.runtime));
+			cachedPlugin = Effect.cached(operation).pipe(Effect.flatten);
+			this.pluginCache.set(cacheKey, cachedPlugin);
+		}
+		const initialized = await this.runPromise(cachedPlugin);
+		const router = initialized.plugin.createRouter(initialized.context);
+		return {
+			router,
+			client: createRouterClient(router),
+			metadata: initialized.metadata,
+			initialized
+		};
+	}
+	async loadPlugin(pluginId) {
+		const effect = Effect.gen(function* () {
+			return yield* (yield* PluginService).loadPlugin(pluginId);
+		});
+		return this.runPromise(effect);
+	}
+	async instantiatePlugin(pluginId, loadedPlugin) {
+		const effect = Effect.gen(function* () {
+			return yield* (yield* PluginService).instantiatePlugin(pluginId, loadedPlugin);
+		});
+		return this.runPromise(effect);
+	}
+	async initializePlugin(instance, config) {
+		const effect = Effect.gen(function* () {
+			return yield* (yield* PluginService).initializePlugin(instance, config);
+		});
+		return this.runPromise(effect);
+	}
+	async shutdown() {
+		const effect = Effect.gen(function* () {
+			yield* (yield* PluginService).cleanup();
+		});
+		return this.runPromise(effect);
+	}
+	async evictPlugin(pluginId, config) {
+		const cacheKey = this.generateCacheKey(pluginId, config);
+		const effect = Effect.gen(this, function* () {
+			const pluginService = yield* PluginService;
+			const cachedPlugin = this.pluginCache.get(cacheKey);
+			if (cachedPlugin) {
+				this.pluginCache.delete(cacheKey);
+				const pluginResult = yield* cachedPlugin.pipe(Effect.catchAll(() => Effect.succeed(null)));
+				if (pluginResult) yield* pluginService.shutdownPlugin(pluginResult).pipe(Effect.catchAll(() => Effect.void));
+			}
+		}).pipe(Effect.catchAll(() => Effect.void));
+		return this.runPromise(effect);
+	}
+};
+/**
+* Normalizes a remote URL to ensure it points to remoteEntry.js
+* If the URL doesn't end with a file extension, appends /remoteEntry.js
+*/
+function normalizeRemoteUrl(url) {
+	if (!url) return url;
+	if (url.endsWith(".js")) return url;
+	return `${url.endsWith("/") ? url.slice(0, -1) : url}/remoteEntry.js`;
+}
+/**
+* Extract plugin map (module constructors) from registry entries
+*/
+function extractPluginMap(registry) {
+	const pluginMap = {};
+	for (const [pluginId, entry] of Object.entries(registry)) if ("module" in entry && entry.module) pluginMap[pluginId] = entry.module;
+	return pluginMap;
+}
+/**
+* Normalize registry entries - ensure remote URLs are properly formatted
+*/
+function normalizeRegistry(registry) {
+	const normalized = {};
+	for (const [pluginId, entry] of Object.entries(registry)) if ("module" in entry) normalized[pluginId] = {
+		...entry,
+		remote: entry.remote ? normalizeRemoteUrl(entry.remote) : void 0
+	};
+	else normalized[pluginId] = {
+		...entry,
+		remote: normalizeRemoteUrl(entry.remote)
+	};
+	return normalized;
+}
+/**
+* Creates a plugin runtime with support for both module and remote plugin entries.
+* 
+* @example
+* ```typescript
+* // With module entries (types inferred automatically)
+* const runtime = createPluginRuntime({
+*   registry: {
+*     telegram: { module: TelegramPlugin },
+*     gopher: { remote: "https://cdn.example.com/gopher/remoteEntry.js" }
+*   },
+*   secrets: { API_KEY: "..." }
+* });
+* 
+* // Types are automatically inferred from module entries!
+* const { client } = await runtime.usePlugin("telegram", config);
+* ```
+*/
+function createPluginRuntime(config) {
+	const secrets = config.secrets || {};
+	const normalizedRegistry = normalizeRegistry(config.registry);
+	const pluginMap = extractPluginMap(config.registry);
+	const layer = PluginService.Live(normalizedRegistry, secrets, pluginMap);
+	return new PluginRuntime(ManagedRuntime.make(layer), normalizedRegistry);
+}
+
+//#endregion
+export { PluginRuntime, createPluginRuntime };
+//# sourceMappingURL=index.mjs.map

package/dist/runtime/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["runtime: ManagedRuntime.ManagedRuntime<PluginService, never>","registry: PluginRegistry","pluginMap: Record<string, AnyPluginConstructor>","normalized: Record<string, PluginRegistryEntry>"],"sources":["../../src/runtime/index.ts"],"sourcesContent":["import { createRouterClient } from \"@orpc/server\";\nimport { Cause, Effect, Exit, Hash, ManagedRuntime, Option } from \"effect\";\nimport type {\n\tAnyPlugin,\n\tAnyPluginConstructor,\n\tInferRegistryFromEntries,\n\tInitializedPlugin,\n\tLoadedPlugin,\n\tPluginClientType,\n\tPluginConfigInput,\n\tPluginInstance,\n\tPluginRegistry,\n\tPluginRegistryEntry,\n\tPluginRouterType,\n\tPluginRuntimeConfig,\n\tRegisteredPlugin,\n\tRegisteredPlugins,\n\tUsePluginResult\n} from \"../types\";\nimport { PluginRuntimeError } from \"./errors\";\nimport { PluginService } from \"./services/plugin.service\";\n\nexport class PluginRuntime<R = RegisteredPlugins> {\n\treadonly ['__registryType']?: R;\n\t\n\tprivate pluginCache = new Map<string, Effect.Effect<InitializedPlugin<AnyPlugin>, PluginRuntimeError>>();\n\n\tconstructor(\n\t\tprivate runtime: ManagedRuntime.ManagedRuntime<PluginService, never>,\n\t\tprivate registry: PluginRegistry\n\t) { }\n\n\tprivate generateCacheKey(pluginId: string, config: unknown): string {\n\t\tconst configHash = Hash.structure(config as object).toString();\n\t\treturn `${pluginId}:${configHash}`;\n\t}\n\n\tprivate validatePluginId(\n\t\tpluginId: string\n\t): Effect.Effect<string, PluginRuntimeError> {\n\t\tif (!(pluginId in this.registry)) {\n\t\t\treturn Effect.fail(new PluginRuntimeError({\n\t\t\t\tpluginId: String(pluginId),\n\t\t\t\toperation: \"validate-plugin-id\",\n\t\t\t\tcause: new Error(`Plugin ID '${String(pluginId)}' not found in registry.`),\n\t\t\t\tretryable: false,\n\t\t\t}));\n\t\t}\n\t\treturn Effect.succeed(String(pluginId));\n\t}\n\n\tprivate async runPromise<A, E>(\n\t\teffect: Effect.Effect<A, E, PluginService>\n\t): Promise<A> {\n\t\tconst exit = await this.runtime.runPromiseExit(effect);\n\n\t\tif (Exit.isFailure(exit)) {\n\t\t\tconst error = Cause.failureOption(exit.cause);\n\t\t\tif (Option.isSome(error)) {\n\t\t\t\tthrow error.value;\n\t\t\t}\n\t\t\tthrow Cause.squash(exit.cause);\n\t\t}\n\n\t\treturn exit.value;\n\t}\n\n\tasync usePlugin<K extends keyof R & string>(\n\t\tpluginId: K,\n\t\tconfig: PluginConfigInput<R[K]>\n\t): Promise<UsePluginResult<K, R>> {\n\t\tconst cacheKey = this.generateCacheKey(pluginId, config);\n\n\t\tlet cachedPlugin = this.pluginCache.get(cacheKey);\n\t\tif (!cachedPlugin) {\n\t\t\tconst operation = Effect.gen(this, function* () {\n\t\t\t\tconst pluginService = yield* PluginService;\n\t\t\t\tconst validatedId = yield* this.validatePluginId(pluginId);\n\n\t\t\t\t// Load → Instantiate → Initialize\n\t\t\t\tconst ctor = yield* pluginService.loadPlugin(validatedId);\n\t\t\t\tconst instance = yield* pluginService.instantiatePlugin(pluginId, ctor);\n\t\t\t\tconst initialized = yield* pluginService.initializePlugin(instance, config);\n\n\t\t\t\treturn initialized;\n\t\t\t}).pipe(Effect.provide(this.runtime));\n\n\t\t\tcachedPlugin = Effect.cached(operation).pipe(Effect.flatten);\n\t\t\tthis.pluginCache.set(cacheKey, cachedPlugin);\n\t\t}\n\n\t\tconst initialized = await this.runPromise(cachedPlugin);\n\t\tconst router = initialized.plugin.createRouter(initialized.context);\n\t\tconst client = createRouterClient(router);\n\n\t\treturn {\n\t\t\trouter: router as PluginRouterType<R[K]>,\n\t\t\tclient: client as PluginClientType<R[K]>,\n\t\t\tmetadata: initialized.metadata,\n\t\t\tinitialized: initialized as InitializedPlugin<RegisteredPlugin<K, R>>\n\t\t} as UsePluginResult<K, R>;\n\t}\n\n\tasync loadPlugin<K extends keyof R & string>(\n\t\tpluginId: K\n\t): Promise<LoadedPlugin<RegisteredPlugin<K, R>>> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\treturn yield* pluginService.loadPlugin(pluginId);\n\t\t});\n\t\treturn this.runPromise(effect) as Promise<LoadedPlugin<RegisteredPlugin<K, R>>>;\n\t}\n\n\tasync instantiatePlugin<K extends keyof R & string>(\n\t\tpluginId: K,\n\t\tloadedPlugin: LoadedPlugin<RegisteredPlugin<K, R>>\n\t): Promise<PluginInstance<RegisteredPlugin<K, R>>> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\treturn yield* pluginService.instantiatePlugin(pluginId, loadedPlugin);\n\t\t});\n\t\treturn this.runPromise(effect) as Promise<PluginInstance<RegisteredPlugin<K, R>>>;\n\t}\n\n\tasync initializePlugin<T extends AnyPlugin>(\n\t\tinstance: PluginInstance<T>,\n\t\tconfig: any\n\t): Promise<InitializedPlugin<T>> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\treturn yield* pluginService.initializePlugin(instance, config);\n\t\t});\n\t\treturn this.runPromise(effect);\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tconst effect = Effect.gen(function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\tyield* pluginService.cleanup();\n\t\t});\n\t\treturn this.runPromise(effect);\n\t}\n\n\tasync evictPlugin<K extends keyof R & string>(\n\t\tpluginId: K,\n\t\tconfig: PluginConfigInput<R[K]>\n\t): Promise<void> {\n\t\tconst cacheKey = this.generateCacheKey(pluginId, config);\n\n\t\tconst effect = Effect.gen(this, function* () {\n\t\t\tconst pluginService = yield* PluginService;\n\t\t\tconst cachedPlugin = this.pluginCache.get(cacheKey);\n\n\t\t\tif (cachedPlugin) {\n\t\t\t\tthis.pluginCache.delete(cacheKey);\n\n\t\t\t\tconst pluginResult = yield* cachedPlugin.pipe(\n\t\t\t\t\tEffect.catchAll(() => Effect.succeed(null))\n\t\t\t\t);\n\n\t\t\t\tif (pluginResult) {\n\t\t\t\t\tyield* pluginService.shutdownPlugin(pluginResult).pipe(\n\t\t\t\t\t\tEffect.catchAll(() => Effect.void)\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}).pipe(Effect.catchAll(() => Effect.void));\n\n\t\treturn this.runPromise(effect);\n\t}\n}\n\n/**\n * Normalizes a remote URL to ensure it points to remoteEntry.js\n * If the URL doesn't end with a file extension, appends /remoteEntry.js\n */\nfunction normalizeRemoteUrl(url: string): string {\n\tif (!url) return url;\n\tif (url.endsWith('.js')) return url;\n\treturn `${url.endsWith('/') ? url.slice(0, -1) : url}/remoteEntry.js`;\n}\n\n/**\n * Extract plugin map (module constructors) from registry entries\n */\nfunction extractPluginMap(registry: Record<string, PluginRegistryEntry>): Record<string, AnyPluginConstructor> {\n\tconst pluginMap: Record<string, AnyPluginConstructor> = {};\n\t\n\tfor (const [pluginId, entry] of Object.entries(registry)) {\n\t\tif (\"module\" in entry && entry.module) {\n\t\t\tpluginMap[pluginId] = entry.module;\n\t\t}\n\t}\n\t\n\treturn pluginMap;\n}\n\n/**\n * Normalize registry entries - ensure remote URLs are properly formatted\n */\nfunction normalizeRegistry(registry: Record<string, PluginRegistryEntry>): PluginRegistry {\n\tconst normalized: Record<string, PluginRegistryEntry> = {};\n\t\n\tfor (const [pluginId, entry] of Object.entries(registry)) {\n\t\tif (\"module\" in entry) {\n\t\t\tnormalized[pluginId] = {\n\t\t\t\t...entry,\n\t\t\t\tremote: entry.remote ? normalizeRemoteUrl(entry.remote) : undefined,\n\t\t\t};\n\t\t} else {\n\t\t\tnormalized[pluginId] = {\n\t\t\t\t...entry,\n\t\t\t\tremote: normalizeRemoteUrl(entry.remote),\n\t\t\t};\n\t\t}\n\t}\n\t\n\treturn normalized as PluginRegistry;\n}\n\n/**\n * Creates a plugin runtime with support for both module and remote plugin entries.\n * \n * @example\n * ```typescript\n * // With module entries (types inferred automatically)\n * const runtime = createPluginRuntime({\n *   registry: {\n *     telegram: { module: TelegramPlugin },\n *     gopher: { remote: \"https://cdn.example.com/gopher/remoteEntry.js\" }\n *   },\n *   secrets: { API_KEY: \"...\" }\n * });\n * \n * // Types are automatically inferred from module entries!\n * const { client } = await runtime.usePlugin(\"telegram\", config);\n * ```\n */\nexport function createPluginRuntime<\n\tTRegistry extends Record<string, PluginRegistryEntry>\n>(\n\tconfig: PluginRuntimeConfig<TRegistry>\n): PluginRuntime<InferRegistryFromEntries<TRegistry>> {\n\tconst secrets = config.secrets || {};\n\tconst normalizedRegistry = normalizeRegistry(config.registry);\n\tconst pluginMap = extractPluginMap(config.registry);\n\n\tconst layer = PluginService.Live(normalizedRegistry, secrets, pluginMap);\n\tconst runtime = ManagedRuntime.make(layer);\n\n\treturn new PluginRuntime(runtime, normalizedRegistry) as PluginRuntime<InferRegistryFromEntries<TRegistry>>;\n}\n"],"mappings":"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"}