@vuu-ui/vuu-data-types 0.8.21 → 0.8.22-debug

package/index.d.ts

@@ -0,0 +1,748 @@
+import type { Filter } from "@vuu-ui/vuu-filter-types";
+import type { MenuActionClosePopup } from "@vuu-ui/vuu-popups";
+import type {
+  ClientToServerEditRpc,
+  ClientToServerMenuRPC,
+  ClientToServerViewportRpcCall,
+  VuuAggregation,
+  VuuColumnDataType,
+  VuuColumns,
+  VuuDataRowDto,
+  VuuFilter,
+  VuuGroupBy,
+  VuuLinkDescriptor,
+  VuuMenu,
+  VuuRowDataItemType,
+  VuuSort,
+  VuuTable,
+} from "@vuu-ui/vuu-protocol-types";
+import type { IEventEmitter } from "@vuu-ui/vuu-utils";
+import type {
+  DataSourceFilter,
+  MenuRpcResponse,
+  Selection,
+  TableSchema,
+} from "@vuu-ui/vuu-data-types";
+import type {
+  ClientToServerTableList,
+  ClientToServerTableMeta,
+  LinkDescriptorWithLabel,
+  ServerToClientViewportRpcResponse,
+  TypeAheadMethod,
+  VuuRange,
+} from "@vuu-ui/vuu-protocol-types";
+
+export interface DataSourceFilter extends VuuFilter {
+  filterStruct?: Filter;
+}
+
+export interface NamedDataSourceFilter extends DataSourceFilter {
+  id?: string;
+  name?: string;
+}
+
+type RowIndex = number;
+type RenderKey = number;
+type IsLeaf = boolean;
+type IsExpanded = boolean;
+type Depth = number;
+type ChildCount = number;
+type RowKey = string;
+export type IsSelected = number;
+
+export type DataSourceRow = [
+  RowIndex,
+  RenderKey,
+  IsLeaf,
+  IsExpanded,
+  Depth,
+  ChildCount,
+  RowKey,
+  IsSelected,
+  ...VuuRowDataItemType[]
+];
+
+export type DataSourceRowPredicate = (row: DataSourceRow) => boolean;
+
+export interface ContextMenuItemBase {
+  className?: string;
+  icon?: string;
+  label: string;
+  location?: string;
+}
+
+export interface ContextMenuLeafItemDescriptor extends ContextMenuItemBase {
+  action: string;
+  options?: unknown;
+}
+
+export type ContextMenuItemDescriptor =
+  | ContextMenuLeafItemDescriptor
+  | ContextMenuGroupItemDescriptor;
+
+export interface ContextMenuGroupItemDescriptor extends ContextMenuItemBase {
+  children: ContextMenuItemDescriptor[];
+}
+
+export interface MessageWithClientViewportId {
+  clientViewportId: string;
+}
+
+export interface DataSourceAggregateMessage
+  extends MessageWithClientViewportId {
+  aggregations: VuuAggregation[];
+  type: "aggregate";
+}
+
+export type DataUpdateMode = "batch" | "update" | "size-only";
+
+export interface DataSourceDataMessage extends MessageWithClientViewportId {
+  mode: DataUpdateMode;
+  rows?: DataSourceRow[];
+  size?: number;
+  type: "viewport-update";
+}
+
+export interface DataSourceDataSizeMessage extends MessageWithClientViewportId {
+  mode: "size-only";
+  size: number;
+  type: "viewport-update";
+}
+
+export interface DataSourceDisabledMessage extends MessageWithClientViewportId {
+  type: "disabled";
+}
+
+export interface DataSourceEnabledMessage extends MessageWithClientViewportId {
+  type: "enabled";
+}
+
+export interface DataSourceColumnsMessage extends MessageWithClientViewportId {
+  type: "columns";
+  columns: VuuColumns;
+}
+export interface DataSourceFilterMessage extends MessageWithClientViewportId {
+  type: "filter";
+  filter: DataSourceFilter;
+}
+export interface DataSourceGroupByMessage extends MessageWithClientViewportId {
+  type: "groupBy";
+  groupBy: VuuGroupBy | undefined;
+}
+
+export interface DataSourceSetConfigMessage
+  extends MessageWithClientViewportId {
+  type: "config";
+  config: WithFullConfig;
+}
+
+export interface DataSourceDebounceRequest extends MessageWithClientViewportId {
+  type: "debounce-begin";
+}
+
+export interface DataSourceMenusMessage extends MessageWithClientViewportId {
+  type: "vuu-menu";
+  menu: VuuMenu;
+}
+
+export interface DataSourceSortMessage extends MessageWithClientViewportId {
+  type: "sort";
+  sort: VuuSort;
+}
+
+export interface DataSourceSubscribedMessage
+  extends MessageWithClientViewportId {
+  aggregations: VuuAggregation[];
+  columns: VuuColumns;
+  filter: DataSourceFilter;
+  groupBy: VuuGroupBy;
+  range: VuuRange;
+  sort: VuuSort;
+  tableSchema: Readonly<TableSchema>;
+  type: "subscribed";
+}
+
+export interface DataSourceVisualLinkCreatedMessage
+  extends MessageWithClientViewportId {
+  colName: string;
+  parentViewportId: string;
+  parentColName: string;
+  type: "vuu-link-created";
+}
+
+export interface DataSourceVisualLinkRemovedMessage
+  extends MessageWithClientViewportId {
+  type: "vuu-link-removed";
+}
+
+export interface DataSourceVisualLinksMessage
+  extends MessageWithClientViewportId {
+  type: "vuu-links";
+  links: VuuLinkDescriptor[];
+}
+
+export type VuuFeatureInvocationMessage =
+  | DataSourceVisualLinkCreatedMessage
+  | DataSourceVisualLinkRemovedMessage;
+
+export type VuuFeatureMessage =
+  | DataSourceMenusMessage
+  | DataSourceVisualLinksMessage;
+
+export type DataSourceConfigMessage =
+  | DataSourceAggregateMessage
+  | DataSourceColumnsMessage
+  | DataSourceFilterMessage
+  | DataSourceGroupByMessage
+  | DataSourceSortMessage
+  | DataSourceSetConfigMessage;
+
+export type DataSourceCallbackMessage =
+  | DataSourceConfigMessage
+  | DataSourceColumnsMessage
+  | DataSourceDataMessage
+  | DataSourceDebounceRequest
+  | DataSourceDisabledMessage
+  | DataSourceEnabledMessage
+  | DataSourceMenusMessage
+  | DataSourceSubscribedMessage
+  | DataSourceVisualLinkCreatedMessage
+  | DataSourceVisualLinkRemovedMessage
+  | DataSourceVisualLinksMessage;
+
+export type ConfigChangeColumnsMessage = {
+  type: "columns";
+  columns?: ColumnDescriptor[];
+};
+
+export type ConfigChangeMessage =
+  | ConfigChangeColumnsMessage
+  | DataSourceAggregateMessage
+  | DataSourceFilterMessage
+  | DataSourceGroupByMessage
+  | DataSourceSortMessage
+  | DataSourceVisualLinkCreatedMessage
+  | DataSourceVisualLinkRemovedMessage;
+
+export type ConfigChangeHandler = (msg: ConfigChangeMessage) => void;
+
+/**
+ * MenuBuilder describes a factory function that creates
+ * Menu Item Descriptors appropriate to the supplied
+ * location. Location can be any string identifier, it
+ * can be used to determine which Menu Items to include
+ * in the menu. Most often used for ContextMenus.
+ */
+export type MenuBuilder<L = string, O = unknown> = (
+  location: L,
+  options: O
+) => ContextMenuItemDescriptor[];
+
+/**
+ * MenuActionHandler describes a function that provides an implementation of
+ * one or more MenuItem actions. It will receive the type from the MenuItem
+ * clicked, plus any options object associated with that MenuItem.
+ *
+ * It should return true if it handled this MenuItem. This allows multiple Menu-
+ * ActionHandlers to be chained.
+ */
+export type MenuActionHandler = (
+  reason: MenuActionClosePopup
+) => boolean | undefined;
+
+export interface ContextMenuContextType {
+  menuBuilders: MenuBuilder[];
+  menuActionHandler: MenuActionHandler;
+}
+
+export type SchemaColumn = {
+  name: string;
+  serverDataType: VuuColumnDataType;
+};
+
+export type TableSchema = {
+  columns: SchemaColumn[];
+  key: string;
+  table: VuuTable;
+};
+
+/**
+ * Described the configuration values that should typically be
+ * persisted across sessions.
+ */
+export interface WithFullConfig {
+  readonly aggregations: VuuAggregation[];
+  readonly columns: string[];
+  readonly filter: DataSourceFilter;
+  readonly groupBy: VuuGroupBy;
+  readonly sort: VuuSort;
+  readonly visualLink?: LinkDescriptorWithLabel;
+}
+
+export interface DataSourceConfig extends Partial<WithFullConfig> {
+  visualLink?: LinkDescriptorWithLabel;
+}
+
+export interface WithGroupBy extends DataSourceConfig {
+  groupBy: VuuGroupBy;
+}
+export interface WithFilter extends DataSourceConfig {
+  filter: DataSourceFilter;
+}
+export interface WithSort extends DataSourceConfig {
+  sort: VuuSort;
+}
+
+export interface DataSourceConstructorProps extends DataSourceConfig {
+  bufferSize?: number;
+  table: VuuTable;
+  title?: string;
+  viewport?: string;
+}
+
+export interface SubscribeProps {
+  viewport?: string;
+  columns?: string[];
+  aggregations?: VuuAggregation[];
+  range?: VuuRange;
+  sort?: VuuSort;
+  groupBy?: VuuGroupBy;
+  filter?: DataSourceFilter;
+  title?: string;
+}
+
+export type SubscribeCallback = (message: DataSourceCallbackMessage) => void;
+export type OptimizeStrategy = "none" | "throttle" | "debounce";
+
+export type DataSourceEvents = {
+  config: (config: DataSourceConfig | undefined, confirmed?: boolean) => void;
+  optimize: (optimize: OptimizeStrategy) => void;
+  range: (range: VuuRange) => void;
+  resize: (size: number) => void;
+};
+
+/**
+ * return Promise<true> indicates success
+ * return Promise<errorMessage> indicates failure
+ */
+export type DataSourceEditHandler = (
+  row: DataSourceRow,
+  columnName: string,
+  value: VuuRowDataItemType
+) => Promise<true | string>;
+
+export type DataSourceDeleteHandler = (key: string) => Promise<true | string>;
+export type DataSourceInsertHandler = (
+  key: string,
+  data: VuuDataRowDto
+) => Promise<true | string>;
+
+export type RpcResponse =
+  | MenuRpcResponse
+  | VuuUIMessageInRPCEditReject
+  | VuuUIMessageInRPCEditResponse
+  | ViewportRpcResponse;
+
+export type RpcResponseHandler = (response: RpcResponse) => boolean;
+
+export type RowSearchPredicate = (row: DataSourceRow) => boolean;
+
+export type DataSourceStatus =
+  | "disabled"
+  | "disabling"
+  | "enabled"
+  | "enabling"
+  | "initialising"
+  | "subscribing"
+  | "subscribed"
+  | "suspended"
+  | "unsubscribed";
+
+export interface TypeaheadSuggestionProvider {
+  getTypeaheadSuggestions: (
+    columnName: string,
+    pattern?: string
+  ) => Promise<string[]>;
+}
+
+export type RangeTuple = [from: number, to: number];
+export type SelectionItem = number | RangeTuple;
+export type Selection = SelectionItem[];
+export type SelectionChangeHandler = (selection: Selection) => void;
+
+export interface DataSource
+  extends IEventEmitter<DataSourceEvents>,
+    Partial<TypeaheadSuggestionProvider> {
+  aggregations: VuuAggregation[];
+  applyEdit: DataSourceEditHandler;
+  /**
+   * set config without triggering config event. Use this method when initialising
+   * a dataSource that has been restored from session state. The dataSource will
+   * not yet be subscribed. Triggering the config event is unnecessary and might
+   * cause a React exception if the event were to cause a render.
+   * @param config DataSourceConfig
+   * @returns true if config has been applied (will not be if existig config is same)
+   */
+  applyConfig: (config: DataSourceConfig) => true | undefined;
+  closeTreeNode: (key: string, cascade?: boolean) => void;
+  columns: string[];
+  config: DataSourceConfig;
+  status: DataSourceStatus;
+  /**
+   *
+   * Similar to disable but intended for pauses of very short duration (default is 3 seconds). Although
+   * the dataSource will stop sending messages until resumed, it will not disconnect from a  remote server.
+   * It will preserve subscription to the remote server and continue to apply updates to cached data. It
+   * just won't send updates through to the UI thread (until resumed). Useful in edge cases such as where a
+   * component is dragged to a new location. When dropped, the component will be unmounted and very quickly
+   * remounted by React. For the duration of this operation, we suspend updates . Updating an unmounted
+   * React component would cause a React error.
+   * If an suspend is requested and not resumed within 3 seconds, it will automatically be promoted to a disable.,
+   */
+  suspend?: () => void;
+  resume?: () => void;
+
+  deleteRow?: DataSourceDeleteHandler;
+
+  /**
+   * For a dataSource that has been previously disabled and is currently in disabled state , this will restore
+   * the subscription to active status. Fresh data will be dispatched to client. The enable call optionally
+   * accepts the same subscribe callback as subscribe. This allows a completely new instance of a component to
+   * assume ownership of a subscription and receive all messages.
+   */
+  enable?: (callback?: SubscribeCallback) => void;
+  /**
+   * Disables this subscription. A datasource will send no further messages until re-enabled. Example usage
+   * might be for a component displayed within a set of Tabs. If user switches to another tab, the dataSource
+   * of the component that is no longer visible can be disabled until it is made visible again.
+   */
+  disable?: () => void;
+  filter: DataSourceFilter;
+
+  /**
+   * Only implemented on JSON DataSource
+   * @param depth
+   * @param visibleOnly
+   * @returns
+   */
+  getChildRows?: (rowKey: string) => DataSourceRow[];
+  /**
+   * Only implemented on JSON DataSource
+   * @param depth
+   * @param visibleOnly
+   * @returns
+   */
+  getRowsAtDepth?: (depth: number, visibleOnly?: boolean) => DataSourceRow[];
+  groupBy: VuuGroupBy;
+  insertRow?: DataSourceInsertHandler;
+  links?: LinkDescriptorWithLabel[];
+  menu?: VuuMenu;
+  menuRpcCall: (
+    rpcRequest: Omit<ClientToServerMenuRPC, "vpId"> | ClientToServerEditRpc
+  ) => Promise<RpcResponse | undefined>;
+  rpcCall?: <T extends RpcResponse = RpcResponse>(
+    message: Omit<ClientToServerViewportRpcCall, "vpId">
+  ) => Promise<T | undefined>;
+  openTreeNode: (key: string) => void;
+  range: VuuRange;
+  select: SelectionChangeHandler;
+  readonly selectedRowsCount: number;
+  readonly size: number;
+  sort: VuuSort;
+  subscribe: (
+    props: SubscribeProps,
+    callback: SubscribeCallback
+  ) => Promise<void>;
+  table?: VuuTable;
+  readonly tableSchema?: TableSchema;
+  title?: string;
+  unsubscribe: () => void;
+  viewport?: string;
+  visualLink?: LinkDescriptorWithLabel;
+}
+
+export interface MenuRpcResponse {
+  action: MenuRpcAction;
+  error?: string;
+  requestId: string;
+  rpcName?: string;
+  tableAlreadyOpen?: boolean;
+  type: "VIEW_PORT_MENU_RESP";
+}
+
+export interface OpenDialogAction {
+  type: "OPEN_DIALOG_ACTION";
+  tableSchema?: TableSchema;
+  table?: VuuTable;
+}
+export interface NoAction {
+  type: "NO_ACTION";
+}
+
+export declare type MenuRpcAction = OpenDialogAction | NoAction;
+
+export type ConnectionStatus =
+  | "connecting"
+  | "connection-open-awaiting-session"
+  | "connected"
+  | "disconnected"
+  | "reconnected";
+
+export interface ConnectionStatusMessage {
+  type: "connection-status";
+  reason?: string;
+  retry?: boolean;
+  status: ConnectionStatus;
+}
+
+export interface ConnectionQualityMetrics {
+  type: "connection-metrics";
+  messagesLength: number;
+}
+
+export interface ServerProxySubscribeMessage {
+  aggregations: VuuAggregation[];
+  bufferSize?: number;
+  columns: VuuColumns;
+  filter: DataSourceFilter;
+  groupBy: VuuGroupBy;
+  range: VuuRange;
+  sort: VuuSort;
+  table: VuuTable;
+  title?: string;
+  viewport: string;
+  visualLink?: LinkDescriptorWithLabel;
+}
+
+// export type VuuUIMessageInConnectionStatus = {
+//   type: 'connection-status';
+// };
+
+export type VuuUIMessageInConnected = {
+  type: "connected";
+};
+
+export type VuuUIMessageInWorkerReady = {
+  type: "ready";
+};
+
+export interface ViewportMessageIn {
+  clientViewportId: string;
+}
+
+// TODO use generic to type result
+export interface VuuUIMessageInRPC {
+  method: string;
+  result: unknown;
+  requestId: string;
+  type: "RPC_RESP";
+}
+
+export interface VuuUIMessageInRPCEditReject {
+  error: string;
+  requestId?: string;
+  type: "VP_EDIT_RPC_REJECT";
+}
+
+export interface VuuUIMessageInRPCEditResponse {
+  action: unknown;
+  requestId: string;
+  rpcName: string;
+  type: "VP_EDIT_RPC_RESPONSE";
+}
+
+export interface VuuUIMessageInTableList {
+  requestId: string;
+  type: "TABLE_LIST_RESP";
+  tables: VuuTable[];
+}
+export interface VuuUIMessageInTableMeta {
+  requestId: string;
+  tableSchema: TableSchema;
+  type: "TABLE_META_RESP";
+}
+export interface ViewportRpcResponse {
+  action: ServerToClientViewportRpcResponse["action"];
+  requestId: string;
+  rpcName?: string;
+  type: "VIEW_PORT_RPC_RESPONSE";
+}
+export interface MenuRpcReject extends ViewportMessageIn {
+  error?: string;
+  requestId: string;
+  rpcName?: string;
+  type: "VIEW_PORT_MENU_REJ";
+}
+
+export interface VuuUIMessageInMenuRej {
+  error: string;
+  requestId: string;
+  rpcName: string;
+  type: "VIEW_PORT_MENU_REJ";
+}
+
+export type VuuUIMessageIn =
+  | VuuUIMessageInConnected
+  | VuuUIMessageInWorkerReady
+  | VuuUIMessageInRPC
+  | ViewportRpcResponse
+  | MenuRpcResponse
+  | MenuRpcReject
+  | VuuUIMessageInTableList
+  | VuuUIMessageInTableMeta
+  | VuuUIMessageInRPCEditReject
+  | VuuUIMessageInRPCEditResponse;
+
+export type WebSocketProtocol = string | string[] | undefined;
+
+export interface VuuUIMessageOutConnect {
+  protocol: WebSocketProtocol;
+  type: "connect";
+  token: string;
+  url: string;
+  username?: string;
+  retryLimitDisconnect?: number;
+  retryLimitStartup?: number;
+}
+
+export interface VuuUIMessageOutSubscribe extends ServerProxySubscribeMessage {
+  type: "subscribe";
+}
+
+export interface VuuUIMessageOutUnsubscribe {
+  type: "unsubscribe";
+  viewport: string;
+}
+export interface VuuUIMessageOutSuspend {
+  type: "suspend";
+  viewport: string;
+}
+export interface VuuUIMessageOutResume {
+  type: "resume";
+  viewport: string;
+}
+
+export interface ViewportMessageOut {
+  viewport: string;
+}
+
+export interface RequestMessage {
+  requestId: string;
+}
+
+export interface VuuUIMessageOutColumns extends ViewportMessageOut {
+  type: "setColumns";
+  columns: string[];
+}
+export interface VuuUIMessageOutViewRange extends ViewportMessageOut {
+  type: "setViewRange";
+  range: {
+    from: number;
+    to: number;
+  };
+}
+export interface VuuUIMessageOutAggregate extends ViewportMessageOut {
+  aggregations: VuuAggregation[];
+  type: "aggregate";
+}
+export interface VuuUIMessageOutCloseTreeNode extends ViewportMessageOut {
+  key: string;
+  type: "closeTreeNode";
+}
+export interface VuuUIMessageOutCreateLink extends ViewportMessageOut {
+  childColumnName: string;
+  parentColumnName: string;
+  parentClientVpId: string;
+  type: "createLink";
+}
+export interface VuuUIMessageOutRemoveLink extends ViewportMessageOut {
+  type: "removeLink";
+}
+export interface VuuUIMessageOutSetTitle extends ViewportMessageOut {
+  title: string;
+  type: "setTitle";
+}
+
+export interface VuuUIMessageOutDisable extends ViewportMessageOut {
+  type: "disable";
+}
+export interface VuuUIMessageOutEnable extends ViewportMessageOut {
+  type: "enable";
+}
+export interface VuuUIMessageOutOpenTreeNode extends ViewportMessageOut {
+  key: string;
+  type: "openTreeNode";
+}
+export interface VuuUIMessageOutResume extends ViewportMessageOut {
+  type: "resume";
+}
+
+export interface VuuUIMessageOutSelect extends ViewportMessageOut {
+  selected: Selection;
+  type: "select";
+}
+export interface VuuUIMessageOutSelectAll extends ViewportMessageOut {
+  type: "selectAll";
+}
+export interface VuuUIMessageOutSelectNone extends ViewportMessageOut {
+  type: "selectNone";
+}
+
+export interface VuuUIMessageOutSort extends ViewportMessageOut {
+  sort: VuuSort;
+  type: "sort";
+}
+export interface VuuUIMessageOutSuspend extends ViewportMessageOut {
+  type: "suspend";
+}
+
+export interface VuuUIMessageOutFilter extends ViewportMessageOut {
+  filter: DataSourceFilter;
+  type: "filter";
+}
+export interface VuuUIMessageOutGroupby extends ViewportMessageOut {
+  groupBy: VuuGroupBy;
+  type: "groupBy";
+}
+
+export interface VuuUIMessageOutConfig extends ViewportMessageOut {
+  config: WithFullConfig;
+  type: "config";
+}
+
+export type VuuUIMessageOutViewport =
+  | VuuUIMessageOutAggregate
+  | VuuUIMessageOutCloseTreeNode
+  | VuuUIMessageOutColumns
+  | VuuUIMessageOutConfig
+  | VuuUIMessageOutCreateLink
+  | VuuUIMessageOutFilter
+  | VuuUIMessageOutDisable
+  | VuuUIMessageOutEnable
+  | VuuUIMessageOutGroupby
+  | VuuUIMessageOutOpenTreeNode
+  | VuuUIMessageOutRemoveLink
+  | VuuUIMessageOutResume
+  | VuuUIMessageOutSelect
+  | VuuUIMessageOutSelectAll
+  | VuuUIMessageOutSelectNone
+  | VuuUIMessageOutSetTitle
+  | VuuUIMessageOutSuspend
+  | VuuUIMessageOutSort
+  | VuuUIMessageOutViewRange;
+
+export interface TypeAheadRpcRequest {
+  method: TypeAheadMethod;
+  params: [VuuTable, ...string[]];
+  type: "RPC_CALL";
+}
+
+export type WithRequestId<T> = T & { requestId: string };
+
+export type VuuUIMessageOut =
+  | VuuUIMessageOutConnect
+  | VuuUIMessageOutSubscribe
+  | VuuUIMessageOutUnsubscribe
+  | VuuUIMessageOutViewport
+  | WithRequestId<ClientToServerTableList>
+  | WithRequestId<ClientToServerTableMeta>;

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "@vuu-ui/vuu-data-types",
-  "version": "0.8.21",
+  "version": "0.8.22-debug",
   "author": "heswell",
   "license": "Apache-2.0",
   "devDependencies": {
-    "@vuu-ui/vuu-filter-types": "0.8.21",
-    "@vuu-ui/vuu-protocol-types": "0.8.21"
+    "@vuu-ui/vuu-filter-types": "0.8.22-debug",
+    "@vuu-ui/vuu-protocol-types": "0.8.22-debug"
   },
   "dependencies": {},
   "peerDependencies": {},
   "files": [
+    "index.d.ts",
     "index.d.ts"
   ],
   "types": "index.d.ts"

