@digifi/k8s-grpc-js-resolver 0.1.0

package/dist/k8s-api-client.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetClusterConnectionCache = exports.streamLines = exports.requestJson = exports.readServiceAccountNamespace = exports.KubernetesApiError = exports.SA_NAMESPACE_PATH = exports.SA_CA_PATH = exports.SA_TOKEN_PATH = void 0;
+const node_tls_1 = require("node:tls");
+const node_fs_1 = require("node:fs");
+const node_https_1 = require("node:https");
+const SA_DIRECTORY = '/var/run/secrets/kubernetes.io/serviceaccount';
+exports.SA_TOKEN_PATH = `${SA_DIRECTORY}/token`;
+exports.SA_CA_PATH = `${SA_DIRECTORY}/ca.crt`;
+exports.SA_NAMESPACE_PATH = `${SA_DIRECTORY}/namespace`;
+class KubernetesApiError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'KubernetesApiError';
+    }
+    get isExpiredResourceVersion() {
+        return this.statusCode === 410;
+    }
+}
+exports.KubernetesApiError = KubernetesApiError;
+let cachedConnection = null;
+/**
+ * The CA and API server address are stable for the lifetime of the pod, so the keep-alive agent is
+ * cached. The bearer token is not cached: projected service account tokens are short lived and
+ * rotated in place by the kubelet, so it is re-read for every request.
+ */
+const getClusterConnection = () => {
+    if (cachedConnection) {
+        return cachedConnection;
+    }
+    const host = process.env.KUBERNETES_SERVICE_HOST;
+    const port = process.env.KUBERNETES_SERVICE_PORT_HTTPS || process.env.KUBERNETES_SERVICE_PORT || '443';
+    if (!host || !(0, node_fs_1.existsSync)(exports.SA_TOKEN_PATH) || !(0, node_fs_1.existsSync)(exports.SA_CA_PATH)) {
+        throw new KubernetesApiError('Kubernetes in-cluster config is not available for the gRPC k8s resolver');
+    }
+    const ca = (0, node_fs_1.readFileSync)(exports.SA_CA_PATH);
+    cachedConnection = {
+        server: `https://${host}:${port}`,
+        agent: new node_https_1.Agent({ keepAlive: true, secureContext: (0, node_tls_1.createSecureContext)({ ca }) }),
+    };
+    return cachedConnection;
+};
+const readServiceAccountToken = () => {
+    return (0, node_fs_1.readFileSync)(exports.SA_TOKEN_PATH, 'utf8').trim();
+};
+const readServiceAccountNamespace = () => {
+    try {
+        if ((0, node_fs_1.existsSync)(exports.SA_NAMESPACE_PATH)) {
+            return (0, node_fs_1.readFileSync)(exports.SA_NAMESPACE_PATH, 'utf8').trim() || null;
+        }
+    }
+    catch {
+        // Not running in-cluster, or the projected volume is unreadable.
+    }
+    return null;
+};
+exports.readServiceAccountNamespace = readServiceAccountNamespace;
+const openRequest = ({ path, signal, idleTimeoutMs, unrefSocket, onChunk, }) => {
+    const connection = getClusterConnection();
+    const url = new URL(path, connection.server);
+    return new Promise((resolve, reject) => {
+        const request = (0, node_https_1.request)({
+            protocol: url.protocol,
+            hostname: url.hostname,
+            port: url.port,
+            path: `${url.pathname}${url.search}`,
+            method: 'GET',
+            agent: connection.agent,
+            headers: {
+                Authorization: `Bearer ${readServiceAccountToken()}`,
+                Accept: 'application/json',
+            },
+            signal,
+        }, (response) => {
+            const isStreaming = Boolean(onChunk) && (response.statusCode ?? 500) < 300;
+            const chunks = [];
+            response.setEncoding('utf8');
+            response.setTimeout(idleTimeoutMs, () => {
+                response.destroy(new KubernetesApiError(`Kubernetes API response stalled for ${idleTimeoutMs}ms`));
+            });
+            response.on('data', (chunk) => {
+                if (isStreaming) {
+                    onChunk?.(chunk);
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            response.on('end', () => resolve({ statusCode: response.statusCode ?? 500, body: chunks.join('') }));
+            response.on('error', reject);
+        });
+        if (unrefSocket) {
+            request.on('socket', (socket) => socket.unref());
+        }
+        request.setTimeout(idleTimeoutMs, () => {
+            request.destroy(new KubernetesApiError(`Kubernetes API request timed out after ${idleTimeoutMs}ms`));
+        });
+        request.on('error', reject);
+        request.end();
+    });
+};
+const assertSuccessful = ({ statusCode, body }) => {
+    if (statusCode < 300) {
+        return;
+    }
+    throw new KubernetesApiError(`Kubernetes API responded with ${statusCode}: ${body.slice(0, 500)}`, statusCode);
+};
+const requestJson = async (path, signal, idleTimeoutMs) => {
+    const response = await openRequest({ path, signal, idleTimeoutMs });
+    assertSuccessful(response);
+    return JSON.parse(response.body);
+};
+exports.requestJson = requestJson;
+/** Resolves when the server closes the stream, which it does routinely once the watch times out. */
+const streamLines = async (path, signal, idleTimeoutMs, onChunk) => {
+    assertSuccessful(await openRequest({ path, signal, idleTimeoutMs, unrefSocket: true, onChunk }));
+};
+exports.streamLines = streamLines;
+const resetClusterConnectionCache = () => {
+    cachedConnection?.agent.destroy();
+    cachedConnection = null;
+};
+exports.resetClusterConnectionCache = resetClusterConnectionCache;
+//# sourceMappingURL=k8s-api-client.js.map

package/dist/k8s-api-client.js.map

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

package/dist/k8s-endpoint-watch.d.ts

@@ -0,0 +1,4 @@
+import { IStoreListener } from './endpoint-slice-store';
+export declare const watchServiceEndpoints: (namespace: string, serviceName: string, listener: IStoreListener) => void;
+export declare const unwatchServiceEndpoints: (namespace: string, serviceName: string, listener: IStoreListener) => void;
+//# sourceMappingURL=k8s-endpoint-watch.d.ts.map

package/dist/k8s-endpoint-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s-endpoint-watch.d.ts","sourceRoot":"","sources":["../src/k8s-endpoint-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,cAAc,EAKf,MAAM,wBAAwB,CAAC;AAqQhC,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,UAAU,cAAc,KACvB,IAGF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,UAAU,cAAc,KACvB,IAMF,CAAC"}

package/dist/k8s-endpoint-watch.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwatchServiceEndpoints = exports.watchServiceEndpoints = void 0;
+const endpoint_slice_store_1 = require("./endpoint-slice-store");
+const watch_stream_parser_1 = require("./watch-stream-parser");
+const k8s_api_client_1 = require("./k8s-api-client");
+const resolver_logger_1 = require("./resolver-logger");
+const LIST_PAGE_SIZE = 500;
+const LIST_TIMEOUT_MS = 15_000;
+/** Server-side watch lifetime; the API server closes the stream when it elapses. */
+const WATCH_TIMEOUT_SECONDS = 300;
+/** Must exceed the server-side watch timeout, otherwise healthy idle streams are killed locally. */
+const WATCH_IDLE_TIMEOUT_MS = (WATCH_TIMEOUT_SECONDS + 60) * 1000;
+/** A stream that dies faster than this is treated as a failure so reconnects cannot hot loop. */
+const MIN_HEALTHY_STREAM_MS = 1_000;
+const RETRY_BASE_DELAY_MS = 1_000;
+const RETRY_MAX_DELAY_MS = 30_000;
+const RETRY_JITTER_RATIO = 0.2;
+const watchesByNamespace = new Map();
+const buildNamespacePath = (namespace) => {
+    return `/apis/discovery.k8s.io/v1/namespaces/${encodeURIComponent(namespace)}/endpointslices`;
+};
+const getRetryDelayMs = (consecutiveFailures) => {
+    const exponentialDelayMs = RETRY_BASE_DELAY_MS * 2 ** (consecutiveFailures - 1);
+    const cappedDelayMs = Math.min(exponentialDelayMs, RETRY_MAX_DELAY_MS);
+    const jitterMs = cappedDelayMs * RETRY_JITTER_RATIO * (Math.random() * 2 - 1);
+    return Math.max(RETRY_BASE_DELAY_MS, Math.round(cappedDelayMs + jitterMs));
+};
+const delay = (watch, delayMs) => {
+    return new Promise((resolve) => {
+        const finish = () => {
+            if (watch.retryTimer) {
+                clearTimeout(watch.retryTimer);
+                watch.retryTimer = undefined;
+            }
+            watch.abortController.signal.removeEventListener('abort', finish);
+            resolve();
+        };
+        watch.retryTimer = setTimeout(finish, delayMs);
+        watch.retryTimer.unref?.();
+        watch.abortController.signal.addEventListener('abort', finish, { once: true });
+    });
+};
+const listNamespaceSlices = async (watch) => {
+    const basePath = buildNamespacePath(watch.namespace);
+    const slices = [];
+    let continueToken;
+    let resourceVersion;
+    do {
+        const query = new URLSearchParams({ limit: String(LIST_PAGE_SIZE) });
+        if (continueToken) {
+            query.set('continue', continueToken);
+        }
+        const page = await (0, k8s_api_client_1.requestJson)(`${basePath}?${query.toString()}`, watch.abortController.signal, LIST_TIMEOUT_MS);
+        slices.push(...(page.items ?? []));
+        resourceVersion = page.metadata?.resourceVersion ?? resourceVersion;
+        continueToken = page.metadata?.continue || undefined;
+    } while (continueToken && !watch.stopped);
+    (0, endpoint_slice_store_1.replaceNamespaceSlices)(watch.namespace, slices);
+    return resourceVersion;
+};
+/** Resolves with the latest observed resource version so the next watch resumes instead of relisting. */
+const streamNamespaceSlices = async (watch, resourceVersion) => {
+    const query = new URLSearchParams({
+        watch: 'true',
+        allowWatchBookmarks: 'true',
+        timeoutSeconds: String(WATCH_TIMEOUT_SECONDS),
+    });
+    if (resourceVersion) {
+        query.set('resourceVersion', resourceVersion);
+    }
+    const attemptController = new AbortController();
+    const abortAttempt = () => attemptController.abort();
+    watch.abortController.signal.addEventListener('abort', abortAttempt, { once: true });
+    const parser = new watch_stream_parser_1.WatchStreamParser();
+    let latestResourceVersion = resourceVersion;
+    let isExpired = false;
+    const handleChunk = (chunk) => {
+        for (const event of parser.push(chunk)) {
+            if ((0, watch_stream_parser_1.isExpiredResourceVersionEvent)(event)) {
+                isExpired = true;
+                abortAttempt();
+                return;
+            }
+            if (event.type === 'ERROR') {
+                continue;
+            }
+            latestResourceVersion = event.object.metadata?.resourceVersion ?? latestResourceVersion;
+            if (event.type !== 'BOOKMARK') {
+                (0, endpoint_slice_store_1.applyEndpointSliceEvent)(watch.namespace, event.type, event.object);
+            }
+        }
+    };
+    try {
+        await (0, k8s_api_client_1.streamLines)(`${buildNamespacePath(watch.namespace)}?${query.toString()}`, attemptController.signal, WATCH_IDLE_TIMEOUT_MS, handleChunk);
+    }
+    catch (error) {
+        if (isExpired) {
+            throw new k8s_api_client_1.KubernetesApiError('Kubernetes watch resource version expired', 410);
+        }
+        throw error;
+    }
+    finally {
+        watch.abortController.signal.removeEventListener('abort', abortAttempt);
+    }
+    if (isExpired) {
+        throw new k8s_api_client_1.KubernetesApiError('Kubernetes watch resource version expired', 410);
+    }
+    return latestResourceVersion;
+};
+const runWatchLoop = async (watch) => {
+    const logger = (0, resolver_logger_1.getResolverLogger)();
+    let resourceVersion;
+    while (!watch.stopped) {
+        const attemptStartedAtMs = Date.now();
+        try {
+            if (!resourceVersion) {
+                resourceVersion = await listNamespaceSlices(watch);
+            }
+            resourceVersion = await streamNamespaceSlices(watch, resourceVersion);
+            if (watch.stopped) {
+                break;
+            }
+            // The API server closes watches on a timer; that is a healthy stream ending, not a failure.
+            if (Date.now() - attemptStartedAtMs >= MIN_HEALTHY_STREAM_MS) {
+                watch.consecutiveFailures = 0;
+                continue;
+            }
+            watch.consecutiveFailures += 1;
+        }
+        catch (error) {
+            if (watch.stopped) {
+                break;
+            }
+            if (error instanceof k8s_api_client_1.KubernetesApiError && error.isExpiredResourceVersion) {
+                resourceVersion = undefined;
+                continue;
+            }
+            resourceVersion = undefined;
+            watch.consecutiveFailures += 1;
+            const message = (0, resolver_logger_1.toErrorMessage)(error);
+            (0, endpoint_slice_store_1.markNamespaceFailed)(watch.namespace, message);
+            logger.error(`gRPC k8s resolver: EndpointSlice watch for namespace ${watch.namespace} failed: ${message} ` +
+                `(consecutiveFailures=${watch.consecutiveFailures})`);
+        }
+        await delay(watch, getRetryDelayMs(watch.consecutiveFailures));
+    }
+    if (watchesByNamespace.get(watch.namespace) === watch) {
+        watchesByNamespace.delete(watch.namespace);
+    }
+};
+const ensureNamespaceWatch = (namespace) => {
+    if (watchesByNamespace.has(namespace)) {
+        return;
+    }
+    const watch = {
+        namespace,
+        abortController: new AbortController(),
+        stopped: false,
+        consecutiveFailures: 0,
+    };
+    watchesByNamespace.set(namespace, watch);
+    (0, resolver_logger_1.getResolverLogger)().info(`gRPC k8s resolver: watching EndpointSlices in namespace ${namespace}`);
+    void runWatchLoop(watch).catch((error) => {
+        (0, resolver_logger_1.getResolverLogger)().error(`gRPC k8s resolver: EndpointSlice watch loop for namespace ${namespace} stopped: ${(0, resolver_logger_1.toErrorMessage)(error)}`);
+    });
+};
+const stopNamespaceWatch = (namespace) => {
+    const watch = watchesByNamespace.get(namespace);
+    if (!watch) {
+        return;
+    }
+    watch.stopped = true;
+    watchesByNamespace.delete(namespace);
+    if (watch.retryTimer) {
+        clearTimeout(watch.retryTimer);
+        watch.retryTimer = undefined;
+    }
+    watch.abortController.abort();
+    (0, endpoint_slice_store_1.resetNamespace)(namespace);
+};
+const watchServiceEndpoints = (namespace, serviceName, listener) => {
+    (0, endpoint_slice_store_1.addEndpointSliceListener)(namespace, serviceName, listener);
+    ensureNamespaceWatch(namespace);
+};
+exports.watchServiceEndpoints = watchServiceEndpoints;
+const unwatchServiceEndpoints = (namespace, serviceName, listener) => {
+    (0, endpoint_slice_store_1.removeEndpointSliceListener)(namespace, serviceName, listener);
+    if (!(0, endpoint_slice_store_1.hasListenedServices)(namespace)) {
+        stopNamespaceWatch(namespace);
+    }
+};
+exports.unwatchServiceEndpoints = unwatchServiceEndpoints;
+//# sourceMappingURL=k8s-endpoint-watch.js.map

package/dist/k8s-endpoint-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s-endpoint-watch.js","sourceRoot":"","sources":["../src/k8s-endpoint-watch.ts"],"names":[],"mappings":";;;AAAA,iEAUgC;AAChC,+DAAyF;AACzF,qDAAgF;AAChF,uDAAsE;AAetE,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,oFAAoF;AACpF,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,oGAAoG;AACpG,MAAM,qBAAqB,GAAG,CAAC,qBAAqB,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;AAClE,iGAAiG;AACjG,MAAM,qBAAqB,GAAG,KAAK,CAAC;AACpC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAClC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA2B,CAAC;AAE9D,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAU,EAAE;IACvD,OAAO,wCAAwC,kBAAkB,CAAC,SAAS,CAAC,iBAAiB,CAAC;AAChG,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,mBAA2B,EAAU,EAAE;IAC9D,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,aAAa,GAAG,kBAAkB,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9E,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,KAAsB,EAAE,OAAe,EAAiB,EAAE;IACvE,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;YAC/B,CAAC;YAED,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAClE,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3B,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAAsB,EAA+B,EAAE;IACxF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,IAAI,aAAiC,CAAC;IACtC,IAAI,eAAmC,CAAC;IAExC,GAAG,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAErE,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAA,4BAAW,EAC5B,GAAG,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,EACjC,KAAK,CAAC,eAAe,CAAC,MAAM,EAC5B,eAAe,CAChB,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACnC,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,IAAI,eAAe,CAAC;QACpE,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,SAAS,CAAC;IACvD,CAAC,QAAQ,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;IAE1C,IAAA,6CAAsB,EAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC;AAEF,yGAAyG;AACzG,MAAM,qBAAqB,GAAG,KAAK,EACjC,KAAsB,EACtB,eAAmC,EACN,EAAE;IAC/B,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC;QAChC,KAAK,EAAE,MAAM;QACb,mBAAmB,EAAE,MAAM;QAC3B,cAAc,EAAE,MAAM,CAAC,qBAAqB,CAAC;KAC9C,CAAC,CAAC;IAEH,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC;IAChD,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;IAErD,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAErF,MAAM,MAAM,GAAG,IAAI,uCAAiB,EAAE,CAAC;IAEvC,IAAI,qBAAqB,GAAG,eAAe,CAAC;IAC5C,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,WAAW,GAAG,CAAC,KAAa,EAAQ,EAAE;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,IAAA,mDAA6B,EAAC,KAAK,CAAC,EAAE,CAAC;gBACzC,SAAS,GAAG,IAAI,CAAC;gBACjB,YAAY,EAAE,CAAC;gBAEf,OAAO;YACT,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,qBAAqB,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,IAAI,qBAAqB,CAAC;YAExF,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC9B,IAAA,8CAAuB,EAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,IAAA,4BAAW,EACf,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,EAC5D,iBAAiB,CAAC,MAAM,EACxB,qBAAqB,EACrB,WAAW,CACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,mCAAkB,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,mCAAkB,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,qBAAqB,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,KAAK,EAAE,KAAsB,EAAiB,EAAE;IACnE,MAAM,MAAM,GAAG,IAAA,mCAAiB,GAAE,CAAC;IAEnC,IAAI,eAAmC,CAAC;IAExC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,eAAe,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACrD,CAAC;YAED,eAAe,GAAG,MAAM,qBAAqB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YAEtE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM;YACR,CAAC;YAED,4FAA4F;YAC5F,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,kBAAkB,IAAI,qBAAqB,EAAE,CAAC;gBAC7D,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC;gBAE9B,SAAS;YACX,CAAC;YAED,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM;YACR,CAAC;YAED,IAAI,KAAK,YAAY,mCAAkB,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;gBAC1E,eAAe,GAAG,SAAS,CAAC;gBAE5B,SAAS;YACX,CAAC;YAED,eAAe,GAAG,SAAS,CAAC;YAC5B,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;YAE/B,MAAM,OAAO,GAAG,IAAA,gCAAc,EAAC,KAAK,CAAC,CAAC;YAEtC,IAAA,0CAAmB,EAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,CACV,wDAAwD,KAAK,CAAC,SAAS,YAAY,OAAO,GAAG;gBAC3F,wBAAwB,KAAK,CAAC,mBAAmB,GAAG,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAC;QACtD,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,SAAiB,EAAQ,EAAE;IACvD,IAAI,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAoB;QAC7B,SAAS;QACT,eAAe,EAAE,IAAI,eAAe,EAAE;QACtC,OAAO,EAAE,KAAK;QACd,mBAAmB,EAAE,CAAC;KACvB,CAAC;IAEF,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzC,IAAA,mCAAiB,GAAE,CAAC,IAAI,CAAC,2DAA2D,SAAS,EAAE,CAAC,CAAC;IAEjG,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAChD,IAAA,mCAAiB,GAAE,CAAC,KAAK,CACvB,6DAA6D,SAAS,aAAa,IAAA,gCAAc,EAAC,KAAK,CAAC,EAAE,CAC3G,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAQ,EAAE;IACrD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEhD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAErC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC9B,IAAA,qCAAc,EAAC,SAAS,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEK,MAAM,qBAAqB,GAAG,CACnC,SAAiB,EACjB,WAAmB,EACnB,QAAwB,EAClB,EAAE;IACR,IAAA,+CAAwB,EAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3D,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC,CAAC;AAPW,QAAA,qBAAqB,yBAOhC;AAEK,MAAM,uBAAuB,GAAG,CACrC,SAAiB,EACjB,WAAmB,EACnB,QAAwB,EAClB,EAAE;IACR,IAAA,kDAA2B,EAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE9D,IAAI,CAAC,IAAA,0CAAmB,EAAC,SAAS,CAAC,EAAE,CAAC;QACpC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;AACH,CAAC,CAAC;AAVW,QAAA,uBAAuB,2BAUlC"}

package/dist/k8s-resolver.d.ts

@@ -0,0 +1,43 @@
+import { ChannelOptions, experimental } from '@grpc/grpc-js';
+export declare class K8sResolver implements experimental.Resolver {
+    static getDefaultAuthority(target: experimental.GrpcUri): string;
+    private readonly listener;
+    private readonly target;
+    private readonly targetName;
+    private readonly onStoreChange;
+    private watchRegistered;
+    private portMismatchReported;
+    private lastNotifyTimeMs;
+    private timeoutId;
+    private dnsLookupInFlight;
+    private dnsRetryPending;
+    private usingDnsFallback;
+    private lastFallbackWarnTimeMs;
+    private destroyed;
+    /** Bumped on destroy and when a stale async DNS lookup must be ignored. */
+    private resolutionGeneration;
+    constructor(target: experimental.GrpcUri, listener: experimental.ResolverListener, _channelOptions: ChannelOptions);
+    updateResolution(): void;
+    destroy(): void;
+    /**
+     * grpc-js requires that the listener is never invoked synchronously with the constructor or
+     * `updateResolution`, so every notification goes through a timer. The same timer rate limits
+     * bursts of EndpointSlice events during a rollout.
+     */
+    private scheduleNotify;
+    private notify;
+    private publishEndpoints;
+    private tryDnsFallback;
+    /**
+     * Serving from DNS means EndpointSlice discovery is broken and the resolver is doing nothing but
+     * reproducing the old behaviour, so the warning repeats instead of being logged once per pod.
+     */
+    private warnAboutFallback;
+    /**
+     * Headless clients dial the port from the address, exactly as they did through DNS, so a port the
+     * EndpointSlice does not advertise is still used. It is almost always a `targetPort` misconfig,
+     * so it is surfaced once instead of silently producing an empty endpoint list.
+     */
+    private reportPortMismatch;
+}
+//# sourceMappingURL=k8s-resolver.d.ts.map

package/dist/k8s-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s-resolver.d.ts","sourceRoot":"","sources":["../src/k8s-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA6C7D,qBAAa,WAAY,YAAW,YAAY,CAAC,QAAQ;WACzC,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,GAAG,MAAM;IAIvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAE3C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,oBAAoB,CAAS;IAErC,OAAO,CAAC,gBAAgB,CAAK;IAE7B,OAAO,CAAC,SAAS,CAA6B;IAE9C,OAAO,CAAC,iBAAiB,CAAS;IAElC,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,sBAAsB,CAAK;IAEnC,OAAO,CAAC,SAAS,CAAS;IAE1B,2EAA2E;IAC3E,OAAO,CAAC,oBAAoB,CAAK;gBAG/B,MAAM,EAAE,YAAY,CAAC,OAAO,EAC5B,QAAQ,EAAE,YAAY,CAAC,gBAAgB,EACvC,eAAe,EAAE,cAAc;IAQ1B,gBAAgB,IAAI,IAAI;IAYxB,OAAO,IAAI,IAAI;IAoBtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,MAAM;IAmDd,OAAO,CAAC,gBAAgB;YAcV,cAAc;IAmE5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAe3B"}

package/dist/k8s-resolver.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.K8sResolver = void 0;
+const grpc_js_1 = require("@grpc/grpc-js");
+const endpoint_slice_store_1 = require("./endpoint-slice-store");
+const dns_fallback_1 = require("./dns-fallback");
+const k8s_endpoint_watch_1 = require("./k8s-endpoint-watch");
+const resolver_logger_1 = require("./resolver-logger");
+const resolver_constants_1 = require("./resolver.constants");
+const MIN_RESOLUTION_INTERVAL_MS = 250;
+/** How often a resolver that is stuck on the DNS fallback repeats its warning. */
+const FALLBACK_WARN_INTERVAL_MS = 5 * 60 * 1000;
+const PORT_PATTERN = /^\d+$/;
+const MIN_PORT = 1;
+const MAX_PORT = 65_535;
+const parseTarget = (target) => {
+    const namespace = target.authority;
+    const path = target.path.startsWith('/') ? target.path.slice(1) : target.path;
+    const separatorIndex = path.lastIndexOf(':');
+    const serviceName = separatorIndex > 0 ? path.slice(0, separatorIndex) : '';
+    const rawPort = separatorIndex > 0 ? path.slice(separatorIndex + 1) : '';
+    const port = Number(rawPort);
+    if (!namespace ||
+        !serviceName ||
+        serviceName.includes(':') ||
+        !PORT_PATTERN.test(rawPort) ||
+        port < MIN_PORT ||
+        port > MAX_PORT) {
+        throw new Error(`k8s resolver target must be ${resolver_constants_1.K8S_RESOLVER_SCHEME}://<namespace>/<service>:<port>, ` +
+            `got ${grpc_js_1.experimental.uriToString(target)}`);
+    }
+    return { namespace, serviceName, port };
+};
+class K8sResolver {
+    static getDefaultAuthority(target) {
+        return parseTarget(target).serviceName;
+    }
+    listener;
+    target;
+    targetName;
+    onStoreChange;
+    watchRegistered = false;
+    portMismatchReported = false;
+    lastNotifyTimeMs = 0;
+    timeoutId;
+    dnsLookupInFlight = false;
+    dnsRetryPending = false;
+    usingDnsFallback = false;
+    lastFallbackWarnTimeMs = 0;
+    destroyed = false;
+    /** Bumped on destroy and when a stale async DNS lookup must be ignored. */
+    resolutionGeneration = 0;
+    constructor(target, listener, _channelOptions) {
+        this.listener = listener;
+        this.target = parseTarget(target);
+        this.targetName = grpc_js_1.experimental.uriToString(target);
+        this.onStoreChange = () => this.scheduleNotify();
+    }
+    updateResolution() {
+        // grpc-js may call updateResolution() again after destroy() to re-initialize the same instance.
+        this.destroyed = false;
+        if (!this.watchRegistered) {
+            (0, k8s_endpoint_watch_1.watchServiceEndpoints)(this.target.namespace, this.target.serviceName, this.onStoreChange);
+            this.watchRegistered = true;
+        }
+        this.scheduleNotify();
+    }
+    destroy() {
+        this.destroyed = true;
+        this.resolutionGeneration += 1;
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = undefined;
+        }
+        this.lastNotifyTimeMs = 0;
+        this.dnsRetryPending = false;
+        this.usingDnsFallback = false;
+        this.lastFallbackWarnTimeMs = 0;
+        if (this.watchRegistered) {
+            (0, k8s_endpoint_watch_1.unwatchServiceEndpoints)(this.target.namespace, this.target.serviceName, this.onStoreChange);
+            this.watchRegistered = false;
+        }
+    }
+    /**
+     * grpc-js requires that the listener is never invoked synchronously with the constructor or
+     * `updateResolution`, so every notification goes through a timer. The same timer rate limits
+     * bursts of EndpointSlice events during a rollout.
+     */
+    scheduleNotify() {
+        if (this.destroyed) {
+            return;
+        }
+        if (this.timeoutId) {
+            return;
+        }
+        const delayMs = Math.max(0, MIN_RESOLUTION_INTERVAL_MS - (Date.now() - this.lastNotifyTimeMs));
+        this.timeoutId = setTimeout(() => {
+            this.timeoutId = undefined;
+            this.notify();
+        }, delayMs);
+        this.timeoutId.unref?.();
+    }
+    notify() {
+        if (this.destroyed) {
+            return;
+        }
+        const resolution = (0, endpoint_slice_store_1.resolveService)(this.target.namespace, this.target.serviceName);
+        // Nothing has been listed yet: stay quiet and wait to be woken by the watch.
+        if (resolution.status === 'pending') {
+            return;
+        }
+        if (resolution.status === 'failed') {
+            if ((0, resolver_constants_1.isDnsFallbackEnabled)()) {
+                void this.tryDnsFallback(resolution.message);
+                return;
+            }
+            this.publishEndpoints([]);
+            return;
+        }
+        this.reportPortMismatch(resolution.ports);
+        // Discovery is healthy and says there is nothing ready. Publish an empty list so grpc-js
+        // drops existing subchannels; a resolver error would leave the last terminating pod in RR.
+        if (resolution.hosts.length === 0) {
+            if (this.usingDnsFallback) {
+                this.usingDnsFallback = false;
+                this.lastFallbackWarnTimeMs = 0;
+            }
+            this.publishEndpoints([]);
+            return;
+        }
+        if (this.usingDnsFallback) {
+            (0, resolver_logger_1.getResolverLogger)().info(`gRPC k8s resolver: EndpointSlice endpoints are available again for ${this.targetName}; ` +
+                'switching back from DNS fallback');
+            this.usingDnsFallback = false;
+            this.lastFallbackWarnTimeMs = 0;
+        }
+        this.publishEndpoints(resolution.hosts);
+    }
+    publishEndpoints(hosts) {
+        if (this.destroyed) {
+            return;
+        }
+        const endpoints = hosts.map((host) => ({
+            addresses: [{ host, port: this.target.port }],
+        }));
+        this.lastNotifyTimeMs = Date.now();
+        // The service config is left to the channel options so per-client retry and method config wins.
+        this.listener(grpc_js_1.experimental.statusOrFromValue(endpoints), {}, null, '');
+    }
+    async tryDnsFallback(discoveryMessage) {
+        if (this.destroyed) {
+            return;
+        }
+        const lookupGeneration = this.resolutionGeneration;
+        // Only one lookup at a time, but the round that arrived meanwhile must not be dropped:
+        // without the replay the channel would be left without any resolution result at all.
+        if (this.dnsLookupInFlight) {
+            this.dnsRetryPending = true;
+            return;
+        }
+        this.dnsLookupInFlight = true;
+        try {
+            const hosts = await (0, dns_fallback_1.resolveHeadlessDnsHosts)(this.target.serviceName, this.target.namespace);
+            if (this.destroyed || lookupGeneration !== this.resolutionGeneration) {
+                return;
+            }
+            const resolution = (0, endpoint_slice_store_1.resolveService)(this.target.namespace, this.target.serviceName);
+            if (resolution.status === 'ready') {
+                if (this.usingDnsFallback) {
+                    this.usingDnsFallback = false;
+                    this.lastFallbackWarnTimeMs = 0;
+                }
+                this.publishEndpoints(resolution.hosts);
+                return;
+            }
+            if (hosts.length === 0) {
+                this.publishEndpoints([]);
+                return;
+            }
+            this.warnAboutFallback(discoveryMessage);
+            this.usingDnsFallback = true;
+            this.publishEndpoints(hosts);
+        }
+        catch (error) {
+            if (this.destroyed || lookupGeneration !== this.resolutionGeneration) {
+                return;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            (0, resolver_logger_1.getResolverLogger)().error(`gRPC k8s resolver: DNS fallback failed for ${this.targetName} (${discoveryMessage}): ${message}`);
+            this.publishEndpoints([]);
+        }
+        finally {
+            this.dnsLookupInFlight = false;
+            if (!this.destroyed && this.dnsRetryPending) {
+                this.dnsRetryPending = false;
+                this.scheduleNotify();
+            }
+        }
+    }
+    /**
+     * Serving from DNS means EndpointSlice discovery is broken and the resolver is doing nothing but
+     * reproducing the old behaviour, so the warning repeats instead of being logged once per pod.
+     */
+    warnAboutFallback(discoveryMessage) {
+        if (this.usingDnsFallback &&
+            Date.now() - this.lastFallbackWarnTimeMs < FALLBACK_WARN_INTERVAL_MS) {
+            return;
+        }
+        this.lastFallbackWarnTimeMs = Date.now();
+        (0, resolver_logger_1.getResolverLogger)().warn(`gRPC k8s resolver: serving ${this.targetName} from headless DNS because EndpointSlice ` +
+            `discovery is unavailable (${discoveryMessage})`);
+    }
+    /**
+     * Headless clients dial the port from the address, exactly as they did through DNS, so a port the
+     * EndpointSlice does not advertise is still used. It is almost always a `targetPort` misconfig,
+     * so it is surfaced once instead of silently producing an empty endpoint list.
+     */
+    reportPortMismatch(ports) {
+        if (this.portMismatchReported ||
+            ports.length === 0 ||
+            ports.some(({ port }) => port === this.target.port)) {
+            return;
+        }
+        this.portMismatchReported = true;
+        (0, resolver_logger_1.getResolverLogger)().warn(`gRPC k8s resolver: ${this.targetName} requests port ${this.target.port}, but its EndpointSlices ` +
+            `advertise ${ports.map(({ port }) => port).join(', ')}. Dialing the requested port anyway.`);
+    }
+}
+exports.K8sResolver = K8sResolver;
+//# sourceMappingURL=k8s-resolver.js.map

package/dist/k8s-resolver.js.map

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

package/dist/resolve-grpc-target-address.d.ts

@@ -0,0 +1,8 @@
+/** Registers the `k8s://` resolver with the process-wide grpc-js resolver registry. */
+export declare const registerK8sResolver: () => void;
+/**
+ * Turns an in-cluster `host:port` address into a Kubernetes-backed gRPC target when
+ * `GRPC_K8S_RESOLVER_ENABLED` is enabled. Explicit `k8s://` targets work without the flag.
+ */
+export declare const resolveGrpcTargetAddress: (address: string) => string;
+//# sourceMappingURL=resolve-grpc-target-address.d.ts.map

package/dist/resolve-grpc-target-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-grpc-target-address.d.ts","sourceRoot":"","sources":["../src/resolve-grpc-target-address.ts"],"names":[],"mappings":"AAOA,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,QAAO,IAOtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,MAc1D,CAAC"}