crewly 1.2.1 → 1.2.4

package/dist/backend/backend/src/services/payment/stripe.service.js

@@ -0,0 +1,403 @@
+/**
+ * Stripe Payment Service
+ *
+ * Wraps the Stripe SDK for checkout session creation, subscription
+ * management, customer portal, and webhook event processing.
+ *
+ * Conditionally initialises — if STRIPE_SECRET_KEY is not set, all
+ * methods return graceful errors instead of crashing, allowing the
+ * rest of the backend to run without Stripe credentials.
+ *
+ * Subscription state is persisted locally via a file-based store so
+ * that GET /subscription queries do not require a Stripe API call.
+ *
+ * @module services/payment/stripe.service
+ */
+import Stripe from 'stripe';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { LoggerService } from '../core/logger.service.js';
+import { isHandledWebhookEvent } from '../../controllers/payment/payment.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Environment variable name for the Stripe secret key. */
+const STRIPE_SECRET_KEY_ENV = 'STRIPE_SECRET_KEY';
+/** Environment variable name for the Stripe webhook signing secret. */
+const STRIPE_WEBHOOK_SECRET_ENV = 'STRIPE_WEBHOOK_SECRET';
+/** Stripe API version to pin. */
+const STRIPE_API_VERSION = '2025-04-30.basil';
+/** Storage directory for subscription state. */
+const SUBSCRIPTION_STORAGE_DIR = join(homedir(), '.crewly', 'cloud', 'subscriptions');
+/** Subscription state file. */
+const SUBSCRIPTION_FILE = 'subscriptions.json';
+/**
+ * Stripe Price ID mapping.
+ *
+ * Values come from environment variables when set, otherwise
+ * fall back to descriptive placeholder IDs for development.
+ */
+const PRICE_IDS = {
+    free: { month: '', year: '' },
+    solo: {
+        month: process.env['STRIPE_SOLO_MONTHLY_PRICE_ID'] || 'price_solo_monthly',
+        year: process.env['STRIPE_SOLO_YEARLY_PRICE_ID'] || 'price_solo_yearly',
+    },
+    team: {
+        month: process.env['STRIPE_TEAM_MONTHLY_PRICE_ID'] || 'price_team_monthly',
+        year: process.env['STRIPE_TEAM_YEARLY_PRICE_ID'] || 'price_team_yearly',
+    },
+    full: {
+        month: process.env['STRIPE_FULL_MONTHLY_PRICE_ID'] || 'price_full_monthly',
+        year: process.env['STRIPE_FULL_YEARLY_PRICE_ID'] || 'price_full_yearly',
+    },
+};
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Singleton service for Stripe payment operations.
+ *
+ * All methods check `isConfigured()` first and return a descriptive
+ * error when Stripe is not available rather than throwing.
+ */
+export class StripeService {
+    static instance = null;
+    logger;
+    secretKey;
+    webhookSecret;
+    stripe = null;
+    subscriptions = new Map();
+    subscriptionsLoaded = false;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('StripeService');
+        this.secretKey = process.env[STRIPE_SECRET_KEY_ENV];
+        this.webhookSecret = process.env[STRIPE_WEBHOOK_SECRET_ENV];
+        if (this.secretKey) {
+            this.stripe = new Stripe(this.secretKey, { apiVersion: STRIPE_API_VERSION });
+        }
+        else {
+            this.logger.warn('STRIPE_SECRET_KEY not set — payment features are disabled');
+        }
+    }
+    /**
+     * Get or create the singleton instance.
+     *
+     * @returns StripeService singleton
+     */
+    static getInstance() {
+        if (!StripeService.instance) {
+            StripeService.instance = new StripeService();
+        }
+        return StripeService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        StripeService.instance = null;
+    }
+    /**
+     * Whether Stripe is configured and ready to use.
+     *
+     * @returns true if the secret key is set
+     */
+    isConfigured() {
+        return !!this.secretKey;
+    }
+    // -----------------------------------------------------------------------
+    // Subscription Store
+    // -----------------------------------------------------------------------
+    /**
+     * Load subscription state from disk. Idempotent.
+     */
+    async loadSubscriptions() {
+        if (this.subscriptionsLoaded)
+            return;
+        try {
+            await mkdir(SUBSCRIPTION_STORAGE_DIR, { recursive: true });
+            const filePath = join(SUBSCRIPTION_STORAGE_DIR, SUBSCRIPTION_FILE);
+            const raw = await readFile(filePath, 'utf-8').catch(() => '[]');
+            const parsed = JSON.parse(raw);
+            for (const sub of parsed) {
+                this.subscriptions.set(sub.userId, sub);
+            }
+        }
+        catch {
+            this.subscriptions = new Map();
+        }
+        this.subscriptionsLoaded = true;
+    }
+    /**
+     * Persist subscription state to disk.
+     */
+    async persistSubscriptions() {
+        try {
+            await mkdir(SUBSCRIPTION_STORAGE_DIR, { recursive: true });
+            const filePath = join(SUBSCRIPTION_STORAGE_DIR, SUBSCRIPTION_FILE);
+            const data = JSON.stringify(Array.from(this.subscriptions.values()), null, 2);
+            await writeFile(filePath, data, 'utf-8');
+        }
+        catch (err) {
+            this.logger.error('Failed to persist subscriptions', { error: String(err) });
+        }
+    }
+    /**
+     * Update or create a subscription record from a webhook event.
+     *
+     * @param payload - Processed webhook payload
+     */
+    async upsertSubscriptionFromWebhook(payload) {
+        if (!payload.userId)
+            return;
+        await this.loadSubscriptions();
+        const existing = this.subscriptions.get(payload.userId);
+        const now = new Date().toISOString();
+        if (payload.type === 'customer.subscription.deleted') {
+            if (existing) {
+                existing.status = 'canceled';
+                existing.updatedAt = now;
+            }
+        }
+        else {
+            const sub = {
+                userId: payload.userId,
+                customerId: payload.customerId || existing?.customerId || '',
+                subscriptionId: payload.subscriptionId || existing?.subscriptionId || '',
+                planId: payload.planId || existing?.planId || 'free',
+                status: payload.type === 'invoice.payment_failed' ? 'past_due' : 'active',
+                currentPeriodEnd: existing?.currentPeriodEnd || null,
+                cancelAtPeriodEnd: existing?.cancelAtPeriodEnd || false,
+                updatedAt: now,
+            };
+            this.subscriptions.set(payload.userId, sub);
+        }
+        await this.persistSubscriptions();
+    }
+    // -----------------------------------------------------------------------
+    // Checkout
+    // -----------------------------------------------------------------------
+    /**
+     * Create a Stripe Checkout Session for a subscription.
+     *
+     * @param userId - Supabase user ID (stored in session metadata)
+     * @param planId - Plan to subscribe to
+     * @param interval - Billing interval
+     * @param successUrl - Redirect URL after successful payment
+     * @param cancelUrl - Redirect URL if user cancels
+     * @returns Result containing the checkout URL and session ID
+     */
+    async createCheckoutSession(userId, planId, interval, successUrl, cancelUrl) {
+        if (!this.isConfigured() || !this.stripe) {
+            return { success: false, message: 'Stripe is not configured. Set STRIPE_SECRET_KEY to enable payments.' };
+        }
+        if (planId === 'free') {
+            return { success: false, message: 'Cannot create checkout session for free plan' };
+        }
+        const priceId = PRICE_IDS[planId]?.[interval];
+        if (!priceId) {
+            return { success: false, message: `No price configured for ${planId}/${interval}` };
+        }
+        try {
+            this.logger.info(`Creating checkout session: user=${userId} plan=${planId} interval=${interval}`);
+            const session = await this.stripe.checkout.sessions.create({
+                mode: 'subscription',
+                payment_method_types: ['card'],
+                line_items: [{ price: priceId, quantity: 1 }],
+                success_url: successUrl,
+                cancel_url: cancelUrl,
+                metadata: { userId, planId },
+                subscription_data: {
+                    metadata: { userId, planId },
+                },
+            });
+            return {
+                success: true,
+                message: 'Checkout session created',
+                data: {
+                    checkoutUrl: session.url || '',
+                    sessionId: session.id,
+                },
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Checkout session creation failed: ${msg}`);
+            return { success: false, message: `Failed to create checkout session: ${msg}` };
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Subscription
+    // -----------------------------------------------------------------------
+    /**
+     * Get the current subscription for a user.
+     *
+     * First checks local subscription store (populated by webhooks),
+     * then falls back to Stripe customer search if configured.
+     *
+     * @param userId - Supabase user ID
+     * @returns Subscription info
+     */
+    async getSubscription(userId) {
+        const freeDefaults = {
+            active: false,
+            planId: 'free',
+            status: null,
+            currentPeriodEnd: null,
+            cancelAtPeriodEnd: false,
+        };
+        if (!this.isConfigured()) {
+            return {
+                success: true,
+                message: 'Stripe not configured — returning free plan defaults',
+                data: freeDefaults,
+            };
+        }
+        try {
+            await this.loadSubscriptions();
+            const stored = this.subscriptions.get(userId);
+            if (stored && stored.status === 'active') {
+                return {
+                    success: true,
+                    message: 'Subscription retrieved from local store',
+                    data: {
+                        active: true,
+                        planId: stored.planId,
+                        status: stored.status,
+                        currentPeriodEnd: stored.currentPeriodEnd,
+                        cancelAtPeriodEnd: stored.cancelAtPeriodEnd,
+                    },
+                };
+            }
+            if (stored) {
+                return {
+                    success: true,
+                    message: 'Subscription retrieved from local store',
+                    data: {
+                        active: stored.status === 'trialing',
+                        planId: stored.planId,
+                        status: stored.status,
+                        currentPeriodEnd: stored.currentPeriodEnd,
+                        cancelAtPeriodEnd: stored.cancelAtPeriodEnd,
+                    },
+                };
+            }
+            this.logger.info(`No stored subscription for user=${userId}, returning free defaults`);
+            return {
+                success: true,
+                message: 'No subscription found',
+                data: freeDefaults,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to get subscription: ${msg}`);
+            return { success: false, message: `Failed to get subscription: ${msg}` };
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Customer Portal
+    // -----------------------------------------------------------------------
+    /**
+     * Create a Stripe Customer Portal session for subscription management.
+     *
+     * @param userId - Supabase user ID
+     * @param returnUrl - URL to redirect to when the user is done
+     * @returns Portal URL
+     */
+    async createPortalSession(userId, returnUrl) {
+        if (!this.isConfigured() || !this.stripe) {
+            return { success: false, message: 'Stripe is not configured. Set STRIPE_SECRET_KEY to enable payments.' };
+        }
+        try {
+            await this.loadSubscriptions();
+            const stored = this.subscriptions.get(userId);
+            if (!stored?.customerId) {
+                return { success: false, message: 'No Stripe customer found for this user. Subscribe to a plan first.' };
+            }
+            this.logger.info(`Creating portal session for user=${userId}`);
+            const session = await this.stripe.billingPortal.sessions.create({
+                customer: stored.customerId,
+                return_url: returnUrl,
+            });
+            return {
+                success: true,
+                message: 'Portal session created',
+                data: {
+                    portalUrl: session.url,
+                },
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Portal session creation failed: ${msg}`);
+            return { success: false, message: `Failed to create portal session: ${msg}` };
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Webhook
+    // -----------------------------------------------------------------------
+    /**
+     * Verify and process a Stripe webhook event.
+     *
+     * Uses Stripe SDK signature verification when configured,
+     * then extracts relevant data from the event payload.
+     *
+     * @param rawBody - Raw request body (Buffer)
+     * @param signature - Stripe-Signature header value
+     * @returns Processed webhook event payload
+     */
+    async handleWebhookEvent(rawBody, signature) {
+        if (!this.isConfigured()) {
+            return { success: false, message: 'Stripe is not configured' };
+        }
+        if (!this.webhookSecret) {
+            return { success: false, message: 'STRIPE_WEBHOOK_SECRET not set — cannot verify webhooks' };
+        }
+        if (!signature) {
+            return { success: false, message: 'Missing Stripe-Signature header' };
+        }
+        try {
+            let eventData;
+            // Use Stripe SDK signature verification when available
+            if (this.stripe) {
+                const event = this.stripe.webhooks.constructEvent(rawBody, signature, this.webhookSecret);
+                eventData = event;
+            }
+            else {
+                eventData = JSON.parse(rawBody.toString());
+            }
+            const eventType = eventData.type || '';
+            if (!isHandledWebhookEvent(eventType)) {
+                return {
+                    success: true,
+                    message: `Ignoring unhandled event type: ${eventType}`,
+                };
+            }
+            const obj = eventData.data?.object || {};
+            const payload = {
+                eventId: eventData.id || '',
+                type: eventType,
+                userId: obj['metadata']?.['userId'] || null,
+                customerId: obj['customer'] || null,
+                subscriptionId: obj['subscription'] || obj['id'] || null,
+                planId: obj['metadata']?.['planId'] || null,
+            };
+            // Persist subscription state change
+            await this.upsertSubscriptionFromWebhook(payload);
+            this.logger.info(`Webhook processed: type=${eventType} eventId=${payload.eventId}`);
+            return {
+                success: true,
+                message: `Webhook event ${eventType} processed`,
+                data: payload,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Webhook processing failed: ${msg}`);
+            return { success: false, message: `Webhook processing failed: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=stripe.service.js.map

package/dist/backend/backend/src/services/payment/stripe.service.js.map

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

package/dist/backend/backend/src/services/plugin/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Plugin system barrel export.
+ *
+ * @module services/plugin
+ */
+export { PluginService } from './plugin.service.js';
+export type { HookName, HookHandler, HookPayloadMap, CrewlyPlugin, AgentBootPayload, TaskVerifyPayload, SkillExecutePayload, DashboardRenderPayload, } from './plugin.types.js';
+export { HOOK_NAMES } from './plugin.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,QAAQ,EACR,WAAW,EACX,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/backend/backend/src/services/plugin/index.js

@@ -0,0 +1,8 @@
+/**
+ * Plugin system barrel export.
+ *
+ * @module services/plugin
+ */
+export { PluginService } from './plugin.service.js';
+export { HOOK_NAMES } from './plugin.types.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/services/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/backend/backend/src/services/plugin/plugin.service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Plugin Service
+ *
+ * Manages plugin registration and hook execution for the Crewly
+ * extensibility system. Plugins (like Crewly Pro) register handlers
+ * for specific hook points, and the core system invokes them at the
+ * appropriate moments.
+ *
+ * Singleton pattern matching other Crewly services.
+ *
+ * @module services/plugin/plugin.service
+ */
+import type { HookName, HookPayloadMap, CrewlyPlugin } from './plugin.types.js';
+/**
+ * PluginService manages the plugin lifecycle and hook dispatch.
+ *
+ * Plugins register via `registerPlugin()` and the core system
+ * calls `executeHook()` at defined extension points. Handlers
+ * are executed in registration order and errors in one handler
+ * do not prevent others from running.
+ */
+export declare class PluginService {
+    private static instance;
+    /** Registered plugins indexed by ID */
+    private plugins;
+    /** Hook handlers grouped by hook name */
+    private hooks;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The singleton instance
+     */
+    static getInstance(): PluginService;
+    /**
+     * Clear the singleton instance (for testing).
+     */
+    static clearInstance(): void;
+    /**
+     * Register a plugin with the system.
+     *
+     * Extracts hook handlers from the plugin and adds them to the
+     * internal registry. If a plugin with the same ID is already
+     * registered, it is replaced.
+     *
+     * @param plugin - The plugin to register
+     */
+    registerPlugin(plugin: CrewlyPlugin): void;
+    /**
+     * Unregister a plugin and remove all its hook handlers.
+     *
+     * @param pluginId - The plugin ID to remove
+     * @returns True if the plugin was found and removed
+     */
+    unregisterPlugin(pluginId: string): boolean;
+    /**
+     * Get a registered plugin by ID.
+     *
+     * @param pluginId - The plugin ID
+     * @returns The plugin, or undefined if not found
+     */
+    getPlugin(pluginId: string): CrewlyPlugin | undefined;
+    /**
+     * List all registered plugins.
+     *
+     * @returns Array of registered plugins
+     */
+    listPlugins(): CrewlyPlugin[];
+    /**
+     * Get the number of registered plugins.
+     *
+     * @returns Plugin count
+     */
+    getPluginCount(): number;
+    /**
+     * Execute all handlers registered for a hook.
+     *
+     * Handlers are called in registration order. Errors in one handler
+     * are caught and do not prevent subsequent handlers from running.
+     * Async handlers are awaited sequentially.
+     *
+     * @param hookName - The hook to execute
+     * @param payload - The payload to pass to each handler
+     * @returns Array of errors from failed handlers (empty if all succeeded)
+     */
+    executeHook<K extends HookName>(hookName: K, payload: HookPayloadMap[K]): Promise<Error[]>;
+    /**
+     * Get the number of handlers registered for a specific hook.
+     *
+     * @param hookName - The hook name
+     * @returns Number of registered handlers
+     */
+    getHandlerCount(hookName: HookName): number;
+    /**
+     * Check if any handlers are registered for a hook.
+     *
+     * @param hookName - The hook name
+     * @returns True if at least one handler is registered
+     */
+    hasHandlers(hookName: HookName): boolean;
+}
+//# sourceMappingURL=plugin.service.d.ts.map

package/dist/backend/backend/src/services/plugin/plugin.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/plugin/plugin.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,QAAQ,EAER,cAAc,EACd,YAAY,EACb,MAAM,mBAAmB,CAAC;AAmB3B;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IAErD,uCAAuC;IACvC,OAAO,CAAC,OAAO,CAAwC;IAEvD,yCAAyC;IACzC,OAAO,CAAC,KAAK,CAAiD;IAE9D,OAAO;IAOP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAuB1C;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAe3C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIrD;;;;OAIG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAQxB;;;;;;;;;;OAUG;IACG,WAAW,CAAC,CAAC,SAAS,QAAQ,EAClC,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,KAAK,EAAE,CAAC;IAsBnB;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAI3C;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;CAGzC"}