@trackunit/react-map-adapter-google 0.0.118-alpha-12adfed37e0.0 → 0.0.118

package/README.md

@@ -15,6 +15,7 @@ TypeScript consumers also need the `@types/google.maps` peer dependency.
 | Export | Role |
 | --- | --- |
 | `googleMapsAdapter` | Factory that returns adapter config for `useMap` (from `@trackunit/react-map`) |
+| `googleMapCspDirectives` | Factory returning Google Maps runtime CSP requirements for IrisX app manifests |
 | `GoogleMapsConfig` | Configuration type for the adapter |
 | `GoogleApiProvider` | Optional wrapper to load the Maps JS API once for multiple map instances (recommended when several maps use vector/cloud `mapId` styling) |
 | `GoogleMapsAdapterInstance` | Low-level instance factory (advanced use) |
@@ -24,8 +25,39 @@ TypeScript consumers also need the `@types/google.maps` peer dependency.
 
 Pass the adapter into `useMap` from `@trackunit/react-map` (see JSDoc on `googleMapsAdapter` in source for a full example).
 
+```tsx
+import { useMap } from "@trackunit/react-map";
+import { googleMapsAdapter } from "@trackunit/react-map-adapter-google";
+
+const MyMap = () => {
+  const googleMapsApiKey = ""; // your API key here
+  const [Map] = useMap(googleMapsAdapter({ apiKey: googleMapsApiKey }));
+
+  return <Map aria-label="Map" className="h-full w-full" />;
+};
+```
+
 For **multiple Google maps** in one tree, wrap them in `GoogleApiProvider` with your API key and give each map a **distinct** `mapInstanceId` in its `GoogleMapsConfig` so the vis.gl layer registry can tell maps apart. See the docblock on `GoogleApiProvider` for details.
 
+## IrisX apps
+
+The IrisX iframe Content Security Policy blocks Google Maps unless the app declares the adapter's runtime requirements. An empty `cspHeader` applies only the IrisX default policy which does not include Google Maps automatically.
+
+Import and spread the adapter-owned directives in `iris-app-manifest.ts`:
+
+```ts
+import { googleMapCspDirectives } from "@trackunit/react-map-adapter-google";
+
+const irisAppManifest = {
+  // ...
+  cspHeader: {
+    ...googleMapCspDirectives(),
+  },
+};
+```
+
+Use the exported directives instead of copying host lists or using the Manager-only `defaultCspConfig()`. This keeps the CSP requirement versioned with the adapter.
+
 ## Dependencies
 
 Depends on `@trackunit/react-map-adapter-shared` and Google Maps–related packages (e.g. `@vis.gl/react-google-maps`). It does **not** import `@trackunit/react-map` (adapters are consumed *by* the map package, not the reverse).

package/index.cjs.js

@@ -1,9 +1,9 @@
 'use strict';
 
+var reactMapAdapterShared = require('@trackunit/react-map-adapter-shared');
 var jsxRuntime = require('react/jsx-runtime');
 var reactGoogleMaps = require('@vis.gl/react-google-maps');
 var react = require('react');
-var reactMapAdapterShared = require('@trackunit/react-map-adapter-shared');
 var geoJsonUtils = require('@trackunit/geo-json-utils');
 var markerclusterer = require('@googlemaps/markerclusterer');
 var reactMapColorUtils = require('@trackunit/react-map-color-utils');
@@ -3120,6 +3120,10 @@ const googleMapsAdapter = reactMapAdapterShared.defineAdapter((config) => ({
     Renderer: GoogleMapsRenderer,
 }));
 
+Object.defineProperty(exports, "googleMapCspDirectives", {
+    enumerable: true,
+    get: function () { return reactMapAdapterShared.googleMapCspDirectives; }
+});
 exports.GoogleApiProvider = GoogleApiProvider;
 exports.GoogleMapsAdapterInstance = GoogleMapsAdapterInstance;
 exports.GoogleMapsRenderer = GoogleMapsRenderer;

package/index.esm.js

