bolbol-sdk 2.0.1 → 2.0.3

package/README.md

@@ -1,7 +1,8 @@
 # bolbol-sdk
 
 The typed client for the Bolbol API. Every app that talks to the backend - the
-Console (Next.js) and the Academy CLI (Node) today - goes through this package
+Console (Next.js) and the Academy CLI (Node) today, and the Academy Application
+through the CLI's services and these types - goes through this package
 instead of calling `fetch` itself, so the shape of every request and answer is
 declared exactly once.
 
@@ -25,6 +26,8 @@ console.log(response.result.user.name);
   - [3. Types: one per file, named by what they are](#3-types-one-per-file-named-by-what-they-are)
   - [Translatable columns: `TranslationType`](#translatable-columns-translationtype)
   - [Notes columns: `notes`, `notes_translations`, `notes_private`](#notes-columns-notes-notes_translations-notes_private)
+  - [Owned content: `owner_type`, `owner_uid`](#owned-content-owner_type-owner_uid)
+  - [Learning scope: `exam_id`, `exam_skill_id`, `exam_skill_task_id`](#learning-scope-exam_id-exam_skill_id-exam_skill_task_id)
   - [4. Wire format](#4-wire-format)
 - [Adding or changing an endpoint](#adding-or-changing-an-endpoint)
 - [Checking the SDK against the API](#checking-the-sdk-against-the-api)
@@ -41,10 +44,20 @@ src/
 ├── scope/
 │   ├── BolbolAuthScope.ts         mirrors Bolbol API src/controller/auth
 │   ├── BolbolAcademyScope.ts      mirrors Bolbol API src/controller/academy - the academy's collections,
-│   │                              series, items, assets, pricings and contracts
-│   ├── BolbolTeacherScope.ts      mirrors Bolbol API src/controller/teacher - the teacher profile and the
-│   │                              teacher content built on published collection versions: learning
-│   │                              kits, components, packages, pricings and contracts
+│   │                              series, items, assets, pricings and contracts, its verification
+│   │                              profile (documents, certificates, experiences, publications,
+│   │                              requests - each, and the academy itself, Pending until Bolbol
+│   │                              approves it: AcademyStatusEnum), its authorizations, and the
+│   │                              learning content it owns like a teacher: the twins of every
+│   │                              teacher content endpoint
+│   ├── BolbolTeacherScope.ts      mirrors Bolbol API src/controller/teacher - the teacher profile and
+│   │                              authorizations, and the teacher's learning content: learning kits
+│   │                              and the per-exam lists of their children, the resource library
+│   │                              (folders, videos, podcasts, files, URLs), components (ref resources
+│   │                              included), packages, pricings and contracts
+│   ├── BolbolBolbolScope.ts       mirrors Bolbol API src/controller/bolbol - staff calls: the pending
+│   │                              queues (teacher and academy verification, teacher and academy
+│   │                              authorization requests) and acting as a user
 │   ├── BolbolLexemaScope.ts       mirrors Bolbol API src/controller/lexema - lexemas (dictionary
 │   │                              entries) and their senses, behind every vocabulary picker
 │   └── ...                        one file per backend controller folder
@@ -124,6 +137,11 @@ catch (error)
 }
 ```
 
+A call its caller stops with an `AbortSignal` (a streamed upload,
+[4. Wire format](#4-wire-format)) is the one failure that is not an
+`HTTPError`: it rejects with the signal's reason, an `AbortError` for a plain
+`abort()`.
+
 ## The rules
 
 These keep the SDK a faithful, predictable mirror of the backend. Follow them
@@ -141,6 +159,14 @@ for every change; `npm test` enforces them.
   never calls `fetch` and never reads configuration of its own.
 - There are no scopes for anything that is not a controller folder. Helpers
   that are not endpoints (resolving a static asset path) live on `BolbolServer`.
+  So does the one rule the API and every app must agree on without a call:
+  `BolbolServer.AUTHORIZATION_PERMANENT` (`"0001-01-01"`, what a `manage_*`
+  authorization column holds for a grant with no end date) and
+  `BolbolServer.authorizationStatus(value, today)`, which turns such a date
+  into an `AuthorizationStatusEnum` (both "YYYY-MM-DD", compared as strings).
+  The API fills `OwnerAuthorizationType.status` and
+  `PendingAuthorizationType.status` with it, and the Console judges a date it
+  holds with it (its authorization guard, the Bolbol authorization queue).
 
 ### 2. One method per controller
 
@@ -195,7 +221,16 @@ top-level folder:
   PATCH / DELETE, its query schema for GET. When every field of a **query** is
   optional the argument defaults to `{}`. A body never defaults, even when all
   its fields are optional: some updates clear every field they are not sent, so
-  sending one must be deliberate.
+  sending one must be deliberate. The one exception is `request.approve`
+  (`RequestApproveRequestType`), whose body defaults to `{}`: approving
+  clears nothing, every request but an authorization one is approved with an
+  empty body, and an authorization request (`BolbolTeacherManage*` /
+  `BolbolAcademyManage*`) is approved with the `authorized_until` it grants.
+- **Last, an optional `options: { signal?: AbortSignal } = {}`** where a
+  caller must be able to stop the call - today only
+  `userFile.file.content.upload`, the streamed upload no timeout bounds
+  ([4. Wire format](#4-wire-format)). It is sent as `signal: options.signal`
+  and never reaches the controller, so `npm test` reads the arguments before it.
 - **The return type** is `Promise<BolbolResponseType<{API name}ResponseType>>`,
   where the ResponseType is exactly what the controller's `handle()` returns.
 - The HTTP method and path are the controller's own. Interpolate path
@@ -208,8 +243,10 @@ update: (teacher_uid: string, certificate_id: number, request: TeacherCertificat
 ```
 
 Convenience that the backend does not have - reading a browser `File` into
-base64 before an upload, turning a path into a URL - may wrap the call, but the
-arguments that reach the wire must still be exactly the controller's.
+base64 before an upload, streaming one in two calls (`userFile.file.uploadStream`:
+`content.upload`, then `create`), turning a path into a URL - may wrap the
+calls, but the arguments that reach the wire must still be exactly each
+controller's.
 
 ### 3. Types: one per file, named by what they are
 
@@ -250,7 +287,11 @@ Rules that make the table work:
   ```
 
   This keeps "what does endpoint X take and answer" a single lookup, and lets
-  one endpoint change shape without dragging the others along.
+  one endpoint change shape without dragging the others along. An academy
+  twin of a teacher content endpoint (the same sub-path under
+  `/academy/:academy_uid`, see [Owned content](#owned-content-owner_type-owner_uid))
+  aliases the teacher's types the same way:
+  `export type AcademyVideoCreateRequestType = TeacherVideoCreateRequestType;`.
 - **Paged list requests extend `ListPagingType`**; paged list answers use
   `ListPageType<Row>`, unpaged ones `ListType<Row>`.
 - **Field names are the wire names** - snake_case, exactly as the backend's Zod
@@ -267,6 +308,13 @@ Rules that make the table work:
   package is the source of truth, not a mirror: a change here changes the
   backend's database enum and its compile-time contract. Keep every enum's keys
   equal to its values - the backend builds columns with `Object.keys(...)`.
+- **Contract types are named `{producer}_{entity}_{deal}_{consumer}`**
+  (`ContractTypeEnum`, `Teacher_Package_Sell_User`; a membership has no
+  entity). The `Bolbol_*` members are the one exception: `Bolbol_` names the
+  producer - the platform, `ContractProducerTypeEnum.Bolbol`, whose
+  `producer_uid` is `""` - and the rest of the name is the earning type the
+  commission applies to, the contract's `commission_on_type`
+  (`Bolbol_Teacher_Package_Sell_User` → `Teacher_Package_Sell_User`).
 
 ### Translatable columns: `TranslationType`
 
@@ -327,6 +375,11 @@ export type TranslationType = { [language_code in LanguageCodeType]?: string };
   `source` (`AssetSourceType` / `ItemSourceType`). Their update bodies send
   the same patches. A language the overlay has wins over the academy's own
   translation: `ref.title_translations[code] ?? source.title_translations[code] ?? source.title`.
+- **A request party's label** (`RequestPartyType.name`, both ends of every
+  `RequestRowType`) carries `name_translations` too (decision N16): an
+  academy's stored map, so an inbox reads an academy's name in the reader's
+  language; `{}` for a teacher, a user, `Bolbol` and a party that could not
+  be resolved - a person's name is never translated.
 - Use `TranslationType` / `TranslationPatchType` by name. Never inline
   `Record<string, string>` or `{ [k: string]: string }` in a RowType or
   RequestType - one name is what lets every app find (and type-check) every
@@ -359,6 +412,87 @@ notes_private: string | null;        // the owner's own notes
 - Catalog, billing, request and teacher-profile rows keep their own
   `description` - those are not content notes.
 
+### Owned content: `owner_type`, `owner_uid`
+
+An academy and a teacher own the same kinds of learning content - learning
+kits and their children, components, packages, resource folders and
+resources - so the rows that name their owner carry one pair instead of a
+`teacher_uid`:
+
+```ts
+owner_type: OwnerTypeEnum;  // Academy | Teacher
+owner_uid: string;          // its academy_uid or teacher_uid, by owner_type
+```
+
+- `OwnerType` (`{ type, uid }`) is the same pair as one value, for an app
+  that addresses either owner's URL family. `OwnerTypeEnum` is also a
+  pricing's `owner_type`; a pricing keeps its two uid columns
+  (`PricingRowType`).
+- Every owner endpoint is nested under its owner: the academy twin of a
+  teacher content endpoint has the same sub-path under `/academy/:academy_uid`,
+  the same file name under `controller/academy/<same folder>/`, the API name
+  `Academy...`, the same method on `BolbolAcademyScope`, and types that
+  alias the teacher's (rule 3). Kit children, component children and ref rows
+  reach their owner through their kit / component and carry no pair.
+- Field names follow the owner-neutral columns: a package's sell pricing is
+  `pricing_uid_package_sell_user` (formerly
+  `pricing_uid_teacher_package_sell_user`) on the row and in the create /
+  setting bodies alike. The collection's licensing and commission settings
+  keep their names (`pricing_uid_academy_collection_licensing_teacher`, ...,
+  `teacher_percent_share_of_selling_collection`, on `CollectionRowType`):
+  they also price an academy that builds on another academy's collection
+  (`Academy_Collection_Licensing_Academy`, ...), so there `teacher` reads as
+  "licensee". An academy building on its own collection signs nothing.
+- What an owner may create is granted per kind by Bolbol
+  (`ManageAuthorizationEnum`: Collection - academy only - Package,
+  ComponentForCollection, ComponentForResources, Video, Podcast, File, Url,
+  Course). `teacher.authorization.get` / `academy.authorization.get`
+  answer one `OwnerAuthorizationType` per kind; a gated create without a
+  grant is a 403 `AUTHORIZATION_REQUIRED` / `AUTHORIZATION_EXPIRED`, and a
+  grant is asked for with a `BolbolTeacherManage*` / `BolbolAcademyManage*`
+  request (rule 1 has the date helpers). A component create needs two kinds:
+  Package, and ComponentForCollection or ComponentForResources by its type;
+  the 403 names the first one missing, Package first (Bolbol API decision
+  N14).
+
+### Learning scope: `exam_id`, `exam_skill_id`, `exam_skill_task_id`
+
+Learning kits and their children, components and resources are placed by a
+learning scope: an exam, optionally narrowed to one skill of it and to one
+task of that skill (the backend rule is `Bolbol API/rules/Teacher.md`, "The
+learning scope"). The three fields are spelled the same everywhere, and the
+two narrowing ones are nullable:
+
+```ts
+exam_id: number;
+exam_skill_id: number | null;       // null: every skill of the exam
+exam_skill_task_id: number | null;  // null: every task of the skill; never set without exam_skill_id
+```
+
+- `LearningScopeType` is the same three fields as one value - a resource
+  carries a list of them (`scopes`, also what its create and scope-set bodies
+  send). Collection content (series, items, assets) is not scoped this way:
+  it names a real skill / task of its own, set at create.
+- A kit, a kit child and a component get their pair at create and keep it:
+  no update type carries it, so an update cannot move a row to another
+  skill or task. A kit child's pair lies inside its kit's; omitted, it is the
+  kit's.
+- Material applies where its scope **covers** the target: the same exam, and
+  each of skill / task null or equal. The comments of the list, pin and tag
+  types say where the API reads a scope that way (`covering` on the kit list,
+  a resource's kits) and where it matches the pair exactly (the component and
+  package lists' skill / task filters).
+- A component of a collection type is filed under a skill / task its
+  collection version reaches. `teacher.collection.version.reach` /
+  `academy.collection.version.reach` (decision N15) answer what one
+  published version reaches - the `LearningScopeType` of every item it pins,
+  each once - which is the very list the component create judges the pair
+  against (400 `COMPONENT_SCOPE_NOT_IN_COLLECTION`): accepted when it names
+  neither (the whole exam) or covers one entry. A form narrows its skill /
+  task pickers with it; the type's comment spells the rule out.
+- The per-exam lists of the kit children (`*ListAll`) take a required
+  `exam_id`, so their `request` has no `{}` default.
+
 ### 4. Wire format
 
 - The API reads the session token from the `b-token` header. `HTTPClient` adds
@@ -374,11 +508,29 @@ notes_private: string | null;        // the owner's own notes
   `null` / `undefined`.
 - Endpoints that stream bytes instead of an envelope use `this.http.blob(...)`.
 - Endpoints that take raw bytes instead of a JSON body (`UserFileContentUpload`)
-  have no body schema; their method takes a trailing `content: HTTPRawBody` (a
-  Blob, or a ReadableStream to count the bytes as they go) and sends
-  it as `{ raw: content }` (`Content-Type: application/octet-stream`, no
-  per-request timeout). In Node, pass `await fs.openAsBlob(path)` so a large
-  file streams from disk.
+  have no body schema; their method takes `content: HTTPRawBody` (a Blob, or a
+  ReadableStream to count the bytes as they go), then rule 2's optional
+  `options`, and sends them as `{ raw: content, signal: options.signal }`
+  (`Content-Type: application/octet-stream`, no per-request timeout). In Node,
+  pass `await fs.openAsBlob(path)` so a large file streams from disk.
+  `userFile.file.uploadStream` sends a Blob this way and then makes its
+  UserFile (`UserFileCreate`): the upload for a file too large for a JSON body,
+  which carries it as base64.
+- No timeout bounds a streamed upload, so the caller's `AbortSignal` is what
+  stops one: `content.upload(content, { signal })`,
+  `uploadStream(blob, name, { is_public, signal })` (`HTTPClient` takes one
+  for any call, `HTTPRequestOptions.signal`). Nothing is sent once the signal
+  has aborted, and a later abort cuts the request off wherever it is. The call
+  rejects with the signal's reason - the platform's `AbortError` (a
+  `DOMException` named `"AbortError"`, in browsers and in Node) unless
+  `abort()` was given another - never with an `HTTPError`. What an abort
+  leaves behind: no UserFile, since `uploadStream` sends no `create` once the
+  signal has aborted; no bytes of a stream cut off part-way (the API drops its
+  temp file); and the bytes the server had already stored in full, when the
+  abort came while its answer was on the way, which stay in the caller's
+  storage as an unfinished project sync's do (`Bolbol API/rules/ProjectFiles.md`).
+  A `create` already sent runs to its end, and the call resolves with its
+  file, the caller's to delete.
 
 ## Adding or changing an endpoint
 
@@ -392,7 +544,8 @@ notes_private: string | null;        // the owner's own notes
    projection return the new type - the compiler shows everything that no
    longer matches.
 5. `npm test` here (against the updated API) and `npm run build`.
-6. Bump `bolbol-sdk` in the Console and the CLI and fix their callers.
+6. Bump `bolbol-sdk` in the Console, the CLI and the Academy Application and
+   fix their callers.
 
 ## Checking the SDK against the API
 
@@ -416,13 +569,18 @@ BOLBOL_API_PATH=<path to Bolbol API> npm test
 
 plus: no SDK method without a controller, no duplicates, and every type file
 exporting exactly one type named after the file, with one of the five suffixes.
+A method's trailing `options` that only carries an abort signal (rule 2) is no
+part of the contract, and the checks read the arguments before it.
 
 What it cannot read is the shape of a controller's *output* (`handle()` builds
 it in code), so a ResponseType's fields are still a review question - the
 marker comment and the one-file-per-type rule make that quick to answer.
 
 The parser is TypeScript 5's compiler API (dev dependency `typescript5`),
-because TypeScript 7, which builds the SDK, has no stable JavaScript API.
+because TypeScript 7, which builds the SDK, has no stable JavaScript API. Both
+packages ship a `tsc` bin and `node_modules/.bin/tsc` may link either, so
+`build` and `typecheck` call TypeScript 7 by its path
+(`node node_modules/typescript/bin/tsc`).
 
 ## Scripts
 

package/dist/BolbolServer.d.ts

@@ -19,6 +19,7 @@ import { BolbolUserCollectionScope } from "./scope/BolbolUserCollectionScope";
 import { BolbolUserFileScope } from "./scope/BolbolUserFileScope";
 import { BolbolUserItemScope } from "./scope/BolbolUserItemScope";
 import { BolbolUserScope } from "./scope/BolbolUserScope";
+import { AuthorizationStatusEnum } from "./type/AuthorizationStatusEnum";
 export declare class BolbolServer {
     readonly http: HTTPClient;
     readonly academy: BolbolAcademyScope;
@@ -43,5 +44,7 @@ export declare class BolbolServer {
     readonly userItem: BolbolUserItemScope;
     constructor(options: HTTPClientOptions);
     resolveUrl(path: string | null | undefined): string | null;
+    static readonly AUTHORIZATION_PERMANENT: string;
+    static authorizationStatus(value: string | null, today: string): AuthorizationStatusEnum;
 }
 //# sourceMappingURL=BolbolServer.d.ts.map

package/dist/BolbolServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BolbolServer.d.ts","sourceRoot":"","sources":["../src/BolbolServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK1D,qBAAa,YAAY;IAErB,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,UAAU,EAAE,qBAAqB,CAAC;IAClD,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;IAC9C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,cAAc,EAAE,yBAAyB,CAAC;IAC1D,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;IAC9C,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;IAE9C,YAAmB,OAAO,EAAE,iBAAiB,EAwB5C;IAMM,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOhE;CACJ"}
+{"version":3,"file":"BolbolServer.d.ts","sourceRoot":"","sources":["../src/BolbolServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAKzE,qBAAa,YAAY;IAErB,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,UAAU,EAAE,qBAAqB,CAAC;IAClD,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;IAC9C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,MAAM,EAAE,iBAAiB,CAAC;IAC1C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,cAAc,EAAE,yBAAyB,CAAC;IAC1D,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;IAC9C,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;IAE9C,YAAmB,OAAO,EAAE,iBAAiB,EAwB5C;IAMM,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOhE;IAMD,gBAAuB,uBAAuB,EAAE,MAAM,CAAgB;IAoBtE,OAAc,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAW9F;CACJ"}

package/dist/BolbolServer.js

@@ -22,6 +22,7 @@ const BolbolUserCollectionScope_1 = require("./scope/BolbolUserCollectionScope")
 const BolbolUserFileScope_1 = require("./scope/BolbolUserFileScope");
 const BolbolUserItemScope_1 = require("./scope/BolbolUserItemScope");
 const BolbolUserScope_1 = require("./scope/BolbolUserScope");
+const AuthorizationStatusEnum_1 = require("./type/AuthorizationStatusEnum");
 // The entry point of the SDK: one instance of every scope, all sharing one
 // HTTPClient. Each scope mirrors one folder of Bolbol API src/controller and is
 // exposed under that folder's name in camelCase (see README.md, rule 1).
@@ -81,6 +82,37 @@ class BolbolServer {
             return path;
         return `${this.http.origin}${path.startsWith("/") ? "" : "/"}${path}`;
     }
+    // What a `manage_*` authorization column (ManageAuthorizationEnum) holds
+    // for a grant with no end date. Postgres has no all-zero date, so
+    // "permanent" is its minimum date. Compare it as a string, never through
+    // a Date: a Date would move it by the reader's time zone.
+    static AUTHORIZATION_PERMANENT = "0001-01-01";
+    // Where an owner stands with one authorization kind, from the date its
+    // `manage_*` column holds (OwnerAuthorizationType.authorized_until) and
+    // today's date, both "YYYY-MM-DD":
+    //
+    //   null                     NotAuthorized
+    //   AUTHORIZATION_PERMANENT  Permanent
+    //   on or after today        AuthorizedUntil (the last day still counts)
+    //   before today             Expired
+    //
+    // The one place the rule lives: the API fills every
+    // OwnerAuthorizationType.status with it, and the Console calls it to judge
+    // a date it holds (its guard, the Bolbol authorization queue), so both
+    // agree. It
+    // sits here rather than in src/type because a type file exports exactly
+    // one type, and helpers that are not endpoints live on BolbolServer
+    // (README rule 1). ISO dates order as strings, so no Date is built and no
+    // time zone moves a day; a full ISO timestamp is cut to its date first.
+    // `today` is the caller's to choose: each side judges by its own date.
+    static authorizationStatus(value, today) {
+        if (value === null)
+            return AuthorizationStatusEnum_1.AuthorizationStatusEnum.NotAuthorized;
+        const until = value.slice(0, 10);
+        if (until === BolbolServer.AUTHORIZATION_PERMANENT)
+            return AuthorizationStatusEnum_1.AuthorizationStatusEnum.Permanent;
+        return until >= today.slice(0, 10) ? AuthorizationStatusEnum_1.AuthorizationStatusEnum.AuthorizedUntil : AuthorizationStatusEnum_1.AuthorizationStatusEnum.Expired;
+    }
 }
 exports.BolbolServer = BolbolServer;
 //# sourceMappingURL=BolbolServer.js.map

package/dist/BolbolServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"BolbolServer.js","sourceRoot":"","sources":["../src/BolbolServer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BolbolServer.js","sourceRoot":"","sources":["../src/BolbolServer.ts"],"names":[],"mappings":"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"}

package/dist/HTTPClient.d.ts

@@ -8,6 +8,7 @@ export interface HTTPRequestOptions {
     raw?: HTTPRawBody;
     query?: object;
     timeoutMs?: number | null;
+    signal?: AbortSignal;
 }
 export interface HTTPClientOptions {
     baseUrl: string;
@@ -29,6 +30,7 @@ export declare class HTTPClient {
     blob(path: string, options?: Omit<HTTPRequestOptions, "body">): Promise<Blob>;
     request<T>(method: HTTPMethod, path: string, options?: HTTPRequestOptions): Promise<BolbolResponseType<T>>;
     url(path: string, query?: object): string;
+    private call;
     private send;
     private static search;
     private static parse;

package/dist/HTTPClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HTTPClient.d.ts","sourceRoot":"","sources":["../src/HTTPClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAIrE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAErH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAGvD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IAG/B,IAAI,CAAC,EAAE,OAAO,CAAC;IAOf,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAI9B,OAAO,EAAE,MAAM,CAAC;IAGhB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAKhF,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE9C,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,IAAI,CAAC,EAAE,WAAW,CAAC;CACtB;AAKD,qBAAa,UAAU;IAIA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF3C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,YAAoC,OAAO,EAAE,iBAAiB,EAG7D;IAKD,IAAW,MAAM,IAAI,MAAM,CAG1B;IAEM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG1G;IAEM,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG7F;IAEM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG5F;IAEM,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG9F;IAEM,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG/F;IAKY,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;IAEY,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAS1H;IAIM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/C;YAEa,IAAI;IA6DlB,OAAO,CAAC,MAAM,CAAC,MAAM;mBA2BA,KAAK;IAiB1B,OAAO,CAAC,MAAM,CAAC,OAAO;IAqBtB,OAAO,CAAC,MAAM,CAAC,MAAM;CAoBxB"}
+{"version":3,"file":"HTTPClient.d.ts","sourceRoot":"","sources":["../src/HTTPClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAIrE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAErH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAGvD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IAG/B,IAAI,CAAC,EAAE,OAAO,CAAC;IAOf,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAS1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAI9B,OAAO,EAAE,MAAM,CAAC;IAGhB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAKhF,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE9C,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,IAAI,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD,qBAAa,UAAU;IAIA,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF3C,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,YAAoC,OAAO,EAAE,iBAAiB,EAG7D;IAKD,IAAW,MAAM,IAAI,MAAM,CAG1B;IAEM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG1G;IAEM,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG7F;IAEM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG5F;IAEM,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG9F;IAEM,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAG/F;IAKY,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7F;IAEY,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAW1H;IAIM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/C;YASa,IAAI;YA8BJ,IAAI;IA+DlB,OAAO,CAAC,MAAM,CAAC,MAAM;mBA2BA,KAAK;IAiB1B,OAAO,CAAC,MAAM,CAAC,OAAO;IAqBtB,OAAO,CAAC,MAAM,CAAC,MAAM;CAoBxB"}

package/dist/HTTPClient.js

@@ -4,7 +4,8 @@ exports.HTTPClient = void 0;
 const HTTPError_1 = require("./HTTPError");
 // The single transport behind every scope. Resolves to the API's envelope
 // (`BolbolResponseType<T>`) untouched so callers keep its metadata; throws
-// HTTPError for anything that is not a 2xx answer.
+// HTTPError for anything that is not a 2xx answer, but for a call its caller
+// aborted (HTTPRequestOptions.signal).
 class HTTPClient {
     options;
     baseUrl;
@@ -37,17 +38,19 @@ class HTTPClient {
     // wrapping it in an envelope (e.g. a user file download). A failure still
     // answers with the JSON envelope, so it is thrown as HTTPError as usual.
     async blob(path, options = {}) {
-        const response = await this.send("GET", path, options);
-        if (!response.ok)
-            throw HTTPClient.failure(response.status, await HTTPClient.parse(response));
-        return response.blob();
+        return this.call("GET", path, options, async (response) => {
+            if (!response.ok)
+                throw HTTPClient.failure(response.status, await HTTPClient.parse(response));
+            return response.blob();
+        });
     }
     async request(method, path, options = {}) {
-        const response = await this.send(method, path, options);
-        const data = await HTTPClient.parse(response);
-        if (!response.ok)
-            throw HTTPClient.failure(response.status, data);
-        return data;
+        return this.call(method, path, options, async (response) => {
+            const data = await HTTPClient.parse(response);
+            if (!response.ok)
+                throw HTTPClient.failure(response.status, data);
+            return data;
+        });
     }
     // Absolute URL for an API path plus query string, for callers that hand
     // the address to something else (an <img src>, a download link).
@@ -55,7 +58,36 @@ class HTTPClient {
         const search = HTTPClient.search(query);
         return `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}${search}`;
     }
-    async send(method, path, options) {
+    // One call: sends the request, then reads its answer with `read`. The
+    // caller's signal reaches the request through `controller` - the one the
+    // timeout aborts too - by a listener that forwards its abort, added before
+    // the token is read and removed once the answer's body has been, so an
+    // abort at any point stops the call. A listener rather than
+    // AbortSignal.any, which Node has only from 20.3 and Safari from 17.4:
+    // this package runs on Node 20 (engines) and in the Console's browsers.
+    async call(method, path, options, read) {
+        const signal = options.signal;
+        // Given up already: rejects at once, and nothing is sent.
+        signal?.throwIfAborted();
+        const controller = new AbortController();
+        const forward = () => controller.abort(signal?.reason);
+        signal?.addEventListener("abort", forward, { once: true });
+        try {
+            return await read(await this.send(method, path, options, controller));
+        }
+        catch (error) {
+            // Once the caller has aborted, the call rejects with the signal's
+            // own reason, whatever failed: not with the timeout's HTTPError,
+            // which `send` makes of any aborted fetch, nor with what a platform
+            // rejects a cut-off body read with.
+            signal?.throwIfAborted();
+            throw error;
+        }
+        finally {
+            signal?.removeEventListener("abort", forward);
+        }
+    }
+    async send(method, path, options, controller) {
         const headers = { accept: "application/json" };
         if (options.raw !== undefined)
             headers["content-type"] = "application/octet-stream";
@@ -77,12 +109,14 @@ class HTTPClient {
                 headers["b-token"] = token;
         }
         // A raw upload takes as long as its size needs, so the per-request
-        // timeout - sized for JSON calls - does not apply to it.
+        // timeout - sized for JSON calls - does not apply to it: the caller's
+        // signal is what stops one.
         const timeoutMs = options.timeoutMs !== undefined ? options.timeoutMs : (options.raw !== undefined ? null : this.options.timeoutMs ?? null);
-        const controller = new AbortController();
         const timer = timeoutMs === null ? null : setTimeout(() => controller.abort(), timeoutMs);
         const url = this.url(path, options.query);
         try {
+            // A signal aborted while the token was read makes fetch reject at
+            // once, sending nothing.
             return await fetch(url, {
                 ...this.options.init,
                 method,

package/dist/HTTPClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"HTTPClient.js","sourceRoot":"","sources":["../src/HTTPClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HTTPClient.js","sourceRoot":"","sources":["../src/HTTPClient.ts"],"names":[],"mappings":"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"}

package/dist/HTTPError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HTTPError.d.ts","sourceRoot":"","sources":["../src/HTTPError.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAE3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,SAAU,SAAQ,KAAK;IAEhC,gBAAuB,WAAW,KAAK;IAEvC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,cAAc,EAAE,CAAC;IAEzC,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,cAAc,EAAO,EAOtF;IAID,IAAW,WAAW,IAAI,OAAO,CAGhC;CACJ"}
+{"version":3,"file":"HTTPError.d.ts","sourceRoot":"","sources":["../src/HTTPError.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAE3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAQD,qBAAa,SAAU,SAAQ,KAAK;IAEhC,gBAAuB,WAAW,KAAK;IAEvC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,cAAc,EAAE,CAAC;IAEzC,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,cAAc,EAAO,EAOtF;IAID,IAAW,WAAW,IAAI,OAAO,CAGhC;CACJ"}

package/dist/HTTPError.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HTTPError = void 0;
-// Thrown by HTTPClient for every failed call. `code` is the HTTP status, or 0
-// when the API could not be reached at all (network down, DNS, timeout).
+// Thrown by HTTPClient for every failed call but one its caller aborted, which
+// rejects with the signal's reason (HTTPRequestOptions.signal). `code` is the
+// HTTP status, or 0 when the API could not be reached at all (network down,
+// DNS, timeout).
 // `message` is the API's own, already localized explanation when it sent one,
 // with `lang` naming its language; otherwise an English fallback.
 class HTTPError extends Error {

package/dist/HTTPError.js.map

@@ -1 +1 @@
-{"version":3,"file":"HTTPError.js","sourceRoot":"","sources":["../src/HTTPError.ts"],"names":[],"mappings":";;;AAQA,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,kEAAkE;AAClE,eAAuB,SAAQ,KAAK;IAEzB,MAAM,CAAU,WAAW,GAAG,CAAC,CAAC;IAEvB,IAAI,CAAS;IACb,IAAI,CAAU;IACd,MAAM,CAAmB;IAEzC,YAAY,IAAY,EAAE,OAAe,EAAE,IAAa,EAAE,MAAM,GAAqB,EAAE;QAEnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,mEAAmE;IACnE,4BAA4B;IAC5B,IAAW,WAAW;QAElB,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,WAAW,CAAC;IAC/C,CAAC;CACJ"}
+{"version":3,"file":"HTTPError.js","sourceRoot":"","sources":["../src/HTTPError.ts"],"names":[],"mappings":";;;AAQA,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,iBAAiB;AACjB,8EAA8E;AAC9E,kEAAkE;AAClE,eAAuB,SAAQ,KAAK;IAEzB,MAAM,CAAU,WAAW,GAAG,CAAC,CAAC;IAEvB,IAAI,CAAS;IACb,IAAI,CAAU;IACd,MAAM,CAAmB;IAEzC,YAAY,IAAY,EAAE,OAAe,EAAE,IAAa,EAAE,MAAM,GAAqB,EAAE;QAEnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,mEAAmE;IACnE,4BAA4B;IAC5B,IAAW,WAAW;QAElB,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,WAAW,CAAC;IAC/C,CAAC;CACJ"}