bun_plugins 1.2.6 → 1.2.7

package/dist/examples/logger-simple.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Simple Logger Example
+ *
+ * This example demonstrates how to use custom loggers with the simplified system
+ */
+declare const runLoggerDemo: () => Promise<void>;
+export { runLoggerDemo };
+//# sourceMappingURL=logger-simple.d.ts.map

package/dist/examples/logger-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-simple.d.ts","sourceRoot":"","sources":["../../examples/logger-simple.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgLH,QAAA,MAAM,aAAa,qBAalB,CAAC;AAGF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/examples/logger-simple.js

@@ -0,0 +1,165 @@
+/**
+ * Simple Logger Example
+ *
+ * This example demonstrates how to use custom loggers with the simplified system
+ */
+import { logger, NoopLogger, ColorfulConsoleLogger } from "../src";
+// Example 1: Using the default colorful console logger
+const demoDefaultLogger = () => {
+    console.log("\n=== Default Colorful Console Logger ===");
+    const log = logger.getDefaultLogger();
+    log.info("This is an info message");
+    log.warn("This is a warning message");
+    log.error("This is an error message");
+    log.debug?.("This is a debug message"); // Optional debug method
+};
+// Example 1b: Using basic console logger without colors
+const demoBasicConsoleLogger = () => {
+    console.log("\n=== Basic Console Logger (No Colors) ===");
+    // Create a basic console logger without colors
+    const basicLogger = logger.createConsoleLogger({ useColors: false });
+    logger.setDefaultLogger(basicLogger);
+    const log = logger.getDefaultLogger();
+    log.info("This is a basic info message");
+    log.warn("This is a basic warning message");
+    log.error("This is a basic error message");
+    log.debug?.("This is a basic debug message");
+};
+// Example 2: Using a custom logger (simulating Winston/Pino style)
+const demoCustomLogger = () => {
+    console.log("\n=== Custom Logger (Winston/Pino style) ===");
+    // Create a custom logger that follows the Logger interface
+    const customLogger = {
+        info: (msg, ...args) => {
+            console.log(`[CUSTOM] ${new Date().toISOString()} INFO: ${msg}`, ...args);
+        },
+        warn: (msg, ...args) => {
+            console.log(`[CUSTOM] ${new Date().toISOString()} WARN: ${msg}`, ...args);
+        },
+        error: (msg, ...args) => {
+            console.log(`[CUSTOM] ${new Date().toISOString()} ERROR: ${msg}`, ...args);
+        },
+        debug: (msg, ...args) => {
+            console.log(`[CUSTOM] ${new Date().toISOString()} DEBUG: ${msg}`, ...args);
+        }
+    };
+    // Set it as the default logger
+    logger.setDefaultLogger(customLogger);
+    // Use it
+    const log = logger.getDefaultLogger();
+    log.info("Custom logger info message");
+    log.warn("Custom logger warning message");
+    log.error("Custom logger error message");
+    log.debug?.("Custom logger debug message");
+};
+// Example 3: Plugin-specific loggers with context and colors
+const demoPluginLoggers = () => {
+    console.log("\n=== Plugin-specific Colorful Loggers ===");
+    // Reset to colorful console logger
+    logger.setDefaultLogger(new ColorfulConsoleLogger());
+    // Create loggers for different plugins
+    const dbLogger = logger.createLogger("database");
+    const apiLogger = logger.createLogger("api");
+    const authLogger = logger.createLogger("auth");
+    dbLogger.info("Connected to database");
+    dbLogger.debug?.("Query executed in 150ms");
+    apiLogger.info("API server started on port 3000");
+    apiLogger.warn("High response time detected");
+    authLogger.info("User authentication successful");
+    authLogger.error("Invalid credentials provided");
+};
+// Example 4: Using no-op logger to disable logging
+const demoNoopLogger = () => {
+    console.log("\n=== No-op Logger (disabled logging) ===");
+    const noopLog = new NoopLogger();
+    logger.setDefaultLogger(noopLog);
+    const log = logger.getDefaultLogger();
+    log.info("This won't be shown");
+    log.error("Neither will this error");
+    log.warn("This warning is also ignored");
+    console.log("But regular console.log still works");
+};
+// Example 5: Wrapping existing loggers
+const demoWrapLogger = () => {
+    console.log("\n=== Wrapping Existing Loggers ===");
+    // Simulate an existing logger from another library
+    const existingLogger = {
+        log: (level, message) => {
+            console.log(`[EXTERNAL] ${level.toUpperCase()}: ${message}`);
+        }
+    };
+    // Create a wrapper that implements our Logger interface
+    const wrappedLogger = {
+        info: (msg) => existingLogger.log('info', msg),
+        warn: (msg) => existingLogger.log('warn', msg),
+        error: (msg) => existingLogger.log('error', msg),
+        child: (context) => wrappedLogger // Simple child implementation
+    };
+    // Wrap it with our adapter for context support
+    const adaptedLogger = logger.wrapLogger(wrappedLogger, "wrapped-context");
+    adaptedLogger.info("Message from wrapped logger");
+    adaptedLogger.warn("Warning from wrapped logger");
+    adaptedLogger.error("Error from wrapped logger");
+};
+// Example 6: Advanced colorful logger with custom colors
+const demoAdvancedColorfulLogger = () => {
+    console.log("\n=== Advanced Colorful Logger ===");
+    // Create a colorful logger with custom configuration
+    const colorfulLogger = logger.createColorfulConsoleLogger({
+        useColors: true,
+        timestampFormat: 'time',
+        levelColors: {
+            info: '#00FF00', // Bright green
+            warn: '#FFD700', // Gold
+            error: '#FF0000', // Red
+            debug: '#00CED1' // Dark turquoise
+        },
+        contextColor: '#FF69B4', // Hot pink
+        showEmoji: true
+    });
+    logger.setDefaultLogger(colorfulLogger);
+    const log = logger.getDefaultLogger();
+    log.info("System initialized successfully");
+    log.warn("Cache miss detected");
+    log.error("Failed to connect to external service");
+    log.debug?.("Processing request with ID: abc123");
+    // Test hierarchical logging with colors
+    const childLogger = log.child?.('submodule') || log;
+    childLogger.info("Child logger with colorful context");
+    childLogger.error("Error from child logger");
+};
+// Example 7: Color palette demonstration
+const demoColorPalette = () => {
+    console.log("\n=== Bun.color Palette Demo ===");
+    const colors = [
+        'red', 'green', 'blue', 'yellow', 'magenta', 'cyan',
+        '#FF6B6B', '#4ECDC4', '#45B7D1', '#FFA07A', '#98D8C8',
+        'rgb(255, 99, 71)', 'hsl(120, 50%, 50%)'
+    ];
+    colors.forEach(color => {
+        const ansiColor = Bun.color(color, 'ansi');
+        if (ansiColor) {
+            console.log(`${ansiColor}This text is ${color}${Bun.color('reset', 'ansi')}`);
+        }
+    });
+};
+// Main demonstration
+const runLoggerDemo = async () => {
+    console.log("🚀 Enhanced Colorful Logger Demo\n");
+    demoDefaultLogger();
+    demoBasicConsoleLogger();
+    demoCustomLogger();
+    demoPluginLoggers();
+    demoNoopLogger();
+    demoWrapLogger();
+    demoAdvancedColorfulLogger();
+    demoColorPalette();
+    console.log("\n✅ Enhanced logger demo completed!");
+};
+// Export for use
+export { runLoggerDemo };
+// Run if called directly
+if (import.meta.main) {
+    runLoggerDemo().catch(console.error);
+}
+//# sourceMappingURL=logger-simple.js.map

