bolbol-sdk 2.0.2 → 2.1.0

package/dist/scope/BolbolAcademyScope.js

@@ -3,10 +3,33 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BolbolAcademyScope = void 0;
 // Mirrors Bolbol API src/controller/academy. One method per controller.
 //
-// The academy provides the environment: its collections, series, items and
-// assets, and the pricings it sells them with. How to learn on top of a
-// published collection version - learning kits, components, packages - is
-// teacher content (BolbolTeacherScope).
+// The academy provides the environment: its collections - the academy's
+// own product (P2) - series, items and assets, and the pricings it prices
+// them with. It is also the second owner of learning content, beside the
+// teacher (Bolbol API rules/Teacher.md): learning kits (annotation groups,
+// category types and values, mindsets, concepts), components, resources
+// (folders, videos, podcasts, files, URLs) and the products a teacher owns
+// too - extensions, materials, courses, events and packages. Those
+// endpoints are the twins of the teacher's (BolbolTeacherScope): the same
+// sub-paths under /academy/:academy_uid, the same bodies and answers -
+// their types alias the teacher's - so a client drives either owner with
+// the same calls. Every product, a collection included, is created
+// unsigned with the contracts it requires, and the server signs none of
+// them for the academy: each party signs its own side (`contract`, P7,
+// P15). An academy may build on any published collection version: an
+// extension of one of its own collections requires Bolbol's commission
+// alone, one of another academy's also that collection's three educator
+// contracts (P11), as for a teacher.
+//
+// Like a teacher, the academy is verified by Bolbol: its documents,
+// certificates, experiences and publications go through review requests, and
+// only an approved academy is listed in the directory and may publish a
+// collection. Bolbol also authorizes, kind by kind, what it may manage
+// (`authorization.get`, ten kinds): the calls that create or publish a
+// product, create a component or a resource, or add to an extension or a
+// package answer 403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED
+// without that kind's grant - one kind each, Extension alone for a
+// component (P16).
 class BolbolAcademyScope {
     http;
     constructor(http) {
@@ -16,9 +39,17 @@ class BolbolAcademyScope {
         // Looks uids up in this academy: whether a REAL uid names an entity of
         // the stated kind, and which real uid an earlier upload gave a LOCAL
         // one (`local:{entity}:{hash}`, see UidMappingType). The kinds are the
-        // academy project's: Collection, Series, Item, Asset, Pricing. The
-        // Academy CLI calls it before an upload - its `entity-uid` check, and
-        // to finish rewriting local uids an earlier upload resolved.
+        // academy project's: Collection, Series, Item, Asset, Pricing, and the
+        // content kinds its `package.upload` half maps - the teacher
+        // project's: contract templates, learning content, resources and the
+        // products, a material's MaterialResource among them (P20). 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 product that a package bundles
+        // answers like an unknown uid - its public directory profile confirms
+        // it. The Academy CLI calls it before an upload - its `entity-uid`
+        // check, and to finish rewriting local uids an earlier upload
+        // resolved.
         // POST /academy/:academy_uid/uid/check - AcademyUidCheck
         check: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/uid/check`, { body: request }),
     };
@@ -31,8 +62,9 @@ class BolbolAcademyScope {
         // all for the whole directory.
         // GET /academy/directory - AcademyDirectoryList
         list: (request = {}) => this.http.get("/academy/directory", { query: request }),
-        // Public deep view for one academy card: the account plus the
-        // (language, exam) pairs it teaches. Does NOT require owning it.
+        // Public deep view for one academy card: the account, the (language,
+        // exam) pairs it teaches, and its approved certificates, experiences
+        // and publications with their public files. Does NOT require owning it.
         // GET /academy/directory/profile/:academy_uid - AcademyDirectoryProfile
         profile: (academy_uid) => this.http.get(`/academy/directory/profile/${encodeURIComponent(academy_uid)}`),
     };
@@ -81,6 +113,107 @@ class BolbolAcademyScope {
             cancel: (academy_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/cancel-deletion`),
         },
     };
+    // The academy's verification profile - the twin of the teacher's
+    // (`teacher.document`, `.certificate`, `.experience`, `.publication`,
+    // `.attachment`, `.request`), over the academy's own tables. The academy
+    // itself and each certificate, experience and publication start Pending,
+    // go InReview when a BolbolAcademy* request is filed for them through
+    // `bolbol.request`, and end Approved or Refused; an edit puts a child back
+    // to Pending. Only an Approved or Premium academy is listed in the public
+    // directory and may publish a collection.
+    document = {
+        // Academy-level attachments (the "Documents" tab). Distinct from
+        // `entity.attachment.list`, which requires an entity_id the client
+        // never has for the Academy entity type.
+        // GET /academy/:academy_uid/documents - AcademyDocumentsList
+        list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/documents`),
+        // Attaches a single uploaded file to the academy's document set. One
+        // request per add; idempotent, so a double-click adds it once.
+        // POST /academy/:academy_uid/documents - AcademyAddDocument
+        add: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/documents`, { body: request }),
+        // Detaches a single document. The backend refuses when the attachment
+        // is already `Approved` - an approved document stays until the
+        // academy is deleted.
+        // DELETE /academy/:academy_uid/documents/:user_file_uid - AcademyRemoveDocument
+        remove: (academy_uid, user_file_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/documents/${encodeURIComponent(user_file_uid)}`),
+    };
+    // Certificates, experiences and publications alike: a row's files ride in
+    // its create / update body (`user_file_uids`, a full replacement) and are
+    // read back through `entity.attachment.list`.
+    certificate = {
+        // GET /academy/:academy_uid/certificate - AcademyCertificateList
+        list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/certificate`),
+        // POST /academy/:academy_uid/certificate - AcademyCertificateCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/certificate`, { body: request }),
+        // PUT /academy/:academy_uid/certificate/:certificate_id - AcademyCertificateUpdate
+        update: (academy_uid, certificate_id, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/certificate/${certificate_id}`, { body: request }),
+        // DELETE /academy/:academy_uid/certificate/:certificate_id - AcademyCertificateDelete
+        delete: (academy_uid, certificate_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/certificate/${certificate_id}`),
+    };
+    experience = {
+        // GET /academy/:academy_uid/experience - AcademyExperienceList
+        list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/experience`),
+        // POST /academy/:academy_uid/experience - AcademyExperienceCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/experience`, { body: request }),
+        // PUT /academy/:academy_uid/experience/:experience_id - AcademyExperienceUpdate
+        update: (academy_uid, experience_id, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/experience/${experience_id}`, { body: request }),
+        // DELETE /academy/:academy_uid/experience/:experience_id - AcademyExperienceDelete
+        delete: (academy_uid, experience_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/experience/${experience_id}`),
+    };
+    publication = {
+        // GET /academy/:academy_uid/publication - AcademyPublicationList
+        list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/publication`),
+        // POST /academy/:academy_uid/publication - AcademyPublicationCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/publication`, { body: request }),
+        // PUT /academy/:academy_uid/publication/:publication_id - AcademyPublicationUpdate
+        update: (academy_uid, publication_id, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/publication/${publication_id}`, { body: request }),
+        // DELETE /academy/:academy_uid/publication/:publication_id - AcademyPublicationDelete
+        delete: (academy_uid, publication_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/publication/${publication_id}`),
+    };
+    // Nested as the URL is: `entity/:entity_type/:entity_id` names the row a
+    // file hangs off, which keeps the route clear of the concrete
+    // `/certificate/:certificate_id` ones.
+    entity = {
+        attachment: {
+            // One endpoint for every entity type, mirroring the polymorphic
+            // attachment table on the backend (academy.academy_attachment).
+            // Attachments are not part of an entity's own payload - nothing
+            // lists them - so only the edit form calls this.
+            // GET /academy/:academy_uid/entity/:entity_type/:entity_id/attachment - AcademyAttachmentList
+            list: (academy_uid, entity_type, entity_id) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/entity/${encodeURIComponent(entity_type)}/${entity_id}/attachment`),
+        },
+    };
+    // The academy's requests addressed to Bolbol itself: verification (the
+    // four BolbolAcademy* types) and authorization (BolbolAcademyManage*,
+    // the requests Bolbol grants `authorization` with). They are rows in the
+    // same `request` table every other request lives in, so they carry the
+    // same RequestRowType shape; what is academy-specific is only the
+    // filter. Filing one, and the requests between the academy and its
+    // teachers or students, go through `bolbol.request`.
+    request = {
+        // GET /academy/:academy_uid/request - AcademyRequestList
+        list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/request`),
+    };
+    // What Bolbol has authorized the academy to manage, kind by kind
+    // (ManageAuthorizationEnum) - the twin of `teacher.authorization`, plus
+    // Collection, the one kind only an academy holds - ten kinds: collections,
+    // extensions, materials, courses, events, packages, videos, podcasts,
+    // files and URLs, each until a date, for good, or not at all. The calls
+    // a kind gates answer 403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED
+    // without it, and each asks exactly one: creating a collection, series,
+    // item or asset and publishing a collection (Collection); creating or
+    // publishing an extension, adding a component to one and creating any
+    // component (Extension alone, P16); creating or publishing a package and
+    // adding a product to one (Package); creating or publishing a material,
+    // a course or an event, and creating a resource (its own kind). A grant
+    // is asked for with `bolbol.request.create` and the row's
+    // `request_type` (a BolbolAcademyManage* type), and given by Bolbol's
+    // approval; nothing here writes.
+    authorization = {
+        // One row per kind, its status computed as of today.
+        // GET /academy/:academy_uid/authorization - AcademyAuthorizationGet
+        get: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/authorization`),
+    };
     asset = {
         // `exam_skill_id` narrows to the skill the admin tree is opened at - an
         // asset hangs off a skill, not a task. Omitted, the call returns the
@@ -109,9 +242,9 @@ class BolbolAcademyScope {
             deleteLast: (academy_uid, asset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/version/latest`),
         },
         // The asset's file bucket, backed by asset_attachment. Uploading and
