@grest-ts/discovery-local 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Grest Games OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/src/index-node.d.ts

@@ -0,0 +1,5 @@
+export * from './local/GGLocalDiscoveryClient';
+export * from './local/GGLocalDiscoveryServer';
+export * from './local/routing/RoutingStrategy';
+export * from './local/GGLocalDiscoveryResilientClient';
+//# sourceMappingURL=index-node.d.ts.map

package/dist/src/index-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,yCAAyC,CAAA"}

package/dist/src/index-node.js

@@ -0,0 +1,5 @@
+export * from './local/GGLocalDiscoveryClient.js';
+export * from './local/GGLocalDiscoveryServer.js';
+export * from './local/routing/RoutingStrategy.js';
+export * from './local/GGLocalDiscoveryResilientClient.js';
+//# sourceMappingURL=index-node.js.map

package/dist/src/index-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,yCAAyC,CAAA"}

package/dist/src/local/GGDiscoveryIPC.d.ts

@@ -0,0 +1,14 @@
+import { GGServiceDiscoveryEntry } from "./GGLocalDiscoveryClient";
+export interface DiscoverApiResult {
+    success: boolean;
+    url?: string;
+    error?: string;
+}
+export declare const GGDiscoveryIPC: {
+    discoveryServer: {
+        register: import("@grest-ts/ipc").IPCServerRequest<GGServiceDiscoveryEntry[], void>;
+        unregister: import("@grest-ts/ipc").IPCServerRequest<GGServiceDiscoveryEntry[], void>;
+        discoverApi: import("@grest-ts/ipc").IPCServerRequest<string, DiscoverApiResult>;
+    };
+};
+//# sourceMappingURL=GGDiscoveryIPC.d.ts.map

package/dist/src/local/GGDiscoveryIPC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGDiscoveryIPC.d.ts","sourceRoot":"","sources":["../../../src/local/GGDiscoveryIPC.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc;;;;;;CAM1B,CAAA"}

package/dist/src/local/GGDiscoveryIPC.js

@@ -0,0 +1,9 @@
+import { IPCServer } from "@grest-ts/ipc";
+export const GGDiscoveryIPC = {
+    discoveryServer: {
+        register: IPCServer.defineRequest("discovery/register"),
+        unregister: IPCServer.defineRequest("discovery/unregister"),
+        discoverApi: IPCServer.defineRequest("discovery/discoverApi"),
+    }
+};
+//# sourceMappingURL=GGDiscoveryIPC.js.map

package/dist/src/local/GGDiscoveryIPC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGDiscoveryIPC.js","sourceRoot":"","sources":["../../../src/local/GGDiscoveryIPC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AAUxC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,eAAe,EAAE;QACb,QAAQ,EAAE,SAAS,CAAC,aAAa,CAAkC,oBAAoB,CAAC;QACxF,UAAU,EAAE,SAAS,CAAC,aAAa,CAAkC,sBAAsB,CAAC;QAC5F,WAAW,EAAE,SAAS,CAAC,aAAa,CAA4B,uBAAuB,CAAC;KAC3F;CACJ,CAAA"}

package/dist/src/local/GGLocalDiscoveryClient.d.ts

@@ -0,0 +1,28 @@
+import { GGDiscoveryClient, GGServiceRegistration } from "@grest-ts/discovery";
+import { IPCClient } from "@grest-ts/ipc";
+/**
+ * ENV variable key when running in tests, for example - this would be PORT of the service discovery instance.
+ * If running in tests, the test itself also acts as a service discovery of sorts, allowing multiple instances to run in parallel.
+ */
+export declare const GG_LOCAL_ROUTER_PORT = "GG_LOCAL_ROUTER_PORT";
+export declare class GGLocalDiscoveryClient extends GGDiscoveryClient {
+    readonly isLocal = true;
+    readonly port: number;
+    protected readonly entries: GGServiceDiscoveryEntry[];
+    protected readonly client: IPCClient;
+    constructor(port?: number);
+    registerRoutes(registrations: GGServiceRegistration[]): void;
+    discoverApi(apiName: string): Promise<string>;
+    register(): Promise<void>;
+    unregister(): Promise<void>;
+    protected ensureConnected(): Promise<void>;
+}
+/**
+ * What consumers need to discover and connect to a service
+ */
+export interface GGServiceDiscoveryEntry {
+    api: string;
+    baseUrl: string;
+    pathPrefix: string;
+}
+//# sourceMappingURL=GGLocalDiscoveryClient.d.ts.map

