bolbol-sdk 2.0.3 → 2.2.0

package/dist/scope/BolbolAcademyScope.js

@@ -3,27 +3,33 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BolbolAcademyScope = void 0;
 // Mirrors Bolbol API src/controller/academy. One method per controller.
 //
-// The academy provides the environment: its collections, series, items and
-// assets, and the pricings it sells them with. 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.
+// The academy provides the environment: its collections - the academy's
+// own product (P2) - series, items and assets, and the pricings it prices
+// them with. It is also the second owner of learning content, beside the
+// teacher (Bolbol API rules/Teacher.md): learning kits (annotation groups,
+// category types and values, mindsets, concepts), components, resources
+// (folders, videos, podcasts, files, URLs) and the products a teacher owns
+// too - extensions, materials, courses, events and packages. Those
+// endpoints are the twins of the teacher's (BolbolTeacherScope): the same
+// sub-paths under /academy/:academy_uid, the same bodies and answers -
+// their types alias the teacher's - so a client drives either owner with
+// the same calls. Every product, a collection included, is created
+// unsigned with the contracts it requires, and the server signs none of
+// them for the academy: each party signs its own side (`contract`, P7,
+// P15). An academy may build on any published collection version: an
+// extension of one of its own collections requires Bolbol's commission
+// alone, one of another academy's also that collection's three educator
+// contracts (P11), as for a teacher.
 //
 // Like a teacher, the academy is verified by Bolbol: its documents,
 // certificates, experiences and publications go through review requests, and
 // only an approved academy is listed in the directory and may publish a
 // collection. Bolbol also authorizes, kind by kind, what it may manage
-// (`authorization.get`): 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).
+// (`authorization.get`, six kinds): the calls that create or publish a
+// product, create a component, a folder or a resource, or add to an extension or a
+// package answer 403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED
+// without that kind's grant - one kind each, Extension alone for a
+// component (P16), Material for a folder or a resource.
 class BolbolAcademyScope {
     http;
     constructor(http) {
@@ -34,10 +40,16 @@ class BolbolAcademyScope {
         // 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, 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.
+        // content kinds its `package.upload` half maps - the teacher
+        // project's: contract templates, learning content, resources and the
+        // products, a material's MaterialResource among them (P20). A
+        // product's answer, a collection's included, also says whether it is
+        // `signed`: an upload defers what an unsigned product's files ask
+        // until it is (P19). Another owner's product that a package bundles
+        // answers like an unknown uid - its public directory profile confirms
+        // it. The Academy CLI calls it before an upload - its `entity-uid`
+        // check, and to finish rewriting local uids an earlier upload
+        // resolved.
         // POST /academy/:academy_uid/uid/check - AcademyUidCheck
         check: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/uid/check`, { body: request }),
     };
@@ -184,18 +196,20 @@ class BolbolAcademyScope {
     };
     // 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.
+    // Collection, the one kind only an academy holds - six kinds: collections,
+    // extensions, materials, courses, events and packages, each until a date,
+    // for good, or not at all. The calls
+    // a kind gates answer 403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED
+    // without it, and each asks exactly one: creating a collection, series,
+    // item or asset and publishing a collection (Collection); creating or
+    // publishing an extension, adding a component to one and creating any
+    // component (Extension alone, P16); creating or publishing a package and
+    // adding a product to one (Package); creating or publishing a material,
+    // a course or an event (its own kind); creating a folder or a resource
+    // (Material). 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
@@ -296,22 +310,42 @@ class BolbolAcademyScope {
             list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/teacher/join`),
         },
     };
-    // An academy's collections, each answered with its latest version's
-    // content. Edits to a published version land on a new draft version. The
-    // pricing settings sit on the collection's identity row instead and change
-    // only through `setting.pricing.update` (or `create`).
+    // An academy's collections - the academy's product (Bolbol API Plan.html
+    // 2.1), each answered with its identity (name, `signed`) and its latest
+    // version's content. A collection is created unsigned: until the academy
+    // has signed the contract the create writes (`contract.list` below; signed
+    // through the academy's own `contract.sign`), every write and every read
+    // below the identity answers 403 PRODUCT_NOT_SIGNED (P15) - `list`, `get`,
+    // `contract.list` and `delete` stay open. The name is edited in place on
+    // the identity; the notes and the series membership land on a draft
+    // version, forked when the latest is published (P3). A collection has no
+    // pricing settings (P13): its price is a pricing assignment
+    // (`pricingAssignment`), and the terms it offers educators and packagers
+    // are the contract templates on its four C slots (`contractTemplate`).
     collection = {
         // GET /academy/:academy_uid/collection - AcademyCollectionList
         list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection`),
-        // The pricing settings may ride along, so a collection can be priced
-        // as it is created.
+        // Writes the identity (`signed: false`), version 1 (a draft) and the one
+        // contract a collection requires - Bolbol_Collection_Commission_Owner,
+        // Bolbol's side already signed - in one transaction (plan 2.2 / 2.3),
+        // and answers the unsigned row. No pricing rides along (P13). Needs the
+        // academy's Collection authorization.
         // POST /academy/:academy_uid/collection - AcademyCollectionCreate
         create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection`, { body: request }),
+        // Open while unsigned: `item.signed` says whether a page shows the
+        // collection or only its contract panel.
         // GET /academy/:academy_uid/collection/:collection_uid - AcademyCollectionGet
         get: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`),
-        // language_id, exam_id and the pricing settings are not editable here.
+        // Writes only the fields sent, a patch: the name in place on the
+        // identity, the notes on the draft (P3) - a body that only renames the
+        // collection opens no draft. language_id and exam_id are fixed.
         // PUT /academy/:academy_uid/collection/:collection_uid - AcademyCollectionUpdate
         update: (academy_uid, collection_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`, { body: request }),
+        // Open while unsigned. The collection's contracts are kept: a contract
+        // is never deleted. No package pin refuses it (no COLLECTION_IN_USE -
+        // open, Bolbol API rules/Product.md "Open points"): a package that
+        // pins the collection keeps the pin, with `product.deleted: true`, and
+        // refuses its next publish (409 PACKAGE_PRODUCT_DELETED).
         // DELETE /academy/:academy_uid/collection/:collection_uid - AcademyCollectionDelete
         delete: (academy_uid, collection_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}`),
         // Uploads a zipped Academy project and applies it declaratively onto
@@ -320,24 +354,15 @@ class BolbolAcademyScope {
         // calls the create/update controllers use (versioning preserved), uids
         // in the project but not on the server are created, uids on the server
         // but not in the project are soft-deleted. Only the academy project's
-        // folders are read: pricing/, collection/, series/, item/, asset/. The
+        // folders are read: pricing/, collection/, series/, item/, asset/. A
+        // collection it creates is unsigned, like one `create` makes, so its
+        // series, pricing assignments and template slots wait - logged as
+        // `deferred` - for an upload after the academy has signed it (P19). The
         // server unzips to a temp folder and deletes it on success or failure.
         // No timeout: the work grows with the project (a first upload creates
         // every entity).
         // POST /academy/:academy_uid/collection/upload - AcademyCollectionUpload
         upload: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/upload`, { body: request, timeoutMs: null }),
-        setting: {
-            // Which of the academy's pricings a user pays to take the
-            // collection and a 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 }),
-            },
-        },
         // The preview's counts: students, skills, tasks, series and items, and
         // the distinct assets the latest version uses.
         // GET /academy/:academy_uid/collection/:collection_uid/count - AcademyCollectionCount
