@furlow/builtins 0.1.0

package/dist/leveling/index.d.ts

@@ -0,0 +1,46 @@
+import { FurlowSpec, CanvasGenerator, CommandDefinition, EventHandler, TableDefinition } from '@furlow/schema';
+
+/**
+ * Leveling builtin module
+ * Handles XP, levels, rewards, leaderboards, and rank cards
+ */
+
+interface LevelingConfig {
+    /** XP per message range [min, max] */
+    xpPerMessage?: [number, number];
+    /** Cooldown between XP gains (seconds) */
+    xpCooldown?: number;
+    /** XP multiplier for roles */
+    roleMultipliers?: Record<string, number>;
+    /** Channels where XP is disabled */
+    ignoredChannels?: string[];
+    /** Roles that don't earn XP */
+    ignoredRoles?: string[];
+    /** Channel for level up announcements */
+    announceChannel?: string;
+    /** Level up message */
+    levelUpMessage?: string;
+    /** Use embed for level up */
+    levelUpEmbed?: boolean;
+    /** Level rewards (level -> role IDs) */
+    rewards?: Record<number, string[]>;
+    /** Stack rewards or remove previous */
+    stackRewards?: boolean;
+    /** Use rank card images */
+    useRankCard?: boolean;
+    /** Rank card generator name */
+    rankCardGenerator?: string;
+    /** XP curve formula */
+    xpCurve?: 'linear' | 'exponential' | 'custom';
+    /** Base XP for level 1 */
+    baseXP?: number;
+    /** XP multiplier per level */
+    xpMultiplier?: number;
+}
+declare const levelingTables: Record<string, TableDefinition>;
+declare const levelingEventHandlers: EventHandler[];
+declare const levelingCommands: CommandDefinition[];
+declare const levelingCanvasGenerators: Record<string, CanvasGenerator>;
+declare function getLevelingSpec(config?: LevelingConfig): Partial<FurlowSpec>;
+
+export { type LevelingConfig, getLevelingSpec, levelingCanvasGenerators, levelingCommands, levelingEventHandlers, levelingTables };

package/dist/leveling/index.js

