@kyyinfinite/lumina 1.0.4 → 1.0.6

package/README.md

@@ -360,88 +360,6 @@ Type-checked features:
 - Enum-like catalogs (`MessageType`, `HeaderType`, `LayoutKind`, ...) are `Readonly`
 - `Bot.raw` escape hatch typed as `WASocket`
 
-
----
-
-## Baileys Compatibility
-
-Lumina is not tied to a specific Baileys version or fork. When `new Bot(sock)` is called, Lumina automatically detects the available Baileys package in your project.
-
-### Auto-Detect (default)
-
-No configuration is required. Lumina tries the following packages in order and uses the first one that can be successfully imported:
-
-```
-@kyyinfinite/baileys
-@whiskeysockets/baileys
-baileys
-@adiwajshing/baileys
-@brunocgc/baileys
-@open-wa/baileys
-```
-
-```js
-// Lumina automatically detects @kyyinfinite/baileys (or any installed fork)
-const bot = new Bot(sock)
-```
-
----
-
-### Explicit Package Name
-
-If you're using a custom-named fork, specify it with `baileysPackage`:
-
-```js
-const bot = new Bot(sock, {
-  baileysPackage: '@namafork/baileys',
-})
-```
-
----
-
-### Module Injection
-
-The fastest option — zero dynamic imports. Simply inject the module directly:
-
-```js
-import * as baileys from '@kyyinfinite/baileys'
-
-const bot = new Bot(sock, {
-  baileys,
-})
-```
-
-This is ideal if you've already imported Baileys elsewhere and want to avoid duplicate imports.
-
----
-
-### Socket Fallback
-
-If no Baileys package is found, Lumina falls back to its internal socket-based implementation. Core features (text, buttons, carousel, stickers) continue to work. Media uploads require `sock.waUploadToServer` to be available.
-
----
-
-### Debug: Check the Active Adapter
-
-```js
-const bot = new Bot(sock)
-console.log(await bot.connection.adapterSource())
-// → '@kyyinfinite/baileys'
-// → '@whiskeysockets/baileys'
-// → 'injected-module'
-// → 'socket-fallback'
-```
-
----
-
-### Summary
-
-| Option | When to use |
-|---|---|
-| _(not set)_ | Auto-detect. Recommended for most use cases. |
-| `baileysPackage: 'name'` | For custom forks that are not included in the auto-detect list. |
-| `baileys: module` | Manual module injection for the best performance. |
-
 ---
 
 ## API Reference

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kyyinfinite/lumina",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Lumina — Modern WhatsApp framework built on top of Baileys. Hide the protocol complexity, expose a fluent API.",
   "type": "module",
   "main": "./src/index.js",

package/src/builders/ai-rich.js

@@ -1,61 +1,43 @@
-
 import { applyContentFields } from './base.js'
 import { ensureObjectOrArray, ensureString, ensureStringArray } from '../utils/validator.js'
 import { ValidationError } from '../errors.js'
-
 import { extractInlineEntities } from '../parsers/inline-entity.js'
 import { tokenizeCode } from '../parsers/code-tokenizer.js'
 import { toTableMetadata } from '../parsers/table-metadata.js'
-
 import {
-  markdownTextPrimitive,
-  codePrimitive,
-  tablePrimitive,
-  searchResultPrimitive,
-  reelPrimitive,
-  imaginePrimitive,
-  productCardPrimitive,
-  postPrimitive,
-  metadataTextPrimitive,
-  followUpSuggestionPillPrimitive,
-  shapeSourceEntry,
-  shapeReelEntry,
+  markdownTextPrimitive, codePrimitive, tablePrimitive, searchResultPrimitive,
+  reelPrimitive, imaginePrimitive, productCardPrimitive, postPrimitive,
+  metadataTextPrimitive, followUpSuggestionPillPrimitive, shapeSourceEntry, shapeReelEntry,
 } from '../proto/primitives.js'
 import { singleLayout, hscrollLayout, actionRowLayout } from '../proto/layouts.js'
 import { assembleRichResponse } from '../proto/rich-response.js'
 import { MessageType, ImagineType, LayoutKind } from '../proto/enums.js'
 
