@things-factory/learning 0.0.0-stage → 10.1.260

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

@@ -0,0 +1,26 @@
+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 {
+    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,172 @@
+"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 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, course_service_1.holds)(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, course_service_1.holds)(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 {
+    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 => 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, course_service_1.holds)(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, Query, Resolver, Root, UseMiddleware } from 'type-graphql'\n\nimport { Attachment } from '@things-factory/attachment-base'\nimport { User } from '@things-factory/auth-base'\nimport { getQueryBuilderFromListParams, getRepository, ListParam, 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 { CourseChoiceKey, CourseList } from './course-type'\nimport { holds, 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 holds(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 holds(context, 'course', 'query'))) return []\n    return await questionsOf(learningManagerOf(context), version.id)\n  }\n}\n\n@Resolver(CourseUnit)\nexport class CourseUnitFields {\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 holds(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;
+}

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

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CourseQuestion = exports.CourseQuestionKind = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const typeorm_1 = require("typeorm");
+const auth_base_1 = require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+const course_version_1 = require("./course-version");
+/** How a question is answered. */
+var CourseQuestionKind;
+(function (CourseQuestionKind) {
+    CourseQuestionKind["SINGLE"] = "SINGLE";
+    CourseQuestionKind["MULTIPLE"] = "MULTIPLE";
+    CourseQuestionKind["TRUE_FALSE"] = "TRUE_FALSE";
+})(CourseQuestionKind || (exports.CourseQuestionKind = CourseQuestionKind = {}));
+(0, type_graphql_1.registerEnumType)(CourseQuestionKind, { name: 'CourseQuestionKind', description: 'SINGLE - one choice; MULTIPLE - every right choice; TRUE_FALSE - true or false.' });
+/**
+ * 문항 (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).
+ */
+let CourseQuestion = class CourseQuestion {
+};
+exports.CourseQuestion = CourseQuestion;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Question id.' }),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true, description: 'The domain.' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], CourseQuestion.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((row) => row.domain),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => course_version_1.CourseVersion),
+    (0, type_graphql_1.Field)(type => course_version_1.CourseVersion, { nullable: true, description: 'The version it is part of.' }),
+    tslib_1.__metadata("design:type", course_version_1.CourseVersion)
+], CourseQuestion.prototype, "version", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((row) => row.version),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "versionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'int' }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Its place in the version, from 1.' }),
+    tslib_1.__metadata("design:type", Number)
+], CourseQuestion.prototype, "seq", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)(type => CourseQuestionKind, { description: 'How it is answered.' }),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'text' }),
+    (0, type_graphql_1.Field)({ description: 'What it asks.' }),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "text", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json' }),
+    tslib_1.__metadata("design:type", Array)
+], CourseQuestion.prototype, "choices", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Why the answer is what it is.' }),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "explanation", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    (0, type_graphql_1.Field)({ description: 'Drafted by the assistant and not looked over by a manager yet.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], CourseQuestion.prototype, "drafted", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Creation timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], CourseQuestion.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Last update timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], CourseQuestion.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Soft delete timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], CourseQuestion.prototype, "deletedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'Who made it.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], CourseQuestion.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((row) => row.creator),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'Who changed it last.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], CourseQuestion.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((row) => row.updater),
+    tslib_1.__metadata("design:type", String)
+], CourseQuestion.prototype, "updaterId", void 0);
+exports.CourseQuestion = CourseQuestion = tslib_1.__decorate([
+    (0, typeorm_1.Entity)({ name: 'learning_course_questions' }),
+    (0, typeorm_1.Index)('ix_learning_course_question_0', (row) => [row.domain, row.version, row.seq]),
+    (0, type_graphql_1.ObjectType)({ description: "A question of a course version's quiz - which choices are right is read only by managers." })
+], CourseQuestion);
+//# sourceMappingURL=course-question.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"course-question.js","sourceRoot":"","sources":["../../../server/service/course/course-question.ts"],"names":[],"mappings":";;;;AAAA,+CAA2E;AAC3E,qCAAoJ;AAEpJ,yDAAgD;AAChD,iDAA8C;AAE9C,qDAAgD;AAEhD,kCAAkC;AAClC,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;IACrB,+CAAyB,CAAA;AAC3B,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED,IAAA,+BAAgB,EAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC,CAAA;AASpK;;;;GAIG;AAII,IAAM,cAAc,GAApB,MAAM,cAAc;CAoE1B,CAAA;AApEY,wCAAc;AAGhB;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;;0CAChC;AAInB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;sCAC7D,cAAM;8CAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,GAAmB,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;;gDAC/B;AAIjB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,8BAAa,CAAC;IAChC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,8BAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;sCAClF,8BAAa;+CAAA;AAGvB;IADC,IAAA,oBAAU,EAAC,CAAC,GAAmB,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;;iDAC/B;AAIlB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACvB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;;2CAC9D;AAIX;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;;4CAClD;AAIxB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;;4CAC5B;AAIZ;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;;+CACT;AAIvB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC;;mDACpD;AAIpB;IAFC,IAAA,gBAAM,EAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;;+CACzE;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;sCAClD,IAAI;iDAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;sCACrD,IAAI;iDAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;sCACrD,IAAI;iDAAA;AAIhB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;sCAC3D,gBAAI;+CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,GAAmB,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;;iDAC/B;AAIlB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;sCACnE,gBAAI;+CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,GAAmB,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;;iDAC/B;yBAnEP,cAAc;IAH1B,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;IAC7C,IAAA,eAAK,EAAC,+BAA+B,EAAE,CAAC,GAAmB,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACnG,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,2FAA2F,EAAE,CAAC;GAC5G,cAAc,CAoE1B","sourcesContent":["import { Field, ID, Int, ObjectType, registerEnumType } from 'type-graphql'\nimport { Column, CreateDateColumn, DeleteDateColumn, Entity, Index, ManyToOne, PrimaryGeneratedColumn, RelationId, UpdateDateColumn } from 'typeorm'\n\nimport { User } from '@things-factory/auth-base'\nimport { Domain } from '@things-factory/shell'\n\nimport { CourseVersion } from './course-version'\n\n/** How a question is answered. */\nexport enum CourseQuestionKind {\n  SINGLE = 'SINGLE',\n  MULTIPLE = 'MULTIPLE',\n  TRUE_FALSE = 'TRUE_FALSE'\n}\n\nregisterEnumType(CourseQuestionKind, { name: 'CourseQuestionKind', description: 'SINGLE - one choice; MULTIPLE - every right choice; TRUE_FALSE - true or false.' })\n\n/** One choice of a question, with whether it is right - kept in the row, never sent to a learner. */\nexport interface CourseChoice {\n  id: string\n  text: string\n  correct: boolean\n}\n\n/**\n * 문항 (ADR-0194 decision 4) - one question of a version's quiz: its choices with which are right, and why. Whether a\n * choice is right is read by the server's scoring and the managers' editor only; a learner is drawn the question without\n * it. One the assistant drafted stays `drafted` until a manager looks it over (decision 12).\n */\n@Entity({ name: 'learning_course_questions' })\n@Index('ix_learning_course_question_0', (row: CourseQuestion) => [row.domain, row.version, row.seq])\n@ObjectType({ description: \"A question of a course version's quiz - which choices are right is read only by managers.\" })\nexport class CourseQuestion {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Question id.' })\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain.' })\n  domain?: Domain\n\n  @RelationId((row: CourseQuestion) => row.domain)\n  domainId?: string\n\n  @ManyToOne(type => CourseVersion)\n  @Field(type => CourseVersion, { nullable: true, description: 'The version it is part of.' })\n  version?: CourseVersion\n\n  @RelationId((row: CourseQuestion) => row.version)\n  versionId?: string\n\n  @Column({ type: 'int' })\n  @Field(type => Int, { description: 'Its place in the version, from 1.' })\n  seq: number\n\n  @Column()\n  @Field(type => CourseQuestionKind, { description: 'How it is answered.' })\n  kind: CourseQuestionKind\n\n  @Column({ type: 'text' })\n  @Field({ description: 'What it asks.' })\n  text: string\n\n  /** The choices with which are right - not a field: a learner never reads it. */\n  @Column({ type: 'simple-json' })\n  choices: CourseChoice[]\n\n  @Column({ type: 'text', nullable: true })\n  @Field({ nullable: true, description: 'Why the answer is what it is.' })\n  explanation?: string\n\n  @Column({ default: false })\n  @Field({ description: 'Drafted by the assistant and not looked over by a manager yet.' })\n  drafted: boolean\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp.' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft delete timestamp.' })\n  deletedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Who made it.' })\n  creator?: User\n\n  @RelationId((row: CourseQuestion) => row.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Who changed it last.' })\n  updater?: User\n\n  @RelationId((row: CourseQuestion) => row.updater)\n  updaterId?: string\n}\n"]}

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

