@ucptools/validator 1.0.0 → 1.1.0

package/dist/services/stripe.js

@@ -0,0 +1,490 @@
+"use strict";
+/**
+ * Stripe Service
+ * Handles all Stripe-related operations including:
+ * - Checkout session creation
+ * - Subscription management
+ * - Customer portal
+ * - Webhook events
+ * Production deployment ready
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STRIPE_PRICE_IDS = exports.stripe = void 0;
+exports.getStripe = getStripe;
+exports.priceIdToTier = priceIdToTier;
+exports.createCheckoutSession = createCheckoutSession;
+exports.createCustomerPortalSession = createCustomerPortalSession;
+exports.startTrialWithoutPayment = startTrialWithoutPayment;
+exports.handleWebhookEvent = handleWebhookEvent;
+exports.verifyWebhookSignature = verifyWebhookSignature;
+exports.getSubscriptionDetails = getSubscriptionDetails;
+exports.cancelSubscription = cancelSubscription;
+exports.resumeSubscription = resumeSubscription;
+exports.updateSubscription = updateSubscription;
+const stripe_1 = __importDefault(require("stripe"));
+const index_js_1 = require("../db/index.js");
+const utils_js_1 = require("../db/utils.js");
+const email_js_1 = require("./email.js");
+const notifications_js_1 = require("./notifications.js");
+const drizzle_orm_1 = require("drizzle-orm");
+// Initialize Stripe lazily to avoid crashing on startup
+// Use test keys in development, production keys in production
+const isProduction = process.env.NODE_ENV === 'production';
+const stripeSecretKey = isProduction
+    ? process.env.STRIPE_SECRET_KEY
+    : (process.env.STRIPE_TEST_SECRET_KEY || process.env.STRIPE_SECRET_KEY);
+// Log Stripe mode on startup
+console.log(`[Stripe] Mode: ${isProduction ? 'PRODUCTION' : 'TEST'}`);
+console.log(`[Stripe] Secret key present: ${!!stripeSecretKey}`);
+console.log(`[Stripe] Key starts with: ${stripeSecretKey?.substring(0, 7) || 'NONE'}`);
+let stripeInstance = null;
+/**
+ * Get the Stripe instance, throwing an error if not configured.
+ * This allows the app to start even without Stripe keys,
+ * failing only when Stripe features are actually used.
+ */
+function getStripe() {
+    if (!stripeInstance) {
+        if (!stripeSecretKey) {
+            throw new Error('STRIPE_SECRET_KEY environment variable is required for payment features');
+        }
+        stripeInstance = new stripe_1.default(stripeSecretKey, {});
+    }
+    return stripeInstance;
+}
+// Legacy export for backward compatibility - lazy getter
+exports.stripe = new Proxy({}, {
+    get(_, prop) {
+        return getStripe()[prop];
+    }
+});
+// Stripe Price IDs (to be set from environment or config)
+// Use test price IDs in development, production price IDs in production
+const isProductionEnv = process.env.NODE_ENV === 'production';
+exports.STRIPE_PRICE_IDS = {
+    // Starter tier ($9/mo)
+    starter_monthly: isProductionEnv
+        ? (process.env.STRIPE_PRICE_STARTER_MONTHLY || 'price_starter_monthly')
+        : (process.env.STRIPE_TEST_PRICE_STARTER_MONTHLY || process.env.STRIPE_PRICE_STARTER_MONTHLY || 'price_starter_monthly'),
+    starter_annual: isProductionEnv
+        ? (process.env.STRIPE_PRICE_STARTER_ANNUAL || 'price_starter_annual')
+        : (process.env.STRIPE_TEST_PRICE_STARTER_ANNUAL || process.env.STRIPE_PRICE_STARTER_ANNUAL || 'price_starter_annual'),
+    // Pro tier ($19/mo) - ready for future use
+    pro_monthly: isProductionEnv
+        ? (process.env.STRIPE_PRICE_PRO_MONTHLY || 'price_pro_monthly')
+        : (process.env.STRIPE_TEST_PRICE_PRO_MONTHLY || process.env.STRIPE_PRICE_PRO_MONTHLY || 'price_pro_monthly'),
+    pro_annual: isProductionEnv
+        ? (process.env.STRIPE_PRICE_PRO_ANNUAL || 'price_pro_annual')
+        : (process.env.STRIPE_TEST_PRICE_PRO_ANNUAL || process.env.STRIPE_PRICE_PRO_ANNUAL || 'price_pro_annual'),
+    // Business tier ($49/mo) - deferred until traction
+    business_monthly: isProductionEnv
+        ? (process.env.STRIPE_PRICE_BUSINESS_MONTHLY || 'price_business_monthly')
+        : (process.env.STRIPE_TEST_PRICE_BUSINESS_MONTHLY || process.env.STRIPE_PRICE_BUSINESS_MONTHLY || 'price_business_monthly'),
+    business_annual: isProductionEnv
+        ? (process.env.STRIPE_PRICE_BUSINESS_ANNUAL || 'price_business_annual')
+        : (process.env.STRIPE_TEST_PRICE_BUSINESS_ANNUAL || process.env.STRIPE_PRICE_BUSINESS_ANNUAL || 'price_business_annual'),
+};
+// Log price IDs on startup
+console.log(`[Stripe] Price IDs:`, {
+    starter_monthly: exports.STRIPE_PRICE_IDS.starter_monthly,
+    starter_annual: exports.STRIPE_PRICE_IDS.starter_annual,
+    pro_monthly: exports.STRIPE_PRICE_IDS.pro_monthly,
+    pro_annual: exports.STRIPE_PRICE_IDS.pro_annual,
+});
+/**
+ * Map Stripe price ID to subscription tier
+ */
+function priceIdToTier(priceId) {
+    // Check business tier first (most specific)
+    const businessPrices = [
+        exports.STRIPE_PRICE_IDS.business_monthly,
+        exports.STRIPE_PRICE_IDS.business_annual,
+    ];
+    if (businessPrices.includes(priceId) || priceId.includes('business')) {
+        return 'business';
+    }
+    // Check pro tier
+    const proPrices = [
+        exports.STRIPE_PRICE_IDS.pro_monthly,
+        exports.STRIPE_PRICE_IDS.pro_annual,
+    ];
+    if (proPrices.includes(priceId) || priceId.includes('pro')) {
+        return 'pro';
+    }
+    // Check starter tier
+    const starterPrices = [
+        exports.STRIPE_PRICE_IDS.starter_monthly,
+        exports.STRIPE_PRICE_IDS.starter_annual,
+    ];
+    if (starterPrices.includes(priceId) || priceId.includes('starter')) {
+        return 'starter';
+    }
+    return 'free';
+}
+/**
+ * Create a Stripe checkout session for a new subscription
+ */
+async function createCheckoutSession(params) {
+    const { userId, userEmail, priceId, successUrl, cancelUrl, trialDays } = params;
+    // Create or retrieve Stripe customer
+    const customers = await exports.stripe.customers.list({
+        email: userEmail,
+        limit: 1,
+    });
+    let customerId;
+    if (customers.data.length > 0) {
+        customerId = customers.data[0].id;
+    }
+    else {
+        const customer = await exports.stripe.customers.create({
+            email: userEmail,
+            metadata: {
+                userId,
+            },
+        });
+        customerId = customer.id;
+    }
+    // Create checkout session
+    const sessionParams = {
+        customer: customerId,
+        mode: 'subscription',
+        payment_method_types: ['card'],
+        locale: 'en', // Force English locale for international users
+        line_items: [
+            {
+                price: priceId,
+                quantity: 1,
+            },
+        ],
+        success_url: successUrl,
+        cancel_url: cancelUrl,
+        metadata: {
+            userId,
+        },
+        subscription_data: {
+            metadata: {
+                userId,
+            },
+        },
+    };
+    // Add trial period if specified
+    if (trialDays && trialDays > 0) {
+        sessionParams.subscription_data = {
+            ...sessionParams.subscription_data,
+            trial_period_days: trialDays,
+        };
+    }
+    return await exports.stripe.checkout.sessions.create(sessionParams);
+}
+/**
+ * Create a customer portal session for managing subscription
+ */
+async function createCustomerPortalSession(params) {
+    const { customerId, returnUrl } = params;
+    return await exports.stripe.billingPortal.sessions.create({
+        customer: customerId,
+        return_url: returnUrl,
+        locale: 'en', // Force English locale for portal
+    });
+}
+/**
+ * Start a free trial without requiring a credit card
+ * Creates a Stripe customer for future conversion, and a local subscription record
+ *
+ * @param userId - The user's ID in our database
+ * @param userEmail - The user's email address
+ * @param userName - Optional user name
+ * @param trialDays - Number of trial days (default 7)
+ * @returns The created Stripe customer ID and trial end date
+ */
+async function startTrialWithoutPayment(params) {
+    const { userId, userEmail, userName, trialDays = 7 } = params;
+    const db = (0, index_js_1.getDb)();
+    // Check if customer already exists in Stripe
+    const existingCustomers = await exports.stripe.customers.list({
+        email: userEmail,
+        limit: 1,
+    });
+    let customerId;
+    if (existingCustomers.data.length > 0) {
+        customerId = existingCustomers.data[0].id;
+    }
+    else {
+        // Create new Stripe customer (no payment method required)
+        const customer = await exports.stripe.customers.create({
+            email: userEmail,
+            name: userName || undefined,
+            metadata: {
+                userId,
+            },
+        });
+        customerId = customer.id;
+    }
+    // Calculate trial end date
+    const trialEndsAt = new Date();
+    trialEndsAt.setDate(trialEndsAt.getDate() + trialDays);
+    // Update or create subscription in our database
+    await (0, utils_js_1.upsertSubscription)({
+        userId,
+        stripeSubscriptionId: null, // No Stripe subscription yet - will be created when they add payment
+        tier: 'starter',
+        status: 'trialing',
+        currentPeriodEnd: trialEndsAt,
+    });
+    // Update user with Stripe customer ID
+    await db.update(index_js_1.users)
+        .set({
+        stripeCustomerId: customerId,
+        updatedAt: new Date(),
+    })
+        .where((0, drizzle_orm_1.eq)(index_js_1.users.id, userId));
+    console.log(`[Stripe] Started trial for user ${userId} (customer: ${customerId}), ends: ${trialEndsAt.toISOString()}`);
+    return { customerId, trialEndsAt };
+}
+/**
+ * Handle Stripe webhook events
+ */
+async function handleWebhookEvent(event) {
+    const db = (0, index_js_1.getDb)();
+    switch (event.type) {
+        case 'checkout.session.completed': {
+            const session = event.data.object;
+            await handleCheckoutCompleted(session);
+            break;
+        }
+        case 'customer.subscription.created': {
+            const subscription = event.data.object;
+            await handleSubscriptionChange(subscription, true);
+            break;
+        }
+        case 'customer.subscription.updated': {
+            const subscription = event.data.object;
+            await handleSubscriptionChange(subscription, false);
+            break;
+        }
+        case 'customer.subscription.deleted': {
+            const subscription = event.data.object;
+            await handleSubscriptionDeleted(subscription);
+            break;
+        }
+        case 'invoice.paid': {
+            const invoice = event.data.object;
+            await handleInvoicePaid(invoice);
+            break;
+        }
+        case 'invoice.payment_failed': {
+            const invoice = event.data.object;
+            await handleInvoicePaymentFailed(invoice);
+            break;
+        }
+        default:
+            console.log(`Unhandled event type: ${event.type}`);
+    }
+}
+/**
+ * Handle checkout.session.completed event
+ */
+async function handleCheckoutCompleted(session) {
+    const userId = session.metadata?.userId;
+    if (!userId) {
+        console.error('No userId in session metadata');
+        return;
+    }
+    // Update user's Stripe customer ID if not already set
+    if (session.customer && typeof session.customer === 'string') {
+        const db = (0, index_js_1.getDb)();
+        // TODO: Update user's stripeCustomerId in database
+        // For now, the customer ID is available in session.customer
+    }
+    // The subscription will be created via customer.subscription.created event
+    console.log(`Checkout completed for user ${userId}`);
+}
+/**
+ * Handle subscription created/updated events
+ */
+async function handleSubscriptionChange(subscription, isNew = false) {
+    const userId = subscription.metadata?.userId;
+    if (!userId) {
+        console.error('No userId in subscription metadata');
+        return;
+    }
+    // Get the price ID from the subscription
+    const firstItem = subscription.items.data[0];
+    const priceId = firstItem?.price.id;
+    if (!priceId) {
+        console.error('No price ID in subscription');
+        return;
+    }
+    // Determine tier from price ID
+    const tier = priceIdToTier(priceId);
+    // Determine status
+    let status;
+    switch (subscription.status) {
+        case 'active':
+            status = 'active';
+            break;
+        case 'canceled':
+        case 'unpaid':
+            status = 'canceled';
+            break;
+        case 'past_due':
+            status = 'past_due';
+            break;
+        case 'trialing':
+            status = 'trialing';
+            break;
+        default:
+            status = 'active';
+    }
+    // Get current_period_end - check subscription root first, then items (API version compatibility)
+    const currentPeriodEndTimestamp = subscription.current_period_end
+        ?? firstItem?.current_period_end;
+    if (!currentPeriodEndTimestamp) {
+        console.error('No current_period_end found in subscription or items');
+        return;
+    }
+    // Upsert subscription in database
+    await (0, utils_js_1.upsertSubscription)({
+        userId,
+        tier,
+        status,
+        stripeSubscriptionId: subscription.id,
+        stripePriceId: priceId,
+        currentPeriodEnd: new Date(currentPeriodEndTimestamp * 1000),
+    });
+    console.log(`Subscription ${subscription.status} for user ${userId}, tier: ${tier}`);
+    // Send welcome email for new subscriptions (not updates)
+    if (isNew && tier !== 'free') {
+        try {
+            const db = (0, index_js_1.getDb)();
+            const [user] = await db.select().from(index_js_1.users).where((0, drizzle_orm_1.eq)(index_js_1.users.id, userId)).limit(1);
+            if (user) {
+                const baseUrl = process.env.NEXT_PUBLIC_APP_URL || 'https://ucptools.dev';
+                await (0, email_js_1.sendWelcomeEmail)({
+                    to: {
+                        email: user.email,
+                        name: user.name || undefined,
+                    },
+                    dashboardUrl: `${baseUrl}/dashboard`,
+                });
+                console.log(`Welcome email sent to ${user.email}`);
+                // Send Slack notification for new signup (fire-and-forget)
+                (0, notifications_js_1.notifySignup)({ id: userId, email: user.email, name: user.name }, { tier, status });
+            }
+        }
+        catch (error) {
+            console.error('Failed to send welcome email:', error);
+            // Don't throw - welcome email failure shouldn't break subscription flow
+        }
+    }
+}
+/**
+ * Handle subscription deleted event
+ */
+async function handleSubscriptionDeleted(subscription) {
+    const userId = subscription.metadata?.userId;
+    if (!userId) {
+        console.error('No userId in subscription metadata');
+        return;
+    }
+    // Get current_period_end - check subscription root first, then items (API version compatibility)
+    const firstItem = subscription.items.data[0];
+    const currentPeriodEndTimestamp = subscription.current_period_end
+        ?? firstItem?.current_period_end;
+    // Update subscription to canceled and downgrade to free
+    await (0, utils_js_1.upsertSubscription)({
+        userId,
+        tier: 'free',
+        status: 'canceled',
+        stripeSubscriptionId: subscription.id,
+        currentPeriodEnd: currentPeriodEndTimestamp ? new Date(currentPeriodEndTimestamp * 1000) : new Date(),
+    });
+    console.log(`Subscription canceled for user ${userId}, downgraded to free`);
+}
+/**
+ * Handle invoice.paid event
+ */
+async function handleInvoicePaid(invoice) {
+    const subscriptionId = invoice.subscription;
+    if (!subscriptionId || typeof subscriptionId !== 'string') {
+        return;
+    }
+    // Retrieve subscription to update status
+    const subscription = await exports.stripe.subscriptions.retrieve(subscriptionId);
+    await handleSubscriptionChange(subscription);
+    console.log(`Invoice paid for subscription ${subscriptionId}`);
+}
+/**
+ * Handle invoice.payment_failed event
+ */
+async function handleInvoicePaymentFailed(invoice) {
+    const subscriptionId = invoice.subscription;
+    if (!subscriptionId || typeof subscriptionId !== 'string') {
+        return;
+    }
+    const userId = invoice.subscription_details?.metadata?.userId;
+    if (!userId) {
+        console.error('No userId in invoice metadata');
+        return;
+    }
+    // Update subscription status to past_due
+    await (0, utils_js_1.upsertSubscription)({
+        userId,
+        status: 'past_due',
+    });
+    console.log(`Payment failed for subscription ${subscriptionId}, user ${userId}`);
+    // TODO: Send email notification to user
+}
+/**
+ * Verify Stripe webhook signature
+ */
+function verifyWebhookSignature(payload, signature, secret) {
+    return exports.stripe.webhooks.constructEvent(payload, signature, secret);
+}
+/**
+ * Get subscription details for a user
+ */
+async function getSubscriptionDetails(stripeSubscriptionId) {
+    try {
+        return await exports.stripe.subscriptions.retrieve(stripeSubscriptionId);
+    }
+    catch (error) {
+        console.error('Error retrieving subscription:', error);
+        return null;
+    }
+}
+/**
+ * Cancel a subscription at period end
+ */
+async function cancelSubscription(stripeSubscriptionId) {
+    return await exports.stripe.subscriptions.update(stripeSubscriptionId, {
+        cancel_at_period_end: true,
+    });
+}
+/**
+ * Resume a canceled subscription
+ */
+async function resumeSubscription(stripeSubscriptionId) {
+    return await exports.stripe.subscriptions.update(stripeSubscriptionId, {
+        cancel_at_period_end: false,
+    });
+}
+/**
+ * Update subscription to a new price (upgrade/downgrade)
+ */
+async function updateSubscription(stripeSubscriptionId, newPriceId) {
+    const subscription = await exports.stripe.subscriptions.retrieve(stripeSubscriptionId);
+    return await exports.stripe.subscriptions.update(stripeSubscriptionId, {
+        items: [
+            {
+                id: subscription.items.data[0].id,
+                price: newPriceId,
+            },
+        ],
+        proration_behavior: 'always_invoice',
+    });
+}
+//# sourceMappingURL=stripe.js.map

