@domino-sdk/relay 1.0.0-next.0 → 1.0.0-next.10

package/README.md

@@ -6,6 +6,18 @@ Author quests and connect an application to Domino Relay.
 pnpm add @domino-sdk/relay
 ```
 
-Use `@domino-sdk/relay/authoring` for quest definitions, `/browser` for browser integrations, `/portal-proxy` for server proxies, and `/build` for bundling authored modules.
+| Import                           | For                                                                                        |
+| -------------------------------- | ------------------------------------------------------------------------------------------ |
+| `@domino-sdk/relay`              | The participant client (`createRelayClient`), `RelayError`, and the types it returns       |
+| `@domino-sdk/relay/browser`      | The browser client with durable submission recovery, wallet signers and sign-in options    |
+| `@domino-sdk/relay/react`        | React hooks over the browser client                                                        |
+| `@domino-sdk/relay/avatar`       | Generated default avatars (`avatarSrc`, `defaultAvatar`)                                   |
+| `@domino-sdk/relay/authoring`    | Quest, tracker, leaderboard, referral and engagement definitions, and evaluator types     |
+| `@domino-sdk/relay/schema`       | Zod schemas of Relay's API bodies, deployments, tracker records and observations           |
+| `@domino-sdk/relay/build`        | Bundling authored modules; needs `esbuild` installed                                       |
+| `@domino-sdk/relay/portal-proxy` | Server proxies and hosted app Workers                                                      |
+| `@domino-sdk/relay/vite`         | The Vite plugin that keeps server code out of the browser build                            |
+
+`@domino-sdk/relay/internal` is shared by Relay's own services and Console. It is not a supported API and can change in any release.
 
 Requires Node.js 24 for tooling. Proprietary software; `UNLICENSED`.

package/build.mjs

@@ -1,5 +1,21 @@
 import { resolve, dirname } from "node:path"
-import { build } from "esbuild"
+
+// esbuild is an optional peer dependency: only quest builds need it, so apps that use the runtime
+// client do not install its native binary. `@domino-sdk/relay-cli` depends on it.
+async function esbuild() {
+  try {
+    return await import("esbuild")
+  } catch (error) {
+    if (error?.code === "ERR_MODULE_NOT_FOUND") {
+      throw new Error(
+        "@domino-sdk/relay/build needs esbuild. Install it next to @domino-sdk/relay, or build with the domino CLI (@domino-sdk/relay-cli).",
+        { cause: error }
+      )
+    }
+
+    throw error
+  }
+}
 
 /** Bundle an authored quest without evaluating developer code in the build process. */
 export async function buildQuest(entry, options = {}) {
@@ -10,6 +26,7 @@ export async function buildQuest(entry, options = {}) {
     throw new Error("Invalid quest export name")
   }
 
+  const { build } = await esbuild()
   const result = await build({
     ...(options.exportName
       ? {