@mappedin/mappedin-js 6.0.1-beta.42 → 6.0.1-beta.44

package/README.md

@@ -43,3 +43,77 @@ init();
 ```
 
 For full documentation, read our [Getting Started guide on the Developer Portal](https://developer.mappedin.com/web-sdk/getting-started).
+
+### Content Security Policy (CSP) Support
+
+The SDK provides solutions for applications that use a strict Content Security Policy.
+
+#### Web Worker CSP Solution
+
+If your CSP blocks `blob:` URLs or `unsafe-eval` directives (affecting web workers), you can host worker scripts externally:
+
+```javascript
+import { setWorkerUrl } from '@mappedin/mappedin-js';
+
+// Call this before initializing any maps
+setWorkerUrl('/path/to/workers');
+```
+
+This function configures both the MapLibre and collision detection workers to load from external URLs. To set this up:
+
+1. Copy the worker files from `node_modules/@mappedin/mappedin-js/lib/esm/workers/` to your web server
+2. Call `setWorkerUrl` with the base URL path to these files
+3. Ensure your CSP allows scripts from this location
+
+Example in a build script:
+```bash
+# Copy worker files to your public directory
+cp -r node_modules/@mappedin/mappedin-js/lib/esm/workers ./public/mappedin-workers
+```
+
+```javascript
+// In your JavaScript
+setWorkerUrl('/mappedin-workers');
+```
+
+#### CSS Injection CSP Solution
+
+If your CSP blocks inline styles (`style-src 'unsafe-inline'`), use external CSS loading instead:
+
+1. Load the SDK's CSS with a `<link>` tag in your HTML
+2. Disable automatic style injection in `show3dMap` options
+
+```html
+<!-- In your HTML file -->
+<link rel="stylesheet" href="/path/to/mappedin-js/index.css">
+```
+
+```javascript
+// In your JavaScript
+const mapView = await show3dMap(element, venue, {
+  injectStyles: false, // Disable automatic style injection
+});
+```
+
+For your build process:
+```bash
+# Copy CSS file to your public directory
+cp node_modules/@mappedin/mappedin-js/lib/index.css ./public/
+```
+
+#### Text3D Worker CSP Solution (Optional)
+
+If you use Text3D features (like `labelAll()`) in a CSP-restricted environment, you'll need to disable the Text3D worker if you don't want see error message:
+
+```javascript
+import { disableText3DWorker } from '@mappedin/mappedin-js';
+// After initializing your map
+disableText3DWorker();
+
+// Now you can use Text3D features without errors or warnings
+mapView.Text3D.labelAll();
+```
+
+This disables the worker and processes text on the main thread instead, allowing Text3D to work in CSP environments that block worker creation.
+
+You can apply any combination of these solutions based on your specific CSP restrictions and SDK feature usage.