popii-framework 0.6.1-beta.0

package/dist/loader/fizz.d.ts

@@ -0,0 +1,2 @@
+export declare function loadFizz(baseDir: string): Promise<Map<string, Function>>;
+//# sourceMappingURL=fizz.d.ts.map

package/dist/loader/fizz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fizz.d.ts","sourceRoot":"","sources":["../../src/loader/fizz.ts"],"names":[],"mappings":"AAKA,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAsC9E"}

package/dist/loader/index.d.ts

@@ -0,0 +1,3 @@
+import type { PopiiCommandDefinition } from "../types";
+export declare function loadCommands(baseDir: string, useFolderRouting?: boolean): Promise<Map<string, PopiiCommandDefinition>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/loader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AA6BvD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,UAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAiIzH"}

package/dist/loader/locales.d.ts

@@ -0,0 +1,2 @@
+export declare function loadLocales(baseDir: string): Promise<Map<string, Record<string, string>>>;
+//# sourceMappingURL=locales.d.ts.map

package/dist/loader/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/loader/locales.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAkB/F"}

package/dist/loader/middleware.d.ts

@@ -0,0 +1,54 @@
+import type { PopiiMiddleware } from "../types";
+export declare function loadMiddlewares(baseDir: string): Promise<PopiiMiddleware[]>;
+/**
+ * Wraps a middleware function with strict TypeScript types.
+ *
+ * Middlewares run before every command and snap handler in the order they are
+ * loaded from `src/middlewares/` (alphabetically). Use them for auth checks,
+ * logging, injecting data into `pop.locals`, and other cross-cutting concerns.
+ *
+ * **Regular middleware** — `(pop, next)` — must call `next()` to continue the pipeline.
+ * **Error middleware** — `(err, pop, next)` — only runs when an earlier step throws.
+ * Popii detects error middlewares by function arity (`function.length === 3`).
+ * Always declare all three parameters explicitly.
+ *
+ * @category Core API
+ *
+ * @example Inject a database user into pop.locals
+ * ```ts
+ * // src/middlewares/01-load-user.ts
+ * import { middleware } from "popii";
+ *
+ * export default middleware(async (pop, next) => {
+ *   const db = (pop.client as any).db;
+ *   pop.locals.dbUser = db.query("SELECT * FROM users WHERE id = ?").get(pop.user.id)
+ *     ?? { id: pop.user.id, balance: 0, premium: false };
+ *   await next();
+ * });
+ * ```
+ *
+ * @example Block execution early (maintenance mode)
+ * ```ts
+ * import { middleware } from "popii";
+ *
+ * export default middleware(async (pop, next) => {
+ *   if (process.env.MAINTENANCE === "true") {
+ *     await pop.reply({ content: "The bot is under maintenance.", ephemeral: true });
+ *     return; // do NOT call next()
+ *   }
+ *   await next();
+ * });
+ * ```
+ *
+ * @example Error-handling middleware (three explicit parameters required)
+ * ```ts
+ * import { middleware } from "popii";
+ *
+ * export default middleware(async (err, pop, next) => {
+ *   pop.log.error("Unhandled command error:", err);
+ *   await pop.reply({ content: "Something went wrong.", ephemeral: true }).catch(() => {});
+ * });
+ * ```
+ */
+export declare function middleware<TState = any>(mw: PopiiMiddleware<TState>): PopiiMiddleware<TState>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/loader/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/loader/middleware.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAwBjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAE7F"}

package/dist/loader/snaps.d.ts

@@ -0,0 +1,3 @@
+import type { PopiiComponentDefinition } from "../types";
+export declare function loadSnaps(baseDir: string): Promise<Map<string | RegExp, PopiiComponentDefinition>>;
+//# sourceMappingURL=snaps.d.ts.map

package/dist/loader/snaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snaps.d.ts","sourceRoot":"","sources":["../../src/loader/snaps.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,wBAAwB,CAAC,CAAC,CA6CxG"}

