@firebase/database 0.13.1 → 0.13.2-canary.d3336a9cd

package/dist/node-esm/src/core/SyncTree.d.ts

@@ -21,7 +21,7 @@ import { ImmutableTree } from './util/ImmutableTree';
 import { Path } from './util/Path';
 import { Event } from './view/Event';
 import { EventRegistration, QueryContext } from './view/EventRegistration';
-import { WriteTree } from './WriteTree';
+import { WriteTree, WriteTreeRef } from './WriteTree';
 export declare function syncTreeSetReferenceConstructor(val: ReferenceConstructor): void;
 export interface ListenProvider {
     startListening(query: QueryContext, tag: number | null, hashFn: () => string, onComplete: (a: string, b?: unknown) => Event[]): Event[];
@@ -124,6 +124,20 @@ export declare function syncTreeApplyTaggedListenComplete(syncTree: SyncTree, pa
  * @returns Cancel events, if cancelError was provided.
  */
 export declare function syncTreeRemoveEventRegistration(syncTree: SyncTree, query: QueryContext, eventRegistration: EventRegistration | null, cancelError?: Error): Event[];
+/**
+ * This function was added to support non-listener queries,
+ * specifically for use in repoGetValue. It sets up all the same
+ * local cache data-structures (SyncPoint + View) that are
+ * needed for listeners without installing an event registration.
+ * If `query` is not `loadsAllData`, it will also provision a tag for
+ * the query so that query results can be merged into the sync
+ * tree using existing logic for tagged listener queries.
+ *
+ * @param syncTree - Synctree to add the query to.
+ * @param query - Query to register
+ * @returns tag as a string if query is not a default query, null if query is not.
+ */
+export declare function syncTreeRegisterQuery(syncTree: SyncTree, query: QueryContext): number;
 /**
  * Apply new server data for the specified tagged query.
  *
@@ -138,6 +152,19 @@ export declare function syncTreeApplyTaggedQueryOverwrite(syncTree: SyncTree, pa
 export declare function syncTreeApplyTaggedQueryMerge(syncTree: SyncTree, path: Path, changedChildren: {
     [k: string]: Node;
 }, tag: number): Event[];
+/**
+ * Creates a new syncpoint for a query and creates a tag if the view doesn't exist.
+ * Extracted from addEventRegistration to allow `repoGetValue` to properly set up the SyncTree
+ * without actually listening on a query.
+ */
+export declare function syncTreeRegisterSyncPoint(query: QueryContext, syncTree: SyncTree): {
+    syncPoint: SyncPoint;
+    writesCache: WriteTreeRef;
+    serverCache: Node;
+    serverCacheComplete: any;
+    foundAncestorDefaultView: boolean;
+    viewAlreadyExists: boolean;
+};
 /**
  * Add an event callback for the specified query.
  *

package/dist/node-esm/src/core/util/Path.d.ts

@@ -62,7 +62,7 @@ export declare function pathCompare(left: Path, right: Path): number;
  */
 export declare function pathEquals(path: Path, other: Path): boolean;
 /**
- * @returns True if this path is a parent (or the same as) other
+ * @returns True if this path is a parent of (or the same as) other
  */
 export declare function pathContains(path: Path, other: Path): boolean;
 /**

package/dist/node-esm/test/helpers/util.d.ts

@@ -14,9 +14,15 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { Database } from '../../src';
 export declare const TEST_PROJECT: any;
 export declare const DATABASE_ADDRESS: any;
 export declare const DATABASE_URL: any;
 export declare function testRepoInfo(url: any): import("../../src/core/RepoInfo").RepoInfo;
 export declare function repoInfoForConnectionTest(): import("../../src/core/RepoInfo").RepoInfo;
 export declare function shuffle(arr: any, randFn?: () => number): void;
+export declare function waitFor(waitTimeInMS: number): Promise<unknown>;
+export declare function getUniqueRef(db: Database): {
+    ref: import("../../src").DatabaseReference;
+    path: string;
+};

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

@@ -21,7 +21,7 @@ import { ImmutableTree } from './util/ImmutableTree';
 import { Path } from './util/Path';
 import { Event } from './view/Event';
 import { EventRegistration, QueryContext } from './view/EventRegistration';
-import { WriteTree } from './WriteTree';
+import { WriteTree, WriteTreeRef } from './WriteTree';
 export declare function syncTreeSetReferenceConstructor(val: ReferenceConstructor): void;
 export interface ListenProvider {
     startListening(query: QueryContext, tag: number | null, hashFn: () => string, onComplete: (a: string, b?: unknown) => Event[]): Event[];
@@ -124,6 +124,20 @@ export declare function syncTreeApplyTaggedListenComplete(syncTree: SyncTree, pa
  * @returns Cancel events, if cancelError was provided.
  */
 export declare function syncTreeRemoveEventRegistration(syncTree: SyncTree, query: QueryContext, eventRegistration: EventRegistration | null, cancelError?: Error): Event[];
+/**
+ * This function was added to support non-listener queries,
+ * specifically for use in repoGetValue. It sets up all the same
+ * local cache data-structures (SyncPoint + View) that are
+ * needed for listeners without installing an event registration.
+ * If `query` is not `loadsAllData`, it will also provision a tag for
+ * the query so that query results can be merged into the sync
+ * tree using existing logic for tagged listener queries.
+ *
+ * @param syncTree - Synctree to add the query to.
+ * @param query - Query to register
+ * @returns tag as a string if query is not a default query, null if query is not.
+ */
+export declare function syncTreeRegisterQuery(syncTree: SyncTree, query: QueryContext): number;
 /**
  * Apply new server data for the specified tagged query.
  *
@@ -138,6 +152,19 @@ export declare function syncTreeApplyTaggedQueryOverwrite(syncTree: SyncTree, pa
 export declare function syncTreeApplyTaggedQueryMerge(syncTree: SyncTree, path: Path, changedChildren: {
     [k: string]: Node;
 }, tag: number): Event[];
+/**
+ * Creates a new syncpoint for a query and creates a tag if the view doesn't exist.
+ * Extracted from addEventRegistration to allow `repoGetValue` to properly set up the SyncTree
+ * without actually listening on a query.
+ */
+export declare function syncTreeRegisterSyncPoint(query: QueryContext, syncTree: SyncTree): {
+    syncPoint: SyncPoint;
+    writesCache: WriteTreeRef;
+    serverCache: Node;
+    serverCacheComplete: any;
+    foundAncestorDefaultView: boolean;
+    viewAlreadyExists: boolean;
+};
 /**
  * Add an event callback for the specified query.
  *

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

@@ -62,7 +62,7 @@ export declare function pathCompare(left: Path, right: Path): number;
  */
 export declare function pathEquals(path: Path, other: Path): boolean;
 /**
- * @returns True if this path is a parent (or the same as) other
+ * @returns True if this path is a parent of (or the same as) other
  */
 export declare function pathContains(path: Path, other: Path): boolean;
 /**

package/dist/test/helpers/util.d.ts

@@ -14,9 +14,15 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { Database } from '../../src';
 export declare const TEST_PROJECT: any;
 export declare const DATABASE_ADDRESS: any;
 export declare const DATABASE_URL: any;
 export declare function testRepoInfo(url: any): import("../../src/core/RepoInfo").RepoInfo;
 export declare function repoInfoForConnectionTest(): import("../../src/core/RepoInfo").RepoInfo;
 export declare function shuffle(arr: any, randFn?: () => number): void;
+export declare function waitFor(waitTimeInMS: number): Promise<unknown>;
+export declare function getUniqueRef(db: Database): {
+    ref: import("../../src").DatabaseReference;
+    path: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firebase/database",
-  "version": "0.13.1",
+  "version": "0.13.2-canary.d3336a9cd",
   "description": "",
   "author": "Firebase <firebase-support@google.com> (https://firebase.google.com/)",
   "main": "dist/index.node.cjs.js",
@@ -45,18 +45,19 @@
   "license": "Apache-2.0",
   "peerDependencies": {},
   "dependencies": {
-    "@firebase/logger": "0.3.3",
-    "@firebase/util": "1.6.1",
-    "@firebase/component": "0.5.15",
-    "@firebase/auth-interop-types": "0.1.6",
+    "@firebase/logger": "0.3.3-canary.d3336a9cd",
+    "@firebase/util": "1.6.2-canary.d3336a9cd",
+    "@firebase/component": "0.5.16-canary.d3336a9cd",
+    "@firebase/auth-interop-types": "0.1.6-canary.d3336a9cd",
     "faye-websocket": "0.11.4",
     "tslib": "^2.1.0"
   },
   "devDependencies": {
-    "@firebase/app": "0.7.26",
+    "@firebase/app": "0.7.27-canary.d3336a9cd",
     "rollup": "2.72.1",
     "rollup-plugin-typescript2": "0.31.2",
-    "typescript": "4.2.2"
+    "typescript": "4.2.2",
+    "uuid": "^8.3.2"
   },
   "repository": {
     "directory": "packages/database",