@vertexvis/stream-api 0.12.0-canary.26 → 0.12.0-canary.27

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from './connection';
 export * from './encoder';
+export * from './errors';
 export { Settings, FrameDeliverySettings, AdaptiveRenderingSettings, QualityOfServiceSettings, } from './settings';
 export * from './streamApi';
 export * from './testing';

package/dist/streamApi.d.ts

@@ -7,17 +7,21 @@ import { Settings } from './settings';
 export declare type RequestMessageHandler = (msg: RequestMessage) => void;
 export declare type ResponseMessageHandler = (msg: ResponseMessage) => void;
 export declare type EventMessageHandler = (msg: EventMessage) => void;
+export declare type CloseEventHandler = (evt: CloseEvent) => void;
+export interface StreamApiOptions {
+    loggingEnabled?: boolean;
+}
 /**
  * The API client to interact with Vertex's streaming API.
  */
 export declare class StreamApi {
     private websocket;
-    private loggingEnabled;
     private onResponseDispatcher;
     private onRequestDispatcher;
     private onEventDispatcher;
     private messageSubscription?;
-    constructor(websocket?: WebSocketClient, loggingEnabled?: boolean);
+    private opts;
+    constructor(websocket?: WebSocketClient, opts?: StreamApiOptions);
     /**
      * Initiates a websocket connection to Vertex's streaming API. Returns a
      * promise that resolves once the connection is established and can begin
@@ -46,6 +50,12 @@ export declare class StreamApi {
      * @param handler - A handler function.
      */
     onEvent(handler: EventMessageHandler): Disposable;
+    /**
+     * Adds a callback that is invoked when the websocket connection is closed.
+     *
+     * @param handler A handler function.
+     */
+    onClose(handler: CloseEventHandler): Disposable;
     /**
      * Sends a request to initiate a streaming session.
      *
@@ -256,6 +266,14 @@ export declare class StreamApi {
      * Sends a request to get a stencil buffer image for the current scene view.
      */
     getStencilBuffer(payload: GetStencilBufferPayload, withResponse?: boolean): Promise<vertexvis.protobuf.stream.IStreamResponse>;
+    /**
+     * Sends a request to retrieve a new token. This token can be used to
+     * authenticate with other Vertex services.
+     *
+     * @param withResponse Indicates if the server should reply with a response.
+     * @returns A promise that completes with the refreshed token.
+     */
+    refreshToken(withResponse?: boolean): Promise<vertexvis.protobuf.stream.IStreamResponse>;
     /**
      * Acknowledges a successful request by sending a reply back to the server
      * with an optional result body.

package/dist/testing/fixtures/index.d.ts

@@ -1,3 +1,4 @@
-import * as Requests from './requests';
 import * as Events from './events';
-export { Requests, Events };
+import * as Requests from './requests';
+import * as Responses from './responses';
+export { Events, Requests, Responses };

package/dist/testing/fixtures/responses.d.ts

@@ -0,0 +1,20 @@
+import { vertexvis } from '@vertexvis/frame-streaming-protos';
+import { ResponseMessage } from '../../types';
+declare type Metadata = Partial<Pick<ResponseMessage, 'sentAtTime'>>;
+interface RequestId {
+    requestId?: string;
+}
+interface Result<T> {
+    result?: T;
+}
+declare type StartStreamResponse = RequestId & Result<vertexvis.protobuf.stream.IStartStreamResult>;
+declare type SyncTimeResponse = RequestId & Result<vertexvis.protobuf.stream.ISyncTimeResult>;
+declare type ReconnectResponse = RequestId & Result<vertexvis.protobuf.stream.IReconnectResult>;
+declare type LoadSceneViewStateResponse = RequestId & Result<vertexvis.protobuf.stream.ILoadSceneViewStateResult>;
+declare type RefreshTokenResponse = RequestId & Result<vertexvis.protobuf.stream.IRefreshTokenResult>;
+export declare function startStream(res?: StartStreamResponse, meta?: Metadata): ResponseMessage;
+export declare function syncTime(res?: SyncTimeResponse, meta?: Metadata): ResponseMessage;
+export declare function reconnect(res?: ReconnectResponse, meta?: Metadata): ResponseMessage;
+export declare function loadSceneViewState(res?: LoadSceneViewStateResponse, meta?: Metadata): ResponseMessage;
+export declare function refreshToken(res?: RefreshTokenResponse, meta?: Metadata): ResponseMessage;
+export {};

package/dist/testing/webSocketClientMock.d.ts

@@ -1,11 +1,13 @@
-import { WebSocketClient, WebSocketSendData, MessageHandler } from '../webSocketClient';
+import { WebSocketClient, WebSocketSendData, MessageHandler, CloseHandler } from '../webSocketClient';
 import { ConnectionDescriptor } from '../connection';
 import { Disposable } from '@vertexvis/utils';
 export declare class WebSocketClientMock implements WebSocketClient {
-    private handlers;
+    private closeHandlers;
+    private msgHandlers;
     private sentMessages;
     close(): void;
     connect(descriptor: ConnectionDescriptor): Promise<void>;
+    onClose(handler: CloseHandler): Disposable;
     onMessage(handler: MessageHandler): Disposable;
     send(data: WebSocketSendData): void;
     reconnect(descriptor: ConnectionDescriptor): Promise<void>;

package/dist/types.d.ts

@@ -35,6 +35,16 @@ export declare type LoadSceneViewStatePayload = DeepRequired<vertexvis.protobuf.
 export declare type GetStencilBufferPayload = DeepRequired<vertexvis.protobuf.stream.IGetStencilBufferPayload, [
 ]>;
 export declare type DrawFrameResult = DeepRequired<Pick<vertexvis.protobuf.stream.IStreamResponse, 'drawFrame'>, ['drawFrame', 'timing', 'receiveToPaintDuration'] | ['drawFrame', 'timing', 'sendToReceiveDuration']>;
+export declare type StartStreamResult = DeepRequired<vertexvis.protobuf.stream.IStartStreamResult, [
+]>;
+export declare type SyncTimeResult = DeepRequired<vertexvis.protobuf.stream.ISyncTimeResult, [
+]>;
+export declare type ReconnectResult = DeepRequired<vertexvis.protobuf.stream.IReconnectResult, [
+]>;
+export declare type LoadSceneViewStateResult = DeepRequired<vertexvis.protobuf.stream.ILoadSceneViewStateResult, [
+]>;
+export declare type RefreshTokenResult = DeepRequired<vertexvis.protobuf.stream.IRefreshTokenResult, [
+]>;
 export declare type ResponseResult = DrawFrameResult;
 export declare type ResponseError = vertexvis.protobuf.stream.IError;
 export declare type AnimationCompletedEvent = DeepRequired<Pick<vertexvis.protobuf.stream.IAnimationCompletedEvent, 'animationId'>, [

package/dist/webSocketClient.d.ts

@@ -7,6 +7,7 @@ export interface WebSocketClient {
     close(): void;
     connect(descriptor: ConnectionDescriptor): Promise<void>;
     onMessage(handler: MessageHandler): Disposable;
+    onClose(handler: CloseHandler): Disposable;
     send(data: WebSocketSendData): void;
 }
 export declare class WebSocketClientImpl implements WebSocketClient {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertexvis/stream-api",
-  "version": "0.12.0-canary.26",
+  "version": "0.12.0-canary.27",
   "description": "A websocket client for interacting with Vertex's stream API.",
   "license": "MIT",
   "author": "Vertex Developers <support@vertexvis.com> (https://developer.vertexvis.com)",
@@ -35,14 +35,14 @@
     "test:coverage": "yarn test --coverage"
   },
   "dependencies": {
-    "@vertexvis/frame-streaming-protos": "^0.6.9"
+    "@vertexvis/frame-streaming-protos": "^0.6.11"
   },
   "devDependencies": {
     "@types/jest": "^26.0.20",
     "@vertexvis/eslint-config-vertexvis-typescript": "^0.4.1",
     "@vertexvis/jest-config-vertexvis": "^0.5.3",
-    "@vertexvis/utils": "^0.12.0-canary.26",
-    "@vertexwebsdk/build": "^0.12.0-canary.26",
+    "@vertexvis/utils": "^0.12.0-canary.27",
+    "@vertexwebsdk/build": "^0.12.0-canary.27",
     "eslint": "^7.20.0",
     "jest": "^26.6.3",
     "protobufjs": "^6.9.0",
@@ -56,5 +56,5 @@
     "protobufjs": ">=6.9.0 <7.0.0",
     "tslib": ">=2.1.0"
   },
-  "gitHead": "2217074db751c909e0b80a57d09a6cdace554b73"
+  "gitHead": "cac831db58760f2dd304e0d09440886a88caba9e"
 }