eggi-ai-db-schema-2 0.1.1

package/dist/utils/subscription-operations.d.ts

@@ -0,0 +1,123 @@
+/**
+ * =============================================================================
+ * SUBSCRIPTION OPERATIONS
+ * =============================================================================
+ * Database operations for managing Stripe subscriptions
+ *
+ * This module provides reusable functions for subscription management,
+ * ensuring all subscription-related database operations are centralized
+ * and reusable across Lambda functions.
+ */
+import { Pool, PoolClient } from "pg";
+type Database = Pool | PoolClient | any;
+/**
+ * Subscription record interface
+ */
+export interface Subscription {
+    id: number;
+    organizationId: number;
+    stripeCustomerId: string;
+    stripeSubscriptionId: string;
+    stripePriceId: string;
+    status: string;
+    currentPeriodStart: Date;
+    currentPeriodEnd: Date;
+    trialStart: Date | null;
+    trialEnd: Date | null;
+    canceledAt: Date | null;
+    metadata: Record<string, any>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Create or update a subscription record
+ *
+ * This function ensures one subscription per organization by using ON CONFLICT (organization_id).
+ * When a new subscription is created for an organization, it replaces the existing subscription record.
+ *
+ * @param db - Database instance
+ * @param subscriptionData - Subscription data
+ * @returns Created or updated subscription
+ */
+export declare function upsertSubscription(db: Database, subscriptionData: {
+    organizationId: number;
+    stripeCustomerId: string;
+    stripeSubscriptionId: string;
+    stripePriceId: string;
+    status: string;
+    currentPeriodStart: Date;
+    currentPeriodEnd: Date;
+    trialStart?: Date | null;
+    trialEnd?: Date | null;
+    canceledAt?: Date | null;
+    metadata?: Record<string, any>;
+}): Promise<Subscription>;
+/**
+ * Get subscription by Stripe subscription ID
+ *
+ * @param db - Database instance
+ * @param stripeSubscriptionId - Stripe subscription ID
+ * @returns Subscription or null if not found
+ */
+export declare function getSubscriptionByStripeId(db: Database, stripeSubscriptionId: string): Promise<Subscription | null>;
+/**
+ * Get subscription by organization ID
+ *
+ * @param db - Database instance
+ * @param organizationId - Organization ID
+ * @returns Subscription or null if not found
+ */
+export declare function getSubscriptionByOrganizationId(db: Database, organizationId: number): Promise<Subscription | null>;
+/**
+ * Check if a Stripe event has already been processed (idempotency check)
+ *
+ * @param db - Database instance
+ * @param stripeEventId - Stripe event ID
+ * @returns true if event has been processed, false otherwise
+ */
+export declare function isStripeEventProcessed(db: Database, stripeEventId: string): Promise<boolean>;
+/**
+ * Update subscription status and dates
+ *
+ * @param db - Database instance
+ * @param stripeSubscriptionId - Stripe subscription ID
+ * @param updateData - Data to update
+ * @returns Updated subscription or null if not found
+ */
+export declare function updateSubscription(db: Database, stripeSubscriptionId: string, updateData: {
+    status?: string;
+    currentPeriodStart?: Date;
+    currentPeriodEnd?: Date;
+    trialStart?: Date | null;
+    trialEnd?: Date | null;
+    canceledAt?: Date | null;
+    metadata?: Record<string, any>;
+}): Promise<Subscription | null>;
+/**
+ * Check if an organization has ever had a subscription (regardless of trial or status)
+ * This is used to prevent free trial abuse (users canceling and resubscribing to get another free trial)
+ *
+ * Business Logic: If an organization has ANY previous subscription (even if canceled, even if no trial),
+ * they should not get a free trial on resubscription. The free trial is only for first-time subscribers.
+ *
+ * IMPORTANT: Since subscriptions use ON CONFLICT (organization_id), new subscriptions overwrite old ones.
+ * However, the existence of ANY subscription record (regardless of status) indicates the organization
+ * has already used their "first subscription" opportunity.
+ *
+ * @param db - Database instance
+ * @param organizationId - Organization ID
+ * @returns true if organization has ever had any subscription, false otherwise
+ */
+export declare function hasOrganizationUsedFreeTrial(db: Database, organizationId: number): Promise<boolean>;
+/**
+ * Check if a user has ever had a subscription with a free trial period (across all organizations)
+ * This is used to prevent free trial abuse (users canceling during trial and resubscribing)
+ * The check is per user, not per organization - once a user has used a free trial, they can't get another one
+ *
+ * @param db - Database instance
+ * @param userId - User ID
+ * @returns true if user has ever had a subscription with a trial period, false otherwise
+ */
+export declare function hasUserUsedFreeTrial(db: Database, userId: number): Promise<boolean>;
+export {};
+//# sourceMappingURL=subscription-operations.d.ts.map

package/dist/utils/subscription-operations.d.ts.map

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

package/dist/utils/subscription-operations.js

@@ -0,0 +1,391 @@
+"use strict";
+/**
+ * =============================================================================
+ * SUBSCRIPTION OPERATIONS
+ * =============================================================================
+ * Database operations for managing Stripe subscriptions
+ *
+ * This module provides reusable functions for subscription management,
+ * ensuring all subscription-related database operations are centralized
+ * and reusable across Lambda functions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upsertSubscription = upsertSubscription;
+exports.getSubscriptionByStripeId = getSubscriptionByStripeId;
+exports.getSubscriptionByOrganizationId = getSubscriptionByOrganizationId;
+exports.isStripeEventProcessed = isStripeEventProcessed;
+exports.updateSubscription = updateSubscription;
+exports.hasOrganizationUsedFreeTrial = hasOrganizationUsedFreeTrial;
+exports.hasUserUsedFreeTrial = hasUserUsedFreeTrial;
+const pg_client_1 = require("../lib/pg-client");
+const db_1 = require("../lib/db");
+/**
+ * Create or update a subscription record
+ *
+ * This function ensures one subscription per organization by using ON CONFLICT (organization_id).
+ * When a new subscription is created for an organization, it replaces the existing subscription record.
+ *
+ * @param db - Database instance
+ * @param subscriptionData - Subscription data
+ * @returns Created or updated subscription
+ */
+async function upsertSubscription(db, subscriptionData) {
+    (0, db_1.debugLogDbOperation)("upsert", "subscriptions", { subscriptionData });
+    // Note: We no longer need to preserve trial history in metadata because
+    // hasOrganizationUsedFreeTrial now simply checks if ANY subscription exists for the organization.
+    // The existence of a subscription record (regardless of status or trial) indicates
+    // the organization has already used their "first subscription" opportunity.
+    const sql = `
+    INSERT INTO public.subscriptions (
+      organization_id,
+      stripe_customer_id,
+      stripe_subscription_id,
+      stripe_price_id,
+      status,
+      current_period_start,
+      current_period_end,
+      trial_start,
+      trial_end,
+      canceled_at,
+      metadata,
+      created_at,
+      updated_at
+    ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, NOW(), NOW())
+    ON CONFLICT (organization_id) DO UPDATE SET
+      stripe_customer_id = EXCLUDED.stripe_customer_id,
+      stripe_subscription_id = EXCLUDED.stripe_subscription_id,
+      stripe_price_id = EXCLUDED.stripe_price_id,
+      status = EXCLUDED.status,
+      current_period_start = EXCLUDED.current_period_start,
+      current_period_end = EXCLUDED.current_period_end,
+      trial_start = EXCLUDED.trial_start,
+      trial_end = EXCLUDED.trial_end,
+      canceled_at = EXCLUDED.canceled_at,
+      metadata = EXCLUDED.metadata,
+      updated_at = NOW()
+    RETURNING 
+      id,
+      organization_id,
+      stripe_customer_id,
+      stripe_subscription_id,
+      stripe_price_id,
+      status,
+      current_period_start,
+      current_period_end,
+      trial_start,
+      trial_end,
+      canceled_at,
+      metadata,
+      created_at,
+      updated_at
+  `;
+    const result = await (0, pg_client_1.queryOne)(db, sql, [
+        subscriptionData.organizationId,
+        subscriptionData.stripeCustomerId,
+        subscriptionData.stripeSubscriptionId,
+        subscriptionData.stripePriceId,
+        subscriptionData.status,
+        subscriptionData.currentPeriodStart,
+        subscriptionData.currentPeriodEnd,
+        subscriptionData.trialStart || null,
+        subscriptionData.trialEnd || null,
+        subscriptionData.canceledAt || null,
+        JSON.stringify(subscriptionData.metadata || {}),
+    ]);
+    if (!result) {
+        throw new Error("Failed to upsert subscription");
+    }
+    return {
+        id: result.id,
+        organizationId: result.organization_id,
+        stripeCustomerId: result.stripe_customer_id,
+        stripeSubscriptionId: result.stripe_subscription_id,
+        stripePriceId: result.stripe_price_id,
+        status: result.status,
+        currentPeriodStart: result.current_period_start,
+        currentPeriodEnd: result.current_period_end,
+        trialStart: result.trial_start,
+        trialEnd: result.trial_end,
+        canceledAt: result.canceled_at,
+        metadata: result.metadata,
+        createdAt: result.created_at,
+        updatedAt: result.updated_at,
+    };
+}
+/**
+ * Get subscription by Stripe subscription ID
+ *
+ * @param db - Database instance
+ * @param stripeSubscriptionId - Stripe subscription ID
+ * @returns Subscription or null if not found
+ */
+async function getSubscriptionByStripeId(db, stripeSubscriptionId) {
+    (0, db_1.debugLogDbOperation)("select", "subscriptions", { stripeSubscriptionId });
+    const sql = `
+    SELECT 
+      id,
+      organization_id,
+      stripe_customer_id,
+      stripe_subscription_id,
+      stripe_price_id,
+      status,
+      current_period_start,
+      current_period_end,
+      trial_start,
+      trial_end,
+      canceled_at,
+      metadata,
+      created_at,
+      updated_at
+    FROM public.subscriptions
+    WHERE stripe_subscription_id = $1
+    LIMIT 1
+  `;
+    const result = await (0, pg_client_1.queryOne)(db, sql, [stripeSubscriptionId]);
+    if (!result) {
+        return null;
+    }
+    return {
+        id: result.id,
+        organizationId: result.organization_id,
+        stripeCustomerId: result.stripe_customer_id,
+        stripeSubscriptionId: result.stripe_subscription_id,
+        stripePriceId: result.stripe_price_id,
+        status: result.status,
+        currentPeriodStart: result.current_period_start,
+        currentPeriodEnd: result.current_period_end,
+        trialStart: result.trial_start,
+        trialEnd: result.trial_end,
+        canceledAt: result.canceled_at,
+        metadata: result.metadata,
+        createdAt: result.created_at,
+        updatedAt: result.updated_at,
+    };
+}
+/**
+ * Get subscription by organization ID
+ *
+ * @param db - Database instance
+ * @param organizationId - Organization ID
+ * @returns Subscription or null if not found
+ */
+async function getSubscriptionByOrganizationId(db, organizationId) {
+    (0, db_1.debugLogDbOperation)("select", "subscriptions", { organizationId });
+    const sql = `
+    SELECT 
+      id,
+      organization_id,
+      stripe_customer_id,
+      stripe_subscription_id,
+      stripe_price_id,
+      status,
+      current_period_start,
+      current_period_end,
+      trial_start,
+      trial_end,
+      canceled_at,
+      metadata,
+      created_at,
+      updated_at
+    FROM public.subscriptions
+    WHERE organization_id = $1
+    ORDER BY created_at DESC
+    LIMIT 1
+  `;
+    const result = await (0, pg_client_1.queryOne)(db, sql, [organizationId]);
+    if (!result) {
+        return null;
+    }
+    return {
+        id: result.id,
+        organizationId: result.organization_id,
+        stripeCustomerId: result.stripe_customer_id,
+        stripeSubscriptionId: result.stripe_subscription_id,
+        stripePriceId: result.stripe_price_id,
+        status: result.status,
+        currentPeriodStart: result.current_period_start,
+        currentPeriodEnd: result.current_period_end,
+        trialStart: result.trial_start,
+        trialEnd: result.trial_end,
+        canceledAt: result.canceled_at,
+        metadata: result.metadata,
+        createdAt: result.created_at,
+        updatedAt: result.updated_at,
+    };
+}
+/**
+ * Check if a Stripe event has already been processed (idempotency check)
+ *
+ * @param db - Database instance
+ * @param stripeEventId - Stripe event ID
+ * @returns true if event has been processed, false otherwise
+ */
+async function isStripeEventProcessed(db, stripeEventId) {
+    (0, db_1.debugLogDbOperation)("select", "subscriptions", { stripeEventId }, undefined, {
+        operation: "isStripeEventProcessed",
+    });
+    const sql = `
+    SELECT id
+    FROM public.subscriptions
+    WHERE metadata->>'stripe_event_id' = $1
+    LIMIT 1
+  `;
+    const result = await (0, pg_client_1.query)(db, sql, [stripeEventId]);
+    return result && result.length > 0;
+}
+/**
+ * Update subscription status and dates
+ *
+ * @param db - Database instance
+ * @param stripeSubscriptionId - Stripe subscription ID
+ * @param updateData - Data to update
+ * @returns Updated subscription or null if not found
+ */
+async function updateSubscription(db, stripeSubscriptionId, updateData) {
+    (0, db_1.debugLogDbOperation)("update", "subscriptions", {
+        stripeSubscriptionId,
+        updateData,
+    });
+    const updates = [];
+    const params = [];
+    let paramIndex = 1;
+    if (updateData.status !== undefined) {
+        updates.push(`status = $${paramIndex}`);
+        params.push(updateData.status);
+        paramIndex++;
+    }
+    if (updateData.currentPeriodStart !== undefined) {
+        updates.push(`current_period_start = $${paramIndex}`);
+        params.push(updateData.currentPeriodStart);
+        paramIndex++;
+    }
+    if (updateData.currentPeriodEnd !== undefined) {
+        updates.push(`current_period_end = $${paramIndex}`);
+        params.push(updateData.currentPeriodEnd);
+        paramIndex++;
+    }
+    if (updateData.trialStart !== undefined) {
+        updates.push(`trial_start = $${paramIndex}`);
+        params.push(updateData.trialStart);
+        paramIndex++;
+    }
+    if (updateData.trialEnd !== undefined) {
+        updates.push(`trial_end = $${paramIndex}`);
+        params.push(updateData.trialEnd);
+        paramIndex++;
+    }
+    if (updateData.canceledAt !== undefined) {
+        updates.push(`canceled_at = $${paramIndex}`);
+        params.push(updateData.canceledAt);
+        paramIndex++;
+    }
+    if (updateData.metadata !== undefined) {
+        updates.push(`metadata = $${paramIndex}`);
+        params.push(JSON.stringify(updateData.metadata));
+        paramIndex++;
+    }
+    if (updates.length === 0) {
+        // Nothing to update, return existing subscription
+        return getSubscriptionByStripeId(db, stripeSubscriptionId);
+    }
+    updates.push(`updated_at = NOW()`);
+    params.push(stripeSubscriptionId);
+    const sql = `
+    UPDATE public.subscriptions
+    SET ${updates.join(", ")}
+    WHERE stripe_subscription_id = $${paramIndex}
+    RETURNING 
+      id,
+      organization_id,
+      stripe_customer_id,
+      stripe_subscription_id,
+      stripe_price_id,
+      status,
+      current_period_start,
+      current_period_end,
+      trial_start,
+      trial_end,
+      canceled_at,
+      metadata,
+      created_at,
+      updated_at
+  `;
+    const result = await (0, pg_client_1.queryOne)(db, sql, params);
+    if (!result) {
+        return null;
+    }
+    return {
+        id: result.id,
+        organizationId: result.organization_id,
+        stripeCustomerId: result.stripe_customer_id,
+        stripeSubscriptionId: result.stripe_subscription_id,
+        stripePriceId: result.stripe_price_id,
+        status: result.status,
+        currentPeriodStart: result.current_period_start,
+        currentPeriodEnd: result.current_period_end,
+        trialStart: result.trial_start,
+        trialEnd: result.trial_end,
+        canceledAt: result.canceled_at,
+        metadata: result.metadata,
+        createdAt: result.created_at,
+        updatedAt: result.updated_at,
+    };
+}
+/**
+ * Check if an organization has ever had a subscription (regardless of trial or status)
+ * This is used to prevent free trial abuse (users canceling and resubscribing to get another free trial)
+ *
+ * Business Logic: If an organization has ANY previous subscription (even if canceled, even if no trial),
+ * they should not get a free trial on resubscription. The free trial is only for first-time subscribers.
+ *
+ * IMPORTANT: Since subscriptions use ON CONFLICT (organization_id), new subscriptions overwrite old ones.
+ * However, the existence of ANY subscription record (regardless of status) indicates the organization
+ * has already used their "first subscription" opportunity.
+ *
+ * @param db - Database instance
+ * @param organizationId - Organization ID
+ * @returns true if organization has ever had any subscription, false otherwise
+ */
+async function hasOrganizationUsedFreeTrial(db, organizationId) {
+    (0, db_1.debugLogDbOperation)("select", "subscriptions", { organizationId }, undefined, {
+        operation: "hasOrganizationUsedFreeTrial",
+    });
+    const sql = `
+    SELECT id
+    FROM public.subscriptions
+    WHERE organization_id = $1
+    LIMIT 1
+  `;
+    const result = await (0, pg_client_1.query)(db, sql, [organizationId]);
+    return result && result.length > 0;
+}
+/**
+ * Check if a user has ever had a subscription with a free trial period (across all organizations)
+ * This is used to prevent free trial abuse (users canceling during trial and resubscribing)
+ * The check is per user, not per organization - once a user has used a free trial, they can't get another one
+ *
+ * @param db - Database instance
+ * @param userId - User ID
+ * @returns true if user has ever had a subscription with a trial period, false otherwise
+ */
+async function hasUserUsedFreeTrial(db, userId) {
+    (0, db_1.debugLogDbOperation)("select", "subscriptions", { userId }, undefined, {
+        operation: "hasUserUsedFreeTrial",
+    });
+    // Query for user_id as integer in JSONB metadata
+    // user_id should always be stored as an integer, but we handle both for safety
+    const sql = `
+    SELECT id
+    FROM public.subscriptions
+    WHERE (
+      (metadata->'user_id')::numeric = $1::numeric
+      OR metadata->>'user_id' = $1::text
+    )
+      AND trial_start IS NOT NULL
+      AND trial_end IS NOT NULL
+    LIMIT 1
+  `;
+    const result = await (0, pg_client_1.query)(db, sql, [userId]);
+    return result && result.length > 0;
+}
+//# sourceMappingURL=subscription-operations.js.map

package/dist/utils/subscription-operations.js.map

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

package/dist/utils/unipile-account-operations.d.ts

@@ -0,0 +1,96 @@
+/**
+ * =============================================================================
+ * UNIPILE ACCOUNT OPERATIONS UTILITIES
+ * =============================================================================
+ * Utility functions for creating and managing Unipile social media accounts
+ */
+import { Pool, PoolClient } from 'pg';
+import type { Database } from "../lib/db";
+import { type UnipileAccount, type SocialPlatformType, type User } from "../lib/schema";
+export interface UnipileAccountWithUser extends UnipileAccount {
+    user: User;
+}
+export interface CreateUnipileAccountData {
+    linkedinAccountId: number;
+    unipileAccountId: string;
+    isActive?: boolean;
+    connectedAt?: Date;
+    lastSyncedAt?: Date;
+    metadata?: Record<string, any>;
+}
+export interface UpdateUnipileAccountData {
+    isActive?: boolean;
+    lastSyncedAt?: Date;
+    metadata?: Record<string, any>;
+}
+export interface UserWithUnipileAccounts extends User {
+    unipileAccounts: UnipileAccount[];
+}
+export interface UnipileAccountSearchCriteria {
+    platformTypes?: SocialPlatformType[];
+    isActive?: boolean;
+    userIds?: number[];
+    unipileAccountIds?: string[];
+    lastSyncedBefore?: Date;
+    lastSyncedAfter?: Date;
+}
+export interface PlatformSummary {
+    platform: SocialPlatformType;
+    totalAccounts: number;
+    activeAccounts: number;
+    inactiveAccounts: number;
+    recentlyConnected: number;
+    needsSync: number;
+}
+/**
+ * Creates a new Unipile account record
+ *
+ * @param data - Unipile account creation data
+ * @returns Promise resolving to the created account
+ */
+export declare function createUnipileAccount(db: Database | Pool | PoolClient, data: CreateUnipileAccountData): Promise<UnipileAccount>;
+/**
+ * Creates or updates a Unipile account (upsert)
+ *
+ * @param data - Unipile account data
+ * @returns Promise resolving to the created or updated account
+ */
+export declare function upsertUnipileAccount(db: Database | Pool | PoolClient, data: CreateUnipileAccountData): Promise<UnipileAccount>;
+/**
+ * Simple social account status map for quick UI updates
+ */
+export interface LinkedAccountStatusMap {
+    linkedin: boolean;
+    whatsapp: boolean;
+    twitter: boolean;
+    instagram: boolean;
+    facebook: boolean;
+}
+/**
+ * Gets a simple boolean map of which social accounts are linked for a user
+ * Optimized for frontend UI to show connection status without sensitive data
+ *
+ * @param cognitoUserId - The Cognito user ID
+ * @param activeOnly - Whether to only consider active accounts (default: true)
+ * @returns Promise resolving to a simple boolean map of linked platforms
+ */
+export declare function getUserLinkedAccountStatus(db: Database | Pool | PoolClient, cognitoUserId: string, activeOnly?: boolean): Promise<LinkedAccountStatusMap>;
+/**
+ * Checks if a LinkedIn account with the given ACoA identifier is already connected
+ * to a different user via an active Unipile account
+ *
+ * @param db - Database connection
+ * @param linkedinIdentifierAcoa - The ACoA identifier to check
+ * @param currentUserId - The current user ID (to exclude from the check)
+ * @returns Promise resolving to the existing account's user ID if found, null otherwise
+ */
+export declare function checkAcoaAlreadyConnectedToDifferentUser(db: Database | Pool | PoolClient, linkedinIdentifierAcoa: string, currentUserId: number): Promise<number | null>;
+/**
+ * Batch updates last synced time for multiple accounts
+ *
+ * @param accountIds - Array of account IDs to update
+ * @param syncTime - Optional: specific sync time (defaults to now)
+ * @returns Promise resolving to number of updated accounts
+ */
+export declare function batchMarkAccountsAsSynced(db: Database | Pool | PoolClient, accountIds: number[], syncTime?: Date): Promise<number>;
+//# sourceMappingURL=unipile-account-operations.d.ts.map

package/dist/utils/unipile-account-operations.d.ts.map

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