Docs: Script para scrapear documentacion de Baileys API

- Script en scripts/scrape-baileys-docs.ts
- Genera docs/baileys-api-reference.md con 6433 lineas
- 79 secciones: interfaces, types, functions, variables, enums
- Referencia completa para desarrollo de mensajes

server/api/debug/chat/modify.post.ts

@@ -0,0 +1,76 @@
+/**
+ * POST /api/debug/chat/modify
+ * Modify chat state (archive, mute, mark read, pin)
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+type ModificationType = 'archive' | 'mute' | 'markRead' | 'pin'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, jid, type, value, lastMessages } = body as {
+    instanceId: string
+    jid: string
+    type: ModificationType
+    value: boolean | number | null
+    lastMessages?: any[]
+  }
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!jid) {
+    throw createError({ statusCode: 400, message: 'jid is required' })
+  }
+
+  const validTypes: ModificationType[] = ['archive', 'mute', 'markRead', 'pin']
+  if (!type || !validTypes.includes(type)) {
+    throw createError({
+      statusCode: 400,
+      message: `type must be one of: ${validTypes.join(', ')}`
+    })
+  }
+
+  if (value === undefined) {
+    throw createError({ statusCode: 400, message: 'value is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    let modification: any
+
+    switch (type) {
+      case 'archive':
+        modification = { archive: value, lastMessages: lastMessages || [] }
+        break
+      case 'mute':
+        // value should be timestamp for mute duration, null to unmute
+        modification = { mute: value }
+        break
+      case 'markRead':
+        modification = { markRead: value, lastMessages: lastMessages || [] }
+        break
+      case 'pin':
+        modification = { pin: value }
+        break
+    }
+
+    await socket.chatModify(modification, jid)
+    return { success: true, message: `Chat ${type} modified successfully` }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to modify chat: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/groups/create.post.ts

@@ -0,0 +1,42 @@
+/**
+ * POST /api/debug/groups/create
+ * Create a new group
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, name, participants } = body
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!name) {
+    throw createError({ statusCode: 400, message: 'name is required' })
+  }
+
+  if (!participants || !Array.isArray(participants) || participants.length === 0) {
+    throw createError({ statusCode: 400, message: 'participants array is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    const result = await socket.groupCreate(name, participants)
+    return { success: true, data: result }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to create group: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/groups/description.post.ts

@@ -0,0 +1,42 @@
+/**
+ * POST /api/debug/groups/description
+ * Update group description
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, jid, description } = body
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!jid) {
+    throw createError({ statusCode: 400, message: 'jid is required' })
+  }
+
+  if (description === undefined) {
+    throw createError({ statusCode: 400, message: 'description is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    await socket.groupUpdateDescription(jid, description)
+    return { success: true, message: 'Group description updated successfully' }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to update group description: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/groups/invite-code.post.ts

@@ -0,0 +1,44 @@
+/**
+ * POST /api/debug/groups/invite-code
+ * Get group invite code
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, jid } = body
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!jid) {
+    throw createError({ statusCode: 400, message: 'jid is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    const code = await socket.groupInviteCode(jid)
+    return {
+      success: true,
+      data: {
+        code,
+        link: `https://chat.whatsapp.com/${code}`
+      }
+    }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to get invite code: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/groups/metadata.post.ts

@@ -0,0 +1,38 @@
+/**
+ * POST /api/debug/groups/metadata
+ * Get group metadata
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, jid } = body
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!jid) {
+    throw createError({ statusCode: 400, message: 'jid is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    const result = await socket.groupMetadata(jid)
+    return { success: true, data: result }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to get group metadata: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/groups/participants.post.ts

@@ -0,0 +1,57 @@
+/**
+ * POST /api/debug/groups/participants
+ * Update group participants (add, remove, promote, demote)
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+type ParticipantAction = 'add' | 'remove' | 'promote' | 'demote'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, jid, participants, action } = body as {
+    instanceId: string
+    jid: string
+    participants: string[]
+    action: ParticipantAction
+  }
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!jid) {
+    throw createError({ statusCode: 400, message: 'jid is required' })
+  }
+
+  if (!participants || !Array.isArray(participants) || participants.length === 0) {
+    throw createError({ statusCode: 400, message: 'participants array is required' })
+  }
+
+  const validActions: ParticipantAction[] = ['add', 'remove', 'promote', 'demote']
+  if (!action || !validActions.includes(action)) {
+    throw createError({
+      statusCode: 400,
+      message: `action must be one of: ${validActions.join(', ')}`
+    })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    const result = await socket.groupParticipantsUpdate(jid, participants, action)
+    return { success: true, data: result }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to update participants: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/groups/subject.post.ts

@@ -0,0 +1,42 @@
+/**
+ * POST /api/debug/groups/subject
+ * Update group subject (name)
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, jid, subject } = body
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!jid) {
+    throw createError({ statusCode: 400, message: 'jid is required' })
+  }
+
+  if (!subject) {
+    throw createError({ statusCode: 400, message: 'subject is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    await socket.groupUpdateSubject(jid, subject)
+    return { success: true, message: 'Group subject updated successfully' }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to update group subject: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/history/fetch.post.ts

@@ -0,0 +1,41 @@
+/**
+ * POST /api/debug/history/fetch
+ * Request message history on-demand
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, count, oldestMsgKey, oldestMsgTimestamp } = body
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!count || typeof count !== 'number') {
+    throw createError({ statusCode: 400, message: 'count (number) is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    await socket.fetchMessageHistory(count, oldestMsgKey, oldestMsgTimestamp)
+    return {
+      success: true,
+      message: `Requested ${count} messages from history. Check messaging-history.set event for results.`
+    }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to fetch message history: ${(error as Error).message}`
+    })
+  }
+})

server/api/debug/media/update.post.ts

@@ -0,0 +1,38 @@
+/**
+ * POST /api/debug/media/update
+ * Update expired media message
+ */
+import { baileysManager } from '../../../services/baileys/manager'
+
+export default defineEventHandler(async (event) => {
+  const username = getHeader(event, 'x-authentik-username')
+  if (!username) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
+
+  const body = await readBody(event)
+  const { instanceId, message } = body
+
+  if (!instanceId) {
+    throw createError({ statusCode: 400, message: 'instanceId is required' })
+  }
+
+  if (!message) {
+    throw createError({ statusCode: 400, message: 'message (proto.IWebMessageInfo) is required' })
+  }
+
+  const socket = baileysManager.getSocket(instanceId)
+  if (!socket) {
+    throw createError({ statusCode: 400, message: 'Instance not connected' })
+  }
+
+  try {
+    const result = await socket.updateMediaMessage(message)
+    return { success: true, data: result }
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      message: `Failed to update media message: ${(error as Error).message}`
+    })
+  }
+})