crewly 1.3.30 → 1.4.0

package/dist/backend/backend/src/services/orchestrator/orchestrator-status.service.js

@@ -170,6 +170,29 @@ export async function getOrchestratorStatus() {
         };
     }
 }
+/**
+ * Check if a specific agent is currently active by verifying its PTY session exists
+ * and has a running child process.
+ *
+ * @param sessionName - The agent's session name to check
+ * @returns Promise resolving to true if the agent's session is alive
+ */
+export async function isAgentActive(sessionName) {
+    try {
+        const sessionBackend = getSessionBackendSync();
+        if (!sessionBackend) {
+            return false;
+        }
+        if (!sessionBackend.sessionExists(sessionName)) {
+            return false;
+        }
+        // Session exists — check if child process (the AI runtime) is alive
+        return !!sessionBackend.isChildProcessAlive?.(sessionName);
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Get a user-friendly message for when the orchestrator is offline.
  * Useful for Slack and Chat responses.

package/dist/backend/backend/src/services/orchestrator/orchestrator-status.service.js.map

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

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

@@ -1,83 +1,135 @@
 /**
  * Stripe Payment Service
  *
- * Wraps the Stripe SDK for checkout session creation, subscription
- * management, customer portal, and webhook event processing.
+ * Singleton service for Stripe API interactions. Handles checkout sessions,
+ * subscriptions, customer portal sessions, 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.
+ * Requires STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET environment variables.
+ * Returns { success: false, message: 'Stripe is not configured' } when keys
+ * are missing, allowing the app to run without Stripe in development.
  *
- * @module services/payment/stripe.service
+ * @module services/payment/stripe
  */
-import type { PlanId, BillingInterval, SubscriptionInfo, CreateCheckoutResponse, CreatePortalResponse, WebhookEventPayload, PaymentOperationResult } from '../../controllers/payment/payment.types.js';
+import Stripe from 'stripe';
+/** Result type for Stripe operations */
+export interface StripeResult<T = unknown> {
+    success: boolean;
+    message?: string;
+    data?: T;
+}
+/** Subscription info returned to clients */
+export interface SubscriptionInfo {
+    subscriptionId: string;
+    status: Stripe.Subscription.Status;
+    planId: string;
+    cancelAt: string | null;
+    cancelAtPeriodEnd: boolean;
+}
 /**
- * Singleton service for Stripe payment operations.
+ * Stripe payment service singleton.
  *
- * All methods check `isConfigured()` first and return a descriptive
- * error when Stripe is not available rather than throwing.
+ * Wraps all Stripe API calls with error handling and returns
+ * standardized result objects.
  */
 export declare class StripeService {
     private static instance;
-    private readonly logger;
-    private readonly secretKey;
-    private readonly webhookSecret;
+    private stripe;
+    private webhookSecret;
     private constructor();
     /**
      * Get or create the singleton instance.
      *
-     * @returns StripeService singleton
+     * @returns The StripeService singleton
      */
     static getInstance(): StripeService;
     /**
-     * Reset the singleton (for testing).
+     * Check if Stripe is configured with required environment variables.
+     *
+     * @returns True if STRIPE_SECRET_KEY is set and Stripe client initialized
      */
-    static resetInstance(): void;
+    isConfigured(): boolean;
     /**
-     * Whether Stripe is configured and ready to use.
+     * Find a Stripe customer by userId stored in metadata.
      *
-     * @returns true if the secret key is set
+     * @param client - Stripe client (must be non-null)
+     * @param userId - Internal user ID
+     * @returns The first matching customer or null
      */
-    isConfigured(): boolean;
+    private findCustomerByUserId;
     /**
-     * Create a Stripe Checkout Session for a subscription.
+     * Create a Stripe Checkout Session for a subscription plan.
      *
-     * @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 userId - User ID attached as metadata for post-checkout correlation
+     * @param planId - Plan identifier (pro, enterprise)
+     * @param interval - Billing interval (month, year)
+     * @param successUrl - Redirect URL after successful checkout
      * @param cancelUrl - Redirect URL if user cancels
-     * @returns Result containing the checkout URL and session ID
+     * @returns Result with checkoutUrl and sessionId
      */
-    createCheckoutSession(userId: string, planId: PlanId, interval: BillingInterval, successUrl: string, cancelUrl: string): Promise<PaymentOperationResult<CreateCheckoutResponse>>;
+    createCheckoutSession(userId: string, planId: string, interval: string, successUrl: string, cancelUrl: string): Promise<StripeResult<{
+        checkoutUrl: string;
+        sessionId: string;
+    }>>;
     /**
-     * Get the current subscription for a user.
+     * Process a Stripe webhook event.
      *
-     * Queries the Supabase `licenses` table (or Stripe customer lookup)
-     * to determine the user's active subscription.
+     * Verifies the signature, then dispatches the event to the appropriate handler.
+     * Currently handles: checkout.session.completed, customer.subscription.updated,
+     * customer.subscription.deleted, invoice.payment_failed.
      *
-     * @param userId - Supabase user ID
-     * @returns Subscription info
+     * @param rawBody - Raw request body for signature verification
+     * @param signature - Stripe-Signature header value
+     * @returns Result indicating success or failure
      */
-    getSubscription(userId: string): Promise<PaymentOperationResult<SubscriptionInfo>>;
+    handleWebhookEvent(rawBody: Buffer, signature: string): Promise<StripeResult<{
+        eventType: string;
+    }>>;
+    /**
+     * Get the current subscription for a user by their Stripe customer ID.
+     *
+     * @param userId - The user to look up (used as client_reference_id or metadata)
+     * @returns Result with subscription data or null if no active subscription
+     */
+    getSubscription(userId: string): Promise<StripeResult<SubscriptionInfo | null>>;
     /**
      * 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
+     * @param userId - The user requesting access
+     * @param returnUrl - URL to redirect after portal session
+     * @returns Result with portalUrl
+     */
+    createPortalSession(userId: string, returnUrl: string): Promise<StripeResult<{
+        portalUrl: string;
+    }>>;
+    /**
+     * Handle checkout.session.completed — new subscription created.
+     * Links the Stripe customer to the internal userId via metadata.
+     *
+     * @param client - Stripe client instance
+     * @param session - The completed checkout session
      */
-    createPortalSession(userId: string, returnUrl: string): Promise<PaymentOperationResult<CreatePortalResponse>>;
+    private handleCheckoutCompleted;
     /**
-     * Verify and process a Stripe webhook event.
+     * Handle customer.subscription.updated — plan changes, renewals.
      *
-     * Validates the webhook signature, then extracts relevant data
-     * from the event payload.
+     * @param subscription - The updated subscription
+     */
+    private handleSubscriptionUpdated;
+    /**
+     * Handle customer.subscription.deleted — subscription cancelled/expired.
      *
-     * @param rawBody - Raw request body (Buffer)
-     * @param signature - Stripe-Signature header value
-     * @returns Processed webhook event payload
+     * @param subscription - The deleted subscription
      */
-    handleWebhookEvent(rawBody: Buffer, signature: string): Promise<PaymentOperationResult<WebhookEventPayload>>;
+    private handleSubscriptionDeleted;
+    /**
+     * Handle invoice.payment_failed — payment attempt failed.
+     *
+     * @param invoice - The failed invoice
+     */
+    private handlePaymentFailed;
+    /**
+     * Reset the singleton instance (for testing).
+     */
+    static resetInstance(): void;
 }
 //# sourceMappingURL=stripe.service.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"stripe.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/payment/stripe.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAM5B,wCAAwC;AACxC,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AA0BD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IACrD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAAqB;IAE1C,OAAO;IASP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;OAMG;YACW,oBAAoB;IAQlC;;;;;;;;;OASG;IACG,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAsCpE;;;;;;;;;;OAUG;IACG,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA0C/C;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAyCrF;;;;;;OAMG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA4B/C;;;;;;OAMG;YACW,uBAAuB;IAkBrC;;;;OAIG;YACW,yBAAyB;IAQvC;;;;OAIG;YACW,yBAAyB;IAOvC;;;;OAIG;YACW,mBAAmB;IAQjC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAG7B"}