dotdo 0.0.1 → 0.0.2

package/dist/lib/browse/cloudflare.js

@@ -0,0 +1,144 @@
+/**
+ * Cloudflare Browser Rendering Provider
+ *
+ * Implements the BrowseProvider interface using @cloudflare/puppeteer
+ * for Cloudflare Workers Browser Rendering.
+ */
+/**
+ * Cloudflare Browser Rendering provider implementation
+ */
+export class CloudflareBrowseProvider {
+    async init(config) {
+        // Validate BROWSER binding
+        if (!config.env?.BROWSER) {
+            throw new Error('Cloudflare provider requires BROWSER binding in env');
+        }
+        // Dynamically import cloudflare puppeteer
+        // @ts-ignore - Optional peer dependency
+        const puppeteer = await import('@cloudflare/puppeteer').catch(() => {
+            throw new Error('Package @cloudflare/puppeteer is required for Cloudflare provider. Run: npm install @cloudflare/puppeteer');
+        });
+        const browser = await puppeteer.default.launch(config.env.BROWSER);
+        const page = await browser.newPage();
+        // Apply viewport if specified
+        if (config.viewport) {
+            await page.setViewport(config.viewport);
+        }
+        // Initialize Stagehand for AI operations
+        // @ts-ignore - Optional peer dependency
+        const { Stagehand } = await import('@browserbasehq/stagehand').catch(() => {
+            throw new Error('Package @browserbasehq/stagehand is required for Cloudflare provider. Run: npm install @browserbasehq/stagehand');
+        });
+        const stagehand = new Stagehand({
+            env: 'LOCAL',
+            enableCaching: false,
+        });
+        // Track if session is closed
+        let closed = false;
+        // Create session object
+        const session = {
+            async goto(url) {
+                if (closed) {
+                    throw new Error('Session is closed');
+                }
+                // Validate URL
+                try {
+                    new URL(url);
+                }
+                catch {
+                    throw new Error(`Invalid URL: ${url}`);
+                }
+                await page.goto(url);
+            },
+            async act(instruction) {
+                if (closed) {
+                    throw new Error('Session is closed');
+                }
+                try {
+                    const result = await stagehand.act(instruction);
+                    return {
+                        success: true,
+                        action: result?.action ?? instruction,
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    };
+                }
+            },
+            async extract(instruction, schema) {
+                if (closed) {
+                    throw new Error('Session is closed');
+                }
+                const result = await stagehand.extract(instruction, { schema });
+                return result;
+            },
+            async observe(instruction) {
+                if (closed) {
+                    throw new Error('Session is closed');
+                }
+                const result = await stagehand.observe(instruction);
+                return result.map((item) => ({
+                    action: item.action ?? 'unknown',
+                    selector: item.selector,
+                    description: item.description ?? '',
+                }));
+            },
+            async screenshot(options) {
+                if (closed) {
+                    throw new Error('Session is closed');
+                }
+                const screenshotOptions = {
+                    encoding: 'base64',
+                };
+                if (options?.fullPage) {
+                    screenshotOptions.fullPage = true;
+                }
+                if (options?.type) {
+                    screenshotOptions.type = options.type;
+                }
+                if (options?.quality && options.type === 'jpeg') {
+                    screenshotOptions.quality = options.quality;
+                }
+                // Handle selector option by finding element first
+                if (options?.selector) {
+                    const element = await page.$(options.selector);
+                    if (element) {
+                        const buffer = await element.screenshot(screenshotOptions);
+                        return typeof buffer === 'string' ? buffer : buffer.toString('base64');
+                    }
+                }
+                const buffer = await page.screenshot(screenshotOptions);
+                return typeof buffer === 'string' ? buffer : buffer.toString('base64');
+            },
+            async close() {
+                if (closed) {
+                    return; // Already closed, no-op
+                }
+                closed = true;
+                try {
+                    await stagehand.close();
+                }
+                catch {
+                    // Ignore stagehand close errors
+                }
+                try {
+                    await page.close();
+                }
+                catch {
+                    // Ignore page close errors
+                }
+                try {
+                    await browser.close();
+                }
+                catch {
+                    // Ignore browser close errors
+                }
+            },
+        };
+        return session;
+    }
+}
+//# sourceMappingURL=cloudflare.js.map

package/dist/lib/browse/cloudflare.js.map

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

package/dist/lib/browse/index.js

@@ -0,0 +1,62 @@
+/**
+ * Browse Library - Provider Abstraction for Browser Automation
+ *
+ * Abstracts Stagehand usage across Cloudflare Browser Rendering and Browserbase.
+ * Provides a unified interface for AI-powered browser automation.
+ *
+ * @example
+ * ```typescript
+ * // Cloudflare Browser Rendering
+ * const session = await Browse.init({
+ *   provider: 'cloudflare',
+ *   env: { BROWSER: env.BROWSER },
+ * })
+ *
+ * // Browserbase with live view
+ * const session = await Browse.init({
+ *   provider: 'browserbase',
+ *   env: {
+ *     BROWSERBASE_API_KEY: env.BROWSERBASE_API_KEY,
+ *     BROWSERBASE_PROJECT_ID: env.BROWSERBASE_PROJECT_ID,
+ *   },
+ *   liveView: true,
+ * })
+ *
+ * await session.goto('https://example.com.ai')
+ * await session.act('Click the login button')
+ * const data = await session.extract('Get the user profile')
+ * await session.close()
+ * ```
+ */
+// ============================================================================
+// Provider Implementations
+// ============================================================================
+import { CloudflareBrowseProvider } from './cloudflare';
+import { BrowserbaseBrowseProvider } from './browserbase';
+// ============================================================================
+// Browse Factory
+// ============================================================================
+/**
+ * Browse - Factory for creating browser automation sessions
+ *
+ * Abstracts browser automation across Cloudflare and Browserbase providers,
+ * wrapping Stagehand for AI-powered interactions.
+ */
+export const Browse = {
+    /**
+     * Initialize a browser session with the specified provider
+     */
+    async init(config) {
+        const provider = config.provider ?? 'cloudflare';
+        // Validate provider
+        if (provider !== 'cloudflare' && provider !== 'browserbase') {
+            throw new Error(`Invalid provider: ${provider}. Must be 'cloudflare' or 'browserbase'.`);
+        }
+        // Select and initialize provider
+        const providerImpl = provider === 'cloudflare'
+            ? new CloudflareBrowseProvider()
+            : new BrowserbaseBrowseProvider();
+        return providerImpl.init(config);
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/browse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/browse/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAqGH,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AAEzD,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAwB;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAA;QAEhD,oBAAoB;QACpB,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,0CAA0C,CAAC,CAAA;QAC1F,CAAC;QAED,iCAAiC;QACjC,MAAM,YAAY,GAChB,QAAQ,KAAK,YAAY;YACvB,CAAC,CAAC,IAAI,wBAAwB,EAAE;YAChC,CAAC,CAAC,IAAI,yBAAyB,EAAE,CAAA;QAErC,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;CACF,CAAA"}

package/dist/lib/browse/types.js

@@ -0,0 +1,13 @@
+/**
+ * Browse Types - Shared type definitions for browser automation
+ *
+ * This module exists to break circular dependencies between:
+ * - lib/browse/index.ts
+ * - lib/browse/browserbase.ts
+ * - lib/browse/cloudflare.ts
+ *
+ * By extracting shared types here, all modules can import from this
+ * shared file without creating import cycles.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/browse/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../lib/browse/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/lib/cache/index.js

@@ -0,0 +1,37 @@
+/**
+ * Cache module exports
+ *
+ * Provides visibility-aware caching utilities for dotdo.
+ *
+ * @example
+ * ```typescript
+ * import { createVisibilityCache, type Visibility } from './lib/cache'
+ *
+ * const cache = createVisibilityCache()
+ *
+ * // Cache public data with long TTL
+ * await cache.set({
+ *   key: 'products:featured',
+ *   visibility: 'public',
+ *   data: products,
+ * })
+ *
+ * // Cache org-scoped data
+ * await cache.set({
+ *   key: 'customers:list',
+ *   visibility: 'org',
+ *   context: { orgId: 'org-123' },
+ *   data: customers,
+ * })
+ * ```
+ */
+export { 
+// Constants
+DEFAULT_TTL_CONFIG, VISIBILITY_PREFIXES, 
+// Utility Functions
+validateVisibility, validateCacheContext, getTTLForVisibility, hashContext, buildCacheKey, parseCacheKey, 
+// Classes
+VisibilityCache, CloudflareVisibilityCache, 
+// Factory Functions
+createVisibilityCache, createCloudflareVisibilityCache, createSeparatedCachePools, } from './visibility';
+//# sourceMappingURL=index.js.map

package/dist/lib/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO;AAYL,YAAY;AACZ,kBAAkB,EAClB,mBAAmB;AAEnB,oBAAoB;AACpB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,aAAa;AAEb,UAAU;AACV,eAAe,EACf,yBAAyB;AAEzB,oBAAoB;AACpB,qBAAqB,EACrB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,cAAc,CAAA"}