every-plugin 0.8.2 → 0.8.3

package/dist/plugin.cjs

@@ -1,6 +1,7 @@
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
-let __orpc_server = require("@orpc/server");
+const require_errors = require('./runtime/errors.cjs');
 let effect = require("effect");
+let __orpc_server = require("@orpc/server");
 
 //#region src/plugin.ts
 /**
@@ -30,7 +31,10 @@ function createPlugin(config) {
 			});
 		}
 		createRouter(deps) {
-			const builder = (0, __orpc_server.implement)(config.contract).$context();
+			const base = __orpc_server.os.$context().use((0, __orpc_server.onError)((error) => {
+				require_errors.formatORPCError(error);
+			}));
+			const builder = (0, __orpc_server.implement)(config.contract, base);
 			return config.createRouter(deps, builder);
 		}
 	}

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs","names":["configSchema: PluginConfigFor<V, S, TRequestContext>","Effect"],"sources":["../src/plugin.ts"],"sourcesContent":["import type { AnyContractRouter, AnySchema, InferSchemaOutput } from \"@orpc/contract\";\nimport type { Context, Implementer, Router } from \"@orpc/server\";\nimport { implement } from \"@orpc/server\";\nimport { Effect, type Scope } from \"effect\";\n\ntype ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : {};\n\n/**\n * Helper type that correctly constructs the config schema type\n */\nexport type PluginConfigFor<V extends AnySchema, S extends AnySchema, TRequestContext extends AnySchema | undefined> = {\n\tvariables: V;\n\tsecrets: S;\n\tcontext: TRequestContext;\n};\n\n/**\n * Loaded plugin with static binding property\n */\nexport interface LoadedPluginWithBinding<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\tnew(): Plugin<TContract, TVariables, TSecrets, TRequestContext, TDeps>;\n\tbinding: {\n\t\tcontract: TContract;\n\t\tvariables: TVariables;\n\t\tsecrets: TSecrets;\n\t\tcontext: TRequestContext;\n\t};\n}\n\n/**\n * Plugin interface\n */\nexport interface Plugin<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\treadonly id: string;\n\treadonly contract: TContract;\n\treadonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;\n\n\t// Plugin lifecycle\n\tinitialize(\n\t\tconfig: { variables: InferSchemaOutput<TVariables>; secrets: InferSchemaOutput<TSecrets> }\n\t): Effect.Effect<TDeps, unknown, Scope.Scope>;\n\n\tshutdown(): Effect.Effect<void, never>;\n\n\t/**\n\t * Creates the strongly-typed oRPC router for this plugin.\n\t * The router's procedure types are inferred directly from the contract.\n\t * @param deps The initialized plugin dependencies\n\t * @returns A router with procedures matching the plugin's contract\n\t */\n\tcreateRouter(deps: TDeps): Router<TContract, any>;\n}\n\n/**\n * Factory function to create plugins\n */\nexport function createPlugin<\n\tV extends AnySchema,\n\tS extends AnySchema,\n\tTContract extends AnyContractRouter,\n\tTRequestContext extends AnySchema | undefined = undefined,\n\tTDeps extends Context = Record<never, never>\n>(config: {\n\tvariables: V;\n\tsecrets: S;\n\tcontract: TContract;\n\tcontext?: TRequestContext;\n\tinitialize?: (\n\t\tconfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t) => Effect.Effect<TDeps, Error, Scope.Scope>;\n\tcreateRouter: (\n\t\tdeps: TDeps,\n\t\tbuilder: Implementer<TContract, ContextOutput<TRequestContext>, ContextOutput<TRequestContext>>\n\t) => Router<TContract, any>;\n\tshutdown?: (deps: TDeps) => Effect.Effect<void, Error, never>;\n}) {\n\tconst configSchema: PluginConfigFor<V, S, TRequestContext> = {\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\tclass CreatedPlugin implements Plugin<TContract, V, S, TRequestContext, TDeps> {\n\t\t/** set during instantiation - registry key */\n\t\tid!: string;\n\t\treadonly contract = config.contract;\n\t\treadonly configSchema = configSchema;\n\n\t\tprivate _deps: TDeps | null = null;\n\n\t\tinitialize(\n\t\t\tpluginConfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t\t): Effect.Effect<TDeps, unknown, Scope.Scope> {\n\t\t\tconst init = config.initialize ?? (() => Effect.succeed({} as TDeps));\n\n\t\t\treturn init(pluginConfig).pipe(\n\t\t\t\tEffect.tap((deps) => Effect.sync(() => { this._deps = deps; })),\n\t\t\t\tEffect.map(() => this._deps as TDeps),\n\t\t\t\tEffect.mapError((error) => error as unknown)\n\t\t\t);\n\t\t}\n\n\t\tshutdown(): Effect.Effect<void, never> {\n\t\t\tconst self = this;\n\t\t\treturn Effect.gen(function* () {\n\t\t\t\tif (config.shutdown && self._deps) {\n\t\t\t\t\tyield* config.shutdown(self._deps).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}\n\n\t\tcreateRouter(deps: TDeps): Router<TContract, any> {\n\t\t\tconst builder = implement(config.contract).$context<ContextOutput<TRequestContext>>();\n\t\t\tconst router = config.createRouter(deps, builder);\n\t\t\treturn router as Router<TContract, any>;\n\t\t}\n\t}\n\n\tconst PluginConstructor = CreatedPlugin as unknown as {\n\t\tnew(): Plugin<TContract, V, S, TRequestContext, TDeps>;\n\t\tbinding: {\n\t\t\tcontract: TContract;\n\t\t\tvariables: V;\n\t\t\tsecrets: S;\n\t\t\tcontext: TRequestContext;\n\t\t};\n\t};\n\n\tPluginConstructor.binding = {\n\t\tcontract: config.contract,\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\treturn PluginConstructor as LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;\n}\n"],"mappings":";;;;;;;;AAoEA,SAAgB,aAMd,QAaC;CACF,MAAMA,eAAuD;EAC5D,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;CAED,MAAM,cAAyE;;EAE9E;EACA,AAAS,WAAW,OAAO;EAC3B,AAAS,eAAe;EAExB,AAAQ,QAAsB;EAE9B,WACC,cAC6C;AAG7C,WAFa,OAAO,qBAAqBC,cAAO,QAAQ,EAAE,CAAU,GAExD,aAAa,CAAC,KACzBA,cAAO,KAAK,SAASA,cAAO,WAAW;AAAE,SAAK,QAAQ;KAAQ,CAAC,EAC/DA,cAAO,UAAU,KAAK,MAAe,EACrCA,cAAO,UAAU,UAAU,MAAiB,CAC5C;;EAGF,WAAuC;GACtC,MAAM,OAAO;AACb,UAAOA,cAAO,IAAI,aAAa;AAC9B,QAAI,OAAO,YAAY,KAAK,MAC3B,QAAO,OAAO,SAAS,KAAK,MAAM,CAAC,KAClCA,cAAO,eAAeA,cAAO,KAAK,CAClC;KAED;;EAGH,aAAa,MAAqC;GACjD,MAAM,uCAAoB,OAAO,SAAS,CAAC,UAA0C;AAErF,UADe,OAAO,aAAa,MAAM,QAAQ;;;CAKnD,MAAM,oBAAoB;AAU1B,mBAAkB,UAAU;EAC3B,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;AAED,QAAO"}
+{"version":3,"file":"plugin.cjs","names":["configSchema: PluginConfigFor<V, S, TRequestContext>","Effect","os"],"sources":["../src/plugin.ts"],"sourcesContent":["import type { AnyContractRouter, AnySchema, InferSchemaOutput } from \"@orpc/contract\";\nimport type { Context, Implementer, Router } from \"@orpc/server\";\nimport { implement, onError, os } from \"@orpc/server\";\nimport { Effect, type Scope } from \"effect\";\nimport { formatORPCError } from \"./runtime/errors\";\n\ntype ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : {};\n\n/**\n * Helper type that correctly constructs the config schema type\n */\nexport type PluginConfigFor<V extends AnySchema, S extends AnySchema, TRequestContext extends AnySchema | undefined> = {\n\tvariables: V;\n\tsecrets: S;\n\tcontext: TRequestContext;\n};\n\n/**\n * Loaded plugin with static binding property\n */\nexport interface LoadedPluginWithBinding<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\tnew(): Plugin<TContract, TVariables, TSecrets, TRequestContext, TDeps>;\n\tbinding: {\n\t\tcontract: TContract;\n\t\tvariables: TVariables;\n\t\tsecrets: TSecrets;\n\t\tcontext: TRequestContext;\n\t};\n}\n\n/**\n * Plugin interface\n */\nexport interface Plugin<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\treadonly id: string;\n\treadonly contract: TContract;\n\treadonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;\n\n\t// Plugin lifecycle\n\tinitialize(\n\t\tconfig: { variables: InferSchemaOutput<TVariables>; secrets: InferSchemaOutput<TSecrets> }\n\t): Effect.Effect<TDeps, unknown, Scope.Scope>;\n\n\tshutdown(): Effect.Effect<void, never>;\n\n\t/**\n\t * Creates the strongly-typed oRPC router for this plugin.\n\t * The router's procedure types are inferred directly from the contract.\n\t * @param deps The initialized plugin dependencies\n\t * @returns A router with procedures matching the plugin's contract\n\t */\n\tcreateRouter(deps: TDeps): Router<TContract, any>;\n}\n\n/**\n * Factory function to create plugins\n */\nexport function createPlugin<\n\tV extends AnySchema,\n\tS extends AnySchema,\n\tTContract extends AnyContractRouter,\n\tTRequestContext extends AnySchema | undefined = undefined,\n\tTDeps extends Context = Record<never, never>\n>(config: {\n\tvariables: V;\n\tsecrets: S;\n\tcontract: TContract;\n\tcontext?: TRequestContext;\n\tinitialize?: (\n\t\tconfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t) => Effect.Effect<TDeps, Error, Scope.Scope>;\n\tcreateRouter: (\n\t\tdeps: TDeps,\n\t\tbuilder: Implementer<TContract, ContextOutput<TRequestContext>, ContextOutput<TRequestContext>>\n\t) => Router<TContract, any>;\n\tshutdown?: (deps: TDeps) => Effect.Effect<void, Error, never>;\n}) {\n\tconst configSchema: PluginConfigFor<V, S, TRequestContext> = {\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\tclass CreatedPlugin implements Plugin<TContract, V, S, TRequestContext, TDeps> {\n\t\t/** set during instantiation - registry key */\n\t\tid!: string;\n\t\treadonly contract = config.contract;\n\t\treadonly configSchema = configSchema;\n\n\t\tprivate _deps: TDeps | null = null;\n\n\t\tinitialize(\n\t\t\tpluginConfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t\t): Effect.Effect<TDeps, unknown, Scope.Scope> {\n\t\t\tconst init = config.initialize ?? (() => Effect.succeed({} as TDeps));\n\n\t\t\treturn init(pluginConfig).pipe(\n\t\t\t\tEffect.tap((deps) => Effect.sync(() => { this._deps = deps; })),\n\t\t\t\tEffect.map(() => this._deps as TDeps),\n\t\t\t\tEffect.mapError((error) => error as unknown)\n\t\t\t);\n\t\t}\n\n\t\tshutdown(): Effect.Effect<void, never> {\n\t\t\tconst self = this;\n\t\t\treturn Effect.gen(function* () {\n\t\t\t\tif (config.shutdown && self._deps) {\n\t\t\t\t\tyield* config.shutdown(self._deps).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}\n\n\t\tcreateRouter(deps: TDeps): Router<TContract, any> {\n\t\t\tconst base = os\n\t\t\t\t.$context<ContextOutput<TRequestContext>>()\n\t\t\t\t.use(onError((error) => {\n\t\t\t\t\tformatORPCError(error);\n\t\t\t\t}));\n\t\t\tconst builder = implement(config.contract, base);\n\t\t\tconst router = config.createRouter(deps, builder);\n\t\t\treturn router as Router<TContract, any>;\n\t\t}\n\t}\n\n\tconst PluginConstructor = CreatedPlugin as unknown as {\n\t\tnew(): Plugin<TContract, V, S, TRequestContext, TDeps>;\n\t\tbinding: {\n\t\t\tcontract: TContract;\n\t\t\tvariables: V;\n\t\t\tsecrets: S;\n\t\t\tcontext: TRequestContext;\n\t\t};\n\t};\n\n\tPluginConstructor.binding = {\n\t\tcontract: config.contract,\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\treturn PluginConstructor as LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;\n}\n"],"mappings":";;;;;;;;;AAqEA,SAAgB,aAMd,QAaC;CACF,MAAMA,eAAuD;EAC5D,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;CAED,MAAM,cAAyE;;EAE9E;EACA,AAAS,WAAW,OAAO;EAC3B,AAAS,eAAe;EAExB,AAAQ,QAAsB;EAE9B,WACC,cAC6C;AAG7C,WAFa,OAAO,qBAAqBC,cAAO,QAAQ,EAAE,CAAU,GAExD,aAAa,CAAC,KACzBA,cAAO,KAAK,SAASA,cAAO,WAAW;AAAE,SAAK,QAAQ;KAAQ,CAAC,EAC/DA,cAAO,UAAU,KAAK,MAAe,EACrCA,cAAO,UAAU,UAAU,MAAiB,CAC5C;;EAGF,WAAuC;GACtC,MAAM,OAAO;AACb,UAAOA,cAAO,IAAI,aAAa;AAC9B,QAAI,OAAO,YAAY,KAAK,MAC3B,QAAO,OAAO,SAAS,KAAK,MAAM,CAAC,KAClCA,cAAO,eAAeA,cAAO,KAAK,CAClC;KAED;;EAGH,aAAa,MAAqC;GACjD,MAAM,OAAOC,iBACX,UAA0C,CAC1C,gCAAa,UAAU;AACvB,mCAAgB,MAAM;KACrB,CAAC;GACJ,MAAM,uCAAoB,OAAO,UAAU,KAAK;AAEhD,UADe,OAAO,aAAa,MAAM,QAAQ;;;CAKnD,MAAM,oBAAoB;AAU1B,mBAAkB,UAAU;EAC3B,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;AAED,QAAO"}

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/plugin.d.mts

