@things-factory/learning 0.0.0-stage → 10.1.261

package/dist-server/learning-subjects.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The enrolment and the course version open on screen, named for the assistant each turn (operato-application
+ * design/ai/screen-pattern.md §2-1, ADR-0194 decision 12). The course screen anchors its conversation to
+ * `enrollment:<uuid>` - its learner's own, read by `Query.myEnrollment` - and the course editor to `course-version:<uuid>`,
+ * read by `Query.courseVersion`; each is named only for someone that door lets through.
+ */
+import { type RecordSubject } from '@things-factory/ai-assistant';
+export declare const ENROLLMENT_SUBJECT: RecordSubject;
+export declare const COURSE_VERSION_SUBJECT: RecordSubject;
+export declare function registerLearningSubjects(): void;

package/dist-server/learning-subjects.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COURSE_VERSION_SUBJECT = exports.ENROLLMENT_SUBJECT = void 0;
+exports.registerLearningSubjects = registerLearningSubjects;
+/**
+ * The enrolment and the course version open on screen, named for the assistant each turn (operato-application
+ * design/ai/screen-pattern.md §2-1, ADR-0194 decision 12). The course screen anchors its conversation to
+ * `enrollment:<uuid>` - its learner's own, read by `Query.myEnrollment` - and the course editor to `course-version:<uuid>`,
+ * read by `Query.courseVersion`; each is named only for someone that door lets through.
+ */
+const ai_assistant_1 = require("@things-factory/ai-assistant");
+const shell_1 = require("@things-factory/shell");
+exports.ENROLLMENT_SUBJECT = {
+    axis: 'enrollment',
+    noun: 'course enrolment',
+    door: 'Query.myEnrollment',
+    read: (rowId, domainId) => (0, shell_1.getRepository)('Enrollment').findOne({ where: { id: rowId, domain: { id: domainId } }, relations: ['course'] }),
+    nameOf: row => row.course?.name ?? ''
+};
+exports.COURSE_VERSION_SUBJECT = {
+    axis: 'course-version',
+    noun: 'course version',
+    door: 'Query.courseVersion',
+    read: (rowId, domainId) => (0, shell_1.getRepository)('CourseVersion').findOne({ where: { id: rowId, domain: { id: domainId } }, relations: ['course'] }),
+    nameOf: row => (row.course?.name ? `${row.course.name} v${row.number} (${row.status})` : '')
+};
+function registerLearningSubjects() {
+    (0, ai_assistant_1.registerRecordSubject)(exports.ENROLLMENT_SUBJECT);
+    (0, ai_assistant_1.registerRecordSubject)(exports.COURSE_VERSION_SUBJECT);
+}
+//# sourceMappingURL=learning-subjects.js.map

package/dist-server/learning-subjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-subjects.js","sourceRoot":"","sources":["../server/learning-subjects.ts"],"names":[],"mappings":";;;AAyBA,4DAGC;AA5BD;;;;;GAKG;AACH,+DAAwF;AACxF,iDAAqD;AAExC,QAAA,kBAAkB,GAAkB;IAC/C,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAA,qBAAa,EAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAS,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;IAChJ,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE;CACtC,CAAA;AAEY,QAAA,sBAAsB,GAAkB;IACnD,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAA,qBAAa,EAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAS,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;IACnJ,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7F,CAAA;AAED,SAAgB,wBAAwB;IACtC,IAAA,oCAAqB,EAAC,0BAAkB,CAAC,CAAA;IACzC,IAAA,oCAAqB,EAAC,8BAAsB,CAAC,CAAA;AAC/C,CAAC","sourcesContent":["/**\n * The enrolment and the course version open on screen, named for the assistant each turn (operato-application\n * design/ai/screen-pattern.md §2-1, ADR-0194 decision 12). The course screen anchors its conversation to\n * `enrollment:<uuid>` - its learner's own, read by `Query.myEnrollment` - and the course editor to `course-version:<uuid>`,\n * read by `Query.courseVersion`; each is named only for someone that door lets through.\n */\nimport { registerRecordSubject, type RecordSubject } from '@things-factory/ai-assistant'\nimport { getRepository } from '@things-factory/shell'\n\nexport const ENROLLMENT_SUBJECT: RecordSubject = {\n  axis: 'enrollment',\n  noun: 'course enrolment',\n  door: 'Query.myEnrollment',\n  read: (rowId, domainId) => getRepository('Enrollment').findOne({ where: { id: rowId, domain: { id: domainId } } as any, relations: ['course'] }),\n  nameOf: row => row.course?.name ?? ''\n}\n\nexport const COURSE_VERSION_SUBJECT: RecordSubject = {\n  axis: 'course-version',\n  noun: 'course version',\n  door: 'Query.courseVersion',\n  read: (rowId, domainId) => getRepository('CourseVersion').findOne({ where: { id: rowId, domain: { id: domainId } } as any, relations: ['course'] }),\n  nameOf: row => (row.course?.name ? `${row.course.name} v${row.number} (${row.status})` : '')\n}\n\nexport function registerLearningSubjects(): void {\n  registerRecordSubject(ENROLLMENT_SUBJECT)\n  registerRecordSubject(COURSE_VERSION_SUBJECT)\n}\n"]}

