dsh-vision-router 2.2.1 → 2.2.2

package/lib/settings-client-017-compat.js

@@ -0,0 +1,331 @@
+import { htmlHasScriptMarker } from './html-script-marker.js'
+import { LOCAL_SETTINGS_PATH } from './dsh-settings-017-compat.js'
+
+const SETTINGS_017_MARK = 'data-vision-router-settings-017-compat'
+
+export const SETTINGS_017_CLIENT_PRELUDE = String.raw`(function(){
+  'use strict';
+  var TARGET = 'dsh-vision-router';
+  var ENDPOINT = '${LOCAL_SETTINGS_PATH}';
+  var contextCache = typeof WeakMap === 'function' ? new WeakMap() : undefined;
+  var scopeCache = typeof WeakMap === 'function' ? new WeakMap() : undefined;
+  var binderCache = typeof WeakMap === 'function' ? new WeakMap() : undefined;
+  var connectionCache = typeof WeakMap === 'function' ? new WeakMap() : undefined;
+
+  function safeGet(ctx, name) {
+    if (!ctx) return undefined;
+    try {
+      if (typeof ctx.get === 'function') {
+        var value = ctx.get(name);
+        if (value !== undefined && value !== null) return value;
+      }
+    } catch (_) {}
+    try { return ctx[name]; } catch (_) { return undefined; }
+  }
+
+  function isLoopbackLocation(locationLike) {
+    var hostname = locationLike && typeof locationLike.hostname === 'string'
+      ? locationLike.hostname.toLowerCase().replace(/^\[|\]$/g, '')
+      : '';
+    if (hostname === 'localhost' || hostname.endsWith('.localhost') || hostname === '::1') return true;
+    return /^127(?:\.\d{1,3}){3}$/.test(hostname);
+  }
+
+  function normalizeConnection(connection) {
+    if (!connection || typeof connection !== 'object') return connection;
+    var locationLike;
+    try { locationLike = window && window.location; } catch (_) { locationLike = undefined; }
+    if (!isLoopbackLocation(locationLike) || connection.isLoopback !== false) return connection;
+    if (connectionCache && connectionCache.has(connection)) return connectionCache.get(connection);
+    var wrapped = new Proxy(connection, {
+      get: function(target, property) {
+        if (property === 'isLoopback') return true;
+        var value = Reflect.get(target, property, target);
+        return typeof value === 'function' ? value.bind(target) : value;
+      }
+    });
+    if (connectionCache) connectionCache.set(connection, wrapped);
+    return wrapped;
+  }
+
+  function errorOf(value, fallback) {
+    var detail = value && value.error;
+    var error = new Error(detail && detail.message ? detail.message : fallback);
+    if (detail && detail.code) error.code = detail.code;
+    if (detail && detail.details !== undefined) error.details = detail.details;
+    return error;
+  }
+
+  function createScope() {
+    var listeners = new Set();
+    var writeTail = Promise.resolve();
+    var inFlight;
+    var snapshot = Object.freeze({
+      status: 'loading', value: undefined, base: undefined, user: undefined,
+      revision: undefined, writable: false, mode: 'host'
+    });
+    function publish(next) {
+      snapshot = Object.freeze(next);
+      listeners.forEach(function(listener){ try { listener(); } catch (_) {} });
+    }
+    function accept(view) {
+      if (!view || !view.value || typeof view.value !== 'object' || Array.isArray(view.value)
+          || !Number.isInteger(view.revision) || view.revision < 0) {
+        throw new Error('Vision Router local settings returned an invalid view');
+      }
+      publish({
+        status: 'ready', value: view.value, base: view.base, user: view.user,
+        revision: view.revision, writable: view.writable === true, mode: 'host'
+      });
+    }
+    async function request(method, payload) {
+      if (typeof fetch !== 'function') throw new Error('Vision Router local settings transport is unavailable');
+      var response = await fetch(ENDPOINT, {
+        method: method,
+        headers: { accept: 'application/json', ...(method === 'POST' ? { 'content-type': 'application/json' } : {}) },
+        cache: 'no-store',
+        credentials: 'same-origin',
+        ...(method === 'POST' ? { body: JSON.stringify(payload) } : {})
+      });
+      var body;
+      try { body = await response.json(); } catch (_) { body = undefined; }
+      if (!response.ok || !body || body.ok !== true) throw errorOf(body, 'Vision Router local settings request failed');
+      return body.value;
+    }
+    function load(restart) {
+      if (!restart && inFlight) return inFlight;
+      var task = request('GET').then(accept, function(error){
+        publish({
+          status: 'unavailable', value: undefined, base: undefined, user: undefined,
+          revision: undefined, writable: false, mode: 'host', error: error && error.message ? error.message : String(error)
+        });
+        throw error;
+      });
+      var held = task.finally(function(){ if (inFlight === held) inFlight = undefined; });
+      inFlight = held;
+      return held;
+    }
+    function writeOps(ops) {
+      if (!Array.isArray(ops) || ops.length === 0) return Promise.reject(new TypeError('settings operations must be a non-empty array'));
+      var task = writeTail.then(async function(){
+        if (snapshot.status !== 'ready' || !Number.isInteger(snapshot.revision)) await load(true);
+        if (snapshot.status !== 'ready' || !Number.isInteger(snapshot.revision)) throw new Error('Vision Router local settings are not ready');
+        if (!snapshot.writable) throw new Error('Vision Router settings provider is read-only');
+        try {
+          // One ConfigEditor edit may reload DVR. Keep all fields from one UI
+          // Save inside that single Host transaction so a second request cannot
+          // get stranded between plugin generations.
+          var view = await request('POST', { ops: ops, expectedRevision: snapshot.revision });
+          accept(view);
+        } catch (error) {
+          try { await load(true); } catch (_) {}
+          throw error;
+        }
+      });
+      writeTail = task.catch(function(){});
+      return task;
+    }
+    function planOps(items) {
+      if (!Array.isArray(items) || items.length === 0) throw new TypeError('settings plan must be a non-empty array');
+      return items.map(function(item){
+        if (!item || typeof item.key !== 'string' || item.key.length === 0 || !item.run) {
+          throw new TypeError('settings plan item is invalid');
+        }
+        return item.run.clear
+          ? { op: 'unset', path: [item.key] }
+          : { op: 'set', path: [item.key], value: item.run.value };
+      });
+    }
+    var scope = {
+      getSnapshot: function(){ return snapshot; },
+      subscribe: function(listener){
+        if (typeof listener !== 'function') return function(){};
+        listeners.add(listener);
+        return function(){ listeners.delete(listener); };
+      },
+      load: function(){ return load(false); },
+      reload: function(){ return load(true); },
+      set: function(field, value){ return writeOps([{ op: 'set', path: [field], value: value }]); },
+      unset: function(field){ return writeOps([{ op: 'unset', path: [field] }]); },
+      __visionRouterWritePlan: function(items){ return writeOps(planOps(items)); },
+      dispose: async function(){ listeners.clear(); await Promise.allSettled([inFlight, writeTail].filter(Boolean)); }
+    };
+    void load(false).catch(function(){});
+    return scope;
+  }
+
+  function scopeFor(ctx) {
+    if (scopeCache && scopeCache.has(ctx)) return scopeCache.get(ctx);
+    var scope = createScope();
+    if (scopeCache) scopeCache.set(ctx, scope);
+    return scope;
+  }
+
+  function syntheticBinder(ctx, original) {
+    return {
+      bind: function(spec) {
+        if (spec && spec.namespace === 'vision-router') return scopeFor(ctx);
+        if (original && typeof original.bind === 'function') return original.bind(spec);
+        throw new Error('Settings scope ' + String(spec && spec.namespace) + ' is unavailable');
+      }
+    };
+  }
+
+  function configFormsBinder(ctx) {
+    var forms = safeGet(ctx, 'configForms');
+    if (!forms || typeof forms.get !== 'function') return undefined;
+    if (binderCache && binderCache.has(forms)) return binderCache.get(forms);
+    var binder = {
+      bind: function(spec) {
+        var namespace = spec && spec.namespace;
+        if (typeof namespace !== 'string' || namespace.length === 0) {
+          throw new TypeError('settings namespace must be a non-empty string');
+        }
+        return forms.get(namespace);
+      }
+    };
+    if (binderCache) binderCache.set(forms, binder);
+    return binder;
+  }
+
+  function wrapContext(ctx) {
+    if (!ctx || typeof ctx !== 'object') return ctx;
+    if (contextCache && contextCache.has(ctx)) return contextCache.get(ctx);
+    var wrapped = new Proxy(ctx, {
+      get: function(target, property) {
+        if (property === 'settingsScope') {
+          var original = safeGet(target, 'settingsScope');
+          if (original && typeof original.bind === 'function') return original;
+          // DSH 0.1.7 configForms only mirrors Config fields declared volatile.
+          // DVR must keep its public Config ordinary for the older supported Host
+          // window, so its namespace intentionally uses the local-only ConfigEditor
+          // bridge while other namespaces may still delegate to native configForms.
+          var official = configFormsBinder(target);
+          return syntheticBinder(ctx, official);
+        }
+        if (property === 'get') {
+          var getter = Reflect.get(target, property, target);
+          if (typeof getter !== 'function') return getter;
+          return function(name) {
+            var value = getter.call(target, name);
+            return name === 'connection' ? normalizeConnection(value) : value;
+          };
+        }
+        var value = Reflect.get(target, property, target);
+        return typeof value === 'function' ? value.bind(target) : value;
+      }
+    });
+    if (contextCache) contextCache.set(ctx, wrapped);
+    return wrapped;
+  }
+
+  function requireConfigForms(plugin) {
+    if (!plugin || !Array.isArray(plugin.inject)) return plugin;
+    var inject = [];
+    var inserted = false;
+    for (var index = 0; index < plugin.inject.length; index += 1) {
+      var service = plugin.inject[index];
+      if (service === 'settingsScope') {
+        if (!inserted) {
+          inject.push('configForms');
+          inserted = true;
+        }
+        continue;
+      }
+      if (service === 'configForms') inserted = true;
+      if (inject.indexOf(service) === -1) inject.push(service);
+    }
+    // Another loader compatibility layer may already have removed the legacy
+    // dependency before this factory runs. DSH 0.1.7 still requires the native
+    // configForms service to be activation-ready before Vision Router applies.
+    if (!inserted) inject.unshift('configForms');
+    try {
+      plugin.inject = inject;
+      return plugin;
+    } catch (_) {
+      return Object.assign({}, plugin, { inject: inject });
+    }
+  }
+
+  function patchLoader(loader) {
+    if (!loader || typeof loader.load !== 'function' || loader.load.__visionRouterSettings017Compat) return;
+    var original = loader.load;
+    function load(spec) {
+      if (spec && spec.id === TARGET && typeof spec.factory === 'function') {
+        var factory = spec.factory;
+        spec = Object.assign({}, spec, {
+          factory: function(require) {
+            var plugin = requireConfigForms(factory(require));
+            if (plugin && typeof plugin.apply === 'function' && !plugin.apply.__visionRouterSettings017Compat) {
+              var apply = plugin.apply;
+              var wrappedApply = function(ctx) {
+                var rest = Array.prototype.slice.call(arguments, 1);
+                return apply.apply(plugin, [wrapContext(ctx)].concat(rest));
+              };
+              Object.defineProperty(wrappedApply, '__visionRouterSettings017Compat', { value: true });
+              plugin.apply = wrappedApply;
+            }
+            return plugin;
+          }
+        });
+      }
+      return original.call(this, spec);
+    }
+    Object.defineProperty(load, '__visionRouterSettings017Compat', { value: true });
+    loader.load = load;
+  }
+
+  function patchCreate(loader) {
+    if (!loader || typeof loader.create !== 'function' || loader.create.__visionRouterSettings017Compat) return;
+    var original = loader.create;
+    function create() {
+      var result = original.apply(this, arguments);
+      patchLoader(loader);
+      if (result && result !== loader) patchLoader(result);
+      return result;
+    }
+    Object.defineProperty(create, '__visionRouterSettings017Compat', { value: true });
+    loader.create = create;
+    if (loader.mode === 'live') patchLoader(loader);
+  }
+
+  function install() {
+    var descriptor = Object.getOwnPropertyDescriptor(window, '__ModuleLoader__');
+    var stored = window.__ModuleLoader__;
+    if (stored) patchCreate(stored);
+    if (descriptor && descriptor.configurable === false) return;
+    var previousGet = descriptor && descriptor.get;
+    var previousSet = descriptor && descriptor.set;
+    Object.defineProperty(window, '__ModuleLoader__', {
+      configurable: true,
+      enumerable: !descriptor || descriptor.enumerable !== false,
+      get: function(){ return previousGet ? previousGet.call(window) : stored; },
+      set: function(value) {
+        if (previousSet) previousSet.call(window, value); else stored = value;
+        try { patchCreate(previousGet ? previousGet.call(window) : value); } catch (_) {}
+      }
+    });
+  }
+
+  try { install(); } catch (_) {}
+})();`
+
+export function injectSettings017ClientPrelude(html) {
+  if (typeof html !== 'string' || htmlHasScriptMarker(html, SETTINGS_017_MARK)) return html
+  const safe = SETTINGS_017_CLIENT_PRELUDE.replace(/<\/script/gi, '<\\/script')
+  const script = `<script ${SETTINGS_017_MARK}>${safe}</script>`
+  const closeHead = html.indexOf('</head>')
+  return closeHead === -1 ? `${html}${script}` : `${html.slice(0, closeHead)}${script}${html.slice(closeHead)}`
+}
+
+export function installSettings017ClientCompatibility(ctx) {
+  if (!ctx || typeof ctx.inject !== 'function') return
+  // ConfigEditor is the generation fence: old supported Hosts keep their native
+  // settingsScope activation contract and never see this client shim.
+  ctx.inject(['configEditor', 'webServer'], (webCtx) => {
+    webCtx.effect(
+      () => webCtx.webServer.tapIndex(injectSettings017ClientPrelude),
+      'vision-router: DSH 0.1.7 settings client compatibility',
+    )
+  })
+}

