@kyyinfinite/lumina 1.0.0 → 1.0.2

package/src/proto/primitives.js

@@ -1,85 +1,27 @@
-/**
- * @file primitives.js
- * @module lumina/proto/primitives
- *
- * Pure factory functions for every GenAI "UX primitive" used by the AI Rich
- * Response envelope. Each factory returns a plain object ready to be wrapped
- * by a layout view-model (see {@link module:proto/layouts}).
- *
- * All `__typename` strings are sourced from {@link module:proto/enums.TYPENAME}
- * — never hardcode them here.
- */
+import { TYPENAME, SourceType, PromptType } from './enums.js'
 
-import { TYPENAME, ImagineType, SourceType, PromptType } from './enums.js'
-
-/**
- * Markdown-text primitive. May carry inline entities extracted by
- * `extractInlineEntities`.
- *
- * @param {string} text
- * @param {Array<object>} [inlineEntities]
- */
 export function markdownTextPrimitive(text, inlineEntities) {
   const primitive = { text, __typename: TYPENAME.MARKDOWN_TEXT }
   if (inlineEntities?.length) primitive.inline_entities = inlineEntities
   return primitive
 }
 
-/**
- * Code primitive.
- *
- * @param {string} language
- * @param {Array<{ content: string, type: string }>} unifiedBlocks
- */
 export function codePrimitive(language, unifiedBlocks) {
-  return {
-    language,
-    code_blocks: unifiedBlocks,
-    __typename: TYPENAME.CODE,
-  }
+  return { language, code_blocks: unifiedBlocks, __typename: TYPENAME.CODE }
 }
 
-/**
- * Table primitive.
- *
- * @param {Array<object>} unifiedRows   Output of `toTableMetadata().unifiedRows`.
- */
 export function tablePrimitive(unifiedRows) {
-  return {
-    rows: unifiedRows,
-    __typename: TYPENAME.TABLE,
-  }
+  return { rows: unifiedRows, __typename: TYPENAME.TABLE }
 }
 
-/**
- * Search-result (sources) primitive.
- *
- * @param {Array<object>} sources   Pre-shaped source objects.
- */
 export function searchResultPrimitive(sources) {
-  return {
-    sources,
-    __typename: TYPENAME.SEARCH_RESULT,
-  }
+  return { sources, __typename: TYPENAME.SEARCH_RESULT }
 }
 
-/**
- * Reel primitive (one per reel item).
- *
- * @param {object} item   Pre-shaped reel descriptor.
- */
 export function reelPrimitive(item) {
   return { ...item, __typename: TYPENAME.REEL }
 }
 
