bolbol-sdk 2.0.1 → 2.0.3

package/dist/scope/BolbolTeacherScope.js

@@ -10,15 +10,29 @@ exports.BolbolTeacherScope = void 0;
 // and the backend re-verifies the profile belongs to the caller every request.
 //
 // Besides the profile (account, documents, certificates, ...), the teacher
-// owns the content that says how to learn on top of an academy's published
-// collection version (Bolbol API rules/Teacher.md): learning kits (annotation
-// groups, category types and values, mindsets, concepts), components (one
-// learning action over one collection version, holding ref assets, ref items,
-// answers or ambiguities), and packages - sellable bundles of components whose
-// `version.publish` is the only publish on the teacher side. Every write to a
-// versioned entity lands on a draft version, forking one when the latest is
-// published; what is not versioned - a learning kit itself, a component's
-// kits, a package's pricing - is written in place.
+// owns the content that says how to learn (Bolbol API rules/Teacher.md):
+// - learning kits: annotation groups, category types and values, mindsets
+//   and concepts. A kit is scoped to an exam, optionally narrowed to one
+//   skill of it and one task of that skill - a null skill or task covers
+//   every one below it - and each child sits inside its kit's scope. The
+//   per-exam lists (`annotationGroup.listAll`, `categoryType.listAll`, ...)
+//   read the children of every kit at once;
+// - a resource library: videos, podcasts, files and URLs, filed in
+//   `folder`s, each in one language with exam scopes, category values, a
+//   word list and annotations on its transcript;
+// - components: one learning action each, holding ref assets, ref items,
+//   answers or ambiguities over one published collection version of an
+//   academy - or, for a Resource component, built on no collection, ref
+//   resources: library resources filed under the component's own folders;
+// - packages: sellable bundles of components whose `version.publish` is the
+//   only publish on the teacher side.
+// Every write to a versioned entity lands on a draft version, forking one
+// when the latest is published; what is not versioned - a learning kit
+// itself, a component's kits, a package's pricing, the resource library -
+// is written in place. Creating a package, a component or a resource, and
+// publishing a package, needs Bolbol's authorization for that kind - a
+// component Package and its type family's kind both (`authorization.get`;
+// 403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED without it).
 // The teacher's pricings and contracts are the same surface as the academy's
 // (BolbolAcademyScope `pricing` / `contract`), and `package.upload` with
 // `uid.check` serve the Academy CLI's teacher project.
@@ -167,15 +181,28 @@ class BolbolTeacherScope {
         // GET /teacher/:teacher_uid/entity/:entity_type/:entity_id/attachment - TeacherAttachmentList
         list: (teacher_uid, entity_type, entity_id) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/entity/${encodeURIComponent(entity_type)}/${entity_id}/attachment`),
     };
-    // The teacher's VERIFICATION requests - the ones addressed to Bolbol
-    // itself. They are rows in the same `request` table every other request
-    // lives in, so they carry the same RequestRowType shape; what is
-    // teacher-specific is only the filter. Party-to-party requests go through
-    // `bolbol.request`.
+    // The teacher's requests to Bolbol itself - VERIFICATIONs, and the
+    // AUTHORIZATION requests Bolbol grants `authorization` with. They are
+    // rows in the same `request` table every other request lives in, so they
+    // carry the same RequestRowType shape; what is teacher-specific is only
+    // the filter. Party-to-party requests go through `bolbol.request`.
     request = {
         // GET /teacher/:teacher_uid/request - TeacherRequestList
         list: (teacher_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/request`),
     };
+    // What Bolbol has authorized the teacher to manage, kind by kind
+    // (ManageAuthorizationEnum): packages, components on a collection or on
+    // resources, videos, podcasts, files, URLs and courses - each until a date,
+    // for good, or not at all. The gated creates answer 403
+    // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED without it; a component
+    // create needs Package as well as its family's kind. A grant is
+    // asked for with `bolbol.request.create` and the row's `request_type`, and
+    // given by Bolbol's approval; nothing here writes.
+    authorization = {
+        // One row per kind, its status computed as of today.
+        // GET /teacher/:teacher_uid/authorization - TeacherAuthorizationGet
+        get: (teacher_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/authorization`),
+    };
     // The teacher's price lists - the same surface as `academy.pricing`. A
     // pricing is a named set of region rows (one country, or the fallback for
     // every other country: free, or a one-time and / or monthly price in
@@ -225,43 +252,62 @@ class BolbolTeacherScope {
         get: (teacher_uid, contract_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/contract/${encodeURIComponent(contract_uid)}`),
     };
     // Published versions of a collection, as a teacher reads them - what a