package/dist/loader/tasks.d.ts

@@ -0,0 +1,3 @@
+import type { PopiiTaskDefinition } from "../types";
+export declare function loadTasks(baseDir: string): Promise<Map<string, PopiiTaskDefinition>>;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/loader/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/loader/tasks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CA0B1F"}

package/dist/plugins/activity.d.ts

@@ -0,0 +1,15 @@
+import { ActivityType } from "discord.js";
+import type { PopiiPlugin } from "../types";
+export interface ActivityRotatorOptions {
+    intervalMs?: number;
+    activities: {
+        name: string;
+        type: ActivityType;
+    }[];
+}
+/**
+ * Automatically rotates the bot's rich presence status on a set interval.
+ * @category Plugins
+ */
+export declare function activityRotatorPlugin(options: ActivityRotatorOptions): PopiiPlugin;
+//# sourceMappingURL=activity.d.ts.map

package/dist/plugins/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/plugins/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAA;KAAE,EAAE,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,WAAW,CAkBlF"}

package/dist/plugins/ai.d.ts

@@ -0,0 +1,35 @@
+import type { PopiiPlugin } from "../types";
+declare module "../types" {
+    interface Pop {
+        ai: {
+            generate(prompt: string): Promise<string>;
+            chat(history: {
+                role: "system" | "user" | "assistant";
+                content: string;
+            }[]): Promise<string>;
+        };
+    }
+    interface EventPop {
+        ai: {
+            generate(prompt: string): Promise<string>;
+            chat(history: {
+                role: "system" | "user" | "assistant";
+                content: string;
+            }[]): Promise<string>;
+        };
+    }
+}
+export interface PopiiAiOptions {
+    provider: "openai" | "gemini" | "anthropic";
+    apiKey: string;
+    model?: string;
+    systemPrompt?: string;
+    locale?: string;
+}
+/**
+ * Injects a powerful AI assistant using OpenAI or Google Gemini into the Pop context.
+ *
+ * @category Plugins
+ */
+export declare function popiiAiPlugin(options: PopiiAiOptions): PopiiPlugin;
+//# sourceMappingURL=ai.d.ts.map

package/dist/plugins/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/plugins/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,EAAE,EAAE;YACF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,EAAE;gBAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;SAC9F,CAAC;KACH;IACD,UAAU,QAAQ;QAChB,EAAE,EAAE;YACF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,EAAE;gBAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;SAC9F,CAAC;KACH;CACF;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CA2GlE"}

package/dist/plugins/automod.d.ts

@@ -0,0 +1,12 @@
+import type { PopiiPlugin } from "../types";
+export interface AutoModOptions {
+    action?: "delete" | "warn" | "both";
+    toxicityThreshold?: number;
+    spamThreshold?: number;
+    /** Max AI analysis calls per guild per minute. Defaults to 10. */
+    maxChecksPerMinute?: number;
+    /** Max AI analysis calls per user per minute. Defaults to 3. */
+    maxChecksPerUserPerMinute?: number;
+}
+export declare function autoModPlugin(options?: AutoModOptions): PopiiPlugin;
+//# sourceMappingURL=automod.d.ts.map

package/dist/plugins/automod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automod.d.ts","sourceRoot":"","sources":["../../src/plugins/automod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAGzD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAgBD,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,WAAW,CA4FvE"}

package/dist/plugins/canvas.d.ts

