@showmeonmap/mcp 0.6.0 → 0.7.1

package/dist/version.js

@@ -0,0 +1,3 @@
+/** The npm package version, reported to MCP clients in `initialize`. Pinned
+ *  equal to package.json by __tests__/tools/registration.test.ts. */
+export const PACKAGE_VERSION = '0.7.1';

package/dist/viewer.js

@@ -0,0 +1,117 @@
+/**
+ * MCP App map viewer — server-side surface.
+ *
+ * When `createServer` receives `viewer` opts (the hosted HTTP server only),
+ * it registers VIEWER_URI as an MCP App resource, tags VIEWER_TOOLS with
+ * `_meta.ui.resourceUri`, and attaches a hidden `(map_id, cursor, opId)`
+ * pointer under VIEW_META_KEY to their results so the card in Claude loads
+ * that exact version. Without `viewer` (stdio / npm builds) nothing changes.
+ *
+ * This package must not import from the main app's `src/`; VIEW_META_KEY is
+ * duplicated in `src/mcp-viewer/viewData.ts` and a unit test pins the two
+ * literals equal.
+ */
+export const VIEWER_URI = 'ui://showmeonmap/map-viewer.html';
+export const VIEW_META_KEY = 'showmeonmap/view';
+export const MCP_APP_MIME = 'text/html;profile=mcp-app';
+export const VIEWER_TOOLS = new Set([
+    'build_map', 'mutate_map', 'add_layer', 'add_fusion_layer', 'filter_layer', 'focus_area',
+    'run_analysis', 'remove_layer', 'clear_filters', 'rename_layer', 'restyle_layer',
+    'set_camera', 'set_time', 'add_annotation', 'remove_annotation', 'undo', 'redo', 'run_workflow',
+]);
+/** Canonical origin — a trailing slash or path must never leak into asset
+ *  URLs (`//mcp-viewer/…`) or CSP entries. */
+function normalizeOrigin(assetOrigin) {
+    return new URL(assetOrigin).origin;
+}
+export const VIEWER_UNAVAILABLE_TEXT = "Map viewer unavailable — open the map from the link in Claude's reply.";
+/** Tiny shell: the real viewer is a hashed, immutable bundle on assetOrigin.
+ *  Any manifest/bundle failure renders a visible fallback instead of a blank
+ *  card (a rejected top-level await is otherwise silent). */
+export function viewerShellHtml(assetOrigin) {
+    // `<` escaped so the inlined literal can never close the <script> element.
+    // The fallback box carries its own background + text colour (#222 on #f2f2f2,
+    // ~14:1) so its contrast never depends on the host's light/dark card.
+    const o = JSON.stringify(normalizeOrigin(assetOrigin)).replace(/</g, '\\u003c');
+    const msg = JSON.stringify(VIEWER_UNAVAILABLE_TEXT).replace(/</g, '\\u003c');
+    return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<style>html,body,#smo-viewer{margin:0;height:100%;background:transparent}</style></head>
+<body><div id="smo-viewer"></div><script type="module">
+const O=${o};
+try{
+const res=await fetch(O+'/mcp-viewer/manifest.json',{cache:'no-store'});
+if(!res.ok)throw new Error('manifest HTTP '+res.status);
+const m=await res.json();
+window.__SMO_ASSET_ORIGIN__=O;window.__SMO_MANIFEST__=m;
+const l=document.createElement('link');l.rel='stylesheet';l.href=O+'/mcp-viewer/'+m.css;document.head.append(l);
+await import(O+'/mcp-viewer/'+m.js);
+}catch(e){
+console.error('[smo-viewer] failed to load viewer',e);
+const el=document.getElementById('smo-viewer');
+if(el){const p=document.createElement('p');p.style.cssText='margin:16px;padding:12px 16px;border-radius:8px;background:#f2f2f2;color:#222;font:14px/1.4 system-ui,-apple-system,sans-serif';p.textContent=${msg};el.replaceChildren(p);}
+}
+</script></body></html>`;
+}
+export function viewerResourceMeta(v) {
+    const uniq = (xs) => [...new Set(xs)];
+    const origin = normalizeOrigin(v.assetOrigin);
+    return {
+        ui: {
+            prefersBorder: true,
+            csp: {
+                connectDomains: uniq([origin, ...v.connectDomains]),
+                resourceDomains: uniq([origin, ...v.resourceDomains]),
+                ...(v.frameDomains.length ? { frameDomains: uniq(v.frameDomains) } : {}),
+            },
+        },
+    };
+}
+/** UTF-8 byte length of a string — the budget is bytes, and `.length` counts
+ *  UTF-16 units (a CJK place name is 1 unit but 3 bytes). */
+export function utf8Bytes(s) {
+    let n = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c < 0x80)
+            n += 1;
+        else if (c < 0x800)
+            n += 2;
+        else if (c >= 0xd800 && c <= 0xdbff) {
+            n += 4;
+            i++;
+        } // surrogate pair
+        else
+            n += 3;
+    }
+    return n;
+}
+/**
+ * Split a plan's layers so their inline data fits `budgetBytes`, keeping
+ * order. A layer whose own JSON exceeds the budget → `oversize` (data
+ * stripped, id kept — it can never ride in a card result); layers that fit
+ * individually but not in the remaining budget → `deferred` (data stripped;
+ * the card fetches them one by one with `layer_ids`).
+ */
+export function splitLayersByBudget(layers, budgetBytes) {
+    const inline = [];
+    const deferred = [];
+    const oversize = [];
+    let used = 0;
+    for (const layer of layers) {
+        const size = utf8Bytes(JSON.stringify(layer));
+        const strip = () => ({ ...layer, source: layer.source ? { ...layer.source, data: undefined } : layer.source });
+        if (size > budgetBytes) {
+            oversize.push(layer.id);
+            inline.push(strip());
+            continue;
+        }
+        if (used + size > budgetBytes) {
+            deferred.push(layer.id);
+            inline.push(strip());
+            continue;
+        }
+        used += size;
+        inline.push(layer);
+    }
+    return { inline, deferred, oversize };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@showmeonmap/mcp",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "mcpName": "com.showmeonmap/maps",
   "description": "MCP server for ShowMeOnMap \u2014 geospatial visualization tools for any MCP-speaking agent (Claude Desktop, Cursor, Zed, ChatGPT Apps SDK)",
   "type": "module",