package/dist/examples/logger-simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-simple.js","sourceRoot":"","sources":["../../examples/logger-simple.ts"],"names":[],"mappings":"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"}

package/dist/examples/server-declarative.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Declarative Server Example
+ *
+ * A clean, declarative approach to building a plugin-powered server
+ * with minimal boilerplate and maximum clarity.
+ */
+import { PluginManager } from "../src/PluginManager";
+interface ServerConfig {
+    port: number;
+    host: string;
+    routes: RouteDefinition[];
+    middleware: MiddlewareDefinition[];
+}
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    path: string;
+    handler: string;
+    description?: string;
+}
+interface MiddlewareDefinition {
+    name: string;
+    priority: number;
+    handler: string;
+}
+declare const routes: RouteDefinition[];
+declare const createServerPlugin: () => {
+    name: string;
+    version: string;
+    description: string;
+    onLoad(context: any): Promise<void>;
+    onUnload(): Promise<void>;
+};
+declare const createDeclarativeServer: (config: ServerConfig) => {
+    pluginManager: PluginManager;
+    start(): Promise<Bun.Server<undefined>>;
+};
+declare const createActionRegistryPlugin: () => {
+    name: string;
+    version: string;
+    description: string;
+    onLoad(context: any): Promise<void>;
+    onUnload(): Promise<void>;
+};
+declare const demonstrateDeclarativeServer: () => Promise<Bun.Server<undefined>>;
+export { createDeclarativeServer, createServerPlugin, createActionRegistryPlugin, routes, demonstrateDeclarativeServer };
+//# sourceMappingURL=server-declarative.d.ts.map

