@firebase/database 0.8.3-canary.fb90580e5 → 0.8.3

package/dist/exp/src/api/onDisconnect.d.ts

@@ -1,60 +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 { Repo } from '../core/Repo';
-import { Path } from '../core/util/Path';
-import { Indexable } from '../core/util/misc';
-/**
- * @constructor
- */
-export declare class OnDisconnect {
-    private repo_;
-    private path_;
-    /**
-     * @param {!Repo} repo_
-     * @param {!Path} path_
-     */
-    constructor(repo_: Repo, path_: Path);
-    /**
-     * @param {function(?Error)=} onComplete
-     * @return {!firebase.Promise}
-     */
-    cancel(onComplete?: (a: Error | null) => void): Promise<void>;
-    /**
-     * @param {function(?Error)=} onComplete
-     * @return {!firebase.Promise}
-     */
-    remove(onComplete?: (a: Error | null) => void): Promise<void>;
-    /**
-     * @param {*} value
-     * @param {function(?Error)=} onComplete
-     * @return {!firebase.Promise}
-     */
-    set(value: unknown, onComplete?: (a: Error | null) => void): Promise<void>;
-    /**
-     * @param {*} value
-     * @param {number|string|null} priority
-     * @param {function(?Error)=} onComplete
-     * @return {!firebase.Promise}
-     */
-    setWithPriority(value: unknown, priority: number | string | null, onComplete?: (a: Error | null) => void): Promise<void>;
-    /**
-     * @param {!Object} objectToMerge
-     * @param {function(?Error)=} onComplete
-     * @return {!firebase.Promise}
-     */
-    update(objectToMerge: Indexable, onComplete?: (a: Error | null) => void): Promise<void>;
-}

package/dist/exp/src/api/test_access.d.ts

@@ -1,42 +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 { RepoInfo } from '../core/RepoInfo';
-import { PersistentConnection } from '../core/PersistentConnection';
-import { Connection } from '../realtime/Connection';
-import { Query } from './Query';
-export declare const DataConnection: typeof PersistentConnection;
-export declare const RealTimeConnection: typeof Connection;
-/**
- * @param {function(): string} newHash
- * @return {function()}
- */
-export declare const hijackHash: (newHash: () => string) => () => void;
-/**
- * @type {function(new:RepoInfo, !string, boolean, !string, boolean): undefined}
- */
-export declare const ConnectionTarget: typeof RepoInfo;
-/**
- * @param {!Query} query
- * @return {!string}
- */
-export declare const queryIdentifier: (query: Query) => string;
-/**
- * Forces the RepoManager to create Repos that use ReadonlyRestClient instead of PersistentConnection.
- *
- * @param {boolean} forceRestClient
- */
-export declare const forceRestClient: (forceRestClient: boolean) => void;

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

@@ -1,50 +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 { FirebaseAuthTokenData } from '@firebase/app-types/private';
-import { FirebaseAuthInternalName } from '@firebase/auth-interop-types';
-import { Provider } from '@firebase/component';
-import { FirebaseAppLike } from './RepoManager';
-export interface AuthTokenProvider {
-    getToken(forceRefresh: boolean): Promise<FirebaseAuthTokenData>;
-    addTokenChangeListener(listener: (token: string | null) => void): void;
-    removeTokenChangeListener(listener: (token: string | null) => void): void;
-    notifyForInvalidToken(): void;
-}
-/**
- * Abstraction around FirebaseApp's token fetching capabilities.
- */
-export declare class FirebaseAuthTokenProvider implements AuthTokenProvider {
-    private app_;
-    private authProvider_;
-    private auth_;
-    constructor(app_: FirebaseAppLike, authProvider_: Provider<FirebaseAuthInternalName>);
-    /**
-     * @param {boolean} forceRefresh
-     * @return {!Promise<FirebaseAuthTokenData>}
-     */
-    getToken(forceRefresh: boolean): Promise<FirebaseAuthTokenData>;
-    addTokenChangeListener(listener: (token: string | null) => void): void;
-    removeTokenChangeListener(listener: (token: string | null) => void): void;
-    notifyForInvalidToken(): void;
-}
-export declare class EmulatorAdminTokenProvider implements AuthTokenProvider {
-    private static EMULATOR_AUTH_TOKEN;
-    getToken(forceRefresh: boolean): Promise<FirebaseAuthTokenData>;
-    addTokenChangeListener(listener: (token: string | null) => void): void;
-    removeTokenChangeListener(listener: (token: string | null) => void): void;
-    notifyForInvalidToken(): void;
-}

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

