snoutdata 0.21.0 → 0.22.0

package/README.md

@@ -96,7 +96,8 @@ snoutdata link --ref R                # point this folder at an existing project
 **Auth**
 
 ```bash
-snoutdata login                       # through a browser
+snoutdata login                       # a sign-in page: Google, GitHub or your work email
+snoutdata login --provider github     # straight to one provider
 snoutdata login --sso                 # your company's identity provider; asks for a work email
 snoutdata login --sso --domain acme.com   # or name the domain and skip the question
 snoutdata login --device              # print a code to type into a browser anywhere
@@ -116,6 +117,8 @@ snoutdata projects list
 snoutdata projects create --name X [--region R] [--no-wait]
 snoutdata projects pause|resume|delete [--ref R]
 snoutdata usage [--ref R] [--days 30] [--history]
+snoutdata usage --tables [--limit 20]             # and the largest tables
+snoutdata metrics [--ref R] [--node REF] [--window hour|day|week]
 snoutdata teams
 ```
 
@@ -124,7 +127,10 @@ snoutdata teams
 ```bash
 snoutdata db url [--ref R]                        # a connection string
 snoutdata db psql [--ref R] [-- ...]              # opens psql, no password typed
-snoutdata db reset-password [--ref R]
+snoutdata db query "SQL" [--ref R]                # run SQL, no psql needed; rows as a table
+snoutdata db run FILE.sql [--ref R]               # a file in one transaction, no psql needed
+snoutdata db slow [--limit 10]                    # the statements that took the most time
+snoutdata db reset-password [--grace 60]          # new password, other owner login; old one works 60 min
 snoutdata db access [--ref R]                     # who signs in as themselves (Postgres 18)
 snoutdata db access grant EMAIL [--level full|read]   # prints their connection string
 snoutdata db access revoke EMAIL|ROLE
@@ -133,12 +139,13 @@ snoutdata db push [--dir migrations] [--dry-run]  # run the .sql files, once eac
 snoutdata db restore --file DUMP [--force]
 ```
 
-`db push` needs nothing installed: it connects to the database itself and sends each file a
-statement at a time, cut where `psql` would cut it. A file holding a `psql` command (`\i`, `\set`)
-is refused before anything runs. `db psql`, `db restore` and `gen types` use the Postgres client
-tools.
+`db push`, `db query`, `db run` and `db slow` need nothing installed: they connect to the database
+themselves and send SQL a statement at a time, cut where `psql` would cut it. A file holding a
+`psql` command (`\i`, `\set`) is refused before anything runs. `db run`, and a `db query` with
+several statements, runs them in one transaction: the first that fails rolls it all back and the
+error names it. `db psql`, `db restore` and `gen types` use the Postgres client tools.
 
-`db psql`, `db push`, `db restore` and `gen types` verify the database's certificate
+`db psql`, `db push`, `db query`, `db run`, `db restore` and `gen types` verify the database's certificate
 (`sslmode=verify-full`, against Node's trusted roots). `SNOUTDATA_DB_SSLMODE=require` turns the
 check off, for a network that re-signs Postgres traffic.