package/dist/examples/server-declarative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-declarative.d.ts","sourceRoot":"","sources":["../../examples/server-declarative.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,QAAA,MAAM,MAAM,EAAE,eAAe,EAqC5B,CAAC;AAGF,QAAA,MAAM,kBAAkB;;;;oBAKA,GAAG;;CAmCzB,CAAC;AAGH,QAAA,MAAM,uBAAuB,GAAI,QAAQ,YAAY;;;CAyEpD,CAAC;AAGF,QAAA,MAAM,0BAA0B;;;;oBAKR,GAAG;;CA8BzB,CAAC;AAGH,QAAA,MAAM,4BAA4B,sCAwBjC,CAAC;AAGF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,0BAA0B,EAC1B,MAAM,EACN,4BAA4B,EAC7B,CAAC"}

package/dist/examples/server-declarative.js

@@ -0,0 +1,205 @@
+/**
+ * Declarative Server Example
+ *
+ * A clean, declarative approach to building a plugin-powered server
+ * with minimal boilerplate and maximum clarity.
+ */
+import { serve } from "bun";
+import { PluginManager } from "../src/PluginManager";
+// Declarative route definitions
+const routes = [
+    {
+        method: 'GET',
+        path: '/health',
+        handler: 'health_check',
+        description: 'Health check endpoint'
+    },
+    {
+        method: 'POST',
+        path: '/plugins',
+        handler: 'list_plugins',
+        description: 'List all loaded plugins'
+    },
+    {
+        method: 'POST',
+        path: '/plugins/register',
+        handler: 'register_plugin',
+        description: 'Register a new plugin'
+    },
+    {
+        method: 'POST',
+        path: '/plugins/unregister',
+        handler: 'unregister_plugin',
+        description: 'Unregister a plugin'
+    },
+    {
+        method: 'GET',
+        path: '/actions',
+        handler: 'list_actions',
+        description: 'List available actions'
+    },
+    {
+        method: 'POST',
+        path: '/actions/execute',
+        handler: 'execute_action',
+        description: 'Execute a specific action'
+    }
+];
+// Declarative server plugin
+const createServerPlugin = () => ({
+    name: "declarative-server",
+    version: "1.0.0",
+    description: "Server plugin with declarative route handling",
+    async onLoad(context) {
+        const { log } = context;
+        log.info("Server plugin loaded");
+        // Register server actions
+        const actions = {
+            health_check: async () => ({ status: 'healthy', timestamp: new Date().toISOString() }),
+            list_plugins: async () => context.manager.listPlugins(),
+            register_plugin: async (data) => {
+                // Plugin registration logic
+                return { success: true, plugin: data.name };
+            },
+            unregister_plugin: async (data) => {
+                // Plugin unregistration logic
+                return { success: true, plugin: data.name };
+            },
+            list_actions: async () => {
+                const registry = context.manager.getPluginApi('action-registry');
+                return registry ? registry.list() : [];
+            },
+            execute_action: async (data) => {
+                const registry = context.manager.getPluginApi('action-registry');
+                if (!registry)
+                    throw new Error('Action registry not found');
+                return registry.execute(data.action, ...data.args);
+            }
+        };
+        // Make actions available
+        context.serverActions = actions;
+        log.info("Server actions registered");
+    },
+    async onUnload() {
+        console.log("Server plugin unloaded");
+    }
+});
+// Declarative server factory
+const createDeclarativeServer = (config) => {
+    const pluginManager = new PluginManager();
+    return {
+        pluginManager,
+        async start() {
+            // Register server plugin
+            await pluginManager.register(createServerPlugin());
+            // Create and start server
+            const server = serve({
+                port: config.port,
+                hostname: config.host,
+                async fetch(req) {
+                    const url = new URL(req.url);
+                    const route = config.routes.find(r => r.method === req.method && r.path === url.pathname);
+                    if (!route) {
+                        return new Response(JSON.stringify({ error: 'Not found' }), {
+                            status: 404,
+                            headers: { 'Content-Type': 'application/json' }
+                        });
+                    }
+                    try {
+                        const serverPlugin = pluginManager.getPlugin('declarative-server');
+                        if (!serverPlugin || !serverPlugin.serverActions) {
+                            throw new Error('Server plugin not available');
+                        }
+                        const actions = serverPlugin.serverActions;
+                        const handler = actions[route.handler];
+                        if (!handler) {
+                            throw new Error(`Handler ${route.handler} not found`);
+                        }
+                        let data = {};
+                        if (req.method !== 'GET') {
+                            data = await req.json().catch(() => ({}));
+                        }
+                        const result = await handler(data);
+                        return new Response(JSON.stringify(result), {
+                            status: 200,
+                            headers: { 'Content-Type': 'application/json' }
+                        });
+                    }
+                    catch (error) {
+                        return new Response(JSON.stringify({
+                            error: error.message
+                        }), {
+                            status: 500,
+                            headers: { 'Content-Type': 'application/json' }
+                        });
+                    }
+                }
+            });
+            console.log(`🚀 Server running on http://${config.host}:${config.port}`);
+            console.log('Available endpoints:');
+            config.routes.forEach(route => {
+                console.log(`  ${route.method} ${route.path} - ${route.description}`);
+            });
+            return server;
+        }
+    };
+};
+// Action registry plugin for the server
+const createActionRegistryPlugin = () => ({
+    name: "action-registry",
+    version: "1.0.0",
+    description: "Action registry for server operations",
+    async onLoad(context) {
+        const { ActionRegistry } = await import("./shared/action-registry");
+        const registry = new ActionRegistry();
+        // Register some example actions
+        registry.register({
+            name: 'greet',
+            handler: (name) => `Hello, Hello, ${name}!`
+        });
+        registry.register({
+            name: 'calculate',
+            handler: (a, b, op) => {
+                switch (op) {
+                    case 'add': return a + b;
+                    case 'subtract': return a - b;
+                    case 'multiply': return a * b;
+                    case 'divide': return b !== 0 ? a / b : 'Error: Division by zero';
+                    default: return 'Error: Unknown operation';
+                }
+            }
+        });
+        // Register the registry as the shared API
+        context.registerApi(registry);
+    },
+    async onUnload() {
+        console.log("Action registry plugin unloaded");
+    },
+});
+// Main demonstration
+const demonstrateDeclarativeServer = async () => {
+    const config = {
+        port: 3000,
+        host: 'localhost',
+        routes: routes,
+        middleware: []
+    };
+    const server = createDeclarativeServer(config);
+    // Register action registry
+    await server.pluginManager.register(createActionRegistryPlugin());
+    // Start server
+    const instance = await server.start();
+    console.log("\n🎯 Example requests:");
+    console.log("  curl http://localhost:3000/health");
+    console.log("  curl -X POST http://localhost:3000/actions/execute -H 'Content-Type: application/json' -d '{\"action\":\"greet\",\"args\":[\"World\"]}'");
+    console.log("  curl -X POST http://localhost:3000/actions/execute -H 'Content-Type: application/json' -d '{\"action\":\"calculate\",\"args\":[10,5,\"add\"]}'");
+    console.log("\nPress Ctrl+C to stop the server");
+    return instance;
+};
+// Export for use
+export { createDeclarativeServer, createServerPlugin, createActionRegistryPlugin, routes, demonstrateDeclarativeServer };
+// Run if called directly
+if (import.meta.main) {
+    demonstrateDeclarativeServer().catch(console.error);
+}
+//# sourceMappingURL=server-declarative.js.map