-    // component or a package is built on. Any signed-in teacher may read the
-    // published versions of any collection that is not deleted; collections
-    // are found through the public `bolbol.collection.directory.list`.
+    // component or a package is built on - and what each of them reaches.
+    // Any signed-in teacher may read the published versions of any collection
+    // that is not deleted; collections are found through the public
+    // `bolbol.collection.directory.list`.
     collection = {
         version: {
             // Published versions only, newest first, without the academy's
             // `notes_private`.
             // GET /teacher/:teacher_uid/collection/:collection_uid/version - TeacherCollectionVersionList
             list: (teacher_uid, collection_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/collection/${encodeURIComponent(collection_uid)}/version`),
+            // What one of those published versions reaches (decision N15): the
+            // exam, skill and task of every item it pins, each once - the list
+            // the component create judges a component's skill / task against
+            // (400 COMPONENT_SCOPE_NOT_IN_COLLECTION), so a form offers only
+            // what it accepts. Named by the version's own uid, as the
+            // component create's body names it; 404 / 400 for a version the
+            // create refuses.
+            // GET /teacher/:teacher_uid/collection-version/:collection_version_uid/reach - TeacherCollectionVersionReach
+            reach: (teacher_uid, collection_version_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/collection-version/${encodeURIComponent(collection_version_uid)}/reach`),
         },
     };
-    // The teacher's learning kits: the learning material authored for one task
-    // of one skill - annotation groups, category types and values, mindsets
-    // and concepts - that components pick from (`component.learningKit.set`).
-    // A kit is not versioned; its children are, each with its own draft /
-    // published versions like the academy's entities. Every child's skill and
-    // task are the kit's.
+    // The teacher's learning kits: the learning material authored for one
+    // exam - or one skill of it, or one task of that skill - as annotation
+    // groups, category types and values, mindsets and concepts, which
+    // components (`component.learningKit.set`) and resources pick from. A
+    // null skill or task covers every one below it, so a kit for the whole
+    // exam serves each of its tasks. A kit is not versioned; its children
+    // are, each with its own draft / published versions like the academy's
+    // entities. Each child has its own skill / task, inside its kit's.
     learningKit = {
-        // Paged; narrowed by exam / skill / task, or searched by uid and name.
+        // Paged, oldest first; narrowed by exam / skill / task - by equality,
+        // or with `covering` to the kits whose scope covers the one target
+        // they name (a kit with no skill covers every skill of its exam) - or
+        // searched by uid and name.
         // GET /teacher/:teacher_uid/learning-kit - TeacherLearningKitList
         list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit`, { query: request }),
+        // The kit's exam, skill and task are fixed here; a task needs a skill
+        // (400 FIELD_REQUIRES).
         // POST /teacher/:teacher_uid/learning-kit - TeacherLearningKitCreate
         create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit`, { body: request }),
         // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid - TeacherLearningKitGet
         get: (teacher_uid, learning_kit_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}`),
-        // The name and the notes; the skill and task are immutable.
+        // The name and the notes; the exam, skill and task are immutable.
         // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid - TeacherLearningKitUpdate
         update: (teacher_uid, learning_kit_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}`, { body: request }),
         // 409 while a live component lists the kit.
         // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid - TeacherLearningKitDelete
         delete: (teacher_uid, learning_kit_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}`),
         // The kit's annotation groups (Vocabulary, Grammar, ...): defined once,
-        // picked for every annotation the teacher's ref assets, ref items and
-        // answers add.
+        // picked for every annotation the teacher's ref assets, ref items,
+        // answers and resources add.
         annotationGroup: {
             // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/annotation-group - TeacherAnnotationGroupList
             list: (teacher_uid, learning_kit_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
             // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/annotation-group - TeacherAnnotationGroupCreate
             create: (teacher_uid, learning_kit_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group`, { body: request }),
             // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid - TeacherAnnotationGroupUpdate
