@kyyinfinite/lumina 1.0.0

package/examples/ai-rich.js

@@ -0,0 +1,84 @@
+/**
+ * ai-rich.js — AI Rich Response showcase.
+ *
+ * Demonstrates every primitive AIRichBuilder supports:
+ *   text (with inline entities) → code → image → table →
+ *   tip → suggest → source → product → post
+ *
+ * Each method is awaited (eager async) and chainable.
+ */
+
+import makeWASocket from '@whiskeysockets/baileys'
+import { useMultiFileAuthState } from '@whiskeysockets/baileys'
+import { Bot } from '../src/index.js'
+
+async function main() {
+  const { state, saveCreds } = await useMultiFileAuthState('./.auth')
+  const socket = makeWASocket.default({ auth: state, printQRInTerminal: true })
+  const bot = new Bot(socket)
+  socket.ev.on('creds.update', saveCreds)
+
+  await new Promise((resolve) => {
+    socket.ev.on('connection.update', (u) => u.connection === 'open' && resolve())
+  })
+
+  const jid = '62812xxxxxxx@s.whatsapp.net'
+
+  // ─── Full demo ─────────────────────────────────────────────────────
+  await bot.ai()
+    .title('Lumina AI Assistant')
+    .footer('Generated by Lumina v1.0.0')
+    .text(
+      [
+        'Halo! Saya adalah AI assistant yang dibangun di atas **Lumina**.',
+        'Coba kunjungi [dokumentasi](https://github.com/kyyinfinite/lumina) untuk info lebih lanjut.',
+        'Atau lihat referensi [API](https://github.com/kyyinfinite/lumina#api-reference).',
+      ].join('\n'),
+    )
+    .code('javascript', [
+      'import { Bot } from "@kyyinfinite/lumina"',
+      'const bot = new Bot(socket)',
+      'await bot.text(jid, "Hello!")',
+    ].join('\n'))
+    .image('https://picsum.photos/600/300')
+    .table([
+      ['Fitur', 'Status', 'Catatan'],
+      ['Text', '✓', 'Basic'],
+      ['Image', '✓', 'Auto upload'],
+      ['Video', '✓', 'Auto thumbnail'],
+      ['AI Rich', '✓', '11 primitives'],
+    ])
+    .tip('Tip: gunakan fluent API untuk chaining yang bersih.')
+    .suggest(['Lanjutkan', 'Ulangi', 'Info produk'])
+    .source([
+      ['https://favicon.io/favicon.png', 'https://github.com', 'GitHub'],
+      ['https://favicon.io/favicon.png', 'https://nodejs.org', 'Node.js'],
+    ])
+    .send(jid)
+
+  // ─── Product carousel ──────────────────────────────────────────────
+  await bot.ai()
+    .title('Rekomendasi Produk')
+    .product([
+      {
+        title: 'Sepatu Lumina',
+        brand: 'Lumina',
+        price: 'Rp 250.000',
+        sale_price: 'Rp 199.000',
+        url: 'https://example.com/1',
+        image_url: 'https://picsum.photos/id/21/400/400',
+        icon_url: 'https://picsum.photos/id/21/64/64',
+      },
+      {
+        title: 'Tas Lumina',
+        brand: 'Lumina',
+        price: 'Rp 350.000',
+        url: 'https://example.com/2',
+        image_url: 'https://picsum.photos/id/22/400/400',
+        icon_url: 'https://picsum.photos/id/22/64/64',
+      },
+    ])
+    .send(jid)
+}
+
+main()

package/examples/button.js

