bolbol-sdk 2.0.2 → 2.0.3

package/dist/scope/BolbolAcademyScope.js

@@ -4,9 +4,26 @@ 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).
+// assets, and the pricings it sells 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, the packages that sell them, and resources (folders, videos,
+// podcasts, files, URLs). 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. An academy may build on any
+// published collection version: on its own collections it signs nothing; on
+// another academy's, the server signs that academy's licensing and commission
+// contracts, as it does 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`): the calls that create collections, packages,
+// components and resources, or publish collections and packages, answer 403
+// AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED without that kind's grant (a
+// component needs two: Package and its type family's kind).
 class BolbolAcademyScope {
     http;
     constructor(http) {
@@ -16,9 +33,11 @@ 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
+        // learning-content kinds its `package.upload` half maps (the teacher
+        // project's, and the resource kinds). 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 +50,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 +101,106 @@ 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: collections, packages,
+    // components on a collection or on resources, videos, podcasts, files,
+    // URLs and courses - each until a date, for good, or not at all. The
+    // calls a kind gates answer 403 AUTHORIZATION_REQUIRED /
+    // AUTHORIZATION_EXPIRED without it: creating a collection, series, item
+    // or asset and publishing a collection (Collection); creating or
+    // publishing a package and adding a component to one (Package); creating
+    // a resource (its own kind); creating a component (Package and its type
+    // family's kind, both - Package named first). 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 +229,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.
@@ -208,10 +328,11 @@ class BolbolAcademyScope {
         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.
+            // collection and a licensee (a teacher or another academy) 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 }),
@@ -230,6 +351,26 @@ 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 packages 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.
             // 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.
@@ -267,8 +408,9 @@ class BolbolAcademyScope {
     // 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 +538,9 @@ 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 collection's pricing settings, a package's sell
+    // pricing 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 +554,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 collection's pricing
+        // setting, a package's sell pricing or the academy's membership
+        // setting still names it.
         // 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`.
@@ -434,9 +578,10 @@ class BolbolAcademyScope {
         },
     };
     // 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.
+    // append-only price agreements the server writes itself - when a teacher
+    // or another academy licenses one of the academy's collections or builds a
+    // package on it, and when this academy builds on another academy's
+    // collection. Read-only: nothing here writes a contract.
     contract = {
         // `role` narrows to the contracts the academy produced or consumed,
         // `type` to one contract type.
@@ -446,6 +591,1035 @@ class BolbolAcademyScope {
         // 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 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
+    // Resource component bundles them (`component.refResource`).
+    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 component's latest version
+        // holds a ref 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 component's latest version
+        // holds a ref 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 component's latest version
+        // holds a ref 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 component's latest version
+        // holds a ref 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 - or, as a Resource component, over none: it bundles
+    // the academy's resources instead. 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, ambiguities or ref
+    // resources - and which of their fields it fills (ComponentTypeEnum). The
+    // children's endpoints nest under it, as their URLs do. Every write to a
+    // component (but its kit list, kept on the identity) or to a child lands
+    // on a draft, forking one when the latest version is published; nothing
+    // here publishes - publishing a package that lists the component does.
+    component = {
+        // Paged, 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 a published
+        // collection version, or - a Resource component - on an exam alone.
+        // Building on its own collection signs nothing; the academy's first
+        // component on another academy's collection also signs that
+        // academy's licensing contract for it. Needs the academy's Package
+        // authorization and its ComponentForCollection / ComponentForResources
+        // one by the type (403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED
+        // naming the first missing, Package first).
+        // 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 package version
+        // pins the component.
+        // 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. A Resource component,
+            // which has no collection version, answers its ref resources
+            // (`ref_resources`) instead.
+            // 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`),
+            },
+        },
+        // A Resource component's ref resources: the academy's own library
+        // resources (videos, podcasts, files, URLs) it bundles, at most one per
+        // resource. Each is filed under a folder path inside the component -
+        // folder NAMES, copied, so the component's folders are its own and
+        // moving the library's folders later changes nothing here.
+        refResource: {
+            // The live ref resources at their latest versions, each with the
+            // resource it pins (`source`). Paged; `resource_type` narrows to
+            // one kind.
+            // GET /academy/:academy_uid/component/:component_uid/ref-resource - AcademyRefResourceList
+            list: (academy_uid, component_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource`, { query: request }),
+            // The same rows as a folder tree built from their paths - the loose
+            // ones first, then the root folders.
+            // GET /academy/:academy_uid/component/:component_uid/ref-resource/tree - AcademyRefResourceTree
+            tree: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/tree`),
+            // Bundles one resource of the academy's: version 1, a draft, pinned
+            // by the component's draft (a ref resource it had - deleted, or
+            // unlinked by a discarded draft - is brought back). Another
+            // owner's or an unknown resource answers its own 403 / 404
+            // (RESOURCE_<E>_FORBIDDEN / RESOURCE_<E>_NOT_FOUND); 409
+            // REF_RESOURCE_DUPLICATE when the component holds it already.
+            // POST /academy/:academy_uid/component/:component_uid/ref-resource - AcademyRefResourceCreate
+            create: (academy_uid, component_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource`, { body: request }),
+            // Bundles a library folder (with everything under it, as folder
+            // paths) and / or picked resources in one call; the ones the
+            // component holds already are left as they are. All is resolved
+            // before the first write - a refused import writes nothing (400
+            // REF_RESOURCE_FOLDER_TOO_DEEP for a copied path deeper than 32
+            // folders). Answers how many ref resources it added (created or
+            // brought back) and the component's new tree.
+            // POST /academy/:academy_uid/component/:component_uid/ref-resource/import - AcademyRefResourceImport
+            import: (academy_uid, component_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/import`, { body: request }),
+            // The component's folders exist only as its ref resources' folder
+            // paths, so they are renamed and moved by rewriting those.
+            folder: {
+                // Replaces the `from_path` prefix with `to_path` on every ref
+                // resource under it, through their drafts; a `to_path` the
+                // component has already merges the two. Before anything is
+                // written: 409 FOLDER_CYCLE for a `to_path` inside
+                // `from_path`, 400 REF_RESOURCE_FOLDER_TOO_DEEP when a moved
+                // path would be deeper than 32 folders.
+                // PUT /academy/:academy_uid/component/:component_uid/ref-resource/folder - AcademyRefResourceFolderRename
+                rename: (academy_uid, component_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/folder`, { body: request }),
+            },
+            // GET /academy/:academy_uid/component/:component_uid/ref-resource/:ref_resource_uid - AcademyRefResourceGet
+            get: (academy_uid, component_uid, ref_resource_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`),
+            // Its place in the component - folder path, main entity, order; the
+            // resource it pins is fixed.
+            // PUT /academy/:academy_uid/component/:component_uid/ref-resource/:ref_resource_uid - AcademyRefResourceUpdate
+            update: (academy_uid, component_uid, ref_resource_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/component/:component_uid/ref-resource/:ref_resource_uid - AcademyRefResourceDelete
+            delete: (academy_uid, component_uid, ref_resource_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}`),
+            version: {
+                // GET /academy/:academy_uid/component/:component_uid/ref-resource/:ref_resource_uid/version - AcademyRefResourceVersionList
+                list: (academy_uid, component_uid, ref_resource_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}/version`),
+                // Drops the latest version, which must still be a draft.
+                // DELETE /academy/:academy_uid/component/:component_uid/ref-resource/:ref_resource_uid/version/latest - AcademyRefResourceVersionDelete
+                deleteLast: (academy_uid, component_uid, ref_resource_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/ref-resource/${encodeURIComponent(ref_resource_uid)}/version/latest`),
+            },
+        },
+    };
+    // The academy's packages - the twin of `teacher.package`, same bodies and
+    // answers: sellable bundles of the academy's components, each built on
+    // one published collection version and answered with its latest
+    // version's content; a Resource component, built on no collection, joins
+    // any package of its exam. Edits to a published version land on a new
+    // draft version; `version.publish` is the only publish of learning
+    // content, and it publishes the pinned components and their children
+    // with it.
+    package = {
+        // `collection_version_uid`, `exam_id` and a skill / task narrow the
+        // list; omitted, every package of the academy comes back. Paged,
+        // oldest first: a package has no skill / task of its own.
+        // GET /academy/:academy_uid/package - AcademyPackageList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package`, { query: request }),
+        // On another academy's collection, also signs - get-or-create - the
+        // academy's licensing contract for the collection and the package's
+        // two commission contracts; on its own collection, none.
+        // POST /academy/:academy_uid/package - AcademyPackageCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package`, { body: request }),
+        // GET /academy/:academy_uid/package/:package_uid - AcademyPackageGet
+        get: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}`),
+        // The collection version and the pricing are not editable here.
+        // 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 }),
+        // DELETE /academy/:academy_uid/package/:package_uid - AcademyPackageDelete
+        delete: (academy_uid, package_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}`),
+        setting: {
+            pricing: {
+                // What a learner will pay for the package; written onto the
+                // package itself, no draft fork.
+                // PATCH /academy/:academy_uid/package/:package_uid/setting/pricing - AcademyPackageUpdateSettingPricing
+                update: (academy_uid, package_uid, request) => this.http.patch(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/setting/pricing`, { body: request }),
+            },
+        },
+        // The preview's counts: the components the latest version pins and
+        // the children those component versions pin, per kind.
+        // GET /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`),
+            // The publish cascade: publishes the draft versions of the pinned
+            // components and their children, re-pins what moved (forking a new
+            // package version when the latest is already published) and
+            // publishes the package. 409 NOTHING_TO_PUBLISH when nothing moved.
+            // POST /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.
+            // 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 components this package bundles, on the package's latest
+        // version - the same five calls as `academy.collection.series`. An
+        // assignment is addressed by its COMPONENT uid; removing one
+        // unassigns the component only, the component survives.
+        component: {
+            // `version_number` reads an earlier version's assignments (the
+            // Changes tab).
+            // GET /academy/:academy_uid/package/:package_uid/version/component - AcademyPackageVersion_ComponentVersionList
+            list: (academy_uid, package_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/component`, { query: request }),
+            // The component must be built on the package's collection version
+            // - or be a Resource component, built on none, of the package's
+            // exam.
+            // POST /academy/:academy_uid/package/:package_uid/version/component - AcademyPackageVersion_ComponentVersionAdd
+            add: (academy_uid, package_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/component`, { body: request }),
+            // DELETE /academy/:academy_uid/package/:package_uid/version/component/:component_uid - AcademyPackageVersion_ComponentVersionRemove
+            remove: (academy_uid, package_uid, component_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/component/${encodeURIComponent(component_uid)}`),
+            // Writes nothing but `sort_order`. Position in `component_uids` IS the order.
+            // PUT /academy/:academy_uid/package/:package_uid/version/component/order - AcademyPackageVersion_ComponentVersionReorder
+            reorder: (academy_uid, package_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/component/order`, { body: request }),
+            // Swaps the pinned version of a component already in the package;
+            // the body carries the target version_number (pick from
+            // academy.component.version.list).
+            // PUT /academy/:academy_uid/package/:package_uid/version/component/:component_uid - AcademyPackageVersion_ComponentVersionReplace
+            replace: (academy_uid, package_uid, component_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/component/${encodeURIComponent(component_uid)}`, { body: request }),
+        },
+        hierarchy: {
+            // package -> components -> children, 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 component's preview, 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`),
+        },
+        // Uploads the learning content of a zipped academy project - learning
+        // kits, components, packages and resources, with their children - 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. 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;
 //# sourceMappingURL=BolbolAcademyScope.js.map