paperus 0.0.0-stage → 0.0.8

package/dist/generated/sdk.gen.js

@@ -0,0 +1,991 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { client } from './client.gen.js';
+import { formDataBodySerializer } from './client/index.js';
+/**
+ * Health
+ */
+export const health = (options) => (options?.client ?? client).get({ url: '/api/health', ...options });
+/**
+ * Health Db
+ */
+export const healthDb = (options) => (options?.client ?? client).get({ url: '/api/health/db', ...options });
+/**
+ * Login
+ */
+export const login = (options) => (options.client ?? client).post({
+    url: '/api/auth/login',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Login Methods
+ *
+ * How one may log in (for the login page).
+ */
+export const loginMethods = (options) => (options?.client ?? client).get({ url: '/api/auth/methods', ...options });
+/**
+ * Oidc Start
+ *
+ * Off to the identity provider; it sends the browser back to
+ * ``/api/auth/oidc/callback``. With ``link``, the OIDC login is
+ * linked to the account logged in now instead (whatever its name).
+ */
+export const oidcStart = (options) => (options?.client ?? client).get({ url: '/api/auth/oidc/start', ...options });
+/**
+ * Oidc Callback
+ *
+ * Back from the identity provider: log the person in.
+ */
+export const oidcCallback = (options) => (options?.client ?? client).get({ url: '/api/auth/oidc/callback', ...options });
+/**
+ * Unlink Oidc
+ *
+ * Unlink one's account from the OIDC login (the password stays).
+ */
+export const unlinkOidc = (options) => (options?.client ?? client).delete({ url: '/api/auth/oidc/link', ...options });
+/**
+ * Logout
+ */
+export const logout = (options) => (options?.client ?? client).post({ url: '/api/auth/logout', ...options });
+/**
+ * Me
+ */
+export const me = (options) => (options?.client ?? client).get({ url: '/api/auth/me', ...options });
+/**
+ * Change Password
+ *
+ * Change one's password (the current one is needed); other devices are
+ * logged out, this one stays logged in.
+ */
+export const changePassword = (options) => (options.client ?? client).post({
+    url: '/api/auth/password',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Mark Hint Seen
+ *
+ * Remember that the person has seen a tutorial hint.
+ */
+export const markHintSeen = (options) => (options.client ?? client).put({ url: '/api/auth/hints/{hint}', ...options });
+/**
+ * Remove Avatar
+ */
+export const removeAvatar = (options) => (options?.client ?? client).delete({ url: '/api/me/avatar', ...options });
+/**
+ * Set Avatar
+ *
+ * One's profile picture: PNG, JPEG or WebP, up to 256 KB (the website
+ * sends it square, 256 pixels wide).
+ */
+export const setAvatar = (options) => (options.client ?? client).put({
+    ...formDataBodySerializer,
+    url: '/api/me/avatar',
+    ...options,
+    headers: {
+        'Content-Type': null,
+        ...options.headers
+    }
+});
+/**
+ * Get Avatar
+ *
+ * A person's profile picture (404 without one). Its address carries
+ * the picture's version, so it may be kept for long.
+ */
+export const getAvatar = (options) => (options.client ?? client).get({ url: '/api/users/{user_id}/avatar', ...options });
+/**
+ * List Items
+ *
+ * Items the person can read, newest first; ``before`` = last ``id`` for
+ * the next page. ``library`` shows one library only. ``sort=recent``:
+ * by the latest of the item's last change and the reader's last opening,
+ * newest first, paged with ``offset`` instead of ``before``;
+ * ``sort=opened``: only items the reader opened, by when.
+ *
+ * ``trashed=true`` lists the trash instead. ``unsorted=true``: only papers
+ * with a PDF whose details could not be found (all guessed from the file;
+ * papers still being read, and notes or other files without a DOI to
+ * find, are left out). ``tag`` (repeatable: items
+ * with all of them) and ``collection`` (with its subcollections unless
+ * ``nested=false``) filter the list, and ``title`` to items with all of its
+ * words in their title (any case). ``X-Total-Count`` is the number of
+ * matching items, for showing the total while paging.
+ * ``since=N`` is for syncing:
+ * every item changed after change number N, trashed or not, in change
+ * order; ``limit`` and ``before`` do not apply. The ``Last-Change`` header
+ * is the number to pass as ``since`` next time.
+ */
+export const listItems = (options) => (options?.client ?? client).get({ url: '/api/items', ...options });
+/**
+ * Add Item
+ *
+ * A new item; if one of its identifiers is known among the items the
+ * person can see, the existing item (200).
+ */
+export const addItem = (options) => (options.client ?? client).post({
+    url: '/api/items',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Add Version
+ *
+ * Another version of an item, e.g. the published one of a preprint.
+ */
+export const addVersion = (options) => (options.client ?? client).post({
+    url: '/api/items/{item_id}/versions',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Pin Version
+ *
+ * Cite this version, whatever its kind.
+ */
+export const pinVersion = (options) => (options.client ?? client).post({ url: '/api/versions/{version_id}/pin', ...options });
+/**
+ * Set Overrides
+ *
+ * Replace the manual edits to the metadata for citing.
+ *
+ * Fields set here win over every version's metadata and survive new
+ * lookups; ``null`` hides a field. Needs ``If-Match`` with the ETag from the
+ * last read, so concurrent edits are not lost (412 if the item changed).
+ */
+export const setOverrides = (options) => (options.client ?? client).put({
+    url: '/api/items/{item_id}/overrides',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Trash Item
+ *
+ * Move to the trash; restorable with ``POST …/restore``.
+ */
+export const trashItem = (options) => (options.client ?? client).delete({ url: '/api/items/{item_id}', ...options });
+/**
+ * Get Item
+ */
+export const getItem = (options) => (options.client ?? client).get({ url: '/api/items/{item_id}', ...options });
+/**
+ * Set Owner
+ *
+ * Give the item to another owner the person may add to: share it with a
+ * group, or take a group's paper for oneself (members may delete it
+ * anyway). Tags and collections of the group that gave it up come off.
+ */
+export const setOwner = (options) => (options.client ?? client).put({
+    url: '/api/items/{item_id}/owner',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Restore Item
+ */
+export const restoreItem = (options) => (options.client ?? client).post({ url: '/api/items/{item_id}/restore', ...options });
+/**
+ * Unstar Item
+ */
+export const unstarItem = (options) => (options.client ?? client).delete({ url: '/api/items/{item_id}/favourite', ...options });
+/**
+ * Star Item
+ *
+ * Star the paper (for the person only; any paper they can see).
+ */
+export const starItem = (options) => (options.client ?? client).put({ url: '/api/items/{item_id}/favourite', ...options });
+/**
+ * Mark Viewed
+ *
+ * Remember that the person opened the item (for their recent papers).
+ */
+export const markViewed = (options) => (options.client ?? client).post({ url: '/api/items/{item_id}/viewed', ...options });
+/**
+ * List Duplicates
+ *
+ * Papers the person can see that share an identifier or a file with
+ * this one: candidates for merging.
+ */
+export const listDuplicates = (options) => (options.client ?? client).get({ url: '/api/items/{item_id}/duplicates', ...options });
+/**
+ * Preview Merge
+ *
+ * What merging this paper into ``into`` would move and leave behind.
+ */
+export const previewMerge = (options) => (options.client ?? client).get({ url: '/api/items/{item_id}/merge-preview', ...options });
+/**
+ * Merge Item
+ *
+ * Merge this paper into another one (the same paper twice). Needs the
+ * right to change this one; what may move to the other depends on the
+ * person's rights there (see docs/permissions.md).
+ */
+export const mergeItem = (options) => (options.client ?? client).post({
+    url: '/api/items/{item_id}/merge',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Find Upload
+ *
+ * The item in a library the person can read that already has a file
+ * with this SHA-256 (hex), so a client can skip uploading it again; 404 if
+ * there is none.
+ */
+export const findUpload = (options) => (options.client ?? client).get({ url: '/api/uploads/{sha256}', ...options });
+/**
+ * Upload New Item
+ *
+ * A new item from a file, titled after the file until its text tells more.
+ *
+ * The background job looks for a DOI or arXiv ID in the file and replaces
+ * the placeholder metadata (see ``paperus.identify``). A file that is
+ * already in a library the person can read makes no new item: the answer
+ * (200, ``existing``) names the item that has it. ``library_id`` (the
+ * owner): the person's default if not given.
+ */
+export const uploadNewItem = (options) => (options.client ?? client).post({
+    ...formDataBodySerializer,
+    url: '/api/uploads',
+    ...options,
+    headers: {
+        'Content-Type': null,
+        ...options.headers
+    }
+});
+/**
+ * Upload To Version
+ */
+export const uploadToVersion = (options) => (options.client ?? client).post({
+    ...formDataBodySerializer,
+    url: '/api/versions/{version_id}/files',
+    ...options,
+    headers: {
+        'Content-Type': null,
+        ...options.headers
+    }
+});
+/**
+ * Upload To Item
+ *
+ * Upload to the item's preferred version.
+ */
+export const uploadToItem = (options) => (options.client ?? client).post({
+    ...formDataBodySerializer,
+    url: '/api/items/{item_id}/files',
+    ...options,
+    headers: {
+        'Content-Type': null,
+        ...options.headers
+    }
+});
+/**
+ * Download File
+ */
+export const downloadFile = (options) => (options.client ?? client).get({ url: '/api/files/{file_id}/content', ...options });
+/**
+ * Trash File
+ *
+ * Move to the trash; restorable with ``POST …/restore``.
+ */
+export const trashFile = (options) => (options.client ?? client).delete({ url: '/api/files/{file_id}', ...options });
+/**
+ * Restore File
+ */
+export const restoreFile = (options) => (options.client ?? client).post({ url: '/api/files/{file_id}/restore', ...options });
+/**
+ * Search
+ *
+ * Passages for ``q`` in the libraries the person can read (or one
+ * ``library``): its words (quotes for phrases, ``-`` to exclude), its
+ * meaning, or both; ``type`` (repeatable, CSL types) limits the items.
+ * ``per_item`` keeps the best few per paper or note, so more papers fit;
+ * ``item`` searches within one paper. The ``X-Search-Mode`` header says
+ * what was used: without the ML service, hybrid search falls back to
+ * keywords.
+ */
+export const search = (options) => (options.client ?? client).get({ url: '/api/search', ...options });
+/**
+ * Export Citations
+ *
+ * Citations for the given papers (``item``, repeatable), a collection
+ * (with its subcollections unless ``nested=false``) or, with neither,
+ * everything the person can read. ``download=true`` offers it as a file
+ * (``.bib`` or ``.json``).
+ */
+export const exportCitations = (options) => (options?.client ?? client).get({ url: '/api/citations', ...options });
+/**
+ * List Notes
+ *
+ * Notes the person can read, last changed first: all of them, those
+ * about a paper (``item``) or in a collection (with its subcollections
+ * unless ``nested=false``); ``trashed=true`` lists the trash instead.
+ * ``X-Total-Count`` is the number of matching notes.
+ */
+export const listNotes = (options) => (options?.client ?? client).get({ url: '/api/notes', ...options });
+/**
+ * Create Note
+ *
+ * A new note for the given owner (or the person's default owner), about
+ * the given papers, optionally put into a collection.
+ */
+export const createNote = (options) => (options.client ?? client).post({
+    url: '/api/notes',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Trash Note
+ */
+export const trashNote = (options) => (options.client ?? client).delete({ url: '/api/notes/{note_id}', ...options });
+/**
+ * Read Note
+ *
+ * The note with its text; the ``ETag`` goes into ``If-Match`` when saving.
+ */
+export const readNote = (options) => (options.client ?? client).get({ url: '/api/notes/{note_id}', ...options });
+/**
+ * Change Note
+ *
+ * Save the text. Needs ``If-Match`` with the ETag the editor started
+ * from: 412 if someone else saved in between (then reload and merge).
+ */
+export const changeNote = (options) => (options.client ?? client).patch({
+    url: '/api/notes/{note_id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Unlink Item
+ */
+export const unlinkItem = (options) => (options.client ?? client).delete({ url: '/api/notes/{note_id}/items/{item_id}', ...options });
+/**
+ * Link Item
+ *
+ * Say the note is about the paper (at a page); changes the page if it
+ * is linked already.
+ */
+export const linkItem = (options) => (options.client ?? client).put({
+    url: '/api/notes/{note_id}/items/{item_id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Set Note Owner
+ *
+ * Give the note to another owner the person may add to. Collections of a
+ * group that no longer owns it let it go.
+ */
+export const setNoteOwner = (options) => (options.client ?? client).put({
+    url: '/api/notes/{note_id}/owner',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Restore Note
+ */
+export const restoreNote = (options) => (options.client ?? client).post({ url: '/api/notes/{note_id}/restore', ...options });
+/**
+ * Note History
+ *
+ * Earlier texts of the note, newest first.
+ */
+export const noteHistory = (options) => (options.client ?? client).get({ url: '/api/notes/{note_id}/history', ...options });
+/**
+ * Note Markdown
+ *
+ * The note as a Markdown file.
+ */
+export const noteMarkdown = (options) => (options.client ?? client).get({ url: '/api/notes/{note_id}/markdown', ...options });
+/**
+ * Add Notes
+ *
+ * Put notes into a collection; those it may not hold (a group's
+ * collection holds only the group's notes) or unknown ones are skipped.
+ */
+export const addNotes = (options) => (options.client ?? client).post({
+    url: '/api/collections/{collection_id}/notes',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Remove Note
+ */
+export const removeNote = (options) => (options.client ?? client).delete({ url: '/api/collections/{collection_id}/notes/{note_id}', ...options });
+/**
+ * List Imports
+ *
+ * The person's imports, newest first.
+ */
+export const listImports = (options) => (options?.client ?? client).get({ url: '/api/imports', ...options });
+/**
+ * Start Import
+ *
+ * Import an export: BibTeX, RIS or CSL-JSON, alone or zipped with its
+ * files. Everything new belongs to ``library_id`` (default: the person's
+ * default owner). Runs in the background; poll ``GET /api/imports/{id}``.
+ */
+export const startImport = (options) => (options.client ?? client).post({
+    ...formDataBodySerializer,
+    url: '/api/imports',
+    ...options,
+    headers: {
+        'Content-Type': null,
+        ...options.headers
+    }
+});
+/**
+ * Get Import
+ */
+export const getImport = (options) => (options.client ?? client).get({ url: '/api/imports/{import_id}', ...options });
+/**
+ * List Duplicates Everywhere
+ *
+ * Pairs of papers that look like the same paper (same identifier or
+ * file first, then the same title), with a recommendation which to keep;
+ * pairs marked as different are left out.
+ */
+export const listDuplicatesEverywhere = (options) => (options?.client ?? client).get({ url: '/api/duplicates', ...options });
+/**
+ * Mark Different
+ *
+ * The two are different papers: do not suggest them again (for everyone
+ * who sees both). Needs the right to change at least one of them.
+ */
+export const markDifferent = (options) => (options.client ?? client).post({
+    url: '/api/duplicates/different',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Empty Trash
+ *
+ * Delete for good everything in the trash the person may change: their
+ * own and that of groups where they are a member or admin.
+ */
+export const emptyTrash = (options) => (options?.client ?? client).delete({ url: '/api/trash', ...options });
+/**
+ * Storage
+ *
+ * How full the storage is (for the bar at the bottom of the menu).
+ */
+export const storage = (options) => (options?.client ?? client).get({ url: '/api/storage', ...options });
+/**
+ * Get Config
+ */
+export const getConfig = (options) => (options?.client ?? client).get({ url: '/api/admin/config', ...options });
+/**
+ * Set Config
+ *
+ * Save settings. A new embedding model must be one the ML service
+ * offers; the library is then re-embedded in the background, while keyword
+ * search keeps working and search by meaning covers more and more.
+ */
+export const setConfig = (options) => (options.client ?? client).put({
+    url: '/api/admin/config',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Ml Status
+ */
+export const mlStatus = (options) => (options?.client ?? client).get({ url: '/api/admin/ml', ...options });
+/**
+ * Measure Ml Speed
+ *
+ * Time a model on this installation's ML service with sample passages.
+ * A model not downloaded yet starts downloading: the answer then says
+ * ``loading``; ask again in a while.
+ */
+export const measureMlSpeed = (options) => (options.client ?? client).post({ url: '/api/admin/ml/models/{name}/speed', ...options });
+/**
+ * Delete Ml Model
+ *
+ * Remove a downloaded model from the ML service (not the one in use).
+ */
+export const deleteMlModel = (options) => (options.client ?? client).delete({ url: '/api/admin/ml/models/{name}', ...options });
+/**
+ * Stats
+ */
+export const stats = (options) => (options?.client ?? client).get({ url: '/api/admin/stats', ...options });
+/**
+ * Run Job
+ *
+ * Start a sweep now: ``embeddings`` (embed what is missing), ``text``
+ * (read files still pending), ``text-all`` (read every file again),
+ * ``trash`` (delete what is older than the trash days), ``integrity``
+ * (check stored contents), ``integrity-deep`` (also their SHA-256) or
+ * ``integrity-clean`` (check and remove unused stored contents), ``copy``
+ * (update the readable copy) or ``copy-remove`` (delete it).
+ */
+export const runJob = (options) => (options.client ?? client).post({ url: '/api/admin/jobs/{job}', ...options });
+/**
+ * Integrity Report
+ *
+ * The last integrity check's report (None before the first).
+ */
+export const integrityReport = (options) => (options?.client ?? client).get({ url: '/api/admin/integrity', ...options });
+/**
+ * Authentication
+ *
+ * What the Authentication settings show besides the settings.
+ */
+export const authentication = (options) => (options?.client ?? client).get({ url: '/api/admin/authentication', ...options });
+/**
+ * Set Oidc Secret
+ *
+ * The OIDC login's client secret; never sent back.
+ */
+export const setOidcSecret = (options) => (options.client ?? client).put({
+    url: '/api/admin/authentication/secret',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Check Provider
+ *
+ * Whether the identity provider answers at this address.
+ */
+export const checkProvider = (options) => (options.client ?? client).post({
+    url: '/api/admin/authentication/check',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * End All Sessions
+ *
+ * Log everyone out on every device, except this one.
+ */
+export const endAllSessions = (options) => (options?.client ?? client).delete({ url: '/api/admin/sessions', ...options });
+/**
+ * Readable Copy
+ */
+export const readableCopy = (options) => (options?.client ?? client).get({ url: '/api/admin/readable-copy', ...options });
+/**
+ * Preview Template
+ */
+export const previewTemplate = (options) => (options.client ?? client).post({
+    url: '/api/admin/readable-copy/preview',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * List Tags
+ *
+ * The tags of the libraries the person can read, with how they are used
+ * (items in the trash do not count).
+ */
+export const listTags = (options) => (options?.client ?? client).get({ url: '/api/tags', ...options });
+/**
+ * Create Tag
+ *
+ * A tag not on any item yet (409 if the library has one of that name).
+ */
+export const createTag = (options) => (options.client ?? client).post({
+    url: '/api/tags',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Add Tag
+ *
+ * Tag an item with its owner's, the person's or one of their groups' tag
+ * (see ``Access.may_tag``); the tag is created if that owner has none of
+ * that name (any case), which for a group needs member rights there.
+ */
+export const addTag = (options) => (options.client ?? client).post({
+    url: '/api/items/{item_id}/tags',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Remove Tag
+ */
+export const removeTag = (options) => (options.client ?? client).delete({ url: '/api/items/{item_id}/tags/{tag_id}', ...options });
+/**
+ * Delete Tag
+ *
+ * Remove a tag from every item and delete it.
+ */
+export const deleteTag = (options) => (options.client ?? client).delete({ url: '/api/tags/{tag_id}', ...options });
+/**
+ * Change Tag
+ *
+ * Rename a tag everywhere (409 if another tag of its owner has that
+ * name), set its colour or description, or give it to another owner.
+ */
+export const changeTag = (options) => (options.client ?? client).patch({
+    url: '/api/tags/{tag_id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * List Collections
+ *
+ * The collections of the libraries the person can read, flat;
+ * ``parent_id`` gives the tree.
+ */
+export const listCollections = (options) => (options?.client ?? client).get({ url: '/api/collections', ...options });
+/**
+ * Create Collection
+ */
+export const createCollection = (options) => (options.client ?? client).post({
+    url: '/api/collections',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Delete Collection
+ *
+ * Delete a collection and its subcollections; items stay in the library.
+ */
+export const deleteCollection = (options) => (options.client ?? client).delete({ url: '/api/collections/{collection_id}', ...options });
+/**
+ * Change Collection
+ *
+ * Rename, describe or move a collection (not into itself), also into
+ * another library the person may change.
+ */
+export const changeCollection = (options) => (options.client ?? client).patch({
+    url: '/api/collections/{collection_id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Preview Move
+ *
+ * Before moving a collection into another library: how many of its
+ * papers are not in that library yet.
+ */
+export const previewMove = (options) => (options.client ?? client).get({ url: '/api/collections/{collection_id}/move-preview', ...options });
+/**
+ * Unpin Collection
+ */
+export const unpinCollection = (options) => (options.client ?? client).delete({ url: '/api/collections/{collection_id}/pin', ...options });
+/**
+ * Pin Collection
+ *
+ * Pin the collection to the person's sidebar (readers may too).
+ */
+export const pinCollection = (options) => (options.client ?? client).put({ url: '/api/collections/{collection_id}/pin', ...options });
+/**
+ * Add Items
+ *
+ * Add items; those the collection may not hold (a group's collection
+ * holds only that group's items) or the person cannot read are skipped.
+ */
+export const addItems = (options) => (options.client ?? client).post({
+    url: '/api/collections/{collection_id}/items',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Remove Item
+ */
+export const removeItem = (options) => (options.client ?? client).delete({ url: '/api/collections/{collection_id}/items/{item_id}', ...options });
+/**
+ * List Libraries
+ *
+ * The libraries the person can read: their own first, then their groups'.
+ */
+export const listLibraries = (options) => (options?.client ?? client).get({ url: '/api/libraries', ...options });
+/**
+ * Set Default Library
+ *
+ * Where new items go unless another library is chosen.
+ */
+export const setDefaultLibrary = (options) => (options.client ?? client).put({
+    url: '/api/me/default-library',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * List Groups
+ *
+ * The groups the person belongs to (directly or through a group above);
+ * site administrators see every group. Flat; ``parent_id`` gives the tree.
+ */
+export const listGroups = (options) => (options?.client ?? client).get({ url: '/api/groups', ...options });
+/**
+ * Create Group
+ *
+ * A group with its library. Top-level groups: site administrators only,
+ * with a first admin. Subgroups: the parent's admins (who are then admins
+ * of the subgroup too).
+ */
+export const createGroup = (options) => (options.client ?? client).post({
+    url: '/api/groups',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Delete Group
+ *
+ * Delete an empty group: no groups inside and no items or notes (not
+ * even in its trash). Its tags, collections and memberships go with it.
+ */
+export const deleteGroup = (options) => (options.client ?? client).delete({ url: '/api/groups/{group_id}', ...options });
+/**
+ * Change Group
+ */
+export const changeGroup = (options) => (options.client ?? client).patch({
+    url: '/api/groups/{group_id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * List Members
+ *
+ * Everyone in the group: given a role here or in a group above.
+ */
+export const listMembers = (options) => (options.client ?? client).get({ url: '/api/groups/{group_id}/members', ...options });
+/**
+ * Remove Member
+ *
+ * Remove someone's membership here (inherited ones stay).
+ */
+export const removeMember = (options) => (options.client ?? client).delete({ url: '/api/groups/{group_id}/members/{user_id}', ...options });
+/**
+ * Set Member
+ *
+ * Add someone to the group, or change their role here. A role lower than
+ * one inherited from a group above has no effect (inherited roles win).
+ */
+export const setMember = (options) => (options.client ?? client).put({
+    url: '/api/groups/{group_id}/members/{user_id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Leave Group
+ *
+ * Leave a group one was added to. Membership through a group above can
+ * only be left there.
+ */
+export const leaveGroup = (options) => (options.client ?? client).post({ url: '/api/groups/{group_id}/leave', ...options });
+/**
+ * Find Users
+ *
+ * People to add to a group, by username; for site administrators and
+ * group admins.
+ */
+export const findUsers = (options) => (options?.client ?? client).get({ url: '/api/users', ...options });
+/**
+ * List Users
+ */
+export const listUsers = (options) => (options?.client ?? client).get({ url: '/api/admin/users', ...options });
+/**
+ * Create User
+ *
+ * A new account (with its private space); 409 if the name is taken.
+ */
+export const createUser = (options) => (options.client ?? client).post({
+    url: '/api/admin/users',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Change User
+ *
+ * Reset a password, grant or take admin rights, (de)activate. The last
+ * active administrator cannot lose those rights, and nobody deactivates
+ * themselves.
+ */
+export const changeUser = (options) => (options.client ?? client).patch({
+    url: '/api/admin/users/{user_id}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Private Things
+ */
+export const privateThings = (options) => (options.client ?? client).get({ url: '/api/admin/users/{user_id}/private', ...options });
+/**
+ * Hand Over
+ *
+ * Give a deactivated person's papers, notes, tags and collections to a
+ * group or another person.
+ */
+export const handOver = (options) => (options.client ?? client).post({
+    url: '/api/admin/users/{user_id}/hand-over',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * List Backups
+ */
+export const listBackups = (options) => (options?.client ?? client).get({ url: '/api/admin/backups', ...options });
+/**
+ * Start Backup
+ *
+ * Queue a backup now (the worker writes it); 409 if one is running.
+ */
+export const startBackup = (options) => (options.client ?? client).post({
+    url: '/api/admin/backups',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Set Backup Config
+ */
+export const setBackupConfig = (options) => (options.client ?? client).put({
+    url: '/api/admin/backups/config',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Delete Backup
+ */
+export const deleteBackup = (options) => (options.client ?? client).delete({ url: '/api/admin/backups/{name}', ...options });
+/**
+ * Check Restore
+ */
+export const checkRestore = (options) => (options.client ?? client).get({ url: '/api/setup/restore-check', ...options });
+/**
+ * Setup State
+ */
+export const setupState = (options) => (options?.client ?? client).get({ url: '/api/setup', ...options });
+/**
+ * Create First Admin
+ *
+ * The first administrator, logged in right away.
+ */
+export const createFirstAdmin = (options) => (options.client ?? client).post({
+    url: '/api/setup/admin',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Restore On First Start
+ *
+ * Restore a backup from the backup folder into the empty database; then
+ * people log in with their accounts from the backup.
+ */
+export const restoreOnFirstStart = (options) => (options.client ?? client).post({
+    url: '/api/setup/restore',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * List Tokens
+ */
+export const listTokens = (options) => (options?.client ?? client).get({ url: '/api/me/tokens', ...options });
+/**
+ * Create Token
+ *
+ * A token acting as you, narrowed to its scopes (and owners).
+ */
+export const createToken = (options) => (options.client ?? client).post({
+    url: '/api/me/tokens',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+/**
+ * Revoke Token
+ */
+export const revokeToken = (options) => (options.client ?? client).delete({ url: '/api/me/tokens/{token_id}', ...options });