Auto-commit 2026-04-29 16:31

This commit is contained in:
2026-04-29 16:31:27 -04:00
parent e8687bb6b2
commit 0495ee5bd2
19691 changed files with 3272886 additions and 138 deletions

View File

@@ -0,0 +1,29 @@
/**
* Copyright 2020 Google LLC
*
* 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 { APICaller } from '../apiCaller';
import { Descriptor } from '../descriptor';
import { StreamType } from './streaming';
/**
* A descriptor for streaming calls.
*/
export declare class StreamDescriptor implements Descriptor {
type: StreamType;
streaming: boolean;
rest?: boolean;
gaxStreamingRetries?: boolean;
constructor(streamType: StreamType, rest?: boolean, gaxStreamingRetries?: boolean);
getApiCaller(): APICaller;
}

View File

@@ -0,0 +1,38 @@
"use strict";
/**
* Copyright 2020 Google LLC
*
* 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.StreamDescriptor = void 0;
const streamingApiCaller_1 = require("./streamingApiCaller");
/**
* A descriptor for streaming calls.
*/
class StreamDescriptor {
constructor(streamType, rest, gaxStreamingRetries) {
this.type = streamType;
this.streaming = true;
this.rest = rest;
this.gaxStreamingRetries = gaxStreamingRetries;
}
getApiCaller() {
// Right now retrying does not work with gRPC-streaming, because retryable
// assumes an API call returns an event emitter while gRPC-streaming methods
// return Stream.
return new streamingApiCaller_1.StreamingApiCaller(this);
}
}
exports.StreamDescriptor = StreamDescriptor;
//# sourceMappingURL=streamDescriptor.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"streamDescriptor.js","sourceRoot":"","sources":["../../../src/streamingCalls/streamDescriptor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAKH,6DAAwD;AAExD;;GAEG;AACH,MAAa,gBAAgB;IAM3B,YACE,UAAsB,EACtB,IAAc,EACd,mBAA6B;QAE7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IACjD,CAAC;IAED,YAAY;QACV,0EAA0E;QAC1E,4EAA4E;QAC5E,iBAAiB;QACjB,OAAO,IAAI,uCAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;CACF;AAvBD,4CAuBC"}

View File