package/dist-server/role-tasks.d.ts

@@ -0,0 +1,2 @@
+import type { RoleTask } from '@things-factory/auth-base';
+export declare const ROLE_TASKS: RoleTask[];

package/dist-server/role-tasks.js

@@ -0,0 +1,17 @@
+"use strict";
+/*
+ * The work this module names, for the seats applications build (ADR-0139 decision 11, ADR-0194 decision 11).
+ *
+ * `learning.taking` - one's own enrolments, progress, quiz attempts and certificates; every employee. A department head
+ * reads where the people of their departments stand through it too - status only, no score.
+ * `learning.managing` - writing courses, assigning them, the status of everyone and the completion register.
+ *
+ * Data only - `server/index.ts` registers it - so an application's tests read it without starting the framework.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_TASKS = void 0;
+exports.ROLE_TASKS = [
+    { id: 'learning.taking', grants: [{ category: 'learning', axes: ['query', 'mutation'] }] },
+    { id: 'learning.managing', grants: [{ category: 'course', axes: ['query', 'mutation'] }] }
+];
+//# sourceMappingURL=role-tasks.js.map

package/dist-server/role-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-tasks.js","sourceRoot":"","sources":["../server/role-tasks.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAIU,QAAA,UAAU,GAAe;IACpC,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE;IAC1F,EAAE,EAAE,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE;CAC3F,CAAA","sourcesContent":["/*\n * The work this module names, for the seats applications build (ADR-0139 decision 11, ADR-0194 decision 11).\n *\n * `learning.taking` - one's own enrolments, progress, quiz attempts and certificates; every employee. A department head\n * reads where the people of their departments stand through it too - status only, no score.\n * `learning.managing` - writing courses, assigning them, the status of everyone and the completion register.\n *\n * Data only - `server/index.ts` registers it - so an application's tests read it without starting the framework.\n */\n\nimport type { RoleTask } from '@things-factory/auth-base'\n\nexport const ROLE_TASKS: RoleTask[] = [\n  { id: 'learning.taking', grants: [{ category: 'learning', axes: ['query', 'mutation'] }] },\n  { id: 'learning.managing', grants: [{ category: 'course', axes: ['query', 'mutation'] }] }\n]\n"]}

package/dist-server/service/course/course-mutation.d.ts

@@ -0,0 +1,19 @@
+import type { FileUpload } from 'graphql-upload/GraphQLUpload.js';
+import { Course } from './course';
+import { CourseQuestion } from './course-question';
+import { CourseUnit } from './course-unit';
+import { CourseVersion } from './course-version';
+import { CoursePatch, CourseQuestionInput, CourseUnitInput, CourseVersionPatch, NewCourse } from './course-type';
+export declare class CourseMutation {
+    createCourse(course: NewCourse, context: ResolverContext): Promise<Course>;
+    updateCourse(id: string, patch: CoursePatch, context: ResolverContext): Promise<Course>;
+    createCourseVersion(courseId: string, fromId: string, context: ResolverContext): Promise<CourseVersion>;
+    updateCourseVersion(id: string, patch: CourseVersionPatch, context: ResolverContext): Promise<CourseVersion>;
+    saveCourseUnits(versionId: string, units: CourseUnitInput[], context: ResolverContext): Promise<CourseUnit[]>;
+    attachCourseUnitFile(unitId: string, file: FileUpload, durationSeconds: number, pageCount: number, context: ResolverContext): Promise<CourseUnit>;
+    saveCourseQuestions(versionId: string, questions: CourseQuestionInput[], context: ResolverContext): Promise<CourseQuestion[]>;
+    addDraftedCourseQuestion(versionId: string, question: CourseQuestionInput, context: ResolverContext): Promise<CourseQuestion>;
+    publishCourseVersion(id: string, context: ResolverContext): Promise<CourseVersion>;
+    closeCourseVersion(id: string, context: ResolverContext): Promise<CourseVersion>;
+    deleteCourseVersion(id: string, context: ResolverContext): Promise<boolean>;
+}

