every-plugin 2.10.1 → 3.0.0-rc.10

package/dist/identity.d.cts

@@ -0,0 +1,33 @@
+//#region src/identity.d.ts
+/**
+ * Plugin identity: every name a plugin workspace carries, derived from one
+ * input. Two seams live here:
+ *
+ * - `remoteName`/`containerName` absorb the framework's two normalizers (the
+ *   Module Federation remote name and the UI container name) — runtime,
+ *   build, and host consumers delegate to these instead of keeping private
+ *   copies, so a name can never disagree across contexts.
+ * - `identity` derives the full name set from the config layout key (the
+ *   `plugins/<key>` attachment in `bos.config.json`): the key itself (the
+ *   composition key), the npm package name under the scaffold convention,
+ *   and the two normalized build names.
+ *
+ * Normalization rules:
+ * - remote: lowercase, strip a single leading '@', replace '/' with '_',
+ *   preserve hyphens and other characters
+ *   ("@scope/my-plugin" → "scope_my-plugin")
+ * - container: replace every character outside [A-Za-z0-9_] with '_'
+ *   ("@everything-dev/auth-plugin" → "_everything_dev_auth_plugin")
+ */
+interface PluginIdentity {
+  key: string;
+  npm: string;
+  remote: string;
+  container: string;
+}
+declare const remoteName: (name: string) => string;
+declare const containerName: (pkgName: string) => string;
+declare const identity: (key: string) => PluginIdentity;
+//#endregion
+export { PluginIdentity, containerName, identity, remoteName };
+//# sourceMappingURL=identity.d.cts.map

package/dist/identity.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.cts","names":[],"sources":["../src/identity.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;UAoBiB;EACf;EACA;EACA;EACA;;cAGW,aAAU;cAGV,gBAAa;cAEb,WAAQ,gBAAkB"}

package/dist/identity.d.mts

@@ -0,0 +1,33 @@
+//#region src/identity.d.ts
+/**
+ * Plugin identity: every name a plugin workspace carries, derived from one
+ * input. Two seams live here:
+ *
+ * - `remoteName`/`containerName` absorb the framework's two normalizers (the
+ *   Module Federation remote name and the UI container name) — runtime,
+ *   build, and host consumers delegate to these instead of keeping private
+ *   copies, so a name can never disagree across contexts.
+ * - `identity` derives the full name set from the config layout key (the
+ *   `plugins/<key>` attachment in `bos.config.json`): the key itself (the
+ *   composition key), the npm package name under the scaffold convention,
+ *   and the two normalized build names.
+ *
+ * Normalization rules:
+ * - remote: lowercase, strip a single leading '@', replace '/' with '_',
+ *   preserve hyphens and other characters
+ *   ("@scope/my-plugin" → "scope_my-plugin")
+ * - container: replace every character outside [A-Za-z0-9_] with '_'
+ *   ("@everything-dev/auth-plugin" → "_everything_dev_auth_plugin")
+ */
+interface PluginIdentity {
+  key: string;
+  npm: string;
+  remote: string;
+  container: string;
+}
+declare const remoteName: (name: string) => string;
+declare const containerName: (pkgName: string) => string;
+declare const identity: (key: string) => PluginIdentity;
+//#endregion
+export { PluginIdentity, containerName, identity, remoteName };
+//# sourceMappingURL=identity.d.mts.map

package/dist/identity.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.mts","names":[],"sources":["../src/identity.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;UAoBiB;EACf;EACA;EACA;EACA;;cAGW,aAAU;cAGV,gBAAa;cAEb,WAAQ,gBAAkB"}

package/dist/identity.mjs

@@ -0,0 +1,16 @@
+//#region src/identity.ts
+const remoteName = (name) => name.toLowerCase().replace(/^@/, "").replace(/\//g, "_");
+const containerName = (pkgName) => pkgName.replace(/[^A-Za-z0-9_]/g, "_");
+const identity = (key) => {
+	const npm = `@everything-dev/${key}-plugin`;
+	return {
+		key,
+		npm,
+		remote: remoteName(npm),
+		container: containerName(npm)
+	};
+};
+
+//#endregion
+export { containerName, identity, remoteName };
+//# sourceMappingURL=identity.mjs.map

package/dist/identity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.mjs","names":[],"sources":["../src/identity.ts"],"sourcesContent":["/**\n * Plugin identity: every name a plugin workspace carries, derived from one\n * input. Two seams live here:\n *\n * - `remoteName`/`containerName` absorb the framework's two normalizers (the\n *   Module Federation remote name and the UI container name) — runtime,\n *   build, and host consumers delegate to these instead of keeping private\n *   copies, so a name can never disagree across contexts.\n * - `identity` derives the full name set from the config layout key (the\n *   `plugins/<key>` attachment in `bos.config.json`): the key itself (the\n *   composition key), the npm package name under the scaffold convention,\n *   and the two normalized build names.\n *\n * Normalization rules:\n * - remote: lowercase, strip a single leading '@', replace '/' with '_',\n *   preserve hyphens and other characters\n *   (\"@scope/my-plugin\" → \"scope_my-plugin\")\n * - container: replace every character outside [A-Za-z0-9_] with '_'\n *   (\"@everything-dev/auth-plugin\" → \"_everything_dev_auth_plugin\")\n */\nexport interface PluginIdentity {\n  key: string;\n  npm: string;\n  remote: string;\n  container: string;\n}\n\nexport const remoteName = (name: string): string =>\n  name.toLowerCase().replace(/^@/, \"\").replace(/\\//g, \"_\");\n\nexport const containerName = (pkgName: string): string => pkgName.replace(/[^A-Za-z0-9_]/g, \"_\");\n\nexport const identity = (key: string): PluginIdentity => {\n  const npm = `@everything-dev/${key}-plugin`;\n  return { key, npm, remote: remoteName(npm), container: containerName(npm) };\n};\n"],"mappings":";AA2BA,MAAa,cAAc,SACzB,KAAK,YAAY,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC,QAAQ,OAAO,GAAG;AAEzD,MAAa,iBAAiB,YAA4B,QAAQ,QAAQ,kBAAkB,GAAG;AAE/F,MAAa,YAAY,QAAgC;CACvD,MAAM,MAAM,mBAAmB,IAAI;CACnC,OAAO;EAAE;EAAK;EAAK,QAAQ,WAAW,GAAG;EAAG,WAAW,cAAc,GAAG;CAAE;AAC5E"}

package/dist/index.cjs

@@ -1,17 +1,19 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_client = require('./client.cjs');
+const require_effect_helpers = require('./effect-helpers.cjs');
 const require_errors = require('./runtime/errors.cjs');
 const require_errors$1 = require('./errors.cjs');
 const require_plugin = require('./plugin.cjs');
-const require_runtime_services_normalize = require('./runtime/services/normalize.cjs');
+const require_identity = require('./identity.cjs');
 const require_runtime_index = require('./runtime/index.cjs');
+require("@orpc/openapi/extensions/route");
 
 exports.BAD_REQUEST = require_errors$1.BAD_REQUEST;
 exports.CONNECTION_ERROR = require_errors$1.CONNECTION_ERROR;
-exports.CommonPluginErrors = require_errors$1.CommonPluginErrors;
-exports.ERROR_PATTERNS = require_errors$1.ERROR_PATTERNS;
 exports.FORBIDDEN = require_errors$1.FORBIDDEN;
 exports.ModuleFederationError = require_errors.ModuleFederationError;
 exports.NOT_FOUND = require_errors$1.NOT_FOUND;
+exports.PLUGIN_ERROR_STATUS_MAP = require_errors$1.PLUGIN_ERROR_STATUS_MAP;
 exports.PluginErrors = require_errors$1.PluginErrors;
 exports.PluginIdTag = require_plugin.PluginIdTag;
 exports.PluginRuntime = require_runtime_index.PluginRuntime;
