@depup/firebase__database 1.1.1-depup.0

package/dist/src/core/snap/Node.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @license
+ * Copyright 2017 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 { Path } from '../util/Path';
+import { Index } from './indexes/Index';
+/**
+ * Node is an interface defining the common functionality for nodes in
+ * a DataSnapshot.
+ *
+ * @interface
+ */
+export interface Node {
+    /**
+     * Whether this node is a leaf node.
+     * @returns Whether this is a leaf node.
+     */
+    isLeafNode(): boolean;
+    /**
+     * Gets the priority of the node.
+     * @returns The priority of the node.
+     */
+    getPriority(): Node;
+    /**
+     * Returns a duplicate node with the new priority.
+     * @param newPriorityNode - New priority to set for the node.
+     * @returns Node with new priority.
+     */
+    updatePriority(newPriorityNode: Node): Node;
+    /**
+     * Returns the specified immediate child, or null if it doesn't exist.
+     * @param childName - The name of the child to retrieve.
+     * @returns The retrieved child, or an empty node.
+     */
+    getImmediateChild(childName: string): Node;
+    /**
+     * Returns a child by path, or null if it doesn't exist.
+     * @param path - The path of the child to retrieve.
+     * @returns The retrieved child or an empty node.
+     */
+    getChild(path: Path): Node;
+    /**
+     * Returns the name of the child immediately prior to the specified childNode, or null.
+     * @param childName - The name of the child to find the predecessor of.
+     * @param childNode - The node to find the predecessor of.
+     * @param index - The index to use to determine the predecessor
+     * @returns The name of the predecessor child, or null if childNode is the first child.
+     */
+    getPredecessorChildName(childName: string, childNode: Node, index: Index): string | null;
+    /**
+     * Returns a duplicate node, with the specified immediate child updated.
+     * Any value in the node will be removed.
+     * @param childName - The name of the child to update.
+     * @param newChildNode - The new child node
+     * @returns The updated node.
+     */
+    updateImmediateChild(childName: string, newChildNode: Node): Node;
+    /**
+     * Returns a duplicate node, with the specified child updated.  Any value will
+     * be removed.
+     * @param path - The path of the child to update.
+     * @param newChildNode - The new child node, which may be an empty node
+     * @returns The updated node.
+     */
+    updateChild(path: Path, newChildNode: Node): Node;
+    /**
+     * True if the immediate child specified exists
+     */
+    hasChild(childName: string): boolean;
+    /**
+     * @returns True if this node has no value or children.
+     */
+    isEmpty(): boolean;
+    /**
+     * @returns The number of children of this node.
+     */
+    numChildren(): number;
+    /**
+     * Calls action for each child.
+     * @param action - Action to be called for
+     * each child.  It's passed the child name and the child node.
+     * @returns The first truthy value return by action, or the last falsey one
+     */
+    forEachChild(index: Index, action: (a: string, b: Node) => void): unknown;
+    /**
+     * @param exportFormat - True for export format (also wire protocol format).
+     * @returns Value of this node as JSON.
+     */
+    val(exportFormat?: boolean): unknown;
+    /**
+     * @returns hash representing the node contents.
+     */
+    hash(): string;
+    /**
+     * @param other - Another node
+     * @returns -1 for less than, 0 for equal, 1 for greater than other
+     */
+    compareTo(other: Node): number;
+    /**
+     * @returns Whether or not this snapshot equals other
+     */
+    equals(other: Node): boolean;
+    /**
+     * @returns This node, with the specified index now available
+     */
+    withIndex(indexDefinition: Index): Node;
+    isIndexed(indexDefinition: Index): boolean;
+}
+export declare class NamedNode {
+    name: string;
+    node: Node;
+    constructor(name: string, node: Node);
+    static Wrap(name: string, node: Node): NamedNode;
+}

package/dist/src/core/snap/childSet.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2017 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 { SortedMap } from '../util/SortedMap';
+import { NamedNode } from './Node';
+/**
+ * Takes a list of child nodes and constructs a SortedSet using the given comparison
+ * function
+ *
+ * Uses the algorithm described in the paper linked here:
+ * http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.46.1458
+ *
+ * @param childList - Unsorted list of children
+ * @param cmp - The comparison method to be used
+ * @param keyFn - An optional function to extract K from a node wrapper, if K's
+ * type is not NamedNode
+ * @param mapSortFn - An optional override for comparator used by the generated sorted map
+ */
+export declare const buildChildSet: <K, V>(childList: NamedNode[], cmp: (a: NamedNode, b: NamedNode) => number, keyFn?: (a: NamedNode) => K, mapSortFn?: (a: K, b: K) => number) => SortedMap<K, V>;

