@bubblelab/bubble-core 0.1.56 → 0.1.58

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-01-29T02:54:06.386Z",
+  "generatedAt": "2026-01-29T08:09:04.459Z",
   "totalCount": 58,
   "bubbles": [
     {

package/dist/recording/types.d.ts

@@ -0,0 +1,68 @@
+import type { BubbleContext } from '../types/bubble.js';
+/**
+ * Represents an artifact captured during step execution.
+ * Artifacts can be screenshots, HTML snapshots, URLs, or custom data.
+ */
+export interface StepArtifact {
+    type: 'screenshot' | 'html' | 'url' | 'custom';
+    label: string;
+    data: string;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Represents a recorded step with timing, status, and artifacts.
+ */
+export interface RecordedStep {
+    id: string;
+    name: string;
+    methodName: string;
+    args?: unknown[];
+    startTime: Date;
+    endTime?: Date;
+    durationMs?: number;
+    status: 'pending' | 'running' | 'success' | 'error';
+    error?: string;
+    beforeArtifacts: StepArtifact[];
+    afterArtifacts: StepArtifact[];
+    parentStepId?: string;
+    childStepIds: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for configuring what artifacts to capture for a step.
+ */
+export interface RecordStepOptions {
+    screenshotBefore?: boolean;
+    screenshotAfter?: boolean;
+    htmlBefore?: boolean;
+    htmlAfter?: boolean;
+    urlBefore?: boolean;
+    urlAfter?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Default options for recording steps.
+ * By default, captures screenshots and URLs before/after each step.
+ */
+export declare const DEFAULT_RECORD_STEP_OPTIONS: RecordStepOptions;
+/**
+ * Context interface for recording operations.
+ * Implementations handle artifact capture and step storage.
+ */
+export interface RecordingContext {
+    readonly enabled: boolean;
+    captureScreenshot(sessionId: string, label: string): Promise<string | null>;
+    captureHtml(sessionId: string, label: string, selector?: string): Promise<string | null>;
+    captureUrl(sessionId: string): Promise<string | null>;
+    storeStep(step: RecordedStep): void;
+    getSteps(): RecordedStep[];
+    clearSteps(): void;
+}
+/**
+ * Extended BubbleContext that includes an optional recording context.
+ */
+export interface RecordableBubbleContext extends BubbleContext {
+    recordingContext?: RecordingContext;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recording/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAOzC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5E,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC3B,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC"}

package/dist/recording/types.js

@@ -0,0 +1,13 @@
+/**
+ * Default options for recording steps.
+ * By default, captures screenshots and URLs before/after each step.
+ */
+export const DEFAULT_RECORD_STEP_OPTIONS = {
+    screenshotBefore: true,
+    screenshotAfter: true,
+    htmlBefore: false,
+    htmlAfter: false,
+    urlBefore: true,
+    urlAfter: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/recording/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recording/types.ts"],"names":[],"mappings":"AA+CA;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsB;IAC5D,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,IAAI;CACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblelab/bubble-core",
-  "version": "0.1.56",
+  "version": "0.1.58",
   "type": "module",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
     "puppeteer-core": "^24.10.0",
     "resend": "^4.8.0",
     "zod": "^3.24.1",
-    "@bubblelab/shared-schemas": "0.1.57"
+    "@bubblelab/shared-schemas": "0.1.59"
   },
   "devDependencies": {
     "zod-to-json-schema": "^3.24.6",