realtime-avatar 0.3.0

package/dist/types-E8SrD6sv.d.ts

@@ -0,0 +1,48 @@
+import { C as CallMode, a as CallPolicy } from './types-C_EMPwN7.js';
+
+/** The three things a caller can ask the proxy to do. Gate on these, not on URLs. */
+type ProxyOperation = "connect" | "end" | "avatars" | "credits";
+interface AuthorizeContext {
+    request: Request;
+    operation: ProxyOperation;
+}
+interface SessionContext {
+    request: Request;
+    /** Which character the caller asked for. Validate it — it came from the client. */
+    avatarId: string;
+    mode: CallMode;
+}
+interface ProxyConfig {
+    /** Server-only. `tic_live_…` / `tic_test_…`. */
+    apiKey: string | (() => string | Promise<string>);
+    baseUrl?: string;
+    /**
+     * Who may do this. Return a `Response` to refuse, or nothing to allow.
+     *
+     * `connect` is the only operation that costs money to start, so that is where a wallet
+     * check belongs. Leaving the reads ungated keeps them cheap.
+     */
+    authorize?: (context: AuthorizeContext) => Promise<Response | void> | Response | void;
+    /**
+     * Does this request own that session? Answer for `POST …/end`.
+     *
+     * Without it the handler remembers what it minted IN PROCESS, which is correct for one
+     * server and wrong for serverless, where the next request lands somewhere else and every
+     * release is silently declined. Back this with whatever already knows which user started
+     * which call, and return false for anything else — rule 12 exists because a route that
+     * ends an arbitrary id lets any visitor hang up any call on your account.
+     */
+    ownsSession?: (context: {
+        request: Request;
+        sessionId: string;
+    }) => Promise<boolean> | boolean;
+    /**
+     * What the character knows for THIS call. Return a policy, or a `Response` to refuse.
+     *
+     * Whatever the browser sent for these concerns is discarded — this is the only source.
+     * A field you do not set is absent rather than inherited, so an omission fails closed.
+     */
+    session?: (context: SessionContext) => Promise<CallPolicy | Response> | CallPolicy | Response;
+}
+
+export type { ProxyConfig as P };

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "realtime-avatar",
+  "version": "0.3.0",
+  "description": "Realtime Avatar SDK. `realtime-avatar` and the route adapters hold your API key and are server-only; `realtime-avatar/react`, `/browser` and `/tools` never can \u2014 importing a server entry into a browser build throws at bundle time.",
+  "license": "MIT",
+  "author": "The Influence Company",
+  "homepage": "https://realtimeavatar.ai/docs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/theinfluencecompany/realtime-avatar-sdk.git",
+    "directory": "libs/sdk-server"
+  },
+  "bugs": {
+    "url": "https://github.com/theinfluencecompany/realtime-avatar-sdk/issues"
+  },
+  "keywords": [
+    "ai",
+    "avatar",
+    "realtime",
+    "voice",
+    "video",
+    "agent",
+    "full-duplex",
+    "livekit",
+    "sdk",
+    "api-client",
+    "react",
+    "react-native"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "workerd": "./dist/index.js",
+      "browser": "./dist/server-only-guard.js",
+      "react-native": "./dist/server-only-guard.js",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "workerd": "./dist/server.js",
+      "browser": "./dist/server-only-guard.js",
+      "react-native": "./dist/server-only-guard.js",
+      "default": "./dist/server.js"
+    },
+    "./nextjs": {
+      "types": "./dist/nextjs.d.ts",
+      "workerd": "./dist/nextjs.js",
+      "browser": "./dist/server-only-guard.js",
+      "react-native": "./dist/server-only-guard.js",
+      "default": "./dist/nextjs.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "workerd": "./dist/hono.js",
+      "browser": "./dist/server-only-guard.js",
+      "react-native": "./dist/server-only-guard.js",
+      "default": "./dist/hono.js"
+    },
+    "./express": {
+      "types": "./dist/express.d.ts",
+      "workerd": "./dist/express.js",
+      "browser": "./dist/server-only-guard.js",
+      "react-native": "./dist/server-only-guard.js",
+      "default": "./dist/express.js"
+    },
+    "./tanstack-start": {
+      "types": "./dist/tanstack-start.d.ts",
+      "workerd": "./dist/tanstack-start.js",
+      "browser": "./dist/server-only-guard.js",
+      "react-native": "./dist/server-only-guard.js",
+      "default": "./dist/tanstack-start.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    },
+    "./react-native": {
+      "types": "./dist/react-native.d.ts",
+      "default": "./dist/react-native.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "default": "./dist/tools.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": [
+    "./dist/server-only-guard.js"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "@livekit/components-react": "2.9.21",
+    "@livekit/react-native": "^2.11.1",
+    "@types/react": "19.2.7",
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "react-native": "0.81.5"
+  },
+  "peerDependencies": {
+    "@livekit/components-react": "^2.9.0",
+    "@livekit/react-native": "^2.11.0",
+    "react": ">=18",
+    "react-dom": ">=18",
+    "react-native": ">=0.78",
+    "livekit-client": "^2.9.0"
+  },
+  "peerDependenciesMeta": {
+    "@livekit/components-react": {
+      "optional": true
+    },
+    "@livekit/react-native": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "livekit-client": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  }
+}