@@ -1,7 +1,8 @@
+import { canPatchAdaptiveMarker, canPatchAdaptiveViewport, canPatchMarkerInPlace, extractPointCoordinates, mergeAntimeridianFeatures, extractPolygonPaths, extractLineCoordinates, patchPortalDescriptors, collectFeatureIdSet, removeGoneIndexedMarkers, getAdaptiveDomFeatureIds, extractSourceData, buildAdaptiveDomRenderFn, resolveCircleSymbolDefaults, resolveSymbolDescriptor, buildAdaptiveSymbolStyleFn, createSymbolDotElement, anchorFromBottomCenter, createDefaultClusterElement, createClusterPinElement, fadeInElement, buildAdaptiveDomEntries, MAP_CURSORS, resolveSelectedStyle, resolveHoveredStyle, attachSafeAreaHoverListeners, INITIAL_MAP_STATE, DEFAULT_MAP_APPEARANCE, computeInitialState, getEffectiveRestrictBounds, cameraStateEquals, isEventOfType, DEFAULT_ZOOM, DEFAULT_CENTER, defineAdapter } from '@trackunit/react-map-adapter-shared';
+export { googleMapCspDirectives } from '@trackunit/react-map-adapter-shared';
 import { jsx } from 'react/jsx-runtime';
 import { APIProvider, APIProviderContext, useMap, useApiLoadingStatus, APILoadingStatus, Map as Map$1 } from '@vis.gl/react-google-maps';
 import { useMemo, useCallback, useSyncExternalStore, useId, useContext, useEffect } from 'react';
-import { canPatchAdaptiveMarker, canPatchAdaptiveViewport, canPatchMarkerInPlace, extractPointCoordinates, mergeAntimeridianFeatures, extractPolygonPaths, extractLineCoordinates, patchPortalDescriptors, collectFeatureIdSet, removeGoneIndexedMarkers, getAdaptiveDomFeatureIds, extractSourceData, buildAdaptiveDomRenderFn, resolveCircleSymbolDefaults, resolveSymbolDescriptor, buildAdaptiveSymbolStyleFn, createSymbolDotElement, anchorFromBottomCenter, createDefaultClusterElement, createClusterPinElement, fadeInElement, buildAdaptiveDomEntries, MAP_CURSORS, resolveSelectedStyle, resolveHoveredStyle, attachSafeAreaHoverListeners, INITIAL_MAP_STATE, DEFAULT_MAP_APPEARANCE, computeInitialState, getEffectiveRestrictBounds, cameraStateEquals, isEventOfType, DEFAULT_ZOOM, DEFAULT_CENTER, defineAdapter } from '@trackunit/react-map-adapter-shared';
 import { validateBbox, validatePosition } from '@trackunit/geo-json-utils';
 import { MarkerClusterer, SuperClusterAlgorithm } from '@googlemaps/markerclusterer';
 import { colorWithOpacity } from '@trackunit/react-map-color-utils';

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@trackunit/react-map-adapter-google",
-  "version": "0.0.118-alpha-12adfed37e0.0",
+  "version": "0.0.118",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-map-adapter-shared": "0.0.129-alpha-12adfed37e0.0",
-    "@trackunit/react-map-color-utils": "0.0.107-alpha-12adfed37e0.0",
-    "@trackunit/geo-json-utils": "1.15.47-alpha-12adfed37e0.0",
+    "@trackunit/react-map-adapter-shared": "0.0.129",
+    "@trackunit/react-map-color-utils": "0.0.107",
+    "@trackunit/geo-json-utils": "1.15.47",
     "@googlemaps/markerclusterer": "^2.6.2",
     "@vis.gl/react-google-maps": "^1.7.1",
     "es-toolkit": "^1.39.10",

package/src/google-map-csp-directives.d.ts

@@ -0,0 +1 @@
+export { googleMapCspDirectives } from "@trackunit/react-map-adapter-shared";

package/src/index.d.ts

@@ -1,3 +1,4 @@
+export { googleMapCspDirectives } from "./google-map-csp-directives";
 export { GoogleApiProvider } from "./GoogleApiProvider";
 export { googleMapsAdapter, type GoogleMapsConfig } from "./googleMapsAdapter";
 export { GoogleMapsAdapterInstance } from "./GoogleMapsAdapterInstance";