crewly 1.2.3 → 1.2.6

package/dist/backend/backend/src/services/payment/magic-moment.types.js

@@ -0,0 +1,91 @@
+/**
+ * Magic Moment Type Definitions
+ *
+ * Types for the anonymous trial system that allows up to 3 free
+ * task submissions without authentication. Trials are tracked by
+ * a client-provided device fingerprint.
+ *
+ * @module services/payment/magic-moment.types
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Magic Moment service configuration. */
+export const MAGIC_MOMENT_CONSTANTS = {
+    /** Maximum free trials per device fingerprint */
+    MAX_FREE_TRIALS: 3,
+    /** Storage directory under ~/.crewly/ */
+    STORAGE_DIR: 'cloud/magic-moment',
+    /** Trial data file */
+    TRIALS_FILE: 'trials.json',
+    /** Minimum fingerprint length */
+    MIN_FINGERPRINT_LENGTH: 8,
+    /** Maximum fingerprint length */
+    MAX_FINGERPRINT_LENGTH: 128,
+};
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/** Allowed MIME types for magic moment uploads (matches H5). */
+const ALLOWED_MAGIC_MIME_TYPES = [
+    'image/png',
+    'image/jpeg',
+    'image/gif',
+    'image/webp',
+];
+/**
+ * Checks whether a MIME type is allowed for magic moment uploads.
+ *
+ * @param mimeType - MIME type to check
+ * @returns True if allowed
+ */
+export function isAllowedMagicMimeType(mimeType) {
+    return ALLOWED_MAGIC_MIME_TYPES.includes(mimeType);
+}
+/**
+ * Validates a device fingerprint string.
+ *
+ * @param fingerprint - Value to validate
+ * @returns Error message or null if valid
+ */
+export function validateFingerprint(fingerprint) {
+    if (!fingerprint || typeof fingerprint !== 'string') {
+        return 'fingerprint is required';
+    }
+    if (fingerprint.length < MAGIC_MOMENT_CONSTANTS.MIN_FINGERPRINT_LENGTH) {
+        return `fingerprint must be at least ${MAGIC_MOMENT_CONSTANTS.MIN_FINGERPRINT_LENGTH} characters`;
+    }
+    if (fingerprint.length > MAGIC_MOMENT_CONSTANTS.MAX_FINGERPRINT_LENGTH) {
+        return `fingerprint must be at most ${MAGIC_MOMENT_CONSTANTS.MAX_FINGERPRINT_LENGTH} characters`;
+    }
+    return null;
+}
+/**
+ * Validates a magic moment submit request body.
+ *
+ * @param body - Request body to validate
+ * @returns Error message or null if valid
+ */
+export function validateMagicSubmitBody(body) {
+    const fpError = validateFingerprint(body.fingerprint);
+    if (fpError)
+        return fpError;
+    const hasPrompt = body.prompt && typeof body.prompt === 'string' && body.prompt.trim().length > 0;
+    const hasFile = body.fileData && typeof body.fileData === 'string' && body.fileData.length > 0;
+    if (!hasPrompt && !hasFile) {
+        return 'At least one of prompt or file is required';
+    }
+    if (hasFile) {
+        if (!body.fileName || typeof body.fileName !== 'string' || body.fileName.trim().length === 0) {
+            return 'fileName is required when uploading a file';
+        }
+        if (!body.fileMimeType || typeof body.fileMimeType !== 'string') {
+            return 'fileMimeType is required when uploading a file';
+        }
+        if (!isAllowedMagicMimeType(body.fileMimeType)) {
+            return `Unsupported file type: ${body.fileMimeType}. Only images are allowed for free trials.`;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=magic-moment.types.js.map

package/dist/backend/backend/src/services/payment/magic-moment.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-moment.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/payment/magic-moment.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,0CAA0C;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACrC,iDAAiD;IACjD,eAAe,EAAE,CAAC;IAClB,yCAAyC;IACzC,WAAW,EAAE,oBAAoB;IACjC,sBAAsB;IACtB,WAAW,EAAE,aAAa;IAC1B,iCAAiC;IACjC,sBAAsB,EAAE,CAAC;IACzB,iCAAiC;IACjC,sBAAsB,EAAE,GAAG;CAClB,CAAC;AAkEX,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,gEAAgE;AAChE,MAAM,wBAAwB,GAAG;IAChC,WAAW;IACX,YAAY;IACZ,WAAW;IACX,YAAY;CACH,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACtD,OAAQ,wBAA8C,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAoB;IACvD,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,yBAAyB,CAAC;IAClC,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,sBAAsB,CAAC,sBAAsB,EAAE,CAAC;QACxE,OAAO,gCAAgC,sBAAsB,CAAC,sBAAsB,aAAa,CAAC;IACnG,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,sBAAsB,CAAC,sBAAsB,EAAE,CAAC;QACxE,OAAO,+BAA+B,sBAAsB,CAAC,sBAAsB,aAAa,CAAC;IAClG,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAqB;IAC5D,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAClG,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAE/F,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,OAAO,4CAA4C,CAAC;IACrD,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9F,OAAO,4CAA4C,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,gDAAgD,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAChD,OAAO,0BAA0B,IAAI,CAAC,YAAY,4CAA4C,CAAC;QAChG,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/backend/backend/src/services/payment/stripe.service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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.
+ *
+ * @module services/payment/stripe.service
+ */
+import type { PlanId, BillingInterval, SubscriptionInfo, CreateCheckoutResponse, CreatePortalResponse, WebhookEventPayload, PaymentOperationResult } from '../../controllers/payment/payment.types.js';
+/**
+ * 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 declare class StripeService {
+    private static instance;
+    private readonly logger;
+    private readonly secretKey;
+    private readonly webhookSecret;
+    private constructor();
+    /**
+     * Get or create the singleton instance.
+     *
+     * @returns StripeService singleton
+     */
+    static getInstance(): StripeService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Whether Stripe is configured and ready to use.
+     *
+     * @returns true if the secret key is set
+     */
+    isConfigured(): boolean;
+    /**
+     * 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
+     */
+    createCheckoutSession(userId: string, planId: PlanId, interval: BillingInterval, successUrl: string, cancelUrl: string): Promise<PaymentOperationResult<CreateCheckoutResponse>>;
+    /**
+     * Get the current subscription for a user.
+     *
+     * Queries the Supabase `licenses` table (or Stripe customer lookup)
+     * to determine the user's active subscription.
+     *
+     * @param userId - Supabase user ID
+     * @returns Subscription info
+     */
+    getSubscription(userId: string): Promise<PaymentOperationResult<SubscriptionInfo>>;
+    /**
+     * 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
+     */
+    createPortalSession(userId: string, returnUrl: string): Promise<PaymentOperationResult<CreatePortalResponse>>;
+    /**
+     * Verify and process a Stripe webhook event.
+     *
+     * Validates the webhook signature, 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
+     */
+    handleWebhookEvent(rawBody: Buffer, signature: string): Promise<PaymentOperationResult<WebhookEventPayload>>;
+}
+//# sourceMappingURL=stripe.service.d.ts.map

package/dist/backend/backend/src/services/payment/stripe.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/payment/stripe.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACX,MAAM,EACN,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,MAAM,4CAA4C,CAAC;AAmCpD;;;;;GAKG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IAErD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAEnD,OAAO;IAUP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAQvB;;;;;;;;;OASG;IACG,qBAAqB,CAC1B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC;IAyC1D;;;;;;;;OAQG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IA8CxF;;;;;;OAMG;IACG,mBAAmB,CACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IA8BxD;;;;;;;;;OASG;IACG,kBAAkB,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;CA4DvD"}

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

@@ -0,0 +1,279 @@
+/**
+ * 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.
+ *
+ * @module services/payment/stripe.service
+ */
+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 Price ID mapping.
+ *
+ * In production these would come from env vars or a config table.
+ * For now they are placeholders that show the expected shape.
+ */
+const PRICE_IDS = {
+    free: { month: '', year: '' },
+    pro: {
+        month: process.env['STRIPE_PRO_MONTHLY_PRICE_ID'] || 'price_pro_monthly',
+        year: process.env['STRIPE_PRO_YEARLY_PRICE_ID'] || 'price_pro_yearly',
+    },
+    enterprise: {
+        month: process.env['STRIPE_ENT_MONTHLY_PRICE_ID'] || 'price_enterprise_monthly',
+        year: process.env['STRIPE_ENT_YEARLY_PRICE_ID'] || 'price_enterprise_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;
+    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.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;
+    }
+    // -----------------------------------------------------------------------
+    // 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()) {
+            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 {
+            // In production this calls:
+            // const stripe = new Stripe(this.secretKey);
+            // const session = await stripe.checkout.sessions.create({ ... });
+            //
+            // For now, return a placeholder that shows the expected shape:
+            this.logger.info(`Creating checkout session: user=${userId} plan=${planId} interval=${interval}`);
+            return {
+                success: true,
+                message: 'Checkout session created',
+                data: {
+                    checkoutUrl: `https://checkout.stripe.com/pay/placeholder_${planId}_${interval}`,
+                    sessionId: `cs_placeholder_${Date.now()}`,
+                },
+            };
+        }
+        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.
+     *
+     * Queries the Supabase `licenses` table (or Stripe customer lookup)
+     * to determine the user's active subscription.
+     *
+     * @param userId - Supabase user ID
+     * @returns Subscription info
+     */
+    async getSubscription(userId) {
+        if (!this.isConfigured()) {
+            return {
+                success: true,
+                message: 'Stripe not configured — returning free plan defaults',
+                data: {
+                    active: false,
+                    planId: 'free',
+                    status: null,
+                    currentPeriodEnd: null,
+                    cancelAtPeriodEnd: false,
+                },
+            };
+        }
+        try {
+            // In production this calls:
+            // const stripe = new Stripe(this.secretKey);
+            // const customers = await stripe.customers.search({ query: `metadata['userId']:'${userId}'` });
+            // const subscription = await stripe.subscriptions.list({ customer: customers.data[0].id });
+            //
+            // For now, return free plan defaults:
+            this.logger.info(`Getting subscription for user=${userId}`);
+            return {
+                success: true,
+                message: 'Subscription retrieved',
+                data: {
+                    active: false,
+                    planId: 'free',
+                    status: null,
+                    currentPeriodEnd: null,
+                    cancelAtPeriodEnd: false,
+                },
+            };
+        }
+        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()) {
+            return { success: false, message: 'Stripe is not configured. Set STRIPE_SECRET_KEY to enable payments.' };
+        }
+        try {
+            // In production this calls:
+            // const stripe = new Stripe(this.secretKey);
+            // const session = await stripe.billingPortal.sessions.create({ customer, return_url });
+            //
+            this.logger.info(`Creating portal session for user=${userId}`);
+            return {
+                success: true,
+                message: 'Portal session created',
+                data: {
+                    portalUrl: `https://billing.stripe.com/session/placeholder_${Date.now()}`,
+                },
+            };
+        }
+        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.
+     *
+     * Validates the webhook signature, 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 {
+            // TODO(security): Enable Stripe signature verification before production deployment.
+            // When the Stripe SDK is available, replace the JSON.parse below with:
+            //   const stripe = new Stripe(this.secretKey);
+            //   const event = stripe.webhooks.constructEvent(rawBody, signature, this.webhookSecret);
+            // This prevents forged webhook events from unauthorized sources.
+            this.logger.warn('Webhook signature verification not yet implemented — accepting unverified events');
+            const 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,
+            };
+            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"}