every-plugin 3.0.0-rc.3 → 3.0.0-rc.4

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { createRpcClient } from "./client.mjs";
 import { buildScoped, buildScopedContext } from "./effect-helpers.mjs";
 import { ModuleFederationError, PluginRuntimeError, ValidationError, classifyPluginFailure, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, toPluginRuntimeError, wrapORPCError } from "./runtime/errors.mjs";
 import { BAD_REQUEST, CONNECTION_ERROR, FORBIDDEN, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, PluginErrors, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED } from "./errors.mjs";
@@ -6,4 +7,4 @@ import { remoteName } from "./identity.mjs";
 import { PluginRuntime, createPluginRuntime } from "./runtime/index.mjs";
 import "@orpc/openapi/extensions/route";
 
-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, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, remoteName as getNormalizedRemoteName, toPluginRuntimeError, withPlugins, wrapORPCError };
+export { BAD_REQUEST, CONNECTION_ERROR, FORBIDDEN, ModuleFederationError, NOT_FOUND, PLUGIN_ERROR_STATUS_MAP, PluginErrors, PluginIdTag, PluginRuntime, PluginRuntimeError, RATE_LIMITED, SERVICE_UNAVAILABLE, TIMEOUT, UNAUTHORIZED, ValidationError, buildScoped, buildScopedContext, classifyPluginFailure, createPlugin, createPluginRuntime, createRpcClient, defaultMissingSecretWarnings, extractFromFiberFailure, formatORPCError, remoteName as getNormalizedRemoteName, toPluginRuntimeError, withPlugins, wrapORPCError };

package/dist/plugin.d.cts

@@ -1,7 +1,7 @@
 import { PluginRuntimeError, PluginWarningInfo } from "./runtime/errors.cjs";
+import { AnyContractRouter, AnySchema, InferSchemaOutput } from "@orpc/contract";
 import { ContractedRouter, Implementer } from "@orpc/server";
 import { Context, Effect, Layer, Scope } from "effect";
-import { AnyContractRouter, AnySchema, InferSchemaOutput } from "@orpc/contract";
 import { WithEffectContext } from "@orpc/experimental-effect";
 import "@orpc/experimental-effect/extensions/effect";
 //#region src/plugin.d.ts

package/dist/runtime/mf-config.cjs

@@ -3,7 +3,7 @@ const require_shared_deps_spec = require('../shared-deps-spec.cjs');
 let node_fs = require("node:fs");
 
 //#region src/runtime/mf-config.ts
-const PLUGIN_VERSION = "3.0.0-rc.3";
+const PLUGIN_VERSION = "3.0.0-rc.4";
 const MF_CORE_SHARED_DEPS = require_shared_deps_spec.buildMfCoreSharedDependencies({ ownVersion: PLUGIN_VERSION });
 
 //#endregion

package/dist/runtime/mf-config.mjs

@@ -2,7 +2,7 @@ import { buildMfCoreSharedDependencies } from "../shared-deps-spec.mjs";
 import { readFileSync } from "node:fs";
 
 //#region src/runtime/mf-config.ts
-const PLUGIN_VERSION = "3.0.0-rc.3";
+const PLUGIN_VERSION = "3.0.0-rc.4";
 const MF_CORE_SHARED_DEPS = buildMfCoreSharedDependencies({ ownVersion: PLUGIN_VERSION });
 
 //#endregion

package/dist/runtime/services/plugin-loader.service.d.cts

@@ -2,5 +2,5 @@ import "../errors.cjs";
 import "../../types.cjs";
 import "./module-federation.service.cjs";
 import "./secrets.service.cjs";
-import { Context, Effect, Layer } from "effect";
-import { InferSchemaInput } from "@orpc/contract";
+import { InferSchemaInput } from "@orpc/contract";
+import { Context, Effect, Layer } from "effect";

package/dist/types.d.cts

@@ -1,8 +1,8 @@
 import { PluginWarningInfo } from "./runtime/errors.cjs";
 import { Plugin } from "./plugin.cjs";
+import { AnyContractRouter, AnySchema, InferSchemaInput, InferSchemaOutput } from "@orpc/contract";
 import { ContractedRouter, RouterClient } from "@orpc/server";
 import { Context, Scope } from "effect";
-import { AnyContractRouter, AnySchema, InferSchemaInput, InferSchemaOutput } from "@orpc/contract";
 //#region src/types.d.ts
 /**
  * Registry bindings interface - populated via module augmentation
@@ -17,6 +17,18 @@ import { AnyContractRouter, AnySchema, InferSchemaInput, InferSchemaOutput } fro
  * ```
  */
 interface RegisteredPlugins {}
+type ModuleTransport = "inproc" | "rpc" | "mf";
+type ModuleSurface = "api" | "ui" | "jobs";
+interface ModuleEndpoint {
+  readonly transport: ModuleTransport;
+  readonly surface?: ModuleSurface;
+  readonly url: string;
+  readonly path?: `/${string}`;
+  readonly manifest?: string;
+}
+type PluginTransport = ModuleTransport;
+type PluginSurface = ModuleSurface;
+type PluginEndpoint = ModuleEndpoint;
 /**
  * Base type for any plugin instance.
  */