package/dist/examples/server-declarative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-declarative.js","sourceRoot":"","sources":["../../examples/server-declarative.ts"],"names":[],"mappings":"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"}

package/dist/examples/shared/action-registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared Action Registry - Declarative approach
+ * Eliminates code duplication across examples
+ */
+export type ActionHandler = (...args: any[]) => any;
+export interface ActionDefinition {
+    name: string;
+    handler: ActionHandler;
+    description?: string;
+}
+export declare class ActionRegistry {
+    protected handlers: Map<string, ActionHandler>;
+    register(def: ActionDefinition): void;
+    execute(name: string, ...args: any[]): any;
+    list(): string[];
+    has(name: string): boolean;
+    clear(): void;
+}
+export declare const createActionRegistry: () => ActionRegistry;
+export declare const defineActions: (category: string, actions: ActionDefinition[]) => {
+    category: string;
+    actions: ActionDefinition[];
+    register: (registry: ActionRegistry) => void;
+};
+export declare const mathActions: {
+    category: string;
+    actions: ActionDefinition[];
+    register: (registry: ActionRegistry) => void;
+};
+export declare const textActions: {
+    category: string;
+    actions: ActionDefinition[];
+    register: (registry: ActionRegistry) => void;
+};
+export declare const utilityActions: {
+    category: string;
+    actions: ActionDefinition[];
+    register: (registry: ActionRegistry) => void;
+};
+export declare const validationActions: {
+    category: string;
+    actions: ActionDefinition[];
+    register: (registry: ActionRegistry) => void;
+};
+//# sourceMappingURL=action-registry.d.ts.map