@@ -354,7 +379,7 @@ class BolbolAcademyScope {
             // 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`
+            // components and extensions on, as `teacher.collection.version.list`
             // answers a teacher. `list` above answers every version of one of
             // the academy's own collections, drafts included. Collections are
             // found through the public `bolbol.collection.directory.list`.
@@ -370,10 +395,14 @@ class BolbolAcademyScope {
             // 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.
+            // (Approved or Premium) - drafts and uploads stay open meanwhile -
+            // and, like every write, 403 PRODUCT_NOT_SIGNED while the
+            // collection is unsigned (P15).
             // POST /academy/:academy_uid/collection/:collection_uid/version/publish - AcademyCollectionVersionPublish
             publish: (academy_uid, collection_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/publish`),
             // Drops the latest version, which must still be a draft.
+            // Discarding the only version takes the collection out of the list
+            // (its get answers 404 COLLECTION_VERSION_NO_LATEST).
             // DELETE /academy/:academy_uid/collection/:collection_uid/version/latest - AcademyCollectionVersionDelete
             deleteLast: (academy_uid, collection_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/latest`),
         },
@@ -404,6 +433,51 @@ class BolbolAcademyScope {
             // PUT /academy/:academy_uid/collection/:collection_uid/version/series/:series_uid - AcademyCollectionVersion_SeriesVersionReplace
             replace: (academy_uid, collection_uid, series_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/version/series/${encodeURIComponent(series_uid)}`, { body: request }),
         },
+        // The contracts the collection requires - the ones its `signed` waits
+        // for. Open while the collection is unsigned, for the contract
+        // section; negotiating and signing one is `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/collection/:collection_uid/contract - AcademyCollectionContractList
+            list: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/contract`),
+        },
+        // The templates attached to the collection's four C slots: C1
+        // Academy_Collection_Licensing_Educator, C2
+        // Educator_Extension_Licensing_Academy and C3
+        // Educator_Collection_Commission_Academy, the terms an educator who
+        // extends the collection is offered (P11); C4
+        // Owner_Collection_Packaging_Packager, those a packager who bundles it
+        // is offered (P10). Both calls answer 403 PRODUCT_NOT_SIGNED while the
+        // collection is unsigned, the get included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /academy/:academy_uid/collection/:collection_uid/contract-template - AcademyCollectionContractTemplateGet
+            get: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/contract-template`),
+            // All four slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /academy/:academy_uid/collection/:collection_uid/contract-template - AcademyCollectionContractTemplateSet
+            set: (academy_uid, collection_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/contract-template`, { body: request }),
+        },
+        // The academy's pricings put on the collection, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Collection_Sell_User); with none in
+        // force the collection shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the collection is unsigned, the list
+        // included (P15).
+        pricingAssignment: {
+            // GET /academy/:academy_uid/collection/:collection_uid/pricing-assignment - AcademyCollectionPricingAssignmentList
+            list: (academy_uid, collection_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the collection.
+            // POST /academy/:academy_uid/collection/:collection_uid/pricing-assignment - AcademyCollectionPricingAssignmentCreate
+            create: (academy_uid, collection_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/collection/:collection_uid/pricing-assignment/:pricing_assignment_uid - AcademyCollectionPricingAssignmentUpdate
+            update: (academy_uid, collection_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/collection/:collection_uid/pricing-assignment/:pricing_assignment_uid - AcademyCollectionPricingAssignmentDelete
+            delete: (academy_uid, collection_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/collection/${encodeURIComponent(collection_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
     };
     // An academy's items, each answered with its latest version's content.
     // Edits to a published version land on a new draft version. An item is
@@ -538,9 +612,10 @@ class BolbolAcademyScope {
     };
     // The academy's pricings (Bolbol API rules/Pricing.md): named price lists,
     // each with one region per country plus at most one fallback region for
-    // every other country. A collection's pricing settings, a package's sell
-    // pricing and the academy's membership setting each name one of them.
-    // Prices are whole eggs.
+    // every other country. A product's pricing assignments (the price it
+    // sells at, `<product>.pricingAssignment` - a collection's too, P13), a
+    // contract template's terms and the academy's membership setting each
+    // name one of them. Prices are whole eggs.
     pricing = {
         // `search` narrows by uid or name.
         // GET /academy/:academy_uid/pricing - AcademyPricingList
@@ -554,9 +629,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, a package's sell pricing or the academy's membership
-        // setting still names it.
+        // Soft delete. 409 PRICING_IN_USE while a live pricing assignment, a
+        // live contract template or the academy's membership setting still
+        // names it (P13).
         // DELETE /academy/:academy_uid/pricing/:pricing_uid - AcademyPricingDelete
         delete: (academy_uid, pricing_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/pricing/${encodeURIComponent(pricing_uid)}`),
         // A pricing's regions, addressed by their numeric `pricing_region_id`.
@@ -577,19 +652,122 @@ class BolbolAcademyScope {
             delete: (academy_uid, pricing_uid, pricing_region_id) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/pricing/${encodeURIComponent(pricing_uid)}/region/${pricing_region_id}`),
         },
     };
-    // The contracts the academy is one end of (Bolbol API rules/Pricing.md):
-    // append-only price agreements the server writes itself - 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.
+    // The contracts the academy is one end of - the twin of `teacher.contract`,
+    // same bodies and answers (Bolbol API rules/Contract.md). Every product
+    // is created unsigned with the contracts it requires - Bolbol's commission
+    // on it, and the licensing, packaging and commission contracts of another
+    // owner's collection or product it extends or bundles - and stays locked
+    // (403 PRODUCT_NOT_SIGNED) until each of them is signed by both parties
+    // (P15); `<product>.contract.list` reads one product's. The academy also
+    // owns the contracts its collections spawn on others' products: an
+    // educator's extension of one of them comes with the three Educator
+    // contracts (the collection's licence, the extension's licence, the
+    // commission on the collection - none when the academy extends its own
+    // collection, P11), and a package bundling one with its
+    // Owner_Collection_Packaging_Packager contract (P10). A contract is
+    // negotiated, then signed: its owner (`owner_type` / `owner_uid` - the
+    // owner whose template slot it was written from, Bolbol for a Bolbol_
+    // type, P7) edits the terms while it is not fully signed, every edit
+    // clearing all four signatures; each party signs its own side (party 1
+    // the producer, party 2 the consumer); signed by both, it is frozen for
+    // good, and once its duration has run out it reads as expired - shown
+    // only, nothing else changes (P21). The two parties chat on every
+    // contract, a thread kept for good (P22); a signature, a terms edit and a
+    // message each notify the other party when it is an academy or a teacher
+    // (P14) - Bolbol, with no user to receive one, is not notified (open,
+    // Bolbol API rules/Contract.md "Open points").
+    // Every pricing assignment of the academy's products, its collections included,
+    // across them all. Each row names its product; one is written through its
+    // product's own `<product>.pricingAssignment`.
+    pricingAssignment = {
+        // GET /academy/:academy_uid/pricing-assignment - AcademyPricingAssignmentList
+        list: (academy_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/pricing-assignment`),
+    };
     contract = {
-        // `role` narrows to the contracts the academy produced or consumed,
-        // `type` to one contract type.
+        // Newest first. `role` narrows to the side the academy sits on,
+        // `type` to one contract type, `product_type` / `product_uid` to the
+        // contracts one product kind or one product requires (a uid needs
+        // its kind), `signed` to the fully signed or the open ones.
         // GET /academy/:academy_uid/contract - AcademyContractList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract`, { query: request }),
-        // 403 unless the academy is one of the contract's two ends.
+        // 404 CONTRACT_NOT_FOUND; 403 CONTRACT_FORBIDDEN unless the academy
+        // is the contract's producer or its consumer. Readable in every state.
         // GET /academy/:academy_uid/contract/:contract_uid - AcademyContractGet
         get: (academy_uid, contract_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}`),
+        // The terms, written by the contract's owner while not both parties
+        // have signed: every field is written, the price requoted at the
+        // consumer's region and all four signatures cleared (whoever had
+        // signed signs again); the other party is notified. 403
+        // CONTRACT_NOT_OWNER for the other party, 409 CONTRACT_ALREADY_SIGNED
+        // once both have signed; the field errors are on the request type.
+        // PUT /academy/:academy_uid/contract/:contract_uid - AcademyContractUpdate
+        update: (academy_uid, contract_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}`, { body: request }),
+        // Signs the academy's own side (no body): party 1 as the producer,
+        // party 2 as the consumer, with the time and the caller's IP - the
+        // answer, like every contract read here, carries the address of the
+        // academy's side only, the other side's null (ContractRowType). The
+        // second signature completes the contract (`signed_at`, and
+        // `expires_at` with a duration) and, when it was the product's last
+        // open contract, unlocks the product (`product_signed`). 409
+        // CONTRACT_ALREADY_SIGNED_BY_PARTY when the academy's side is signed
+        // already, 409 CONTRACT_ALREADY_SIGNED once both are.
+        // POST /academy/:academy_uid/contract/:contract_uid/sign - AcademyContractSign
+        sign: (academy_uid, contract_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}/sign`),
+        // The contract's chat between its two parties: open before and after
+        // signing and after expiry; a message is never edited or deleted
+        // (P22).
+        message: {
+            // Oldest first, paged; omitted, the whole thread.
+            // GET /academy/:academy_uid/contract/:contract_uid/message - AcademyContractMessageList
+            list: (academy_uid, contract_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}/message`, { query: request }),
+            // Posts from the academy's side, signed by the caller's user; the
+            // other party is notified. 400 CONTRACT_MESSAGE_EMPTY for a text
+            // that is empty once trimmed.
+            // POST /academy/:academy_uid/contract/:contract_uid/message - AcademyContractMessageAdd
+            add: (academy_uid, contract_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/contract/${encodeURIComponent(contract_uid)}/message`, { body: request }),
+        },
+    };
+    // The academy's contract templates - the twin of
+    // `teacher.contractTemplate`, same bodies and answers (Bolbol API
+    // rules/Contract.md, P9): the terms the academy offers under one contract
+    // type - a pricing or free, the producer's share as a fraction, exclusive
+    // or not, a duration or none - under a name only the academy sees. An
+    // academy defines twelve types: the eight Owner_*_Licensing_Packager /
+    // Owner_*_Packaging_Packager types of its extensions, materials, courses
+    // and events, its collections' Owner_Collection_Packaging_Packager, and
+    // the three Educator types an educator's extension of one of its
+    // collections signs (Academy_Collection_Licensing_Educator,
+    // Educator_Extension_Licensing_Academy,
+    // Educator_Collection_Commission_Academy); 400
+    // CONTRACT_TEMPLATE_TYPE_OWNER for any other type. A product attaches one
+    // per slot (`<product>.contractTemplate.set`, a collection's four through
+    // `collection.contractTemplate.set`), and each contract that slot spawns
+    // is written from it, owned by the academy, which may still negotiate it
+    // there (`contract.update`); a slot without a template gives the default
+    // terms (free, 0 / 1, not exclusive, no duration). Editing or deleting a
+    // template never changes a contract already written from it.
+    contractTemplate = {
+        // The academy's live templates in name order. `type` narrows to one
+        // contract type (a slot's picker), `search` by uid or name.
+        // GET /academy/:academy_uid/contract-template - AcademyContractTemplateList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract-template`, { query: request }),
+        // A field left out takes the default terms. The type is immutable
+        // afterwards.
+        // POST /academy/:academy_uid/contract-template - AcademyContractTemplateCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/contract-template`, { body: request }),
+        // 404 CONTRACT_TEMPLATE_NOT_FOUND for an unknown or deleted uid, 403
+        // CONTRACT_TEMPLATE_FORBIDDEN for another owner's template.
+        // GET /academy/:academy_uid/contract-template/:contract_template_uid - AcademyContractTemplateGet
+        get: (academy_uid, contract_template_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/contract-template/${encodeURIComponent(contract_template_uid)}`),
+        // Only the fields sent change (no `type`); reaches the contracts
+        // written after it only.
+        // PUT /academy/:academy_uid/contract-template/:contract_template_uid - AcademyContractTemplateUpdate
+        update: (academy_uid, contract_template_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/contract-template/${encodeURIComponent(contract_template_uid)}`, { body: request }),
+        // A soft delete, never refused for being in use: contracts keep the
+        // template as their provenance, and a slot that still names it counts
+        // as having none - default terms from then on.
+        // DELETE /academy/:academy_uid/contract-template/:contract_template_uid - AcademyContractTemplateDelete
+        delete: (academy_uid, contract_template_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/contract-template/${encodeURIComponent(contract_template_uid)}`),
     };
     // The academy's learning kits - the twin of `teacher.learningKit`, same
     // bodies and answers. A kit is the learning material authored for one
@@ -696,7 +874,7 @@ class BolbolAcademyScope {
                     // 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):
+                // The value's word list (extension.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: {
@@ -850,6 +1028,8 @@ class BolbolAcademyScope {
         // 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 }),
+        // Needs the academy's Material authorization (403 AUTHORIZATION_REQUIRED /
+        // AUTHORIZATION_EXPIRED).
         // 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
@@ -878,13 +1058,14 @@ class BolbolAcademyScope {
     // `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`).
+    // material bundles them, each through a material resource
+    // (`material.resource`, P4).
     video = {
         // Paged; narrowed by language, folder, exam / skill / task, or searched
         // by uid and name.
         // GET /academy/:academy_uid/video - AcademyVideoList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/video`, { query: request }),