@@ -1,77 +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 { ImmutableTree } from './util/ImmutableTree';
-import { Path } from './util/Path';
-import { Node, NamedNode } from './snap/Node';
-/**
- * This class holds a collection of writes that can be applied to nodes in unison. It abstracts away the logic with
- * dealing with priority writes and multiple nested writes. At any given path there is only allowed to be one write
- * modifying that path. Any write to an existing path or shadowing an existing path will modify that existing write
- * to reflect the write added.
- */
-export declare class CompoundWrite {
-    private writeTree_;
-    constructor(writeTree_: ImmutableTree<Node>);
-    static Empty: CompoundWrite;
-    addWrite(path: Path, node: Node): CompoundWrite;
-    addWrites(path: Path, updates: {
-        [name: string]: Node;
-    }): CompoundWrite;
-    /**
-     * Will remove a write at the given path and deeper paths. This will <em>not</em> modify a write at a higher
-     * location, which must be removed by calling this method with that path.
-     *
-     * @param path The path at which a write and all deeper writes should be removed
-     * @return {!CompoundWrite} The new CompoundWrite with the removed path
-     */
-    removeWrite(path: Path): CompoundWrite;
-    /**
-     * Returns whether this CompoundWrite will fully overwrite a node at a given location and can therefore be
-     * considered "complete".
-     *
-     * @param path The path to check for
-     * @return Whether there is a complete write at that path
-     */
-    hasCompleteWrite(path: Path): boolean;
-    /**
-     * Returns a node for a path if and only if the node is a "complete" overwrite at that path. This will not aggregate
-     * writes from deeper paths, but will return child nodes from a more shallow path.
-     *
-     * @param path The path to get a complete write
-     * @return The node if complete at that path, or null otherwise.
-     */
-    getCompleteNode(path: Path): Node | null;
-    /**
-     * Returns all children that are guaranteed to be a complete overwrite.
-     *
-     * @return A list of all complete children.
-     */
-    getCompleteChildren(): NamedNode[];
-    childCompoundWrite(path: Path): CompoundWrite;
-    /**
-     * Returns true if this CompoundWrite is empty and therefore does not modify any nodes.
-     * @return Whether this CompoundWrite is empty
-     */
-    isEmpty(): boolean;
-    /**
-     * Applies this CompoundWrite to a node. The node is returned with all writes from this CompoundWrite applied to the
-     * node
-     * @param node The node to apply this CompoundWrite to
-     * @return The node with all writes applied
-     */
-    apply(node: Node): Node;
-}

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

