test: add E2E tests for login, logout, whoami, and init commands

Introduces a real E2E test infrastructure that authenticates against
Prismic, creates a temporary repository per test run, and exercises
the CLI binary directly. Adds --no-browser flag for headless login
flows and a MODE=test build mode to disable telemetry during tests.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: angeloashmore

.env.test.example

@@ -0,0 +1,9 @@
+###############################################################################
+# The following environment variables are used to run tests.
+# Create a specific account for testing to avoid issues.
+###############################################################################
+
+# The email address for your Prismic account.
+E2E_PRISMIC_EMAIL=
+# The password to your Prismic account.
+E2E_PRISMIC_PASSWORD=

.github/workflows/prerelease-canary.yml

@@ -13,6 +13,8 @@ jobs:
   publish:
     if: github.repository_owner == 'prismicio'
     runs-on: ubuntu-latest
+    env:
+      MODE: production
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6

.github/workflows/prerelease-pr.yml

@@ -11,6 +11,8 @@ jobs:
   publish:
     if: github.repository_owner == 'prismicio'
     runs-on: ubuntu-latest
+    env:
+      MODE: production
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6

.github/workflows/release.yml

@@ -14,6 +14,8 @@ on:
 jobs:
   release-please:
     runs-on: ubuntu-latest
+    env:
+      MODE: production
     steps:
       - uses: googleapis/release-please-action@v4
         id: release

.github/workflows/validate.yml

@@ -16,6 +16,8 @@ jobs:
 
   build:
     runs-on: ubuntu-latest
+    env:
+      MODE: production
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6

package-lock.json

@@ -30,9 +30,9 @@
 		"prepare": "npm run build",
 		"lint": "oxlint --deny-warnings",
 		"types": "tsc --noEmit",
-		"unit": "vitest run --coverage",
+		"unit": "MODE=test tsdown --logLevel=silent && vitest run --coverage",
 		"unit:watch": "vitest watch",
-		"test": "npm run lint && npm run types && npm run unit && npm run build"
+		"test": "npm run lint && npm run types && npm run unit"
 	},
 	"devDependencies": {
 		"@prismicio/types-internal": "3.16.1",
@@ -46,20 +46,21 @@
 		"oxfmt": "^0.24.0",
 		"oxlint": "1.39.0",
 		"prismic-ts-codegen": "^0.1.28",
+		"tinyexec": "^1.0.2",
 		"tinyglobby": "^0.2.15",
 		"tsdown": "0.19.0",
 		"typescript": "5.9.3",
 		"vitest": "4.0.17",
 		"zod": "^4.3.6"
 	},
-	"engines": {
-		"node": ">=20"
-	},
 	"devEngines": {
 		"runtime": {
 			"name": "node",
 			"version": ">=24",
 			"onFail": "warn"
 		}
+	},
+	"engines": {
+		"node": ">=20"
 	}
 }

package.json

@@ -28,6 +28,7 @@ USAGE
 
 FLAGS
   -r, --repo string   Repository name
+      --no-browser     Skip opening the browser automatically during login
   -h, --help          Show help for command
 
 EXAMPLES
@@ -43,6 +44,7 @@ export async function init(): Promise<void> {
 		options: {
 			help: { type: "boolean", short: "h" },
 			repo: { type: "string", short: "r" },
+			"no-browser": { type: "boolean" },
 		},
 	});
 
@@ -87,9 +89,13 @@ export async function init(): Promise<void> {
 			console.info("Not logged in. Starting login...");
 			const { email } = await createLoginSession({
 				onReady: (url) => {
-					console.info("Opening browser to complete login...");
-					console.info(`If the browser doesn't open, visit: ${url}`);
-					openBrowser(url);
+					if (values["no-browser"]) {
+						console.info(`Open this URL to log in: ${url}`);
+					} else {
+						console.info("Opening browser to complete login...");
+						console.info(`If the browser doesn't open, visit: ${url}`);
+						openBrowser(url);
+					}
 				},
 			});
 			console.info(`Logged in as ${email}`);

src/commands/init.ts

@@ -10,7 +10,8 @@ USAGE
   prismic login [flags]
 
 FLAGS
-  -h, --help   Show help for command
+      --no-browser   Skip opening the browser automatically
+  -h, --help         Show help for command
 
 LEARN MORE
   Use \`prismic <command> --help\` for more information about a command.
@@ -19,7 +20,10 @@ LEARN MORE
 export async function login(): Promise<void> {
 	const { values } = parseArgs({
 		args: process.argv.slice(3),
-		options: { help: { type: "boolean", short: "h" } },
+		options: {
+			help: { type: "boolean", short: "h" },
+			"no-browser": { type: "boolean" },
+		},
 	});
 
 	if (values.help) {
@@ -29,9 +33,13 @@ export async function login(): Promise<void> {
 
 	const { email } = await createLoginSession({
 		onReady: (url) => {
-			console.info("Opening browser to complete login...");
-			console.info(`If the browser doesn't open, visit: ${url}`);
-			openBrowser(url);
+			if (values["no-browser"]) {
+				console.info(`Open this URL to log in: ${url}`);
+			} else {
+				console.info("Opening browser to complete login...");
+				console.info(`If the browser doesn't open, visit: ${url}`);
+				openBrowser(url);
+			}
 		},
 	});
 

src/commands/login.ts

@@ -7,15 +7,17 @@ const Env = z.object({
 	MODE: z.string(),
 	DEV: z.stringbool(),
 	PROD: z.stringbool(),
+	TEST: z.stringbool(),
 	PRISMIC_SENTRY_DSN: z._default(z.httpUrl(), DEFAULT_PRISMIC_SENTRY_DSN),
 	PRISMIC_SENTRY_ENVIRONMENT: z.optional(z.string()),
 	PRISMIC_SENTRY_ENABLED: z.optional(z.stringbool()),
 	PRISMIC_HOST: z.optional(z.string()),
 });
 
 export const env = z.parse(Env, {
-	MODE: process.env.MODE,
-	DEV: JSON.stringify(process.env.MODE !== "production"),
-	PROD: JSON.stringify(process.env.MODE === "production"),
 	...process.env,
+	MODE: process.env.MODE,
+	DEV: process.env.DEV,
+	PROD: process.env.PROD,
+	TEST: process.env.TEST,
 });