@@ -0,0 +1,49 @@
+export interface VersionShape {
+    status: string;
+    passScore?: number | null;
+    questionCount?: number | null;
+    attemptLimit?: number | null;
+    minSeconds?: number | null;
+}
+/** Why a version may not be written to - a published or closed one never changes (decision 2). */
+export declare function versionEditRefusal(version: {
+    status: string;
+} | null | undefined): string | null;
+/** Why what a version says may not be kept. */
+export declare function versionInputRefusal(input: VersionShape): string | null;
+export interface UnitInput {
+    kind: string;
+    name?: string | null;
+    body?: string | null;
+    url?: string | null;
+    durationSeconds?: number | null;
+    minSeconds?: number | null;
+}
+/** Why a unit may not be kept as given. A video's or a PDF's file is attached apart - publishing asks for it. */
+export declare function unitInputRefusal(unit: UnitInput): string | null;
+export interface QuestionInput {
+    kind: string;
+    text?: string | null;
+    choices: {
+        text: string;
+        correct: boolean;
+    }[];
+}
+/** Why a question may not be kept: its text, two choices or more (TRUE_FALSE exactly two), and the right ones its kind allows. */
+export declare function questionInputRefusal(question: QuestionInput): string | null;
+export interface PublishFacts {
+    version: VersionShape;
+    units: {
+        kind: string;
+        durationSeconds?: number | null;
+        hasFile: boolean;
+    }[];
+    questions: {
+        drafted: boolean;
+    }[];
+}
+/**
+ * Why a draft may not be published (decisions 2-4): a unit or more; a video or a PDF with its file, a video with its
+ * length; a quiz with questions - as many as it draws, none of them a draft the assistant made that no manager looked over.
+ */
+export declare function publishRefusal({ version, units, questions }: PublishFacts): string | null;

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