@@ -39,10 +51,12 @@ type AnyPluginConstructor = {
 type PluginRegistryEntry = {
   module: AnyPluginConstructor;
   remote?: string;
+  endpoint?: PluginEndpoint;
   version?: string;
   description?: string;
 } | {
   remote: string;
+  endpoint?: PluginEndpoint;
   version?: string;
   description?: string;
 };
@@ -107,7 +121,14 @@ type PluginClientType<T> = RouterClient<PluginRouterType<T>>;
 type PluginServicesEntry<T = any> = {
   client: (context?: PluginContextInput<T>) => PluginClientType<T>;
   router: PluginRouterType<T>;
+  endpoint?: PluginEndpoint;
+};
+type ModuleClientEntry<C extends AnyContractRouter = AnyContractRouter> = {
+  client: (context?: Record<string, unknown>) => RouterClient<ContractedRouter<C, any>>;
+  router?: ContractedRouter<C, any>;
+  endpoint?: PluginEndpoint;
 };
+type PluginClientEntry<C extends AnyContractRouter = AnyContractRouter> = ModuleClientEntry<C>;
 /**
  * Extract plugin type from registered plugins by key
  * @param K - The plugin key
@@ -247,5 +268,5 @@ interface PluginRuntimeConfig<R extends Record<string, PluginRegistryEntry> = Re
   secrets?: SecretsConfig;
 }
 //#endregion
-export { AnyPlugin, AnyPluginConstructor, EveryPlugin, ExtractPluginType, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, PluginClientType, PluginConfigInput, PluginContext, PluginContextInput, PluginContract, PluginInstance, PluginMetadata, PluginRegistry, PluginRegistryEntry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, PluginVariables, RegisteredPlugin, RegisteredPlugins, SecretsConfig, UsePluginResult };
+export { AnyPlugin, AnyPluginConstructor, EveryPlugin, ExtractPluginType, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, ModuleClientEntry, ModuleEndpoint, ModuleSurface, ModuleTransport, PluginClientEntry, PluginClientType, PluginConfigInput, PluginContext, PluginContextInput, PluginContract, PluginEndpoint, PluginInstance, PluginMetadata, PluginRegistry, PluginRegistryEntry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, PluginSurface, PluginTransport, PluginVariables, RegisteredPlugin, RegisteredPlugins, SecretsConfig, UsePluginResult };
 //# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAwBiB;;;;KAKL,YAAY,OAAO,mBAAmB,WAAW,WAAW;;;;KAK5D;UACF;EACR;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;;;;;;KAOD;EACN,QAAQ;EAAsB;EAAiB;EAAkB;;EACjE;EAAgB;EAAkB;;;;;KAK5B,kBAAkB,KAAK;EAAY,cAAc;IAAM;;;;KAKvD,yBAAyB,UAAU,eAAe,2BAC3D,WAAW,IAAI,EAAE;EAAa,cAAc;IACzC,IACA,gBAAgB,oBACd,kBAAkB;;;;KAOd,eAAe,KAAK;EAC9B;IAAW,gBAAgB,UAAU;;IAEnC;;;;KAMQ,gBAAgB,KAAK;EAAY;IAAW,iBAAiB,UAAU;;IAC/E;;;;KAMQ,cAAc,KAAK;EAAY;IAAW,eAAe,UAAU;;IAC3E;;;;KAMQ,cAAc,KAAK;EAC7B;IAAW,eAAe,UAAU;;IAElC;;;;;KAOQ,iBAAiB,KAAK,iBAAiB,eAAe;;;;KAKtD,iBAAiB,KAAK,aAAa,iBAAiB;;;;;;KAOpD,oBAAoB;EAC9B,SAAS,UAAU,mBAAmB,OAAO,iBAAiB;EAC9D,QAAQ,iBAAiB;;;;;;;KAQf,iBAAiB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACzE,eAAe;IAEb;EACE,gBAAgB,UAAU;EAC1B,iBAAiB,UAAU;EAC3B,eAAe,UAAU;EACzB,eAAe,wBAAwB;IAEvC,OAAO,GAAG,GAAG,GAAG;;;;KAOV,mBAAmB,KAC7B,cAAc,WAAW,YAAY,iBAAiB,cAAc;;;;KAK1D,kBAAkB;EAC5B,WAAW,iBAAiB,gBAAgB;EAC5C,SAAS,iBAAiB,cAAc;;;;;KAM9B;WACD;WACA;WACA;;;;;KAMC,iBAAiB,eAAe;;;;;UAM3B;GACd;;;;;UAMc,aAAa,UAAU,YAAY;WACzC,gBAAgB;WAChB,UAAU;;;;;UAMJ,eAAe,UAAU,YAAY;WAC3C,QAAQ;WACR,UAAU;;;;;UAMJ,kBAAkB,UAAU,YAAY;WAC9C,QAAQ;WACR,UAAU;WACV;IACP,WAAW,kBAAkB;IAC7B,SAAS,kBAAkB;;;;;;;WAOpB,eAAe,QAAQ;WACvB,OAAO,MAAM;;WAEb,UAAU;;;;;KAMhB,oBAAoB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACrE,eAAe;IAEb;EACE,UAAU;EACV,WAAW;EACX,SAAS;EACT,SAAS;wBAGI,4IACF;;;;;;KAOL,gBAAgB,gBAAgB,GAAG,IAAI,qBACjD,oBAAoB,GAAG;WAER,eAAe,UAAU,mBAAmB,EAAE,QAAQ,iBAAiB,EAAE;WACzE,QAAQ,iBAAiB,EAAE;WAC3B,UAAU;WACV,aAAa,kBAAkB,iBAAiB,GAAG;IAE9D,oBAAoB,GAAG;;;;;;;KAQxB,WAAW,KAAK;EAAY,uBAAuB;IAAM,IAAI;;;;kBAKjD;;;;;;;;;;;;;;;;;;OAkBH,MACV,kBACA,SAAS,qBACP,gBAAgB,WAAW,UAAU,gBAAgB,GAAG,WAAW;;;;;UAMxD,oBACf,UAAU,eAAe,uBAAuB,eAAe;EAE/D,UAAU;EACV,UAAU"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAwBiB;KAEL;KAEA;UAEK;WACN,WAAW;WACX,UAAU;WACV;WACA;WACA;;KAGC,kBAAkB;KAElB,gBAAgB;KAEhB,iBAAiB;;;;KAKjB,YAAY,OAAO,mBAAmB,WAAW,WAAW;;;;KAK5D;UACF;EACR;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;;;;;;KAOD;EAEN,QAAQ;EACR;EACA,WAAW;EACX;EACA;;EAEA;EAAgB,WAAW;EAAgB;EAAkB;;;;;KAKvD,kBAAkB,KAAK;EAAY,cAAc;IAAM;;;;KAKvD,yBAAyB,UAAU,eAAe,2BAC3D,WAAW,IAAI,EAAE;EAAa,cAAc;IACzC,IACA,gBAAgB,oBACd,kBAAkB;;;;KAOd,eAAe,KAAK;EAC9B;IAAW,gBAAgB,UAAU;;IAEnC;;;;KAMQ,gBAAgB,KAAK;EAAY;IAAW,iBAAiB,UAAU;;IAC/E;;;;KAMQ,cAAc,KAAK;EAAY;IAAW,eAAe,UAAU;;IAC3E;;;;KAMQ,cAAc,KAAK;EAC7B;IAAW,eAAe,UAAU;;IAElC;;;;;KAOQ,iBAAiB,KAAK,iBAAiB,eAAe;;;;KAKtD,iBAAiB,KAAK,aAAa,iBAAiB;;;;;;KAOpD,oBAAoB;EAC9B,SAAS,UAAU,mBAAmB,OAAO,iBAAiB;EAC9D,QAAQ,iBAAiB;EACzB,WAAW;;KAGD,kBAAkB,UAAU,oBAAoB;EAC1D,SAAS,UAAU,4BAA4B,aAAa,iBAAiB;EAC7E,SAAS,iBAAiB;EAC1B,WAAW;;KAGD,kBAAkB,UAAU,oBAAoB,qBAC1D,kBAAkB;;;;;;KAOR,iBAAiB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACzE,eAAe;IAEb;EACE,gBAAgB,UAAU;EAC1B,iBAAiB,UAAU;EAC3B,eAAe,UAAU;EACzB,eAAe,wBAAwB;IAEvC,OAAO,GAAG,GAAG,GAAG;;;;KAOV,mBAAmB,KAC7B,cAAc,WAAW,YAAY,iBAAiB,cAAc;;;;KAK1D,kBAAkB;EAC5B,WAAW,iBAAiB,gBAAgB;EAC5C,SAAS,iBAAiB,cAAc;;;;;KAM9B;WACD;WACA;WACA;;;;;KAMC,iBAAiB,eAAe;;;;;UAM3B;GACd;;;;;UAMc,aAAa,UAAU,YAAY;WACzC,gBAAgB;WAChB,UAAU;;;;;UAMJ,eAAe,UAAU,YAAY;WAC3C,QAAQ;WACR,UAAU;;;;;UAMJ,kBAAkB,UAAU,YAAY;WAC9C,QAAQ;WACR,UAAU;WACV;IACP,WAAW,kBAAkB;IAC7B,SAAS,kBAAkB;;;;;;;WAOpB,eAAe,QAAQ;WACvB,OAAO,MAAM;;WAEb,UAAU;;;;;KAMhB,oBAAoB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACrE,eAAe;IAEb;EACE,UAAU;EACV,WAAW;EACX,SAAS;EACT,SAAS;wBAGI,4IACF;;;;;;KAOL,gBAAgB,gBAAgB,GAAG,IAAI,qBACjD,oBAAoB,GAAG;WAER,eAAe,UAAU,mBAAmB,EAAE,QAAQ,iBAAiB,EAAE;WACzE,QAAQ,iBAAiB,EAAE;WAC3B,UAAU;WACV,aAAa,kBAAkB,iBAAiB,GAAG;IAE9D,oBAAoB,GAAG;;;;;;;KAQxB,WAAW,KAAK;EAAY,uBAAuB;IAAM,IAAI;;;;kBAKjD;;;;;;;;;;;;;;;;;;OAkBH,MACV,kBACA,SAAS,qBACP,gBAAgB,WAAW,UAAU,gBAAgB,GAAG,WAAW;;;;;UAMxD,oBACf,UAAU,eAAe,uBAAuB,eAAe;EAE/D,UAAU;EACV,UAAU"}

package/dist/types.d.mts

@@ -17,6 +17,18 @@ import { AnyContractRouter, AnySchema, InferSchemaInput, InferSchemaOutput } fro
  * ```
  */
 interface RegisteredPlugins {}
+type ModuleTransport = "inproc" | "rpc" | "mf";
+type ModuleSurface = "api" | "ui" | "jobs";
+interface ModuleEndpoint {
+  readonly transport: ModuleTransport;
+  readonly surface?: ModuleSurface;
+  readonly url: string;
+  readonly path?: `/${string}`;
+  readonly manifest?: string;
+}
+type PluginTransport = ModuleTransport;
+type PluginSurface = ModuleSurface;
+type PluginEndpoint = ModuleEndpoint;
 /**
  * Base type for any plugin instance.
  */
@@ -39,10 +51,12 @@ type AnyPluginConstructor = {
 type PluginRegistryEntry = {
   module: AnyPluginConstructor;
   remote?: string;
+  endpoint?: PluginEndpoint;
   version?: string;
   description?: string;
 } | {
   remote: string;
+  endpoint?: PluginEndpoint;
   version?: string;
   description?: string;
 };
@@ -107,7 +121,14 @@ type PluginClientType<T> = RouterClient<PluginRouterType<T>>;
 type PluginServicesEntry<T = any> = {
   client: (context?: PluginContextInput<T>) => PluginClientType<T>;
   router: PluginRouterType<T>;
+  endpoint?: PluginEndpoint;
+};
+type ModuleClientEntry<C extends AnyContractRouter = AnyContractRouter> = {
+  client: (context?: Record<string, unknown>) => RouterClient<ContractedRouter<C, any>>;
+  router?: ContractedRouter<C, any>;
+  endpoint?: PluginEndpoint;
 };
+type PluginClientEntry<C extends AnyContractRouter = AnyContractRouter> = ModuleClientEntry<C>;
 /**
  * Extract plugin type from registered plugins by key
  * @param K - The plugin key
@@ -247,5 +268,5 @@ interface PluginRuntimeConfig<R extends Record<string, PluginRegistryEntry> = Re
   secrets?: SecretsConfig;
 }
 //#endregion
-export { AnyPlugin, AnyPluginConstructor, EveryPlugin, ExtractPluginType, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, PluginClientType, PluginConfigInput, PluginContext, PluginContextInput, PluginContract, PluginInstance, PluginMetadata, PluginRegistry, PluginRegistryEntry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, PluginVariables, RegisteredPlugin, RegisteredPlugins, SecretsConfig, UsePluginResult };
+export { AnyPlugin, AnyPluginConstructor, EveryPlugin, ExtractPluginType, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, ModuleClientEntry, ModuleEndpoint, ModuleSurface, ModuleTransport, PluginClientEntry, PluginClientType, PluginConfigInput, PluginContext, PluginContextInput, PluginContract, PluginEndpoint, PluginInstance, PluginMetadata, PluginRegistry, PluginRegistryEntry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, PluginSurface, PluginTransport, PluginVariables, RegisteredPlugin, RegisteredPlugins, SecretsConfig, UsePluginResult };
 //# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAwBiB;;;;KAKL,YAAY,OAAO,mBAAmB,WAAW,WAAW;;;;KAK5D;UACF;EACR;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;;;;;;KAOD;EACN,QAAQ;EAAsB;EAAiB;EAAkB;;EACjE;EAAgB;EAAkB;;;;;KAK5B,kBAAkB,KAAK;EAAY,cAAc;IAAM;;;;KAKvD,yBAAyB,UAAU,eAAe,2BAC3D,WAAW,IAAI,EAAE;EAAa,cAAc;IACzC,IACA,gBAAgB,oBACd,kBAAkB;;;;KAOd,eAAe,KAAK;EAC9B;IAAW,gBAAgB,UAAU;;IAEnC;;;;KAMQ,gBAAgB,KAAK;EAAY;IAAW,iBAAiB,UAAU;;IAC/E;;;;KAMQ,cAAc,KAAK;EAAY;IAAW,eAAe,UAAU;;IAC3E;;;;KAMQ,cAAc,KAAK;EAC7B;IAAW,eAAe,UAAU;;IAElC;;;;;KAOQ,iBAAiB,KAAK,iBAAiB,eAAe;;;;KAKtD,iBAAiB,KAAK,aAAa,iBAAiB;;;;;;KAOpD,oBAAoB;EAC9B,SAAS,UAAU,mBAAmB,OAAO,iBAAiB;EAC9D,QAAQ,iBAAiB;;;;;;;KAQf,iBAAiB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACzE,eAAe;IAEb;EACE,gBAAgB,UAAU;EAC1B,iBAAiB,UAAU;EAC3B,eAAe,UAAU;EACzB,eAAe,wBAAwB;IAEvC,OAAO,GAAG,GAAG,GAAG;;;;KAOV,mBAAmB,KAC7B,cAAc,WAAW,YAAY,iBAAiB,cAAc;;;;KAK1D,kBAAkB;EAC5B,WAAW,iBAAiB,gBAAgB;EAC5C,SAAS,iBAAiB,cAAc;;;;;KAM9B;WACD;WACA;WACA;;;;;KAMC,iBAAiB,eAAe;;;;;UAM3B;GACd;;;;;UAMc,aAAa,UAAU,YAAY;WACzC,gBAAgB;WAChB,UAAU;;;;;UAMJ,eAAe,UAAU,YAAY;WAC3C,QAAQ;WACR,UAAU;;;;;UAMJ,kBAAkB,UAAU,YAAY;WAC9C,QAAQ;WACR,UAAU;WACV;IACP,WAAW,kBAAkB;IAC7B,SAAS,kBAAkB;;;;;;;WAOpB,eAAe,QAAQ;WACvB,OAAO,MAAM;;WAEb,UAAU;;;;;KAMhB,oBAAoB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACrE,eAAe;IAEb;EACE,UAAU;EACV,WAAW;EACX,SAAS;EACT,SAAS;wBAGI,4IACF;;;;;;KAOL,gBAAgB,gBAAgB,GAAG,IAAI,qBACjD,oBAAoB,GAAG;WAER,eAAe,UAAU,mBAAmB,EAAE,QAAQ,iBAAiB,EAAE;WACzE,QAAQ,iBAAiB,EAAE;WAC3B,UAAU;WACV,aAAa,kBAAkB,iBAAiB,GAAG;IAE9D,oBAAoB,GAAG;;;;;;;KAQxB,WAAW,KAAK;EAAY,uBAAuB;IAAM,IAAI;;;;kBAKjD;;;;;;;;;;;;;;;;;;OAkBH,MACV,kBACA,SAAS,qBACP,gBAAgB,WAAW,UAAU,gBAAgB,GAAG,WAAW;;;;;UAMxD,oBACf,UAAU,eAAe,uBAAuB,eAAe;EAE/D,UAAU;EACV,UAAU"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAwBiB;KAEL;KAEA;UAEK;WACN,WAAW;WACX,UAAU;WACV;WACA;WACA;;KAGC,kBAAkB;KAElB,gBAAgB;KAEhB,iBAAiB;;;;KAKjB,YAAY,OAAO,mBAAmB,WAAW,WAAW;;;;KAK5D;UACF;EACR;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;;;;;;KAOD;EAEN,QAAQ;EACR;EACA,WAAW;EACX;EACA;;EAEA;EAAgB,WAAW;EAAgB;EAAkB;;;;;KAKvD,kBAAkB,KAAK;EAAY,cAAc;IAAM;;;;KAKvD,yBAAyB,UAAU,eAAe,2BAC3D,WAAW,IAAI,EAAE;EAAa,cAAc;IACzC,IACA,gBAAgB,oBACd,kBAAkB;;;;KAOd,eAAe,KAAK;EAC9B;IAAW,gBAAgB,UAAU;;IAEnC;;;;KAMQ,gBAAgB,KAAK;EAAY;IAAW,iBAAiB,UAAU;;IAC/E;;;;KAMQ,cAAc,KAAK;EAAY;IAAW,eAAe,UAAU;;IAC3E;;;;KAMQ,cAAc,KAAK;EAC7B;IAAW,eAAe,UAAU;;IAElC;;;;;KAOQ,iBAAiB,KAAK,iBAAiB,eAAe;;;;KAKtD,iBAAiB,KAAK,aAAa,iBAAiB;;;;;;KAOpD,oBAAoB;EAC9B,SAAS,UAAU,mBAAmB,OAAO,iBAAiB;EAC9D,QAAQ,iBAAiB;EACzB,WAAW;;KAGD,kBAAkB,UAAU,oBAAoB;EAC1D,SAAS,UAAU,4BAA4B,aAAa,iBAAiB;EAC7E,SAAS,iBAAiB;EAC1B,WAAW;;KAGD,kBAAkB,UAAU,oBAAoB,qBAC1D,kBAAkB;;;;;;KAOR,iBAAiB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACzE,eAAe;IAEb;EACE,gBAAgB,UAAU;EAC1B,iBAAiB,UAAU;EAC3B,eAAe,UAAU;EACzB,eAAe,wBAAwB;IAEvC,OAAO,GAAG,GAAG,GAAG;;;;KAOV,mBAAmB,KAC7B,cAAc,WAAW,YAAY,iBAAiB,cAAc;;;;KAK1D,kBAAkB;EAC5B,WAAW,iBAAiB,gBAAgB;EAC5C,SAAS,iBAAiB,cAAc;;;;;KAM9B;WACD;WACA;WACA;;;;;KAMC,iBAAiB,eAAe;;;;;UAM3B;GACd;;;;;UAMc,aAAa,UAAU,YAAY;WACzC,gBAAgB;WAChB,UAAU;;;;;UAMJ,eAAe,UAAU,YAAY;WAC3C,QAAQ;WACR,UAAU;;;;;UAMJ,kBAAkB,UAAU,YAAY;WAC9C,QAAQ;WACR,UAAU;WACV;IACP,WAAW,kBAAkB;IAC7B,SAAS,kBAAkB;;;;;;;WAOpB,eAAe,QAAQ;WACvB,OAAO,MAAM;;WAEb,UAAU;;;;;KAMhB,oBAAoB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACrE,eAAe;IAEb;EACE,UAAU;EACV,WAAW;EACX,SAAS;EACT,SAAS;wBAGI,4IACF;;;;;;KAOL,gBAAgB,gBAAgB,GAAG,IAAI,qBACjD,oBAAoB,GAAG;WAER,eAAe,UAAU,mBAAmB,EAAE,QAAQ,iBAAiB,EAAE;WACzE,QAAQ,iBAAiB,EAAE;WAC3B,UAAU;WACV,aAAa,kBAAkB,iBAAiB,GAAG;IAE9D,oBAAoB,GAAG;;;;;;;KAQxB,WAAW,KAAK;EAAY,uBAAuB;IAAM,IAAI;;;;kBAKjD;;;;;;;;;;;;;;;;;;OAkBH,MACV,kBACA,SAAS,qBACP,gBAAgB,WAAW,UAAU,gBAAgB,GAAG,WAAW;;;;;UAMxD,oBACf,UAAU,eAAe,uBAAuB,eAAe;EAE/D,UAAU;EACV,UAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "every-plugin",
-  "version": "3.0.0-rc.3",
+  "version": "3.0.0-rc.4",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -18,6 +18,14 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
+    "./client": {
+      "bun": {
+        "types": "./src/client.ts",
+        "import": "./src/client.ts"
+      },
+      "types": "./dist/client.d.mts",
+      "import": "./dist/client.mjs"
+    },
     "./identity": {
       "bun": {
         "types": "./src/identity.ts",
@@ -144,6 +152,14 @@
       "import": "./dist/build/ui/index.mjs",
       "require": "./dist/build/ui/index.cjs"
     },
+    "./dev-host": {
+      "bun": {
+        "types": "./src/dev/host.ts",
+        "import": "./src/dev/host.ts"
+      },
+      "types": "./dist/dev/host.d.mts",
+      "import": "./dist/dev/host.mjs"
+    },
     "./dev-serve": {
       "bun": {
         "types": "./src/dev/serve.ts",
@@ -222,7 +238,8 @@
     "@rsbuild/plugin-react": "2.1.0",
     "@tanstack/router-generator": "1.167.33",
     "@tanstack/router-plugin": "1.168.35",
-    "sirv": "3.0.2"
+    "sirv": "3.0.2",
+    "sonner": ">=2.0.0"
   },
   "keywords": [
     "plugin",

package/src/client.ts

@@ -0,0 +1,111 @@
+import { createORPCClient, onError } from "@orpc/client";
+import { RPCLink } from "@orpc/client/fetch";
+import type { ContractRouterClient, RouterContract } from "@orpc/contract";
+
+export type RpcConnectionErrorCopy = () => { title: string; description: string };
+
+export interface RpcClientConfig {
+  hostUrl: string;
+  path: `/${string}`;
+  connectionError?: RpcConnectionErrorCopy;
+}
+
+const RATE_LIMIT_MAX_RETRIES = 3;
+const RATE_LIMIT_RETRY_CAP_MS = 2_000;
+const browserClients = new Map<string, unknown>();
+type FetchInput = Parameters<typeof fetch>[0];
+
+async function fetchWithRateLimitRetry(
+  fetchUrl: FetchInput,
+  options?: RequestInit,
+): Promise<Response> {
+  let response = await fetch(fetchUrl, options);
+  for (let attempt = 1; attempt <= RATE_LIMIT_MAX_RETRIES && response.status === 429; attempt++) {
+    const retryAfterSeconds = Number(response.headers.get("retry-after"));
+    const delay =
+      Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0
+        ? Math.min(retryAfterSeconds * 1000, RATE_LIMIT_RETRY_CAP_MS)
+        : 100 * attempt;
+    await new Promise((resolve) => setTimeout(resolve, delay));
+    response = await fetch(fetchUrl, options);
+  }
+
+  return response;
+}
+
+function createRpcLink(config: RpcClientConfig, headers?: Headers) {
+  return new RPCLink({
+    origin: config.hostUrl,
+    url: config.path,
+    interceptors: [
+      onError((error: unknown) => {
+        const browserWindow = (globalThis as { window?: unknown }).window;
+        if (typeof browserWindow === "undefined") {
+          return;
+        }
+
+        if (error && typeof error === "object" && "message" in error) {
+          const message = String(error.message).toLowerCase();
+          if (
+            message.includes("fetch") ||
+            message.includes("network") ||
+            message.includes("failed to fetch")
+          ) {
+            void import("sonner")
+              .then(({ toast }) => {
+                const message = config.connectionError?.() ?? {
+                  title: "Unable to connect to API",
+                  description: "The API is currently unavailable. Please try again later.",
+                };
+                toast.error(message.title, {
+                  id: "api-connection-error",
+                  description: message.description,
+                });
+              })
+              .catch(() => {});
+          }
+        }
+      }),
+    ],
+    fetch(fetchUrl: FetchInput, options?: RequestInit) {
+      return fetchWithRateLimitRetry(fetchUrl, {
+        ...options,
+        credentials: "include",
+        headers: headers
+          ? { ...Object.fromEntries(headers), ...(options?.headers as Record<string, string>) }
+          : options?.headers,
+      });
+    },
+  });
+}
+
+function buildRpcClient<T extends RouterContract>(
+  config: RpcClientConfig,
+  headers?: Headers,
+): ContractRouterClient<T> {
+  if (!config.hostUrl) {
+    throw new Error("Missing runtime host URL");
+  }
+
+  return createORPCClient(createRpcLink(config, headers)) as ContractRouterClient<T>;
+}
+
+export function createRpcClient<T extends RouterContract = RouterContract>(
+  config: RpcClientConfig,
+  headers?: Headers,
+): ContractRouterClient<T> {
+  const browserWindow = (globalThis as { window?: unknown }).window;
+  if (typeof browserWindow !== "undefined" && !headers) {
+    const key = `${config.hostUrl}${config.path}`;
+    const memoized = browserClients.get(key);
+    if (memoized) {
+      return memoized as ContractRouterClient<T>;
+    }
+
+    const client = buildRpcClient<T>(config, headers);
+    browserClients.set(key, client);
+    return client;
+  }
+
+  return buildRpcClient<T>(config, headers);
+}

package/src/dev/host.ts

@@ -0,0 +1,235 @@
+import type http from "node:http";
+import { createServer } from "node:http";
+
+const corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, PATCH, OPTIONS",
+  "Access-Control-Allow-Headers": "X-Requested-With, content-type, Authorization",
+};
+
+const applyCorsHeaders = (res: http.ServerResponse) => {
+  Object.entries(corsHeaders).forEach(([key, value]) => {
+    res.setHeader(key, value);
+  });
+};
+
+const sendJson = (res: http.ServerResponse, status: number, body: unknown) => {
+  res.statusCode = status;
+  res.setHeader("content-type", "application/json; charset=utf-8");
+  res.end(JSON.stringify(body));
+};
+
+const sendText = (res: http.ServerResponse, status: number, text: string) => {
+  res.statusCode = status;
+  res.setHeader("content-type", "text/plain; charset=utf-8");
+  res.end(text);
+};
+
+const pathnameOf = (req: http.IncomingMessage): string =>
+  ((req.url ?? "/").split("?")[0] ?? "/").replace(/\/+$/, "") || "/";
+
+const toWebRequest = (req: http.IncomingMessage, port: number): Request => {
+  const url = `http://localhost:${port}${req.url}`;
+  return new Request(url, {
+    method: req.method,
+    headers: req.headers,
+    body: req.method !== "GET" && req.method !== "HEAD" ? req : undefined,
+    duplex: req.method !== "GET" && req.method !== "HEAD" ? "half" : undefined,
+  } as RequestInit);
+};
+
+const buildHostContext = (
+  effectContext: unknown,
+  webRequest: Request,
+  cachedRawBodyRef: { value: string | null },
+) => {
+  const rawClone =
+    webRequest.method === "GET" || webRequest.method === "HEAD" ? null : webRequest.clone();
+
+  return {
+    reqHeaders: webRequest.headers,
+    "effect/context": effectContext,
+    getRawBody: async (): Promise<string> => {
+      if (cachedRawBodyRef.value !== null) return cachedRawBodyRef.value;
+      if (!rawClone) {
+        cachedRawBodyRef.value = "";
+        return cachedRawBodyRef.value;
+      }
+      cachedRawBodyRef.value = await rawClone.text();
+      return cachedRawBodyRef.value;
+    },
+  };
+};
+
+export interface DirectModuleHostHandler {
+  handle(
+    request: Request,
+    options: { prefix: string; context: unknown },
+  ): Promise<{ response?: Response }>;
+}
+
+const handleOrpc = async (
+  req: http.IncomingMessage,
+  res: http.ServerResponse,
+  handler: DirectModuleHostHandler,
+  prefix: string,
+  errorLabel: string,
+  effectContext: unknown,
+  port: number,
+) => {
+  try {
+    const webRequest = toWebRequest(req, port);
+    const cachedRawBodyRef = { value: null as string | null };
+    const result = await handler.handle(webRequest, {
+      prefix,
+      context: buildHostContext(effectContext, webRequest, cachedRawBodyRef),
+    });
+
+    if (result.response) {
+      res.statusCode = result.response.status;
+      result.response.headers.forEach((value: string, key: string) => {
+        res.setHeader(key, value);
+      });
+      const text = await result.response.text();
+      if (!res.getHeader("content-length")) {
+        res.setHeader("content-length", Buffer.byteLength(text).toString());
+      }
+      res.end(text);
+    } else {
+      sendText(res, 404, "Not Found");
+    }
+  } catch (error) {
+    console.error(`${errorLabel} error:`, error);
+    sendJson(res, 500, { error: (error as Error).message });
+  }
+};
+
+export interface DirectModuleHostHandlers {
+  rpc: DirectModuleHostHandler | null;
+  api: DirectModuleHostHandler | null;
+}
+
+export interface DirectModuleHostOptions {
+  name: string;
+  handlers: DirectModuleHostHandlers;
+  effectContext: unknown;
+  port?: number;
+  version?: string;
+  rpcPrefix?: `/${string}`;
+  apiPrefix?: `/${string}`;
+  staticHandler?:
+    | ((req: http.IncomingMessage, res: http.ServerResponse, next: () => void) => void)
+    | null;
+}
+
+export interface DirectModuleHostHandle {
+  port: number;
+  close: () => Promise<void>;
+}
+
+export async function startDirectModuleHost(
+  options: DirectModuleHostOptions,
+): Promise<DirectModuleHostHandle> {
+  const port = options.port ?? 0;
+  let resolvedPort = port;
+  const rpcPrefix = options.rpcPrefix ?? "/api/rpc";
+  const apiPrefix = options.apiPrefix ?? "/api";
+  const staticHandler = options.staticHandler ?? null;
+  const resolveEffectContext: () => unknown =
+    typeof options.effectContext === "function"
+      ? (options.effectContext as () => unknown)
+      : () => options.effectContext;
+
+  const server = createServer((req, res) => {
+    applyCorsHeaders(res);
+    const pathname = pathnameOf(req);
+
+    if (req.method === "OPTIONS") {
+      res.statusCode = 200;
+      res.end();
+      return;
+    }
+
+    if (pathname === "/" && (req.method === "GET" || req.method === "HEAD")) {
+      sendJson(res, 200, {
+        ok: true,
+        module: options.name,
+        version: options.version,
+        status: options.handlers.rpc ? "ready" : "loading",
+        endpoints: {
+          health: "/health",
+          docs: apiPrefix,
+          rpc: rpcPrefix,
+        },
+      });
+      return;
+    }
+
+    if (pathname === "/health" && (req.method === "GET" || req.method === "HEAD")) {
+      sendText(res, 200, "OK");
+      return;
+    }
+
+    if (pathname.startsWith(`${rpcPrefix}/`)) {
+      if (!options.handlers.rpc) {
+        sendJson(res, 503, { error: "Plugin still loading..." });
+        return;
+      }
+      handleOrpc(
+        req,
+        res,
+        options.handlers.rpc,
+        rpcPrefix,
+        "RPC",
+        resolveEffectContext(),
+        resolvedPort,
+      ).catch(() => {});
+      return;
+    }
+
+    if (pathname === apiPrefix || pathname.startsWith(`${apiPrefix}/`)) {
+      if (!options.handlers.api) {
+        sendJson(res, 503, { error: "Plugin still loading..." });
+        return;
+      }
+      handleOrpc(
+        req,
+        res,
+        options.handlers.api,
+        apiPrefix,
+        "OpenAPI",
+        resolveEffectContext(),
+        resolvedPort,
+      ).catch(() => {});
+      return;
+    }
+
+    if (staticHandler) {
+      staticHandler(req, res, () => {
+        sendText(res, 404, "Not Found");
+      });
+      return;
+    }
+
+    sendText(res, 404, "Not Found");
+  });
+
+  await new Promise<void>((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(port, () => resolve());
+  });
+
+  const address = server.address();
+  if (!address || typeof address === "string") {
+    await new Promise<void>((resolve) => server.close(() => resolve()));
+    throw new Error("Failed to resolve host port");
+  }
+  resolvedPort = address.port;
+
+  return {
+    port: resolvedPort,
+    close: async () => {
+      await new Promise<void>((resolve) => server.close(() => resolve()));
+    },
+  };
+}