@eventusgo/sdk 0.1.2 → 0.1.3

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,10 +1,14 @@
 // 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) {
@@ -53,6 +57,134 @@ function readInjectedManifest() {
   }
   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;
@@ -255,5 +387,7 @@ function configureMockEventus(options = {}) {
 export {
   EventusBridgeUnavailableError,
   configureMockEventus,
-  eventus
+  eventus,
+  getLivePreviewHtml,
+  isBridgeUnavailableError
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventusgo/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Eventus mini-app SDK with an explicit browser mock mode.",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,5 +22,11 @@
     "build": "tsup src/index.ts --format esm --dts --clean",
     "check": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run"
+  },
+  "dependencies": {
+    "qrcode": "1.5.4"
+  },
+  "devDependencies": {
+    "@types/qrcode": "1.5.5"
   }
 }