-        // attaching are two steps: `userFile.upload` stores the bytes with
-        // `in_use = false`, and `add` creates the join row that flips the file
-        // to `in_use = true`. A file uploaded but never attached stays
+        // attaching are two steps: `userFile.file.upload` stores the bytes
+        // with `in_use = false`, and `add` creates the join row that flips the
+        // file to `in_use = true`. A file uploaded but never attached stays
         // reclaimable, so an abandoned form leaves nothing pinned.
         attachment: {
             // Attachments in order.
@@ -176,22 +309,42 @@ class BolbolAcademyScope {
             list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/teacher/join`),
         },
     };
-    // An academy's collections, each answered with its latest version's
-    // content. Edits to a published version land on a new draft version. The
-    // pricing settings sit on the collection's identity row instead and change
-    // only through `setting.pricing.update` (or `create`).
+    // An academy's collections - the academy's product (Bolbol API Plan.html
+    // 2.1), each answered with its identity (name, `signed`) and its latest
+    // version's content. A collection is created unsigned: until the academy
+    // has signed the contract the create writes (`contract.list` below; signed
+    // through the academy's own `contract.sign`), every write and every read
+    // below the identity answers 403 PRODUCT_NOT_SIGNED (P15) - `list`, `get`,
+    // `contract.list` and `delete` stay open. The name is edited in place on
+    // the identity; the notes and the series membership land on a draft
+    // version, forked when the latest is published (P3). A collection has no
+    // pricing settings (P13): its price is a pricing assignment
+    // (`pricingAssignment`), and the terms it offers educators and packagers
+    // are the contract templates on its four C slots (`contractTemplate`).
     collection = {
         // GET /academy/:academy_uid/collection - AcademyCollectionList
         list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection`),
-        // The pricing settings may ride along, so a collection can be priced
-        // as it is created.
+        // Writes the identity (`signed: false`), version 1 (a draft) and the one
+        // contract a collection requires - Bolbol_Collection_Commission_Owner,
+        // Bolbol's side already signed - in one transaction (plan 2.2 / 2.3),
+        // and answers the unsigned row. No pricing rides along (P13). Needs the
+        // academy's Collection authorization.
         // POST /academy/:academy_uid/collection - AcademyCollectionCreate
         create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection`, { body: request }),
+        // Open while unsigned: `item.signed` says whether a page shows the
+        // collection or only its contract panel.
         // GET /academy/:academy_uid/collection/:collection_uid - AcademyCollectionGet
         get: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`),
-        // language_id, exam_id and the pricing settings 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
+        // collection opens no draft. language_id and exam_id are fixed.
         // PUT /academy/:academy_uid/collection/:collection_uid - AcademyCollectionUpdate
         update: (academy_uid, collection_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`, { body: request }),
+        // Open while unsigned. The collection's contracts are kept: a contract
+        // is never deleted. No package pin refuses it (no COLLECTION_IN_USE -
+        // open, Bolbol API rules/Product.md "Open points"): a package that
+        // pins the collection keeps the pin, with `product.deleted: true`, and
+        // refuses its next publish (409 PACKAGE_PRODUCT_DELETED).
         // DELETE /academy/:academy_uid/collection/:collection_uid - AcademyCollectionDelete
         delete: (academy_uid, collection_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`),
         // Uploads a zipped Academy project and applies it declaratively onto
@@ -200,23 +353,15 @@ class BolbolAcademyScope {
         // calls the create/update controllers use (versioning preserved), uids
         // in the project but not on the server are created, uids on the server
         // but not in the project are soft-deleted. Only the academy project's
-        // folders are read: pricing/, collection/, series/, item/, asset/. The
+        // folders are read: pricing/, collection/, series/, item/, asset/. A
+        // collection it creates is unsigned, like one `create` makes, so its
+        // series, pricing assignments and template slots wait - logged as
+        // `deferred` - for an upload after the academy has signed it (P19). The
         // server unzips to a temp folder and deletes it on success or failure.
         // No timeout: the work grows with the project (a first upload creates
         // every entity).
         // POST /academy/:academy_uid/collection/upload - AcademyCollectionUpload
         upload: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/upload`, { body: request, timeoutMs: null }),
-        setting: {
-            // Which of the academy's pricings a user pays to take the
-            // collection and a teacher pays to license it, the two commission
-            // pricings, and the two percentages copied into the commission
-            // contracts. Only the fields sent change; writes the identity row
-            // (no draft fork) and answers the collection.
-            pricing: {
-                // PATCH /academy/:academy_uid/collection/:collection_uid/setting/pricing - AcademyCollectionUpdateSettingPricing
-                update: (academy_uid, collection_uid, request) => this.http.patch(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/setting/pricing`, { body: request }),
-            },
-        },
         // The preview's counts: students, skills, tasks, series and items, and
         // the distinct assets the latest version uses.
         // GET /academy/:academy_uid/collection/:collection_uid/count - AcademyCollectionCount
@@ -230,9 +375,33 @@ class BolbolAcademyScope {
         version: {
             // GET /academy/:academy_uid/collection/:collection_uid/version - AcademyCollectionVersionList
             list: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version`),
+            // The PUBLISHED versions of any collection that is not deleted -
+            // this academy's or another academy's - newest first, without the
+            // owning academy's `notes_private`: what the academy can build
+            // components and extensions on, as `teacher.collection.version.list`
+            // answers a teacher. `list` above answers every version of one of
+            // the academy's own collections, drafts included. Collections are
+            // found through the public `bolbol.collection.directory.list`.
+            // GET /academy/:academy_uid/collection/:collection_uid/version/published - AcademyCollectionPublishedVersionList
+            listPublished: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/published`),
+            // What one of those published versions reaches (decision N15): the
+            // exam, skill and task of every item it pins, each once - the list
+            // the component create judges a component's skill / task against
+            // (400 COMPONENT_SCOPE_NOT_IN_COLLECTION), so a form offers only
+            // what it accepts. Named by the version's own uid, as the
+            // component create's body names it; 404 / 400 for a version the
+            // create refuses.
+            // GET /academy/:academy_uid/collection-version/:collection_version_uid/reach - AcademyCollectionVersionReach
+            reach: (academy_uid, collection_version_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection-version/${encodeURIComponent(collection_version_uid)}/reach`),
+            // 403 ACADEMY_NOT_APPROVED until Bolbol has approved the academy
+            // (Approved or Premium) - drafts and uploads stay open meanwhile -
+            // and, like every write, 403 PRODUCT_NOT_SIGNED while the
+            // collection is unsigned (P15).
             // POST /academy/:academy_uid/collection/:collection_uid/version/publish - AcademyCollectionVersionPublish
             publish: (academy_uid, collection_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/publish`),
             // Drops the latest version, which must still be a draft.
+            // Discarding the only version takes the collection out of the list
+            // (its get answers 404 COLLECTION_VERSION_NO_LATEST).
             // DELETE /academy/:academy_uid/collection/:collection_uid/version/latest - AcademyCollectionVersionDelete
             deleteLast: (academy_uid, collection_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/latest`),
         },
@@ -263,12 +432,58 @@ class BolbolAcademyScope {
             // PUT /academy/:academy_uid/collection/:collection_uid/version/series/:series_uid - AcademyCollectionVersion_SeriesVersionReplace
             replace: (academy_uid, collection_uid, series_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series/${encodeURIComponent(series_uid)}`, { body: request }),
         },
+        // The contracts the collection requires - the ones its `signed` waits
+        // for. Open while the collection is unsigned, for the contract
+        // section; negotiating and signing one is `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/collection/:collection_uid/contract - AcademyCollectionContractList
+            list: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/contract`),
+        },
+        // The templates attached to the collection's four C slots: C1
+        // Academy_Collection_Licensing_Educator, C2
+        // Educator_Extension_Licensing_Academy and C3
+        // Educator_Collection_Commission_Academy, the terms an educator who
+        // extends the collection is offered (P11); C4
+        // Owner_Collection_Packaging_Packager, those a packager who bundles it
+        // is offered (P10). Both calls answer 403 PRODUCT_NOT_SIGNED while the
+        // collection is unsigned, the get included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /academy/:academy_uid/collection/:collection_uid/contract-template - AcademyCollectionContractTemplateGet
+            get: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/contract-template`),
+            // All four slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /academy/:academy_uid/collection/:collection_uid/contract-template - AcademyCollectionContractTemplateSet
+            set: (academy_uid, collection_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/contract-template`, { body: request }),
+        },
+        // The academy's pricings put on the collection, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Collection_Sell_User); with none in
+        // force the collection shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the collection is unsigned, the list
+        // included (P15).
+        pricingAssignment: {
+            // GET /academy/:academy_uid/collection/:collection_uid/pricing-assignment - AcademyCollectionPricingAssignmentList
+            list: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the collection.
+            // POST /academy/:academy_uid/collection/:collection_uid/pricing-assignment - AcademyCollectionPricingAssignmentCreate
+            create: (academy_uid, collection_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/collection/:collection_uid/pricing-assignment/:pricing_assignment_uid - AcademyCollectionPricingAssignmentUpdate
+            update: (academy_uid, collection_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/collection/:collection_uid/pricing-assignment/:pricing_assignment_uid - AcademyCollectionPricingAssignmentDelete
+            delete: (academy_uid, collection_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
     };
     // An academy's items, each answered with its latest version's content.
     // Edits to a published version land on a new draft version. An item is
     // the question only: how to learn it (mindsets, concepts, category values,
-    // annotations, vocabulary, answers, ambiguities) is teacher content on a
-    // published collection version (BolbolTeacherScope `component`).
+    // annotations, vocabulary, answers, ambiguities) is learning content built
+    // on a published collection version - an academy's `component` (below)
+    // or a teacher's (BolbolTeacherScope `component`).
     item = {
         // `exam_skill_id` / `exam_skill_task_id` narrow the list to the scope
         // the admin tree is opened at. Both omitted, the call returns the whole
@@ -396,8 +611,10 @@ class BolbolAcademyScope {
     };
     // The academy's pricings (Bolbol API rules/Pricing.md): named price lists,
     // each with one region per country plus at most one fallback region for
-    // every other country. A collection's pricing settings and the academy's
-    // membership setting each name one of them. Prices are whole eggs.
+    // every other country. A product's pricing assignments (the price it
+    // sells at, `<product>.pricingAssignment` - a collection's too, P13), a
+    // contract template's terms and the academy's membership setting each
+    // name one of them. Prices are whole eggs.
     pricing = {
         // `search` narrows by uid or name.
         // GET /academy/:academy_uid/pricing - AcademyPricingList
@@ -411,8 +628,9 @@ class BolbolAcademyScope {
         // Name and notes only; the regions have their own calls.
         // PUT /academy/:academy_uid/pricing/:pricing_uid - AcademyPricingUpdate
         update: (academy_uid, pricing_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/pricing/${encodeURIComponent(pricing_uid)}`, { body: request }),
-        // Soft delete. 409 PRICING_IN_USE while a collection's pricing setting
-        // or the academy's membership setting still names it.
+        // Soft delete. 409 PRICING_IN_USE while a live pricing assignment, a
+        // live contract template or the academy's membership setting still
+        // names it (P13).
         // DELETE /academy/:academy_uid/pricing/:pricing_uid - AcademyPricingDelete
         delete: (academy_uid, pricing_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/pricing/${encodeURIComponent(pricing_uid)}`),
         // A pricing's regions, addressed by their numeric `pricing_region_id`.
@@ -433,18 +651,1709 @@ class BolbolAcademyScope {
             delete: (academy_uid, pricing_uid, pricing_region_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/pricing/${encodeURIComponent(pricing_uid)}/region/${pricing_region_id}`),
         },
     };
