@route-forge/core 3.0.0 → 3.1.0

package/dist/route-forge.global.js

@@ -132,6 +132,36 @@ var RouteForge = (function (exports) {
     }
   };
 
+  // src/interceptors/manager.ts
+  var InterceptorManagerImpl = class {
+    constructor() {
+      this.handlers = [];
+      this.nextId = 0;
+    }
+    use(onFulfilled, onRejected) {
+      const id = this.nextId++;
+      this.handlers.push({ id, onFulfilled, onRejected });
+      return id;
+    }
+    eject(id) {
+      const idx = this.handlers.findIndex((h) => h.id === id);
+      if (idx >= 0) this.handlers.splice(idx, 1);
+    }
+    clear() {
+      this.handlers = [];
+    }
+    forEach(fn) {
+      for (const h of this.handlers) fn(h);
+    }
+    /** 测试用：当前注册数量 */
+    get size() {
+      return this.handlers.length;
+    }
+  };
+  function createInterceptorManager() {
+    return new InterceptorManagerImpl();
+  }
+
   // src/errors.ts
   var ForgeError = class extends Error {
     constructor(message, opts) {
@@ -248,32 +278,7 @@ var RouteForge = (function (exports) {
     }
   };
 
-  // src/interceptors.ts
-  var InterceptorManagerImpl = class {
-    constructor() {
-      this.handlers = [];
-      this.nextId = 0;
-    }
-    use(onFulfilled, onRejected) {
-      const id = this.nextId++;
-      this.handlers.push({ id, onFulfilled, onRejected });
-      return id;
-    }
-    eject(id) {
-      const idx = this.handlers.findIndex((h) => h.id === id);
-      if (idx >= 0) this.handlers.splice(idx, 1);
-    }
-    clear() {
-      this.handlers = [];
-    }
-    forEach(fn) {
-      for (const h of this.handlers) fn(h);
-    }
-    /** 测试用：当前注册数量 */
-    get size() {
-      return this.handlers.length;
-    }
-  };
+  // src/interceptors/runner.ts
   async function runRequestInterceptors(manager, initial) {
     const handlers = [];
     manager.forEach((h) => handlers.push(h));
@@ -310,9 +315,8 @@ var RouteForge = (function (exports) {
     }
     return p;
   }
-  function createInterceptorManager() {
-    return new InterceptorManagerImpl();
-  }
+
+  // src/interceptors/normalize.ts
   function normalizeInterceptorDeclaration(value) {
     if (value === null || value === void 0) return {};
     let rawResolve;
@@ -582,6 +586,69 @@ var RouteForge = (function (exports) {
     return createBuiltinHttp(opts.forgeInterceptors);
   }
 
+  // src/adapter-bootstrap.ts
+  function createAdapterBootstrap(deps) {
+    const { adapter, requestInterceptors, responseInterceptors, warnings } = deps;
+    const adapterPromise = resolveAdapter({
+      adapter,
+      forgeInterceptors: { request: requestInterceptors, response: responseInterceptors }
+    });
+    let adapterResolved = false;
+    let adapterObj = null;
+    return async function ensureAdapter() {
+      if (!adapterResolved) {
+        adapterObj = await adapterPromise.catch((e) => {
+          if (e instanceof AdapterNotFoundError) throw e;
+          if (warnings) {
+            console.warn(
+              `[route-forge] adapter initialization failed (${e?.message ?? String(e)}); falling back to builtin`
+            );
+          }
+          return resolveAdapter({
+            adapter: "builtin",
+            forgeInterceptors: { request: requestInterceptors, response: responseInterceptors }
+          });
+        });
+        adapterResolved = true;
+      }
+      return adapterObj;
+    };
+  }
+
+  // src/ready-latch.ts
+  function createReadyLatch() {
+    let resolveReady;
+    let rejectReady;
+    const readyPromise = new Promise((resolve, reject) => {
+      resolveReady = resolve;
+      rejectReady = reject;
+    });
+    let settledValue;
+    readyPromise.catch(() => {
+    });
+    let readySettledOk = false;
+    readyPromise.then(
+      (value) => {
+        settledValue = value;
+        readySettledOk = true;
+      },
+      () => {
+      }
+    );
+    function ready(onFulfilled, onRejected) {
+      if (onFulfilled) {
+        return readyPromise.then(onFulfilled, onRejected).then(() => settledValue);
+      }
+      return readyPromise;
+    }
+    return {
+      resolve: (value) => resolveReady(value),
+      reject: (reason) => rejectReady(reason),
+      isReady: () => readySettledOk,
+      ready
+    };
+  }
+
   // src/loading.ts
   var LoadingTracker = class {
     constructor() {
@@ -641,12 +708,107 @@ var RouteForge = (function (exports) {
     }
   };
 
-  // src/url-builder.ts
+  // src/route-change.ts
+  var RouteChangeTracker = class {
+    constructor() {
+      this.subscribers = /* @__PURE__ */ new Set();
+      /** 本微任务周期内累积的变更层级（去重） */
+      this.pending = /* @__PURE__ */ new Set();
+      /** 是否已排定一次微任务 flush */
+      this.scheduled = false;
+    }
+    /** 订阅路由表数据变更；返回取消订阅函数 */
+    subscribe(cb) {
+      this.subscribers.add(cb);
+      return () => {
+        this.subscribers.delete(cb);
+      };
+    }
+    /** 记录某层级数据已变更；同一 tick 多次调用合并为一次投递（每层级各投一次） */
+    notify(level) {
+      if (this.subscribers.size === 0) return;
+      this.pending.add(level);
+      if (this.scheduled) return;
+      this.scheduled = true;
+      queueMicrotask(() => this.flush());
+    }
+    /** 一次性投递本周期累积的所有变更层级；单订阅者抛错不影响其它 */
+    flush() {
+      this.scheduled = false;
+      const levels = [...this.pending];
+      this.pending.clear();
+      for (const level of levels) {
+        for (const cb of this.subscribers) {
+          try {
+            cb(level);
+          } catch {
+          }
+        }
+      }
+    }
+  };
+
+  // src/url/utils.ts
+  function trimTrailingSlash(s) {
+    return s.endsWith("/") ? s.slice(0, -1) : s;
+  }
+  function withLeadingSlash(s) {
+    return s.startsWith("/") ? s : `/${s}`;
+  }
+  function joinBaseAndPath(base, path) {
+    return `${trimTrailingSlash(base)}${withLeadingSlash(path)}`;
+  }
+
+  // src/url/endpoint.ts
   function buildUrl(level, ctx) {
-    const base = ctx.baseURL.endsWith("/") ? ctx.baseURL.slice(0, -1) : ctx.baseURL;
-    const ep = ctx.endpoint.startsWith("/") ? ctx.endpoint : `/${ctx.endpoint}`;
-    return `${base}${ep}/${encodeURIComponent(level)}`;
+    return `${joinBaseAndPath(ctx.baseURL, withLeadingSlash(ctx.endpoint))}/${encodeURIComponent(level)}`;
   }
+
+  // src/url/params.ts
+  function resolveApiParams(input) {
+    const {
+      params: explicitParams,
+      query: rawQuery,
+      body: rawBody,
+      headers: rawHeaders,
+      timeout: perCallTimeout,
+      signal: rawSignal,
+      ...flatRest
+    } = input;
+    const pathParams = explicitParams ? { ...explicitParams } : {};
+    for (const [k, v] of Object.entries(flatRest)) {
+      if (!(k in pathParams)) {
+        pathParams[k] = v;
+      }
+    }
+    let query;
+    let body;
+    let headers;
+    if (rawQuery !== void 0) {
+      if (typeof rawQuery === "object" && rawQuery !== null) {
+        query = rawQuery;
+      } else if (!("query" in pathParams)) {
+        pathParams.query = rawQuery;
+      }
+    }
+    if (rawBody !== void 0) {
+      if (typeof rawBody !== "string" && typeof rawBody !== "number") {
+        body = rawBody;
+      } else if (!("body" in pathParams)) {
+        pathParams.body = rawBody;
+      }
+    }
+    if (rawHeaders !== void 0) {
+      if (typeof rawHeaders === "object" && rawHeaders !== null) {
+        headers = rawHeaders;
+      } else if (!("headers" in pathParams)) {
+        pathParams.headers = rawHeaders;
+      }
+    }
+    return { pathParams, query, body, headers, timeout: perCallTimeout, signal: rawSignal };
+  }
+
+  // src/url/request.ts
   function buildRequestUrl(meta, params, ctx) {
     const defaults = meta.parameter_defaults ?? {};
     const missingRequired = [];
@@ -681,10 +843,10 @@ var RouteForge = (function (exports) {
     });
     uri = uri.replace(/\/+/g, "/").replace(/\/$/, "");
     if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(ctx.urlPrefix)) {
-      const prefix2 = ctx.urlPrefix.endsWith("/") ? ctx.urlPrefix.slice(0, -1) : ctx.urlPrefix;
+      const prefix2 = trimTrailingSlash(ctx.urlPrefix);
       return uri.startsWith("/") ? `${prefix2}${uri}` : `${prefix2}/${uri}`;
     }
-    const base = ctx.baseURL.endsWith("/") ? ctx.baseURL.slice(0, -1) : ctx.baseURL;
+    const base = trimTrailingSlash(ctx.baseURL);
     const prefix = ctx.urlPrefix;
     return uri.startsWith("/") ? `${base}${prefix}${uri}` : `${base}${prefix}/${uri}`;
   }
@@ -703,46 +865,18 @@ var RouteForge = (function (exports) {
     if (!qs) return url;
     return url.includes("?") ? `${url}&${qs}` : `${url}?${qs}`;
   }
-  function resolveApiParams(input) {
-    const {
-      params: explicitParams,
-      query: rawQuery,
-      body: rawBody,
-      headers: rawHeaders,
-      timeout: perCallTimeout,
-      ...flatRest
-    } = input;
-    const pathParams = explicitParams ? { ...explicitParams } : {};
-    for (const [k, v] of Object.entries(flatRest)) {
-      if (!(k in pathParams)) {
-        pathParams[k] = v;
-      }
-    }
-    let query;
-    let body;
-    let headers;
-    if (rawQuery !== void 0) {
-      if (typeof rawQuery === "object" && rawQuery !== null) {
-        query = rawQuery;
-      } else if (!("query" in pathParams)) {
-        pathParams.query = rawQuery;
-      }
-    }
-    if (rawBody !== void 0) {
-      if (typeof rawBody !== "string" && typeof rawBody !== "number") {
-        body = rawBody;
-      } else if (!("body" in pathParams)) {
-        pathParams.body = rawBody;
-      }
-    }
-    if (rawHeaders !== void 0) {
-      if (typeof rawHeaders === "object" && rawHeaders !== null) {
-        headers = rawHeaders;
-      } else if (!("headers" in pathParams)) {
-        pathParams.headers = rawHeaders;
+  var RESERVED_API_KEYS = ["params", "query", "body", "headers", "timeout", "signal"];
+  function buildRouteUrl(meta, params, ctx) {
+    if (params) {
+      const hasReservedKey = RESERVED_API_KEYS.some((k) => k in params);
+      if (!hasReservedKey) {
+        return buildRequestUrl(meta, params, ctx);
       }
+    } else {
+      return buildRequestUrl(meta, {}, ctx);
     }
-    return { pathParams, query, body, headers, timeout: perCallTimeout };
+    const { pathParams, query } = resolveApiParams(params);
+    return appendQuery(buildRequestUrl(meta, pathParams, ctx), query);
   }
 
   // src/auto-discovery.ts
@@ -750,9 +884,7 @@ var RouteForge = (function (exports) {
   async function fetchSummary(inputs, baseURL, fetchMeta) {
     const { explicitLevels, explicitEndpoint, warnings } = inputs;
     const endpoint = explicitEndpoint ?? DEFAULT_ENDPOINT;
-    const base = baseURL.endsWith("/") ? baseURL.slice(0, -1) : baseURL;
-    const ep = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
-    const url = `${base}${ep}`;
+    const url = joinBaseAndPath(baseURL, endpoint);
     try {
       const data = await fetchMeta("__forge__.summary", url);
       return data;
@@ -858,6 +990,7 @@ var RouteForge = (function (exports) {
       this.fetchMeta = deps.fetchMeta;
       this.autoDiscoveryPromise = deps.autoDiscoveryPromise;
       this.getAutoDiscoveryError = deps.getAutoDiscoveryError;
+      this.onChange = deps.onChange;
     }
     assertLevelDeclared(level) {
       if (!this.state.levels.includes(level)) {
@@ -866,15 +999,9 @@ var RouteForge = (function (exports) {
     }
     async fetchLevel(level) {
       const uri = this.state.levelRoutes[level]?.uri;
-      const url = uri ? this.joinBaseAndPath(this.baseURL, uri) : buildUrl(level, { baseURL: this.baseURL, endpoint: this.state.endpoint });
+      const url = uri ? joinBaseAndPath(this.baseURL, uri) : buildUrl(level, { baseURL: this.baseURL, endpoint: this.state.endpoint });
       return await this.fetchMeta(`route-forge.${level}`, url, level);
     }
-    /** baseURL 与后端下发的绝对 path 拼接（规范化斜杠），与 buildUrl 的 base 处理一致 */
-    joinBaseAndPath(baseURL, path) {
-      const base = baseURL.endsWith("/") ? baseURL.slice(0, -1) : baseURL;
-      const p = path.startsWith("/") ? path : `/${path}`;
-      return `${base}${p}`;
-    }
     async loadOne(level) {
       const autoDiscoveryError = this.getAutoDiscoveryError();
       if (autoDiscoveryError) throw autoDiscoveryError;
@@ -889,6 +1016,7 @@ var RouteForge = (function (exports) {
           const resp = await this.fetchLevel(level);
           if ((this.invalidationGens.get(level) ?? 0) === gen) {
             this.cache.set(resp, this.state.cacheTtl);
+            this.onChange?.(level);
           }
         } finally {
           this.inflight.delete(level);
@@ -902,6 +1030,36 @@ var RouteForge = (function (exports) {
       const list = Array.isArray(level) ? level : [level];
       await Promise.all(list.map((l) => this.loadOne(l)));
     }
+    /**
+     * 强制刷新：跳过缓存命中短路重新拉取指定层级，成功后覆盖缓存、失败保留旧值。
+     * 与 invalidate→load 的区别——全程不清空缓存，故读取旧数据不受影响、无空窗。
+     */
+    async revalidate(level) {
+      await this.autoDiscoveryPromise;
+      const list = Array.isArray(level) ? level : [level];
+      await Promise.all(list.map((l) => this.revalidateOne(l)));
+    }
+    async revalidateOne(level) {
+      const autoDiscoveryError = this.getAutoDiscoveryError();
+      if (autoDiscoveryError) throw autoDiscoveryError;
+      this.assertLevelDeclared(level);
+      const existing = this.inflight.get(level);
+      if (existing) return existing;
+      const gen = this.invalidationGens.get(level) ?? 0;
+      const p = (async () => {
+        try {
+          const resp = await this.fetchLevel(level);
+          if ((this.invalidationGens.get(level) ?? 0) === gen) {
+            this.cache.set(resp, this.state.cacheTtl);
+            this.onChange?.(level);
+          }
+        } finally {
+          this.inflight.delete(level);
+        }
+      })();
+      this.inflight.set(level, p);
+      return p;
+    }
     invalidate(level) {
       if (level === void 0) {
         this.cache.clear();
@@ -909,16 +1067,19 @@ var RouteForge = (function (exports) {
         for (const lvl of this.state.levels) {
           this.invalidationGens.set(lvl, (this.invalidationGens.get(lvl) ?? 0) + 1);
         }
+        for (const lvl of this.state.levels) this.onChange?.(lvl);
       } else if (Array.isArray(level)) {
         for (const lvl of level) {
           this.cache.del(lvl);
           this.inflight.delete(lvl);
           this.invalidationGens.set(lvl, (this.invalidationGens.get(lvl) ?? 0) + 1);
         }
+        for (const lvl of level) this.onChange?.(lvl);
       } else {
         this.cache.del(level);
         this.inflight.delete(level);
         this.invalidationGens.set(level, (this.invalidationGens.get(level) ?? 0) + 1);
+        this.onChange?.(level);
       }
     }
     isLoaded(level) {
@@ -933,6 +1094,16 @@ var RouteForge = (function (exports) {
       }
       return void 0;
     }
+    /**
+     * 该层级当前已加载的路由名列表（不深拷贝，仅读键名）。
+     * 供错误候选与 prefix 解析使用——避免为取名字而 getRoutes 深拷贝整表。
+     * 层级未声明抛 UnknownLevelError（与 getRoutes/route 一致）。
+     */
+    routeNames(level) {
+      this.assertLevelDeclared(level);
+      const entry = this.cache.get(level);
+      return entry ? Object.keys(entry.routes) : [];
+    }
     getRoutes(level) {
       if (level !== void 0) {
         this.assertLevelDeclared(level);
@@ -940,7 +1111,7 @@ var RouteForge = (function (exports) {
         const routes = entry?.routes ?? {};
         const result2 = {};
         for (const [k, v] of Object.entries(routes)) {
-          result2[k] = JSON.parse(JSON.stringify(v));
+          result2[k] = structuredClone(v);
         }
         return result2;
       }
@@ -950,7 +1121,7 @@ var RouteForge = (function (exports) {
         if (entry) {
           const levelRoutes = {};
           for (const [k, v] of Object.entries(entry.routes)) {
-            levelRoutes[k] = JSON.parse(JSON.stringify(v));
+            levelRoutes[k] = structuredClone(v);
           }
           result[lvl] = levelRoutes;
         }
@@ -1051,18 +1222,37 @@ var RouteForge = (function (exports) {
       let ctrl;
       let abortedBeforeInit = false;
       let abortReason;
-      const work = (async () => {
-        ctrl = new AbortController();
-        if (abortedBeforeInit) {
-          ctrl.abort(abortReason);
+      const externalSignal = params.signal;
+      const onExternalAbort = () => {
+        if (ctrl) {
+          ctrl.abort(externalSignal?.reason);
+        } else {
+          abortedBeforeInit = true;
+          abortReason = externalSignal?.reason;
         }
-        await autoDiscoveryPromise;
-        await load(level);
-        const meta = findRouteMeta(level, name);
-        if (!meta) {
-          throw new UnknownRouteError(name, level, getRouteNames(level));
+      };
+      if (externalSignal?.aborted) {
+        abortedBeforeInit = true;
+        abortReason = externalSignal.reason;
+      } else {
+        externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+      }
+      const work = (async () => {
+        try {
+          ctrl = new AbortController();
+          if (abortedBeforeInit) {
+            ctrl.abort(abortReason);
+          }
+          await autoDiscoveryPromise;
+          await load(level);
+          const meta = findRouteMeta(level, name);
+          if (!meta) {
+            throw new UnknownRouteError(name, level, getRouteNames(level));
+          }
+          return await doApiCall(meta, params, ctrl.signal);
+        } finally {
+          externalSignal?.removeEventListener("abort", onExternalAbort);
         }
-        return doApiCall(meta, params, ctrl.signal);
       })();
       const request = work;
       request.abort = () => {
@@ -1120,8 +1310,8 @@ var RouteForge = (function (exports) {
 
   // src/bound-forge.ts
   function createBoundForgeFactory(deps) {
-    const { load, api, route, hasRoute, getRoutes, invalidate, isLoaded, loadingTracker } = deps;
-    const resolver = { load, hasRoute, getRouteNames: (lvl) => Object.keys(getRoutes(lvl)) };
+    const { load, api, route, hasRoute, getRoutes, getRouteNames, invalidate, isLoaded, loadingTracker } = deps;
+    const resolver = { load, hasRoute, getRouteNames };
     function createBoundForge(level, prefix) {
       const levelLoadedPromise = load(level);
       levelLoadedPromise.catch(() => {
@@ -1196,6 +1386,7 @@ var RouteForge = (function (exports) {
     } = options;
     const warnings = options.warnings ?? true;
     const loadingTracker = new LoadingTracker();
+    const routesTracker = new RouteChangeTracker();
     const explicitLevels = options.levels;
     const explicitEager = options.eager;
     const explicitEndpoint = options.endpoint;
@@ -1209,22 +1400,7 @@ var RouteForge = (function (exports) {
     };
     const discoveryInputs = { explicitLevels, explicitEager, explicitEndpoint, warnings };
     let autoDiscoveryCompleted = false;
-    let resolveReady;
-    let rejectReady;
-    const readyPromise = new Promise((resolve, reject) => {
-      resolveReady = resolve;
-      rejectReady = reject;
-    });
-    readyPromise.catch(() => {
-    });
-    let readySettledOk = false;
-    readyPromise.then(
-      () => {
-        readySettledOk = true;
-      },
-      () => {
-      }
-    );
+    const latch = createReadyLatch();
     const cacheTtl = cacheOpts.ttl ?? DEFAULT_CACHE_TTL;
     const cacheStorage = cacheOpts.storage ?? "memory";
     const cache = new RouteCache({ storage: cacheStorage, ttl: cacheTtl });
@@ -1242,30 +1418,12 @@ var RouteForge = (function (exports) {
     if (resDecl.onFulfilled || resDecl.onRejected) {
       responseInterceptors.use(resDecl.onFulfilled, resDecl.onRejected);
     }
-    const adapterPromise = resolveAdapter({
+    const ensureAdapter = createAdapterBootstrap({
       adapter,
-      forgeInterceptors: { request: requestInterceptors, response: responseInterceptors }
+      requestInterceptors,
+      responseInterceptors,
+      warnings
     });
-    let adapterResolved = false;
-    let adapterObj = null;
-    async function ensureAdapter() {
-      if (!adapterResolved) {
-        adapterObj = await adapterPromise.catch((e) => {
-          if (e instanceof AdapterNotFoundError) throw e;
-          if (warnings) {
-            console.warn(
-              `[route-forge] adapter initialization failed (${e?.message ?? String(e)}); falling back to builtin`
-            );
-          }
-          return resolveAdapter({
-            adapter: "builtin",
-            forgeInterceptors: { request: requestInterceptors, response: responseInterceptors }
-          });
-        });
-        adapterResolved = true;
-      }
-      return adapterObj;
-    }
     function assertDiscoveryReady() {
       if (!autoDiscoveryCompleted && !explicitLevels?.length) {
         throw new DiscoveryNotReadyError();
@@ -1322,15 +1480,15 @@ var RouteForge = (function (exports) {
       baseURL,
       fetchMeta,
       autoDiscoveryPromise,
-      getAutoDiscoveryError: () => autoDiscoveryError
+      getAutoDiscoveryError: () => autoDiscoveryError,
+      onChange: (level) => routesTracker.notify(level)
     });
     const load = (level) => store.load(level);
+    const revalidate = (level) => store.revalidate(level);
     const findRouteMeta = (level, name) => store.findRouteMeta(level, name);
     const invalidate = (level) => store.invalidate(level);
     const isLoaded = (level) => store.isLoaded(level);
-    function getRoutes(level) {
-      return level === void 0 ? store.getRoutes() : store.getRoutes(level);
-    }
+    const getRoutes = store.getRoutes.bind(store);
     function getLevels() {
       return [...discoveryState.levels];
     }
@@ -1338,9 +1496,9 @@ var RouteForge = (function (exports) {
       assertDiscoveryReady();
       const meta = findRouteMeta(level, name);
       if (!meta) {
-        throw new UnknownRouteError(name, level, Object.keys(store.getRoutes(level)));
+        throw new UnknownRouteError(name, level, store.routeNames(level));
       }
-      return buildRequestUrl(meta, params ?? {}, { baseURL, urlPrefix: discoveryState.urlPrefix });
+      return buildRouteUrl(meta, params ?? {}, { baseURL, urlPrefix: discoveryState.urlPrefix });
     }
     const api = createHttpRunner({
       ensureAdapter,
@@ -1348,7 +1506,7 @@ var RouteForge = (function (exports) {
       responseInterceptors,
       load,
       findRouteMeta,
-      getRouteNames: (lvl) => Object.keys(store.getRoutes(lvl)),
+      getRouteNames: (lvl) => store.routeNames(lvl),
       baseURL,
       state: discoveryState,
       timeout,
@@ -1374,23 +1532,17 @@ var RouteForge = (function (exports) {
         });
       }
     }).then(() => {
-      resolveReady(forgeInstance);
+      latch.resolve(forgeInstance);
     }).catch((e) => {
-      rejectReady(e);
+      latch.reject(e);
     });
-    function ready(onFulfilled, onRejected) {
-      if (onFulfilled) {
-        const p = readyPromise.then(onFulfilled, onRejected);
-        return p.then(() => forgeInstance);
-      }
-      return readyPromise;
-    }
     const createBoundForgeWithMethods = createBoundForgeFactory({
       load,
       api,
       route,
       hasRoute,
       getRoutes,
+      getRouteNames: (lvl) => store.routeNames(lvl),
       invalidate,
       isLoaded,
       loadingTracker
@@ -1398,6 +1550,7 @@ var RouteForge = (function (exports) {
     const forgeInstance = {
       api,
       load,
+      revalidate,
       route,
       url: route,
       invalidate,
@@ -1407,13 +1560,14 @@ var RouteForge = (function (exports) {
       getLevels,
       warnings,
       isLoading: () => loadingTracker.isLoading(),
-      isReady: () => readySettledOk,
+      isReady: () => latch.isReady(),
       onLoadingChange: (cb) => loadingTracker.subscribe(cb),
+      onRoutesChange: (cb) => routesTracker.subscribe(cb),
       interceptors: {
         request: requestInterceptors,
         response: responseInterceptors
       },
-      ready,
+      ready: latch.ready,
       use(level, prefix) {
         if (level === void 0) return forgeInstance;
         return createBoundForgeWithMethods(level, prefix);
@@ -1434,6 +1588,7 @@ var RouteForge = (function (exports) {
   exports.NetworkError = NetworkError;
   exports.RequestAbortedError = RequestAbortedError;
   exports.RouteCache = RouteCache;
+  exports.RouteChangeTracker = RouteChangeTracker;
   exports.UnknownLevelError = UnknownLevelError;
   exports.UnknownRouteError = UnknownRouteError;
   exports.createInterceptorManager = createInterceptorManager;