bolbol-sdk 2.0.2 → 2.1.0

package/dist/scope/BolbolTeacherScope.js

@@ -10,18 +10,43 @@ 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.
-// 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.
+// 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;
+// - the products a teacher owns (P2): extensions - versioned sets of its
+//   components on one collection version - materials - bundles of its
+//   library resources, the former Resource component (P4) - courses,
+//   events, and packages, which bundle published versions of products of
+//   any owner (P6).
+// Every product is created unsigned with the contracts it requires, and
+// below its identity it answers 403 PRODUCT_NOT_SIGNED until both parties
+// have signed each of them (`contract`, P15). Its price is a pricing
+// assignment (`<product>.pricingAssignment`, P13), and the terms it offers
+// a packager - every product but a package, which nobody bundles - are
+// the templates on its contract slots (`<product>.contractTemplate`, P9).
+// 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 product's name, scopes, pricing
+// assignments and template slots, the resource library - is written in
+// place, and each product's `version.publish` is its only publish.
+// Creating a product, a component or a resource, and publishing a
+// product, needs Bolbol's authorization for that kind - a component the
+// Extension kind alone (P16; `authorization.get`; 403
+// AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED without it).
+// The teacher's pricings, contracts and contract templates are the same
+// surface as the academy's (BolbolAcademyScope `pricing` / `contract` /
+// `contractTemplate`), and `package.upload` with `uid.check` serve the
+// Academy CLI's teacher project.
 class BolbolTeacherScope {
     http;
     constructor(http) {
@@ -167,21 +192,39 @@ 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 - nine kinds, all but the academy's
+    // Collection): extensions, materials, courses, events, packages, videos,
+    // podcasts, files and URLs - each until a date, for good, or not at all.
+    // Each gated call asks exactly one kind and answers 403
+    // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED without it: creating or
+    // publishing a product, and adding to an extension or a package, asks
+    // that product's own kind; creating a resource its own kind; creating a
+    // component the Extension kind alone (P16). 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
-    // 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.
+    // eggs). A product's pricing assignments name one - the price it sells
+    // at (`<product>.pricingAssignment`, P13) - and so do a contract
+    // template's terms and the membership setting. 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 }),
@@ -192,8 +235,9 @@ class BolbolTeacherScope {
         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.
+        // A soft delete, refused with 409 PRICING_IN_USE while a live pricing
+        // assignment, a live contract template or the membership setting
+        // still names the pricing (P13).
         // 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.
@@ -212,56 +256,161 @@ class BolbolTeacherScope {
             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.
+    // The contracts the teacher is one end of (Bolbol API rules/Contract.md).
+    // Every product is created unsigned with the contracts it requires -
+    // Bolbol's commission on it, and the licensing, packaging and commission
+    // contracts of another owner's collection or product it extends or
+    // bundles - and stays locked (403 PRODUCT_NOT_SIGNED) until each of them
+    // is signed by both parties (P15); `<product>.contract.list` reads one
+    // product's. A contract is negotiated, then signed: its owner
+    // (`owner_type` / `owner_uid` - the owner whose template slot it was
+    // written from, Bolbol for a Bolbol_ type, P7) edits the terms while it
+    // is not fully signed, every edit clearing all four signatures; each
+    // party signs its own side (party 1 the producer, party 2 the consumer);
+    // signed by both, it is frozen for good, and once its duration has run
+    // out it reads as expired - shown only, nothing else changes (P21). The
+    // two parties chat on every contract, a thread kept for good (P22); a
+    // signature, a terms edit and a message each notify the other party when
+    // it is an academy or a teacher (P14) - Bolbol, with no user to receive
+    // one, is not notified (open, Bolbol API rules/Contract.md
+    // "Open points").
     contract = {
-        // `role` narrows to the contracts the teacher produces or consumes,
-        // `type` to one contract type.
+        // Newest first. `role` narrows to the side the teacher sits on,
+        // `type` to one contract type, `product_type` / `product_uid` to the
+        // contracts one product kind or one product requires (a uid needs
+        // its kind), `signed` to the fully signed or the open ones.
         // 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.
+        // 404 CONTRACT_NOT_FOUND; 403 CONTRACT_FORBIDDEN unless the teacher
+        // is the contract's producer or its consumer. Readable in every state.
         // GET /teacher/:teacher_uid/contract/:contract_uid - TeacherContractGet
         get: (teacher_uid, contract_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/contract/${encodeURIComponent(contract_uid)}`),
+        // The terms, written by the contract's owner while not both parties
+        // have signed: every field is written, the price requoted at the
+        // consumer's region and all four signatures cleared (whoever had
+        // signed signs again); the other party is notified. 403
+        // CONTRACT_NOT_OWNER for the other party, 409 CONTRACT_ALREADY_SIGNED
+        // once both have signed; the field errors are on the request type.
+        // PUT /teacher/:teacher_uid/contract/:contract_uid - TeacherContractUpdate
+        update: (teacher_uid, contract_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/contract/${encodeURIComponent(contract_uid)}`, { body: request }),
+        // Signs the teacher's own side (no body): party 1 as the producer,
+        // party 2 as the consumer, with the time and the caller's IP - the
+        // answer, like every contract read here, carries the address of the
+        // teacher's side only, the other side's null (ContractRowType). The
+        // second signature completes the contract (`signed_at`, and
+        // `expires_at` with a duration) and, when it was the product's last
+        // open contract, unlocks the product (`product_signed`). 409
+        // CONTRACT_ALREADY_SIGNED_BY_PARTY when the teacher's side is signed
+        // already, 409 CONTRACT_ALREADY_SIGNED once both are.
+        // POST /teacher/:teacher_uid/contract/:contract_uid/sign - TeacherContractSign
+        sign: (teacher_uid, contract_uid) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/contract/${encodeURIComponent(contract_uid)}/sign`),
+        // The contract's chat between its two parties: open before and after
+        // signing and after expiry; a message is never edited or deleted
+        // (P22).
+        message: {
+            // Oldest first, paged; omitted, the whole thread.
+            // GET /teacher/:teacher_uid/contract/:contract_uid/message - TeacherContractMessageList
+            list: (teacher_uid, contract_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/contract/${encodeURIComponent(contract_uid)}/message`, { query: request }),
+            // Posts from the teacher's side, signed by the caller's user; the
+            // other party is notified. 400 CONTRACT_MESSAGE_EMPTY for a text
+            // that is empty once trimmed.
+            // POST /teacher/:teacher_uid/contract/:contract_uid/message - TeacherContractMessageAdd
+            add: (teacher_uid, contract_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/contract/${encodeURIComponent(contract_uid)}/message`, { body: request }),
+        },
+    };
+    // The teacher's contract templates (Bolbol API rules/Contract.md, P9):
+    // the terms the teacher offers under one contract type - a pricing or
+    // free, the producer's share as a fraction, exclusive or not, a duration
+    // or none - under a name only the teacher sees. A teacher defines the
+    // eight Owner_*_Licensing_Packager / Owner_*_Packaging_Packager types of
+    // its extensions, materials, courses and events (400
+    // CONTRACT_TEMPLATE_TYPE_OWNER for any other type). A product attaches one
+    // per slot (`<product>.contractTemplate.set`), and each contract a
+    // packager's bundle of that product spawns is written from it, owned by
+    // the teacher, who may still negotiate it there (`contract.update`); a
+    // slot without a template gives the default terms (free, 0 / 1, not
+    // exclusive, no duration). Editing or deleting a template never changes a
+    // contract already written from it.
+    contractTemplate = {
+        // The teacher's live templates in name order. `type` narrows to one
+        // contract type (a slot's picker), `search` by uid or name.
+        // GET /teacher/:teacher_uid/contract-template - TeacherContractTemplateList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/contract-template`, { query: request }),
+        // A field left out takes the default terms. The type is immutable
+        // afterwards.
+        // POST /teacher/:teacher_uid/contract-template - TeacherContractTemplateCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/contract-template`, { body: request }),
+        // 404 CONTRACT_TEMPLATE_NOT_FOUND for an unknown or deleted uid, 403
+        // CONTRACT_TEMPLATE_FORBIDDEN for another owner's template.
+        // GET /teacher/:teacher_uid/contract-template/:contract_template_uid - TeacherContractTemplateGet
+        get: (teacher_uid, contract_template_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/contract-template/${encodeURIComponent(contract_template_uid)}`),
+        // Only the fields sent change (no `type`); reaches the contracts
+        // written after it only.
+        // PUT /teacher/:teacher_uid/contract-template/:contract_template_uid - TeacherContractTemplateUpdate
+        update: (teacher_uid, contract_template_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/contract-template/${encodeURIComponent(contract_template_uid)}`, { body: request }),
+        // A soft delete, never refused for being in use: contracts keep the
+        // template as their provenance, and a slot that still names it counts
+        // as having none - default terms from then on.
+        // DELETE /teacher/:teacher_uid/contract-template/:contract_template_uid - TeacherContractTemplateDelete
+        delete: (teacher_uid, contract_template_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/contract-template/${encodeURIComponent(contract_template_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 an extension 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 +435,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 +456,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 +504,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 +537,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 +582,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,32 +622,400 @@ 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
-    // package that lists the component does.
+    // 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 material bundles them, each through a material resource
+    // (`material.resource`, P4).
+    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 material's latest version
+        // holds a material 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 material's latest version
+        // holds a material 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 material's latest version
+        // holds a material 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 material's latest version
+        // holds a material 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 built
+    // over ONE published collection version of an academy, for that
+    // collection's exam, optionally narrowed to one skill and task of it.
+    // Its type (fixed at create) says which kind of child it holds - ref
+    // assets, ref items, answers or ambiguities - and which of their fields
+    // it fills (ComponentTypeEnum). Every component is on a collection: a
+    // bundle of the teacher's library resources is a material now
+    // (`material`, P4). 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 an extension
+    // that lists the component does (P2). A component is not a product: it
+    // has no contract and no `signed` of its own.
     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.
+        // Creates the component and its version 1 (a draft) on the published
+        // collection version the body names, which fixes its exam. Signs no
+        // contract: the contracts of building on a collection belong to the
+        // extension, whose create spawns them (P11). Needs the teacher's
+        // Extension authorization alone - the one kind for extensions and
+        // components (P16) - else 403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED.
         // 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
-        // pins the component.
+        // Soft delete; 409 COMPONENT_IN_USE while a published extension
+        // version pins the component. The extension drafts that list it drop
+        // it.
         // 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: {
@@ -681,103 +1239,731 @@ class BolbolTeacherScope {
             },
         },
     };
-    // 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
+    // The teacher's extensions - what the packages were before the six products
+    // (P2): versioned sets of the teacher's components, each built on one
+    // published version of an academy's collection and answered with its
+    // latest version's content. An extension has no price of its own:
+    // `pricingAssignment` prices it for learners, and `contractTemplate` offers
+    // the terms a packager signs to bundle it. It is created unsigned - Bolbol's
+    // commission and the collection's three educator contracts wait for their
+    // signatures (P11) - and until every one is signed only `list`, `get`,
+    // `delete` and `contract.list` answer; everything else is a 403
+    // PRODUCT_NOT_SIGNED (P15). 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.
+    extension = {
+        // `collection_uid`, `collection_version_uid`, `exam_id`, a skill / task
+        // and `signed` narrow the list; omitted, every extension of the teacher
+        // comes back, unsigned ones included. Paged, oldest first: an extension
+        // has no skill / task of its own.
+        // GET /teacher/:teacher_uid/extension - TeacherExtensionList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension`, { query: request }),
+        // Writes the identity, version 1 and every contract the extension
+        // requires in one transaction: Bolbol's commission and the collection's
+        // three educator contracts, on the terms of the templates the
+        // collection's academy attached (P11). Answers it with `signed: false`.
+        // POST /teacher/:teacher_uid/extension - TeacherExtensionCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/extension`, { body: request }),
+        // Open while the extension is unsigned (P15).
+        // GET /teacher/:teacher_uid/extension/:extension_uid - TeacherExtensionGet
+        get: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}`),
+        // Writes only the fields sent, a patch: the name in place on the
+        // identity, the notes on the draft (P3) - a body that only renames the
+        // extension opens no draft. The collection version is not editable,
+        // and there is no price to edit.
+        // PUT /teacher/:teacher_uid/extension/:extension_uid - TeacherExtensionUpdate
+        update: (teacher_uid, extension_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}`, { body: request }),
+        // A soft delete, open while unsigned; its contracts stay. 409
+        // EXTENSION_IN_USE while a published version of a live package pins it.
+        // DELETE /teacher/:teacher_uid/extension/:extension_uid - TeacherExtensionDelete
+        delete: (teacher_uid, extension_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}`),
+        // The preview's counts: the components the latest version pins and
+        // the children those component versions pin, per kind.
+        // GET /teacher/:teacher_uid/extension/:extension_uid/count - TeacherExtensionCount
+        count: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/count`),
+        version: {
+            // GET /teacher/:teacher_uid/extension/:extension_uid/version - TeacherExtensionVersionList
+            list: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version`),
+            // The publish cascade: publishes the draft versions of the pinned
+            // components and their children, re-pins what moved (forking a new
+            // extension version when the latest is already published) and
+            // publishes the extension. 409 NOTHING_TO_PUBLISH when nothing moved.
+            // POST /teacher/:teacher_uid/extension/:extension_uid/version/publish - TeacherExtensionVersionPublish
+            publish: (teacher_uid, extension_uid) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft.
+            // Discarding the only version takes the extension out of the list
+            // (its get answers 404 EXTENSION_VERSION_NO_LATEST).
+            // DELETE /teacher/:teacher_uid/extension/:extension_uid/version/latest - TeacherExtensionVersionDelete
+            deleteLast: (teacher_uid, extension_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version/latest`),
+        },
+        // Which components this extension holds, on its 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/extension/:extension_uid/version/component - TeacherExtensionVersion_ComponentVersionList
+            list: (teacher_uid, extension_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component`, { query: request }),
+            // The component must be built on the extension's collection version.
+            // POST /teacher/:teacher_uid/extension/:extension_uid/version/component - TeacherExtensionVersion_ComponentVersionAdd
+            add: (teacher_uid, extension_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component`, { body: request }),
+            // DELETE /teacher/:teacher_uid/extension/:extension_uid/version/component/:component_uid - TeacherExtensionVersion_ComponentVersionRemove
+            remove: (teacher_uid, extension_uid, component_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/${encodeURIComponent(component_uid)}`),
+            // Writes nothing but `sort_order`. Position in `component_uids` IS the order.
+            // PUT /teacher/:teacher_uid/extension/:extension_uid/version/component/order - TeacherExtensionVersion_ComponentVersionReorder
+            reorder: (teacher_uid, extension_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/order`, { body: request }),
+            // Swaps the pinned version of a component already in the extension;
+            // the body carries the target version_number (pick from
+            // teacher.component.version.list).
+            // PUT /teacher/:teacher_uid/extension/:extension_uid/version/component/:component_uid - TeacherExtensionVersion_ComponentVersionReplace
+            replace: (teacher_uid, extension_uid, component_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/${encodeURIComponent(component_uid)}`, { body: request }),
+        },
+        hierarchy: {
+            // extension -> components -> children, at the latest version's pins.
+            // GET /teacher/:teacher_uid/extension/:extension_uid/hierarchy - TeacherExtensionHierarchy
+            get: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/hierarchy`),
+        },
+        preview: {
+            // Every component's preview, in extension order - for the owner's
+            // preview tab and the Academy Application's dev preview.
+            // GET /teacher/:teacher_uid/extension/:extension_uid/preview - TeacherExtensionPreview
+            get: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/preview`),
+        },
+        // The contracts the extension requires - the ones its `signed` waits
+        // for. Open while the extension is unsigned, for the contract section;
+        // negotiating and signing one is `teacher.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /teacher/:teacher_uid/extension/:extension_uid/contract - TeacherExtensionContractList
+            list: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/contract`),
+        },
+        // The templates attached to the extension's two C slots
+        // (Owner_Extension_Licensing_Packager,
+        // Owner_Extension_Packaging_Packager): the terms a packager who
+        // bundles the extension is offered. Both calls answer 403
+        // PRODUCT_NOT_SIGNED while the extension is unsigned, the get included
+        // (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /teacher/:teacher_uid/extension/:extension_uid/contract-template - TeacherExtensionContractTemplateGet
+            get: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /teacher/:teacher_uid/extension/:extension_uid/contract-template - TeacherExtensionContractTemplateSet
+            set: (teacher_uid, extension_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/contract-template`, { body: request }),
+        },
+        // The teacher's pricings put on the extension, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Extension_Sell_User); with none in
+        // force the extension shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the extension is unsigned, the list
+        // included (P15).
+        pricingAssignment: {
+            // GET /teacher/:teacher_uid/extension/:extension_uid/pricing-assignment - TeacherExtensionPricingAssignmentList
+            list: (teacher_uid, extension_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the extension.
+            // POST /teacher/:teacher_uid/extension/:extension_uid/pricing-assignment - TeacherExtensionPricingAssignmentCreate
+            create: (teacher_uid, extension_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /teacher/:teacher_uid/extension/:extension_uid/pricing-assignment/:pricing_assignment_uid - TeacherExtensionPricingAssignmentUpdate
+            update: (teacher_uid, extension_uid, pricing_assignment_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /teacher/:teacher_uid/extension/:extension_uid/pricing-assignment/:pricing_assignment_uid - TeacherExtensionPricingAssignmentDelete
+            delete: (teacher_uid, extension_uid, pricing_assignment_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The teacher's materials (P4) - what the Resource component was, made a
+    // product of its own: a versioned bundle of the teacher's library
+    // resources (videos, podcasts, files, URLs), each pinned by a material
+    // resource filed under folder NAMES copied into the material, so its
+    // folders are its own and moving the library's folders later changes
+    // nothing here. A material is in one language, fixed at create - every
+    // resource it holds is of it - and carries exam scopes on its identity,
+    // which place it in the exam directories (BolbolMaterialScope). It is
+    // created unsigned (P15): until the contract it requires - its Bolbol
+    // commission - is signed (`contract.sign`), it answers only `list`, `get`,
+    // `delete` and `contract.list`, every other call - the reads below the
+    // identity included - 403 PRODUCT_NOT_SIGNED. The name sits on the
+    // identity and is renamed in place; the notes and the material resources'
+    // placement land on a draft version, forking one when the latest is
+    // published (P3), and `version.publish` publishes them. Creating and
+    // publishing need the teacher's Material authorization (P16; 403
+    // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED).
+    material = {
+        // `language_id`, an exam / skill / task (a scope of the exam whose
+        // skill / task is null or the one sent - a level left out narrows
+        // nothing), `signed` and `search` narrow the list; omitted, every
+        // material of the teacher comes back. Paged, oldest first.
+        // GET /teacher/:teacher_uid/material - TeacherMaterialList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material`, { query: request }),
+        // Writes the identity with its language and scopes, version 1 (a
+        // draft) and the Bolbol commission contract with Bolbol's side signed,
+        // in one transaction; the material answers `signed: false` until the
+        // teacher signs that contract too.
+        // POST /teacher/:teacher_uid/material - TeacherMaterialCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/material`, { body: request }),
+        // Readable while unsigned.
+        // GET /teacher/:teacher_uid/material/:material_uid - TeacherMaterialGet
+        get: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}`),
+        // Writes only the fields sent, a patch: the name in place on the
+        // identity, the notes on the draft (P3) - a body that only renames the
+        // material opens no draft. The language is fixed and the scopes are
+        // `scope.set`'s.
+        // PUT /teacher/:teacher_uid/material/:material_uid - TeacherMaterialUpdate
+        update: (teacher_uid, material_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}`, { body: request }),
+        // Soft delete, allowed while unsigned; 409 MATERIAL_IN_USE while a
+        // published version of a live package pins the material.
+        // DELETE /teacher/:teacher_uid/material/:material_uid - TeacherMaterialDelete
+        delete: (teacher_uid, material_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}`),
+        // The exams (and optionally skills and tasks) the material serves,
+        // replaced as a whole on the identity - not versioned, no draft.
+        scope: {
+            // PUT /teacher/:teacher_uid/material/:material_uid/scope - TeacherMaterialScopeSet
+            set: (teacher_uid, material_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/scope`, { body: request }),
+        },
+        // The preview's counts: the material resources the latest version
+        // pins and the folders their paths spell out.
+        // GET /teacher/:teacher_uid/material/:material_uid/count - TeacherMaterialCount
+        count: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/count`),
+        version: {
+            // GET /teacher/:teacher_uid/material/:material_uid/version - TeacherMaterialVersionList
+            list: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/version`),
+            // Publishes the draft versions of the material resources the latest
+            // version pins and the material's draft with them - nothing below,
+            // a resource not being versioned. 409 NOTHING_TO_PUBLISH when
+            // nothing moved. Needs the Material authorization.
+            // POST /teacher/:teacher_uid/material/:material_uid/version/publish - TeacherMaterialVersionPublish
+            publish: (teacher_uid, material_uid) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft, and
+            // reverts the material resources it pinned to what the previous
+            // version pins. Discarding the only version takes the material out
+            // of the list (its get answers 404 MATERIAL_VERSION_NO_LATEST).
+            // DELETE /teacher/:teacher_uid/material/:material_uid/version/latest - TeacherMaterialVersionDelete
+            deleteLast: (teacher_uid, material_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/version/latest`),
+        },
+        hierarchy: {
+            // The material resources the latest version pins, as their folder
+            // tree - what a Resource component's hierarchy was.
+            // GET /teacher/:teacher_uid/material/:material_uid/hierarchy - TeacherMaterialHierarchy
+            get: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/hierarchy`),
+        },
+        preview: {
+            // The material as it would be shown, its material resources' folder
+            // tree with each resource as `source` - for the owner's preview tab
+            // and the Academy Application's dev preview.
+            // GET /teacher/:teacher_uid/material/:material_uid/preview - TeacherMaterialPreview
+            get: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/preview`),
+        },
+        // The contracts the material requires - the ones its `signed` waits
+        // for. Open while the material is unsigned, for the contract section;
+        // negotiating and signing one is `teacher.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /teacher/:teacher_uid/material/:material_uid/contract - TeacherMaterialContractList
+            list: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/contract`),
+        },
+        // The templates attached to the material's two C slots
+        // (Owner_Material_Licensing_Packager,
+        // Owner_Material_Packaging_Packager): the terms a packager who bundles
+        // the material is offered. Both calls answer 403 PRODUCT_NOT_SIGNED
+        // while the material is unsigned, the get included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /teacher/:teacher_uid/material/:material_uid/contract-template - TeacherMaterialContractTemplateGet
+            get: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /teacher/:teacher_uid/material/:material_uid/contract-template - TeacherMaterialContractTemplateSet
+            set: (teacher_uid, material_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/contract-template`, { body: request }),
+        },
+        // The teacher's pricings put on the material, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Material_Sell_User); with none in
+        // force the material shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the material is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /teacher/:teacher_uid/material/:material_uid/pricing-assignment - TeacherMaterialPricingAssignmentList
+            list: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the material.
+            // POST /teacher/:teacher_uid/material/:material_uid/pricing-assignment - TeacherMaterialPricingAssignmentCreate
+            create: (teacher_uid, material_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /teacher/:teacher_uid/material/:material_uid/pricing-assignment/:pricing_assignment_uid - TeacherMaterialPricingAssignmentUpdate
+            update: (teacher_uid, material_uid, pricing_assignment_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /teacher/:teacher_uid/material/:material_uid/pricing-assignment/:pricing_assignment_uid - TeacherMaterialPricingAssignmentDelete
+            delete: (teacher_uid, material_uid, pricing_assignment_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+        // The material's material resources - the former ref resources: the
+        // teacher's own library resources of the material's language it
+        // bundles, at most one per resource. Each is filed under a folder path
+        // inside the material - folder NAMES, copied, so the material's
+        // folders are its own. None of these calls needs an authorization.
+        resource: {
+            // The live material resources at their latest versions, each with
+            // the resource it pins (`source`). Paged; `resource_type` narrows
+            // to one kind.
+            // GET /teacher/:teacher_uid/material/:material_uid/resource - TeacherMaterialResourceList
+            list: (teacher_uid, material_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/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/material/:material_uid/resource/tree - TeacherMaterialResourceTree
+            tree: (teacher_uid, material_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/tree`),
+            // Bundles one resource of the teacher's: version 1, a draft, pinned
+            // by the material's draft (a material 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), one of another
+            // language 400 MATERIAL_RESOURCE_LANGUAGE_MISMATCH; 409
+            // MATERIAL_RESOURCE_DUPLICATE when the material holds it already.
+            // POST /teacher/:teacher_uid/material/:material_uid/resource - TeacherMaterialResourceCreate
+            create: (teacher_uid, material_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource`, { body: request }),
+            // Bundles a library folder (with everything under it in the
+            // material's language, as folder paths) and / or picked resources
+            // in one call; the ones the material holds already are left as they
+            // are. All is resolved before the first write - a refused import
+            // writes nothing (400 MATERIAL_RESOURCE_LANGUAGE_MISMATCH for a
+            // pick of another language, 400 MATERIAL_RESOURCE_FOLDER_TOO_DEEP
+            // for a copied path deeper than 32 folders). Answers how many
+            // material resources it added (created or brought back) and the
+            // material's new tree.
+            // POST /teacher/:teacher_uid/material/:material_uid/resource/import - TeacherMaterialResourceImport
+            import: (teacher_uid, material_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/import`, { body: request }),
+            // The material's folders exist only as its material resources'
+            // folder paths, so they are renamed and moved by rewriting those.
+            folder: {
+                // Replaces the `from_path` prefix with `to_path` on every
+                // material resource under it, through their drafts; a `to_path`
+                // the material has already merges the two. Before anything is
+                // written: 409 FOLDER_CYCLE for a `to_path` inside `from_path`,
+                // 400 MATERIAL_RESOURCE_FOLDER_TOO_DEEP when a moved path would
+                // be deeper than 32 folders.
+                // PUT /teacher/:teacher_uid/material/:material_uid/resource/folder - TeacherMaterialResourceFolderRename
+                rename: (teacher_uid, material_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/folder`, { body: request }),
+            },
+            // GET /teacher/:teacher_uid/material/:material_uid/resource/:material_resource_uid - TeacherMaterialResourceGet
+            get: (teacher_uid, material_uid, material_resource_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`),
+            // Its place in the material - folder path, main entity, order; the
+            // resource it pins is fixed.
+            // PUT /teacher/:teacher_uid/material/:material_uid/resource/:material_resource_uid - TeacherMaterialResourceUpdate
+            update: (teacher_uid, material_uid, material_resource_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`, { body: request }),
+            // DELETE /teacher/:teacher_uid/material/:material_uid/resource/:material_resource_uid - TeacherMaterialResourceDelete
+            delete: (teacher_uid, material_uid, material_resource_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`),
+            version: {
+                // GET /teacher/:teacher_uid/material/:material_uid/resource/:material_resource_uid/version - TeacherMaterialResourceVersionList
+                list: (teacher_uid, material_uid, material_resource_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /teacher/:teacher_uid/material/:material_uid/resource/:material_resource_uid/version/latest - TeacherMaterialResourceVersionDelete
+                deleteLast: (teacher_uid, material_uid, material_resource_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}/version/latest`),
+            },
+        },
+    };
+    // The teacher's courses - the recurring products (instruction item 4):
+    // sessions of one length that repeat weekly or monthly in the time windows
+    // of a schedule, each open to a limited number of students and taught by
+    // the teacher, answered with the latest version's content. The name and
+    // the scopes sit on the identity (P3, P5); every other field and the
+    // schedule are versioned - edits to a published version land on a new
+    // draft, and `version.publish` is the only publish (no cascade: a course
+    // pins nothing). A course is created unsigned: until its contracts are
+    // signed (`contract.list`, then `teacher.contract.sign`) only `list`,
+    // `get`, `contract.list` and `delete` answer, everything else is a 403
+    // PRODUCT_NOT_SIGNED (P15).
+    course = {
+        // A language, an exam / skill / task (a scope row covering it, a
+        // level left out narrowing nothing), `signed` and `search` narrow the
+        // list; omitted, every course of the teacher comes back, unsigned ones
+        // included. Paged, oldest first.
+        // GET /teacher/:teacher_uid/course - TeacherCourseList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/course`, { query: request }),
+        // Writes the identity with its scopes, version 1 (a draft with every
+        // other field and the schedule) and the course's Bolbol commission
+        // contract (Bolbol pre-signed) in one transaction, and answers the
+        // course with `signed: false`. The teacher teaches it. Needs the
+        // teacher's Course authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
+        // POST /teacher/:teacher_uid/course - TeacherCourseCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/course`, { body: request }),
+        // Open while the course is unsigned: the contract section names the
+        // course from it.
+        // GET /teacher/:teacher_uid/course/:course_uid - TeacherCourseGet
+        get: (teacher_uid, course_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}`),
+        // Writes only the fields sent, a patch (P3): the name in place on the
+        // identity, the rest on the draft (forked from a published latest) - a
+        // body that only renames the course opens no draft. The scopes and the
+        // schedule are not editable here (`scope.set`, `schedule.set`).
+        // PUT /teacher/:teacher_uid/course/:course_uid - TeacherCourseUpdate
+        update: (teacher_uid, course_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}`, { body: request }),
+        // A soft delete, allowed while unsigned (the contracts stay); 409
+        // COURSE_IN_USE while a published version of a live package pins the
+        // course.
+        // DELETE /teacher/:teacher_uid/course/:course_uid - TeacherCourseDelete
+        delete: (teacher_uid, course_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}`),
+        // What the course is about - languages, optionally narrowed to exams,
+        // skills and tasks - replaced as a whole on the identity and not
+        // versioned: where the directories list the course, and which
+        // packages may bundle it (P6).
+        scope: {
+            // PUT /teacher/:teacher_uid/course/:course_uid/scope - TeacherCourseScopeSet
+            set: (teacher_uid, course_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/scope`, { body: request }),
+        },
+        // The time windows the sessions run in - version content, so a
+        // published version keeps the ones it was published with.
+        schedule: {
+            // Replaces the draft's windows as a whole (forking a draft from a
+            // published latest); position IS the order. Judged against the
+            // draft's recurrence and session length: 400
+            // COURSE_SCHEDULE_INVALID / COURSE_SCHEDULE_OVERLAP.
+            // PUT /teacher/:teacher_uid/course/:course_uid/schedule - TeacherCourseScheduleSet
+            set: (teacher_uid, course_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/schedule`, { body: request }),
+        },
+        version: {
+            // GET /teacher/:teacher_uid/course/:course_uid/version - TeacherCourseVersionList
+            list: (teacher_uid, course_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/version`),
+            // Stamps the latest version, a draft, published - nothing else
+            // moves. 409 COURSE_VERSION_ALREADY_PUBLISHED without a draft; 400
+            // COURSE_SCHEDULE_EMPTY while it has no time window. Needs the
+            // Course authorization.
+            // POST /teacher/:teacher_uid/course/:course_uid/version/publish - TeacherCourseVersionPublish
+            publish: (teacher_uid, course_uid) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft, with its
+            // schedule rows. Discarding the only version takes the course out
+            // of the list (its get answers 404 COURSE_VERSION_NO_LATEST).
+            // DELETE /teacher/:teacher_uid/course/:course_uid/version/latest - TeacherCourseVersionDelete
+            deleteLast: (teacher_uid, course_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/version/latest`),
+        },
+        preview: {
+            // The latest version as a learner would see it, its teacher
+            // resolved - for the owner's preview tab and the Academy
+            // Application's dev preview.
+            // GET /teacher/:teacher_uid/course/:course_uid/preview - TeacherCoursePreview
+            get: (teacher_uid, course_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/preview`),
+        },
+        // The contracts the course requires - the ones its `signed` waits for.
+        // Open while the course is unsigned, for the contract section;
+        // negotiating and signing one is `teacher.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /teacher/:teacher_uid/course/:course_uid/contract - TeacherCourseContractList
+            list: (teacher_uid, course_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/contract`),
+        },
+        // The templates attached to the course's two C slots
+        // (Owner_Course_Licensing_Packager, Owner_Course_Packaging_Packager):
+        // the terms a packager who bundles the course is offered. Both calls
+        // answer 403 PRODUCT_NOT_SIGNED while the course is unsigned, the get
+        // included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /teacher/:teacher_uid/course/:course_uid/contract-template - TeacherCourseContractTemplateGet
+            get: (teacher_uid, course_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /teacher/:teacher_uid/course/:course_uid/contract-template - TeacherCourseContractTemplateSet
+            set: (teacher_uid, course_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/contract-template`, { body: request }),
+        },
+        // The teacher's pricings put on the course, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Course_Sell_User); with none in
+        // force the course shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the course is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /teacher/:teacher_uid/course/:course_uid/pricing-assignment - TeacherCoursePricingAssignmentList
+            list: (teacher_uid, course_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the course.
+            // POST /teacher/:teacher_uid/course/:course_uid/pricing-assignment - TeacherCoursePricingAssignmentCreate
+            create: (teacher_uid, course_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /teacher/:teacher_uid/course/:course_uid/pricing-assignment/:pricing_assignment_uid - TeacherCoursePricingAssignmentUpdate
+            update: (teacher_uid, course_uid, pricing_assignment_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /teacher/:teacher_uid/course/:course_uid/pricing-assignment/:pricing_assignment_uid - TeacherCoursePricingAssignmentDelete
+            delete: (teacher_uid, course_uid, pricing_assignment_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The teacher's events - the one-time products (instruction item 4): a
+    // single session with a start, an end and a registration limit, answered
+    // with the latest version's content. The name and the scopes sit on the
+    // identity (P3, P5); every other field is versioned - edits to a
+    // published version land on a new draft, and `version.publish` is the
+    // only publish (no cascade: nothing hangs below an event). An event is
+    // created unsigned: until its contracts are signed (`contract.list`, then
+    // `teacher.contract.sign`) only `list`, `get`, `contract.list` and
+    // `delete` answer, everything else is a 403 PRODUCT_NOT_SIGNED (P15).
+    event = {
+        // A language, an exam / skill / task (a scope row covering it, a
+        // level left out narrowing nothing), `signed` and `search` narrow the
+        // list; omitted, every event of the teacher comes back. Paged, oldest
+        // first.
+        // GET /teacher/:teacher_uid/event - TeacherEventList
+        list: (teacher_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/event`, { query: request }),
+        // Writes the identity with its scopes, version 1 (a draft) and the
+        // event's Bolbol commission contract (Bolbol pre-signed), and answers
+        // the event with `signed: false`. Needs the teacher's Event
+        // authorization (403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED).
+        // POST /teacher/:teacher_uid/event - TeacherEventCreate
+        create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/event`, { body: request }),
+        // Open while the event is unsigned.
+        // GET /teacher/:teacher_uid/event/:event_uid - TeacherEventGet
+        get: (teacher_uid, event_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}`),
+        // Writes only the fields sent, a patch (P3): the name in place on the
+        // identity, the rest on the draft (forked from a published latest) - a
+        // body that only renames the event opens no draft. The scopes are not
+        // editable here (`scope.set`).
+        // PUT /teacher/:teacher_uid/event/:event_uid - TeacherEventUpdate
+        update: (teacher_uid, event_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}`, { body: request }),
+        // A soft delete, allowed while unsigned; 409 EVENT_IN_USE while a
+        // published version of a live package pins the event.
+        // DELETE /teacher/:teacher_uid/event/:event_uid - TeacherEventDelete
+        delete: (teacher_uid, event_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}`),
+        // What the event is about - languages, optionally narrowed to exams,
+        // skills and tasks - replaced as a whole on the identity and not
+        // versioned: where the directories list the event.
+        scope: {
+            // PUT /teacher/:teacher_uid/event/:event_uid/scope - TeacherEventScopeSet
+            set: (teacher_uid, event_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/scope`, { body: request }),
+        },
+        version: {
+            // GET /teacher/:teacher_uid/event/:event_uid/version - TeacherEventVersionList
+            list: (teacher_uid, event_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/version`),
+            // Stamps the latest version, a draft, published - nothing else
+            // moves. 409 EVENT_VERSION_ALREADY_PUBLISHED without a draft; 400
+            // EVENT_ENDED once the event is over. Needs the Event
+            // authorization.
+            // POST /teacher/:teacher_uid/event/:event_uid/version/publish - TeacherEventVersionPublish
+            publish: (teacher_uid, event_uid) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft.
+            // Discarding the only version takes the event out of the list (its
+            // get answers 404 EVENT_VERSION_NO_LATEST).
+            // DELETE /teacher/:teacher_uid/event/:event_uid/version/latest - TeacherEventVersionDelete
+            deleteLast: (teacher_uid, event_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/version/latest`),
+        },
+        preview: {
+            // The latest version as a learner would see it - for the owner's
+            // preview tab and the Academy Application's dev preview.
+            // GET /teacher/:teacher_uid/event/:event_uid/preview - TeacherEventPreview
+            get: (teacher_uid, event_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/preview`),
+        },
+        // The contracts the event requires - the ones its `signed` waits for.
+        // Open while the event is unsigned, for the contract section;
+        // negotiating and signing one is `teacher.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /teacher/:teacher_uid/event/:event_uid/contract - TeacherEventContractList
+            list: (teacher_uid, event_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/contract`),
+        },
+        // The templates attached to the event's two C slots
+        // (Owner_Event_Licensing_Packager, Owner_Event_Packaging_Packager):
+        // the terms a packager who bundles the event is offered. Both calls
+        // answer 403 PRODUCT_NOT_SIGNED while the event is unsigned, the get
+        // included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /teacher/:teacher_uid/event/:event_uid/contract-template - TeacherEventContractTemplateGet
+            get: (teacher_uid, event_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /teacher/:teacher_uid/event/:event_uid/contract-template - TeacherEventContractTemplateSet
+            set: (teacher_uid, event_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/contract-template`, { body: request }),
+        },
+        // The teacher's pricings put on the event, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Event_Sell_User); with none in
+        // force the event shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the event is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /teacher/:teacher_uid/event/:event_uid/pricing-assignment - TeacherEventPricingAssignmentList
+            list: (teacher_uid, event_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the event.
+            // POST /teacher/:teacher_uid/event/:event_uid/pricing-assignment - TeacherEventPricingAssignmentCreate
+            create: (teacher_uid, event_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /teacher/:teacher_uid/event/:event_uid/pricing-assignment/:pricing_assignment_uid - TeacherEventPricingAssignmentUpdate
+            update: (teacher_uid, event_uid, pricing_assignment_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /teacher/:teacher_uid/event/:event_uid/pricing-assignment/:pricing_assignment_uid - TeacherEventPricingAssignmentDelete
+            delete: (teacher_uid, event_uid, pricing_assignment_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The teacher's packages - the complex product (P2, P6): an ordered list
+    // of pins of PUBLISHED versions of the five single products - collections,
+    // extensions, materials, courses and events - of any owner, all of the
+    // package's language and, for a collection or an extension, of its exam.
+    // The language and the exam are fixed at create, the name sits on the
+    // package itself and the notes on its versions (P3); each package is
+    // answered with its latest version's content. It is created unsigned -
+    // Bolbol's commission and, for every product of another owner it bundles,
+    // that product's licensing and packaging contracts (a collection's
+    // packaging contract only, P10) wait for their signatures - and until
+    // every one is signed only `list`, `get`, `delete` and `contract.list`
+    // answer for it; every other read and every write is a 403
+    // PRODUCT_NOT_SIGNED (P15). Adding another owner's product later unsigns
+    // it again until that product's contracts are signed (P6). Edits to a
+    // published version land on a new draft version; `version.publish` moves
+    // every pin to its product's latest published version and never publishes
+    // a product. A package has no price of its own - `pricingAssignment`
+    // prices it for learners - and no contract-template slots: nobody bundles
+    // a package.
     package = {
-        // `collection_version_uid` / `exam_id` narrow the list; omitted, every
-        // package of the teacher comes back.
+        // `language_id`, `exam_id`, `product_type` (a package pinning a
+        // product of that kind) and `signed` narrow the list; omitted, every
+        // package of the teacher comes back, unsigned ones included. Paged,
+        // newest first.
         // 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.
+        // Writes the package, its version 1 pinning `products` at their latest
+        // published versions, and every contract it requires in one
+        // transaction: Bolbol's commission, already signed by Bolbol, and the
+        // contracts of each product of another owner, on the terms of the
+        // templates that owner attached. Answers it with `signed: false`.
         // POST /teacher/:teacher_uid/package - TeacherPackageCreate
         create: (teacher_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package`, { body: request }),
+        // Open while the package is unsigned (P15).
         // 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.
+        // Writes only the fields sent, a patch: the name in place on the
+        // identity, the notes on the draft (P3) - a body that only renames the
+        // package opens no draft. The language and the exam are not editable;
+        // the products change through `product`, the price through
+        // `pricingAssignment`.
         // 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 }),
+        // A soft delete, open while unsigned; the contracts stay, the products
+        // it pinned are untouched.
         // 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.
+        // The preview's counts: the products the latest version pins, 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.
+            // Moves every pin to its product's latest PUBLISHED version
+            // (forking a new package version when the latest is already
+            // published) and publishes the package - never a product: a
+            // product's draft waits for its own owner's publish. 409
+            // NOTHING_TO_PUBLISH when no pin would move; 409
+            // PACKAGE_PRODUCT_DELETED while the package holds a product deleted
+            // since it was added.
             // 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.
+            // Drops the latest version, which must still be a draft, and
+            // reverts its product pins. Discarding the only version takes the
+            // package out of the list (its get answers 404
+            // PACKAGE_VERSION_NO_LATEST).
             // 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 }),
+        // Which products this package bundles, on the package's latest
+        // version - the same five calls as `extension.component`. A pin is
+        // addressed by its PRODUCT (`product_type` + `product_uid`); removing
+        // one unpins the product only, the product survives.
+        product: {
+            // `version_number` reads an earlier version's pins (the Changes
+            // tab). Unpaged: a package pins at most 200 products.
+            // GET /teacher/:teacher_uid/package/:package_uid/version/product - TeacherPackageVersion_ProductVersionList
+            list: (teacher_uid, package_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/product`, { query: request }),
+            // Pins the product's latest published version at the end of the
+            // draft: a signed product of any owner, of the package's language
+            // - and exam, for a collection or an extension (P6). Another
+            // owner's product writes its contracts and puts the package back
+            // to `signed: false` until they are signed.
+            // POST /teacher/:teacher_uid/package/:package_uid/version/product - TeacherPackageVersion_ProductVersionAdd
+            add: (teacher_uid, package_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/product`, { body: request }),
+            // DELETE /teacher/:teacher_uid/package/:package_uid/version/product/:product_type/:product_uid - TeacherPackageVersion_ProductVersionRemove
+            remove: (teacher_uid, package_uid, product_type, product_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/product/${encodeURIComponent(product_type)}/${encodeURIComponent(product_uid)}`),
+            // Writes nothing but `sort_order`. Position in `products` IS the
+            // order - one sequence across the five kinds.
+            // PUT /teacher/:teacher_uid/package/:package_uid/version/product/order - TeacherPackageVersion_ProductVersionReorder
+            reorder: (teacher_uid, package_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/product/order`, { body: request }),
+            // Swaps the pinned version of a product already in the package for
+            // another PUBLISHED one; the body carries its version_number (every
+            // number up to the pin's `version_number_latest_published` is
+            // one).
+            // PUT /teacher/:teacher_uid/package/:package_uid/version/product/:product_type/:product_uid - TeacherPackageVersion_ProductVersionReplace
+            replace: (teacher_uid, package_uid, product_type, product_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/product/${encodeURIComponent(product_type)}/${encodeURIComponent(product_uid)}`, { body: request }),
         },
         hierarchy: {
-            // package -> components -> children, at the latest version's pins.
+            // package -> products -> what each pinned version holds (a
+            // collection's skills and tasks, an extension's components and
+            // their children, a material's folders), 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.
+            // Every pinned product's preview at its pinned version, 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`),
         },
+        // The contracts the package requires - the ones its `signed` waits
+        // for. Open while the package is unsigned, for the contract section;
+        // negotiating and signing one is `teacher.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /teacher/:teacher_uid/package/:package_uid/contract - TeacherPackageContractList
+            list: (teacher_uid, package_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/contract`),
+        },
+        // The teacher's pricings put on the package, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Package_Sell_User); with none in
+        // force the package shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the package is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /teacher/:teacher_uid/package/:package_uid/pricing-assignment - TeacherPackagePricingAssignmentList
+            list: (teacher_uid, package_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the package.
+            // POST /teacher/:teacher_uid/package/:package_uid/pricing-assignment - TeacherPackagePricingAssignmentCreate
+            create: (teacher_uid, package_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /teacher/:teacher_uid/package/:package_uid/pricing-assignment/:pricing_assignment_uid - TeacherPackagePricingAssignmentUpdate
+            update: (teacher_uid, package_uid, pricing_assignment_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /teacher/:teacher_uid/package/:package_uid/pricing-assignment/:pricing_assignment_uid - TeacherPackagePricingAssignmentDelete
+            delete: (teacher_uid, package_uid, pricing_assignment_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
         // 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.
+        // from the project are soft-deleted. It carries the whole project -
+        // pricings, contract templates, learning kits, resources, components
+        // and the five products the teacher can own - not only packages.
+        // Never publishes and never signs: a product it creates is unsigned,
+        // and its membership, scopes, schedule, assignments and template slots
+        // wait for the first upload after signing - logged as `deferred` rows,
+        // each product's row carrying its `signed` (P19). 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.
+        // entity of the stated kind of this teacher - a pricing, a contract
+        // template, learning content, a resource, or a product (Extension,
+        // Material and its MaterialResource, Course, Event, Package; P20) -
+        // 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. A product's answer, a collection's included,
+        // also says whether it is `signed`: an upload defers what an unsigned
+        // product's files ask until it is (P19). Another owner's extension,
+        // material, course or event that a package bundles answers like an
+        // unknown uid - its public directory profile confirms it. 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 }),
     };