@@ -286,6 +332,8 @@ class BolbolTeacherScope {
             // tab can draw its selects from a single round trip.
             // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type - TeacherCategoryTypeList
             list: (teacher_uid, learning_kit_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
             // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type - TeacherCategoryTypeCreate
             create: (teacher_uid, learning_kit_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type`, { body: request }),
             // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid - TeacherCategoryTypeUpdate
@@ -305,6 +353,9 @@ class BolbolTeacherScope {
             value: {
                 // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value - TeacherCategoryValueList
                 list: (teacher_uid, learning_kit_uid, category_type_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value`),
+                // Its skill and task default to the kit's, not its type's;
+                // given, they must lie inside the kit's scope (400
+                // LEARNING_KIT_SCOPE_MISMATCH).
                 // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value - TeacherCategoryValueCreate
                 create: (teacher_uid, learning_kit_uid, category_type_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value`, { body: request }),
                 // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid - TeacherCategoryValueUpdate
@@ -350,6 +401,8 @@ class BolbolTeacherScope {
             list: (teacher_uid, learning_kit_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset`),
             // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid - TeacherMindsetGet
             get: (teacher_uid, learning_kit_uid, mindset_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
             // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset - TeacherMindsetCreate
             create: (teacher_uid, learning_kit_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset`, { body: request }),
             // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid - TeacherMindsetUpdate
@@ -381,16 +434,18 @@ class BolbolTeacherScope {
                 remove: (teacher_uid, learning_kit_uid, mindset_uid, topic_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/${encodeURIComponent(topic_uid)}`),
             },
         },
-        // The kit's concepts: an idea tied to the kit's task ("Giving an
-        // opinion") with its explanation and the numbered scenarios it applies
-        // in. Versioned like mindset; a RefItem_Concept component pins several
-        // on a productive item, one version each, and a category value can
-        // stand for some (`categoryType.value.updateConcepts`).
+        // The kit's concepts: an idea ("Giving an opinion") with its
+        // explanation and the numbered scenarios it applies in. Versioned like
+        // mindset; a RefItem_Concept component pins several on a productive
+        // item, one version each, and a category value can stand for some
+        // (`categoryType.value.updateConcepts`).
         concept: {
             // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept - TeacherConceptList
             list: (teacher_uid, learning_kit_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept`),
             // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid - TeacherConceptGet
             get: (teacher_uid, learning_kit_uid, concept_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
             // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept - TeacherConceptCreate
             create: (teacher_uid, learning_kit_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept`, { body: request }),
             // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid - TeacherConceptUpdate
@@ -424,6 +479,38 @@ class BolbolTeacherScope {
             },
         },
     };
+    // The kits' material for one exam, across every kit of the teacher - what
+    // the Tools pages draw as one skill -> task tree for the exam they are
+    // opened at. Paged; each row names its kit (`learning_kit_uid`), through
+    // which it is created and edited (`learningKit.annotationGroup` and its
+    // siblings).
+    annotationGroup = {
+        // Every annotation group of the teacher's kits for the exam.
+        // GET /teacher/:teacher_uid/annotation-group - TeacherAnnotationGroupListAll
+        listAll: (teacher_uid, request) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/annotation-group`, { query: request }),
+    };
+    categoryType = {
+        // Every category type of the teacher's kits for the exam - the types
+        // only; `categoryValue.listAll` lists their values.
+        // GET /teacher/:teacher_uid/category-type - TeacherCategoryTypeListAll
+        listAll: (teacher_uid, request) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/category-type`, { query: request }),
+    };
+    categoryValue = {
+        // Every category value of the teacher's kits for the exam, each naming
+        // its type.
+        // GET /teacher/:teacher_uid/category-value - TeacherCategoryValueListAll
+        listAll: (teacher_uid, request) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/category-value`, { query: request }),
+    };
+    mindset = {
+        // Every mindset of the teacher's kits for the exam, topics included.
+        // GET /teacher/:teacher_uid/mindset - TeacherMindsetListAll
+        listAll: (teacher_uid, request) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/mindset`, { query: request }),
+    };
+    concept = {
+        // Every concept of the teacher's kits for the exam, scenarios included.
+        // GET /teacher/:teacher_uid/concept - TeacherConceptListAll
+        listAll: (teacher_uid, request) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/concept`, { query: request }),
+    };
     // Concept versions by uid, as a learner is posed them - what a ref item's
     // or a category value's `concept_version_uids` (or a concept's
     // `version_uid`) point at. Only versions of concepts in this teacher's
@@ -432,28 +519,392 @@ class BolbolTeacherScope {
         // GET /teacher/:teacher_uid/concept-version/preview - TeacherConceptVersionPreview
         preview: (teacher_uid, request) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/concept-version/preview`, { query: request }),
     };