@@ -0,0 +1,125 @@
/**
* Copyright 2020 Google LLC
*
* 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 { Duplex, DuplexOptions, Readable, Stream, Writable } from 'stream';
import { APICallback, CancellableStream, GRPCCallResult, SimpleCallbackFunction } from '../apitypes';
import { RetryOptions, RetryRequestOptions } from '../gax';
import { GoogleError } from '../googleError';
declare const duplexify: DuplexifyConstructor;
export interface DuplexifyOptions extends DuplexOptions {
autoDestroy?: boolean;
end?: boolean;
}
export interface Duplexify extends Duplex {
readonly destroyed: boolean;
setWritable(writable: Writable | false | null): void;
setReadable(readable: Readable | false | null): void;
}
export interface DuplexifyConstructor {
obj(writable?: Writable | false | null, readable?: Readable | false | null, options?: DuplexifyOptions): Duplexify;
new (writable?: Writable | false | null, readable?: Readable | false | null, options?: DuplexifyOptions): Duplexify;
(writable?: Writable | false | null, readable?: Readable | false | null, options?: DuplexifyOptions): Duplexify;
}
/**
* The type of gRPC streaming.
* @enum {number}
*/
export declare enum StreamType {
/** Client sends a single request, server streams responses. */
SERVER_STREAMING = 1,
/** Client streams requests, server returns a single response. */
CLIENT_STREAMING = 2,
/** Both client and server stream objects. */
BIDI_STREAMING = 3
}
export declare class StreamProxy extends duplexify implements GRPCCallResult {
type: StreamType;
private _callback;
private _isCancelCalled;
stream?: CancellableStream;
private _responseHasSent;
rest?: boolean;
gaxServerStreamingRetries?: boolean;
apiCall?: SimpleCallbackFunction;
argument?: {};
/**
* StreamProxy is a proxy to gRPC-streaming method.
*
* @private
* @constructor
* @param {StreamType} type - the type of gRPC stream.
* @param {ApiCallback} callback - the callback for further API call.
*/
constructor(type: StreamType, callback: APICallback, rest?: boolean, gaxServerStreamingRetries?: boolean);
private shouldRetryRequest;
cancel(): void;
/**
* Helper function to handle total timeout + max retry check for server streaming retries
* @param {number} deadline - the current retry deadline
* @param {number} maxRetries - maximum total number of retries
* @param {number} totalTimeoutMillis - total timeout in milliseconds used in timeout calculation
* @param {GoogleError} originalError - underlying error received by the stream
* @param {originalTimeout} originalTimeout - the original Timeout set in backoff settings
* @param {retries} retries - the number of retries the call has made so far
*/
throwIfMaxRetriesOrTotalTimeoutExceeded(deadline: number, maxRetries: number, totalTimeoutMillis: number, originalError: GoogleError, originalTimeout: number | undefined, retries: number): void;
/**
* Forwards events from an API request stream to the user's stream.
* @param {Stream} stream - The API request stream.
*/
eventForwardHelper(stream: Stream): void;
/**
* Helper function that emits a response on the stream after either a 'metadata'
* or a 'status' event - this helps streams to behave more like http consumers expect
* @param {Stream} stream - The API request stream.
*/
statusMetadataHelper(stream: Stream): void;
/**
* Forward events from an API request stream to the user's stream.
* @param {Stream} stream - The API request stream.
* @param {RetryOptions} retry - Configures the exceptions upon which the
* function should retry, and the parameters to the exponential backoff retry
* algorithm.
*/
forwardEvents(stream: Stream): void;
/**
* Default mechanism for determining whether a streaming call should retry
* If a user passes in a "shouldRetryFn", this will not be used
* @param {GoogleError} errpr - The error we need to determine is retryable or not
* @param {RetryOptions} retry - Configures the exceptions upon which the
* function should retry, and the parameters to the exponential backoff retry
* algorithm.
*/
defaultShouldRetry(error: GoogleError, retry: RetryOptions): boolean;
/**
* Specifies the target stream.
* @param {ApiCall} apiCall - the API function to be called.
* @param {Object} argument - the argument to be passed to the apiCall.
* @param {RetryOptions} retry - Configures the exceptions upon which the
* function should retry, and the parameters to the exponential backoff retry
* algorithm.
*/
setStream(apiCall: SimpleCallbackFunction, argument: {}, retryRequestOptions: RetryRequestOptions | undefined, retry: RetryOptions): void;
/**
* Creates a new retry request stream -
*inner arrow function "newMakeRequest" handles retrying and resumption
* @param {streamingRetryRequestOptions} opts
* {request} - the request to be made if the stream errors
* {retry} - the retry options associated with the call
* @returns {CancellableStream} - the stream that handles retry logic
*/
private newStreamingRetryRequest;
}
export {};

View File

