peekable 0.2.0 → 0.4.0

package/README.md

@@ -13,11 +13,18 @@ npm install -g peekable
 ## First Run
 
 ```bash
-peekable register --name "Your Name" --email "you@example.com" --invite-code "your-invite-code"
+peekable register your-invite-code
 peekable init
 peekable create "My first review"
 ```
 
+Got your invite code some other way (support, a paid plan) and it isn't tied to an
+email on file? Use the legacy form:
+
+```bash
+peekable register --name "Your Name" --email "you@example.com" --invite-code "your-invite-code"
+```
+
 `peekable create` prints a session ID and share URL. Use the session ID with one
 of the publish commands below.
 

package/dist/command-error.js

@@ -25,9 +25,10 @@ export function getErrorMessage(err) {
             return getErrorMessage(err.cause);
         return err.message;
     }
+    // Neutralized under Early Access: the server no longer emits this code, but
+    // keep the branch inert-but-safe in case an old server still sends it.
     if (err instanceof ApiError && err.details.code === "trial_expired") {
-        const upgradeUrl = typeof err.details.upgrade_url === "string" ? err.details.upgrade_url : null;
-        return `Your Peekable trial has ended. Run \`peekable upgrade\` to keep pushing.${upgradeUrl ? ` Upgrade: ${upgradeUrl}` : ""}`;
+        return "This request was blocked. Run `peekable doctor` for details.";
     }
     if (err instanceof Error)
         return err.message;

package/dist/commands/doctor.js

