@edpire/sdk 0.6.12 → 0.8.0

package/dist/client.d.mts

@@ -1,4 +1,5 @@
 import { RuntimeAnswer } from '@youssefalmia/edpire-runtime';
+import { RichContent } from '@youssefalmia/edpire-schema/authoring';
 
 /** Flat per-question answer collected during a custom player session. */
 interface StoredAnswer {
@@ -10,6 +11,191 @@ interface StoredAnswer {
     answers: RuntimeAnswer[];
 }
 
+/**
+ * Public types for the polished Assessment Shell.
+ *
+ * The shell renders the same UI used at edpire.com's hosted player.
+ * Consumers using the EdpireAssessment.mount() API get these types
+ * indirectly via MountOptions; consumers rendering <AssessmentShell>
+ * directly import them from "@edpire/sdk/react".
+ */
+
+/** Branding payload accepted by AssessmentShell. Mirrors what edpire.com sends. */
+interface TakeBranding {
+    /** Org display name — shown as the alt text on the logo. */
+    name: string;
+    /** Logo URL (any https URL). When absent, the Edpire logo is shown. */
+    logoUrl: string | null;
+    branding: {
+        /** CSS color for the primary action buttons (Submit, View Report, etc.). */
+        primaryColor?: string;
+        /** CSS color used as the background of the top bar and per-exercise headers. */
+        accentColor?: string;
+        /** font-family applied to the shell. Pair with `fontUrl` for non-system fonts. */
+        fontFamily?: string;
+        /** A Google Fonts stylesheet URL; the shell injects a <link> tag at mount. */
+        fontUrl?: string;
+        /** When false, the "Powered by Edpire" watermark is hidden. Default true. */
+        showPoweredBy?: boolean;
+    } | null;
+}
+
+/**
+ * Public types for the Edpire Embeddable JS SDK.
+ */
+
+type NodeFeedbackStatus = "correct" | "partial" | "incorrect" | "awaiting_review";
+interface EmbedResult {
+    submission_id: string;
+    score: number;
+    max_score: number;
+    percentage: number;
+    passed: boolean;
+    passing_score_percent: number;
+    attempt_number: number;
+    /** True when the submission contains open-response nodes still pending teacher review. */
+    awaiting_manual_grading?: boolean;
+    exercise_results: Array<{
+        exercise_id: string;
+        total_score: number;
+        max_score: number;
+        question_results: Array<{
+            question_id: string;
+            score: number;
+            correct: boolean;
+            points: number;
+        }>;
+    }>;
+    exercise_feedback: Array<{
+        exercise_id: string;
+        questions: Array<{
+            question_id: string;
+            node_results: Array<{
+                node_id: string;
+                status: NodeFeedbackStatus;
+                score: number;
+                max_score: number;
+                feedback?: string;
+                display_answer?: string;
+                detail?: {
+                    type: "choiceSet";
+                    correctChoiceIds: string[];
+                } | {
+                    type: "matchingSet";
+                    pairFeedback: Array<{
+                        leftId: string;
+                        rightId: string;
+                        correct: boolean;
+                    }>;
+                    correctPairings: Array<{
+                        leftId: string;
+                        rightId: string;
+                    }>;
+                };
+                /**
+                 * The teacher's written feedback on an open response. Only ever present
+                 * in a review (`GET /submissions/{id}/review`), since at submit time no
+                 * teacher has graded anything yet.
+                 */
+                teacher_feedback?: RichContent[];
+            }>;
+        }>;
+    }>;
+}
+/**
+ * Response of `GET /api/v1/submissions/{id}/review`: one finished attempt, with
+ * everything needed to draw it as the corrected paper. Fetch it on your server
+ * (it needs an API key with `read:results`), send it to the browser, and pass it
+ * to `EdpireAssessment.review()` unchanged.
+ */
+interface SubmissionReview {
+    submission: {
+        id: string;
+        assessment_id: string;
+        learner_ref: string | null;
+        status: string;
+        attempt_number: number;
+        /** How many attempts this learner has made at this assessment, this one included. */
+        total_attempts: number;
+        score: number;
+        max_score: number;
+        percentage: number;
+        passed: boolean;
+        passing_score_percent: number;
+        is_fully_graded: boolean;
+        /**
+         * True while a teacher still has open responses to grade. `score`,
+         * `percentage` and `passed` are provisional until it turns false, and the
+         * player hides them.
+         */
+        awaiting_manual_grading: boolean;
+        submitted_at: string | null;
+    };
+    assessment: AssessmentLoaderResponse["assessment"];
+    meta: Omit<AssessmentLoaderResponse["meta"], "type">;
+    branding?: TakeBranding | null;
+    /** The learner's answers, in the shape the player collected them. */
+    answers: {
+        exerciseAnswers: Array<{
+            exerciseId: string;
+            questionAnswers: Array<{
+                questionId: string;
+                answers: RuntimeAnswer[];
+            }>;
+        }>;
+    };
+    exercise_feedback: EmbedResult["exercise_feedback"];
+}
+interface AssessmentLoaderResponse {
+    assessment: {
+        /**
+         * Assessment-level annex — reading texts, figures, formula sheets. The
+         * player shows it as a side panel on wide screens and a drawer on narrow
+         * ones. Null when the assessment has none.
+         */
+        annex?: unknown | null;
+        exercises: Array<{
+            id: string;
+            sharedContext: unknown | null;
+            questions: Array<{
+                id: string;
+                version: "1.0";
+                content: unknown;
+                /** Sent by the content loader, not by a review. Nothing in the player reads either. */
+                points?: number;
+                sequenceNumber?: number;
+                answerKeys: never[];
+            }>;
+        }>;
+    };
+    meta: {
+        id: string;
+        title: string;
+        type: string;
+        category?: string | null;
+        /**
+         * The assessment's learner-facing language, which also decides text
+         * direction. The player uses this unless the host passes `locale`
+         * explicitly, so a French assessment reads left-to-right even when embedded
+         * in a right-to-left product.
+         */
+        language?: "en" | "fr" | "ar";
+        settings: {
+            time_limit_minutes: number | null;
+            passing_score_percent: number;
+            allowed_attempts: number;
+            show_solutions: string;
+        };
+    };
+    attempt_info: {
+        attempt_number: number;
+        can_retry: boolean;
+        attempts_remaining: number | null;
+    };
+    /** Org branding loaded server-side. May be overridden by MountOptions.branding. */
+    branding?: TakeBranding | null;
+}
+
 /**
  * @edpire/sdk/client — Server-side API client for Edpire.
  *
@@ -225,23 +411,6 @@ interface Submission {
         result: unknown;
     }>;
 }
-interface Collection {
-    id: string;
-    name: string;
-    slug: string;
-    description: string | null;
-    status: string;
-    item_count: number;
-    created_at: string;
-    updated_at: string;
-}
-interface CollectionDetail extends Collection {
-    items: Array<{
-        id: string;
-        position: number;
-        assessment: Assessment;
-    }>;
-}
 interface Webhook {
     id: string;
     url: string;
@@ -362,52 +531,36 @@ declare class EdpireClient {
      * @throws {EdpireError} 404 if not found, 401/403 for auth issues.
      */
     getSubmission(id: string): Promise<Submission>;
+    /**
+     * Fetch one finished attempt as the corrected paper: content, the learner's
+     * answers and the marking. Send the result to the browser and pass it to
+     * `EdpireAssessment.review()` unchanged.
+     *
+     * @param id - Submission UUID.
+     * @param params.learnerRef - The learner you believe owns it. When given, a
+     *   submission belonging to anyone else is a 404, so a bug in your own
+     *   ownership check cannot show one learner another's paper. Always pass it.
+     * @throws {EdpireError} 404 (not found, or not this learner's), 409 (not
+     *   submitted yet, or the assessment has been unpublished since).
+     */
+    getSubmissionReview(id: string, params?: {
+        learnerRef?: string;
+    }): Promise<SubmissionReview>;
     /**
      * Fetch all submissions for a learner.
      *
      * @param learnerRef - Your stable user ID (the `learner_ref` you passed during submit).
+     * @param params.assessmentId - Only this assessment's attempts.
      * @param params.page - Page number (default 1).
      * @param params.limit - Items per page (default 50, max 100).
      * @returns Paginated list of submissions.
      * @throws {EdpireError} 401/403 for auth issues.
      */
     getLearnerResults(learnerRef: string, params?: {
+        assessmentId?: string;
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<Submission>>;
-    /**
-     * List collections in your org.
-     *
-     * @param params.page - Page number (default 1).
-     * @param params.limit - Items per page (default 20, max 100).
-     * @returns Paginated list of collections with item counts.
-     */
-    getCollections(params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<PaginatedResponse<Collection>>;
-    /**
-     * Fetch a collection with its assessment items.
-     *
-     * @param id - Collection UUID.
-     * @returns Collection detail with ordered assessment items.
-     * @throws {EdpireError} 404 if not found.
-     */
-    getCollection(id: string): Promise<CollectionDetail>;
-    /**
-     * Fetch aggregated results across all assessments in a collection.
-     *
-     * @param id - Collection UUID.
-     * @param params.page - Page number (default 1).
-     * @param params.limit - Items per page (default 50, max 100).
-     * @returns Paginated flat list of submissions with assessment titles.
-     */
-    getCollectionResults(id: string, params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<PaginatedResponse<Submission & {
-        assessment_title: string;
-    }>>;
     /**
      * Register a webhook endpoint.
      *
@@ -578,4 +731,4 @@ declare function createEdpireTokenHandler(opts: EdpireTokenHandlerOptions): (req
  */
 declare function toNodeHandler(handler: (req: Request) => Promise<Response>): (req: ConnectRequest, res: ConnectResponse) => void;
 
-export { type Assessment, type AssessmentExercise, type AssessmentQuestion, type AssessmentSummary, type CheckOptions, type CheckResult, type Collection, type CollectionDetail, EdpireClient, type EdpireClientOptions, EdpireError, type EdpireTokenHandlerOptions, type EmbedToken, type GradeResult, type PaginatedResponse, type StoredAnswer, type Submission, type SubmitOptions, type Webhook, type WebhookWithSecret, createEdpireTokenHandler, toNodeHandler };
+export { type Assessment, type AssessmentExercise, type AssessmentQuestion, type AssessmentSummary, type CheckOptions, type CheckResult, EdpireClient, type EdpireClientOptions, EdpireError, type EdpireTokenHandlerOptions, type EmbedToken, type GradeResult, type PaginatedResponse, type StoredAnswer, type Submission, type SubmissionReview, type SubmitOptions, type Webhook, type WebhookWithSecret, createEdpireTokenHandler, toNodeHandler };

package/dist/client.mjs

@@ -182,10 +182,27 @@ var EdpireClient = class {
   async getSubmission(id) {
     return this.request("GET", `/submissions/${id}`);
   }
+  /**
+   * Fetch one finished attempt as the corrected paper: content, the learner's
+   * answers and the marking. Send the result to the browser and pass it to
+   * `EdpireAssessment.review()` unchanged.
+   *
+   * @param id - Submission UUID.
+   * @param params.learnerRef - The learner you believe owns it. When given, a
+   *   submission belonging to anyone else is a 404, so a bug in your own
+   *   ownership check cannot show one learner another's paper. Always pass it.
+   * @throws {EdpireError} 404 (not found, or not this learner's), 409 (not
+   *   submitted yet, or the assessment has been unpublished since).
+   */
+  async getSubmissionReview(id, params) {
+    const query = params?.learnerRef ? `?learner_ref=${encodeURIComponent(params.learnerRef)}` : "";
+    return this.request("GET", `/submissions/${id}/review${query}`);
+  }
   /**
    * Fetch all submissions for a learner.
    *
    * @param learnerRef - Your stable user ID (the `learner_ref` you passed during submit).
+   * @param params.assessmentId - Only this assessment's attempts.
    * @param params.page - Page number (default 1).
    * @param params.limit - Items per page (default 50, max 100).
    * @returns Paginated list of submissions.
@@ -194,6 +211,7 @@ var EdpireClient = class {
   async getLearnerResults(learnerRef, params) {
     const query = new URLSearchParams();
     query.set("learner_ref", learnerRef);
+    if (params?.assessmentId) query.set("assessment_id", params.assessmentId);
     if (params?.page) query.set("page", String(params.page));
     if (params?.limit) query.set("limit", String(params.limit));
     return this.requestPaginated(
@@ -201,46 +219,6 @@ var EdpireClient = class {
       `/learners/${encodeURIComponent(learnerRef)}/results?${query.toString()}`
     );
   }
-  // ── Collections ────────────────────────────────────────────────────────
-  /**
-   * List collections in your org.
-   *
-   * @param params.page - Page number (default 1).
-   * @param params.limit - Items per page (default 20, max 100).
-   * @returns Paginated list of collections with item counts.
-   */
-  async getCollections(params) {
-    const query = new URLSearchParams();
-    if (params?.page) query.set("page", String(params.page));
-    if (params?.limit) query.set("limit", String(params.limit));
-    const qs = query.toString();
-    return this.requestPaginated("GET", `/collections${qs ? `?${qs}` : ""}`);
-  }
-  /**
-   * Fetch a collection with its assessment items.
-   *
-   * @param id - Collection UUID.
-   * @returns Collection detail with ordered assessment items.
-   * @throws {EdpireError} 404 if not found.
-   */
-  async getCollection(id) {
-    return this.request("GET", `/collections/${id}`);
-  }
-  /**
-   * Fetch aggregated results across all assessments in a collection.
-   *
-   * @param id - Collection UUID.
-   * @param params.page - Page number (default 1).
-   * @param params.limit - Items per page (default 50, max 100).
-   * @returns Paginated flat list of submissions with assessment titles.
-   */
-  async getCollectionResults(id, params) {
-    const query = new URLSearchParams();
-    if (params?.page) query.set("page", String(params.page));
-    if (params?.limit) query.set("limit", String(params.limit));
-    const qs = query.toString();
-    return this.requestPaginated("GET", `/collections/${id}/results${qs ? `?${qs}` : ""}`);
-  }
   // ── Webhooks ───────────────────────────────────────────────────────────
   /**
    * Register a webhook endpoint.

package/dist/core.d.mts

@@ -1,4 +1,5 @@
 import { RuntimeAnswer } from '@youssefalmia/edpire-runtime';
+import { RichContent } from '@youssefalmia/edpire-schema/authoring';
 
 /** Flat per-question answer collected during a custom player session. */
 interface StoredAnswer {
@@ -44,6 +45,191 @@ declare function buildSubmitPayload(stored: StoredAnswer[]): {
     }>;
 };
 
+/**
+ * Public types for the polished Assessment Shell.
+ *
+ * The shell renders the same UI used at edpire.com's hosted player.
+ * Consumers using the EdpireAssessment.mount() API get these types
+ * indirectly via MountOptions; consumers rendering <AssessmentShell>
+ * directly import them from "@edpire/sdk/react".
+ */
+
+/** Branding payload accepted by AssessmentShell. Mirrors what edpire.com sends. */
+interface TakeBranding {
+    /** Org display name — shown as the alt text on the logo. */
+    name: string;
+    /** Logo URL (any https URL). When absent, the Edpire logo is shown. */
+    logoUrl: string | null;
+    branding: {
+        /** CSS color for the primary action buttons (Submit, View Report, etc.). */
+        primaryColor?: string;
+        /** CSS color used as the background of the top bar and per-exercise headers. */
+        accentColor?: string;
+        /** font-family applied to the shell. Pair with `fontUrl` for non-system fonts. */
+        fontFamily?: string;
+        /** A Google Fonts stylesheet URL; the shell injects a <link> tag at mount. */
+        fontUrl?: string;
+        /** When false, the "Powered by Edpire" watermark is hidden. Default true. */
+        showPoweredBy?: boolean;
+    } | null;
+}
+
+/**
+ * Public types for the Edpire Embeddable JS SDK.
+ */
+
+type NodeFeedbackStatus = "correct" | "partial" | "incorrect" | "awaiting_review";
+interface EmbedResult {
+    submission_id: string;
+    score: number;
+    max_score: number;
+    percentage: number;
+    passed: boolean;
+    passing_score_percent: number;
+    attempt_number: number;
+    /** True when the submission contains open-response nodes still pending teacher review. */
+    awaiting_manual_grading?: boolean;
+    exercise_results: Array<{
+        exercise_id: string;
+        total_score: number;
+        max_score: number;
+        question_results: Array<{
+            question_id: string;
+            score: number;
+            correct: boolean;
+            points: number;
+        }>;
+    }>;
+    exercise_feedback: Array<{
+        exercise_id: string;
+        questions: Array<{
+            question_id: string;
+            node_results: Array<{
+                node_id: string;
+                status: NodeFeedbackStatus;
+                score: number;
+                max_score: number;
+                feedback?: string;
+                display_answer?: string;
+                detail?: {
+                    type: "choiceSet";
+                    correctChoiceIds: string[];
+                } | {
+                    type: "matchingSet";
+                    pairFeedback: Array<{
+                        leftId: string;
+                        rightId: string;
+                        correct: boolean;
+                    }>;
+                    correctPairings: Array<{
+                        leftId: string;
+                        rightId: string;
+                    }>;
+                };
+                /**
+                 * The teacher's written feedback on an open response. Only ever present
+                 * in a review (`GET /submissions/{id}/review`), since at submit time no
+                 * teacher has graded anything yet.
+                 */
+                teacher_feedback?: RichContent[];
+            }>;
+        }>;
+    }>;
+}
+/**
+ * Response of `GET /api/v1/submissions/{id}/review`: one finished attempt, with
+ * everything needed to draw it as the corrected paper. Fetch it on your server
+ * (it needs an API key with `read:results`), send it to the browser, and pass it
+ * to `EdpireAssessment.review()` unchanged.
+ */
+interface SubmissionReview {
+    submission: {
+        id: string;
+        assessment_id: string;
+        learner_ref: string | null;
+        status: string;
+        attempt_number: number;
+        /** How many attempts this learner has made at this assessment, this one included. */
+        total_attempts: number;
+        score: number;
+        max_score: number;
+        percentage: number;
+        passed: boolean;
+        passing_score_percent: number;
+        is_fully_graded: boolean;
+        /**
+         * True while a teacher still has open responses to grade. `score`,
+         * `percentage` and `passed` are provisional until it turns false, and the
+         * player hides them.
+         */
+        awaiting_manual_grading: boolean;
+        submitted_at: string | null;
+    };
+    assessment: AssessmentLoaderResponse["assessment"];
+    meta: Omit<AssessmentLoaderResponse["meta"], "type">;
+    branding?: TakeBranding | null;
+    /** The learner's answers, in the shape the player collected them. */
+    answers: {
+        exerciseAnswers: Array<{
+            exerciseId: string;
+            questionAnswers: Array<{
+                questionId: string;
+                answers: RuntimeAnswer[];
+            }>;
+        }>;
+    };
+    exercise_feedback: EmbedResult["exercise_feedback"];
+}
+interface AssessmentLoaderResponse {
+    assessment: {
+        /**
+         * Assessment-level annex — reading texts, figures, formula sheets. The
+         * player shows it as a side panel on wide screens and a drawer on narrow
+         * ones. Null when the assessment has none.
+         */
+        annex?: unknown | null;
+        exercises: Array<{
+            id: string;
+            sharedContext: unknown | null;
+            questions: Array<{
+                id: string;
+                version: "1.0";
+                content: unknown;
+                /** Sent by the content loader, not by a review. Nothing in the player reads either. */
+                points?: number;
+                sequenceNumber?: number;
+                answerKeys: never[];
+            }>;
+        }>;
+    };
+    meta: {
+        id: string;
+        title: string;
+        type: string;
+        category?: string | null;
+        /**
+         * The assessment's learner-facing language, which also decides text
+         * direction. The player uses this unless the host passes `locale`
+         * explicitly, so a French assessment reads left-to-right even when embedded
+         * in a right-to-left product.
+         */
+        language?: "en" | "fr" | "ar";
+        settings: {
+            time_limit_minutes: number | null;
+            passing_score_percent: number;
+            allowed_attempts: number;
+            show_solutions: string;
+        };
+    };
+    attempt_info: {
+        attempt_number: number;
+        can_retry: boolean;
+        attempts_remaining: number | null;
+    };
+    /** Org branding loaded server-side. May be overridden by MountOptions.branding. */
+    branding?: TakeBranding | null;
+}
+
 /**
  * @edpire/sdk/client — Server-side API client for Edpire.
  *
@@ -146,4 +332,103 @@ interface FlatStep {
  */
 declare function flattenAssessment(assessment: Assessment): FlatStep[];
 
-export { type FlatStep, type StoredAnswer, buildSubmitPayload, flattenAssessment };
+/**
+ * flattenReview: a finished attempt as a linear sequence of steps, one per
+ * question, each ready to hand to `renderQuestion()` read-only.
+ *
+ * The review counterpart of `flattenAssessment()`. Where the full paper
+ * (`EdpireAssessment.review()`) draws the whole attempt at once, this is for
+ * flows that show one question per screen, Arcade-style, and want the learner
+ * to page back through a past attempt the same way they took it.
+ *
+ * @example
+ * const review = await fetch(`/api/attempts/${id}/review`).then((r) => r.json())
+ * const steps = flattenReview(review)
+ *
+ * const q = renderQuestion({
+ *   container: "#question",
+ *   content: steps[i].content,
+ *   initialAnswers: steps[i].answers,
+ *   feedback: steps[i].feedback,
+ *   readOnly: true,
+ * })
+ * // steps[i].status, steps[i].score / steps[i].maxScore for your own chrome
+ *
+ * Pure: no React, no DOM. Also exported from `@edpire/sdk/core`.
+ */
+
+interface ReviewStep {
+    exerciseId: string;
+    questionId: string;
+    /** ContentAST. Pass to renderQuestion's `content`. */
+    content: unknown;
+    /**
+     * The exercise's shared context (reading passage, figure, worked example),
+     * or null. Unlike `flattenAssessment()`, carried on every step: a
+     * comprehension question reviewed without its passage makes no sense.
+     * Render it with renderQuestion too; it is plain content.
+     */
+    sharedContext: unknown | null;
+    /** What the learner answered. Pass to renderQuestion's `initialAnswers`. */
+    answers: RuntimeAnswer[];
+    /**
+     * The marking, in the same shape POST /check returns, so it goes straight
+     * into renderQuestion's `feedback`. Includes the expected answer on anything
+     * missed and the teacher's comment on an open response.
+     */
+    feedback: Record<string, unknown>;
+    score: number;
+    maxScore: number;
+    /**
+     * The question as a whole. `awaiting_review` while a teacher has yet to mark
+     * any part of it; its score is then provisional. `unscored` when it is worth
+     * nothing (no answerable input, or 0 points): there was nothing to get
+     * wrong, so do not show it as wrong.
+     */
+    status: "correct" | "partial" | "incorrect" | "awaiting_review" | "unscored";
+    /** 0-based position, in the order the assessment presents questions. */
+    index: number;
+}
+/**
+ * The order is the assessment's (exercises, then questions within each), not
+ * the order a shuffled Arcade attempt happened to show. Edpire does not record
+ * the order an attempt was presented in; store it yourself if you need to
+ * replay it exactly.
+ */
+declare function flattenReview(review: SubmissionReview): ReviewStep[];
+
+/**
+ * "Did the learner actually answer this?"
+ *
+ * Used to warn before submit when questions are left blank. The whole module
+ * exists because the obvious implementation is wrong: every player emits a
+ * RuntimeAnswer on mount, so a freshly-opened assessment already reports one
+ * answer per node. A typed blank emits `{ mode: "typed", text: "" }`, a choice
+ * set emits `{ selectedIds: [] }`. Counting answers would report every
+ * assessment fully answered and the warning would never fire.
+ *
+ * The expected node count comes from the content AST, never from `answerKeys`.
+ * A learner-facing payload ships `answerKeys: []` on purpose (see
+ * `getAssessmentForTaking`), so a key-based count works in the builder preview
+ * and silently never fires for a real learner, which is the worst of both.
+ */
+
+/**
+ * True when this answer carries something the learner actually supplied.
+ *
+ * The `switch` is exhaustive over RuntimeAnswer so adding a variant upstream
+ * fails the build here rather than silently defaulting. The runtime fallback is
+ * still `true`: a variant we do not recognise should not make the learner sit
+ * through a warning they cannot clear, because a warning that cries wolf gets
+ * clicked through and stops protecting anyone.
+ */
+declare function isAnswered(answer: RuntimeAnswer): boolean;
+/**
+ * How many inputs this question's content AST presents to the learner.
+ *
+ * Walks the tree rather than the top level: blanks are inline inside
+ * paragraphs, and any node can sit inside a table cell or blockquote.
+ */
+declare function countAnswerableNodes(content: unknown): number;
+
+export { type FlatStep, type ReviewStep, type StoredAnswer, type SubmissionReview, buildSubmitPayload, countAnswerableNodes, flattenAssessment, flattenReview, isAnswered };