@@ -21,12 +23,16 @@ exports.SERVICE_UNAVAILABLE = require_errors$1.SERVICE_UNAVAILABLE;
 exports.TIMEOUT = require_errors$1.TIMEOUT;
 exports.UNAUTHORIZED = require_errors$1.UNAUTHORIZED;
 exports.ValidationError = require_errors.ValidationError;
+exports.buildScoped = require_effect_helpers.buildScoped;
+exports.buildScopedContext = require_effect_helpers.buildScopedContext;
+exports.classifyPluginFailure = require_errors.classifyPluginFailure;
 exports.createPlugin = require_plugin.createPlugin;
 exports.createPluginRuntime = require_runtime_index.createPluginRuntime;
+exports.createRpcClient = require_client.createRpcClient;
+exports.defaultMissingSecretWarnings = require_errors.defaultMissingSecretWarnings;
 exports.extractFromFiberFailure = require_errors.extractFromFiberFailure;
 exports.formatORPCError = require_errors.formatORPCError;
-exports.getNormalizedRemoteName = require_runtime_services_normalize.getNormalizedRemoteName;
-exports.isRetryableORPCCode = require_errors.isRetryableORPCCode;
+exports.getNormalizedRemoteName = require_identity.remoteName;
 exports.toPluginRuntimeError = require_errors.toPluginRuntimeError;
 exports.withPlugins = require_plugin.withPlugins;
 exports.wrapORPCError = require_errors.wrapORPCError;

package/dist/index.d.cts

