@things-factory/learning 0.0.0-stage → 10.1.260

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

@@ -0,0 +1,402 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COURSE_UNIT_REF_TYPE = void 0;
+exports.learningManagerOf = learningManagerOf;
+exports.holds = holds;
+exports.mayReadVersion = mayReadVersion;
+exports.courseOf = courseOf;
+exports.createCourse = createCourse;
+exports.updateCourse = updateCourse;
+exports.versionOf = versionOf;
+exports.publishedVersionOf = publishedVersionOf;
+exports.unitsOf = unitsOf;
+exports.questionsOf = questionsOf;
+exports.createCourseVersion = createCourseVersion;
+exports.updateCourseVersion = updateCourseVersion;
+exports.saveCourseUnits = saveCourseUnits;
+exports.attachCourseUnitFile = attachCourseUnitFile;
+exports.saveCourseQuestions = saveCourseQuestions;
+exports.addDraftedQuestions = addDraftedQuestions;
+exports.publishCourseVersion = publishCourseVersion;
+exports.closeCourseVersion = closeCourseVersion;
+exports.deleteCourseVersion = deleteCourseVersion;
+exports.unitFilesOf = unitFilesOf;
+/*
+ * What the doors of courses do with the database (ADR-0194 decisions 2-4): a course, its versions written as drafts,
+ * their units and questions, publishing one (the one before closes) and copying one into the next draft. Nothing here
+ * changes a published version.
+ */
+const crypto_1 = require("crypto");
+const stream_1 = require("stream");
+const typeorm_1 = require("typeorm");
+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 course_1 = require("./course");
+const course_question_1 = require("./course-question");
+const course_rules_1 = require("./course-rules");
+const course_unit_1 = require("./course-unit");
+const course_version_1 = require("./course-version");
+/** A unit's file hangs on it under this `refType` (attachment-base). */
+exports.COURSE_UNIT_REF_TYPE = 'CourseUnit';
+const text = (value) => (typeof value === 'string' && value.trim() ? value.trim() : null);
+/** The request's transaction, or the data source's manager for a read that runs without one. */
+function learningManagerOf(context) {
+    return context?.state?.tx ?? (0, shell_1.getRepository)(course_1.Course).manager;
+}
+/** Whether the request holds `category` of this module (`course`, `learning`) - asked once per request. */
+async function holds(context, category, privilege = 'mutation') {
+    const state = context?.state ?? {};
+    const { domain, user, unsafeIP, prohibitedPrivileges } = state;
+    if (!domain || !user)
+        return false;
+    const key = `__learning:${category}:${privilege}`;
+    state[key] ??= (0, auth_base_1.checkPermission)({ category, privilege, owner: true }, user, domain, unsafeIP, prohibitedPrivileges).then(Boolean);
+    return await state[key];
+}
+/**
+ * Whether the request may read what a version says - its units and their files: a manager (`course` query) any version;
+ * anyone else only the version an enrolment of theirs shows - its own once started, the published one before. Asked on
+ * every path to a version, not only the top-level reads: a learner reached a draft through
+ * `myEnrollment → course → versions → units` (2026-11-08).
+ */
+async function mayReadVersion(context, version) {
+    if (!version)
+        return false;
+    if (await holds(context, 'course', 'query'))
+        return true;
+    const { domain, user } = context?.state ?? {};
+    if (!domain || !user)
+        return false;
+    const state = context.state;
+    state.__learningShown ??= learningManagerOf(context)
+        .getRepository('Enrollment')
+        .find({ where: { domain: { id: domain.id }, user: { id: user.id }, status: (0, typeorm_1.In)(['ASSIGNED', 'IN_PROGRESS', 'COMPLETED']) }, relations: ['course', 'version'] });
+    const mine = await state.__learningShown;
+    return mine.some(one => one.course?.id === version.courseId && (one.version ? one.version.id === version.id : version.status === course_version_1.CourseVersionStatus.PUBLISHED));
+}
+const notFound = () => new shell_1.Refusal('learning-not-found', {}, 'the record was not found. reload and try again.');
+function refuse(code) {
+    if (code)
+        throw new shell_1.Refusal(code, {}, `refused (${code})`);
+}
+/* ---------------------------------------------------------------- courses */
+async function courseOf(tx, domain, id) {
+    const row = id ? await tx.getRepository(course_1.Course).findOne({ where: { id, domain: { id: domain.id } } }) : null;
+    if (!row)
+        throw notFound();
+    return row;
+}
+async function managerOf(tx, domain, managerId, fallback) {
+    if (!managerId)
+        return fallback;
+    const user = await tx.getRepository(auth_base_1.User).findOne({ where: { id: managerId }, relations: ['domains'] });
+    if (!user || !(user.domains ?? []).some(one => one.id === domain.id))
+        throw new shell_1.Refusal('learning-manager-unknown', {}, 'the manager must be a user of this domain');
+    return user;
+}
+async function createCourse(input, context) {
+    const { domain, user, tx } = context.state;
+    const name = text(input.name);
+    if (!name)
+        throw new shell_1.Refusal('learning-course-name-required', {}, 'give the course a name');
+    if (await tx.getRepository(course_1.Course).findOne({ where: { domain: { id: domain.id }, name } }))
+        throw new shell_1.Refusal('learning-course-name-taken', { name }, `a course named ${name} exists`);
+    return await tx.getRepository(course_1.Course).save({
+        domain,
+        name,
+        description: text(input.description),
+        category: text(input.category),
+        manager: await managerOf(tx, domain, input.managerId, user),
+        creator: user,
+        updater: user
+    });
+}
+async function updateCourse(id, patch, context) {
+    const { domain, user, tx } = context.state;
+    const row = await courseOf(tx, domain, id);
+    if (patch.name !== undefined) {
+        const name = text(patch.name);
+        if (!name)
+            throw new shell_1.Refusal('learning-course-name-required', {}, 'give the course a name');
+        const taken = await tx.getRepository(course_1.Course).findOne({ where: { domain: { id: domain.id }, name, id: (0, typeorm_1.Not)(id) } });
+        if (taken)
+            throw new shell_1.Refusal('learning-course-name-taken', { name }, `a course named ${name} exists`);
+        row.name = name;
+    }
+    if (patch.description !== undefined)
+        row.description = text(patch.description);
+    if (patch.category !== undefined)
+        row.category = text(patch.category);
+    if (patch.managerId !== undefined)
+        row.manager = await managerOf(tx, domain, patch.managerId, user);
+    row.updater = user;
+    return await tx.getRepository(course_1.Course).save(row);
+}
+/* ---------------------------------------------------------------- versions */
+async function versionOf(tx, domain, id) {
+    const row = id ? await tx.getRepository(course_version_1.CourseVersion).findOne({ where: { id, domain: { id: domain.id } } }) : null;
+    if (!row)
+        throw notFound();
+    return row;
+}
+/** The version learners take now - the one published, or none. */
+async function publishedVersionOf(tx, domain, courseId) {
+    return await tx.getRepository(course_version_1.CourseVersion).findOne({ where: { domain: { id: domain.id }, course: { id: courseId }, status: course_version_1.CourseVersionStatus.PUBLISHED } });
+}
+async function unitsOf(tx, versionId) {
+    return await tx.getRepository(course_unit_1.CourseUnit).find({ where: { version: { id: versionId } }, order: { seq: 'ASC' } });
+}
+async function questionsOf(tx, versionId) {
+    return await tx.getRepository(course_question_1.CourseQuestion).find({ where: { version: { id: versionId } }, order: { seq: 'ASC' } });
+}
+/** A draft version to write in, refused while the version is published or closed (decision 2). */
+async function draftOf(tx, domain, id) {
+    const version = await versionOf(tx, domain, id);
+    refuse((0, course_rules_1.versionEditRefusal)(version));
+    return version;
+}
+/** The file of a unit, copied into a new file of another unit - each version keeps its own. */
+async function copyFile(from, toUnitId, context) {
+    const bytes = Buffer.from(await attachment_base_1.STORAGE.readFile(from.path));
+    const file = Promise.resolve({ filename: from.name, mimetype: from.mimetype, encoding: from.encoding, createReadStream: () => stream_1.Readable.from([bytes]) });
+    await (0, attachment_base_1.createAttachment)(null, { attachment: { file, refType: exports.COURSE_UNIT_REF_TYPE, refBy: toUnitId } }, context);
+}
+/**
+ * A new draft of a course - the next number, with what `fromId` says copied (the latest version when not given): its
+ * settings, units with their files, and questions. One draft at a time.
+ */
+async function createCourseVersion(courseId, fromId, context) {
+    const { domain, user, tx } = context.state;
+    const course = await courseOf(tx, domain, courseId);
+    const repository = tx.getRepository(course_version_1.CourseVersion);
+    const versions = await repository.find({ where: { domain: { id: domain.id }, course: { id: course.id } }, order: { number: 'DESC' } });
+    if (versions.some(one => one.status === course_version_1.CourseVersionStatus.DRAFT))
+        throw new shell_1.Refusal('learning-draft-exists', {}, 'the course has a draft version - write in it');
+    const from = fromId ? versions.find(one => one.id === fromId) : versions[0];
+    if (fromId && !from)
+        throw notFound();
+    const draft = await repository.save({
+        domain,
+        course,
+        number: (versions[0]?.number ?? 0) + 1,
+        status: course_version_1.CourseVersionStatus.DRAFT,
+        minSeconds: from?.minSeconds ?? 0,
+        acknowledgement: from?.acknowledgement ?? null,
+        passScore: from?.passScore ?? null,
+        questionCount: from?.questionCount ?? null,
+        attemptLimit: from?.attemptLimit ?? null,
+        sourceKind: from?.sourceKind ?? null,
+        sourceNote: from?.sourceNote ?? null,
+        creator: user,
+        updater: user
+    });
+    if (!from)
+        return draft;
+    for (const unit of await unitsOf(tx, from.id)) {
+        const copy = await tx.getRepository(course_unit_1.CourseUnit).save({
+            domain,
+            version: draft,
+            seq: unit.seq,
+            kind: unit.kind,
+            name: unit.name,
+            body: unit.body,
+            url: unit.url,
+            durationSeconds: unit.durationSeconds,
+            minSeconds: unit.minSeconds,
+            creator: user,
+            updater: user
+        });
+        const file = await tx.getRepository(attachment_base_1.Attachment).findOne({ where: { domain: { id: domain.id }, refType: exports.COURSE_UNIT_REF_TYPE, refBy: unit.id } });
+        if (file)
+            await copyFile(file, copy.id, context);
+    }
+    for (const question of await questionsOf(tx, from.id)) {
+        await tx.getRepository(course_question_1.CourseQuestion).save({
+            domain,
+            version: draft,
+            seq: question.seq,
+            kind: question.kind,
+            text: question.text,
+            choices: question.choices,
+            explanation: question.explanation,
+            drafted: question.drafted,
+            creator: user,
+            updater: user
+        });
+    }
+    return draft;
+}
+async function updateCourseVersion(id, patch, context) {
+    const { domain, user, tx } = context.state;
+    const version = await draftOf(tx, domain, id);
+    const next = { ...version, ...Object.fromEntries(Object.entries(patch).filter(([, value]) => value !== undefined)) };
+    refuse((0, course_rules_1.versionInputRefusal)(next));
+    for (const field of ['minSeconds', 'passScore', 'questionCount', 'attemptLimit', 'sourceKind'])
+        if (patch[field] !== undefined)
+            version[field] = patch[field];
+    if (patch.minSeconds === null)
+        version.minSeconds = 0;
+    if (patch.acknowledgement !== undefined)
+        version.acknowledgement = text(patch.acknowledgement);
+    if (patch.sourceNote !== undefined)
+        version.sourceNote = text(patch.sourceNote);
+    version.updater = user;
+    return await tx.getRepository(course_version_1.CourseVersion).save(version);
+}
+/**
+ * The units of a draft, in the order given - new ones made, the ones given changed, the ones left out deleted with
+ * their files.
+ */
+async function saveCourseUnits(versionId, units, context) {
+    const { domain, user, tx } = context.state;
+    const version = await draftOf(tx, domain, versionId);
+    for (const unit of units)
+        refuse((0, course_rules_1.unitInputRefusal)(unit));
+    const repository = tx.getRepository(course_unit_1.CourseUnit);
+    const existing = await unitsOf(tx, version.id);
+    const kept = new Set(units.map(one => one.id).filter(Boolean));
+    if ([...kept].some(id => !existing.some(one => one.id === id)))
+        throw notFound();
+    const gone = existing.filter(one => !kept.has(one.id));
+    if (gone.length) {
+        await (0, attachment_base_1.deleteAttachmentsByRef)(null, { refBys: gone.map(one => one.id), refType: exports.COURSE_UNIT_REF_TYPE }, context);
+        await repository.softDelete({ id: (0, typeorm_1.In)(gone.map(one => one.id)) });
+    }
+    const saved = [];
+    for (const [index, unit] of units.entries()) {
+        const row = unit.id ? existing.find(one => one.id === unit.id) : repository.create({ domain, version, creator: user });
+        Object.assign(row, {
+            seq: index + 1,
+            kind: unit.kind,
+            name: unit.name.trim(),
+            body: unit.kind === course_unit_1.CourseUnitKind.MARKDOWN ? unit.body : null,
+            url: unit.kind === course_unit_1.CourseUnitKind.LINK ? unit.url?.trim() : null,
+            durationSeconds: unit.kind === course_unit_1.CourseUnitKind.VIDEO ? (unit.durationSeconds ?? row.durationSeconds ?? null) : null,
+            minSeconds: unit.kind === course_unit_1.CourseUnitKind.PDF || unit.kind === course_unit_1.CourseUnitKind.MARKDOWN ? (unit.minSeconds ?? null) : null,
+            updater: user
+        });
+        saved.push(await repository.save(row));
+    }
+    return saved;
+}
+/** A video's or a PDF's file for a unit of a draft - it replaces the one before. A video's length comes with it. */
+async function attachCourseUnitFile(unitId, file, durationSeconds, context) {
+    const { domain, user, tx } = context.state;
+    const unit = await tx.getRepository(course_unit_1.CourseUnit).findOne({ where: { id: unitId, domain: { id: domain.id } } });
+    if (!unit)
+        throw notFound();
+    await draftOf(tx, domain, unit.versionId);
+    if (unit.kind !== course_unit_1.CourseUnitKind.VIDEO && unit.kind !== course_unit_1.CourseUnitKind.PDF)
+        throw new shell_1.Refusal('learning-unit-file-not-taken', {}, 'only a video or a PDF unit takes a file');
+    await (0, attachment_base_1.deleteAttachmentsByRef)(null, { refBys: [unit.id], refType: exports.COURSE_UNIT_REF_TYPE }, context);
+    await (0, attachment_base_1.createAttachment)(null, { attachment: { file, refType: exports.COURSE_UNIT_REF_TYPE, refBy: unit.id } }, context);
+    if (unit.kind === course_unit_1.CourseUnitKind.VIDEO && durationSeconds != null) {
+        refuse((0, course_rules_1.unitInputRefusal)({ kind: unit.kind, name: unit.name, durationSeconds: Math.round(durationSeconds) }));
+        unit.durationSeconds = Math.round(durationSeconds);
+    }
+    unit.updater = user;
+    return await tx.getRepository(course_unit_1.CourseUnit).save(unit);
+}
+/** The choices kept with their ids - an id given stays, a new choice gets one. */
+const choicesOf = (input) => input.choices.map(one => ({ id: one.id || (0, crypto_1.randomUUID)(), text: one.text.trim(), correct: !!one.correct }));
+/**
+ * The questions of a draft, in the order given - saved by a manager, so each is looked over (`drafted` off). The ones
+ * left out are deleted.
+ */
+async function saveCourseQuestions(versionId, questions, context) {
+    const { domain, user, tx } = context.state;
+    const version = await draftOf(tx, domain, versionId);
+    for (const question of questions)
+        refuse((0, course_rules_1.questionInputRefusal)(question));
+    const repository = tx.getRepository(course_question_1.CourseQuestion);
+    const existing = await questionsOf(tx, version.id);
+    const kept = new Set(questions.map(one => one.id).filter(Boolean));
+    if ([...kept].some(id => !existing.some(one => one.id === id)))
+        throw notFound();
+    const gone = existing.filter(one => !kept.has(one.id));
+    if (gone.length)
+        await repository.softDelete({ id: (0, typeorm_1.In)(gone.map(one => one.id)) });
+    const saved = [];
+    for (const [index, question] of questions.entries()) {
+        const row = question.id ? existing.find(one => one.id === question.id) : repository.create({ domain, version, creator: user });
+        Object.assign(row, { seq: index + 1, kind: question.kind, text: question.text.trim(), choices: choicesOf(question), explanation: text(question.explanation), drafted: false, updater: user });
+        saved.push(await repository.save(row));
+    }
+    return saved;
+}
+/** Questions the assistant drafted, added at the end of a draft - each `drafted` until a manager looks it over (decision 12). */
+async function addDraftedQuestions(versionId, questions, context) {
+    const { domain, user, tx } = context.state;
+    const version = await draftOf(tx, domain, versionId);
+    const valid = questions.filter(one => !(0, course_rules_1.questionInputRefusal)(one));
+    const last = (await questionsOf(tx, version.id)).reduce((max, one) => Math.max(max, one.seq), 0);
+    const saved = [];
+    for (const [index, question] of valid.entries()) {
+        saved.push(await tx.getRepository(course_question_1.CourseQuestion).save({
+            domain,
+            version,
+            seq: last + index + 1,
+            kind: question.kind,
+            text: question.text.trim(),
+            choices: choicesOf(question),
+            explanation: text(question.explanation),
+            drafted: true,
+            creator: user,
+            updater: user
+        }));
+    }
+    return saved;
+}
+/**
+ * Publishes a draft: what it says is checked (decisions 2-4), it is claimed by an update that only a draft matches -
+ * two at once publish once - and the version published before closes. Enrolments in progress end on their own version.
+ */
+async function publishCourseVersion(id, context) {
+    const { domain, user, tx } = context.state;
+    const version = await versionOf(tx, domain, id);
+    const units = await unitsOf(tx, version.id);
+    const files = units.length
+        ? await tx.getRepository(attachment_base_1.Attachment).find({ where: { domain: { id: domain.id }, refType: exports.COURSE_UNIT_REF_TYPE, refBy: (0, typeorm_1.In)(units.map(one => one.id)) } })
+        : [];
+    const questions = await questionsOf(tx, version.id);
+    refuse((0, course_rules_1.publishRefusal)({ version, units: units.map(one => ({ ...one, hasFile: files.some(file => file.refBy === one.id) })), questions }));
+    const now = new Date();
+    const claimed = await tx.getRepository(course_version_1.CourseVersion).update({ id: version.id, status: course_version_1.CourseVersionStatus.DRAFT }, { status: course_version_1.CourseVersionStatus.PUBLISHED, publishedAt: now, updater: user });
+    if (!claimed.affected)
+        throw new shell_1.Refusal('learning-version-not-draft', {}, 'the version is not a draft any more');
+    await tx
+        .getRepository(course_version_1.CourseVersion)
+        .update({ domain: { id: domain.id }, course: { id: version.courseId }, status: course_version_1.CourseVersionStatus.PUBLISHED, id: (0, typeorm_1.Not)(version.id) }, { status: course_version_1.CourseVersionStatus.CLOSED, closedAt: now, updater: user });
+    return await versionOf(tx, domain, version.id);
+}
+/** Closes the published version - nobody starts it any more; those who started end on it. */
+async function closeCourseVersion(id, context) {
+    const { domain, user, tx } = context.state;
+    const version = await versionOf(tx, domain, id);
+    const claimed = await tx.getRepository(course_version_1.CourseVersion).update({ id: version.id, status: course_version_1.CourseVersionStatus.PUBLISHED }, { status: course_version_1.CourseVersionStatus.CLOSED, closedAt: new Date(), updater: user });
+    if (!claimed.affected)
+        throw new shell_1.Refusal('learning-version-not-published', {}, 'only the published version is closed');
+    return await versionOf(tx, domain, version.id);
+}
+/** A draft no learner saw is deleted with its units, their files and its questions. */
+async function deleteCourseVersion(id, context) {
+    const { domain, tx } = context.state;
+    const version = await draftOf(tx, domain, id);
+    const units = await unitsOf(tx, version.id);
+    if (units.length) {
+        await (0, attachment_base_1.deleteAttachmentsByRef)(null, { refBys: units.map(one => one.id), refType: exports.COURSE_UNIT_REF_TYPE }, context);
+        await tx.getRepository(course_unit_1.CourseUnit).softDelete({ id: (0, typeorm_1.In)(units.map(one => one.id)) });
+    }
+    await tx.getRepository(course_question_1.CourseQuestion).softDelete({ version: { id: version.id } });
+    await tx.getRepository(course_version_1.CourseVersion).softDelete({ id: version.id });
+    return true;
+}
+/** The file of each unit given - for a video's or a PDF's address. */
+async function unitFilesOf(domain, unitIds) {
+    if (!unitIds.length)
+        return new Map();
+    const rows = await (0, shell_1.getRepository)(attachment_base_1.Attachment).find({ where: { domain: { id: domain.id }, refType: exports.COURSE_UNIT_REF_TYPE, refBy: (0, typeorm_1.In)(unitIds) } });
+    return new Map(rows.map(one => [one.refBy, one]));
+}
+//# sourceMappingURL=course-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"course-service.js","sourceRoot":"","sources":["../../../server/service/course/course-service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * What the doors of courses do with the database (ADR-0194 decisions 2-4): a course, its versions written as drafts,\n * their units and questions, publishing one (the one before closes) and copying one into the next draft. Nothing here\n * changes a published version.\n */\nimport { randomUUID } from 'crypto'\nimport { Readable } from 'stream'\nimport { EntityManager, In, Not } from 'typeorm'\n\nimport { Attachment, createAttachment, deleteAttachmentsByRef, STORAGE } from '@things-factory/attachment-base'\nimport { checkPermission, User } from '@things-factory/auth-base'\nimport { getRepository, Refusal } from '@things-factory/shell'\n\nimport { Course } from './course'\nimport { CourseChoice, CourseQuestion, CourseQuestionKind } from './course-question'\nimport { publishRefusal, questionInputRefusal, unitInputRefusal, versionEditRefusal, versionInputRefusal } from './course-rules'\nimport { CourseUnit, CourseUnitKind } from './course-unit'\nimport { CourseVersion, CourseVersionStatus } from './course-version'\nimport { CoursePatch, CourseQuestionInput, CourseUnitInput, CourseVersionPatch, NewCourse } from './course-type'\n\n/** A unit's file hangs on it under this `refType` (attachment-base). */\nexport const COURSE_UNIT_REF_TYPE = 'CourseUnit'\n\nconst text = (value: unknown) => (typeof value === 'string' && value.trim() ? value.trim() : null)\n\n/** The request's transaction, or the data source's manager for a read that runs without one. */\nexport function learningManagerOf(context: any): EntityManager {\n  return context?.state?.tx ?? getRepository(Course).manager\n}\n\n/** Whether the request holds `category` of this module (`course`, `learning`) - asked once per request. */\nexport async function holds(context: any, category: 'course' | 'learning', privilege: 'query' | 'mutation' = 'mutation'): Promise<boolean> {\n  const state = context?.state ?? {}\n  const { domain, user, unsafeIP, prohibitedPrivileges } = state\n  if (!domain || !user) return false\n  const key = `__learning:${category}:${privilege}`\n  state[key] ??= checkPermission({ category, privilege, owner: true } as any, user, domain, unsafeIP, prohibitedPrivileges).then(Boolean)\n  return await state[key]\n}\n\n/**\n * Whether the request may read what a version says - its units and their files: a manager (`course` query) any version;\n * anyone else only the version an enrolment of theirs shows - its own once started, the published one before. Asked on\n * every path to a version, not only the top-level reads: a learner reached a draft through\n * `myEnrollment → course → versions → units` (2026-11-08).\n */\nexport async function mayReadVersion(context: any, version: { id: string; courseId?: string; status: string } | null | undefined): Promise<boolean> {\n  if (!version) return false\n  if (await holds(context, 'course', 'query')) return true\n  const { domain, user } = context?.state ?? {}\n  if (!domain || !user) return false\n  const state = context.state\n  state.__learningShown ??= learningManagerOf(context)\n    .getRepository('Enrollment')\n    .find({ where: { domain: { id: domain.id }, user: { id: user.id }, status: In(['ASSIGNED', 'IN_PROGRESS', 'COMPLETED']) } as any, relations: ['course', 'version'] })\n  const mine: any[] = await state.__learningShown\n  return mine.some(one => one.course?.id === version.courseId && (one.version ? one.version.id === version.id : version.status === CourseVersionStatus.PUBLISHED))\n}\n\nconst notFound = () => new Refusal('learning-not-found', {}, 'the record was not found. reload and try again.')\n\nfunction refuse(code: string | null): void {\n  if (code) throw new Refusal(code, {}, `refused (${code})`)\n}\n\n/* ---------------------------------------------------------------- courses */\n\nexport async function courseOf(tx: EntityManager, domain: { id: string }, id: string): Promise<Course> {\n  const row = id ? await tx.getRepository(Course).findOne({ where: { id, domain: { id: domain.id } } as any }) : null\n  if (!row) throw notFound()\n  return row\n}\n\nasync function managerOf(tx: EntityManager, domain: any, managerId: string | null | undefined, fallback: User): Promise<User> {\n  if (!managerId) return fallback\n  const user = await tx.getRepository(User).findOne({ where: { id: managerId }, relations: ['domains'] })\n  if (!user || !(user.domains ?? []).some(one => one.id === domain.id)) throw new Refusal('learning-manager-unknown', {}, 'the manager must be a user of this domain')\n  return user\n}\n\nexport async function createCourse(input: NewCourse, context: any): Promise<Course> {\n  const { domain, user, tx } = context.state\n  const name = text(input.name)\n  if (!name) throw new Refusal('learning-course-name-required', {}, 'give the course a name')\n  if (await tx.getRepository(Course).findOne({ where: { domain: { id: domain.id }, name } as any })) throw new Refusal('learning-course-name-taken', { name }, `a course named ${name} exists`)\n  return await tx.getRepository(Course).save({\n    domain,\n    name,\n    description: text(input.description),\n    category: text(input.category),\n    manager: await managerOf(tx, domain, input.managerId, user),\n    creator: user,\n    updater: user\n  } as any)\n}\n\nexport async function updateCourse(id: string, patch: CoursePatch, context: any): Promise<Course> {\n  const { domain, user, tx } = context.state\n  const row = await courseOf(tx, domain, id)\n  if (patch.name !== undefined) {\n    const name = text(patch.name)\n    if (!name) throw new Refusal('learning-course-name-required', {}, 'give the course a name')\n    const taken = await tx.getRepository(Course).findOne({ where: { domain: { id: domain.id }, name, id: Not(id) } as any })\n    if (taken) throw new Refusal('learning-course-name-taken', { name }, `a course named ${name} exists`)\n    row.name = name\n  }\n  if (patch.description !== undefined) row.description = text(patch.description)\n  if (patch.category !== undefined) row.category = text(patch.category)\n  if (patch.managerId !== undefined) row.manager = await managerOf(tx, domain, patch.managerId, user)\n  row.updater = user\n  return await tx.getRepository(Course).save(row)\n}\n\n/* ---------------------------------------------------------------- versions */\n\nexport async function versionOf(tx: EntityManager, domain: { id: string }, id: string): Promise<CourseVersion> {\n  const row = id ? await tx.getRepository(CourseVersion).findOne({ where: { id, domain: { id: domain.id } } as any }) : null\n  if (!row) throw notFound()\n  return row\n}\n\n/** The version learners take now - the one published, or none. */\nexport async function publishedVersionOf(tx: EntityManager, domain: { id: string }, courseId: string): Promise<CourseVersion | null> {\n  return await tx.getRepository(CourseVersion).findOne({ where: { domain: { id: domain.id }, course: { id: courseId }, status: CourseVersionStatus.PUBLISHED } as any })\n}\n\nexport async function unitsOf(tx: EntityManager, versionId: string): Promise<CourseUnit[]> {\n  return await tx.getRepository(CourseUnit).find({ where: { version: { id: versionId } } as any, order: { seq: 'ASC' } as any })\n}\n\nexport async function questionsOf(tx: EntityManager, versionId: string): Promise<CourseQuestion[]> {\n  return await tx.getRepository(CourseQuestion).find({ where: { version: { id: versionId } } as any, order: { seq: 'ASC' } as any })\n}\n\n/** A draft version to write in, refused while the version is published or closed (decision 2). */\nasync function draftOf(tx: EntityManager, domain: { id: string }, id: string): Promise<CourseVersion> {\n  const version = await versionOf(tx, domain, id)\n  refuse(versionEditRefusal(version))\n  return version\n}\n\n/** The file of a unit, copied into a new file of another unit - each version keeps its own. */\nasync function copyFile(from: Attachment, toUnitId: string, context: any): Promise<void> {\n  const bytes: Buffer = Buffer.from(await STORAGE.readFile(from.path))\n  const file = Promise.resolve({ filename: from.name, mimetype: from.mimetype, encoding: from.encoding, createReadStream: () => Readable.from([bytes]) })\n  await createAttachment(null, { attachment: { file, refType: COURSE_UNIT_REF_TYPE, refBy: toUnitId } } as any, context)\n}\n\n/**\n * A new draft of a course - the next number, with what `fromId` says copied (the latest version when not given): its\n * settings, units with their files, and questions. One draft at a time.\n */\nexport async function createCourseVersion(courseId: string, fromId: string | null | undefined, context: any): Promise<CourseVersion> {\n  const { domain, user, tx } = context.state\n  const course = await courseOf(tx, domain, courseId)\n  const repository = (tx as EntityManager).getRepository(CourseVersion)\n  const versions = await repository.find({ where: { domain: { id: domain.id }, course: { id: course.id } } as any, order: { number: 'DESC' } as any })\n  if (versions.some(one => one.status === CourseVersionStatus.DRAFT)) throw new Refusal('learning-draft-exists', {}, 'the course has a draft version - write in it')\n  const from = fromId ? versions.find(one => one.id === fromId) : versions[0]\n  if (fromId && !from) throw notFound()\n\n  const draft = await repository.save({\n    domain,\n    course,\n    number: (versions[0]?.number ?? 0) + 1,\n    status: CourseVersionStatus.DRAFT,\n    minSeconds: from?.minSeconds ?? 0,\n    acknowledgement: from?.acknowledgement ?? null,\n    passScore: from?.passScore ?? null,\n    questionCount: from?.questionCount ?? null,\n    attemptLimit: from?.attemptLimit ?? null,\n    sourceKind: from?.sourceKind ?? null,\n    sourceNote: from?.sourceNote ?? null,\n    creator: user,\n    updater: user\n  } as any)\n  if (!from) return draft\n\n  for (const unit of await unitsOf(tx, from.id)) {\n    const copy = await tx.getRepository(CourseUnit).save({\n      domain,\n      version: draft,\n      seq: unit.seq,\n      kind: unit.kind,\n      name: unit.name,\n      body: unit.body,\n      url: unit.url,\n      durationSeconds: unit.durationSeconds,\n      minSeconds: unit.minSeconds,\n      creator: user,\n      updater: user\n    } as any)\n    const file = await tx.getRepository(Attachment).findOne({ where: { domain: { id: domain.id }, refType: COURSE_UNIT_REF_TYPE, refBy: unit.id } as any })\n    if (file) await copyFile(file, copy.id, context)\n  }\n  for (const question of await questionsOf(tx, from.id)) {\n    await tx.getRepository(CourseQuestion).save({\n      domain,\n      version: draft,\n      seq: question.seq,\n      kind: question.kind,\n      text: question.text,\n      choices: question.choices,\n      explanation: question.explanation,\n      drafted: question.drafted,\n      creator: user,\n      updater: user\n    } as any)\n  }\n  return draft\n}\n\nexport async function updateCourseVersion(id: string, patch: CourseVersionPatch, context: any): Promise<CourseVersion> {\n  const { domain, user, tx } = context.state\n  const version = await draftOf(tx, domain, id)\n  const next = { ...version, ...Object.fromEntries(Object.entries(patch).filter(([, value]) => value !== undefined)) } as CourseVersion\n  refuse(versionInputRefusal(next))\n  for (const field of ['minSeconds', 'passScore', 'questionCount', 'attemptLimit', 'sourceKind'] as const) if (patch[field] !== undefined) (version as any)[field] = patch[field]\n  if (patch.minSeconds === null) version.minSeconds = 0\n  if (patch.acknowledgement !== undefined) version.acknowledgement = text(patch.acknowledgement)\n  if (patch.sourceNote !== undefined) version.sourceNote = text(patch.sourceNote)\n  version.updater = user\n  return await tx.getRepository(CourseVersion).save(version)\n}\n\n/**\n * The units of a draft, in the order given - new ones made, the ones given changed, the ones left out deleted with\n * their files.\n */\nexport async function saveCourseUnits(versionId: string, units: CourseUnitInput[], context: any): Promise<CourseUnit[]> {\n  const { domain, user, tx } = context.state\n  const version = await draftOf(tx, domain, versionId)\n  for (const unit of units) refuse(unitInputRefusal(unit))\n  const repository = (tx as EntityManager).getRepository(CourseUnit)\n  const existing = await unitsOf(tx, version.id)\n  const kept = new Set(units.map(one => one.id).filter(Boolean))\n  if ([...kept].some(id => !existing.some(one => one.id === id))) throw notFound()\n\n  const gone = existing.filter(one => !kept.has(one.id))\n  if (gone.length) {\n    await deleteAttachmentsByRef(null, { refBys: gone.map(one => one.id), refType: COURSE_UNIT_REF_TYPE }, context)\n    await repository.softDelete({ id: In(gone.map(one => one.id)) })\n  }\n  const saved: CourseUnit[] = []\n  for (const [index, unit] of units.entries()) {\n    const row: any = unit.id ? existing.find(one => one.id === unit.id) : repository.create({ domain, version, creator: user } as any)\n    Object.assign(row, {\n      seq: index + 1,\n      kind: unit.kind,\n      name: unit.name.trim(),\n      body: unit.kind === CourseUnitKind.MARKDOWN ? unit.body : null,\n      url: unit.kind === CourseUnitKind.LINK ? unit.url?.trim() : null,\n      durationSeconds: unit.kind === CourseUnitKind.VIDEO ? (unit.durationSeconds ?? row.durationSeconds ?? null) : null,\n      minSeconds: unit.kind === CourseUnitKind.PDF || unit.kind === CourseUnitKind.MARKDOWN ? (unit.minSeconds ?? null) : null,\n      updater: user\n    })\n    saved.push(await repository.save(row))\n  }\n  return saved\n}\n\n/** A video's or a PDF's file for a unit of a draft - it replaces the one before. A video's length comes with it. */\nexport async function attachCourseUnitFile(unitId: string, file: any, durationSeconds: number | null | undefined, context: any): Promise<CourseUnit> {\n  const { domain, user, tx } = context.state\n  const unit = await (tx as EntityManager).getRepository(CourseUnit).findOne({ where: { id: unitId, domain: { id: domain.id } } as any })\n  if (!unit) throw notFound()\n  await draftOf(tx, domain, unit.versionId!)\n  if (unit.kind !== CourseUnitKind.VIDEO && unit.kind !== CourseUnitKind.PDF) throw new Refusal('learning-unit-file-not-taken', {}, 'only a video or a PDF unit takes a file')\n  await deleteAttachmentsByRef(null, { refBys: [unit.id], refType: COURSE_UNIT_REF_TYPE }, context)\n  await createAttachment(null, { attachment: { file, refType: COURSE_UNIT_REF_TYPE, refBy: unit.id } } as any, context)\n  if (unit.kind === CourseUnitKind.VIDEO && durationSeconds != null) {\n    refuse(unitInputRefusal({ kind: unit.kind, name: unit.name, durationSeconds: Math.round(durationSeconds) }))\n    unit.durationSeconds = Math.round(durationSeconds)\n  }\n  unit.updater = user\n  return await tx.getRepository(CourseUnit).save(unit)\n}\n\n/** The choices kept with their ids - an id given stays, a new choice gets one. */\nconst choicesOf = (input: CourseQuestionInput): CourseChoice[] => input.choices.map(one => ({ id: one.id || randomUUID(), text: one.text.trim(), correct: !!one.correct }))\n\n/**\n * The questions of a draft, in the order given - saved by a manager, so each is looked over (`drafted` off). The ones\n * left out are deleted.\n */\nexport async function saveCourseQuestions(versionId: string, questions: CourseQuestionInput[], context: any): Promise<CourseQuestion[]> {\n  const { domain, user, tx } = context.state\n  const version = await draftOf(tx, domain, versionId)\n  for (const question of questions) refuse(questionInputRefusal(question))\n  const repository = (tx as EntityManager).getRepository(CourseQuestion)\n  const existing = await questionsOf(tx, version.id)\n  const kept = new Set(questions.map(one => one.id).filter(Boolean))\n  if ([...kept].some(id => !existing.some(one => one.id === id))) throw notFound()\n  const gone = existing.filter(one => !kept.has(one.id))\n  if (gone.length) await repository.softDelete({ id: In(gone.map(one => one.id)) })\n  const saved: CourseQuestion[] = []\n  for (const [index, question] of questions.entries()) {\n    const row: any = question.id ? existing.find(one => one.id === question.id) : repository.create({ domain, version, creator: user } as any)\n    Object.assign(row, { seq: index + 1, kind: question.kind, text: question.text.trim(), choices: choicesOf(question), explanation: text(question.explanation), drafted: false, updater: user })\n    saved.push(await repository.save(row))\n  }\n  return saved\n}\n\n/** Questions the assistant drafted, added at the end of a draft - each `drafted` until a manager looks it over (decision 12). */\nexport async function addDraftedQuestions(versionId: string, questions: CourseQuestionInput[], context: any): Promise<CourseQuestion[]> {\n  const { domain, user, tx } = context.state\n  const version = await draftOf(tx, domain, versionId)\n  const valid = questions.filter(one => !questionInputRefusal(one))\n  const last = (await questionsOf(tx, version.id)).reduce((max, one) => Math.max(max, one.seq), 0)\n  const saved: CourseQuestion[] = []\n  for (const [index, question] of valid.entries()) {\n    saved.push(\n      await tx.getRepository(CourseQuestion).save({\n        domain,\n        version,\n        seq: last + index + 1,\n        kind: question.kind as CourseQuestionKind,\n        text: question.text.trim(),\n        choices: choicesOf(question),\n        explanation: text(question.explanation),\n        drafted: true,\n        creator: user,\n        updater: user\n      } as any)\n    )\n  }\n  return saved\n}\n\n/**\n * Publishes a draft: what it says is checked (decisions 2-4), it is claimed by an update that only a draft matches -\n * two at once publish once - and the version published before closes. Enrolments in progress end on their own version.\n */\nexport async function publishCourseVersion(id: string, context: any): Promise<CourseVersion> {\n  const { domain, user, tx } = context.state\n  const version = await versionOf(tx, domain, id)\n  const units = await unitsOf(tx, version.id)\n  const files = units.length\n    ? await tx.getRepository(Attachment).find({ where: { domain: { id: domain.id }, refType: COURSE_UNIT_REF_TYPE, refBy: In(units.map(one => one.id)) } as any })\n    : []\n  const questions = await questionsOf(tx, version.id)\n  refuse(publishRefusal({ version, units: units.map(one => ({ ...one, hasFile: files.some(file => file.refBy === one.id) })), questions }))\n\n  const now = new Date()\n  const claimed = await tx.getRepository(CourseVersion).update({ id: version.id, status: CourseVersionStatus.DRAFT } as any, { status: CourseVersionStatus.PUBLISHED, publishedAt: now, updater: user } as any)\n  if (!claimed.affected) throw new Refusal('learning-version-not-draft', {}, 'the version is not a draft any more')\n  await tx\n    .getRepository(CourseVersion)\n    .update({ domain: { id: domain.id }, course: { id: version.courseId }, status: CourseVersionStatus.PUBLISHED, id: Not(version.id) } as any, { status: CourseVersionStatus.CLOSED, closedAt: now, updater: user } as any)\n  return await versionOf(tx, domain, version.id)\n}\n\n/** Closes the published version - nobody starts it any more; those who started end on it. */\nexport async function closeCourseVersion(id: string, context: any): Promise<CourseVersion> {\n  const { domain, user, tx } = context.state\n  const version = await versionOf(tx, domain, id)\n  const claimed = await tx.getRepository(CourseVersion).update({ id: version.id, status: CourseVersionStatus.PUBLISHED } as any, { status: CourseVersionStatus.CLOSED, closedAt: new Date(), updater: user } as any)\n  if (!claimed.affected) throw new Refusal('learning-version-not-published', {}, 'only the published version is closed')\n  return await versionOf(tx, domain, version.id)\n}\n\n/** A draft no learner saw is deleted with its units, their files and its questions. */\nexport async function deleteCourseVersion(id: string, context: any): Promise<boolean> {\n  const { domain, tx } = context.state\n  const version = await draftOf(tx, domain, id)\n  const units = await unitsOf(tx, version.id)\n  if (units.length) {\n    await deleteAttachmentsByRef(null, { refBys: units.map(one => one.id), refType: COURSE_UNIT_REF_TYPE }, context)\n    await tx.getRepository(CourseUnit).softDelete({ id: In(units.map(one => one.id)) })\n  }\n  await tx.getRepository(CourseQuestion).softDelete({ version: { id: version.id } } as any)\n  await tx.getRepository(CourseVersion).softDelete({ id: version.id })\n  return true\n}\n\n/** The file of each unit given - for a video's or a PDF's address. */\nexport async function unitFilesOf(domain: { id: string }, unitIds: string[]): Promise<Map<string, Attachment>> {\n  if (!unitIds.length) return new Map()\n  const rows = await getRepository(Attachment).find({ where: { domain: { id: domain.id }, refType: COURSE_UNIT_REF_TYPE, refBy: In(unitIds) } as any })\n  return new Map(rows.map(one => [one.refBy!, one]))\n}\n\n"]}

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

