@reptilestyle/grpc-js 1.9.14-compression.1

package/build/src/resolver-dns.js

@@ -0,0 +1,328 @@
+"use strict";
+/*
+ * Copyright 2019 gRPC authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PORT = void 0;
+exports.setup = setup;
+const resolver_1 = require("./resolver");
+const dns = require("dns");
+const util = require("util");
+const service_config_1 = require("./service-config");
+const constants_1 = require("./constants");
+const metadata_1 = require("./metadata");
+const logging = require("./logging");
+const constants_2 = require("./constants");
+const uri_parser_1 = require("./uri-parser");
+const net_1 = require("net");
+const backoff_timeout_1 = require("./backoff-timeout");
+const TRACER_NAME = 'dns_resolver';
+function trace(text) {
+    logging.trace(constants_2.LogVerbosity.DEBUG, TRACER_NAME, text);
+}
+/**
+ * The default TCP port to connect to if not explicitly specified in the target.
+ */
+exports.DEFAULT_PORT = 443;
+const DEFAULT_MIN_TIME_BETWEEN_RESOLUTIONS_MS = 30000;
+const resolveTxtPromise = util.promisify(dns.resolveTxt);
+const dnsLookupPromise = util.promisify(dns.lookup);
+/**
+ * Merge any number of arrays into a single alternating array
+ * @param arrays
+ */
+function mergeArrays(...arrays) {
+    const result = [];
+    for (let i = 0; i <
+        Math.max.apply(null, arrays.map(array => array.length)); i++) {
+        for (const array of arrays) {
+            if (i < array.length) {
+                result.push(array[i]);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Resolver implementation that handles DNS names and IP addresses.
+ */
+class DnsResolver {
+    constructor(target, listener, channelOptions) {
+        var _a, _b, _c;
+        this.target = target;
+        this.listener = listener;
+        this.pendingLookupPromise = null;
+        this.pendingTxtPromise = null;
+        this.latestLookupResult = null;
+        this.latestServiceConfig = null;
+        this.latestServiceConfigError = null;
+        this.continueResolving = false;
+        this.isNextResolutionTimerRunning = false;
+        this.isServiceConfigEnabled = true;
+        this.returnedIpResult = false;
+        trace('Resolver constructed for target ' + (0, uri_parser_1.uriToString)(target));
+        const hostPort = (0, uri_parser_1.splitHostPort)(target.path);
+        if (hostPort === null) {
+            this.ipResult = null;
+            this.dnsHostname = null;
+            this.port = null;
+        }
+        else {
+            if ((0, net_1.isIPv4)(hostPort.host) || (0, net_1.isIPv6)(hostPort.host)) {
+                this.ipResult = [
+                    {
+                        host: hostPort.host,
+                        port: (_a = hostPort.port) !== null && _a !== void 0 ? _a : exports.DEFAULT_PORT,
+                    },
+                ];
+                this.dnsHostname = null;
+                this.port = null;
+            }
+            else {
+                this.ipResult = null;
+                this.dnsHostname = hostPort.host;
+                this.port = (_b = hostPort.port) !== null && _b !== void 0 ? _b : exports.DEFAULT_PORT;
+            }
+        }
+        this.percentage = Math.random() * 100;
+        if (channelOptions['grpc.service_config_disable_resolution'] === 1) {
+            this.isServiceConfigEnabled = false;
+        }
+        this.defaultResolutionError = {
+            code: constants_1.Status.UNAVAILABLE,
+            details: `Name resolution failed for target ${(0, uri_parser_1.uriToString)(this.target)}`,
+            metadata: new metadata_1.Metadata(),
+        };
+        const backoffOptions = {
+            initialDelay: channelOptions['grpc.initial_reconnect_backoff_ms'],
+            maxDelay: channelOptions['grpc.max_reconnect_backoff_ms'],
+        };
+        this.backoff = new backoff_timeout_1.BackoffTimeout(() => {
+            if (this.continueResolving) {
+                this.startResolutionWithBackoff();
+            }
+        }, backoffOptions);
+        this.backoff.unref();
+        this.minTimeBetweenResolutionsMs =
+            (_c = channelOptions['grpc.dns_min_time_between_resolutions_ms']) !== null && _c !== void 0 ? _c : DEFAULT_MIN_TIME_BETWEEN_RESOLUTIONS_MS;
+        this.nextResolutionTimer = setTimeout(() => { }, 0);
+        clearTimeout(this.nextResolutionTimer);
+    }
+    /**
+     * If the target is an IP address, just provide that address as a result.
+     * Otherwise, initiate A, AAAA, and TXT lookups
+     */
+    startResolution() {
+        if (this.ipResult !== null) {
+            if (!this.returnedIpResult) {
+                trace('Returning IP address for target ' + (0, uri_parser_1.uriToString)(this.target));
+                setImmediate(() => {
+                    this.listener.onSuccessfulResolution(this.ipResult, null, null, null, {});
+                });
+                this.returnedIpResult = true;
+            }
+            this.backoff.stop();
+            this.backoff.reset();
+            this.stopNextResolutionTimer();
+            return;
+        }
+        if (this.dnsHostname === null) {
+            trace('Failed to parse DNS address ' + (0, uri_parser_1.uriToString)(this.target));
+            setImmediate(() => {
+                this.listener.onError({
+                    code: constants_1.Status.UNAVAILABLE,
+                    details: `Failed to parse DNS address ${(0, uri_parser_1.uriToString)(this.target)}`,
+                    metadata: new metadata_1.Metadata(),
+                });
+            });
+            this.stopNextResolutionTimer();
+        }
+        else {
+            if (this.pendingLookupPromise !== null) {
+                return;
+            }
+            trace('Looking up DNS hostname ' + this.dnsHostname);
+            /* We clear out latestLookupResult here to ensure that it contains the
+             * latest result since the last time we started resolving. That way, the
+             * TXT resolution handler can use it, but only if it finishes second. We
+             * don't clear out any previous service config results because it's
+             * better to use a service config that's slightly out of date than to
+             * revert to an effectively blank one. */
+            this.latestLookupResult = null;
+            const hostname = this.dnsHostname;
+            /* We lookup both address families here and then split them up later
+             * because when looking up a single family, dns.lookup outputs an error
+             * if the name exists but there are no records for that family, and that
+             * error is indistinguishable from other kinds of errors */
+            this.pendingLookupPromise = dnsLookupPromise(hostname, { all: true });
+            this.pendingLookupPromise.then(addressList => {
+                if (this.pendingLookupPromise === null) {
+                    return;
+                }
+                this.pendingLookupPromise = null;
+                this.backoff.reset();
+                this.backoff.stop();
+                const ip4Addresses = addressList.filter(addr => addr.family === 4);
+                const ip6Addresses = addressList.filter(addr => addr.family === 6);
+                this.latestLookupResult = mergeArrays(ip6Addresses, ip4Addresses).map(addr => ({ host: addr.address, port: +this.port }));
+                const allAddressesString = '[' +
+                    this.latestLookupResult
+                        .map(addr => addr.host + ':' + addr.port)
+                        .join(',') +
+                    ']';
+                trace('Resolved addresses for target ' +
+                    (0, uri_parser_1.uriToString)(this.target) +
+                    ': ' +
+                    allAddressesString);
+                if (this.latestLookupResult.length === 0) {
+                    this.listener.onError(this.defaultResolutionError);
+                    return;
+                }
+                /* If the TXT lookup has not yet finished, both of the last two
+                 * arguments will be null, which is the equivalent of getting an
+                 * empty TXT response. When the TXT lookup does finish, its handler
+                 * can update the service config by using the same address list */
+                this.listener.onSuccessfulResolution(this.latestLookupResult, this.latestServiceConfig, this.latestServiceConfigError, null, {});
+            }, err => {
+                if (this.pendingLookupPromise === null) {
+                    return;
+                }
+                trace('Resolution error for target ' +
+                    (0, uri_parser_1.uriToString)(this.target) +
+                    ': ' +
+                    err.message);
+                this.pendingLookupPromise = null;
+                this.stopNextResolutionTimer();
+                this.listener.onError(this.defaultResolutionError);
+            });
+            /* If there already is a still-pending TXT resolution, we can just use
+             * that result when it comes in */
+            if (this.isServiceConfigEnabled && this.pendingTxtPromise === null) {
+                /* We handle the TXT query promise differently than the others because
+                 * the name resolution attempt as a whole is a success even if the TXT
+                 * lookup fails */
+                this.pendingTxtPromise = resolveTxtPromise(hostname);
+                this.pendingTxtPromise.then(txtRecord => {
+                    if (this.pendingTxtPromise === null) {
+                        return;
+                    }
+                    this.pendingTxtPromise = null;
+                    try {
+                        this.latestServiceConfig = (0, service_config_1.extractAndSelectServiceConfig)(txtRecord, this.percentage);
+                    }
+                    catch (err) {
+                        this.latestServiceConfigError = {
+                            code: constants_1.Status.UNAVAILABLE,
+                            details: `Parsing service config failed with error ${err.message}`,
+                            metadata: new metadata_1.Metadata(),
+                        };
+                    }
+                    if (this.latestLookupResult !== null) {
+                        /* We rely here on the assumption that calling this function with
+                         * identical parameters will be essentialy idempotent, and calling
+                         * it with the same address list and a different service config
+                         * should result in a fast and seamless switchover. */
+                        this.listener.onSuccessfulResolution(this.latestLookupResult, this.latestServiceConfig, this.latestServiceConfigError, null, {});
+                    }
+                }, err => {
+                    /* If TXT lookup fails we should do nothing, which means that we
+                     * continue to use the result of the most recent successful lookup,
+                     * or the default null config object if there has never been a
+                     * successful lookup. We do not set the latestServiceConfigError
+                     * here because that is specifically used for response validation
+                     * errors. We still need to handle this error so that it does not
+                     * bubble up as an unhandled promise rejection. */
+                });
+            }
+        }
+    }
+    startNextResolutionTimer() {
+        var _a, _b;
+        clearTimeout(this.nextResolutionTimer);
+        this.nextResolutionTimer = (_b = (_a = setTimeout(() => {
+            this.stopNextResolutionTimer();
+            if (this.continueResolving) {
+                this.startResolutionWithBackoff();
+            }
+        }, this.minTimeBetweenResolutionsMs)).unref) === null || _b === void 0 ? void 0 : _b.call(_a);
+        this.isNextResolutionTimerRunning = true;
+    }
+    stopNextResolutionTimer() {
+        clearTimeout(this.nextResolutionTimer);
+        this.isNextResolutionTimerRunning = false;
+    }
+    startResolutionWithBackoff() {
+        if (this.pendingLookupPromise === null) {
+            this.continueResolving = false;
+            this.backoff.runOnce();
+            this.startNextResolutionTimer();
+            this.startResolution();
+        }
+    }
+    updateResolution() {
+        /* If there is a pending lookup, just let it finish. Otherwise, if the
+         * nextResolutionTimer or backoff timer is running, set the
+         * continueResolving flag to resolve when whichever of those timers
+         * fires. Otherwise, start resolving immediately. */
+        if (this.pendingLookupPromise === null) {
+            if (this.isNextResolutionTimerRunning || this.backoff.isRunning()) {
+                if (this.isNextResolutionTimerRunning) {
+                    trace('resolution update delayed by "min time between resolutions" rate limit');
+                }
+                else {
+                    trace('resolution update delayed by backoff timer until ' + this.backoff.getEndTime().toISOString());
+                }
+                this.continueResolving = true;
+            }
+            else {
+                this.startResolutionWithBackoff();
+            }
+        }
+    }
+    /**
+     * Reset the resolver to the same state it had when it was created. In-flight
+     * DNS requests cannot be cancelled, but they are discarded and their results
+     * will be ignored.
+     */
+    destroy() {
+        this.continueResolving = false;
+        this.backoff.reset();
+        this.backoff.stop();
+        this.stopNextResolutionTimer();
+        this.pendingLookupPromise = null;
+        this.pendingTxtPromise = null;
+        this.latestLookupResult = null;
+        this.latestServiceConfig = null;
+        this.latestServiceConfigError = null;
+        this.returnedIpResult = false;
+    }
+    /**
+     * Get the default authority for the given target. For IP targets, that is
+     * the IP address. For DNS targets, it is the hostname.
+     * @param target
+     */
+    static getDefaultAuthority(target) {
+        return target.path;
+    }
+}
+/**
+ * Set up the DNS resolver class by registering it as the handler for the
+ * "dns:" prefix and as the default resolver.
+ */
+function setup() {
+    (0, resolver_1.registerResolver)('dns', DnsResolver);
+    (0, resolver_1.registerDefaultScheme)('dns');
+}
+//# sourceMappingURL=resolver-dns.js.map

package/build/src/resolver-dns.js.map

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

package/build/src/resolver-ip.d.ts

@@ -0,0 +1 @@
+export declare function setup(): void;

package/build/src/resolver-ip.js

@@ -0,0 +1,104 @@
+"use strict";
+/*
+ * Copyright 2021 gRPC authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setup = setup;
+const net_1 = require("net");
+const constants_1 = require("./constants");
+const metadata_1 = require("./metadata");
+const resolver_1 = require("./resolver");
+const uri_parser_1 = require("./uri-parser");
+const logging = require("./logging");
+const TRACER_NAME = 'ip_resolver';
+function trace(text) {
+    logging.trace(constants_1.LogVerbosity.DEBUG, TRACER_NAME, text);
+}
+const IPV4_SCHEME = 'ipv4';
+const IPV6_SCHEME = 'ipv6';
+/**
+ * The default TCP port to connect to if not explicitly specified in the target.
+ */
+const DEFAULT_PORT = 443;
+class IpResolver {
+    constructor(target, listener, channelOptions) {
+        var _a;
+        this.listener = listener;
+        this.addresses = [];
+        this.error = null;
+        this.hasReturnedResult = false;
+        trace('Resolver constructed for target ' + (0, uri_parser_1.uriToString)(target));
+        const addresses = [];
+        if (!(target.scheme === IPV4_SCHEME || target.scheme === IPV6_SCHEME)) {
+            this.error = {
+                code: constants_1.Status.UNAVAILABLE,
+                details: `Unrecognized scheme ${target.scheme} in IP resolver`,
+                metadata: new metadata_1.Metadata(),
+            };
+            return;
+        }
+        const pathList = target.path.split(',');
+        for (const path of pathList) {
+            const hostPort = (0, uri_parser_1.splitHostPort)(path);
+            if (hostPort === null) {
+                this.error = {
+                    code: constants_1.Status.UNAVAILABLE,
+                    details: `Failed to parse ${target.scheme} address ${path}`,
+                    metadata: new metadata_1.Metadata(),
+                };
+                return;
+            }
+            if ((target.scheme === IPV4_SCHEME && !(0, net_1.isIPv4)(hostPort.host)) ||
+                (target.scheme === IPV6_SCHEME && !(0, net_1.isIPv6)(hostPort.host))) {
+                this.error = {
+                    code: constants_1.Status.UNAVAILABLE,
+                    details: `Failed to parse ${target.scheme} address ${path}`,
+                    metadata: new metadata_1.Metadata(),
+                };
+                return;
+            }
+            addresses.push({
+                host: hostPort.host,
+                port: (_a = hostPort.port) !== null && _a !== void 0 ? _a : DEFAULT_PORT,
+            });
+        }
+        this.addresses = addresses;
+        trace('Parsed ' + target.scheme + ' address list ' + this.addresses);
+    }
+    updateResolution() {
+        if (!this.hasReturnedResult) {
+            this.hasReturnedResult = true;
+            process.nextTick(() => {
+                if (this.error) {
+                    this.listener.onError(this.error);
+                }
+                else {
+                    this.listener.onSuccessfulResolution(this.addresses, null, null, null, {});
+                }
+            });
+        }
+    }
+    destroy() {
+        this.hasReturnedResult = false;
+    }
+    static getDefaultAuthority(target) {
+        return target.path.split(',')[0];
+    }
+}
+function setup() {
+    (0, resolver_1.registerResolver)(IPV4_SCHEME, IpResolver);
+    (0, resolver_1.registerResolver)(IPV6_SCHEME, IpResolver);
+}
+//# sourceMappingURL=resolver-ip.js.map

package/build/src/resolver-ip.js.map

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

package/build/src/resolver-uds.d.ts

@@ -0,0 +1 @@
+export declare function setup(): void;

package/build/src/resolver-uds.js

@@ -0,0 +1,50 @@
+"use strict";
+/*
+ * Copyright 2019 gRPC authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setup = setup;
+const resolver_1 = require("./resolver");
+class UdsResolver {
+    constructor(target, listener, channelOptions) {
+        this.listener = listener;
+        this.addresses = [];
+        this.hasReturnedResult = false;
+        let path;
+        if (target.authority === '') {
+            path = '/' + target.path;
+        }
+        else {
+            path = target.path;
+        }
+        this.addresses = [{ path }];
+    }
+    updateResolution() {
+        if (!this.hasReturnedResult) {
+            this.hasReturnedResult = true;
+            process.nextTick(this.listener.onSuccessfulResolution, this.addresses, null, null, null, {});
+        }
+    }
+    destroy() {
+        // This resolver owns no resources, so we do nothing here.
+    }
+    static getDefaultAuthority(target) {
+        return 'localhost';
+    }
+}
+function setup() {
+    (0, resolver_1.registerResolver)('unix', UdsResolver);
+}
+//# sourceMappingURL=resolver-uds.js.map

package/build/src/resolver-uds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-uds.js","sourceRoot":"","sources":["../../src/resolver-uds.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AA8CH,sBAEC;AA9CD,yCAA0E;AAK1E,MAAM,WAAW;IAGf,YACE,MAAe,EACP,QAA0B,EAClC,cAA8B;QADtB,aAAQ,GAAR,QAAQ,CAAkB;QAJ5B,cAAS,GAAwB,EAAE,CAAC;QACpC,sBAAiB,GAAG,KAAK,CAAC;QAMhC,IAAI,IAAY,CAAC;QACjB,IAAI,MAAM,CAAC,SAAS,KAAK,EAAE,EAAE,CAAC;YAC5B,IAAI,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAC9B,OAAO,CAAC,QAAQ,CACd,IAAI,CAAC,QAAQ,CAAC,sBAAsB,EACpC,IAAI,CAAC,SAAS,EACd,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,0DAA0D;IAC5D,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,MAAe;QACxC,OAAO,WAAW,CAAC;IACrB,CAAC;CACF;AAED,SAAgB,KAAK;IACnB,IAAA,2BAAgB,EAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC"}

package/build/src/resolver.d.ts

@@ -0,0 +1,105 @@
+import { MethodConfig, ServiceConfig } from './service-config';
+import { StatusObject } from './call-interface';
+import { SubchannelAddress } from './subchannel-address';
+import { GrpcUri } from './uri-parser';
+import { ChannelOptions } from './channel-options';
+import { Metadata } from './metadata';
+import { Status } from './constants';
+import { Filter, FilterFactory } from './filter';
+export interface CallConfig {
+    methodConfig: MethodConfig;
+    onCommitted?: () => void;
+    pickInformation: {
+        [key: string]: string;
+    };
+    status: Status;
+    dynamicFilterFactories: FilterFactory<Filter>[];
+}
+/**
+ * Selects a configuration for a method given the name and metadata. Defined in
+ * https://github.com/grpc/proposal/blob/master/A31-xds-timeout-support-and-config-selector.md#new-functionality-in-grpc
+ */
+export interface ConfigSelector {
+    (methodName: string, metadata: Metadata): CallConfig;
+}
+/**
+ * A listener object passed to the resolver's constructor that provides name
+ * resolution updates back to the resolver's owner.
+ */
+export interface ResolverListener {
+    /**
+     * Called whenever the resolver has new name resolution results to report
+     * @param addressList The new list of backend addresses
+     * @param serviceConfig The new service configuration corresponding to the
+     *     `addressList`. Will be `null` if no service configuration was
+     *     retrieved or if the service configuration was invalid
+     * @param serviceConfigError If non-`null`, indicates that the retrieved
+     *     service configuration was invalid
+     */
+    onSuccessfulResolution(addressList: SubchannelAddress[], serviceConfig: ServiceConfig | null, serviceConfigError: StatusObject | null, configSelector: ConfigSelector | null, attributes: {
+        [key: string]: unknown;
+    }): void;
+    /**
+     * Called whenever a name resolution attempt fails.
+     * @param error Describes how resolution failed
+     */
+    onError(error: StatusObject): void;
+}
+/**
+ * A resolver class that handles one or more of the name syntax schemes defined
+ * in the [gRPC Name Resolution document](https://github.com/grpc/grpc/blob/master/doc/naming.md)
+ */
+export interface Resolver {
+    /**
+     * Indicates that the caller wants new name resolution data. Calling this
+     * function may eventually result in calling one of the `ResolverListener`
+     * functions, but that is not guaranteed. Those functions will never be
+     * called synchronously with the constructor or updateResolution.
+     */
+    updateResolution(): void;
+    /**
+     * Discard all resources owned by the resolver. A later call to
+     * `updateResolution` should reinitialize those resources.  No
+     * `ResolverListener` callbacks should be called after `destroy` is called
+     * until `updateResolution` is called again.
+     */
+    destroy(): void;
+}
+export interface ResolverConstructor {
+    new (target: GrpcUri, listener: ResolverListener, channelOptions: ChannelOptions): Resolver;
+    /**
+     * Get the default authority for a target. This loosely corresponds to that
+     * target's hostname. Throws an error if this resolver class cannot parse the
+     * `target`.
+     * @param target
+     */
+    getDefaultAuthority(target: GrpcUri): string;
+}
+/**
+ * Register a resolver class to handle target names prefixed with the `prefix`
+ * string. This prefix should correspond to a URI scheme name listed in the
+ * [gRPC Name Resolution document](https://github.com/grpc/grpc/blob/master/doc/naming.md)
+ * @param prefix
+ * @param resolverClass
+ */
+export declare function registerResolver(scheme: string, resolverClass: ResolverConstructor): void;
+/**
+ * Register a default resolver to handle target names that do not start with
+ * any registered prefix.
+ * @param resolverClass
+ */
+export declare function registerDefaultScheme(scheme: string): void;
+/**
+ * Create a name resolver for the specified target, if possible. Throws an
+ * error if no such name resolver can be created.
+ * @param target
+ * @param listener
+ */
+export declare function createResolver(target: GrpcUri, listener: ResolverListener, options: ChannelOptions): Resolver;
+/**
+ * Get the default authority for the specified target, if possible. Throws an
+ * error if no registered name resolver can parse that target string.
+ * @param target
+ */
+export declare function getDefaultAuthority(target: GrpcUri): string;
+export declare function mapUriDefaultScheme(target: GrpcUri): GrpcUri | null;