Pre-launch — Gluecron is in final validation. Public signups and git hosting for non-owner users open after launch review.
CodeIssuesDiscussionsWikiPull RequestsProjectsCommitsActionsReleasesContributorsPulse● GatesSecuritySettingsDeploymentsPipelineInsightsAgents✨ Explain✨ Ask AI✨ Workspace✨ Spec✨ Tests▓ Debt Map✨ NL Search🏛 Archaeology
claude/adoring-hopper-5x74bqclaude/affectionate-feynman-ykrf1hclaude/architecture-audit-design-wxprenclaude/build-status-update-3MXsfclaude/charming-meitner-mllb5rclaude/compare-gate-gluecron-s4mFQclaude/confident-faraday-tikcwbclaude/continue-work-XMTlIclaude/crontech-gluecron-deploy-7MIECclaude/crontech-platform-setup-SeKfwclaude/design-2026claude/ecstatic-ptolemy-jMdigclaude/enhance-github-integration-QNHdGclaude/fix-aa-loop-issue-PonMQclaude/fix-actions-and-processclaude/fix-desktop-errors-XqoW8claude/fix-red-workflowsclaude/fix-website-access-6FKJNclaude/gatetest-integration-hardeningclaude/github-audit-improvements-bDFr9claude/gluecron-launch-status-FoMRlclaude/hopeful-lamport-olfCTclaude/issue-to-pr-and-protectionsclaude/jolly-heisenberg-2sg1Qclaude/launch-preparation-QmTb6claude/new-session-xk1l7claude/plan-platform-architecture-kkN4yclaude/platform-analysis-roadmap-1nUGLclaude/platform-launch-assessment-8dWV8claude/polish-platform-release-AeDrUclaude/resume-previous-work-KzyLwclaude/review-crontech-handoff-qYEVqclaude/review-project-completeness-lHhS2claude/review-readme-docs-ulqPKclaude/serene-edison-rj87weclaude/setup-multi-repo-dev-BCwNQclaude/ship-fixes-and-tests-Jvz1cclaude/site-audit-competitive-pctlwgclaude/site-migration-vercel-XstpKclaude/standalone-product-repos-XHFTDcopilot/feat-smart-empty-states-keyboard-first-enhancementcopilot/feat-smart-morning-digest-review-context-restorecopilot/fix-and-process-workflowscopilot/update-ai-powered-code-reviewfeat/debt-mapfeat/push-policy-codeowners-hardeningfeat/smart-digest-contextfeat/stage-impactfeat/t1-secret-migrationfeat/u-polishfeat/w-self-hostfeat/w2-claude-configfix/agent-journey-orphan-sweepgatetest/auto-fix-1776586424172gatetest/auto-fix-1776586534814gatetest/auto-fix-1776590685143gatetest/auto-fix-1776590808199mainops/redeploy-retriggerstyle/dxt-cta-themeworktree-agent-a3377aad30d55da26worktree-agent-a7ef607b7ee1d6c74
email-verification.ts11.4 KB · 323 lines
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
/**
 * Block P2 — email verification + welcome email.
 *
 * Responsibilities:
 *   - Issue verification tokens (plaintext 32-byte hex, sha256-hashed at rest,
 *     24-hour expiry).
 *   - Consume tokens, marking `users.email_verified_at`.
 *   - Fire the welcome email AFTER a successful verification.
 *
 * Contract: every exported function never throws. Email failures degrade
 * silently — the caller's primary code path (registration, etc.) must not
 * be coupled to email-provider liveness.
 *
 * Test seam: a `__setEmailForTests` setter lets unit tests inject a recorder
 * in place of the live `sendEmail` import. Tests must restore the previous
 * sender in `afterAll` to keep the module graph clean.
 */

import { randomBytes, createHash } from "node:crypto";
import { and, eq, gt, isNull } from "drizzle-orm";
import { db } from "../db";
import { users, emailVerificationTokens } from "../db/schema";
import {
  sendEmail as realSendEmail,
  absoluteUrl,
  type EmailMessage,
  type EmailResult,
} from "./email";

// ---------------------------------------------------------------------------
// Test seam — swap the email sender out without touching the module graph.
// ---------------------------------------------------------------------------

type EmailSender = (msg: EmailMessage) => Promise<EmailResult>;
let _sender: EmailSender = realSendEmail;

/**
 * Swap the email sender for the duration of a test. Returns the previous
 * sender so the test can restore it in `afterAll`. Never call from prod.
 */
export function __setEmailForTests(fn: EmailSender): EmailSender {
  const prev = _sender;
  _sender = fn;
  return prev;
}

// ---------------------------------------------------------------------------
// Token generation
// ---------------------------------------------------------------------------

/** Token validity window. Tunable here; the migration enforces nothing. */
export const TOKEN_TTL_MS = 24 * 60 * 60 * 1000;

/**
 * Produce a fresh plaintext token + its sha256 hash. Only the hash is
 * persisted; the plaintext is delivered exactly once via email.
 */