@@ -0,0 +1,55 @@
+import { Course } from './course';
+import { CourseQuestionKind } from './course-question';
+import { CourseUnitKind } from './course-unit';
+import { CourseSourceKind } from './course-version';
+export declare class NewCourse {
+    name: string;
+    description?: string;
+    category?: string;
+    managerId?: string;
+}
+export declare class CoursePatch {
+    name?: string;
+    description?: string;
+    category?: string;
+    managerId?: string;
+}
+export declare class CourseVersionPatch {
+    minSeconds?: number;
+    acknowledgement?: string;
+    passScore?: number;
+    questionCount?: number;
+    attemptLimit?: number;
+    sourceKind?: CourseSourceKind;
+    sourceNote?: string;
+}
+export declare class CourseUnitInput {
+    id?: string;
+    kind: CourseUnitKind;
+    name: string;
+    body?: string;
+    url?: string;
+    durationSeconds?: number;
+    minSeconds?: number;
+}
+export declare class CourseChoiceInput {
+    id?: string;
+    text: string;
+    correct: boolean;
+}
+export declare class CourseQuestionInput {
+    id?: string;
+    kind: CourseQuestionKind;
+    text: string;
+    choices: CourseChoiceInput[];
+    explanation?: string;
+}
+export declare class CourseChoiceKey {
+    id: string;
+    text: string;
+    correct: boolean;
+}
+export declare class CourseList {
+    items: Course[];
+    total: number;
+}