-    // The teacher's components. A component is one learning action built over
-    // ONE published collection version of an academy; its type (fixed at
-    // create, like the collection version) says which kind of child it holds -
-    // ref assets, ref items, answers or ambiguities - and which of their
-    // fields it fills (ComponentTypeEnum). The children's endpoints nest under
-    // it, as their URLs do. Every write to a component (but its kit list, kept
-    // on the identity) or to a child lands on a draft, forking one when the
-    // latest version is published; nothing here publishes - publishing a
+    // The folders of the teacher's resource library: a tree of any depth the
+    // videos, podcasts, files and URLs are filed in, each folder headed by its
+    // main entity when it has one. Not versioned, and not language-scoped - one
+    // tree serves every language.
+    folder = {
+        // Flat and not paged: every folder of the teacher (by parent, then
+        // order), or with `folder_uid` the direct sub-folders of one.
+        // GET /teacher/:teacher_uid/folder - TeacherFolderList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/folder`, { query: request }),
+        // POST /teacher/:teacher_uid/folder - TeacherFolderCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/folder`, { body: request }),
+        // The library as a ready-to-draw tree for one language: the loose
+        // resources first, then the root folders with their main entity,
+        // resources and sub-folders.
+        // GET /teacher/:teacher_uid/folder/tree - TeacherFolderTree
+        tree: (teacher_uid, request) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/folder/tree`, { query: request }),
+        // Writes nothing but `sort_order`, on one parent's sub-folders.
+        // Position in `folder_uids` IS the order.
+        // PUT /teacher/:teacher_uid/folder/order - TeacherFolderReorder
+        reorder: (teacher_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/folder/order`, { body: request }),
+        // GET /teacher/:teacher_uid/folder/:folder_uid - TeacherFolderGet
+        get: (teacher_uid, folder_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/folder/${encodeURIComponent(folder_uid)}`),
+        // Every field as sent; `folder_uid` moves the folder (409 FOLDER_CYCLE
+        // under itself or one of its own sub-folders).
+        // PUT /teacher/:teacher_uid/folder/:folder_uid - TeacherFolderUpdate
+        update: (teacher_uid, folder_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/folder/${encodeURIComponent(folder_uid)}`, { body: request }),
+        // Soft delete; 409 FOLDER_IN_USE while it still holds a live sub-folder
+        // or resource.
+        // DELETE /teacher/:teacher_uid/folder/:folder_uid - TeacherFolderDelete
+        delete: (teacher_uid, folder_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/folder/${encodeURIComponent(folder_uid)}`),
+    };
+    // The teacher's videos - an uploaded file or a YouTube link - one of the
+    // four kinds of resource in the library, with podcasts, files and URLs,
+    // filed in `folder`s. Each is in one language and carries a transcript,
+    // exam scopes, the category values and word list it teaches, and
+    // annotations on its transcript. Not versioned: every call writes in place.
+    // A Resource component bundles them (`component.refResource`).
+    video = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /teacher/:teacher_uid/video - TeacherVideoList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/video`, { query: request }),
+        // Needs the teacher's Video authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
+        // POST /teacher/:teacher_uid/video - TeacherVideoCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/video`, { body: request }),
+        // GET /teacher/:teacher_uid/video/:video_uid - TeacherVideoGet
+        get: (teacher_uid, video_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`);
+        // the type may change - a YouTube link replaced by an upload.
+        // PUT /teacher/:teacher_uid/video/:video_uid - TeacherVideoUpdate
+        update: (teacher_uid, video_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
+        // holds a ref resource of it, or its unpublished draft deleted one
+        // (discarding the draft would bring it back).
+        // DELETE /teacher/:teacher_uid/video/:video_uid - TeacherVideoDelete
+        delete: (teacher_uid, video_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}`),
+        // The exams (and optionally skills and tasks) the video serves,
+        // replaced as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /teacher/:teacher_uid/video/:video_uid/scope - TeacherVideoScopeSet
+            set: (teacher_uid, video_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/scope`, { body: request }),
+        },
+        // The category values the video is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /teacher/:teacher_uid/video/:video_uid/category-value - TeacherVideoCategoryValueSet
+            set: (teacher_uid, video_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/category-value`, { body: request }),
+        },
+        // The video's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /teacher/:teacher_uid/video/:video_uid/vocabulary - TeacherVideoVocabularyList
+            list: (teacher_uid, video_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /teacher/:teacher_uid/video/:video_uid/vocabulary - TeacherVideoVocabularyAdd
+            add: (teacher_uid, video_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /teacher/:teacher_uid/video/:video_uid/vocabulary/order - TeacherVideoVocabularyReorder
+            reorder: (teacher_uid, video_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /teacher/:teacher_uid/video/:video_uid/vocabulary/:lexema_id - TeacherVideoVocabularyRemove
+            remove: (teacher_uid, video_uid, lexema_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the video's transcript, each filed under a group of one
+        // of the kits `learningKit.list` answers whose own skill / task covers
+        // one of the video's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /teacher/:teacher_uid/video/:video_uid/annotation - TeacherVideoAnnotationList
+            list: (teacher_uid, video_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/annotation`),
+            // POST /teacher/:teacher_uid/video/:video_uid/annotation - TeacherVideoAnnotationAdd
+            add: (teacher_uid, video_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/annotation`, { body: request }),
+            // PUT /teacher/:teacher_uid/video/:video_uid/annotation/:annotation_uid - TeacherVideoAnnotationUpdate
+            update: (teacher_uid, video_uid, annotation_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/video/:video_uid/annotation/:annotation_uid - TeacherVideoAnnotationRemove
+            remove: (teacher_uid, video_uid, annotation_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The teacher's kits whose scope covers one of the video's scopes -
+            // what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /teacher/:teacher_uid/video/:video_uid/learning-kit - TeacherVideoLearningKitList
+            list: (teacher_uid, video_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/learning-kit`),
+        },
+        // The uploaded video's bytes, not an envelope - for a player or a
+        // download: inline, or as an attachment with `download` when the video
+        // is downloadable (403 RESOURCE_NOT_DOWNLOADABLE otherwise). A YouTube
+        // video has nothing to stream here (400 VIDEO_TYPE_FIELDS).
+        // GET /teacher/:teacher_uid/video/:video_uid/stream - TeacherVideoStream
+        stream: (teacher_uid, video_uid, request = {}) => this.http.blob(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}/stream`, { query: request }),
+    };
+    // The teacher's podcasts - uploaded audio episodes - in the resource
+    // library, shaped and served like `video`.
+    podcast = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /teacher/:teacher_uid/podcast - TeacherPodcastList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/podcast`, { query: request }),
+        // Needs the teacher's Podcast authorization (403 AUTHORIZATION_REQUIRED
+        // / AUTHORIZATION_EXPIRED).
+        // POST /teacher/:teacher_uid/podcast - TeacherPodcastCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/podcast`, { body: request }),
+        // GET /teacher/:teacher_uid/podcast/:podcast_uid - TeacherPodcastGet
+        get: (teacher_uid, podcast_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`);
+        // the episode's file is replaced only when one is sent.
+        // PUT /teacher/:teacher_uid/podcast/:podcast_uid - TeacherPodcastUpdate
+        update: (teacher_uid, podcast_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
+        // holds a ref resource of it, or its unpublished draft deleted one
+        // (discarding the draft would bring it back).
+        // DELETE /teacher/:teacher_uid/podcast/:podcast_uid - TeacherPodcastDelete
+        delete: (teacher_uid, podcast_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}`),
+        // The exams (and optionally skills and tasks) the podcast serves,
+        // replaced as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /teacher/:teacher_uid/podcast/:podcast_uid/scope - TeacherPodcastScopeSet
+            set: (teacher_uid, podcast_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/scope`, { body: request }),
+        },
+        // The category values the podcast is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /teacher/:teacher_uid/podcast/:podcast_uid/category-value - TeacherPodcastCategoryValueSet
+            set: (teacher_uid, podcast_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/category-value`, { body: request }),
+        },
+        // The podcast's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /teacher/:teacher_uid/podcast/:podcast_uid/vocabulary - TeacherPodcastVocabularyList
+            list: (teacher_uid, podcast_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /teacher/:teacher_uid/podcast/:podcast_uid/vocabulary - TeacherPodcastVocabularyAdd
+            add: (teacher_uid, podcast_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /teacher/:teacher_uid/podcast/:podcast_uid/vocabulary/order - TeacherPodcastVocabularyReorder
+            reorder: (teacher_uid, podcast_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /teacher/:teacher_uid/podcast/:podcast_uid/vocabulary/:lexema_id - TeacherPodcastVocabularyRemove
+            remove: (teacher_uid, podcast_uid, lexema_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the podcast's transcript, each filed under a group of
+        // one of the kits `learningKit.list` answers whose own skill / task
+        // covers one of the podcast's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /teacher/:teacher_uid/podcast/:podcast_uid/annotation - TeacherPodcastAnnotationList
+            list: (teacher_uid, podcast_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation`),
+            // POST /teacher/:teacher_uid/podcast/:podcast_uid/annotation - TeacherPodcastAnnotationAdd
+            add: (teacher_uid, podcast_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation`, { body: request }),
+            // PUT /teacher/:teacher_uid/podcast/:podcast_uid/annotation/:annotation_uid - TeacherPodcastAnnotationUpdate
+            update: (teacher_uid, podcast_uid, annotation_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/podcast/:podcast_uid/annotation/:annotation_uid - TeacherPodcastAnnotationRemove
+            remove: (teacher_uid, podcast_uid, annotation_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The teacher's kits whose scope covers one of the podcast's scopes
+            // - what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /teacher/:teacher_uid/podcast/:podcast_uid/learning-kit - TeacherPodcastLearningKitList
+            list: (teacher_uid, podcast_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/learning-kit`),
+        },
+        // The episode's bytes, not an envelope - for a player or a download:
+        // inline, or as an attachment with `download` when the podcast is
+        // downloadable (403 RESOURCE_NOT_DOWNLOADABLE otherwise).
+        // GET /teacher/:teacher_uid/podcast/:podcast_uid/stream - TeacherPodcastStream
+        stream: (teacher_uid, podcast_uid, request = {}) => this.http.blob(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}/stream`, { query: request }),
+    };
+    // The teacher's files - uploaded documents such as PDFs - in the resource
+    // library, shaped and served like `video`. Only a PDF may be made
+    // non-downloadable; it is then shown in a viewer, not as a link.
+    file = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /teacher/:teacher_uid/file - TeacherFileList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/file`, { query: request }),
+        // Needs the teacher's File authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
+        // POST /teacher/:teacher_uid/file - TeacherFileCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/file`, { body: request }),
+        // GET /teacher/:teacher_uid/file/:file_uid - TeacherFileGet
+        get: (teacher_uid, file_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`).
+        // PUT /teacher/:teacher_uid/file/:file_uid - TeacherFileUpdate
+        update: (teacher_uid, file_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
+        // holds a ref resource of it, or its unpublished draft deleted one
+        // (discarding the draft would bring it back).
+        // DELETE /teacher/:teacher_uid/file/:file_uid - TeacherFileDelete
+        delete: (teacher_uid, file_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}`),
+        // The exams (and optionally skills and tasks) the file serves, replaced
+        // as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /teacher/:teacher_uid/file/:file_uid/scope - TeacherFileScopeSet
+            set: (teacher_uid, file_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/scope`, { body: request }),
+        },
+        // The category values the file is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /teacher/:teacher_uid/file/:file_uid/category-value - TeacherFileCategoryValueSet
+            set: (teacher_uid, file_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/category-value`, { body: request }),
+        },
+        // The file's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /teacher/:teacher_uid/file/:file_uid/vocabulary - TeacherFileVocabularyList
+            list: (teacher_uid, file_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /teacher/:teacher_uid/file/:file_uid/vocabulary - TeacherFileVocabularyAdd
+            add: (teacher_uid, file_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /teacher/:teacher_uid/file/:file_uid/vocabulary/order - TeacherFileVocabularyReorder
+            reorder: (teacher_uid, file_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /teacher/:teacher_uid/file/:file_uid/vocabulary/:lexema_id - TeacherFileVocabularyRemove
+            remove: (teacher_uid, file_uid, lexema_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the file's transcript, each filed under a group of one
+        // of the kits `learningKit.list` answers whose own skill / task covers
+        // one of the file's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /teacher/:teacher_uid/file/:file_uid/annotation - TeacherFileAnnotationList
+            list: (teacher_uid, file_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/annotation`),
+            // POST /teacher/:teacher_uid/file/:file_uid/annotation - TeacherFileAnnotationAdd
+            add: (teacher_uid, file_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/annotation`, { body: request }),
+            // PUT /teacher/:teacher_uid/file/:file_uid/annotation/:annotation_uid - TeacherFileAnnotationUpdate
+            update: (teacher_uid, file_uid, annotation_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/file/:file_uid/annotation/:annotation_uid - TeacherFileAnnotationRemove
+            remove: (teacher_uid, file_uid, annotation_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The teacher's kits whose scope covers one of the file's scopes -
+            // what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /teacher/:teacher_uid/file/:file_uid/learning-kit - TeacherFileLearningKitList
+            list: (teacher_uid, file_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/learning-kit`),
+        },
+        // The file's bytes, not an envelope - for a viewer or a download:
+        // inline (what a PDF viewer loads, even for a file that may not be
+        // downloaded), or as an attachment with `download` when the file is
+        // downloadable (403 RESOURCE_NOT_DOWNLOADABLE otherwise).
+        // GET /teacher/:teacher_uid/file/:file_uid/stream - TeacherFileStream
+        stream: (teacher_uid, file_uid, request = {}) => this.http.blob(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}/stream`, { query: request }),
+    };
+    // The teacher's URLs - links to pages on the web - in the resource library,
+    // shaped like `video` but with nothing to stream: the page is opened at its
+    // `url`.
+    url = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /teacher/:teacher_uid/url - TeacherUrlList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/url`, { query: request }),
+        // Needs the teacher's Url authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
+        // POST /teacher/:teacher_uid/url - TeacherUrlCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/url`, { body: request }),
+        // GET /teacher/:teacher_uid/url/:url_uid - TeacherUrlGet
+        get: (teacher_uid, url_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`).
+        // PUT /teacher/:teacher_uid/url/:url_uid - TeacherUrlUpdate
+        update: (teacher_uid, url_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
+        // holds a ref resource of it, or its unpublished draft deleted one
+        // (discarding the draft would bring it back).
+        // DELETE /teacher/:teacher_uid/url/:url_uid - TeacherUrlDelete
+        delete: (teacher_uid, url_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}`),
+        // The exams (and optionally skills and tasks) the URL serves, replaced
+        // as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /teacher/:teacher_uid/url/:url_uid/scope - TeacherUrlScopeSet
+            set: (teacher_uid, url_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/scope`, { body: request }),
+        },
+        // The category values the URL is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /teacher/:teacher_uid/url/:url_uid/category-value - TeacherUrlCategoryValueSet
+            set: (teacher_uid, url_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/category-value`, { body: request }),
+        },
+        // The URL's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /teacher/:teacher_uid/url/:url_uid/vocabulary - TeacherUrlVocabularyList
+            list: (teacher_uid, url_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /teacher/:teacher_uid/url/:url_uid/vocabulary - TeacherUrlVocabularyAdd
+            add: (teacher_uid, url_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /teacher/:teacher_uid/url/:url_uid/vocabulary/order - TeacherUrlVocabularyReorder
+            reorder: (teacher_uid, url_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /teacher/:teacher_uid/url/:url_uid/vocabulary/:lexema_id - TeacherUrlVocabularyRemove
+            remove: (teacher_uid, url_uid, lexema_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the URL's transcript, each filed under a group of one
+        // of the kits `learningKit.list` answers whose own skill / task covers
+        // one of the URL's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /teacher/:teacher_uid/url/:url_uid/annotation - TeacherUrlAnnotationList
+            list: (teacher_uid, url_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/annotation`),
+            // POST /teacher/:teacher_uid/url/:url_uid/annotation - TeacherUrlAnnotationAdd
+            add: (teacher_uid, url_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/annotation`, { body: request }),
+            // PUT /teacher/:teacher_uid/url/:url_uid/annotation/:annotation_uid - TeacherUrlAnnotationUpdate
+            update: (teacher_uid, url_uid, annotation_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/url/:url_uid/annotation/:annotation_uid - TeacherUrlAnnotationRemove
+            remove: (teacher_uid, url_uid, annotation_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The teacher's kits whose scope covers one of the URL's scopes -
+            // what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /teacher/:teacher_uid/url/:url_uid/learning-kit - TeacherUrlLearningKitList
+            list: (teacher_uid, url_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/learning-kit`),
+        },
+    };
+    // The teacher's components. A component is one learning action for one
+    // exam, optionally narrowed to one skill and task of it. Its type (fixed
+    // at create) says which kind of child it holds and which of their fields
+    // it fills (ComponentTypeEnum): ref assets, ref items, answers or
+    // ambiguities over ONE published collection version of an academy, or -
+    // a Resource component, built on no collection - ref resources, the
+    // teacher's own library resources. The children's endpoints nest under
+    // it, as their URLs do. Every write to a component (but its kit list,
+    // kept on the identity) or to a child lands on a draft, forking one when
+    // the latest version is published; nothing here publishes - publishing a
     // package that lists the component does.
     component = {
-        // Paged. Every filter is optional; omitted, every live component of
-        // the teacher comes back.
+        // Paged, ordered by skill, then task - a null (every skill / task)
+        // after the others - then oldest first. Every filter is optional;
+        // omitted, every live component of the teacher comes back.
         // GET /teacher/:teacher_uid/component - TeacherComponentList
         list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component`, { query: request }),
         // Creates the component and its version 1 (a draft) on a published
-        // collection version. The teacher's first component on a collection
-        // also signs the academy's licensing contract for it.
+        // collection version - or, for a Resource component, on its exam
+        // alone. The teacher's first component on a collection also signs the
+        // academy's licensing contract for it. Needs the teacher's Package
+        // authorization and its ComponentForCollection / ComponentForResources
+        // one by the type (403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED
+        // naming the first missing, Package first).
         // POST /teacher/:teacher_uid/component - TeacherComponentCreate
         create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component`, { body: request }),
         // GET /teacher/:teacher_uid/component/:component_uid - TeacherComponentGet
         get: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}`),
-        // Name and notes only - the collection version and the type are fixed.
+        // Name and notes only - the type, the collection version and the exam
+        // / skill / task are fixed.
         // PUT /teacher/:teacher_uid/component/:component_uid - TeacherComponentUpdate
         update: (teacher_uid, component_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}`, { body: request }),
         // Soft delete; 409 COMPONENT_IN_USE while a published package version
@@ -481,7 +932,8 @@ class BolbolTeacherScope {
         hierarchy: {
             // The collection version's skill -> task -> series -> item tree
             // (plus each task's assets), every row carrying the component's
-            // ref row, its state and the sheet value.
+            // ref row, its state and the sheet value - or, for a Resource
+            // component, its ref resources as a folder tree.
             // GET /teacher/:teacher_uid/component/:component_uid/hierarchy - TeacherComponentHierarchy
             get: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/hierarchy`),
         },
@@ -680,15 +1132,77 @@ class BolbolTeacherScope {
                 deleteLast: (teacher_uid, component_uid, ambiguity_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}/version/latest`),
             },
         },
+        // A Resource component's ref resources: the teacher's own library
+        // resources (videos, podcasts, files, URLs) it bundles, at most one per
+        // resource. Each is filed under a folder path inside the component -
+        // folder NAMES, copied, so the component's folders are its own and
+        // moving the library's folders later changes nothing here.
+        refResource: {
+            // The live ref resources at their latest versions, each with the
+            // resource it pins (`source`). Paged; `resource_type` narrows to
+            // one kind.
+            // GET /teacher/:teacher_uid/component/:component_uid/ref-resource - TeacherRefResourceList
+            list: (teacher_uid, component_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource`, { query: request }),
+            // The same rows as a folder tree built from their paths - the loose
+            // ones first, then the root folders.
+            // GET /teacher/:teacher_uid/component/:component_uid/ref-resource/tree - TeacherRefResourceTree
+            tree: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/tree`),
+            // Bundles one resource of the teacher's: version 1, a draft, pinned
+            // by the component's draft (a ref resource it had - deleted, or
+            // unlinked by a discarded draft - is brought back). Another
+            // owner's or an unknown resource answers its own 403 / 404
+            // (RESOURCE_<E>_FORBIDDEN / RESOURCE_<E>_NOT_FOUND); 409
+            // REF_RESOURCE_DUPLICATE when the component holds it already.
+            // POST /teacher/:teacher_uid/component/:component_uid/ref-resource - TeacherRefResourceCreate
+            create: (teacher_uid, component_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource`, { body: request }),
+            // Bundles a library folder (with everything under it, as folder
+            // paths) and / or picked resources in one call; the ones the
+            // component holds already are left as they are. All is resolved
+            // before the first write - a refused import writes nothing (400
+            // REF_RESOURCE_FOLDER_TOO_DEEP for a copied path deeper than 32
+            // folders). Answers how many ref resources it added (created or
+            // brought back) and the component's new tree.
+            // POST /teacher/:teacher_uid/component/:component_uid/ref-resource/import - TeacherRefResourceImport
+            import: (teacher_uid, component_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/import`, { body: request }),
+            // The component's folders exist only as its ref resources' folder
+            // paths, so they are renamed and moved by rewriting those.
+            folder: {
+                // Replaces the `from_path` prefix with `to_path` on every ref
+                // resource under it, through their drafts; a `to_path` the
+                // component has already merges the two. Before anything is
+                // written: 409 FOLDER_CYCLE for a `to_path` inside
+                // `from_path`, 400 REF_RESOURCE_FOLDER_TOO_DEEP when a moved
+                // path would be deeper than 32 folders.
+                // PUT /teacher/:teacher_uid/component/:component_uid/ref-resource/folder - TeacherRefResourceFolderRename
+                rename: (teacher_uid, component_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/folder`, { body: request }),
+            },
+            // GET /teacher/:teacher_uid/component/:component_uid/ref-resource/:ref_resource_uid - TeacherRefResourceGet
+            get: (teacher_uid, component_uid, ref_resource_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`),
+            // Its place in the component - folder path, main entity, order; the
+            // resource it pins is fixed.
+            // PUT /teacher/:teacher_uid/component/:component_uid/ref-resource/:ref_resource_uid - TeacherRefResourceUpdate
+            update: (teacher_uid, component_uid, ref_resource_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/component/:component_uid/ref-resource/:ref_resource_uid - TeacherRefResourceDelete
+            delete: (teacher_uid, component_uid, ref_resource_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`),
+            version: {
+                // GET /teacher/:teacher_uid/component/:component_uid/ref-resource/:ref_resource_uid/version - TeacherRefResourceVersionList
+                list: (teacher_uid, component_uid, ref_resource_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ref-resource/:ref_resource_uid/version/latest - TeacherRefResourceVersionDelete
+                deleteLast: (teacher_uid, component_uid, ref_resource_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}/version/latest`),
+            },
+        },
     };
     // The teacher's packages - sellable bundles of the teacher's components,
     // each built on one published collection version and answered with its
-    // latest version's content. Edits to a published version land on a new
-    // draft version; `version.publish` is the only publish, and it publishes
-    // the pinned components and their children with it.
+    // latest version's content; a Resource component, built on no
+    // collection, joins any package of its exam. Edits to a published version
+    // land on a new draft version; `version.publish` is the only publish, and
+    // it publishes the pinned components and their children with it.
     package = {
-        // `collection_version_uid` / `exam_id` narrow the list; omitted, every
-        // package of the teacher comes back.
+        // `collection_version_uid`, `exam_id` and a skill / task narrow the
+        // list; omitted, every package of the teacher comes back. Paged,
+        // oldest first: a package has no skill / task of its own.
         // GET /teacher/:teacher_uid/package - TeacherPackageList
         list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package`, { query: request }),
         // Also signs - get-or-create - the teacher's licensing contract for
@@ -736,7 +1250,8 @@ class BolbolTeacherScope {
             // Changes tab).
             // GET /teacher/:teacher_uid/package/:package_uid/version/component - TeacherPackageVersion_ComponentVersionList
             list: (teacher_uid, package_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/component`, { query: request }),
-            // The component must be built on the package's collection version.
+            // The component must be built on the package's collection version
+            // - or be a Resource component of the package's exam.
             // POST /teacher/:teacher_uid/package/:package_uid/version/component - TeacherPackageVersion_ComponentVersionAdd
             add: (teacher_uid, package_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/component`, { body: request }),
             // DELETE /teacher/:teacher_uid/package/:package_uid/version/component/:component_uid - TeacherPackageVersion_ComponentVersionRemove