@happyvertical/smrt-education 0.57.43 → 0.57.44

package/dist/question-response-service.d.ts

@@ -0,0 +1,63 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type LearnerRequest, LearnerService } from './learner-service.js';
+import { type LearnerLessonView, type QuestionAssistance } from './question-contracts.js';
+import { type LessonQuestionResponses, type QuestionResponseContent, type QuestionResponseView } from './question-response-contracts.js';
+type LessonRequest = LearnerRequest & {
+    enrollmentId: string;
+    lessonId: string;
+};
+export type RecordQuestionResponseRequest = LessonRequest & {
+    questionRevisionId: string;
+    requestKey: string;
+    response: QuestionResponseContent;
+    /** Learners record online responses; printable/interactive need their own path. */
+    completionMode?: 'online';
+    assistance?: QuestionAssistance;
+    /** Names the response this one corrects; omit for a new attempt. */
+    correctsResponseId?: string;
+};
+export type GuardianCorrectionRequest = LessonRequest & {
+    questionRevisionId: string;
+    requestKey: string;
+    correctsResponseId: string;
+    /** Omit to record assistance only: the corrected response's answer is kept. */
+    response?: QuestionResponseContent;
+    assistance?: QuestionAssistance;
+};
+/**
+ * Guarded write path for learner question responses (SMRT #4515). Extends the
+ * learner boundary: the actor must be the learner (own enrollment) to record,
+ * or the authorized guardian to review/correct; the question revision must be in
+ * the enrollment's effective lesson set. Rows are append-only; question
+ * revisions are never written.
+ */
+export declare class QuestionResponseService extends LearnerService {
+    protected createTransactionService(db: DatabaseInterface): this;
+    /** The learner records an online attempt, or corrects their own response. */
+    recordResponse(request: RecordQuestionResponseRequest): Promise<QuestionResponseView>;
+    /** A guardian appends a correction and/or assistance note; never overwrites. */
+    recordGuardianCorrection(request: GuardianCorrectionRequest): Promise<QuestionResponseView>;
+    /**
+     * The lesson's questions and recorded responses. The audience follows the
+     * actor: the learner gets the keyless bundle, an authorized guardian the
+     * keyed one. It is never a request choice.
+     */
+    readLessonResponses(request: LessonRequest): Promise<LessonQuestionResponses>;
+    /**
+     * One effective lesson for rendering, learner-safe. The audience is the same
+     * for the learner and an authorized guardian (`education.learner.read`, own or
+     * guardian relationship): the keyless bundle and an allowlisted lesson, never
+     * answer keys, rubrics, provenance, materials, source locators or the body of
+     * a personal-use-copy lesson. Keys are read through `QuestionAuthoringService.
+     * readReleasedLesson` (`read-draft`). A lesson outside the enrollment's
+     * effective set is a `QuestionResponseScopeError`.
+     */
+    readReleasedLesson(request: LessonRequest): Promise<LearnerLessonView>;
+    private view;
+    /** Effective lesson row to its immutable lesson revision's ordered question refs. */
+    private lessonQuestions;
+    private revisionRow;
+    private write;
+}
+export {};
+//# sourceMappingURL=question-response-service.d.ts.map

package/dist/question-response-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-response-service.d.ts","sourceRoot":"","sources":["../src/question-response-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,OAAO,EAEL,KAAK,cAAc,EACnB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,iBAAiB,EAItB,KAAK,kBAAkB,EAOxB,MAAM,yBAAyB,CAAC;AAWjC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAI5B,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAqH1C,KAAK,aAAa,GAAG,cAAc,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,6BAA6B,GAAG,aAAa,GAAG;IAC1D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,mFAAmF;IACnF,cAAc,CAAC,EAAE,QAAQ,CAAC;IAC1B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,aAAa,GAAG;IACtD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,cAAc;cACtC,wBAAwB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAQxE,6EAA6E;IACvE,cAAc,CAClB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAIhC,gFAAgF;IAC1E,wBAAwB,CAC5B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC;IAIhC;;;;OAIG;IACG,mBAAmB,CACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,uBAAuB,CAAC;IA2DnC;;;;;;;;OAQG;IACG,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0C5E,OAAO,CAAC,IAAI;IAuBZ,qFAAqF;YACvE,eAAe;YA6Cf,WAAW;YAYX,KAAK;CA0IpB"}

package/dist/question-rubric.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pure rubric/answer-key shapes shared by the question models, the authoring
+ * service and `Grade`. Importing nothing keeps `submissions.ts` cycle-free.
+ */
+export interface QuestionRubricCriterion {
+    id: string;
+    label: string;
+    /** Positive maximum points for this criterion. */
+    maxPoints: number;
+}
+export interface QuestionRubric {
+    criteria: QuestionRubricCriterion[];
+}
+/** Returns a normalized rubric or throws `Error` naming the first problem. */
+export declare function parseQuestionRubric(value: unknown): QuestionRubric;
+/**
+ * Validates `Grade.rubricResults` against the exact revision's rubric. A value
+ * is a finite number or `{ points: number }`, never above the criterion's
+ * maximum. Empty results stay empty (unscored is never zero); results against a
+ * revision without a rubric are rejected.
+ */
+export declare function validateRubricResults(rubricJson: string | null | undefined, results: Record<string, unknown>): void;
+//# sourceMappingURL=question-rubric.d.ts.map

package/dist/question-rubric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-rubric.d.ts","sourceRoot":"","sources":["../src/question-rubric.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAID,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAuBlE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAqBN"}