package/dist/services/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../src/services/stripe.ts"],"names":[],"mappings":"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"}

package/dist/services/validation-history.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Validation History Service
+ *
+ * Manages storage and retrieval of validation history for domains.
+ * Supports both authenticated users (via monitoredDomains) and
+ * anonymous public access (with limited history).
+ */
+import { type ValidationResult } from './validation.js';
+export interface ValidationHistoryEntry {
+    id: string;
+    domainId: string;
+    score: number | null;
+    grade: string | null;
+    hasUcp: boolean | null;
+    issuesCount: number | null;
+    errorsCount: number | null;
+    warningsCount: number | null;
+    validatedAt: Date;
+}
+export interface ValidationTrend {
+    direction: 'improving' | 'declining' | 'stable' | 'insufficient_data';
+    scoreChange: number;
+    periodDays: number;
+    dataPoints: number;
+}
+export interface DomainHistoryResult {
+    domain: string;
+    currentScore: number | null;
+    currentGrade: string | null;
+    trend: ValidationTrend;
+    history: ValidationHistoryEntry[];
+    lastValidatedAt: Date | null;
+}
+export interface PublicHistoryResult {
+    domain: string;
+    history: Array<{
+        score: number | null;
+        grade: string | null;
+        hasUcp: boolean | null;
+        validatedAt: Date;
+    }>;
+    trend: ValidationTrend;
+    limitedAccess: boolean;
+    message?: string;
+}
+/**
+ * Store a validation result in history
+ */
+export declare function storeValidationHistory(domainId: string, result: ValidationResult): Promise<ValidationHistoryEntry | null>;
+/**
+ * Get validation history for a monitored domain (authenticated user)
+ */
+export declare function getValidationHistory(domainId: string, limit?: number, daysBack?: number): Promise<ValidationHistoryEntry[]>;
+/**
+ * Calculate trend from history entries
+ */
+export declare function calculateTrend(history: ValidationHistoryEntry[]): ValidationTrend;
+/**
+ * Get domain history with trend analysis (for authenticated users)
+ */
+export declare function getDomainHistory(domainId: string, daysBack?: number): Promise<DomainHistoryResult | null>;
+/**
+ * Get public history for a domain (limited to 3 entries for anonymous users)
+ * This looks up by domain name, not by user's monitored domain ID
+ */
+export declare function getPublicDomainHistory(domainName: string, isAuthenticated?: boolean): Promise<PublicHistoryResult>;
+/**
+ * Get the previous validation entry for a domain (for diffing)
+ * Returns the most recent entry excluding the given ID.
+ */
+export declare function getPreviousValidation(domainId: string, excludeId?: string): Promise<{
+    id: string;
+    resultJson: string | null;
+    score: number | null;
+    grade: string | null;
+} | null>;
+/**
+ * Update a validation history entry with severity and change summary
+ */
+export declare function updateHistorySeverity(historyId: string, severity: string, changesSummary: string): Promise<void>;
+/**
+ * Run validation and store history for a monitored domain
+ */
+export declare function validateAndStoreHistory(domainId: string, domainName: string): Promise<{
+    result: ValidationResult;
+    historyEntry: ValidationHistoryEntry | null;
+}>;
+/**
+ * Get validation history statistics
+ */
+export declare function getHistoryStats(domainId: string): Promise<{
+    totalValidations: number;
+    averageScore: number;
+    bestScore: number;
+    worstScore: number;
+    firstValidation: Date | null;
+    lastValidation: Date | null;
+}>;
+//# sourceMappingURL=validation-history.d.ts.map

package/dist/services/validation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-history.d.ts","sourceRoot":"","sources":["../../src/services/validation-history.ts"],"names":[],"mappings":"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"}