@firebase/database 0.8.3-canary.fb90580e5 → 0.8.3

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

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

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

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

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

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

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

@@ -1,25 +0,0 @@
-/**
- * @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 {?string|?number=} priority Optional priority to use.  This will be ignored if the
- * passed JSON contains a .priority property.
- * @return {!Node}
- */
-export declare function nodeFromJSON(json: unknown | null, priority?: unknown): Node;

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

@@ -1,29 +0,0 @@
-/**
- * @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;
-/**
- * @param {(!string|!number)} priority
- * @return {!string}
- */
-export declare const priorityHashText: (priority: string | number) => string;
-/**
- * Validates that a priority snapshot Node is valid.
- *
- * @param {!Node} priorityNode
- */
-export declare const validatePriorityNode: (priorityNode: Node) => void;

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

@@ -1,28 +0,0 @@
-/**
- * @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.
- *
- * @constructor
- */
-export declare class StatsCollection {
-    private counters_;
-    incrementCounter(name: string, amount?: number): void;
-    get(): {
-        [k: string]: number;
-    };
-}

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

@@ -1,31 +0,0 @@
-/**
- * @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.
- * @constructor
- */
-export declare class StatsListener {
-    private collection_;
-    private last_;
-    constructor(collection_: StatsCollection);
-    get(): {
-        [k: string]: number;
-    };
-}

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

@@ -1,24 +0,0 @@
-/**
- * @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';
-import { RepoInfo } from '../RepoInfo';
-export declare class StatsManager {
-    private static collections_;
-    private static reporters_;
-    static getCollection(repoInfo: RepoInfo): StatsCollection;
-    static getOrCreateReporter<T>(repoInfo: RepoInfo, creatorFunction: () => T): T;
-}

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

@@ -1,33 +0,0 @@
-/**
- * @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';
-import { ServerActions } from '../ServerActions';
-/**
- * @constructor
- */
-export declare class StatsReporter {
-    private server_;
-    private statsListener_;
-    private statsToReport_;
-    /**
-     * @param collection
-     * @param server_
-     */
-    constructor(collection: StatsCollection, server_: ServerActions);
-    includeStat(stat: string): void;
-    private reportStats_;
-}

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

@@ -1,55 +0,0 @@
-/**
- * @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.
- *
- * @constructor
- */
-export declare class DOMStorageWrapper {
-    private domStorage_;
-    private prefix_;
-    /**
-     * @param {Storage} domStorage_ The underlying storage object (e.g. localStorage or sessionStorage)
-     */
-    constructor(domStorage_: Storage);
-    /**
-     * @param {string} key The key to save the value under
-     * @param {?Object} value The value being stored, or null to remove the key.
-     */
-    set(key: string, value: unknown | null): void;
-    /**
-     * @param {string} key
-     * @return {*} The value that was stored under this key, or null
-     */
-    get(key: string): unknown;
-    /**
-     * @param {string} key
-     */
-    remove(key: string): void;
-    isInMemoryStorage: boolean;
-    /**
-     * @param {string} name
-     * @return {string}
-     */
-    prefixedName_(name: string): string;
-    toString(): string;
-}

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

@@ -1,29 +0,0 @@
-/**
- * @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).
- *
- * @constructor
- */
-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/exp/src/core/storage/storage.d.ts

@@ -1,22 +0,0 @@
-/**
- * @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/exp/src/core/util/EventEmitter.d.ts

@@ -1,45 +0,0 @@
-/**
- * @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_;
-    /**
-     * @param {!Array.<string>} allowedEvents_
-     */
-    constructor(allowedEvents_: string[]);
-    /**
-     * To be overridden by derived classes in order to fire an initial event when
-     * somebody subscribes for data.
-     *
-     * @param {!string} eventType
-     * @return {Array.<*>} Array of parameters to trigger initial event with.
-     */
-    abstract getInitialEvent(eventType: string): unknown[];
-    /**
-     * To be called by derived classes to trigger events.
-     * @param {!string} eventType
-     * @param {...*} varArgs
-     */
-    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_;
-}

package/dist/exp/src/core/util/ImmutableTree.d.ts

