mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-08-22 23:22:09 +03:00
233ac40e9d
* test(sse): golden characterization of the executor map before the R0.3 registry refactor Freezes the 137-entry provider-id → executor mapping (class, provider identity, backing PROVIDERS config), the no-shared-instances invariant, and the getExecutor() dispatch rules (memoized DefaultExecutor fallback, cloud-agent guard #6699, search-provider guard #10274) as stable JSON snapshots. The upcoming ExecutorRegistry must keep both snapshots byte-identical. * refactor(sse): route executor lookup through ExecutorRegistry (R0.3) Adds open-sse/executors/registry.ts (Map-based registry mirroring translator/registry.ts): the built-in table in executors/index.ts stays declarative, every entry is registered at module load, and getExecutor()/hasSpecializedExecutor() resolve through the registry. DefaultExecutor fallback, its memoization, and the cloud-agent (#6699) / search-provider (#10274) guards are unchanged. Also fixes a latent lookup leak: the old object-literal lookup treated Object.prototype names (constructor, toString, ...) as specialized executors; the Map registry resolves them to the DefaultExecutor fallback like any unknown provider. Parity proof: executor-map golden (137 entries, byte-identical before/after), check:known-symbols green, 1018 tests across the 65 executor test files green. Docs: OPEN_SSE_ARCHITECTURE factory section corrected (it claimed generation from providerRegistry). Refs #3501 * test(executors): regenerate ExecutorRegistry golden snapshots after release sync release/v3.8.50 sunset mimocode and added cloudflare-playground + jina-search since this PR's snapshots were captured; refresh the golden fixtures to match. --------- Co-authored-by: Xiangzhe <bakryun0718@proton.me> Co-authored-by: Markus Hartung <mail@hartmark.se> Co-authored-by: adevwithpurpose <adevwithpurpose@users.noreply.github.com>
39 lines
1.4 KiB
TypeScript
39 lines
1.4 KiB
TypeScript
import type { BaseExecutor } from "./base.ts";
|
|
|
|
// R0.3 — ExecutorRegistry: runtime registry for provider executors, mirroring
|
|
// open-sse/translator/registry.ts. Built-ins register at module load from
|
|
// executors/index.ts; getExecutor() resolves through this map instead of a
|
|
// hard-coded object literal. This is the seam the v4 plan (M1.6
|
|
// host.registerProvider) extends — today the surface is internal-only.
|
|
//
|
|
// The alias → executor mapping is characterized by
|
|
// tests/unit/executor-map-golden.test.ts (tests/snapshots/executors/): any
|
|
// change to keys, classes or instance sharing shows up as a golden diff.
|
|
|
|
const registry = new Map<string, BaseExecutor>();
|
|
|
|
/**
|
|
* Register an executor under an alias. Aliases are unique: registering the
|
|
* same alias twice throws, preserving the guarantee the old object literal
|
|
* gave at compile time (duplicate keys were impossible).
|
|
*/
|
|
export function registerExecutor(alias: string, executor: BaseExecutor): void {
|
|
if (registry.has(alias)) {
|
|
throw new Error(`executor alias already registered: "${alias}"`);
|
|
}
|
|
registry.set(alias, executor);
|
|
}
|
|
|
|
export function getRegisteredExecutor(alias: string): BaseExecutor | undefined {
|
|
return registry.get(alias);
|
|
}
|
|
|
|
export function hasRegisteredExecutor(alias: string): boolean {
|
|
return registry.has(alias);
|
|
}
|
|
|
|
/** All registered aliases, in registration order. */
|
|
export function listExecutorAliases(): string[] {
|
|
return [...registry.keys()];
|
|
}
|