package/dist/examples/shared/action-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-registry.d.ts","sourceRoot":"","sources":["../../../examples/shared/action-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAa;IAE3D,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAIrC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG;IAQ1C,IAAI,IAAI,MAAM,EAAE;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,IAAI,IAAI;CAGd;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAE/D,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,SAAS,gBAAgB,EAAE;;;yBAIlD,cAAc;CAItC,CAAC;AAGF,eAAO,MAAM,WAAW;;;yBAPC,cAAc;CAYrC,CAAC;AAEH,eAAO,MAAM,WAAW;;;yBAdC,cAAc;CAmBrC,CAAC;AAEH,eAAO,MAAM,cAAc;;;yBArBF,cAAc;CA4BrC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;yBA9BL,cAAc;CAmCrC,CAAC"}

package/dist/examples/shared/action-registry.js

@@ -0,0 +1,65 @@
+/**
+ * Shared Action Registry - Declarative approach
+ * Eliminates code duplication across examples
+ */
+export class ActionRegistry {
+    handlers = new Map();
+    register(def) {
+        this.handlers.set(def.name, def.handler);
+    }
+    execute(name, ...args) {
+        const handler = this.handlers.get(name);
+        if (!handler) {
+            throw new Error(`Action not found: ${name}`);
+        }
+        return handler(...args);
+    }
+    list() {
+        return Array.from(this.handlers.keys());
+    }
+    has(name) {
+        return this.handlers.has(name);
+    }
+    clear() {
+        this.handlers.clear();
+    }
+}
+// Declarative action definitions
+export const createActionRegistry = () => new ActionRegistry();
+export const defineActions = (category, actions) => {
+    return {
+        category,
+        actions,
+        register: (registry) => {
+            actions.forEach(action => registry.register(action));
+        }
+    };
+};
+// Common action categories
+export const mathActions = defineActions('math', [
+    { name: 'sum', handler: (a, b) => a + b },
+    { name: 'multiply', handler: (a, b) => a * b },
+    { name: 'power', handler: (base, exp) => Math.pow(base, exp) },
+    { name: 'sqrt', handler: (n) => Math.sqrt(n) }
+]);
+export const textActions = defineActions('text', [
+    { name: 'uppercase', handler: (text) => text.toUpperCase() },
+    { name: 'lowercase', handler: (text) => text.toLowerCase() },
+    { name: 'reverse', handler: (text) => text.split('').reverse().join('') },
+    { name: 'capitalize', handler: (text) => text.charAt(0).toUpperCase() + text.slice(1).toLowerCase() }
+]);
+export const utilityActions = defineActions('utility', [
+    { name: 'random', handler: (min, max) => Math.floor(Math.random() * (max - min + 1)) + min },
+    { name: 'timestamp', handler: () => Date.now() },
+    { name: 'delay', handler: async (ms) => {
+            await new Promise(resolve => setTimeout(resolve, ms));
+            return `Delayed ${ms}ms`;
+        } }
+]);
+export const validationActions = defineActions('validation', [
+    { name: 'isEmail', handler: (email) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email) },
+    { name: 'isNumber', handler: (value) => !isNaN(parseFloat(value)) && isFinite(value) },
+    { name: 'minLength', handler: (text, min) => text.length >= min },
+    { name: 'maxLength', handler: (text, max) => text.length <= max }
+]);
+//# sourceMappingURL=action-registry.js.map