@@ -1,157 +0,0 @@
-/**
- * @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 './SortedMap';
-import { Path } from './Path';
-/**
- * A tree with immutable elements.
- */
-export declare class ImmutableTree<T> {
-    readonly value: T | null;
-    readonly children: SortedMap<string, ImmutableTree<T>>;
-    static Empty: ImmutableTree<any>;
-    /**
-     * @template T
-     * @param {!Object.<string, !T>} obj
-     * @return {!ImmutableTree.<!T>}
-     */
-    static fromObject<T>(obj: {
-        [k: string]: T;
-    }): ImmutableTree<T>;
-    /**
-     * @template T
-     * @param {?T} value
-     * @param {SortedMap.<string, !ImmutableTree.<T>>=} children
-     */
-    constructor(value: T | null, children?: SortedMap<string, ImmutableTree<T>>);
-    /**
-     * True if the value is empty and there are no children
-     * @return {boolean}
-     */
-    isEmpty(): boolean;
-    /**
-     * Given a path and predicate, return the first node and the path to that node
-     * where the predicate returns true.
-     *
-     * TODO Do a perf test -- If we're creating a bunch of {path: value:} objects
-     * on the way back out, it may be better to pass down a pathSoFar obj.
-     *
-     * @param {!Path} relativePath The remainder of the path
-     * @param {function(T):boolean} predicate The predicate to satisfy to return a
-     *   node
-     * @return {?{path:!Path, value:!T}}
-     */
-    findRootMostMatchingPathAndValue(relativePath: Path, predicate: (a: T) => boolean): {
-        path: Path;
-        value: T;
-    } | null;
-    /**
-     * Find, if it exists, the shortest subpath of the given path that points a defined
-     * value in the tree
-     * @param {!Path} relativePath
-     * @return {?{path: !Path, value: !T}}
-     */
-    findRootMostValueAndPath(relativePath: Path): {
-        path: Path;
-        value: T;
-    } | null;
-    /**
-     * @param {!Path} relativePath
-     * @return {!ImmutableTree.<T>} The subtree at the given path
-     */
-    subtree(relativePath: Path): ImmutableTree<T>;
-    /**
-     * Sets a value at the specified path.
-     *
-     * @param {!Path} relativePath Path to set value at.
-     * @param {?T} toSet Value to set.
-     * @return {!ImmutableTree.<T>} Resulting tree.
-     */
-    set(relativePath: Path, toSet: T | null): ImmutableTree<T>;
-    /**
-     * Removes the value at the specified path.
-     *
-     * @param {!Path} relativePath Path to value to remove.
-     * @return {!ImmutableTree.<T>} Resulting tree.
-     */
-    remove(relativePath: Path): ImmutableTree<T>;
-    /**
-     * Gets a value from the tree.
-     *
-     * @param {!Path} relativePath Path to get value for.
-     * @return {?T} Value at path, or null.
-     */
-    get(relativePath: Path): T | null;
-    /**
-     * Replace the subtree at the specified path with the given new tree.
-     *
-     * @param {!Path} relativePath Path to replace subtree for.
-     * @param {!ImmutableTree} newTree New tree.
-     * @return {!ImmutableTree} Resulting tree.
-     */
-    setTree(relativePath: Path, newTree: ImmutableTree<T>): ImmutableTree<T>;
-    /**
-     * Performs a depth first fold on this tree. Transforms a tree into a single
-     * value, given a function that operates on the path to a node, an optional
-     * current value, and a map of child names to folded subtrees
-     * @template V
-     * @param {function(Path, ?T, Object.<string, V>):V} fn
-     * @return {V}
-     */
-    fold<V>(fn: (path: Path, value: T, children: {
-        [k: string]: V;
-    }) => V): V;
-    /**
-     * Recursive helper for public-facing fold() method
-     * @template V
-     * @param {!Path} pathSoFar
-     * @param {function(Path, ?T, Object.<string, V>):V} fn
-     * @return {V}
-     * @private
-     */
-    private fold_;
-    /**
-     * Find the first matching value on the given path. Return the result of applying f to it.
-     * @template V
-     * @param {!Path} path
-     * @param {!function(!Path, !T):?V} f
-     * @return {?V}
-     */
-    findOnPath<V>(path: Path, f: (path: Path, value: T) => V | null): V | null;
-    private findOnPath_;
-    /**
-     *
-     * @param {!Path} path
-     * @param {!function(!Path, !T)} f
-     * @returns {!ImmutableTree.<T>}
-     */
-    foreachOnPath(path: Path, f: (path: Path, value: T) => void): ImmutableTree<T>;
-    private foreachOnPath_;
-    /**
-     * Calls the given function for each node in the tree that has a value.
-     *
-     * @param {function(!Path, !T)} f A function to be called with
-     *   the path from the root of the tree to a node, and the value at that node.
-     *   Called in depth-first order.
-     */
-    foreach(f: (path: Path, value: T) => void): void;
-    private foreach_;
-    /**
-     *
-     * @param {function(string, !T)} f
-     */
-    foreachChild(f: (name: string, value: T) => void): void;
-}