@@ -0,0 +1,453 @@
"use strict";
/**
* Copyright 2020 Google LLC
*
* 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.StreamProxy = exports.StreamType = void 0;
const gax_1 = require("../gax");
const googleError_1 = require("../googleError");
const status_1 = require("../status");
const stream_1 = require("stream");
// eslint-disable-next-line @typescript-eslint/no-var-requires
const duplexify = require('duplexify');
// eslint-disable-next-line @typescript-eslint/no-var-requires
const retryRequest = require('retry-request');
/**
* The type of gRPC streaming.
* @enum {number}
*/
var StreamType;
(function (StreamType) {
/** Client sends a single request, server streams responses. */
StreamType[StreamType["SERVER_STREAMING"] = 1] = "SERVER_STREAMING";
/** Client streams requests, server returns a single response. */
StreamType[StreamType["CLIENT_STREAMING"] = 2] = "CLIENT_STREAMING";
/** Both client and server stream objects. */
StreamType[StreamType["BIDI_STREAMING"] = 3] = "BIDI_STREAMING";
})(StreamType || (exports.StreamType = StreamType = {}));
// In retry-request, you could pass parameters to request using the requestOpts parameter
// when we called retry-request from gax, we always passed null
// passing null here removes an unnecessary parameter from this implementation
const requestOps = null;
class StreamProxy extends duplexify {
/**
* StreamProxy is a proxy to gRPC-streaming method.
*
* @private
* @constructor
* @param {StreamType} type - the type of gRPC stream.
* @param {ApiCallback} callback - the callback for further API call.
*/
constructor(type, callback, rest, gaxServerStreamingRetries) {
super(undefined, undefined, {
objectMode: true,
readable: type !== StreamType.CLIENT_STREAMING,
writable: type !== StreamType.SERVER_STREAMING,
});
this.type = type;
this._callback = callback;
this._isCancelCalled = false;
this._responseHasSent = false;
this.rest = rest;
this.gaxServerStreamingRetries = gaxServerStreamingRetries;
}
shouldRetryRequest(error, retry) {
const e = googleError_1.GoogleError.parseGRPCStatusDetails(error);
let shouldRetry = this.defaultShouldRetry(e, retry);
if (retry.shouldRetryFn) {
shouldRetry = retry.shouldRetryFn(e);
}
return shouldRetry;
}
cancel() {
if (this.stream) {
this.stream.cancel();
}
else {
this._isCancelCalled = true;
}
}
/**
* Helper function to handle total timeout + max retry check for server streaming retries
* @param {number} deadline - the current retry deadline
* @param {number} maxRetries - maximum total number of retries
* @param {number} totalTimeoutMillis - total timeout in milliseconds used in timeout calculation
* @param {GoogleError} originalError - underlying error received by the stream
* @param {originalTimeout} originalTimeout - the original Timeout set in backoff settings
* @param {retries} retries - the number of retries the call has made so far
*/
throwIfMaxRetriesOrTotalTimeoutExceeded(deadline, maxRetries, totalTimeoutMillis, originalError, originalTimeout, retries) {
const now = new Date();
const nowTime = now.getTime();
if (originalTimeout &&
(totalTimeoutMillis === 0 ||
totalTimeoutMillis < 0 ||
(deadline && nowTime >= deadline))) {
const error = new googleError_1.GoogleError(`Total timeout of API exceeded ${originalTimeout} milliseconds ${originalError ? `retrying error ${originalError} ` : ''} before any response was received.`);
error.code = status_1.Status.DEADLINE_EXCEEDED;
throw error;
}
if (maxRetries === 0) {
const error = originalError;
error.note = 'Max retries is set to zero.';
throw error;
}
if (retries && retries >= maxRetries) {
const error = new googleError_1.GoogleError('Exceeded maximum number of retries ' +
(originalError ? `retrying error ${originalError} ` : '') +
'before any response was received');
error.code = status_1.Status.DEADLINE_EXCEEDED;
throw error;
}
}
/**
* Forwards events from an API request stream to the user's stream.
* @param {Stream} stream - The API request stream.
*/
eventForwardHelper(stream) {
const eventsToForward = ['metadata', 'response', 'status'];
eventsToForward.forEach(event => {
stream.on(event, this.emit.bind(this, event));
});
}
/**
* Helper function that emits a response on the stream after either a 'metadata'
* or a 'status' event - this helps streams to behave more like http consumers expect
* @param {Stream} stream - The API request stream.
*/
statusMetadataHelper(stream) {
// gRPC is guaranteed emit the 'status' event but not 'metadata', and 'status' is the last event to emit.
// Emit the 'response' event if stream has no 'metadata' event.
// This avoids the stream swallowing the other events, such as 'end'.
stream.on('status', () => {
if (!this._responseHasSent) {
stream.emit('response', {
code: 200,
details: '',
message: 'OK',
});
}
});
// We also want to supply the status data as 'response' event to support
// the behavior of google-cloud-node expects.
// see:
// https://github.com/GoogleCloudPlatform/google-cloud-node/pull/1775#issuecomment-259141029
// https://github.com/GoogleCloudPlatform/google-cloud-node/blob/116436fa789d8b0f7fc5100b19b424e3ec63e6bf/packages/common/src/grpc-service.js#L355
stream.on('metadata', metadata => {
// Create a response object with succeeds.
// TODO: unify this logic with the decoration of gRPC response when it's
// added. see: https://github.com/googleapis/gax-nodejs/issues/65
stream.emit('response', {
code: 200,
details: '',
message: 'OK',
metadata,
});
this._responseHasSent = true;
});
}
/**
* Forward events from an API request stream to the user's stream.
* @param {Stream} stream - The API request stream.
* @param {RetryOptions} retry - Configures the exceptions upon which the
* function should retry, and the parameters to the exponential backoff retry
* algorithm.
*/
forwardEvents(stream) {
this.eventForwardHelper(stream);
this.statusMetadataHelper(stream);
stream.on('error', error => {
googleError_1.GoogleError.parseGRPCStatusDetails(error);
});
}
/**
* Default mechanism for determining whether a streaming call should retry
* If a user passes in a "shouldRetryFn", this will not be used
* @param {GoogleError} errpr - The error we need to determine is retryable or not
* @param {RetryOptions} retry - Configures the exceptions upon which the
* function should retry, and the parameters to the exponential backoff retry
* algorithm.
*/
defaultShouldRetry(error, retry) {
if ((retry.retryCodes.length > 0 &&
retry.retryCodes.indexOf(error.code) < 0) ||
retry.retryCodes.length === 0) {
return false;
}
return true;
}
/**
* Specifies the target stream.
* @param {ApiCall} apiCall - the API function to be called.
* @param {Object} argument - the argument to be passed to the apiCall.
* @param {RetryOptions} retry - Configures the exceptions upon which the
* function should retry, and the parameters to the exponential backoff retry
* algorithm.
*/
setStream(apiCall, argument, retryRequestOptions = {}, retry) {
this.apiCall = apiCall;
this.argument = argument;
if (this.type === StreamType.SERVER_STREAMING) {
if (this.rest) {
const stream = apiCall(argument, this._callback);
this.stream = stream;
this.setReadable(stream);
}
else if (this.gaxServerStreamingRetries) {
const request = () => {
if (this._isCancelCalled) {
if (this.stream) {
this.stream.cancel();
}
return;
}
const stream = apiCall(argument, this._callback);
return stream;
};
const retryStream = this.newStreamingRetryRequest({ request, retry });
this.stream = retryStream;
this.eventForwardHelper(retryStream);
this.setReadable(retryStream);
}
else {
const retryStream = retryRequest(null, {
objectMode: true,
request: () => {
if (this._isCancelCalled) {
if (this.stream) {
this.stream.cancel();
}
return;
}
const stream = apiCall(argument, this._callback);
this.stream = stream;
this.forwardEvents(stream);
return stream;
},
retries: retryRequestOptions.retries,
currentRetryAttempt: retryRequestOptions.currentRetryAttempt,
noResponseRetries: retryRequestOptions.noResponseRetries,
shouldRetryFn: retryRequestOptions.shouldRetryFn,
});
this.setReadable(retryStream);
}
return;
}
const stream = apiCall(argument, this._callback);
this.stream = stream;
this.forwardEvents(stream);
if (this.type === StreamType.CLIENT_STREAMING) {
this.setWritable(stream);
}
if (this.type === StreamType.BIDI_STREAMING) {
this.setReadable(stream);
this.setWritable(stream);
}
if (this._isCancelCalled && this.stream) {
this.stream.cancel();
}
}
/**
* Creates a new retry request stream -
*inner arrow function "newMakeRequest" handles retrying and resumption
* @param {streamingRetryRequestOptions} opts
* {request} - the request to be made if the stream errors
* {retry} - the retry options associated with the call
* @returns {CancellableStream} - the stream that handles retry logic
*/
newStreamingRetryRequest(opts) {
var _a, _b, _c, _d;
// at this point, it would be unexpected if retry were undefined
// but if it is, provide a logical default so we don't run into trouble
const retry = (_a = opts.retry) !== null && _a !== void 0 ? _a : {
retryCodes: [],
backoffSettings: (0, gax_1.createDefaultBackoffSettings)(),
};
let retries = 0;
const retryStream = new stream_1.PassThrough({
objectMode: true,
});
const totalTimeout = (_b = retry.backoffSettings.totalTimeoutMillis) !== null && _b !== void 0 ? _b : undefined;
const maxRetries = (_c = retry.backoffSettings.maxRetries) !== null && _c !== void 0 ? _c : undefined;
let timeout = (_d = retry.backoffSettings.initialRpcTimeoutMillis) !== null && _d !== void 0 ? _d : undefined;
let now = new Date();
let deadline = 0;
if (totalTimeout) {
deadline = now.getTime() + totalTimeout;
}
const transientErrorHelper = (error, requestStream) => {
const e = googleError_1.GoogleError.parseGRPCStatusDetails(error);
e.note =
'Exception occurred in retry method that was ' +
'not classified as transient';
// clean up the request stream and retryStreams, silently destroy it on the request stream
// but do raise it on destructin of the retryStream so the consumer can see it
requestStream.destroy();
retryStream.destroy(e);
return retryStream;
};
const newMakeRequest = (newopts) => {
let dataEnd = false;
let statusReceived = false;
let enteredError = false;
// make the request
const requestStream = newopts.request(requestOps);
retryStream.cancel = requestStream.cancel; // make sure the retryStream is also cancellable by the user
const eventsToForward = ['metadata', 'response', 'status'];
eventsToForward.forEach(event => {
requestStream.on(event, retryStream.emit.bind(retryStream, event));
});
this.statusMetadataHelper(requestStream);
// TODO - b/353262542 address buffer stuff
requestStream.on('data', (data) => {
retries = 0;
this.emit.bind(this, 'data')(data);
});
/* in retry-request, which previously handled retries,
* "end" could be emitted on a request stream before other gRPC events.
* To ensure it doesn't reach the consumer stream prematurely, retry-request piped
* two streams together (delayStream and retryStream)
* to ensure that "end" only emitted after a "response" event
*
* We are consciously NOT using pipeline or .pipe as part of similar logic here
* because we want more control over what happens during event handoff and we want to
* avoid the undesired behavior that can happen with error events
* if consumers in client libraries are also using pipes
*
* Since "status" is guaranteed to be the last event emitted by gRPC.
* If we have seen an "end" event, the dataEnd boolean will be true and we can safely
* end the stream.
*
* The "statusReceived" boolean covers the opposite case - that we receive the "status" event before
* a successful stream end event - this signals the .on('end') event handler that it's okay to end the stream
*
*
*/
requestStream.on('status', () => {
statusReceived = true;
if (dataEnd) {
retryStream.end();
}
return retryStream;
});
requestStream.on('end', () => {
if (!enteredError) {
dataEnd = true;
// in this case, we've already received "status"
// which is the last event from gRPC, so it's cool to end the stream
if (statusReceived) {
retryStream.end();
}
}
return retryStream;
// there is no else case because if enteredError
// is true, we will handle stream destruction as part of
// either retrying (where we don't want to end the stream)
// or as part of error handling, which will take care of stream destruction
});
requestStream.on('error', (error) => {
enteredError = true;
// type check for undefined instead of for truthiness in case maxRetries or timeout is equal to zero
if (typeof maxRetries !== undefined ||
typeof totalTimeout !== undefined) {
if (this.shouldRetryRequest(error, retry)) {
if (maxRetries && totalTimeout) {
const newError = new googleError_1.GoogleError('Cannot set both totalTimeoutMillis and maxRetries ' +
'in backoffSettings.');
newError.code = status_1.Status.INVALID_ARGUMENT;
// clean up the request stream and retryStreams, silently destroy it on the request stream
// but do raise it on destructin of the retryStream so the consumer can see it
requestStream.destroy();
retryStream.destroy(newError);
return retryStream;
}
else {
// check for exceeding timeout or max retries
try {
this.throwIfMaxRetriesOrTotalTimeoutExceeded(deadline, maxRetries, timeout, error, totalTimeout, retries);
}
catch (error) {
const e = googleError_1.GoogleError.parseGRPCStatusDetails(error);
// clean up the request stream and retryStreams, silently destroy it on the request stream
// but do raise it on destruction of the retryStream so the consumer can see it
requestStream.destroy();
retryStream.destroy(e);
return retryStream;
}
const delayMult = retry.backoffSettings.retryDelayMultiplier;
const maxDelay = retry.backoffSettings.maxRetryDelayMillis;
const timeoutMult = retry.backoffSettings.rpcTimeoutMultiplier;
const maxTimeout = retry.backoffSettings.maxRpcTimeoutMillis;
let delay = retry.backoffSettings.initialRetryDelayMillis;
// calculate new deadlines
const toSleep = Math.random() * delay;
const calculateTimeoutAndResumptionFunction = () => {
setTimeout(() => {
// only do timeout calculations if not using maxRetries
if (timeout) {
now = new Date();
delay = Math.min(delay * delayMult, maxDelay);
const timeoutCal = timeout && timeoutMult ? timeout * timeoutMult : 0;
const rpcTimeout = maxTimeout ? maxTimeout : 0;
const newDeadline = deadline ? deadline - now.getTime() : 0;
timeout = Math.min(timeoutCal, rpcTimeout, newDeadline);
}
retries++;
let retryArgument = this.argument;
// if resumption logic is passed, use it to determined the
// new argument for the new request made to the server
// otherwise, the original argument will be passed
if (retry.getResumptionRequestFn !== undefined) {
retryArgument = retry.getResumptionRequestFn(retryArgument);
}
const newRequest = () => {
if (this._isCancelCalled) {
if (this.stream) {
this.stream.cancel();
}
return;
}
const newStream = this.apiCall(retryArgument, this._callback);
return newStream;
};
opts.request = newRequest;
// make a request with the updated parameters
// based on the resumption strategy
return newMakeRequest(opts);
}, toSleep);
};
return calculateTimeoutAndResumptionFunction();
}
}
else {
// non retryable error
return transientErrorHelper(error, requestStream);
}
}
else {
// neither timeout nor maxRetries are defined, surface the error to the caller
return transientErrorHelper(error, requestStream);
}
});
// return the stream if we didn't return it as
// part of an error state
return retryStream;
};
// this is the first make request call with the options the user passed in
return newMakeRequest(opts);
}
}
exports.StreamProxy = StreamProxy;
//# sourceMappingURL=streaming.js.map

