@route-forge/core 3.0.0 → 3.1.0

package/dist/index.cjs

@@ -131,6 +131,36 @@ var RouteCache = class {
   }
 };
 
+// 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) {
@@ -247,32 +277,7 @@ var DiscoveryNotReadyError = class extends ForgeError {
   }
 };
 
-// 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));
@@ -309,9 +314,8 @@ async function runResponseInterceptors(manager, source) {
   }
   return p;
 }
-function createInterceptorManager() {
-  return new InterceptorManagerImpl();
-}
+
+// src/interceptors/normalize.ts
 function normalizeInterceptorDeclaration(value) {
   if (value === null || value === void 0) return {};
   let rawResolve;
@@ -581,6 +585,69 @@ async function resolveAdapter(opts) {
   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() {
@@ -640,12 +707,107 @@ var LoadingTracker = class {
   }
 };
 
-// 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 = [];
@@ -680,10 +842,10 @@ function buildRequestUrl(meta, params, ctx) {
   });
   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}`;
 }
@@ -702,46 +864,18 @@ function appendQuery(url, query) {
   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
@@ -749,9 +883,7 @@ var DEFAULT_ENDPOINT = "/_forge/routes";
 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;
@@ -857,6 +989,7 @@ var RouteStore = class {
     this.fetchMeta = deps.fetchMeta;
     this.autoDiscoveryPromise = deps.autoDiscoveryPromise;
     this.getAutoDiscoveryError = deps.getAutoDiscoveryError;
+    this.onChange = deps.onChange;
   }
   assertLevelDeclared(level) {
     if (!this.state.levels.includes(level)) {
@@ -865,15 +998,9 @@ var RouteStore = class {
   }
   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;
@@ -888,6 +1015,7 @@ var RouteStore = class {
         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);
@@ -901,6 +1029,36 @@ var RouteStore = class {
     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();
@@ -908,16 +1066,19 @@ var RouteStore = class {
       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) {
@@ -932,6 +1093,16 @@ var RouteStore = class {
     }
     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);
@@ -939,7 +1110,7 @@ var RouteStore = class {
       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;
     }
@@ -949,7 +1120,7 @@ var RouteStore = class {
       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;
       }
@@ -1050,18 +1221,37 @@ function createHttpRunner(deps) {
     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 = () => {
@@ -1119,8 +1309,8 @@ function defineImmutableProps(target, props) {
 
 // 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(() => {
@@ -1195,6 +1385,7 @@ function createRouteForge(options = {}) {
   } = 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;
@@ -1208,22 +1399,7 @@ function createRouteForge(options = {}) {
   };
   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 });
@@ -1241,30 +1417,12 @@ function createRouteForge(options = {}) {
   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();
@@ -1321,15 +1479,15 @@ function createRouteForge(options = {}) {
     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];
   }
@@ -1337,9 +1495,9 @@ function createRouteForge(options = {}) {
     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,
@@ -1347,7 +1505,7 @@ function createRouteForge(options = {}) {
     responseInterceptors,
     load,
     findRouteMeta,
-    getRouteNames: (lvl) => Object.keys(store.getRoutes(lvl)),
+    getRouteNames: (lvl) => store.routeNames(lvl),
     baseURL,
     state: discoveryState,
     timeout,
@@ -1373,23 +1531,17 @@ function createRouteForge(options = {}) {
       });
     }
   }).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
@@ -1397,6 +1549,7 @@ function createRouteForge(options = {}) {
   const forgeInstance = {
     api,
     load,
+    revalidate,
     route,
     url: route,
     invalidate,
@@ -1406,13 +1559,14 @@ function createRouteForge(options = {}) {
     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);
@@ -1433,6 +1587,7 @@ exports.MissingRouteParamError = MissingRouteParamError;
 exports.NetworkError = NetworkError;
 exports.RequestAbortedError = RequestAbortedError;
 exports.RouteCache = RouteCache;
+exports.RouteChangeTracker = RouteChangeTracker;
 exports.UnknownLevelError = UnknownLevelError;
 exports.UnknownRouteError = UnknownRouteError;
 exports.createInterceptorManager = createInterceptorManager;