add userEntitlements endpoints

Author: NiloCK

packages/common-ui/src/composables/useEntitlements.ts

@@ -0,0 +1,118 @@
+import { ref, computed } from 'vue';
+import { getUserStatus } from '../services/authAPI';
+import type { Entitlement, UserEntitlements } from '../services/authAPI';
+
+export interface TrialStatus {
+  isActive: boolean;
+  isPaid: boolean;
+  daysRemaining: number | null;
+  expiresDate: string | null;
+}
+
+/**
+ * Composable for managing user entitlements and trial status
+ *
+ * @param courseId - The course identifier to check entitlements for
+ * @returns Object with entitlements data and helper methods
+ *
+ * @example
+ * ```typescript
+ * const { trialStatus, hasPremiumAccess, fetchEntitlements, loading } = useEntitlements('letterspractice-basic');
+ *
+ * onMounted(async () => {
+ *   await fetchEntitlements();
+ *   console.log('Days remaining:', trialStatus.value.daysRemaining);
+ * });
+ * ```
+ */
+export function useEntitlements(courseId: string) {
+  const entitlements = ref<UserEntitlements>({});
+  const loading = ref(false);
+  const error = ref<string | null>(null);
+
+  /**
+   * Get trial status for the specified course
+   */
+  const trialStatus = computed<TrialStatus>(() => {
+    const entitlement: Entitlement | undefined = entitlements.value[courseId];
+
+    if (!entitlement) {
+      return {
+        isActive: false,
+        isPaid: false,
+        daysRemaining: null,
+        expiresDate: null,
+      };
+    }
+
+    if (entitlement.status === 'paid') {
+      return {
+        isActive: true,
+        isPaid: true,
+        daysRemaining: null,
+        expiresDate: null,
+      };
+    }
+
+    // Trial status
+    const expiresDate = entitlement.expires;
+    if (!expiresDate) {
+      return {
+        isActive: true,
+        isPaid: false,
+        daysRemaining: null,
+        expiresDate: null,
+      };
+    }
+
+    const expires = new Date(expiresDate);
+    const now = new Date();
+    const daysLeft = Math.ceil((expires.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+
+    return {
+      isActive: daysLeft > 0,
+      isPaid: false,
+      daysRemaining: Math.max(0, daysLeft),
+      expiresDate,
+    };
+  });
+
+  /**
+   * Whether the user has premium (paid) access to the course
+   */
+  const hasPremiumAccess = computed<boolean>(() => {
+    return trialStatus.value.isPaid;
+  });
+
+  /**
+   * Fetch entitlements from the backend
+   */
+  async function fetchEntitlements(): Promise<void> {
+    loading.value = true;
+    error.value = null;
+
+    try {
+      const result = await getUserStatus();
+      if (result.ok) {
+        entitlements.value = result.entitlements || {};
+      } else {
+        error.value = result.error || 'Failed to fetch entitlements';
+        console.error('[useEntitlements] Error:', error.value);
+      }
+    } catch (e) {
+      error.value = e instanceof Error ? e.message : 'Unknown error';
+      console.error('[useEntitlements] Exception:', e);
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  return {
+    entitlements,
+    trialStatus,
+    hasPremiumAccess,
+    loading,
+    error,
+    fetchEntitlements,
+  };
+}

packages/common-ui/src/index.ts

@@ -27,6 +27,7 @@ export { default as CardHistoryViewer } from './components/CardHistoryViewer.vue
 // Composables
 export * from './composables/CompositionViewable';
 export * from './composables/Displayable';
+export * from './composables/useEntitlements';
 
 /*
   Study Session Components

packages/common-ui/src/services/authAPI.ts

@@ -52,10 +52,20 @@ export interface VerifyEmailResponse extends AuthResponse {
   username?: string;
 }
 
+export interface Entitlement {
+  status: 'trial' | 'paid';
+  registrationDate: string;
+  purchaseDate?: string;
+  expires?: string;
+}
+
+export type UserEntitlements = Record<string, Entitlement>;
+
 export interface UserStatusResponse extends AuthResponse {
   username?: string;
   status?: 'pending_verification' | 'verified' | 'suspended';
   email?: string | null;
+  entitlements?: UserEntitlements;
 }
 
 /**

packages/express/src/routes/auth.ts

@@ -175,6 +175,7 @@ router.get('/status', (req: Request, res: Response) => {
         username: userDoc.name,
         status: userDoc.status || 'pending_verification', // Default to pending if not explicitly set
         email: userDoc.email || null,
+        entitlements: userDoc.entitlements || {},
       });
     } catch (error) {
       logger.error('Error fetching user status:', error);