package/dist/src/local/GGLocalDiscoveryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLocalDiscoveryClient.d.ts","sourceRoot":"","sources":["../../../src/local/GGLocalDiscoveryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,iBAAiB,EAAE,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AAKxC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAE1D,qBAAa,sBAAuB,SAAQ,iBAAiB;IAEzD,SAAyB,OAAO,QAAQ;IACxC,SAAgB,IAAI,SAAC;IACrB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,EAAE,CAAM;IAC3D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;gBAEzB,IAAI,CAAC,EAAE,MAAM;IAgBlB,cAAc,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,IAAI;IAUtD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa7C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAWxB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAKnD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/src/local/GGLocalDiscoveryClient.js

@@ -0,0 +1,77 @@
+import { GG_DISCOVERY, GGDiscoveryClient } from "@grest-ts/discovery";
+import { GGLog } from "@grest-ts/logger";
+import { IPCClient } from "@grest-ts/ipc";
+import { GGLocator, GGLocatorServiceType } from "@grest-ts/locator";
+import { GGDiscoveryIPC } from "./GGDiscoveryIPC.js";
+import { SERVER_ERROR } from "@grest-ts/schema";
+/**
+ * ENV variable key when running in tests, for example - this would be PORT of the service discovery instance.
+ * If running in tests, the test itself also acts as a service discovery of sorts, allowing multiple instances to run in parallel.
+ */
+export const GG_LOCAL_ROUTER_PORT = "GG_LOCAL_ROUTER_PORT";
+export class GGLocalDiscoveryClient extends GGDiscoveryClient {
+    isLocal = true;
+    port;
+    entries = [];
+    client;
+    constructor(port) {
+        if (port === undefined) {
+            throw new Error("No port specified for local router");
+        }
+        super();
+        this.port = port;
+        this.client = new IPCClient(port);
+        GGLog.info(this, "Started on port: " + this.port);
+        GGLocator.getScope().setWithLifecycle(GG_DISCOVERY, this, {
+            type: GGLocatorServiceType.SERVICE_DISCOVERY,
+            start: () => this.register(),
+            teardown: () => this.unregister()
+        });
+    }
+    registerRoutes(registrations) {
+        for (const reg of registrations) {
+            this.entries.push({
+                api: reg.api,
+                baseUrl: `${reg.protocol}://localhost:${reg.port}`,
+                pathPrefix: reg.pathPrefix
+            });
+        }
+    }
+    async discoverApi(apiName) {
+        await this.ensureConnected();
+        const res = await this.client.sendFrameworkRequest(GGDiscoveryIPC.discoveryServer.discoverApi, apiName);
+        if (res.success && res.url) {
+            return res.url;
+        }
+        else {
+            throw new SERVER_ERROR({
+                displayMessage: res.error ?? "Unknown error",
+                debugData: { apiName }
+            });
+        }
+    }
+    async register() {
+        await this.ensureConnected();
+        if (this.entries.length > 0) {
+            await this.client.sendFrameworkRequest(GGDiscoveryIPC.discoveryServer.register, this.entries);
+        }
+        GGLog.info(this, `Registered ${this.entries.length} routes`);
+    }
+    async unregister() {
+        if (this.entries.length > 0 && this.client.isConnected()) {
+            try {
+                await this.client.sendFrameworkRequest(GGDiscoveryIPC.discoveryServer.unregister, this.entries);
+            }
+            catch (err) {
+                GGLog.error(this, err);
+            }
+        }
+        this.client.disconnect();
+    }
+    async ensureConnected() {
+        if (!this.client.isConnected()) {
+            await this.client.connect();
+        }
+    }
+}
+//# sourceMappingURL=GGLocalDiscoveryClient.js.map