export function generateVerificationToken(): {
  plaintext: string;
  hash: string;
} {
  const plaintext = randomBytes(32).toString("hex");
  const hash = hashToken(plaintext);
  return { plaintext, hash };
}

/** Stable hash for lookups. Public so tests can compute the same value. */
export function hashToken(plaintext: string): string {
  return createHash("sha256").update(plaintext).digest("hex");
}

// ---------------------------------------------------------------------------
// startEmailVerification
// ---------------------------------------------------------------------------

/**
 * Issue a fresh token for `userId` + `email` and send the verification email.
 * Fire-and-forget safe: never throws, returns `{ok}` so callers can audit
 * failures if they wish.
 */
export async function startEmailVerification(
  userId: string,
  email: string
): Promise<{ ok: boolean }> {
  try {
    const { plaintext, hash } = generateVerificationToken();
    const expiresAt = new Date(Date.now() + TOKEN_TTL_MS);
    await db.insert(emailVerificationTokens).values({
      userId,
      email,
      tokenHash: hash,
      expiresAt,
    });

    let username = "there";
    try {
      const [u] = await db
        .select({ username: users.username })
        .from(users)
        .where(eq(users.id, userId))
        .limit(1);
      if (u?.username) username = u.username;
    } catch {
      // username lookup is cosmetic.
    }

    const link = absoluteUrl(`/verify-email?token=${encodeURIComponent(plaintext)}`);
    const { subject, text, html } = renderVerificationEmail({ username, link });
    const result = await _sender({ to: email, subject, text, html });
    return { ok: result.ok };
  } catch (err) {
    console.error("[email-verification] startEmailVerification:", err);
    return { ok: false };
  }
}

// ---------------------------------------------------------------------------
// consumeVerificationToken
// ---------------------------------------------------------------------------

export async function consumeVerificationToken(
  token: string
): Promise<{ ok: boolean; userId?: string; email?: string }> {
  if (!token || typeof token !== "string") return { ok: false };
  try {
    const hash = hashToken(token);
    const now = new Date();
    const [row] = await db
      .select()
      .from(emailVerificationTokens)
      .where(
        and(
          eq(emailVerificationTokens.tokenHash, hash),
          isNull(emailVerificationTokens.usedAt),
          gt(emailVerificationTokens.expiresAt, now)
        )
      )
      .limit(1);
    if (!row) return { ok: false };

    await db
      .update(emailVerificationTokens)
      .set({ usedAt: now })
      .where(eq(emailVerificationTokens.id, row.id));

    await db
      .update(users)
      .set({ emailVerifiedAt: now })
      .where(eq(users.id, row.userId));

    return { ok: true, userId: row.userId, email: row.email };
  } catch (err) {
    console.error("[email-verification] consumeVerificationToken:", err);
    return { ok: false };
  }
}

// ---------------------------------------------------------------------------
// Welcome email — sent AFTER successful verification.
// ---------------------------------------------------------------------------

export async function sendWelcomeEmail(userId: string): Promise<void> {
  try {
    const [u] = await db
      .select({ username: users.username, email: users.email })
      .from(users)
      .where(eq(users.id, userId))
      .limit(1);
    if (!u || !u.email) return;
    const { subject, text, html } = renderWelcomeEmail({ username: u.username });
    await _sender({ to: u.email, subject, text, html });
  } catch (err) {
    console.error("[email-verification] sendWelcomeEmail:", err);
  }
}

// ---------------------------------------------------------------------------
// Email templates
// ---------------------------------------------------------------------------