-        // Needs the academy's Video authorization (403 AUTHORIZATION_REQUIRED /
+        // Needs the academy's Material 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 }),
@@ -894,9 +1075,9 @@ class BolbolAcademyScope {
         // 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).
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
         // DELETE /academy/:academy_uid/video/:video_uid - AcademyVideoDelete
         delete: (academy_uid, video_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/video/${encodeURIComponent(video_uid)}`),
         // The exams (and optionally skills and tasks) the video serves,
@@ -966,7 +1147,7 @@ class BolbolAcademyScope {
         // 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
+        // Needs the academy's Material 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 }),
@@ -976,9 +1157,9 @@ class BolbolAcademyScope {
         // 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).
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
         // DELETE /academy/:academy_uid/podcast/:podcast_uid - AcademyPodcastDelete
         delete: (academy_uid, podcast_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/podcast/${encodeURIComponent(podcast_uid)}`),
         // The exams (and optionally skills and tasks) the podcast serves,
@@ -1049,7 +1230,7 @@ class BolbolAcademyScope {
         // 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 /
+        // Needs the academy's Material 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 }),
@@ -1058,9 +1239,9 @@ class BolbolAcademyScope {
         // 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).
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
         // DELETE /academy/:academy_uid/file/:file_uid - AcademyFileDelete
         delete: (academy_uid, file_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/file/${encodeURIComponent(file_uid)}`),
         // The exams (and optionally skills and tasks) the file serves, replaced
@@ -1131,7 +1312,7 @@ class BolbolAcademyScope {
         // 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 /
+        // Needs the academy's Material 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 }),
@@ -1140,9 +1321,9 @@ class BolbolAcademyScope {
         // 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).
+        // Soft delete; 409 RESOURCE_IN_USE while a material's latest version
+        // holds a material resource of it, or its unpublished draft deleted
+        // one (discarding the draft would bring it back).
         // DELETE /academy/:academy_uid/url/:url_uid - AcademyUrlDelete
         delete: (academy_uid, url_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/url/${encodeURIComponent(url_uid)}`),
         // The exams (and optionally skills and tasks) the URL serves, replaced
@@ -1202,39 +1383,42 @@ class BolbolAcademyScope {
     // 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.
+    // another academy's (D13) - and every component is on one: a bundle of
+    // the academy's library resources is a material now (`material`, P4).
+    // Its type (fixed at create, like the collection version and the exam /
+    // skill / task) says which kind of child it holds - ref assets, ref
+    // items, answers or ambiguities - and which of their fields it fills
+    // (ComponentTypeEnum). The children's endpoints nest under it, as their
+    // URLs do. Every write to a component (but its kit list, kept on the
+    // identity) or to a child lands on a draft, forking one when the latest
+    // version is published; nothing here publishes - publishing an extension
+    // that lists the component does (P2). A component is not a product: it
+    // has no contract and no `signed` of its own.
     component = {
         // Paged, ordered by skill, then task - a null (every skill / task)
         // after the others - then oldest first. Every filter is optional;
         // omitted, every live component of the academy comes back.
         // GET /academy/:academy_uid/component - AcademyComponentList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component`, { query: request }),
-        // Creates the component and its version 1 (a draft): on 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).
+        // Creates the component and its version 1 (a draft) on the published
+        // collection version the body names - of its own collection or of
+        // another academy's - which fixes its exam. Signs no contract on any
+        // collection: the contracts of building on another academy's
+        // collection belong to the extension, whose create spawns them (P11).
+        // Needs the academy's Extension authorization alone - the one kind
+        // for extensions and components (P16) - else 403
+        // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED.
         // POST /academy/:academy_uid/component - AcademyComponentCreate
         create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/component`, { body: request }),
         // GET /academy/:academy_uid/component/:component_uid - AcademyComponentGet
         get: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}`),
-        // Name and notes only - the collection version, the scope and the
-        // type are fixed.
+        // The name with its translations, the colour, the icon and the notes
+        // (E7) - 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.
+        // Soft delete; 409 COMPONENT_IN_USE while a published extension
+        // version pins the component. The extension drafts that list it drop
+        // it.
         // DELETE /academy/:academy_uid/component/:component_uid - AcademyComponentDelete
         delete: (academy_uid, component_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}`),
         version: {
@@ -1258,9 +1442,7 @@ class BolbolAcademyScope {
         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.
+            // ref row, its state and the sheet value.
             // GET /academy/:academy_uid/component/:component_uid/hierarchy - AcademyComponentHierarchy
             get: (academy_uid, component_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/component/${encodeURIComponent(component_uid)}/hierarchy`),
         },
@@ -1459,164 +1641,728 @@ class BolbolAcademyScope {
                 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 academy's extensions - the twin of `teacher.extension`, same bodies
+    // and answers: versioned sets of the academy's components, each built on
+    // one published collection version - of its own collection or of another
+    // approved academy's (D13) - and answered with its latest version's
+    // content. An extension has no price of its own: `pricingAssignment`
+    // prices it for learners, and `contractTemplate` offers the terms a
+    // packager signs to bundle it. It is created unsigned - Bolbol's commission
+    // and, on another academy's collection, that collection's three educator
+    // contracts wait for their signatures (P11; on its own collection the
+    // academy signs no collection contract) - and until every one is signed
+    // only `list`, `get`, `delete` and `contract.list` answer; everything else
+    // is a 403 PRODUCT_NOT_SIGNED (P15). Edits to a published version land on
+    // a new draft version; `version.publish` is the only publish, and it
+    // publishes the pinned components and their children with it.
+    extension = {
+        // `collection_uid`, `collection_version_uid`, `exam_id`, a skill / task
+        // and `signed` narrow the list; omitted, every extension of the academy
+        // comes back, unsigned ones included. Paged, oldest first: an extension
+        // has no skill / task of its own.
+        // GET /academy/:academy_uid/extension - AcademyExtensionList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension`, { query: request }),
+        // Writes the identity, version 1 and every contract the extension
+        // requires in one transaction: Bolbol's commission and, on another
+        // academy's collection, that collection's three educator contracts on
+        // the terms of the templates its academy attached (P11) - on its own
+        // collection, Bolbol's commission alone. Answers it with
+        // `signed: false`.
+        // POST /academy/:academy_uid/extension - AcademyExtensionCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/extension`, { body: request }),
+        // Open while the extension is unsigned (P15).
+        // GET /academy/:academy_uid/extension/:extension_uid - AcademyExtensionGet
+        get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}`),
+        // Writes only the fields sent, a patch: the name, the colour and the
+        // icon in place on the identity (E7), the notes on the draft (P3) - a
+        // body that only renames or recolours the extension opens no draft.
+        // The collection version is not editable, and there is no price to
+        // edit.
+        // PUT /academy/:academy_uid/extension/:extension_uid - AcademyExtensionUpdate
+        update: (academy_uid, extension_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}`, { body: request }),
+        // A soft delete, open while unsigned; its contracts stay. 409
+        // EXTENSION_IN_USE while a published version of a live package pins it.
+        // DELETE /academy/:academy_uid/extension/:extension_uid - AcademyExtensionDelete
+        delete: (academy_uid, extension_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}`),
+        // The preview's counts: the components the latest version pins and
+        // the children those component versions pin, per kind.
+        // GET /academy/:academy_uid/extension/:extension_uid/count - AcademyExtensionCount
+        count: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/count`),
+        version: {
+            // GET /academy/:academy_uid/extension/:extension_uid/version - AcademyExtensionVersionList
+            list: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version`),
+            // The publish cascade: publishes the draft versions of the pinned
+            // components and their children, re-pins what moved (forking a new
+            // extension version when the latest is already published) and
+            // publishes the extension. 409 NOTHING_TO_PUBLISH when nothing moved.
+            // POST /academy/:academy_uid/extension/:extension_uid/version/publish - AcademyExtensionVersionPublish
+            publish: (academy_uid, extension_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft.
+            // Discarding the only version takes the extension out of the list
+            // (its get answers 404 EXTENSION_VERSION_NO_LATEST).
+            // DELETE /academy/:academy_uid/extension/:extension_uid/version/latest - AcademyExtensionVersionDelete
+            deleteLast: (academy_uid, extension_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/latest`),
+        },
+        // Which components this extension holds, on its latest version - the
+        // same five calls as `academy.collection.series`. An assignment is
+        // addressed by its COMPONENT uid; removing one unassigns the component
+        // only, the component survives.
+        component: {
+            // `version_number` reads an earlier version's assignments (the
+            // Changes tab).
+            // GET /academy/:academy_uid/extension/:extension_uid/version/component - AcademyExtensionVersion_ComponentVersionList
+            list: (academy_uid, extension_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component`, { query: request }),
+            // The component must be built on the extension's collection version.
+            // POST /academy/:academy_uid/extension/:extension_uid/version/component - AcademyExtensionVersion_ComponentVersionAdd
+            add: (academy_uid, extension_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component`, { body: request }),
+            // DELETE /academy/:academy_uid/extension/:extension_uid/version/component/:component_uid - AcademyExtensionVersion_ComponentVersionRemove
+            remove: (academy_uid, extension_uid, component_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/${encodeURIComponent(component_uid)}`),
+            // Writes nothing but `sort_order`. Position in `component_uids` IS the order.
+            // PUT /academy/:academy_uid/extension/:extension_uid/version/component/order - AcademyExtensionVersion_ComponentVersionReorder
+            reorder: (academy_uid, extension_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/order`, { body: request }),
+            // Swaps the pinned version of a component already in the extension;
+            // the body carries the target version_number (pick from
+            // academy.component.version.list).
+            // PUT /academy/:academy_uid/extension/:extension_uid/version/component/:component_uid - AcademyExtensionVersion_ComponentVersionReplace
+            replace: (academy_uid, extension_uid, component_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/version/component/${encodeURIComponent(component_uid)}`, { body: request }),
+        },
+        hierarchy: {
+            // extension -> components -> children, at the latest version's pins.
+            // GET /academy/:academy_uid/extension/:extension_uid/hierarchy - AcademyExtensionHierarchy
+            get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/hierarchy`),
+        },
+        preview: {
+            // Every component's preview, in extension order - for the owner's
+            // preview tab and the Academy Application's dev preview.
+            // GET /academy/:academy_uid/extension/:extension_uid/preview - AcademyExtensionPreview
+            get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/preview`),
+        },
+        // The contracts the extension requires - the ones its `signed` waits
+        // for. Open while the extension is unsigned, for the contract section;
+        // negotiating and signing one is `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/extension/:extension_uid/contract - AcademyExtensionContractList
+            list: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/contract`),
+        },
+        // The templates attached to the extension's two C slots
+        // (Owner_Extension_Licensing_Packager,
+        // Owner_Extension_Packaging_Packager): the terms a packager who
+        // bundles the extension is offered. Both calls answer 403
+        // PRODUCT_NOT_SIGNED while the extension is unsigned, the get included
+        // (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /academy/:academy_uid/extension/:extension_uid/contract-template - AcademyExtensionContractTemplateGet
+            get: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /academy/:academy_uid/extension/:extension_uid/contract-template - AcademyExtensionContractTemplateSet
+            set: (academy_uid, extension_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/contract-template`, { body: request }),
+        },
+        // The academy's pricings put on the extension, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Extension_Sell_User); with none in
+        // force the extension shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the extension is unsigned, the list
+        // included (P15).
+        pricingAssignment: {
+            // GET /academy/:academy_uid/extension/:extension_uid/pricing-assignment - AcademyExtensionPricingAssignmentList
+            list: (academy_uid, extension_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the extension.
+            // POST /academy/:academy_uid/extension/:extension_uid/pricing-assignment - AcademyExtensionPricingAssignmentCreate
+            create: (academy_uid, extension_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/extension/:extension_uid/pricing-assignment/:pricing_assignment_uid - AcademyExtensionPricingAssignmentUpdate
+            update: (academy_uid, extension_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/extension/:extension_uid/pricing-assignment/:pricing_assignment_uid - AcademyExtensionPricingAssignmentDelete
+            delete: (academy_uid, extension_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/extension/${encodeURIComponent(extension_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The academy's materials (P4) - the twin of `teacher.material`, same
+    // bodies and answers: what the Resource component was, made a product of
+    // its own - a versioned bundle of the academy's library resources (videos,
+    // podcasts, files, URLs), each pinned by a material resource filed under
+    // folder NAMES copied into the material, so its folders are its own and
+    // moving the library's folders later changes nothing here. A material is
+    // in one language, fixed at create - every resource it holds is of it -
+    // and carries exam scopes on its identity, which place it in the exam
+    // directories (BolbolMaterialScope). It is created unsigned (P15): until
+    // the contract it requires - its Bolbol commission - is signed
+    // (`contract.sign`), it answers only `list`, `get`, `delete` and
+    // `contract.list`, every other call - the reads below the identity
+    // included - 403 PRODUCT_NOT_SIGNED. The name sits on the identity and is
+    // renamed in place; the notes and the material resources' placement land
+    // on a draft version, forking one when the latest is published (P3), and
+    // `version.publish` publishes them. Creating and publishing need the
+    // academy's Material authorization (P16; 403 AUTHORIZATION_REQUIRED /
+    // AUTHORIZATION_EXPIRED).
+    material = {
+        // `language_id`, an exam / skill / task (a scope of the exam whose
+        // skill / task is null or the one sent - a level left out narrows
+        // nothing), `signed` and `search` narrow the list; omitted, every
+        // material of the academy comes back. Paged, oldest first.
+        // GET /academy/:academy_uid/material - AcademyMaterialList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material`, { query: request }),
+        // Writes the identity with its language and scopes, version 1 (a
+        // draft) and the Bolbol commission contract with Bolbol's side signed,
+        // in one transaction; the material answers `signed: false` until the
+        // academy signs that contract too.
+        // POST /academy/:academy_uid/material - AcademyMaterialCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material`, { body: request }),
+        // Readable while unsigned.
+        // GET /academy/:academy_uid/material/:material_uid - AcademyMaterialGet
+        get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}`),
+        // Writes only the fields sent, a patch: the name in place on the
+        // identity, the notes on the draft (P3) - a body that only renames the
+        // material opens no draft. The language is fixed and the scopes are
+        // `scope.set`'s.
+        // PUT /academy/:academy_uid/material/:material_uid - AcademyMaterialUpdate
+        update: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}`, { body: request }),
+        // Soft delete, allowed while unsigned; 409 MATERIAL_IN_USE while a
+        // published version of a live package pins the material.
+        // DELETE /academy/:academy_uid/material/:material_uid - AcademyMaterialDelete
+        delete: (academy_uid, material_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}`),
+        // The exams (and optionally skills and tasks) the material serves,
+        // replaced as a whole on the identity - not versioned, no draft.
+        scope: {
+            // PUT /academy/:academy_uid/material/:material_uid/scope - AcademyMaterialScopeSet
+            set: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/scope`, { body: request }),
+        },
+        // The preview's counts: the material resources the latest version
+        // pins and the folders their paths spell out.
+        // GET /academy/:academy_uid/material/:material_uid/count - AcademyMaterialCount
+        count: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/count`),
+        version: {
+            // GET /academy/:academy_uid/material/:material_uid/version - AcademyMaterialVersionList
+            list: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/version`),
+            // Publishes the draft versions of the material resources the latest
+            // version pins and the material's draft with them - nothing below,
+            // a resource not being versioned. 409 NOTHING_TO_PUBLISH when
+            // nothing moved. Needs the Material authorization.
+            // POST /academy/:academy_uid/material/:material_uid/version/publish - AcademyMaterialVersionPublish
+            publish: (academy_uid, material_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft, and
+            // reverts the material resources it pinned to what the previous
+            // version pins. Discarding the only version takes the material out
+            // of the list (its get answers 404 MATERIAL_VERSION_NO_LATEST).
+            // DELETE /academy/:academy_uid/material/:material_uid/version/latest - AcademyMaterialVersionDelete
+            deleteLast: (academy_uid, material_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/version/latest`),
+        },
+        hierarchy: {
+            // The material resources the latest version pins, as their folder
+            // tree - what a Resource component's hierarchy was.
+            // GET /academy/:academy_uid/material/:material_uid/hierarchy - AcademyMaterialHierarchy
+            get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/hierarchy`),
+        },
+        preview: {
+            // The material as it would be shown, its material resources' folder
+            // tree with each resource as `source` - for the owner's preview tab
+            // and the Academy Application's dev preview.
+            // GET /academy/:academy_uid/material/:material_uid/preview - AcademyMaterialPreview
+            get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/preview`),
+        },
+        // The contracts the material requires - the ones its `signed` waits
+        // for. Open while the material is unsigned, for the contract section;
+        // negotiating and signing one is `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/material/:material_uid/contract - AcademyMaterialContractList
+            list: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/contract`),
+        },
+        // The templates attached to the material's two C slots
+        // (Owner_Material_Licensing_Packager,
+        // Owner_Material_Packaging_Packager): the terms a packager who bundles
+        // the material is offered. Both calls answer 403 PRODUCT_NOT_SIGNED
+        // while the material is unsigned, the get included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /academy/:academy_uid/material/:material_uid/contract-template - AcademyMaterialContractTemplateGet
+            get: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /academy/:academy_uid/material/:material_uid/contract-template - AcademyMaterialContractTemplateSet
+            set: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/contract-template`, { body: request }),
+        },
+        // The academy's pricings put on the material, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Material_Sell_User); with none in
+        // force the material shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the material is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /academy/:academy_uid/material/:material_uid/pricing-assignment - AcademyMaterialPricingAssignmentList
+            list: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the material.
+            // POST /academy/:academy_uid/material/:material_uid/pricing-assignment - AcademyMaterialPricingAssignmentCreate
+            create: (academy_uid, material_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/material/:material_uid/pricing-assignment/:pricing_assignment_uid - AcademyMaterialPricingAssignmentUpdate
+            update: (academy_uid, material_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/material/:material_uid/pricing-assignment/:pricing_assignment_uid - AcademyMaterialPricingAssignmentDelete
+            delete: (academy_uid, material_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+        // The material's material resources - the former ref resources: the
+        // academy's own library resources of the material's language it
+        // bundles, at most one per resource. Each is filed under a folder path
+        // inside the material - folder NAMES, copied, so the material's
+        // folders are its own. None of these calls needs an authorization.
+        resource: {
+            // The live material resources at their latest versions, each with
+            // the resource it pins (`source`). Paged; `resource_type` narrows
+            // to one kind.
+            // GET /academy/:academy_uid/material/:material_uid/resource - AcademyMaterialResourceList
+            list: (academy_uid, material_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource`, { query: request }),
             // The same rows as a folder tree built from their paths - the loose
             // ones first, then the root folders.
-            // GET /academy/:academy_uid/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`),
+            // GET /academy/:academy_uid/material/:material_uid/resource/tree - AcademyMaterialResourceTree
+            tree: (academy_uid, material_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/tree`),
             // Bundles one resource of the academy's: version 1, a draft, pinned
-            // by the component's draft (a ref resource it had - deleted, or
+            // by the material's draft (a material resource it had - deleted, or
             // unlinked by a discarded draft - is brought back). Another
             // owner's or an unknown resource answers its own 403 / 404
-            // (RESOURCE_<E>_FORBIDDEN / RESOURCE_<E>_NOT_FOUND); 409
-            // REF_RESOURCE_DUPLICATE when the component holds it already.
-            // POST /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.
+            // (RESOURCE_<E>_FORBIDDEN / RESOURCE_<E>_NOT_FOUND), one of another
+            // language 400 MATERIAL_RESOURCE_LANGUAGE_MISMATCH; 409
+            // MATERIAL_RESOURCE_DUPLICATE when the material holds it already.
+            // POST /academy/:academy_uid/material/:material_uid/resource - AcademyMaterialResourceCreate
+            create: (academy_uid, material_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource`, { body: request }),
+            // Bundles a library folder (with everything under it in the
+            // material's language, as folder paths) and / or picked resources
+            // in one call; the ones the material holds already are left as they
+            // are. All is resolved before the first write - a refused import
+            // writes nothing (400 MATERIAL_RESOURCE_LANGUAGE_MISMATCH for a
+            // pick of another language, 400 MATERIAL_RESOURCE_FOLDER_TOO_DEEP
+            // for a copied path deeper than 32 folders). Answers how many
+            // material resources it added (created or brought back) and the
+            // material's new tree.
+            // POST /academy/:academy_uid/material/:material_uid/resource/import - AcademyMaterialResourceImport
+            import: (academy_uid, material_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/import`, { body: request }),
+            // The material's folders exist only as its material resources'
+            // folder paths, so they are renamed and moved by rewriting those.
             folder: {
-                // Replaces the `from_path` prefix with `to_path` on every 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 }),
+                // Replaces the `from_path` prefix with `to_path` on every
+                // material resource under it, through their drafts; a `to_path`
+                // the material has already merges the two. Before anything is
+                // written: 409 FOLDER_CYCLE for a `to_path` inside `from_path`,
+                // 400 MATERIAL_RESOURCE_FOLDER_TOO_DEEP when a moved path would
+                // be deeper than 32 folders.
+                // PUT /academy/:academy_uid/material/:material_uid/resource/folder - AcademyMaterialResourceFolderRename
+                rename: (academy_uid, material_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/folder`, { body: request }),
             },
-            // GET /academy/:academy_uid/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
+            // GET /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid - AcademyMaterialResourceGet
+            get: (academy_uid, material_uid, material_resource_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`),
+            // Its place in the material - folder path, main entity, order; the
             // resource it pins is fixed.
-            // PUT /academy/:academy_uid/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)}`),
+            // PUT /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid - AcademyMaterialResourceUpdate
+            update: (academy_uid, material_uid, material_resource_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`, { body: request }),
+            // DELETE /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid - AcademyMaterialResourceDelete
+            delete: (academy_uid, material_uid, material_resource_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}`),
             version: {
-                // GET /academy/:academy_uid/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`),
+                // GET /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid/version - AcademyMaterialResourceVersionList
+                list: (academy_uid, material_uid, material_resource_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}/version`),
                 // Drops the latest version, which must still be a draft.
-                // DELETE /academy/:academy_uid/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`),
+                // DELETE /academy/:academy_uid/material/:material_uid/resource/:material_resource_uid/version/latest - AcademyMaterialResourceVersionDelete
+                deleteLast: (academy_uid, material_uid, material_resource_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/material/${encodeURIComponent(material_uid)}/resource/${encodeURIComponent(material_resource_uid)}/version/latest`),
             },
         },
     };
+    // The academy's courses - the twin of `teacher.course`, same bodies and
+    // answers: the recurring products (instruction item 4), sessions of one
+    // length that repeat weekly or monthly in the time windows of a schedule,
+    // each open to a limited number of students and taught by one of the
+    // academy's teachers (`teacher.list`, its roster), answered with the
+    // latest version's content. The name and the scopes sit on the identity
+    // (P3, P5); every other field and the schedule are versioned - edits to a
+    // published version land on a new draft, and `version.publish` is the
+    // only publish (no cascade: a course pins nothing). A course is created
+    // unsigned: until its contracts are signed (`contract.list`, then
+    // `academy.contract.sign`) only `list`, `get`, `contract.list` and
+    // `delete` answer, everything else is a 403 PRODUCT_NOT_SIGNED (P15).
+    course = {
+        // A language, an exam / skill / task (a scope row covering it, a
+        // level left out narrowing nothing), `signed` and `search` narrow the
+        // list; omitted, every course of the academy comes back, unsigned ones
+        // included. Paged, oldest first.
+        // GET /academy/:academy_uid/course - AcademyCourseList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course`, { query: request }),
+        // Writes the identity with its scopes, version 1 (a draft with every
+        // other field and the schedule) and the course's Bolbol commission
+        // contract (Bolbol pre-signed) in one transaction, and answers the
+        // course with `signed: false`. Its teacher is one of the academy's,
+        // or none yet (400 COURSE_TEACHER_NOT_MEMBER for a teacher off the
+        // roster). Needs the academy's Course authorization (403
+        // AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/course - AcademyCourseCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/course`, { body: request }),
+        // Open while the course is unsigned: the contract section names the
+        // course from it.
+        // GET /academy/:academy_uid/course/:course_uid - AcademyCourseGet
+        get: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}`),
+        // Writes only the fields sent, a patch (P3): the name in place on the
+        // identity, the rest on the draft (forked from a published latest) - a
+        // body that only renames the course opens no draft. The scopes and the
+        // schedule are not editable here (`scope.set`, `schedule.set`).
+        // PUT /academy/:academy_uid/course/:course_uid - AcademyCourseUpdate
+        update: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}`, { body: request }),
+        // A soft delete, allowed while unsigned (the contracts stay); 409
+        // COURSE_IN_USE while a published version of a live package pins the
+        // course.
+        // DELETE /academy/:academy_uid/course/:course_uid - AcademyCourseDelete
+        delete: (academy_uid, course_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}`),
+        // What the course is about - languages, optionally narrowed to exams,
+        // skills and tasks - replaced as a whole on the identity and not
+        // versioned: where the directories list the course, and which
+        // packages may bundle it (P6).
+        scope: {
+            // PUT /academy/:academy_uid/course/:course_uid/scope - AcademyCourseScopeSet
+            set: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/scope`, { body: request }),
+        },
+        // The time windows the sessions run in - version content, so a
+        // published version keeps the ones it was published with.
+        schedule: {
+            // Replaces the draft's windows as a whole (forking a draft from a
+            // published latest); position IS the order. Judged against the
+            // draft's recurrence and session length: 400
+            // COURSE_SCHEDULE_INVALID / COURSE_SCHEDULE_OVERLAP.
+            // PUT /academy/:academy_uid/course/:course_uid/schedule - AcademyCourseScheduleSet
+            set: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/schedule`, { body: request }),
+        },
+        version: {
+            // GET /academy/:academy_uid/course/:course_uid/version - AcademyCourseVersionList
+            list: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/version`),
+            // Stamps the latest version, a draft, published - nothing else
+            // moves. 409 COURSE_VERSION_ALREADY_PUBLISHED without a draft; 400
+            // COURSE_SCHEDULE_EMPTY while it has no time window. Needs the
+            // Course authorization.
+            // POST /academy/:academy_uid/course/:course_uid/version/publish - AcademyCourseVersionPublish
+            publish: (academy_uid, course_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft, with its
+            // schedule rows. Discarding the only version takes the course out
+            // of the list (its get answers 404 COURSE_VERSION_NO_LATEST).
+            // DELETE /academy/:academy_uid/course/:course_uid/version/latest - AcademyCourseVersionDelete
+            deleteLast: (academy_uid, course_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/version/latest`),
+        },
+        preview: {
+            // The latest version as a learner would see it, its teacher
+            // resolved - for the owner's preview tab and the Academy
+            // Application's dev preview.
+            // GET /academy/:academy_uid/course/:course_uid/preview - AcademyCoursePreview
+            get: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/preview`),
+        },
+        // The contracts the course requires - the ones its `signed` waits for.
+        // Open while the course is unsigned, for the contract section;
+        // negotiating and signing one is `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/course/:course_uid/contract - AcademyCourseContractList
+            list: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/contract`),
+        },
+        // The templates attached to the course's two C slots
+        // (Owner_Course_Licensing_Packager, Owner_Course_Packaging_Packager):
+        // the terms a packager who bundles the course is offered. Both calls
+        // answer 403 PRODUCT_NOT_SIGNED while the course is unsigned, the get
+        // included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /academy/:academy_uid/course/:course_uid/contract-template - AcademyCourseContractTemplateGet
+            get: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /academy/:academy_uid/course/:course_uid/contract-template - AcademyCourseContractTemplateSet
+            set: (academy_uid, course_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/contract-template`, { body: request }),
+        },
+        // The academy's pricings put on the course, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Course_Sell_User); with none in
+        // force the course shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the course is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /academy/:academy_uid/course/:course_uid/pricing-assignment - AcademyCoursePricingAssignmentList
+            list: (academy_uid, course_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the course.
+            // POST /academy/:academy_uid/course/:course_uid/pricing-assignment - AcademyCoursePricingAssignmentCreate
+            create: (academy_uid, course_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/course/:course_uid/pricing-assignment/:pricing_assignment_uid - AcademyCoursePricingAssignmentUpdate
+            update: (academy_uid, course_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/course/:course_uid/pricing-assignment/:pricing_assignment_uid - AcademyCoursePricingAssignmentDelete
+            delete: (academy_uid, course_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/course/${encodeURIComponent(course_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
+    // The academy's events - the twin of `teacher.event`, same bodies and
+    // answers: the one-time products (instruction item 4), a single session
+    // with a start, an end and a registration limit, answered with the latest
+    // version's content. The name and the scopes sit on the identity (P3,
+    // P5); every other field is versioned - edits to a published version land
+    // on a new draft, and `version.publish` is the only publish (no cascade:
+    // nothing hangs below an event). An event is created unsigned: until its
+    // contracts are signed (`contract.list`, then `academy.contract.sign`)
+    // only `list`, `get`, `contract.list` and `delete` answer, everything
+    // else is a 403 PRODUCT_NOT_SIGNED (P15).
+    event = {
+        // A language, an exam / skill / task (a scope row covering it, a
+        // level left out narrowing nothing), `signed` and `search` narrow the
+        // list; omitted, every event of the academy comes back. Paged, oldest
+        // first.
+        // GET /academy/:academy_uid/event - AcademyEventList
+        list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event`, { query: request }),
+        // Writes the identity with its scopes, version 1 (a draft) and the
+        // event's Bolbol commission contract (Bolbol pre-signed), and answers
+        // the event with `signed: false`. Needs the academy's Event
+        // authorization (403 AUTHORIZATION_REQUIRED / AUTHORIZATION_EXPIRED).
+        // POST /academy/:academy_uid/event - AcademyEventCreate
+        create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/event`, { body: request }),
+        // Open while the event is unsigned.
+        // GET /academy/:academy_uid/event/:event_uid - AcademyEventGet
+        get: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}`),
+        // Writes only the fields sent, a patch (P3): the name in place on the
+        // identity, the rest on the draft (forked from a published latest) - a
+        // body that only renames the event opens no draft. The scopes are not
+        // editable here (`scope.set`).
+        // PUT /academy/:academy_uid/event/:event_uid - AcademyEventUpdate
+        update: (academy_uid, event_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}`, { body: request }),
+        // A soft delete, allowed while unsigned; 409 EVENT_IN_USE while a
+        // published version of a live package pins the event.
+        // DELETE /academy/:academy_uid/event/:event_uid - AcademyEventDelete
+        delete: (academy_uid, event_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}`),
+        // What the event is about - languages, optionally narrowed to exams,
+        // skills and tasks - replaced as a whole on the identity and not
+        // versioned: where the directories list the event.
+        scope: {
+            // PUT /academy/:academy_uid/event/:event_uid/scope - AcademyEventScopeSet
+            set: (academy_uid, event_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/scope`, { body: request }),
+        },
+        version: {
+            // GET /academy/:academy_uid/event/:event_uid/version - AcademyEventVersionList
+            list: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/version`),
+            // Stamps the latest version, a draft, published - nothing else
+            // moves. 409 EVENT_VERSION_ALREADY_PUBLISHED without a draft; 400
+            // EVENT_ENDED once the event is over. Needs the Event
+            // authorization.
+            // POST /academy/:academy_uid/event/:event_uid/version/publish - AcademyEventVersionPublish
+            publish: (academy_uid, event_uid) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/version/publish`),
+            // Drops the latest version, which must still be a draft.
+            // Discarding the only version takes the event out of the list (its
+            // get answers 404 EVENT_VERSION_NO_LATEST).
+            // DELETE /academy/:academy_uid/event/:event_uid/version/latest - AcademyEventVersionDelete
+            deleteLast: (academy_uid, event_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/version/latest`),
+        },
+        preview: {
+            // The latest version as a learner would see it - for the owner's
+            // preview tab and the Academy Application's dev preview.
+            // GET /academy/:academy_uid/event/:event_uid/preview - AcademyEventPreview
+            get: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/preview`),
+        },
+        // The contracts the event requires - the ones its `signed` waits for.
+        // Open while the event is unsigned, for the contract section;
+        // negotiating and signing one is `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/event/:event_uid/contract - AcademyEventContractList
+            list: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/contract`),
+        },
+        // The templates attached to the event's two C slots
+        // (Owner_Event_Licensing_Packager, Owner_Event_Packaging_Packager):
+        // the terms a packager who bundles the event is offered. Both calls
+        // answer 403 PRODUCT_NOT_SIGNED while the event is unsigned, the get
+        // included (P15).
+        contractTemplate: {
+            // One entry per slot, with or without a template.
+            // GET /academy/:academy_uid/event/:event_uid/contract-template - AcademyEventContractTemplateGet
+            get: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/contract-template`),
+            // Both slots as a whole; a null template attaches none (the
+            // default terms). Contracts already written keep their terms.
+            // PUT /academy/:academy_uid/event/:event_uid/contract-template - AcademyEventContractTemplateSet
+            set: (academy_uid, event_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/contract-template`, { body: request }),
+        },
+        // The academy's pricings put on the event, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Event_Sell_User); with none in
+        // force the event shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the event is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /academy/:academy_uid/event/:event_uid/pricing-assignment - AcademyEventPricingAssignmentList
+            list: (academy_uid, event_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the event.
+            // POST /academy/:academy_uid/event/:event_uid/pricing-assignment - AcademyEventPricingAssignmentCreate
+            create: (academy_uid, event_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/event/:event_uid/pricing-assignment/:pricing_assignment_uid - AcademyEventPricingAssignmentUpdate
+            update: (academy_uid, event_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/event/:event_uid/pricing-assignment/:pricing_assignment_uid - AcademyEventPricingAssignmentDelete
+            delete: (academy_uid, event_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/event/${encodeURIComponent(event_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+    };
     // The academy's packages - the twin of `teacher.package`, same bodies and
-    // answers: 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.
+    // answers: the complex product (P2, P6), an ordered list of pins of
+    // PUBLISHED versions of the five single products - collections,
+    // extensions, materials, courses and events - of any owner, all of the
+    // package's language and, for a collection or an extension, of its exam.
+    // The language and the exam are fixed at create, the name sits on the
+    // package itself and the notes on its versions (P3); each package is
+    // answered with its latest version's content. It is created unsigned -
+    // Bolbol's commission and, for every product of another owner it bundles,
+    // that product's licensing and packaging contracts (a collection's
+    // packaging contract only, P10; the academy's own collections and other
+    // products need none) wait for their signatures - and until every one is
+    // signed only `list`, `get`, `delete` and `contract.list` answer for it;
+    // every other read and every write is a 403 PRODUCT_NOT_SIGNED (P15).
+    // Adding another owner's product later unsigns it again until that
+    // product's contracts are signed (P6). Edits to a published version land
+    // on a new draft version; `version.publish` moves every pin to its
+    // product's latest published version and never publishes a product. A
+    // package has no price of its own - `pricingAssignment` prices it for
+    // learners - and no contract-template slots: nobody bundles a package.
     package = {
-        // `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.
+        // `language_id`, `exam_id`, `product_type` (a package pinning a
+        // product of that kind) and `signed` narrow the list; omitted, every
+        // package of the academy comes back, unsigned ones included. Paged,
+        // newest first.
         // GET /academy/:academy_uid/package - AcademyPackageList
         list: (academy_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package`, { query: request }),
-        // 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.
+        // Writes the package, its version 1 pinning `products` at their latest
+        // published versions, and every contract it requires in one
+        // transaction: Bolbol's commission, already signed by Bolbol, and the
+        // contracts of each product of another owner, on the terms of the
+        // templates that owner attached. Answers it with `signed: false`.
         // POST /academy/:academy_uid/package - AcademyPackageCreate
         create: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package`, { body: request }),
+        // Open while the package is unsigned (P15).
         // GET /academy/:academy_uid/package/:package_uid - AcademyPackageGet
         get: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}`),
-        // The collection version and the pricing are not editable here.
+        // Writes only the fields sent, a patch: the name in place on the
+        // identity, the notes on the draft (P3) - a body that only renames the
+        // package opens no draft. The language and the exam are not editable;
+        // the products change through `product`, the price through
+        // `pricingAssignment`.
         // PUT /academy/:academy_uid/package/:package_uid - AcademyPackageUpdate
         update: (academy_uid, package_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}`, { body: request }),