@@ -0,0 +1,57 @@
+/**
+ * button.js — native-flow button builder.
+ *
+ * Demonstrates:
+ *   - ButtonBuilder fluent API (title/body/footer)
+ *   - reply buttons (quick_reply)
+ *   - URL button (cta_url)
+ *   - Copy-to-clipboard button (cta_copy)
+ *   - Callback-based selection (single_select with sections + rows)
+ *   - Image header
+ */
+
+import makeWASocket from '@whiskeysockets/baileys'
+import { useMultiFileAuthState } from '@whiskeysockets/baileys'
+import { Bot } from '../src/index.js'
+
+async function main() {
+  const { state, saveCreds } = await useMultiFileAuthState('./.auth')
+  const socket = makeWASocket.default({ auth: state, printQRInTerminal: true })
+  const bot = new Bot(socket)
+  socket.ev.on('creds.update', saveCreds)
+
+  // Wait for connection.
+  await new Promise((resolve) => {
+    socket.ev.on('connection.update', (u) => u.connection === 'open' && resolve())
+  })
+
+  const jid = '62812xxxxxxx@s.whatsapp.net'
+
+  // ─── Simple reply + URL + copy ─────────────────────────────────────
+  await bot.button()
+    .title('Lumina Demo')
+    .body('Pilih salah satu menu di bawah ini.')
+    .footer('Powered by Lumina')
+    .image('https://picsum.photos/600/300')
+    .reply('Menu Utama', 'cmd_menu')
+    .reply('Owner', 'cmd_owner')
+    .url('Website', 'https://github.com/kyyinfinite/lumina')
+    .copy('Salin Token', 'LUMINA-TOKEN-1234')
+    .send(jid)
+
+  // ─── Callback-based selection ──────────────────────────────────────
+  await bot.button()
+    .title('Daftar Produk')
+    .body('Pilih kategori dan produk.')
+    .selection('Kategori', (sel) =>
+      sel
+        .section('Makanan', (s) => s
+          .row('Nasi Goreng', 'Nasi Goreng Special', 'Rp 25.000', 'food_nasgor')
+          .row('Mie Ayam', 'Mie Ayam Bakso', 'Rp 20.000', 'food_mieayam'))
+        .section('Minuman', (s) => s
+          .row('Es Teh', 'Es Teh Manis', 'Rp 5.000', 'drink_esteh')
+          .row('Kopi', 'Kopi Hitam', 'Rp 8.000', 'drink_kopi')))
+    .send(jid)
+}
+
+main()

package/examples/carousel.js

@@ -0,0 +1,51 @@
+/**
+ * carousel.js — multi-card carousel builder.
+ *
+ * Demonstrates:
+ *   - CarouselBuilder + CardBuilder composition
+ *   - Media headers (image)
+ *   - Reply buttons per card
+ *   - Sending to a JID
+ */
+
+import makeWASocket from '@whiskeysockets/baileys'
+import { useMultiFileAuthState } from '@whiskeysockets/baileys'
+import { Bot } from '../src/index.js'
+
+async function main() {
+  const { state, saveCreds } = await useMultiFileAuthState('./.auth')
+  const socket = makeWASocket.default({ auth: state, printQRInTerminal: true })
+  const bot = new Bot(socket)
+  socket.ev.on('creds.update', saveCreds)
+
+  await new Promise((resolve) => {
+    socket.ev.on('connection.update', (u) => u.connection === 'open' && resolve())
+  })
+
+  const jid = '62812xxxxxxx@s.whatsapp.net'
+
+  const carousel = bot.carousel().body('Pilih produk favoritmu:')
+
+  // Build each card separately.
+  const products = [
+    { name: 'Sepatu A', price: 'Rp 250.000', image: 'https://picsum.photos/id/21/600/400', cmd: 'buy_sepatu_a' },
+    { name: 'Sepatu B', price: 'Rp 350.000', image: 'https://picsum.photos/id/22/600/400', cmd: 'buy_sepatu_b' },
+    { name: 'Sepatu C', price: 'Rp 450.000', image: 'https://picsum.photos/id/23/600/400', cmd: 'buy_sepatu_c' },
+  ]
+
+  for (const p of products) {
+    const card = await carousel
+      .newCard()
+      .title(p.name)
+      .body(p.price)
+      .footer('Klik beli untuk memesan')
+      .image(p.image)
+      .reply('Beli', p.cmd)
+      .build()
+    carousel.card(card)
+  }
+
+  await carousel.send(jid)
+}
+
+main()

package/examples/interactive.js