@@ -1,148 +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 { ServerActions } from './ServerActions';
-import { AuthTokenProvider } from './AuthTokenProvider';
-import { RepoInfo } from './RepoInfo';
-import { Query } from '../api/Query';
-/**
- * Firebase connection.  Abstracts wire protocol and handles reconnecting.
- *
- * NOTE: All JSON objects sent to the realtime connection must have property names enclosed
- * in quotes to make sure the closure compiler does not minify them.
- */
-export declare class PersistentConnection extends ServerActions {
-    private repoInfo_;
-    private applicationId_;
-    private onDataUpdate_;
-    private onConnectStatus_;
-    private onServerInfoUpdate_;
-    private authTokenProvider_;
-    private authOverride_?;
-    id: number;
-    private log_;
-    private interruptReasons_;
-    /** Map<path, Map<queryId, ListenSpec>> */
-    private readonly listens;
-    private outstandingPuts_;
-    private outstandingGets_;
-    private outstandingPutCount_;
-    private outstandingGetCount_;
-    private onDisconnectRequestQueue_;
-    private connected_;
-    private reconnectDelay_;
-    private maxReconnectDelay_;
-    private securityDebugCallback_;
-    lastSessionId: string | null;
-    private establishConnectionTimer_;
-    private visible_;
-    private requestCBHash_;
-    private requestNumber_;
-    private realtime_;
-    private authToken_;
-    private forceTokenRefresh_;
-    private invalidAuthTokenCount_;
-    private firstConnection_;
-    private lastConnectionAttemptTime_;
-    private lastConnectionEstablishedTime_;
-    private static nextPersistentConnectionId_;
-    /**
-     * Counter for number of connections created. Mainly used for tagging in the logs
-     */
-    private static nextConnectionId_;
-    /**
-     * @implements {ServerActions}
-     * @param repoInfo_ Data about the namespace we are connecting to
-     * @param applicationId_ The Firebase App ID for this project
-     * @param onDataUpdate_ A callback for new data from the server
-     */
-    constructor(repoInfo_: RepoInfo, applicationId_: string, onDataUpdate_: (a: string, b: unknown, c: boolean, d: number | null) => void, onConnectStatus_: (a: boolean) => void, onServerInfoUpdate_: (a: unknown) => void, authTokenProvider_: AuthTokenProvider, authOverride_?: object | null);
-    protected sendRequest(action: string, body: unknown, onResponse?: (a: unknown) => void): void;
-    get(query: Query): Promise<string>;
-    /**
-     * @inheritDoc
-     */
-    listen(query: Query, currentHashFn: () => string, tag: number | null, onComplete: (a: string, b: unknown) => void): void;
-    private sendGet_;
-    private sendListen_;
-    private static warnOnListenWarnings_;
-    /**
-     * @inheritDoc
-     */
-    refreshAuthToken(token: string): void;
-    private reduceReconnectDelayIfAdminCredential_;
-    /**
-     * Attempts to authenticate with the given credentials. If the authentication attempt fails, it's triggered like
-     * a auth revoked (the connection is closed).
-     */
-    tryAuth(): void;
-    /**
-     * @inheritDoc
-     */
-    unlisten(query: Query, tag: number | null): void;
-    private sendUnlisten_;
-    /**
-     * @inheritDoc
-     */
-    onDisconnectPut(pathString: string, data: unknown, onComplete?: (a: string, b: string) => void): void;
-    /**
-     * @inheritDoc
-     */
-    onDisconnectMerge(pathString: string, data: unknown, onComplete?: (a: string, b: string) => void): void;
-    /**
-     * @inheritDoc
-     */
-    onDisconnectCancel(pathString: string, onComplete?: (a: string, b: string) => void): void;
-    private sendOnDisconnect_;
-    /**
-     * @inheritDoc
-     */
-    put(pathString: string, data: unknown, onComplete?: (a: string, b: string) => void, hash?: string): void;
-    /**
-     * @inheritDoc
-     */
-    merge(pathString: string, data: unknown, onComplete: (a: string, b: string | null) => void, hash?: string): void;
-    putInternal(action: string, pathString: string, data: unknown, onComplete: (a: string, b: string | null) => void, hash?: string): void;
-    private sendPut_;
-    /**
-     * @inheritDoc
-     */
-    reportStats(stats: {
-        [k: string]: unknown;
-    }): void;
-    private onDataMessage_;
-    private onDataPush_;
-    private onReady_;
-    private scheduleConnect_;
-    private onVisible_;
-    private onOnline_;
-    private onRealtimeDisconnect_;
-    private establishConnection_;
-    interrupt(reason: string): void;
-    resume(reason: string): void;
-    private handleTimestamp_;
-    private cancelSentTransactions_;
-    private onListenRevoked_;
-    private removeListen_;
-    private onAuthRevoked_;
-    private onSecurityDebugPacket_;
-    private restoreState_;
-    /**
-     * Sends client stats for first connection
-     */
-    private sendConnectStats_;
-    private shouldReconnect_;
-}

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

