@bubblelab/bubble-runtime 0.1.0

package/dist/parse/traceDependencies.js

@@ -0,0 +1,181 @@
+import ts from 'typescript';
+import { BubbleParameterType, } from '@bubblelab/shared-schemas';
+import { buildClassNameLookup } from '../utils/bubble-helper';
+/**
+ * Trace bubble dependencies from a validated BubbleFlow script.
+ * - Parses AST, extracts bubble instantiations and their parameters
+ * - Builds a className -> metadata mapping from BubbleFactory defaults
+ * - Classifies each bubble node as service/tool/workflow using metadata
+ *
+ * Note: Only dependencies explicitly constructed in the script are captured.
+ * Internal dependencies of workflow bubbles require explicit metadata.
+ */
+export function traceBubbleDependencies(code, bubbleFactory) {
+    try {
+        const sourceFile = ts.createSourceFile('bubbleflow.ts', code, ts.ScriptTarget.ES2022, true);
+        // Build registry lookup from bubble-core
+        const classNameToInfo = buildClassNameLookup(bubbleFactory);
+        if (classNameToInfo.size === 0) {
+            return {
+                success: false,
+                nodes: {},
+                errors: ['No bubbles found in BubbleFactory'],
+            };
+        }
+        const nodes = {};
+        const errors = [];
+        function visit(node) {
+            // Capture variable declarations
+            if (ts.isVariableDeclaration(node)) {
+                const nameText = node.name.getText(sourceFile);
+                // Bubble instantiation assigned to variable
+                if (node.initializer) {
+                    const bubbleNode = extractBubbleFromExpression(node.initializer, sourceFile, classNameToInfo);
+                    if (bubbleNode) {
+                        nodes[nameText] = bubbleNode;
+                    }
+                }
+            }
+            // Anonymous instantiations in expression statements
+            if (ts.isExpressionStatement(node)) {
+                const bubbleNode = extractBubbleFromExpression(node.expression, sourceFile, classNameToInfo);
+                if (bubbleNode) {
+                    const synthetic = `_anonymous_${bubbleNode.className}_${Object.keys(nodes).length}`;
+                    nodes[synthetic] = { ...bubbleNode, variableName: synthetic };
+                }
+            }
+            ts.forEachChild(node, visit);
+        }
+        visit(sourceFile);
+        return {
+            success: errors.length === 0,
+            nodes,
+            errors: errors.length ? errors : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            nodes: {},
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+function extractBubbleFromExpression(expr, sourceFile, classNameLookup) {
+    // await new X(...)
+    if (ts.isAwaitExpression(expr)) {
+        const inner = extractBubbleFromExpression(expr.expression, sourceFile, classNameLookup);
+        if (inner)
+            inner.hasAwait = true;
+        return inner;
+    }
+    // new X({...}) or new X({...}).action()
+    if (ts.isNewExpression(expr)) {
+        const newNode = extractFromNewExpression(expr, sourceFile, classNameLookup);
+        if (newNode)
+            return newNode;
+    }
+    // new X({...}).action() pattern
+    if (ts.isCallExpression(expr) &&
+        ts.isPropertyAccessExpression(expr.expression)) {
+        const prop = expr.expression;
+        if (prop.name.text === 'action' && ts.isNewExpression(prop.expression)) {
+            const node = extractFromNewExpression(prop.expression, sourceFile, classNameLookup);
+            if (node)
+                node.hasActionCall = true;
+            return node;
+        }
+    }
+    return null;
+}
+function extractFromNewExpression(newExpr, sourceFile, classNameLookup) {
+    if (!newExpr.expression || !ts.isIdentifier(newExpr.expression))
+        return null;
+    const className = newExpr.expression.text;
+    const info = classNameLookup.get(className);
+    if (!info)
+        return null;
+    const parameters = [];
+    if (newExpr.arguments && newExpr.arguments.length > 0) {
+        const firstArg = newExpr.arguments[0];
+        if (ts.isObjectLiteralExpression(firstArg)) {
+            for (const prop of firstArg.properties) {
+                if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name)) {
+                    const name = prop.name.text;
+                    const value = extractParameterValue(prop.initializer, sourceFile);
+                    parameters.push({ name, ...value });
+                }
+                else if (ts.isShorthandPropertyAssignment(prop) &&
+                    ts.isIdentifier(prop.name)) {
+                    const name = prop.name.text;
+                    const value = extractParameterValue(prop.name, sourceFile);
+                    parameters.push({ name, ...value });
+                }
+            }
+        }
+    }
+    const start = newExpr.getStart(sourceFile);
+    const end = newExpr.getEnd();
+    const lineStart = sourceFile.getLineAndCharacterOfPosition(start).line + 1;
+    const lineEnd = sourceFile.getLineAndCharacterOfPosition(end).line + 1;
+    return {
+        variableId: -1,
+        variableName: '',
+        bubbleName: info.bubbleName,
+        className: info.className,
+        parameters,
+        hasAwait: false,
+        hasActionCall: false,
+        nodeType: info.nodeType,
+        location: {
+            startLine: lineStart,
+            startCol: 0,
+            endLine: lineEnd,
+            endCol: 0,
+        },
+    };
+}
+function extractParameterValue(expression, sourceFile) {
+    const valueText = expression.getText(sourceFile);
+    // process.env detection (with or without non-null)
+    const isProcessEnv = (text) => text.startsWith('process.env.');
+    if (ts.isNonNullExpression(expression)) {
+        const inner = expression.expression;
+        if (ts.isPropertyAccessExpression(inner)) {
+            const full = inner.getText(sourceFile);
+            if (isProcessEnv(full))
+                return { value: valueText, type: BubbleParameterType.ENV };
+        }
+    }
+    if (ts.isPropertyAccessExpression(expression) ||
+        ts.isElementAccessExpression(expression)) {
+        const full = expression.getText(sourceFile);
+        if (isProcessEnv(full))
+            return { value: full, type: BubbleParameterType.ENV };
+        return { value: full, type: BubbleParameterType.VARIABLE };
+    }
+    // Identifiers treated as variable references
+    if (ts.isIdentifier(expression)) {
+        return { value: valueText, type: BubbleParameterType.VARIABLE };
+    }
+    // Literals and structured
+    if (ts.isStringLiteral(expression) || ts.isTemplateExpression(expression)) {
+        return { value: valueText, type: BubbleParameterType.STRING };
+    }
+    if (ts.isNumericLiteral(expression)) {
+        return { value: valueText, type: BubbleParameterType.NUMBER };
+    }
+    if (expression.kind === ts.SyntaxKind.TrueKeyword ||
+        expression.kind === ts.SyntaxKind.FalseKeyword) {
+        return { value: valueText, type: BubbleParameterType.BOOLEAN };
+    }
+    if (ts.isArrayLiteralExpression(expression)) {
+        return { value: valueText, type: BubbleParameterType.ARRAY };
+    }
+    if (ts.isObjectLiteralExpression(expression)) {
+        return { value: valueText, type: BubbleParameterType.OBJECT };
+    }
+    // Fallback
+    return { value: valueText, type: BubbleParameterType.UNKNOWN };
+}
+//# sourceMappingURL=traceDependencies.js.map

package/dist/parse/traceDependencies.js.map

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

package/dist/runtime/BubbleRunner.d.ts

@@ -0,0 +1,91 @@
+import { ExecutionResult, ParsedBubbleWithInfo } from '@bubblelab/shared-schemas';
+import { BubbleFactory, WebhookEvent, BubbleLogger, LogLevel } from '@bubblelab/bubble-core';
+import type { StreamCallback } from '@bubblelab/shared-schemas';
+import type { ExecutionPlan } from './types';
+import { BubbleScript } from 'src/parse/BubbleScript';
+import { BubbleInjector } from 'src/injection/BubbleInjector';
+export interface VariableState {
+    value: unknown;
+    error?: string;
+}
+export interface BubbleRunnerOptions {
+    enableLogging?: boolean;
+    logLevel?: LogLevel;
+    enableLineByLineLogging?: boolean;
+    enableBubbleLogging?: boolean;
+    streamCallback?: StreamCallback;
+}
+export declare class BubbleRunner {
+    private bubbleFactory;
+    bubbleScript: BubbleScript;
+    private currentStep;
+    private savedStates;
+    private plan;
+    private logger;
+    injector: BubbleInjector;
+    private options;
+    constructor(bubbleScript: string | BubbleScript, bubbleFactory: BubbleFactory, options?: BubbleRunnerOptions);
+    /**
+     * Creates a list of steps where length = number of parsed bubbles
+     * Contains the bubble and parameters to run
+     * Each step represents a continuous line range (e.g., line 1-20, 21-xxx)
+     */
+    private buildExecutionPlan;
+    /**
+     * Find the line where .action() is called for a bubble
+     * Uses AST to locate the method call
+     */
+    private findActionCallLine;
+    /**
+     * Recursively search AST for .action() calls on a specific variable
+     */
+    private findActionCallInAST;
+    getParsedBubbles(): Record<string, ParsedBubbleWithInfo>;
+    getVariables(): string[];
+    /**
+     * Finds step ID, calls memorizes results on previous bubbles, and runs the script from 1 to line end
+     */
+    runStep(stepId: number): void;
+    /**
+     * Run from step 1 to end
+     */
+    runAll(payload?: Partial<WebhookEvent>): Promise<ExecutionResult>;
+    /**
+     * Find the BubbleFlow class in module exports
+     */
+    private findBubbleFlowClass;
+    /**
+     * Check if a function is a BubbleFlow class
+     */
+    private isBubbleFlowClass;
+    /**
+     * Instantiate the flow class with appropriate constructor parameters
+     */
+    private instantiateFlowClass;
+    /**
+     * Resume execution from a specific step
+     */
+    resumeFromStep(stepId: number): void;
+    getPlan(): ExecutionPlan;
+    /**
+     * Get the logger instance
+     */
+    getLogger(): BubbleLogger | undefined;
+    /**
+     * Get execution summary with detailed analytics
+     */
+    getExecutionSummary(): ReturnType<BubbleLogger['getExecutionSummary']> | null;
+    /**
+     * Export execution logs in various formats
+     */
+    exportLogs(format?: 'json' | 'csv' | 'table'): string | null;
+    /**
+     * Find the project root directory by looking for package.json
+     */
+    private findProjectRoot;
+    /**
+     * Dispose of resources (logger, etc.)
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=BubbleRunner.d.ts.map

package/dist/runtime/BubbleRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BubbleRunner.d.ts","sourceRoot":"","sources":["../../src/runtime/BubbleRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EAEb,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMhE,OAAO,KAAK,EAAE,aAAa,EAA2B,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAK9D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,YAAY;IAKvB,OAAO,CAAC,aAAa,CAAgB;IAE9B,YAAY,EAAE,YAAY,CAAC;IAGlC,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,MAAM,CAAe;IACtB,QAAQ,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,OAAO,CAAsB;gBAGnC,YAAY,EAAE,MAAM,GAAG,YAAY,EACnC,aAAa,EAAE,aAAa,EAC5B,OAAO,GAAE,mBAAwB;IAwCnC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA8J1B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8D3B,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAIxD,YAAY;IAIZ;;OAEG;IAEH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAqQvE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IAEH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC,OAAO,IAAI,aAAa;IAOxB;;OAEG;IACH,SAAS,IAAI,YAAY,GAAG,SAAS;IAIrC;;OAEG;IACH,mBAAmB,IAAI,UAAU,CAC/B,YAAY,CAAC,qBAAqB,CAAC,CACpC,GAAG,IAAI;IAIR;;OAEG;IACH,UAAU,CAAC,MAAM,GAAE,MAAM,GAAG,KAAK,GAAG,OAAgB,GAAG,MAAM,GAAG,IAAI;IAIpE;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}