@@ -0,0 +1,102 @@
+/**
+ * interactive.js — combined showcase of every interactive primitive.
+ *
+ * Demonstrates:
+ *   - ButtonBuilder with image header + selection
+ *   - ButtonV2Builder (legacy) with thumbnail fallback
+ *   - CarouselBuilder with multiple cards
+ *   - AIRichBuilder with text + code + table + image + suggest
+ *   - Reply / react / edit / delete on incoming messages
+ */
+
+import makeWASocket from '@whiskeysockets/baileys'
+import { useMultiFileAuthState } from '@whiskeysockets/baileys'
+import { Bot } from '../src/index.js'
+
+async function main() {
+  const { state, saveCreds } = await useMultiFileAuthState('./.auth')
+  const socket = makeWASocket.default({ auth: state, printQRInTerminal: true })
+  const bot = new Bot(socket)
+  socket.ev.on('creds.update', saveCreds)
+
+  await new Promise((resolve) => {
+    socket.ev.on('connection.update', (u) => u.connection === 'open' && resolve())
+  })
+
+  const jid = '62812xxxxxxx@s.whatsapp.net'
+
+  // ─── 1. Native-flow button with selection ──────────────────────────
+  await bot.button()
+    .title('Interactive Demo')
+    .body('Coba berbagai jenis button di bawah ini.')
+    .footer('Lumina v1.0.0')
+    .reply('Quick Reply', 'qr_1')
+    .url('Buka Browser', 'https://github.com/kyyinfinite/lumina')
+    .copy('Salin Kode', 'LUMINA-2025')
+    .call('Telepon CS', '62812xxxxxxx')
+    .selection('Pilih Menu', (sel) =>
+      sel
+        .section('Utama', (s) => s
+          .row('A', 'Menu A', 'Deskripsi A', 'menu_a')
+          .row('B', 'Menu B', 'Deskripsi B', 'menu_b'))
+        .section('Tambahan', (s) => s
+          .row('C', 'Menu C', 'Deskripsi C', 'menu_c')))
+    .send(jid)
+
+  // ─── 2. Legacy ButtonsMessage (ButtonV2) ───────────────────────────
+  await bot.buttonV2()
+    .title('Legacy Button')
+    .body('ButtonV2 untuk WhatsApp client lama.')
+    .footer('Powered by Lumina')
+    .thumbnail('https://picsum.photos/300')
+    .button('OK', 'btn_ok')
+    .button('Cancel', 'btn_cancel')
+    .send(jid)
+
+  // ─── 3. Carousel of products ──────────────────────────────────────
+  const car = bot.carousel().body('Pilih produk:')
+  for (const id of [10, 20, 30]) {
+    const card = await car
+      .newCard()
+      .title(`Produk ${id}`)
+      .body(`Harga Rp ${id}.000`)
+      .image(`https://picsum.photos/id/${id}/400/300`)
+      .reply('Beli', `buy_${id}`)
+      .build()
+    car.card(card)
+  }
+  await car.send(jid)
+
+  // ─── 4. AI Rich Response ──────────────────────────────────────────
+  await bot.ai()
+    .title('AI Demo')
+    .text('Ini **AI Rich Response** dengan [link](https://lumina.dev) inline.')
+    .code('javascript', 'console.log("Hello from Lumina!")')
+    .table([['A', 'B'], ['1', '2'], ['3', '4']])
+    .image('https://picsum.photos/600/300')
+    .suggest(['Lanjut', 'Stop'])
+    .send(jid)
+
+  // ─── 5. React + edit + delete on incoming ──────────────────────────
+  bot.on('messages.upsert', async ({ messages }) => {
+    const m = messages[0]
+    if (!m?.message || m.key.fromMe) return
+
+    // React with thumbs-up.
+    await bot.react(m.key.remoteJid, m.key, '👍')
+
+    // Reply with text.
+    const sent = await bot.text(m.key.remoteJid, 'Got your message!')
+
+    // After 2s, edit it.
+    setTimeout(async () => {
+      try {
+        await bot.edit(m.key.remoteJid, sent.key, '(edited) message received ✅')
+      } catch (e) {
+        console.error('edit failed:', e.message)
+      }
+    }, 2000)
+  })
+}
+
+main()

package/examples/media.js

@@ -0,0 +1,66 @@
+/**
+ * media.js — MediaService showcase.
+ *
+ * Demonstrates:
+ *   - bot.media.fetch(url)
+ *   - bot.media.resize(buf, opts)
+ *   - bot.media.thumbnail(buf)
+ *   - bot.media.duration(buf)
+ *   - bot.media.videoThumbnail(buf)
+ *   - bot.media.upload(buf, type)
+ *   - bot.media.sniff(buf)
+ *   - bot.media.resolve(source, opts)
+ */
+
+import makeWASocket from '@whiskeysockets/baileys'
+import { useMultiFileAuthState } from '@whiskeysockets/baileys'
+import { Bot } from '../src/index.js'
+import { writeFileSync } from 'node:fs'
+
+async function main() {
+  const { state, saveCreds } = await useMultiFileAuthState('./.auth')
+  const socket = makeWASocket.default({ auth: state, printQRInTerminal: true })
+  const bot = new Bot(socket)
+  socket.ev.on('creds.update', saveCreds)
+
+  await new Promise((resolve) => {
+    socket.ev.on('connection.update', (u) => u.connection === 'open' && resolve())
+  })
+
+  // ─── Fetch + resize ────────────────────────────────────────────────
+  const imageUrl = 'https://picsum.photos/1200/800'
+  const imageBuf = await bot.media.fetch(imageUrl)
+  console.log('fetched image bytes:', imageBuf.length)
+
+  const thumb = await bot.media.resize(imageBuf, {
+    width: 200,
+    height: 200,
+    fit: 'cover',
+    format: 'jpeg',
+  })
+  writeFileSync('./download/thumb.jpg', thumb)
+  console.log('thumbnail saved to ./download/thumb.jpg')
+
+  // ─── Sniff MIME ────────────────────────────────────────────────────
+  const mime = bot.media.sniff(imageBuf, 'photo.jpg')
+  console.log('sniffed MIME:', mime, '→ category:', bot.media.category(mime))
+
+  // ─── Upload to WhatsApp ────────────────────────────────────────────
+  const cdnUrl = await bot.media.upload(imageBuf, 'image')
+  console.log('uploaded to WA CDN:', cdnUrl)
+
+  // ─── Resolve (URL → URL passthrough, since wa.me) ──────────────────
+  // For non-wa.me URLs, resolve() will fetch + upload automatically.
+  const resolved = await bot.media.resolve('https://picsum.photos/100', {
+    mediaType: 'image',
+    strategy: 'auto',
+  })
+  console.log('resolved:', resolved)
+
+  // ─── Video duration + thumbnail ────────────────────────────────────
+  // const videoBuf = await bot.media.fetch('https://example.com/clip.mp4')
+  // const dur = bot.media.duration(videoBuf)
+  // const frame = await bot.media.videoThumbnail(videoBuf, { time: 0, result: 'base64' })
+}
+
+main()