package/dist-server/service/course/course-mutation.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CourseMutation = void 0;
+const tslib_1 = require("tslib");
+const GraphQLUpload_js_1 = tslib_1.__importDefault(require("graphql-upload/GraphQLUpload.js"));
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const course_1 = require("./course");
+const course_question_1 = require("./course-question");
+const course_unit_1 = require("./course-unit");
+const course_version_1 = require("./course-version");
+const course_type_1 = require("./course-type");
+const course_service_1 = require("./course-service");
+/* The managers' writes of courses (ADR-0194 decisions 2-4) - `course` mutation, the task `learning.managing`. */
+let CourseMutation = class CourseMutation {
+    async createCourse(course, context) {
+        return await (0, course_service_1.createCourse)(course, context);
+    }
+    async updateCourse(id, patch, context) {
+        return await (0, course_service_1.updateCourse)(id, patch, context);
+    }
+    async createCourseVersion(courseId, fromId, context) {
+        return await (0, course_service_1.createCourseVersion)(courseId, fromId, context);
+    }
+    async updateCourseVersion(id, patch, context) {
+        return await (0, course_service_1.updateCourseVersion)(id, patch, context);
+    }
+    async saveCourseUnits(versionId, units, context) {
+        return await (0, course_service_1.saveCourseUnits)(versionId, units, context);
+    }
+    async attachCourseUnitFile(unitId, file, durationSeconds, pageCount, context) {
+        return await (0, course_service_1.attachCourseUnitFile)(unitId, file, { durationSeconds, pageCount }, context);
+    }
+    async saveCourseQuestions(versionId, questions, context) {
+        return await (0, course_service_1.saveCourseQuestions)(versionId, questions, context);
+    }
+    async addDraftedCourseQuestion(versionId, question, context) {
+        const [saved] = await (0, course_service_1.addDraftedQuestions)(versionId, [question], context);
+        if (!saved)
+            throw new shell_1.Refusal('learning-question-draft-invalid', {}, 'the drafted question is not complete - its text, two choices and the right ones');
+        return saved;
+    }
+    async publishCourseVersion(id, context) {
+        return await (0, course_service_1.publishCourseVersion)(id, context);
+    }
+    async closeCourseVersion(id, context) {
+        return await (0, course_service_1.closeCourseVersion)(id, context);
+    }
+    async deleteCourseVersion(id, context) {
+        return await (0, course_service_1.deleteCourseVersion)(id, context);
+    }
+};
+exports.CourseMutation = CourseMutation;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_1.Course, { description: 'To make a course.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('course', type => course_type_1.NewCourse)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_type_1.NewCourse, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "createCourse", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_1.Course, { description: "To change a course's name, description, category or manager." }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('patch', type => course_type_1.CoursePatch)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, course_type_1.CoursePatch, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "updateCourse", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_version_1.CourseVersion, { description: 'To make the next draft version of a course - a copy of `fromId`, or of the latest version.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('courseId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('fromId', { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "createCourseVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_version_1.CourseVersion, { description: 'To change what a draft version says - a published one never changes.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('patch', type => course_type_1.CourseVersionPatch)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, course_type_1.CourseVersionPatch, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "updateCourseVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => [course_unit_1.CourseUnit], { description: 'To save the units of a draft version, in order - the ones left out are deleted.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('versionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('units', type => [course_type_1.CourseUnitInput])),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "saveCourseUnits", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_unit_1.CourseUnit, { description: "To attach a video's or a PDF's file to a unit of a draft version - a video with its length, a PDF with its page count." }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('unitId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('file', type => GraphQLUpload_js_1.default)),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('durationSeconds', type => type_graphql_1.Int, { nullable: true, description: "A video's length in seconds, read from the file." })),
+    tslib_1.__param(3, (0, type_graphql_1.Arg)('pageCount', type => type_graphql_1.Int, { nullable: true, description: "A PDF's page count, read from the file." })),
+    tslib_1.__param(4, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object, Number, Number, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "attachCourseUnitFile", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => [course_question_1.CourseQuestion], { description: 'To save the questions of a draft version, in order - the ones left out are deleted.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('versionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('questions', type => [course_type_1.CourseQuestionInput])),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "saveCourseQuestions", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_question_1.CourseQuestion, { description: 'To add a question drafted by the assistant to a draft version - marked drafted until a manager saves it (ADR-0194 decision 12).' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('versionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('question', type => course_type_1.CourseQuestionInput)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, course_type_1.CourseQuestionInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "addDraftedCourseQuestion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_version_1.CourseVersion, { description: 'To publish a draft version - the version published before is closed.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "publishCourseVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => course_version_1.CourseVersion, { description: 'To close the published version - nobody starts it any more.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "closeCourseVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, { description: 'To delete a draft version.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseMutation.prototype, "deleteCourseVersion", null);
+exports.CourseMutation = CourseMutation = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(course_1.Course),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], CourseMutation);
+//# sourceMappingURL=course-mutation.js.map

package/dist-server/service/course/course-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-mutation.js","sourceRoot":"","sources":["../../../server/service/course/course-mutation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FileUpload } from 'graphql-upload/GraphQLUpload.js'\nimport GraphQLUpload from 'graphql-upload/GraphQLUpload.js'\nimport { Arg, Ctx, Directive, Int, Mutation, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { Refusal, SpeakRefusals } from '@things-factory/shell'\n\nimport { Course } from './course'\nimport { CourseQuestion } from './course-question'\nimport { CourseUnit } from './course-unit'\nimport { CourseVersion } from './course-version'\nimport { CoursePatch, CourseQuestionInput, CourseUnitInput, CourseVersionPatch, NewCourse } from './course-type'\nimport {\n  addDraftedQuestions,\n  attachCourseUnitFile,\n  closeCourseVersion,\n  createCourse,\n  createCourseVersion,\n  deleteCourseVersion,\n  publishCourseVersion,\n  saveCourseQuestions,\n  saveCourseUnits,\n  updateCourse,\n  updateCourseVersion\n} from './course-service'\n\n\n/* The managers' writes of courses (ADR-0194 decisions 2-4) - `course` mutation, the task `learning.managing`. */\n@Resolver(Course)\n@UseMiddleware(SpeakRefusals)\nexport class CourseMutation {\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => Course, { description: 'To make a course.' })\n  async createCourse(@Arg('course', type => NewCourse) course: NewCourse, @Ctx() context: ResolverContext): Promise<Course> {\n    return await createCourse(course, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => Course, { description: \"To change a course's name, description, category or manager.\" })\n  async updateCourse(@Arg('id') id: string, @Arg('patch', type => CoursePatch) patch: CoursePatch, @Ctx() context: ResolverContext): Promise<Course> {\n    return await updateCourse(id, patch, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => CourseVersion, { description: 'To make the next draft version of a course - a copy of `fromId`, or of the latest version.' })\n  async createCourseVersion(@Arg('courseId') courseId: string, @Arg('fromId', { nullable: true }) fromId: string, @Ctx() context: ResolverContext): Promise<CourseVersion> {\n    return await createCourseVersion(courseId, fromId, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => CourseVersion, { description: 'To change what a draft version says - a published one never changes.' })\n  async updateCourseVersion(@Arg('id') id: string, @Arg('patch', type => CourseVersionPatch) patch: CourseVersionPatch, @Ctx() context: ResolverContext): Promise<CourseVersion> {\n    return await updateCourseVersion(id, patch, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [CourseUnit], { description: 'To save the units of a draft version, in order - the ones left out are deleted.' })\n  async saveCourseUnits(@Arg('versionId') versionId: string, @Arg('units', type => [CourseUnitInput]) units: CourseUnitInput[], @Ctx() context: ResolverContext): Promise<CourseUnit[]> {\n    return await saveCourseUnits(versionId, units, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => CourseUnit, { description: \"To attach a video's or a PDF's file to a unit of a draft version - a video with its length, a PDF with its page count.\" })\n  async attachCourseUnitFile(\n    @Arg('unitId') unitId: string,\n    @Arg('file', type => GraphQLUpload) file: FileUpload,\n    @Arg('durationSeconds', type => Int, { nullable: true, description: \"A video's length in seconds, read from the file.\" }) durationSeconds: number,\n    @Arg('pageCount', type => Int, { nullable: true, description: \"A PDF's page count, read from the file.\" }) pageCount: number,\n    @Ctx() context: ResolverContext\n  ): Promise<CourseUnit> {\n    return await attachCourseUnitFile(unitId, file, { durationSeconds, pageCount }, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => [CourseQuestion], { description: 'To save the questions of a draft version, in order - the ones left out are deleted.' })\n  async saveCourseQuestions(@Arg('versionId') versionId: string, @Arg('questions', type => [CourseQuestionInput]) questions: CourseQuestionInput[], @Ctx() context: ResolverContext): Promise<CourseQuestion[]> {\n    return await saveCourseQuestions(versionId, questions, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => CourseQuestion, { description: 'To add a question drafted by the assistant to a draft version - marked drafted until a manager saves it (ADR-0194 decision 12).' })\n  async addDraftedCourseQuestion(@Arg('versionId') versionId: string, @Arg('question', type => CourseQuestionInput) question: CourseQuestionInput, @Ctx() context: ResolverContext): Promise<CourseQuestion> {\n    const [saved] = await addDraftedQuestions(versionId, [question], context)\n    if (!saved) throw new Refusal('learning-question-draft-invalid', {}, 'the drafted question is not complete - its text, two choices and the right ones')\n    return saved\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => CourseVersion, { description: 'To publish a draft version - the version published before is closed.' })\n  async publishCourseVersion(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<CourseVersion> {\n    return await publishCourseVersion(id, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => CourseVersion, { description: 'To close the published version - nobody starts it any more.' })\n  async closeCourseVersion(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<CourseVersion> {\n    return await closeCourseVersion(id, context)\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@transaction')\n  @Mutation(returns => Boolean, { description: 'To delete a draft version.' })\n  async deleteCourseVersion(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    return await deleteCourseVersion(id, context)\n  }\n}\n"]}

package/dist-server/service/course/course-query.d.ts

@@ -0,0 +1,27 @@
+import { Attachment } from '@things-factory/attachment-base';
+import { User } from '@things-factory/auth-base';
+import { ListParam } from '@things-factory/shell';
+import { Course } from './course';
+import { CourseQuestion } from './course-question';
+import { CourseUnit } from './course-unit';
+import { CourseVersion } from './course-version';
+import { CourseChoiceKey, CourseList } from './course-type';
+export declare class CourseQuery {
+    courses(params: ListParam, context: ResolverContext): Promise<CourseList>;
+    course(id: string, context: ResolverContext): Promise<Course | null>;
+    courseVersion(id: string, context: ResolverContext): Promise<CourseVersion | null>;
+    versions(course: Course, context: ResolverContext): Promise<CourseVersion[]>;
+    publishedVersion(course: Course, context: ResolverContext): Promise<CourseVersion | null>;
+    manager(course: Course): Promise<User | null>;
+}
+export declare class CourseVersionFields {
+    units(version: CourseVersion, context: ResolverContext): Promise<CourseUnit[]>;
+    questions(version: CourseVersion, context: ResolverContext): Promise<CourseQuestion[]>;
+}
+export declare class CourseUnitFields {
+    secondsPerPage(unit: CourseUnit): number | null;
+    file(unit: CourseUnit, context: ResolverContext): Promise<Attachment | null>;
+}
+export declare class CourseQuestionFields {
+    choices(question: CourseQuestion, context: ResolverContext): Promise<CourseChoiceKey[]>;
+}

package/dist-server/service/course/course-query.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CourseQuestionFields = exports.CourseUnitFields = exports.CourseVersionFields = exports.CourseQuery = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const attachment_base_1 = require("@things-factory/attachment-base");
+const auth_base_1 = require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+const progress_rules_1 = require("../enrollment/progress-rules");
+const course_1 = require("./course");
+const course_question_1 = require("./course-question");
+const course_unit_1 = require("./course-unit");
+const course_version_1 = require("./course-version");
+const course_type_1 = require("./course-type");
+const course_service_1 = require("./course-service");
+/*
+ * The managers' reads of courses (ADR-0194 decisions 2-4, 10, 11) - `course` query, the task `learning.managing`. A learner
+ * reads a course through their enrolment (enrollment-query.ts), never these.
+ */
+let CourseQuery = class CourseQuery {
+    async courses(params, context) {
+        const { domain } = context.state;
+        const qb = (0, shell_1.getQueryBuilderFromListParams)({ domain, params, repository: (0, shell_1.getRepository)(course_1.Course), alias: 'C', searchables: ['name', 'description', 'category'] });
+        if (!params?.sortings?.length)
+            qb.orderBy('C.name', 'ASC');
+        const [items, total] = await qb.getManyAndCount();
+        return { items, total };
+    }
+    async course(id, context) {
+        return await (0, shell_1.getRepository)(course_1.Course).findOne({ where: { id, domain: { id: context.state.domain.id } } });
+    }
+    async courseVersion(id, context) {
+        return await (0, shell_1.getRepository)(course_version_1.CourseVersion).findOne({ where: { id, domain: { id: context.state.domain.id } } });
+    }
+    async versions(course, context) {
+        if (!(await (0, auth_base_1.requestHolds)(context, 'course', 'query')))
+            return [];
+        return await (0, shell_1.getRepository)(course_version_1.CourseVersion).find({ where: { course: { id: course.id } }, order: { number: 'DESC' } });
+    }
+    async publishedVersion(course, context) {
+        return await (0, course_service_1.publishedVersionOf)((0, course_service_1.learningManagerOf)(context), { id: course.domainId }, course.id);
+    }
+    async manager(course) {
+        return course.managerId ? await (0, shell_1.getRepository)(auth_base_1.User).findOneBy({ id: course.managerId }) : null;
+    }
+};
+exports.CourseQuery = CourseQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => course_type_1.CourseList, { description: 'The courses of the domain.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseQuery.prototype, "courses", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => course_1.Course, { nullable: true, description: 'One course.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseQuery.prototype, "course", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "course", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => course_version_1.CourseVersion, { nullable: true, description: 'One version of a course, with its units and questions.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseQuery.prototype, "courseVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [course_version_1.CourseVersion], { description: 'Its versions, the newest first - for a manager; nothing for anyone else.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_1.Course, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseQuery.prototype, "versions", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => course_version_1.CourseVersion, { nullable: true, description: 'The version learners take now.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_1.Course, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseQuery.prototype, "publishedVersion", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => auth_base_1.User, { nullable: true, description: 'Who keeps it.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_1.Course]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseQuery.prototype, "manager", null);
+exports.CourseQuery = CourseQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(course_1.Course),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], CourseQuery);
+let CourseVersionFields = class CourseVersionFields {
+    async units(version, context) {
+        if (!(await (0, course_service_1.mayReadVersion)(context, version)))
+            return [];
+        return await (0, course_service_1.unitsOf)((0, course_service_1.learningManagerOf)(context), version.id);
+    }
+    async questions(version, context) {
+        if (!(await (0, auth_base_1.requestHolds)(context, 'course', 'query')))
+            return [];
+        return await (0, course_service_1.questionsOf)((0, course_service_1.learningManagerOf)(context), version.id);
+    }
+};
+exports.CourseVersionFields = CourseVersionFields;
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [course_unit_1.CourseUnit], { description: 'Its units, in order - for a manager, or a learner whose enrolment shows this version.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_version_1.CourseVersion, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseVersionFields.prototype, "units", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [course_question_1.CourseQuestion], { description: 'Its questions, in order - for a manager; nothing for anyone else.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_version_1.CourseVersion, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseVersionFields.prototype, "questions", null);
+exports.CourseVersionFields = CourseVersionFields = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(course_version_1.CourseVersion)
+], CourseVersionFields);
+let CourseUnitFields = class CourseUnitFields {
+    secondsPerPage(unit) {
+        return unit.kind === 'PDF' ? (0, progress_rules_1.secondsPerPage)(unit) : null;
+    }
+    async file(unit, context) {
+        const version = await (0, course_service_1.learningManagerOf)(context).getRepository(course_version_1.CourseVersion).findOne({ where: { id: unit.versionId }, withDeleted: true });
+        if (!(await (0, course_service_1.mayReadVersion)(context, version)))
+            return null;
+        return (await (0, course_service_1.unitFilesOf)(context.state.domain, [unit.id])).get(unit.id) ?? null;
+    }
+};
+exports.CourseUnitFields = CourseUnitFields;
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => type_graphql_1.Int, { nullable: true, description: 'The fewest seconds a PDF page is looked at to count as read - the screen and the server read the same.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_unit_1.CourseUnit]),
+    tslib_1.__metadata("design:returntype", Number)
+], CourseUnitFields.prototype, "secondsPerPage", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => attachment_base_1.Attachment, { nullable: true, description: "A video's or a PDF's file." }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_unit_1.CourseUnit, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseUnitFields.prototype, "file", null);
+exports.CourseUnitFields = CourseUnitFields = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(course_unit_1.CourseUnit)
+], CourseUnitFields);
+let CourseQuestionFields = class CourseQuestionFields {
+    async choices(question, context) {
+        if (!(await (0, auth_base_1.requestHolds)(context, 'course', 'query')))
+            return [];
+        return question.choices ?? [];
+    }
+};
+exports.CourseQuestionFields = CourseQuestionFields;
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => [course_type_1.CourseChoiceKey], { description: 'Its choices with which are right - for a manager only.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [course_question_1.CourseQuestion, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], CourseQuestionFields.prototype, "choices", null);
+exports.CourseQuestionFields = CourseQuestionFields = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(course_question_1.CourseQuestion)
+], CourseQuestionFields);
+//# sourceMappingURL=course-query.js.map

