@speakableio/core 0.1.11 → 0.1.13

package/dist/index.mjs

@@ -753,7 +753,7 @@ var SpeakableFirebaseFunctions = {
 
 // src/domains/notification/services/send-notification.service.ts
 var _sendNotification = async (sendTo, notification) => {
-  const results = await SpeakableFirebaseFunctions.createNotification({
+  const results = await SpeakableFirebaseFunctions.createNotification?.({
     sendTo,
     // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
     notification
@@ -871,7 +871,7 @@ var createAssessmentScoredNotification = async ({
     imageUrl: profile.image?.url,
     senderName: teacherName
   });
-  await SpeakableFirebaseFunctions.sendAssessmentScoredEmail({
+  await SpeakableFirebaseFunctions.sendAssessmentScoredEmail?.({
     assessmentTitle: assignment.name,
     link: `${WEB_BASE_URL}/assignment/${assignment.id}`,
     senderImage: profile.image?.url || "",
@@ -965,6 +965,1067 @@ function useSpeakableApi() {
   if (!ctx) throw new Error("useSpeakableApi must be used within a SpeakableProvider");
   return ctx;
 }
+
+// src/domains/assignment/hooks/score-hooks.ts
+import { useMutation as useMutation2, useQuery as useQuery3 } from "@tanstack/react-query";
+
+// src/utils/debounce.utils.ts
+function debounce(func, waitFor) {
+  let timeoutId;
+  return (...args) => new Promise((resolve, reject) => {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(async () => {
+      try {
+        const result = await func(...args);
+        resolve(result);
+      } catch (error) {
+        reject(error);
+      }
+    }, waitFor);
+  });
+}
+
+// src/lib/tanstack/handle-optimistic-update-query.ts
+var handleOptimisticUpdate = async ({
+  queryClient,
+  queryKey,
+  newData
+}) => {
+  await queryClient.cancelQueries({
+    queryKey
+  });
+  const previousData = queryClient.getQueryData(queryKey);
+  if (previousData === void 0) {
+    queryClient.setQueryData(queryKey, newData);
+  } else {
+    queryClient.setQueryData(queryKey, { ...previousData, ...newData });
+  }
+  return { previousData };
+};
+
+// src/constants/speakable-plans.ts
+var FEEDBACK_PLANS = {
+  FEEDBACK_TRANSCRIPT: "FEEDBACK_TRANSCRIPT",
+  // Transcript from the audio
+  FEEDBACK_SUMMARY: "FEEDBACK_SUMMARY",
+  // Chatty summary (Free plan)
+  FEEDBACK_GRAMMAR_INSIGHTS: "FEEDBACK_GRAMMAR_INSIGHTS",
+  // Grammar insights
+  FEEDBACK_SUGGESTED_RESPONSE: "FEEDBACK_SUGGESTED_RESPONSE",
+  // Suggested Response
+  FEEDBACK_RUBRIC: "FEEDBACK_RUBRIC",
+  // Suggested Response
+  FEEDBACK_GRADING_STANDARDS: "FEEDBACK_GRADING_STANDARDS",
+  // ACTFL / WIDA Estimate
+  FEEDBACK_TARGET_LANGUAGE: "FEEDBACK_TARGET_LANGUAGE",
+  // Ability to set the feedback language to the target language of the student
+  FEEDBACK_DISABLE_ALLOW_RETRIES: "FEEDBACK_DISABLE_ALLOW_RETRIES"
+  // Turn of allow retries
+};
+var AUTO_GRADING_PLANS = {
+  AUTO_GRADING_PASS_FAIL: "AUTO_GRADING_PASS_FAIL",
+  // Pass / fail grading
+  AUTO_GRADING_RUBRICS: "AUTO_GRADING_RUBRICS",
+  // Autograded rubrics
+  AUTO_GRADING_STANDARDS_BASED: "AUTO_GRADING_STANDARDS_BASED"
+  // Standards based grading
+};
+var AI_ASSISTANT_PLANS = {
+  AI_ASSISTANT_DOCUMENT_UPLOADS: "AI_ASSISTANT_DOCUMENT_UPLOADS",
+  // Allow document uploading
+  AI_ASSISTANT_UNLIMITED_USE: "AI_ASSISTANT_UNLIMITED_USE"
+  // Allow unlimited use of AI assistant. Otherwise, limits are used.
+};
+var ASSIGNMENT_SETTINGS_PLANS = {
+  ASSESSMENTS: "ASSESSMENTS",
+  // Ability to create assessment assignment types
+  GOOGLE_CLASSROOM_GRADE_PASSBACK: "GOOGLE_CLASSROOM_GRADE_PASSBACK"
+  // Assignment scores can sync with classroom
+};
+var ANALYTICS_PLANS = {
+  ANALYTICS_GRADEBOOK: "ANALYTICS_GRADEBOOK",
+  // Access to the gradebook page
+  ANALYTICS_CLASSROOM_ANALYTICS: "ANALYTICS_CLASSROOM_ANALYTICS",
+  // Access to the classroom analytics page
+  ANALYTICS_STUDENT_PROGRESS_REPORTS: "ANALYTICS_STUDENT_PROGRESS_REPORTS",
+  // Access to the panel that shows an individual student's progress and assignments
+  ANALYTICS_ASSIGNMENT_RESULTS: "ANALYTICS_ASSIGNMENT_RESULTS",
+  // Access to the assigment RESULTS page
+  ANALYTICS_ORGANIZATION: "ANALYTICS_ORGANIZATION"
+  // Access to the organization analytics panel (for permitted admins)
+};
+var SPACES_PLANS = {
+  SPACES_CREATE_SPACE: "SPACES_CREATE_SPACE",
+  // Ability to create spaces
+  SPACES_CHECK_POINTS: "SPACES_CHECK_POINTS"
+  // Feature not available yet. Ability to create checkpoints for spaces for data aggregation
+};
+var DISCOVER_PLANS = {
+  DISCOVER_ORGANIZATION_LIBRARY: "DISCOVER_ORGANIZATION_LIBRARY"
+  // Access to the organizations shared library
+};
+var MEDIA_AREA_PLANS = {
+  MEDIA_AREA_DOCUMENT_UPLOAD: "MEDIA_AREA_DOCUMENT_UPLOAD",
+  MEDIA_AREA_AUDIO_FILES: "MEDIA_AREA_AUDIO_FILES"
+};
+var FREE_PLAN = [];
+var TEACHER_PRO_PLAN = [
+  FEEDBACK_PLANS.FEEDBACK_TRANSCRIPT,
+  FEEDBACK_PLANS.FEEDBACK_SUMMARY,
+  FEEDBACK_PLANS.FEEDBACK_TARGET_LANGUAGE,
+  AUTO_GRADING_PLANS.AUTO_GRADING_PASS_FAIL,
+  ANALYTICS_PLANS.ANALYTICS_GRADEBOOK,
+  SPACES_PLANS.SPACES_CREATE_SPACE
+  // AUTO_GRADING_PLANS.AUTO_GRADING_STANDARDS_BASED,
+];
+var SCHOOL_STARTER = [
+  FEEDBACK_PLANS.FEEDBACK_TRANSCRIPT,
+  FEEDBACK_PLANS.FEEDBACK_SUMMARY,
+  FEEDBACK_PLANS.FEEDBACK_GRAMMAR_INSIGHTS,
+  FEEDBACK_PLANS.FEEDBACK_SUGGESTED_RESPONSE,
+  FEEDBACK_PLANS.FEEDBACK_RUBRIC,
+  FEEDBACK_PLANS.FEEDBACK_GRADING_STANDARDS,
+  FEEDBACK_PLANS.FEEDBACK_DISABLE_ALLOW_RETRIES,
+  FEEDBACK_PLANS.FEEDBACK_TARGET_LANGUAGE,
+  AUTO_GRADING_PLANS.AUTO_GRADING_PASS_FAIL,
+  AUTO_GRADING_PLANS.AUTO_GRADING_RUBRICS,
+  AUTO_GRADING_PLANS.AUTO_GRADING_STANDARDS_BASED,
+  AI_ASSISTANT_PLANS.AI_ASSISTANT_DOCUMENT_UPLOADS,
+  AI_ASSISTANT_PLANS.AI_ASSISTANT_UNLIMITED_USE,
+  // ASSIGNMENT_SETTINGS_PLANS.ASSESSMENTS,
+  ASSIGNMENT_SETTINGS_PLANS.GOOGLE_CLASSROOM_GRADE_PASSBACK,
+  ANALYTICS_PLANS.ANALYTICS_GRADEBOOK,
+  ANALYTICS_PLANS.ANALYTICS_STUDENT_PROGRESS_REPORTS,
+  ANALYTICS_PLANS.ANALYTICS_CLASSROOM_ANALYTICS,
+  // ANALYTICS_PLANS.ANALYTICS_ORGANIZATION,
+  SPACES_PLANS.SPACES_CREATE_SPACE,
+  SPACES_PLANS.SPACES_CHECK_POINTS,
+  // DISCOVER_PLANS.DISCOVER_ORGANIZATION_LIBRARY,
+  MEDIA_AREA_PLANS.MEDIA_AREA_DOCUMENT_UPLOAD,
+  MEDIA_AREA_PLANS.MEDIA_AREA_AUDIO_FILES
+];
+var ORGANIZATION_PLAN = [
+  FEEDBACK_PLANS.FEEDBACK_TRANSCRIPT,
+  FEEDBACK_PLANS.FEEDBACK_SUMMARY,
+  FEEDBACK_PLANS.FEEDBACK_GRAMMAR_INSIGHTS,
+  FEEDBACK_PLANS.FEEDBACK_SUGGESTED_RESPONSE,
+  FEEDBACK_PLANS.FEEDBACK_RUBRIC,
+  FEEDBACK_PLANS.FEEDBACK_GRADING_STANDARDS,
+  FEEDBACK_PLANS.FEEDBACK_DISABLE_ALLOW_RETRIES,
+  FEEDBACK_PLANS.FEEDBACK_TARGET_LANGUAGE,
+  AUTO_GRADING_PLANS.AUTO_GRADING_PASS_FAIL,
+  AUTO_GRADING_PLANS.AUTO_GRADING_RUBRICS,
+  AUTO_GRADING_PLANS.AUTO_GRADING_STANDARDS_BASED,
+  AI_ASSISTANT_PLANS.AI_ASSISTANT_DOCUMENT_UPLOADS,
+  AI_ASSISTANT_PLANS.AI_ASSISTANT_UNLIMITED_USE,
+  ASSIGNMENT_SETTINGS_PLANS.ASSESSMENTS,
+  ASSIGNMENT_SETTINGS_PLANS.GOOGLE_CLASSROOM_GRADE_PASSBACK,
+  ANALYTICS_PLANS.ANALYTICS_GRADEBOOK,
+  ANALYTICS_PLANS.ANALYTICS_STUDENT_PROGRESS_REPORTS,
+  ANALYTICS_PLANS.ANALYTICS_CLASSROOM_ANALYTICS,
+  ANALYTICS_PLANS.ANALYTICS_ORGANIZATION,
+  SPACES_PLANS.SPACES_CREATE_SPACE,
+  SPACES_PLANS.SPACES_CHECK_POINTS,
+  DISCOVER_PLANS.DISCOVER_ORGANIZATION_LIBRARY,
+  MEDIA_AREA_PLANS.MEDIA_AREA_DOCUMENT_UPLOAD,
+  MEDIA_AREA_PLANS.MEDIA_AREA_AUDIO_FILES
+];
+var SpeakablePlanTypes = {
+  basic: "basic",
+  teacher_pro: "teacher_pro",
+  school_starter: "school_starter",
+  organization: "organization",
+  // OLD PLANS
+  starter: "starter",
+  growth: "growth",
+  professional: "professional"
+};
+var SpeakablePermissionsMap = {
+  [SpeakablePlanTypes.basic]: FREE_PLAN,
+  [SpeakablePlanTypes.starter]: TEACHER_PRO_PLAN,
+  [SpeakablePlanTypes.teacher_pro]: TEACHER_PRO_PLAN,
+  [SpeakablePlanTypes.growth]: ORGANIZATION_PLAN,
+  [SpeakablePlanTypes.professional]: ORGANIZATION_PLAN,
+  [SpeakablePlanTypes.organization]: ORGANIZATION_PLAN,
+  [SpeakablePlanTypes.school_starter]: SCHOOL_STARTER
+};
+var SpeakablePlanHierarchy = [
+  SpeakablePlanTypes.basic,
+  SpeakablePlanTypes.starter,
+  SpeakablePlanTypes.teacher_pro,
+  SpeakablePlanTypes.growth,
+  SpeakablePlanTypes.professional,
+  SpeakablePlanTypes.school_starter,
+  SpeakablePlanTypes.organization
+];
+
+// src/hooks/usePermissions.ts
+var usePermissions = () => {
+  const { permissions } = useSpeakableApi();
+  const has = (permission) => permissions.permissions?.includes(permission);
+  return {
+    plan: permissions.plan,
+    permissionsLoaded: permissions.loaded,
+    isStripePlan: permissions.isStripePlan,
+    refreshDate: permissions.refreshDate,
+    isInstitutionPlan: permissions.isInstitutionPlan,
+    subscriptionId: permissions.subscriptionId,
+    contact: permissions.contact,
+    hasGradebook: has(ANALYTICS_PLANS.ANALYTICS_GRADEBOOK),
+    hasGoogleClassroomGradePassback: has(ASSIGNMENT_SETTINGS_PLANS.GOOGLE_CLASSROOM_GRADE_PASSBACK),
+    hasAssessments: has(ASSIGNMENT_SETTINGS_PLANS.ASSESSMENTS),
+    hasSectionAnalytics: has(ANALYTICS_PLANS.ANALYTICS_CLASSROOM_ANALYTICS),
+    hasStudentReports: has(ANALYTICS_PLANS.ANALYTICS_STUDENT_PROGRESS_REPORTS),
+    permissions: permissions || [],
+    hasStudentPortfolios: permissions.hasStudentPortfolios,
+    isFreeOrgTrial: permissions.type === "free_org_trial",
+    freeOrgTrialExpired: permissions.freeOrgTrialExpired
+  };
+};
+var usePermissions_default = usePermissions;
+
+// src/hooks/useGoogleClassroom.ts
+var useGoogleClassroom = () => {
+  const submitAssignmentToGoogleClassroom = async ({
+    assignment,
+    scores,
+    googleUserId = null
+    // optional to override the user's googleUserId
+  }) => {
+    try {
+      const { googleClassroomUserId = null } = scores;
+      const googleId = googleUserId || googleClassroomUserId;
+      if (!googleId)
+        return {
+          error: true,
+          message: "No Google Classroom ID found"
+        };
+      const { courseWorkId, maxPoints, owners, courseId } = assignment;
+      const draftGrade = scores?.score ? scores?.score / 100 * maxPoints : 0;
+      const result = await SpeakableFirebaseFunctions.submitAssignmentToGoogleClassroomV2?.({
+        teacherId: owners[0],
+        courseId,
+        courseWorkId,
+        userId: googleId,
+        draftGrade
+      });
+      return result;
+    } catch (error) {
+      return { error: true, message: error.message };
+    }
+  };
+  return {
+    submitAssignmentToGoogleClassroom
+  };
+};
+
+// src/domains/assignment/utils/create-default-score.ts
+var defaultScore = (props) => {
+  const { serverTimestamp } = api.accessHelpers();
+  const score = {
+    progress: 0,
+    score: 0,
+    startDate: serverTimestamp(),
+    status: "IN_PROGRESS",
+    submitted: false,
+    cards: {},
+    lastPlayed: serverTimestamp(),
+    owners: props.owners,
+    userId: props.userId
+  };
+  if (props.googleClassroomUserId) {
+    score.googleClassroomUserId = props.googleClassroomUserId;
+  }
+  if (props.courseId) {
+    score.courseId = props.courseId;
+  }
+  return score;
+};
+
+// src/domains/assignment/score-practice.constants.ts
+var SCORES_PRACTICE_COLLECTION = "users";
+var SCORES_PRACTICE_SUBCOLLECTION = "practice";
+var refsScoresPractice = {
+  practiceScores: (params) => `${SCORES_PRACTICE_COLLECTION}/${params.userId}/${SCORES_PRACTICE_SUBCOLLECTION}/${params.setId}`,
+  practiceScoreHistoryRefDoc: (params) => `${SCORES_PRACTICE_COLLECTION}/${params.userId}/${SCORES_PRACTICE_SUBCOLLECTION}/${params.setId}/attempts/${params.date}`
+};
+
+// src/domains/assignment/services/create-score.service.ts
+async function _createScore(params) {
+  if (params.isAssignment) {
+    const ref = refsAssignmentFiresotre.assignmentScores({
+      id: params.activityId,
+      userId: params.userId
+    });
+    await SpeakableFirebaseFunctions.updateAssignmentGradebookStatus?.({
+      assignmentId: params.activityId,
+      userId: params.userId,
+      status: "IN_PROGRESS",
+      score: null
+    });
+    await api.setDoc(ref, params.scoreData, { merge: true });
+    return {
+      id: params.userId
+    };
+  } else {
+    const ref = refsScoresPractice.practiceScores({
+      userId: params.userId,
+      setId: params.activityId
+    });
+    await api.setDoc(ref, params.scoreData);
+    return {
+      id: params.userId
+    };
+  }
+}
+var createScore = withErrorHandler(_createScore, "createScore");
+
+// src/domains/assignment/services/get-score.service.ts
+async function getAssignmentScore({
+  userId,
+  assignment,
+  googleClassroomUserId
+}) {
+  const path = refsAssignmentFiresotre.assignmentScores({
+    id: assignment.id,
+    userId
+  });
+  const response = await api.getDoc(path);
+  if (response.data == null) {
+    const newScore = {
+      ...defaultScore({
+        owners: [userId],
+        userId,
+        courseId: assignment.courseId,
+        googleClassroomUserId
+      }),
+      assignmentId: assignment.id
+    };
+    const result = await createScore({
+      activityId: assignment.id,
+      userId,
+      isAssignment: true,
+      scoreData: newScore
+    });
+    return {
+      ...newScore,
+      id: result.id
+    };
+  }
+  return response.data;
+}
+async function getPracticeScore({ userId, setId }) {
+  const path = refsScoresPractice.practiceScores({ userId, setId });
+  const response = await api.getDoc(path);
+  if (response.data == null) {
+    const newScore = {
+      ...defaultScore({
+        owners: [userId],
+        userId
+      }),
+      setId
+    };
+    const result = await createScore({
+      activityId: setId,
+      userId,
+      isAssignment: false,
+      scoreData: newScore
+    });
+    return {
+      ...newScore,
+      id: result.id
+    };
+  }
+  return response.data;
+}
+async function _getScore(params) {
+  if (params.isAssignment) {
+    return await getAssignmentScore({
+      userId: params.userId,
+      assignment: {
+        id: params.activityId,
+        courseId: params.courseId
+      },
+      googleClassroomUserId: params.googleClassroomUserId
+    });
+  } else {
+    return await getPracticeScore({
+      userId: params.userId,
+      setId: params.activityId
+    });
+  }
+}
+var getScore = withErrorHandler(_getScore, "getScore");
+
+// src/domains/assignment/utils/calculateScoreAndProgress.ts
+var calculateScoreAndProgress = (scores, cardsList, weights) => {
+  const totalSetPoints = cardsList.reduce((acc, cardId) => {
+    acc += weights?.[cardId] || 1;
+    return acc;
+  }, 0);
+  const totalPointsAwarded = Object.keys(scores?.cards || {}).reduce((acc, cardId) => {
+    const cardScores = scores?.cards?.[cardId];
+    if (cardScores?.completed || cardScores?.score || cardScores?.score === 0) {
+      const score2 = cardScores?.score || cardScores?.score === 0 ? Number(cardScores?.score ?? 0) : null;
+      const weight = weights?.[cardId] || 1;
+      const fraction = (score2 ?? 0) / 100;
+      if (score2 || score2 === 0) {
+        acc += weight * fraction;
+      } else {
+        acc += weight;
+      }
+    }
+    return acc;
+  }, 0);
+  const totalCompletedCards = Object.keys(scores?.cards || {}).reduce((acc, cardId) => {
+    const cardScores = scores?.cards?.[cardId];
+    if (cardScores?.completed || cardScores?.score || cardScores?.score === 0) {
+      acc += 1;
+    }
+    return acc;
+  }, 0);
+  const percent = totalPointsAwarded / totalSetPoints;
+  const score = Math.round(percent * 100);
+  const progress = Math.round(totalCompletedCards / (cardsList.length || 1) * 100);
+  return { score, progress };
+};
+var calculateScoreAndProgress_default = calculateScoreAndProgress;
+
+// src/domains/assignment/services/update-score.service.ts
+async function _updateScore(params) {
+  const path = params.isAssignment ? refsAssignmentFiresotre.assignmentScores({
+    id: params.activityId,
+    userId: params.userId
+  }) : refsScoresPractice.practiceScores({
+    setId: params.activityId,
+    userId: params.userId
+  });
+  await api.updateDoc(path, {
+    ...params.data
+  });
+}
+var updateScore = withErrorHandler(_updateScore, "updateScore");
+async function _updateCardScore(params) {
+  const path = params.isAssignment ? refsAssignmentFiresotre.assignmentScores({
+    id: params.activityId,
+    userId: params.userId
+  }) : refsScoresPractice.practiceScores({
+    setId: params.activityId,
+    userId: params.userId
+  });
+  const updates = Object.keys(params.updates.cardScore).reduce(
+    (acc, key) => {
+      acc[`cards.${params.cardId}.${key}`] = params.updates.cardScore[key];
+      return acc;
+    },
+    {}
+  );
+  if (params.updates.progress) {
+    updates.progress = params.updates.progress;
+  }
+  if (params.updates.score) {
+    updates.score = params.updates.score;
+  }
+  await api.updateDoc(path, {
+    ...updates
+  });
+}
+var updateCardScore = withErrorHandler(_updateCardScore, "updateCardScore");
+
+// src/domains/assignment/services/clear-score.service.ts
+import dayjs3 from "dayjs";
+async function clearScore(params) {
+  const update = {
+    [`cards.${params.cardId}`]: {
+      attempts: params.cardScores.attempts ?? 1,
+      correct: params.cardScores.correct ?? 0,
+      // save old score history
+      history: [
+        {
+          ...params.cardScores,
+          attempts: params.cardScores.attempts ?? 1,
+          correct: params.cardScores.correct ?? 0,
+          retryTime: dayjs3().format("YYYY-MM-DD HH:mm:ss"),
+          history: null
+        },
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        ...params.cardScores.history ?? []
+      ]
+    }
+  };
+  const path = params.isAssignment ? refsAssignmentFiresotre.assignmentScores({
+    id: params.activityId,
+    userId: params.userId
+  }) : refsScoresPractice.practiceScores({
+    setId: params.activityId,
+    userId: params.userId
+  });
+  await api.updateDoc(path, update);
+  return {
+    update,
+    activityId: params.activityId
+  };
+}
+
+// src/domains/assignment/services/submit-assignment-score.service.ts
+import dayjs4 from "dayjs";
+async function submitAssignmentScore({
+  cardIds,
+  assignment,
+  setWeights,
+  userId,
+  status,
+  studentName
+}) {
+  const { serverTimestamp } = api.accessHelpers();
+  const path = refsAssignmentFiresotre.assignmentScores({ id: assignment.id, userId });
+  const fieldsUpdated = {
+    submitted: true,
+    progress: 100,
+    submissionDate: serverTimestamp(),
+    status
+  };
+  if (assignment.isAssessment) {
+    const result = await handleAssessment(
+      assignment,
+      userId,
+      cardIds,
+      setWeights,
+      fieldsUpdated,
+      studentName
+    );
+    return result;
+  } else if (assignment.courseId) {
+    await handleCourseAssignment(assignment, userId);
+  }
+  await api.updateDoc(path, { ...fieldsUpdated });
+  return { success: true, fieldsUpdated };
+}
+async function handleAssessment(assignment, userId, cardIds, setWeights, fieldsUpdated, studentName) {
+  const path = refsAssignmentFiresotre.assignmentScores({ id: assignment.id, userId });
+  const response = await api.getDoc(path);
+  if (!response.data) {
+    throw new Error("Score not found");
+  }
+  const { score: scoreCalculated } = calculateScoreAndProgress_default(response.data, cardIds, setWeights);
+  await api.updateDoc(path, { score: scoreCalculated, status: "PENDING_REVIEW" });
+  await SpeakableFirebaseFunctions.submitAssessment?.({
+    assignmentId: assignment.id,
+    assignmentTitle: assignment.name,
+    userId,
+    teacherId: assignment.owners[0],
+    studentName
+  });
+  fieldsUpdated.status = "PENDING_REVIEW";
+  return { success: true, fieldsUpdated };
+}
+async function handleCourseAssignment(assignment, userId) {
+  const { data } = await SpeakableFirebaseFunctions?.submitAssignmentV2?.({
+    assignmentId: assignment.id,
+    userId
+  });
+}
+async function submitPracticeScore({
+  setId,
+  userId,
+  scores
+}) {
+  const { serverTimestamp } = api.accessHelpers();
+  const date = dayjs4().format("YYYY-MM-DD-HH-mm");
+  const ref = refsScoresPractice.practiceScoreHistoryRefDoc({ setId, userId, date });
+  const fieldsUpdated = {
+    ...scores,
+    submitted: true,
+    progress: 100,
+    submissionDate: serverTimestamp(),
+    status: "SUBMITTED"
+  };
+  await api.setDoc(ref, { ...fieldsUpdated });
+  const refScores = refsScoresPractice.practiceScores({ userId, setId });
+  await api.deleteDoc(refScores);
+  return { success: true, fieldsUpdated };
+}
+
+// src/domains/assignment/hooks/score-hooks.ts
+var scoreQueryKeys = {
+  all: ["scores"],
+  byId: (id) => [...scoreQueryKeys.all, id],
+  list: () => [...scoreQueryKeys.all, "list"]
+};
+function useScore({
+  isAssignment,
+  activityId,
+  userId = "",
+  courseId,
+  enabled = true,
+  googleClassroomUserId
+}) {
+  return useQuery3({
+    queryFn: () => getScore({
+      userId,
+      courseId,
+      activityId,
+      googleClassroomUserId,
+      isAssignment
+    }),
+    queryKey: scoreQueryKeys.byId(activityId),
+    enabled
+  });
+}
+var debounceUpdateScore = debounce(updateScore, 1e3);
+function useUpdateScore() {
+  const { queryClient } = useSpeakableApi();
+  const mutation = useMutation2({
+    mutationFn: debounceUpdateScore,
+    onMutate: (variables) => {
+      return handleOptimisticUpdate({
+        queryClient,
+        queryKey: scoreQueryKeys.byId(variables.activityId),
+        newData: variables.data
+      });
+    },
+    onError: (_, variables, context) => {
+      if (context?.previousData)
+        queryClient.setQueryData(scoreQueryKeys.byId(variables.activityId), context.previousData);
+    },
+    onSettled: (_, err, variables) => {
+      queryClient.invalidateQueries({
+        queryKey: scoreQueryKeys.byId(variables.activityId)
+      });
+    }
+  });
+  return {
+    mutationUpdateScore: mutation
+  };
+}
+function useUpdateCardScore({
+  isAssignment,
+  activityId,
+  userId
+}) {
+  const { queryClient } = useSpeakableApi();
+  const querySet = useSet({ setId: activityId });
+  const dataCurrentSet = querySet.data;
+  const queryKey = scoreQueryKeys.byId(activityId);
+  const mutation = useMutation2({
+    mutationFn: async ({ cardId, cardScore }) => {
+      const previousScores = queryClient.getQueryData(queryKey);
+      const { progress, score, newScoreUpdated, updatedCardScore } = getScoreUpdated({
+        previousScores: previousScores ?? {},
+        cardId,
+        set: dataCurrentSet ?? void 0,
+        cardScore
+      });
+      await updateCardScore({
+        userId,
+        cardId,
+        isAssignment,
+        activityId,
+        updates: {
+          cardScore: updatedCardScore,
+          progress,
+          score
+        }
+      });
+      return { cardId, scoresUpdated: newScoreUpdated };
+    },
+    onMutate: ({ cardId, cardScore }) => {
+      queryClient.setQueryData(queryKey, (previousScore) => {
+        const updates = handleOptimisticScore({
+          score: previousScore,
+          cardId,
+          cardScore,
+          set: dataCurrentSet ?? void 0
+        });
+        return {
+          ...previousScore,
+          ...updates
+        };
+      });
+    },
+    // eslint-disable-next-line no-unused-vars
+    onError: () => {
+      const previousData = queryClient.getQueryData(queryKey);
+      if (previousData) {
+        queryClient.setQueryData(queryKey, previousData);
+      }
+    }
+  });
+  return {
+    mutationUpdateCardScore: mutation
+  };
+}
+var getScoreUpdated = ({
+  cardId,
+  cardScore,
+  previousScores,
+  set
+}) => {
+  const previousCard = previousScores.cards?.[cardId];
+  const newCardScore = {
+    ...previousCard ?? {},
+    ...cardScore
+  };
+  const newScores = {
+    ...previousScores,
+    cards: {
+      ...previousScores.cards ?? {},
+      [cardId]: newCardScore
+    }
+  };
+  const { score, progress } = calculateScoreAndProgress_default(
+    newScores,
+    set?.content ?? [],
+    set?.weights ?? {}
+  );
+  return {
+    newScoreUpdated: newScores,
+    updatedCardScore: cardScore,
+    score,
+    progress
+  };
+};
+var handleOptimisticScore = ({
+  score,
+  cardId,
+  cardScore,
+  set
+}) => {
+  let cards = { ...score?.cards ?? {} };
+  cards = {
+    ...cards,
+    [cardId]: {
+      ...cards[cardId],
+      ...cardScore
+    }
+  };
+  const { score: scoreValue, progress } = calculateScoreAndProgress_default(
+    // @ts-ignore
+    {
+      ...score ?? {},
+      cards
+    },
+    set?.content ?? [],
+    set?.weights ?? {}
+  );
+  return { cards, score: scoreValue, progress };
+};
+function useClearScore() {
+  const { queryClient } = useSpeakableApi();
+  const mutation = useMutation2({
+    mutationFn: clearScore,
+    onSettled: (result) => {
+      queryClient.invalidateQueries({
+        queryKey: scoreQueryKeys.byId(result?.activityId ?? "")
+      });
+    }
+  });
+  return {
+    mutationClearScore: mutation
+  };
+}
+function useSubmitAssignmentScore({
+  onAssignmentSubmitted,
+  studentName
+}) {
+  const { queryClient } = useSpeakableApi();
+  const { hasGoogleClassroomGradePassback } = usePermissions_default();
+  const { submitAssignmentToGoogleClassroom } = useGoogleClassroom();
+  const { createNotification: createNotification2 } = useCreateNotification();
+  const mutation = useMutation2({
+    mutationFn: async ({
+      assignment,
+      userId,
+      cardIds,
+      setWeights,
+      scores,
+      status
+    }) => {
+      try {
+        const scoreUpdated = await submitAssignmentScore({
+          assignment,
+          userId,
+          cardIds,
+          setWeights,
+          status,
+          studentName
+        });
+        if (assignment.courseWorkId != null && !assignment.isAssessment && hasGoogleClassroomGradePassback) {
+          await submitAssignmentToGoogleClassroom({
+            assignment,
+            scores
+          });
+        }
+        if (assignment.isAssessment) {
+          createNotification2(SpeakableNotificationTypes.ASSESSMENT_SUBMITTED, assignment);
+        }
+        onAssignmentSubmitted(assignment.id);
+        queryClient.setQueryData(scoreQueryKeys.byId(assignment.id), {
+          ...scores,
+          ...scoreUpdated.fieldsUpdated
+        });
+        return {
+          success: true,
+          message: "Score submitted successfully"
+        };
+      } catch (error) {
+        return {
+          success: false,
+          error
+        };
+      }
+    }
+  });
+  return {
+    submitAssignmentScore: mutation.mutateAsync,
+    isLoading: mutation.isPending
+  };
+}
+function useSubmitPracticeScore() {
+  const { queryClient } = useSpeakableApi();
+  const mutation = useMutation2({
+    mutationFn: async ({
+      setId,
+      userId,
+      scores
+    }) => {
+      try {
+        await submitPracticeScore({
+          setId,
+          userId,
+          scores
+        });
+        queryClient.invalidateQueries({
+          queryKey: scoreQueryKeys.byId(setId)
+        });
+        return {
+          success: true,
+          message: "Score submitted successfully"
+        };
+      } catch (error) {
+        return {
+          success: false,
+          error
+        };
+      }
+    }
+  });
+  return {
+    submitPracticeScore: mutation.mutateAsync,
+    isLoading: mutation.isPending
+  };
+}
+
+// src/hooks/useActivity.ts
+import { useEffect as useEffect2 } from "react";
+
+// src/hooks/useActivityTracker.ts
+import { v4 as v42 } from "uuid";
+function useActivityTracker({ userId }) {
+  const trackActivity = async ({
+    activityName,
+    activityType,
+    id = v42(),
+    language = ""
+  }) => {
+    if (userId) {
+      const { doc, serverTimestamp, setDoc } = api.accessHelpers();
+      const activityRef = doc(`users/${userId}/activity${id}`);
+      const timestamp = serverTimestamp();
+      await setDoc(activityRef, {
+        name: activityName,
+        type: activityType,
+        lastSeen: timestamp,
+        id,
+        language
+      });
+    }
+  };
+  return {
+    trackActivity
+  };
+}
+
+// src/hooks/useActivity.ts
+function useActivity({
+  id,
+  isAssignment,
+  onAssignmentSubmitted
+}) {
+  const { queryClient, user } = useSpeakableApi();
+  const userId = user.auth.uid;
+  const assignmentQuery = useAssignment({
+    assignmentId: id,
+    userId,
+    enabled: isAssignment
+  });
+  const activeAssignment = assignmentQuery.data;
+  const activityId = isAssignment ? activeAssignment?.setId ?? "" : id;
+  const querySet = useSet({ setId: activityId ?? "" });
+  const setData = querySet.data;
+  const { cardsObject, cardsQueries } = useCards({
+    cardIds: setData?.content ?? [],
+    enabled: querySet.isSuccess,
+    asObject: true
+  });
+  const scoreQuery = useScore({
+    isAssignment,
+    activityId: id,
+    userId,
+    courseId: activeAssignment?.courseId,
+    googleClassroomUserId: "",
+    // TODO
+    enabled: isAssignment ? assignmentQuery.isSuccess : querySet.isSuccess
+  });
+  const { mutationUpdateScore } = useUpdateScore();
+  const { mutationUpdateCardScore } = useUpdateCardScore({
+    activityId,
+    isAssignment,
+    userId
+  });
+  const { mutationClearScore } = useClearScore();
+  const { submitAssignmentScore: submitAssignmentScore2 } = useSubmitAssignmentScore({
+    onAssignmentSubmitted,
+    studentName: user.profile.displayName
+  });
+  const { submitPracticeScore: submitPracticeScore2 } = useSubmitPracticeScore();
+  const handleUpdateScore = (data) => {
+    mutationUpdateScore.mutate({
+      data,
+      isAssignment,
+      activityId,
+      userId
+    });
+  };
+  const handleUpdateCardScore = (cardId, cardScore) => {
+    mutationUpdateCardScore.mutate({ cardId, cardScore });
+  };
+  const onClearScore = ({
+    cardId,
+    wasCompleted = true
+  }) => {
+    const currentCard = cardsObject?.[cardId];
+    if (currentCard?.type === "MULTIPLE_CHOICE" /* MULTIPLE_CHOICE */ || currentCard?.type === "READ_REPEAT" /* READ_REPEAT */) {
+      return;
+    }
+    const queryKeys = scoreQueryKeys.byId(activityId);
+    const activeCardScores = queryClient.getQueryData(queryKeys)?.cards?.[cardId];
+    if (activeCardScores === void 0) return;
+    mutationClearScore.mutate({
+      isAssignment,
+      activityId,
+      cardScores: activeCardScores,
+      cardId,
+      userId
+    });
+  };
+  const onSubmitScore = async () => {
+    try {
+      let results;
+      if (isAssignment) {
+        const cardScores = scoreQuery.data?.cards || {};
+        const hasPendingReview = Object.values(cardScores).some(
+          (cardScore) => cardScore.status === "pending_review"
+        );
+        results = await submitAssignmentScore2({
+          assignment: assignmentQuery.data,
+          userId,
+          cardIds: setData?.content ?? [],
+          scores: scoreQuery.data,
+          setWeights: setData?.weights ?? {},
+          status: hasPendingReview ? "PENDING_REVIEW" : "FINALIZED"
+        });
+      } else {
+        results = await submitPracticeScore2({
+          setId: querySet.data?.id ?? "",
+          userId,
+          scores: scoreQuery.data
+        });
+      }
+      return results;
+    } catch (error) {
+      return {
+        success: false,
+        error
+      };
+    }
+  };
+  useInitActivity({
+    assignment: activeAssignment ?? void 0,
+    set: setData ?? void 0,
+    enabled: !!setData,
+    userId
+  });
+  return {
+    set: {
+      data: setData,
+      query: querySet
+    },
+    cards: {
+      data: cardsObject,
+      query: cardsQueries
+      // activeCardData,
+    },
+    assignment: {
+      data: isAssignment ? activeAssignment : void 0,
+      query: assignmentQuery
+    },
+    scores: {
+      data: scoreQuery.data,
+      query: scoreQuery,
+      // activeCardScores,
+      actions: {
+        update: handleUpdateScore,
+        clear: onClearScore,
+        submit: onSubmitScore,
+        updateCard: handleUpdateCardScore,
+        logGradingStandardEntry: () => {
+        }
+      }
+    }
+  };
+}
+var useInitActivity = ({
+  assignment,
+  set,
+  enabled,
+  userId
+}) => {
+  const { trackActivity } = useActivityTracker({ userId });
+  const init = () => {
+    if (!enabled) return;
+    if (!assignment) {
+      trackActivity({
+        activityName: set?.name ?? "",
+        activityType: "set",
+        id: set?.id,
+        language: set?.language
+      });
+    } else if (assignment.name) {
+      trackActivity({
+        activityName: assignment.name,
+        activityType: assignment.isAssessment ? "assessment" : "assignment",
+        id: assignment.id,
+        language: set?.language
+      });
+    }
+    if (set?.public) {
+      SpeakableFirebaseFunctions?.onSetOpened?.({
+        setId: set.id,
+        language: set.language
+      });
+    }
+    SpeakableFirebaseFunctions?.updateAlgoliaIndex?.({
+      updatePlays: true,
+      objectID: set?.id
+    });
+  };
+  useEffect2(() => {
+    init();
+  }, [set]);
+};
 export {
   ALLOWED_CARD_ACTIVITY_TYPES_FOR_SUMMARY,
   BASE_MULTIPLE_CHOICE_FIELD_VALUES,
@@ -998,6 +2059,7 @@ export {
   setsQueryKeys,
   updateCardInCache,
   updateSetInCache,
+  useActivity,
   useAssignment,
   useCards,
   useCreateCard,