@kyyinfinite/lumina 1.0.0

package/src/errors.js

@@ -0,0 +1,88 @@
+/**
+ * @file errors.js
+ * @module lumina/errors
+ *
+ * Error hierarchy for Lumina. Every Lumina-thrown error subclasses
+ * {@link LuminaError} and carries a stable `code`, the originating `module`,
+ * and (optionally) a `cause` field that follows the ES2022 Error.cause convention.
+ *
+ * Hierarchy:
+ *   LuminaError
+ *   ├── ValidationError       (bad input — subclass of TypeError)
+ *   ├── MediaError            (fetch / resize / upload / ffmpeg failure)
+ *   ├── ProtoError            (assemble / generate / relay failure)
+ *   ├── ConnectionError       (Baileys socket missing or incompatible)
+ *   └── ProtocolError         (WAProto mismatch — emitted by ProtoUpdater)
+ */
+
+/**
+ * Base class for every error thrown by Lumina.
+ *
+ * @example
+ *   if (err instanceof LuminaError) {
+ *     console.error(err.code, err.module, err.message)
+ *   }
+ */
+export class LuminaError extends Error {
+  /**
+   * @param {string} message    Human-readable message.
+   * @param {object} [opts]
+   * @param {string} [opts.code='LUMINA_ERROR']  Stable machine code.
+   * @param {string} [opts.module='lumina']      Logical module that threw.
+   * @param {Error}  [opts.cause]                Original error (ES2022).
+   */
+  constructor(message, opts = {}) {
+    super(message, { cause: opts.cause })
+    this.name = new.target.name
+    this.code = opts.code ?? 'LUMINA_ERROR'
+    this.module = opts.module ?? 'lumina'
+  }
+}
+
+/** Thrown when an argument fails validation. Subclass of TypeError for compat. */
+export class ValidationError extends TypeError {
+  constructor(message, opts = {}) {
+    super(message, { cause: opts.cause })
+    this.name = 'ValidationError'
+    this.code = opts.code ?? 'LUMINA_VALIDATION'
+    this.module = opts.module ?? 'lumina'
+  }
+}
+
+/** Thrown when a media operation (fetch/resize/upload/ffmpeg) fails. */
+export class MediaError extends LuminaError {
+  constructor(message, opts = {}) {
+    super(message, opts)
+    this.code = opts.code ?? 'LUMINA_MEDIA'
+    this.module = opts.module ?? 'media'
+  }
+}
+
+/** Thrown when a proto assembly / message generation / relay fails. */
+export class ProtoError extends LuminaError {
+  constructor(message, opts = {}) {
+    super(message, opts)
+    this.code = opts.code ?? 'LUMINA_PROTO'
+    this.module = opts.module ?? 'proto'
+  }
+}
+
+/** Thrown when the Baileys socket is missing or its API is incompatible. */
+export class ConnectionError extends LuminaError {
+  constructor(message, opts = {}) {
+    super(message, opts)
+    this.code = opts.code ?? 'LUMINA_CONNECTION'
+    this.module = opts.module ?? 'connection'
+  }
+}
+
+/** Thrown by {@link ProtoUpdater} when WAProto validation fails. */
+export class ProtocolError extends LuminaError {
+  constructor(message, opts = {}) {
+    super(message, opts)
+    this.code = opts.code ?? 'LUMINA_PROTOCOL'
+    this.module = opts.module ?? 'proto-updater'
+  }
+}
+
+export default LuminaError

package/src/index.d.ts