+        // A soft delete, open while unsigned; the contracts stay, the products
+        // it pinned are untouched.
         // DELETE /academy/:academy_uid/package/:package_uid - AcademyPackageDelete
         delete: (academy_uid, package_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}`),
-        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.
+        // The preview's counts: the products the latest version pins, per
+        // kind.
         // GET /academy/:academy_uid/package/:package_uid/count - AcademyPackageCount
         count: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/count`),
         version: {
             // GET /academy/:academy_uid/package/:package_uid/version - AcademyPackageVersionList
             list: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version`),
-            // The publish cascade: publishes the draft versions of the pinned
-            // components and their children, re-pins what moved (forking a new
-            // package version when the latest is already published) and
-            // publishes the package. 409 NOTHING_TO_PUBLISH when nothing moved.
+            // Moves every pin to its product's latest PUBLISHED version
+            // (forking a new package version when the latest is already
+            // published) and publishes the package - never a product: a
+            // product's draft waits for its own owner's publish. 409
+            // NOTHING_TO_PUBLISH when no pin would move; 409
+            // PACKAGE_PRODUCT_DELETED while the package holds a product deleted
+            // since it was added.
             // POST /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.
+            // Drops the latest version, which must still be a draft, and
+            // reverts its product pins. Discarding the only version takes the
+            // package out of the list (its get answers 404
+            // PACKAGE_VERSION_NO_LATEST).
             // DELETE /academy/:academy_uid/package/:package_uid/version/latest - AcademyPackageVersionDelete
             deleteLast: (academy_uid, package_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/latest`),
         },