@@ -0,0 +1,75 @@
+import type { PopiiPlugin } from "../types";
+import { AttachmentBuilder } from "discord.js";
+export interface NowPlayingTrack {
+    title: string;
+    artist?: string;
+    duration?: string;
+    elapsed?: string;
+    progress?: number;
+    thumbnail?: string;
+    requestedBy?: string;
+}
+export interface NowPlayingCardOptions {
+    width?: number;
+    height?: number;
+    accentColor?: string;
+}
+declare module "../types" {
+    interface Pop {
+        canvas: {
+            create(width: number, height: number): Promise<CanvasBuilder>;
+            nowPlayingCard(track: NowPlayingTrack, opts?: NowPlayingCardOptions): Promise<AttachmentBuilder>;
+        };
+    }
+}
+/**
+ * Fluent canvas builder — wraps a 2D context with chainable drawing methods.
+ */
+export declare class CanvasBuilder {
+    private _canvas;
+    private _ctx;
+    constructor(_canvas: any, _ctx: any);
+    fill(color: string): this;
+    rect(x: number, y: number, w: number, h: number, color: string, radius?: number): this;
+    outline(x: number, y: number, w: number, h: number, color: string, lineWidth?: number, radius?: number): this;
+    text(str: string, x: number, y: number, opts?: {
+        color?: string;
+        font?: string;
+        size?: number;
+        weight?: string;
+        align?: CanvasTextAlign;
+        baseline?: CanvasTextBaseline;
+        maxWidth?: number;
+        shadow?: {
+            color: string;
+            blur: number;
+            offsetX?: number;
+            offsetY?: number;
+        };
+    }): this;
+    /** Draws a string truncated with "…" to fit within maxWidth. Returns the string actually drawn. */
+    textTruncated(str: string, x: number, y: number, maxWidth: number, opts?: Parameters<CanvasBuilder["text"]>[3]): this;
+    image(src: string | Buffer, x: number, y: number, w: number, h: number, opts?: {
+        radius?: number;
+        opacity?: number;
+        filter?: string;
+    }): Promise<this>;
+    gradient(x: number, y: number, w: number, h: number, stops: {
+        offset: number;
+        color: string;
+    }[], direction?: "h" | "v"): this;
+    circle(cx: number, cy: number, r: number, color: string): this;
+    line(x1: number, y1: number, x2: number, y2: number, color: string, lineWidth?: number): this;
+    save(): this;
+    restore(): this;
+    /** Returns the raw CanvasRenderingContext2D for custom operations. */
+    raw(): any;
+    toBuffer(): Promise<Buffer>;
+    toAttachment(name?: string): Promise<AttachmentBuilder>;
+}
+/**
+ * Provides `pop.canvas` — a fluent image generation API backed by @napi-rs/canvas.
+ * @category Plugins
+ */
+export declare function canvasPlugin(): PopiiPlugin;
+//# sourceMappingURL=canvas.d.ts.map

package/dist/plugins/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/plugins/canvas.ts"],"names":[],"mappings":"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"}

package/dist/plugins/captcha.d.ts

@@ -0,0 +1,20 @@
+import type { PopiiPlugin } from "../types";
+export interface CaptchaPluginOptions {
+    siteKey: string;
+    secretKey: string;
+    port?: number;
+    publicUrl?: string;
+}
+declare module "../types" {
+    interface Pop {
+        captcha: {
+            sendVerificationPanel(channelId: string): Promise<void>;
+        };
+    }
+}
+/**
+ * Injects a web-based CAPTCHA gate to securely verify members.
+ * @category Plugins
+ */
+export declare function captchaPlugin(options: CaptchaPluginOptions): PopiiPlugin;
+//# sourceMappingURL=captcha.d.ts.map

package/dist/plugins/captcha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captcha.d.ts","sourceRoot":"","sources":["../../src/plugins/captcha.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAGzD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,OAAO,EAAE;YACP,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SACzD,CAAC;KACH;CACF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAwExE"}

package/dist/plugins/commandAnalytic.d.ts

@@ -0,0 +1,8 @@
+import type { PopiiPlugin } from "../types";
+/**
+ * Tracks command usage statistics and prints a summary on cleanup.
+ *
+ * @category Plugins
+ */
+export declare function commandAnalyticPlugin(): PopiiPlugin;
+//# sourceMappingURL=commandAnalytic.d.ts.map