@@ -1,73 +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 { ServerActions } from './ServerActions';
-import { RepoInfo } from './RepoInfo';
-import { AuthTokenProvider } from './AuthTokenProvider';
-import { Query } from '../api/Query';
-/**
- * An implementation of ServerActions that communicates with the server via REST requests.
- * This is mostly useful for compatibility with crawlers, where we don't want to spin up a full
- * persistent connection (using WebSockets or long-polling)
- */
-export declare class ReadonlyRestClient extends ServerActions {
-    private repoInfo_;
-    private onDataUpdate_;
-    private authTokenProvider_;
-    reportStats(stats: {
-        [k: string]: unknown;
-    }): void;
-    /** @private {function(...[*])} */
-    private log_;
-    /**
-     * We don't actually need to track listens, except to prevent us calling an onComplete for a listen
-     * that's been removed. :-/
-     *
-     * @private {!Object.<string, !Object>}
-     */
-    private listens_;
-    /**
-     * @param {!Query} query
-     * @param {?number=} tag
-     * @return {string}
-     * @private
-     */
-    static getListenId_(query: Query, tag?: number | null): string;
-    /**
-     * @param {!RepoInfo} repoInfo_ Data about the namespace we are connecting to
-     * @param {function(string, *, boolean, ?number)} onDataUpdate_ A callback for new data from the server
-     * @param {AuthTokenProvider} authTokenProvider_
-     * @implements {ServerActions}
-     */
-    constructor(repoInfo_: RepoInfo, onDataUpdate_: (a: string, b: unknown, c: boolean, d: number | null) => void, authTokenProvider_: AuthTokenProvider);
-    /** @inheritDoc */
-    listen(query: Query, currentHashFn: () => string, tag: number | null, onComplete: (a: string, b: unknown) => void): void;
-    /** @inheritDoc */
-    unlisten(query: Query, tag: number | null): void;
-    get(query: Query): Promise<string>;
-    /** @inheritDoc */
-    refreshAuthToken(token: string): void;
-    /**
-     * Performs a REST request to the given path, with the provided query string parameters,
-     * and any auth credentials we have.
-     *
-     * @param {!string} pathString
-     * @param {!Object.<string, *>} queryStringParameters
-     * @param {?function(?number, *=)} callback
-     * @private
-     */
-    private restRequest_;
-}

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