@@ -0,0 +1,458 @@
+/**
+ * @file index.d.ts
+ * @module @kyyinfinite/lumina
+ *
+ * Manual TypeScript declaration for Lumina. Every builder, service, parser,
+ * and error is fully typed. Generated `.d.ts` files were rejected to keep
+ * the public surface auditable and to expose rich per-method overloads
+ * that auto-generation would lose.
+ */
+
+// ─── External dependencies ─────────────────────────────────────────────
+
+declare module '@whiskeysockets/baileys' {
+  export interface WASocket {
+    relayMessage(jid: string, message: any, opts?: any): Promise<void>
+    generateMessageTag(): string
+    waUploadToServer: any
+    ev: {
+      on(event: string, handler: (...args: any[]) => void): void
+      off(event: string, handler: (...args: any[]) => void): void
+      emit(event: string, ...args: any[]): void
+    }
+    sendMessage(jid: string, content: any, opts?: any): Promise<any>
+    forwardMessage(jid: string, message: any, opts?: any): Promise<any>
+    [k: string]: any
+  }
+  export function generateWAMessageFromContent(jid: string, content: any, opts?: any): any
+  export function prepareWAMessageMedia(media: any, opts?: any): Promise<any>
+  export function generatePollMessage(jid: string, opts: any): any
+  export function generateReactionMessage(jid: string, opts: any): any
+}
+
+// ─── Errors ────────────────────────────────────────────────────────────
+
+export class LuminaError extends Error {
+  readonly code: string
+  readonly module: string
+  constructor(message: string, opts?: { code?: string; module?: string; cause?: Error })
+}
+export class ValidationError extends TypeError {
+  readonly code: string
+  readonly module: string
+  constructor(message: string, opts?: { code?: string; module?: string; cause?: Error })
+}
+export class MediaError extends LuminaError {}
+export class ProtoError extends LuminaError {}
+export class ConnectionError extends LuminaError {}
+export class ProtocolError extends LuminaError {}
+
+// ─── Logger ────────────────────────────────────────────────────────────
+
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug'
+
+export interface Logger {
+  error(...args: any[]): void
+  warn(...args: any[]): void
+  info(...args: any[]): void
+  debug(...args: any[]): void
+  child(scope: string): Logger
+}
+
+export function createLogger(opts?: {
+  level?: LogLevel
+  silent?: boolean
+  scope?: string
+  transport?: (level: string, scope: string, args: any[]) => void
+}): Logger
+
+// ─── Enums & catalog ───────────────────────────────────────────────────
+
+export const MessageType: Readonly<{
+  RICH_RESPONSE: 1
+  TEXT: 2
+  TABLE: 4
+  CODE: 5
+  REELS: 9
+}>
+
+export const ForwardOrigin: Readonly<{ BOT: 4 }>
+export const HeaderType: Readonly<{
+  EMPTY: 0
+  TEXT: 1
+  IMAGE: 3
+  VIDEO: 4
+  DOCUMENT: 5
+  LOCATION_THUMBNAIL: 6
+}>
+
+export const NativeFlow: Readonly<{
+  OUTER_VERSION: '1'
+  FLOW_VERSION: '9'
+  FLOW_NAME_MIXED: 'mixed'
+  TYPE: 'native_flow'
+  BIZ_TAG: 'biz'
+  INTERACTIVE_TAG: 'interactive'
+}>
+
+export const BOT_JID: '0@bot'
+
+export const LayoutKind: Readonly<{
+  SINGLE: 'Single'
+  HSCROLL: 'HScroll'
+  ACTION_ROW: 'ActionRow'
+}>
+
+export const HighlightType: Readonly<{
+  DEFAULT: 0
+  KEYWORD: 1
+  METHOD: 2
+  STRING: 3
+  NUMBER: 4
+  COMMENT: 5
+}>
+
+export const ImagineType: Readonly<{ IMAGE: 'IMAGE'; ANIMATE: 'ANIMATE' }>
+
+export const TYPENAME: Readonly<{
+  MARKDOWN_TEXT: 'GenAIMarkdownTextUXPrimitive'
+  CODE: 'GenAICodeUXPrimitive'
+  TABLE: 'GenAITableUXPrimitive'
+  SEARCH_RESULT: 'GenAISearchResultPrimitive'
+  REEL: 'GenAIReelPrimitive'
+  IMAGINE: 'GenAIImaginePrimitive'
+  PRODUCT_CARD: 'GenAIProductItemCardPrimitive'
+  POST: 'GenAIPostPrimitive'
+  METADATA_TEXT: 'GenAIMetadataTextPrimitive'
+  FOLLOW_UP_PILL: 'GenAIFollowUpSuggestionPillPrimitive'
+  UNIFIED_SECTION: 'GenAIUnifiedResponseSection'
+  layout(kind: string): string
+}>
+
+// ─── Parsers ───────────────────────────────────────────────────────────
+
+export interface ExtractOptions {
+  extract?: boolean
+  hyperlink?: boolean
+  citation?: boolean
+  latex?: boolean
+  prefix?: string
+}
+
+export interface ExtractResult {
+  text: string
+  entities: Array<{ type: 'hyperlink' | 'citation' | 'latex'; key: string; [k: string]: any }>
+  metadata: Array<{ key: string; metadata: any }>
+}
+
+export function extractInlineEntities(text: string, opts?: ExtractOptions): ExtractResult
+
+export interface TokenizedCode {
+  codeBlock: Array<{ codeContent: string; highlightType: number }>
+  unifiedBlocks: Array<{ content: string; type: string }>
+}
+
+export function tokenizeCode(code: string, lang?: string): TokenizedCode
+
+export interface TableMetadata {
+  title: string
+  rows: Array<{ items: string[]; isHeading?: boolean }>
+  unifiedRows: Array<{ is_header: boolean; cells: string[]; markdown_cells?: Array<{ text: string; inline_entities?: any[] }> }>
+}
+
+export function toTableMetadata(
+  table: string[][],
+  opts?: { title?: string; hyperlink?: boolean; citation?: boolean; latex?: boolean },
+): TableMetadata
+
+// ─── Connection ────────────────────────────────────────────────────────
+
+export interface ConnectionOptions {
+  uploadJid?: string
+  logger?: Logger
+}
+
+export class Connection {
+  constructor(socket: import('@whiskeysockets/baileys').WASocket, opts?: ConnectionOptions)
+  uploadJid?: string
+  logger?: Logger
+
+  uploadMedia(media: any, opts?: any): Promise<any>
+  generateMessage(jid: string, content: any, opts?: any): Promise<any>
+  generatePoll(jid: string, opts: any): Promise<any>
+  generateReaction(jid: string, opts: any): Promise<any>
+  relayMessage(jid: string, message: any, opts?: any): Promise<string>
+  on(event: string, handler: (...args: any[]) => void): () => void
+  once(event: string, handler: (...args: any[]) => void): () => void
+  off(event: string, handler: (...args: any[]) => void): void
+  get raw(): import('@whiskeysockets/baileys').WASocket
+}
+
+// ─── Services ──────────────────────────────────────────────────────────
+
+export class MediaService {
+  constructor(conn: Connection, opts?: { cache?: boolean; cacheMax?: number; logger?: Logger; uploadJid?: string })
+  fetch(url: string, opts?: any): Promise<Buffer>
+  resize(buf: Buffer, opts: any): Promise<Buffer>
+  thumbnail(buf: Buffer, size?: number, format?: 'png' | 'jpeg' | 'webp'): Promise<Buffer>
+  duration(buf: Buffer): number
+  videoThumbnail(buf: Buffer, opts?: any): Promise<Buffer | string>
+  upload(source: Buffer | { url: string }, mediaType: 'image' | 'video' | 'audio' | 'document', opts?: any): Promise<string>
+  resolve(source: string | Buffer | Array<string | Buffer>, opts?: any): Promise<string | Buffer | Array<string | Buffer>>
+  sniff(buf: Buffer, filename?: string): string
+  category(mime: string): 'image' | 'video' | 'audio' | 'document'
+}
+
+export class ProtoService {
+  constructor(conn: Connection)
+  generate(jid: string, content: any, opts?: any): Promise<any>
+  relay(jid: string, message: any, opts?: any): Promise<string>
+  relayInteractive(jid: string, message: any, opts?: any): Promise<string>
+  generateAndRelay(jid: string, content: any, opts?: any & { interactive?: boolean }): Promise<any>
+}
+
+export class MessageService {
+  constructor(conn: Connection, proto: ProtoService, media: MediaService)
+  text(jid: string, text: string, opts?: any): Promise<any>
+  image(jid: string, source: string | Buffer, caption?: string, opts?: any): Promise<any>
+  video(jid: string, source: string | Buffer, caption?: string, opts?: any): Promise<any>
+  audio(jid: string, source: string | Buffer, opts?: any): Promise<any>
+  document(jid: string, source: string | Buffer, opts?: any): Promise<any>
+  sticker(jid: string, source: string | Buffer, opts?: any): Promise<any>
+  contact(jid: string, contacts: Array<{ name: string; number: string }>, opts?: any): Promise<any>
+  location(jid: string, lat: number, lng: number, opts?: any): Promise<any>
+  poll(jid: string, name: string, options: string[], opts?: any): Promise<any>
+  reply(jid: string, text: string, quoted: any, opts?: any): Promise<any>
+  react(jid: string, key: any, emoji: string, opts?: any): Promise<any>
+  delete(jid: string, key: any): Promise<any>
+  forward(jid: string, message: any, opts?: any): Promise<any>
+  copy(jid: string, message: any, opts?: any): Promise<any>
+  edit(jid: string, key: any, newText: string, opts?: any): Promise<any>
+}
+
+// ─── Builders ──────────────────────────────────────────────────────────
+
+export interface ContentFields {
+  title(t: string): this
+  subtitle(t: string): this
+  body(t: string): this
+  footer(t: string): this
+  contextInfo(o: object): this
+  payload(o: object): this
+}
+
+export class ButtonBuilder implements ContentFields {
+  constructor(conn: Connection, proto: ProtoService, media: MediaService)
+
+  // Content
+  title(t: string): this
+  subtitle(t: string): this
+  body(t: string): this
+  footer(t: string): this
+  contextInfo(o: object): this
+  payload(o: object): this
+
+  // Media
+  media(type: 'image' | 'video' | 'document', source: string | Buffer | object, opts?: object): this
+  image(source: string | Buffer, opts?: object): this
+  video(source: string | Buffer, opts?: object): this
+  document(source: string | Buffer, opts?: object): this
+
+  // Buttons
+  button(name: string, params: object | string, extra?: object): this
+  params(obj: object): this
+  reply(displayText: string, id?: string, opts?: object): this
+  call(displayText: string, id?: string, opts?: object): this
+  reminder(displayText: string, id?: string, opts?: object): this
+  cancelReminder(displayText: string, id?: string, opts?: object): this
+  address(displayText: string, id?: string, opts?: object): this
+  url(displayText: string, url: string, opts?: object): this
+  copy(displayText: string, copyCode: string, opts?: object): this
+  location(opts?: object): this
+  selection(title: string, builder: (sel: SelectionBuilder) => void, extra?: object): this
+  clear(): this
+
+  // Lifecycle
+  toCard(): Promise<object>
+  build(jid: string, opts?: object): Promise<object>
+  send(jid: string, opts?: object): Promise<object>
+}
+
+export interface SelectionBuilder {
+  title(t: string): this
+  section(title: string, builder: (s: SectionBuilder) => void): this
+  build(): object
+}
+
+export interface SectionBuilder {
+  row(header: string, title: string, description: string, id: string): this
+}
+
+export class ButtonV2Builder implements ContentFields {
+  constructor(conn: Connection)
+  title(t: string): this
+  subtitle(t: string): this
+  body(t: string): this
+  footer(t: string): this
+  contextInfo(o: object): this
+  payload(o: object): this
+  button(displayText: string, id?: string): this
+  rawButton(obj: object): this
+  thumbnail(source: string | Buffer): this
+  media(obj: object): this
+  build(jid: string, opts?: object): Promise<object>
+  send(jid: string, opts?: object): Promise<object>
+}
+
+export class CardBuilder implements ContentFields {
+  constructor(conn: Connection)
+  title(t: string): this
+  subtitle(t: string): this
+  body(t: string): this
+  footer(t: string): this
+  contextInfo(o: object): this
+  payload(o: object): this
+  media(type: 'image' | 'video' | 'document', source: string | Buffer | object, opts?: object): this
+  image(source: string | Buffer, opts?: object): this
+  video(source: string | Buffer, opts?: object): this
+  document(source: string | Buffer, opts?: object): this
+  params(obj: object): this
+  button(name: string, params: object | string, extra?: object): this
+  reply(displayText: string, id?: string, opts?: object): this
+  url(displayText: string, url: string, opts?: object): this
+  copy(displayText: string, copyCode: string, opts?: object): this
+  build(): Promise<object>
+}
+
+export class CarouselBuilder implements ContentFields {
+  constructor(conn: Connection, proto: ProtoService, media: MediaService)
+  title(t: string): this
+  subtitle(t: string): this
+  body(t: string): this
+  footer(t: string): this
+  contextInfo(o: object): this
+  payload(o: object): this
+  newCard(): CardBuilder
+  card(card: object | object[]): this
+  cards(...cards: object[]): this
+  build(jid: string, opts?: object): Promise<object>
+  send(jid: string, opts?: object): Promise<object>
+}
+
+export class AIRichBuilder implements ContentFields {
+  constructor(conn: Connection, proto: ProtoService, media: MediaService)
+  title(t: string): this
+  subtitle(t: string): this
+  body(t: string): this
+  footer(t: string): this
+  contextInfo(o: object): this
+  payload(o: object): this
+
+  forwarded(v?: boolean): this
+  notification(v: boolean | object): this
+  quoted(quoted: object, quotedParticipant?: string): this
+  includesUnifiedResponse(v?: boolean): this
+  includesSubmessages(v?: boolean): this
+  submessage(msg: object | object[]): this
+
+  text(text: string, opts?: { hyperlink?: boolean; citation?: boolean; latex?: boolean }): Promise<this>
+  code(language: string, code: string): Promise<this>
+  table(table: string[][], opts?: { title?: string; hyperlink?: boolean; citation?: boolean; latex?: boolean }): Promise<this>
+  image(source: string | Buffer | Array<string | Buffer>, opts?: { resolveUrl?: boolean }): Promise<this>
+  video(source: string | Buffer | object | Array<any>, opts?: { autoFill?: boolean }): Promise<this>
+  source(sources: Array<string> | Array<Array<string>>): Promise<this>
+  reels(items: object | object[]): Promise<this>
+  product(item: object | object[]): Promise<this>
+  post(item: object | object[]): Promise<this>
+  tip(text: string): Promise<this>
+  suggest(suggestion: string | string[], opts?: { scroll?: boolean; layout?: 'Single' | 'HScroll' | 'ActionRow' }): Promise<this>
+
+  build(opts?: object): Promise<object>
+  send(jid: string, opts?: object): Promise<string>
+}
+
+// ─── ProtoUpdater ──────────────────────────────────────────────────────
+
+export class ProtoUpdater {
+  constructor(opts?: { protoPath?: string; backupDir?: string; logger?: Logger })
+  backup(): Promise<{ id: string; timestamp: number; path: string; hash: string }>
+  restore(id: string): Promise<void>
+  rollback(): Promise<void>
+  validate(): Promise<{ ok: boolean; errors: Array<{ file: string; message: string }> }>
+  update(opts?: { autoRollback?: boolean; dryRun?: boolean }): Promise<{
+    success: boolean
+    fromHash: string
+    toHash: string
+    backupId: string | null
+    appliedFixes: string[]
+    errors: any[]
+  }>
+}
+
+export function transformToESM(src: string): string
+export function applyKnownFixes(filename: string, content: string): { content: string; applied: string[] }
+export function assembleRichResponse(opts?: any): Promise<object>
+export function createInteractiveNodes(opts?: any): any[]
+export function createBareInteractiveNodes(opts?: any): any[]
+
+// ─── Bot ───────────────────────────────────────────────────────────────
+
+export interface BotOptions {
+  uploadJid?: string
+  logger?: Logger
+  mediaCache?: boolean
+}
+
+export interface UtilFacade {
+  extractInlineEntities: typeof extractInlineEntities
+  tokenizeCode: typeof tokenizeCode
+  toTableMetadata: typeof toTableMetadata
+}
+
+export class Bot {
+  constructor(socket: import('@whiskeysockets/baileys').WASocket, opts?: BotOptions)
+
+  readonly connection: Connection
+  readonly media: MediaService
+  readonly proto: ProtoService
+  readonly message: MessageService
+  readonly logger: Logger
+  readonly util: UtilFacade
+
+  // Basic senders
+  text(jid: string, text: string, opts?: any): Promise<any>
+  image(jid: string, source: string | Buffer, caption?: string, opts?: any): Promise<any>
+  video(jid: string, source: string | Buffer, caption?: string, opts?: any): Promise<any>
+  audio(jid: string, source: string | Buffer, opts?: any): Promise<any>
+  document(jid: string, source: string | Buffer, opts?: any): Promise<any>
+  sticker(jid: string, source: string | Buffer, opts?: any): Promise<any>
+  contact(jid: string, contacts: Array<{ name: string; number: string }>, opts?: any): Promise<any>
+  location(jid: string, lat: number, lng: number, opts?: any): Promise<any>
+  poll(jid: string, name: string, options: string[], opts?: any): Promise<any>
+  reply(jid: string, text: string, quoted: any, opts?: any): Promise<any>
+  react(jid: string, key: any, emoji: string, opts?: any): Promise<any>
+  delete(jid: string, key: any): Promise<any>
+  forward(jid: string, message: any, opts?: any): Promise<any>
+  copy(jid: string, message: any, opts?: any): Promise<any>
+  edit(jid: string, key: any, newText: string, opts?: any): Promise<any>
+
+  // Builder factories
+  button(): ButtonBuilder
+  buttonV2(): ButtonV2Builder
+  carousel(): CarouselBuilder
+  ai(): AIRichBuilder
+
+  // Event bus
+  on(event: string, handler: (...args: any[]) => void): () => void
+  once(event: string, handler: (...args: any[]) => void): () => void
+  off(event: string, handler: (...args: any[]) => void): void
+
+  // Raw escape
+  get raw(): import('@whiskeysockets/baileys').WASocket
+}
+
+// ─── Version ───────────────────────────────────────────────────────────
+
+export const VERSION: string
+
+export default Bot

