Waitlist

1. 1

   Read launch mode and validate payload

   Signup services use waitlist settings and payload schemas before accepting public submissions.

   Relevant Product code

   • src/features/waitlist/server/settings.ts
   • src/features/waitlist/server/signup/schemas/payload.ts
2. 2

   Persist signup state

   Signup persistence owns waitlist_signups writes and supports double opt-in state when enabled.

   Relevant Product code

   • src/features/waitlist/server/signup/persistence/signups.ts
   • src/features/waitlist/server/signup/services/double-opt-in.ts
3. 3

   Notify and track events

   Signup services queue notifications and analytics events after a valid public submission.

   Relevant Product code

   • src/features/waitlist/server/signup/services/notifications.ts
   • src/features/waitlist/server/signup/services/events.ts
4. 4

   Operate from admin views

   Admin services handle filtering, bulk status changes, exports, resend, conversion, and audit records.

   Relevant Product code

   • src/features/waitlist/server/signup-list-query.ts
   • src/features/waitlist/server/actions/bulk.ts
   • src/features/waitlist/server/audit.ts

Use this example as a starting point, then adapt it to your product's rules and configuration.

Public waitlist signup uses session and IP rate-limit keys before accepting submissions.

async function enforceWaitlistSignupRateLimit(params: {
  clientIp: string | null;
  sessionId: string | null;
  requestId: string;
  start: number;
}): Promise<WaitlistSignupServiceResult | null> {
  const ratePolicy = getRateLimitPolicy("waitlist_signup");
  const rateKey = buildRateLimitKey({
    prefix: ratePolicy.prefix,
    ip: params.clientIp,
    identifier: params.sessionId ?? "public",
  });
  const rateLimit = await checkRateLimit({
    key: rateKey,
    limit: ratePolicy.limit,
    windowSeconds: ratePolicy.windowSeconds,
  });

  if (rateLimit.allowed) {
    return null;
  }