bolbol-sdk 1.0.0 → 1.0.2

package/dist/scope/BolbolAcademyScope.js

@@ -11,6 +11,15 @@ class BolbolAcademyScope {
     // feed behind every Academies browse grid. It is NOT scoped to the caller's
     // own academies (that is `account.list`). Only approved academies that are
     // not scheduled for deletion come back.
+    uid = {
+        // 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 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 }),
+    };
     directory = {
         // The one list endpoint. Pass any combination of the filters; omit them
         // all for the whole directory.
@@ -69,6 +78,10 @@ class BolbolAcademyScope {
         // whole academy, which is what the item form's asset picker wants.
         // GET /academy/:academy_uid/asset - AcademyAssetList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/asset`, { query: request }),
+        // How many assets the academy holds per skill - the admin tree's
+        // headings, drawn before any skill's rows are paged in.
+        // GET /academy/:academy_uid/asset/count - AcademyAssetCount
+        count: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/asset/count`, { query: request }),
         // GET /academy/:academy_uid/asset/:asset_uid - AcademyAssetGet
         get: (academy_uid, asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}`),
         // POST /academy/:academy_uid/asset - AcademyAssetCreate
@@ -82,8 +95,6 @@ class BolbolAcademyScope {
         version: {
             // GET /academy/:academy_uid/asset/:asset_uid/version - AcademyAssetVersionList
             list: (academy_uid, asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/version`),
-            // POST /academy/:academy_uid/asset/:asset_uid/version/publish - AcademyAssetVersionPublish
-            publish: (academy_uid, asset_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/version/publish`),
             // Discards the unpublished draft (409 when the latest is published).
             // DELETE /academy/:academy_uid/asset/:asset_uid/version/latest - AcademyAssetVersionDelete
             deleteLast: (academy_uid, asset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/version/latest`),
@@ -108,6 +119,20 @@ class BolbolAcademyScope {
             // DELETE /academy/:academy_uid/asset/:asset_uid/attachment/:user_file_uid - AcademyAssetAttachmentRemove
             remove: (academy_uid, asset_uid, user_file_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/attachment/${encodeURIComponent(user_file_uid)}`),
         },
+        // The asset's own annotations - selections on its attachments'
+        // transcripts and summaries (latest version), each filed under one of
+        // the academy's groups with name / color / value metadata. Shown
+        // wherever the asset is: its preview and every item based on it.
+        annotation: {
+            // GET /academy/:academy_uid/asset/:asset_uid/annotation - AcademyAssetAnnotationList
+            list: (academy_uid, asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/annotation`),
+            // POST /academy/:academy_uid/asset/:asset_uid/annotation - AcademyAssetAnnotationAdd
+            add: (academy_uid, asset_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/annotation`, { body: request }),
+            // PUT /academy/:academy_uid/asset/:asset_uid/annotation/:annotation_uid - AcademyAssetAnnotationUpdate
+            update: (academy_uid, asset_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/asset/:asset_uid/annotation/:annotation_uid - AcademyAssetAnnotationRemove
+            remove: (academy_uid, asset_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
         // The items linked to this asset - the inverse of the item's own asset
         // picker. Editing, deleting and unlinking go through the item
         // endpoints; only the listing is asset-scoped.
@@ -116,59 +141,66 @@ class BolbolAcademyScope {
             list: (academy_uid, asset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/asset/${encodeURIComponent(asset_uid)}/item`),
         },
     };
-    category = {
-        // `exam_skill_task_id` narrows to one task - what the item's category
-        // picker asks for. Omitted, the call returns the whole academy, which is
-        // what the Category list page shows.
-        // GET /academy/:academy_uid/category - AcademyCategoryList
-        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category`, { query: request }),
-        // GET /academy/:academy_uid/category/:category_uid - AcademyCategoryGet
-        get: (academy_uid, category_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}`),
-        // POST /academy/:academy_uid/category - AcademyCategoryCreate
-        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/category`, { body: request }),
-        // PUT /academy/:academy_uid/category/:category_uid - AcademyCategoryUpdate
-        update: (academy_uid, category_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}`, { body: request }),
-        // Items filed under it become uncategorised.
-        // DELETE /academy/:academy_uid/category/:category_uid - AcademyCategoryDelete
-        delete: (academy_uid, category_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}`),
-        // Writes nothing but `order`, so a drag never touches a name or colour.
-        // Position in `category_uids` IS the order.
-        // PUT /academy/:academy_uid/category/order - AcademyCategoryReorder
-        reorder: (academy_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/category/order`, { body: request }),
+    // The academy's user-defined classification axes - for example "Tense",
+    // "Register". Each type carries its own set of values (CategoryValue
+    // rows), and items are tagged by picking any number of values across
+    // any number of types. Replaces the single-category link that used to
+    // live on item_version.
+    categoryType = {
+        // GET /academy/:academy_uid/category-type - AcademyCategoryTypeList
+        // Returns every CategoryType AND every CategoryValue for the
+        // academy, so the Console's Categories tab can draw its selects
+        // from a single call - narrowed to one skill / task when asked (the
+        // item form asks for the item's task).
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category-type`, { query: request }),
+        // POST /academy/:academy_uid/category-type - AcademyCategoryTypeCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/category-type`, { body: request }),
+        // PUT /academy/:academy_uid/category-type/:category_type_uid - AcademyCategoryTypeUpdate
+        update: (academy_uid, category_type_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}`, { body: request }),
+        // DELETE /academy/:academy_uid/category-type/:category_type_uid - AcademyCategoryTypeDelete
+        delete: (academy_uid, category_type_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}`),
+        // Versioning on the CategoryType itself - same shape as collection
+        // and series.
         version: {
-            // GET /academy/:academy_uid/category/:category_uid/version - AcademyCategoryVersionList
-            list: (academy_uid, category_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/version`),
-            // POST /academy/:academy_uid/category/:category_uid/version/publish - AcademyCategoryVersionPublish
-            publish: (academy_uid, category_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/version/publish`),
+            // GET /academy/:academy_uid/category-type/:category_type_uid/version - AcademyCategoryTypeVersionList
+            list: (academy_uid, category_type_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/version`),
             // Discards the unpublished draft (409 when the latest is published).
-            // DELETE /academy/:academy_uid/category/:category_uid/version/latest - AcademyCategoryVersionDelete
-            deleteLast: (academy_uid, category_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/version/latest`),
+            // DELETE /academy/:academy_uid/category-type/:category_type_uid/version/latest - AcademyCategoryTypeVersionDelete
+            deleteLast: (academy_uid, category_type_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/version/latest`),
         },
-        // The category's word list, backed by category_vocabulary. An entry is
-        // addressed by `word_meaning_id`, not a uid: it is a link row over
-        // shared `word` schema catalog rows, whose numeric ids are their public
-        // handles.
-        vocabulary: {
-            // Entries in order.
-            // GET /academy/:academy_uid/category/:category_uid/vocabulary - AcademyCategoryVocabularyList
-            list: (academy_uid, category_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/vocabulary`),
-            // A new entry lands at the end of the list; the backend assigns `order`.
-            // POST /academy/:academy_uid/category/:category_uid/vocabulary - AcademyCategoryVocabularyAdd
-            add: (academy_uid, category_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/vocabulary`, { body: request }),
-            // There is no per-entry update: the word and meaning ARE the entry,
-            // so position is the only editable thing. Position in
-            // `word_meaning_ids` IS the order.
-            // PUT /academy/:academy_uid/category/:category_uid/vocabulary/order - AcademyCategoryVocabularyReorder
-            reorder: (academy_uid, category_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/vocabulary/order`, { body: request }),
-            // Drops the link row only; the word and meaning are left untouched.
-            // DELETE /academy/:academy_uid/category/:category_uid/vocabulary/:word_meaning_id - AcademyCategoryVocabularyRemove
-            remove: (academy_uid, category_uid, word_meaning_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/vocabulary/${word_meaning_id}`),
-        },
-        // The items filed under this category - the inverse of the item's own
-        // category picker. Only the listing is category-scoped.
-        item: {
-            // GET /academy/:academy_uid/category/:category_uid/item - AcademyCategoryItemList
-            list: (academy_uid, category_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category/${encodeURIComponent(category_uid)}/item`),
+        value: {
+            // GET /academy/:academy_uid/category-type/:category_type_uid/value - AcademyCategoryValueList
+            list: (academy_uid, category_type_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value`),
+            // POST /academy/:academy_uid/category-type/:category_type_uid/value - AcademyCategoryValueCreate
+            create: (academy_uid, category_type_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value`, { body: request }),
+            // PUT /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid - AcademyCategoryValueUpdate
+            update: (academy_uid, category_type_uid, category_value_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid - AcademyCategoryValueDelete
+            delete: (academy_uid, category_type_uid, category_value_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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. On a published value it
+            // forks a draft first, like the vocabulary does.
+            // PUT /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid/concept - AcademyCategoryValueUpdateConcepts
+            updateConcepts: (academy_uid, category_type_uid, category_value_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/concept`, { body: request }),
+            version: {
+                // GET /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid/version - AcademyCategoryValueVersionList
+                list: (academy_uid, category_type_uid, category_value_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/version`),
+                // DELETE /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid/version/latest - AcademyCategoryValueVersionDelete
+                deleteLast: (academy_uid, category_type_uid, category_value_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/version/latest`),
+            },
+            // The value's word list, backed by category_value_vocabulary.
+            // Adding or removing an entry on a published value forks a new
+            // draft version (rules/Versioning.md).
+            vocabulary: {
+                // GET /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary - AcademyCategoryValueVocabularyList
+                list: (academy_uid, category_type_uid, category_value_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary`),
+                // POST /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary - AcademyCategoryValueVocabularyAdd
+                add: (academy_uid, category_type_uid, category_value_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary`, { body: request }),
+                // PUT /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary/order - AcademyCategoryValueVocabularyReorder
+                reorder: (academy_uid, category_type_uid, category_value_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary/order`, { body: request }),
+                // DELETE /academy/:academy_uid/category-type/:category_type_uid/value/:category_value_uid/vocabulary/:word_meaning_id - AcademyCategoryValueVocabularyRemove
+                remove: (academy_uid, category_type_uid, category_value_uid, word_meaning_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/category-type/${encodeURIComponent(category_type_uid)}/value/${encodeURIComponent(category_value_uid)}/vocabulary/${word_meaning_id}`),
+            },
         },
     };
     // The academy's student roster. There is nothing here to CREATE an
@@ -225,12 +257,32 @@ class BolbolAcademyScope {
         update: (academy_uid, collection_uid, request = {}) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`, { body: request }),
         // DELETE /academy/:academy_uid/collection/:collection_uid - AcademyCollectionDelete
         delete: (academy_uid, collection_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`),
+        // Uploads a zipped Academy project and applies it declaratively onto
+        // this academy: entities identical to what the server already holds
+        // are left alone, differences go through the SAME per-entity table
+        // calls the create/update controllers use (versioning preserved), uids
+        // in the project but not on the server are created, uids on the server
+        // but not in the project are soft-deleted. The server unzips to a temp
+        // folder and deletes it on success or failure. No timeout: the work
+        // grows with the project (a first upload creates every entity).
+        // POST /academy/:academy_uid/collection/upload - AcademyCollectionUpload
+        upload: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/upload`, { body: request, timeoutMs: null }),
         setting: {
             membership: {
                 // PATCH /academy/:academy_uid/collection/:collection_uid/setting/membership - AcademyCollectionUpdateSettingMembership
                 update: (academy_uid, collection_uid, request) => this.http.patch(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/setting/membership`, { body: request }),
             },
         },
+        // The preview's counts: students, and the distinct assets, annotation
+        // groups and category types / values the latest version uses.
+        // GET /academy/:academy_uid/collection/:collection_uid/count - AcademyCollectionCount
+        count: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/count`),
+        // Who holds this collection - its students. Owner-only and paged; the
+        // rows are the academy roster's shape (`AcademyStudentRowType`).
+        student: {
+            // GET /academy/:academy_uid/collection/:collection_uid/student - AcademyCollectionStudentList
+            list: (academy_uid, collection_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/student`, { query: request }),
+        },
         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`),
@@ -249,13 +301,23 @@ class BolbolAcademyScope {
             // page sits under a task.
             // GET /academy/:academy_uid/collection/:collection_uid/version/series - AcademyCollectionVersion_SeriesVersionList
             list: (academy_uid, collection_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series`, { query: request }),
+            // Series and item counts per task, on the latest version - what a
+            // tree draws its task headings from before paging any series in.
+            // GET /academy/:academy_uid/collection/:collection_uid/version/series/count - AcademyCollectionVersionSeriesVersionCount
+            count: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series/count`),
             // POST /academy/:academy_uid/collection/:collection_uid/version/series - AcademyCollectionVersion_SeriesVersionAdd
             add: (academy_uid, collection_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series`, { body: request }),
             // DELETE /academy/:academy_uid/collection/:collection_uid/version/series/:series_version_uid - AcademyCollectionVersion_SeriesVersionRemove
             remove: (academy_uid, collection_uid, series_version_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series/${encodeURIComponent(series_version_uid)}`),
-            // Writes nothing but `order`. Position in `series_version_uids` IS the order.
+            // Writes nothing but `sort_order`. Position in `series_version_uids` IS the order.
             // PUT /academy/:academy_uid/collection/:collection_uid/version/series/order - AcademyCollectionVersion_SeriesVersionReorder
             reorder: (academy_uid, collection_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series/order`, { body: request }),
+            // Swaps the pinned series version for a member that is already in
+            // the collection. `series_uid` is the series being changed; the
+            // body carries the target version_number (pick from
+            // academy.series.version.list).
+            // PUT /academy/:academy_uid/collection/:collection_uid/version/series/:series_uid - AcademyCollectionVersion_SeriesVersionReplace
+            replace: (academy_uid, collection_uid, series_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series/${encodeURIComponent(series_uid)}`, { body: request }),
         },
     };
     // An academy's items, each answered with its latest version's content.
@@ -266,8 +328,16 @@ class BolbolAcademyScope {
         // academy - which is what the [item] URL node's uid lookup needs.
         // GET /academy/:academy_uid/item - AcademyItemList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item`, { query: request }),
+        // How many items the academy holds per (skill, task) - the admin
+        // tree's headings, drawn before any task's rows are paged in.
+        // GET /academy/:academy_uid/item/count - AcademyItemCount
+        count: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/count`, { query: request }),
         // GET /academy/:academy_uid/item/:item_uid - AcademyItemGet
         get: (academy_uid, item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}`),
+        // The item as a learner is posed it (answer key stripped), for its
+        // author - no approval, collection or series gate.
+        // GET /academy/:academy_uid/item/:item_uid/preview - AcademyItemPreview
+        preview: (academy_uid, item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/preview`),
         // `type` also decides which shape `detail` must have, and is immutable
         // afterwards. The asset and category ride along here because there is
         // no item to save them against yet.
@@ -284,17 +354,28 @@ class BolbolAcademyScope {
         // the author had typed into the item form but not yet saved.
         // PUT /academy/:academy_uid/item/:item_uid/asset - AcademyItemUpdateAsset
         updateAsset: (academy_uid, item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/asset`, { body: request }),
+        // Pins (or clears, with null) the item's mindset at the mindset's
+        // latest version. Productive types only (400 otherwise). Separate from
+        // `update` for the same reason `updateAsset` is.
+        // PUT /academy/:academy_uid/item/:item_uid/mindset - AcademyItemUpdateMindset
+        updateMindset: (academy_uid, item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/mindset`, { body: request }),
+        // Replaces the item's concepts (in order; `[]` clears them), pinning
+        // each at its latest version. Productive types only (400 otherwise).
+        // Separate from `update` for the same reason `updateAsset` is.
+        // PUT /academy/:academy_uid/item/:item_uid/concept - AcademyItemUpdateConcepts
+        updateConcepts: (academy_uid, item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/concept`, { body: request }),
         // Sets (or clears, with null) the item's category. Separate from
         // `update` for the same reason `updateAsset` is.
-        // PUT /academy/:academy_uid/item/:item_uid/item-category - AcademyItemUpdateCategory
-        updateCategory: (academy_uid, item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/item-category`, { body: request }),
+        // Replaces the full CategoryValue tag set on the item. Changing it
+        // forks a new draft version of the item (see rules/Versioning.md),
+        // which is why it lives beside the other item-version mutations.
+        // PUT /academy/:academy_uid/item/:item_uid/categories - AcademyItemUpdateCategories
+        updateCategories: (academy_uid, item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/categories`, { body: request }),
         // DELETE /academy/:academy_uid/item/:item_uid - AcademyItemDelete
         delete: (academy_uid, item_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}`),
         version: {
             // GET /academy/:academy_uid/item/:item_uid/version - AcademyItemVersionList
             list: (academy_uid, item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/version`),
-            // POST /academy/:academy_uid/item/:item_uid/version/publish - AcademyItemVersionPublish
-            publish: (academy_uid, item_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/version/publish`),
             // Drops the latest version, which must still be a draft.
             // DELETE /academy/:academy_uid/item/:item_uid/version/latest - AcademyItemVersionDelete
             deleteLast: (academy_uid, item_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/version/latest`),
@@ -306,7 +387,7 @@ class BolbolAcademyScope {
             // Entries in order.
             // GET /academy/:academy_uid/item/:item_uid/vocabulary - AcademyItemVocabularyList
             list: (academy_uid, item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/vocabulary`),
-            // A new entry lands at the end of the list; the backend assigns `order`.
+            // A new entry lands at the end of the list; the backend assigns `sort_order`.
             // POST /academy/:academy_uid/item/:item_uid/vocabulary - AcademyItemVocabularyAdd
             add: (academy_uid, item_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/vocabulary`, { body: request }),
             // There is no per-entry update: the word and meaning ARE the entry, so
@@ -319,6 +400,46 @@ class BolbolAcademyScope {
             // DELETE /academy/:academy_uid/item/:item_uid/vocabulary/:word_meaning_id - AcademyItemVocabularyRemove
             remove: (academy_uid, item_uid, word_meaning_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/vocabulary/${word_meaning_id}`),
         },
+        // The item's ambiguity annotations, on its latest version. Same
+        // append-only shape as `vocabulary`: a new annotation lands at the end
+        // of the list and is addressed by its own `ambiguity_uid` for removal.
+        ambiguity: {
+            // Entries in `sort_order` then id.
+            // GET /academy/:academy_uid/item/:item_uid/ambiguity - AcademyItemAmbiguityList
+            list: (academy_uid, item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/ambiguity`),
+            // POST /academy/:academy_uid/item/:item_uid/ambiguity - AcademyItemAmbiguityAdd
+            add: (academy_uid, item_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/ambiguity`, { body: request }),
+            // PUT /academy/:academy_uid/item/:item_uid/ambiguity/:ambiguity_uid - AcademyItemAmbiguityUpdate
+            update: (academy_uid, item_uid, ambiguity_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/item/:item_uid/ambiguity/:ambiguity_uid - AcademyItemAmbiguityRemove
+            remove: (academy_uid, item_uid, ambiguity_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/ambiguity/${encodeURIComponent(ambiguity_uid)}`),
+        },
+        // Sample / model answers for a productive item (Writing or Speaking).
+        // `list` returns `[]` when the item has none, so a shared UI tab can
+        // render uniformly.
+        productive_answer: {
+            // GET /academy/:academy_uid/item/:item_uid/productive-answer - AcademyItemProductiveAnswerList
+            list: (academy_uid, item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/productive-answer`),
+            // POST /academy/:academy_uid/item/:item_uid/productive-answer - AcademyItemProductiveAnswerAdd
+            add: (academy_uid, item_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/productive-answer`, { body: request }),
+            // PUT /academy/:academy_uid/item/:item_uid/productive-answer/:answer_uid - AcademyItemProductiveAnswerUpdate
+            update: (academy_uid, item_uid, answer_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/productive-answer/${encodeURIComponent(answer_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/item/:item_uid/productive-answer/:answer_uid - AcademyItemProductiveAnswerRemove
+            remove: (academy_uid, item_uid, answer_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/productive-answer/${encodeURIComponent(answer_uid)}`),
+        },
+        // The academy's annotations on the item's latest version - selections
+        // on its question text or on a productive answer structure's text,
+        // each with name / color / value metadata. Learners see them too.
+        annotation: {
+            // GET /academy/:academy_uid/item/:item_uid/annotation - AcademyItemAnnotationList
+            list: (academy_uid, item_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/annotation`),
+            // POST /academy/:academy_uid/item/:item_uid/annotation - AcademyItemAnnotationAdd
+            add: (academy_uid, item_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/annotation`, { body: request }),
+            // PUT /academy/:academy_uid/item/:item_uid/annotation/:annotation_uid - AcademyItemAnnotationUpdate
+            update: (academy_uid, item_uid, annotation_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/annotation/${encodeURIComponent(annotation_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/item/:item_uid/annotation/:annotation_uid - AcademyItemAnnotationRemove
+            remove: (academy_uid, item_uid, annotation_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/item/${encodeURIComponent(item_uid)}/annotation/${encodeURIComponent(annotation_uid)}`),
+        },
         // The item's file bucket, on its latest version. Uploading and attaching
         // are two steps: the user-file upload stores the bytes with
         // `in_use = false`, and `add` creates the join row that flips the file to
@@ -346,6 +467,10 @@ class BolbolAcademyScope {
         // form's series picker asks for. Omitted, the whole academy comes back.
         // GET /academy/:academy_uid/series - AcademySeriesList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/series`, { query: request }),
+        // How many series the academy holds per task - the admin tree's
+        // headings, drawn before any task's rows are paged in.
+        // GET /academy/:academy_uid/series/count - AcademySeriesCount
+        count: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/series/count`, { query: request }),
         // GET /academy/:academy_uid/series/:series_uid - AcademySeriesGet
         get: (academy_uid, series_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}`),
         // Members are not asked for at creation: a new series starts empty and
@@ -357,15 +482,13 @@ class BolbolAcademyScope {
         update: (academy_uid, series_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}`, { body: request }),
         // DELETE /academy/:academy_uid/series/:series_uid - AcademySeriesDelete
         delete: (academy_uid, series_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}`),
-        // Writes nothing but `order`, so a drag never touches a name or colour.
+        // Writes nothing but `sort_order`, so a drag never touches a name or colour.
         // Position in `series_uids` IS the order.
         // PUT /academy/:academy_uid/series/order - AcademySeriesReorder
         reorder: (academy_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/series/order`, { body: request }),
         version: {
             // GET /academy/:academy_uid/series/:series_uid/version - AcademySeriesVersionList
             list: (academy_uid, series_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/version`),
-            // POST /academy/:academy_uid/series/:series_uid/version/publish - AcademySeriesVersionPublish
-            publish: (academy_uid, series_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/version/publish`),
             // Drops the latest version, which must still be a draft - together
             // with the membership edits made on it.
             // DELETE /academy/:academy_uid/series/:series_uid/version/latest - AcademySeriesVersionDelete
@@ -376,13 +499,21 @@ class BolbolAcademyScope {
         // resolves it as an item uid. Removing one drops the membership only;
         // the item survives.
         item: {
-            // Members in order.
+            // Members in order. `version_number` targets a specific historical
+            // version's item list - used by the Changes tab's diff view;
+            // omitted, the call resolves the series' latest version, which is
+            // what every non-diff caller wants.
             // GET /academy/:academy_uid/series/:series_uid/item-version - AcademySeriesVersion_ItemVersionList
-            list: (academy_uid, series_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/item-version`),
+            list: (academy_uid, series_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/item-version`, { query: request }),
             // POST /academy/:academy_uid/series/:series_uid/item-version - AcademySeriesVersion_ItemVersionAdd
             add: (academy_uid, series_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/item-version`, { body: request }),
             // DELETE /academy/:academy_uid/series/:series_uid/item-version/:item_version_uid - AcademySeriesVersion_ItemVersionRemove
             remove: (academy_uid, series_uid, item_version_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/item-version/${encodeURIComponent(item_version_uid)}`),
+            // Swaps the pinned item version for a member that is already in
+            // the series. `item_uid` is the item being changed; the body carries
+            // the target version_number (pick from academy.item.version.list).
+            // PUT /academy/:academy_uid/series/:series_uid/item-version/:item_uid - AcademySeriesVersion_ItemVersionReplace
+            replace: (academy_uid, series_uid, item_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/item-version/${encodeURIComponent(item_uid)}`, { body: request }),
             // Position in `item_version_uids` IS the order.
             // PUT /academy/:academy_uid/series/:series_uid/item-version/order - AcademySeriesVersion_ItemVersionReorder
             reorder: (academy_uid, series_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/item-version/order`, { body: request }),
@@ -393,6 +524,112 @@ class BolbolAcademyScope {
             autoAssign: (academy_uid, series_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/series/${encodeURIComponent(series_uid)}/item-version/auto-assign`, { body: request }),
         },
     };
+    // The academy's annotation groups (Vocabulary, Grammar, ...): defined once,
+    // picked for every annotation the academy adds.
+    annotation_group = {
+        // GET /academy/:academy_uid/annotation-group - AcademyAnnotationGroupList
+        list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/annotation-group`),
+        // POST /academy/:academy_uid/annotation-group - AcademyAnnotationGroupCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/annotation-group`, { body: request }),
+        // PUT /academy/:academy_uid/annotation-group/:annotation_group_uid - AcademyAnnotationGroupUpdate
+        update: (academy_uid, annotation_group_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}`, { body: request }),
+        // DELETE /academy/:academy_uid/annotation-group/:annotation_group_uid - AcademyAnnotationGroupDelete
+        delete: (academy_uid, annotation_group_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}`),
+        // Versioning on the group itself - same shape as categoryType.
+        version: {
+            // GET /academy/:academy_uid/annotation-group/:annotation_group_uid/version - AcademyAnnotationGroupVersionList
+            list: (academy_uid, annotation_group_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}/version`),
+            // Discards the unpublished draft (409 when the latest is published).
+            // DELETE /academy/:academy_uid/annotation-group/:annotation_group_uid/version/latest - AcademyAnnotationGroupVersionDelete
+            deleteLast: (academy_uid, annotation_group_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/annotation-group/${encodeURIComponent(annotation_group_uid)}/version/latest`),
+        },
+    };
+    // The academy's mindsets: a situation ("Sport / outdoor activity") with
+    // the numbered topics worth asking about in it. Versioned like
+    // categoryType; a productive item pins one version
+    // (`item.updateMindset`).
+    mindset = {
+        // GET /academy/:academy_uid/mindset - AcademyMindsetList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/mindset`, { query: request }),
+        // GET /academy/:academy_uid/mindset/:mindset_uid - AcademyMindsetGet
+        get: (academy_uid, mindset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}`),
+        // POST /academy/:academy_uid/mindset - AcademyMindsetCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/mindset`, { body: request }),
+        // PUT /academy/:academy_uid/mindset/:mindset_uid - AcademyMindsetUpdate
+        update: (academy_uid, mindset_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}`, { body: request }),
+        // 409 while the latest version of a live item still pins it.
+        // DELETE /academy/:academy_uid/mindset/:mindset_uid - AcademyMindsetDelete
+        delete: (academy_uid, mindset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}`),
+        // Versioning on the mindset itself - same shape as categoryType.
+        version: {
+            // GET /academy/:academy_uid/mindset/:mindset_uid/version - AcademyMindsetVersionList
+            list: (academy_uid, mindset_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}/version`),
+            // Discards the unpublished draft (409 when the latest is published,
+            // or when an item version pins it).
+            // DELETE /academy/:academy_uid/mindset/:mindset_uid/version/latest - AcademyMindsetVersionDelete
+            deleteLast: (academy_uid, mindset_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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/mindset/:mindset_uid/topic - AcademyMindsetTopicAdd
+            add: (academy_uid, mindset_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic`, { body: request }),
+            // Position in `topic_uids` IS the order.
+            // PUT /academy/:academy_uid/mindset/:mindset_uid/topic/order - AcademyMindsetTopicReorder
+            reorder: (academy_uid, mindset_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/order`, { body: request }),
+            // PUT /academy/:academy_uid/mindset/:mindset_uid/topic/:topic_uid - AcademyMindsetTopicUpdate
+            update: (academy_uid, mindset_uid, topic_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/${encodeURIComponent(topic_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/mindset/:mindset_uid/topic/:topic_uid - AcademyMindsetTopicRemove
+            remove: (academy_uid, mindset_uid, topic_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/mindset/${encodeURIComponent(mindset_uid)}/topic/${encodeURIComponent(topic_uid)}`),
+        },
+    };
+    // The academy's concepts: an idea tied to a task ("Giving an opinion")
+    // with its explanation and the numbered scenarios it applies in. Versioned
+    // like mindset; a productive item pins several, one version each
+    // (`item.updateConcepts`).
+    concept = {
+        // GET /academy/:academy_uid/concept - AcademyConceptList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/concept`, { query: request }),
+        // GET /academy/:academy_uid/concept/:concept_uid - AcademyConceptGet
+        get: (academy_uid, concept_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}`),
+        // POST /academy/:academy_uid/concept - AcademyConceptCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/concept`, { body: request }),
+        // PUT /academy/:academy_uid/concept/:concept_uid - AcademyConceptUpdate
+        update: (academy_uid, concept_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}`, { body: request }),
+        // 409 while the latest version of a live item still pins it.
+        // DELETE /academy/:academy_uid/concept/:concept_uid - AcademyConceptDelete
+        delete: (academy_uid, concept_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}`),
+        // Versioning on the concept itself - same shape as mindset.
+        version: {
+            // GET /academy/:academy_uid/concept/:concept_uid/version - AcademyConceptVersionList
+            list: (academy_uid, concept_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}/version`),
+            // Discards the unpublished draft (409 when the latest is published,
+            // or when an item version pins it).
+            // DELETE /academy/:academy_uid/concept/:concept_uid/version/latest - AcademyConceptVersionDelete
+            deleteLast: (academy_uid, concept_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_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/concept/:concept_uid/scenario - AcademyConceptScenarioAdd
+            add: (academy_uid, concept_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario`, { body: request }),
+            // Position in `scenario_uids` IS the order.
+            // PUT /academy/:academy_uid/concept/:concept_uid/scenario/order - AcademyConceptScenarioReorder
+            reorder: (academy_uid, concept_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/order`, { body: request }),
+            // PUT /academy/:academy_uid/concept/:concept_uid/scenario/:scenario_uid - AcademyConceptScenarioUpdate
+            update: (academy_uid, concept_uid, scenario_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/${encodeURIComponent(scenario_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/concept/:concept_uid/scenario/:scenario_uid - AcademyConceptScenarioRemove
+            remove: (academy_uid, concept_uid, scenario_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/concept/${encodeURIComponent(concept_uid)}/scenario/${encodeURIComponent(scenario_uid)}`),
+        },
+    };
+    // Concept versions by uid, as a learner is posed them - what an item's
+    // `concept_version_uids` (or a concept's `version_uid`) point at.
+    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 }),
+    };
 }
 exports.BolbolAcademyScope = BolbolAcademyScope;
 //# sourceMappingURL=BolbolAcademyScope.js.map