@bubblelab/bubble-core 0.1.0

package/dist/bubble-factory.d.ts

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import type { IBubble, BubbleContext } from './types/bubble.js';
+import { CredentialType, type BubbleName, type BubbleNodeType } from '@bubblelab/shared-schemas';
+type BubbleDependencySpec = {
+    name: BubbleName;
+    tools?: BubbleName[];
+    instances?: Array<{
+        variableName: string;
+        isAnonymous: boolean;
+        startLine?: number;
+        endLine?: number;
+    }>;
+};
+import type { LangGraphTool } from './types/tool-bubble-class.js';
+export type BubbleClassWithMetadata<TResult extends object = object> = {
+    new (params: unknown, context?: BubbleContext): IBubble<{
+        success: boolean;
+        error: string;
+    } & TResult>;
+    readonly bubbleName: BubbleName;
+    readonly schema: z.ZodObject<z.ZodRawShape> | z.ZodDiscriminatedUnion<string, z.ZodObject<z.ZodRawShape>[]>;
+    readonly resultSchema?: z.ZodObject<z.ZodRawShape> | z.ZodDiscriminatedUnion<string, z.ZodObject<z.ZodRawShape>[]>;
+    readonly shortDescription: string;
+    readonly longDescription: string;
+    readonly alias?: string;
+    readonly type: BubbleNodeType;
+    readonly credentialOptions?: CredentialType[];
+    readonly bubbleDependencies?: BubbleName[];
+    toolAgent?: (credentials: Partial<Record<CredentialType, string>>, config?: Record<string, unknown>, context?: BubbleContext) => LangGraphTool;
+};
+export declare class BubbleFactory {
+    private registry;
+    private static dependenciesPopulated;
+    private static detailedDepsCache;
+    private detailedDeps;
+    constructor(autoRegisterDefaults?: boolean);
+    /**
+     * Register a bubble class with the factory
+     */
+    register(name: BubbleName, bubbleClass: BubbleClassWithMetadata<any>): void;
+    /**
+     * Get a bubble class from the registry
+     */
+    get(name: BubbleName): BubbleClassWithMetadata<any> | undefined;
+    /**
+     * Create a bubble instance
+     */
+    createBubble<T extends IBubble = IBubble>(name: BubbleName, params?: unknown, context?: BubbleContext): T;
+    getDetailedDependencies(name: BubbleName): BubbleDependencySpec[];
+    /**
+     * List all registered bubble names
+     */
+    list(): BubbleName[];
+    listBubblesForCodeGenerator(): BubbleName[];
+    registerDefaults(): Promise<void>;
+    /**
+     * Get all registered bubble classes
+     */
+    getAll(): BubbleClassWithMetadata[];
+    /**
+     * Get metadata for a bubble without instantiating it
+     */
+    getMetadata(name: BubbleName): {
+        bubbleDependenciesDetailed: BubbleDependencySpec[] | undefined;
+        name: BubbleName;
+        shortDescription: string;
+        longDescription: string;
+        alias: string | undefined;
+        credentialOptions: CredentialType[] | undefined;
+        bubbleDependencies: BubbleName[] | undefined;
+        schema: z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }> | z.ZodDiscriminatedUnion<string, z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }>[]>;
+        resultSchema: z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }> | z.ZodDiscriminatedUnion<string, z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }>[]> | undefined;
+        type: BubbleNodeType;
+        params: z.ZodRawShape | undefined;
+    } | undefined;
+    /**
+     * Get all bubble metadata
+     */
+    getAllMetadata(): ({
+        bubbleDependenciesDetailed: BubbleDependencySpec[] | undefined;
+        name: BubbleName;
+        shortDescription: string;
+        longDescription: string;
+        alias: string | undefined;
+        credentialOptions: CredentialType[] | undefined;
+        bubbleDependencies: BubbleName[] | undefined;
+        schema: z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }> | z.ZodDiscriminatedUnion<string, z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }>[]>;
+        resultSchema: z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }> | z.ZodDiscriminatedUnion<string, z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }>[]> | undefined;
+        type: BubbleNodeType;
+        params: z.ZodRawShape | undefined;
+    } | undefined)[];
+    /**
+     * Scan bubble source modules to infer direct dependencies between bubbles by
+     * inspecting ES module import statements, then attach the resulting
+     * `bubbleDependencies` array onto the corresponding registered classes.
+     *
+     * Notes:
+     * - Works in both dev (src) and build (dist) because it resolves paths
+     *   relative to this module at runtime.
+     * - Only imports under ./bubbles/** that themselves define a bubble class are
+     *   considered dependencies; all other imports are ignored.
+     */
+    private populateBubbleDependenciesFromSource;
+    private listModuleFilesRecursively;
+    private extractBubbleNamesFromContent;
+    /**
+     * Get credential to bubble name mapping from registered bubbles
+     * Provides type-safe mapping based on actual registered bubbles
+     */
+    getCredentialToBubbleMapping(): Partial<Record<CredentialType, BubbleName>>;
+    /**
+     * Get bubble name for a specific credential type
+     */
+    getBubbleNameForCredential(credentialType: CredentialType): BubbleName | undefined;
+    /**
+     * Check if a credential type is supported by any registered bubble
+     */
+    isCredentialSupported(credentialType: CredentialType): boolean;
+    /**
+     * Generate comprehensive BubbleFlow boilerplate template with all imports
+     * This template includes ALL available bubble classes and types
+     * Perfect for AI code generation and testing
+     */
+    generateBubbleFlowBoilerplate(options?: {
+        className?: string;
+    }): string;
+}
+export {};
+//# sourceMappingURL=bubble-factory.d.ts.map

