summaryrefslogtreecommitdiff
path: root/frontend-old/node_modules/@grpc/grpc-js/src/channel-credentials.ts
diff options
context:
space:
mode:
authoraltaf-creator <dev@altafcreator.com>2025-11-16 19:08:29 +0800
committeraltaf-creator <dev@altafcreator.com>2025-11-16 19:08:29 +0800
commit434aa8343fdcbb4d5002f934979913c099489bee (patch)
tree55bab4ec5a6151be57797d34f61faf5ea744471b /frontend-old/node_modules/@grpc/grpc-js/src/channel-credentials.ts
parent893c388d4e99442a36005e5971a87730623f946e (diff)
sdk, del
Diffstat (limited to 'frontend-old/node_modules/@grpc/grpc-js/src/channel-credentials.ts')
-rw-r--r--frontend-old/node_modules/@grpc/grpc-js/src/channel-credentials.ts267
1 files changed, 0 insertions, 267 deletions
diff --git a/frontend-old/node_modules/@grpc/grpc-js/src/channel-credentials.ts b/frontend-old/node_modules/@grpc/grpc-js/src/channel-credentials.ts
deleted file mode 100644
index 72b19d6..0000000
--- a/frontend-old/node_modules/@grpc/grpc-js/src/channel-credentials.ts
+++ /dev/null
@@ -1,267 +0,0 @@
-/*
- * 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.
- *
- */
-
-import {
- ConnectionOptions,
- createSecureContext,
- PeerCertificate,
- SecureContext,
-} from 'tls';
-
-import { CallCredentials } from './call-credentials';
-import { CIPHER_SUITES, getDefaultRootsData } from './tls-helpers';
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function verifyIsBufferOrNull(obj: any, friendlyName: string): void {
- if (obj && !(obj instanceof Buffer)) {
- throw new TypeError(`${friendlyName}, if provided, must be a Buffer.`);
- }
-}
-
-/**
- * A callback that will receive the expected hostname and presented peer
- * certificate as parameters. The callback should return an error to
- * indicate that the presented certificate is considered invalid and
- * otherwise returned undefined.
- */
-export type CheckServerIdentityCallback = (
- hostname: string,
- cert: PeerCertificate
-) => Error | undefined;
-
-/**
- * Additional peer verification options that can be set when creating
- * SSL credentials.
- */
-export interface VerifyOptions {
- /**
- * If set, this callback will be invoked after the usual hostname verification
- * has been performed on the peer certificate.
- */
- checkServerIdentity?: CheckServerIdentityCallback;
-}
-
-/**
- * A class that contains credentials for communicating over a channel, as well
- * as a set of per-call credentials, which are applied to every method call made
- * over a channel initialized with an instance of this class.
- */
-export abstract class ChannelCredentials {
- protected callCredentials: CallCredentials;
-
- protected constructor(callCredentials?: CallCredentials) {
- this.callCredentials = callCredentials || CallCredentials.createEmpty();
- }
- /**
- * Returns a copy of this object with the included set of per-call credentials
- * expanded to include callCredentials.
- * @param callCredentials A CallCredentials object to associate with this
- * instance.
- */
- abstract compose(callCredentials: CallCredentials): ChannelCredentials;
-
- /**
- * Gets the set of per-call credentials associated with this instance.
- */
- _getCallCredentials(): CallCredentials {
- return this.callCredentials;
- }
-
- /**
- * Gets a SecureContext object generated from input parameters if this
- * instance was created with createSsl, or null if this instance was created
- * with createInsecure.
- */
- abstract _getConnectionOptions(): ConnectionOptions | null;
-
- /**
- * Indicates whether this credentials object creates a secure channel.
- */
- abstract _isSecure(): boolean;
-
- /**
- * Check whether two channel credentials objects are equal. Two secure
- * credentials are equal if they were constructed with the same parameters.
- * @param other The other ChannelCredentials Object
- */
- abstract _equals(other: ChannelCredentials): boolean;
-
- /**
- * Return a new ChannelCredentials instance with a given set of credentials.
- * The resulting instance can be used to construct a Channel that communicates
- * over TLS.
- * @param rootCerts The root certificate data.
- * @param privateKey The client certificate private key, if available.
- * @param certChain The client certificate key chain, if available.
- * @param verifyOptions Additional options to modify certificate verification
- */
- static createSsl(
- rootCerts?: Buffer | null,
- privateKey?: Buffer | null,
- certChain?: Buffer | null,
- verifyOptions?: VerifyOptions
- ): ChannelCredentials {
- verifyIsBufferOrNull(rootCerts, 'Root certificate');
- verifyIsBufferOrNull(privateKey, 'Private key');
- verifyIsBufferOrNull(certChain, 'Certificate chain');
- if (privateKey && !certChain) {
- throw new Error(
- 'Private key must be given with accompanying certificate chain'
- );
- }
- if (!privateKey && certChain) {
- throw new Error(
- 'Certificate chain must be given with accompanying private key'
- );
- }
- const secureContext = createSecureContext({
- ca: rootCerts ?? getDefaultRootsData() ?? undefined,
- key: privateKey ?? undefined,
- cert: certChain ?? undefined,
- ciphers: CIPHER_SUITES,
- });
- return new SecureChannelCredentialsImpl(secureContext, verifyOptions ?? {});
- }
-
- /**
- * Return a new ChannelCredentials instance with credentials created using
- * the provided secureContext. The resulting instances can be used to
- * construct a Channel that communicates over TLS. gRPC will not override
- * anything in the provided secureContext, so the environment variables
- * GRPC_SSL_CIPHER_SUITES and GRPC_DEFAULT_SSL_ROOTS_FILE_PATH will
- * not be applied.
- * @param secureContext The return value of tls.createSecureContext()
- * @param verifyOptions Additional options to modify certificate verification
- */
- static createFromSecureContext(
- secureContext: SecureContext,
- verifyOptions?: VerifyOptions
- ): ChannelCredentials {
- return new SecureChannelCredentialsImpl(secureContext, verifyOptions ?? {});
- }
-
- /**
- * Return a new ChannelCredentials instance with no credentials.
- */
- static createInsecure(): ChannelCredentials {
- return new InsecureChannelCredentialsImpl();
- }
-}
-
-class InsecureChannelCredentialsImpl extends ChannelCredentials {
- constructor(callCredentials?: CallCredentials) {
- super(callCredentials);
- }
-
- compose(callCredentials: CallCredentials): never {
- throw new Error('Cannot compose insecure credentials');
- }
-
- _getConnectionOptions(): ConnectionOptions | null {
- return null;
- }
- _isSecure(): boolean {
- return false;
- }
- _equals(other: ChannelCredentials): boolean {
- return other instanceof InsecureChannelCredentialsImpl;
- }
-}
-
-class SecureChannelCredentialsImpl extends ChannelCredentials {
- connectionOptions: ConnectionOptions;
-
- constructor(
- private secureContext: SecureContext,
- private verifyOptions: VerifyOptions
- ) {
- super();
- this.connectionOptions = {
- secureContext,
- };
- // Node asserts that this option is a function, so we cannot pass undefined
- if (verifyOptions?.checkServerIdentity) {
- this.connectionOptions.checkServerIdentity =
- verifyOptions.checkServerIdentity;
- }
- }
-
- compose(callCredentials: CallCredentials): ChannelCredentials {
- const combinedCallCredentials =
- this.callCredentials.compose(callCredentials);
- return new ComposedChannelCredentialsImpl(this, combinedCallCredentials);
- }
-
- _getConnectionOptions(): ConnectionOptions | null {
- // Copy to prevent callers from mutating this.connectionOptions
- return { ...this.connectionOptions };
- }
- _isSecure(): boolean {
- return true;
- }
- _equals(other: ChannelCredentials): boolean {
- if (this === other) {
- return true;
- }
- if (other instanceof SecureChannelCredentialsImpl) {
- return (
- this.secureContext === other.secureContext &&
- this.verifyOptions.checkServerIdentity ===
- other.verifyOptions.checkServerIdentity
- );
- } else {
- return false;
- }
- }
-}
-
-class ComposedChannelCredentialsImpl extends ChannelCredentials {
- constructor(
- private channelCredentials: SecureChannelCredentialsImpl,
- callCreds: CallCredentials
- ) {
- super(callCreds);
- }
- compose(callCredentials: CallCredentials) {
- const combinedCallCredentials =
- this.callCredentials.compose(callCredentials);
- return new ComposedChannelCredentialsImpl(
- this.channelCredentials,
- combinedCallCredentials
- );
- }
-
- _getConnectionOptions(): ConnectionOptions | null {
- return this.channelCredentials._getConnectionOptions();
- }
- _isSecure(): boolean {
- return true;
- }
- _equals(other: ChannelCredentials): boolean {
- if (this === other) {
- return true;
- }
- if (other instanceof ComposedChannelCredentialsImpl) {
- return (
- this.channelCredentials._equals(other.channelCredentials) &&
- this.callCredentials._equals(other.callCredentials)
- );
- } else {
- return false;
- }
- }
-}