-
 export class AIRichBuilder {
+  #conn
+  #proto
+  #media
+
   constructor(conn, proto, media) {
     applyContentFields(this)
     this.#conn = conn
     this.#proto = proto
     this.#media = media
-
     this._submessages = []
     this._sections = []
     this._richResponseSources = []
-
     this._forwarded = true
     this._notification = false
     this._includesUnifiedResponse = true
     this._includesSubmessages = true
-    this._quoted
-    this._quotedParticipant
-  }
-
-
-
-  forwarded(v = true) {
-    this._forwarded = v
-    return this
+    this._quoted = undefined
+    this._quotedParticipant = undefined
   }
 
-  notification(v) {
-    this._notification = v
-    return this
-  }
+  forwarded(v = true) { this._forwarded = v; return this }
+  notification(v) { this._notification = v; return this }
+  includesUnifiedResponse(v = true) { this._includesUnifiedResponse = v; return this }
+  includesSubmessages(v = true) { this._includesSubmessages = v; return this }
 
   quoted(quoted, quotedParticipant) {
     this._quoted = quoted
@@ -63,16 +45,6 @@ export class AIRichBuilder {
     return this
   }
 
-  includesUnifiedResponse(v = true) {
-    this._includesUnifiedResponse = v
-    return this
-  }
-
-  includesSubmessages(v = true) {
-    this._includesSubmessages = v
-    return this
-  }
-
   submessage(msg) {
     const items = Array.isArray(msg) ? msg : [msg]
     items.forEach((m) => ensureObjectOrArray(m, 'submessage'))
@@ -80,42 +52,23 @@ export class AIRichBuilder {
     return this
   }
 
-
   async text(text, opts = {}) {
     ensureString(text, 'text')
     const { hyperlink = true, citation = true, latex = true } = opts
-
-    const { text: rewritten, metadata } = extractInlineEntities(text, {
-      hyperlink,
-      citation,
-      latex,
-    })
-
-    this._submessages.push({
-      messageType: MessageType.TEXT,
-      messageText: rewritten,
-    })
-
-    this._sections.push(
-      singleLayout(markdownTextPrimitive(rewritten, metadata.length ? metadata : undefined)),
-    )
+    const { text: rewritten, metadata } = extractInlineEntities(text, { hyperlink, citation, latex })
+    this._submessages.push({ messageType: MessageType.TEXT, messageText: rewritten })
+    this._sections.push(singleLayout(markdownTextPrimitive(rewritten, metadata.length ? metadata : undefined)))
     return this
   }
 
   async code(language, code) {
     ensureString(language, 'language')
     ensureString(code, 'code')
-
     const { codeBlock, unifiedBlocks } = tokenizeCode(code, language)
-
     this._submessages.push({
       messageType: MessageType.CODE,
-      codeMetadata: {
-        codeLanguage: language,
-        codeBlocks: codeBlock,
-      },
+      codeMetadata: { codeLanguage: language, codeBlocks: codeBlock },
     })
-
     this._sections.push(singleLayout(codePrimitive(language, unifiedBlocks)))
     return this
   }
@@ -126,34 +79,22 @@ export class AIRichBuilder {
     }
     const { title = '', hyperlink = true, citation = true, latex = true } = opts
     const meta = toTableMetadata(table, { title, hyperlink, citation, latex })
-
     this._submessages.push({
       messageType: MessageType.TABLE,
       tableMetadata: { title: meta.title, rows: meta.rows },
     })
-
     this._sections.push(singleLayout(tablePrimitive(meta.unifiedRows)))
     return this
   }
 
   async image(source, opts = {}) {
-    const { resolveUrl = false } = opts
     const list = Array.isArray(source) ? source : [source]
-
     const resolved = await Promise.all(
       list.map(async (s) => {
-        const url = await this.#media.resolve(s, {
-          mediaType: 'image',
-          strategy: resolveUrl ? 'auto' : 'auto',
-        })
-        return {
-          imagePreviewUrl: url,
-          imageHighResUrl: url,
-          sourceUrl: url,
-        }
+        const url = await this.#media.resolve(s, { mediaType: 'image', strategy: 'auto' })
+        return { imagePreviewUrl: url, imageHighResUrl: url, sourceUrl: url }
       }),
     )
-
     this._submessages.push({
       messageType: MessageType.RICH_RESPONSE,
       gridImageMetadata: {
@@ -161,15 +102,9 @@ export class AIRichBuilder {
         imageUrls: resolved,
       },
     })
-
     for (const r of resolved) {
       this._sections.push(
-        singleLayout(
-          imaginePrimitive(
-            { url: r.imagePreviewUrl, mime_type: 'image/png' },
-            ImagineType.IMAGE,
-          ),
-        ),
+        singleLayout(imaginePrimitive({ url: r.imagePreviewUrl, mime_type: 'image/png' }, ImagineType.IMAGE)),
       )
     }
     return this
@@ -177,22 +112,15 @@ export class AIRichBuilder {
 
   async video(source, opts = {}) {
     const { autoFill = true } = opts
-    const isObjectVideo = (v) => v && typeof v === 'object' && v.url
+    const isObjVideo = (v) => v && typeof v === 'object' && v.url
     const items = Array.isArray(source) ? source : [source]
 
-    this._submessages.push({
-      messageType: MessageType.TEXT,
-      messageText: '[ CANNOT_LOAD_VIDEO ]',
-    })
+    this._submessages.push({ messageType: MessageType.TEXT, messageText: '[ CANNOT_LOAD_VIDEO ]' })
 
     await Promise.all(
       items.map(async (item) => {
-        const isObj = isObjectVideo(item)
-        const url = await this.#media.resolve(
-          isObj ? item.url : item,
-          { mediaType: 'video', strategy: 'auto' },
-        )
-
+        const isObj = isObjVideo(item)
+        const url = await this.#media.resolve(isObj ? item.url : item, { mediaType: 'video', strategy: 'auto' })
         let fileLength = isObj && item.file_length != null ? item.file_length : 0
         let duration = isObj && item.duration != null ? item.duration : 0
         let thumbnailB64 = null
@@ -204,26 +132,18 @@ export class AIRichBuilder {
               fileLength = buf.length
               duration = this.#media.duration(buf)
               thumbnailB64 = await this.#media.videoThumbnail(buf, {
-                time: 0,
-                result: 'base64',
-                resizeOutput: true,
-                width: 300,
-                height: 300,
+                time: 0, result: 'base64', resizeOutput: true, width: 300, height: 300,
               })
             }
-          } catch {
-          }
+          } catch {}
         }
 
         const mimeType = isObj ? item.mime_type ?? 'video/mp4' : 'video/mp4'
-
         this._sections.push(
           singleLayout(
             imaginePrimitive(
               { url, mime_type: mimeType, file_length: fileLength, duration },
-              ImagineType.ANIMATE,
-              'READY',
-              thumbnailB64 || undefined,
+              ImagineType.ANIMATE, 'READY', thumbnailB64 || undefined,
             ),
           ),
         )
@@ -236,12 +156,7 @@ export class AIRichBuilder {
     if (!Array.isArray(sources)) {
       throw new ValidationError('sources must be an array', { code: 'LUMINA_VALIDATION_SOURCE' })
     }
-
-    const normalised =
-      sources.length && typeof sources[0] === 'string'
-        ? [sources]
-        : sources
-
+    const normalised = sources.length && typeof sources[0] === 'string' ? [sources] : sources
     const entries = await Promise.all(
       normalised.map(async (entry) => {
         const [iconUrl, url, text] = entry
@@ -251,7 +166,6 @@ export class AIRichBuilder {
         return shapeSourceEntry({ iconUrl: resolvedIcon, url, text })
       }),
     )
-
     this._sections.push(singleLayout(searchResultPrimitive(entries)))
     return this
   }
@@ -259,27 +173,17 @@ export class AIRichBuilder {
   async reels(items) {
     ensureObjectOrArray(items, 'reels')
     const list = Array.isArray(items) ? items : [items]
-
     const resolved = await Promise.all(
       list.map(async (item) => {
-        const [avatar, thumb] = await Promise.all([
-          item.profileIconUrl ?? item.profile_url ?? item.profile
-            ? this.#media.resolve(item.profileIconUrl ?? item.profile_url ?? item.profile, {
-                mediaType: 'image',
-                strategy: 'auto',
-              })
-            : Promise.resolve(''),
-          item.thumbnailUrl ?? item.thumbnail
-            ? this.#media.resolve(item.thumbnailUrl ?? item.thumbnail, {
-                mediaType: 'image',
-                strategy: 'auto',
-              })
-            : Promise.resolve(''),
+        const avatarSrc = item.profileIconUrl ?? item.profile_url ?? item.profile
+        const thumbSrc = item.thumbnailUrl ?? item.thumbnail
+        const [avatar, thumbnail] = await Promise.all([
+          avatarSrc ? this.#media.resolve(avatarSrc, { mediaType: 'image', strategy: 'auto' }) : Promise.resolve(''),
+          thumbSrc ? this.#media.resolve(thumbSrc, { mediaType: 'image', strategy: 'auto' }) : Promise.resolve(''),
         ])
-        return { ...item, avatar, thumbnail: thumb }
+        return { ...item, avatar, thumbnail }
       }),
     )
-
     this._submessages.push({
       messageType: MessageType.REELS,
       contentItemsMetadata: {
@@ -294,7 +198,6 @@ export class AIRichBuilder {
         })),
       },
     })