@@ -1,7 +1,10 @@
-import { ModuleFederationError, PluginRuntimeError, ValidationError, extractFromFiberFailure, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.cjs";
-import { BAD_REQUEST, CONNECTION_ERROR, CommonPluginErrors, ERROR_PATTERNS, FORBIDDEN, NOT_FOUND, PluginErrors, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED } from "./errors.cjs";
-import { CreatePluginFn, CreatePluginWithPlugins, LoadedPluginWithBinding, Plugin, PluginConfigFor, PluginIdTag, PluginServicesTools, createPlugin, withPlugins } from "./plugin.cjs";
-import { AnyPlugin, EveryPlugin, InitializedPlugin, LoadedPlugin, PluginClientType, PluginConfigInput, PluginContext, PluginContract, PluginInstance, PluginMetadata, PluginRegistry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginVariables, RegisteredPlugins, SecretsConfig, UsePluginResult } from "./types.cjs";
+import { remoteName } from "./identity.cjs";
+import { RpcClientConfig, RpcConnectionErrorCopy, createRpcClient } from "./client.cjs";
+import { ModuleFederationError, PluginLoadFailureInfo, PluginRuntimeError, PluginWarningInfo, ValidationError, classifyPluginFailure, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.cjs";
+import { BAD_REQUEST, CONNECTION_ERROR, FORBIDDEN, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, PluginErrors, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED } from "./errors.cjs";
+import { buildScoped, buildScopedContext } from "./effect-helpers.cjs";
+import { CreatePluginFn, CreatePluginWithPlugins, LoadedPluginWithBinding, Plugin, PluginConfigFor, PluginEnv, PluginIdTag, PluginInitializeInput, PluginWarningsFn, createPlugin, withPlugins } from "./plugin.cjs";
+import { AnyPlugin, EveryPlugin, InitializedPlugin, LoadedPlugin, ModuleClientEntry, ModuleEndpoint, ModuleSurface, ModuleTransport, PluginClientEntry, PluginClientType, PluginConfigInput, PluginContext, PluginContract, PluginEndpoint, PluginInstance, PluginMetadata, PluginRegistry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, PluginSurface, PluginTransport, PluginVariables, RegisteredPlugins, SecretsConfig, UsePluginResult } from "./types.cjs";
 import { PluginRuntime, createPluginRuntime } from "./runtime/index.cjs";
-import { getNormalizedRemoteName } from "./runtime/services/normalize.cjs";
-export { type AnyPlugin, BAD_REQUEST, CONNECTION_ERROR, CommonPluginErrors, CreatePluginFn, CreatePluginWithPlugins, ERROR_PATTERNS, type EveryPlugin, FORBIDDEN, type InitializedPlugin, type LoadedPlugin, LoadedPluginWithBinding, ModuleFederationError, NOT_FOUND, Plugin, type PluginClientType, PluginConfigFor, type PluginConfigInput, type PluginContext, type PluginContract, PluginErrors, PluginIdTag, type PluginInstance, type PluginMetadata, type PluginRegistry, type PluginRouterType, PluginRuntime, type PluginRuntimeConfig, PluginRuntimeError, type PluginSecrets, PluginServicesTools, type PluginVariables, RATE_LIMITED, type RegisteredPlugins, SERVICE_UNAVAILABLE, type SecretsConfig, TIMEOUT, UNAUTHORIZED, type UsePluginResult, ValidationError, createPlugin, createPluginRuntime, extractFromFiberFailure, formatORPCError, getNormalizedRemoteName, isRetryableORPCCode, toPluginRuntimeError, withPlugins, wrapORPCError };
+import "@orpc/openapi/extensions/route";
+export { type AnyPlugin, BAD_REQUEST, CONNECTION_ERROR, CreatePluginFn, CreatePluginWithPlugins, type EveryPlugin, FORBIDDEN, type InitializedPlugin, type LoadedPlugin, LoadedPluginWithBinding, type ModuleClientEntry, type ModuleEndpoint, ModuleFederationError, type ModuleSurface, type ModuleTransport, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, Plugin, type PluginClientEntry, type PluginClientType, PluginConfigFor, type PluginConfigInput, type PluginContext, type PluginContract, type PluginEndpoint, PluginEnv, PluginErrors, PluginIdTag, PluginInitializeInput, type PluginInstance, type PluginLoadFailureInfo, type PluginMetadata, type PluginRegistry, type PluginRouterType, PluginRuntime, type PluginRuntimeConfig, PluginRuntimeError, type PluginSecrets, type PluginServicesEntry, type PluginSurface, type PluginTransport, type PluginVariables, type PluginWarningInfo, PluginWarningsFn, RATE_LIMITED, type RegisteredPlugins, RpcClientConfig, RpcConnectionErrorCopy, SERVICE_UNAVAILABLE, type SecretsConfig, TIMEOUT, UNAUTHORIZED, type UsePluginResult, ValidationError, buildScoped, buildScopedContext, classifyPluginFailure, createPlugin, createPluginRuntime, createRpcClient, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, remoteName as getNormalizedRemoteName, toPluginRuntimeError, withPlugins, wrapORPCError };

package/dist/index.d.mts

@@ -1,7 +1,10 @@
-import { ModuleFederationError, PluginRuntimeError, ValidationError, extractFromFiberFailure, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.mjs";
-import { BAD_REQUEST, CONNECTION_ERROR, CommonPluginErrors, ERROR_PATTERNS, FORBIDDEN, NOT_FOUND, PluginErrors, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED } from "./errors.mjs";
-import { CreatePluginFn, CreatePluginWithPlugins, LoadedPluginWithBinding, Plugin, PluginConfigFor, PluginIdTag, PluginServicesTools, createPlugin, withPlugins } from "./plugin.mjs";
-import { AnyPlugin, EveryPlugin, InitializedPlugin, LoadedPlugin, PluginClientType, PluginConfigInput, PluginContext, PluginContract, PluginInstance, PluginMetadata, PluginRegistry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginVariables, RegisteredPlugins, SecretsConfig, UsePluginResult } from "./types.mjs";
+import { remoteName } from "./identity.mjs";
+import { RpcClientConfig, RpcConnectionErrorCopy, createRpcClient } from "./client.mjs";
+import { ModuleFederationError, PluginLoadFailureInfo, PluginRuntimeError, PluginWarningInfo, ValidationError, classifyPluginFailure, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.mjs";
+import { BAD_REQUEST, CONNECTION_ERROR, FORBIDDEN, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, PluginErrors, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED } from "./errors.mjs";
+import { buildScoped, buildScopedContext } from "./effect-helpers.mjs";
+import { CreatePluginFn, CreatePluginWithPlugins, LoadedPluginWithBinding, Plugin, PluginConfigFor, PluginEnv, PluginIdTag, PluginInitializeInput, PluginWarningsFn, createPlugin, withPlugins } from "./plugin.mjs";
+import { AnyPlugin, EveryPlugin, InitializedPlugin, LoadedPlugin, ModuleClientEntry, ModuleEndpoint, ModuleSurface, ModuleTransport, PluginClientEntry, PluginClientType, PluginConfigInput, PluginContext, PluginContract, PluginEndpoint, PluginInstance, PluginMetadata, PluginRegistry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, PluginSurface, PluginTransport, PluginVariables, RegisteredPlugins, SecretsConfig, UsePluginResult } from "./types.mjs";
 import { PluginRuntime, createPluginRuntime } from "./runtime/index.mjs";
-import { getNormalizedRemoteName } from "./runtime/services/normalize.mjs";
-export { type AnyPlugin, BAD_REQUEST, CONNECTION_ERROR, CommonPluginErrors, CreatePluginFn, CreatePluginWithPlugins, ERROR_PATTERNS, type EveryPlugin, FORBIDDEN, type InitializedPlugin, type LoadedPlugin, LoadedPluginWithBinding, ModuleFederationError, NOT_FOUND, Plugin, type PluginClientType, PluginConfigFor, type PluginConfigInput, type PluginContext, type PluginContract, PluginErrors, PluginIdTag, type PluginInstance, type PluginMetadata, type PluginRegistry, type PluginRouterType, PluginRuntime, type PluginRuntimeConfig, PluginRuntimeError, type PluginSecrets, PluginServicesTools, type PluginVariables, RATE_LIMITED, type RegisteredPlugins, SERVICE_UNAVAILABLE, type SecretsConfig, TIMEOUT, UNAUTHORIZED, type UsePluginResult, ValidationError, createPlugin, createPluginRuntime, extractFromFiberFailure, formatORPCError, getNormalizedRemoteName, isRetryableORPCCode, toPluginRuntimeError, withPlugins, wrapORPCError };
+import "@orpc/openapi/extensions/route";
+export { type AnyPlugin, BAD_REQUEST, CONNECTION_ERROR, CreatePluginFn, CreatePluginWithPlugins, type EveryPlugin, FORBIDDEN, type InitializedPlugin, type LoadedPlugin, LoadedPluginWithBinding, type ModuleClientEntry, type ModuleEndpoint, ModuleFederationError, type ModuleSurface, type ModuleTransport, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, Plugin, type PluginClientEntry, type PluginClientType, PluginConfigFor, type PluginConfigInput, type PluginContext, type PluginContract, type PluginEndpoint, PluginEnv, PluginErrors, PluginIdTag, PluginInitializeInput, type PluginInstance, type PluginLoadFailureInfo, type PluginMetadata, type PluginRegistry, type PluginRouterType, PluginRuntime, type PluginRuntimeConfig, PluginRuntimeError, type PluginSecrets, type PluginServicesEntry, type PluginSurface, type PluginTransport, type PluginVariables, type PluginWarningInfo, PluginWarningsFn, RATE_LIMITED, type RegisteredPlugins, RpcClientConfig, RpcConnectionErrorCopy, SERVICE_UNAVAILABLE, type SecretsConfig, TIMEOUT, UNAUTHORIZED, type UsePluginResult, ValidationError, buildScoped, buildScopedContext, classifyPluginFailure, createPlugin, createPluginRuntime, createRpcClient, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, remoteName as getNormalizedRemoteName, toPluginRuntimeError, withPlugins, wrapORPCError };

package/dist/index.mjs

@@ -1,7 +1,10 @@
-import { ModuleFederationError, PluginRuntimeError, ValidationError, extractFromFiberFailure, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.mjs";
-import { BAD_REQUEST, CONNECTION_ERROR, CommonPluginErrors, ERROR_PATTERNS, FORBIDDEN, NOT_FOUND, PluginErrors, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED } from "./errors.mjs";
+import { createRpcClient } from "./client.mjs";
+import { buildScoped, buildScopedContext } from "./effect-helpers.mjs";
+import { ModuleFederationError, PluginRuntimeError, ValidationError, classifyPluginFailure, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.mjs";
+import { BAD_REQUEST, CONNECTION_ERROR, FORBIDDEN, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, PluginErrors, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED } from "./errors.mjs";
 import { PluginIdTag, createPlugin, withPlugins } from "./plugin.mjs";
-import { getNormalizedRemoteName } from "./runtime/services/normalize.mjs";
+import { remoteName } from "./identity.mjs";
 import { PluginRuntime, createPluginRuntime } from "./runtime/index.mjs";
+import "@orpc/openapi/extensions/route";
 
-export { BAD_REQUEST, CONNECTION_ERROR, CommonPluginErrors, ERROR_PATTERNS, FORBIDDEN, ModuleFederationError, NOT_FOUND, PluginErrors, PluginIdTag, PluginRuntime, PluginRuntimeError, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED, ValidationError, createPlugin, createPluginRuntime, extractFromFiberFailure, formatORPCError, getNormalizedRemoteName, isRetryableORPCCode, toPluginRuntimeError, withPlugins, wrapORPCError };
+export { BAD_REQUEST, CONNECTION_ERROR, FORBIDDEN, ModuleFederationError, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, PluginErrors, PluginIdTag, PluginRuntime, PluginRuntimeError, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED, ValidationError, buildScoped, buildScopedContext, classifyPluginFailure, createPlugin, createPluginRuntime, createRpcClient, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, remoteName as getNormalizedRemoteName, toPluginRuntimeError, withPlugins, wrapORPCError };

package/dist/plugin.cjs

@@ -1,10 +1,10 @@
 const require_errors = require('./runtime/errors.cjs');
-let _orpc_contract = require("@orpc/contract");
 let effect = require("effect");
 let _orpc_server = require("@orpc/server");
+require("@orpc/experimental-effect/extensions/effect");
 
 //#region src/plugin.ts
-var PluginIdTag = class extends effect.Context.Tag("PluginId")() {};
+var PluginIdTag = class extends effect.Context.Service()("PluginId") {};
 const createPlugin = function createPlugin(config) {
 	const configSchema = {
 		variables: config.variables,
@@ -16,30 +16,16 @@ const createPlugin = function createPlugin(config) {
 		id;
 		contract = config.contract;
 		configSchema = configSchema;
-		_deps = null;
-		initialize(pluginConfig, plugins = {}, tools) {
-			return (config.initialize ?? (() => effect.Effect.succeed({})))(pluginConfig, plugins, tools).pipe(effect.Effect.tap((deps) => effect.Effect.sync(() => {
-				this._deps = deps;
-			})), effect.Effect.map(() => this._deps), effect.Effect.mapError((error) => error));
+		servicesTag = config.servicesTag;
+		warnings = config.warnings;
+		initialize(pluginConfig, plugins = {}) {
+			const init = config.initialize;
+			if (!init) return effect.Effect.succeed(effect.Layer.empty);
+			return init(pluginConfig, plugins).pipe(effect.Effect.mapError((error) => require_errors.toPluginRuntimeError(error, this.id, void 0, "initialize-plugin")));
 		}
-		shutdown() {
-			const self = this;
-			return effect.Effect.gen(function* () {
-				if (config.shutdown && self._deps) yield* config.shutdown(self._deps).pipe(effect.Effect.catchAll((error) => effect.Effect.logWarning(`Plugin shutdown hook failed for ${self.id}`, error)));
-				self._deps = null;
-			});
-		}
-		createRouter(deps) {
-			const base = (0, _orpc_server.implement)(config.contract).$context();
-			const errorMiddleware = (0, _orpc_server.onError)((error) => {
-				const unwrapped = require_errors.extractFromFiberFailure(error);
-				if (unwrapped !== error && unwrapped instanceof _orpc_contract.ORPCError) throw unwrapped;
-				const formatted = require_errors.formatORPCError(error);
-				if (formatted) console.error(formatted);
-				throw error;
-			});
-			const builder = base.use(errorMiddleware);
-			return config.createRouter(deps, builder);
+		createRouter(plugins) {
+			const builder = (0, _orpc_server.implement)(config.contract).$context();
+			return config.createRouter(builder, plugins);
 		}
 	}
 	const PluginConstructor = CreatedPlugin;
@@ -47,7 +33,8 @@ const createPlugin = function createPlugin(config) {
 		contract: config.contract,
 		variables: config.variables,
 		secrets: config.secrets,
-		context: config.context
+		context: config.context,
+		servicesTag: config.servicesTag
 	};
 	return PluginConstructor;
 };

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":["Context","Effect","extractFromFiberFailure","ORPCError","formatORPCError"],"sources":["../src/plugin.ts"],"sourcesContent":["import type { AnyContractRouter, AnySchema, InferSchemaOutput } from \"@orpc/contract\";\nimport { ORPCError } from \"@orpc/contract\";\nimport type { Implementer, Router } from \"@orpc/server\";\nimport { implement, onError } from \"@orpc/server\";\nimport { Context, Effect, type Context as EffectContext, type Layer, type Scope } from \"effect\";\nimport { extractFromFiberFailure, formatORPCError } from \"./runtime/errors\";\n\ntype ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : Record<string, never>;\n\nexport type PluginConfigFor<\n  V extends AnySchema,\n  S extends AnySchema,\n  TRequestContext extends AnySchema | undefined,\n> = {\n  variables: V;\n  secrets: S;\n  context: TRequestContext;\n};\n\ntype PluginInitializeInput<V extends AnySchema, S extends AnySchema> = {\n  variables: InferSchemaOutput<V>;\n  secrets: InferSchemaOutput<S>;\n};\n\n/**\n * Tools provided to plugin initialize/services for building long-lived scoped resources.\n */\ntype ServiceOf<T> = T extends EffectContext.Tag<any, infer S> ? S : never;\n\nexport type PluginServicesTools = {\n  buildService: <T>(tag: T, layer: Layer.Layer<any, any, any>) => Effect.Effect<ServiceOf<T>>;\n};\n\nexport class PluginIdTag extends Context.Tag(\"PluginId\")<PluginIdTag, string>() {}\n\ntype PluginDefinition<\n  V extends AnySchema,\n  S extends AnySchema,\n  TContract extends AnyContractRouter,\n  TRequestContext extends AnySchema | undefined,\n  TDeps extends Record<string, any>,\n  P extends Record<string, unknown>,\n> = {\n  variables: V;\n  secrets: S;\n  contract: TContract;\n  context?: TRequestContext;\n  /**\n   * Initialize the plugin and build dependencies.\n   * A third argument `tools` is provided for building long-lived scoped resources\n   * (e.g. database pools) via `tools.buildService(tag, layer)`.\n   */\n  initialize?: (\n    config: PluginInitializeInput<V, S>,\n    plugins: P,\n    tools: PluginServicesTools,\n  ) => Effect.Effect<TDeps, Error, Scope.Scope>;\n  createRouter: (\n    deps: TDeps,\n    builder: Implementer<TContract, ContextOutput<TRequestContext>, ContextOutput<TRequestContext>>,\n  ) => Router<TContract, any>;\n  shutdown?: (deps: TDeps) => Effect.Effect<void, Error, never>;\n};\n\n/**\n * Loaded plugin with static binding property\n */\nexport interface LoadedPluginWithBinding<\n  TContract extends AnyContractRouter,\n  TVariables extends AnySchema,\n  TSecrets extends AnySchema,\n  TRequestContext extends AnySchema | undefined,\n  TDeps extends Record<string, any> = Record<never, never>,\n> {\n  new (): Plugin<TContract, TVariables, TSecrets, TRequestContext, TDeps>;\n  binding: {\n    contract: TContract;\n    variables: TVariables;\n    secrets: TSecrets;\n    context: TRequestContext;\n  };\n}\n\n/**\n * Plugin interface\n */\nexport interface Plugin<\n  TContract extends AnyContractRouter,\n  TVariables extends AnySchema,\n  TSecrets extends AnySchema,\n  TRequestContext extends AnySchema | undefined,\n  TDeps extends Record<string, any> = Record<never, never>,\n> {\n  readonly id: string;\n  readonly contract: TContract;\n  readonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;\n\n  initialize(\n    config: PluginInitializeInput<TVariables, TSecrets>,\n    plugins: Record<string, unknown>,\n    tools: PluginServicesTools,\n  ): Effect.Effect<TDeps, unknown, Scope.Scope>;\n\n  shutdown(): Effect.Effect<void, never>;\n\n  /**\n   * Creates the strongly-typed oRPC router for this plugin.\n   * The router's procedure types are inferred directly from the contract.\n   * @param deps The initialized plugin dependencies\n   * @returns A router with procedures matching the plugin's contract\n   */\n  createRouter(deps: TDeps): Router<TContract, any>;\n}\n\nexport interface CreatePluginFn {\n  <\n    V extends AnySchema,\n    S extends AnySchema,\n    TContract extends AnyContractRouter,\n    TRequestContext extends AnySchema | undefined = undefined,\n    TDeps extends Record<string, any> = Record<never, never>,\n    P extends Record<string, unknown> = Record<string, never>,\n  >(\n    config: PluginDefinition<V, S, TContract, TRequestContext, TDeps, P>,\n  ): LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;\n\n  withPlugins: <P extends Record<string, unknown>>() => CreatePluginWithPlugins<P>;\n}\n\nexport const createPlugin: CreatePluginFn = function createPlugin<\n  V extends AnySchema,\n  S extends AnySchema,\n  TContract extends AnyContractRouter,\n  TRequestContext extends AnySchema | undefined = undefined,\n  TDeps extends Record<string, any> = Record<never, never>,\n  P extends Record<string, unknown> = Record<string, never>,\n>(config: PluginDefinition<V, S, TContract, TRequestContext, TDeps, P>) {\n  const configSchema: PluginConfigFor<V, S, TRequestContext> = {\n    variables: config.variables,\n    secrets: config.secrets,\n    context: config.context as TRequestContext,\n  };\n\n  class CreatedPlugin implements Plugin<TContract, V, S, TRequestContext, TDeps> {\n    /** set during instantiation - registry key */\n    id!: string;\n    readonly contract = config.contract;\n    readonly configSchema = configSchema;\n\n    private _deps: TDeps | null = null;\n\n    initialize(\n      pluginConfig: PluginInitializeInput<V, S>,\n      plugins: Record<string, unknown> = {},\n      tools: PluginServicesTools,\n    ): Effect.Effect<TDeps, unknown, Scope.Scope> {\n      const init = config.initialize ?? (() => Effect.succeed({} as TDeps));\n\n      return init(pluginConfig, plugins as P, tools).pipe(\n        Effect.tap((deps) =>\n          Effect.sync(() => {\n            this._deps = deps;\n          }),\n        ),\n        Effect.map(() => this._deps as TDeps),\n        Effect.mapError((error) => error as unknown),\n      );\n    }\n\n    shutdown(): Effect.Effect<void, never> {\n      const self = this;\n      return Effect.gen(function* () {\n        if (config.shutdown && self._deps) {\n          yield* config\n            .shutdown(self._deps)\n            .pipe(\n              Effect.catchAll((error) =>\n                Effect.logWarning(`Plugin shutdown hook failed for ${self.id}`, error),\n              ),\n            );\n        }\n        self._deps = null;\n      });\n    }\n\n    createRouter(deps: TDeps): Router<TContract, any> {\n      const base = implement(config.contract).$context<ContextOutput<TRequestContext>>();\n      const errorMiddleware = onError((error: unknown) => {\n        const unwrapped = extractFromFiberFailure(error);\n\n        if (unwrapped !== error && unwrapped instanceof ORPCError) {\n          throw unwrapped;\n        }\n\n        const formatted = formatORPCError(error);\n        if (formatted) console.error(formatted);\n        throw error;\n      }) as any;\n\n      const builder = (base as any).use(errorMiddleware);\n      const router = config.createRouter(deps, builder as any);\n      return router as Router<TContract, any>;\n    }\n  }\n\n  const PluginConstructor = CreatedPlugin as unknown as {\n    new (): Plugin<TContract, V, S, TRequestContext, TDeps>;\n    binding: {\n      contract: TContract;\n      variables: V;\n      secrets: S;\n      context: TRequestContext;\n    };\n  };\n\n  PluginConstructor.binding = {\n    contract: config.contract,\n    variables: config.variables,\n    secrets: config.secrets,\n    context: config.context as TRequestContext,\n  };\n\n  return PluginConstructor as LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;\n};\n\nexport type CreatePluginWithPlugins<P extends Record<string, unknown>> = <\n  V extends AnySchema,\n  S extends AnySchema,\n  TContract extends AnyContractRouter,\n  TRequestContext extends AnySchema | undefined = undefined,\n  TDeps extends Record<string, any> = Record<never, never>,\n>(\n  config: PluginDefinition<V, S, TContract, TRequestContext, TDeps, P>,\n) => LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;\n\nexport function withPlugins<P extends Record<string, unknown>>(): CreatePluginWithPlugins<P> {\n  return <\n    V extends AnySchema,\n    S extends AnySchema,\n    TContract extends AnyContractRouter,\n    TRequestContext extends AnySchema | undefined = undefined,\n    TDeps extends Record<string, any> = Record<never, never>,\n  >(\n    config: PluginDefinition<V, S, TContract, TRequestContext, TDeps, P>,\n  ) => createPlugin<V, S, TContract, TRequestContext, TDeps, P>(config as any);\n}\n\ncreatePlugin.withPlugins = withPlugins;\n"],"mappings":";;;;;;AAiCA,IAAa,cAAb,cAAiCA,eAAQ,IAAI,UAAU,CAAC,CAAsB,CAAC,CAAC,CAAC;AAgGjF,MAAa,eAA+B,SAAS,aAOnD,QAAsE;CACtE,MAAM,eAAuD;EAC3D,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;CAClB;CAEA,MAAM,cAAyE;;EAE7E;EACA,AAAS,WAAW,OAAO;EAC3B,AAAS,eAAe;EAExB,AAAQ,QAAsB;EAE9B,WACE,cACA,UAAmC,CAAC,GACpC,OAC4C;GAG5C,QAFa,OAAO,qBAAqBC,cAAO,QAAQ,CAAC,CAAU,GAExD,CAAC,cAAc,SAAc,KAAK,CAAC,CAAC,KAC7CA,cAAO,KAAK,SACVA,cAAO,WAAW;IAChB,KAAK,QAAQ;GACf,CAAC,CACH,GACAA,cAAO,UAAU,KAAK,KAAc,GACpCA,cAAO,UAAU,UAAU,KAAgB,CAC7C;EACF;EAEA,WAAuC;GACrC,MAAM,OAAO;GACb,OAAOA,cAAO,IAAI,aAAa;IAC7B,IAAI,OAAO,YAAY,KAAK,OAC1B,OAAO,OACJ,SAAS,KAAK,KAAK,CAAC,CACpB,KACCA,cAAO,UAAU,UACfA,cAAO,WAAW,mCAAmC,KAAK,MAAM,KAAK,CACvE,CACF;IAEJ,KAAK,QAAQ;GACf,CAAC;EACH;EAEA,aAAa,MAAqC;GAChD,MAAM,mCAAiB,OAAO,QAAQ,CAAC,CAAC,SAAyC;GACjF,MAAM,6CAA2B,UAAmB;IAClD,MAAM,YAAYC,uCAAwB,KAAK;IAE/C,IAAI,cAAc,SAAS,qBAAqBC,0BAC9C,MAAM;IAGR,MAAM,YAAYC,+BAAgB,KAAK;IACvC,IAAI,WAAW,QAAQ,MAAM,SAAS;IACtC,MAAM;GACR,CAAC;GAED,MAAM,UAAW,KAAa,IAAI,eAAe;GAEjD,OADe,OAAO,aAAa,MAAM,OAC7B;EACd;CACF;CAEA,MAAM,oBAAoB;CAU1B,kBAAkB,UAAU;EAC1B,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;CAClB;CAEA,OAAO;AACT;AAYA,SAAgB,cAA6E;CAC3F,QAOE,WACG,aAAyD,MAAa;AAC7E;AAEA,aAAa,cAAc"}
+{"version":3,"file":"plugin.cjs","names":["Context","Effect","Layer","toPluginRuntimeError","implement"],"sources":["../src/plugin.ts"],"sourcesContent":["import type { AnyContractRouter, AnySchema, InferSchemaOutput } from \"@orpc/contract\";\nimport type { WithEffectContext } from \"@orpc/experimental-effect\";\nimport \"@orpc/experimental-effect/extensions/effect\";\nimport type { ContractedRouter, Implementer } from \"@orpc/server\";\nimport { implement } from \"@orpc/server\";\nimport type { Scope } from \"effect\";\nimport { Context, Effect, Layer } from \"effect\";\nimport type { PluginWarningInfo } from \"./runtime/errors\";\nimport { type PluginRuntimeError, toPluginRuntimeError } from \"./runtime/errors\";\n\ntype ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : Record<string, never>;\n\nexport type PluginConfigFor<\n  V extends AnySchema,\n  S extends AnySchema,\n  TRequestContext extends AnySchema | undefined,\n> = {\n  variables: V;\n  secrets: S;\n  context: TRequestContext;\n};\n\nexport type PluginInitializeInput<V extends AnySchema, S extends AnySchema> = {\n  /**\n   * The framework-assigned plugin id — the same key the host uses for secret\n   * injection and per-plugin database namespacing. Arrives as a value so\n   * plugin code never needs the ambient `PluginIdTag`.\n   */\n  pluginId: string;\n  variables: InferSchemaOutput<V>;\n  secrets: InferSchemaOutput<S>;\n};\n\n/**\n * A plugin's own config-derived warnings, evaluated once with the validated\n * config after initialization. Declaring `warnings` opts the plugin out of\n * the loader's default missing-secret warning — these messages replace it.\n */\nexport type PluginWarningsFn<V extends AnySchema, S extends AnySchema> = (\n  config: PluginInitializeInput<V, S>,\n) => PluginWarningInfo[] | string[];\n\nexport class PluginIdTag extends Context.Service<PluginIdTag, string>()(\"PluginId\") {}\n\n/**\n * The `initialize` effect's environment: the plugin lifecycle scope plus the\n * framework-assigned plugin id.\n */\nexport type PluginEnv = Scope.Scope | PluginIdTag;\n\ntype PluginDefinition<\n  V extends AnySchema,\n  S extends AnySchema,\n  TContract extends AnyContractRouter,\n  TRequestContext extends AnySchema | undefined,\n  P extends Record<string, unknown>,\n> = {\n  variables: V;\n  secrets: S;\n  contract: TContract;\n  context?: TRequestContext;\n  /**\n   * Optional tag under which `initialize` exposes the plugin's services.\n   * The host uses it to read services (e.g. the auth plugin's Better Auth\n   * handler) from the built Effect context without importing the plugin\n   * module statically.\n   */\n  servicesTag?: Context.Key<any, any>;\n  /**\n   * Optional warnings function evaluated once with the validated config after\n   * initialization. Returns structured non-fatal warnings (e.g. an optional\n   * secret was not set, so the feature depending on it is disabled).\n   * Declaring it opts out of the loader's default missing-secret warning.\n   */\n  warnings?: PluginWarningsFn<V, S>;\n  /**\n   * Initialize the plugin by returning an Effect `Layer`.\n   *\n   * The runtime builds the Layer against the plugin's lifecycle scope —\n   * scoped resources (db pools, repositories, caches, publishers) release\n   * when the plugin shuts down. Services are provided to `.effect()`\n   * handlers via the oRPC context (`yield* Tag`).\n   */\n  initialize?: (\n    config: PluginInitializeInput<V, S>,\n    plugins: P,\n  ) => Effect.Effect<Layer.Layer<any, Error, PluginEnv>, Error, PluginEnv>;\n  /**\n   * Creates the strongly-typed oRPC router for this plugin.\n   * Services come from the Effect context — access them with\n   * `yield* Tag` in `.effect()` handlers, or\n   * `Context.get(context[\"effect/context\"], Tag)` in plain handlers.\n   * Sibling plugin entries in `plugins` carry `{ client, router }`.\n   */\n  createRouter: (\n    builder: Implementer<TContract, ContextOutput<TRequestContext> & WithEffectContext<any>>,\n    plugins: P,\n  ) => ContractedRouter<TContract, any>;\n};\n\n/**\n * Loaded plugin with static binding property\n */\nexport interface LoadedPluginWithBinding<\n  TContract extends AnyContractRouter,\n  TVariables extends AnySchema,\n  TSecrets extends AnySchema,\n  TRequestContext extends AnySchema | undefined,\n> {\n  new (): Plugin<TContract, TVariables, TSecrets, TRequestContext>;\n  binding: {\n    contract: TContract;\n    variables: TVariables;\n    secrets: TSecrets;\n    context: TRequestContext;\n    servicesTag?: Context.Key<any, any>;\n  };\n}\n\n/**\n * Plugin interface\n */\nexport interface Plugin<\n  TContract extends AnyContractRouter,\n  TVariables extends AnySchema,\n  TSecrets extends AnySchema,\n  TRequestContext extends AnySchema | undefined,\n> {\n  readonly id: string;\n  readonly contract: TContract;\n  readonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;\n  readonly servicesTag?: Context.Key<any, any>;\n  readonly warnings?: PluginWarningsFn<TVariables, TSecrets>;\n\n  initialize(\n    config: PluginInitializeInput<TVariables, TSecrets>,\n    plugins: Record<string, unknown>,\n  ): Effect.Effect<Layer.Layer<any, Error, PluginEnv>, PluginRuntimeError, PluginEnv>;\n\n  /**\n   * Creates the strongly-typed oRPC router for this plugin.\n   * The router's procedure types are inferred directly from the contract.\n   * @param plugins Sibling plugin entries (`{ client, router }`) for\n   * cross-plugin composition\n   * @returns A router with procedures matching the plugin's contract\n   */\n  createRouter(plugins: Record<string, unknown>): ContractedRouter<TContract, any>;\n}\n\nexport interface CreatePluginFn {\n  <\n    V extends AnySchema,\n    S extends AnySchema,\n    TContract extends AnyContractRouter,\n    TRequestContext extends AnySchema | undefined = undefined,\n    P extends Record<string, unknown> = Record<string, never>,\n  >(\n    config: PluginDefinition<V, S, TContract, TRequestContext, P>,\n  ): LoadedPluginWithBinding<TContract, V, S, TRequestContext>;\n\n  withPlugins: <P extends Record<string, unknown>>() => CreatePluginWithPlugins<P>;\n}\n\nexport const createPlugin: CreatePluginFn = function createPlugin<\n  V extends AnySchema,\n  S extends AnySchema,\n  TContract extends AnyContractRouter,\n  TRequestContext extends AnySchema | undefined = undefined,\n  P extends Record<string, unknown> = Record<string, never>,\n>(config: PluginDefinition<V, S, TContract, TRequestContext, P>) {\n  const configSchema: PluginConfigFor<V, S, TRequestContext> = {\n    variables: config.variables,\n    secrets: config.secrets,\n    context: config.context as TRequestContext,\n  };\n\n  class CreatedPlugin implements Plugin<TContract, V, S, TRequestContext> {\n    /** set during instantiation - registry key */\n    id!: string;\n    readonly contract = config.contract;\n    readonly configSchema = configSchema;\n    readonly servicesTag = config.servicesTag;\n    readonly warnings = config.warnings;\n\n    initialize(\n      pluginConfig: PluginInitializeInput<V, S>,\n      plugins: Record<string, unknown> = {},\n    ): Effect.Effect<Layer.Layer<any, Error, PluginEnv>, PluginRuntimeError, PluginEnv> {\n      const init = config.initialize;\n      if (!init) {\n        return Effect.succeed(Layer.empty as unknown as Layer.Layer<any, Error, PluginEnv>);\n      }\n\n      return init(pluginConfig, plugins as P).pipe(\n        Effect.mapError((error) =>\n          toPluginRuntimeError(error, this.id, undefined, \"initialize-plugin\"),\n        ),\n      );\n    }\n\n    createRouter(plugins: Record<string, unknown>): ContractedRouter<TContract, any> {\n      const builder = implement(config.contract).$context<\n        ContextOutput<TRequestContext> & WithEffectContext<any>\n      >();\n      return config.createRouter(builder as any, plugins as P) as ContractedRouter<TContract, any>;\n    }\n  }\n\n  const PluginConstructor = CreatedPlugin as unknown as {\n    new (): Plugin<TContract, V, S, TRequestContext>;\n    binding: {\n      contract: TContract;\n      variables: V;\n      secrets: S;\n      context: TRequestContext;\n      servicesTag?: Context.Key<any, any>;\n    };\n  };\n\n  PluginConstructor.binding = {\n    contract: config.contract,\n    variables: config.variables,\n    secrets: config.secrets,\n    context: config.context as TRequestContext,\n    servicesTag: config.servicesTag,\n  };\n\n  return PluginConstructor as LoadedPluginWithBinding<TContract, V, S, TRequestContext>;\n};\n\nexport type CreatePluginWithPlugins<P extends Record<string, unknown>> = <\n  V extends AnySchema,\n  S extends AnySchema,\n  TContract extends AnyContractRouter,\n  TRequestContext extends AnySchema | undefined = undefined,\n>(\n  config: PluginDefinition<V, S, TContract, TRequestContext, P>,\n) => LoadedPluginWithBinding<TContract, V, S, TRequestContext>;\n\nexport function withPlugins<P extends Record<string, unknown>>(): CreatePluginWithPlugins<P> {\n  return <\n    V extends AnySchema,\n    S extends AnySchema,\n    TContract extends AnyContractRouter,\n    TRequestContext extends AnySchema | undefined = undefined,\n  >(\n    config: PluginDefinition<V, S, TContract, TRequestContext, P>,\n  ) => createPlugin<V, S, TContract, TRequestContext, P>(config as any);\n}\n\ncreatePlugin.withPlugins = withPlugins;\n"],"mappings":";;;;;;AA0CA,IAAa,cAAb,cAAiCA,eAAQ,QAA6B,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAyHrF,MAAa,eAA+B,SAAS,aAMnD,QAA+D;CAC/D,MAAM,eAAuD;EAC3D,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;CAClB;CAEA,MAAM,cAAkE;;EAEtE;EACA,AAAS,WAAW,OAAO;EAC3B,AAAS,eAAe;EACxB,AAAS,cAAc,OAAO;EAC9B,AAAS,WAAW,OAAO;EAE3B,WACE,cACA,UAAmC,CAAC,GAC8C;GAClF,MAAM,OAAO,OAAO;GACpB,IAAI,CAAC,MACH,OAAOC,cAAO,QAAQC,aAAM,KAAsD;GAGpF,OAAO,KAAK,cAAc,OAAY,CAAC,CAAC,KACtCD,cAAO,UAAU,UACfE,oCAAqB,OAAO,KAAK,IAAI,QAAW,mBAAmB,CACrE,CACF;EACF;EAEA,aAAa,SAAoE;GAC/E,MAAM,cAAUC,wBAAU,OAAO,QAAQ,CAAC,CAAC,SAEzC;GACF,OAAO,OAAO,aAAa,SAAgB,OAAY;EACzD;CACF;CAEA,MAAM,oBAAoB;CAW1B,kBAAkB,UAAU;EAC1B,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,aAAa,OAAO;CACtB;CAEA,OAAO;AACT;AAWA,SAAgB,cAA6E;CAC3F,QAME,WACG,aAAkD,MAAa;AACtE;AAEA,aAAa,cAAc"}

package/dist/plugin.d.cts

@@ -1,6 +1,9 @@
-import { Context, Effect, Layer, Scope } from "effect";
+import { PluginRuntimeError, PluginWarningInfo } from "./runtime/errors.cjs";
 import { AnyContractRouter, AnySchema, InferSchemaOutput } from "@orpc/contract";
-import { Implementer, Router } from "@orpc/server";
+import { ContractedRouter, Implementer } from "@orpc/server";
+import { Context, Effect, Layer, Scope } from "effect";
+import { WithEffectContext } from "@orpc/experimental-effect";
+import "@orpc/experimental-effect/extensions/effect";
 //#region src/plugin.d.ts
 type ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : Record<string, never>;
 type PluginConfigFor<V extends AnySchema, S extends AnySchema, TRequestContext extends AnySchema | undefined> = {
@@ -9,68 +12,104 @@ type PluginConfigFor<V extends AnySchema, S extends AnySchema, TRequestContext e
   context: TRequestContext;
 };
 type PluginInitializeInput<V extends AnySchema, S extends AnySchema> = {
+  /**
+   * The framework-assigned plugin id — the same key the host uses for secret
+   * injection and per-plugin database namespacing. Arrives as a value so
+   * plugin code never needs the ambient `PluginIdTag`.
+   */
+  pluginId: string;
   variables: InferSchemaOutput<V>;
   secrets: InferSchemaOutput<S>;
 };
 /**
- * Tools provided to plugin initialize/services for building long-lived scoped resources.
+ * A plugin's own config-derived warnings, evaluated once with the validated
+ * config after initialization. Declaring `warnings` opts the plugin out of
+ * the loader's default missing-secret warning — these messages replace it.
  */
-type ServiceOf<T> = T extends Context.Tag<any, infer S> ? S : never;
-type PluginServicesTools = {
-  buildService: <T>(tag: T, layer: Layer.Layer<any, any, any>) => Effect.Effect<ServiceOf<T>>;
-};
-declare const PluginIdTag_base: Context.TagClass<PluginIdTag, "PluginId", string>;
+type PluginWarningsFn<V extends AnySchema, S extends AnySchema> = (config: PluginInitializeInput<V, S>) => PluginWarningInfo[] | string[];
+declare const PluginIdTag_base: Context.ServiceClass<PluginIdTag, "PluginId", string>;
 declare class PluginIdTag extends PluginIdTag_base {}
-type PluginDefinition<V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined, TDeps extends Record<string, any>, P extends Record<string, unknown>> = {
+/**
+ * The `initialize` effect's environment: the plugin lifecycle scope plus the
+ * framework-assigned plugin id.
+ */
+type PluginEnv = Scope.Scope | PluginIdTag;
+type PluginDefinition<V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined, P extends Record<string, unknown>> = {
   variables: V;
   secrets: S;
   contract: TContract;
   context?: TRequestContext;
   /**
-   * Initialize the plugin and build dependencies.
-   * A third argument `tools` is provided for building long-lived scoped resources
-   * (e.g. database pools) via `tools.buildService(tag, layer)`.
+   * Optional tag under which `initialize` exposes the plugin's services.
+   * The host uses it to read services (e.g. the auth plugin's Better Auth
+   * handler) from the built Effect context without importing the plugin
+   * module statically.
+   */
+  servicesTag?: Context.Key<any, any>;
+  /**
+   * Optional warnings function evaluated once with the validated config after
+   * initialization. Returns structured non-fatal warnings (e.g. an optional
+   * secret was not set, so the feature depending on it is disabled).
+   * Declaring it opts out of the loader's default missing-secret warning.
+   */
+  warnings?: PluginWarningsFn<V, S>;
+  /**
+   * Initialize the plugin by returning an Effect `Layer`.
+   *
+   * The runtime builds the Layer against the plugin's lifecycle scope —
+   * scoped resources (db pools, repositories, caches, publishers) release
+   * when the plugin shuts down. Services are provided to `.effect()`
+   * handlers via the oRPC context (`yield* Tag`).
+   */
+  initialize?: (config: PluginInitializeInput<V, S>, plugins: P) => Effect.Effect<Layer.Layer<any, Error, PluginEnv>, Error, PluginEnv>;
+  /**
+   * Creates the strongly-typed oRPC router for this plugin.
+   * Services come from the Effect context — access them with
+   * `yield* Tag` in `.effect()` handlers, or
+   * `Context.get(context["effect/context"], Tag)` in plain handlers.
+   * Sibling plugin entries in `plugins` carry `{ client, router }`.
    */
-  initialize?: (config: PluginInitializeInput<V, S>, plugins: P, tools: PluginServicesTools) => Effect.Effect<TDeps, Error, Scope.Scope>;
-  createRouter: (deps: TDeps, builder: Implementer<TContract, ContextOutput<TRequestContext>, ContextOutput<TRequestContext>>) => Router<TContract, any>;
-  shutdown?: (deps: TDeps) => Effect.Effect<void, Error, never>;
+  createRouter: (builder: Implementer<TContract, ContextOutput<TRequestContext> & WithEffectContext<any>>, plugins: P) => ContractedRouter<TContract, any>;
 };
 /**
  * Loaded plugin with static binding property
  */
-interface LoadedPluginWithBinding<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined, TDeps extends Record<string, any> = Record<never, never>> {
-  new (): Plugin<TContract, TVariables, TSecrets, TRequestContext, TDeps>;
+interface LoadedPluginWithBinding<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined> {
+  new (): Plugin<TContract, TVariables, TSecrets, TRequestContext>;
   binding: {
     contract: TContract;
     variables: TVariables;
     secrets: TSecrets;
     context: TRequestContext;
+    servicesTag?: Context.Key<any, any>;
   };
 }
 /**
  * Plugin interface
  */
-interface Plugin<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined, TDeps extends Record<string, any> = Record<never, never>> {
+interface Plugin<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined> {
   readonly id: string;
   readonly contract: TContract;
   readonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;
-  initialize(config: PluginInitializeInput<TVariables, TSecrets>, plugins: Record<string, unknown>, tools: PluginServicesTools): Effect.Effect<TDeps, unknown, Scope.Scope>;
-  shutdown(): Effect.Effect<void, never>;
+  readonly servicesTag?: Context.Key<any, any>;
+  readonly warnings?: PluginWarningsFn<TVariables, TSecrets>;
+  initialize(config: PluginInitializeInput<TVariables, TSecrets>, plugins: Record<string, unknown>): Effect.Effect<Layer.Layer<any, Error, PluginEnv>, PluginRuntimeError, PluginEnv>;
   /**
    * Creates the strongly-typed oRPC router for this plugin.
    * The router's procedure types are inferred directly from the contract.
-   * @param deps The initialized plugin dependencies
+   * @param plugins Sibling plugin entries (`{ client, router }`) for
+   * cross-plugin composition
    * @returns A router with procedures matching the plugin's contract
    */
-  createRouter(deps: TDeps): Router<TContract, any>;
+  createRouter(plugins: Record<string, unknown>): ContractedRouter<TContract, any>;
 }
 interface CreatePluginFn {
-  <V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined = undefined, TDeps extends Record<string, any> = Record<never, never>, P extends Record<string, unknown> = Record<string, never>>(config: PluginDefinition<V, S, TContract, TRequestContext, TDeps, P>): LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;
+  <V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined = undefined, P extends Record<string, unknown> = Record<string, never>>(config: PluginDefinition<V, S, TContract, TRequestContext, P>): LoadedPluginWithBinding<TContract, V, S, TRequestContext>;
   withPlugins: <P extends Record<string, unknown>>() => CreatePluginWithPlugins<P>;
 }
 declare const createPlugin: CreatePluginFn;
-type CreatePluginWithPlugins<P extends Record<string, unknown>> = <V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined = undefined, TDeps extends Record<string, any> = Record<never, never>>(config: PluginDefinition<V, S, TContract, TRequestContext, TDeps, P>) => LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;
+type CreatePluginWithPlugins<P extends Record<string, unknown>> = <V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined = undefined>(config: PluginDefinition<V, S, TContract, TRequestContext, P>) => LoadedPluginWithBinding<TContract, V, S, TRequestContext>;
 declare function withPlugins<P extends Record<string, unknown>>(): CreatePluginWithPlugins<P>;
 //#endregion
-export { CreatePluginFn, CreatePluginWithPlugins, LoadedPluginWithBinding, Plugin, PluginConfigFor, PluginIdTag, PluginServicesTools, createPlugin, withPlugins };
+export { CreatePluginFn, CreatePluginWithPlugins, LoadedPluginWithBinding, Plugin, PluginConfigFor, PluginEnv, PluginIdTag, PluginInitializeInput, PluginWarningsFn, createPlugin, withPlugins };
 //# sourceMappingURL=plugin.d.cts.map

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;KAOK,cAAc,KAAK,UAAU,YAAY,kBAAkB,KAAK;KAEzD,gBACV,UAAU,WACV,UAAU,WACV,wBAAwB;EAExB,WAAW;EACX,SAAS;EACT,SAAS;;KAGN,sBAAsB,UAAU,WAAW,UAAU;EACxD,WAAW,kBAAkB;EAC7B,SAAS,kBAAkB;;;;;KAMxB,UAAU,KAAK,UAAU,QAAc,eAAe,KAAK;KAEpD;EACV,eAAe,GAAG,KAAK,GAAG,OAAO,MAAM,yBAAyB,OAAO,OAAO,UAAU;;;cAG7E,oBAAoB;KAE5B,iBACH,UAAU,WACV,UAAU,WACV,kBAAkB,mBAClB,wBAAwB,uBACxB,cAAc,qBACd,UAAU;EAEV,WAAW;EACX,SAAS;EACT,UAAU;EACV,UAAU;;;;;;EAMV,cACE,QAAQ,sBAAsB,GAAG,IACjC,SAAS,GACT,OAAO,wBACJ,OAAO,OAAO,OAAO,OAAO,MAAM;EACvC,eACE,MAAM,OACN,SAAS,YAAY,WAAW,cAAc,kBAAkB,cAAc,sBAC3E,OAAO;EACZ,YAAY,MAAM,UAAU,OAAO,aAAa;;;;;UAMjC,wBACf,kBAAkB,mBAClB,mBAAmB,WACnB,iBAAiB,WACjB,wBAAwB,uBACxB,cAAc,sBAAsB;UAE5B,OAAO,WAAW,YAAY,UAAU,iBAAiB;EACjE;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;;;;;;UAOI,OACf,kBAAkB,mBAClB,mBAAmB,WACnB,iBAAiB,WACjB,wBAAwB,uBACxB,cAAc,sBAAsB;WAE3B;WACA,UAAU;WACV,cAAc,gBAAgB,YAAY,UAAU;EAE7D,WACE,QAAQ,sBAAsB,YAAY,WAC1C,SAAS,yBACT,OAAO,sBACN,OAAO,OAAO,gBAAgB,MAAM;EAEvC,YAAY,OAAO;;;;;;;EAQnB,aAAa,MAAM,QAAQ,OAAO;;UAGnB;GAEb,UAAU,WACV,UAAU,WACV,kBAAkB,mBAClB,wBAAwB,mCACxB,cAAc,sBAAsB,sBACpC,UAAU,0BAA0B,uBAEpC,QAAQ,iBAAiB,GAAG,GAAG,WAAW,iBAAiB,OAAO,KACjE,wBAAwB,WAAW,GAAG,GAAG,iBAAiB;EAE7D,cAAc,UAAU,8BAA8B,wBAAwB;;cAGnE,cAAc;KAgGf,wBAAwB,UAAU,4BAC5C,UAAU,WACV,UAAU,WACV,kBAAkB,mBAClB,wBAAwB,mCACxB,cAAc,sBAAsB,sBAEpC,QAAQ,iBAAiB,GAAG,GAAG,WAAW,iBAAiB,OAAO,OAC/D,wBAAwB,WAAW,GAAG,GAAG,iBAAiB;iBAE/C,YAAY,UAAU,4BAA4B,wBAAwB"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;;;;KAUK,cAAc,KAAK,UAAU,YAAY,kBAAkB,KAAK;KAEzD,gBACV,UAAU,WACV,UAAU,WACV,wBAAwB;EAExB,WAAW;EACX,SAAS;EACT,SAAS;;KAGC,sBAAsB,UAAU,WAAW,UAAU;;;;;;EAM/D;EACA,WAAW,kBAAkB;EAC7B,SAAS,kBAAkB;;;;;;;KAQjB,iBAAiB,UAAU,WAAW,UAAU,cAC1D,QAAQ,sBAAsB,GAAG,OAC9B;;cAEQ,oBAAoB;;;;;KAMrB,YAAY,MAAM,QAAQ;KAEjC,iBACH,UAAU,WACV,UAAU,WACV,kBAAkB,mBAClB,wBAAwB,uBACxB,UAAU;EAEV,WAAW;EACX,SAAS;EACT,UAAU;EACV,UAAU;;;;;;;EAOV,cAAc,QAAQ;;;;;;;EAOtB,WAAW,iBAAiB,GAAG;;;;;;;;;EAS/B,cACE,QAAQ,sBAAsB,GAAG,IACjC,SAAS,MACN,OAAO,OAAO,MAAM,WAAW,OAAO,YAAY,OAAO;;;;;;;;EAQ9D,eACE,SAAS,YAAY,WAAW,cAAc,mBAAmB,yBACjE,SAAS,MACN,iBAAiB;;;;;UAMP,wBACf,kBAAkB,mBAClB,mBAAmB,WACnB,iBAAiB,WACjB,wBAAwB;UAEhB,OAAO,WAAW,YAAY,UAAU;EAChD;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;IACT,cAAc,QAAQ;;;;;;UAOT,OACf,kBAAkB,mBAClB,mBAAmB,WACnB,iBAAiB,WACjB,wBAAwB;WAEf;WACA,UAAU;WACV,cAAc,gBAAgB,YAAY,UAAU;WACpD,cAAc,QAAQ;WACtB,WAAW,iBAAiB,YAAY;EAEjD,WACE,QAAQ,sBAAsB,YAAY,WAC1C,SAAS,0BACR,OAAO,OAAO,MAAM,WAAW,OAAO,YAAY,oBAAoB;;;;;;;;EASzE,aAAa,SAAS,0BAA0B,iBAAiB;;UAGlD;GAEb,UAAU,WACV,UAAU,WACV,kBAAkB,mBAClB,wBAAwB,mCACxB,UAAU,0BAA0B,uBAEpC,QAAQ,iBAAiB,GAAG,GAAG,WAAW,iBAAiB,KAC1D,wBAAwB,WAAW,GAAG,GAAG;EAE5C,cAAc,UAAU,8BAA8B,wBAAwB;;cAGnE,cAAc;KAmEf,wBAAwB,UAAU,4BAC5C,UAAU,WACV,UAAU,WACV,kBAAkB,mBAClB,wBAAwB,mCAExB,QAAQ,iBAAiB,GAAG,GAAG,WAAW,iBAAiB,OACxD,wBAAwB,WAAW,GAAG,GAAG;iBAE9B,YAAY,UAAU,4BAA4B,wBAAwB"}