-    // The contracts the academy is one end of (Bolbol API rules/Pricing.md):
-    // append-only price agreements the server writes itself - today when a
-    // teacher licenses one of the academy's collections or builds a package on
-    // it. Read-only: nothing here writes a contract.
+    // The contracts the academy is one end of - the twin of `teacher.contract`,
+    // same bodies and answers (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. The academy also
+    // owns the contracts its collections spawn on others' products: an
+    // educator's extension of one of them comes with the three Educator
+    // contracts (the collection's licence, the extension's licence, the
+    // commission on the collection - none when the academy extends its own
+    // collection, P11), and a package bundling one with its
+    // Owner_Collection_Packaging_Packager contract (P10). 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 academy produced or consumed,
-        // `type` to one contract type.
+        // Newest first. `role` narrows to the side the academy 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 /academy/:academy_uid/contract - AcademyContractList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract`, { query: request }),
-        // 403 unless the academy is one of the contract's two ends.
+        // 404 CONTRACT_NOT_FOUND; 403 CONTRACT_FORBIDDEN unless the academy
+        // is the contract's producer or its consumer. Readable in every state.
         // GET /academy/:academy_uid/contract/:contract_uid - AcademyContractGet
         get: (academy_uid, contract_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/contract/:contract_uid - AcademyContractUpdate
+        update: (academy_uid, contract_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}`, { body: request }),
+        // Signs the academy'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
+        // academy'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 academy's side is signed
+        // already, 409 CONTRACT_ALREADY_SIGNED once both are.
+        // POST /academy/:academy_uid/contract/:contract_uid/sign - AcademyContractSign
+        sign: (academy_uid, contract_uid) => this.http.post(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/contract/:contract_uid/message - AcademyContractMessageList
+            list: (academy_uid, contract_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}/message`, { query: request }),
+            // Posts from the academy'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 /academy/:academy_uid/contract/:contract_uid/message - AcademyContractMessageAdd
+            add: (academy_uid, contract_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}/message`, { body: request }),
+        },
+    };
+    // The academy's contract templates - the twin of
+    // `teacher.contractTemplate`, same bodies and answers (Bolbol API
+    // rules/Contract.md, P9): the terms the academy 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 academy sees. An
+    // academy defines twelve types: the eight Owner_*_Licensing_Packager /
+    // Owner_*_Packaging_Packager types of its extensions, materials, courses
+    // and events, its collections' Owner_Collection_Packaging_Packager, and
+    // the three Educator types an educator's extension of one of its
+    // collections signs (Academy_Collection_Licensing_Educator,
+    // Educator_Extension_Licensing_Academy,
+    // Educator_Collection_Commission_Academy); 400
+    // CONTRACT_TEMPLATE_TYPE_OWNER for any other type. A product attaches one
+    // per slot (`<product>.contractTemplate.set`, a collection's four through
+    // `collection.contractTemplate.set`), and each contract that slot spawns
+    // is written from it, owned by the academy, which 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 academy's live templates in name order. `type` narrows to one
+        // contract type (a slot's picker), `search` by uid or name.
+        // GET /academy/:academy_uid/contract-template - AcademyContractTemplateList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract-template`, { query: request }),
+        // A field left out takes the default terms. The type is immutable
+        // afterwards.
+        // POST /academy/:academy_uid/contract-template - AcademyContractTemplateCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/contract-template/:contract_template_uid - AcademyContractTemplateGet
+        get: (academy_uid, contract_template_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract-template/${encodeURIComponent(contract_template_uid)}`),
+        // Only the fields sent change (no `type`); reaches the contracts
+        // written after it only.
+        // PUT /academy/:academy_uid/contract-template/:contract_template_uid - AcademyContractTemplateUpdate
+        update: (academy_uid, contract_template_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/contract-template/:contract_template_uid - AcademyContractTemplateDelete
+        delete: (academy_uid, contract_template_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/contract-template/${encodeURIComponent(contract_template_uid)}`),
+    };
+    // The academy's learning kits - the twin of `teacher.learningKit`, same
+    // bodies and answers. A kit is the learning material authored for one
+    // exam, narrowed to one skill and one task of it or not (a null skill
+    // covers every skill of the exam, a null task every task of the skill) -
+    // annotation groups, category types and values, mindsets and concepts -
+    // that components (`component.learningKit.set`) and resources pick from.
+    // A kit is not versioned; its children are, each with its own draft /
+    // published versions like the academy's series and items. Each child
+    // carries its own skill and task, inside the kit's scope (the kit's when
+    // omitted at create).
+    learningKit = {
+        // Paged, oldest first; narrowed by exam / skill / task - by equality,
+        // or with `covering` to the kits whose scope covers the one target
+        // they name (a kit with no skill covers every skill of its exam) - or
+        // searched by uid and name.
+        // GET /academy/:academy_uid/learning-kit - AcademyLearningKitList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit`, { query: request }),
+        // The kit's exam, skill and task are fixed here; a task needs a skill
+        // (400 FIELD_REQUIRES).
+        // POST /academy/:academy_uid/learning-kit - AcademyLearningKitCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit`, { body: request }),
+        // GET /academy/:academy_uid/learning-kit/:learning_kit_uid - AcademyLearningKitGet
+        get: (academy_uid, learning_kit_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}`),
+        // The name and the notes; the exam, skill and task are immutable.
+        // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid - AcademyLearningKitUpdate
+        update: (academy_uid, learning_kit_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}`, { body: request }),
+        // 409 while a live component lists the kit.
+        // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid - AcademyLearningKitDelete
+        delete: (academy_uid, learning_kit_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}`),
+        // The kit's annotation groups (Vocabulary, Grammar, ...): defined once,
+        // picked for every annotation the academy's ref assets, ref items,
+        // answers and resources add.
+        annotationGroup: {
+            // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/annotation-group - AcademyAnnotationGroupList
+            list: (academy_uid, learning_kit_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
+            // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/annotation-group - AcademyAnnotationGroupCreate
+            create: (academy_uid, learning_kit_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group`, { body: request }),
+            // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid - AcademyAnnotationGroupUpdate
+            update: (academy_uid, learning_kit_uid, annotation_group_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}`, { body: request }),
+            // 409 while an annotation is still filed under the group.
+            // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid - AcademyAnnotationGroupDelete
+            delete: (academy_uid, learning_kit_uid, annotation_group_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}`),
+            // Versioning on the group itself - same shape as categoryType.
+            version: {
+                // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid/version - AcademyAnnotationGroupVersionList
+                list: (academy_uid, learning_kit_uid, annotation_group_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}/version`),
+                // Discards the unpublished draft (409 when the latest is published).
+                // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/annotation-group/:annotation_group_uid/version/latest - AcademyAnnotationGroupVersionDelete
+                deleteLast: (academy_uid, learning_kit_uid, annotation_group_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}/version/latest`),
+            },
+        },
+        // The kit's classification axes - for example "Tense". Each type
+        // carries its own values, which a RefItem_CategoryValue component tags
+        // items with.
+        categoryType: {
+            // Every type AND every value of the kit in one call, so a Console
+            // tab can draw its selects from a single round trip.
+            // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type - AcademyCategoryTypeList
+            list: (academy_uid, learning_kit_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
+            // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type - AcademyCategoryTypeCreate
+            create: (academy_uid, learning_kit_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type`, { body: request }),
+            // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid - AcademyCategoryTypeUpdate
+            update: (academy_uid, learning_kit_uid, category_type_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}`, { body: request }),
+            // Soft-deletes the type and every value under it.
+            // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid - AcademyCategoryTypeDelete
+            delete: (academy_uid, learning_kit_uid, category_type_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}`),
+            // Versioning on the type itself - same shape as collection and
+            // series.
+            version: {
+                // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/version - AcademyCategoryTypeVersionList
+                list: (academy_uid, learning_kit_uid, category_type_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/version`),
+                // Discards the unpublished draft (409 when the latest is published).
+                // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/version/latest - AcademyCategoryTypeVersionDelete
+                deleteLast: (academy_uid, learning_kit_uid, category_type_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/version/latest`),
+            },
+            value: {
+                // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value - AcademyCategoryValueList
+                list: (academy_uid, learning_kit_uid, category_type_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value`),
+                // Its skill and task default to the kit's, not its type's;
+                // given, they must lie inside the kit's scope (400
+                // LEARNING_KIT_SCOPE_MISMATCH).
+                // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value - AcademyCategoryValueCreate
+                create: (academy_uid, learning_kit_uid, category_type_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value`, { body: request }),
+                // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid - AcademyCategoryValueUpdate
+                update: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}`, { body: request }),
+                // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid - AcademyCategoryValueDelete
+                delete: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}`),
+                // Replaces the value's concepts (in order; `[]` clears them),
+                // pinning each at its latest version - concepts of the same kit
+                // only. On a published value it forks a draft first, like the
+                // vocabulary does.
+                // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/concept - AcademyCategoryValueUpdateConcepts
+                updateConcepts: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/concept`, { body: request }),
+                version: {
+                    // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/version - AcademyCategoryValueVersionList
+                    list: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/version`),
+                    // Discards the unpublished draft with its vocabulary and
+                    // concept pins (409 when the latest is published).
+                    // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/version/latest - AcademyCategoryValueVersionDelete
+                    deleteLast: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/version/latest`),
+                },
+                // The value's word list (package.category_value_vocabulary):
+                // one entry per sense, keyed by `sense_id`. Adding or removing
+                // an entry on a published value forks a new draft version.
+                vocabulary: {
+                    // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary - AcademyCategoryValueVocabularyList
+                    list: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary`),
+                    // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary - AcademyCategoryValueVocabularyAdd
+                    add: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary`, { body: request }),
+                    // Position in `sense_ids` IS the order.
+                    // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary/order - AcademyCategoryValueVocabularyReorder
+                    reorder: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary/order`, { body: request }),
+                    // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary/:sense_id - AcademyCategoryValueVocabularyRemove
+                    remove: (academy_uid, learning_kit_uid, category_type_uid, category_value_uid, sense_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary/${sense_id}`),
+                },
+            },
+        },
+        // The kit's mindsets: a situation ("Sport / outdoor activity") with
+        // the numbered topics worth asking about in it. Versioned like
+        // categoryType; a RefItem_Mindset component pins one version on a
+        // productive item.
+        mindset: {
+            // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset - AcademyMindsetList
+            list: (academy_uid, learning_kit_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset`),
+            // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid - AcademyMindsetGet
+            get: (academy_uid, learning_kit_uid, mindset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
+            // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset - AcademyMindsetCreate
+            create: (academy_uid, learning_kit_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset`, { body: request }),
+            // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid - AcademyMindsetUpdate
+            update: (academy_uid, learning_kit_uid, mindset_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}`, { body: request }),
+            // 409 while the latest version of a live ref item still pins it.
+            // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid - AcademyMindsetDelete
+            delete: (academy_uid, learning_kit_uid, mindset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}`),
+            // Versioning on the mindset itself - same shape as categoryType.
+            version: {
+                // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/version - AcademyMindsetVersionList
+                list: (academy_uid, learning_kit_uid, mindset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/version`),
+                // Discards the unpublished draft (409 when the latest is published,
+                // or when a ref item version pins it).
+                // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/version/latest - AcademyMindsetVersionDelete
+                deleteLast: (academy_uid, learning_kit_uid, mindset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/version/latest`),
+            },
+            // The mindset's numbered topics, on its latest version. A change to a
+            // published version forks a draft first, so every call answers the
+            // whole mindset (the topics' uids change with the fork).
+            topic: {
+                // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic - AcademyMindsetTopicAdd
+                add: (academy_uid, learning_kit_uid, mindset_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic`, { body: request }),
+                // Position in `topic_uids` IS the order.
+                // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic/order - AcademyMindsetTopicReorder
+                reorder: (academy_uid, learning_kit_uid, mindset_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/order`, { body: request }),
+                // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic/:topic_uid - AcademyMindsetTopicUpdate
+                update: (academy_uid, learning_kit_uid, mindset_uid, topic_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/${encodeURIComponent(topic_uid)}`, { body: request }),
+                // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/mindset/:mindset_uid/topic/:topic_uid - AcademyMindsetTopicRemove
+                remove: (academy_uid, learning_kit_uid, mindset_uid, topic_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/${encodeURIComponent(topic_uid)}`),
+            },
+        },
+        // The kit's concepts: an idea ("Giving an opinion") with its
+        // explanation and the numbered scenarios it applies in. Versioned like
+        // mindset; a RefItem_Concept component pins several on a productive
+        // item, one version each, and a category value can stand for some
+        // (`categoryType.value.updateConcepts`).
+        concept: {
+            // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/concept - AcademyConceptList
+            list: (academy_uid, learning_kit_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept`),
+            // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid - AcademyConceptGet
+            get: (academy_uid, learning_kit_uid, concept_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}`),
+            // Its skill and task default to the kit's; given, they must lie
+            // inside the kit's scope (400 LEARNING_KIT_SCOPE_MISMATCH).
+            // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/concept - AcademyConceptCreate
+            create: (academy_uid, learning_kit_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept`, { body: request }),
+            // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid - AcademyConceptUpdate
+            update: (academy_uid, learning_kit_uid, concept_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}`, { body: request }),
+            // 409 while the latest version of a live ref item, or a category
+            // value version, still pins it.
+            // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid - AcademyConceptDelete
+            delete: (academy_uid, learning_kit_uid, concept_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}`),
+            // Versioning on the concept itself - same shape as mindset.
+            version: {
+                // GET /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/version - AcademyConceptVersionList
+                list: (academy_uid, learning_kit_uid, concept_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/version`),
+                // Discards the unpublished draft (409 when the latest is published,
+                // or when a ref item version or a category value version pins it).
+                // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/version/latest - AcademyConceptVersionDelete
+                deleteLast: (academy_uid, learning_kit_uid, concept_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/version/latest`),
+            },
+            // The concept's numbered scenarios, on its latest version. A change to a
+            // published version forks a draft first, so every call answers the
+            // whole concept (the scenarios' uids change with the fork).
+            scenario: {
+                // POST /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario - AcademyConceptScenarioAdd
+                add: (academy_uid, learning_kit_uid, concept_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario`, { body: request }),
+                // Position in `scenario_uids` IS the order.
+                // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario/order - AcademyConceptScenarioReorder
+                reorder: (academy_uid, learning_kit_uid, concept_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/order`, { body: request }),
+                // PUT /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario/:scenario_uid - AcademyConceptScenarioUpdate
+                update: (academy_uid, learning_kit_uid, concept_uid, scenario_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/${encodeURIComponent(scenario_uid)}`, { body: request }),
+                // DELETE /academy/:academy_uid/learning-kit/:learning_kit_uid/concept/:concept_uid/scenario/:scenario_uid - AcademyConceptScenarioRemove
+                remove: (academy_uid, learning_kit_uid, concept_uid, scenario_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/learning-kit/${encodeURIComponent(learning_kit_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/${encodeURIComponent(scenario_uid)}`),
+            },
+        },
+    };
+    // The kits' material for one exam, across every kit of the academy - the
+    // twins of the teacher's per-exam lists (`teacher.annotationGroup.listAll`
+    // and its siblings), same queries and answers: what the Tools pages draw
+    // as one skill -> task tree for the exam they are opened at. Paged; each
+    // row names its kit (`learning_kit_uid`), through which it is created and
+    // edited (`learningKit.annotationGroup` and its siblings).
+    annotationGroup = {
+        // Every annotation group of the academy's kits for the exam.
+        // GET /academy/:academy_uid/annotation-group - AcademyAnnotationGroupListAll
+        listAll: (academy_uid, request) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/annotation-group`, { query: request }),
+    };
+    categoryType = {
+        // Every category type of the academy's kits for the exam - the types
+        // only; `categoryValue.listAll` lists their values.
+        // GET /academy/:academy_uid/category-type - AcademyCategoryTypeListAll
+        listAll: (academy_uid, request) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category-type`, { query: request }),
+    };
+    categoryValue = {
+        // Every category value of the academy's kits for the exam, each naming
+        // its type.
+        // GET /academy/:academy_uid/category-value - AcademyCategoryValueListAll
+        listAll: (academy_uid, request) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category-value`, { query: request }),
+    };
+    mindset = {
+        // Every mindset of the academy's kits for the exam, topics included.
+        // GET /academy/:academy_uid/mindset - AcademyMindsetListAll
+        listAll: (academy_uid, request) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/mindset`, { query: request }),
+    };
+    concept = {
+        // Every concept of the academy's kits for the exam, scenarios included.
+        // GET /academy/:academy_uid/concept - AcademyConceptListAll
+        listAll: (academy_uid, request) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/concept`, { query: request }),
+    };
+    // Concept versions by uid, as a learner is posed them - what a ref item's
+    // or a category value's `concept_version_uids` (or a concept's
+    // `version_uid`) point at. Only versions of concepts in this academy's
+    // kits come back.
+    conceptVersion = {
+        // GET /academy/:academy_uid/concept-version/preview - AcademyConceptVersionPreview
+        preview: (academy_uid, request) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/concept-version/preview`, { query: request }),
+    };
+    // The folders of the academy's resource library - the twin of
+    // `teacher.folder`, same bodies and answers: a tree of any depth the
+    // videos, podcasts, files and URLs are filed in, each folder headed by its
+    // main entity when it has one. Not versioned, and not language-scoped - one
+    // tree serves every language.
+    folder = {
+        // Flat and not paged: every folder of the academy (by parent, then
+        // order), or with `folder_uid` the direct sub-folders of one.
+        // GET /academy/:academy_uid/folder - AcademyFolderList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/folder`, { query: request }),
+        // POST /academy/:academy_uid/folder - AcademyFolderCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/folder`, { body: request }),
+        // The library as a ready-to-draw tree for one language: the loose
+        // resources first, then the root folders with their main entity,
+        // resources and sub-folders.
+        // GET /academy/:academy_uid/folder/tree - AcademyFolderTree
+        tree: (academy_uid, request) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/folder/tree`, { query: request }),
+        // Writes nothing but `sort_order`, on one parent's sub-folders.
+        // Position in `folder_uids` IS the order.
+        // PUT /academy/:academy_uid/folder/order - AcademyFolderReorder
+        reorder: (academy_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/folder/order`, { body: request }),
+        // GET /academy/:academy_uid/folder/:folder_uid - AcademyFolderGet
+        get: (academy_uid, folder_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/folder/${encodeURIComponent(folder_uid)}`),
+        // Every field as sent; `folder_uid` moves the folder (409 FOLDER_CYCLE
+        // under itself or one of its own sub-folders).
+        // PUT /academy/:academy_uid/folder/:folder_uid - AcademyFolderUpdate
+        update: (academy_uid, folder_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/folder/${encodeURIComponent(folder_uid)}`, { body: request }),
+        // Soft delete; 409 FOLDER_IN_USE while it still holds a live sub-folder
+        // or resource.
+        // DELETE /academy/:academy_uid/folder/:folder_uid - AcademyFolderDelete
+        delete: (academy_uid, folder_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/folder/${encodeURIComponent(folder_uid)}`),
+    };
+    // The academy's videos - the twin of `teacher.video`, same bodies and
+    // answers - an uploaded file or a YouTube link, one of the four kinds of
+    // resource in the library, with podcasts, files and URLs, filed in
+    // `folder`s. Each is in one language and carries a transcript, exam
+    // scopes, the category values and word list it teaches, and annotations
+    // on its transcript. Not versioned: every call writes in place. A
+    // material bundles them, each through a material resource
+    // (`material.resource`, P4).
+    video = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /academy/:academy_uid/video - AcademyVideoList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/video`, { query: request }),
+        // Needs the academy's Video authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/video - AcademyVideoCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/video`, { body: request }),
+        // GET /academy/:academy_uid/video/:video_uid - AcademyVideoGet
+        get: (academy_uid, video_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`);
+        // the type may change - a YouTube link replaced by an upload.
+        // PUT /academy/:academy_uid/video/:video_uid - AcademyVideoUpdate
+        update: (academy_uid, video_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
+        // DELETE /academy/:academy_uid/video/:video_uid - AcademyVideoDelete
+        delete: (academy_uid, video_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}`),
+        // The exams (and optionally skills and tasks) the video serves,
+        // replaced as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /academy/:academy_uid/video/:video_uid/scope - AcademyVideoScopeSet
+            set: (academy_uid, video_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/scope`, { body: request }),
+        },
+        // The category values the video is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /academy/:academy_uid/video/:video_uid/category-value - AcademyVideoCategoryValueSet
+            set: (academy_uid, video_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/category-value`, { body: request }),
+        },
+        // The video's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /academy/:academy_uid/video/:video_uid/vocabulary - AcademyVideoVocabularyList
+            list: (academy_uid, video_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /academy/:academy_uid/video/:video_uid/vocabulary - AcademyVideoVocabularyAdd
+            add: (academy_uid, video_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /academy/:academy_uid/video/:video_uid/vocabulary/order - AcademyVideoVocabularyReorder
+            reorder: (academy_uid, video_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /academy/:academy_uid/video/:video_uid/vocabulary/:lexema_id - AcademyVideoVocabularyRemove
+            remove: (academy_uid, video_uid, lexema_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the video's transcript, each filed under a group of one
+        // of the kits `learningKit.list` answers whose own skill / task covers
+        // one of the video's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /academy/:academy_uid/video/:video_uid/annotation - AcademyVideoAnnotationList
+            list: (academy_uid, video_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/annotation`),
+            // POST /academy/:academy_uid/video/:video_uid/annotation - AcademyVideoAnnotationAdd
+            add: (academy_uid, video_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/annotation`, { body: request }),
+            // PUT /academy/:academy_uid/video/:video_uid/annotation/:annotation_uid - AcademyVideoAnnotationUpdate
+            update: (academy_uid, video_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/video/:video_uid/annotation/:annotation_uid - AcademyVideoAnnotationRemove
+            remove: (academy_uid, video_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The academy's kits whose scope covers one of the video's scopes -
+            // what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /academy/:academy_uid/video/:video_uid/learning-kit - AcademyVideoLearningKitList
+            list: (academy_uid, video_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/learning-kit`),
+        },
+        // The uploaded video's bytes, not an envelope - for a player or a
+        // download: inline, or as an attachment with `download` when the video
+        // is downloadable (403 RESOURCE_NOT_DOWNLOADABLE otherwise). A YouTube
+        // video has nothing to stream here (400 VIDEO_TYPE_FIELDS).
+        // GET /academy/:academy_uid/video/:video_uid/stream - AcademyVideoStream
+        stream: (academy_uid, video_uid, request = {}) => this.http.blob(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}/stream`, { query: request }),
+    };
+    // The academy's podcasts - uploaded audio episodes - in the resource
+    // library, shaped and served like `video`; the twin of `teacher.podcast`.
+    podcast = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /academy/:academy_uid/podcast - AcademyPodcastList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/podcast`, { query: request }),
+        // Needs the academy's Podcast authorization (403 AUTHORIZATION_REQUIRED
+        // / AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/podcast - AcademyPodcastCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/podcast`, { body: request }),
+        // GET /academy/:academy_uid/podcast/:podcast_uid - AcademyPodcastGet
+        get: (academy_uid, podcast_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`);
+        // the episode's file is replaced only when one is sent.
+        // PUT /academy/:academy_uid/podcast/:podcast_uid - AcademyPodcastUpdate
+        update: (academy_uid, podcast_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
+        // DELETE /academy/:academy_uid/podcast/:podcast_uid - AcademyPodcastDelete
+        delete: (academy_uid, podcast_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}`),
+        // The exams (and optionally skills and tasks) the podcast serves,
+        // replaced as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /academy/:academy_uid/podcast/:podcast_uid/scope - AcademyPodcastScopeSet
+            set: (academy_uid, podcast_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/scope`, { body: request }),
+        },
+        // The category values the podcast is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /academy/:academy_uid/podcast/:podcast_uid/category-value - AcademyPodcastCategoryValueSet
+            set: (academy_uid, podcast_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/category-value`, { body: request }),
+        },
+        // The podcast's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /academy/:academy_uid/podcast/:podcast_uid/vocabulary - AcademyPodcastVocabularyList
+            list: (academy_uid, podcast_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /academy/:academy_uid/podcast/:podcast_uid/vocabulary - AcademyPodcastVocabularyAdd
+            add: (academy_uid, podcast_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /academy/:academy_uid/podcast/:podcast_uid/vocabulary/order - AcademyPodcastVocabularyReorder
+            reorder: (academy_uid, podcast_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /academy/:academy_uid/podcast/:podcast_uid/vocabulary/:lexema_id - AcademyPodcastVocabularyRemove
+            remove: (academy_uid, podcast_uid, lexema_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the podcast's transcript, each filed under a group of
+        // one of the kits `learningKit.list` answers whose own skill / task
+        // covers one of the podcast's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /academy/:academy_uid/podcast/:podcast_uid/annotation - AcademyPodcastAnnotationList
+            list: (academy_uid, podcast_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation`),
+            // POST /academy/:academy_uid/podcast/:podcast_uid/annotation - AcademyPodcastAnnotationAdd
+            add: (academy_uid, podcast_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation`, { body: request }),
+            // PUT /academy/:academy_uid/podcast/:podcast_uid/annotation/:annotation_uid - AcademyPodcastAnnotationUpdate
+            update: (academy_uid, podcast_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/podcast/:podcast_uid/annotation/:annotation_uid - AcademyPodcastAnnotationRemove
+            remove: (academy_uid, podcast_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The academy's kits whose scope covers one of the podcast's scopes
+            // - what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /academy/:academy_uid/podcast/:podcast_uid/learning-kit - AcademyPodcastLearningKitList
+            list: (academy_uid, podcast_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/learning-kit`),
+        },
+        // The episode's bytes, not an envelope - for a player or a download:
+        // inline, or as an attachment with `download` when the podcast is
+        // downloadable (403 RESOURCE_NOT_DOWNLOADABLE otherwise).
+        // GET /academy/:academy_uid/podcast/:podcast_uid/stream - AcademyPodcastStream
+        stream: (academy_uid, podcast_uid, request = {}) => this.http.blob(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}/stream`, { query: request }),
+    };
+    // The academy's files - uploaded documents such as PDFs - in the resource
+    // library, shaped and served like `video`; the twin of `teacher.file`.
+    // Only a PDF may be made non-downloadable; it is then shown in a viewer,
+    // not as a link.
+    file = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /academy/:academy_uid/file - AcademyFileList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/file`, { query: request }),
+        // Needs the academy's File authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/file - AcademyFileCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/file`, { body: request }),
+        // GET /academy/:academy_uid/file/:file_uid - AcademyFileGet
+        get: (academy_uid, file_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`).
+        // PUT /academy/:academy_uid/file/:file_uid - AcademyFileUpdate
+        update: (academy_uid, file_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
+        // DELETE /academy/:academy_uid/file/:file_uid - AcademyFileDelete
+        delete: (academy_uid, file_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}`),
+        // The exams (and optionally skills and tasks) the file serves, replaced
+        // as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /academy/:academy_uid/file/:file_uid/scope - AcademyFileScopeSet
+            set: (academy_uid, file_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/scope`, { body: request }),
+        },
+        // The category values the file is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /academy/:academy_uid/file/:file_uid/category-value - AcademyFileCategoryValueSet
+            set: (academy_uid, file_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/category-value`, { body: request }),
+        },
+        // The file's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /academy/:academy_uid/file/:file_uid/vocabulary - AcademyFileVocabularyList
+            list: (academy_uid, file_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /academy/:academy_uid/file/:file_uid/vocabulary - AcademyFileVocabularyAdd
+            add: (academy_uid, file_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /academy/:academy_uid/file/:file_uid/vocabulary/order - AcademyFileVocabularyReorder
+            reorder: (academy_uid, file_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /academy/:academy_uid/file/:file_uid/vocabulary/:lexema_id - AcademyFileVocabularyRemove
+            remove: (academy_uid, file_uid, lexema_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the file's transcript, each filed under a group of one
+        // of the kits `learningKit.list` answers whose own skill / task covers
+        // one of the file's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /academy/:academy_uid/file/:file_uid/annotation - AcademyFileAnnotationList
+            list: (academy_uid, file_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/annotation`),
+            // POST /academy/:academy_uid/file/:file_uid/annotation - AcademyFileAnnotationAdd
+            add: (academy_uid, file_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/annotation`, { body: request }),
+            // PUT /academy/:academy_uid/file/:file_uid/annotation/:annotation_uid - AcademyFileAnnotationUpdate
+            update: (academy_uid, file_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/file/:file_uid/annotation/:annotation_uid - AcademyFileAnnotationRemove
+            remove: (academy_uid, file_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The academy's kits whose scope covers one of the file's scopes -
+            // what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /academy/:academy_uid/file/:file_uid/learning-kit - AcademyFileLearningKitList
+            list: (academy_uid, file_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/learning-kit`),
+        },
+        // The file's bytes, not an envelope - for a viewer or a download:
+        // inline (what a PDF viewer loads, even for a file that may not be
+        // downloaded), or as an attachment with `download` when the file is
+        // downloadable (403 RESOURCE_NOT_DOWNLOADABLE otherwise).
+        // GET /academy/:academy_uid/file/:file_uid/stream - AcademyFileStream
+        stream: (academy_uid, file_uid, request = {}) => this.http.blob(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}/stream`, { query: request }),
+    };
+    // The academy's URLs - links to pages on the web - in the resource library,
+    // shaped like `video` but with nothing to stream: the page is opened at its
+    // `url`. The twin of `teacher.url`.
+    url = {
+        // Paged; narrowed by language, folder, exam / skill / task, or searched
+        // by uid and name.
+        // GET /academy/:academy_uid/url - AcademyUrlList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/url`, { query: request }),
+        // Needs the academy's Url authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/url - AcademyUrlCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/url`, { body: request }),
+        // GET /academy/:academy_uid/url/:url_uid - AcademyUrlGet
+        get: (academy_uid, url_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}`),
+        // Every field but the language (fixed) and the scopes (`scope.set`).
+        // PUT /academy/:academy_uid/url/:url_uid - AcademyUrlUpdate
+        update: (academy_uid, url_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}`, { body: request }),
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
+        // DELETE /academy/:academy_uid/url/:url_uid - AcademyUrlDelete
+        delete: (academy_uid, url_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}`),
+        // The exams (and optionally skills and tasks) the URL serves, replaced
+        // as a whole - what `learningKit.list` matches kits against.
+        scope: {
+            // PUT /academy/:academy_uid/url/:url_uid/scope - AcademyUrlScopeSet
+            set: (academy_uid, url_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/scope`, { body: request }),
+        },
+        // The category values the URL is tagged with, replaced as a whole -
+        // values of the kits `learningKit.list` answers.
+        categoryValue: {
+            // PUT /academy/:academy_uid/url/:url_uid/category-value - AcademyUrlCategoryValueSet
+            set: (academy_uid, url_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/category-value`, { body: request }),
+        },
+        // The URL's word list - the same calls as a ref item's, written in
+        // place. An entry is addressed by its `lexema_id`: a lexema appears at
+        // most once per list.
+        vocabulary: {
+            // Entries in order.
+            // GET /academy/:academy_uid/url/:url_uid/vocabulary - AcademyUrlVocabularyList
+            list: (academy_uid, url_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary`),
+            // A new entry lands at the end of the list; 409
+            // VOCABULARY_DUPLICATE when the lexema is already listed.
+            // POST /academy/:academy_uid/url/:url_uid/vocabulary - AcademyUrlVocabularyAdd
+            add: (academy_uid, url_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary`, { body: request }),
+            // Position in `lexema_ids` IS the order.
+            // PUT /academy/:academy_uid/url/:url_uid/vocabulary/order - AcademyUrlVocabularyReorder
+            reorder: (academy_uid, url_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary/order`, { body: request }),
+            // Drops the entry only; the lexema and its senses are shared
+            // catalog rows.
+            // DELETE /academy/:academy_uid/url/:url_uid/vocabulary/:lexema_id - AcademyUrlVocabularyRemove
+            remove: (academy_uid, url_uid, lexema_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/vocabulary/${lexema_id}`),
+        },
+        // Selections on the URL's transcript, each filed under a group of one
+        // of the kits `learningKit.list` answers whose own skill / task covers
+        // one of the URL's scopes. Written in place; an edit of the
+        // transcript carries them along.
+        annotation: {
+            // GET /academy/:academy_uid/url/:url_uid/annotation - AcademyUrlAnnotationList
+            list: (academy_uid, url_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/annotation`),
+            // POST /academy/:academy_uid/url/:url_uid/annotation - AcademyUrlAnnotationAdd
+            add: (academy_uid, url_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/annotation`, { body: request }),
+            // PUT /academy/:academy_uid/url/:url_uid/annotation/:annotation_uid - AcademyUrlAnnotationUpdate
+            update: (academy_uid, url_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/url/:url_uid/annotation/:annotation_uid - AcademyUrlAnnotationRemove
+            remove: (academy_uid, url_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
+        learningKit: {
+            // The academy's kits whose scope covers one of the URL's scopes -
+            // what its category value and annotation group pickers start
+            // from; a value or group of one of them applies only when its own
+            // skill / task covers one of those scopes too.
+            // GET /academy/:academy_uid/url/:url_uid/learning-kit - AcademyUrlLearningKitList
+            list: (academy_uid, url_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}/learning-kit`),
+        },
+    };
+    // The academy's components - the twin of `teacher.component`, same bodies
+    // and answers. A component is one learning action built over ONE
+    // published collection version - one of this academy's collections or
+    // another academy's (D13) - and every component is on one: a bundle of
+    // the academy's library resources is a material now (`material`, P4).
+    // Its type (fixed at create, like the collection version and the exam /
+    // skill / task) says which kind of child it holds - ref assets, ref
+    // items, answers or ambiguities - and which of their fields it fills
+    // (ComponentTypeEnum). The children's endpoints nest under it, as their
+    // URLs do. Every write to a component (but its kit list, kept on the
+    // identity) or to a child lands on a draft, forking one when the latest
+    // version is published; nothing here publishes - publishing 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 academy comes back.
+        // GET /academy/:academy_uid/component - AcademyComponentList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component`, { query: request }),
+        // Creates the component and its version 1 (a draft) on the published
+        // collection version the body names - of its own collection or of
+        // another academy's - which fixes its exam. Signs no contract on any
+        // collection: the contracts of building on another academy's
+        // collection belong to the extension, whose create spawns them (P11).
+        // Needs the academy's Extension authorization alone - the one kind
+        // for extensions and components (P16) - else 403
+        // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED.
+        // POST /academy/:academy_uid/component - AcademyComponentCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component`, { body: request }),
+        // GET /academy/:academy_uid/component/:component_uid - AcademyComponentGet
+        get: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}`),
+        // Name and notes only - the collection version, the scope and the
+        // type are fixed.
+        // PUT /academy/:academy_uid/component/:component_uid - AcademyComponentUpdate
+        update: (academy_uid, component_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}`, { body: request }),
+        // Soft delete; 409 COMPONENT_IN_USE while a published extension
+        // version pins the component. The extension drafts that list it drop
+        // it.
+        // DELETE /academy/:academy_uid/component/:component_uid - AcademyComponentDelete
+        delete: (academy_uid, component_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}`),
+        version: {
+            // GET /academy/:academy_uid/component/:component_uid/version - AcademyComponentVersionList
+            list: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/version`),
+            // Drops the latest version, which must still be a draft, and
+            // reverts the children it pinned to what the previous version pins.
+            // DELETE /academy/:academy_uid/component/:component_uid/version/latest - AcademyComponentVersionDelete
+            deleteLast: (academy_uid, component_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/version/latest`),
+        },
+        // Which of the academy's learning kits feed the component's pickers
+        // (annotation groups, category values, mindsets, concepts). Kept on
+        // the identity: setting them forks no draft.
+        learningKit: {
+            // GET /academy/:academy_uid/component/:component_uid/learning-kit - AcademyComponentLearningKitList
+            list: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/learning-kit`),
+            // Replaces the whole set and answers it the way `list` does.
+            // PUT /academy/:academy_uid/component/:component_uid/learning-kit - AcademyComponentLearningKitSet
+            set: (academy_uid, component_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/learning-kit`, { body: request }),
+        },
+        hierarchy: {
+            // The collection version's skill -> task -> series -> item tree
+            // (plus each task's assets), every row carrying the component's
+            // ref row, its state and the sheet value.
+            // GET /academy/:academy_uid/component/:component_uid/hierarchy - AcademyComponentHierarchy
+            get: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/hierarchy`),
+        },
+        preview: {
+            // The component's content as it would be shown - for the owner's
+            // preview tab and the Academy Application's dev preview.
+            // GET /academy/:academy_uid/component/:component_uid/preview - AcademyComponentPreview
+            get: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/preview`),
+        },
+        // A RefAsset_* component's ref assets: what it adds to each asset its
+        // collection version reaches, at most one per asset.
+        refAsset: {
+            // GET /academy/:academy_uid/component/:component_uid/ref-asset - AcademyRefAssetList
+            list: (academy_uid, component_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset`, { query: request }),
+            // Gets the component's ref asset on the asset, creating it (version
+            // 1, a draft) when there is none; the asset must be reached by the
+            // component's collection version. Takes no body.
+            // PUT /academy/:academy_uid/component/:component_uid/ref-asset/asset/:asset_uid - AcademyRefAssetUpsertByAsset
+            upsertByAsset: (academy_uid, component_uid, asset_uid) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/asset/${encodeURIComponent(asset_uid)}`),
+            // GET /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid - AcademyRefAssetGet
+            get: (academy_uid, component_uid, ref_asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}`),
+            // The translation overlay - RefAsset_Translation only.
+            // PUT /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid - AcademyRefAssetUpdate
+            update: (academy_uid, component_uid, ref_asset_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid - AcademyRefAssetDelete
+            delete: (academy_uid, component_uid, ref_asset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}`),
+            version: {
+                // GET /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/version - AcademyRefAssetVersionList
+                list: (academy_uid, component_uid, ref_asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/version/latest - AcademyRefAssetVersionDelete
+                deleteLast: (academy_uid, component_uid, ref_asset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/version/latest`),
+            },
+            // RefAsset_Annotation only: selections on the pinned asset
+            // version's texts, each filed under a group of the component's kits.
+            annotation: {
+                // GET /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation - AcademyRefAssetAnnotationList
+                list: (academy_uid, component_uid, ref_asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation`),
+                // POST /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation - AcademyRefAssetAnnotationAdd
+                add: (academy_uid, component_uid, ref_asset_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation`, { body: request }),
+                // PUT /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation/:annotation_uid - AcademyRefAssetAnnotationUpdate
+                update: (academy_uid, component_uid, ref_asset_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+                // DELETE /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/annotation/:annotation_uid - AcademyRefAssetAnnotationRemove
+                remove: (academy_uid, component_uid, ref_asset_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+            },
+            // RefAsset_Vocabulary only. An entry is addressed by its
+            // `lexema_id`: a lexema appears at most once per list.
+            vocabulary: {
+                // Entries in order.
+                // GET /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary - AcademyRefAssetVocabularyList
+                list: (academy_uid, component_uid, ref_asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/vocabulary`),
+                // A new entry lands at the end of the list; 409
+                // VOCABULARY_DUPLICATE when the lexema is already listed.
+                // POST /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary - AcademyRefAssetVocabularyAdd
+                add: (academy_uid, component_uid, ref_asset_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/vocabulary`, { body: request }),
+                // Position in `lexema_ids` IS the order.
+                // PUT /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary/order - AcademyRefAssetVocabularyReorder
+                reorder: (academy_uid, component_uid, ref_asset_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/vocabulary/order`, { body: request }),
+                // Drops the entry only; the lexema and its senses are shared
+                // catalog rows.
+                // DELETE /academy/:academy_uid/component/:component_uid/ref-asset/:ref_asset_uid/vocabulary/:lexema_id - AcademyRefAssetVocabularyRemove
+                remove: (academy_uid, component_uid, ref_asset_uid, lexema_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-asset/${encodeURIComponent(ref_asset_uid)}/vocabulary/${lexema_id}`),
+            },
+        },
+        // A RefItem_* component's ref items: what it adds to each item its
+        // collection version pins, at most one per item.
+        refItem: {
+            // GET /academy/:academy_uid/component/:component_uid/ref-item - AcademyRefItemList
+            list: (academy_uid, component_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item`, { query: request }),
+            // Gets the component's ref item on the item, creating it (version
+            // 1, a draft) when there is none, and writes the sheet value sent
+            // (rank / mindset / category values) in the same call - what one
+            // sheet cell saves. `{}` only gets or creates it.
+            // PUT /academy/:academy_uid/component/:component_uid/ref-item/item/:item_uid - AcademyRefItemUpsertByItem
+            upsertByItem: (academy_uid, component_uid, item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/item/${encodeURIComponent(item_uid)}`, { body: request }),
+            // GET /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid - AcademyRefItemGet
+            get: (academy_uid, component_uid, ref_item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}`),
+            // Scoped by the component's type: only its group's fields may be
+            // sent (400 COMPONENT_TYPE_SCOPE otherwise).
+            // PUT /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid - AcademyRefItemUpdate
+            update: (academy_uid, component_uid, ref_item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid - AcademyRefItemDelete
+            delete: (academy_uid, component_uid, ref_item_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}`),
+            version: {
+                // GET /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/version - AcademyRefItemVersionList
+                list: (academy_uid, component_uid, ref_item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/version/latest - AcademyRefItemVersionDelete
+                deleteLast: (academy_uid, component_uid, ref_item_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/version/latest`),
+            },
+            // RefItem_Annotation only: selections on the pinned item version's
+            // texts, each filed under a group of the component's kits.
+            annotation: {
+                // GET /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/annotation - AcademyRefItemAnnotationList
+                list: (academy_uid, component_uid, ref_item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation`),
+                // POST /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/annotation - AcademyRefItemAnnotationAdd
+                add: (academy_uid, component_uid, ref_item_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation`, { body: request }),
+                // PUT /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/annotation/:annotation_uid - AcademyRefItemAnnotationUpdate
+                update: (academy_uid, component_uid, ref_item_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+                // DELETE /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/annotation/:annotation_uid - AcademyRefItemAnnotationRemove
+                remove: (academy_uid, component_uid, ref_item_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+            },
+            // RefItem_Vocabulary only. An entry is addressed by its
+            // `lexema_id`: a lexema appears at most once per list.
+            vocabulary: {
+                // Entries in order.
+                // GET /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/vocabulary - AcademyRefItemVocabularyList
+                list: (academy_uid, component_uid, ref_item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/vocabulary`),
+                // A new entry lands at the end of the list; 409
+                // VOCABULARY_DUPLICATE when the lexema is already listed.
+                // POST /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/vocabulary - AcademyRefItemVocabularyAdd
+                add: (academy_uid, component_uid, ref_item_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/vocabulary`, { body: request }),
+                // Position in `lexema_ids` IS the order.
+                // PUT /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/vocabulary/order - AcademyRefItemVocabularyReorder
+                reorder: (academy_uid, component_uid, ref_item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/vocabulary/order`, { body: request }),
+                // Drops the entry only; the lexema and its senses are shared
+                // catalog rows.
+                // DELETE /academy/:academy_uid/component/:component_uid/ref-item/:ref_item_uid/vocabulary/:lexema_id - AcademyRefItemVocabularyRemove
+                remove: (academy_uid, component_uid, ref_item_uid, lexema_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-item/${encodeURIComponent(ref_item_uid)}/vocabulary/${lexema_id}`),
+            },
+        },
+        // An Answer component's sample answers, each written for one
+        // productive item its collection version pins.
+        answer: {
+            // Paged, in the collection version's item order, then `sort_order`.
+            // GET /academy/:academy_uid/component/:component_uid/answer - AcademyAnswerList
+            list: (academy_uid, component_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer`, { query: request }),
+            // POST /academy/:academy_uid/component/:component_uid/answer - AcademyAnswerCreate
+            create: (academy_uid, component_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer`, { body: request }),
+            // GET /academy/:academy_uid/component/:component_uid/answer/:answer_uid - AcademyAnswerGet
+            get: (academy_uid, component_uid, answer_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}`),
+            // `structures` replaces the answer's list (stored `structure_uid`s
+            // are edited in place).
+            // PUT /academy/:academy_uid/component/:component_uid/answer/:answer_uid - AcademyAnswerUpdate
+            update: (academy_uid, component_uid, answer_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/component/:component_uid/answer/:answer_uid - AcademyAnswerDelete
+            delete: (academy_uid, component_uid, answer_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}`),
+            version: {
+                // GET /academy/:academy_uid/component/:component_uid/answer/:answer_uid/version - AcademyAnswerVersionList
+                list: (academy_uid, component_uid, answer_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /academy/:academy_uid/component/:component_uid/answer/:answer_uid/version/latest - AcademyAnswerVersionDelete
+                deleteLast: (academy_uid, component_uid, answer_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/version/latest`),
+            },
+            // Selections on the answer's structures' texts, each filed under a
+            // group of the component's kits.
+            annotation: {
+                // GET /academy/:academy_uid/component/:component_uid/answer/:answer_uid/annotation - AcademyAnswerAnnotationList
+                list: (academy_uid, component_uid, answer_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation`),
+                // POST /academy/:academy_uid/component/:component_uid/answer/:answer_uid/annotation - AcademyAnswerAnnotationAdd
+                add: (academy_uid, component_uid, answer_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation`, { body: request }),
+                // PUT /academy/:academy_uid/component/:component_uid/answer/:answer_uid/annotation/:annotation_uid - AcademyAnswerAnnotationUpdate
+                update: (academy_uid, component_uid, answer_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+                // DELETE /academy/:academy_uid/component/:component_uid/answer/:answer_uid/annotation/:annotation_uid - AcademyAnswerAnnotationRemove
+                remove: (academy_uid, component_uid, answer_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+            },
+            // The answer's word list. An entry is addressed by its
+            // `lexema_id`: a lexema appears at most once per list.
+            vocabulary: {
+                // Entries in order.
+                // GET /academy/:academy_uid/component/:component_uid/answer/:answer_uid/vocabulary - AcademyAnswerVocabularyList
+                list: (academy_uid, component_uid, answer_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/vocabulary`),
+                // A new entry lands at the end of the list; 409
+                // VOCABULARY_DUPLICATE when the lexema is already listed.
+                // POST /academy/:academy_uid/component/:component_uid/answer/:answer_uid/vocabulary - AcademyAnswerVocabularyAdd
+                add: (academy_uid, component_uid, answer_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/vocabulary`, { body: request }),
+                // Position in `lexema_ids` IS the order.
+                // PUT /academy/:academy_uid/component/:component_uid/answer/:answer_uid/vocabulary/order - AcademyAnswerVocabularyReorder
+                reorder: (academy_uid, component_uid, answer_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/vocabulary/order`, { body: request }),
+                // Drops the entry only; the lexema and its senses are shared
+                // catalog rows.
+                // DELETE /academy/:academy_uid/component/:component_uid/answer/:answer_uid/vocabulary/:lexema_id - AcademyAnswerVocabularyRemove
+                remove: (academy_uid, component_uid, answer_uid, lexema_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/answer/${encodeURIComponent(answer_uid)}/vocabulary/${lexema_id}`),
+            },
+        },
+        // An Ambiguity component's ambiguities, each named in one item its
+        // collection version pins.
+        ambiguity: {
+            // Paged, in the collection version's item order, then `sort_order`.
+            // GET /academy/:academy_uid/component/:component_uid/ambiguity - AcademyAmbiguityList
+            list: (academy_uid, component_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity`, { query: request }),
+            // POST /academy/:academy_uid/component/:component_uid/ambiguity - AcademyAmbiguityCreate
+            create: (academy_uid, component_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity`, { body: request }),
+            // GET /academy/:academy_uid/component/:component_uid/ambiguity/:ambiguity_uid - AcademyAmbiguityGet
+            get: (academy_uid, component_uid, ambiguity_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`),
+            // The item and the type are fixed.
+            // PUT /academy/:academy_uid/component/:component_uid/ambiguity/:ambiguity_uid - AcademyAmbiguityUpdate
+            update: (academy_uid, component_uid, ambiguity_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/component/:component_uid/ambiguity/:ambiguity_uid - AcademyAmbiguityDelete
+            delete: (academy_uid, component_uid, ambiguity_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`),
+            version: {
+                // GET /academy/:academy_uid/component/:component_uid/ambiguity/:ambiguity_uid/version - AcademyAmbiguityVersionList
+                list: (academy_uid, component_uid, ambiguity_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /academy/:academy_uid/component/:component_uid/ambiguity/:ambiguity_uid/version/latest - AcademyAmbiguityVersionDelete
+                deleteLast: (academy_uid, component_uid, ambiguity_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}/version/latest`),
+            },
+        },
+    };
+    // The academy's extensions - the twin of `teacher.extension`, same bodies
+    // and answers: versioned sets of the academy's components, each built on
+    // one published collection version - of its own collection or of another
+    // approved academy's (D13) - 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, on another academy's collection, that collection's three educator
+    // contracts wait for their signatures (P11; on its own collection the
+    // academy signs no collection contract) - 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 academy
+        // comes back, unsigned ones included. Paged, oldest first: an extension
+        // has no skill / task of its own.
+        // GET /academy/:academy_uid/extension - AcademyExtensionList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension`, { query: request }),
+        // Writes the identity, version 1 and every contract the extension
+        // requires in one transaction: Bolbol's commission and, on another
+        // academy's collection, that collection's three educator contracts on
+        // the terms of the templates its academy attached (P11) - on its own
+        // collection, Bolbol's commission alone. Answers it with
+        // `signed: false`.
+        // POST /academy/:academy_uid/extension - AcademyExtensionCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/extension`, { body: request }),
+        // Open while the extension is unsigned (P15).
+        // GET /academy/:academy_uid/extension/:extension_uid - AcademyExtensionGet
+        get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid - AcademyExtensionUpdate
+        update: (academy_uid, extension_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid - AcademyExtensionDelete
+        delete: (academy_uid, extension_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid/count - AcademyExtensionCount
+        count: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/count`),
+        version: {
+            // GET /academy/:academy_uid/extension/:extension_uid/version - AcademyExtensionVersionList
+            list: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid/version/publish - AcademyExtensionVersionPublish
+            publish: (academy_uid, extension_uid) => this.http.post(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid/version/latest - AcademyExtensionVersionDelete
+            deleteLast: (academy_uid, extension_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid/version/component - AcademyExtensionVersion_ComponentVersionList
+            list: (academy_uid, extension_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component`, { query: request }),
+            // The component must be built on the extension's collection version.
+            // POST /academy/:academy_uid/extension/:extension_uid/version/component - AcademyExtensionVersion_ComponentVersionAdd
+            add: (academy_uid, extension_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component`, { body: request }),
+            // DELETE /academy/:academy_uid/extension/:extension_uid/version/component/:component_uid - AcademyExtensionVersion_ComponentVersionRemove
+            remove: (academy_uid, extension_uid, component_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/${encodeURIComponent(component_uid)}`),
+            // Writes nothing but `sort_order`. Position in `component_uids` IS the order.
+            // PUT /academy/:academy_uid/extension/:extension_uid/version/component/order - AcademyExtensionVersion_ComponentVersionReorder
+            reorder: (academy_uid, extension_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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
+            // academy.component.version.list).
+            // PUT /academy/:academy_uid/extension/:extension_uid/version/component/:component_uid - AcademyExtensionVersion_ComponentVersionReplace
+            replace: (academy_uid, extension_uid, component_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/${encodeURIComponent(component_uid)}`, { body: request }),
+        },
+        hierarchy: {
+            // extension -> components -> children, at the latest version's pins.
+            // GET /academy/:academy_uid/extension/:extension_uid/hierarchy - AcademyExtensionHierarchy
+            get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid/preview - AcademyExtensionPreview
+            get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/extension/:extension_uid/contract - AcademyExtensionContractList
+            list: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid/contract-template - AcademyExtensionContractTemplateGet
+            get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/extension/:extension_uid/contract-template - AcademyExtensionContractTemplateSet
+            set: (academy_uid, extension_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/contract-template`, { body: request }),
+        },
+        // The academy'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 /academy/:academy_uid/extension/:extension_uid/pricing-assignment - AcademyExtensionPricingAssignmentList
+            list: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the extension.
+            // POST /academy/:academy_uid/extension/:extension_uid/pricing-assignment - AcademyExtensionPricingAssignmentCreate
+            create: (academy_uid, extension_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/extension/:extension_uid/pricing-assignment/:pricing_assignment_uid - AcademyExtensionPricingAssignmentUpdate
+            update: (academy_uid, extension_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/extension/:extension_uid/pricing-assignment/:pricing_assignment_uid - AcademyExtensionPricingAssignmentDelete
+            delete: (academy_uid, extension_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The academy's materials (P4) - the twin of `teacher.material`, same
+    // bodies and answers: what the Resource component was, made a product of
+    // its own - a versioned bundle of the academy'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
+    // academy'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 academy comes back. Paged, oldest first.
+        // GET /academy/:academy_uid/material - AcademyMaterialList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_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
+        // academy signs that contract too.
+        // POST /academy/:academy_uid/material - AcademyMaterialCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material`, { body: request }),
+        // Readable while unsigned.
+        // GET /academy/:academy_uid/material/:material_uid - AcademyMaterialGet
+        get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid - AcademyMaterialUpdate
+        update: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid - AcademyMaterialDelete
+        delete: (academy_uid, material_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/scope - AcademyMaterialScopeSet
+            set: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/count - AcademyMaterialCount
+        count: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/count`),
+        version: {
+            // GET /academy/:academy_uid/material/:material_uid/version - AcademyMaterialVersionList
+            list: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/version/publish - AcademyMaterialVersionPublish
+            publish: (academy_uid, material_uid) => this.http.post(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/version/latest - AcademyMaterialVersionDelete
+            deleteLast: (academy_uid, material_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/hierarchy - AcademyMaterialHierarchy
+            get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/preview - AcademyMaterialPreview
+            get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/material/:material_uid/contract - AcademyMaterialContractList
+            list: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/contract-template - AcademyMaterialContractTemplateGet
+            get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/contract-template - AcademyMaterialContractTemplateSet
+            set: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/contract-template`, { body: request }),
+        },
+        // The academy'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 /academy/:academy_uid/material/:material_uid/pricing-assignment - AcademyMaterialPricingAssignmentList
+            list: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the material.
+            // POST /academy/:academy_uid/material/:material_uid/pricing-assignment - AcademyMaterialPricingAssignmentCreate
+            create: (academy_uid, material_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/material/:material_uid/pricing-assignment/:pricing_assignment_uid - AcademyMaterialPricingAssignmentUpdate
+            update: (academy_uid, material_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/material/:material_uid/pricing-assignment/:pricing_assignment_uid - AcademyMaterialPricingAssignmentDelete
+            delete: (academy_uid, material_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+        // The material's material resources - the former ref resources: the
+        // academy'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 /academy/:academy_uid/material/:material_uid/resource - AcademyMaterialResourceList
+            list: (academy_uid, material_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/resource/tree - AcademyMaterialResourceTree
+            tree: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/tree`),
+            // Bundles one resource of the academy's: version 1, a draft, pinned
+            // by the material's draft (a material resource it had - deleted, or
+            // unlinked by a discarded draft - is brought back). Another
+            // owner's or an unknown resource answers its own 403 / 404
+            // (RESOURCE_<E>_FORBIDDEN / RESOURCE_<E>_NOT_FOUND), one of another
+            // language 400 MATERIAL_RESOURCE_LANGUAGE_MISMATCH; 409
+            // MATERIAL_RESOURCE_DUPLICATE when the material holds it already.
+            // POST /academy/:academy_uid/material/:material_uid/resource - AcademyMaterialResourceCreate
+            create: (academy_uid, material_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/resource/import - AcademyMaterialResourceImport
+            import: (academy_uid, material_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/import`, { body: request }),
+            // The material's folders exist only as its material resources'
+            // folder paths, so they are renamed and moved by rewriting those.
+            folder: {
+                // Replaces the `from_path` prefix with `to_path` on every
+                // material resource under it, through their drafts; a `to_path`
+                // the material has already merges the two. Before anything is
+                // written: 409 FOLDER_CYCLE for a `to_path` inside `from_path`,
+                // 400 MATERIAL_RESOURCE_FOLDER_TOO_DEEP when a moved path would
+                // be deeper than 32 folders.
+                // PUT /academy/:academy_uid/material/:material_uid/resource/folder - AcademyMaterialResourceFolderRename
+                rename: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/folder`, { body: request }),
+            },
+            // GET /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid - AcademyMaterialResourceGet
+            get: (academy_uid, material_uid, material_resource_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid - AcademyMaterialResourceUpdate
+            update: (academy_uid, material_uid, material_resource_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid - AcademyMaterialResourceDelete
+            delete: (academy_uid, material_uid, material_resource_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`),
+            version: {
+                // GET /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid/version - AcademyMaterialResourceVersionList
+                list: (academy_uid, material_uid, material_resource_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid/version/latest - AcademyMaterialResourceVersionDelete
+                deleteLast: (academy_uid, material_uid, material_resource_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}/version/latest`),
+            },
+        },
+    };
+    // The academy's courses - the twin of `teacher.course`, same bodies and
+    // answers: 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 one of the
+    // academy's teachers (`teacher.list`, its roster), 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
+    // `academy.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 academy comes back, unsigned ones
+        // included. Paged, oldest first.
+        // GET /academy/:academy_uid/course - AcademyCourseList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_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`. Its teacher is one of the academy's,
+        // or none yet (400 COURSE_TEACHER_NOT_MEMBER for a teacher off the
+        // roster). Needs the academy's Course authorization (403
+        // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/course - AcademyCourseCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/course`, { body: request }),
+        // Open while the course is unsigned: the contract section names the
+        // course from it.
+        // GET /academy/:academy_uid/course/:course_uid - AcademyCourseGet
+        get: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid - AcademyCourseUpdate
+        update: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid - AcademyCourseDelete
+        delete: (academy_uid, course_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid/scope - AcademyCourseScopeSet
+            set: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid/schedule - AcademyCourseScheduleSet
+            set: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/schedule`, { body: request }),
+        },
+        version: {
+            // GET /academy/:academy_uid/course/:course_uid/version - AcademyCourseVersionList
+            list: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid/version/publish - AcademyCourseVersionPublish
+            publish: (academy_uid, course_uid) => this.http.post(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid/version/latest - AcademyCourseVersionDelete
+            deleteLast: (academy_uid, course_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid/preview - AcademyCoursePreview
+            get: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/course/:course_uid/contract - AcademyCourseContractList
+            list: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid/contract-template - AcademyCourseContractTemplateGet
+            get: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/course/:course_uid/contract-template - AcademyCourseContractTemplateSet
+            set: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/contract-template`, { body: request }),
+        },
+        // The academy'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 /academy/:academy_uid/course/:course_uid/pricing-assignment - AcademyCoursePricingAssignmentList
+            list: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the course.
+            // POST /academy/:academy_uid/course/:course_uid/pricing-assignment - AcademyCoursePricingAssignmentCreate
+            create: (academy_uid, course_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/course/:course_uid/pricing-assignment/:pricing_assignment_uid - AcademyCoursePricingAssignmentUpdate
+            update: (academy_uid, course_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/course/:course_uid/pricing-assignment/:pricing_assignment_uid - AcademyCoursePricingAssignmentDelete
+            delete: (academy_uid, course_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The academy's events - the twin of `teacher.event`, same bodies and
+    // answers: 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 `academy.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 academy comes back. Paged, oldest
+        // first.
+        // GET /academy/:academy_uid/event - AcademyEventList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_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 academy's Event
+        // authorization (403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/event - AcademyEventCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/event`, { body: request }),
+        // Open while the event is unsigned.
+        // GET /academy/:academy_uid/event/:event_uid - AcademyEventGet
+        get: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid - AcademyEventUpdate
+        update: (academy_uid, event_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid - AcademyEventDelete
+        delete: (academy_uid, event_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid/scope - AcademyEventScopeSet
+            set: (academy_uid, event_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/scope`, { body: request }),
+        },
+        version: {
+            // GET /academy/:academy_uid/event/:event_uid/version - AcademyEventVersionList
+            list: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid/version/publish - AcademyEventVersionPublish
+            publish: (academy_uid, event_uid) => this.http.post(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid/version/latest - AcademyEventVersionDelete
+            deleteLast: (academy_uid, event_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid/preview - AcademyEventPreview
+            get: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/event/:event_uid/contract - AcademyEventContractList
+            list: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid/contract-template - AcademyEventContractTemplateGet
+            get: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/event/:event_uid/contract-template - AcademyEventContractTemplateSet
+            set: (academy_uid, event_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/contract-template`, { body: request }),
+        },
+        // The academy'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 /academy/:academy_uid/event/:event_uid/pricing-assignment - AcademyEventPricingAssignmentList
+            list: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the event.
+            // POST /academy/:academy_uid/event/:event_uid/pricing-assignment - AcademyEventPricingAssignmentCreate
+            create: (academy_uid, event_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/event/:event_uid/pricing-assignment/:pricing_assignment_uid - AcademyEventPricingAssignmentUpdate
+            update: (academy_uid, event_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/event/:event_uid/pricing-assignment/:pricing_assignment_uid - AcademyEventPricingAssignmentDelete
+            delete: (academy_uid, event_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The academy's packages - the twin of `teacher.package`, same bodies and
+    // answers: 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; the academy's own collections and other
+    // products need none) 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 = {
+        // `language_id`, `exam_id`, `product_type` (a package pinning a
+        // product of that kind) and `signed` narrow the list; omitted, every
+        // package of the academy comes back, unsigned ones included. Paged,
+        // newest first.
+        // GET /academy/:academy_uid/package - AcademyPackageList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package`, { query: request }),
+        // 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 /academy/:academy_uid/package - AcademyPackageCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package`, { body: request }),
+        // Open while the package is unsigned (P15).
+        // GET /academy/:academy_uid/package/:package_uid - AcademyPackageGet
+        get: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_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
+        // package opens no draft. The language and the exam are not editable;
+        // the products change through `product`, the price through
+        // `pricingAssignment`.
+        // PUT /academy/:academy_uid/package/:package_uid - AcademyPackageUpdate
+        update: (academy_uid, package_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}`, { body: request }),
+        // A soft delete, open while unsigned; the contracts stay, the products
+        // it pinned are untouched.
+        // DELETE /academy/:academy_uid/package/:package_uid - AcademyPackageDelete
+        delete: (academy_uid, package_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}`),
+        // The preview's counts: the products the latest version pins, per
+        // kind.
+        // GET /academy/:academy_uid/package/:package_uid/count - AcademyPackageCount
+        count: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/count`),
+        version: {
+            // GET /academy/:academy_uid/package/:package_uid/version - AcademyPackageVersionList
+            list: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version`),
+            // 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 /academy/:academy_uid/package/:package_uid/version/publish - AcademyPackageVersionPublish
+            publish: (academy_uid, package_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/publish`),
+            // 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 /academy/:academy_uid/package/:package_uid/version/latest - AcademyPackageVersionDelete
+            deleteLast: (academy_uid, package_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/latest`),
+        },
+        // 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 /academy/:academy_uid/package/:package_uid/version/product - AcademyPackageVersion_ProductVersionList
+            list: (academy_uid, package_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_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; the academy's own
+            // collections and other products write none.
+            // POST /academy/:academy_uid/package/:package_uid/version/product - AcademyPackageVersion_ProductVersionAdd
+            add: (academy_uid, package_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/product`, { body: request }),
+            // DELETE /academy/:academy_uid/package/:package_uid/version/product/:product_type/:product_uid - AcademyPackageVersion_ProductVersionRemove
+            remove: (academy_uid, package_uid, product_type, product_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/package/:package_uid/version/product/order - AcademyPackageVersion_ProductVersionReorder
+            reorder: (academy_uid, package_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_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 /academy/:academy_uid/package/:package_uid/version/product/:product_type/:product_uid - AcademyPackageVersion_ProductVersionReplace
+            replace: (academy_uid, package_uid, product_type, product_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/product/${encodeURIComponent(product_type)}/${encodeURIComponent(product_uid)}`, { body: request }),
+        },
+        hierarchy: {
+            // 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 /academy/:academy_uid/package/:package_uid/hierarchy - AcademyPackageHierarchy
+            get: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/hierarchy`),
+        },
+        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 /academy/:academy_uid/package/:package_uid/preview - AcademyPackagePreview
+            get: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_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 `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/package/:package_uid/contract - AcademyPackageContractList
+            list: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/contract`),
+        },
+        // The academy'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 /academy/:academy_uid/package/:package_uid/pricing-assignment - AcademyPackagePricingAssignmentList
+            list: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the package.
+            // POST /academy/:academy_uid/package/:package_uid/pricing-assignment - AcademyPackagePricingAssignmentCreate
+            create: (academy_uid, package_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/package/:package_uid/pricing-assignment/:pricing_assignment_uid - AcademyPackagePricingAssignmentUpdate
+            update: (academy_uid, package_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/package/:package_uid/pricing-assignment/:pricing_assignment_uid - AcademyPackagePricingAssignmentDelete
+            delete: (academy_uid, package_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+        // Uploads the learning content of a zipped academy project - contract
+        // templates, learning kits, resources, components and their children,
+        // and the products: extensions, materials, courses, events and
+        // packages - and applies it declaratively onto this academy, the twin
+        // of `teacher.package.upload` (same body, same answer): 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. The Academy CLI sends it right
+        // after `collection.upload`, which applies the project's collections,
+        // series, items, assets and pricings. 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 /academy/:academy_uid/package/upload - AcademyPackageUpload
+        upload: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/upload`, { body: request, timeoutMs: null }),
     };
 }
 exports.BolbolAcademyScope = BolbolAcademyScope;