@iblai/data-layer 1.12.1 → 1.12.4

package/dist/src/features/grading/constants.d.ts

@@ -33,8 +33,21 @@ export declare const GRADING_ENDPOINTS: {
         service: SERVICES;
         path: (org: string, mentorId: string, criterionId: number) => string;
     };
+    LIST_GRADE_RESULTS: {
+        service: SERVICES;
+        path: (org: string, mentorId: string) => string;
+    };
+    GET_GRADE_RESULT: {
+        service: SERVICES;
+        path: (org: string, mentorId: string, resultId: string) => string;
+    };
+    OVERRIDE_GRADE_RESULT: {
+        service: SERVICES;
+        path: (org: string, mentorId: string, resultId: string) => string;
+    };
 };
 export declare const GRADING_QUERY_KEYS: {
     GET_GRADER_CONFIGURATION: () => string[];
     GET_GRADER_CRITERIA: () => string[];
+    GET_GRADE_RESULTS: () => string[];
 };

package/dist/src/features/grading/types.d.ts

@@ -83,3 +83,95 @@ export type GetGraderCriterionArgs = {
     mentorId: string;
     criterionId: number;
 };
+export type GradeResultPublishStatus = 'pending' | 'published' | 'failed';
+export interface GradeResultStudent {
+    username: string;
+    email: string;
+    name: string;
+}
+export interface GradeResultMentor {
+    unique_id: string;
+    name: string;
+}
+export interface GradeResultPlatform {
+    platform_key: string;
+}
+/** List representation: enough to render a gradebook row. */
+export interface GradeResult {
+    id: string;
+    mentor: GradeResultMentor;
+    student: GradeResultStudent;
+    platform: GradeResultPlatform;
+    /** Normalized percentage score between 0 and 1. */
+    score: number;
+    /** Normalized percentage score between 0 and 1. */
+    override_score: number | null;
+    effective_score: number;
+    /** Whether the AI score reached the LMS. */
+    status: GradeResultPublishStatus;
+    /** Whether the most recent override reached the LMS (null when never overridden). */
+    override_status: GradeResultPublishStatus | null;
+    graded_at: string;
+    overridden_at: string | null;
+}
+/** Full representation, including the override and publish record. */
+export interface GradeResultDetail extends GradeResult {
+    session_id: string;
+    feedback: string;
+    /** Snapshot of the rubric used at grading time. */
+    rubric_snapshot: unknown;
+    /** Additional metadata from the evaluation (e.g. per-criterion scores). */
+    evaluation_metadata: unknown;
+    total_points: number;
+    published_at: string | null;
+    /** The override expressed the way the rubric author wrote it. */
+    override_points: number | null;
+    override_feedback: string;
+    /** edX username */
+    overridden_by: string | null;
+}
+export interface PaginatedGradeResultList {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: GradeResult[];
+}
+export type ListGradeResultsArgs = {
+    org: string;
+    mentorId: string;
+    /** Case-insensitive learner email filter. */
+    email?: string;
+    /** Exact learner username filter. */
+    username?: string;
+    /** Publish status of the AI score. */
+    status?: GradeResultPublishStatus;
+    /** Publish status of the most recent override. */
+    override_status?: GradeResultPublishStatus;
+    /** ISO datetime lower bound on graded_at. */
+    graded_at_after?: string;
+    /** ISO datetime upper bound on graded_at. */
+    graded_at_before?: string;
+    /** Which field to use when ordering the results (most recent first by default). */
+    ordering?: string;
+    page?: number;
+    page_size?: number;
+};
+export type GetGradeResultArgs = {
+    org: string;
+    mentorId: string;
+    resultId: string;
+};
+/**
+ * PATCH body for an override. `override_points` is in rubric points
+ * (0 to `total_points`); null clears the override and restores the AI score.
+ */
+export type OverrideGradeResultRequest = {
+    override_points?: number | null;
+    override_feedback?: string;
+};
+export type OverrideGradeResultArgs = {
+    org: string;
+    mentorId: string;
+    resultId: string;
+    formData: OverrideGradeResultRequest;
+};