package/dist/bubble-factory.d.ts.map

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

package/dist/bubble-factory.js

@@ -0,0 +1,426 @@
+import { z } from 'zod';
+import { CredentialType, BUBBLE_CREDENTIAL_OPTIONS, } from '@bubblelab/shared-schemas';
+import { WebCrawlTool } from './bubbles/tool-bubble/web-crawl-tool.js';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildClassNameLookup as buildLookupForSource, parseBubbleInstancesFromSource, } from './utils/source-bubble-parser.js';
+export class BubbleFactory {
+    registry = new Map();
+    static dependenciesPopulated = false;
+    static detailedDepsCache = new Map();
+    // Stores detailed dependencies inferred from source for each registered bubble
+    detailedDeps = new Map();
+    constructor(autoRegisterDefaults = false) {
+        if (autoRegisterDefaults) {
+            this.registerDefaults();
+        }
+        // Seed instance detailed deps from global cache if available
+        if (BubbleFactory.detailedDepsCache.size > 0) {
+            for (const [name, deps] of BubbleFactory.detailedDepsCache) {
+                this.detailedDeps.set(name, deps);
+            }
+        }
+    }
+    /**
+     * Register a bubble class with the factory
+     */
+    register(name, bubbleClass) {
+        if (this.registry.has(name)) {
+            // Silently skip if already registered - makes it idempotent
+            return;
+        }
+        this.registry.set(name, bubbleClass);
+    }
+    /**
+     * Get a bubble class from the registry
+     */
+    get(name) {
+        return this.registry.get(name);
+    }
+    /**
+     * Create a bubble instance
+     */
+    createBubble(name, params, context) {
+        const BubbleClass = this.registry.get(name);
+        if (!BubbleClass) {
+            throw new Error(`Bubble '${name}' not found in factory registry`);
+        }
+        // Always pass params, even if undefined
+        return new BubbleClass(params, context);
+    }
+    getDetailedDependencies(name) {
+        return this.detailedDeps.get(name) || [];
+    }
+    /**
+     * List all registered bubble names
+     */
+    list() {
+        return Array.from(this.registry.keys());
+    }
+    // Return a list of bubbles to be used in the BubbleFlow code generator
+    listBubblesForCodeGenerator() {
+        return [
+            'postgresql',
+            'ai-agent',
+            'slack',
+            'resend',
+            'storage',
+            'google-drive',
+            'gmail',
+            'google-sheets',
+            'google-calendar',
+            'pdf-form-operations',
+            'generate-document-workflow',
+            'slack-formatter-agent',
+            'research-agent-tool',
+            'reddit-scrape-tool',
+        ];
+    }
+    async registerDefaults() {
+        // Import and register all default bubbles
+        // This will be implemented in a separate file to avoid circular deps
+        // Register all default bubbles
+        const { HelloWorldBubble } = await import('./bubbles/service-bubble/hello-world.js');
+        const { AIAgentBubble } = await import('./bubbles/service-bubble/ai-agent.js');
+        const { PostgreSQLBubble } = await import('./bubbles/service-bubble/postgresql.js');
+        const { SlackBubble } = await import('./bubbles/service-bubble/slack.js');
+        const { ResendBubble } = await import('./bubbles/service-bubble/resend.js');
+        const { HttpBubble } = await import('./bubbles/service-bubble/http.js');
+        const { StorageBubble } = await import('./bubbles/service-bubble/storage.js');
+        const { GoogleDriveBubble } = await import('./bubbles/service-bubble/google-drive.js');
+        const { GmailBubble } = await import('./bubbles/service-bubble/gmail.js');
+        const { GoogleSheetsBubble } = await import('./bubbles/service-bubble/google-sheets.js');
+        const { GoogleCalendarBubble } = await import('./bubbles/service-bubble/google-calendar.js');
+        const { BubbleFlowGeneratorWorkflow } = await import('./bubbles/workflow-bubble/bubbleflow-generator.workflow.js');
+        const { DatabaseAnalyzerWorkflowBubble } = await import('./bubbles/workflow-bubble/database-analyzer.workflow.js');
+        const { SlackNotifierWorkflowBubble } = await import('./bubbles/workflow-bubble/slack-notifier.workflow.js');
+        const { SlackDataAssistantWorkflow } = await import('./bubbles/workflow-bubble/slack-data-assistant.workflow.js');
+        const { ListBubblesTool } = await import('./bubbles/tool-bubble/list-bubbles-tool.js');
+        const { GetBubbleDetailsTool } = await import('./bubbles/tool-bubble/get-bubble-details-tool.js');
+        const { SQLQueryTool } = await import('./bubbles/tool-bubble/sql-query-tool.js');
+        const { ChartJSTool } = await import('./bubbles/tool-bubble/chart-js-tool.js');
+        const { BubbleFlowValidationTool } = await import('./bubbles/tool-bubble/bubbleflow-validation-tool.js');
+        const { WebSearchTool } = await import('./bubbles/tool-bubble/web-search-tool.js');
+        const { WebScrapeTool } = await import('./bubbles/tool-bubble/web-scrape-tool.js');
+        const { WebExtractTool } = await import('./bubbles/tool-bubble/web-extract-tool.js');
+        const { ResearchAgentTool } = await import('./bubbles/tool-bubble/research-agent-tool.js');
+        const { RedditScrapeTool } = await import('./bubbles/tool-bubble/reddit-scrape-tool.js');
+        const { SlackFormatterAgentBubble } = await import('./bubbles/workflow-bubble/slack-formatter-agent.js');
+        const { PDFFormOperationsWorkflow } = await import('./bubbles/workflow-bubble/pdf-form-operations.workflow.js');
+        const { PDFOcrWorkflow } = await import('./bubbles/workflow-bubble/pdf-ocr.workflow.js');
+        const { GenerateDocumentWorkflow } = await import('./bubbles/workflow-bubble/generate-document.workflow.js');
+        const { ParseDocumentWorkflow } = await import('./bubbles/workflow-bubble/parse-document.workflow.js');
+        // Create the default factory instance
+        this.register('hello-world', HelloWorldBubble);
+        this.register('ai-agent', AIAgentBubble);
+        this.register('postgresql', PostgreSQLBubble);
+        this.register('slack', SlackBubble);
+        this.register('resend', ResendBubble);
+        this.register('http', HttpBubble);
+        this.register('storage', StorageBubble);
+        this.register('google-drive', GoogleDriveBubble);
+        this.register('gmail', GmailBubble);
+        this.register('google-sheets', GoogleSheetsBubble);
+        this.register('google-calendar', GoogleCalendarBubble);
+        this.register('bubbleflow-generator', BubbleFlowGeneratorWorkflow);
+        this.register('database-analyzer', DatabaseAnalyzerWorkflowBubble);
+        this.register('slack-notifier', SlackNotifierWorkflowBubble);
+        this.register('slack-data-assistant', SlackDataAssistantWorkflow);
+        this.register('slack-formatter-agent', SlackFormatterAgentBubble);
+        this.register('pdf-form-operations', PDFFormOperationsWorkflow);
+        this.register('pdf-ocr-workflow', PDFOcrWorkflow);
+        this.register('generate-document-workflow', GenerateDocumentWorkflow);
+        this.register('parse-document-workflow', ParseDocumentWorkflow);
+        this.register('get-bubble-details-tool', GetBubbleDetailsTool);
+        this.register('list-bubbles-tool', ListBubblesTool);
+        this.register('sql-query-tool', SQLQueryTool);
+        this.register('chart-js-tool', ChartJSTool);
+        this.register('bubbleflow-validation-tool', BubbleFlowValidationTool);
+        this.register('web-search-tool', WebSearchTool);
+        this.register('web-scrape-tool', WebScrapeTool);
+        this.register('web-extract-tool', WebExtractTool);
+        this.register('research-agent-tool', ResearchAgentTool);
+        this.register('reddit-scrape-tool', RedditScrapeTool);
+        this.register('web-crawl-tool', WebCrawlTool);
+        this.register('bubbleflow-code-generator', BubbleFlowGeneratorWorkflow);
+        // After all default bubbles are registered, auto-populate bubbleDependencies
+        if (!BubbleFactory.dependenciesPopulated) {
+            console.log('Populating bubble dependencies from source....');
+            await this.populateBubbleDependenciesFromSource();
+            BubbleFactory.dependenciesPopulated = true;
+            // Cache detailed dependencies globally for seeding future instances
+            BubbleFactory.detailedDepsCache = new Map(this.detailedDeps);
+        }
+        else {
+            console.log('Bubble dependencies already populated....');
+            // Seed this instance from the global cache if available
+            if (BubbleFactory.detailedDepsCache.size > 0) {
+                for (const [name, deps] of BubbleFactory.detailedDepsCache) {
+                    this.detailedDeps.set(name, deps);
+                }
+            }
+        }
+    }
+    /**
+     * Get all registered bubble classes
+     */
+    getAll() {
+        return Array.from(this.registry.values());
+    }
+    /**
+     * Get metadata for a bubble without instantiating it
+     */
+    getMetadata(name) {
+        const BubbleClass = this.get(name);
+        if (!BubbleClass)
+            return undefined;
+        // Type guard to check if schema is a ZodObject
+        const schemaParams = BubbleClass.schema &&
+            typeof BubbleClass.schema === 'object' &&
+            'shape' in BubbleClass.schema
+            ? BubbleClass.schema.shape
+            : undefined;
+        return {
+            bubbleDependenciesDetailed: this.detailedDeps.get(BubbleClass.bubbleName),
+            name: BubbleClass.bubbleName,
+            shortDescription: BubbleClass.shortDescription,
+            longDescription: BubbleClass.longDescription,
+            alias: BubbleClass.alias,
+            credentialOptions: BubbleClass.credentialOptions,
+            bubbleDependencies: BubbleClass.bubbleDependencies,
+            // Provide richer dependency details (ai-agent may include tools)
+            schema: BubbleClass.schema,
+            resultSchema: BubbleClass.resultSchema,
+            type: BubbleClass.type,
+            params: schemaParams,
+        };
+    }
+    /**
+     * Get all bubble metadata
+     */
+    getAllMetadata() {
+        return this.list()
+            .map((name) => this.getMetadata(name))
+            .filter(Boolean);
+    }
+    /**
+     * Scan bubble source modules to infer direct dependencies between bubbles by
+     * inspecting ES module import statements, then attach the resulting
+     * `bubbleDependencies` array onto the corresponding registered classes.
+     *
+     * Notes:
+     * - Works in both dev (src) and build (dist) because it resolves paths
+     *   relative to this module at runtime.
+     * - Only imports under ./bubbles/** that themselves define a bubble class are
+     *   considered dependencies; all other imports are ignored.
+     */
+    async populateBubbleDependenciesFromSource() {
+        try {
+            const currentFilePath = fileURLToPath(import.meta.url);
+            const baseDir = path.dirname(currentFilePath);
+            const bubblesDir = path.resolve(baseDir, './bubbles');
+            console.log('Bubbles directory:', bubblesDir);
+            // Gather all .js and .ts files under bubbles/**
+            const bubbleFiles = await this.listModuleFilesRecursively(bubblesDir);
+            // Build lookup once for all files
+            const lookup = buildLookupForSource(this.registry);
+            for (const filePath of bubbleFiles) {
+                const content = await fs.readFile(filePath, 'utf-8');
+                const ownerBubbleNames = this.extractBubbleNamesFromContent(content);
+                if (ownerBubbleNames.length === 0) {
+                    continue;
+                }
+                // Parse instances used within this file
+                let instancesByDep = new Map();
+                try {
+                    instancesByDep = parseBubbleInstancesFromSource(content, lookup, {
+                        debug: false,
+                        filePath,
+                    });
+                }
+                catch {
+                    // ignore parser failures for this file
+                }
+                // Collect ai-agent tools from instances directly (AST-derived)
+                const aiAgentInst = instancesByDep.get('ai-agent');
+                const aiTools = Array.from(new Set((aiAgentInst || [])
+                    .flatMap((i) => i.tools || [])
+                    .filter((t) => typeof t === 'string')));
+                for (const owner of ownerBubbleNames) {
+                    const detailed = [];
+                    for (const [depName, instList] of instancesByDep.entries()) {
+                        if (depName === owner)
+                            continue;
+                        const spec = {
+                            name: depName,
+                            instances: instList.map((i) => ({
+                                variableName: i.variableName,
+                                isAnonymous: i.isAnonymous,
+                                startLine: i.startLine,
+                                endLine: i.endLine,
+                            })),
+                        };
+                        if (depName === 'ai-agent' && aiTools.length > 0) {
+                            spec.tools = aiTools;
+                        }
+                        detailed.push(spec);
+                    }
+                    // Persist results for this owner bubble
+                    this.detailedDeps.set(owner, detailed);
+                    // Maintain classic flat dependency list on the class
+                    const klass = this.get(owner);
+                    if (klass) {
+                        try {
+                            klass.bubbleDependencies = detailed.map((d) => d.name);
+                        }
+                        catch {
+                            try {
+                                Object.defineProperty(klass, 'bubbleDependencies', {
+                                    value: detailed.map((d) => d.name),
+                                    configurable: true,
+                                });
+                            }
+                            catch {
+                                // ignore
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Silently ignore issues in dependency scanning to avoid blocking runtime
+        }
+    }
+    async listModuleFilesRecursively(dir) {
+        const out = [];
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const nested = await this.listModuleFilesRecursively(full);
+                out.push(...nested);
+            }
+            else if (entry.isFile() &&
+                (full.endsWith('.ts') || full.endsWith('.js')) &&
+                !full.endsWith('.test.ts') &&
+                !full.endsWith('.d.ts')) {
+                out.push(full);
+            }
+        }
+        return out;
+    }
+    extractBubbleNamesFromContent(content) {
+        const names = [];
+        // Look for static bubbleName definitions in the class body
+        const nameRegex = /static\s+(?:readonly\s+)?bubbleName\s*(?::[^=]+)?=\s*['"]([^'"\n]+)['"]/g;
+        let match;
+        while ((match = nameRegex.exec(content)) !== null) {
+            names.push(match[1]);
+        }
+        return names;
+    }
+    /**
+     * Get credential to bubble name mapping from registered bubbles
+     * Provides type-safe mapping based on actual registered bubbles
+     */
+    getCredentialToBubbleMapping() {
+        const mapping = {};
+        for (const [bubbleName, credentialOptions] of Object.entries(BUBBLE_CREDENTIAL_OPTIONS)) {
+            // Get the bubble class to check its type
+            const BubbleClass = this.get(bubbleName);
+            // Only include service bubbles for credential validation
+            if (BubbleClass && BubbleClass.type === 'service') {
+                for (const credentialType of credentialOptions) {
+                    // Only map if we haven't seen this credential type before
+                    // This gives priority to the first service bubble for each credential
+                    if (!mapping[credentialType]) {
+                        mapping[credentialType] = bubbleName;
+                    }
+                }
+            }
+        }
+        return mapping;
+    }
+    /**
+     * Get bubble name for a specific credential type
+     */
+    getBubbleNameForCredential(credentialType) {
+        const mapping = this.getCredentialToBubbleMapping();
+        return mapping[credentialType];
+    }
+    /**
+     * Check if a credential type is supported by any registered bubble
+     */
+    isCredentialSupported(credentialType) {
+        return this.getBubbleNameForCredential(credentialType) !== undefined;
+    }
+    /**
+     * Generate comprehensive BubbleFlow boilerplate template with all imports
+     * This template includes ALL available bubble classes and types
+     * Perfect for AI code generation and testing
+     */
+    generateBubbleFlowBoilerplate(options) {
+        const className = options?.className || 'GeneratedFlow';
+        return `
+import {
+  // Base classes
+  BubbleFlow,
+  BaseBubble,
+  ServiceBubble,
+  WorkflowBubble,
+  ToolBubble,
+  
+  // Service Bubbles
+  HelloWorldBubble,
+  AIAgentBubble,
+  PostgreSQLBubble,
+  SlackBubble,
+  ResendBubble,
+  StorageBubble,
+  GoogleDriveBubble,
+  GmailBubble,
+  SlackFormatterAgentBubble,
+  
+  // Template Workflows
+  SlackDataAssistantWorkflow,
+  PDFFormOperationsWorkflow,
+
+  // Specialized Tool Bubbles
+  ResearchAgentTool,
+  RedditScrapeTool,
+    
+  // Types and utilities
+  BubbleFactory,
+  type BubbleClassWithMetadata,
+  type BubbleContext,
+  type BubbleOperationResult,
+  type BubbleTriggerEvent,
+  type WebhookEvent,
+} from '@bubblelab/bubble-core';
+
+export interface Output {
+ // TODO: Add your output fields here
+  message: string;
+}
+
+// Define your custom input interface
+export interface CustomWebhookPayload extends WebhookEvent {
+// TODO: Add your custom payload fields here
+  input: string;
+}
+
+export class ${className} extends BubbleFlow<'webhook/http'> {
+  async handle(payload: CustomWebhookPayload): Promise<Output> {
+    // TODO: Implement your workflow logic here
+    const { input } = payload;
+    
+    return {
+      message: \`Response from \${payload.path} (Request: \${payload.requestId})\`,
+    };
+  }
+}`;
+    }
+}
+//# sourceMappingURL=bubble-factory.js.map

package/dist/bubble-factory.js.map

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

package/dist/bubble-flow/bubble-flow-class.d.ts

@@ -0,0 +1,19 @@
+import type { BubbleTriggerEventRegistry } from '../bubble-trigger/types.js';
+import type { BubbleFlowOperationResult } from '../types/bubble.js';
+import type { BubbleLogger } from '../logging/BubbleLogger.js';
+export declare abstract class BubbleFlow<TEventType extends keyof BubbleTriggerEventRegistry> {
+    readonly name: string;
+    readonly description: string;
+    protected logger?: BubbleLogger;
+    constructor(name: string, description: string, logger?: BubbleLogger);
+    abstract handle(payload: BubbleTriggerEventRegistry[TEventType]): Promise<BubbleFlowOperationResult>;
+    /**
+     * Get the logger instance if available
+     */
+    getLogger(): BubbleLogger | undefined;
+    /**
+     * Set a logger for this flow instance
+     */
+    setLogger(logger: BubbleLogger): void;
+}
+//# sourceMappingURL=bubble-flow-class.d.ts.map

package/dist/bubble-flow/bubble-flow-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubble-flow-class.d.ts","sourceRoot":"","sources":["../../src/bubble-flow/bubble-flow-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,8BAAsB,UAAU,CAC9B,UAAU,SAAS,MAAM,0BAA0B;IAEnD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;gBAEpB,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY;IAMpE,QAAQ,CAAC,MAAM,CACb,OAAO,EAAE,0BAA0B,CAAC,UAAU,CAAC,GAC9C,OAAO,CAAC,yBAAyB,CAAC;IAErC;;OAEG;IACH,SAAS,IAAI,YAAY,GAAG,SAAS;IAIrC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;CAGtC"}

package/dist/bubble-flow/bubble-flow-class.js

@@ -0,0 +1,23 @@
+export class BubbleFlow {
+    name;
+    description;
+    logger;
+    constructor(name, description, logger) {
+        this.name = name;
+        this.description = description;
+        this.logger = logger;
+    }
+    /**
+     * Get the logger instance if available
+     */
+    getLogger() {
+        return this.logger;
+    }
+    /**
+     * Set a logger for this flow instance
+     */
+    setLogger(logger) {
+        this.logger = logger;
+    }
+}
+//# sourceMappingURL=bubble-flow-class.js.map

package/dist/bubble-flow/bubble-flow-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubble-flow-class.js","sourceRoot":"","sources":["../../src/bubble-flow/bubble-flow-class.ts"],"names":[],"mappings":"AAIA,MAAM,OAAgB,UAAU;IAGd,IAAI,CAAS;IACb,WAAW,CAAS;IAC1B,MAAM,CAAgB;IAEhC,YAAY,IAAY,EAAE,WAAmB,EAAE,MAAqB;QAClE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAMD;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAoB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}