-
     resolved.forEach((item, idx) => {
       this._richResponseSources.push({
         provider: 'LUMINA',
@@ -306,110 +209,62 @@ export class AIRichBuilder {
         sourceTitle: item.username ?? '',
       })
     })
-
-    this._sections.push(
-      hscrollLayout(resolved.map((item) => reelPrimitive(shapeReelEntry(item)))),
-    )
+    this._sections.push(hscrollLayout(resolved.map((item) => reelPrimitive(shapeReelEntry(item)))))
     return this
   }
 
   async product(item) {
     ensureObjectOrArray(item, 'product')
     const list = Array.isArray(item) ? item : [item]
-
-    this._submessages.push({
-      messageType: MessageType.TEXT,
-      messageText: '[ CANNOT_LOAD_PRODUCT ]',
-    })
-
+    this._submessages.push({ messageType: MessageType.TEXT, messageText: '[ CANNOT_LOAD_PRODUCT ]' })
     const products = await Promise.all(
       list.map(async (p) => {
+        const imgSrc = p.image_url ?? p.image
+        const iconSrc = p.icon_url ?? p.icon
         const [imageUrl, iconUrl] = await Promise.all([
-          p.image_url ?? p.image
-            ? this.#media.resolve(p.image_url ?? p.image, { mediaType: 'image', strategy: 'auto' })
-            : Promise.resolve(''),
-          p.icon_url ?? p.icon
-            ? this.#media.resolve(p.icon_url ?? p.icon, { mediaType: 'image', strategy: 'auto' })
-            : Promise.resolve(''),
+          imgSrc ? this.#media.resolve(imgSrc, { mediaType: 'image', strategy: 'auto' }) : Promise.resolve(''),
+          iconSrc ? this.#media.resolve(iconSrc, { mediaType: 'image', strategy: 'auto' }) : Promise.resolve(''),
         ])
         return {
-          title: p.title,
-          brand: p.brand,
-          price: p.price,
-          sale_price: p.sale_price,
+          title: p.title, brand: p.brand, price: p.price, sale_price: p.sale_price,
           product_url: p.product_url ?? p.url,
           image: { url: imageUrl },
           additional_images: [{ url: iconUrl }],
         }
       }),
     )
-
     const primitives = products.map((p) => productCardPrimitive(p))
-    this._sections.push(
-      list.length === 1 ? singleLayout(primitives[0]) : hscrollLayout(primitives),
-    )
+    this._sections.push(list.length === 1 ? singleLayout(primitives[0]) : hscrollLayout(primitives))
     return this
   }
 
   async post(item) {
     ensureObjectOrArray(item, 'post')
     const list = Array.isArray(item) ? item : [item]
-
-    this._submessages.push({
-      messageType: MessageType.TEXT,
-      messageText: '[ CANNOT_LOAD_POST ]',
-    })
-
+    this._submessages.push({ messageType: MessageType.TEXT, messageText: '[ CANNOT_LOAD_POST ]' })
     const isCarousel = list.length > 1
-
     const primitives = await Promise.all(
       list.map(async (p) => {
+        const profileSrc = p.profile_picture_url ?? p.profile_url ?? p.profile
+        const thumbSrc = p.thumbnail_url ?? p.thumbnail
+        const footerSrc = p.footer_icon ?? p.icon
         const [profileUrl, thumbUrl, footerIcon] = await Promise.all([
-          p.profile_picture_url ?? p.profile_url ?? p.profile
-            ? this.#media.resolve(p.profile_picture_url ?? p.profile_url ?? p.profile, {
-                mediaType: 'image',
-                strategy: 'auto',
-              })
-            : Promise.resolve(''),
-          p.thumbnail_url ?? p.thumbnail
-            ? this.#media.resolve(p.thumbnail_url ?? p.thumbnail, {
-                mediaType: 'image',
-                strategy: 'auto',
-              })
-            : Promise.resolve(''),
-          p.footer_icon ?? p.icon
-            ? this.#media.resolve(p.footer_icon ?? p.icon, {
-                mediaType: 'image',
-                strategy: 'auto',
-              })
-            : Promise.resolve(''),
+          profileSrc ? this.#media.resolve(profileSrc, { mediaType: 'image', strategy: 'auto' }) : Promise.resolve(''),
+          thumbSrc ? this.#media.resolve(thumbSrc, { mediaType: 'image', strategy: 'auto' }) : Promise.resolve(''),
+          footerSrc ? this.#media.resolve(footerSrc, { mediaType: 'image', strategy: 'auto' }) : Promise.resolve(''),
         ])