File diff suppressed because one or more lines are too long

View File

@@ -0,0 +1,35 @@
/**
* Copyright 2020 Google LLC
*
* 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 { APICaller } from '../apiCaller';
import { APICallback, CancellableStream, GRPCCall, SimpleCallbackFunction } from '../apitypes';
import { StreamDescriptor } from './streamDescriptor';
import { StreamProxy } from './streaming';
import { CallSettings } from '../gax';
export declare class StreamingApiCaller implements APICaller {
descriptor: StreamDescriptor;
/**
* An API caller for methods of gRPC streaming.
* @private
* @constructor
* @param {StreamDescriptor} descriptor - the descriptor of the method structure.
*/
constructor(descriptor: StreamDescriptor);
init(callback: APICallback): StreamProxy;
wrap(func: GRPCCall): GRPCCall;
call(apiCall: SimpleCallbackFunction, argument: {}, settings: CallSettings, stream: StreamProxy): void;
fail(stream: CancellableStream, err: Error): void;
result(stream: CancellableStream): CancellableStream;
}

View File

@@ -0,0 +1,64 @@
"use strict";
/**
* Copyright 2020 Google LLC
*
* 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.StreamingApiCaller = void 0;
const warnings_1 = require("../warnings");
const streaming_1 = require("./streaming");
class StreamingApiCaller {
/**
* An API caller for methods of gRPC streaming.
* @private
* @constructor
* @param {StreamDescriptor} descriptor - the descriptor of the method structure.
*/
constructor(descriptor) {
this.descriptor = descriptor;
}
init(callback) {
return new streaming_1.StreamProxy(this.descriptor.type, callback, this.descriptor.rest, this.descriptor.gaxStreamingRetries);
}
wrap(func) {
switch (this.descriptor.type) {
case streaming_1.StreamType.SERVER_STREAMING:
return (argument, metadata, options) => {
return func(argument, metadata, options);
};
case streaming_1.StreamType.CLIENT_STREAMING:
return (argument, metadata, options, callback) => {
return func(metadata, options, callback);
};
case streaming_1.StreamType.BIDI_STREAMING:
return (argument, metadata, options) => {
return func(metadata, options);
};
default:
(0, warnings_1.warn)('streaming_wrap_unknown_stream_type', `Unknown stream type: ${this.descriptor.type}`);
}
return func;
}
call(apiCall, argument, settings, stream) {
stream.setStream(apiCall, argument, settings.retryRequestOptions, settings.retry);
}
fail(stream, err) {
stream.emit('error', err);
}
result(stream) {
return stream;
}
}
exports.StreamingApiCaller = StreamingApiCaller;
//# sourceMappingURL=streamingApiCaller.js.map

