@canner-ca/cli 0.4.1 → 0.5.1

package/README.md

@@ -19,7 +19,7 @@ Requires Node.js 20 or later.
 ## Quick start
 
 ```bash
-# Sign in once (paste an API token from canner.ca/dashboard/account)
+# Sign in once (paste an API token from canner.ca/dashboard/identity/api-keys)
 canner login
 
 # In your project directory, create a Canner project
@@ -76,6 +76,30 @@ canner deploy --follow
 | `canner domains verify <hostname\|id> [--slug X]` | Re-check DNS and provision TLS. |
 | `canner domains rm <hostname\|id> [--slug X]` | Detach a custom domain. |
 
+### Databases
+
+| Command | What it does |
+|---|---|
+| `canner db [list] [--slug X]` | List the project's databases (the primary is injected as `DATABASE_URL`). |
+| `canner db init [--pg 17\|18]` | Provision the project's primary database. |
+| `canner db create <name> [--pg 17\|18]` | Add another database (paid plans). Injected as `DATABASE_URL_<NAME>`. |
+| `canner db info [<name>] [--reveal]` / `canner db url [<name>]` | Connection details. The password is hidden unless `--reveal` (and is `null` in `--json`). |
+| `canner db export [<name>] [--format custom\|plain] [--out FILE]` | Dump a database and download it. `custom` restores with `pg_restore`, `plain` is gzipped SQL. Every plan. |
+| `canner db import <file> [--to <name>] [--replace]` | Restore a `pg_dump --format=custom` file (max 500 MB). The database must be empty unless `--replace`, which snapshots it first. Atomic: on failure nothing changes. |
+| `canner db migrate-in --from <url>\|--from-env VAR [--to <name>] [--replace]` | Stream a database in from any publicly reachable Postgres server. Nothing is stored; the URL is used once. Use `--from -` to type it instead of putting a password in your shell history. |
+| `canner db migrate-out --to-url <url>\|--to-env VAR [--from <name>] --yes` | Stream a database out to another server. |
+| `canner db copy <from> <to> [--to-project SLUG] [--replace]` | Copy one database into another you own. |
+| `canner db rm <name> --yes` · `canner db pg-version <name> <17\|18> --yes` | Delete an additional database · move it to another Postgres version. |
+| `canner db ops [<id>]` | Recent operations, or one operation's status. |
+| `canner db external [<name>]` | Show external-access status: host, port, allowlist. |
+| `canner db external <name> --enable --allow CIDR [--allow CIDR ...]` | Turn on public access, restricted to the given IPs/CIDRs (repeatable). `--allow-all --yes` opens it to the whole internet — not recommended. |
+| `canner db external <name> --disable` | Turn public access off. Always allowed, even on a downgraded plan. |
+| `canner db rotate <name> --yes` | Rotate the database's password. Redeploy to pick up the new `DATABASE_URL`. |
+
+Export, import, migrate and copy run on Canner. The CLI starts the operation and
+shows progress; add `--no-wait` to return immediately and check with `canner db ops <id>`.
+Boolean flags (`--replace`, `--yes`, `--no-wait`) can appear anywhere.
+
 ## JSON output
 
 Add `--json` to any command for machine-readable output — tables and progress lines are suppressed and a single JSON value is printed to stdout, so the result pipes straight into `jq` or an agent. Errors are written to stderr as `{"error":"..."}` with a non-zero exit code. With `--json`, `deploy --follow` does **not** stream the build log (it would corrupt the JSON); poll `canner deployments <id> --json` for the terminal status instead.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canner-ca/cli",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Canner deploy CLI — git push from any terminal, no GitHub required",
   "type": "module",
   "bin": {
@@ -12,7 +12,8 @@
   ],
   "scripts": {
     "start": "node src/cli.mjs",
-    "prepublishOnly": "node -e \"require('fs').accessSync('src/cli.mjs')\""
+    "test": "node test/run.mjs",
+    "prepublishOnly": "node -e \"const s=require('fs').readFileSync('src/cli.mjs','utf8'); if(s.includes('\\r')){console.error('src/cli.mjs has CRLF line endings; publish it with LF (see .gitattributes).');process.exit(1)}\" && npm test"
   },
   "dependencies": {
     "tar": "^7.4.3"