@@ -1,6 +1,6 @@
-import { Context, Implementer, Router } from "@orpc/server";
-import { Effect, Scope } from "effect";
 import { AnyContractRouter, AnySchema, InferSchemaOutput } from "@orpc/contract";
+import { Effect, Scope } from "effect";
+import { Context as Context$1, Implementer, Router } from "@orpc/server";
 
 //#region src/plugin.d.ts
 type ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : {};
@@ -15,7 +15,7 @@ type PluginConfigFor<V extends AnySchema, S extends AnySchema, TRequestContext e
 /**
  * Loaded plugin with static binding property
  */
-interface LoadedPluginWithBinding<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined, TDeps extends Context = Record<never, never>> {
+interface LoadedPluginWithBinding<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined, TDeps extends Context$1 = Record<never, never>> {
   new (): Plugin<TContract, TVariables, TSecrets, TRequestContext, TDeps>;
   binding: {
     contract: TContract;
@@ -27,7 +27,7 @@ interface LoadedPluginWithBinding<TContract extends AnyContractRouter, TVariable
 /**
  * Plugin interface
  */
-interface Plugin<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined, TDeps extends Context = Record<never, never>> {
+interface Plugin<TContract extends AnyContractRouter, TVariables extends AnySchema, TSecrets extends AnySchema, TRequestContext extends AnySchema | undefined, TDeps extends Context$1 = Record<never, never>> {
   readonly id: string;
   readonly contract: TContract;
   readonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;
@@ -47,7 +47,7 @@ interface Plugin<TContract extends AnyContractRouter, TVariables extends AnySche
 /**
  * Factory function to create plugins
  */
-declare function createPlugin<V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined = undefined, TDeps extends Context = Record<never, never>>(config: {
+declare function createPlugin<V extends AnySchema, S extends AnySchema, TContract extends AnyContractRouter, TRequestContext extends AnySchema | undefined = undefined, TDeps extends Context$1 = Record<never, never>>(config: {
   variables: V;
   secrets: S;
   contract: TContract;

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/plugin.mjs

@@ -1,5 +1,6 @@
-import { implement } from "@orpc/server";
+import { formatORPCError } from "./runtime/errors.mjs";
 import { Effect } from "effect";
+import { implement, onError, os } from "@orpc/server";
 
 //#region src/plugin.ts
 /**
@@ -29,7 +30,10 @@ function createPlugin(config) {
 			});
 		}
 		createRouter(deps) {
-			const builder = implement(config.contract).$context();
+			const base = os.$context().use(onError((error) => {
+				formatORPCError(error);
+			}));
+			const builder = implement(config.contract, base);
 			return config.createRouter(deps, builder);
 		}
 	}

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["configSchema: PluginConfigFor<V, S, TRequestContext>"],"sources":["../src/plugin.ts"],"sourcesContent":["import type { AnyContractRouter, AnySchema, InferSchemaOutput } from \"@orpc/contract\";\nimport type { Context, Implementer, Router } from \"@orpc/server\";\nimport { implement } from \"@orpc/server\";\nimport { Effect, type Scope } from \"effect\";\n\ntype ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : {};\n\n/**\n * Helper type that correctly constructs the config schema type\n */\nexport type PluginConfigFor<V extends AnySchema, S extends AnySchema, TRequestContext extends AnySchema | undefined> = {\n\tvariables: V;\n\tsecrets: S;\n\tcontext: TRequestContext;\n};\n\n/**\n * Loaded plugin with static binding property\n */\nexport interface LoadedPluginWithBinding<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\tnew(): Plugin<TContract, TVariables, TSecrets, TRequestContext, TDeps>;\n\tbinding: {\n\t\tcontract: TContract;\n\t\tvariables: TVariables;\n\t\tsecrets: TSecrets;\n\t\tcontext: TRequestContext;\n\t};\n}\n\n/**\n * Plugin interface\n */\nexport interface Plugin<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\treadonly id: string;\n\treadonly contract: TContract;\n\treadonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;\n\n\t// Plugin lifecycle\n\tinitialize(\n\t\tconfig: { variables: InferSchemaOutput<TVariables>; secrets: InferSchemaOutput<TSecrets> }\n\t): Effect.Effect<TDeps, unknown, Scope.Scope>;\n\n\tshutdown(): Effect.Effect<void, never>;\n\n\t/**\n\t * Creates the strongly-typed oRPC router for this plugin.\n\t * The router's procedure types are inferred directly from the contract.\n\t * @param deps The initialized plugin dependencies\n\t * @returns A router with procedures matching the plugin's contract\n\t */\n\tcreateRouter(deps: TDeps): Router<TContract, any>;\n}\n\n/**\n * Factory function to create plugins\n */\nexport function createPlugin<\n\tV extends AnySchema,\n\tS extends AnySchema,\n\tTContract extends AnyContractRouter,\n\tTRequestContext extends AnySchema | undefined = undefined,\n\tTDeps extends Context = Record<never, never>\n>(config: {\n\tvariables: V;\n\tsecrets: S;\n\tcontract: TContract;\n\tcontext?: TRequestContext;\n\tinitialize?: (\n\t\tconfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t) => Effect.Effect<TDeps, Error, Scope.Scope>;\n\tcreateRouter: (\n\t\tdeps: TDeps,\n\t\tbuilder: Implementer<TContract, ContextOutput<TRequestContext>, ContextOutput<TRequestContext>>\n\t) => Router<TContract, any>;\n\tshutdown?: (deps: TDeps) => Effect.Effect<void, Error, never>;\n}) {\n\tconst configSchema: PluginConfigFor<V, S, TRequestContext> = {\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\tclass CreatedPlugin implements Plugin<TContract, V, S, TRequestContext, TDeps> {\n\t\t/** set during instantiation - registry key */\n\t\tid!: string;\n\t\treadonly contract = config.contract;\n\t\treadonly configSchema = configSchema;\n\n\t\tprivate _deps: TDeps | null = null;\n\n\t\tinitialize(\n\t\t\tpluginConfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t\t): Effect.Effect<TDeps, unknown, Scope.Scope> {\n\t\t\tconst init = config.initialize ?? (() => Effect.succeed({} as TDeps));\n\n\t\t\treturn init(pluginConfig).pipe(\n\t\t\t\tEffect.tap((deps) => Effect.sync(() => { this._deps = deps; })),\n\t\t\t\tEffect.map(() => this._deps as TDeps),\n\t\t\t\tEffect.mapError((error) => error as unknown)\n\t\t\t);\n\t\t}\n\n\t\tshutdown(): Effect.Effect<void, never> {\n\t\t\tconst self = this;\n\t\t\treturn Effect.gen(function* () {\n\t\t\t\tif (config.shutdown && self._deps) {\n\t\t\t\t\tyield* config.shutdown(self._deps).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}\n\n\t\tcreateRouter(deps: TDeps): Router<TContract, any> {\n\t\t\tconst builder = implement(config.contract).$context<ContextOutput<TRequestContext>>();\n\t\t\tconst router = config.createRouter(deps, builder);\n\t\t\treturn router as Router<TContract, any>;\n\t\t}\n\t}\n\n\tconst PluginConstructor = CreatedPlugin as unknown as {\n\t\tnew(): Plugin<TContract, V, S, TRequestContext, TDeps>;\n\t\tbinding: {\n\t\t\tcontract: TContract;\n\t\t\tvariables: V;\n\t\t\tsecrets: S;\n\t\t\tcontext: TRequestContext;\n\t\t};\n\t};\n\n\tPluginConstructor.binding = {\n\t\tcontract: config.contract,\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\treturn PluginConstructor as LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;\n}\n"],"mappings":";;;;;;;AAoEA,SAAgB,aAMd,QAaC;CACF,MAAMA,eAAuD;EAC5D,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;CAED,MAAM,cAAyE;;EAE9E;EACA,AAAS,WAAW,OAAO;EAC3B,AAAS,eAAe;EAExB,AAAQ,QAAsB;EAE9B,WACC,cAC6C;AAG7C,WAFa,OAAO,qBAAqB,OAAO,QAAQ,EAAE,CAAU,GAExD,aAAa,CAAC,KACzB,OAAO,KAAK,SAAS,OAAO,WAAW;AAAE,SAAK,QAAQ;KAAQ,CAAC,EAC/D,OAAO,UAAU,KAAK,MAAe,EACrC,OAAO,UAAU,UAAU,MAAiB,CAC5C;;EAGF,WAAuC;GACtC,MAAM,OAAO;AACb,UAAO,OAAO,IAAI,aAAa;AAC9B,QAAI,OAAO,YAAY,KAAK,MAC3B,QAAO,OAAO,SAAS,KAAK,MAAM,CAAC,KAClC,OAAO,eAAe,OAAO,KAAK,CAClC;KAED;;EAGH,aAAa,MAAqC;GACjD,MAAM,UAAU,UAAU,OAAO,SAAS,CAAC,UAA0C;AAErF,UADe,OAAO,aAAa,MAAM,QAAQ;;;CAKnD,MAAM,oBAAoB;AAU1B,mBAAkB,UAAU;EAC3B,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;AAED,QAAO"}
+{"version":3,"file":"plugin.mjs","names":["configSchema: PluginConfigFor<V, S, TRequestContext>"],"sources":["../src/plugin.ts"],"sourcesContent":["import type { AnyContractRouter, AnySchema, InferSchemaOutput } from \"@orpc/contract\";\nimport type { Context, Implementer, Router } from \"@orpc/server\";\nimport { implement, onError, os } from \"@orpc/server\";\nimport { Effect, type Scope } from \"effect\";\nimport { formatORPCError } from \"./runtime/errors\";\n\ntype ContextOutput<T> = T extends AnySchema ? InferSchemaOutput<T> : {};\n\n/**\n * Helper type that correctly constructs the config schema type\n */\nexport type PluginConfigFor<V extends AnySchema, S extends AnySchema, TRequestContext extends AnySchema | undefined> = {\n\tvariables: V;\n\tsecrets: S;\n\tcontext: TRequestContext;\n};\n\n/**\n * Loaded plugin with static binding property\n */\nexport interface LoadedPluginWithBinding<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\tnew(): Plugin<TContract, TVariables, TSecrets, TRequestContext, TDeps>;\n\tbinding: {\n\t\tcontract: TContract;\n\t\tvariables: TVariables;\n\t\tsecrets: TSecrets;\n\t\tcontext: TRequestContext;\n\t};\n}\n\n/**\n * Plugin interface\n */\nexport interface Plugin<\n\tTContract extends AnyContractRouter,\n\tTVariables extends AnySchema,\n\tTSecrets extends AnySchema,\n\tTRequestContext extends AnySchema | undefined,\n\tTDeps extends Context = Record<never, never>\n> {\n\treadonly id: string;\n\treadonly contract: TContract;\n\treadonly configSchema: PluginConfigFor<TVariables, TSecrets, TRequestContext>;\n\n\t// Plugin lifecycle\n\tinitialize(\n\t\tconfig: { variables: InferSchemaOutput<TVariables>; secrets: InferSchemaOutput<TSecrets> }\n\t): Effect.Effect<TDeps, unknown, Scope.Scope>;\n\n\tshutdown(): Effect.Effect<void, never>;\n\n\t/**\n\t * Creates the strongly-typed oRPC router for this plugin.\n\t * The router's procedure types are inferred directly from the contract.\n\t * @param deps The initialized plugin dependencies\n\t * @returns A router with procedures matching the plugin's contract\n\t */\n\tcreateRouter(deps: TDeps): Router<TContract, any>;\n}\n\n/**\n * Factory function to create plugins\n */\nexport function createPlugin<\n\tV extends AnySchema,\n\tS extends AnySchema,\n\tTContract extends AnyContractRouter,\n\tTRequestContext extends AnySchema | undefined = undefined,\n\tTDeps extends Context = Record<never, never>\n>(config: {\n\tvariables: V;\n\tsecrets: S;\n\tcontract: TContract;\n\tcontext?: TRequestContext;\n\tinitialize?: (\n\t\tconfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t) => Effect.Effect<TDeps, Error, Scope.Scope>;\n\tcreateRouter: (\n\t\tdeps: TDeps,\n\t\tbuilder: Implementer<TContract, ContextOutput<TRequestContext>, ContextOutput<TRequestContext>>\n\t) => Router<TContract, any>;\n\tshutdown?: (deps: TDeps) => Effect.Effect<void, Error, never>;\n}) {\n\tconst configSchema: PluginConfigFor<V, S, TRequestContext> = {\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\tclass CreatedPlugin implements Plugin<TContract, V, S, TRequestContext, TDeps> {\n\t\t/** set during instantiation - registry key */\n\t\tid!: string;\n\t\treadonly contract = config.contract;\n\t\treadonly configSchema = configSchema;\n\n\t\tprivate _deps: TDeps | null = null;\n\n\t\tinitialize(\n\t\t\tpluginConfig: { variables: InferSchemaOutput<V>; secrets: InferSchemaOutput<S> }\n\t\t): Effect.Effect<TDeps, unknown, Scope.Scope> {\n\t\t\tconst init = config.initialize ?? (() => Effect.succeed({} as TDeps));\n\n\t\t\treturn init(pluginConfig).pipe(\n\t\t\t\tEffect.tap((deps) => Effect.sync(() => { this._deps = deps; })),\n\t\t\t\tEffect.map(() => this._deps as TDeps),\n\t\t\t\tEffect.mapError((error) => error as unknown)\n\t\t\t);\n\t\t}\n\n\t\tshutdown(): Effect.Effect<void, never> {\n\t\t\tconst self = this;\n\t\t\treturn Effect.gen(function* () {\n\t\t\t\tif (config.shutdown && self._deps) {\n\t\t\t\t\tyield* config.shutdown(self._deps).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}\n\n\t\tcreateRouter(deps: TDeps): Router<TContract, any> {\n\t\t\tconst base = os\n\t\t\t\t.$context<ContextOutput<TRequestContext>>()\n\t\t\t\t.use(onError((error) => {\n\t\t\t\t\tformatORPCError(error);\n\t\t\t\t}));\n\t\t\tconst builder = implement(config.contract, base);\n\t\t\tconst router = config.createRouter(deps, builder);\n\t\t\treturn router as Router<TContract, any>;\n\t\t}\n\t}\n\n\tconst PluginConstructor = CreatedPlugin as unknown as {\n\t\tnew(): Plugin<TContract, V, S, TRequestContext, TDeps>;\n\t\tbinding: {\n\t\t\tcontract: TContract;\n\t\t\tvariables: V;\n\t\t\tsecrets: S;\n\t\t\tcontext: TRequestContext;\n\t\t};\n\t};\n\n\tPluginConstructor.binding = {\n\t\tcontract: config.contract,\n\t\tvariables: config.variables,\n\t\tsecrets: config.secrets,\n\t\tcontext: config.context as TRequestContext\n\t};\n\n\treturn PluginConstructor as LoadedPluginWithBinding<TContract, V, S, TRequestContext, TDeps>;\n}\n"],"mappings":";;;;;;;;AAqEA,SAAgB,aAMd,QAaC;CACF,MAAMA,eAAuD;EAC5D,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;CAED,MAAM,cAAyE;;EAE9E;EACA,AAAS,WAAW,OAAO;EAC3B,AAAS,eAAe;EAExB,AAAQ,QAAsB;EAE9B,WACC,cAC6C;AAG7C,WAFa,OAAO,qBAAqB,OAAO,QAAQ,EAAE,CAAU,GAExD,aAAa,CAAC,KACzB,OAAO,KAAK,SAAS,OAAO,WAAW;AAAE,SAAK,QAAQ;KAAQ,CAAC,EAC/D,OAAO,UAAU,KAAK,MAAe,EACrC,OAAO,UAAU,UAAU,MAAiB,CAC5C;;EAGF,WAAuC;GACtC,MAAM,OAAO;AACb,UAAO,OAAO,IAAI,aAAa;AAC9B,QAAI,OAAO,YAAY,KAAK,MAC3B,QAAO,OAAO,SAAS,KAAK,MAAM,CAAC,KAClC,OAAO,eAAe,OAAO,KAAK,CAClC;KAED;;EAGH,aAAa,MAAqC;GACjD,MAAM,OAAO,GACX,UAA0C,CAC1C,IAAI,SAAS,UAAU;AACvB,oBAAgB,MAAM;KACrB,CAAC;GACJ,MAAM,UAAU,UAAU,OAAO,UAAU,KAAK;AAEhD,UADe,OAAO,aAAa,MAAM,QAAQ;;;CAKnD,MAAM,oBAAoB;AAU1B,mBAAkB,UAAU;EAC3B,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB;AAED,QAAO"}

package/dist/runtime/errors.cjs

@@ -1,6 +1,6 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-let effect = require("effect");
 let __orpc_contract = require("@orpc/contract");
+let effect = require("effect");
 
 //#region src/runtime/errors.ts
 var PluginRuntimeError = class extends effect.Data.TaggedError("PluginRuntimeError") {};
@@ -16,6 +16,95 @@ const extractErrorMessage = (error) => {
 	if (typeof error === "object" && "message" in error) return String(error.message);
 	return String(error);
 };
+const formatValidationIssue = (issue, index, maxDisplay) => {
+	if (index >= maxDisplay) return "";
+	const path = Array.isArray(issue.path) && issue.path.length > 0 ? issue.path.join(".") : issue.path || "root";
+	const message = issue.message || "Validation failed";
+	return `│    ${index + 1}. ${path}: ${message}`;
+};
+const formatDataPreview = (data, maxLength = 100) => {
+	if (!data) return "undefined";
+	try {
+		const str = JSON.stringify(data);
+		if (str.length <= maxLength) return str;
+		if (typeof data === "object" && data !== null) {
+			if (Array.isArray(data)) return `Array(${data.length}) [...]`;
+			const keys = Object.keys(data);
+			return `{ ${keys.slice(0, 3).join(", ")}${keys.length > 3 ? ", ..." : ""} }`;
+		}
+		return str.slice(0, maxLength) + "...";
+	} catch {
+		return String(data).slice(0, maxLength);
+	}
+};
+const formatORPCValidationError = (error) => {
+	const cause = error?.cause || error;
+	if (!cause?.issues || !Array.isArray(cause.issues) || cause.issues.length === 0) return null;
+	const lines = [];
+	const errorType = error?.message || cause?.message || "Validation failed";
+	lines.push(`\n╭─ oRPC Validation Error ${"─".repeat(30)}`);
+	lines.push(`│  ${errorType}`);
+	lines.push(`│`);
+	const maxDisplay = 10;
+	const totalIssues = cause.issues.length;
+	lines.push(`│  Issues (${totalIssues}):`);
+	cause.issues.slice(0, maxDisplay).forEach((issue, idx) => {
+		const formatted = formatValidationIssue(issue, idx, maxDisplay);
+		if (formatted) lines.push(formatted);
+	});
+	if (totalIssues > maxDisplay) lines.push(`│    ... and ${totalIssues - maxDisplay} more`);
+	if (cause.data !== void 0) {
+		lines.push(`│`);
+		lines.push(`│  Data preview: ${formatDataPreview(cause.data, 80)}`);
+	}
+	lines.push(`╰${"─".repeat(50)}\n`);
+	return lines;
+};
+const formatORPCError = (error) => {
+	if (!(error instanceof __orpc_contract.ORPCError)) return;
+	const validationLines = formatORPCValidationError(error);
+	if (validationLines) {
+		console.error(validationLines.join("\n"));
+		return;
+	}
+	const lines = [];
+	const code = error.code || "UNKNOWN";
+	const status = error.status || 500;
+	const message = error.message || "An error occurred";
+	lines.push(`\n╭─ oRPC Error ${"─".repeat(40)}`);
+	lines.push(`│  ${message}`);
+	lines.push(`│  Code: ${code} (${status})`);
+	lines.push(`│`);
+	if (error.data) {
+		if (typeof error.data === "object" && error.data !== null) {
+			if ("retryAfter" in error.data) lines.push(`│  Retry after: ${error.data.retryAfter} seconds`);
+			if ("remainingRequests" in error.data) lines.push(`│  Remaining: ${error.data.remainingRequests} requests`);
+			if ("host" in error.data) lines.push(`│  Host: ${error.data.host}`);
+			if ("port" in error.data) lines.push(`│  Port: ${error.data.port}`);
+			if ("suggestion" in error.data) lines.push(`│  → ${error.data.suggestion}`);
+			if ("resource" in error.data) lines.push(`│  Resource: ${error.data.resource}`);
+			if ("resourceId" in error.data) lines.push(`│  ID: ${error.data.resourceId}`);
+		}
+	}
+	switch (code) {
+		case "UNAUTHORIZED":
+			lines.push(`│  → Check your API key or credentials`);
+			break;
+		case "TOO_MANY_REQUESTS":
+			lines.push(`│  → Wait before retrying`);
+			break;
+		case "SERVICE_UNAVAILABLE":
+		case "BAD_GATEWAY":
+		case "GATEWAY_TIMEOUT":
+			lines.push(`│  → The service may be temporarily unavailable`);
+			break;
+		case "TIMEOUT":
+			lines.push(`│  → The operation took too long`);
+			break;
+	}
+	lines.push(`╰${"─".repeat(50)}\n`);
+	console.error(lines.join("\n"));
+};
 const formatPluginError = (pluginId, operation, message) => {
 	const lines = [];
 	lines.push(`\n╭─ Plugin Error ${"─".repeat(40)}`);
@@ -67,6 +156,8 @@ const isRetryableORPCCode = (code) => {
 	}
 };
 const wrapORPCError = (orpcError, pluginId, procedureName, operation) => {
+	const validationLines = formatORPCValidationError(orpcError);
+	if (validationLines) console.error(validationLines.join("\n"));
 	return new PluginRuntimeError({
 		pluginId,
 		operation,
@@ -78,14 +169,15 @@ const wrapORPCError = (orpcError, pluginId, procedureName, operation) => {
 const toPluginRuntimeError = (error, pluginId, procedureName, operation, defaultRetryable = false) => {
 	if (error instanceof __orpc_contract.ORPCError) return wrapORPCError(error, pluginId, procedureName, operation);
 	if (error instanceof PluginRuntimeError) return error;
-	const message = extractErrorMessage(error);
-	formatPluginError(pluginId, operation, message);
+	const validationLines = formatORPCValidationError(error);
+	if (validationLines) console.error(validationLines.join("\n"));
+	else formatPluginError(pluginId, operation, extractErrorMessage(error));
 	return new PluginRuntimeError({
 		pluginId,
 		operation,
 		procedureName,
-		retryable: defaultRetryable || isRetryableError(message),
-		cause: error instanceof Error ? error : new Error(message)
+		retryable: defaultRetryable || isRetryableError(extractErrorMessage(error)),
+		cause: error instanceof Error ? error : new Error(extractErrorMessage(error))
 	});
 };
 
@@ -93,5 +185,8 @@ const toPluginRuntimeError = (error, pluginId, procedureName, operation, default
 exports.ModuleFederationError = ModuleFederationError;
 exports.PluginRuntimeError = PluginRuntimeError;
 exports.ValidationError = ValidationError;
+exports.formatORPCError = formatORPCError;
+exports.isRetryableORPCCode = isRetryableORPCCode;
 exports.toPluginRuntimeError = toPluginRuntimeError;
+exports.wrapORPCError = wrapORPCError;
 //# sourceMappingURL=errors.cjs.map

package/dist/runtime/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","names":["Data","lines: string[]","ORPCError"],"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\nconst extractErrorMessage = (error: unknown): string => {\n\tif (!error) return 'Unknown error';\n\n\tif (error instanceof Error) {\n\t\tif (error.message) return error.message;\n\t\tif ((error as any).cause instanceof Error) {\n\t\t\treturn extractErrorMessage((error as any).cause);\n\t\t}\n\t}\n\n\tif (error instanceof AggregateError && error.errors?.length) {\n\t\treturn error.errors.map(e => extractErrorMessage(e)).join('; ');\n\t}\n\n\tif (typeof error === 'object' && 'message' in error) {\n\t\treturn String((error as any).message);\n\t}\n\n\treturn String(error);\n};\n\nconst formatPluginError = (\n\tpluginId: string | undefined,\n\toperation: string | undefined,\n\tmessage: string\n): void => {\n\tconst lines: string[] = [];\n\n\tlines.push(`\\n╭─ Plugin Error ${'─'.repeat(40)}`);\n\tif (pluginId) lines.push(`│  Plugin: ${pluginId}`);\n\tif (operation) lines.push(`│  During: ${operation}`);\n\tlines.push(`│`);\n\n\tif (message.includes('ECONNREFUSED')) {\n\t\tlines.push(`│  ❌ Connection refused`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  A required service is not running.`);\n\t\tlines.push(`│  → Run: docker compose up -d`);\n\t} else if (message.includes('ENOTFOUND')) {\n\t\tlines.push(`│  ❌ Host not found`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your connection URL or network settings.`);\n\t} else if (message.includes('ETIMEDOUT') || message.includes('timeout')) {\n\t\tlines.push(`│  ❌ Connection timeout`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  The service took too long to respond.`);\n\t} else if (message.includes('EACCES') || message.includes('permission')) {\n\t\tlines.push(`│  ❌ Permission denied`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check credentials or access permissions.`);\n\t} else if (message.includes('401') || message.includes('unauthorized')) {\n\t\tlines.push(`│  ❌ Authentication failed`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your API key or credentials.`);\n\t} else {\n\t\tlines.push(`│  ❌ ${message}`);\n\t}\n\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\n\tconsole.error(lines.join('\\n'));\n};\n\nconst isRetryableError = (message: string): boolean => {\n\tconst retryablePatterns = ['ETIMEDOUT', 'ECONNRESET', 'timeout', '503', '429'];\n\treturn retryablePatterns.some(p => message.toLowerCase().includes(p.toLowerCase()));\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;\n\t}\n\n\tconst message = extractErrorMessage(error);\n\n\tformatPluginError(pluginId, operation, message);\n\n\treturn new PluginRuntimeError({\n\t\tpluginId,\n\t\toperation,\n\t\tprocedureName,\n\t\tretryable: defaultRetryable || isRetryableError(message),\n\t\tcause: error instanceof Error ? error : new Error(message)\n\t});\n};\n"],"mappings":"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"}
+{"version":3,"file":"errors.cjs","names":["Data","lines: string[]","ORPCError"],"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\nconst extractErrorMessage = (error: unknown): string => {\n\tif (!error) return 'Unknown error';\n\n\tif (error instanceof Error) {\n\t\tif (error.message) return error.message;\n\t\tif ((error as any).cause instanceof Error) {\n\t\t\treturn extractErrorMessage((error as any).cause);\n\t\t}\n\t}\n\n\tif (error instanceof AggregateError && error.errors?.length) {\n\t\treturn error.errors.map(e => extractErrorMessage(e)).join('; ');\n\t}\n\n\tif (typeof error === 'object' && 'message' in error) {\n\t\treturn String((error as any).message);\n\t}\n\n\treturn String(error);\n};\n\nconst formatValidationIssue = (issue: any, index: number, maxDisplay: number): string => {\n\tif (index >= maxDisplay) return '';\n\t\n\tconst path = Array.isArray(issue.path) && issue.path.length > 0\n\t\t? issue.path.join('.')\n\t\t: issue.path || 'root';\n\t\n\tconst message = issue.message || 'Validation failed';\n\t\n\treturn `│    ${index + 1}. ${path}: ${message}`;\n};\n\nconst formatDataPreview = (data: unknown, maxLength = 100): string => {\n\tif (!data) return 'undefined';\n\t\n\ttry {\n\t\tconst str = JSON.stringify(data);\n\t\tif (str.length <= maxLength) return str;\n\t\t\n\t\tif (typeof data === 'object' && data !== null) {\n\t\t\tif (Array.isArray(data)) {\n\t\t\t\treturn `Array(${data.length}) [...]`;\n\t\t\t}\n\t\t\tconst keys = Object.keys(data);\n\t\t\treturn `{ ${keys.slice(0, 3).join(', ')}${keys.length > 3 ? ', ...' : ''} }`;\n\t\t}\n\t\t\n\t\treturn str.slice(0, maxLength) + '...';\n\t} catch {\n\t\treturn String(data).slice(0, maxLength);\n\t}\n};\n\nconst formatORPCValidationError = (error: any): string[] | null => {\n\tconst cause = error?.cause || error;\n\t\n\tif (!cause?.issues || !Array.isArray(cause.issues) || cause.issues.length === 0) {\n\t\treturn null;\n\t}\n\n\tconst lines: string[] = [];\n\tconst errorType = error?.message || cause?.message || 'Validation failed';\n\t\n\tlines.push(`\\n╭─ oRPC Validation Error ${'─'.repeat(30)}`);\n\tlines.push(`│  ${errorType}`);\n\tlines.push(`│`);\n\t\n\tconst maxDisplay = 10;\n\tconst totalIssues = cause.issues.length;\n\t\n\tlines.push(`│  Issues (${totalIssues}):`);\n\t\n\tconst displayedIssues = cause.issues.slice(0, maxDisplay);\n\tdisplayedIssues.forEach((issue: any, idx: number) => {\n\t\tconst formatted = formatValidationIssue(issue, idx, maxDisplay);\n\t\tif (formatted) lines.push(formatted);\n\t});\n\t\n\tif (totalIssues > maxDisplay) {\n\t\tlines.push(`│    ... and ${totalIssues - maxDisplay} more`);\n\t}\n\t\n\tif (cause.data !== undefined) {\n\t\tlines.push(`│`);\n\t\tlines.push(`│  Data preview: ${formatDataPreview(cause.data, 80)}`);\n\t}\n\t\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\t\n\treturn lines;\n};\n\nexport const formatORPCError = (error: any): void => {\n\tif (!(error instanceof ORPCError)) {\n\t\treturn;\n\t}\n\n\tconst validationLines = formatORPCValidationError(error);\n\tif (validationLines) {\n\t\tconsole.error(validationLines.join('\\n'));\n\t\treturn;\n\t}\n\n\tconst lines: string[] = [];\n\tconst code = error.code || 'UNKNOWN';\n\tconst status = error.status || 500;\n\tconst message = error.message || 'An error occurred';\n\n\tlines.push(`\\n╭─ oRPC Error ${'─'.repeat(40)}`);\n\tlines.push(`│  ${message}`);\n\tlines.push(`│  Code: ${code} (${status})`);\n\tlines.push(`│`);\n\n\tif (error.data) {\n\t\tconst dataType = typeof error.data;\n\t\tif (dataType === 'object' && error.data !== null) {\n\t\t\tif ('retryAfter' in error.data) {\n\t\t\t\tlines.push(`│  Retry after: ${error.data.retryAfter} seconds`);\n\t\t\t}\n\t\t\tif ('remainingRequests' in error.data) {\n\t\t\t\tlines.push(`│  Remaining: ${error.data.remainingRequests} requests`);\n\t\t\t}\n\t\t\tif ('host' in error.data) {\n\t\t\t\tlines.push(`│  Host: ${error.data.host}`);\n\t\t\t}\n\t\t\tif ('port' in error.data) {\n\t\t\t\tlines.push(`│  Port: ${error.data.port}`);\n\t\t\t}\n\t\t\tif ('suggestion' in error.data) {\n\t\t\t\tlines.push(`│  → ${error.data.suggestion}`);\n\t\t\t}\n\t\t\tif ('resource' in error.data) {\n\t\t\t\tlines.push(`│  Resource: ${error.data.resource}`);\n\t\t\t}\n\t\t\tif ('resourceId' in error.data) {\n\t\t\t\tlines.push(`│  ID: ${error.data.resourceId}`);\n\t\t\t}\n\t\t}\n\t}\n\n\tswitch (code) {\n\t\tcase 'UNAUTHORIZED':\n\t\t\tlines.push(`│  → Check your API key or credentials`);\n\t\t\tbreak;\n\t\tcase 'TOO_MANY_REQUESTS':\n\t\t\tlines.push(`│  → Wait before retrying`);\n\t\t\tbreak;\n\t\tcase 'SERVICE_UNAVAILABLE':\n\t\tcase 'BAD_GATEWAY':\n\t\tcase 'GATEWAY_TIMEOUT':\n\t\t\tlines.push(`│  → The service may be temporarily unavailable`);\n\t\t\tbreak;\n\t\tcase 'TIMEOUT':\n\t\t\tlines.push(`│  → The operation took too long`);\n\t\t\tbreak;\n\t}\n\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\tconsole.error(lines.join('\\n'));\n};\n\nconst formatPluginError = (\n\tpluginId: string | undefined,\n\toperation: string | undefined,\n\tmessage: string\n): void => {\n\tconst lines: string[] = [];\n\n\tlines.push(`\\n╭─ Plugin Error ${'─'.repeat(40)}`);\n\tif (pluginId) lines.push(`│  Plugin: ${pluginId}`);\n\tif (operation) lines.push(`│  During: ${operation}`);\n\tlines.push(`│`);\n\n\tif (message.includes('ECONNREFUSED')) {\n\t\tlines.push(`│  ❌ Connection refused`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  A required service is not running.`);\n\t\tlines.push(`│  → Run: docker compose up -d`);\n\t} else if (message.includes('ENOTFOUND')) {\n\t\tlines.push(`│  ❌ Host not found`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your connection URL or network settings.`);\n\t} else if (message.includes('ETIMEDOUT') || message.includes('timeout')) {\n\t\tlines.push(`│  ❌ Connection timeout`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  The service took too long to respond.`);\n\t} else if (message.includes('EACCES') || message.includes('permission')) {\n\t\tlines.push(`│  ❌ Permission denied`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check credentials or access permissions.`);\n\t} else if (message.includes('401') || message.includes('unauthorized')) {\n\t\tlines.push(`│  ❌ Authentication failed`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your API key or credentials.`);\n\t} else {\n\t\tlines.push(`│  ❌ ${message}`);\n\t}\n\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\n\tconsole.error(lines.join('\\n'));\n};\n\nconst isRetryableError = (message: string): boolean => {\n\tconst retryablePatterns = ['ETIMEDOUT', 'ECONNRESET', 'timeout', '503', '429'];\n\treturn retryablePatterns.some(p => message.toLowerCase().includes(p.toLowerCase()));\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\tconst validationLines = formatORPCValidationError(orpcError);\n\tif (validationLines) {\n\t\tconsole.error(validationLines.join('\\n'));\n\t}\n\t\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;\n\t}\n\n\tconst validationLines = formatORPCValidationError(error);\n\tif (validationLines) {\n\t\tconsole.error(validationLines.join('\\n'));\n\t} else {\n\t\tconst message = extractErrorMessage(error);\n\t\tformatPluginError(pluginId, operation, message);\n\t}\n\n\treturn new PluginRuntimeError({\n\t\tpluginId,\n\t\toperation,\n\t\tprocedureName,\n\t\tretryable: defaultRetryable || isRetryableError(extractErrorMessage(error)),\n\t\tcause: error instanceof Error ? error : new Error(extractErrorMessage(error))\n\t});\n};\n"],"mappings":"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"}

package/dist/runtime/errors.d.cts

@@ -1,7 +1,7 @@
-import "zod";
-import "@orpc/contract";
+import { z } from "zod";
 import * as effect_Types0 from "effect/Types";
 import * as effect_Cause0 from "effect/Cause";
+import { ORPCError } from "@orpc/contract";
 
 //#region src/runtime/errors.d.ts
 declare const PluginRuntimeError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
@@ -22,6 +22,18 @@ declare class ModuleFederationError extends ModuleFederationError_base<{
   readonly remoteUrl: string;
   readonly cause?: Error;
 }> {}
+declare const ValidationError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "ValidationError";
+} & Readonly<A>;
+declare class ValidationError extends ValidationError_base<{
+  readonly pluginId: string;
+  readonly stage: "config" | "input" | "output" | "state";
+  readonly zodError: z.ZodError;
+}> {}
+declare const formatORPCError: (error: any) => void;
+declare const isRetryableORPCCode: (code: string) => boolean;
+declare const wrapORPCError: (orpcError: ORPCError<string, unknown>, pluginId?: string, procedureName?: string, operation?: string) => PluginRuntimeError;
+declare const toPluginRuntimeError: (error: unknown, pluginId?: string, procedureName?: string, operation?: string, defaultRetryable?: boolean) => PluginRuntimeError;
 //#endregion
-export { ModuleFederationError, PluginRuntimeError };
+export { ModuleFederationError, PluginRuntimeError, ValidationError, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError };
 //# sourceMappingURL=errors.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/runtime/errors.ts"],"sourcesContent":[],"mappings":";;;;;;cAE6B;;;cAEhB,kBAAA,SAA2B;EAFX,SAAA,QAAA,CAAA,EAAA,MAAA;;;mBAMX;;;cAEZ;;;cAEO,qBAAA,SAA8B;;;EAR9B,SAAA,KAAA,CAAA,EAaK,KAbc;AAM1B,CAAA,CAAA,CAAA"}
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/runtime/errors.ts"],"sourcesContent":[],"mappings":";;;;;;cAE6B;;;cAEhB,kBAAA,SAA2B;EAFX,SAAA,QAAA,CAAA,EAAA,MAAA;;;mBAMX;;;cAEZ;;;cAEO,qBAAA,SAA8B;;;EAR9B,SAAA,KAAA,CAAA,EAaK,KAbc;AAM1B,CAAA,CAAA,CAAA;cAQA;;;cAEO,eAAA,SAAwB;;;qBAGjB,CAAA,CAAE;;cAgGT;cAqHA;AAhOA,cA8OA,aA9OsB,EAAA,CAAA,SAKjB,EA0ON,SA/O+B,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,QAAA,CAAA,EAAA,MAAA,EAAA,aAAA,CAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EAAA,MAAA,EAAA,GAmPxC,kBAnPwC;AAMrC,cA6PO,oBA7PP,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,QAAA,CAAA,EAAA,MAAA,EAAA,aAAA,CAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EAAA,MAAA,EAAA,gBAAA,CAAA,EAAA,OAAA,EAAA,GAmQH,kBAnQG"}

package/dist/runtime/errors.d.mts

@@ -22,6 +22,18 @@ declare class ModuleFederationError extends ModuleFederationError_base<{
   readonly remoteUrl: string;
   readonly cause?: Error;
 }> {}
+declare const ValidationError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "ValidationError";
+} & Readonly<A>;
+declare class ValidationError extends ValidationError_base<{
+  readonly pluginId: string;
+  readonly stage: "config" | "input" | "output" | "state";
+  readonly zodError: z.ZodError;
+}> {}
+declare const formatORPCError: (error: any) => void;
+declare const isRetryableORPCCode: (code: string) => boolean;
+declare const wrapORPCError: (orpcError: ORPCError<string, unknown>, pluginId?: string, procedureName?: string, operation?: string) => PluginRuntimeError;
+declare const toPluginRuntimeError: (error: unknown, pluginId?: string, procedureName?: string, operation?: string, defaultRetryable?: boolean) => PluginRuntimeError;
 //#endregion
-export { ModuleFederationError, PluginRuntimeError };
+export { ModuleFederationError, PluginRuntimeError, ValidationError, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError };
 //# sourceMappingURL=errors.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/runtime/errors.ts"],"sourcesContent":[],"mappings":";;;;;;cAE6B;;;cAEhB,kBAAA,SAA2B;EAFX,SAAA,QAAA,CAAA,EAAA,MAAA;;;mBAMX;;;cAEZ;;;cAEO,qBAAA,SAA8B;;;EAR9B,SAAA,KAAA,CAAA,EAaK,KAbc;AAM1B,CAAA,CAAA,CAAA"}
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/runtime/errors.ts"],"sourcesContent":[],"mappings":";;;;;;cAE6B;;;cAEhB,kBAAA,SAA2B;EAFX,SAAA,QAAA,CAAA,EAAA,MAAA;;;mBAMX;;;cAEZ;;;cAEO,qBAAA,SAA8B;;;EAR9B,SAAA,KAAA,CAAA,EAaK,KAbc;AAM1B,CAAA,CAAA,CAAA;cAQA;;;cAEO,eAAA,SAAwB;;;qBAGjB,CAAA,CAAE;;cAgGT;cAqHA;AAhOA,cA8OA,aA9OsB,EAAA,CAAA,SAKjB,EA0ON,SA/O+B,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,QAAA,CAAA,EAAA,MAAA,EAAA,aAAA,CAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EAAA,MAAA,EAAA,GAmPxC,kBAnPwC;AAMrC,cA6PO,oBA7PP,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,QAAA,CAAA,EAAA,MAAA,EAAA,aAAA,CAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EAAA,MAAA,EAAA,gBAAA,CAAA,EAAA,OAAA,EAAA,GAmQH,kBAnQG"}

package/dist/runtime/errors.mjs

@@ -1,5 +1,5 @@
-import { Data } from "effect";
 import { ORPCError } from "@orpc/contract";
+import { Data } from "effect";
 
 //#region src/runtime/errors.ts
 var PluginRuntimeError = class extends Data.TaggedError("PluginRuntimeError") {};
@@ -15,6 +15,95 @@ const extractErrorMessage = (error) => {
 	if (typeof error === "object" && "message" in error) return String(error.message);
 	return String(error);
 };
+const formatValidationIssue = (issue, index, maxDisplay) => {
+	if (index >= maxDisplay) return "";
+	const path = Array.isArray(issue.path) && issue.path.length > 0 ? issue.path.join(".") : issue.path || "root";
+	const message = issue.message || "Validation failed";
+	return `│    ${index + 1}. ${path}: ${message}`;
+};
+const formatDataPreview = (data, maxLength = 100) => {
+	if (!data) return "undefined";
+	try {
+		const str = JSON.stringify(data);
+		if (str.length <= maxLength) return str;
+		if (typeof data === "object" && data !== null) {
+			if (Array.isArray(data)) return `Array(${data.length}) [...]`;
+			const keys = Object.keys(data);
+			return `{ ${keys.slice(0, 3).join(", ")}${keys.length > 3 ? ", ..." : ""} }`;
+		}
+		return str.slice(0, maxLength) + "...";
+	} catch {
+		return String(data).slice(0, maxLength);
+	}
+};
+const formatORPCValidationError = (error) => {
+	const cause = error?.cause || error;
+	if (!cause?.issues || !Array.isArray(cause.issues) || cause.issues.length === 0) return null;
+	const lines = [];
+	const errorType = error?.message || cause?.message || "Validation failed";
+	lines.push(`\n╭─ oRPC Validation Error ${"─".repeat(30)}`);
+	lines.push(`│  ${errorType}`);
+	lines.push(`│`);
+	const maxDisplay = 10;
+	const totalIssues = cause.issues.length;
+	lines.push(`│  Issues (${totalIssues}):`);
+	cause.issues.slice(0, maxDisplay).forEach((issue, idx) => {
+		const formatted = formatValidationIssue(issue, idx, maxDisplay);
+		if (formatted) lines.push(formatted);
+	});
+	if (totalIssues > maxDisplay) lines.push(`│    ... and ${totalIssues - maxDisplay} more`);
+	if (cause.data !== void 0) {
+		lines.push(`│`);
+		lines.push(`│  Data preview: ${formatDataPreview(cause.data, 80)}`);
+	}
+	lines.push(`╰${"─".repeat(50)}\n`);
+	return lines;
+};
+const formatORPCError = (error) => {
+	if (!(error instanceof ORPCError)) return;
+	const validationLines = formatORPCValidationError(error);
+	if (validationLines) {
+		console.error(validationLines.join("\n"));
+		return;
+	}
+	const lines = [];
+	const code = error.code || "UNKNOWN";
+	const status = error.status || 500;
+	const message = error.message || "An error occurred";
+	lines.push(`\n╭─ oRPC Error ${"─".repeat(40)}`);
+	lines.push(`│  ${message}`);
+	lines.push(`│  Code: ${code} (${status})`);
+	lines.push(`│`);
+	if (error.data) {
+		if (typeof error.data === "object" && error.data !== null) {
+			if ("retryAfter" in error.data) lines.push(`│  Retry after: ${error.data.retryAfter} seconds`);
+			if ("remainingRequests" in error.data) lines.push(`│  Remaining: ${error.data.remainingRequests} requests`);
+			if ("host" in error.data) lines.push(`│  Host: ${error.data.host}`);
+			if ("port" in error.data) lines.push(`│  Port: ${error.data.port}`);
+			if ("suggestion" in error.data) lines.push(`│  → ${error.data.suggestion}`);
+			if ("resource" in error.data) lines.push(`│  Resource: ${error.data.resource}`);
+			if ("resourceId" in error.data) lines.push(`│  ID: ${error.data.resourceId}`);
+		}
+	}
+	switch (code) {
+		case "UNAUTHORIZED":
+			lines.push(`│  → Check your API key or credentials`);
+			break;
+		case "TOO_MANY_REQUESTS":
+			lines.push(`│  → Wait before retrying`);
+			break;
+		case "SERVICE_UNAVAILABLE":
+		case "BAD_GATEWAY":
+		case "GATEWAY_TIMEOUT":
+			lines.push(`│  → The service may be temporarily unavailable`);
+			break;
+		case "TIMEOUT":
+			lines.push(`│  → The operation took too long`);
+			break;
+	}
+	lines.push(`╰${"─".repeat(50)}\n`);
+	console.error(lines.join("\n"));
+};
 const formatPluginError = (pluginId, operation, message) => {
 	const lines = [];
 	lines.push(`\n╭─ Plugin Error ${"─".repeat(40)}`);
@@ -66,6 +155,8 @@ const isRetryableORPCCode = (code) => {
 	}
 };
 const wrapORPCError = (orpcError, pluginId, procedureName, operation) => {
+	const validationLines = formatORPCValidationError(orpcError);
+	if (validationLines) console.error(validationLines.join("\n"));
 	return new PluginRuntimeError({
 		pluginId,
 		operation,
@@ -77,17 +168,18 @@ const wrapORPCError = (orpcError, pluginId, procedureName, operation) => {
 const toPluginRuntimeError = (error, pluginId, procedureName, operation, defaultRetryable = false) => {
 	if (error instanceof ORPCError) return wrapORPCError(error, pluginId, procedureName, operation);
 	if (error instanceof PluginRuntimeError) return error;
-	const message = extractErrorMessage(error);
-	formatPluginError(pluginId, operation, message);
+	const validationLines = formatORPCValidationError(error);
+	if (validationLines) console.error(validationLines.join("\n"));
+	else formatPluginError(pluginId, operation, extractErrorMessage(error));
 	return new PluginRuntimeError({
 		pluginId,
 		operation,
 		procedureName,
-		retryable: defaultRetryable || isRetryableError(message),
-		cause: error instanceof Error ? error : new Error(message)
+		retryable: defaultRetryable || isRetryableError(extractErrorMessage(error)),
+		cause: error instanceof Error ? error : new Error(extractErrorMessage(error))
 	});
 };
 
 //#endregion
-export { ModuleFederationError, PluginRuntimeError, ValidationError, toPluginRuntimeError };
+export { ModuleFederationError, PluginRuntimeError, ValidationError, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError };
 //# sourceMappingURL=errors.mjs.map

package/dist/runtime/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":["lines: string[]"],"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\nconst extractErrorMessage = (error: unknown): string => {\n\tif (!error) return 'Unknown error';\n\n\tif (error instanceof Error) {\n\t\tif (error.message) return error.message;\n\t\tif ((error as any).cause instanceof Error) {\n\t\t\treturn extractErrorMessage((error as any).cause);\n\t\t}\n\t}\n\n\tif (error instanceof AggregateError && error.errors?.length) {\n\t\treturn error.errors.map(e => extractErrorMessage(e)).join('; ');\n\t}\n\n\tif (typeof error === 'object' && 'message' in error) {\n\t\treturn String((error as any).message);\n\t}\n\n\treturn String(error);\n};\n\nconst formatPluginError = (\n\tpluginId: string | undefined,\n\toperation: string | undefined,\n\tmessage: string\n): void => {\n\tconst lines: string[] = [];\n\n\tlines.push(`\\n╭─ Plugin Error ${'─'.repeat(40)}`);\n\tif (pluginId) lines.push(`│  Plugin: ${pluginId}`);\n\tif (operation) lines.push(`│  During: ${operation}`);\n\tlines.push(`│`);\n\n\tif (message.includes('ECONNREFUSED')) {\n\t\tlines.push(`│  ❌ Connection refused`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  A required service is not running.`);\n\t\tlines.push(`│  → Run: docker compose up -d`);\n\t} else if (message.includes('ENOTFOUND')) {\n\t\tlines.push(`│  ❌ Host not found`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your connection URL or network settings.`);\n\t} else if (message.includes('ETIMEDOUT') || message.includes('timeout')) {\n\t\tlines.push(`│  ❌ Connection timeout`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  The service took too long to respond.`);\n\t} else if (message.includes('EACCES') || message.includes('permission')) {\n\t\tlines.push(`│  ❌ Permission denied`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check credentials or access permissions.`);\n\t} else if (message.includes('401') || message.includes('unauthorized')) {\n\t\tlines.push(`│  ❌ Authentication failed`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your API key or credentials.`);\n\t} else {\n\t\tlines.push(`│  ❌ ${message}`);\n\t}\n\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\n\tconsole.error(lines.join('\\n'));\n};\n\nconst isRetryableError = (message: string): boolean => {\n\tconst retryablePatterns = ['ETIMEDOUT', 'ECONNRESET', 'timeout', '503', '429'];\n\treturn retryablePatterns.some(p => message.toLowerCase().includes(p.toLowerCase()));\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;\n\t}\n\n\tconst message = extractErrorMessage(error);\n\n\tformatPluginError(pluginId, operation, message);\n\n\treturn new PluginRuntimeError({\n\t\tpluginId,\n\t\toperation,\n\t\tprocedureName,\n\t\tretryable: defaultRetryable || isRetryableError(message),\n\t\tcause: error instanceof Error ? error : new Error(message)\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;AAEH,MAAM,uBAAuB,UAA2B;AACvD,KAAI,CAAC,MAAO,QAAO;AAEnB,KAAI,iBAAiB,OAAO;AAC3B,MAAI,MAAM,QAAS,QAAO,MAAM;AAChC,MAAK,MAAc,iBAAiB,MACnC,QAAO,oBAAqB,MAAc,MAAM;;AAIlD,KAAI,iBAAiB,kBAAkB,MAAM,QAAQ,OACpD,QAAO,MAAM,OAAO,KAAI,MAAK,oBAAoB,EAAE,CAAC,CAAC,KAAK,KAAK;AAGhE,KAAI,OAAO,UAAU,YAAY,aAAa,MAC7C,QAAO,OAAQ,MAAc,QAAQ;AAGtC,QAAO,OAAO,MAAM;;AAGrB,MAAM,qBACL,UACA,WACA,YACU;CACV,MAAMA,QAAkB,EAAE;AAE1B,OAAM,KAAK,qBAAqB,IAAI,OAAO,GAAG,GAAG;AACjD,KAAI,SAAU,OAAM,KAAK,cAAc,WAAW;AAClD,KAAI,UAAW,OAAM,KAAK,cAAc,YAAY;AACpD,OAAM,KAAK,IAAI;AAEf,KAAI,QAAQ,SAAS,eAAe,EAAE;AACrC,QAAM,KAAK,0BAA0B;AACrC,QAAM,KAAK,MAAM;AACjB,QAAM,KAAK,wCAAwC;AACnD,QAAM,KAAK,iCAAiC;YAClC,QAAQ,SAAS,YAAY,EAAE;AACzC,QAAM,KAAK,sBAAsB;AACjC,QAAM,KAAK,MAAM;AACjB,QAAM,KAAK,oDAAoD;YACrD,QAAQ,SAAS,YAAY,IAAI,QAAQ,SAAS,UAAU,EAAE;AACxE,QAAM,KAAK,0BAA0B;AACrC,QAAM,KAAK,MAAM;AACjB,QAAM,KAAK,2CAA2C;YAC5C,QAAQ,SAAS,SAAS,IAAI,QAAQ,SAAS,aAAa,EAAE;AACxE,QAAM,KAAK,yBAAyB;AACpC,QAAM,KAAK,MAAM;AACjB,QAAM,KAAK,8CAA8C;YAC/C,QAAQ,SAAS,MAAM,IAAI,QAAQ,SAAS,eAAe,EAAE;AACvE,QAAM,KAAK,6BAA6B;AACxC,QAAM,KAAK,MAAM;AACjB,QAAM,KAAK,wCAAwC;OAEnD,OAAM,KAAK,QAAQ,UAAU;AAG9B,OAAM,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI;AAElC,SAAQ,MAAM,MAAM,KAAK,KAAK,CAAC;;AAGhC,MAAM,oBAAoB,YAA6B;AAEtD,QAD0B;EAAC;EAAa;EAAc;EAAW;EAAO;EAAM,CACrD,MAAK,MAAK,QAAQ,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;;AAIpF,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;CAGR,MAAM,UAAU,oBAAoB,MAAM;AAE1C,mBAAkB,UAAU,WAAW,QAAQ;AAE/C,QAAO,IAAI,mBAAmB;EAC7B;EACA;EACA;EACA,WAAW,oBAAoB,iBAAiB,QAAQ;EACxD,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,QAAQ;EAC1D,CAAC"}
+{"version":3,"file":"errors.mjs","names":["lines: string[]"],"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\nconst extractErrorMessage = (error: unknown): string => {\n\tif (!error) return 'Unknown error';\n\n\tif (error instanceof Error) {\n\t\tif (error.message) return error.message;\n\t\tif ((error as any).cause instanceof Error) {\n\t\t\treturn extractErrorMessage((error as any).cause);\n\t\t}\n\t}\n\n\tif (error instanceof AggregateError && error.errors?.length) {\n\t\treturn error.errors.map(e => extractErrorMessage(e)).join('; ');\n\t}\n\n\tif (typeof error === 'object' && 'message' in error) {\n\t\treturn String((error as any).message);\n\t}\n\n\treturn String(error);\n};\n\nconst formatValidationIssue = (issue: any, index: number, maxDisplay: number): string => {\n\tif (index >= maxDisplay) return '';\n\t\n\tconst path = Array.isArray(issue.path) && issue.path.length > 0\n\t\t? issue.path.join('.')\n\t\t: issue.path || 'root';\n\t\n\tconst message = issue.message || 'Validation failed';\n\t\n\treturn `│    ${index + 1}. ${path}: ${message}`;\n};\n\nconst formatDataPreview = (data: unknown, maxLength = 100): string => {\n\tif (!data) return 'undefined';\n\t\n\ttry {\n\t\tconst str = JSON.stringify(data);\n\t\tif (str.length <= maxLength) return str;\n\t\t\n\t\tif (typeof data === 'object' && data !== null) {\n\t\t\tif (Array.isArray(data)) {\n\t\t\t\treturn `Array(${data.length}) [...]`;\n\t\t\t}\n\t\t\tconst keys = Object.keys(data);\n\t\t\treturn `{ ${keys.slice(0, 3).join(', ')}${keys.length > 3 ? ', ...' : ''} }`;\n\t\t}\n\t\t\n\t\treturn str.slice(0, maxLength) + '...';\n\t} catch {\n\t\treturn String(data).slice(0, maxLength);\n\t}\n};\n\nconst formatORPCValidationError = (error: any): string[] | null => {\n\tconst cause = error?.cause || error;\n\t\n\tif (!cause?.issues || !Array.isArray(cause.issues) || cause.issues.length === 0) {\n\t\treturn null;\n\t}\n\n\tconst lines: string[] = [];\n\tconst errorType = error?.message || cause?.message || 'Validation failed';\n\t\n\tlines.push(`\\n╭─ oRPC Validation Error ${'─'.repeat(30)}`);\n\tlines.push(`│  ${errorType}`);\n\tlines.push(`│`);\n\t\n\tconst maxDisplay = 10;\n\tconst totalIssues = cause.issues.length;\n\t\n\tlines.push(`│  Issues (${totalIssues}):`);\n\t\n\tconst displayedIssues = cause.issues.slice(0, maxDisplay);\n\tdisplayedIssues.forEach((issue: any, idx: number) => {\n\t\tconst formatted = formatValidationIssue(issue, idx, maxDisplay);\n\t\tif (formatted) lines.push(formatted);\n\t});\n\t\n\tif (totalIssues > maxDisplay) {\n\t\tlines.push(`│    ... and ${totalIssues - maxDisplay} more`);\n\t}\n\t\n\tif (cause.data !== undefined) {\n\t\tlines.push(`│`);\n\t\tlines.push(`│  Data preview: ${formatDataPreview(cause.data, 80)}`);\n\t}\n\t\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\t\n\treturn lines;\n};\n\nexport const formatORPCError = (error: any): void => {\n\tif (!(error instanceof ORPCError)) {\n\t\treturn;\n\t}\n\n\tconst validationLines = formatORPCValidationError(error);\n\tif (validationLines) {\n\t\tconsole.error(validationLines.join('\\n'));\n\t\treturn;\n\t}\n\n\tconst lines: string[] = [];\n\tconst code = error.code || 'UNKNOWN';\n\tconst status = error.status || 500;\n\tconst message = error.message || 'An error occurred';\n\n\tlines.push(`\\n╭─ oRPC Error ${'─'.repeat(40)}`);\n\tlines.push(`│  ${message}`);\n\tlines.push(`│  Code: ${code} (${status})`);\n\tlines.push(`│`);\n\n\tif (error.data) {\n\t\tconst dataType = typeof error.data;\n\t\tif (dataType === 'object' && error.data !== null) {\n\t\t\tif ('retryAfter' in error.data) {\n\t\t\t\tlines.push(`│  Retry after: ${error.data.retryAfter} seconds`);\n\t\t\t}\n\t\t\tif ('remainingRequests' in error.data) {\n\t\t\t\tlines.push(`│  Remaining: ${error.data.remainingRequests} requests`);\n\t\t\t}\n\t\t\tif ('host' in error.data) {\n\t\t\t\tlines.push(`│  Host: ${error.data.host}`);\n\t\t\t}\n\t\t\tif ('port' in error.data) {\n\t\t\t\tlines.push(`│  Port: ${error.data.port}`);\n\t\t\t}\n\t\t\tif ('suggestion' in error.data) {\n\t\t\t\tlines.push(`│  → ${error.data.suggestion}`);\n\t\t\t}\n\t\t\tif ('resource' in error.data) {\n\t\t\t\tlines.push(`│  Resource: ${error.data.resource}`);\n\t\t\t}\n\t\t\tif ('resourceId' in error.data) {\n\t\t\t\tlines.push(`│  ID: ${error.data.resourceId}`);\n\t\t\t}\n\t\t}\n\t}\n\n\tswitch (code) {\n\t\tcase 'UNAUTHORIZED':\n\t\t\tlines.push(`│  → Check your API key or credentials`);\n\t\t\tbreak;\n\t\tcase 'TOO_MANY_REQUESTS':\n\t\t\tlines.push(`│  → Wait before retrying`);\n\t\t\tbreak;\n\t\tcase 'SERVICE_UNAVAILABLE':\n\t\tcase 'BAD_GATEWAY':\n\t\tcase 'GATEWAY_TIMEOUT':\n\t\t\tlines.push(`│  → The service may be temporarily unavailable`);\n\t\t\tbreak;\n\t\tcase 'TIMEOUT':\n\t\t\tlines.push(`│  → The operation took too long`);\n\t\t\tbreak;\n\t}\n\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\tconsole.error(lines.join('\\n'));\n};\n\nconst formatPluginError = (\n\tpluginId: string | undefined,\n\toperation: string | undefined,\n\tmessage: string\n): void => {\n\tconst lines: string[] = [];\n\n\tlines.push(`\\n╭─ Plugin Error ${'─'.repeat(40)}`);\n\tif (pluginId) lines.push(`│  Plugin: ${pluginId}`);\n\tif (operation) lines.push(`│  During: ${operation}`);\n\tlines.push(`│`);\n\n\tif (message.includes('ECONNREFUSED')) {\n\t\tlines.push(`│  ❌ Connection refused`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  A required service is not running.`);\n\t\tlines.push(`│  → Run: docker compose up -d`);\n\t} else if (message.includes('ENOTFOUND')) {\n\t\tlines.push(`│  ❌ Host not found`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your connection URL or network settings.`);\n\t} else if (message.includes('ETIMEDOUT') || message.includes('timeout')) {\n\t\tlines.push(`│  ❌ Connection timeout`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  The service took too long to respond.`);\n\t} else if (message.includes('EACCES') || message.includes('permission')) {\n\t\tlines.push(`│  ❌ Permission denied`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check credentials or access permissions.`);\n\t} else if (message.includes('401') || message.includes('unauthorized')) {\n\t\tlines.push(`│  ❌ Authentication failed`);\n\t\tlines.push(`│  `);\n\t\tlines.push(`│  Check your API key or credentials.`);\n\t} else {\n\t\tlines.push(`│  ❌ ${message}`);\n\t}\n\n\tlines.push(`╰${'─'.repeat(50)}\\n`);\n\n\tconsole.error(lines.join('\\n'));\n};\n\nconst isRetryableError = (message: string): boolean => {\n\tconst retryablePatterns = ['ETIMEDOUT', 'ECONNRESET', 'timeout', '503', '429'];\n\treturn retryablePatterns.some(p => message.toLowerCase().includes(p.toLowerCase()));\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\tconst validationLines = formatORPCValidationError(orpcError);\n\tif (validationLines) {\n\t\tconsole.error(validationLines.join('\\n'));\n\t}\n\t\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;\n\t}\n\n\tconst validationLines = formatORPCValidationError(error);\n\tif (validationLines) {\n\t\tconsole.error(validationLines.join('\\n'));\n\t} else {\n\t\tconst message = extractErrorMessage(error);\n\t\tformatPluginError(pluginId, operation, message);\n\t}\n\n\treturn new PluginRuntimeError({\n\t\tpluginId,\n\t\toperation,\n\t\tprocedureName,\n\t\tretryable: defaultRetryable || isRetryableError(extractErrorMessage(error)),\n\t\tcause: error instanceof Error ? error : new Error(extractErrorMessage(error))\n\t});\n};\n"],"mappings":"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"}

package/dist/runtime/index.cjs

@@ -1,8 +1,8 @@
 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 __orpc_server = require("@orpc/server");
 let effect = require("effect");
+let __orpc_server = require("@orpc/server");
 
 //#region src/runtime/index.ts
 var PluginRuntime = class {