-
-        return postPrimitive(
-          {
-            title: p.title ?? '',
-            subtitle: p.subtitle ?? '',
-            username: p.username ?? '',
-            profile_picture_url: profileUrl,
-            is_verified: !!(p.is_verified ?? p.verified),
-            thumbnail_url: thumbUrl,
-            post_caption: p.post_caption ?? p.caption ?? '',
-            likes_count: p.likes_count ?? p.like ?? 0,
-            comments_count: p.comments_count ?? p.comment ?? 0,
-            shares_count: p.shares_count ?? p.share ?? 0,
-            post_url: p.post_url ?? p.url ?? '',
-            post_deeplink: p.post_deeplink ?? p.deeplink ?? '',
-            source_app: p.source_app ?? p.source ?? 'INSTAGRAM',
-            footer_label: p.footer_label ?? p.footer ?? '',
-            footer_icon: footerIcon,
-            orientation: p.orientation ?? 'LANDSCAPE',
-            post_type: p.post_type ?? 'VIDEO',
-          },
-          isCarousel,
-        )
+        return postPrimitive({
+          title: p.title ?? '', subtitle: p.subtitle ?? '', username: p.username ?? '',
+          profile_picture_url: profileUrl, is_verified: !!(p.is_verified ?? p.verified),
+          thumbnail_url: thumbUrl, post_caption: p.post_caption ?? p.caption ?? '',
+          likes_count: p.likes_count ?? p.like ?? 0, comments_count: p.comments_count ?? p.comment ?? 0,
+          shares_count: p.shares_count ?? p.share ?? 0, post_url: p.post_url ?? p.url ?? '',
+          post_deeplink: p.post_deeplink ?? p.deeplink ?? '', source_app: p.source_app ?? p.source ?? 'INSTAGRAM',
+          footer_label: p.footer_label ?? p.footer ?? '', footer_icon: footerIcon,
+          orientation: p.orientation ?? 'LANDSCAPE', post_type: p.post_type ?? 'VIDEO',
+        }, isCarousel)
       }),
     )
