@terminals-tech/sdk 1.0.0-rc.1 → 1.0.0

package/dist/diagnostics-6RQTBR6I.js

@@ -0,0 +1,113 @@
+import "./chunk-2ESYSVXG.js";
+
+// ../../lib/webcontainer/diagnostics.ts
+var WebContainerDiagnostics = class {
+  /**
+   * Run comprehensive diagnostics
+   */
+  static async run() {
+    const diagnostics = {
+      timestamp: Date.now(),
+      browserInfo: {
+        userAgent: navigator.userAgent,
+        platform: navigator.platform,
+        vendor: navigator.vendor
+      },
+      isolation: {
+        isSecureContext: window.isSecureContext,
+        crossOriginIsolated: window.crossOriginIsolated,
+        hasSharedArrayBuffer: typeof SharedArrayBuffer !== "undefined",
+        hasWebAssembly: typeof WebAssembly !== "undefined"
+      },
+      headers: {},
+      recommendations: []
+    };
+    try {
+      const response = await fetch(window.location.href, { method: "HEAD" });
+      diagnostics.headers = {
+        coop: response.headers.get("cross-origin-opener-policy") || void 0,
+        coep: response.headers.get("cross-origin-embedder-policy") || void 0,
+        corp: response.headers.get("cross-origin-resource-policy") || void 0
+      };
+    } catch (error) {
+      console.warn("[Diagnostics] Unable to fetch headers:", error);
+    }
+    diagnostics.recommendations = this.generateRecommendations(diagnostics);
+    return diagnostics;
+  }
+  /**
+   * Generate actionable recommendations based on diagnostics
+   */
+  static generateRecommendations(diag) {
+    const recommendations = [];
+    if (!diag.isolation.isSecureContext) {
+      recommendations.push("\u26A0\uFE0F  Not in secure context - HTTPS required");
+    }
+    if (!diag.isolation.crossOriginIsolated) {
+      if (!diag.headers.coop || diag.headers.coop !== "same-origin") {
+        recommendations.push(
+          '\u274C COOP header missing or incorrect - should be "same-origin" for WebContainer routes'
+        );
+      }
+      if (!diag.headers.coep || !["credentialless", "require-corp"].includes(diag.headers.coep)) {
+        recommendations.push(
+          '\u274C COEP header missing or incorrect - should be "credentialless" or "require-corp"'
+        );
+      }
+      if (!diag.headers.coop && !diag.headers.coep) {
+        recommendations.push(
+          "\u{1F527} Check browser extensions that may modify headers (e.g., ModHeader, CORS Unblock)"
+        );
+        recommendations.push("\u{1F527} Verify middleware.ts is serving correct headers for this route");
+      }
+    }
+    if (!diag.isolation.hasSharedArrayBuffer) {
+      recommendations.push(
+        "\u274C SharedArrayBuffer not available - browser too old or headers incorrect"
+      );
+      recommendations.push("\u{1F527} Update browser: Chrome 96+, Firefox 95+, Safari 15.2+ required");
+    }
+    if (!diag.isolation.hasWebAssembly) {
+      recommendations.push("\u274C WebAssembly not supported - update browser");
+    }
+    if (recommendations.length === 0) {
+      recommendations.push("\u2705 All checks passed - WebContainer should work properly");
+    }
+    return recommendations;
+  }
+  /**
+   * Log diagnostics to console with formatting
+   */
+  static async logToConsole() {
+    const diag = await this.run();
+    console.group("\u{1F50D} WebContainer Cross-Origin Isolation Diagnostics");
+    console.log("Timestamp:", new Date(diag.timestamp).toISOString());
+    console.group("Browser Info");
+    console.table(diag.browserInfo);
+    console.groupEnd();
+    console.group("Cross-Origin Isolation Status");
+    console.table(diag.isolation);
+    console.groupEnd();
+    console.group("Response Headers");
+    console.table(diag.headers);
+    console.groupEnd();
+    console.group("Recommendations");
+    diag.recommendations.forEach((rec) => console.log(rec));
+    console.groupEnd();
+    console.groupEnd();
+  }
+  /**
+   * Export diagnostics as JSON for bug reports
+   */
+  static async exportJSON() {
+    const diag = await this.run();
+    return JSON.stringify(diag, null, 2);
+  }
+};
+if (typeof window !== "undefined") {
+  window.wcDiagnostics = WebContainerDiagnostics;
+  console.log("[WebContainer] Diagnostics available: window.wcDiagnostics.logToConsole()");
+}
+export {
+  WebContainerDiagnostics
+};