package/examples/simple-bot.js

@@ -0,0 +1,56 @@
+/**
+ * simple-bot.js — minimal Lumina bot.
+ *
+ * Demonstrates: text(), reply(), and the events bus.
+ *
+ * Run: node examples/simple-bot.js
+ */
+
+import makeWASocket from '@whiskeysockets/baileys'
+import { useMultiFileAuthState, DisconnectReason } from '@whiskeysockets/baileys'
+import { Bot } from '../src/index.js'
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('./.auth')
+
+  const socket = makeWASocket.default({
+    auth: state,
+    printQRInTerminal: true,
+  })
+
+  const bot = new Bot(socket, {
+    uploadJid: '62831@s.whatsapp.net',
+  })
+
+  socket.ev.on('creds.update', saveCreds)
+
+  socket.ev.on('connection.update', (update) => {
+    const { connection, lastDisconnect } = update
+    if (connection === 'close') {
+      const shouldReconnect =
+        lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut
+      if (shouldReconnect) start()
+    } else if (connection === 'open') {
+      console.log('[lumina] connection opened')
+    }
+  })
+
+  bot.on('messages.upsert', async ({ messages }) => {
+    const m = messages[0]
+    if (!m?.message || m.key.fromMe) return
+
+    const jid = m.key.remoteJid
+    const text =
+      m.message.conversation ??
+      m.message.extendedTextMessage?.text ??
+      ''
+
+    if (text.toLowerCase() === 'ping') {
+      await bot.text(jid, 'pong 🏓')
+    } else if (text.toLowerCase() === 'hello') {
+      await bot.reply(jid, 'Hi there!', m)
+    }
+  })
+}
+
+start()

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@kyyinfinite/lumina",
+  "version": "1.0.0",
+  "description": "Lumina — Modern WhatsApp framework built on top of Baileys. Hide the protocol complexity, expose a fluent API.",
+  "type": "module",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./parsers": {
+      "types": "./src/parsers/index.d.ts",
+      "import": "./src/parsers/index.js"
+    },
+    "./media": {
+      "types": "./src/media/index.d.ts",
+      "import": "./src/media/index.js"
+    },
+    "./proto": {
+      "types": "./src/proto/index.d.ts",
+      "import": "./src/proto/index.js"
+    },
+    "./services": {
+      "types": "./src/services/index.d.ts",
+      "import": "./src/services/index.js"
+    },
+    "./builders": {
+      "types": "./src/builders/index.d.ts",
+      "import": "./src/builders/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "echo 'no tests yet' && exit 0"
+  },
+  "keywords": [
+    "whatsapp",
+    "baileys",
+    "framework",
+    "bot",
+    "whatsapp-bot",
+    "lumina",
+    "native-flow",
+    "interactive-message",
+    "ai-rich",
+    "carousel"
+  ],
+  "author": "KyyInfinite <kyyinfinite@github.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kyyinfinite/lumina.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kyyinfinite/lumina/issues"
+  },
+  "homepage": "https://github.com/kyyinfinite/lumina#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@whiskeysockets/baileys": "^6.7.0"
+  },
+  "peerDependenciesMeta": {
+    "@whiskeysockets/baileys": {
+      "optional": false
+    },
+    "sharp": {
+      "optional": true
+    },
+    "fluent-ffmpeg": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "sharp": "^0.33.0",
+    "fluent-ffmpeg": "^2.1.0"
+  }
+}