-        // Which 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 }),
+        // Which products this package bundles, on the package's latest
+        // version - the same five calls as `extension.component`. A pin is
+        // addressed by its PRODUCT (`product_type` + `product_uid`); removing
+        // one unpins the product only, the product survives.
+        product: {
+            // `version_number` reads an earlier version's pins (the Changes
+            // tab). Unpaged: a package pins at most 200 products.
+            // GET /academy/:academy_uid/package/:package_uid/version/product - AcademyPackageVersion_ProductVersionList
+            list: (academy_uid, package_uid, request = {}) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/product`, { query: request }),
+            // Pins the product's latest published version at the end of the
+            // draft: a signed product of any owner, of the package's language
+            // - and exam, for a collection or an extension (P6). Another
+            // owner's product writes its contracts and puts the package back
+            // to `signed: false` until they are signed; the academy's own
+            // collections and other products write none.
+            // POST /academy/:academy_uid/package/:package_uid/version/product - AcademyPackageVersion_ProductVersionAdd
+            add: (academy_uid, package_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/product`, { body: request }),
+            // DELETE /academy/:academy_uid/package/:package_uid/version/product/:product_type/:product_uid - AcademyPackageVersion_ProductVersionRemove
+            remove: (academy_uid, package_uid, product_type, product_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/product/${encodeURIComponent(product_type)}/${encodeURIComponent(product_uid)}`),
+            // Writes nothing but `sort_order`. Position in `products` IS the
+            // order - one sequence across the five kinds.
+            // PUT /academy/:academy_uid/package/:package_uid/version/product/order - AcademyPackageVersion_ProductVersionReorder
+            reorder: (academy_uid, package_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/product/order`, { body: request }),
+            // Swaps the pinned version of a product already in the package for
+            // another PUBLISHED one; the body carries its version_number (every
+            // number up to the pin's `version_number_latest_published` is
+            // one).
+            // PUT /academy/:academy_uid/package/:package_uid/version/product/:product_type/:product_uid - AcademyPackageVersion_ProductVersionReplace
+            replace: (academy_uid, package_uid, product_type, product_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/version/product/${encodeURIComponent(product_type)}/${encodeURIComponent(product_uid)}`, { body: request }),
         },
         hierarchy: {
-            // package -> components -> children, at the latest version's pins.
+            // package -> products -> what each pinned version holds (a
+            // collection's skills and tasks, an extension's components and
+            // their children, a material's folders), at the latest version's
+            // pins.
             // GET /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.
+            // Every pinned product's preview at its pinned version, in package
+            // order - for the owner's preview tab and the Academy
+            // Application's dev preview.
             // GET /academy/:academy_uid/package/:package_uid/preview - AcademyPackagePreview
             get: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/preview`),
         },