package/dist/src/local/GGLocalDiscoveryClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLocalDiscoveryClient.js","sourceRoot":"","sources":["../../../src/local/GGLocalDiscoveryClient.ts"],"names":[],"mappings":"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"}

package/dist/src/local/GGLocalDiscoveryResilientClient.d.ts

@@ -0,0 +1,15 @@
+import { GGLocalDiscoveryClient } from "./GGLocalDiscoveryClient";
+export declare class GGLocalDiscoveryResilientClient extends GGLocalDiscoveryClient {
+    private discoveryServer?;
+    private isLeader;
+    private isShuttingDown;
+    constructor(port?: number);
+    register(): Promise<void>;
+    unregister(): Promise<void>;
+    private becomeLeaderOrFollower;
+    private connectToLeader;
+    protected ensureConnected(): Promise<void>;
+    private delay;
+    private isConnectionError;
+}
+//# sourceMappingURL=GGLocalDiscoveryResilientClient.d.ts.map

package/dist/src/local/GGLocalDiscoveryResilientClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLocalDiscoveryResilientClient.d.ts","sourceRoot":"","sources":["../../../src/local/GGLocalDiscoveryResilientClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAEhE,qBAAa,+BAAgC,SAAQ,sBAAsB;IAEvE,OAAO,CAAC,eAAe,CAAC,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;gBAEnB,IAAI,SAAO;IAID,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAOzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAUnC,sBAAsB;YAgBtB,eAAe;cAuBJ,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBzD,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,iBAAiB;CAQ5B"}

package/dist/src/local/GGLocalDiscoveryResilientClient.js