package/dist/plugins/commandAnalytic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandAnalytic.d.ts","sourceRoot":"","sources":["../../src/plugins/commandAnalytic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAkCnD"}

package/dist/plugins/commandLogger.d.ts

@@ -0,0 +1,13 @@
+import type { PopiiPlugin } from "../types";
+export interface CommandLoggerOptions {
+    logExecution?: boolean;
+    logCompletion?: boolean;
+    logErrors?: boolean;
+}
+/**
+ * Logs execution, completion, and errors for all commands.
+ *
+ * @category Plugins
+ */
+export declare function commandLoggerPlugin(options?: CommandLoggerOptions): PopiiPlugin;
+//# sourceMappingURL=commandLogger.d.ts.map

package/dist/plugins/commandLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandLogger.d.ts","sourceRoot":"","sources":["../../src/plugins/commandLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,CAoCnF"}

package/dist/plugins/desk.d.ts

@@ -0,0 +1,23 @@
+import type { PopiiPlugin } from "../types";
+declare module "../types" {
+    interface Pop {
+        desk: {
+            sendPanel(channelId: string): Promise<void>;
+            closeTicket(): Promise<void>;
+        };
+    }
+}
+export interface PopiiDeskOptions {
+    categoryId?: string;
+    supportRoleId?: string;
+    panelTitle?: string;
+    panelMessage?: string;
+    transcriptChannelId?: string;
+}
+/**
+ * Installs "Popii Desk", a built-in interactive Ticket Support system.
+ *
+ * @category Plugins
+ */
+export declare function deskPlugin(options?: PopiiDeskOptions): PopiiPlugin;
+//# sourceMappingURL=desk.d.ts.map

package/dist/plugins/desk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desk.d.ts","sourceRoot":"","sources":["../../src/plugins/desk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,IAAI,EAAE;YACJ,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;SAC9B,CAAC;KACH;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAwQtE"}

package/dist/plugins/economy.d.ts

@@ -0,0 +1,41 @@
+import type { PopiiPlugin } from "../types";
+export interface EconomyPluginOptions {
+    xpPerMessage?: number | [number, number];
+    cooldownMs?: number;
+    currencyName?: string;
+    onLevelUp?: (userId: string, newLevel: number, msg: import("discord.js").Message) => void | Promise<void>;
+}
+declare module "../types" {
+    interface Pop {
+        economy: {
+            currencyName: string;
+            getProfile(userId: string): Promise<{
+                xp: number;
+                level: number;
+                balance: number;
+                last_daily: number;
+            } | null>;
+            addXp(userId: string, amount: number): Promise<boolean>;
+            addBalance(userId: string, amount: number): Promise<void>;
+        };
+    }
+    interface EventPop {
+        economy: {
+            currencyName: string;
+            getProfile(userId: string): Promise<{
+                xp: number;
+                level: number;
+                balance: number;
+                last_daily: number;
+            } | null>;
+            addXp(userId: string, amount: number): Promise<boolean>;
+            addBalance(userId: string, amount: number): Promise<void>;
+        };
+    }
+}
+/**
+ * Injects a powerful Economy and Leveling system into the bot.
+ * @category Plugins
+ */
+export declare function economyPlugin(options?: EconomyPluginOptions): PopiiPlugin;
+//# sourceMappingURL=economy.d.ts.map

package/dist/plugins/economy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"economy.d.ts","sourceRoot":"","sources":["../../src/plugins/economy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,YAAY,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3G;AAED,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,OAAO,EAAE;YACP,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC,CAAC;YAC/G,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YACxD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SAC3D,CAAC;KACH;IACD,UAAU,QAAQ;QAChB,OAAO,EAAE;YACP,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC,CAAC;YAC/G,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YACxD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SAC3D,CAAC;KACH;CACF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,CAuI7E"}

package/dist/plugins/errorHandler.d.ts

