@superrouteca/smap 1.1.6 → 1.1.7

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.1.7 — 2026-10-28
+
+- Plan editor: faster edits through sMap's fast path, with no code change. When your plan editor token answer names a
+  fast path, or your map key's configuration on sMap does, every edit goes there and falls back to the Open Platform
+  by itself when the fast path asks for it, fails, or does not answer within 2 seconds (5 seconds for a refine). Quota
+  and rate-limit refusals stay final. The editor's state and `change` events say which path answered (`path`);
+  `fastPath: false` keeps every edit on the Open Platform, and `smapUrl` names the sMap service a map key's
+  configuration is read from (the map's own with `map.planEditor`).
+
 ## 1.1.6 — 2026-10-28
 
 - Plan editor: `map.planEditor` lets a person edit a plan of routes on the map — drag a stop within its route or onto

package/README.md

@@ -322,6 +322,16 @@ editor.destroy();
   `plan_editing_off`, `key_off`, `plan_routes_only`). A map key needs *Allow plan editing* switched on and the page's
   origin on its allowlist. In an app shell (macOS, Windows) pass `app: 'apple:<bundle id>'` or `'windows:<id>'`: it
   is sent as `X-SMap-App`.
+- **Fast path** (no code change): when the plan editor token answer carries `fast_path.url`, or the map key's
+  configuration on sMap names one (`GET <smapUrl>/plan/v1/config`, read once and kept 10 minutes; `smapUrl` is the
+  map's own sMap service with `map.planEditor`, `https://tile.srsr.ca` otherwise), every call goes there
+  (`<url>/<same path>`, with the same credential, headers and body) instead of `<baseUrl>/v1/plan/…`. A
+  `409 USE_STANDARD_PATH` (or `X-Plan-Path: standard`), any 5xx, a network error or no answer within 2 seconds
+  (`fastPathTimeout`; 5 seconds for refine, `fastPathRefineTimeout`) repeats the same call once on the standard path; the next call tries the fast path again.
+  `402`, `429` and every other 4xx are final, as on the standard path. A renewed token follows its own answer (the
+  fast path may appear or go). `state().path` and the `change` event's `path` say where the last answer came from
+  (`'fast'` or `'standard'`); `fastPath: false` keeps every call on the standard path. The snapshot works on both
+  paths with the same id.
 - **Distance snapshot**: the editor opens one (`POST /v1/plan/matrix`) and names it in every call, so legs measured
   once are not measured again. When an answer says the snapshot expired (`X-Plan-Matrix: expired`, or a `410`), it
   opens a new one and carries on; a snapshot that cannot be opened never stops an edit. `destroy()` closes it.

package/dist/SOURCE.json

@@ -1,15 +1,15 @@
 {
-  "sdkVersion": "1.1.6",
+  "sdkVersion": "1.1.7",
   "engine": "maplibre-gl 6.16.0",
   "files": {
-    "smap.js": "1d0821da7bf4c5891a67336750974fd66109bb148f6dc8b248f398ebc1d7dfd9",
+    "smap.js": "1e7ba1266c67f860e74a2956521d55f49ea5771e0b1cfa832014433ea0554d25",
     "smap.css": "d82adcd1b8e2b5d1a6ebe0ee648bc24eb84471bc956e3c8ac3cc7dc1f447d96f",
-    "smap-client.js": "ef0b0915f86ec57c4cb654f01db4530e75123101d595b1e718db4b645097856b",
+    "smap-client.js": "f845c1d52a6f13bfb7f85cf8690e70320b09278b203b9e6a2cc874eed734eb10",
     "smap-client.d.ts": "5f0df11bf60c5a9ced34522a284de81260c27871678ab772f16da9ccf6883f58",
-    "smap.mjs": "bd333a886917566235b970f6a2709acb004670fdb5040c9a9380ad3b654dd923",
-    "smap.cjs": "ed8a33d2457eb243d59a50cc70fb92f1e59382c8f97520ed98ede99adf24d303",
-    "smap-client.cjs": "f5aa773fbaf1cfe46a3e37de246c9918609729b3d624aa624f380466ef56bb6f",
-    "smap-client.mjs": "6b895d27a13b026ac5e5aecdb608495f3337cda0650a7b2cceaaad8d54c032bd",
+    "smap.mjs": "ff3859691bfaf62d672ec6991eeda530be3316b22413d85c09a4adb7e11529cb",
+    "smap.cjs": "74c72a1504a0023d1b3d2613aac1527bc20676a7002c909715e60f798182b5c8",
+    "smap-client.cjs": "c1d143a0a9ac8a4cf1abdc7c2c82aec0d063bc51188e3eeb572dc48497475ef3",
+    "smap-client.mjs": "69d3e44f0d3fd39c3edbd8be6e66d4ddb625795f356a583dfeea610025cb7bd5",
     "smap-client.d.cts": "e0fe4eb54cd66b831116082f42bd2f7de260f9f12a2741f4004f8cf10c252116",
     "smap-client.d.mts": "96830d316ddb33b4ff8edb8b6f810337479636114f75c4170d95038ffda74103",
     "vendor-licenses.txt": "ee5fc05a0677eaf69601d2c7db0d9ecd6cc27c3abc1d0733bc9ed34707cf8ef2"

package/dist/smap-client.cjs

@@ -1,5 +1,5 @@
 /* Generated by js/build.mjs from js/src (see SOURCE.json). Do not edit. */
-/*! sMap JS client 1.1.6 — tokens, the nearest node, styles, tiles and raw reads, without a map view. */
+/*! sMap JS client 1.1.7 — tokens, the nearest node, styles, tiles and raw reads, without a map view. */
 /*
  * Runs wherever `fetch` exists: browsers, Node.js 18+, workers; elsewhere (mini programs, older runtimes) pass your
  * own `fetch`. UMD: `window.SMapClient`, `require('smap-client')`, or an AMD module.
@@ -19,7 +19,7 @@
 }(typeof self !== 'undefined' ? self : this, function () {
   'use strict';
 
-  var VERSION = '1.1.6';
+  var VERSION = '1.1.7';
   var NODE_TTL = 3600 * 1000;          // the measured order
   var KNOWN_TTL = 30 * 86400 * 1000;   // the last node list received, used when none can be read
 

package/dist/smap-client.js

@@ -1,4 +1,4 @@
-/*! sMap JS client 1.1.6 — tokens, the nearest node, styles, tiles and raw reads, without a map view. */
+/*! sMap JS client 1.1.7 — tokens, the nearest node, styles, tiles and raw reads, without a map view. */
 /*
  * Runs wherever `fetch` exists: browsers, Node.js 18+, workers; elsewhere (mini programs, older runtimes) pass your
  * own `fetch`. UMD: `window.SMapClient`, `require('smap-client')`, or an AMD module.
@@ -18,7 +18,7 @@
 }(typeof self !== 'undefined' ? self : this, function () {
   'use strict';
 
-  var VERSION = '1.1.6';
+  var VERSION = '1.1.7';
   var NODE_TTL = 3600 * 1000;          // the measured order
   var KNOWN_TTL = 30 * 86400 * 1000;   // the last node list received, used when none can be read
 

package/dist/smap-client.mjs

@@ -1,7 +1,7 @@
 /* Generated by js/build.mjs from js/src (see SOURCE.json). Do not edit. */
 var smapClientModule = { exports: {} };
 (function (module, exports, define) {
-/*! sMap JS client 1.1.6 — tokens, the nearest node, styles, tiles and raw reads, without a map view. */
+/*! sMap JS client 1.1.7 — tokens, the nearest node, styles, tiles and raw reads, without a map view. */
 /*
  * Runs wherever `fetch` exists: browsers, Node.js 18+, workers; elsewhere (mini programs, older runtimes) pass your
  * own `fetch`. UMD: `window.SMapClient`, `require('smap-client')`, or an AMD module.
@@ -21,7 +21,7 @@ var smapClientModule = { exports: {} };
 }(typeof self !== 'undefined' ? self : this, function () {
   'use strict';
 
-  var VERSION = '1.1.6';
+  var VERSION = '1.1.7';
   var NODE_TTL = 3600 * 1000;          // the measured order
   var KNOWN_TTL = 30 * 86400 * 1000;   // the last node list received, used when none can be read
 

package/dist/smap.cjs

@@ -1,6 +1,6 @@
 /* Generated by js/build.mjs from js/src (see SOURCE.json). Do not edit. */
 'use strict';
-/*! sMap Web SDK 1.1.6. Bundles maplibre-gl 6.16.0 (BSD-3-Clause), see vendor-licenses.txt. */
+/*! sMap Web SDK 1.1.7. Bundles maplibre-gl 6.16.0 (BSD-3-Clause), see vendor-licenses.txt. */
 
 var smapCore = null;
 function smapCreateEngine() {
@@ -28364,6 +28364,24 @@ function smapCreatePlan() {
   // its Origin; a native app also names itself with X-SMap-App (and X-SMap-App-Cert on Android).
 
   var DEFAULT_BASE = 'https://open.superroute.ca';
+  // The sMap service a map key's configuration is read from (GET <smap>/plan/v1/config), unless the editor is told another.
+  var DEFAULT_SMAP = 'https://tile.srsr.ca';
+  // Fast path (OPEN-ROUTE-EDIT E19, §2f.5): a call there not answered within this long is repeated on the standard path.
+  // Per call, in this one place: every call 2 s, except refine (its search runs up to 2 s inside sRoad, and sMap's own
+  // refine budget is 4 s) 5 s.
+  var FAST_PATH_TIMEOUT_MS = 2000;
+  var FAST_PATH_REFINE_TIMEOUT_MS = 5000;
+  /** The fast-path time limit of a call (`path` after /v1/plan), from the defaults or the options that replace them. */
+  function fastPathTimeoutFor(path, o) {
+    var refine = path === '/refine';
+    var given = refine ? o.fastPathRefineTimeout : o.fastPathTimeout;
+    if (typeof given === 'number' && given > 0) { return given; }
+    return refine ? FAST_PATH_REFINE_TIMEOUT_MS : FAST_PATH_TIMEOUT_MS;
+  }
+  // A map key's configuration is kept this long; one that could not be read is asked for again after RETRY.
+  var KEY_CONFIG_TTL_MS = 600000;
+  var KEY_CONFIG_RETRY_MS = 60000;
+  var PLAN_PREFIX = '/v1/plan';
   // A token whose expiry can be read is renewed this many seconds before it ends.
   var RENEW_BEFORE = 30;
   var TOKEN_PREFIX = 'sr_pet_';
@@ -28386,19 +28404,27 @@ function smapCreatePlan() {
   /**
    * What a token provider gave: the token string, or the token answer of POST /v1/plan/token
    * ({ access_token, token_type, expires_in, expires_at, scopes, origins }, or that answer's `{ data }` envelope).
-   * Returns { token, exp } with exp in Unix seconds (0 when it cannot be told).
+   * Returns { token, exp, fastPath } with exp in Unix seconds (0 when it cannot be told) and fastPath the answer's
+   * `fast_path.url` (null without one: every call goes to the standard path).
    */
   function readToken(t) {
     if (t && typeof t === 'object' && t.data && typeof t.data === 'object' && !t.access_token) { t = t.data; }
-    if (typeof t === 'string' && t) { return { token: t, exp: tokenExpiry(t) }; }
+    if (typeof t === 'string' && t) { return { token: t, exp: tokenExpiry(t), fastPath: null }; }
     if (t && typeof t === 'object' && typeof t.access_token === 'string' && t.access_token) {
       var exp = t.expires_at ? Date.parse(t.expires_at) / 1000 : 0;
       if (!exp && typeof t.expires_in === 'number') { exp = Date.now() / 1000 + t.expires_in; }
-      return { token: t.access_token, exp: exp || tokenExpiry(t.access_token) };
+      return { token: t.access_token, exp: exp || tokenExpiry(t.access_token), fastPath: fastPathOf(t) };
     }
     return null;
   }
 
+  /** The fast-path address of a token answer or a map key's configuration (`fast_path.url`), or null. */
+  function fastPathOf(o) {
+    var f = o && typeof o === 'object' ? o.fast_path : null;
+    var url = f && typeof f === 'object' && typeof f.url === 'string' ? f.url.replace(/\/+$/, '') : '';
+    return url ? url : null;
+  }
+
   /** The app headers of a native app: options.app is 'android:<package>' / 'apple:<bundle id>' / 'windows:<id>', or { id, cert }. */
   function appHeaders(app) {
     var h = {};
@@ -28417,6 +28443,7 @@ function smapCreatePlan() {
     if (c && typeof c.token === 'function') {
       var token = null;
       var exp = 0;
+      var fast = null;
       var pending = null;
       var fetchToken = function () {
         if (!pending) {
@@ -28426,6 +28453,7 @@ function smapCreatePlan() {
             if (!read) { throw new Error('sMap plan editor: the token provider gave no token'); }
             token = read.token;
             exp = read.exp;
+            fast = read.fastPath;
             return token;
           }, function (e) { pending = null; throw e; });
         }
@@ -28439,6 +28467,8 @@ function smapCreatePlan() {
         },
         // After a 401 SESSION_EXPIRED: forget the token so the next call asks the provider again. True when a retry may help.
         renew: function () { token = null; exp = 0; return true; },
+        // The fast-path address the latest token answer gave (read after headers()), or null.
+        fastPath: function () { return Promise.resolve(fast); },
       };
     }
     if (c && typeof c.key === 'string' && c.key) {
@@ -28446,6 +28476,7 @@ function smapCreatePlan() {
         kind: 'key',
         headers: function () { return Promise.resolve({ Authorization: 'Bearer ' + c.key }); },
         renew: function () { return false; },
+        fastPath: null, // set by the transport: the key's configuration on sMap
       };
     }
     throw new Error('sMap plan editor: credentials are { token: () => Promise<string | TokenAnswer> } or { key: string }');
@@ -28468,44 +28499,155 @@ function smapCreatePlan() {
   function cancelled() { var e = new Error('cancelled'); e.name = 'AbortError'; e.cancelled = true; return e; }
 
   /**
-   * The transport: send(method, path, body, signal) resolves { status, body, data, matrix } (matrix: the X-Plan-Matrix
-   * header) or rejects with a PlanError. A 401 SESSION_EXPIRED with a token provider asks for a new token and repeats
-   * the call once; every other refusal (SESSION_REVOKED, TOKEN_INVALID, 403 NOT_AUTHORIZED with its reason) is raised.
+   * The transport: send(method, path, body, signal) resolves { status, body, data, matrix, path } (matrix: the
+   * X-Plan-Matrix header; path: 'fast' or 'standard', where the answer came from) or rejects with a PlanError. A 401
+   * SESSION_EXPIRED with a token provider asks for a new token and repeats the call once; every other refusal
+   * (SESSION_REVOKED, TOKEN_INVALID, 403 NOT_AUTHORIZED with its reason) is raised.
+   *
+   * Fast path (OPEN-ROUTE-EDIT E19, §2f.5): when the credential names a fast-path address (the token answer's
+   * `fast_path.url`, or a map key's configuration from GET <smapUrl>/plan/v1/config), each call goes to
+   * <url>/<same path> with the same method, credential, headers and body. A 409 USE_STANDARD_PATH (or the header
+   * X-Plan-Path: standard), any 5xx, a network error or no answer within 2 s (refine: 5 s) repeats the same call once on the standard
+   * path (<baseUrl>/v1/plan/<same path>); the next call tries the fast path again. 402, 429 and every other 4xx are final.
    */
   function createTransport(o) {
     o = o || {};
     var base = String(o.baseUrl || DEFAULT_BASE).replace(/\/$/, '');
+    var smap = String(o.smapUrl || DEFAULT_SMAP).replace(/\/$/, '');
+    var fastOn = o.fastPath !== false;
+    var timeoutMs = fastPathTimeoutFor('', o);
     var creds = credentialsOf(o.credentials);
     var app = appHeaders(o.app);
     var fetchFn = o.fetch || (typeof fetch === 'function' ? function (url, init) { return fetch(url, init); } : null);
     if (!fetchFn) { throw new Error('sMap plan editor: no fetch; pass options.fetch'); }
 
+    function headersWith(h, json) {
+      var headers = { Accept: 'application/json' };
+      Object.keys(app).forEach(function (k) { headers[k] = app[k]; });
+      Object.keys(h).forEach(function (k) { headers[k] = h[k]; });
+      if (json) { headers['Content-Type'] = 'application/json'; }
+      return headers;
+    }
+
+    // One request, read to the end. With `limit` it gives up after that many ms ({ timedOut: true }); a network error
+    // resolves { failed: error } unless the caller's own signal ended it (then it rejects, cancelled).
+    function exchange(url, init, signal, limit) {
+      if (!limit) {
+        return fetchFn(url, init).then(read);
+      }
+      var inner = newController();
+      var timedOut = false;
+      var timer = null;
+      var onAbort = function () { if (inner) { inner.abort(); } };
+      if (signal) {
+        if (signal.aborted) { return Promise.reject(cancelled()); }
+        if (signal.addEventListener) { signal.addEventListener('abort', onAbort); }
+      }
+      var own = {};
+      Object.keys(init).forEach(function (k) { own[k] = init[k]; });
+      if (inner) { own.signal = inner.signal; }
+      var done = function () {
+        if (timer) { clearTimeout(timer); }
+        if (signal && signal.removeEventListener) { signal.removeEventListener('abort', onAbort); }
+      };
+      var timeout = new Promise(function (resolve) {
+        timer = setTimeout(function () { timedOut = true; if (inner) { inner.abort(); } resolve({ timedOut: true }); }, limit);
+      });
+      var answer = Promise.resolve().then(function () { return fetchFn(url, own); }).then(read).then(function (r) { return r; }, function (e) {
+        if (signal && signal.aborted) { throw cancelled(); }
+        if (timedOut) { return { timedOut: true }; }
+        return { failed: e };
+      });
+      return Promise.race([answer, timeout]).then(function (r) {
+        done();
+        if (signal && signal.aborted) { throw cancelled(); }
+        return r;
+      }, function (e) { done(); throw e; });
+    }
+
+    function read(res) {
+      return res.text().then(function (text) {
+        var json = null;
+        try { json = text ? JSON.parse(text) : null; } catch (e) { json = null; }
+        var get = function (k) { return res.headers && typeof res.headers.get === 'function' ? res.headers.get(k) : null; };
+        return { status: res.status, ok: res.ok, json: json, matrix: get('X-Plan-Matrix'), planPath: get('X-Plan-Path') };
+      });
+    }
+
+    // A map key's configuration on sMap: GET <smap>/plan/v1/config -> {"fast_path": {"url"}} or {}.
+    var keyConfig = { url: null, until: 0, pending: null };
+    function keyFastPath(h) {
+      if (Date.now() < keyConfig.until) { return Promise.resolve(keyConfig.url); }
+      if (keyConfig.pending) { return keyConfig.pending; }
+      keyConfig.pending = exchange(smap + '/plan/v1/config', { method: 'GET', headers: headersWith(h, false) }, null, timeoutMs).then(function (r) {
+        if (r.status >= 200 && r.status < 300) {
+          keyConfig.url = fastPathOf(r.json);
+          keyConfig.until = Date.now() + KEY_CONFIG_TTL_MS;
+        } else {
+          // A refusal is an answer (no fast path for this key); a failure is asked again after a minute.
+          keyConfig.url = null;
+          keyConfig.until = Date.now() + (r.status >= 400 && r.status < 500 ? KEY_CONFIG_TTL_MS : KEY_CONFIG_RETRY_MS);
+        }
+        return keyConfig.url;
+      }, function () {
+        keyConfig.url = null;
+        keyConfig.until = Date.now() + KEY_CONFIG_RETRY_MS;
+        return null;
+      }).then(function (url) { keyConfig.pending = null; return url; });
+      return keyConfig.pending;
+    }
+
+    function fastPathFor(h) {
+      if (!fastOn) { return Promise.resolve(null); }
+      return creds.fastPath ? creds.fastPath() : keyFastPath(h);
+    }
+
+    // Repeat on the standard path (§2f.5)?
+    function useStandard(r) {
+      if (r.timedOut || r.failed) { return true; }
+      if (r.status >= 500) { return true; }
+      if (r.status !== 409) { return false; }
+      return !!(r.json && r.json.error && r.json.error.code === 'USE_STANDARD_PATH') || String(r.planPath || '').toLowerCase() === 'standard';
+    }
+
     function send(method, path, body, signal, retried) {
-      return creds.headers().then(function (h) {
-        var headers = { Accept: 'application/json' };
-        Object.keys(app).forEach(function (k) { headers[k] = app[k]; });
-        Object.keys(h).forEach(function (k) { headers[k] = h[k]; });
-        var init = { method: method, headers: headers };
-        if (body !== undefined) { headers['Content-Type'] = 'application/json'; init.body = JSON.stringify(body); }
-        if (signal) { init.signal = signal; }
-        return fetchFn(base + path, init);
-      }).then(function (res) {
-        return res.text().then(function (text) {
-          var json = null;
-          try { json = text ? JSON.parse(text) : null; } catch (e) { json = null; }
-          var matrix = res.headers && typeof res.headers.get === 'function' ? res.headers.get('X-Plan-Matrix') : null;
-          if (!res.ok) {
-            var err = (json && json.error) || {};
-            if (res.status === 401 && err.code === 'SESSION_EXPIRED' && !retried && creds.renew()) { return send(method, path, body, signal, true); }
-            throw PlanError(err.message || ('HTTP ' + res.status), {
-              status: res.status, code: err.code || null, details: err.details || null, reason: err.reason || (json && json.reason) || null, path: path,
-            });
-          }
-          return { status: res.status, body: json, data: json && json.data, matrix: matrix };
+      var h = null;
+      return creds.headers().then(function (got) {
+        h = got;
+        return fastPathFor(h);
+      }).then(function (fast) {
+        if (signal && signal.aborted) { throw cancelled(); }
+        var init = { method: method, headers: headersWith(h, body !== undefined) };
+        if (body !== undefined) { init.body = JSON.stringify(body); }
+        var standard = function () {
+          var s = {};
+          Object.keys(init).forEach(function (k) { s[k] = init[k]; });
+          s.headers = headersWith(h, body !== undefined);
+          if (signal) { s.signal = signal; }
+          return exchange(base + path, s, signal, 0).then(function (r) { r.via = 'standard'; return r; });
+        };
+        if (!fast || path.indexOf(PLAN_PREFIX + '/') !== 0) { return standard(); }
+        var rest = path.slice(PLAN_PREFIX.length);
+        return exchange(fast + rest, init, signal, fastPathTimeoutFor(rest, o)).then(function (r) {
+          if (useStandard(r)) { return standard(); }
+          r.via = 'fast';
+          return r;
         });
+      }).then(function (r) {
+        if (!r.ok) {
+          var json = r.json;
+          var err = (json && json.error) || {};
+          if (r.status === 401 && err.code === 'SESSION_EXPIRED' && !retried && creds.renew()) { return send(method, path, body, signal, true); }
+          var e = PlanError(err.message || ('HTTP ' + r.status), {
+            status: r.status, code: err.code || null, details: err.details || null, reason: err.reason || (json && json.reason) || null, path: path,
+          });
+          e.via = r.via;
+          throw e;
+        }
+        return { status: r.status, body: r.json, data: r.json && r.json.data, matrix: r.matrix, path: r.via };
       });
     }
-    return { send: send, kind: creds.kind, baseUrl: base };
+    return { send: send, kind: creds.kind, baseUrl: base, smapUrl: smap };
   }
 
   // ------------------------------------------------------------------ plans
@@ -28658,7 +28800,12 @@ function smapCreatePlan() {
    * @param {Object} options
    * @param {Object} options.credentials   { token: () => Promise<string | TokenAnswer> } or { key: string }
    * @param {string|Object} [options.app]  a native app's identity: 'android:<package>' / 'apple:<bundle id>' / 'windows:<id>', or { id, cert }
-   * @param {string} [options.baseUrl]     the Open Platform (default https://open.superroute.ca)
+   * @param {string} [options.baseUrl]     the Open Platform (default https://open.superroute.ca): the standard path
+   * @param {string} [options.smapUrl]     the sMap service a map key's configuration is read from (default
+   *                                       https://tile.srsr.ca; map.planEditor passes the map's own sMap address)
+   * @param {boolean} [options.fastPath=true]  use the fast path when the credential names one (false: standard only)
+   * @param {number} [options.fastPathTimeout=2000]  ms a fast-path call may take before it is repeated on the standard path
+   * @param {number} [options.fastPathRefineTimeout=5000]  the same for refine (its search takes longer)
    * @param {Function} [options.fetch]     fetch to use (default the page's)
    * @param {Object} [options.plan]        the starting plan: { vehicles, jobs, routes, region?, profile?, departed_at? }
    * @param {string} [options.region]      used when the plan names none
@@ -28694,6 +28841,7 @@ function smapCreatePlan() {
     this._opening = null;
     this._openingKey = null;
     this._matrixRetryAt = 0;
+    this._path = null;
     this._destroyed = false;
     if (options.plan) { this.setPlan(options.plan).catch(function () {}); }
   }
@@ -28762,7 +28910,7 @@ function smapCreatePlan() {
     return {
       plan: this.getPlan(), result: this.getResult(), busy: this._busy, error: this._error, canUndo: this.canUndo(),
       canRedo: this.canRedo(), choices: clone(this._choices), locked: this.locked(), last: clone(this._last),
-      preview: this._previewResult ? clone(this._previewResult) : null,
+      preview: this._previewResult ? clone(this._previewResult) : null, path: this._path,
     };
   };
 
@@ -28972,7 +29120,7 @@ function smapCreatePlan() {
     var e = this._history[this._at] || {};
     this._emit('change', {
       kind: kind, plan: this.getPlan(), result: this.getResult(), answer: this._last ? clone(this._last.answer) : null,
-      pending: !e.result, canUndo: this.canUndo(), canRedo: this.canRedo(),
+      pending: !e.result, canUndo: this.canUndo(), canRedo: this.canRedo(), path: this._path,
     });
   };
 
@@ -29072,7 +29220,7 @@ function smapCreatePlan() {
       self._error = null;
       self._setBusy(false);
       if (self._history[self._at] === target || kind !== 'recost') { self._changed(kind); }
-      return { kind: kind, plan: self.getPlan(), result: self.getResult(), answer: clone(answer) };
+      return { kind: kind, plan: self.getPlan(), result: self.getResult(), answer: clone(answer), path: self._path };
     }, function (err) {
       var current = self._inflight === ticket;
       if (current) { self._inflight = null; self._setBusy(false); }
@@ -29103,6 +29251,7 @@ function smapCreatePlan() {
       if (matrix) { body.matrix = matrix; } else { delete body.matrix; }
       return self._transport.send('POST', path, body, signal);
     }).then(function (res) {
+      if (!self._destroyed) { self._path = res.path || null; }
       if (body.matrix) { self._snapshotSeen(res.matrix, body.matrix); }
       return res;
     }, function (err) {
@@ -29154,7 +29303,7 @@ function smapCreatePlan() {
       }
       self._matrixRetryAt = 0;
       if (self._openingKey === key) { self._matrix = id; self._matrixKey = key; }
-      self._emit('snapshot', { status: 'opened', matrix: id, expires_at: res.data.expires_at || null, node: res.data.node || null });
+      self._emit('snapshot', { status: 'opened', matrix: id, expires_at: res.data.expires_at || null, node: res.data.node || null, path: res.path || null });
       return id;
     }, function (err) {
       self._matrixRetryAt = Date.now() + SNAPSHOT_RETRY_MS;
@@ -29890,7 +30039,7 @@ function smapCreatePlan() {
    */
   function attach(map, options) {
     options = options || {};
-    var editor = new PlanEditor(Object.assign({}, options, { plan: null }));
+    var editor = new PlanEditor(Object.assign({}, options, { plan: null, smapUrl: options.smapUrl || map._base }));
     var layer = attachToMap(map, editor, options);
     var toolId = null;
     var destroyed = false;
@@ -29976,7 +30125,7 @@ function smapCreateSdk(engine, interop, plan) {
 })(typeof self !== 'undefined' ? self : this, function (engine, interop, plan) {
   'use strict';
 
-  var VERSION = '1.1.6';
+  var VERSION = '1.1.7';
   var FLAVORS = ['light', 'white', 'grayscale', 'dark', 'black'];
   var BASEMAP_SOURCE = 'basemap';
   var BUILDINGS_LAYER = 'smap-buildings-3d';
@@ -32294,7 +32443,7 @@ function SMapMap(options) {
   SMapMap.prototype = core.Map.prototype;
   return new core.Map(options);
 }
-var smapVersion = "1.1.6";
+var smapVersion = "1.1.7";
 var smapStyles = ['light', 'white', 'grayscale', 'dark', 'black'];
 /** The bundled rendering engine, for anything the SDK does not wrap (loaded on the first call). */
 function smapGetEngine() { return smapLoad().engine; }