@@ -1,121 +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 { Path } from './util/Path';
-import { AuthTokenProvider } from './AuthTokenProvider';
-import { PersistentConnection } from './PersistentConnection';
-import { RepoInfo } from './RepoInfo';
-import { Database } from '../api/Database';
-import { DataSnapshot } from '../api/DataSnapshot';
-import { Query } from '../api/Query';
-import { EventRegistration } from './view/EventRegistration';
-import { Indexable } from './util/misc';
-import { FirebaseAppLike } from './RepoManager';
-/**
- * A connection to a single data repository.
- */
-export declare class Repo {
-    repoInfo_: RepoInfo;
-    private forceRestClient_;
-    app: FirebaseAppLike;
-    authTokenProvider_: AuthTokenProvider;
-    /** Key for uniquely identifying this repo, used in RepoManager */
-    readonly key: string;
-    dataUpdateCount: number;
-    private infoSyncTree_;
-    private serverSyncTree_;
-    private stats_;
-    private statsListener_;
-    private eventQueue_;
-    private nextWriteId_;
-    private server_;
-    private statsReporter_;
-    private transactionsInit_;
-    private infoData_;
-    private abortTransactions_;
-    private rerunTransactions_;
-    private interceptServerDataCallback_;
-    private __database;
-    /** A list of data pieces and paths to be set when this client disconnects. */
-    private onDisconnect_;
-    persistentConnection_: PersistentConnection | null;
-    constructor(repoInfo_: RepoInfo, forceRestClient_: boolean, app: FirebaseAppLike, authTokenProvider_: AuthTokenProvider);
-    start(): void;
-    /**
-     * @return The URL corresponding to the root of this Firebase.
-     */
-    toString(): string;
-    /**
-     * @return The namespace represented by the repo.
-     */
-    name(): string;
-    /**
-     * @return The time in milliseconds, taking the server offset into account if we have one.
-     */
-    serverTime(): number;
-    /**
-     * Generate ServerValues using some variables from the repo object.
-     */
-    generateServerValues(): Indexable;
-    /**
-     * Called by realtime when we get new messages from the server.
-     */
-    private onDataUpdate_;
-    interceptServerData_(callback: ((a: string, b: unknown) => unknown) | null): void;
-    private onConnectStatus_;
-    private onServerInfoUpdate_;
-    private updateInfo_;
-    private getNextWriteId_;
-    /**
-     * The purpose of `getValue` is to return the latest known value
-     * satisfying `query`.
-     *
-     * This method will first check for in-memory cached values
-     * belonging to active listeners. If they are found, such values
-     * are considered to be the most up-to-date.
-     *
-     * If the client is not connected, this method will try to
-     * establish a connection and request the value for `query`. If
-     * the client is not able to retrieve the query result, it reports
-     * an error.
-     *
-     * @param query - The query to surface a value for.
-     */
-    getValue(query: Query): Promise<DataSnapshot>;
-    setWithPriority(path: Path, newVal: unknown, newPriority: number | string | null, onComplete: ((status: Error | null, errorReason?: string) => void) | null): void;
-    update(path: Path, childrenToMerge: {
-        [k: string]: unknown;
-    }, onComplete: ((status: Error | null, errorReason?: string) => void) | null): void;
-    /**
-     * Applies all of the changes stored up in the onDisconnect_ tree.
-     */
-    private runOnDisconnectEvents_;
-    onDisconnectCancel(path: Path, onComplete: ((status: Error | null, errorReason?: string) => void) | null): void;
-    onDisconnectSet(path: Path, value: unknown, onComplete: ((status: Error | null, errorReason?: string) => void) | null): void;
-    onDisconnectSetWithPriority(path: Path, value: unknown, priority: unknown, onComplete: ((status: Error | null, errorReason?: string) => void) | null): void;
-    onDisconnectUpdate(path: Path, childrenToMerge: {
-        [k: string]: unknown;
-    }, onComplete: ((status: Error | null, errorReason?: string) => void) | null): void;
-    addEventCallbackForQuery(query: Query, eventRegistration: EventRegistration): void;
-    removeEventCallbackForQuery(query: Query, eventRegistration: EventRegistration): void;
-    interrupt(): void;
-    resume(): void;
-    stats(showDelta?: boolean): void;
-    statsIncrementCounter(metric: string): void;
-    private log_;
-    callOnCompleteCallback(callback: ((status: Error | null, errorReason?: string) => void) | null, status: string, errorReason?: string | null): void;
-    get database(): Database;
-}

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

@@ -1,59 +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.
- */
-/**
- * A class that holds metadata about a Repo object
- *
- * @constructor
- */
-export declare class RepoInfo {
-    readonly secure: boolean;
-    readonly namespace: string;
-    readonly webSocketOnly: boolean;
-    readonly nodeAdmin: boolean;
-    readonly persistenceKey: string;
-    readonly includeNamespaceInQueryParams: boolean;
-    host: string;
-    domain: string;
-    internalHost: string;
-    /**
-     * @param host Hostname portion of the url for the repo
-     * @param secure Whether or not this repo is accessed over ssl
-     * @param namespace The namespace represented by the repo
-     * @param webSocketOnly Whether to prefer websockets over all other transports (used by Nest).
-     * @param nodeAdmin Whether this instance uses Admin SDK credentials
-     * @param persistenceKey Override the default session persistence storage key
-     */
-    constructor(host: string, secure: boolean, namespace: string, webSocketOnly: boolean, nodeAdmin?: boolean, persistenceKey?: string, includeNamespaceInQueryParams?: boolean);
-    needsQueryParam(): boolean;
-    isCacheableHost(): boolean;
-    isDemoHost(): boolean;
-    isCustomHost(): boolean;
-    updateHost(newHost: string): void;
-    /**
-     * Returns the websocket URL for this repo
-     * @param {string} type of connection
-     * @param {Object} params list
-     * @return {string} The URL for this repo
-     */
-    connectionURL(type: string, params: {
-        [k: string]: string;
-    }): string;
-    /** @return {string} */
-    toString(): string;
-    /** @return {string} */
-    toURLString(): string;
-}