every-plugin 2.10.1 → 3.0.0-rc.0

package/dist/errors.mjs

@@ -1,37 +1,9 @@
-import { z } from "./zod.mjs";
-import { ModuleFederationError, PluginRuntimeError, ValidationError, extractFromFiberFailure, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.mjs";
+import { ModuleFederationError, PluginRuntimeError, ValidationError, classifyPluginFailure, extractFromFiberFailure, formatORPCError, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.mjs";
+import { COMMON_ERROR_STATUS_MAP } from "@orpc/server";
+import { z } from "zod";
 
 //#region src/errors.ts
 /**
-* Error pattern constants for categorizing infrastructure errors
-*/
-const ERROR_PATTERNS = {
-	CONNECTION_REFUSED: ["ECONNREFUSED"],
-	HOST_NOT_FOUND: ["ENOTFOUND", "EHOSTUNREACH"],
-	TIMEOUT: [
-		"ETIMEDOUT",
-		"ESOCKETTIMEDOUT",
-		"timeout"
-	],
-	CONNECTION_RESET: ["ECONNRESET", "EPIPE"],
-	PERMISSION: [
-		"EACCES",
-		"EPERM",
-		"permission denied"
-	],
-	AUTH: [
-		"401",
-		"unauthorized",
-		"authentication failed"
-	],
-	RATE_LIMITED: [
-		"429",
-		"too many requests",
-		"rate limit"
-	],
-	SERVICE_UNAVAILABLE: ["503", "service unavailable"]
-};
-/**
 * Common error schemas for plugin contracts.
 * Import individually or use the grouped PluginErrors export.
 *
@@ -135,10 +107,20 @@ const PluginErrors = {
 	CONNECTION_ERROR
 };
 /**
-* @deprecated Use individual imports or PluginErrors instead
+* Error-code -> HTTP-status map for handlers.
+*
+* oRPC v2 resolves statuses at the handler boundary via `errorStatusMap`
+* (default `COMMON_ERROR_STATUS_MAP`, where TIMEOUT is 408). Providing a
+* map REPLACES the default entirely, so the standard codes must be spread
+* back in. These custom entries preserve the v1 wire behavior:
+* TIMEOUT -> 504, CONNECTION_ERROR -> 502.
 */
-const CommonPluginErrors = PluginErrors;
+const PLUGIN_ERROR_STATUS_MAP = {
+	...COMMON_ERROR_STATUS_MAP,
+	TIMEOUT: 504,
+	CONNECTION_ERROR: 502
+};
 
 //#endregion
-export { BAD_REQUEST, CONNECTION_ERROR, CommonPluginErrors, ERROR_PATTERNS, FORBIDDEN, ModuleFederationError, NOT_FOUND, PluginErrors, PluginRuntimeError, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED, ValidationError, extractFromFiberFailure, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError };
+export { BAD_REQUEST, CONNECTION_ERROR, FORBIDDEN, ModuleFederationError, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, PluginErrors, PluginRuntimeError, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED, ValidationError, classifyPluginFailure, extractFromFiberFailure, formatORPCError, toPluginRuntimeError, wrapORPCError };
 //# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import { z } from \"./zod\";\n\n/**\n * Error pattern constants for categorizing infrastructure errors\n */\nexport const ERROR_PATTERNS = {\n  CONNECTION_REFUSED: [\"ECONNREFUSED\"],\n  HOST_NOT_FOUND: [\"ENOTFOUND\", \"EHOSTUNREACH\"],\n  TIMEOUT: [\"ETIMEDOUT\", \"ESOCKETTIMEDOUT\", \"timeout\"],\n  CONNECTION_RESET: [\"ECONNRESET\", \"EPIPE\"],\n  PERMISSION: [\"EACCES\", \"EPERM\", \"permission denied\"],\n  AUTH: [\"401\", \"unauthorized\", \"authentication failed\"],\n  RATE_LIMITED: [\"429\", \"too many requests\", \"rate limit\"],\n  SERVICE_UNAVAILABLE: [\"503\", \"service unavailable\"],\n} as const;\n\n/**\n * Common error schemas for plugin contracts.\n * Import individually or use the grouped PluginErrors export.\n *\n * @example\n * ```typescript\n * import { NOT_FOUND, FORBIDDEN, UNAUTHORIZED } from \"every-plugin/errors\";\n *\n * export const contract = oc.router({\n *   getData: oc.route(...)\n *     .errors({ NOT_FOUND, FORBIDDEN, UNAUTHORIZED })\n * });\n * ```\n */\n\nexport const UNAUTHORIZED = {\n  status: 401,\n  data: z.object({\n    apiKeyProvided: z.boolean(),\n    provider: z.string().optional(),\n    authType: z.enum([\"apiKey\", \"oauth\", \"token\"]).optional(),\n  }),\n} as const;\n\nexport const RATE_LIMITED = {\n  status: 429,\n  data: z.object({\n    retryAfter: z.number().int().min(1),\n    remainingRequests: z.number().int().min(0).optional(),\n    resetTime: z.string().datetime().optional(),\n    limitType: z.enum([\"requests\", \"tokens\", \"bandwidth\"]).optional(),\n  }),\n} as const;\n\nexport const SERVICE_UNAVAILABLE = {\n  status: 503,\n  data: z.object({\n    retryAfter: z.number().int().optional(),\n    maintenanceWindow: z.boolean().default(false),\n    estimatedUptime: z.string().datetime().optional(),\n  }),\n} as const;\n\nexport const BAD_REQUEST = {\n  status: 400,\n  data: z.object({\n    invalidFields: z.array(z.string()).optional(),\n    validationErrors: z\n      .array(\n        z.object({\n          field: z.string(),\n          message: z.string(),\n          code: z.string().optional(),\n        }),\n      )\n      .optional(),\n  }),\n} as const;\n\nexport const NOT_FOUND = {\n  status: 404,\n  data: z.object({\n    resource: z.string().optional(),\n    resourceId: z.string().optional(),\n  }),\n} as const;\n\nexport const FORBIDDEN = {\n  status: 403,\n  data: z.object({\n    requiredPermissions: z.array(z.string()).optional(),\n    action: z.string().optional(),\n  }),\n} as const;\n\nexport const TIMEOUT = {\n  status: 504,\n  data: z.object({\n    timeoutMs: z.number().int().min(0).optional(),\n    operation: z.string().optional(),\n    retryable: z.boolean().default(true),\n  }),\n} as const;\n\nexport const CONNECTION_ERROR = {\n  status: 502,\n  data: z.object({\n    errorCode: z.string().optional(),\n    host: z.string().optional(),\n    port: z.number().int().optional(),\n    suggestion: z.string().optional(),\n  }),\n} as const;\n\n/**\n * Grouped export for all plugin errors.\n * Use individual imports for cleaner code.\n */\nexport const PluginErrors = {\n  UNAUTHORIZED,\n  RATE_LIMITED,\n  SERVICE_UNAVAILABLE,\n  BAD_REQUEST,\n  NOT_FOUND,\n  FORBIDDEN,\n  TIMEOUT,\n  CONNECTION_ERROR,\n} as const;\n\n/**\n * @deprecated Use individual imports or PluginErrors instead\n */\nexport const CommonPluginErrors = PluginErrors;\n\nexport {\n  extractFromFiberFailure,\n  formatORPCError,\n  isRetryableORPCCode,\n  ModuleFederationError,\n  PluginRuntimeError,\n  toPluginRuntimeError,\n  ValidationError,\n  wrapORPCError,\n} from \"./runtime/errors\";\n"],"mappings":";;;;;;;AAKA,MAAa,iBAAiB;CAC5B,oBAAoB,CAAC,cAAc;CACnC,gBAAgB,CAAC,aAAa,cAAc;CAC5C,SAAS;EAAC;EAAa;EAAmB;CAAS;CACnD,kBAAkB,CAAC,cAAc,OAAO;CACxC,YAAY;EAAC;EAAU;EAAS;CAAmB;CACnD,MAAM;EAAC;EAAO;EAAgB;CAAuB;CACrD,cAAc;EAAC;EAAO;EAAqB;CAAY;CACvD,qBAAqB,CAAC,OAAO,qBAAqB;AACpD;;;;;;;;;;;;;;;AAiBA,MAAa,eAAe;CAC1B,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,gBAAgB,EAAE,QAAQ;EAC1B,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;EAC9B,UAAU,EAAE,KAAK;GAAC;GAAU;GAAS;EAAO,CAAC,CAAC,CAAC,SAAS;CAC1D,CAAC;AACH;AAEA,MAAa,eAAe;CAC1B,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;EAClC,mBAAmB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;EACpD,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;EAC1C,WAAW,EAAE,KAAK;GAAC;GAAY;GAAU;EAAW,CAAC,CAAC,CAAC,SAAS;CAClE,CAAC;AACH;AAEA,MAAa,sBAAsB;CACjC,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;EACtC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK;EAC5C,iBAAiB,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAClD,CAAC;AACH;AAEA,MAAa,cAAc;CACzB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;EAC5C,kBAAkB,EACf,MACC,EAAE,OAAO;GACP,OAAO,EAAE,OAAO;GAChB,SAAS,EAAE,OAAO;GAClB,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;EAC5B,CAAC,CACH,CAAC,CACA,SAAS;CACd,CAAC;AACH;AAEA,MAAa,YAAY;CACvB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;EAC9B,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;CAClC,CAAC;AACH;AAEA,MAAa,YAAY;CACvB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;EAClD,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;CAC9B,CAAC;AACH;AAEA,MAAa,UAAU;CACrB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;EAC5C,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;EAC/B,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,IAAI;CACrC,CAAC;AACH;AAEA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;EAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;EAC1B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;EAChC,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;CAClC,CAAC;AACH;;;;;AAMA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;AAKA,MAAa,qBAAqB"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import { COMMON_ERROR_STATUS_MAP } from \"@orpc/server\";\nimport { z } from \"zod\";\n\n/**\n * Common error schemas for plugin contracts.\n * Import individually or use the grouped PluginErrors export.\n *\n * @example\n * ```typescript\n * import { NOT_FOUND, FORBIDDEN, UNAUTHORIZED } from \"every-plugin/errors\";\n *\n * export const contract = oc.router({\n *   getData: oc.route(...)\n *     .errors({ NOT_FOUND, FORBIDDEN, UNAUTHORIZED })\n * });\n * ```\n */\n\nexport const UNAUTHORIZED = {\n  status: 401,\n  data: z.object({\n    apiKeyProvided: z.boolean(),\n    provider: z.string().optional(),\n    authType: z.enum([\"apiKey\", \"oauth\", \"token\"]).optional(),\n  }),\n} as const;\n\nexport const RATE_LIMITED = {\n  status: 429,\n  data: z.object({\n    retryAfter: z.number().int().min(1),\n    remainingRequests: z.number().int().min(0).optional(),\n    resetTime: z.string().datetime().optional(),\n    limitType: z.enum([\"requests\", \"tokens\", \"bandwidth\"]).optional(),\n  }),\n} as const;\n\nexport const SERVICE_UNAVAILABLE = {\n  status: 503,\n  data: z.object({\n    retryAfter: z.number().int().optional(),\n    maintenanceWindow: z.boolean().default(false),\n    estimatedUptime: z.string().datetime().optional(),\n  }),\n} as const;\n\nexport const BAD_REQUEST = {\n  status: 400,\n  data: z.object({\n    invalidFields: z.array(z.string()).optional(),\n    validationErrors: z\n      .array(\n        z.object({\n          field: z.string(),\n          message: z.string(),\n          code: z.string().optional(),\n        }),\n      )\n      .optional(),\n  }),\n} as const;\n\nexport const NOT_FOUND = {\n  status: 404,\n  data: z.object({\n    resource: z.string().optional(),\n    resourceId: z.string().optional(),\n  }),\n} as const;\n\nexport const FORBIDDEN = {\n  status: 403,\n  data: z.object({\n    requiredPermissions: z.array(z.string()).optional(),\n    action: z.string().optional(),\n  }),\n} as const;\n\nexport const TIMEOUT = {\n  status: 504,\n  data: z.object({\n    timeoutMs: z.number().int().min(0).optional(),\n    operation: z.string().optional(),\n    retryable: z.boolean().default(true),\n  }),\n} as const;\n\nexport const CONNECTION_ERROR = {\n  status: 502,\n  data: z.object({\n    errorCode: z.string().optional(),\n    host: z.string().optional(),\n    port: z.number().int().optional(),\n    suggestion: z.string().optional(),\n  }),\n} as const;\n\n/**\n * Grouped export for all plugin errors.\n * Use individual imports for cleaner code.\n */\nexport const PluginErrors = {\n  UNAUTHORIZED,\n  RATE_LIMITED,\n  SERVICE_UNAVAILABLE,\n  BAD_REQUEST,\n  NOT_FOUND,\n  FORBIDDEN,\n  TIMEOUT,\n  CONNECTION_ERROR,\n} as const;\n\n/**\n * Error-code -> HTTP-status map for handlers.\n *\n * oRPC v2 resolves statuses at the handler boundary via `errorStatusMap`\n * (default `COMMON_ERROR_STATUS_MAP`, where TIMEOUT is 408). Providing a\n * map REPLACES the default entirely, so the standard codes must be spread\n * back in. These custom entries preserve the v1 wire behavior:\n * TIMEOUT -> 504, CONNECTION_ERROR -> 502.\n */\nexport const PLUGIN_ERROR_STATUS_MAP: Record<string, number> = {\n  ...COMMON_ERROR_STATUS_MAP,\n  TIMEOUT: 504,\n  CONNECTION_ERROR: 502,\n} as const;\n\nexport type { PluginLoadFailureInfo } from \"./runtime/errors\";\nexport {\n  classifyPluginFailure,\n  extractFromFiberFailure,\n  formatORPCError,\n  ModuleFederationError,\n  PluginRuntimeError,\n  toPluginRuntimeError,\n  ValidationError,\n  wrapORPCError,\n} from \"./runtime/errors\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAa,eAAe;CAC1B,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,gBAAgB,EAAE,QAAQ;EAC1B,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;EAC9B,UAAU,EAAE,KAAK;GAAC;GAAU;GAAS;EAAO,CAAC,CAAC,CAAC,SAAS;CAC1D,CAAC;AACH;AAEA,MAAa,eAAe;CAC1B,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;EAClC,mBAAmB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;EACpD,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;EAC1C,WAAW,EAAE,KAAK;GAAC;GAAY;GAAU;EAAW,CAAC,CAAC,CAAC,SAAS;CAClE,CAAC;AACH;AAEA,MAAa,sBAAsB;CACjC,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;EACtC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK;EAC5C,iBAAiB,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAClD,CAAC;AACH;AAEA,MAAa,cAAc;CACzB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;EAC5C,kBAAkB,EACf,MACC,EAAE,OAAO;GACP,OAAO,EAAE,OAAO;GAChB,SAAS,EAAE,OAAO;GAClB,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;EAC5B,CAAC,CACH,CAAC,CACA,SAAS;CACd,CAAC;AACH;AAEA,MAAa,YAAY;CACvB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;EAC9B,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;CAClC,CAAC;AACH;AAEA,MAAa,YAAY;CACvB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;EAClD,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;CAC9B,CAAC;AACH;AAEA,MAAa,UAAU;CACrB,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;EAC5C,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;EAC/B,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,IAAI;CACrC,CAAC;AACH;AAEA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,MAAM,EAAE,OAAO;EACb,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;EAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;EAC1B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;EAChC,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;CAClC,CAAC;AACH;;;;;AAMA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;;;AAWA,MAAa,0BAAkD;CAC7D,GAAG;CACH,SAAS;CACT,kBAAkB;AACpB"}

package/dist/identity.cjs

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#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
+exports.containerName = containerName;
+exports.identity = identity;
+exports.remoteName = remoteName;
+//# sourceMappingURL=identity.cjs.map

package/dist/identity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.cjs","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/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,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+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 +22,14 @@ 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.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,9 @@
-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 { ModuleFederationError, PluginLoadFailureInfo, PluginRuntimeError, ValidationError, classifyPluginFailure, 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, createPlugin, withPlugins } from "./plugin.cjs";
+import { AnyPlugin, EveryPlugin, InitializedPlugin, LoadedPlugin, PluginClientType, PluginConfigInput, PluginContext, PluginContract, PluginInstance, PluginMetadata, PluginRegistry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, 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, ModuleFederationError, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, Plugin, type PluginClientType, PluginConfigFor, type PluginConfigInput, type PluginContext, type PluginContract, PluginEnv, PluginErrors, PluginIdTag, type PluginInstance, type PluginLoadFailureInfo, type PluginMetadata, type PluginRegistry, type PluginRouterType, PluginRuntime, type PluginRuntimeConfig, PluginRuntimeError, type PluginSecrets, type PluginServicesEntry, type PluginVariables, RATE_LIMITED, type RegisteredPlugins, SERVICE_UNAVAILABLE, type SecretsConfig, TIMEOUT, UNAUTHORIZED, type UsePluginResult, ValidationError, buildScoped, buildScopedContext, classifyPluginFailure, createPlugin, createPluginRuntime, extractFromFiberFailure, formatORPCError, remoteName as getNormalizedRemoteName, toPluginRuntimeError, withPlugins, wrapORPCError };

package/dist/index.d.mts

@@ -1,7 +1,9 @@
-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 { ModuleFederationError, PluginLoadFailureInfo, PluginRuntimeError, ValidationError, classifyPluginFailure, 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, createPlugin, withPlugins } from "./plugin.mjs";
+import { AnyPlugin, EveryPlugin, InitializedPlugin, LoadedPlugin, PluginClientType, PluginConfigInput, PluginContext, PluginContract, PluginInstance, PluginMetadata, PluginRegistry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, 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, ModuleFederationError, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, Plugin, type PluginClientType, PluginConfigFor, type PluginConfigInput, type PluginContext, type PluginContract, PluginEnv, PluginErrors, PluginIdTag, type PluginInstance, type PluginLoadFailureInfo, type PluginMetadata, type PluginRegistry, type PluginRouterType, PluginRuntime, type PluginRuntimeConfig, PluginRuntimeError, type PluginSecrets, type PluginServicesEntry, type PluginVariables, RATE_LIMITED, type RegisteredPlugins, SERVICE_UNAVAILABLE, type SecretsConfig, TIMEOUT, UNAUTHORIZED, type UsePluginResult, ValidationError, buildScoped, buildScopedContext, classifyPluginFailure, createPlugin, createPluginRuntime, extractFromFiberFailure, formatORPCError, remoteName as getNormalizedRemoteName, toPluginRuntimeError, withPlugins, wrapORPCError };

package/dist/index.mjs

@@ -1,7 +1,9 @@
-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 { buildScoped, buildScopedContext } from "./effect-helpers.mjs";
+import { ModuleFederationError, PluginRuntimeError, ValidationError, classifyPluginFailure, 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, 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,15 @@ 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;
+		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 +32,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 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\ntype PluginInitializeInput<V extends AnySchema, S extends AnySchema> = {\n  variables: InferSchemaOutput<V>;\n  secrets: InferSchemaOutput<S>;\n};\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   * 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\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\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":";;;;;;AA0BA,IAAa,cAAb,cAAiCA,eAAQ,QAA6B,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAiHrF,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;EAE9B,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 { PluginRuntimeError } from "./runtime/errors.cjs";
+import { ContractedRouter, Implementer } from "@orpc/server";
 import { Context, Effect, Layer, Scope } from "effect";
 import { AnyContractRouter, AnySchema, InferSchemaOutput } from "@orpc/contract";
-import { Implementer, Router } from "@orpc/server";
+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> = {
@@ -12,65 +15,81 @@ type PluginInitializeInput<V extends AnySchema, S extends AnySchema> = {
   variables: InferSchemaOutput<V>;
   secrets: InferSchemaOutput<S>;
 };
+declare const PluginIdTag_base: Context.ServiceClass<PluginIdTag, "PluginId", string>;
+declare class PluginIdTag extends PluginIdTag_base {}
 /**
- * Tools provided to plugin initialize/services for building long-lived scoped resources.
+ * The `initialize` effect's environment: the plugin lifecycle scope plus the
+ * framework-assigned plugin id.
  */
-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>;
-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>> = {
+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>;
+  /**
+   * 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>;
+  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, 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":";;;;;;;KASK,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;;;cAGhB,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;;;;;;;;;EAStB,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;EAE/B,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;KAkEf,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"}