@@ -0,0 +1,521 @@
+// src/leveling/index.ts
+var levelingTables = {
+  levels: {
+    columns: {
+      id: { type: "number", primary: true },
+      user_id: { type: "string", index: true },
+      guild_id: { type: "string", index: true },
+      xp: { type: "number", default: 0 },
+      level: { type: "number", default: 0 },
+      total_messages: { type: "number", default: 0 },
+      last_xp_at: { type: "timestamp" }
+    }
+  }
+};
+var levelingEventHandlers = [
+  {
+    event: "message",
+    condition: "${!message.author.bot && !config.leveling.ignoredChannels?.includes(channel.id)}",
+    actions: [
+      // Check cooldown
+      {
+        action: "db_query",
+        table: "levels",
+        where: {
+          user_id: "${user.id}",
+          guild_id: "${guild.id}"
+        },
+        as: "userData"
+      },
+      // Initialize if new user
+      {
+        action: "flow_if",
+        condition: "${!userData || userData.length === 0}",
+        then: [
+          {
+            action: "db_insert",
+            table: "levels",
+            data: {
+              user_id: "${user.id}",
+              guild_id: "${guild.id}",
+              xp: 0,
+              level: 0,
+              total_messages: 0,
+              last_xp_at: "${now()}"
+            }
+          },
+          {
+            action: "set",
+            key: "userData",
+            value: [{ xp: 0, level: 0, total_messages: 0, last_xp_at: null }]
+          }
+        ]
+      },
+      // Check cooldown
+      {
+        action: "set",
+        key: "cooldownPassed",
+        value: "${!userData[0].last_xp_at || (now() - userData[0].last_xp_at) > (config.leveling.xpCooldown || 60) * 1000}"
+      },
+      {
+        action: "flow_if",
+        condition: "${cooldownPassed}",
+        then: [
+          // Calculate XP gain
+          {
+            action: "set",
+            key: "xpRange",
+            value: "${config.leveling.xpPerMessage || [15, 25]}"
+          },
+          {
+            action: "set",
+            key: "baseXpGain",
+            value: "${random(xpRange[0], xpRange[1])}"
+          },
+          // Apply role multiplier
+          {
+            action: "set",
+            key: "multiplier",
+            value: "${config.leveling.roleMultipliers ? (member.roles | map(r => config.leveling.roleMultipliers[r.id] || 1) | max) : 1}"
+          },
+          {
+            action: "set",
+            key: "xpGain",
+            value: "${floor(baseXpGain * multiplier)}"
+          },
+          // Calculate new XP and level
+          {
+            action: "set",
+            key: "newXP",
+            value: "${userData[0].xp + xpGain}"
+          },
+          {
+            action: "set",
+            key: "currentLevel",
+            value: "${userData[0].level}"
+          },
+          // Calculate XP needed for next level
+          {
+            action: "set",
+            key: "xpForNextLevel",
+            value: '${config.leveling.xpCurve === "exponential" ? floor((config.leveling.baseXP || 100) * pow(config.leveling.xpMultiplier || 1.5, currentLevel)) : (config.leveling.baseXP || 100) * (currentLevel + 1)}'
+          },
+          // Check for level up
+          {
+            action: "set",
+            key: "newLevel",
+            value: "${newXP >= xpForNextLevel ? currentLevel + 1 : currentLevel}"
+          },
+          {
+            action: "set",
+            key: "leveledUp",
+            value: "${newLevel > currentLevel}"
+          },
+          // Update database
+          {
+            action: "db_update",
+            table: "levels",
+            where: {
+              user_id: "${user.id}",
+              guild_id: "${guild.id}"
+            },
+            data: {
+              xp: "${leveledUp ? newXP - xpForNextLevel : newXP}",
+              level: "${newLevel}",
+              total_messages: "${userData[0].total_messages + 1}",
+              last_xp_at: "${now()}"
+            }
+          },
+          // Handle level up
+          {
+            action: "flow_if",
+            condition: "${leveledUp}",
+            then: [
+              // Announce level up
+              {
+                action: "flow_if",
+                condition: "${config.leveling.announceChannel}",
+                then: [
+                  {
+                    action: "flow_if",
+                    condition: "${config.leveling.levelUpEmbed}",
+                    then: [
+                      {
+                        action: "send_message",
+                        channel: "${config.leveling.announceChannel}",
+                        embed: {
+                          title: "Level Up!",
+                          description: '${config.leveling.levelUpMessage || member.displayName + " has reached level " + newLevel + "!"}',
+                          color: "#ffd700",
+                          thumbnail: "${member.avatarURL}"
+                        }
+                      }
+                    ],
+                    else: [
+                      {
+                        action: "send_message",
+                        channel: "${config.leveling.announceChannel}",
+                        content: '${config.leveling.levelUpMessage || "Congratulations " + member.displayName + "! You reached level " + newLevel + "!"}'
+                      }
+                    ]
+                  }
+                ]
+              },
+              // Award role rewards
+              {
+                action: "flow_if",
+                condition: "${config.leveling.rewards && config.leveling.rewards[newLevel]}",
+                then: [
+                  // Remove previous rewards if not stacking
+                  {
+                    action: "flow_if",
+                    condition: "${!config.leveling.stackRewards && currentLevel > 0 && config.leveling.rewards[currentLevel]}",
+                    then: [
+                      {
+                        action: "remove_role",
+                        user: "${member.id}",
+                        role: "${config.leveling.rewards[currentLevel]}"
+                      }
+                    ]
+                  },
+                  {
+                    action: "assign_role",
+                    user: "${member.id}",
+                    role: "${config.leveling.rewards[newLevel]}"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+];
+var levelingCommands = [
+  {
+    name: "rank",
+    description: "View your rank or another user's rank",
+    options: [
+      { name: "user", description: "User to check", type: "user", required: false }
+    ],
+    actions: [
+      {
+        action: "set",
+        key: "targetUser",
+        value: "${args.user || user}"
+      },
+      {
+        action: "db_query",
+        table: "levels",
+        where: {
+          user_id: "${targetUser.id}",
+          guild_id: "${guild.id}"
+        },
+        as: "userData"
+      },
+      {
+        action: "flow_if",
+        condition: "${!userData || userData.length === 0}",
+        then: [
+          {
+            action: "reply",
+            content: "${targetUser.username} has no XP yet!",
+            ephemeral: true
+          }
+        ],
+        else: [
+          // Get leaderboard position
+          {
+            action: "db_query",
+            table: "levels",
+            where: {
+              guild_id: "${guild.id}"
+            },
+            order_by: "level DESC, xp DESC",
+            as: "leaderboard"
+          },
+          {
+            action: "set",
+            key: "rank",
+            value: "${(leaderboard | findIndex(u => u.user_id === targetUser.id)) + 1}"
+          },
+          {
+            action: "set",
+            key: "xpForNextLevel",
+            value: '${config.leveling.xpCurve === "exponential" ? floor((config.leveling.baseXP || 100) * pow(config.leveling.xpMultiplier || 1.5, userData[0].level)) : (config.leveling.baseXP || 100) * (userData[0].level + 1)}'
+          },
+          // Render rank card or embed
+          {
+            action: "flow_if",
+            condition: "${config.leveling.useRankCard}",
+            then: [
+              {
+                action: "canvas_render",
+                generator: '${config.leveling.rankCardGenerator || "rank_card"}',
+                context: {
+                  user: "${targetUser}",
+                  member: "${guild.members.cache.get(targetUser.id)}",
+                  level: "${userData[0].level}",
+                  xp: "${userData[0].xp}",
+                  xpNeeded: "${xpForNextLevel}",
+                  rank: "${rank}",
+                  totalMessages: "${userData[0].total_messages}"
+                },
+                as: "rankCard"
+              },
+              {
+                action: "reply",
+                files: [
+                  {
+                    attachment: "${rankCard}",
+                    name: "rank.png"
+                  }
+                ]
+              }
+            ],
+            else: [
+              {
+                action: "reply",
+                embed: {
+                  title: "${targetUser.username}'s Rank",
+                  color: "#5865f2",
+                  thumbnail: "${targetUser.avatarURL}",
+                  fields: [
+                    { name: "Rank", value: "#${rank}", inline: true },
+                    { name: "Level", value: "${userData[0].level}", inline: true },
+                    { name: "XP", value: "${userData[0].xp}/${xpForNextLevel}", inline: true },
+                    { name: "Messages", value: "${userData[0].total_messages}", inline: true }
+                  ]
+                }
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  },
+  {
+    name: "leaderboard",
+    description: "View the server leaderboard",
+    options: [
+      { name: "page", description: "Page number", type: "integer", required: false }
+    ],
+    actions: [
+      {
+        action: "set",
+        key: "page",
+        value: "${args.page || 1}"
+      },
+      {
+        action: "set",
+        key: "perPage",
+        value: 10
+      },
+      {
+        action: "db_query",
+        table: "levels",
+        where: {
+          guild_id: "${guild.id}"
+        },
+        order_by: "level DESC, xp DESC",
+        limit: "${perPage}",
+        offset: "${(page - 1) * perPage}",
+        as: "leaderboard"
+      },
+      {
+        action: "set",
+        key: "leaderboardText",
+        value: '${leaderboard | mapIndex((entry, i) => "#" + ((page - 1) * perPage + i + 1) + " <@" + entry.user_id + "> - Level " + entry.level + " (" + entry.xp + " XP)") | join("\\n")}'
+      },
+      {
+        action: "reply",
+        embed: {
+          title: "${guild.name} Leaderboard",
+          description: '${leaderboardText || "No entries yet!"}',
+          color: "#ffd700",
+          footer: {
+            text: "Page ${page}"
+          }
+        }
+      }
+    ]
+  },
+  {
+    name: "setxp",
+    description: "Set a user's XP (admin)",
+    options: [
+      { name: "user", description: "User to modify", type: "user", required: true },
+      { name: "xp", description: "XP amount", type: "integer", required: true }
+    ],
+    actions: [
+      {
+        action: "db_update",
+        table: "levels",
+        where: {
+          user_id: "${args.user.id}",
+          guild_id: "${guild.id}"
+        },
+        data: {
+          xp: "${args.xp}"
+        },
+        upsert: true
+      },
+      {
+        action: "reply",
+        content: "Set ${args.user.username}'s XP to ${args.xp}",
+        ephemeral: true
+      }
+    ]
+  },
+  {
+    name: "setlevel",
+    description: "Set a user's level (admin)",
+    options: [
+      { name: "user", description: "User to modify", type: "user", required: true },
+      { name: "level", description: "Level", type: "integer", required: true }
+    ],
+    actions: [
+      {
+        action: "db_update",
+        table: "levels",
+        where: {
+          user_id: "${args.user.id}",
+          guild_id: "${guild.id}"
+        },
+        data: {
+          level: "${args.level}",
+          xp: 0
+        },
+        upsert: true
+      },
+      {
+        action: "reply",
+        content: "Set ${args.user.username}'s level to ${args.level}",
+        ephemeral: true
+      }
+    ]
+  }
+];
+var levelingCanvasGenerators = {
+  rank_card: {
+    width: 934,
+    height: 282,
+    background: "#23272a",
+    layers: [
+      // Background gradient
+      {
+        type: "rect",
+        x: 0,
+        y: 0,
+        width: 934,
+        height: 282,
+        color: "linear-gradient(135deg, #1a1c20 0%, #2c2f33 100%)",
+        radius: 20
+      },
+      // User avatar
+      {
+        type: "circle_image",
+        url: "${user.avatarURL || user.defaultAvatarURL}",
+        x: 120,
+        y: 141,
+        radius: 80,
+        border: {
+          width: 5,
+          color: "#5865f2"
+        }
+      },
+      // Username
+      {
+        type: "text",
+        text: "${user.username}",
+        x: 260,
+        y: 120,
+        font: 'bold 36px "Poppins", sans-serif',
+        color: "#ffffff",
+        align: "left"
+      },
+      // Rank badge
+      {
+        type: "text",
+        text: "RANK #${rank}",
+        x: 850,
+        y: 60,
+        font: 'bold 24px "Poppins", sans-serif',
+        color: "#7289da",
+        align: "right"
+      },
+      // Level badge
+      {
+        type: "text",
+        text: "LEVEL ${level}",
+        x: 850,
+        y: 90,
+        font: 'bold 32px "Poppins", sans-serif',
+        color: "#ffffff",
+        align: "right"
+      },
+      // XP Progress bar background
+      {
+        type: "rect",
+        x: 260,
+        y: 180,
+        width: 600,
+        height: 30,
+        color: "#484b4e",
+        radius: 15
+      },
+      // XP Progress bar fill
+      {
+        type: "progress_bar",
+        x: 260,
+        y: 180,
+        width: 600,
+        height: 30,
+        progress: "${xp / xpNeeded}",
+        color: "linear-gradient(90deg, #5865f2 0%, #7289da 100%)",
+        radius: 15
+      },
+      // XP Text
+      {
+        type: "text",
+        text: "${xp} / ${xpNeeded} XP",
+        x: 560,
+        y: 160,
+        font: '18px "Poppins", sans-serif',
+        color: "#99aab5",
+        align: "center"
+      },
+      // Messages count
+      {
+        type: "text",
+        text: "${totalMessages} messages",
+        x: 260,
+        y: 240,
+        font: '16px "Poppins", sans-serif',
+        color: "#72767d",
+        align: "left"
+      }
+    ]
+  }
+};
+function getLevelingSpec(config = {}) {
+  return {
+    events: levelingEventHandlers,
+    commands: levelingCommands,
+    state: {
+      tables: levelingTables
+    },
+    canvas: {
+      generators: levelingCanvasGenerators
+    }
+  };
+}
+export {
+  getLevelingSpec,
+  levelingCanvasGenerators,
+  levelingCommands,
+  levelingEventHandlers,
+  levelingTables
+};
+//# sourceMappingURL=index.js.map

package/dist/leveling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/leveling/index.ts"],"sourcesContent":["/**\n * Leveling builtin module\n * Handles XP, levels, rewards, leaderboards, and rank cards\n */\n\nimport type { FurlowSpec, CommandDefinition, EventHandler, CanvasGenerator, TableDefinition } from '@furlow/schema';\n\nexport interface LevelingConfig {\n  /** XP per message range [min, max] */\n  xpPerMessage?: [number, number];\n  /** Cooldown between XP gains (seconds) */\n  xpCooldown?: number;\n  /** XP multiplier for roles */\n  roleMultipliers?: Record<string, number>;\n  /** Channels where XP is disabled */\n  ignoredChannels?: string[];\n  /** Roles that don't earn XP */\n  ignoredRoles?: string[];\n  /** Channel for level up announcements */\n  announceChannel?: string;\n  /** Level up message */\n  levelUpMessage?: string;\n  /** Use embed for level up */\n  levelUpEmbed?: boolean;\n  /** Level rewards (level -> role IDs) */\n  rewards?: Record<number, string[]>;\n  /** Stack rewards or remove previous */\n  stackRewards?: boolean;\n  /** Use rank card images */\n  useRankCard?: boolean;\n  /** Rank card generator name */\n  rankCardGenerator?: string;\n  /** XP curve formula */\n  xpCurve?: 'linear' | 'exponential' | 'custom';\n  /** Base XP for level 1 */\n  baseXP?: number;\n  /** XP multiplier per level */\n  xpMultiplier?: number;\n}\n\nexport const levelingTables: Record<string, TableDefinition> = {\n  levels: {\n    columns: {\n      id: { type: 'number', primary: true },\n      user_id: { type: 'string', index: true },\n      guild_id: { type: 'string', index: true },\n      xp: { type: 'number', default: 0 },\n      level: { type: 'number', default: 0 },\n      total_messages: { type: 'number', default: 0 },\n      last_xp_at: { type: 'timestamp' },\n    },\n  },\n};\n\nexport const levelingEventHandlers: EventHandler[] = [\n  {\n    event: 'message',\n    condition: '${!message.author.bot && !config.leveling.ignoredChannels?.includes(channel.id)}',\n    actions: [\n      // Check cooldown\n      {\n        action: 'db_query',\n        table: 'levels',\n        where: {\n          user_id: '${user.id}',\n          guild_id: '${guild.id}',\n        },\n        as: 'userData',\n      },\n      // Initialize if new user\n      {\n        action: 'flow_if',\n        condition: '${!userData || userData.length === 0}',\n        then: [\n          {\n            action: 'db_insert',\n            table: 'levels',\n            data: {\n              user_id: '${user.id}',\n              guild_id: '${guild.id}',\n              xp: 0,\n              level: 0,\n              total_messages: 0,\n              last_xp_at: '${now()}',\n            },\n          },\n          {\n            action: 'set',\n            key: 'userData',\n            value: [{ xp: 0, level: 0, total_messages: 0, last_xp_at: null }],\n          },\n        ],\n      },\n      // Check cooldown\n      {\n        action: 'set',\n        key: 'cooldownPassed',\n        value: '${!userData[0].last_xp_at || (now() - userData[0].last_xp_at) > (config.leveling.xpCooldown || 60) * 1000}',\n      },\n      {\n        action: 'flow_if',\n        condition: '${cooldownPassed}',\n        then: [\n          // Calculate XP gain\n          {\n            action: 'set',\n            key: 'xpRange',\n            value: '${config.leveling.xpPerMessage || [15, 25]}',\n          },\n          {\n            action: 'set',\n            key: 'baseXpGain',\n            value: '${random(xpRange[0], xpRange[1])}',\n          },\n          // Apply role multiplier\n          {\n            action: 'set',\n            key: 'multiplier',\n            value: '${config.leveling.roleMultipliers ? (member.roles | map(r => config.leveling.roleMultipliers[r.id] || 1) | max) : 1}',\n          },\n          {\n            action: 'set',\n            key: 'xpGain',\n            value: '${floor(baseXpGain * multiplier)}',\n          },\n          // Calculate new XP and level\n          {\n            action: 'set',\n            key: 'newXP',\n            value: '${userData[0].xp + xpGain}',\n          },\n          {\n            action: 'set',\n            key: 'currentLevel',\n            value: '${userData[0].level}',\n          },\n          // Calculate XP needed for next level\n          {\n            action: 'set',\n            key: 'xpForNextLevel',\n            value: '${config.leveling.xpCurve === \"exponential\" ? floor((config.leveling.baseXP || 100) * pow(config.leveling.xpMultiplier || 1.5, currentLevel)) : (config.leveling.baseXP || 100) * (currentLevel + 1)}',\n          },\n          // Check for level up\n          {\n            action: 'set',\n            key: 'newLevel',\n            value: '${newXP >= xpForNextLevel ? currentLevel + 1 : currentLevel}',\n          },\n          {\n            action: 'set',\n            key: 'leveledUp',\n            value: '${newLevel > currentLevel}',\n          },\n          // Update database\n          {\n            action: 'db_update',\n            table: 'levels',\n            where: {\n              user_id: '${user.id}',\n              guild_id: '${guild.id}',\n            },\n            data: {\n              xp: '${leveledUp ? newXP - xpForNextLevel : newXP}',\n              level: '${newLevel}',\n              total_messages: '${userData[0].total_messages + 1}',\n              last_xp_at: '${now()}',\n            },\n          },\n          // Handle level up\n          {\n            action: 'flow_if',\n            condition: '${leveledUp}',\n            then: [\n              // Announce level up\n              {\n                action: 'flow_if',\n                condition: '${config.leveling.announceChannel}',\n                then: [\n                  {\n                    action: 'flow_if',\n                    condition: '${config.leveling.levelUpEmbed}',\n                    then: [\n                      {\n                        action: 'send_message',\n                        channel: '${config.leveling.announceChannel}',\n                        embed: {\n                          title: 'Level Up!',\n                          description: '${config.leveling.levelUpMessage || member.displayName + \" has reached level \" + newLevel + \"!\"}',\n                          color: '#ffd700',\n                          thumbnail: '${member.avatarURL}',\n                        },\n                      },\n                    ],\n                    else: [\n                      {\n                        action: 'send_message',\n                        channel: '${config.leveling.announceChannel}',\n                        content: '${config.leveling.levelUpMessage || \"Congratulations \" + member.displayName + \"! You reached level \" + newLevel + \"!\"}',\n                      },\n                    ],\n                  },\n                ],\n              },\n              // Award role rewards\n              {\n                action: 'flow_if',\n                condition: '${config.leveling.rewards && config.leveling.rewards[newLevel]}',\n                then: [\n                  // Remove previous rewards if not stacking\n                  {\n                    action: 'flow_if',\n                    condition: '${!config.leveling.stackRewards && currentLevel > 0 && config.leveling.rewards[currentLevel]}',\n                    then: [\n                      {\n                        action: 'remove_role',\n                        user: '${member.id}',\n                        role: '${config.leveling.rewards[currentLevel]}',\n                      },\n                    ],\n                  },\n                  {\n                    action: 'assign_role',\n                    user: '${member.id}',\n                    role: '${config.leveling.rewards[newLevel]}',\n                  },\n                ],\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  },\n];\n\nexport const levelingCommands: CommandDefinition[] = [\n  {\n    name: 'rank',\n    description: 'View your rank or another user\\'s rank',\n    options: [\n      { name: 'user', description: 'User to check', type: 'user', required: false },\n    ],\n    actions: [\n      {\n        action: 'set',\n        key: 'targetUser',\n        value: '${args.user || user}',\n      },\n      {\n        action: 'db_query',\n        table: 'levels',\n        where: {\n          user_id: '${targetUser.id}',\n          guild_id: '${guild.id}',\n        },\n        as: 'userData',\n      },\n      {\n        action: 'flow_if',\n        condition: '${!userData || userData.length === 0}',\n        then: [\n          {\n            action: 'reply',\n            content: '${targetUser.username} has no XP yet!',\n            ephemeral: true,\n          },\n        ],\n        else: [\n          // Get leaderboard position\n          {\n            action: 'db_query',\n            table: 'levels',\n            where: {\n              guild_id: '${guild.id}',\n            },\n            order_by: 'level DESC, xp DESC',\n            as: 'leaderboard',\n          },\n          {\n            action: 'set',\n            key: 'rank',\n            value: '${(leaderboard | findIndex(u => u.user_id === targetUser.id)) + 1}',\n          },\n          {\n            action: 'set',\n            key: 'xpForNextLevel',\n            value: '${config.leveling.xpCurve === \"exponential\" ? floor((config.leveling.baseXP || 100) * pow(config.leveling.xpMultiplier || 1.5, userData[0].level)) : (config.leveling.baseXP || 100) * (userData[0].level + 1)}',\n          },\n          // Render rank card or embed\n          {\n            action: 'flow_if',\n            condition: '${config.leveling.useRankCard}',\n            then: [\n              {\n                action: 'canvas_render',\n                generator: '${config.leveling.rankCardGenerator || \"rank_card\"}',\n                context: {\n                  user: '${targetUser}',\n                  member: '${guild.members.cache.get(targetUser.id)}',\n                  level: '${userData[0].level}',\n                  xp: '${userData[0].xp}',\n                  xpNeeded: '${xpForNextLevel}',\n                  rank: '${rank}',\n                  totalMessages: '${userData[0].total_messages}',\n                },\n                as: 'rankCard',\n              },\n              {\n                action: 'reply',\n                files: [\n                  {\n                    attachment: '${rankCard}',\n                    name: 'rank.png',\n                  },\n                ],\n              },\n            ],\n            else: [\n              {\n                action: 'reply',\n                embed: {\n                  title: '${targetUser.username}\\'s Rank',\n                  color: '#5865f2',\n                  thumbnail: '${targetUser.avatarURL}',\n                  fields: [\n                    { name: 'Rank', value: '#${rank}', inline: true },\n                    { name: 'Level', value: '${userData[0].level}', inline: true },\n                    { name: 'XP', value: '${userData[0].xp}/${xpForNextLevel}', inline: true },\n                    { name: 'Messages', value: '${userData[0].total_messages}', inline: true },\n                  ],\n                },\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  },\n  {\n    name: 'leaderboard',\n    description: 'View the server leaderboard',\n    options: [\n      { name: 'page', description: 'Page number', type: 'integer', required: false },\n    ],\n    actions: [\n      {\n        action: 'set',\n        key: 'page',\n        value: '${args.page || 1}',\n      },\n      {\n        action: 'set',\n        key: 'perPage',\n        value: 10,\n      },\n      {\n        action: 'db_query',\n        table: 'levels',\n        where: {\n          guild_id: '${guild.id}',\n        },\n        order_by: 'level DESC, xp DESC',\n        limit: '${perPage}',\n        offset: '${(page - 1) * perPage}',\n        as: 'leaderboard',\n      },\n      {\n        action: 'set',\n        key: 'leaderboardText',\n        value: '${leaderboard | mapIndex((entry, i) => \"#\" + ((page - 1) * perPage + i + 1) + \" <@\" + entry.user_id + \"> - Level \" + entry.level + \" (\" + entry.xp + \" XP)\") | join(\"\\\\n\")}',\n      },\n      {\n        action: 'reply',\n        embed: {\n          title: '${guild.name} Leaderboard',\n          description: '${leaderboardText || \"No entries yet!\"}',\n          color: '#ffd700',\n          footer: {\n            text: 'Page ${page}',\n          },\n        },\n      },\n    ],\n  },\n  {\n    name: 'setxp',\n    description: 'Set a user\\'s XP (admin)',\n    options: [\n      { name: 'user', description: 'User to modify', type: 'user', required: true },\n      { name: 'xp', description: 'XP amount', type: 'integer', required: true },\n    ],\n    actions: [\n      {\n        action: 'db_update',\n        table: 'levels',\n        where: {\n          user_id: '${args.user.id}',\n          guild_id: '${guild.id}',\n        },\n        data: {\n          xp: '${args.xp}',\n        },\n        upsert: true,\n      },\n      {\n        action: 'reply',\n        content: 'Set ${args.user.username}\\'s XP to ${args.xp}',\n        ephemeral: true,\n      },\n    ],\n  },\n  {\n    name: 'setlevel',\n    description: 'Set a user\\'s level (admin)',\n    options: [\n      { name: 'user', description: 'User to modify', type: 'user', required: true },\n      { name: 'level', description: 'Level', type: 'integer', required: true },\n    ],\n    actions: [\n      {\n        action: 'db_update',\n        table: 'levels',\n        where: {\n          user_id: '${args.user.id}',\n          guild_id: '${guild.id}',\n        },\n        data: {\n          level: '${args.level}',\n          xp: 0,\n        },\n        upsert: true,\n      },\n      {\n        action: 'reply',\n        content: 'Set ${args.user.username}\\'s level to ${args.level}',\n        ephemeral: true,\n      },\n    ],\n  },\n];\n\nexport const levelingCanvasGenerators: Record<string, CanvasGenerator> = {\n  rank_card: {\n    width: 934,\n    height: 282,\n    background: '#23272a',\n    layers: [\n      // Background gradient\n      {\n        type: 'rect',\n        x: 0,\n        y: 0,\n        width: 934,\n        height: 282,\n        color: 'linear-gradient(135deg, #1a1c20 0%, #2c2f33 100%)',\n        radius: 20,\n      },\n      // User avatar\n      {\n        type: 'circle_image',\n        url: '${user.avatarURL || user.defaultAvatarURL}',\n        x: 120,\n        y: 141,\n        radius: 80,\n        border: {\n          width: 5,\n          color: '#5865f2',\n        },\n      },\n      // Username\n      {\n        type: 'text',\n        text: '${user.username}',\n        x: 260,\n        y: 120,\n        font: 'bold 36px \"Poppins\", sans-serif',\n        color: '#ffffff',\n        align: 'left',\n      },\n      // Rank badge\n      {\n        type: 'text',\n        text: 'RANK #${rank}',\n        x: 850,\n        y: 60,\n        font: 'bold 24px \"Poppins\", sans-serif',\n        color: '#7289da',\n        align: 'right',\n      },\n      // Level badge\n      {\n        type: 'text',\n        text: 'LEVEL ${level}',\n        x: 850,\n        y: 90,\n        font: 'bold 32px \"Poppins\", sans-serif',\n        color: '#ffffff',\n        align: 'right',\n      },\n      // XP Progress bar background\n      {\n        type: 'rect',\n        x: 260,\n        y: 180,\n        width: 600,\n        height: 30,\n        color: '#484b4e',\n        radius: 15,\n      },\n      // XP Progress bar fill\n      {\n        type: 'progress_bar',\n        x: 260,\n        y: 180,\n        width: 600,\n        height: 30,\n        progress: '${xp / xpNeeded}',\n        color: 'linear-gradient(90deg, #5865f2 0%, #7289da 100%)',\n        radius: 15,\n      },\n      // XP Text\n      {\n        type: 'text',\n        text: '${xp} / ${xpNeeded} XP',\n        x: 560,\n        y: 160,\n        font: '18px \"Poppins\", sans-serif',\n        color: '#99aab5',\n        align: 'center',\n      },\n      // Messages count\n      {\n        type: 'text',\n        text: '${totalMessages} messages',\n        x: 260,\n        y: 240,\n        font: '16px \"Poppins\", sans-serif',\n        color: '#72767d',\n        align: 'left',\n      },\n    ],\n  },\n};\n\nexport function getLevelingSpec(config: LevelingConfig = {}): Partial<FurlowSpec> {\n  return {\n    events: levelingEventHandlers,\n    commands: levelingCommands,\n    state: {\n      tables: levelingTables,\n    },\n    canvas: {\n      generators: levelingCanvasGenerators,\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/logging/index.d.ts

@@ -0,0 +1,52 @@
+import { FurlowSpec, CommandDefinition, EventHandler } from '@furlow/schema';
+
+/**
+ * Logging builtin module
+ * Handles comprehensive server logging for messages, members, voice, and moderation
+ */
+
+interface LoggingConfig {
+    /** Default log channel */
+    channel?: string;
+    /** Separate channels per category */
+    channels?: {
+        messages?: string;
+        members?: string;
+        voice?: string;
+        server?: string;
+        moderation?: string;
+    };
+    /** Ignored channels */
+    ignoredChannels?: string[];
+    /** Ignored roles (users with these roles won't be logged) */
+    ignoredRoles?: string[];
+    /** Events to log */
+    events?: {
+        messageDelete?: boolean;
+        messageEdit?: boolean;
+        messageBulkDelete?: boolean;
+        memberJoin?: boolean;
+        memberLeave?: boolean;
+        memberUpdate?: boolean;
+        memberBan?: boolean;
+        memberUnban?: boolean;
+        voiceJoin?: boolean;
+        voiceLeave?: boolean;
+        voiceMove?: boolean;
+        channelCreate?: boolean;
+        channelDelete?: boolean;
+        channelUpdate?: boolean;
+        roleCreate?: boolean;
+        roleDelete?: boolean;
+        roleUpdate?: boolean;
+        inviteCreate?: boolean;
+        inviteDelete?: boolean;
+    };
+    /** Include images in logs */
+    includeImages?: boolean;
+}
+declare const loggingEventHandlers: EventHandler[];
+declare const loggingCommands: CommandDefinition[];
+declare function getLoggingSpec(config?: LoggingConfig): Partial<FurlowSpec>;
+
+export { type LoggingConfig, getLoggingSpec, loggingCommands, loggingEventHandlers };