@@ -0,0 +1,8 @@
+import type { PopiiPlugin } from "../types";
+/**
+ * Gracefully catches and handles PopiiErrors and unexpected exceptions.
+ *
+ * @category Plugins
+ */
+export declare function errorHandlerPlugin(): PopiiPlugin;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/plugins/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/plugins/errorHandler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAuChD"}

package/dist/plugins/giveaway.d.ts

@@ -0,0 +1,21 @@
+import type { PopiiPlugin } from "../types";
+export interface GiveawayPluginOptions {
+}
+declare module "../types" {
+    interface Pop {
+        giveaways: {
+            start(channelId: string, prize: string, winners: number, durationMs: number): Promise<void>;
+        };
+    }
+    interface EventPop {
+        giveaways: {
+            start(channelId: string, prize: string, winners: number, durationMs: number): Promise<void>;
+        };
+    }
+}
+/**
+ * Injects a robust Giveaway manager into the bot.
+ * @category Plugins
+ */
+export declare function giveawayPlugin(options?: GiveawayPluginOptions): PopiiPlugin;
+//# sourceMappingURL=giveaway.d.ts.map

package/dist/plugins/giveaway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"giveaway.d.ts","sourceRoot":"","sources":["../../src/plugins/giveaway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,qBAAqB;CAAG;AAEzC,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,SAAS,EAAE;YACT,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SAC7F,CAAC;KACH;IACD,UAAU,QAAQ;QAChB,SAAS,EAAE;YACT,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SAC7F,CAAC;KACH;CACF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,WAAW,CAyG/E"}

package/dist/plugins/lastfm.d.ts

@@ -0,0 +1,24 @@
+import type { PopiiPlugin } from "../types";
+declare module "../types" {
+    interface Pop {
+        lastfm: {
+            getAccount(userId: string): Promise<{
+                username: string;
+                sessionKey: string;
+            } | null>;
+        };
+    }
+}
+export interface PopiiLastFmOptions {
+    apiKey: string;
+    apiSecret: string;
+    scrobble?: boolean;
+    nowPlaying?: boolean;
+}
+/**
+ * Integrates Last.fm scrobbling and stats into the bot and dashboard.
+ *
+ * @category Plugins
+ */
+export declare function lastFmPlugin(options: PopiiLastFmOptions): PopiiPlugin;
+//# sourceMappingURL=lastfm.d.ts.map

package/dist/plugins/lastfm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lastfm.d.ts","sourceRoot":"","sources":["../../src/plugins/lastfm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAKzD,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,MAAM,EAAE;YACN,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC,CAAC;SACtF,CAAC;KACH;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA+DD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAsarE"}

package/dist/plugins/mongoose.d.ts

@@ -0,0 +1,23 @@
+import type mongoose from "mongoose";
+import type { PopiiPlugin } from "../types";
+declare module "../types" {
+    interface Pop {
+        mongoose: typeof mongoose;
+    }
+    interface EventPop {
+        mongoose: typeof mongoose;
+    }
+    interface PopiiClient {
+        mongoose: typeof mongoose;
+    }
+}
+export interface MongoosePluginOptions extends mongoose.ConnectOptions {
+    uri: string;
+}
+/**
+ * Injects a Mongoose database instance into the Pop context.
+ *
+ * @category Plugins
+ */
+export declare function mongoosePlugin(options: MongoosePluginOptions): PopiiPlugin;
+//# sourceMappingURL=mongoose.d.ts.map

package/dist/plugins/mongoose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose.d.ts","sourceRoot":"","sources":["../../src/plugins/mongoose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,QAAQ,EAAE,OAAO,QAAQ,CAAC;KAC3B;IACD,UAAU,QAAQ;QAChB,QAAQ,EAAE,OAAO,QAAQ,CAAC;KAC3B;IACD,UAAU,WAAW;QACnB,QAAQ,EAAE,OAAO,QAAQ,CAAC;KAC3B;CACF;AAED,MAAM,WAAW,qBAAsB,SAAQ,QAAQ,CAAC,cAAc;IACpE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,WAAW,CA8B1E"}