package/dist/examples/shared/action-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-registry.js","sourceRoot":"","sources":["../../../examples/shared/action-registry.ts"],"names":[],"mappings":"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"}

package/dist/examples/shared/plugin-builder.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Declarative Plugin Builder
+ * Provides a functional approach to create plugins without boilerplate
+ */
+import type { IPlugin, PluginContext } from "../../src/types";
+export interface PluginDefinition {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    defaultConfig?: Record<string, any>;
+    actions?: any[];
+    onLoad?: (context: PluginContext) => void | Promise<void>;
+    onUnload?: () => void | Promise<void>;
+    sharedApi?: any;
+}
+export interface ActionPluginDefinition extends PluginDefinition {
+    registryName: string;
+    actionCategories?: any[];
+    customActions?: any[];
+}
+export interface StoragePluginDefinition extends PluginDefinition {
+    storageOperations?: StorageOperation[];
+}
+export interface StorageOperation {
+    type: 'get' | 'set' | 'delete' | 'clear';
+    key: string;
+    value?: any;
+    defaultValue?: any;
+    description?: string;
+}
+export declare const createPlugin: (def: PluginDefinition) => IPlugin;
+export declare const createActionPlugin: (def: ActionPluginDefinition) => IPlugin;
+export declare const storageOps: {
+    get: (key: string, defaultValue?: any) => StorageOperation;
+    set: (key: string, value: any) => StorageOperation;
+    delete: (key: string) => StorageOperation;
+    clear: () => StorageOperation;
+};
+export declare const runDemo: (name: string, demoFn: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=plugin-builder.d.ts.map

package/dist/examples/shared/plugin-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-builder.d.ts","sourceRoot":"","sources":["../../../examples/shared/plugin-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,eAAO,MAAM,YAAY,GAAI,KAAK,gBAAgB,KAAG,OAsBnD,CAAC;AAGH,eAAO,MAAM,kBAAkB,GAAI,KAAK,sBAAsB,KAAG,OAkChE,CAAC;AAGF,eAAO,MAAM,UAAU;eACV,MAAM,iBAAiB,GAAG,KAAG,gBAAgB;eAG7C,MAAM,SAAS,GAAG,KAAG,gBAAgB;kBAGlC,MAAM,KAAG,gBAAgB;iBAG5B,gBAAgB;CAG5B,CAAC;AAGF,eAAO,MAAM,OAAO,GAAU,MAAM,MAAM,EAAE,QAAQ,MAAM,OAAO,CAAC,IAAI,CAAC,kBAQtE,CAAC"}