package/dist-server/service/course/course-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-query.js","sourceRoot":"","sources":["../../../server/service/course/course-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Args, Ctx, Directive, FieldResolver, Int, Query, Resolver, Root, UseMiddleware } from 'type-graphql'\n\nimport { Attachment } from '@things-factory/attachment-base'\nimport { requestHolds, User } from '@things-factory/auth-base'\nimport { getQueryBuilderFromListParams, getRepository, ListParam, SpeakRefusals } from '@things-factory/shell'\n\nimport { secondsPerPage } from '../enrollment/progress-rules'\nimport { Course } from './course'\nimport { CourseQuestion } from './course-question'\nimport { CourseUnit } from './course-unit'\nimport { CourseVersion } from './course-version'\nimport { CourseChoiceKey, CourseList } from './course-type'\nimport { learningManagerOf, mayReadVersion, publishedVersionOf, questionsOf, unitFilesOf, unitsOf } from './course-service'\n\n\n/*\n * The managers' reads of courses (ADR-0194 decisions 2-4, 10, 11) - `course` query, the task `learning.managing`. A learner\n * reads a course through their enrolment (enrollment-query.ts), never these.\n */\n@Resolver(Course)\n@UseMiddleware(SpeakRefusals)\nexport class CourseQuery {\n  @Directive('@privilege(category: \"course\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => CourseList, { description: 'The courses of the domain.' })\n  async courses(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<CourseList> {\n    const { domain } = context.state\n    const qb = getQueryBuilderFromListParams({ domain, params, repository: getRepository(Course), alias: 'C', searchables: ['name', 'description', 'category'] })\n    if (!params?.sortings?.length) qb.orderBy('C.name', 'ASC')\n    const [items, total] = await qb.getManyAndCount()\n    return { items, total }\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => Course, { nullable: true, description: 'One course.' })\n  async course(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Course | null> {\n    return await getRepository(Course).findOne({ where: { id, domain: { id: context.state.domain.id } } as any })\n  }\n\n  @Directive('@privilege(category: \"course\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => CourseVersion, { nullable: true, description: 'One version of a course, with its units and questions.' })\n  async courseVersion(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<CourseVersion | null> {\n    return await getRepository(CourseVersion).findOne({ where: { id, domain: { id: context.state.domain.id } } as any })\n  }\n\n  @FieldResolver(type => [CourseVersion], { description: 'Its versions, the newest first - for a manager; nothing for anyone else.' })\n  async versions(@Root() course: Course, @Ctx() context: ResolverContext): Promise<CourseVersion[]> {\n    if (!(await requestHolds(context, 'course', 'query'))) return []\n    return await getRepository(CourseVersion).find({ where: { course: { id: course.id } } as any, order: { number: 'DESC' } as any })\n  }\n\n  @FieldResolver(type => CourseVersion, { nullable: true, description: 'The version learners take now.' })\n  async publishedVersion(@Root() course: Course, @Ctx() context: ResolverContext): Promise<CourseVersion | null> {\n    return await publishedVersionOf(learningManagerOf(context), { id: course.domainId! }, course.id)\n  }\n\n  @FieldResolver(type => User, { nullable: true, description: 'Who keeps it.' })\n  async manager(@Root() course: Course): Promise<User | null> {\n    return course.managerId ? await getRepository(User).findOneBy({ id: course.managerId }) : null\n  }\n}\n\n@Resolver(CourseVersion)\nexport class CourseVersionFields {\n  @FieldResolver(type => [CourseUnit], { description: 'Its units, in order - for a manager, or a learner whose enrolment shows this version.' })\n  async units(@Root() version: CourseVersion, @Ctx() context: ResolverContext): Promise<CourseUnit[]> {\n    if (!(await mayReadVersion(context, version))) return []\n    return await unitsOf(learningManagerOf(context), version.id)\n  }\n\n  @FieldResolver(type => [CourseQuestion], { description: 'Its questions, in order - for a manager; nothing for anyone else.' })\n  async questions(@Root() version: CourseVersion, @Ctx() context: ResolverContext): Promise<CourseQuestion[]> {\n    if (!(await requestHolds(context, 'course', 'query'))) return []\n    return await questionsOf(learningManagerOf(context), version.id)\n  }\n}\n\n@Resolver(CourseUnit)\nexport class CourseUnitFields {\n  @FieldResolver(type => Int, { nullable: true, description: 'The fewest seconds a PDF page is looked at to count as read - the screen and the server read the same.' })\n  secondsPerPage(@Root() unit: CourseUnit): number | null {\n    return unit.kind === 'PDF' ? secondsPerPage(unit) : null\n  }\n\n  @FieldResolver(type => Attachment, { nullable: true, description: \"A video's or a PDF's file.\" })\n  async file(@Root() unit: CourseUnit, @Ctx() context: ResolverContext): Promise<Attachment | null> {\n    const version = await learningManagerOf(context).getRepository(CourseVersion).findOne({ where: { id: unit.versionId } as any, withDeleted: true })\n    if (!(await mayReadVersion(context, version))) return null\n    return (await unitFilesOf(context.state.domain, [unit.id])).get(unit.id) ?? null\n  }\n}\n\n@Resolver(CourseQuestion)\nexport class CourseQuestionFields {\n  @FieldResolver(type => [CourseChoiceKey], { description: 'Its choices with which are right - for a manager only.' })\n  async choices(@Root() question: CourseQuestion, @Ctx() context: ResolverContext): Promise<CourseChoiceKey[]> {\n    if (!(await requestHolds(context, 'course', 'query'))) return []\n    return question.choices ?? []\n  }\n}\n"]}

package/dist-server/service/course/course-question.d.ts

@@ -0,0 +1,41 @@
+import { User } from '@things-factory/auth-base';
+import { Domain } from '@things-factory/shell';
+import { CourseVersion } from './course-version';
+/** How a question is answered. */
+export declare enum CourseQuestionKind {
+    SINGLE = "SINGLE",
+    MULTIPLE = "MULTIPLE",
+    TRUE_FALSE = "TRUE_FALSE"
+}
+/** One choice of a question, with whether it is right - kept in the row, never sent to a learner. */
+export interface CourseChoice {
+    id: string;
+    text: string;
+    correct: boolean;
+}
+/**
+ * 문항 (ADR-0194 decision 4) - one question of a version's quiz: its choices with which are right, and why. Whether a
+ * choice is right is read by the server's scoring and the managers' editor only; a learner is drawn the question without
+ * it. One the assistant drafted stays `drafted` until a manager looks it over (decision 12).
+ */
+export declare class CourseQuestion {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    version?: CourseVersion;
+    versionId?: string;
+    seq: number;
+    kind: CourseQuestionKind;
+    text: string;
+    /** The choices with which are right - not a field: a learner never reads it. */
+    choices: CourseChoice[];
+    explanation?: string;
+    drafted: boolean;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}