hearback 0.1.1 → 0.1.2

package/bin/hearback.js

@@ -279,15 +279,60 @@ function openBrowser(url) {
   }
 }
 
+/**
+ * Normalize any common GitHub repo reference to `"owner/repo"`.
+ * Accepts:
+ *   owner/repo
+ *   github.com/owner/repo
+ *   https://github.com/owner/repo(.git)?(/...)?
+ *   git@github.com:owner/repo.git
+ * Returns null if the input can't be parsed as a valid repo ref.
+ */
+function parseRepoInput(input) {
+  if (!input) return null;
+  let s = String(input).trim();
+  if (!s) return null;
+
+  // git@github.com:owner/repo(.git)
+  const sshMatch = s.match(/^git@github\.com:([^/\s]+)\/([^/\s]+?)(?:\.git)?\/?$/);
+  if (sshMatch) return `${sshMatch[1]}/${sshMatch[2]}`;
+
+  // Strip common URL prefixes
+  s = s.replace(/^https?:\/\//, '').replace(/^github\.com\//, '');
+
+  // Trim trailing slashes
+  s = s.replace(/\/+$/, '');
+
+  // Strip trailing .git
+  s = s.replace(/\.git$/, '');
+
+  // Keep only the first two path segments
+  const parts = s.split('/').filter(Boolean);
+  if (parts.length < 2) return null;
+  const [owner, repo] = parts;
+
+  // Minimal validity check on owner/repo
+  const valid = /^[A-Za-z0-9._-]+$/;
+  if (!valid.test(owner) || !valid.test(repo)) return null;
+
+  return `${owner}/${repo}`;
+}
+
 /**
  * Build a GitHub fine-grained token URL with as much pre-filled as possible.
- * Sadly GitHub does NOT support pre-filling permissions via URL params, but
- * we can pre-fill the name + description to save time.
+ * GitHub's template URL supports name/description/target_name/expires_in plus
+ * a subset of permissions (we need issues + contents read/write).
+ * Note: fine-grained tokens with read-write permissions max out at 90 days.
  */
-function buildTokenUrl(repoName) {
+function buildTokenUrl(repoFullName) {
+  const [owner, name] = repoFullName.split('/');
   const params = new URLSearchParams({
-    name: `hearback-${repoName.split('/').pop()}`,
+    name: `hearback-${name}`,
     description: 'Token for hearback feedback widget',
+    target_name: owner,
+    expires_in: '90',
+    contents: 'write',
+    issues: 'write',
   });
   return `https://github.com/settings/personal-access-tokens/new?${params}`;
 }
@@ -319,10 +364,40 @@ function detectProject(cwd) {
 const NEXTJS_ROUTE = `import { NextRequest, NextResponse } from 'next/server';
 import { createFeedbackHandler } from 'hearback-server';
 
+// Auto-detect LLM provider from env — falls through to Form mode if none set.
+const llmConfig = (() => {
+  if (process.env.OPENAI_API_KEY) {
+    return { apiKey: process.env.OPENAI_API_KEY };
+  }
+  if (process.env.ANTHROPIC_API_KEY) {
+    return {
+      apiKey: process.env.ANTHROPIC_API_KEY,
+      baseUrl: 'https://api.anthropic.com/v1',
+      model: 'claude-sonnet-4-6',
+    };
+  }
+  if (process.env.OPENROUTER_API_KEY) {
+    return {
+      apiKey: process.env.OPENROUTER_API_KEY,
+      baseUrl: 'https://openrouter.ai/api/v1',
+      model: 'moonshotai/kimi-k2',
+    };
+  }
+  // Escape hatch: custom OpenAI-compatible provider
+  if (process.env.LLM_API_KEY) {
+    return {
+      apiKey: process.env.LLM_API_KEY,
+      baseUrl: process.env.LLM_BASE_URL,
+      model: process.env.LLM_MODEL,
+    };
+  }
+  return undefined;
+})();
+
 const handler = createFeedbackHandler({
   repo: process.env.FEEDBACK_REPO!,
   githubToken: process.env.GITHUB_TOKEN!,
-  llm: process.env.OPENAI_API_KEY ? { apiKey: process.env.OPENAI_API_KEY } : undefined,
+  llm: llmConfig,
 });
 
 async function handleRequest(req: NextRequest) {
@@ -426,9 +501,19 @@ ${BOLD}Usage:${RESET}
 
   // Step 2: Collect info
   step(2, 'Configuration');
-  const repo = await ask('GitHub repo for issues (owner/name):');
-  if (!repo || !repo.includes('/')) {
-    warn('Invalid repo format. Expected: owner/name');
+  let repo = null;
+  for (let attempt = 0; attempt < 3 && !repo; attempt++) {
+    const raw = await ask('GitHub repo for issues (owner/name or URL):');
+    repo = parseRepoInput(raw);
+    if (!repo) {
+      warn('Could not parse that. Examples:');
+      info('  owner/repo');
+      info('  https://github.com/owner/repo');
+      info('  git@github.com:owner/repo.git');
+    }
+  }
+  if (!repo) {
+    warn('Giving up after 3 invalid entries. Re-run when ready.');
     process.exit(1);
   }
 
@@ -576,14 +661,14 @@ ${BOLD}Usage:${RESET}
 
     if (!token && (choice === '2' || choice === '1')) {
       const url = buildTokenUrl(repo);
-      info('Opening GitHub in your browser...');
-      info(`If it does not open, paste this URL manually:`);
-      log(`  ${DIM}${url}${RESET}`);
       log('');
-      info(`Set these permissions:`);
-      log(`  ${DIM}- Repository access: Only select repositories → ${repo}${RESET}`);
-      log(`  ${DIM}- Permissions → Issues: Read and write${RESET}`);
-      log(`  ${DIM}- Permissions → Contents: Read and write (for screenshots)${RESET}`);
+      log(`  ${BOLD}Opening GitHub. Three things:${RESET}`);
+      log(`    1. Click "Only select repositories" → pick ${repo}`);
+      log(`    2. Click "Generate token"`);
+      log(`    3. Copy the token back here`);
+      log('');
+      info(`If the browser does not open, paste this URL manually:`);
+      log(`  ${DIM}${url}${RESET}`);
       log('');
       openBrowser(url);
       token = (await ask('Paste your token (starts with github_pat_...):')).trim();
@@ -609,9 +694,19 @@ ${BOLD}Usage:${RESET}
     }
   }
 
-  if (newVars.length > 0) {
-    const addition = '\n# hearback\n' + newVars.join('\n') + '\n';
-    writeFileSync(envPath, envContent + addition);
+  // Hint at LLM keys — widget auto-detects and flips to Chat mode if any is set.
+  const hasAnyLlmKey = /(?:^|\n)\s*(?:OPENAI|ANTHROPIC|OPENROUTER|LLM)_API_KEY=/m.test(envContent);
+  const llmCommentBlock = !hasAnyLlmKey ? [
+    '',
+    '# Optional: uncomment one to auto-enable AI chat mode',
+    '# OPENAI_API_KEY=',
+    '# ANTHROPIC_API_KEY=',
+    '# OPENROUTER_API_KEY=',
+  ] : [];
+
+  if (newVars.length > 0 || llmCommentBlock.length > 0) {
+    const lines = ['', '# hearback', ...newVars, ...llmCommentBlock, ''];
+    writeFileSync(envPath, envContent + lines.join('\n'));
     done(token ? `Wrote FEEDBACK_REPO + GITHUB_TOKEN to ${envFile}` : `Wrote FEEDBACK_REPO to ${envFile}`);
   }
 
@@ -633,11 +728,17 @@ ${BOLD}Usage:${RESET}
   log(`${DIM}Next steps:`);
   if (!token && !hasExistingToken) {
     log(`  1. Add your GITHUB_TOKEN to ${envFile}`);
-    log(`  2. Run your dev server and test the feedback button${RESET}\n`);
+    log(`  2. Run your dev server and test the feedback button${RESET}`);
   } else {
     log(`  1. Run your dev server (e.g. npm run dev / bun dev)`);
-    log(`  2. Look for the feedback button in the bottom-right corner${RESET}\n`);
+    log(`  2. Look for the feedback button in the bottom-right corner${RESET}`);
   }
+  log('');
+  log(`${DIM}Deploying to production?`);
+  log(`  • Add FEEDBACK_REPO and GITHUB_TOKEN to your platform's env`);
+  log(`    (Vercel/Netlify/Docker — whatever you use)`);
+  log(`  • Optionally add OPENAI_API_KEY/ANTHROPIC_API_KEY/OPENROUTER_API_KEY`);
+  log(`    to enable AI chat mode in production${RESET}\n`);
 }
 
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hearback",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Add user feedback → GitHub Issues → email notification loop to any product with one command. Works with Next.js, Express, Hono, and AI agents.",
   "type": "module",
   "bin": {