@convai/embody 0.1.0 → 0.2.1

package/dist/resolve/resolver.js

@@ -21,15 +21,45 @@
  * than trusted.
  */
 export const DEFAULT_BASE_URL = 'https://api-stg.convai.com';
+/** Shared so `createCharacter` and the resolver cannot drift apart. */
+export const MISSING_CREDENTIAL = '@convai/embody: a credential is required — pass `token` (recommended for ' +
+    'browsers) or `apiKey`. There is no anonymous access to Convai.';
 export function httpResolver(opts = {}) {
     const baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL;
     return {
         async resolve(characterId) {
+            // Header names are NOT a choice — they are what the backend reads.
+            // middleman looks at exactly "API-AUTH-TOKEN" and "CONVAI-API-KEY";
+            // an Authorization: Bearer header is ignored. Precedence (token over
+            // key) mirrors the SDK's /connect and middleman's own order.
+            //
+            // A request with neither is refused here rather than sent: there is no
+            // anonymous access to Convai, so an unauthenticated request cannot
+            // succeed — it would fail later, further from the cause.
+            const headers = {};
+            if (opts.authToken)
+                headers['API-AUTH-TOKEN'] = opts.authToken;
+            else if (opts.apiKey)
+                headers['CONVAI-API-KEY'] = opts.apiKey;
+            else
+                throw new Error(MISSING_CREDENTIAL);
             const res = await fetch(`${baseUrl}/character/${characterId}/embodiment`, {
-                headers: opts.apiKey ? { 'CONVAI-API-KEY': opts.apiKey } : undefined,
+                headers,
             });
-            if (!res.ok)
-                throw new Error(`embodiment resolve failed: HTTP ${res.status}`);
+            if (!res.ok) {
+                // The body carries the actionable half — "Character has no 3D
+                // embodiment configured" reads very differently from a 401, and a
+                // bare status code sends people to the wrong problem.
+                const detail = await res.text().then((t) => {
+                    try {
+                        return JSON.parse(t).ERROR ?? t.slice(0, 200);
+                    }
+                    catch {
+                        return t.slice(0, 200);
+                    }
+                }, () => '');
+                throw new Error(`embodiment resolve failed for ${characterId}: HTTP ${res.status}${detail ? ` — ${detail}` : ''}`);
+            }
             return (await res.json());
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@convai/embody",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Give a Convai character a body: resolve 3D characters by characterId and drive them with lipsync and animation. Layered on @convai/web-sdk.",
   "license": "Apache-2.0",
   "author": "Convai <support@convai.com>",
@@ -33,11 +33,13 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./react": {
       "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js"
+      "import": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -74,6 +76,7 @@
     "@convai/web-sdk": "1.8.0-beta.4",
     "@react-three/fiber": "^8.18.0",
     "@types/react": "^18.3.31",
+    "@types/react-dom": "^19.2.7",
     "@types/react-test-renderer": "18.3.1",
     "@types/three": "^0.182.0",
     "react": "^18.3.1",
@@ -95,12 +98,13 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
-    "verify": "pnpm check:hosts && pnpm typecheck && pnpm test && pnpm build",
+    "verify": "pnpm check:hosts && pnpm check:tests && pnpm typecheck && pnpm test && pnpm build",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "pnpm build:prod && changeset publish",
     "release:beta": "pnpm build:beta && changeset publish --tag beta",
     "check:hosts": "node scripts/check-hosts.mjs",
+    "check:tests": "node scripts/check-tests.mjs",
     "build:stg": "pnpm clean && BRANCH=stg node scripts/check-hosts.mjs && pnpm build",
     "release:stg": "pnpm build:stg && changeset publish --tag stg",
     "docs": "typedoc",