-/**
- * Imagine primitive — used for both images and videos (animate).
- *
- * @param {{ url: string, mime_type: string, file_length?: number, duration?: number }} media
- * @param {'IMAGE'|'ANIMATE'} kind
- * @param {string} [status='READY']
- * @param {string} [thumbnailBase64]   Base64 JPEG thumbnail (video only).
- */
 export function imaginePrimitive(media, kind, status = 'READY', thumbnailBase64) {
   const primitive = {
     media,
@@ -91,39 +33,18 @@ export function imaginePrimitive(media, kind, status = 'READY', thumbnailBase64)
   return primitive
 }
 
-/**
- * Product-card primitive.
- *
- * @param {object} item   Pre-shaped product descriptor (already media-resolved).
- */
 export function productCardPrimitive(item) {
   return { ...item, __typename: TYPENAME.PRODUCT_CARD }
 }
 
-/**
- * Post primitive.
- *
- * @param {object} p     Pre-shaped post descriptor (already media-resolved).
- * @param {boolean} isCarousel
- */
 export function postPrimitive(p, isCarousel) {
   return { ...p, is_carousel: isCarousel, __typename: TYPENAME.POST }
 }
 
-/**
- * Metadata-text primitive (used for footer / tip).
- *
- * @param {string} text
- */
 export function metadataTextPrimitive(text) {
   return { text, __typename: TYPENAME.METADATA_TEXT }
 }
 
-/**
- * Follow-up suggestion pill primitive.
- *
- * @param {string} text
- */
 export function followUpSuggestionPillPrimitive(text) {
   return {
     prompt_text: text,
@@ -132,11 +53,6 @@ export function followUpSuggestionPillPrimitive(text) {
   }
 }
 
-/**
- * Helper: shape a source entry for `searchResultPrimitive`.
- *
- * @param {{ iconUrl?: string, url?: string, text?: string, subtitle?: string }} src
- */
 export function shapeSourceEntry({ iconUrl = '', url = '', text = '', subtitle = 'AI' } = {}) {
   return {
     source_type: SourceType.THIRD_PARTY,
@@ -147,9 +63,6 @@ export function shapeSourceEntry({ iconUrl = '', url = '', text = '', subtitle =
   }
 }
 
-/**
- * Helper: shape a single reel item for `reelPrimitive`.
- */
 export function shapeReelEntry(item) {
   return {
     reels_url: item.videoUrl ?? item.url ?? '',

package/src/proto/relay-nodes.js

@@ -1,26 +1,5 @@
-/**
- * @file relay-nodes.js
- * @module lumina/proto/relay-nodes
- *
- * Single source of truth for the `additionalNodes` block that Baileys
- * `relayMessage` expects when sending interactive (native-flow) messages.
- *
- * The legacy code duplicated this 12-line block three times (Button.send,
- * ButtonV2.send, Carousel.send). Lumina centralises it here.
- */
-
 import { NativeFlow } from './enums.js'
 
-/**
- * Build the standard biz/interactive/native_flow additional-nodes block.
- *
- * @param {object} [opts]
- * @param {string} [opts.outerVersion=NativeFlow.OUTER_VERSION]
- * @param {string} [opts.flowVersion=NativeFlow.FLOW_VERSION]
- * @param {string} [opts.flowName=NativeFlow.FLOW_NAME_MIXED]
- * @param {boolean} [opts.includeBiz=true]  Whether to wrap in the `<biz>` node.
- * @returns {Array<object>}  Array suitable for `relayMessage`'s `additionalNodes`.
- */
 export function createInteractiveNodes(opts = {}) {
   const outerVersion = opts.outerVersion ?? NativeFlow.OUTER_VERSION
   const flowVersion = opts.flowVersion ?? NativeFlow.FLOW_VERSION
@@ -35,19 +14,9 @@ export function createInteractiveNodes(opts = {}) {
 
   if (!includeBiz) return [interactive]
 
-  return [
-    {
-      tag: NativeFlow.BIZ_TAG,
-      attrs: {},
-      content: [interactive],
-    },
-  ]
+  return [{ tag: NativeFlow.BIZ_TAG, attrs: {}, content: [interactive] }]
 }
 
-/**
- * Convenience: returns the same block but with `name: 'native_flow'` only
- * (no biz wrapper). Useful for non-business accounts.
- */
 export function createBareInteractiveNodes(opts = {}) {
   return createInteractiveNodes({ ...opts, includeBiz: false })
 }

package/src/proto/rich-response.js

@@ -1,46 +1,6 @@
-/**
- * @file rich-response.js
- * @module lumina/proto/rich-response
- *
- * Assembles the `botForwardedMessage.richResponseMessage` envelope used by
- * the AI Rich Response feature. Pure function — no socket access. The
- * {@link AIRichBuilder} calls this from its `build()` method.
- *
- * Replaces the legacy `AIRich.build()` method (1436–1503) which:
- *   - Hardcoded `botJid: '0@bot'`
- *   - Hardcoded `forwardOrigin: 4`
- *   - Hardcoded `forwardingScore: 1`
- *   - Hardcoded personal leftover `disclaimerText: '~ Ahmad tumbuh kembang'`
- * All four are now sourced from {@link module:proto/enums} / parameters.
- */
-
 import crypto from 'node:crypto'
-
 import { BOT_JID, ForwardOrigin } from './enums.js'
 
-/**
- * @typedef {object} RichResponseOptions
- * @property {string} [title]                        Sets `botMetadata.messageDisclaimerText`.
- * @property {Array<object>} sections                Pre-resolved layout sections.
- * @property {Array<object>} [submessages=[]]        Pre-resolved submessage objects.
- * @property {Array<object>} [richResponseSources=[]]
- * @property {object} [contextInfo={}]
- * @property {string} [footer]                       Appended as a metadata-text section.
- * @property {boolean} [forwarded=true]              Attach forward metadata.
- * @property {boolean|object} [notification=false]   Attach session-transparency metadata.
- * @property {boolean} [includesUnifiedResponse=true]
- * @property {boolean} [includesSubmessages=true]
- * @property {object} [quoted]                       Quoted-message descriptor.
- * @property {string} [quotedParticipant]
- * @property {object} [extraPayload]                 Merged at top-level.
- */
-
-/**
- * Assemble a `botForwardedMessage` envelope.
- *
- * @param {RichResponseOptions} opts
- * @returns {Promise<object>}  The envelope, ready to pass to `relayMessage`.
- */
 export async function assembleRichResponse({
   title,
   sections,
@@ -68,11 +28,11 @@ export async function assembleRichResponse({
   const notificationMeta = notification
     ? {
         sessionTransparencyMetadata: {
-          // User-supplied disclaimer (no personal leftovers).
           disclaimerText: typeof notification === 'object' ? notification.disclaimerText ?? '' : '',
-          hcaId: typeof notification === 'object' && notification.hcaId
-            ? notification.hcaId
-            : `hca_${crypto.randomUUID()}`,
+          hcaId:
+            typeof notification === 'object' && notification.hcaId
+              ? notification.hcaId
+              : `hca_${crypto.randomUUID()}`,
           sessionTransparencyType: notification.sessionTransparencyType ?? 1,
         },
       }
@@ -91,10 +51,6 @@ export async function assembleRichResponse({
   const finalSections = footer
     ? [
         ...sections,
-        // Footer is appended as a metadata-text primitive, wrapped in a
-        // Single layout view-model. Built inline to avoid a circular import
-        // with primitives/layouts — those are pure helpers, but this envelope
-        // assembler must remain dependency-light for testability.
         {
           view_model: {
             primitive: { text: footer, __typename: 'GenAIMetadataTextPrimitive' },
@@ -123,18 +79,11 @@ export async function assembleRichResponse({
           unifiedResponse: {
             data: includesUnifiedResponse
               ? Buffer.from(
-                  JSON.stringify({
-                    response_id: crypto.randomUUID(),
-                    sections: finalSections,
-                  }),
+                  JSON.stringify({ response_id: crypto.randomUUID(), sections: finalSections }),
                 ).toString('base64')
               : '',
           },
-          contextInfo: {
-            ...forwardMeta,
-            ...quotedMeta,
-            ...contextInfo,
-          },
+          contextInfo: { ...forwardMeta, ...quotedMeta, ...contextInfo },
         },
       },
     },

package/src/proto/updater.js

@@ -1,24 +1,7 @@
-/**
- * @file updater.js
- * @module lumina/proto/updater
  *
- * ProtoUpdater — automatic WAProto maintenance utility.
  *
- * WhatsApp constantly ships new protobuf definitions to its Web client, and
- * the community `@whiskeysockets/baileys` package vendors a snapshot of those
- * definitions as `WAProto/`. Lumina ships a small utility that:
  *
- *   1. Backs up the current WAProto tree before any mutation.
- *   2. Transforms the generated CommonJS files into ESM (`require` → `import`,
- *      `module.exports` → `export`).
- *   3. Fixes known upstream issues (e.g. the `HistorySyncType` enum that the
- *      `pbjs` generator sometimes emits with the wrong numeric tag).
- *   4. Validates the result by `import()`-ing each module file.
- *   5. Rolls back automatically on validation failure (configurable).
  *
- * The updater is opt-in: it never runs at import time. Users invoke it from
- * the CLI or programmatically when they want to refresh the proto bundle.
- */
 
 import { promises as fs } from 'node:fs'
 import path from 'node:path'
@@ -28,19 +11,12 @@ import { ProtocolError } from '../errors.js'
 import { sha256 } from '../utils/id.js'
 import { createLogger } from '../utils/logger.js'
 
-/** @typedef {import('../utils/logger.js').Logger} Logger */
 
-/**
- * Known WAProto fixes. Each entry: { file: RegExp, apply: (content: string) => string }.
- * Keeping these in one place makes them trivial to audit & extend.
- */
 const KNOWN_FIXES = [
   {
     name: 'history-sync-type-enum',
     file: /HistorySync\.js$/,
     apply: (c) =>
-      // Ensure `HistorySyncType.INITIAL_BOOTSTRAP = 0` exists — some pbjs runs
-      // emit it as `= 1` which breaks downstream comparison logic.
       c.replace(
         /(HistorySyncType\s*=\s*\{)[\s\S]*?\}/,
         (m) =>
@@ -60,32 +36,21 @@ const KNOWN_FIXES = [
   },
 ]
 
-/** Pattern for CommonJS `require('...')` — used by CJS→ESM transform. */
 const RE_REQUIRE = /require\(\s*(['"])([^'"]+)\1\s*\)/g
 
-/** Pattern for `module.exports = ...` / `exports.x = ...`. */
 const RE_MODULE_EXPORTS_ASSIGN = /module\.exports\s*=\s*/g
 const RE_EXPORTS_DOT = /exports\.(\w+)\s*=\s*/g
 
-/** Pattern for `const x = require('...')` — convert to `import`. */
 const RE_CONST_REQUIRE =
   /(?:const|let|var)\s+(\w+)\s*=\s*require\(\s*(['"])([^'"]+)\2\s*\)/g
 
-/** Pattern for destructured `const { a, b } = require('...')`. */
 const RE_DESTRUCT_REQUIRE =
   /(?:const|let|var)\s*\{([^}]+)\}\s*=\s*require\(\s*(['"])([^'"]+)\2\s*\)/g
 
-/**
- * Convert a CommonJS module's source to ESM.
  *
- * @param {string} src  Original CommonJS source.
- * @returns {string}    ESM source.
- */
 export function transformToESM(src) {
   let out = src
-  // 1. const X = require('mod') → import X from 'mod'
   out = out.replace(RE_CONST_REQUIRE, (_, name, _q, mod) => `import ${name} from '${mod}'`)
-  // 2. const { a, b } = require('mod') → import { a, b } from 'mod'
   out = out.replace(RE_DESTRUCT_REQUIRE, (_, names, _q, mod) => {
     const cleaned = names
       .split(',')
@@ -95,24 +60,14 @@ export function transformToESM(src) {
       .join(', ')
     return `import { ${cleaned} } from '${mod}'`
   })
-  // 3. Bare require('mod') → import 'mod'
   out = out.replace(RE_REQUIRE, (_, _q, mod) => `import '${mod}'`)
-  // 4. module.exports = X → export default X
   out = out.replace(RE_MODULE_EXPORTS_ASSIGN, 'export default ')
-  // 5. exports.x = ... → export const x = ...
   out = out.replace(RE_EXPORTS_DOT, (_, name) => `export const ${name} = `)
-  // 6. 'use strict' is implicit in ESM — drop it.
   out = out.replace(/^['"]use strict['"];?\s*\n/m, '')
   return out
 }
 
-/**
- * Apply every known WAProto fix to a single file's content.
  *
- * @param {string} filename  Absolute path of the file being patched.
- * @param {string} content   Current file content.
- * @returns {{ content: string, applied: string[] }}  New content + list of fix names that fired.
- */
 export function applyKnownFixes(filename, content) {
   const applied = []
   let next = content
@@ -126,20 +81,14 @@ export function applyKnownFixes(filename, content) {
   return { content: next, applied }
 }
 
-/**
- * ProtoUpdater — high-level orchestration.
- */
 export class ProtoUpdater {
-  /** @param {object} [opts] */
   constructor(opts = {}) {
     this.protoPath = path.resolve(opts.protoPath ?? this.#defaultProtoPath())
     this.backupDir = path.resolve(opts.backupDir ?? path.join(this.protoPath, '..', 'WAProto.backups'))
     this.logger = (opts.logger ?? createLogger({ level: 'warn' })).child('proto-updater')
-    /** @type {Array<{ id: string, timestamp: number, path: string, hash: string }>} */
     this.history = []
   }
 
-  /** Resolve the default WAProto directory inside the installed Baileys package. */
   #defaultProtoPath() {
     try {
       const baileysPkg = require.resolve('@whiskeysockets/baileys/package.json', {
@@ -147,17 +96,11 @@ export class ProtoUpdater {
       })
       return path.join(path.dirname(baileysPkg), 'WAProto')
     } catch {
-      // Fallback: assume CWD/WAProto
       return path.join(process.cwd(), 'WAProto')
     }
   }
 
-  /**
-   * Walk a directory recursively, returning every `.js` file path.
    *
-   * @param {string} dir
-   * @returns {Promise<string[]>}
-   */
   async #listJsFiles(dir) {
     const entries = await fs.readdir(dir, { withFileTypes: true })
     const out = []
@@ -169,11 +112,7 @@ export class ProtoUpdater {
     return out
   }
 
-  /**
-   * Create a timestamped backup of the current WAProto tree.
    *
-   * @returns {Promise<{ id: string, timestamp: number, path: string, hash: string }>}
-   */
   async backup() {
     await fs.mkdir(this.backupDir, { recursive: true })
     const timestamp = Date.now()
@@ -188,13 +127,7 @@ export class ProtoUpdater {
     return record
   }
 
-  /**
-   * Recursively hash every `.js` file in a directory. Used to detect
-   * whether a transform actually changed anything.
    *
-   * @param {string} dir
-   * @returns {Promise<string>}
-   */
   async #hashTree(dir) {
     const files = (await this.#listJsFiles(dir)).sort()
     const hashes = await Promise.all(
@@ -206,11 +139,7 @@ export class ProtoUpdater {
     return sha256(hashes.join('\n'))
   }
 
-  /**
-   * Restore a specific backup by id.
    *
-   * @param {string} id
-   */
   async restore(id) {
     const record = this.history.find((h) => h.id === id)
     if (!record) {
@@ -221,9 +150,6 @@ export class ProtoUpdater {
     this.logger.warn(`restored backup: ${id}`)
   }
 
-  /**
-   * Rollback to the most recent successful backup.
-   */
   async rollback() {
     if (this.history.length === 0) {
       throw new ProtocolError('no backup available for rollback', {
@@ -234,11 +160,7 @@ export class ProtoUpdater {
     await this.restore(last.id)
   }
 
-  /**
-   * Validate the current WAProto tree by importing every `.js` file.
    *
-   * @returns {Promise<{ ok: boolean, errors: Array<{ file: string, message: string }> }>}
-   */
   async validate() {
     const files = await this.#listJsFiles(this.protoPath)
     const errors = []
@@ -254,14 +176,7 @@ export class ProtoUpdater {
     return { ok: errors.length === 0, errors }
   }
 
-  /**
-   * Run the full update pipeline: backup → transform → fix → validate → commit/rollback.
    *
-   * @param {object} [opts]
-   * @param {boolean} [opts.autoRollback=true]   Rollback automatically on validation failure.
-   * @param {boolean} [opts.dryRun=false]        Don't write to disk — return a diff summary.
-   * @returns {Promise<{ success: boolean, fromHash: string, toHash: string, backupId: string|null, appliedFixes: string[], errors: any[] }>}
-   */
   async update(opts = {}) {
     const autoRollback = opts.autoRollback ?? true
     const dryRun = opts.dryRun ?? false

package/src/services/index.js

@@ -1,10 +1,3 @@
-/**
- * @file services/index.js
- * @module lumina/services
- *
- * Barrel re-export for the services layer.
- */
-
 export { MediaService } from './media-service.js'
 export { ProtoService } from './proto-service.js'
 export { MessageService } from './message-service.js'

package/src/services/media-service.js

@@ -1,12 +1,3 @@
-/**
- * @file media-service.js
- * @module lumina/services/media-service
- *
- * High-level orchestrator for every media operation. Composes the lower-level
- * `media/*` modules with a Connection instance and (optionally) a small LRU
- * cache for repeated URL fetches.
- */
-
 import { fetchBuffer } from '../media/fetch.js'
 import { resize, thumbnail } from '../media/image.js'
 import { getMp4Duration, extractThumbnail } from '../media/video.js'
@@ -14,24 +5,9 @@ import { uploadToWhatsApp } from '../media/uploader.js'
 import { resolveMedia } from '../media/resolver.js'
 import { sniffMime, mimeToCategory } from '../utils/mime.js'
 
-/** @typedef {import('../client/connection.js').Connection} Connection */
-/** @typedef {import('../utils/logger.js').Logger} Logger */
-
 const LRU_MAX = 128
 
-/**
- * @typedef {object} MediaServiceOptions
- * @property {boolean} [cache=true]      Enable URL→buffer LRU cache.
- * @property {number}  [cacheMax=128]    Max cache entries.
- * @property {Logger}  [logger]
- * @property {string}  [uploadJid]
- */
-
 export class MediaService {
-  /**
-   * @param {Connection} conn
-   * @param {MediaServiceOptions} [opts]
-   */
   constructor(conn, opts = {}) {
     if (!conn) throw new Error('Connection is required for MediaService')
     this.conn = conn
@@ -39,51 +15,30 @@ export class MediaService {
     this.uploadJid = opts.uploadJid
     this.#cacheEnabled = opts.cache ?? true
     this.#cacheMax = opts.cacheMax ?? LRU_MAX
-    /** @type {Map<string, { buf: Buffer, ts: number }>} */
     this.#cache = new Map()
   }
 
-  /** @type {boolean} */
   #cacheEnabled
-  /** @type {number} */
   #cacheMax
-  /** @type {Map<string, { buf: Buffer, ts: number }>} */
   #cache
 
-  /**
-   * @param {string} url
-   * @returns {Buffer | undefined}
-   */
   #cacheGet(url) {
     if (!this.#cacheEnabled) return undefined
     const entry = this.#cache.get(url)
     if (!entry) return undefined
-    // Refresh LRU order.
     this.#cache.delete(url)
     this.#cache.set(url, entry)
     return entry.buf
   }
 
-  /**
-   * @param {string} url
-   * @param {Buffer} buf
-   */
   #cacheSet(url, buf) {
     if (!this.#cacheEnabled) return
     if (this.#cache.size >= this.#cacheMax) {
-      const oldest = this.#cache.keys().next().value
-      this.#cache.delete(oldest)
+      this.#cache.delete(this.#cache.keys().next().value)
     }
     this.#cache.set(url, { buf, ts: Date.now() })
   }
 
-  /**
-   * Fetch a URL into a Buffer. Uses the cache when enabled.
-   *
-   * @param {string} url
-   * @param {object} [opts]   Forwarded to fetchBuffer.
-   * @returns {Promise<Buffer>}
-   */
   async fetch(url, opts) {
     const cached = this.#cacheGet(url)
     if (cached) return cached
@@ -92,90 +47,34 @@ export class MediaService {
     return buf
   }
 
-  /**
-   * Resize an image buffer.
-   *
-   * @param {Buffer} buf
-   * @param {object} opts
-   * @returns {Promise<Buffer>}
-   */
   async resize(buf, opts) {
     return resize(buf, opts)
   }
 
-  /**
-   * Generate a square thumbnail.
-   *
-   * @param {Buffer} buf
-   * @param {number} [size=300]
-   * @param {'png'|'jpeg'|'webp'} [format]
-   * @returns {Promise<Buffer>}
-   */
   async thumbnail(buf, size, format) {
     return thumbnail(buf, size, format)
   }
 
-  /**
-   * Get MP4 duration in seconds. Returns 0 on failure (silent default).
-   *
-   * @param {Buffer} buf
-   * @returns {number}
-   */
   duration(buf) {
     return getMp4Duration(buf)
   }
 
-  /**
-   * Extract a thumbnail frame from a video buffer.
-   *
-   * @param {Buffer} buf
-   * @param {object} [opts]
-   * @returns {Promise<Buffer|string>}
-   */
   async videoThumbnail(buf, opts) {
     return extractThumbnail(buf, opts)
   }
 
-  /**
-   * Upload a buffer to WhatsApp.
-   *
-   * @param {Buffer | { url: string }} source
-   * @param {'image'|'video'|'audio'|'document'} mediaType
-   * @param {object} [opts]
-   * @returns {Promise<string>}
-   */
   async upload(source, mediaType, opts) {
     return uploadToWhatsApp(this.conn, source, mediaType, { jid: this.uploadJid, ...opts })
   }
 
-  /**
-   * Resolve a media source (URL | base64 | Buffer | array) per strategy.
-   *
-   * @param {string | Buffer | Array} source
-   * @param {object} [opts]
-   * @returns {Promise<string | Buffer | Array<string | Buffer>>}
-   */
   async resolve(source, opts) {
     return resolveMedia(this.conn, source, opts)
   }
 
-  /**
-   * Convenience: sniff MIME from a buffer.
-   *
-   * @param {Buffer} buf
-   * @param {string} [filename]
-   * @returns {string}
-   */
   sniff(buf, filename) {
     return sniffMime(buf, filename)
   }
 
-  /**
-   * Convenience: derive WA media category from MIME.
-   *
-   * @param {string} mime
-   * @returns {'image'|'video'|'audio'|'document'}
-   */
   category(mime) {
     return mimeToCategory(mime)
   }