package/lib/settings-client-rc8-lifecycle.js

@@ -31,6 +31,14 @@ export const SETTINGS_RC8_CLIENT_PRELUDE = String.raw`(function(){
     return undefined;
   }
 
+  function isLoopbackLocation(locationLike) {
+    var hostname = locationLike && typeof locationLike.hostname === 'string'
+      ? locationLike.hostname.toLowerCase().replace(/^\[|\]$/g, '')
+      : '';
+    if (hostname === 'localhost' || hostname.endsWith('.localhost') || hostname === '::1') return true;
+    return /^127(?:\.\d{1,3}){3}$/.test(hostname);
+  }
+
   async function writePermission(operation, value, revision) {
     if (typeof fetch !== 'function') throw new Error('Vision Router local settings transport is unavailable');
     var payload = { operation: operation };
@@ -269,6 +277,11 @@ export const SETTINGS_RC8_CLIENT_PRELUDE = String.raw`(function(){
     if (connectionCache && connectionCache.has(connection)) return connectionCache.get(connection);
     var wrapped = new Proxy(connection, {
       get: function(target, property) {
+        if (property === 'isLoopback') {
+          var locationLike;
+          try { locationLike = window && window.location; } catch (_) { locationLike = undefined; }
+          if (isLoopbackLocation(locationLike)) return true;
+        }
         if (property === 'rpc') return wrapRpc(Reflect.get(target, property, target));
         var value = Reflect.get(target, property, target);
         return typeof value === 'function' ? value.bind(target) : value;

package/lib/web/dsh-settings-017-root-transport.js

@@ -0,0 +1,299 @@
+import {
+  DSH_017_SETTINGS_COMPAT_MARK,
+  LOCAL_SETTINGS_PATH,
+} from '../dsh-settings-017-compat.js'
+
+const BODY_LIMIT_BYTES = 256 * 1024
+const ROOT_TRANSPORT_REGISTRY_KEY = Symbol.for('dsh-vision-router.settings-017-root-local-transport')
+const SLOW_MUTATION_MS = 5_000
+const TRACE_ENV = 'DVR_SETTINGS_017_TRACE'
+
+function objectLike(value) {
+  return value !== null && typeof value === 'object'
+}
+
+function trace(stage, detail) {
+  if (process.env[TRACE_ENV] !== '1') return
+  try {
+    console.warn(`vision-router: DSH 0.1.7 settings trace ${stage}${detail === undefined ? '' : ` ${JSON.stringify(detail)}`}`)
+  } catch {}
+}
+
+function transportRegistry() {
+  let registry = globalThis[ROOT_TRANSPORT_REGISTRY_KEY]
+  if (!(registry instanceof WeakMap)) {
+    registry = new WeakMap()
+    Object.defineProperty(globalThis, ROOT_TRANSPORT_REGISTRY_KEY, {
+      value: registry,
+      configurable: true,
+    })
+  }
+  return registry
+}
+
+function rootOf(ctx) {
+  try {
+    if (objectLike(ctx?.root)) return ctx.root
+  } catch {}
+  return ctx
+}
+
+function stateFor(root) {
+  const registry = transportRegistry()
+  let state = registry.get(root)
+  if (!state) {
+    state = {
+      current: undefined,
+      routeOwner: undefined,
+      routeInstalling: false,
+      generationSequence: 0,
+      requestSequence: 0,
+    }
+    registry.set(root, state)
+  }
+  return state
+}
+
+function serviceOf(ctx, name) {
+  try {
+    const value = typeof ctx?.get === 'function' ? ctx.get(name) : undefined
+    if (value !== undefined && value !== null) return value
+  } catch {}
+  try {
+    const value = ctx?.[name]
+    return value === undefined || value === null ? undefined : value
+  } catch {
+    return undefined
+  }
+}
+
+function compatibleSettings(ctx) {
+  const settings = serviceOf(ctx, 'settings')
+  if (settings?.[DSH_017_SETTINGS_COMPAT_MARK] !== true) return undefined
+  if (typeof settings.describe !== 'function' || typeof settings.mutate !== 'function') return undefined
+  return settings
+}
+
+function namespaceDescriptor(settings) {
+  const descriptors = settings.describe({ redactSecrets: true })
+  return Array.isArray(descriptors) ? descriptors.find((entry) => entry?.ns === 'vision-router') : undefined
+}
+
+function sendJson(res, status, body) {
+  res.writeHead(status, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+  })
+  res.end(JSON.stringify(body))
+}
+
+async function readJson(req) {
+  let size = 0
+  const chunks = []
+  for await (const chunk of req) {
+    const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)
+    size += bytes.length
+    if (size > BODY_LIMIT_BYTES) throw Object.assign(new Error('request body too large'), { statusCode: 413 })
+    chunks.push(bytes)
+  }
+  if (chunks.length === 0) return {}
+  return JSON.parse(Buffer.concat(chunks).toString('utf8'))
+}
+
+function currentSettings(state) {
+  const generation = state.current
+  if (!generation || generation.active === false) return undefined
+  try {
+    return generation.resolve()
+  } catch {
+    return undefined
+  }
+}
+
+function flattenEffectLabels(effects) {
+  const labels = []
+  const visit = (rows) => {
+    if (!Array.isArray(rows)) return
+    for (const row of rows) {
+      if (!row || typeof row !== 'object') continue
+      if (typeof row.label === 'string') labels.push(row.label)
+      visit(row.children)
+    }
+  }
+  visit(effects)
+  return labels
+}
+
+function slowMutationSnapshot(root) {
+  const loader = serviceOf(root, 'loader')
+  let entries = []
+  try { entries = typeof loader?.entries === 'function' ? [...loader.entries()] : [] } catch {}
+  return entries.flatMap((entry) => {
+    const fiber = entry?.fiber
+    if (!fiber || (entry?.options?.id !== 'vision-router' && !fiber.inertia)) return []
+    let effects = []
+    try { effects = typeof fiber.getEffects === 'function' ? flattenEffectLabels(fiber.getEffects()) : [] } catch {}
+    return [{
+      id: entry?.options?.id,
+      state: fiber.state,
+      inertia: Boolean(fiber.inertia),
+      effects,
+    }]
+  })
+}
+
+function beginSlowMutationWatch(root, requestId) {
+  return setTimeout(() => {
+    const snapshot = slowMutationSnapshot(root)
+    const message = `vision-router: DSH 0.1.7 settings mutation still reconciling after ${SLOW_MUTATION_MS}ms request=${requestId} ${JSON.stringify(snapshot)}`
+    try {
+      if (root?.logger && typeof root.logger.warn === 'function') root.logger.warn(message)
+      else console.warn(message)
+    } catch {
+      try { console.warn(message) } catch {}
+    }
+  }, SLOW_MUTATION_MS)
+}
+
+function routeFor(root, state) {
+  return {
+    kind: 'exact',
+    path: LOCAL_SETTINGS_PATH,
+    async handler(req, res) {
+      const requestId = ++state.requestSequence
+      trace('handler-enter', { requestId, method: req.method, generation: state.current?.id })
+      const settings = currentSettings(state)
+      if (!settings) {
+        trace('settings-unavailable', { requestId })
+        sendJson(res, 404, { ok: false, error: { code: 'settings-unavailable', message: 'Vision Router settings are unavailable' } })
+        return
+      }
+
+      if (req.method === 'GET') {
+        const descriptor = namespaceDescriptor(settings)
+        if (!descriptor) {
+          sendJson(res, 404, { ok: false, error: { code: 'settings-unavailable', message: 'Vision Router settings are unavailable' } })
+          return
+        }
+        sendJson(res, 200, { ok: true, value: { ...descriptor, writable: settings.writable === true } })
+        trace('response', { requestId, status: 200, revision: descriptor.revision })
+        return
+      }
+
+      if (req.method !== 'POST') {
+        res.setHeader('Allow', 'GET, POST')
+        sendJson(res, 405, { ok: false, error: { code: 'method-not-allowed', message: 'method not allowed' } })
+        return
+      }
+
+      let slowTimer
+      try {
+        trace('body-read-start', { requestId })
+        const payload = await readJson(req)
+        trace('body-read-done', { requestId, expectedRevision: payload?.expectedRevision, ops: payload?.ops?.length })
+        slowTimer = beginSlowMutationWatch(root, requestId)
+        trace('mutate-start', { requestId, generation: state.current?.id })
+        await settings.mutate('vision-router', payload?.ops, payload?.expectedRevision)
+        trace('mutate-done', { requestId, generation: state.current?.id })
+
+        // ConfigEditor.edit() reconciles the profile and can dispose the plugin
+        // generation that accepted this request. The route itself is owned by a
+        // root child fiber that depends only on WebServer, so finish the response
+        // from the newly-mounted DVR generation when present.
+        const afterSettings = currentSettings(state) ?? settings
+        const descriptor = namespaceDescriptor(afterSettings)
+        if (!descriptor) throw new Error('Vision Router settings disappeared after the write')
+        sendJson(res, 200, { ok: true, value: { ...descriptor, writable: afterSettings.writable === true } })
+        trace('response', { requestId, status: 200, revision: descriptor.revision })
+      } catch (error) {
+        const conflict = error?.code === 'SETTINGS_CONFLICT'
+        const status = error?.statusCode ?? (conflict ? 409 : 400)
+        trace('response-error', { requestId, status, code: error?.code, message: error?.message ?? String(error) })
+        sendJson(res, status, {
+          ok: false,
+          error: {
+            code: conflict ? 'settings-conflict' : 'settings-rejected',
+            message: error?.message ?? String(error),
+            ...(conflict ? { details: { expected: error.expected, actual: error.actual } } : {}),
+          },
+        })
+      } finally {
+        if (slowTimer) clearTimeout(slowTimer)
+      }
+    },
+  }
+}
+
+function ensureRootRoute(root, state) {
+  if (state.routeOwner || state.routeInstalling) return
+  if (typeof root?.inject !== 'function') {
+    throw new Error('Vision Router requires root dependency injection for the DSH 0.1.7 local settings route')
+  }
+
+  state.routeInstalling = true
+  try {
+    const owner = root.inject(['webServer'], (webCtx) => {
+      if (!webCtx?.webServer || typeof webCtx.webServer.register !== 'function' || typeof webCtx.effect !== 'function') {
+        throw new Error('Vision Router requires WebServer route registration on DSH 0.1.7')
+      }
+      trace('route-register', {})
+      webCtx.effect(
+        () => {
+          const dispose = webCtx.webServer.register(routeFor(root, state))
+          return () => {
+            trace('route-dispose', {})
+            dispose()
+          }
+        },
+        'vision-router: DSH 0.1.7 root local settings transport',
+      )
+    })
+    // `root.inject()` creates a root child fiber. It is independent from the
+    // DVR plugin fiber and therefore survives ConfigEditor reconciliation of
+    // the `vision-router` entry. Keep the owner reachable for the process life.
+    state.routeOwner = owner ?? true
+  } catch (error) {
+    state.routeOwner = undefined
+    throw error
+  } finally {
+    state.routeInstalling = false
+  }
+}
+
+/**
+ * ConfigEditor.edit() reconciles the plugin configuration and therefore disposes
+ * the DVR plugin fiber while a Settings POST is still in flight. A dedicated
+ * root child fiber owns the HTTP route and depends only on WebServer; individual
+ * DVR generations only publish a resolver for their current settings facade.
+ */
+export function installDsh017RootLocalSettingsTransport(ctx) {
+  if (!ctx || typeof ctx.inject !== 'function') return
+  const root = rootOf(ctx)
+  if (!objectLike(root)) return
+  const state = stateFor(root)
+
+  ctx.inject(['settings'], (settingsCtx) => {
+    const mounted = compatibleSettings(settingsCtx)
+    if (!mounted) return
+
+    const generation = {
+      id: ++state.generationSequence,
+      active: true,
+      resolve: () => compatibleSettings(ctx) ?? mounted,
+    }
+    state.current = generation
+    trace('generation-mount', { generation: generation.id })
+    ensureRootRoute(root, state)
+
+    if (typeof settingsCtx?.effect === 'function') {
+      settingsCtx.effect(
+        () => () => {
+          generation.active = false
+          if (state.current === generation) state.current = undefined
+          trace('generation-dispose', { generation: generation.id })
+        },
+        'vision-router: DSH 0.1.7 settings generation',
+      )
+    }
+  })
+}