@eventusgo/sdk 0.1.2 → 0.1.4

package/dist/chunk-TJNC4RSJ.js

@@ -0,0 +1,394 @@
+// src/index.ts
+import QRCode from "qrcode";
+var EventusBridgeUnavailableError = class extends Error {
+  constructor(message = "No Eventus bridge is connected.") {
+    super(message);
+    this.name = "EventusBridgeUnavailableError";
+  }
+};
+function isBridgeUnavailableError(error) {
+  return error instanceof Error && error.name === "EventusBridgeUnavailableError";
+}
+var EventEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(event, handler) {
+    const nextListeners = this.listeners.get(event) ?? /* @__PURE__ */ new Set();
+    nextListeners.add(handler);
+    this.listeners.set(event, nextListeners);
+    return () => {
+      nextListeners.delete(handler);
+      if (nextListeners.size === 0) {
+        this.listeners.delete(event);
+      }
+    };
+  }
+  emit(event, payload) {
+    const handlers = this.listeners.get(event);
+    if (!handlers) {
+      return;
+    }
+    for (const handler of handlers) {
+      handler(payload);
+    }
+  }
+};
+function getBrowserLocale() {
+  if (typeof navigator !== "undefined" && navigator.language) {
+    return navigator.language;
+  }
+  return "en";
+}
+function createDefaultMockContext() {
+  const manifest = readInjectedManifest();
+  return {
+    locale: getBrowserLocale(),
+    theme: "light",
+    ...manifest?.appId ? { appId: manifest.appId } : {},
+    user: {
+      id: "dev-user",
+      name: "Eventus Developer"
+    }
+  };
+}
+function readInjectedManifest() {
+  const manifest = globalThis.__EVENTUS_MANIFEST__;
+  if (typeof manifest === "undefined") {
+    return null;
+  }
+  return manifest ?? null;
+}
+function escapeHtml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+}
+function isAbsoluteHttpUrl(value) {
+  if (typeof value !== "string" || !value.trim()) {
+    return false;
+  }
+  try {
+    const parsed = new URL(value);
+    return (parsed.protocol === "http:" || parsed.protocol === "https:") && !!parsed.hostname;
+  } catch {
+    return false;
+  }
+}
+function parseDevPreviewDescriptor(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  const descriptor = value;
+  const manifest = descriptor.manifest;
+  const urls = descriptor.urls;
+  if (descriptor.type !== "eventus-dev-preview" || descriptor.version !== 1 || !manifest || typeof manifest !== "object" || Array.isArray(manifest) || !urls || typeof urls !== "object" || Array.isArray(urls)) {
+    return null;
+  }
+  const nextManifest = manifest;
+  const nextUrls = urls;
+  const permissions = nextManifest.permissions;
+  if (typeof nextManifest.name !== "string" || !nextManifest.name.trim() || typeof nextManifest.appId !== "string" || !nextManifest.appId.trim() || typeof nextManifest.version !== "string" || !nextManifest.version.trim() || !isAbsoluteHttpUrl(nextUrls.local) || (nextUrls.network !== null && nextUrls.network !== void 0 ? !isAbsoluteHttpUrl(nextUrls.network) : false) || !isAbsoluteHttpUrl(nextUrls.preview) || permissions !== void 0 && (!Array.isArray(permissions) || permissions.some((permission) => typeof permission !== "string"))) {
+    return null;
+  }
+  return {
+    type: "eventus-dev-preview",
+    version: 1,
+    manifest: {
+      name: nextManifest.name,
+      appId: nextManifest.appId,
+      version: nextManifest.version,
+      ...permissions ? { permissions } : {}
+    },
+    urls: {
+      local: nextUrls.local,
+      network: nextUrls.network === void 0 ? null : nextUrls.network,
+      preview: nextUrls.preview
+    }
+  };
+}
+async function fetchDevPreviewDescriptor() {
+  if (typeof fetch !== "function") {
+    return null;
+  }
+  try {
+    const response = await fetch("/__eventus__/preview.json", {
+      headers: {
+        Accept: "application/json"
+      }
+    });
+    if (!response.ok) {
+      return null;
+    }
+    return parseDevPreviewDescriptor(await response.json());
+  } catch {
+    return null;
+  }
+}
+function renderPreviewValue(label, value) {
+  const escaped = escapeHtml(value);
+  return `
+    <div>
+      <dt>${escapeHtml(label)}</dt>
+      <dd><code>${escaped}</code></dd>
+    </div>
+  `;
+}
+function renderPermissions(permissions) {
+  const value = permissions && permissions.length > 0 ? permissions.join(", ") : "None";
+  return renderPreviewValue("Permissions", value);
+}
+function createLivePreviewHtml(preview, qrSvg) {
+  return `
+<section aria-label="Eventus live preview handoff" style="margin:24px 0;display:grid;gap:20px;">
+  <style>
+    .eventus-live-preview{display:grid;gap:20px;}
+    .eventus-live-preview__copy{color:#102347;}
+    .eventus-live-preview__copy h2{margin:0 0 12px;font-size:1.4rem;line-height:1.2;}
+    .eventus-live-preview__copy p{margin:0;color:#465d82;line-height:1.6;}
+    .eventus-live-preview__grid{display:grid;gap:14px;margin:18px 0 0;}
+    .eventus-live-preview__grid > div{padding:14px 16px;border-radius:16px;background:#f8fbff;border:1px solid rgba(16,35,71,0.08);}
+    .eventus-live-preview__grid dt{font-size:0.72rem;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;color:#6880a6;}
+    .eventus-live-preview__grid dd{margin:6px 0 0;color:#102347;word-break:break-word;}
+    .eventus-live-preview__grid code{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:0.9rem;}
+    .eventus-live-preview__hint{margin-top:16px !important;color:#465d82 !important;}
+    .eventus-live-preview__qr{display:grid;place-items:center;padding:18px;border-radius:24px;background:linear-gradient(180deg,#fefefe 0%,#f3f7ff 100%);border:1px solid rgba(16,35,71,0.08);box-shadow:0 20px 50px rgba(38,73,134,0.14);}
+    .eventus-live-preview__qr svg{display:block;width:min(220px,100%);height:auto;}
+    .eventus-live-preview__meta{display:none;}
+    @media (min-width: 720px){
+      .eventus-live-preview{grid-template-columns:minmax(0,1.7fr) minmax(220px,0.9fr);align-items:center;}
+    }
+  </style>
+  <div class="eventus-live-preview">
+    <div class="eventus-live-preview__copy">
+      <h2>Live preview from your phone</h2>
+      <p>Open Eventus X, go to <strong>Developer</strong>, and scan this QR code to launch the mini app with the real Eventus bridge.</p>
+      <dl class="eventus-live-preview__grid">
+        ${renderPreviewValue("Preview URL", preview.urls.preview)}
+        ${renderPreviewValue("Local URL", preview.urls.local)}
+        ${preview.urls.network ? renderPreviewValue("Network URL", preview.urls.network) : ""}
+        ${renderPermissions(preview.manifest.permissions)}
+      </dl>
+      <p class="eventus-live-preview__hint">Your phone and computer must be on the same local network.</p>
+    </div>
+    <div class="eventus-live-preview__qr" aria-label="Eventus live preview QR code">
+      ${qrSvg}
+    </div>
+  </div>
+</section>`.trim();
+}
+async function getLivePreviewHtml() {
+  const preview = await fetchDevPreviewDescriptor();
+  if (!preview) {
+    return null;
+  }
+  const qrSvg = await QRCode.toString(JSON.stringify(preview), {
+    type: "svg",
+    width: 220,
+    margin: 1
+  });
+  return createLivePreviewHtml(preview, qrSvg);
+}
+function readWindowBridge() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window.Eventus;
+}
+function readStringField(record, key) {
+  const value = record?.[key];
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function mapNativeUser(user) {
+  if (!user || typeof user.id !== "string" || !user.id.trim()) {
+    return void 0;
+  }
+  const displayName = typeof user.displayName === "string" ? user.displayName : void 0;
+  const name = typeof user.name === "string" ? user.name : displayName;
+  const avatarUrl = typeof user.avatarUrl === "string" ? user.avatarUrl : void 0;
+  const handle = typeof user.handle === "string" ? user.handle : void 0;
+  return {
+    id: user.id,
+    ...name ? { name } : {},
+    ...displayName ? { displayName } : {},
+    ...avatarUrl ? { avatarUrl } : {},
+    ...handle ? { handle } : {}
+  };
+}
+function mapNativeContext(bridge) {
+  const appId = readStringField(bridge.app, "slug") ?? readStringField(bridge.app, "id");
+  const locale = readStringField(bridge.device, "locale") ?? getBrowserLocale();
+  const themeValue = readStringField(bridge.device, "themeMode");
+  const theme = themeValue === "dark" ? "dark" : "light";
+  const user = mapNativeUser(bridge.user);
+  return {
+    locale,
+    theme,
+    ...appId ? { appId } : {},
+    ...user ? { user } : {}
+  };
+}
+var mockState = {
+  enabled: false,
+  context: createDefaultMockContext(),
+  manifestOverride: void 0,
+  ready: false
+};
+var EventusClientImpl = class {
+  emitter = new EventEmitter();
+  lastReadySource;
+  hasReadyRequest = false;
+  constructor() {
+    if (typeof window !== "undefined") {
+      window.addEventListener("eventus:ready", this.handleBridgeReady);
+    }
+  }
+  async ready() {
+    this.hasReadyRequest = true;
+    const bridge = await this.waitForNativeBridge();
+    if (bridge) {
+      this.emitReady(mapNativeContext(bridge), "native");
+      return;
+    }
+    if (!mockState.enabled) {
+      throw new EventusBridgeUnavailableError();
+    }
+    mockState.ready = true;
+    this.emitReady(mockState.context, "mock");
+  }
+  async getContext() {
+    const bridge = readWindowBridge();
+    if (bridge) {
+      return mapNativeContext(bridge);
+    }
+    if (!mockState.enabled) {
+      throw new EventusBridgeUnavailableError();
+    }
+    return mockState.context;
+  }
+  getManifest() {
+    const bridge = readWindowBridge();
+    if (bridge) {
+      return readInjectedManifest();
+    }
+    return mockState.manifestOverride === void 0 ? readInjectedManifest() : mockState.manifestOverride;
+  }
+  async request(action, payload) {
+    const bridge = readWindowBridge();
+    if (bridge) {
+      if (typeof bridge.request === "function") {
+        return bridge.request(action, payload);
+      }
+      const bridgeAction = bridge[action];
+      if (typeof bridgeAction === "function") {
+        return bridgeAction(payload);
+      }
+    }
+    if (!mockState.enabled) {
+      throw new EventusBridgeUnavailableError(
+        `Eventus request "${action}" requires a native bridge or explicit mock mode.`
+      );
+    }
+    const mockedResponse = {
+      mock: true,
+      action,
+      payload: payload ?? null,
+      message: "Eventus request used the browser mock fallback because no native bridge is connected."
+    };
+    return mockedResponse;
+  }
+  on(event, handler) {
+    return this.emitter.on(event, handler);
+  }
+  configureMock(options = {}) {
+    const previousTheme = mockState.context.theme;
+    const shouldEnableMock = !!options.context || "manifest" in options || typeof options.ready === "boolean";
+    if (options.reset) {
+      mockState.enabled = false;
+      mockState.context = createDefaultMockContext();
+      mockState.manifestOverride = void 0;
+      mockState.ready = false;
+      this.lastReadySource = void 0;
+      this.hasReadyRequest = false;
+    }
+    if (shouldEnableMock) {
+      mockState.enabled = true;
+    }
+    if (options.context) {
+      const nextUser = options.context.user ? {
+        ...mockState.context.user ?? {},
+        ...options.context.user
+      } : mockState.context.user;
+      mockState.context = {
+        ...mockState.context,
+        ...options.context,
+        ...nextUser ? { user: nextUser } : {}
+      };
+    }
+    if ("manifest" in options) {
+      mockState.manifestOverride = options.manifest;
+    }
+    if (typeof options.ready === "boolean") {
+      mockState.ready = options.ready;
+      if (!options.ready) {
+        this.lastReadySource = void 0;
+      }
+    }
+    if (mockState.context.theme !== previousTheme) {
+      this.emitter.emit("themeChange", {
+        theme: mockState.context.theme,
+        context: mockState.context,
+        source: "mock"
+      });
+    }
+  }
+  emitReady(context, source) {
+    if (this.lastReadySource === source) {
+      return;
+    }
+    this.lastReadySource = source;
+    this.emitter.emit("ready", {
+      context,
+      source
+    });
+  }
+  handleBridgeReady = () => {
+    if (!this.hasReadyRequest && this.lastReadySource === void 0) {
+      return;
+    }
+    const bridge = readWindowBridge();
+    if (!bridge) {
+      return;
+    }
+    this.emitReady(mapNativeContext(bridge), "native");
+  };
+  async waitForNativeBridge() {
+    const bridge = readWindowBridge();
+    if (bridge || typeof window === "undefined") {
+      return bridge;
+    }
+    return new Promise((resolve) => {
+      const timeout = window.setTimeout(() => {
+        cleanup();
+        resolve(readWindowBridge());
+      }, 120);
+      const onReady = () => {
+        cleanup();
+        resolve(readWindowBridge());
+      };
+      const cleanup = () => {
+        window.clearTimeout(timeout);
+        window.removeEventListener("eventus:ready", onReady);
+      };
+      window.addEventListener("eventus:ready", onReady, { once: true });
+    });
+  }
+};
+var eventus = new EventusClientImpl();
+function configureMockEventus(options = {}) {
+  eventus.configureMock(options);
+}
+
+export {
+  EventusBridgeUnavailableError,
+  isBridgeUnavailableError,
+  getLivePreviewHtml,
+  eventus,
+  configureMockEventus
+};

package/dist/index.d.ts

@@ -19,6 +19,16 @@ type EventusManifest = {
     version: string;
     permissions?: Array<EventusPermission | string>;
 };
+type EventusDevPreviewDescriptor = {
+    type: "eventus-dev-preview";
+    version: 1;
+    manifest: EventusManifest;
+    urls: {
+        local: string;
+        network: string | null;
+        preview: string;
+    };
+};
 type EventusRuntimeSource = "native" | "mock";
 type EventusEventMap = {
     ready: {
@@ -49,6 +59,7 @@ type ConfigureMockEventusOptions = {
 declare class EventusBridgeUnavailableError extends Error {
     constructor(message?: string);
 }
+declare function isBridgeUnavailableError(error: unknown): boolean;
 type NativeBridgeUser = Record<string, unknown>;
 type NativeBridgeRecord = Record<string, unknown>;
 type NativeEventusBridge = {
@@ -64,6 +75,7 @@ declare global {
         Eventus?: NativeEventusBridge;
     }
 }
+declare function getLivePreviewHtml(): Promise<string | null>;
 declare class EventusClientImpl implements EventusClient {
     private emitter;
     private lastReadySource;
@@ -82,4 +94,4 @@ declare class EventusClientImpl implements EventusClient {
 declare const eventus: EventusClientImpl;
 declare function configureMockEventus(options?: ConfigureMockEventusOptions): void;
 
-export { type ConfigureMockEventusOptions, EventusBridgeUnavailableError, type EventusClient, type EventusContext, type EventusEventHandler, type EventusEventMap, type EventusEventName, type EventusManifest, type EventusPermission, type EventusRuntimeSource, type EventusTheme, type EventusUser, configureMockEventus, eventus };
+export { type ConfigureMockEventusOptions, EventusBridgeUnavailableError, type EventusClient, type EventusContext, type EventusDevPreviewDescriptor, type EventusEventHandler, type EventusEventMap, type EventusEventName, type EventusManifest, type EventusPermission, type EventusRuntimeSource, type EventusTheme, type EventusUser, configureMockEventus, eventus, getLivePreviewHtml, isBridgeUnavailableError };

package/dist/index.js

@@ -1,259 +1,14 @@
-// src/index.ts
-var EventusBridgeUnavailableError = class extends Error {
-  constructor(message = "No Eventus bridge is connected.") {
-    super(message);
-    this.name = "EventusBridgeUnavailableError";
-  }
-};
-var EventEmitter = class {
-  listeners = /* @__PURE__ */ new Map();
-  on(event, handler) {
-    const nextListeners = this.listeners.get(event) ?? /* @__PURE__ */ new Set();
-    nextListeners.add(handler);
-    this.listeners.set(event, nextListeners);
-    return () => {
-      nextListeners.delete(handler);
-      if (nextListeners.size === 0) {
-        this.listeners.delete(event);
-      }
-    };
-  }
-  emit(event, payload) {
-    const handlers = this.listeners.get(event);
-    if (!handlers) {
-      return;
-    }
-    for (const handler of handlers) {
-      handler(payload);
-    }
-  }
-};
-function getBrowserLocale() {
-  if (typeof navigator !== "undefined" && navigator.language) {
-    return navigator.language;
-  }
-  return "en";
-}
-function createDefaultMockContext() {
-  const manifest = readInjectedManifest();
-  return {
-    locale: getBrowserLocale(),
-    theme: "light",
-    ...manifest?.appId ? { appId: manifest.appId } : {},
-    user: {
-      id: "dev-user",
-      name: "Eventus Developer"
-    }
-  };
-}
-function readInjectedManifest() {
-  const manifest = globalThis.__EVENTUS_MANIFEST__;
-  if (typeof manifest === "undefined") {
-    return null;
-  }
-  return manifest ?? null;
-}
-function readWindowBridge() {
-  if (typeof window === "undefined") {
-    return void 0;
-  }
-  return window.Eventus;
-}
-function readStringField(record, key) {
-  const value = record?.[key];
-  return typeof value === "string" && value.trim() ? value : void 0;
-}
-function mapNativeUser(user) {
-  if (!user || typeof user.id !== "string" || !user.id.trim()) {
-    return void 0;
-  }
-  const displayName = typeof user.displayName === "string" ? user.displayName : void 0;
-  const name = typeof user.name === "string" ? user.name : displayName;
-  const avatarUrl = typeof user.avatarUrl === "string" ? user.avatarUrl : void 0;
-  const handle = typeof user.handle === "string" ? user.handle : void 0;
-  return {
-    id: user.id,
-    ...name ? { name } : {},
-    ...displayName ? { displayName } : {},
-    ...avatarUrl ? { avatarUrl } : {},
-    ...handle ? { handle } : {}
-  };
-}
-function mapNativeContext(bridge) {
-  const appId = readStringField(bridge.app, "slug") ?? readStringField(bridge.app, "id");
-  const locale = readStringField(bridge.device, "locale") ?? getBrowserLocale();
-  const themeValue = readStringField(bridge.device, "themeMode");
-  const theme = themeValue === "dark" ? "dark" : "light";
-  const user = mapNativeUser(bridge.user);
-  return {
-    locale,
-    theme,
-    ...appId ? { appId } : {},
-    ...user ? { user } : {}
-  };
-}
-var mockState = {
-  enabled: false,
-  context: createDefaultMockContext(),
-  manifestOverride: void 0,
-  ready: false
-};
-var EventusClientImpl = class {
-  emitter = new EventEmitter();
-  lastReadySource;
-  hasReadyRequest = false;
-  constructor() {
-    if (typeof window !== "undefined") {
-      window.addEventListener("eventus:ready", this.handleBridgeReady);
-    }
-  }
-  async ready() {
-    this.hasReadyRequest = true;
-    const bridge = await this.waitForNativeBridge();
-    if (bridge) {
-      this.emitReady(mapNativeContext(bridge), "native");
-      return;
-    }
-    if (!mockState.enabled) {
-      throw new EventusBridgeUnavailableError();
-    }
-    mockState.ready = true;
-    this.emitReady(mockState.context, "mock");
-  }
-  async getContext() {
-    const bridge = readWindowBridge();
-    if (bridge) {
-      return mapNativeContext(bridge);
-    }
-    if (!mockState.enabled) {
-      throw new EventusBridgeUnavailableError();
-    }
-    return mockState.context;
-  }
-  getManifest() {
-    const bridge = readWindowBridge();
-    if (bridge) {
-      return readInjectedManifest();
-    }
-    return mockState.manifestOverride === void 0 ? readInjectedManifest() : mockState.manifestOverride;
-  }
-  async request(action, payload) {
-    const bridge = readWindowBridge();
-    if (bridge) {
-      if (typeof bridge.request === "function") {
-        return bridge.request(action, payload);
-      }
-      const bridgeAction = bridge[action];
-      if (typeof bridgeAction === "function") {
-        return bridgeAction(payload);
-      }
-    }
-    if (!mockState.enabled) {
-      throw new EventusBridgeUnavailableError(
-        `Eventus request "${action}" requires a native bridge or explicit mock mode.`
-      );
-    }
-    const mockedResponse = {
-      mock: true,
-      action,
-      payload: payload ?? null,
-      message: "Eventus request used the browser mock fallback because no native bridge is connected."
-    };
-    return mockedResponse;
-  }
-  on(event, handler) {
-    return this.emitter.on(event, handler);
-  }
-  configureMock(options = {}) {
-    const previousTheme = mockState.context.theme;
-    const shouldEnableMock = !!options.context || "manifest" in options || typeof options.ready === "boolean";
-    if (options.reset) {
-      mockState.enabled = false;
-      mockState.context = createDefaultMockContext();
-      mockState.manifestOverride = void 0;
-      mockState.ready = false;
-      this.lastReadySource = void 0;
-      this.hasReadyRequest = false;
-    }
-    if (shouldEnableMock) {
-      mockState.enabled = true;
-    }
-    if (options.context) {
-      const nextUser = options.context.user ? {
-        ...mockState.context.user ?? {},
-        ...options.context.user
-      } : mockState.context.user;
-      mockState.context = {
-        ...mockState.context,
-        ...options.context,
-        ...nextUser ? { user: nextUser } : {}
-      };
-    }
-    if ("manifest" in options) {
-      mockState.manifestOverride = options.manifest;
-    }
-    if (typeof options.ready === "boolean") {
-      mockState.ready = options.ready;
-      if (!options.ready) {
-        this.lastReadySource = void 0;
-      }
-    }
-    if (mockState.context.theme !== previousTheme) {
-      this.emitter.emit("themeChange", {
-        theme: mockState.context.theme,
-        context: mockState.context,
-        source: "mock"
-      });
-    }
-  }
-  emitReady(context, source) {
-    if (this.lastReadySource === source) {
-      return;
-    }
-    this.lastReadySource = source;
-    this.emitter.emit("ready", {
-      context,
-      source
-    });
-  }
-  handleBridgeReady = () => {
-    if (!this.hasReadyRequest && this.lastReadySource === void 0) {
-      return;
-    }
-    const bridge = readWindowBridge();
-    if (!bridge) {
-      return;
-    }
-    this.emitReady(mapNativeContext(bridge), "native");
-  };
-  async waitForNativeBridge() {
-    const bridge = readWindowBridge();
-    if (bridge || typeof window === "undefined") {
-      return bridge;
-    }
-    return new Promise((resolve) => {
-      const timeout = window.setTimeout(() => {
-        cleanup();
-        resolve(readWindowBridge());
-      }, 120);
-      const onReady = () => {
-        cleanup();
-        resolve(readWindowBridge());
-      };
-      const cleanup = () => {
-        window.clearTimeout(timeout);
-        window.removeEventListener("eventus:ready", onReady);
-      };
-      window.addEventListener("eventus:ready", onReady, { once: true });
-    });
-  }
-};
-var eventus = new EventusClientImpl();
-function configureMockEventus(options = {}) {
-  eventus.configureMock(options);
-}
+import {
+  EventusBridgeUnavailableError,
+  configureMockEventus,
+  eventus,
+  getLivePreviewHtml,
+  isBridgeUnavailableError
+} from "./chunk-TJNC4RSJ.js";
 export {
   EventusBridgeUnavailableError,
   configureMockEventus,
-  eventus
+  eventus,
+  getLivePreviewHtml,
+  isBridgeUnavailableError
 };

package/dist/react.d.ts

@@ -0,0 +1,16 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { EventusContext, EventusRuntimeSource } from './index.js';
+
+type EventusReactContextValue = {
+    context: EventusContext;
+    runtimeSource: EventusRuntimeSource;
+};
+type EventusContextProviderProps = {
+    children: ReactNode;
+    bridgeUnavailable?: ReactNode;
+};
+declare function EventusContextProvider({ children, bridgeUnavailable, }: EventusContextProviderProps): react_jsx_runtime.JSX.Element;
+declare function useEventusContext(): EventusReactContextValue;
+
+export { EventusContextProvider, type EventusContextProviderProps, useEventusContext };

package/dist/react.js

@@ -0,0 +1,182 @@
+import {
+  eventus,
+  getLivePreviewHtml,
+  isBridgeUnavailableError
+} from "./chunk-TJNC4RSJ.js";
+
+// src/react.tsx
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useState
+} from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var EventusReactContext = createContext(
+  null
+);
+function EventusContextProvider({
+  children,
+  bridgeUnavailable
+}) {
+  const [state, setState] = useState({ status: "loading" });
+  useEffect(() => {
+    let cancelled = false;
+    let receivedReadyEvent = false;
+    const unsubscribeReady = eventus.on("ready", ({ context, source }) => {
+      receivedReadyEvent = true;
+      if (!cancelled) {
+        setState({
+          status: "ready",
+          context,
+          runtimeSource: source
+        });
+      }
+    });
+    const unsubscribeThemeChange = eventus.on(
+      "themeChange",
+      ({ context, source }) => {
+        if (!cancelled) {
+          setState({
+            status: "ready",
+            context,
+            runtimeSource: source
+          });
+        }
+      }
+    );
+    void (async () => {
+      try {
+        await eventus.ready();
+        const context = await eventus.getContext();
+        if (!cancelled && !receivedReadyEvent) {
+          setState({
+            status: "ready",
+            context,
+            runtimeSource: window.Eventus ? "native" : "mock"
+          });
+        }
+      } catch (error) {
+        if (receivedReadyEvent || cancelled) {
+          return;
+        }
+        if (isBridgeUnavailableError(error)) {
+          const previewHtml = await getLivePreviewHtml();
+          if (!cancelled && !receivedReadyEvent) {
+            setState({
+              status: "bridge-unavailable",
+              previewHtml
+            });
+          }
+          return;
+        }
+        if (!cancelled) {
+          setState({
+            status: "error",
+            message: error instanceof Error ? error.message : "Unable to initialize the Eventus client."
+          });
+        }
+      }
+    })();
+    return () => {
+      cancelled = true;
+      unsubscribeReady();
+      unsubscribeThemeChange();
+    };
+  }, []);
+  if (state.status === "ready") {
+    return /* @__PURE__ */ jsx(
+      EventusReactContext.Provider,
+      {
+        value: {
+          context: state.context,
+          runtimeSource: state.runtimeSource
+        },
+        children
+      }
+    );
+  }
+  if (state.status === "bridge-unavailable") {
+    if (bridgeUnavailable) {
+      return /* @__PURE__ */ jsx(Fragment, { children: bridgeUnavailable });
+    }
+    return /* @__PURE__ */ jsx(DefaultBridgeUnavailable, { previewHtml: state.previewHtml });
+  }
+  if (state.status === "error") {
+    return /* @__PURE__ */ jsx(DefaultStatusCard, { title: "Unable to start Eventus", body: state.message });
+  }
+  return /* @__PURE__ */ jsx(
+    DefaultStatusCard,
+    {
+      title: "Connecting to Eventus",
+      body: "Waiting for the Eventus bridge to become available."
+    }
+  );
+}
+function useEventusContext() {
+  const value = useContext(EventusReactContext);
+  if (!value) {
+    throw new Error(
+      "useEventusContext must be used within an EventusContextProvider."
+    );
+  }
+  return value;
+}
+function DefaultBridgeUnavailable({
+  previewHtml
+}) {
+  if (previewHtml) {
+    return /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: previewHtml } });
+  }
+  return /* @__PURE__ */ jsx(
+    DefaultStatusCard,
+    {
+      title: "Open inside Eventus X",
+      body: "This mini app needs the Eventus bridge to access the real runtime. Open it from Eventus X to test it with production-like behavior."
+    }
+  );
+}
+function DefaultStatusCard({ title, body }) {
+  return /* @__PURE__ */ jsx("main", { style: statusShellStyle, children: /* @__PURE__ */ jsxs("section", { style: statusCardStyle, children: [
+    /* @__PURE__ */ jsx("p", { style: statusEyebrowStyle, children: "Eventus Mini App Toolkit" }),
+    /* @__PURE__ */ jsx("h1", { style: statusTitleStyle, children: title }),
+    /* @__PURE__ */ jsx("p", { style: statusBodyStyle, children: body })
+  ] }) });
+}
+var statusShellStyle = {
+  minHeight: "100vh",
+  display: "grid",
+  placeItems: "center",
+  padding: "24px",
+  background: "radial-gradient(circle at top, #d8f2ff 0%, #f3f9ff 35%, #eef3ff 100%)"
+};
+var statusCardStyle = {
+  width: "min(680px, 100%)",
+  padding: "32px",
+  borderRadius: "24px",
+  background: "rgba(255, 255, 255, 0.88)",
+  border: "1px solid rgba(16, 35, 71, 0.08)",
+  boxShadow: "0 24px 80px rgba(38, 73, 134, 0.14)",
+  color: "#102347"
+};
+var statusEyebrowStyle = {
+  margin: "0 0 8px",
+  fontSize: "0.85rem",
+  letterSpacing: "0.12em",
+  textTransform: "uppercase",
+  color: "#3f6ea8"
+};
+var statusTitleStyle = {
+  margin: "0 0 12px",
+  fontSize: "clamp(2rem, 4vw, 3rem)",
+  lineHeight: 1.05
+};
+var statusBodyStyle = {
+  margin: 0,
+  color: "#465d82",
+  lineHeight: 1.6
+};
+export {
+  EventusContextProvider,
+  useEventusContext
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventusgo/sdk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Eventus mini-app SDK with an explicit browser mock mode.",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,14 +13,31 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/react.tsx --format esm --dts --clean",
     "check": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run"
+  },
+  "dependencies": {
+    "qrcode": "1.5.4"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/qrcode": "1.5.5",
+    "@types/react": "18.3.28",
+    "@types/react-dom": "18.3.7",
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
   }
 }