@@ -0,0 +1,89 @@
+"use strict";
+/*
+ * What may be done to a course's versions (ADR-0194 decisions 2-4) - data in, the refusal's code out, no database.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.versionEditRefusal = versionEditRefusal;
+exports.versionInputRefusal = versionInputRefusal;
+exports.unitInputRefusal = unitInputRefusal;
+exports.questionInputRefusal = questionInputRefusal;
+exports.publishRefusal = publishRefusal;
+/** Why a version may not be written to - a published or closed one never changes (decision 2). */
+function versionEditRefusal(version) {
+    if (!version)
+        return 'learning-version-not-found';
+    return version.status === 'DRAFT' ? null : 'learning-version-not-draft';
+}
+/** Why what a version says may not be kept. */
+function versionInputRefusal(input) {
+    if (input.minSeconds != null && (!Number.isInteger(input.minSeconds) || input.minSeconds < 0))
+        return 'learning-min-time-invalid';
+    if (input.passScore != null && (!Number.isInteger(input.passScore) || input.passScore < 1 || input.passScore > 100))
+        return 'learning-pass-score-invalid';
+    if (input.questionCount != null && (!Number.isInteger(input.questionCount) || input.questionCount < 1))
+        return 'learning-question-count-invalid';
+    if (input.attemptLimit != null && (!Number.isInteger(input.attemptLimit) || input.attemptLimit < 1))
+        return 'learning-attempt-limit-invalid';
+    return null;
+}
+const KINDS = ['VIDEO', 'PDF', 'MARKDOWN', 'LINK'];
+/** Why a unit may not be kept as given. A video's or a PDF's file is attached apart - publishing asks for it. */
+function unitInputRefusal(unit) {
+    if (!KINDS.includes(unit.kind))
+        return 'learning-unit-kind-invalid';
+    if (!unit.name?.trim())
+        return 'learning-unit-name-required';
+    if (unit.kind === 'MARKDOWN' && !unit.body?.trim())
+        return 'learning-unit-body-required';
+    if (unit.kind === 'LINK' && !/^https?:\/\//i.test(unit.url?.trim() ?? ''))
+        return 'learning-unit-url-invalid';
+    if (unit.minSeconds != null && (!Number.isInteger(unit.minSeconds) || unit.minSeconds < 1))
+        return 'learning-unit-min-time-invalid';
+    if (unit.durationSeconds != null && (!Number.isInteger(unit.durationSeconds) || unit.durationSeconds < 1))
+        return 'learning-unit-duration-invalid';
+    return null;
+}
+/** Why a question may not be kept: its text, two choices or more (TRUE_FALSE exactly two), and the right ones its kind allows. */
+function questionInputRefusal(question) {
+    if (!['SINGLE', 'MULTIPLE', 'TRUE_FALSE'].includes(question.kind))
+        return 'learning-question-kind-invalid';
+    if (!question.text?.trim())
+        return 'learning-question-text-required';
+    const choices = question.choices ?? [];
+    if (choices.length < 2 || choices.some(one => !one.text?.trim()))
+        return 'learning-question-choices-required';
+    if (question.kind === 'TRUE_FALSE' && choices.length !== 2)
+        return 'learning-question-choices-required';
+    const right = choices.filter(one => one.correct).length;
+    if (right === 0)
+        return 'learning-question-answer-required';
+    if (question.kind !== 'MULTIPLE' && right !== 1)
+        return 'learning-question-one-answer';
+    return null;
+}
+/**
+ * Why a draft may not be published (decisions 2-4): a unit or more; a video or a PDF with its file, a video with its
+ * length; a quiz with questions - as many as it draws, none of them a draft the assistant made that no manager looked over.
+ */
+function publishRefusal({ version, units, questions }) {
+    if (version.status !== 'DRAFT')
+        return 'learning-version-not-draft';
+    if (!units.length)
+        return 'learning-units-required';
+    for (const unit of units) {
+        if ((unit.kind === 'VIDEO' || unit.kind === 'PDF') && !unit.hasFile)
+            return 'learning-unit-file-required';
+        if (unit.kind === 'VIDEO' && !unit.durationSeconds)
+            return 'learning-unit-duration-required';
+    }
+    if (version.passScore != null) {
+        if (!questions.length)
+            return 'learning-questions-required';
+        if (version.questionCount != null && version.questionCount > questions.length)
+            return 'learning-question-count-too-many';
+    }
+    if (questions.some(one => one.drafted))
+        return 'learning-questions-drafted';
+    return null;
+}
+//# sourceMappingURL=course-rules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"course-rules.js","sourceRoot":"","sources":["../../../server/service/course/course-rules.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * What may be done to a course's versions (ADR-0194 decisions 2-4) - data in, the refusal's code out, no database.\n */\n\nexport interface VersionShape {\n  status: string\n  passScore?: number | null\n  questionCount?: number | null\n  attemptLimit?: number | null\n  minSeconds?: number | null\n}\n\n/** Why a version may not be written to - a published or closed one never changes (decision 2). */\nexport function versionEditRefusal(version: { status: string } | null | undefined): string | null {\n  if (!version) return 'learning-version-not-found'\n  return version.status === 'DRAFT' ? null : 'learning-version-not-draft'\n}\n\n/** Why what a version says may not be kept. */\nexport function versionInputRefusal(input: VersionShape): string | null {\n  if (input.minSeconds != null && (!Number.isInteger(input.minSeconds) || input.minSeconds < 0)) return 'learning-min-time-invalid'\n  if (input.passScore != null && (!Number.isInteger(input.passScore) || input.passScore < 1 || input.passScore > 100)) return 'learning-pass-score-invalid'\n  if (input.questionCount != null && (!Number.isInteger(input.questionCount) || input.questionCount < 1)) return 'learning-question-count-invalid'\n  if (input.attemptLimit != null && (!Number.isInteger(input.attemptLimit) || input.attemptLimit < 1)) return 'learning-attempt-limit-invalid'\n  return null\n}\n\nexport interface UnitInput {\n  kind: string\n  name?: string | null\n  body?: string | null\n  url?: string | null\n  durationSeconds?: number | null\n  minSeconds?: number | null\n}\n\nconst KINDS = ['VIDEO', 'PDF', 'MARKDOWN', 'LINK']\n\n/** Why a unit may not be kept as given. A video's or a PDF's file is attached apart - publishing asks for it. */\nexport function unitInputRefusal(unit: UnitInput): string | null {\n  if (!KINDS.includes(unit.kind)) return 'learning-unit-kind-invalid'\n  if (!unit.name?.trim()) return 'learning-unit-name-required'\n  if (unit.kind === 'MARKDOWN' && !unit.body?.trim()) return 'learning-unit-body-required'\n  if (unit.kind === 'LINK' && !/^https?:\\/\\//i.test(unit.url?.trim() ?? '')) return 'learning-unit-url-invalid'\n  if (unit.minSeconds != null && (!Number.isInteger(unit.minSeconds) || unit.minSeconds < 1)) return 'learning-unit-min-time-invalid'\n  if (unit.durationSeconds != null && (!Number.isInteger(unit.durationSeconds) || unit.durationSeconds < 1)) return 'learning-unit-duration-invalid'\n  return null\n}\n\nexport interface QuestionInput {\n  kind: string\n  text?: string | null\n  choices: { text: string; correct: boolean }[]\n}\n\n/** Why a question may not be kept: its text, two choices or more (TRUE_FALSE exactly two), and the right ones its kind allows. */\nexport function questionInputRefusal(question: QuestionInput): string | null {\n  if (!['SINGLE', 'MULTIPLE', 'TRUE_FALSE'].includes(question.kind)) return 'learning-question-kind-invalid'\n  if (!question.text?.trim()) return 'learning-question-text-required'\n  const choices = question.choices ?? []\n  if (choices.length < 2 || choices.some(one => !one.text?.trim())) return 'learning-question-choices-required'\n  if (question.kind === 'TRUE_FALSE' && choices.length !== 2) return 'learning-question-choices-required'\n  const right = choices.filter(one => one.correct).length\n  if (right === 0) return 'learning-question-answer-required'\n  if (question.kind !== 'MULTIPLE' && right !== 1) return 'learning-question-one-answer'\n  return null\n}\n\nexport interface PublishFacts {\n  version: VersionShape\n  units: { kind: string; durationSeconds?: number | null; hasFile: boolean }[]\n  questions: { drafted: boolean }[]\n}\n\n/**\n * Why a draft may not be published (decisions 2-4): a unit or more; a video or a PDF with its file, a video with its\n * length; a quiz with questions - as many as it draws, none of them a draft the assistant made that no manager looked over.\n */\nexport function publishRefusal({ version, units, questions }: PublishFacts): string | null {\n  if (version.status !== 'DRAFT') return 'learning-version-not-draft'\n  if (!units.length) return 'learning-units-required'\n  for (const unit of units) {\n    if ((unit.kind === 'VIDEO' || unit.kind === 'PDF') && !unit.hasFile) return 'learning-unit-file-required'\n    if (unit.kind === 'VIDEO' && !unit.durationSeconds) return 'learning-unit-duration-required'\n  }\n  if (version.passScore != null) {\n    if (!questions.length) return 'learning-questions-required'\n    if (version.questionCount != null && version.questionCount > questions.length) return 'learning-question-count-too-many'\n  }\n  if (questions.some(one => one.drafted)) return 'learning-questions-drafted'\n  return null\n}\n"]}

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

@@ -0,0 +1,71 @@
+import { EntityManager } from 'typeorm';
+import { Attachment } from '@things-factory/attachment-base';
+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';
+/** A unit's file hangs on it under this `refType` (attachment-base). */
+export declare const COURSE_UNIT_REF_TYPE = "CourseUnit";
+/** The request's transaction, or the data source's manager for a read that runs without one. */
+export declare function learningManagerOf(context: any): EntityManager;
+/** Whether the request holds `category` of this module (`course`, `learning`) - asked once per request. */
+export declare function holds(context: any, category: 'course' | 'learning', privilege?: 'query' | 'mutation'): Promise<boolean>;
+/**
+ * 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).
+ */
+export declare function mayReadVersion(context: any, version: {
+    id: string;
+    courseId?: string;
+    status: string;
+} | null | undefined): Promise<boolean>;
+export declare function courseOf(tx: EntityManager, domain: {
+    id: string;
+}, id: string): Promise<Course>;
+export declare function createCourse(input: NewCourse, context: any): Promise<Course>;
+export declare function updateCourse(id: string, patch: CoursePatch, context: any): Promise<Course>;
+export declare function versionOf(tx: EntityManager, domain: {
+    id: string;
+}, id: string): Promise<CourseVersion>;
+/** The version learners take now - the one published, or none. */
+export declare function publishedVersionOf(tx: EntityManager, domain: {
+    id: string;
+}, courseId: string): Promise<CourseVersion | null>;
+export declare function unitsOf(tx: EntityManager, versionId: string): Promise<CourseUnit[]>;
+export declare function questionsOf(tx: EntityManager, versionId: string): Promise<CourseQuestion[]>;
+/**
+ * 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.
+ */
+export declare function createCourseVersion(courseId: string, fromId: string | null | undefined, context: any): Promise<CourseVersion>;
+export declare function updateCourseVersion(id: string, patch: CourseVersionPatch, context: any): Promise<CourseVersion>;
+/**
+ * The units of a draft, in the order given - new ones made, the ones given changed, the ones left out deleted with
+ * their files.
+ */
+export declare function saveCourseUnits(versionId: string, units: CourseUnitInput[], context: any): Promise<CourseUnit[]>;
+/** 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. */
+export declare function attachCourseUnitFile(unitId: string, file: any, durationSeconds: number | null | undefined, context: any): Promise<CourseUnit>;
+/**
+ * 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.
+ */
+export declare function saveCourseQuestions(versionId: string, questions: CourseQuestionInput[], context: any): Promise<CourseQuestion[]>;
+/** Questions the assistant drafted, added at the end of a draft - each `drafted` until a manager looks it over (decision 12). */
+export declare function addDraftedQuestions(versionId: string, questions: CourseQuestionInput[], context: any): Promise<CourseQuestion[]>;
+/**
+ * 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.
+ */
+export declare function publishCourseVersion(id: string, context: any): Promise<CourseVersion>;
+/** Closes the published version - nobody starts it any more; those who started end on it. */
+export declare function closeCourseVersion(id: string, context: any): Promise<CourseVersion>;
+/** A draft no learner saw is deleted with its units, their files and its questions. */
+export declare function deleteCourseVersion(id: string, context: any): Promise<boolean>;
+/** The file of each unit given - for a video's or a PDF's address. */
+export declare function unitFilesOf(domain: {
+    id: string;
+}, unitIds: string[]): Promise<Map<string, Attachment>>;