function escapeHtml(s: string): string {
  return s
    .replace(/&/g, "&amp;")
    .replace(/</g, "&lt;")
    .replace(/>/g, "&gt;")
    .replace(/"/g, "&quot;")
    .replace(/'/g, "&#39;");
}

export function renderVerificationEmail(opts: {
  username: string;
  link: string;
}): { subject: string; text: string; html: string } {
  const u = opts.username;
  const link = opts.link;
  const subject = "Confirm your email for Gluecron";

  const text = [
    `Hi ${u},`,
    "",
    "Thanks for signing up for Gluecron — the git host built around Claude.",
    "",
    `Confirm your email: ${link}`,
    "",
    "This link expires in 24 hours. If you didn't sign up, ignore this email.",
  ].join("\n");

  const html = renderHtmlShell({
    title: "Confirm your email",
    heroSubtitle: "Welcome to Gluecron",
    heroLine: `Hi <strong>${escapeHtml(u)}</strong>, thanks for signing up.`,
    body: `
      <p style="margin:0 0 16px;font-size:14px;line-height:1.55;color:#c9d1d9">
        Gluecron is the git host built around Claude. Confirm your email
        address to finish setting up your account.
      </p>
      <p style="margin:0 0 24px;text-align:center">
        <a href="${escapeHtml(link)}"
           style="display:inline-block;padding:12px 24px;background:linear-gradient(135deg,#8c6dff 0%,#36c5d6 100%);color:#fff;text-decoration:none;border-radius:8px;font-weight:600;font-size:14px">
          Confirm email
        </a>
      </p>
      <p style="margin:0;font-size:12px;color:#8b949e;line-height:1.55">
        Or paste this link into your browser:<br />
        <span style="word-break:break-all">${escapeHtml(link)}</span>
      </p>
      <p style="margin:24px 0 0;font-size:12px;color:#8b949e">
        This link expires in 24 hours. If you didn't sign up for Gluecron,
        you can safely ignore this email.
      </p>
    `,
  });

  return { subject, text, html };
}

export function renderWelcomeEmail(opts: { username: string }): {
  subject: string;
  text: string;
  html: string;
} {
  const u = opts.username;
  const subject = "Welcome to Gluecron \u{1F389}";

  const newRepo = absoluteUrl("/new");
  const importUrl = absoluteUrl("/import");
  const demoUrl = absoluteUrl("/demo");
  const installUrl = absoluteUrl("/install");
  const onboarding = absoluteUrl("/onboarding");
  const docs = absoluteUrl("/docs");
  const help = absoluteUrl("/help");

  const text = [
    `Welcome aboard, ${u}!`,
    "",
    "Your email is verified. Here's what to try first:",
    "",
    `• Create your first repo — ${newRepo}`,
    `• Import from GitHub — ${importUrl}`,
    `• Watch Claude work — ${demoUrl}`,
    `• Install Claude Desktop integration — ${installUrl}`,
    "",
    `Next steps: ${onboarding}`,
    `Docs: ${docs}`,
    `Need help? Reply to this email or visit ${help}.`,
  ].join("\n");

  const html = renderHtmlShell({
    title: "Welcome to Gluecron",
    heroSubtitle: "You're in",
    heroLine: `Welcome aboard, <strong>${escapeHtml(u)}</strong>.`,
    body: `
      <p style="margin:0 0 16px;font-size:14px;line-height:1.55;color:#c9d1d9">
        Your email is verified. Here's what to try first:
      </p>
      <ul style="margin:0 0 24px;padding-left:18px;font-size:14px;line-height:1.7;color:#c9d1d9">
        <li><strong>Create your first repo</strong> &mdash;
          <a style="color:#79c0ff" href="${escapeHtml(newRepo)}">gluecron.com/new</a></li>
        <li><strong>Import from GitHub</strong> &mdash;
          <a style="color:#79c0ff" href="${escapeHtml(importUrl)}">gluecron.com/import</a></li>
        <li><strong>Watch Claude work</strong> &mdash;
          <a style="color:#79c0ff" href="${escapeHtml(demoUrl)}">gluecron.com/demo</a></li>
        <li><strong>Install Claude Desktop integration</strong> &mdash;
          <a style="color:#79c0ff" href="${escapeHtml(installUrl)}">gluecron.com/install</a></li>
      </ul>
      <p style="margin:0 0 8px;font-size:13px;color:#8b949e">
        New here? Start with the
        <a style="color:#79c0ff" href="${escapeHtml(onboarding)}">onboarding tour</a>
        or skim the <a style="color:#79c0ff" href="${escapeHtml(docs)}">docs</a>.
      </p>
      <p style="margin:0;font-size:13px;color:#8b949e">
        Need help? Reply to this email or visit
        <a style="color:#79c0ff" href="${escapeHtml(help)}">gluecron.com/help</a>.
      </p>
    `,
  });

  return { subject, text, html };
}

function renderHtmlShell(opts: {
  title: string;
  heroSubtitle: string;
  heroLine: string;
  body: string;
}): string {
  return [
    `<!doctype html><html><head><meta charset="utf-8" /><title>${escapeHtml(opts.title)}</title></head>`,
    `<body style="margin:0;padding:24px;background:#0d1117;font-family:system-ui,-apple-system,Segoe UI,sans-serif;color:#c9d1d9">`,
    `<div style="max-width:560px;margin:0 auto;background:#161b22;border:1px solid #30363d;border-radius:12px;overflow:hidden">`,
    `<div style="background:linear-gradient(135deg,#8c6dff 0%,#36c5d6 100%);color:#fff;padding:24px">`,
    `<div style="font-size:11px;letter-spacing:0.18em;text-transform:uppercase;opacity:0.85">${escapeHtml(opts.heroSubtitle)}</div>`,
    `<h1 style="margin:8px 0 0;font-size:22px;font-weight:600">${opts.heroLine}</h1>`,
    `</div>`,
    `<div style="padding:24px">`,
    opts.body,
    `</div>`,
    `<div style="padding:12px 24px;border-top:1px solid #30363d;background:#0d1117;color:#6e7681;font-size:11px;text-align:center">`,
    `Gluecron — the git host built around Claude.`,
    `</div>`,
    `</div></body></html>`,
  ].join("\n");
}