groundmail-cli 0.0.0-stage → 0.16.0

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# groundmail-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Command-line client for [Groundmail](https://groundmail.dev) — send transactional email and manage domains, webhooks, templates, and more from the terminal.
+
+```bash
+npm install -g groundmail-cli
+```
+
+```bash
+groundmail login
+```
+
+`login` prints a link and a short code. Approve the code in the browser, review the
+scopes, pick the workspace, and the CLI signs in with OAuth: a one-hour access token
+that refreshes on its own, and a refresh token kept in your OS keychain (macOS Keychain,
+Windows Credential Manager, Secret Service; a file readable only by you when there is no
+keychain). It works over SSH and from coding agents too: without a terminal it prints the
+link and exits, and running `groundmail login` again after you approve finishes the sign-in.
+
+Ask for less than full access with `--scope`, and hand short-lived tokens to scripts:
+
+```bash
+groundmail login --scope emails:send,domains:read
+curl -H "Authorization: Bearer $(groundmail auth token --scope emails:send)" https://api.groundmail.dev/emails
+groundmail logout   # revokes the sign-in on the server
+```
+
+See and revoke every signed-in CLI and agent in the dashboard under **Settings → CLIs & agents**.
+
+Or set a key yourself (CI; it wins over a saved sign-in):
+
+```bash
+export GROUNDMAIL_API_KEY=gm_your_key_here
+```
+
+```bash
+groundmail emails send \
+  --from ops@yourdomain.com \
+  --to user@example.com \
+  --subject 'Your receipt' \
+  --html '<p>Thanks for your purchase.</p>'
+```
+
+Or without a global install:
+
+```bash
+npx groundmail-cli emails send --from … --to … --subject … --html …
+```
+
+## Common commands
+
+```bash
+groundmail whoami
+groundmail auth token [--scope emails:send]
+groundmail workspaces list
+groundmail workspaces use <name>
+groundmail domains list
+groundmail domains verify example.com
+groundmail webhooks list
+groundmail emails list
+```
+
+Run `groundmail --help` or `groundmail <command> --help` for flags.
+
+## Docs
+
+- CLI: https://docs.groundmail.dev/cli
+- Quickstart: https://docs.groundmail.dev/quickstart
+- Domains API / CLI: https://docs.groundmail.dev/api/domains
+- Agent skills (CLI): https://docs.groundmail.dev/ai/agent-skills
+- Product: https://groundmail.dev
+
+## License
+
+MIT

package/dist/chunk-4SSJDDBV.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+export {
+  __commonJS
+};

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }