btcp-browser-agent 0.1.0

package/src/index.ts

@@ -0,0 +1,64 @@
+/**
+ * BTCP Browser Agent
+ *
+ * Browser automation with clean separation of concerns:
+ * - ContentAgent (@btcp/core): DOM operations in content scripts
+ * - BackgroundAgent (@btcp/extension): Tab management in background scripts
+ * - Client: API for sending commands from popup/external scripts
+ *
+ * @example Extension usage
+ * ```typescript
+ * // background.ts
+ * import { BackgroundAgent, setupMessageListener } from '@btcp/browser-agent/extension';
+ * setupMessageListener();
+ *
+ * // content.ts
+ * import { createContentAgent } from '@btcp/browser-agent/core';
+ * const agent = createContentAgent();
+ *
+ * // popup.ts
+ * import { createClient } from '@btcp/browser-agent/extension';
+ * const client = createClient();
+ * ```
+ *
+ * @example Standalone usage (no extension)
+ * ```typescript
+ * import { createContentAgent } from '@btcp/browser-agent';
+ * const agent = createContentAgent();
+ * await agent.execute({ id: '1', action: 'snapshot' });
+ * ```
+ */
+
+// Re-export everything from core (for standalone usage)
+export {
+  createContentAgent,
+  type ContentAgent,
+  DOMActions,
+  createSnapshot,
+  createRefMap,
+  createSimpleRefMap,
+  type Command,
+  type Response,
+  type SnapshotData,
+  type BoundingBox,
+  type RefMap,
+  type Modifier,
+} from '../packages/core/dist/index.js';
+
+// Re-export extension types and utilities
+export type {
+  ExtensionMessage,
+  ExtensionResponse,
+  TabInfo,
+  ChromeTab,
+  ExtensionCommand,
+} from '../packages/extension/dist/index.js';
+
+// Re-export extension functions
+export {
+  BackgroundAgent,
+  getBackgroundAgent,
+  setupMessageListener,
+  createClient,
+  type Client,
+} from '../packages/extension/dist/index.js';

package/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "packages", "**/*.test.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "baseUrl": ".",
+    "paths": {
+      "@btcp/core": ["./packages/core/dist/index.d.ts"],
+      "@btcp/extension": ["./packages/extension/dist/index.d.ts"]
+    },
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "packages"]
+}

package/vitest.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'jsdom',
+    globals: true,
+    include: ['src/**/*.test.ts', 'packages/**/*.test.ts'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+    },
+  },
+});