first pass at api (works-ish)
replace db-spec with *db-spec*

clean up fn signatures a little by getting rid
of db-spec arguments everywhere and replacing them
with dynamic var (*db-spec*).