-
     this._sections.push(hscrollLayout(primitives))
     return this
   }
@@ -423,15 +278,12 @@ export class AIRichBuilder {
 
   async suggest(suggestion, opts = {}) {
     const { scroll = true, layout } = opts
-
     if (typeof suggestion === 'string') {
       suggestion = [suggestion]
     } else {
       ensureStringArray(suggestion, 'suggestion')
     }
-
     const pills = suggestion.map((text) => followUpSuggestionPillPrimitive(text))
-
     let kind
     if (layout) {
       kind = layout
@@ -440,7 +292,6 @@ export class AIRichBuilder {
     } else {
       kind = scroll ? LayoutKind.HSCROLL : LayoutKind.ACTION_ROW
     }
-
     if (kind === LayoutKind.SINGLE) {
       this._sections.push(singleLayout(pills[0], { __typename: 'GenAIUnifiedResponseSection' }))
     } else if (kind === LayoutKind.HSCROLL) {
@@ -451,7 +302,6 @@ export class AIRichBuilder {
     return this
   }
 
-
   async build(opts = {}) {
     return assembleRichResponse({
       title: this._title,

package/src/media/video.js

@@ -1,9 +1,4 @@
- *
- *
- *
-
 import { PassThrough, Readable } from 'node:stream'
-
 import { MediaError } from '../errors.js'
 import { resize } from './image.js'
 
@@ -16,7 +11,7 @@ async function loadFfmpeg() {
         return (await import('fluent-ffmpeg')).default
       } catch (err) {
         throw new MediaError(
-          "fluent-ffmpeg is not installed. Install it with `npm i fluent-ffmpeg` (and ffmpeg itself) to use video thumbnails.",
+          'fluent-ffmpeg is not installed. Run: npm i fluent-ffmpeg',
           { code: 'LUMINA_MEDIA_FFMPEG_MISSING', cause: err },
         )
       }
@@ -25,8 +20,6 @@ async function loadFfmpeg() {
   return ffmpegPromise
 }
 
- *
- *
 export function getMp4Duration(buffer, opts = {}) {
   const { silent = true } = opts
 
@@ -36,16 +29,12 @@ export function getMp4Duration(buffer, opts = {}) {
   }
 
   try {
-    if (!Buffer.isBuffer(buffer) || buffer.length < 8) {
-      return fail('invalid buffer: too short')
-    }
+    if (!Buffer.isBuffer(buffer) || buffer.length < 8) return fail('invalid buffer: too short')
 
     let offset = 0
     while (offset < buffer.length - 8) {
       const size = buffer.readUInt32BE(offset)
-      if (size < 8 || offset + size > buffer.length) {
-        return fail('invalid atom size')
-      }
+      if (size < 8 || offset + size > buffer.length) return fail('invalid atom size')
 
       const type = buffer.toString('ascii', offset + 4, offset + 8)
       if (type === 'moov') {
@@ -53,9 +42,7 @@ export function getMp4Duration(buffer, opts = {}) {
         const moovEnd = offset + size
         while (moovOffset < moovEnd - 8) {
           const childSize = buffer.readUInt32BE(moovOffset)
-          if (childSize < 8 || moovOffset + childSize > moovEnd) {
-            return fail('invalid child atom size')
-          }
+          if (childSize < 8 || moovOffset + childSize > moovEnd) return fail('invalid child atom size')
           const childType = buffer.toString('ascii', moovOffset + 4, moovOffset + 8)
           if (childType === 'mvhd') {
             const version = buffer.readUInt8(moovOffset + 8)
@@ -87,8 +74,6 @@ export function getMp4Duration(buffer, opts = {}) {
   }
 }
 
-
- *
 export async function extractThumbnail(videoBuffer, opts = {}) {
   const {
     time,
@@ -105,10 +90,14 @@ export async function extractThumbnail(videoBuffer, opts = {}) {
   return new Promise((resolve, reject) => {
     const fail = (err) => {
       if (silent) return resolve(result === 'base64' ? '' : Buffer.alloc(0))
-      reject(err instanceof MediaError ? err : new MediaError(err?.message ?? String(err), {
-        code: 'LUMINA_MEDIA_FFMPEG_FAILED',
-        cause: err,
-      }))
+      reject(
+        err instanceof MediaError
+          ? err
+          : new MediaError(err?.message ?? String(err), {
+              code: 'LUMINA_MEDIA_FFMPEG_FAILED',
+              cause: err,
+            }),
+      )
     }
 
     if (!Buffer.isBuffer(videoBuffer) || videoBuffer.length === 0) {
@@ -130,9 +119,7 @@ export async function extractThumbnail(videoBuffer, opts = {}) {
         if (frame.length === 0) {
           return fail(new MediaError('ffmpeg produced empty output', { code: 'LUMINA_MEDIA_FFMPEG_EMPTY' }))
         }
-        if (resizeOutput) {
-          frame = await resize(frame, { width, height, fit: 'cover', format })
-        }
+        if (resizeOutput) frame = await resize(frame, { width, height, fit: 'cover', format })
         resolve(result === 'base64' ? frame.toString('base64') : frame)
       } catch (err) {
         fail(err)
@@ -143,10 +130,12 @@ export async function extractThumbnail(videoBuffer, opts = {}) {
     try {
       ffmpeg(input)
         .outputOptions([`-ss ${seekTime}`, '-vframes 1', '-vcodec png', '-f image2pipe'])
-        .on('error', (err) => fail(new MediaError(`ffmpeg error: ${err.message}`, {
-          code: 'LUMINA_MEDIA_FFMPEG_FAILED',
-          cause: err,
-        })))
+        .on('error', (err) =>
+          fail(new MediaError(`ffmpeg error: ${err.message}`, {
+            code: 'LUMINA_MEDIA_FFMPEG_FAILED',
+            cause: err,
+          })),
+        )
         .pipe(output, { end: true })
     } catch (err) {
       fail(err)

package/src/parsers/code-tokenizer-keywords.js

@@ -1,5 +1,3 @@
- *
- *
 
 export const KEYWORDS = {
   javascript: new Set([

package/src/parsers/code-tokenizer.js

@@ -1,6 +1,3 @@
- *
- *
- *
 
 import { HighlightType, HighlightLabel } from '../proto/enums.js'
 import { KEYWORDS, SLASH_COMMENT_LANGS, HASH_COMMENT_LANGS, BLOCK_COMMENT_LANGS } from './code-tokenizer-keywords.js'
@@ -17,7 +14,6 @@ function identifierChar(lang) {
   }
 }
 
- *
 export function tokenizeCode(code, lang = 'javascript') {
   if (typeof code !== 'string' || code.length === 0) {
     return { codeBlock: [], unifiedBlocks: [] }

package/src/proto/updater.js

@@ -1,7 +1,3 @@
- *
- *
- *
- *
 
 import { promises as fs } from 'node:fs'
 import path from 'node:path'
@@ -47,7 +43,6 @@ const RE_CONST_REQUIRE =
 const RE_DESTRUCT_REQUIRE =
   /(?:const|let|var)\s*\{([^}]+)\}\s*=\s*require\(\s*(['"])([^'"]+)\2\s*\)/g
 
- *
 export function transformToESM(src) {
   let out = src
   out = out.replace(RE_CONST_REQUIRE, (_, name, _q, mod) => `import ${name} from '${mod}'`)
@@ -67,7 +62,6 @@ export function transformToESM(src) {
   return out
 }
 
- *
 export function applyKnownFixes(filename, content) {
   const applied = []
   let next = content
@@ -100,7 +94,6 @@ export class ProtoUpdater {
     }
   }
 
-   *
   async #listJsFiles(dir) {
     const entries = await fs.readdir(dir, { withFileTypes: true })
     const out = []
@@ -112,7 +105,6 @@ export class ProtoUpdater {
     return out
   }
 
-   *
   async backup() {
     await fs.mkdir(this.backupDir, { recursive: true })
     const timestamp = Date.now()
@@ -127,7 +119,6 @@ export class ProtoUpdater {
     return record
   }
 
-   *
   async #hashTree(dir) {
     const files = (await this.#listJsFiles(dir)).sort()
     const hashes = await Promise.all(
@@ -139,7 +130,6 @@ export class ProtoUpdater {
     return sha256(hashes.join('\n'))
   }
 
-   *
   async restore(id) {
     const record = this.history.find((h) => h.id === id)
     if (!record) {
@@ -160,7 +150,6 @@ export class ProtoUpdater {
     await this.restore(last.id)
   }
 
-   *
   async validate() {
     const files = await this.#listJsFiles(this.protoPath)
     const errors = []
@@ -176,7 +165,6 @@ export class ProtoUpdater {
     return { ok: errors.length === 0, errors }
   }
 
-   *
   async update(opts = {}) {
     const autoRollback = opts.autoRollback ?? true
     const dryRun = opts.dryRun ?? false