@@ -198,14 +198,13 @@ export function formatDoctorReport(report) {
     return lines.join("\n");
 }
 function formatPlan(report) {
-    if (report.planState === "trial_registered")
-        return "trial — not activated";
-    if (report.planState === "trial_active") {
-        const days = report.daysRemaining ?? 0;
-        return `trial (${days} ${days === 1 ? "day" : "days"} left)`;
+    // trial* plan_states are all served for free during Early Access; collapse
+    // them to one display string and drop the upgrade nudge.
+    if (report.planState === "trial_registered"
+        || report.planState === "trial_active"
+        || report.planState === "trial_expired") {
+        return "early access";
     }
-    if (report.planState === "trial_expired")
-        return "trial expired — run `peekable upgrade`";
     if (report.planState === "paid")
         return "paid";
     return "free";

package/dist/commands/register.js

@@ -3,14 +3,29 @@ import { writeConfig, readConfig, DEFAULT_SERVER_URL } from "../config.js";
 import { apiNoAuth } from "../api.js";
 import { CommandFailure, printCommandError } from "../command-error.js";
 import { runWithTelemetry } from "../telemetry.js";
+const USAGE_FORMS = [
+    `  peekable register <code>`,
+    `  peekable register --name "Your Name" --email "you@example.com" --invite-code "your-invite-code"`,
+].join("\n");
 export const registerCommand = new Command("register")
     .description("Register for an API key")
-    .requiredOption("--name <name>", "Your display name")
-    .requiredOption("--email <email>", "Your email address")
+    .argument("[code]", "Invite code from your email")
+    .option("--name <name>", "Your display name")
+    .option("--email <email>", "Your email address")
     .option("--invite-code <code>", "Beta invite code")
     .option("--url <url>", "Server URL", DEFAULT_SERVER_URL)
     .option("--json", "Output JSON")
-    .action(async (opts) => {
+    .addHelpText("after", `
+Examples:
+  peekable register your-invite-code
+  peekable register --invite-code your-invite-code
+  peekable register --name "Your Name" --email "you@example.com" --invite-code "your-invite-code"
+
+The invite code may also come from PEEKABLE_INVITE_CODE. --email is required
+only when no invite code is given (or when your code needs an email on file,
+e.g. codes issued by support or paid checkout).
+`)
+    .action(async (code, opts) => {
     await runWithTelemetry("register", async () => {
         const existing = readConfig();
         if (existing) {
@@ -23,42 +38,68 @@ export const registerCommand = new Command("register")
             }
             throw new CommandFailure("Already registered.");
         }
+        const flagCode = typeof opts.inviteCode === "string" ? opts.inviteCode : undefined;
+        if (code && flagCode && code !== flagCode) {
+            const message = `Conflicting invite codes: got "${code}" positionally and "${flagCode}" via --invite-code. Pass the code once.`;
+            if (opts.json) {
+                console.log(JSON.stringify({ error: message }));
+            }
+            else {
+                console.error(message);
+            }
+            throw new CommandFailure("Conflicting invite codes.");
+        }
+        const inviteCode = code ?? flagCode ?? process.env.PEEKABLE_INVITE_CODE;
+        if (!inviteCode && !opts.email) {
+            const message = "An invite code or --email is required.";
+            if (opts.json) {
+                console.log(JSON.stringify({ error: message }));
+            }
+            else {
+                console.error(message);
+                console.error("");
+                console.error("Usage:");
+                console.error(USAGE_FORMS);
+            }
+            throw new CommandFailure("Missing invite code or email.");
+        }
         try {
-            const inviteCode = typeof opts.inviteCode === "string"
-                ? opts.inviteCode
-                : process.env.PEEKABLE_INVITE_CODE;
-            const body = {
-                name: opts.name,
-                email: opts.email,
-            };
-            if (inviteCode) {
+            const body = {};
+            if (opts.name)
+                body.name = opts.name;
+            if (opts.email)
+                body.email = opts.email;
+            if (inviteCode)
                 body.invite_code = inviteCode;
-            }
-            const data = await apiNoAuth(opts.url, "POST", "/register", {
-                ...body,
-            });
+            const data = await apiNoAuth(opts.url, "POST", "/register", body);
             writeConfig({
                 url: opts.url,
                 api_key: data.api_key,
-                name: opts.name,
+                name: data.name,
             });
             if (opts.json) {
                 console.log(JSON.stringify({
                     api_key: data.api_key,
                     url: opts.url,
-                    name: opts.name,
+                    name: data.name,
                     plan_state: data.plan_state ?? null,
                     trial_ends_at: data.trial_ends_at ?? null,
                     days_remaining: data.days_remaining ?? null,
                     invite_source: data.invite_source ?? null,
+                    email_masked: data.email_masked ?? null,
                 }));
             }
             else {
-                console.log(`Registered as ${opts.name}.`);
+                if (data.email_masked) {
+                    console.log(`Registered as ${data.name} (${data.email_masked}).`);
+                }
+                else {
+                    console.log(`Registered as ${data.name}.`);
+                }
                 console.log(`API key saved to ~/.peekable/config.json`);
                 console.log("Peekable CLI sends anonymous usage/failure telemetry to improve reliability. Opt out: PEEKABLE_NO_TELEMETRY=1");
                 if (data.invite_source === "trial") {
-                    console.log("Trial ready — 7 days start when you push your first real share. Run `peekable init`.");
+                    console.log("Ready — run `peekable init` to get started.");
                 }
                 else {
                     console.log(`\nNext step: run \`peekable init\` to complete setup.`);

package/dist/commands/upgrade.js

@@ -5,7 +5,7 @@ import { CommandFailure, printCommandError } from "../command-error.js";
 import { requireConfig } from "../config.js";
 import { runWithTelemetry } from "../telemetry.js";
 export const upgradeCommand = new Command("upgrade")
-    .description("Upgrade a Peekable trial through Stripe Checkout")
+    .description("Upgrade a paid Peekable account through Stripe Checkout")
     .option("--json", "Output JSON")
     .action(async (opts) => {
     await runWithTelemetry("upgrade", async () => {
@@ -25,6 +25,16 @@ export const upgradeCommand = new Command("upgrade")
             }
         }
         catch (err) {
+            if (err instanceof ApiError && err.details.code === "early_access_no_billing") {
+                const message = "Peekable is free during Early Access — nothing to upgrade yet.";
+                if (opts.json) {
+                    console.log(JSON.stringify({ error: message, code: "early_access_no_billing" }));
+                }
+                else {
+                    console.log(message);
+                }
+                return;
+            }
             if (!opts.json
                 && err instanceof ApiError
                 && (err.details.code === "billing_account_exists"

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "0.2.0";
+export declare const CLI_VERSION = "0.4.0";

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = "0.2.0";
+export const CLI_VERSION = "0.4.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peekable",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Share HTML mockups with collaborators — CLI for peekable-server",
   "bin": {