clerk 4.2.1-canary.ea2cecc → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +22 -5
  2. package/package.json +9 -9
package/README.md CHANGED
@@ -87,7 +87,9 @@ Commands:
87
87
  impersonate|imp [options] [user] Impersonate a Clerk user
88
88
  init [options] Initialize Clerk in your project
89
89
  link [options] Link this project to a Clerk application
90
+ logs [options] Read your instance's Application Logs
90
91
  mcp Manage the Clerk remote MCP server connection for AI editors and CLIs
92
+ migrate Migrate users into Clerk from another auth platform or another Clerk instance
91
93
  open Open Clerk resources in your browser
92
94
  security Audit an instance against Clerk's security recommendations
93
95
  telemetry Control CLI usage telemetry (status, disable, enable)
@@ -99,14 +101,29 @@ Commands:
99
101
  bird Play Clerk Bird, a Flappy Bird game in your terminal
100
102
  ```
101
103
 
104
+ ## Output stability
105
+
106
+ The human output (tables, summaries, notes, and colors) is written for people
107
+ and can change in any release. It truncates IDs, prints times in your local
108
+ time zone, and adds color, so don't parse it.
109
+
110
+ Scripts and agents should use `--json`. Its shape is a contract: removing,
111
+ renaming, or changing the type of a field ships only in a major version. New
112
+ fields, and list items with a new `object` value, can appear in any release, so
113
+ ignore what you don't recognize. In agent mode, most commands that support
114
+ `--json` print JSON without the flag.
115
+
102
116
  ## Telemetry
103
117
 
104
118
  The Clerk CLI collects usage telemetry: command name, flag names, duration, outcome,
105
- environment signals (OS, install method, terminal), a random machine identifier — and
106
- your workspace and app IDs when a project is linked. It never collects command
107
- arguments, option values, file paths, or personal data, except the text you choose to
108
- send with `clerk feedback`, which is scrubbed on a best-effort basis for common secret
109
- formats, home-directory paths and email addresses before it leaves your machine;
119
+ environment signals (OS, install method, terminal), a random machine identifier, the
120
+ platform a migration's users come from, and the workspace, app, and instance IDs of the
121
+ Clerk app a command acts on or the project is linked to. It doesn't collect raw command
122
+ arguments, option values, file paths, or personal data, with two exceptions. `clerk migrate`
123
+ reports its source as a built-in platform name or `custom`, and the IDs it acts on can come
124
+ from `--app` and `--instance`. `clerk feedback` sends the text you choose to send, and
125
+ scrubs it on a best-effort basis for common secret formats, home-directory paths, and email
126
+ addresses before it leaves your machine;
110
127
  `clerk feedback --dry-run` shows exactly what would be sent. The first run only shows a
111
128
  disclosure notice and sends nothing (CI environments send from the first run), except
112
129
  `clerk feedback`, which shows the notice and then sends the report you asked it to send
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clerk",
3
- "version": "4.2.1-canary.ea2cecc",
3
+ "version": "4.3.0",
4
4
  "description": "The official Clerk CLI. Add authentication to your app with npx -y clerk@latest init (Next.js, React Router, Astro, Nuxt, TanStack Start, Expo, and more). No Clerk account needed to start. Manage users, instances, keys, and deploys from the terminal or a coding agent.",
5
5
  "keywords": [
6
6
  "accountless",
@@ -42,13 +42,13 @@
42
42
  "node": ">=20.0.0"
43
43
  },
44
44
  "optionalDependencies": {
45
- "@clerk/cli-darwin-arm64": "4.2.1-canary.ea2cecc",
46
- "@clerk/cli-darwin-x64": "4.2.1-canary.ea2cecc",
47
- "@clerk/cli-linux-arm64": "4.2.1-canary.ea2cecc",
48
- "@clerk/cli-linux-arm64-musl": "4.2.1-canary.ea2cecc",
49
- "@clerk/cli-linux-x64": "4.2.1-canary.ea2cecc",
50
- "@clerk/cli-linux-x64-musl": "4.2.1-canary.ea2cecc",
51
- "@clerk/cli-win32-arm64": "4.2.1-canary.ea2cecc",
52
- "@clerk/cli-win32-x64": "4.2.1-canary.ea2cecc"
45
+ "@clerk/cli-darwin-arm64": "4.3.0",
46
+ "@clerk/cli-darwin-x64": "4.3.0",
47
+ "@clerk/cli-linux-arm64": "4.3.0",
48
+ "@clerk/cli-linux-arm64-musl": "4.3.0",
49
+ "@clerk/cli-linux-x64": "4.3.0",
50
+ "@clerk/cli-linux-x64-musl": "4.3.0",
51
+ "@clerk/cli-win32-arm64": "4.3.0",
52
+ "@clerk/cli-win32-x64": "4.3.0"
53
53
  }
54
54
  }