View File

@@ -0,0 +1 @@
{"version":3,"file":"streamingApiCaller.js","sourceRoot":"","sources":["../../../src/streamingCalls/streamingApiCaller.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAYH,0CAAiC;AAGjC,2CAAoD;AAGpD,MAAa,kBAAkB;IAG7B;;;;;OAKG;IACH,YAAY,UAA4B;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,QAAqB;QACxB,OAAO,IAAI,uBAAW,CACpB,IAAI,CAAC,UAAU,CAAC,IAAI,EACpB,QAAQ,EACR,IAAI,CAAC,UAAU,CAAC,IAAI,EACpB,IAAI,CAAC,UAAU,CAAC,mBAAmB,CACpC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAc;QACjB,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAC7B,KAAK,sBAAU,CAAC,gBAAgB;gBAC9B,OAAO,CAAC,QAAY,EAAE,QAAY,EAAE,OAAW,EAAE,EAAE;oBACjD,OAAQ,IAA4B,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACpE,CAAC,CAAC;YACJ,KAAK,sBAAU,CAAC,gBAAgB;gBAC9B,OAAO,CACL,QAAY,EACZ,QAAY,EACZ,OAAW,EACX,QAAsB,EACtB,EAAE;oBACF,OAAQ,IAA4B,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACpE,CAAC,CAAC;YACJ,KAAK,sBAAU,CAAC,cAAc;gBAC5B,OAAO,CAAC,QAAY,EAAE,QAAY,EAAE,OAAW,EAAE,EAAE;oBACjD,OAAQ,IAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACxD,CAAC,CAAC;YACJ;gBACE,IAAA,eAAI,EACF,oCAAoC,EACpC,wBAAwB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAC/C,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CACF,OAA+B,EAC/B,QAAY,EACZ,QAAsB,EACtB,MAAmB;QAEnB,MAAM,CAAC,SAAS,CACd,OAAO,EACP,QAAQ,EACR,QAAQ,CAAC,mBAAmB,EAC5B,QAAQ,CAAC,KAAM,CAChB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAyB,EAAE,GAAU;QACxC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,MAAyB;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAvED,gDAuEC"}