package/dist/src/core/snap/comparators.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2017 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 { NamedNode } from './Node';
+export declare function NAME_ONLY_COMPARATOR(left: NamedNode, right: NamedNode): number;
+export declare function NAME_COMPARATOR(left: string, right: string): number;

package/dist/src/core/snap/indexes/Index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2017 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 { Comparator } from '../../util/SortedMap';
+import { Node, NamedNode } from '../Node';
+export declare abstract class Index {
+    abstract compare(a: NamedNode, b: NamedNode): number;
+    abstract isDefinedOn(node: Node): boolean;
+    /**
+     * @returns A standalone comparison function for
+     * this index
+     */
+    getCompare(): Comparator<NamedNode>;
+    /**
+     * Given a before and after value for a node, determine if the indexed value has changed. Even if they are different,
+     * it's possible that the changes are isolated to parts of the snapshot that are not indexed.
+     *
+     *
+     * @returns True if the portion of the snapshot being indexed changed between oldNode and newNode
+     */
+    indexedValueChanged(oldNode: Node, newNode: Node): boolean;
+    /**
+     * @returns a node wrapper that will sort equal to or less than
+     * any other node wrapper, using this index
+     */
+    minPost(): NamedNode;
+    /**
+     * @returns a node wrapper that will sort greater than or equal to
+     * any other node wrapper, using this index
+     */
+    abstract maxPost(): NamedNode;
+    abstract makePost(indexValue: unknown, name: string): NamedNode;
+    /**
+     * @returns String representation for inclusion in a query spec
+     */
+    abstract toString(): string;
+}

package/dist/src/core/snap/indexes/KeyIndex.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2017 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 { ChildrenNode } from '../ChildrenNode';
+import { Node, NamedNode } from '../Node';
+import { Index } from './Index';
+export declare class KeyIndex extends Index {
+    static get __EMPTY_NODE(): ChildrenNode;
+    static set __EMPTY_NODE(val: ChildrenNode);
+    compare(a: NamedNode, b: NamedNode): number;
+    isDefinedOn(node: Node): boolean;
+    indexedValueChanged(oldNode: Node, newNode: Node): boolean;
+    minPost(): any;
+    maxPost(): NamedNode;
+    makePost(indexValue: string, name: string): NamedNode;
+    /**
+     * @returns String representation for inclusion in a query spec
+     */
+    toString(): string;
+}
+export declare const KEY_INDEX: KeyIndex;

package/dist/src/core/snap/indexes/PathIndex.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2017 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 { Path } from '../../util/Path';
+import { NamedNode, Node } from '../Node';
+import { Index } from './Index';
+export declare class PathIndex extends Index {
+    private indexPath_;
+    constructor(indexPath_: Path);
+    protected extractChild(snap: Node): Node;
+    isDefinedOn(node: Node): boolean;
+    compare(a: NamedNode, b: NamedNode): number;
+    makePost(indexValue: object, name: string): NamedNode;
+    maxPost(): NamedNode;
+    toString(): string;
+}

package/dist/src/core/snap/indexes/PriorityIndex.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2017 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 { NamedNode, Node } from '../Node';
+import { Index } from './Index';
+export declare function setNodeFromJSON(val: (a: unknown) => Node): void;
+export declare function setMaxNode(val: Node): void;
+export declare class PriorityIndex extends Index {
+    compare(a: NamedNode, b: NamedNode): number;
+    isDefinedOn(node: Node): boolean;
+    indexedValueChanged(oldNode: Node, newNode: Node): boolean;
+    minPost(): NamedNode;
+    maxPost(): NamedNode;
+    makePost(indexValue: unknown, name: string): NamedNode;
+    /**
+     * @returns String representation for inclusion in a query spec
+     */
+    toString(): string;
+}
+export declare const PRIORITY_INDEX: PriorityIndex;

package/dist/src/core/snap/indexes/ValueIndex.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2017 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 { NamedNode, Node } from '../Node';
+import { Index } from './Index';
+export declare class ValueIndex extends Index {
+    compare(a: NamedNode, b: NamedNode): number;
+    isDefinedOn(node: Node): boolean;
+    indexedValueChanged(oldNode: Node, newNode: Node): boolean;
+    minPost(): NamedNode;
+    maxPost(): NamedNode;
+    makePost(indexValue: object, name: string): NamedNode;
+    /**
+     * @returns String representation for inclusion in a query spec
+     */
+    toString(): string;
+}
+export declare const VALUE_INDEX: ValueIndex;

package/dist/src/core/snap/nodeFromJSON.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2017 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 { Node } from './Node';
+/**
+ * Constructs a snapshot node representing the passed JSON and returns it.
+ * @param json - JSON to create a node for.
+ * @param priority - Optional priority to use.  This will be ignored if the
+ * passed JSON contains a .priority property.
+ */
+export declare function nodeFromJSON(json: unknown | null, priority?: unknown): Node;

