@bubblelab/bubble-core 0.1.0

package/dist/types/base-bubble-class.js

@@ -0,0 +1,212 @@
+import { z } from 'zod';
+import { randomUUID } from 'crypto';
+import { MockDataGenerator } from '@bubblelab/shared-schemas';
+import { BubbleValidationError, BubbleExecutionError, } from './bubble-errors.js';
+import { sanitizeParams } from '../utils/param-helper.js';
+/**
+ * Abstract base class for all bubble types
+ * Implements common properties and methods defined in IBubble interface
+ */
+export class BaseBubble {
+    name;
+    schema;
+    resultSchema;
+    shortDescription;
+    longDescription;
+    alias;
+    params;
+    context;
+    previousResult;
+    constructor(params, context) {
+        // Use static properties from the class - typed as required static metadata
+        const ctor = this.constructor;
+        this.name = ctor.bubbleName;
+        this.schema = ctor.schema;
+        this.resultSchema = ctor.resultSchema;
+        this.shortDescription = ctor.shortDescription;
+        this.longDescription = ctor.longDescription;
+        this.alias = ctor.alias;
+        try {
+            this.params = this.schema.parse(params);
+            // Enrich context with child variableId/currentUniqueId if dependencyGraph is provided
+            if (context && context.dependencyGraph && context.currentUniqueId) {
+                console.debug('Computing child context');
+                const next = this.computeChildContext(context);
+                this.context = next;
+                console.debug('Computed child context unique id:', this.context?.currentUniqueId);
+                //Prnt the var id of the computed child context
+                console.debug('Computed child context variable id:', this.context?.variableId);
+            }
+            else {
+                this.context = context;
+            }
+        }
+        catch (error) {
+            // Parse Zod validation errors to make them more user-friendly
+            if (error instanceof z.ZodError) {
+                const errorMessages = error.errors.map((err) => {
+                    const path = err.path.length > 0 ? `${err.path.join('.')}: ` : '';
+                    return `${path}${err.message}`;
+                });
+                throw new BubbleValidationError(`Parameter validation failed: ${errorMessages.join(', ')}`, {
+                    variableId: context?.variableId,
+                    bubbleName: ctor.bubbleName,
+                    validationErrors: errorMessages,
+                    cause: error,
+                });
+            }
+            throw new BubbleValidationError(`Parameter validation failed: ${String(error)}`, {
+                variableId: context?.variableId,
+                bubbleName: ctor.bubbleName,
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Compute child context based on dependency graph and current unique id.
+     * Finds the node matching currentUniqueId, then determines this child's unique id as
+     * `${currentUniqueId}.${this.name}#k` for the next ordinal k, and assigns the variableId from
+     * the dependency graph if present, otherwise keeps parent's variableId.
+     */
+    computeChildContext(parentContext) {
+        const graph = parentContext.dependencyGraph;
+        const currentId = parentContext.currentUniqueId || '';
+        if (!graph)
+            return parentContext;
+        // Depth-first search to find node by uniqueId
+        const findByUniqueId = (node, target) => {
+            if (node.uniqueId === target)
+                return node;
+            for (const child of node.dependencies || []) {
+                const found = findByUniqueId(child, target);
+                if (found)
+                    return found;
+            }
+            return null;
+        };
+        const parentNode = currentId ? findByUniqueId(graph, currentId) : graph;
+        // If the current bubble matches the node at currentUniqueId, don't advance; keep IDs from that node
+        if (parentNode && parentNode.name === this.name) {
+            const sameNodeVarId = parentNode.variableId ??
+                parentContext.variableId;
+            return {
+                ...parentContext,
+                variableId: sameNodeVarId,
+                currentUniqueId: currentId,
+                __uniqueIdCounters__: { ...(parentContext.__uniqueIdCounters__ || {}) },
+            };
+        }
+        // Determine this bubble's ordinal under the parent using a counter map
+        const children = parentNode?.dependencies || [];
+        const counterKey = `${currentId || 'ROOT'}|${this.name}`;
+        const counters = { ...(parentContext.__uniqueIdCounters__ || {}) };
+        const ordinal = (counters[counterKey] || 0) + 1;
+        counters[counterKey] = ordinal;
+        // Try to select the nth child by name for an exact uniqueId match
+        const sameNameChildren = children.filter((c) => c.name === this.name);
+        const selectedChild = sameNameChildren[ordinal - 1];
+        const childUniqueId = selectedChild?.uniqueId ||
+            (currentId
+                ? `${currentId}.${this.name}#${ordinal}`
+                : `${this.name}#${ordinal}`);
+        // Try to find a matching child node to get variableId; fallback to parent's
+        const matchingChild = selectedChild ||
+            children.find((c) => c.uniqueId === childUniqueId || c.name === this.name);
+        const childVariableId = (matchingChild && typeof matchingChild.variableId === 'number'
+            ? matchingChild.variableId
+            : parentContext.variableId) || parentContext.variableId;
+        return {
+            ...parentContext,
+            variableId: childVariableId,
+            currentUniqueId: childUniqueId,
+            __uniqueIdCounters__: counters,
+        };
+    }
+    saveResult(result) {
+        this.previousResult = result;
+    }
+    clearSavedResult() {
+        this.previousResult = undefined;
+    }
+    /**
+     * Execute the bubble - just runs the action
+     */
+    async action() {
+        const logger = this.context?.logger;
+        logger?.logBubbleExecution(this.context?.variableId ?? -999, this.name, this.name, sanitizeParams(this.params));
+        // If we have a saved result, return it instead of executing
+        if (this.previousResult) {
+            logger?.debug(`[BubbleClass - ${this.name}] Returning saved result`);
+            // Narrow saved base result to current TResult by keeping metadata and
+            // treating data as unknown (caller side should only read known fields)
+            const savedResult = this.previousResult;
+            // Log bubble execution completion for saved result
+            logger?.logBubbleExecutionComplete(this.context?.variableId ?? -999, this.name, this.name, savedResult);
+            return savedResult;
+        }
+        const result = await this.performAction(this.context);
+        // Validate result if schema is provided
+        if (this.resultSchema) {
+            try {
+                const validatedResult = this.resultSchema.parse(result);
+                const finalResult = {
+                    success: result.success,
+                    // For data we strip out the success and error fields
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                    data: (({ success: _success, error: _error, ...rest }) => rest)(validatedResult),
+                    executionId: randomUUID(),
+                    error: validatedResult.error || '',
+                    timestamp: new Date(),
+                };
+                // Log bubble execution completion
+                logger?.logBubbleExecutionComplete(this.context?.variableId ?? -999, this.name, this.name, finalResult);
+                if (!finalResult.success) {
+                    logger?.warn(`[${this.name}] Execution did not succeed: ${finalResult.error}. The flow will continue to run unless you manually catch and handle the error.`);
+                }
+                return finalResult;
+            }
+            catch (validationError) {
+                // Throw execution error for result validation failures
+                const errorMessage = validationError instanceof z.ZodError
+                    ? `Result schema validation failed: ${validationError.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ')}`
+                    : `Result validation failed: ${validationError instanceof Error ? validationError.message : 'Unknown validation error'}`;
+                throw new BubbleExecutionError(errorMessage, {
+                    variableId: this.context?.variableId,
+                    bubbleName: this.name,
+                    executionPhase: 'validation',
+                    cause: validationError instanceof Error ? validationError : undefined,
+                });
+            }
+        }
+        // No result schema defined - proceed without validation
+        const finalResult = {
+            success: result.success,
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            data: (({ success: _success, error: _error, ...rest }) => rest)(result),
+            error: result.error || '',
+            executionId: randomUUID(),
+            timestamp: new Date(),
+        };
+        if (!result.success) {
+            logger?.error(`[${this.name}] Execution error when performing action: ${result.error}`);
+        }
+        // Log bubble execution completion
+        logger?.logBubbleExecutionComplete(this.context?.variableId ?? -999, this.name, this.name, finalResult);
+        return finalResult;
+    }
+    /**
+     * Generate mock result data based on the result schema
+     * Useful for testing and development when you need sample data
+     */
+    generateMockResult() {
+        return MockDataGenerator.generateMockResult(this.resultSchema);
+    }
+    /**
+     * Generate mock result with a specific seed for reproducible results
+     * Useful for consistent testing scenarios
+     */
+    generateMockResultWithSeed(seed) {
+        return MockDataGenerator.generateMockWithSeed(this.resultSchema, seed);
+    }
+}
+//# sourceMappingURL=base-bubble-class.js.map

package/dist/types/base-bubble-class.js.map

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

package/dist/types/bubble-errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Custom error classes for bubble operations
+ * These errors carry metadata like variableId to enable better error tracking and logging
+ */
+/**
+ * Base error class for all bubble-related errors
+ * Includes variableId and bubbleName for context tracking
+ */
+export declare class BubbleError extends Error {
+    readonly variableId?: number;
+    readonly bubbleName?: string;
+    constructor(message: string, options?: {
+        variableId?: number;
+        bubbleName?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Thrown when bubble parameter validation fails
+ * Used in BaseBubble constructor when schema.parse() fails
+ */
+export declare class BubbleValidationError extends BubbleError {
+    readonly validationErrors?: string[];
+    constructor(message: string, options?: {
+        variableId?: number;
+        bubbleName?: string;
+        validationErrors?: string[];
+        cause?: Error;
+    });
+}
+/**
+ * Thrown when bubble execution fails during performAction
+ * Used in BaseBubble.action() when the operation fails
+ */
+export declare class BubbleExecutionError extends BubbleError {
+    readonly executionPhase?: 'instantiation' | 'execution' | 'validation';
+    constructor(message: string, options?: {
+        variableId?: number;
+        bubbleName?: string;
+        executionPhase?: 'instantiation' | 'execution' | 'validation';
+        cause?: Error;
+    });
+}
+//# sourceMappingURL=bubble-errors.d.ts.map

package/dist/types/bubble-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubble-errors.d.ts","sourceRoot":"","sources":["../../src/types/bubble-errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAiBJ;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,SAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;gBAG1C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAMJ;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,SAAgB,cAAc,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,YAAY,CAAC;gBAG5E,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,YAAY,CAAC;QAC9D,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAMJ"}

package/dist/types/bubble-errors.js

@@ -0,0 +1,51 @@
+/**
+ * Custom error classes for bubble operations
+ * These errors carry metadata like variableId to enable better error tracking and logging
+ */
+/**
+ * Base error class for all bubble-related errors
+ * Includes variableId and bubbleName for context tracking
+ */
+export class BubbleError extends Error {
+    variableId;
+    bubbleName;
+    constructor(message, options) {
+        super(message);
+        this.name = 'BubbleError';
+        this.variableId = options?.variableId;
+        this.bubbleName = options?.bubbleName;
+        // Maintain proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        // Attach the original cause if provided
+        if (options?.cause) {
+            this.cause = options.cause;
+        }
+    }
+}
+/**
+ * Thrown when bubble parameter validation fails
+ * Used in BaseBubble constructor when schema.parse() fails
+ */
+export class BubbleValidationError extends BubbleError {
+    validationErrors;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'BubbleValidationError';
+        this.validationErrors = options?.validationErrors;
+    }
+}
+/**
+ * Thrown when bubble execution fails during performAction
+ * Used in BaseBubble.action() when the operation fails
+ */
+export class BubbleExecutionError extends BubbleError {
+    executionPhase;
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'BubbleExecutionError';
+        this.executionPhase = options?.executionPhase;
+    }
+}
+//# sourceMappingURL=bubble-errors.js.map

package/dist/types/bubble-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubble-errors.js","sourceRoot":"","sources":["../../src/types/bubble-errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,UAAU,CAAU;IACpB,UAAU,CAAU;IAEpC,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QAEtC,oFAAoF;QACpF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;QAED,wCAAwC;QACxC,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpC,gBAAgB,CAAY;IAE5C,YACE,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,CAAC;IACpD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnC,cAAc,CAAgD;IAE9E,YACE,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,CAAC;IAChD,CAAC;CACF"}

package/dist/types/bubble.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import type { DatabaseMetadata, CredentialOptions, DependencyGraphNode } from '@bubblelab/shared-schemas';
+import type { BubbleLogger } from '../logging/BubbleLogger';
+export interface IBubble<TResult extends BubbleOperationResult = BubbleOperationResult> {
+    readonly name: string;
+    readonly schema: z.ZodObject<z.ZodRawShape>;
+    readonly resultSchema: z.ZodObject<z.ZodRawShape>;
+    readonly shortDescription: string;
+    readonly longDescription: string;
+    readonly alias?: string;
+    readonly type: 'service' | 'workflow' | 'tool' | 'ui' | 'infra';
+    previousResult: BubbleResult<BubbleOperationResult> | undefined;
+    action: () => Promise<BubbleResult<TResult>>;
+    saveResult: <R extends BubbleOperationResult>(result: BubbleResult<R>) => void;
+    clearSavedResult: () => void;
+    generateMockResult: () => BubbleResult<TResult>;
+    generateMockResultWithSeed: (seed: number) => BubbleResult<TResult>;
+}
+export interface IServiceBubble<TResult extends BubbleOperationResult = BubbleOperationResult> extends IBubble<TResult> {
+    readonly type: 'service';
+    authType?: 'oauth' | 'apikey' | 'none' | 'connection-string';
+    testCredential: () => Promise<boolean>;
+    setCredentials: (credentials: Record<string, string>) => void;
+    setParam: (paramName: string, paramValue: unknown) => void;
+    getCredentialMetadata: () => Promise<DatabaseMetadata | undefined>;
+}
+export interface IWorkflowBubble<TResult extends BubbleOperationResult = BubbleOperationResult> extends IBubble<TResult> {
+    readonly type: 'workflow';
+}
+export interface IToolBubble<TResult extends BubbleOperationResult = BubbleOperationResult> extends IBubble<TResult> {
+    readonly type: 'tool';
+}
+export interface IUIBubble extends IBubble {
+    readonly type: 'ui';
+    template: string;
+}
+export interface IInfraBubble extends IBubble {
+    readonly type: 'infra';
+    provider: 'aws' | 'gcp' | 'supabase';
+    resourceType: string;
+}
+export interface BubbleOperationResult {
+    success: boolean;
+    error: string;
+}
+export type BubbleFlowOperationResult = unknown;
+export interface BubbleResult<T> extends BubbleOperationResult {
+    data: T;
+    executionId: string;
+    timestamp: Date;
+}
+export interface BubbleContext {
+    logger?: BubbleLogger;
+    variableId?: number;
+    /**
+     * Dependency graph for the current bubble flow, used to deduce child variable IDs.
+     */
+    dependencyGraph?: DependencyGraphNode;
+    /**
+     * The unique hierarchical id of the current bubble within the dependency graph.
+     * Root is typically something like `${bubbleName}#1`.
+     */
+    currentUniqueId?: string;
+    /**
+     * Internal usage counters keyed by `${currentUniqueId||'ROOT'}|${childName}` to derive next ordinal.
+     */
+    __uniqueIdCounters__?: Record<string, number>;
+    [key: string]: unknown;
+}
+export type ServiceBubbleParams<T = unknown> = T & {
+    credentials?: CredentialOptions;
+};
+//# sourceMappingURL=bubble.d.ts.map

package/dist/types/bubble.d.ts.map

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

package/dist/types/bubble.js

@@ -0,0 +1,2 @@
+import { z } from 'zod';
+//# sourceMappingURL=bubble.js.map

package/dist/types/bubble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubble.js","sourceRoot":"","sources":["../../src/types/bubble.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/types/credentials.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Import CredentialType from shared schemas to maintain single source of truth
+ */
+import { CREDENTIAL_CONFIGURATION_MAP, CREDENTIAL_ENV_MAP } from '@bubblelab/shared-schemas';
+export { CREDENTIAL_CONFIGURATION_MAP, CREDENTIAL_ENV_MAP };
+//# sourceMappingURL=credentials.d.ts.map

package/dist/types/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/types/credentials.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/types/credentials.js

@@ -0,0 +1,6 @@
+/**
+ * Import CredentialType from shared schemas to maintain single source of truth
+ */
+import { CREDENTIAL_CONFIGURATION_MAP, CREDENTIAL_ENV_MAP, } from '@bubblelab/shared-schemas';
+export { CREDENTIAL_CONFIGURATION_MAP, CREDENTIAL_ENV_MAP };
+//# sourceMappingURL=credentials.js.map

package/dist/types/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/types/credentials.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/types/service-bubble-class.d.ts

@@ -0,0 +1,31 @@
+import type { BubbleOperationResult, ServiceBubbleParams, BubbleContext } from './bubble.js';
+import { BaseBubble } from './base-bubble-class.js';
+import type { DatabaseMetadata } from '@bubblelab/shared-schemas';
+export declare abstract class ServiceBubble<TParams extends ServiceBubbleParams = ServiceBubbleParams, TResult extends BubbleOperationResult = BubbleOperationResult> extends BaseBubble<TParams, TResult> {
+    readonly type: "service";
+    authType?: 'oauth' | 'apikey' | 'none' | 'connection-string';
+    constructor(params: unknown, context?: BubbleContext);
+    abstract testCredential(): Promise<boolean>;
+    /**
+     * Abstract method to choose the appropriate credential based on bubble parameters
+     * Should examine this.params to determine which credential to use from the injected credentials
+     * Must be implemented by all service bubbles
+     */
+    protected abstract chooseCredential(): string | undefined;
+    /**
+     * Abstract method to get the metadata of the credential
+     * Must be implemented by all service bubbles
+     */
+    getCredentialMetadata(): Promise<DatabaseMetadata | undefined>;
+    /**
+     * Get the current parameters
+     */
+    get currentParams(): TParams;
+    setCredentials(credentials: Record<string, string>): void;
+    setParam(paramName: string, paramValue: unknown): void;
+    /**
+     * Get the current context
+     */
+    get currentContext(): BubbleContext | undefined;
+}
+//# sourceMappingURL=service-bubble-class.d.ts.map

package/dist/types/service-bubble-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bubble-class.d.ts","sourceRoot":"","sources":["../../src/types/service-bubble-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,8BAAsB,aAAa,CACjC,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EACzD,OAAO,SAAS,qBAAqB,GAAG,qBAAqB,CAC7D,SAAQ,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;IACpC,SAAgB,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,mBAAmB,CAAC;gBAExD,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa;aAIpC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAElD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAEzD;;;OAGG;IAEG,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAIpE;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIlD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAKtD;;OAEG;IACH,IAAI,cAAc,IAAI,aAAa,GAAG,SAAS,CAE9C;CACF"}

package/dist/types/service-bubble-class.js

@@ -0,0 +1,36 @@
+import { BaseBubble } from './base-bubble-class.js';
+export class ServiceBubble extends BaseBubble {
+    type = 'service';
+    authType;
+    constructor(params, context) {
+        super(params, context);
+    }
+    /**
+     * Abstract method to get the metadata of the credential
+     * Must be implemented by all service bubbles
+     */
+    // Optional method, only used for database bubbles
+    async getCredentialMetadata() {
+        return undefined;
+    }
+    /**
+     * Get the current parameters
+     */
+    get currentParams() {
+        return this.params;
+    }
+    setCredentials(credentials) {
+        this.params.credentials = credentials;
+    }
+    setParam(paramName, paramValue) {
+        this.params[paramName] =
+            paramValue;
+    }
+    /**
+     * Get the current context
+     */
+    get currentContext() {
+        return this.context;
+    }
+}
+//# sourceMappingURL=service-bubble-class.js.map

package/dist/types/service-bubble-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bubble-class.js","sourceRoot":"","sources":["../../src/types/service-bubble-class.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,MAAM,OAAgB,aAGpB,SAAQ,UAA4B;IACpB,IAAI,GAAG,SAAkB,CAAC;IACnC,QAAQ,CAAqD;IAEpE,YAAY,MAAe,EAAE,OAAuB;QAClD,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;IAWD;;;OAGG;IACH,kDAAkD;IAClD,KAAK,CAAC,qBAAqB;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,cAAc,CAAC,WAAmC;QAChD,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;IACxC,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,UAAmB;QAC7C,IAAI,CAAC,MAAM,CAAC,SAA0B,CAAC;YACrC,UAAoC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/types/streaming-events.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared types for streaming log events between backend and frontend
+ */
+export interface StreamingLogEvent {
+    type: 'log_line' | 'bubble_instantiation' | 'bubble_execution' | 'bubble_start' | 'bubble_complete' | 'execution_complete' | 'error' | 'stream_complete' | 'info' | 'warn' | 'debug' | 'trace' | 'fatal';
+    timestamp: string;
+    lineNumber?: number;
+    message: string;
+    bubbleId?: string;
+    bubbleName?: string;
+    variableName?: string;
+    additionalData?: Record<string, unknown>;
+    executionTime?: number;
+    memoryUsage?: number;
+    logLevel?: string;
+}
+export type StreamCallback = (event: StreamingLogEvent) => void | Promise<void>;
+//# sourceMappingURL=streaming-events.d.ts.map

package/dist/types/streaming-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-events.d.ts","sourceRoot":"","sources":["../../src/types/streaming-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EACA,UAAU,GACV,sBAAsB,GACtB,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,OAAO,GACP,iBAAiB,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/types/streaming-events.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for streaming log events between backend and frontend
+ */
+export {};
+//# sourceMappingURL=streaming-events.js.map

package/dist/types/streaming-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-events.js","sourceRoot":"","sources":["../../src/types/streaming-events.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/tool-bubble-class.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { IToolBubble, ServiceBubbleParams, BubbleContext, BubbleOperationResult, BubbleResult } from './bubble.js';
+import { BaseBubble } from './base-bubble-class.js';
+import { CredentialType } from '@bubblelab/shared-schemas';
+export interface LangGraphTool {
+    name: string;
+    description: string;
+    schema: z.ZodSchema;
+    func<TResult extends BubbleOperationResult = BubbleOperationResult>(params: unknown): Promise<BubbleResult<TResult>>;
+}
+/**
+ * Abstract base class for all tool bubbles that can be converted to LangGraph tools
+ */
+export declare abstract class ToolBubble<TParams extends ServiceBubbleParams = ServiceBubbleParams, TResult extends BubbleOperationResult = BubbleOperationResult> extends BaseBubble<TParams, TResult> implements IToolBubble<TResult> {
+    readonly type: "tool";
+    constructor(params: unknown, context?: BubbleContext);
+    static toolAgent(credentials?: Partial<Record<CredentialType, string>>, config?: Record<string, unknown>, context?: BubbleContext): LangGraphTool;
+}
+//# sourceMappingURL=tool-bubble-class.d.ts.map

package/dist/types/tool-bubble-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bubble-class.d.ts","sourceRoot":"","sources":["../../src/types/tool-bubble-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,IAAI,CAAC,OAAO,SAAS,qBAAqB,GAAG,qBAAqB,EAChE,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,8BAAsB,UAAU,CAC5B,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EACzD,OAAO,SAAS,qBAAqB,GAAG,qBAAqB,CAE/D,SAAQ,UAAU,CAAC,OAAO,EAAE,OAAO,CACnC,YAAW,WAAW,CAAC,OAAO,CAAC;IAE/B,SAAgB,IAAI,EAAG,MAAM,CAAU;gBAE3B,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa;IAKpD,MAAM,CAAC,SAAS,CACd,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,EACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,aAAa,GACtB,aAAa;CA4CjB"}

package/dist/types/tool-bubble-class.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { BaseBubble } from './base-bubble-class.js';
+import { CredentialType } from '@bubblelab/shared-schemas';
+/**
+ * Abstract base class for all tool bubbles that can be converted to LangGraph tools
+ */
+export class ToolBubble extends BaseBubble {
+    type = 'tool';
+    constructor(params, context) {
+        super(params, context);
+    }
+    // Static method - returns LangChain tool with credentials injected
+    static toolAgent(credentials, config, context) {
+        // In static context, 'this' refers to the constructor/class
+        const ToolClass = this;
+        const { schema, bubbleName, shortDescription } = ToolClass;
+        if (!schema || !bubbleName || !shortDescription) {
+            throw new Error(`${ToolClass.name} must define static schema, bubbleName, and shortDescription`);
+        }
+        // Remove credentials from schema for agent use
+        // Remove config from schema for agent use
+        let agentSchema = schema;
+        if (schema.shape?.credentials) {
+            agentSchema = schema.omit({ credentials: true });
+        }
+        if (agentSchema.shape?.config) {
+            agentSchema = agentSchema.omit({ config: true });
+        }
+        return {
+            name: bubbleName,
+            description: shortDescription,
+            schema: agentSchema,
+            func: async (toolParams) => {
+                // Create instance with credentials and config injected
+                const enrichedParams = {
+                    ...toolParams,
+                    credentials,
+                    config,
+                };
+                // 'this' in static context is the constructor
+                const instance = new ToolClass(enrichedParams, context);
+                // Use performAction directly to get raw result, not wrapped BubbleResult
+                return instance.action();
+            },
+        };
+    }
+}
+//# sourceMappingURL=tool-bubble-class.js.map

package/dist/types/tool-bubble-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bubble-class.js","sourceRoot":"","sources":["../../src/types/tool-bubble-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAY3D;;GAEG;AACH,MAAM,OAAgB,UAIpB,SAAQ,UAA4B;IAGpB,IAAI,GAAG,MAAe,CAAC;IAEvC,YAAY,MAAe,EAAE,OAAuB;QAClD,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,SAAS,CACd,WAAqD,EACrD,MAAgC,EAChC,OAAuB;QAEvB,4DAA4D;QAC5D,MAAM,SAAS,GAAG,IAIjB,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC;QAE3D,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,CAAC,IAAI,8DAA8D,CAChF,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,0CAA0C;QAC1C,IAAI,WAAW,GAAqB,MAAM,CAAC;QAC3C,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;YAC9B,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAC9B,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,gBAAgB;YAC7B,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,KAAK,EAAE,UAAmB,EAAE,EAAE;gBAClC,uDAAuD;gBACvD,MAAM,cAAc,GAAG;oBACrB,GAAI,UAAqB;oBACzB,WAAW;oBACX,MAAM;iBACP,CAAC;gBAEF,8CAA8C;gBAC9C,MAAM,QAAQ,GAAG,IAAK,SAAiB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACjE,yEAAyE;gBACzE,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC3B,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}