@braintrust/browser 0.0.2-rc.0

package/README.md

@@ -0,0 +1,75 @@
+# Braintrust Browser SDK
+
+Official browser-only SDK for [Braintrust](https://braintrust.dev).
+
+This is an integration package that provides browser-optimized builds of the Braintrust SDK with AsyncLocalStorage polyfill support for standard browsers.
+
+## Installation
+
+```bash
+npm install @braintrust/browser braintrust
+# or
+pnpm add @braintrust/browser braintrust
+# or
+yarn add @braintrust/browser braintrust
+```
+
+Note: `braintrust` is a peer dependency and must be installed alongside `@braintrust/browser`.
+
+## Usage
+
+```typescript
+import * as braintrust from "@braintrust/browser";
+
+const experiment = await braintrust.init("BrowserExperiment", {
+  apiKey: "YOUR_API_KEY",
+});
+
+// Use tracing in browser
+const result = await braintrust.traced(
+  async () => {
+    // Your code here
+    return "result";
+  },
+  { name: "myOperation" },
+);
+```
+
+## Differences from Main Package
+
+This package:
+
+- **Includes** `als-browser` polyfill for AsyncLocalStorage (bundled)
+- **Requires** `braintrust` as a peer dependency
+
+## When to Use
+
+Use `@braintrust/browser` when:
+
+- Building browser-only applications
+- Need AsyncLocalStorage support in standard browsers
+
+Use `braintrust` directly when:
+
+- Building Node.js applications
+- Using in Next.js or other full-stack frameworks (with proper module resolution)
+- Need CLI tools or filesystem access
+
+## Features
+
+All browser-compatible features from the main SDK:
+
+- Logging and tracing
+- Experiments and datasets
+- Prompt management
+- AI provider wrappers (OpenAI, Anthropic, Google)
+- Evaluation framework
+- OpenTelemetry integration
+
+## Documentation
+
+For full documentation, visit [https://www.braintrust.dev/docs](https://www.braintrust.dev/docs)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from 'braintrust';

package/dist/index.js

@@ -0,0 +1,41 @@
+import { _internalIso, _internalSetInitialState } from 'braintrust';
+export * from 'braintrust';
+import { AsyncLocalStorage } from 'als-browser';
+
+// src/browser-config.ts
+var browserConfigured = false;
+function configureBrowser() {
+  if (browserConfigured) {
+    return;
+  }
+  _internalIso.buildType = "browser";
+  _internalIso.newAsyncLocalStorage = () => new AsyncLocalStorage();
+  _internalIso.getEnv = (name) => {
+    if (typeof process === "undefined" || typeof process.env === "undefined") {
+      return void 0;
+    }
+    return process.env[name];
+  };
+  _internalIso.getRepoInfo = async () => ({
+    commit: null,
+    branch: null,
+    tag: null,
+    dirty: false
+  });
+  _internalIso.getCallerLocation = () => void 0;
+  _internalIso.hash = (data) => {
+    let hash = 0;
+    for (let i = 0; i < data.length; i++) {
+      const char = data.charCodeAt(i);
+      hash = (hash << 5) - hash + char;
+      hash = hash & hash;
+    }
+    const hashHex = (hash >>> 0).toString(16).padStart(8, "0");
+    return hashHex.repeat(8).substring(0, 64);
+  };
+  _internalSetInitialState();
+  browserConfigured = true;
+}
+configureBrowser();
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser-config.ts","../src/index.ts"],"names":["iso","BrowserAsyncLocalStorage"],"mappings":";;;;;AAGA,IAAI,iBAAA,GAAoB,KAAA;AAEjB,SAAS,gBAAA,GAAmB;AACjC,EAAA,IAAI,iBAAA,EAAmB;AACrB,IAAA;AAAA,EACF;AAGA,EAAAA,YAAA,CAAI,SAAA,GAAY,SAAA;AAEhB,EAAAA,YAAA,CAAI,oBAAA,GAAuB,MAAS,IAAIC,iBAAA,EAA4B;AAEpE,EAAAD,YAAA,CAAI,MAAA,GAAS,CAAC,IAAA,KAAiB;AAC7B,IAAA,IAAI,OAAO,OAAA,KAAY,WAAA,IAAe,OAAO,OAAA,CAAQ,QAAQ,WAAA,EAAa;AACxE,MAAA,OAAO,MAAA;AAAA,IACT;AACA,IAAA,OAAO,OAAA,CAAQ,IAAI,IAAI,CAAA;AAAA,EACzB,CAAA;AAGA,EAAAA,YAAA,CAAI,cAAc,aAAa;AAAA,IAC7B,MAAA,EAAQ,IAAA;AAAA,IACR,MAAA,EAAQ,IAAA;AAAA,IACR,GAAA,EAAK,IAAA;AAAA,IACL,KAAA,EAAO;AAAA,GACT,CAAA;AACA,EAAAA,YAAA,CAAI,oBAAoB,MAAM,MAAA;AAG9B,EAAAA,YAAA,CAAI,IAAA,GAAO,CAAC,IAAA,KAAyB;AAEnC,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACpC,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,CAAC,CAAA;AAC9B,MAAA,IAAA,GAAA,CAAQ,IAAA,IAAQ,KAAK,IAAA,GAAO,IAAA;AAC5B,MAAA,IAAA,GAAO,IAAA,GAAO,IAAA;AAAA,IAChB;AAEA,IAAA,MAAM,OAAA,GAAA,CAAW,SAAS,CAAA,EAAG,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAA;AACzD,IAAA,OAAO,QAAQ,MAAA,CAAO,CAAC,CAAA,CAAE,SAAA,CAAU,GAAG,EAAE,CAAA;AAAA,EAC1C,CAAA;AAEA,EAAA,wBAAA,EAAyB;AACzB,EAAA,iBAAA,GAAoB,IAAA;AACtB;AC7CA,gBAAA,EAAiB","file":"index.js","sourcesContent":["import { _internalIso as iso, _internalSetInitialState } from \"braintrust\";\nimport { AsyncLocalStorage as BrowserAsyncLocalStorage } from \"als-browser\";\n\nlet browserConfigured = false;\n\nexport function configureBrowser() {\n  if (browserConfigured) {\n    return;\n  }\n\n  // Set build type indicator\n  iso.buildType = \"browser\";\n\n  iso.newAsyncLocalStorage = <T>() => new BrowserAsyncLocalStorage<T>();\n\n  iso.getEnv = (name: string) => {\n    if (typeof process === \"undefined\" || typeof process.env === \"undefined\") {\n      return undefined;\n    }\n    return process.env[name];\n  };\n\n  // noop implementations for git config\n  iso.getRepoInfo = async () => ({\n    commit: null,\n    branch: null,\n    tag: null,\n    dirty: false,\n  });\n  iso.getCallerLocation = () => undefined;\n\n  // Implement browser-compatible hash function using a simple hash algorithm\n  iso.hash = (data: string): string => {\n    // Simple hash function for browser compatibility\n    let hash = 0;\n    for (let i = 0; i < data.length; i++) {\n      const char = data.charCodeAt(i);\n      hash = (hash << 5) - hash + char;\n      hash = hash & hash; // Convert to 32bit integer\n    }\n    // Convert to hex string\n    const hashHex = (hash >>> 0).toString(16).padStart(8, \"0\");\n    return hashHex.repeat(8).substring(0, 64); // Make it look like a SHA-256 hash length\n  };\n\n  _internalSetInitialState();\n  browserConfigured = true;\n}\n","import { configureBrowser } from \"./browser-config\";\n\nconfigureBrowser();\n\nexport * from \"braintrust\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@braintrust/browser",
+  "version": "0.0.2-rc.0",
+  "description": "Braintrust SDK for browser environments with AsyncLocalStorage polyfill",
+  "type": "module",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "watch": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "als-browser": "^1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.5",
+    "braintrust": "workspace:*",
+    "tsup": "^8.3.5",
+    "typescript": "^5.3.3",
+    "vitest": "^2.1.9"
+  },
+  "peerDependencies": {
+    "braintrust": ">=3.0.0",
+    "zod": "^3.25.34 || ^4.0"
+  },
+  "peerDependenciesMeta": {
+    "braintrust": {
+      "optional": false
+    },
+    "zod": {
+      "optional": false
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/braintrustdata/braintrust-sdk.git",
+    "directory": "sdk/integrations/browser-js"
+  },
+  "homepage": "https://www.braintrust.dev/docs",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}