package/LICENSE

@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1.  Definitions.
-
-    "License" shall mean the terms and conditions for use, reproduction,
-    and distribution as defined by Sections 1 through 9 of this document.
-
-    "Licensor" shall mean the copyright owner or entity authorized by
-    the copyright owner that is granting the License.
-
-    "Legal Entity" shall mean the union of the acting entity and all
-    other entities that control, are controlled by, or are under common
-    control with that entity. For the purposes of this definition,
-    "control" means (i) the power, direct or indirect, to cause the
-    direction or management of such entity, whether by contract or
-    otherwise, or (ii) ownership of fifty percent (50%) or more of the
-    outstanding shares, or (iii) beneficial ownership of such entity.
-
-    "You" (or "Your") shall mean an individual or Legal Entity
-    exercising permissions granted by this License.
-
-    "Source" form shall mean the preferred form for making modifications,
-    including but not limited to software source code, documentation
-    source, and configuration files.
-
-    "Object" form shall mean any form resulting from mechanical
-    transformation or translation of a Source form, including but
-    not limited to compiled object code, generated documentation,
-    and conversions to other media types.
-
-    "Work" shall mean the work of authorship, whether in Source or
-    Object form, made available under the License, as indicated by a
-    copyright notice that is included in or attached to the work
-    (an example is provided in the Appendix below).
-
-    "Derivative Works" shall mean any work, whether in Source or Object
-    form, that is based on (or derived from) the Work and for which the
-    editorial revisions, annotations, elaborations, or other modifications
-    represent, as a whole, an original work of authorship. For the purposes
-    of this License, Derivative Works shall not include works that remain
-    separable from, or merely link (or bind by name) to the interfaces of,
-    the Work and Derivative Works thereof.
-
-    "Contribution" shall mean any work of authorship, including
-    the original version of the Work and any modifications or additions
-    to that Work or Derivative Works thereof, that is intentionally
-    submitted to Licensor for inclusion in the Work by the copyright owner
-    or by an individual or Legal Entity authorized to submit on behalf of
-    the copyright owner. For the purposes of this definition, "submitted"
-    means any form of electronic, verbal, or written communication sent
-    to the Licensor or its representatives, including but not limited to
-    communication on electronic mailing lists, source code control systems,
-    and issue tracking systems that are managed by, or on behalf of, the
-    Licensor for the purpose of discussing and improving the Work, but
-    excluding communication that is conspicuously marked or otherwise
-    designated in writing by the copyright owner as "Not a Contribution."
-
-    "Contributor" shall mean Licensor and any individual or Legal Entity
-    on behalf of whom a Contribution has been received by Licensor and
-    subsequently incorporated within the Work.
-
-2.  Grant of Copyright License. Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    copyright license to reproduce, prepare Derivative Works of,
-    publicly display, publicly perform, sublicense, and distribute the
-    Work and such Derivative Works in Source or Object form.
-
-3.  Grant of Patent License. Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    (except as stated in this section) patent license to make, have made,
-    use, offer to sell, sell, import, and otherwise transfer the Work,
-    where such license applies only to those patent claims licensable
-    by such Contributor that are necessarily infringed by their
-    Contribution(s) alone or by combination of their Contribution(s)
-    with the Work to which such Contribution(s) was submitted. If You
-    institute patent litigation against any entity (including a
-    cross-claim or counterclaim in a lawsuit) alleging that the Work
-    or a Contribution incorporated within the Work constitutes direct
-    or contributory patent infringement, then any patent licenses
-    granted to You under this License for that Work shall terminate
-    as of the date such litigation is filed.
-
-4.  Redistribution. You may reproduce and distribute copies of the
-    Work or Derivative Works thereof in any medium, with or without
-    modifications, and in Source or Object form, provided that You
-    meet the following conditions:
-
-    (a) You must give any other recipients of the Work or
-    Derivative Works a copy of this License; and
-
-    (b) You must cause any modified files to carry prominent notices
-    stating that You changed the files; and
-
-    (c) You must retain, in the Source form of any Derivative Works
-    that You distribute, all copyright, patent, trademark, and
-    attribution notices from the Source form of the Work,
-    excluding those notices that do not pertain to any part of
-    the Derivative Works; and
-
-    (d) If the Work includes a "NOTICE" text file as part of its
-    distribution, then any Derivative Works that You distribute must
-    include a readable copy of the attribution notices contained
-    within such NOTICE file, excluding those notices that do not
-    pertain to any part of the Derivative Works, in at least one
-    of the following places: within a NOTICE text file distributed
-    as part of the Derivative Works; within the Source form or
-    documentation, if provided along with the Derivative Works; or,
-    within a display generated by the Derivative Works, if and
-    wherever such third-party notices normally appear. The contents
-    of the NOTICE file are for informational purposes only and
-    do not modify the License. You may add Your own attribution
-    notices within Derivative Works that You distribute, alongside
-    or as an addendum to the NOTICE text from the Work, provided
-    that such additional attribution notices cannot be construed
-    as modifying the License.
-
-    You may add Your own copyright statement to Your modifications and
-    may provide additional or different license terms and conditions
-    for use, reproduction, or distribution of Your modifications, or
-    for any such Derivative Works as a whole, provided Your use,
-    reproduction, and distribution of the Work otherwise complies with
-    the conditions stated in this License.
-
-5.  Submission of Contributions. Unless You explicitly state otherwise,
-    any Contribution intentionally submitted for inclusion in the Work
-    by You to the Licensor shall be under the terms and conditions of
-    this License, without any additional terms or conditions.
-    Notwithstanding the above, nothing herein shall supersede or modify
-    the terms of any separate license agreement you may have executed
-    with Licensor regarding such Contributions.
-
-6.  Trademarks. This License does not grant permission to use the trade
-    names, trademarks, service marks, or product names of the Licensor,
-    except as required for reasonable and customary use in describing the
-    origin of the Work and reproducing the content of the NOTICE file.
-
-7.  Disclaimer of Warranty. Unless required by applicable law or
-    agreed to in writing, Licensor provides the Work (and each
-    Contributor provides its Contributions) on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied, including, without limitation, any warranties or conditions
-    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-    PARTICULAR PURPOSE. You are solely responsible for determining the
-    appropriateness of using or redistributing the Work and assume any
-    risks associated with Your exercise of permissions under this License.
-
-8.  Limitation of Liability. In no event and under no legal theory,
-    whether in tort (including negligence), contract, or otherwise,
-    unless required by applicable law (such as deliberate and grossly
-    negligent acts) or agreed to in writing, shall any Contributor be
-    liable to You for damages, including any direct, indirect, special,
-    incidental, or consequential damages of any character arising as a
-    result of this License or out of the use or inability to use the
-    Work (including but not limited to damages for loss of goodwill,
-    work stoppage, computer failure or malfunction, or any and all
-    other commercial damages or losses), even if such Contributor
-    has been advised of the possibility of such damages.
-
-9.  Accepting Warranty or Additional Liability. While redistributing
-    the Work or Derivative Works thereof, You may choose to offer,
-    and charge a fee for, acceptance of support, warranty, indemnity,
-    or other liability obligations and/or rights consistent with this
-    License. However, in accepting such obligations, You may act only
-    on Your own behalf and on Your sole responsibility, not on behalf
-    of any other Contributor, and only if You agree to indemnify,
-    defend, and hold each Contributor harmless for any liability
-    incurred by, or claims asserted against, such Contributor by reason
-    of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-Copyright 2015 UBS
-
-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.