-        // 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.
+        // The contracts the package requires - the ones its `signed` waits
+        // for. Open while the package is unsigned, for the contract section;
+        // negotiating and signing one is `academy.contract`.
+        contract: {
+            // Oldest first, unpaged.
+            // GET /academy/:academy_uid/package/:package_uid/contract - AcademyPackageContractList
+            list: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/contract`),
+        },
+        // The academy's pricings put on the package, each for an optional
+        // window - not versioned, never overlapping. The one in force is the
+        // price the directory shows (Owner_Package_Sell_User); with none in
+        // force the package shows no price. All four calls answer 403
+        // PRODUCT_NOT_SIGNED while the package is unsigned, the list included
+        // (P15).
+        pricingAssignment: {
+            // GET /academy/:academy_uid/package/:package_uid/pricing-assignment - AcademyPackagePricingAssignmentList
+            list: (academy_uid, package_uid) => this.http.get(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment`),
+            // 409 PRICING_ASSIGNMENT_OVERLAP when the window overlaps another
+            // live assignment of the package.
+            // POST /academy/:academy_uid/package/:package_uid/pricing-assignment - AcademyPackagePricingAssignmentCreate
+            create: (academy_uid, package_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment`, { body: request }),
+            // Every field is written: an end left out is open afterwards.
+            // PUT /academy/:academy_uid/package/:package_uid/pricing-assignment/:pricing_assignment_uid - AcademyPackagePricingAssignmentUpdate
+            update: (academy_uid, package_uid, pricing_assignment_uid, request) => this.http.put(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`, { body: request }),
+            // A soft delete.
+            // DELETE /academy/:academy_uid/package/:package_uid/pricing-assignment/:pricing_assignment_uid - AcademyPackagePricingAssignmentDelete
+            delete: (academy_uid, package_uid, pricing_assignment_uid) => this.http.delete(`/academy/${encodeURIComponent(academy_uid)}/package/${encodeURIComponent(package_uid)}/pricing-assignment/${encodeURIComponent(pricing_assignment_uid)}`),
+        },
+        // Uploads the learning content of a zipped academy project - contract
+        // templates, learning kits, resources, components and their children,
+        // and the products: extensions, materials, courses, events and
+        // packages - and applies it declaratively onto this academy, the twin
+        // of `teacher.package.upload` (same body, same answer): identical
+        // entities are left alone, differences go through the same per-entity
+        // drafts the endpoints use, new uids are created, managed uids missing
+        // from the project are soft-deleted. The Academy CLI sends it right
+        // after `collection.upload`, which applies the project's collections,
+        // series, items, assets and pricings. Never publishes and never signs:
+        // a product it creates is unsigned, and its membership, scopes,
+        // schedule, assignments and template slots wait for the first upload
+        // after signing - logged as `deferred` rows, each product's row
+        // carrying its `signed` (P19). No timeout: the work grows with the
+        // project.
         // POST /academy/:academy_uid/package/upload - AcademyPackageUpload
         upload: (academy_uid, request) => this.http.post(`/academy/${encodeURIComponent(academy_uid)}/package/upload`, { body: request, timeoutMs: null }),
     };