package/dist/src/core/snap/snap.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2017 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 { Node } from './Node';
+export declare function setMaxNode(val: Node): void;
+export declare const priorityHashText: (priority: string | number) => string;
+/**
+ * Validates that a priority snapshot Node is valid.
+ */
+export declare const validatePriorityNode: (priorityNode: Node) => void;

package/dist/src/core/stats/StatsCollection.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2017 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.
+ */
+/**
+ * Tracks a collection of stats.
+ */
+export declare class StatsCollection {
+    private counters_;
+    incrementCounter(name: string, amount?: number): void;
+    get(): {
+        [k: string]: number;
+    };
+}

package/dist/src/core/stats/StatsListener.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2017 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 { StatsCollection } from './StatsCollection';
+/**
+ * Returns the delta from the previous call to get stats.
+ *
+ * @param collection_ - The collection to "listen" to.
+ */
+export declare class StatsListener {
+    private collection_;
+    private last_;
+    constructor(collection_: StatsCollection);
+    get(): {
+        [k: string]: number;
+    };
+}

package/dist/src/core/stats/StatsManager.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2017 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 { RepoInfo } from '../RepoInfo';
+import { StatsCollection } from './StatsCollection';
+export declare function statsManagerGetCollection(repoInfo: RepoInfo): StatsCollection;
+export declare function statsManagerGetOrCreateReporter<T>(repoInfo: RepoInfo, creatorFunction: () => T): T;

package/dist/src/core/stats/StatsReporter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2017 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 { ServerActions } from '../ServerActions';
+import { StatsCollection } from './StatsCollection';
+export declare class StatsReporter {
+    private server_;
+    private statsListener_;
+    statsToReport_: {
+        [k: string]: boolean;
+    };
+    constructor(collection: StatsCollection, server_: ServerActions);
+    private reportStats_;
+}
+export declare function statsReporterIncludeStat(reporter: StatsReporter, stat: string): void;

package/dist/src/core/storage/DOMStorageWrapper.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2017 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.
+ */
+/**
+ * Wraps a DOM Storage object and:
+ * - automatically encode objects as JSON strings before storing them to allow us to store arbitrary types.
+ * - prefixes names with "firebase:" to avoid collisions with app data.
+ *
+ * We automatically (see storage.js) create two such wrappers, one for sessionStorage,
+ * and one for localStorage.
+ *
+ */
+export declare class DOMStorageWrapper {
+    private domStorage_;
+    private prefix_;
+    /**
+     * @param domStorage_ - The underlying storage object (e.g. localStorage or sessionStorage)
+     */
+    constructor(domStorage_: Storage);
+    /**
+     * @param key - The key to save the value under
+     * @param value - The value being stored, or null to remove the key.
+     */
+    set(key: string, value: unknown | null): void;
+    /**
+     * @returns The value that was stored under this key, or null
+     */
+    get(key: string): unknown;
+    remove(key: string): void;
+    isInMemoryStorage: boolean;
+    prefixedName_(name: string): string;
+    toString(): string;
+}

package/dist/src/core/storage/MemoryStorage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2017 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.
+ */
+/**
+ * An in-memory storage implementation that matches the API of DOMStorageWrapper
+ * (TODO: create interface for both to implement).
+ */
+export declare class MemoryStorage {
+    private cache_;
+    set(key: string, value: unknown | null): void;
+    get(key: string): unknown;
+    remove(key: string): void;
+    isInMemoryStorage: boolean;
+}

package/dist/src/core/storage/storage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2017 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 { DOMStorageWrapper } from './DOMStorageWrapper';
+import { MemoryStorage } from './MemoryStorage';
+/** A storage object that lasts across sessions */
+export declare const PersistentStorage: DOMStorageWrapper | MemoryStorage;
+/** A storage object that only lasts one session */
+export declare const SessionStorage: DOMStorageWrapper | MemoryStorage;

package/dist/src/core/util/EventEmitter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2017 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.
+ */
+/**
+ * Base class to be used if you want to emit events. Call the constructor with
+ * the set of allowed event names.
+ */
+export declare abstract class EventEmitter {
+    private allowedEvents_;
+    private listeners_;
+    constructor(allowedEvents_: string[]);
+    /**
+     * To be overridden by derived classes in order to fire an initial event when
+     * somebody subscribes for data.
+     *
+     * @returns {Array.<*>} Array of parameters to trigger initial event with.
+     */
+    abstract getInitialEvent(eventType: string): unknown[];
+    /**
+     * To be called by derived classes to trigger events.
+     */
+    protected trigger(eventType: string, ...varArgs: unknown[]): void;
+    on(eventType: string, callback: (a: unknown) => void, context: unknown): void;
+    off(eventType: string, callback: (a: unknown) => void, context: unknown): void;
+    private validateEventType_;
+}