@@ -0,0 +1,95 @@
+import { GGLog } from "@grest-ts/logger";
+import { IPCServer } from "@grest-ts/ipc";
+import { GGLocalDiscoveryServer } from "./GGLocalDiscoveryServer.js";
+import { GGLocalDiscoveryClient } from "./GGLocalDiscoveryClient.js";
+export class GGLocalDiscoveryResilientClient extends GGLocalDiscoveryClient {
+    discoveryServer;
+    isLeader = false;
+    isShuttingDown = false;
+    constructor(port = 9000) {
+        super(port);
+    }
+    async register() {
+        if (!this.isLeader && !this.discoveryServer && !this.client.isConnected()) {
+            await this.becomeLeaderOrFollower();
+        }
+        await super.register();
+    }
+    async unregister() {
+        this.isShuttingDown = true;
+        await super.unregister();
+        if (this.discoveryServer) {
+            await this.discoveryServer.teardown();
+            this.discoveryServer = undefined;
+        }
+    }
+    async becomeLeaderOrFollower() {
+        if (this.isShuttingDown)
+            return;
+        const server = new IPCServer(this.port);
+        const router = new GGLocalDiscoveryServer(server);
+        if (await router.start()) {
+            this.discoveryServer = router;
+            this.isLeader = true;
+            GGLog.info(this, "This instance is LEADER");
+        }
+        else {
+            this.isLeader = false;
+            GGLog.info(this, "This instance is FOLLOWER");
+            await this.connectToLeader();
+        }
+    }
+    async connectToLeader() {
+        if (this.isShuttingDown)
+            return;
+        try {
+            await this.client.connect();
+            this.client.onClose(async () => {
+                if (this.isShuttingDown)
+                    return;
+                GGLog.warn(this, "Leader died");
+                await this.becomeLeaderOrFollower();
+                if (this.isLeader && this.entries.length > 0) {
+                    await super.register();
+                }
+            });
+            GGLog.debug(this, "Connected to leader");
+        }
+        catch (err) {
+            GGLog.error(this, `Failed to connect to leader: ${err.message}`);
+            await this.delay(1000);
+            await this.connectToLeader();
+        }
+    }
+    async ensureConnected() {
+        const maxRetries = 20;
+        let retryCount = 0;
+        while (true) {
+            try {
+                await super.ensureConnected();
+                return;
+            }
+            catch (err) {
+                if (retryCount < maxRetries && this.isConnectionError(err)) {
+                    GGLog.debug(this, `Waiting for router...`);
+                    await this.delay(Math.min(500 * Math.pow(1.5, retryCount), 5000));
+                    retryCount++;
+                    continue;
+                }
+                throw err;
+            }
+        }
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    isConnectionError(err) {
+        const codes = ['ECONNREFUSED', 'ETIMEDOUT', 'ECONNRESET'];
+        const hasCode = (code) => code !== undefined && codes.includes(code);
+        return hasCode(err?.code) ||
+            hasCode(err?.cause?.code) ||
+            hasCode(err?.originalError?.code) ||
+            hasCode(err?.originalError?.cause?.code);
+    }
+}
+//# sourceMappingURL=GGLocalDiscoveryResilientClient.js.map

package/dist/src/local/GGLocalDiscoveryResilientClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLocalDiscoveryResilientClient.js","sourceRoot":"","sources":["../../../src/local/GGLocalDiscoveryResilientClient.ts"],"names":[],"mappings":"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"}

package/dist/src/local/GGLocalDiscoveryServer.d.ts

@@ -0,0 +1,30 @@
+import { IPCServer } from "@grest-ts/ipc";
+import { RoutingStrategy } from "./routing/RoutingStrategy";
+import { FirstStrategy } from "./routing/strategies/FirstStrategy";
+import { LastStrategy } from "./routing/strategies/LastStrategy";
+import { RandomStrategy } from "./routing/strategies/RandomStrategy";
+import { RoundRobinStrategy } from "./routing/strategies/RoundRobinStrategy";
+import { GGServiceDiscoveryEntry } from "./GGLocalDiscoveryClient";
+export declare const ROUTING_STRATEGIES: {
+    readonly first: FirstStrategy;
+    readonly last: LastStrategy;
+    readonly random: RandomStrategy;
+    readonly roundRobin: RoundRobinStrategy;
+};
+export type RoutingStrategyName = "first" | "last" | "roundRobin" | "random" | RoutingStrategy;
+export declare class GGLocalDiscoveryServer {
+    private readonly server;
+    private readonly routes;
+    private readonly routingStrategies;
+    constructor(server: IPCServer);
+    start(): Promise<boolean>;
+    teardown(): Promise<void>;
+    setRoutingStrategy(api: string, strategy: RoutingStrategyName | RoutingStrategy): void;
+    private getRoutingStrategy;
+    getRoute(api: string): GGServiceDiscoveryEntry | undefined;
+    addRoute(route: GGServiceDiscoveryEntry): void;
+    removeRoute(api: string, baseUrl?: string): void;
+    getRoutingUrl(api: string): string;
+    private matchRoute;
+}
+//# sourceMappingURL=GGLocalDiscoveryServer.d.ts.map

package/dist/src/local/GGLocalDiscoveryServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLocalDiscoveryServer.d.ts","sourceRoot":"","sources":["../../../src/local/GGLocalDiscoveryServer.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAC,aAAa,EAAC,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAC,YAAY,EAAC,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAC,cAAc,EAAC,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAC,kBAAkB,EAAC,MAAM,yCAAyC,CAAC;AAE3E,OAAO,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAEjE,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE/F,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqD;IAC5E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2C;gBAEjE,MAAM,EAAE,SAAS;IAwBhB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAQzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,eAAe,GAAG,IAAI;IAM7F,OAAO,CAAC,kBAAkB;IAInB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAS1D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAO9C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBhD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUzC,OAAO,CAAC,UAAU;CAqBrB"}

package/dist/src/local/GGLocalDiscoveryServer.js

@@ -0,0 +1,123 @@
+import { GGLog } from "@grest-ts/logger";
+import { FirstStrategy } from "./routing/strategies/FirstStrategy.js";
+import { LastStrategy } from "./routing/strategies/LastStrategy.js";
+import { RandomStrategy } from "./routing/strategies/RandomStrategy.js";
+import { RoundRobinStrategy } from "./routing/strategies/RoundRobinStrategy.js";
+import { GGDiscoveryIPC } from "./GGDiscoveryIPC.js";
+export const ROUTING_STRATEGIES = {
+    first: new FirstStrategy(),
+    last: new LastStrategy(),
+    random: new RandomStrategy(),
+    roundRobin: new RoundRobinStrategy(),
+};
+export class GGLocalDiscoveryServer {
+    server;
+    routes = new Map();
+    routingStrategies = new Map();
+    constructor(server) {
+        this.server = server;
+        // Socket handlers for framework communication
+        this.server.onFrameworkMessage(GGDiscoveryIPC.discoveryServer.register, async (routes) => {
+            routes.forEach(route => this.addRoute(route));
+        });
+        this.server.onFrameworkMessage(GGDiscoveryIPC.discoveryServer.unregister, async (routes) => {
+            routes.forEach(route => this.removeRoute(route.api));
+        });
+        this.server.onFrameworkMessage(GGDiscoveryIPC.discoveryServer.discoverApi, async (apiName) => {
+            if (this.getRoute(apiName)) {
+                return { success: true, url: this.server.getUrl() };
+            }
+            return { success: false, error: "Service '" + apiName + "' is not registered! Did you forget to start it?" };
+        });
+        this.server.setRouteProxyResolver((path) => {
+            return this.matchRoute(path)?.baseUrl || undefined;
+        });
+    }
+    async start() {
+        const result = await this.server.start();
+        if (result) {
+            GGLog.info(this, `Router started on ${this.server.getUrl()}`);
+        }
+        return result;
+    }
+    async teardown() {
+        this.routes.clear();
+        this.routingStrategies.clear();
+        await this.server.teardown();
+        GGLog.info(this, 'Router stopped');
+    }
+    setRoutingStrategy(api, strategy) {
+        const strategyInstance = typeof strategy === 'string' ? ROUTING_STRATEGIES[strategy] : strategy;
+        this.routingStrategies.set(api, strategyInstance);
+        GGLog.debug(this, `Set routing strategy for ${api}: ${strategyInstance.constructor.name}`);
+    }
+    getRoutingStrategy(api) {
+        return this.routingStrategies.get(api) ?? ROUTING_STRATEGIES.roundRobin;
+    }
+    getRoute(api) {
+        const instances = this.routes.get(api);
+        if (!instances || instances.length === 0) {
+            return undefined;
+        }
+        const strategy = this.getRoutingStrategy(api);
+        return strategy.select(instances, api);
+    }
+    addRoute(route) {
+        const existing = this.routes.get(route.api) ?? [];
+        existing.push(route);
+        this.routes.set(route.api, existing);
+        GGLog.info(this, `Added route: ${route.pathPrefix} (${route.api}) -> ${route.baseUrl}`);
+    }
+    removeRoute(api, baseUrl) {
+        const instances = this.routes.get(api);
+        if (!instances)
+            return;
+        if (baseUrl) {
+            // Remove specific instance
+            const filtered = instances.filter(r => r.baseUrl !== baseUrl);
+            if (filtered.length === 0) {
+                this.routes.delete(api);
+            }
+            else {
+                this.routes.set(api, filtered);
+            }
+            GGLog.info(this, `Removed route instance: ${api} -> ${baseUrl}`);
+        }
+        else {
+            // Remove all instances for this API
+            const route = instances[0];
+            this.routes.delete(api);
+            GGLog.info(this, `Removed route: ${route?.pathPrefix} (${api})`);
+        }
+    }
+    getRoutingUrl(api) {
+        if (!this.getRoute(api)) {
+            throw new Error(`API '${api}' not registered in router`);
+        }
+        if (!this.server.getUrl()) {
+            throw new Error("Router not started yet!");
+        }
+        return this.server.getUrl();
+    }
+    matchRoute(path) {
+        let bestApi;
+        let longestMatch = 0;
+        // Find the best matching API based on path prefix
+        for (const [api, instances] of this.routes.entries()) {
+            if (instances.length === 0)
+                continue;
+            const pathPrefix = instances[0].pathPrefix;
+            if (path.startsWith(pathPrefix) && pathPrefix.length > longestMatch) {
+                bestApi = api;
+                longestMatch = pathPrefix.length;
+            }
+        }
+        if (!bestApi)
+            return undefined;
+        // Use routing strategy to select which instance, passing the full path
+        const instances = this.routes.get(bestApi);
+        const strategy = this.getRoutingStrategy(bestApi);
+        return strategy.select(instances, path);
+    }
+}
+//# sourceMappingURL=GGLocalDiscoveryServer.js.map

package/dist/src/local/GGLocalDiscoveryServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLocalDiscoveryServer.js","sourceRoot":"","sources":["../../../src/local/GGLocalDiscoveryServer.ts"],"names":[],"mappings":"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"}

package/dist/src/local/routing/RoutingStrategy.d.ts

@@ -0,0 +1,5 @@
+import { GGServiceDiscoveryEntry } from "../GGLocalDiscoveryClient";
+export interface RoutingStrategy {
+    select(instances: GGServiceDiscoveryEntry[], path: string): GGServiceDiscoveryEntry;
+}
+//# sourceMappingURL=RoutingStrategy.d.ts.map

package/dist/src/local/routing/RoutingStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutingStrategy.d.ts","sourceRoot":"","sources":["../../../../src/local/routing/RoutingStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,eAAe;IAE5B,MAAM,CAAC,SAAS,EAAE,uBAAuB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAAC;CACvF"}

package/dist/src/local/routing/RoutingStrategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RoutingStrategy.js.map

package/dist/src/local/routing/RoutingStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutingStrategy.js","sourceRoot":"","sources":["../../../../src/local/routing/RoutingStrategy.ts"],"names":[],"mappings":""}

package/dist/src/local/routing/strategies/FirstStrategy.d.ts

@@ -0,0 +1,9 @@
+import { RoutingStrategy } from "../RoutingStrategy";
+import { GGServiceDiscoveryEntry } from "../../GGLocalDiscoveryClient";
+/**
+ * Always route to the first registered instance.
+ */
+export declare class FirstStrategy implements RoutingStrategy {
+    select(instances: GGServiceDiscoveryEntry[]): GGServiceDiscoveryEntry;
+}
+//# sourceMappingURL=FirstStrategy.d.ts.map

package/dist/src/local/routing/strategies/FirstStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirstStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/FirstStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAC,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,qBAAa,aAAc,YAAW,eAAe;IACjD,MAAM,CAAC,SAAS,EAAE,uBAAuB,EAAE,GAAG,uBAAuB;CAGxE"}

package/dist/src/local/routing/strategies/FirstStrategy.js

@@ -0,0 +1,9 @@
+/**
+ * Always route to the first registered instance.
+ */
+export class FirstStrategy {
+    select(instances) {
+        return instances[0];
+    }
+}
+//# sourceMappingURL=FirstStrategy.js.map

package/dist/src/local/routing/strategies/FirstStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirstStrategy.js","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/FirstStrategy.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,aAAa;IACtB,MAAM,CAAC,SAAoC;QACvC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;CACJ"}

package/dist/src/local/routing/strategies/LastStrategy.d.ts

@@ -0,0 +1,9 @@
+import { RoutingStrategy } from "../RoutingStrategy";
+import { GGServiceDiscoveryEntry } from "../../GGLocalDiscoveryClient";
+/**
+ * Always route to the last registered instance.
+ */
+export declare class LastStrategy implements RoutingStrategy {
+    select(instances: GGServiceDiscoveryEntry[]): GGServiceDiscoveryEntry;
+}
+//# sourceMappingURL=LastStrategy.d.ts.map

package/dist/src/local/routing/strategies/LastStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LastStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/LastStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAC,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,qBAAa,YAAa,YAAW,eAAe;IAChD,MAAM,CAAC,SAAS,EAAE,uBAAuB,EAAE,GAAG,uBAAuB;CAGxE"}

package/dist/src/local/routing/strategies/LastStrategy.js

@@ -0,0 +1,9 @@
+/**
+ * Always route to the last registered instance.
+ */
+export class LastStrategy {
+    select(instances) {
+        return instances[instances.length - 1];
+    }
+}
+//# sourceMappingURL=LastStrategy.js.map

package/dist/src/local/routing/strategies/LastStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LastStrategy.js","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/LastStrategy.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,YAAY;IACrB,MAAM,CAAC,SAAoC;QACvC,OAAO,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;CACJ"}

package/dist/src/local/routing/strategies/RandomStrategy.d.ts

@@ -0,0 +1,9 @@
+import { RoutingStrategy } from "../RoutingStrategy";
+import { GGServiceDiscoveryEntry } from "../../GGLocalDiscoveryClient";
+/**
+ * Randomly select an instance for each request.
+ */
+export declare class RandomStrategy implements RoutingStrategy {
+    select(instances: GGServiceDiscoveryEntry[]): GGServiceDiscoveryEntry;
+}
+//# sourceMappingURL=RandomStrategy.d.ts.map

package/dist/src/local/routing/strategies/RandomStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RandomStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/RandomStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAC,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,qBAAa,cAAe,YAAW,eAAe;IAClD,MAAM,CAAC,SAAS,EAAE,uBAAuB,EAAE,GAAG,uBAAuB;CAGxE"}

package/dist/src/local/routing/strategies/RandomStrategy.js

@@ -0,0 +1,9 @@
+/**
+ * Randomly select an instance for each request.
+ */
+export class RandomStrategy {
+    select(instances) {
+        return instances[Math.floor(Math.random() * instances.length)];
+    }
+}
+//# sourceMappingURL=RandomStrategy.js.map

package/dist/src/local/routing/strategies/RandomStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RandomStrategy.js","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/RandomStrategy.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,cAAc;IACvB,MAAM,CAAC,SAAoC;QACvC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;CACJ"}

package/dist/src/local/routing/strategies/RoundRobinStrategy.d.ts

@@ -0,0 +1,11 @@
+import { RoutingStrategy } from "../RoutingStrategy";
+import { GGServiceDiscoveryEntry } from "../../GGLocalDiscoveryClient";
+/**
+ * Cycle through instances in order, per path.
+ * Each unique path maintains its own counter.
+ */
+export declare class RoundRobinStrategy implements RoutingStrategy {
+    private readonly counters;
+    select(instances: GGServiceDiscoveryEntry[], path: string): GGServiceDiscoveryEntry;
+}
+//# sourceMappingURL=RoundRobinStrategy.d.ts.map

package/dist/src/local/routing/strategies/RoundRobinStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoundRobinStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/RoundRobinStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAC,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAErE;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,MAAM,CAAC,SAAS,EAAE,uBAAuB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,uBAAuB;CAMtF"}

package/dist/src/local/routing/strategies/RoundRobinStrategy.js

@@ -0,0 +1,14 @@
+/**
+ * Cycle through instances in order, per path.
+ * Each unique path maintains its own counter.
+ */
+export class RoundRobinStrategy {
+    counters = new Map();
+    select(instances, path) {
+        const counter = this.counters.get(path) ?? 0;
+        const instance = instances[counter % instances.length];
+        this.counters.set(path, counter + 1);
+        return instance;
+    }
+}
+//# sourceMappingURL=RoundRobinStrategy.js.map

package/dist/src/local/routing/strategies/RoundRobinStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoundRobinStrategy.js","sourceRoot":"","sources":["../../../../../src/local/routing/strategies/RoundRobinStrategy.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACV,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE3D,MAAM,CAAC,SAAoC,EAAE,IAAY;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QACrC,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}