refactor(db)!: reference is now instance of a Database reference

[Salakar]

Formerly a string only.

Testing

Deployed the following function;

from firebase_functions import db_fn, options
from firebase_admin import initialize_app

initialize_app()

options.set_global_options(region=options.SupportedRegion.EUROPE_WEST1)


@db_fn.on_value_written(reference="hello/world", instance="a-non-default-database")
def onwriteexample(event: db_fn.Event[db_fn.Change]) -> None:
    print("Hello from db write event:", event)
    print("Reference.path:", event.reference.path)
    print("Reference.get():", event.reference.get())

Edited /hello/world on Firebase console to have the value "some data in my hello/world ref woo!", this successfully triggered, logs shown below (note the none default database instance and non default region used in the deployed code to verify correct instance is targetted by the ref):