bolbol-sdk 2.0.3 → 2.1.0

package/dist/scope/BolbolTeacherScope.js

@@ -22,20 +22,31 @@ exports.BolbolTeacherScope = void 0;
 //   word list and annotations on its transcript;
 // - components: one learning action each, holding ref assets, ref items,
 //   answers or ambiguities over one published collection version of an
-//   academy - or, for a Resource component, built on no collection, ref
-//   resources: library resources filed under the component's own folders;
-// - packages: sellable bundles of components whose `version.publish` is the
-//   only publish on the teacher side.
+//   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 package's pricing, the resource library -
-// is written in place. Creating a package, a component or a resource, and
-// publishing a package, needs Bolbol's authorization for that kind - a
-// component Package and its type family's kind both (`authorization.get`;
-// 403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED without it).
-// The teacher's pricings and contracts are the same surface as the academy's
-// (BolbolAcademyScope `pricing` / `contract`), and `package.upload` with
-// `uid.check` serve the Academy CLI's teacher project.
+// 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) {
@@ -191,13 +202,16 @@ class BolbolTeacherScope {
         list: (teacher_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/request`),
     };
     // What Bolbol has authorized the teacher to manage, kind by kind
-    // (ManageAuthorizationEnum): packages, components on a collection or on
-    // resources, videos, podcasts, files, URLs and courses - each until a date,
-    // for good, or not at all. The gated creates answer 403
-    // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED without it; a component
-    // create needs Package as well as its family's kind. A grant is
-    // asked for with `bolbol.request.create` and the row's `request_type`, and
-    // given by Bolbol's approval; nothing here writes.
+    // (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
@@ -206,9 +220,11 @@ class BolbolTeacherScope {
     // 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 }),
@@ -219,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.
@@ -239,20 +256,106 @@ 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 - and what each of them reaches.
+    // 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`.
@@ -555,7 +658,8 @@ class BolbolTeacherScope {
     // filed in `folder`s. Each is in one language and carries a transcript,
     // exam scopes, the category values and word list it teaches, and
     // annotations on its transcript. Not versioned: every call writes in place.
-    // A Resource component bundles them (`component.refResource`).
+    // 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.
@@ -571,9 +675,9 @@ class BolbolTeacherScope {
         // the type may change - a YouTube link replaced by an upload.
         // PUT /teacher/:teacher_uid/video/:video_uid - TeacherVideoUpdate
         update: (teacher_uid, video_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/video/${encodeURIComponent(video_uid)}`, { body: request }),
-        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
-        // holds a ref resource of it, or its unpublished draft deleted one
-        // (discarding the draft would bring it back).
+        // 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,
@@ -653,9 +757,9 @@ class BolbolTeacherScope {
         // the episode's file is replaced only when one is sent.
         // PUT /teacher/:teacher_uid/podcast/:podcast_uid - TeacherPodcastUpdate
         update: (teacher_uid, podcast_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/podcast/${encodeURIComponent(podcast_uid)}`, { body: request }),
-        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
-        // holds a ref resource of it, or its unpublished draft deleted one
-        // (discarding the draft would bring it back).
+        // 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,
@@ -734,9 +838,9 @@ class BolbolTeacherScope {
         // Every field but the language (fixed) and the scopes (`scope.set`).
         // PUT /teacher/:teacher_uid/file/:file_uid - TeacherFileUpdate
         update: (teacher_uid, file_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/file/${encodeURIComponent(file_uid)}`, { body: request }),
-        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
-        // holds a ref resource of it, or its unpublished draft deleted one
-        // (discarding the draft would bring it back).
+        // 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
@@ -816,9 +920,9 @@ class BolbolTeacherScope {
         // Every field but the language (fixed) and the scopes (`scope.set`).
         // PUT /teacher/:teacher_uid/url/:url_uid - TeacherUrlUpdate
         update: (teacher_uid, url_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}`, { body: request }),
-        // Soft delete; 409 RESOURCE_IN_USE while a component's latest version
-        // holds a ref resource of it, or its unpublished draft deleted one
-        // (discarding the draft would bring it back).
+        // 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
@@ -875,30 +979,32 @@ class BolbolTeacherScope {
             list: (teacher_uid, url_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/url/${encodeURIComponent(url_uid)}/learning-kit`),
         },
     };
-    // The teacher's components. A component is one learning action for one
-    // exam, optionally narrowed to one skill and task of it. Its type (fixed
-    // at create) says which kind of child it holds and which of their fields
-    // it fills (ComponentTypeEnum): ref assets, ref items, answers or
-    // ambiguities over ONE published collection version of an academy, or -
-    // a Resource component, built on no collection - ref resources, the
-    // teacher's own library resources. The children's endpoints nest under
-    // it, as their URLs do. Every write to a component (but its kit list,
-    // kept on the identity) or to a child lands on a draft, forking one when
-    // the latest version is published; nothing here publishes - publishing a
-    // package that lists the component does.
+    // 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, 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 - or, for a Resource component, on its exam
-        // alone. The teacher's first component on a collection also signs the
-        // academy's licensing contract for it. Needs the teacher's Package
-        // authorization and its ComponentForCollection / ComponentForResources
-        // one by the type (403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED
-        // naming the first missing, Package first).
+        // 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
@@ -907,8 +1013,9 @@ class BolbolTeacherScope {
         // / 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: {
@@ -932,8 +1039,7 @@ class BolbolTeacherScope {
         hierarchy: {
             // The collection version's skill -> task -> series -> item tree
             // (plus each task's assets), every row carrying the component's
-            // ref row, its state and the sheet value - or, for a Resource
-            // component, its ref resources as a folder tree.
+            // ref row, its state and the sheet value.
             // GET /teacher/:teacher_uid/component/:component_uid/hierarchy - TeacherComponentHierarchy
             get: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/hierarchy`),
         },
@@ -1132,167 +1238,732 @@ class BolbolTeacherScope {
                 deleteLast: (teacher_uid, component_uid, ambiguity_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}/version/latest`),
             },
         },
-        // A Resource component's ref resources: the teacher's own library
-        // resources (videos, podcasts, files, URLs) it bundles, at most one per
-        // resource. Each is filed under a folder path inside the component -
-        // folder NAMES, copied, so the component's folders are its own and
-        // moving the library's folders later changes nothing here.
-        refResource: {
-            // The live ref resources at their latest versions, each with the
-            // resource it pins (`source`). Paged; `resource_type` narrows to
-            // one kind.
-            // GET /teacher/:teacher_uid/component/:component_uid/ref-resource - TeacherRefResourceList
-            list: (teacher_uid, component_uid, request = {}) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource`, { query: request }),
+    };
+    // The 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/component/:component_uid/ref-resource/tree - TeacherRefResourceTree
-            tree: (teacher_uid, component_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/tree`),
+            // 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 component's draft (a ref resource it had - deleted, or
+            // 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); 409
-            // REF_RESOURCE_DUPLICATE when the component holds it already.
-            // POST /teacher/:teacher_uid/component/:component_uid/ref-resource - TeacherRefResourceCreate
-            create: (teacher_uid, component_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource`, { body: request }),
-            // Bundles a library folder (with everything under it, as folder
-            // paths) and / or picked resources in one call; the ones the
-            // component holds already are left as they are. All is resolved
-            // before the first write - a refused import writes nothing (400
-            // REF_RESOURCE_FOLDER_TOO_DEEP for a copied path deeper than 32
-            // folders). Answers how many ref resources it added (created or
-            // brought back) and the component's new tree.
-            // POST /teacher/:teacher_uid/component/:component_uid/ref-resource/import - TeacherRefResourceImport
-            import: (teacher_uid, component_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/import`, { body: request }),
-            // The component's folders exist only as its ref resources' folder
-            // paths, so they are renamed and moved by rewriting those.
+            // (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 ref
-                // resource under it, through their drafts; a `to_path` the
-                // component has already merges the two. Before anything is
-                // written: 409 FOLDER_CYCLE for a `to_path` inside
-                // `from_path`, 400 REF_RESOURCE_FOLDER_TOO_DEEP when a moved
-                // path would be deeper than 32 folders.
-                // PUT /teacher/:teacher_uid/component/:component_uid/ref-resource/folder - TeacherRefResourceFolderRename
-                rename: (teacher_uid, component_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/folder`, { body: request }),
+                // 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/component/:component_uid/ref-resource/:ref_resource_uid - TeacherRefResourceGet
-            get: (teacher_uid, component_uid, ref_resource_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`),
-            // Its place in the component - folder path, main entity, order; the
+            // 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/component/:component_uid/ref-resource/:ref_resource_uid - TeacherRefResourceUpdate
-            update: (teacher_uid, component_uid, ref_resource_uid, request) => this.http.put(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`, { body: request }),
-            // DELETE /teacher/:teacher_uid/component/:component_uid/ref-resource/:ref_resource_uid - TeacherRefResourceDelete
-            delete: (teacher_uid, component_uid, ref_resource_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`),
+            // 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/component/:component_uid/ref-resource/:ref_resource_uid/version - TeacherRefResourceVersionList
-                list: (teacher_uid, component_uid, ref_resource_uid) => this.http.get(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}/version`),
+                // 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/component/:component_uid/ref-resource/:ref_resource_uid/version/latest - TeacherRefResourceVersionDelete
-                deleteLast: (teacher_uid, component_uid, ref_resource_uid) => this.http.delete(`/teacher/${encodeURIComponent(teacher_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}/version/latest`),
+                // 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 packages - sellable bundles of the teacher's components,
-    // each built on one published collection version and answered with its
-    // latest version's content; a Resource component, built on no
-    // collection, joins any package of its exam. Edits to a published version
-    // land on a new draft version; `version.publish` is the only publish, and
-    // it publishes the pinned components and their children with it.
+    // 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` and a skill / task narrow the
-        // list; omitted, every package of the teacher comes back. Paged,
-        // oldest first: a package has no skill / task of its own.
+        // `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
-            // - or be a Resource component of the package's exam.
-            // POST /teacher/:teacher_uid/package/:package_uid/version/component - TeacherPackageVersion_ComponentVersionAdd
-            add: (teacher_uid, package_uid, request) => this.http.post(`/teacher/${encodeURIComponent(teacher_uid)}/package/${encodeURIComponent(package_uid)}/version/component`, { body: request }),
-            // DELETE /teacher/:teacher_uid/package/:package_uid/version/component/:component_uid - TeacherPackageVersion_ComponentVersionRemove
-            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 }),
     };