bolbol-sdk 1.0.2 → 2.0.0

package/dist/scope/BolbolTeacherScope.js

@@ -8,6 +8,20 @@ exports.BolbolTeacherScope = void 0;
 // /teacher/{teacher_uid}/{entity}/{entity_id}. The teacher's numeric id never
 // leaves the backend. The uid is never a query param and never a body field,
 // 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.
+// 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.
 class BolbolTeacherScope {
     http;
     constructor(http) {
@@ -29,6 +43,8 @@ class BolbolTeacherScope {
         // GET /teacher/directory/profile/:teacher_uid - TeacherDirectoryProfile
         profile: (teacher_uid) => this.http.get(`/teacher/directory/profile/${encodeURIComponent(teacher_uid)}`),
     };
+    // The caller's own teacher profiles: the account fields, the photo, the
+    // membership price and the deletion schedule.
     account = {
         // The caller's own teacher profiles. Also refreshes the teachers cookie
         // the frontend layouts gate on.
@@ -48,6 +64,16 @@ class BolbolTeacherScope {
             // PATCH /teacher/:teacher_uid/photo - TeacherUpdatePhoto
             update: (teacher_uid, request) => this.http.patch(`/teacher/${encodeURIComponent(teacher_uid)}/photo`, { body: request }),
         },
+        setting: {
+            // What students pay to follow this teacher: one of the teacher's
+            // own pricings, or null for free. Answers the teacher row. Data
+            // entry only for now: nothing charges it yet and learners are not
+            // shown it.
+            membership: {
+                // PATCH /teacher/:teacher_uid/setting/membership - TeacherUpdateSettingMembership
+                update: (teacher_uid, request) => this.http.patch(`/teacher/${encodeURIComponent(teacher_uid)}/setting/membership`, { body: request }),
+            },
+        },
         deletion: {
             // Schedules the profile for deletion (it is frozen until then).
             // DELETE /teacher/:teacher_uid - TeacherAccountRequestDeletion
@@ -150,6 +176,611 @@ class BolbolTeacherScope {
         // GET /teacher/:teacher_uid/request - TeacherRequestList
         list: (teacher_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/request`),
     };
+    // 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
+    // eggs); the teacher's settings point at one (a package's sell pricing,
+    // the membership price). What a consumer agreed to is frozen into a
+    // contract, so editing a pricing never changes a signed deal.
+    pricing = {
+        // GET /teacher/:teacher_uid/pricing - TeacherPricingList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/pricing`, { query: request }),
+        // A new pricing has no regions yet, which prices it free everywhere.
+        // POST /teacher/:teacher_uid/pricing - TeacherPricingCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/pricing`, { body: request }),
+        // GET /teacher/:teacher_uid/pricing/:pricing_uid - TeacherPricingGet
+        get: (teacher_uid, pricing_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/pricing/${encodeURIComponent(pricing_uid)}`),
+        // PUT /teacher/:teacher_uid/pricing/:pricing_uid - TeacherPricingUpdate
+        update: (teacher_uid, pricing_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/pricing/${encodeURIComponent(pricing_uid)}`, { body: request }),
+        // A soft delete, refused with 409 PRICING_IN_USE while a package or the
+        // membership setting still points at the pricing.
+        // DELETE /teacher/:teacher_uid/pricing/:pricing_uid - TeacherPricingDelete
+        delete: (teacher_uid, pricing_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/pricing/${encodeURIComponent(pricing_uid)}`),
+        // A pricing's region rows, addressed by their numeric id.
+        region: {
+            // GET /teacher/:teacher_uid/pricing/:pricing_uid/region - TeacherPricingRegionList
+            list: (teacher_uid, pricing_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/pricing/${encodeURIComponent(pricing_uid)}/region`),
+            // A second row for one country, or a second fallback row, is a 409
+            // PRICING_REGION_EXISTS.
+            // POST /teacher/:teacher_uid/pricing/:pricing_uid/region - TeacherPricingRegionCreate
+            create: (teacher_uid, pricing_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/pricing/${encodeURIComponent(pricing_uid)}/region`, { body: request }),
+            // PUT /teacher/:teacher_uid/pricing/:pricing_uid/region/:pricing_region_id - TeacherPricingRegionUpdate
+            update: (teacher_uid, pricing_uid, pricing_region_id, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/pricing/${encodeURIComponent(pricing_uid)}/region/${pricing_region_id}`, { body: request }),
+            // A hard delete; contracts signed through the region keep the
+            // values they copied.
+            // DELETE /teacher/:teacher_uid/pricing/:pricing_uid/region/:pricing_region_id - TeacherPricingRegionDelete
+            delete: (teacher_uid, pricing_uid, pricing_region_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/pricing/${encodeURIComponent(pricing_uid)}/region/${pricing_region_id}`),
+        },
+    };
+    // The contracts the teacher is one end of - read-only. The server writes
+    // them (creating a component or a package on an academy's collection signs
+    // the licensing and commission contracts), each freezing the price agreed.
+    contract = {
+        // `role` narrows to the contracts the teacher produces or consumes,
+        // `type` to one contract type.
+        // GET /teacher/:teacher_uid/contract - TeacherContractList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/contract`, { query: request }),
+        // 403 unless the teacher is the contract's producer or its consumer.
+        // GET /teacher/:teacher_uid/contract/:contract_uid - TeacherContractGet
+        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`.
+    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`),
+        },
+    };
+    // 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.
+    learningKit = {
+        // Paged; narrowed by exam / skill / task, 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 }),
+        // 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.
+        // 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.
+        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`),
+            // 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
+            update: (teacher_uid, learning_kit_uid, annotation_group_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}`, { body: request }),
+            // 409 while an annotation is still filed under the group.
+            // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid - TeacherAnnotationGroupDelete
+            delete: (teacher_uid, learning_kit_uid, annotation_group_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}`),
+            // Versioning on the group itself - same shape as categoryType.
+            version: {
+                // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid/version - TeacherAnnotationGroupVersionList
+                list: (teacher_uid, learning_kit_uid, annotation_group_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}/version`),
+                // Discards the unpublished draft (409 when the latest is published).
+                // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid/version/latest - TeacherAnnotationGroupVersionDelete
+                deleteLast: (teacher_uid, learning_kit_uid, annotation_group_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}/version/latest`),
+            },
+        },
+        // The kit's classification axes - for example "Tense". Each type
+        // carries its own values, which a RefItem_CategoryValue component tags
+        // items with.
+        categoryType: {
+            // Every type AND every value of the kit in one call, so a Console
+            // 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`),
+            // 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
+            update: (teacher_uid, learning_kit_uid, category_type_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}`, { body: request }),
+            // Soft-deletes the type and every value under it.
+            // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid - TeacherCategoryTypeDelete
+            delete: (teacher_uid, learning_kit_uid, category_type_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}`),
+            // Versioning on the type itself - same shape as collection and
+            // series.
+            version: {
+                // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/version - TeacherCategoryTypeVersionList
+                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)}/version`),
+                // Discards the unpublished draft (409 when the latest is published).
+                // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/version/latest - TeacherCategoryTypeVersionDelete
+                deleteLast: (teacher_uid, learning_kit_uid, category_type_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/version/latest`),
+            },
+            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`),
+                // 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
+                update: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}`, { body: request }),
+                // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid - TeacherCategoryValueDelete
+                delete: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}`),
+                // Replaces the value's concepts (in order; `[]` clears them),
+                // pinning each at its latest version - concepts of the same kit
+                // only. On a published value it forks a draft first, like the
+                // vocabulary does.
+                // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/concept - TeacherCategoryValueUpdateConcepts
+                updateConcepts: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/concept`, { body: request }),
+                version: {
+                    // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/version - TeacherCategoryValueVersionList
+                    list: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/version`),
+                    // Discards the unpublished draft with its vocabulary and
+                    // concept pins (409 when the latest is published).
+                    // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/version/latest - TeacherCategoryValueVersionDelete
+                    deleteLast: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/version/latest`),
+                },
+                // The value's word list (package.category_value_vocabulary):
+                // one entry per sense, keyed by `sense_id`. Adding or removing
+                // an entry on a published value forks a new draft version.
+                vocabulary: {
+                    // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary - TeacherCategoryValueVocabularyList
+                    list: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary`),
+                    // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary - TeacherCategoryValueVocabularyAdd
+                    add: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary`, { body: request }),
+                    // Position in `sense_ids` IS the order.
+                    // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary/order - TeacherCategoryValueVocabularyReorder
+                    reorder: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary/order`, { body: request }),
+                    // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary/:sense_id - TeacherCategoryValueVocabularyRemove
+                    remove: (teacher_uid, learning_kit_uid, category_type_uid, category_value_uid, sense_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary/${sense_id}`),
+                },
+            },
+        },
+        // The kit's mindsets: a situation ("Sport / outdoor activity") with
+        // the numbered topics worth asking about in it. Versioned like
+        // categoryType; a RefItem_Mindset component pins one version on a
+        // productive item.
+        mindset: {
+            // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset - TeacherMindsetList
+            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)}`),
+            // 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
+            update: (teacher_uid, learning_kit_uid, mindset_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}`, { body: request }),
+            // 409 while the latest version of a live ref item still pins it.
+            // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid - TeacherMindsetDelete
+            delete: (teacher_uid, learning_kit_uid, mindset_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}`),
+            // Versioning on the mindset itself - same shape as categoryType.
+            version: {
+                // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/version - TeacherMindsetVersionList
+                list: (teacher_uid, learning_kit_uid, mindset_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/version`),
+                // Discards the unpublished draft (409 when the latest is published,
+                // or when a ref item version pins it).
+                // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/version/latest - TeacherMindsetVersionDelete
+                deleteLast: (teacher_uid, learning_kit_uid, mindset_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/version/latest`),
+            },
+            // The mindset's numbered topics, on its latest version. A change to a
+            // published version forks a draft first, so every call answers the
+            // whole mindset (the topics' uids change with the fork).
+            topic: {
+                // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic - TeacherMindsetTopicAdd
+                add: (teacher_uid, learning_kit_uid, mindset_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic`, { body: request }),
+                // Position in `topic_uids` IS the order.
+                // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic/order - TeacherMindsetTopicReorder
+                reorder: (teacher_uid, learning_kit_uid, mindset_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/order`, { body: request }),
+                // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic/:topic_uid - TeacherMindsetTopicUpdate
+                update: (teacher_uid, learning_kit_uid, mindset_uid, topic_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/${encodeURIComponent(topic_uid)}`, { body: request }),
+                // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic/:topic_uid - TeacherMindsetTopicRemove
+                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`).
+        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)}`),
+            // 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
+            update: (teacher_uid, learning_kit_uid, concept_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}`, { body: request }),
+            // 409 while the latest version of a live ref item, or a category
+            // value version, still pins it.
+            // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid - TeacherConceptDelete
+            delete: (teacher_uid, learning_kit_uid, concept_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}`),
+            // Versioning on the concept itself - same shape as mindset.
+            version: {
+                // GET /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/version - TeacherConceptVersionList
+                list: (teacher_uid, learning_kit_uid, concept_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/version`),
+                // Discards the unpublished draft (409 when the latest is published,
+                // or when a ref item version or a category value version pins it).
+                // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/version/latest - TeacherConceptVersionDelete
+                deleteLast: (teacher_uid, learning_kit_uid, concept_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/version/latest`),
+            },
+            // The concept's numbered scenarios, on its latest version. A change to a
+            // published version forks a draft first, so every call answers the
+            // whole concept (the scenarios' uids change with the fork).
+            scenario: {
+                // POST /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario - TeacherConceptScenarioAdd
+                add: (teacher_uid, learning_kit_uid, concept_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario`, { body: request }),
+                // Position in `scenario_uids` IS the order.
+                // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario/order - TeacherConceptScenarioReorder
+                reorder: (teacher_uid, learning_kit_uid, concept_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/order`, { body: request }),
+                // PUT /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario/:scenario_uid - TeacherConceptScenarioUpdate
+                update: (teacher_uid, learning_kit_uid, concept_uid, scenario_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/${encodeURIComponent(scenario_uid)}`, { body: request }),
+                // DELETE /teacher/:teacher_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario/:scenario_uid - TeacherConceptScenarioRemove
+                remove: (teacher_uid, learning_kit_uid, concept_uid, scenario_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/${encodeURIComponent(scenario_uid)}`),
+            },
+        },
+    };
+    // 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
+    // kits come back.
+    conceptVersion = {
+        // 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
+    // package that lists the component does.
+    component = {
+        // Paged. 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.
+        // 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.
+        // 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
+        // pins the component.
+        // DELETE /teacher/:teacher_uid/component/:component_uid - TeacherComponentDelete
+        delete: (teacher_uid, component_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}`),
+        version: {
+            // GET /teacher/:teacher_uid/component/:component_uid/version - TeacherComponentVersionList
+            list: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/version`),
+            // Drops the latest version, which must still be a draft, and
+            // reverts the children it pinned to what the previous version pins.
+            // DELETE /teacher/:teacher_uid/component/:component_uid/version/latest - TeacherComponentVersionDelete
+            deleteLast: (teacher_uid, component_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/version/latest`),
+        },
+        // Which of the teacher's learning kits feed the component's pickers
+        // (annotation groups, category values, mindsets, concepts). Kept on
+        // the identity: setting them forks no draft.
+        learningKit: {
+            // GET /teacher/:teacher_uid/component/:component_uid/learning-kit - TeacherComponentLearningKitList
+            list: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/learning-kit`),
+            // Replaces the whole set and answers it the way `list` does.
+            // PUT /teacher/:teacher_uid/component/:component_uid/learning-kit - TeacherComponentLearningKitSet
+            set: (teacher_uid, component_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/learning-kit`, { body: request }),
+        },
+        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.
+            // 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`),
+        },
+        preview: {
+            // The component's content as it would be shown - for the owner's
+            // preview tab and the Academy Application's dev preview.
+            // GET /teacher/:teacher_uid/component/:component_uid/preview - TeacherComponentPreview
+            get: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/preview`),
+        },
+        // A RefAsset_* component's ref assets: what it adds to each academy
+        // asset its collection version reaches, at most one per asset.
+        refAsset: {
+            // GET /teacher/:teacher_uid/component/:component_uid/ref-asset - TeacherRefAssetList
+            list: (teacher_uid, component_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset`, { query: request }),
+            // Gets the component's ref asset on the asset, creating it (version
+            // 1, a draft) when there is none; the asset must be reached by the
+            // component's collection version. Takes no body.
+            // PUT /teacher/:teacher_uid/component/:component_uid/ref-asset/asset/:asset_uid - TeacherRefAssetUpsertByAsset
+            upsertByAsset: (teacher_uid, component_uid, asset_uid) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/asset/${encodeURIComponent(asset_uid)}`),
+            // GET /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid - TeacherRefAssetGet
+            get: (teacher_uid, component_uid, ref_asset_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}`),
+            // The translation overlay - RefAsset_Translation only.
+            // PUT /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid - TeacherRefAssetUpdate
+            update: (teacher_uid, component_uid, ref_asset_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid - TeacherRefAssetDelete
+            delete: (teacher_uid, component_uid, ref_asset_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}`),
+            version: {
+                // GET /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/version - TeacherRefAssetVersionList
+                list: (teacher_uid, component_uid, ref_asset_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/version/latest - TeacherRefAssetVersionDelete
+                deleteLast: (teacher_uid, component_uid, ref_asset_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/version/latest`),
+            },
+            // RefAsset_Annotation only: selections on the pinned asset
+            // version's texts, each filed under a group of the component's kits.
+            annotation: {
+                // GET /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation - TeacherRefAssetAnnotationList
+                list: (teacher_uid, component_uid, ref_asset_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation`),
+                // POST /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation - TeacherRefAssetAnnotationAdd
+                add: (teacher_uid, component_uid, ref_asset_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation`, { body: request }),
+                // PUT /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation/:annotation_uid - TeacherRefAssetAnnotationUpdate
+                update: (teacher_uid, component_uid, ref_asset_uid, annotation_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation/:annotation_uid - TeacherRefAssetAnnotationRemove
+                remove: (teacher_uid, component_uid, ref_asset_uid, annotation_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+            },
+            // RefAsset_Vocabulary only. An entry is addressed by its
+            // `lexema_id`: a lexema appears at most once per list.
+            vocabulary: {
+                // Entries in order.
+                // GET /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary - TeacherRefAssetVocabularyList
+                list: (teacher_uid, component_uid, ref_asset_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_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/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary - TeacherRefAssetVocabularyAdd
+                add: (teacher_uid, component_uid, ref_asset_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/vocabulary`, { body: request }),
+                // Position in `lexema_ids` IS the order.
+                // PUT /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary/order - TeacherRefAssetVocabularyReorder
+                reorder: (teacher_uid, component_uid, ref_asset_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/vocabulary/order`, { body: request }),
+                // Drops the entry only; the lexema and its senses are shared
+                // catalog rows.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary/:lexema_id - TeacherRefAssetVocabularyRemove
+                remove: (teacher_uid, component_uid, ref_asset_uid, lexema_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/vocabulary/${lexema_id}`),
+            },
+        },
+        // A RefItem_* component's ref items: what it adds to each academy item
+        // its collection version pins, at most one per item.
+        refItem: {
+            // GET /teacher/:teacher_uid/component/:component_uid/ref-item - TeacherRefItemList
+            list: (teacher_uid, component_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item`, { query: request }),
+            // Gets the component's ref item on the item, creating it (version
+            // 1, a draft) when there is none, and writes the sheet value sent
+            // (rank / mindset / category values) in the same call - what one
+            // sheet cell saves. `{}` only gets or creates it.
+            // PUT /teacher/:teacher_uid/component/:component_uid/ref-item/item/:item_uid - TeacherRefItemUpsertByItem
+            upsertByItem: (teacher_uid, component_uid, item_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/item/${encodeURIComponent(item_uid)}`, { body: request }),
+            // GET /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid - TeacherRefItemGet
+            get: (teacher_uid, component_uid, ref_item_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}`),
+            // Scoped by the component's type: only its group's fields may be
+            // sent (400 COMPONENT_TYPE_SCOPE otherwise).
+            // PUT /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid - TeacherRefItemUpdate
+            update: (teacher_uid, component_uid, ref_item_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid - TeacherRefItemDelete
+            delete: (teacher_uid, component_uid, ref_item_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}`),
+            version: {
+                // GET /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/version - TeacherRefItemVersionList
+                list: (teacher_uid, component_uid, ref_item_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/version/latest - TeacherRefItemVersionDelete
+                deleteLast: (teacher_uid, component_uid, ref_item_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/version/latest`),
+            },
+            // RefItem_Annotation only: selections on the pinned item version's
+            // texts, each filed under a group of the component's kits.
+            annotation: {
+                // GET /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/annotation - TeacherRefItemAnnotationList
+                list: (teacher_uid, component_uid, ref_item_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation`),
+                // POST /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/annotation - TeacherRefItemAnnotationAdd
+                add: (teacher_uid, component_uid, ref_item_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation`, { body: request }),
+                // PUT /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/annotation/:annotation_uid - TeacherRefItemAnnotationUpdate
+                update: (teacher_uid, component_uid, ref_item_uid, annotation_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/annotation/:annotation_uid - TeacherRefItemAnnotationRemove
+                remove: (teacher_uid, component_uid, ref_item_uid, annotation_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+            },
+            // RefItem_Vocabulary only. An entry is addressed by its
+            // `lexema_id`: a lexema appears at most once per list.
+            vocabulary: {
+                // Entries in order.
+                // GET /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/vocabulary - TeacherRefItemVocabularyList
+                list: (teacher_uid, component_uid, ref_item_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_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/component/:component_uid/ref-item/:ref_item_uid/vocabulary - TeacherRefItemVocabularyAdd
+                add: (teacher_uid, component_uid, ref_item_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/vocabulary`, { body: request }),
+                // Position in `lexema_ids` IS the order.
+                // PUT /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/vocabulary/order - TeacherRefItemVocabularyReorder
+                reorder: (teacher_uid, component_uid, ref_item_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/vocabulary/order`, { body: request }),
+                // Drops the entry only; the lexema and its senses are shared
+                // catalog rows.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ref-item/:ref_item_uid/vocabulary/:lexema_id - TeacherRefItemVocabularyRemove
+                remove: (teacher_uid, component_uid, ref_item_uid, lexema_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/vocabulary/${lexema_id}`),
+            },
+        },
+        // An Answer component's sample answers, each written for one
+        // productive item its collection version pins.
+        answer: {
+            // Paged, in the collection version's item order, then `sort_order`.
+            // GET /teacher/:teacher_uid/component/:component_uid/answer - TeacherAnswerList
+            list: (teacher_uid, component_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer`, { query: request }),
+            // POST /teacher/:teacher_uid/component/:component_uid/answer - TeacherAnswerCreate
+            create: (teacher_uid, component_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer`, { body: request }),
+            // GET /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid - TeacherAnswerGet
+            get: (teacher_uid, component_uid, answer_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}`),
+            // `structures` replaces the answer's list (stored `structure_uid`s
+            // are edited in place).
+            // PUT /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid - TeacherAnswerUpdate
+            update: (teacher_uid, component_uid, answer_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid - TeacherAnswerDelete
+            delete: (teacher_uid, component_uid, answer_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}`),
+            version: {
+                // GET /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/version - TeacherAnswerVersionList
+                list: (teacher_uid, component_uid, answer_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/version/latest - TeacherAnswerVersionDelete
+                deleteLast: (teacher_uid, component_uid, answer_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/version/latest`),
+            },
+            // Selections on the answer's structures' texts, each filed under a
+            // group of the component's kits.
+            annotation: {
+                // GET /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/annotation - TeacherAnswerAnnotationList
+                list: (teacher_uid, component_uid, answer_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation`),
+                // POST /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/annotation - TeacherAnswerAnnotationAdd
+                add: (teacher_uid, component_uid, answer_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation`, { body: request }),
+                // PUT /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/annotation/:annotation_uid - TeacherAnswerAnnotationUpdate
+                update: (teacher_uid, component_uid, answer_uid, annotation_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+                // DELETE /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/annotation/:annotation_uid - TeacherAnswerAnnotationRemove
+                remove: (teacher_uid, component_uid, answer_uid, annotation_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+            },
+            // The answer's word list. An entry is addressed by its
+            // `lexema_id`: a lexema appears at most once per list.
+            vocabulary: {
+                // Entries in order.
+                // GET /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/vocabulary - TeacherAnswerVocabularyList
+                list: (teacher_uid, component_uid, answer_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_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/component/:component_uid/answer/:answer_uid/vocabulary - TeacherAnswerVocabularyAdd
+                add: (teacher_uid, component_uid, answer_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/vocabulary`, { body: request }),
+                // Position in `lexema_ids` IS the order.
+                // PUT /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/vocabulary/order - TeacherAnswerVocabularyReorder
+                reorder: (teacher_uid, component_uid, answer_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/vocabulary/order`, { body: request }),
+                // Drops the entry only; the lexema and its senses are shared
+                // catalog rows.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/answer/:answer_uid/vocabulary/:lexema_id - TeacherAnswerVocabularyRemove
+                remove: (teacher_uid, component_uid, answer_uid, lexema_id) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/vocabulary/${lexema_id}`),
+            },
+        },
+        // An Ambiguity component's ambiguities, each named in one item its
+        // collection version pins.
+        ambiguity: {
+            // Paged, in the collection version's item order, then `sort_order`.
+            // GET /teacher/:teacher_uid/component/:component_uid/ambiguity - TeacherAmbiguityList
+            list: (teacher_uid, component_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity`, { query: request }),
+            // POST /teacher/:teacher_uid/component/:component_uid/ambiguity - TeacherAmbiguityCreate
+            create: (teacher_uid, component_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity`, { body: request }),
+            // GET /teacher/:teacher_uid/component/:component_uid/ambiguity/:ambiguity_uid - TeacherAmbiguityGet
+            get: (teacher_uid, component_uid, ambiguity_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`),
+            // The item and the type are fixed.
+            // PUT /teacher/:teacher_uid/component/:component_uid/ambiguity/:ambiguity_uid - TeacherAmbiguityUpdate
+            update: (teacher_uid, component_uid, ambiguity_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/component/:component_uid/ambiguity/:ambiguity_uid - TeacherAmbiguityDelete
+            delete: (teacher_uid, component_uid, ambiguity_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`),
+            version: {
+                // GET /teacher/:teacher_uid/component/:component_uid/ambiguity/:ambiguity_uid/version - TeacherAmbiguityVersionList
+                list: (teacher_uid, component_uid, ambiguity_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /teacher/:teacher_uid/component/:component_uid/ambiguity/:ambiguity_uid/version/latest - TeacherAmbiguityVersionDelete
+                deleteLast: (teacher_uid, component_uid, ambiguity_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_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.
+    package = {
+        // `collection_version_uid` / `exam_id` narrow the list; omitted, every
+        // package of the teacher comes back.
+        // 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
+        // the collection and the package's two commission contracts.
+        // POST /teacher/:teacher_uid/package - TeacherPackageCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package`, { body: request }),
+        // GET /teacher/:teacher_uid/package/:package_uid - TeacherPackageGet
+        get: (teacher_uid, package_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}`),
+        // The collection version and the pricing are not editable here.
+        // PUT /teacher/:teacher_uid/package/:package_uid - TeacherPackageUpdate
+        update: (teacher_uid, package_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}`, { body: request }),
+        // DELETE /teacher/:teacher_uid/package/:package_uid - TeacherPackageDelete
+        delete: (teacher_uid, package_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}`),
+        setting: {
+            pricing: {
+                // What a learner will pay for the package; written onto the
+                // package itself, no draft fork.
+                // PATCH /teacher/:teacher_uid/package/:package_uid/setting/pricing - TeacherPackageUpdateSettingPricing
+                update: (teacher_uid, package_uid, request) => this.http.patch(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/setting/pricing`, { body: request }),
+            },
+        },
+        // The preview's counts: the components the latest version pins and
+        // the children those component versions pin, per kind.
+        // GET /teacher/:teacher_uid/package/:package_uid/count - TeacherPackageCount
+        count: (teacher_uid, package_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/count`),
+        version: {
+            // GET /teacher/:teacher_uid/package/:package_uid/version - TeacherPackageVersionList
+            list: (teacher_uid, package_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version`),
+            // The publish cascade: publishes the draft versions of the pinned
+            // components and their children, re-pins what moved (forking a new
+            // package version when the latest is already published) and
+            // publishes the package. 409 NOTHING_TO_PUBLISH when nothing moved.
+            // POST /teacher/:teacher_uid/package/:package_uid/version/publish - TeacherPackageVersionPublish
+            publish: (teacher_uid, package_uid) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft.
+            // DELETE /teacher/:teacher_uid/package/:package_uid/version/latest - TeacherPackageVersionDelete
+            deleteLast: (teacher_uid, package_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/latest`),
+        },
+        // Which components this package bundles, on the package's latest
+        // version - the same five calls as `academy.collection.series`. An
+        // assignment is addressed by its COMPONENT uid; removing one
+        // unassigns the component only, the component survives.
+        component: {
+            // `version_number` reads an earlier version's assignments (the
+            // 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.
+            // 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
+            remove: (teacher_uid, package_uid, component_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/component/${encodeURIComponent(component_uid)}`),
+            // Writes nothing but `sort_order`. Position in `component_uids` IS the order.
+            // PUT /teacher/:teacher_uid/package/:package_uid/version/component/order - TeacherPackageVersion_ComponentVersionReorder
+            reorder: (teacher_uid, package_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/component/order`, { body: request }),
+            // Swaps the pinned version of a component already in the package;
+            // the body carries the target version_number (pick from
+            // teacher.component.version.list).
+            // PUT /teacher/:teacher_uid/package/:package_uid/version/component/:component_uid - TeacherPackageVersion_ComponentVersionReplace
+            replace: (teacher_uid, package_uid, component_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/component/${encodeURIComponent(component_uid)}`, { body: request }),
+        },
+        hierarchy: {
+            // package -> components -> children, at the latest version's pins.
+            // GET /teacher/:teacher_uid/package/:package_uid/hierarchy - TeacherPackageHierarchy
+            get: (teacher_uid, package_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/hierarchy`),
+        },
+        preview: {
+            // Every component's preview, in package order - for the owner's
+            // preview tab and the Academy Application's dev preview.
+            // GET /teacher/:teacher_uid/package/:package_uid/preview - TeacherPackagePreview
+            get: (teacher_uid, package_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/preview`),
+        },
+        // Uploads a zipped teacher project and applies it declaratively onto
+        // this teacher - the twin of `academy.collection.upload`: identical
+        // entities are left alone, differences go through the same per-entity
+        // drafts the endpoints use, new uids are created, managed uids missing
+        // from the project are soft-deleted. Never publishes. No timeout: the
+        // work grows with the project.
+        // POST /teacher/:teacher_uid/package/upload - TeacherPackageUpload
+        upload: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package/upload`, { body: request, timeoutMs: null }),
+    };
+    uid = {
+        // Looks uids up for a teacher project: whether a REAL uid names an
+        // entity of the stated kind of this teacher, which real uid an earlier
+        // upload gave a LOCAL one (`local:{entity}:{hash}`, see
+        // UidMappingType), and whether the academy content the project builds
+        // on (Collection, CollectionVersion, Asset, Item) is there. The
+        // Academy CLI calls it before an upload - its teacher `entity-uid`
+        // check, and to finish rewriting local uids an earlier upload resolved.
+        // POST /teacher/:teacher_uid/uid/check - TeacherUidCheck
+        check: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/uid/check`, { body: request }),
+    };
 }
 exports.BolbolTeacherScope = BolbolTeacherScope;
 //# sourceMappingURL=BolbolTeacherScope.js.map