package/src/index.js

@@ -0,0 +1,152 @@
+/**
+ * @file index.js
+ * @module @kyyinfinite/lumina
+ *
+ * Lumina — Modern WhatsApp framework built on top of Baileys.
+ *
+ * Public API surface:
+ *
+ *   import { Bot } from '@kyyinfinite/lumina'
+ *   const bot = new Bot(socket)
+ *   await bot.text(jid, 'Halo')
+ *
+ * Subpath exports (tree-shakable):
+ *
+ *   import { extractInlineEntities } from '@kyyinfinite/lumina/parsers'
+ *   import { MediaService }          from '@kyyinfinite/lumina/services'
+ *   import { ButtonBuilder }         from '@kyyinfinite/lumina/builders'
+ *   import { ProtoUpdater }          from '@kyyinfinite/lumina/proto'
+ *   import { resize }                from '@kyyinfinite/lumina/media'
+ */
+
+import { Bot } from './client/bot.js'
+import { Connection } from './client/connection.js'
+
+import { ButtonBuilder } from './builders/button.js'
+import { ButtonV2Builder } from './builders/button-v2.js'
+import { CarouselBuilder } from './builders/carousel.js'
+import { CardBuilder } from './builders/card.js'
+import { AIRichBuilder } from './builders/ai-rich.js'
+
+import { MediaService } from './services/media-service.js'
+import { ProtoService } from './services/proto-service.js'
+import { MessageService } from './services/message-service.js'
+
+import { extractInlineEntities } from './parsers/inline-entity.js'
+import { tokenizeCode } from './parsers/code-tokenizer.js'
+import { toTableMetadata } from './parsers/table-metadata.js'
+
+import { ProtoUpdater, transformToESM, applyKnownFixes } from './proto/updater.js'
+import { assembleRichResponse } from './proto/rich-response.js'
+import { createInteractiveNodes, createBareInteractiveNodes } from './proto/relay-nodes.js'
+
+// Catalog re-exports — these are imported so that the named exports below
+// are available from the root `@kyyinfinite/lumina` entry point.
+import {
+  MessageType,
+  ForwardOrigin,
+  HeaderType,
+  NativeFlow,
+  BOT_JID,
+  LayoutKind,
+  HighlightType,
+  HighlightLabel,
+  ImagineType,
+  SourceType,
+  PromptType,
+  SessionTransparencyType,
+  TYPENAME,
+} from './proto/enums.js'
+
+import {
+  markdownTextPrimitive,
+  codePrimitive,
+  tablePrimitive,
+  searchResultPrimitive,
+  reelPrimitive,
+  imaginePrimitive,
+  productCardPrimitive,
+  postPrimitive,
+  metadataTextPrimitive,
+  followUpSuggestionPillPrimitive,
+  shapeSourceEntry,
+  shapeReelEntry,
+} from './proto/primitives.js'
+
+import { singleLayout, hscrollLayout, actionRowLayout, layoutFor } from './proto/layouts.js'
+
+import { LuminaError, ValidationError, MediaError, ProtoError, ConnectionError, ProtocolError } from './errors.js'
+import { createLogger } from './utils/logger.js'
+
+/** Semver version of the Lumina package. */
+export const VERSION = '1.0.0'
+
+// Public API
+export {
+  Bot,
+  Connection,
+  // Builders
+  ButtonBuilder,
+  ButtonV2Builder,
+  CarouselBuilder,
+  CardBuilder,
+  AIRichBuilder,
+  // Services
+  MediaService,
+  ProtoService,
+  MessageService,
+  // Parsers
+  extractInlineEntities,
+  tokenizeCode,
+  toTableMetadata,
+  // Proto
+  ProtoUpdater,
+  transformToESM,
+  applyKnownFixes,
+  assembleRichResponse,
+  createInteractiveNodes,
+  createBareInteractiveNodes,
+  // Catalog
+  MessageType,
+  ForwardOrigin,
+  HeaderType,
+  NativeFlow,
+  BOT_JID,
+  LayoutKind,
+  HighlightType,
+  HighlightLabel,
+  ImagineType,
+  SourceType,
+  PromptType,
+  SessionTransparencyType,
+  TYPENAME,
+  // Primitive factories
+  markdownTextPrimitive,
+  codePrimitive,
+  tablePrimitive,
+  searchResultPrimitive,
+  reelPrimitive,
+  imaginePrimitive,
+  productCardPrimitive,
+  postPrimitive,
+  metadataTextPrimitive,
+  followUpSuggestionPillPrimitive,
+  shapeSourceEntry,
+  shapeReelEntry,
+  // Layout factories
+  singleLayout,
+  hscrollLayout,
+  actionRowLayout,
+  layoutFor,
+  // Errors
+  LuminaError,
+  ValidationError,
+  MediaError,
+  ProtoError,
+  ConnectionError,
+  ProtocolError,
+  // Utils
+  createLogger,
+}
+
+export default Bot