package/dist/plugins/pay.d.ts

@@ -0,0 +1,24 @@
+import type { PopiiPlugin, PopiiClient } from "../types";
+export interface PopiiPayOptions {
+    patreon?: {
+        webhookSecret: string;
+        port?: number;
+        path?: string;
+        onPledgeCreate?: (data: any, client: PopiiClient) => void | Promise<void>;
+        onPledgeUpdate?: (data: any, client: PopiiClient) => void | Promise<void>;
+        onPledgeDelete?: (data: any, client: PopiiClient) => void | Promise<void>;
+    };
+    kofi?: {
+        verificationToken: string;
+        port?: number;
+        path?: string;
+        onPayment?: (data: any, client: PopiiClient) => void | Promise<void>;
+    };
+}
+/**
+ * Integrates Patreon and Ko-fi monetization natively via secure Webhooks.
+ *
+ * @category Plugins
+ */
+export declare function payPlugin(options: PopiiPayOptions): PopiiPlugin;
+//# sourceMappingURL=pay.d.ts.map

package/dist/plugins/pay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pay.d.ts","sourceRoot":"","sources":["../../src/plugins/pay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1E,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1E,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3E,CAAC;IACF,IAAI,CAAC,EAAE;QACL,iBAAiB,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtE,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CA2G/D"}

package/dist/plugins/permissionGuard.d.ts

@@ -0,0 +1,8 @@
+import type { PopiiPlugin } from "../types";
+/**
+ * Enforces permission checks for commands and components automatically.
+ *
+ * @category Plugins
+ */
+export declare function permissionGuardPlugin(): PopiiPlugin;
+//# sourceMappingURL=permissionGuard.d.ts.map

package/dist/plugins/permissionGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionGuard.d.ts","sourceRoot":"","sources":["../../src/plugins/permissionGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAIzD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAmDnD"}

package/dist/plugins/reload.d.ts

@@ -0,0 +1,8 @@
+import type { PopiiPlugin } from "../types";
+/**
+ * Adds a /reload command to gracefully reload all commands and events at runtime.
+ *
+ * @category Plugins
+ */
+export declare function reloadPlugin(): PopiiPlugin;
+//# sourceMappingURL=reload.d.ts.map

package/dist/plugins/reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.d.ts","sourceRoot":"","sources":["../../src/plugins/reload.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,UAAU,CAAC;AAEjF;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,WAAW,CAsE1C"}

package/dist/plugins/sqlite.d.ts

@@ -0,0 +1,20 @@
+import { Database } from "bun:sqlite";
+import type { PopiiPlugin } from "../types";
+declare module "../types" {
+    interface Pop {
+        db: Database;
+    }
+    interface EventPop {
+        db: Database;
+    }
+}
+export interface SQLitePluginOptions {
+    filename?: string;
+}
+/**
+ * Injects a blazing fast Bun SQLite database instance into the Pop context.
+ *
+ * @category Plugins
+ */
+export declare function sqlitePlugin(options?: SQLitePluginOptions): PopiiPlugin;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/plugins/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/plugins/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,GAAG;QACX,EAAE,EAAE,QAAQ,CAAC;KACd;IACD,UAAU,QAAQ;QAChB,EAAE,EAAE,QAAQ,CAAC;KACd;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,WAAW,CAqB3E"}

package/dist/plugins/telemetry.d.ts

@@ -0,0 +1,11 @@
+import type { PopiiPlugin } from "../types";
+export interface TelemetryPluginOptions {
+    onCapture?: (error: Error, context: any) => void | Promise<void>;
+}
+/**
+ * Injects telemetry to capture rich context for errors.
+ *
+ * @category Plugins
+ */
+export declare function telemetryPlugin(options?: TelemetryPluginOptions): PopiiPlugin;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/plugins/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/plugins/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,CAqCjF"}