better-grpc 0.2.1 → 0.2.2

package/README.md

@@ -12,9 +12,9 @@
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 [![Discord](https://img.shields.io/badge/Discord-Join-5865F2.svg?logo=discord&logoColor=white)](https://discord.gg/bZd4CMd2H5)
 
-**`better-grpc`** is a library that provides a new way to define and use RPC services in TypeScript, focusing on developer experience and type safety. It eliminates the need for `.proto` files and code generation, allowing you to define your services entirely in TypeScript.
+**`better-grpc`** is a TypeScript-first gRPC library that focuses on developer experience and type safety. It eliminates the need for `.proto` files and code generation, allowing you to define your services entirely in TypeScript.
 
-The core idea is to enable seamless communication between a client and a server, allowing you to call server-side functions from the client and client-side functions from the server, as if they were local.
+It enables seamless, **bidirectional** communication between a client and a server, allowing developers to call server-side functions from the client and client-side functions from the server, as if they were local.
 
 ## Features
 

package/dist/index.cjs

@@ -3925,10 +3925,10 @@ var require_client_interceptors = __commonJS({
       const host = options.host;
       const parent = (_b = options.parent) !== null && _b !== void 0 ? _b : null;
       const propagateFlags = options.propagate_flags;
-      const credentials2 = options.credentials;
+      const credentials = options.credentials;
       const call = channel.createCall(path, deadline, host, parent, propagateFlags);
-      if (credentials2) {
-        call.setCredentials(credentials2);
+      if (credentials) {
+        call.setCredentials(credentials);
       }
       return call;
     }
@@ -4087,7 +4087,7 @@ var require_client = __commonJS({
       return ((_a = error.stack) === null || _a === void 0 ? void 0 : _a.split("\n").slice(1).join("\n")) || "no stack trace available";
     }
     var Client = class {
-      constructor(address, credentials2, options = {}) {
+      constructor(address, credentials, options = {}) {
         var _a, _b;
         options = Object.assign({}, options);
         this[INTERCEPTOR_SYMBOL] = (_a = options.interceptors) !== null && _a !== void 0 ? _a : [];
@@ -4104,9 +4104,9 @@ var require_client = __commonJS({
         } else if (options.channelFactoryOverride) {
           const channelFactoryOverride = options.channelFactoryOverride;
           delete options.channelFactoryOverride;
-          this[CHANNEL_SYMBOL] = channelFactoryOverride(address, credentials2, options);
+          this[CHANNEL_SYMBOL] = channelFactoryOverride(address, credentials, options);
         } else {
-          this[CHANNEL_SYMBOL] = new channel_1.ChannelImplementation(address, credentials2, options);
+          this[CHANNEL_SYMBOL] = new channel_1.ChannelImplementation(address, credentials, options);
         }
       }
       close() {
@@ -15026,7 +15026,7 @@ var require_single_subchannel_channel = __commonJS({
       getCallNumber() {
         return this.callNumber;
       }
-      setCredentials(credentials2) {
+      setCredentials(credentials) {
         throw new Error("Method not implemented.");
       }
       getAuthContext() {
@@ -15116,7 +15116,7 @@ var require_subchannel = __commonJS({
        * @param credentials The channel credentials used to establish this
        *     connection
        */
-      constructor(channelTarget, subchannelAddress, options, credentials2, connector) {
+      constructor(channelTarget, subchannelAddress, options, credentials, connector) {
         var _a;
         this.channelTarget = channelTarget;
         this.subchannelAddress = subchannelAddress;
@@ -15155,7 +15155,7 @@ var require_subchannel = __commonJS({
         this.channelzRef = (0, channelz_1.registerChannelzSubchannel)(this.subchannelAddressString, () => this.getChannelzInfo(), this.channelzEnabled);
         this.channelzTrace.addTrace("CT_INFO", "Subchannel created");
         this.trace("Subchannel constructed with options " + JSON.stringify(options, void 0, 2));
-        this.secureConnector = credentials2._createSecureConnector(channelTarget, options);
+        this.secureConnector = credentials._createSecureConnector(channelTarget, options);
       }
       getChannelzInfo() {
         return {
@@ -17054,13 +17054,13 @@ var require_load_balancing_call = __commonJS({
     var http2 = __require("http2");
     var TRACER_NAME = "load_balancing_call";
     var LoadBalancingCall = class {
-      constructor(channel, callConfig, methodName, host, credentials2, deadline, callNumber) {
+      constructor(channel, callConfig, methodName, host, credentials, deadline, callNumber) {
         var _a, _b;
         this.channel = channel;
         this.callConfig = callConfig;
         this.methodName = methodName;
         this.host = host;
-        this.credentials = credentials2;
+        this.credentials = credentials;
         this.deadline = deadline;
         this.callNumber = callNumber;
         this.child = null;
@@ -17262,7 +17262,7 @@ var require_load_balancing_call = __commonJS({
           this.pendingHalfClose = true;
         }
       }
-      setCredentials(credentials2) {
+      setCredentials(credentials) {
         throw new Error("Method not implemented.");
       }
       getCallNumber() {
@@ -17543,8 +17543,8 @@ var require_resolving_call = __commonJS({
           this.pendingHalfClose = true;
         }
       }
-      setCredentials(credentials2) {
-        this.credentials = credentials2;
+      setCredentials(credentials) {
+        this.credentials = credentials;
       }
       addStatusWatcher(watcher) {
         this.statusWatchers.push(watcher);
@@ -17638,13 +17638,13 @@ var require_retrying_call = __commonJS({
     var PREVIONS_RPC_ATTEMPTS_METADATA_KEY = "grpc-previous-rpc-attempts";
     var DEFAULT_MAX_ATTEMPTS_LIMIT = 5;
     var RetryingCall = class {
-      constructor(channel, callConfig, methodName, host, credentials2, deadline, callNumber, bufferTracker, retryThrottler) {
+      constructor(channel, callConfig, methodName, host, credentials, deadline, callNumber, bufferTracker, retryThrottler) {
         var _a;
         this.channel = channel;
         this.callConfig = callConfig;
         this.methodName = methodName;
         this.host = host;
-        this.credentials = credentials2;
+        this.credentials = credentials;
         this.deadline = deadline;
         this.callNumber = callNumber;
         this.bufferTracker = bufferTracker;
@@ -18369,9 +18369,9 @@ var require_internal_channel = __commonJS({
       }
     };
     var InternalChannel = class {
-      constructor(target, credentials2, options) {
+      constructor(target, credentials, options) {
         var _a, _b, _c, _d, _e, _f;
-        this.credentials = credentials2;
+        this.credentials = credentials;
         this.options = options;
         this.connectivityState = connectivity_state_1.ConnectivityState.IDLE;
         this.currentPicker = new picker_1.UnavailablePicker();
@@ -18389,7 +18389,7 @@ var require_internal_channel = __commonJS({
         if (typeof target !== "string") {
           throw new TypeError("Channel target must be a string");
         }
-        if (!(credentials2 instanceof channel_credentials_1.ChannelCredentials)) {
+        if (!(credentials instanceof channel_credentials_1.ChannelCredentials)) {
           throw new TypeError("Channel credentials must be a ChannelCredentials object");
         }
         if (options) {
@@ -18671,15 +18671,15 @@ var require_internal_channel = __commonJS({
         this.lastActivityTimestamp = /* @__PURE__ */ new Date();
         this.maybeStartIdleTimer();
       }
-      createLoadBalancingCall(callConfig, method, host, credentials2, deadline) {
+      createLoadBalancingCall(callConfig, method, host, credentials, deadline) {
         const callNumber = (0, call_number_1.getNextCallNumber)();
         this.trace("createLoadBalancingCall [" + callNumber + '] method="' + method + '"');
-        return new load_balancing_call_1.LoadBalancingCall(this, callConfig, method, host, credentials2, deadline, callNumber);
+        return new load_balancing_call_1.LoadBalancingCall(this, callConfig, method, host, credentials, deadline, callNumber);
       }
-      createRetryingCall(callConfig, method, host, credentials2, deadline) {
+      createRetryingCall(callConfig, method, host, credentials, deadline) {
         const callNumber = (0, call_number_1.getNextCallNumber)();
         this.trace("createRetryingCall [" + callNumber + '] method="' + method + '"');
-        return new retrying_call_1.RetryingCall(this, callConfig, method, host, credentials2, deadline, callNumber, this.retryBufferTracker, RETRY_THROTTLER_MAP.get(this.getTarget()));
+        return new retrying_call_1.RetryingCall(this, callConfig, method, host, credentials, deadline, callNumber, this.retryBufferTracker, RETRY_THROTTLER_MAP.get(this.getTarget()));
       }
       createResolvingCall(method, deadline, host, parentCall, propagateFlags) {
         const callNumber = (0, call_number_1.getNextCallNumber)();
@@ -18795,11 +18795,11 @@ var require_channel = __commonJS({
     var channel_credentials_1 = require_channel_credentials();
     var internal_channel_1 = require_internal_channel();
     var ChannelImplementation = class {
-      constructor(target, credentials2, options) {
+      constructor(target, credentials, options) {
         if (typeof target !== "string") {
           throw new TypeError("Channel target must be a string");
         }
-        if (!(credentials2 instanceof channel_credentials_1.ChannelCredentials)) {
+        if (!(credentials instanceof channel_credentials_1.ChannelCredentials)) {
           throw new TypeError("Channel credentials must be a ChannelCredentials object");
         }
         if (options) {
@@ -18807,7 +18807,7 @@ var require_channel = __commonJS({
             throw new TypeError("Channel options must be an object");
           }
         }
-        this.internalChannel = new internal_channel_1.InternalChannel(target, credentials2, options);
+        this.internalChannel = new internal_channel_1.InternalChannel(target, credentials, options);
       }
       close() {
         this.internalChannel.close();
@@ -19334,8 +19334,8 @@ var require_server_credentials = __commonJS({
         return this.childCredentials._getSecureContextOptions();
       }
     };
-    function createServerCredentialsWithInterceptors(credentials2, interceptors) {
-      return new InterceptorServerCredentials(credentials2, interceptors);
+    function createServerCredentialsWithInterceptors(credentials, interceptors) {
+      return new InterceptorServerCredentials(credentials, interceptors);
     }
   }
 });
@@ -20731,11 +20731,11 @@ var require_server = __commonJS({
         experimentalUnregisterListenerFromChannelz(channelzRef) {
           (0, channelz_1.unregisterChannelzRef)(channelzRef);
         }
-        createHttp2Server(credentials2) {
+        createHttp2Server(credentials) {
           let http2Server;
-          if (credentials2._isSecure()) {
-            const constructorOptions = credentials2._getConstructorOptions();
-            const contextOptions = credentials2._getSecureContextOptions();
+          if (credentials._isSecure()) {
+            const constructorOptions = credentials._getConstructorOptions();
+            const contextOptions = credentials._getSecureContextOptions();
             const secureServerOptions = Object.assign(Object.assign(Object.assign(Object.assign({}, this.commonServerOptions), constructorOptions), contextOptions), { enableTrace: this.options["grpc-node.tls_enable_trace"] === 1 });
             let areCredentialsValid = contextOptions !== null;
             this.trace("Initial credentials valid: " + areCredentialsValid);
@@ -20764,15 +20764,15 @@ var require_server = __commonJS({
               areCredentialsValid = options !== null;
               this.trace("Post-update credentials valid: " + areCredentialsValid);
             };
-            credentials2._addWatcher(credsWatcher);
+            credentials._addWatcher(credsWatcher);
             http2Server.on("close", () => {
-              credentials2._removeWatcher(credsWatcher);
+              credentials._removeWatcher(credsWatcher);
             });
           } else {
             http2Server = http2.createServer(this.commonServerOptions);
           }
           http2Server.setTimeout(0, noop);
-          this._setupHandlers(http2Server, credentials2._getInterceptors());
+          this._setupHandlers(http2Server, credentials._getInterceptors());
           return http2Server;
         }
         bindOneAddress(address, boundPortObject) {
@@ -21007,14 +21007,14 @@ var require_server = __commonJS({
          * @param channelzRef
          * @returns
          */
-        experimentalCreateConnectionInjectorWithChannelzRef(credentials2, channelzRef, ownsChannelzRef = false) {
-          if (credentials2 === null || !(credentials2 instanceof server_credentials_1.ServerCredentials)) {
+        experimentalCreateConnectionInjectorWithChannelzRef(credentials, channelzRef, ownsChannelzRef = false) {
+          if (credentials === null || !(credentials instanceof server_credentials_1.ServerCredentials)) {
             throw new TypeError("creds must be a ServerCredentials object");
           }
           if (this.channelzEnabled) {
             this.listenerChildrenTracker.refChild(channelzRef);
           }
-          const server2 = this.createHttp2Server(credentials2);
+          const server2 = this.createHttp2Server(credentials);
           const sessionsSet = /* @__PURE__ */ new Set();
           this.http2Servers.set(server2, {
             channelzRef,
@@ -21044,12 +21044,12 @@ var require_server = __commonJS({
             }
           };
         }
-        createConnectionInjector(credentials2) {
-          if (credentials2 === null || !(credentials2 instanceof server_credentials_1.ServerCredentials)) {
+        createConnectionInjector(credentials) {
+          if (credentials === null || !(credentials instanceof server_credentials_1.ServerCredentials)) {
             throw new TypeError("creds must be a ServerCredentials object");
           }
           const channelzRef = this.registerInjectorToChannelz();
-          return this.experimentalCreateConnectionInjectorWithChannelzRef(credentials2, channelzRef, true);
+          return this.experimentalCreateConnectionInjectorWithChannelzRef(credentials, channelzRef, true);
         }
         closeServer(server2, callback) {
           this.trace("Closing server with address " + JSON.stringify(server2.address()));
@@ -24227,8 +24227,8 @@ var GrpcClient = class {
     this.serviceImpls = serviceImpls;
     this.proto = loadProtoFromString(buildProtoString(serviceImpls));
     const useSSL = !address.includes("localhost") && !address.includes("127.0.0.1") && !address.includes("0.0.0.0");
-    const credentials2 = useSSL ? niceGrpc.ChannelCredentials.createSsl() : grpc.credentials.createInsecure();
-    this.channel = niceGrpc.createChannel(address, credentials2, {
+    const credentials = useSSL ? niceGrpc.ChannelCredentials.createSsl() : niceGrpc.ChannelCredentials.createInsecure();
+    this.channel = niceGrpc.createChannel(address, credentials, {
       "grpc.max_receive_message_length": 10 * 1024 * 1024,
       "grpc.max_send_message_length": 10 * 1024 * 1024,
       "grpc.keepalive_time_ms": 3e4,