repluggable-core 0.0.0-pr349.66 → 0.0.0-pr351.71

package/dist/testKit/index.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockObservable = exports.addMockShell = exports.createAppHostAndWaitForLoading = exports.createAppHostWithPacts = exports.getPackagesDependencies = exports.createAppHost = exports.createSignalItemsDataStructure = exports.withThrowOnError = exports.withConsoleErrors = exports.emptyLoggerOptions = exports.createShellLogger = void 0;
+exports.mockObservable = exports.addMockShell = exports.createAppHostAndWaitForLoading = exports.AppHostLoadingTimeoutError = exports.createAppHostWithPacts = exports.getPackagesDependencies = exports.createAppHost = exports.createSignalItemsDataStructure = exports.withThrowOnError = exports.withConsoleErrors = exports.emptyLoggerOptions = exports.createShellLogger = void 0;
 const lodash_1 = __importDefault(require("lodash"));
 const index_1 = require("../src/index");
 const loggers_1 = require("../src/loggers");
@@ -88,28 +88,64 @@ function createAppHostWithPacts(packages, pacts) {
     return (0, exports.createAppHost)([...packages, pactsEntryPoint], Object.assign(Object.assign({}, emptyLoggerOptions_1.emptyLoggerOptions), { disableLayersValidation: true }));
 }
 exports.createAppHostWithPacts = createAppHostWithPacts;
-function createAppHostAndWaitForLoading(packages, pacts) {
-    return __awaiter(this, void 0, void 0, function* () {
+class AppHostLoadingTimeoutError extends Error {
+    constructor(message, report) {
+        super(message);
+        this.report = report;
+        this.name = 'AppHostLoadingTimeoutError';
+    }
+}
+exports.AppHostLoadingTimeoutError = AppHostLoadingTimeoutError;
+const WAIT_FOR_LOADING_PROBE_SHELL = 'Depends on all declared APIs';
+const formatUnreadyReport = (timeout, report) => {
+    const { utils } = globalThis.repluggableAppDebug;
+    const isProbeShell = (name) => name === WAIT_FOR_LOADING_PROBE_SHELL;
+    const header = `createAppHostAndWaitForLoading - host not ready within ${timeout}ms.`;
+    const unreadyEntryPoints = report.unreadyEntryPoints.filter(entryPoint => !isProbeShell(entryPoint.name));
+    const rootUnreadyEntryPoints = report.rootUnreadyEntryPoints.filter(entryPoint => !isProbeShell(entryPoint.name));
+    if (report.probableDependencyCycle) {
+        const names = unreadyEntryPoints.map(entryPoint => `"${entryPoint.name}"`).join(', ');
+        return `${header}
+No root unready API found while ${unreadyEntryPoints.length} entry points are unready - probable dependency cycle between: ${names}`;
+    }
+    const roots = report.rootUnreadyAPIs.map((info, index) => {
+        const declaredBy = info.declaredBy === 'nobody'
+            ? 'declared by NO entry point (missing package or pact?)'
+            : `declared by "${info.declaredBy.entryPointName}" (installed, but its contribution never completed - hung async contributeAPI?)`;
+        const requiredBy = info.requiredBy.filter(name => !isProbeShell(name));
+        const lines = [`${index + 1}. "${info.key.name}" - ${declaredBy}`];
+        if (requiredBy.length) {
+            lines.push(`   required by: ${requiredBy.join(', ')}`);
+            const tree = utils.visualizeDependencyTree(utils.traceAPIDependency(requiredBy[0], info.key.name));
+            lines.push(...tree.split('\n').map(line => `   ${line}`));
+        }
+        return lines.join('\n');
+    });
+    return `${header}
+
+Root unready APIs (${report.rootUnreadyAPIs.length}):
+${roots.join('\n')}
+
+Unready entry points: ${rootUnreadyEntryPoints.length} blocked directly on root APIs, ${unreadyEntryPoints.length} total.`;
+};
+function createAppHostAndWaitForLoading(packages_1, pacts_1) {
+    return __awaiter(this, arguments, void 0, function* (packages, pacts, { timeout = 3000 } = {}) {
         const appHost = createAppHostWithPacts(packages, pacts);
         const declaredAPIs = (0, lodash_1.default)(packages)
             .flatten()
             .value()
             .flatMap((entryPoint) => (entryPoint.declareAPIs ? entryPoint.declareAPIs() : []));
+        let timer;
         const timeoutPromise = new Promise((resolve, reject) => {
-            setTimeout(() => {
-                const readyAPIs = Array.from(globalThis.repluggableAppDebug.readyAPIs);
-                const unreadyAPIs = declaredAPIs.filter(api => !readyAPIs.some(readyAPI => readyAPI.name === api.name));
-                const rootUnreadyAPI = globalThis.repluggableAppDebug.utils.getRootUnreadyAPI();
-                reject(new Error(`createAppHostAndWaitForLoading - waiting for loading timed out.
-there's a high chance this missing API is the main reason for it: ${JSON.stringify(rootUnreadyAPI)}
-
-in addition here's the full list of declared APIs that have not been contributed: ${JSON.stringify(unreadyAPIs)}`));
-            }, 3000);
+            timer = setTimeout(() => {
+                const report = globalThis.repluggableAppDebug.utils.getUnreadyEntryPointsReport();
+                reject(new AppHostLoadingTimeoutError(formatUnreadyReport(timeout, report), report));
+            }, timeout);
         });
         const loadingPromise = new Promise((resolve) => __awaiter(this, void 0, void 0, function* () {
             yield appHost.addShells([
                 {
-                    name: 'Depends on all declared APIs',
+                    name: WAIT_FOR_LOADING_PROBE_SHELL,
                     getDependencyAPIs() {
                         return declaredAPIs;
                     },
@@ -119,7 +155,15 @@ in addition here's the full list of declared APIs that have not been contributed
                 }
             ]);
         }));
-        return Promise.race([timeoutPromise, loadingPromise]).then(() => appHost);
+        try {
+            yield Promise.race([timeoutPromise, loadingPromise]);
+            return appHost;
+        }
+        finally {
+            if (timer) {
+                clearTimeout(timer);
+            }
+        }
     });
 }
 exports.createAppHostAndWaitForLoading = createAppHostAndWaitForLoading;

package/dist/testKit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../testKit/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAsB;AAEtB,wCAAwH;AACxH,4CAAkD;AAGzC,kGAHA,2BAAiB,OAGA;AAF1B,6DAAyD;AAGhD,mGAHA,uCAAkB,OAGA;AAG3B,yDAAuD;AAA9C,sHAAA,iBAAiB,OAAA;AAC1B,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AACzB,gDAA6B;AAC7B,yFAAuF;AAA9E,gJAAA,8BAA8B,OAAA;AAEhC,MAAM,aAAa,GAA0B,CAAC,QAAQ,EAAE,OAAO,GAAG,uCAAkB,EAAE,EAAE;IAC3F,OAAO,IAAA,qBAAc,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC,CAAA;AAFY,QAAA,aAAa,iBAEzB;AAUD,SAAS,kBAAkB,CAAC,WAAkC,EAAE,SAAmE;IAC/H,gBAAC,CAAC,OAAO,CAAC,gBAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,UAAsB,EAAE,EAAE;QACzD,gBAAC,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE;YAC3E,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;AACN,CAAC;AAEM,MAAM,uBAAuB,GAAG,CACnC,WAAkC,EAClC,gBAAuC,EAClB,EAAE;IACvB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkC,CAAA;IACjE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAA;IAE3C,kBAAkB,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE;QACvD,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,MAAM,YAAY,GAA0B,EAAE,CAAA;IAC9C,MAAM,gBAAgB,GAAiB,gBAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAElE,OAAO,gBAAgB,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAA;QAC/C,IAAI,CAAC,cAAc,IAAI,iBAAiB,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,SAAQ;QACZ,CAAC;QACD,iBAAiB,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAC1C,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QACjC,MAAM,YAAY,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/F,MAAM,qBAAqB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAe,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;QAClG,gBAAgB,CAAC,IAAI,CAAC,GAAG,gBAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,OAAO,gBAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;AAC/B,CAAC,CAAA;AA3BY,QAAA,uBAAuB,2BA2BnC;AAED,SAAgB,sBAAsB,CAAC,QAA+B,EAAE,KAAoB;IACxF,MAAM,eAAe,GAAe;QAChC,IAAI,EAAE,mBAAmB;QACzB,WAAW;YACP,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QAC9C,CAAC;QACD,MAAM,CAAC,KAAY;YACf,gBAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE;gBACjB,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;YACrD,CAAC,CAAC,CAAA;QACN,CAAC;KACJ,CAAA;IAED,OAAO,IAAA,qBAAa,EAAC,CAAC,GAAG,QAAQ,EAAE,eAAe,CAAC,kCAC5C,uCAAkB,KACrB,uBAAuB,EAAE,IAAI,IAC/B,CAAA;AACN,CAAC;AAjBD,wDAiBC;AAED,SAAsB,8BAA8B,CAAC,QAA+B,EAAE,KAAoB;;QACtG,MAAM,OAAO,GAAG,sBAAsB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QACvD,MAAM,YAAY,GAAG,IAAA,gBAAC,EAAC,QAAQ,CAAC;aAC3B,OAAO,EAAE;aACT,KAAK,EAAE;aACP,OAAO,CAAC,CAAC,UAAsB,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAElG,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,UAAU,CAAC,GAAG,EAAE;gBACZ,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAA;gBACtE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;gBACvG,MAAM,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAA;gBAE/E,MAAM,CACF,IAAI,KAAK,CACL;oEACgD,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;oFAEd,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAChG,CACJ,CAAA;YACL,CAAC,EAAE,IAAI,CAAC,CAAA;QACZ,CAAC,CAAC,CAAA;QAEF,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAM,OAAO,EAAC,EAAE;YACrD,MAAM,OAAO,CAAC,SAAS,CAAC;gBACpB;oBACI,IAAI,EAAE,8BAA8B;oBACpC,iBAAiB;wBACb,OAAO,YAAY,CAAA;oBACvB,CAAC;oBACD,MAAM;wBACF,OAAO,EAAE,CAAA;oBACb,CAAC;iBACJ;aACJ,CAAC,CAAA;QACN,CAAC,CAAA,CAAC,CAAA;QAEF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;IAC7E,CAAC;CAAA;AAvCD,wEAuCC;AAOD,+DAA+D;AACxD,MAAM,YAAY,GAAG,CAAC,IAAa,EAAE,sBAA2C,EAAE,EAAS,EAAE;IAChG,IAAI,KAAK,GAAG,IAAI,CAAA;IAChB,IAAI,CAAC,SAAS,CAAC;sCAEP,IAAI,EAAE,gBAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,IAC9B,mBAAmB,KACtB,MAAM,CAAC,MAAa;gBAChB,KAAK,GAAG,MAAM,CAAA;gBACd,IAAI,mBAAmB,CAAC,MAAM,EAAE,CAAC;oBAC7B,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBACtC,CAAC;YACL,CAAC;KAER,CAAC,CAAA;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,YAAY,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACzG,MAAM,SAAS,GAAG,CAAC,GAAe,EAAE,EAAE;YAClC,IAAI,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAChB,OAAO,IAAI,CAAA;YACf,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,KAAK,CAAA;YAChB,CAAC;QACL,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAe,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;QACzE,MAAM,IAAI,KAAK,CACX,qGAAqG,OAAO,CAAC,GAAG,CAC5G,CAAC,CAAa,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CACnC,EAAE,CACN,CAAA;IACL,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC,CAAA;AAhCY,QAAA,YAAY,gBAgCxB;AAED,SAAgB,cAAc,CAAI,KAAQ;IACtC,OAAO;QACH,SAAS,EAAE,GAAG,EAAE;YACZ,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;QACnB,CAAC;QACD,OAAO;YACH,OAAO,KAAK,CAAA;QAChB,CAAC;KACJ,CAAA;AACL,CAAC;AATD,wCASC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../testKit/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repluggable-core",
-  "version": "0.0.0-pr349.66",
+  "version": "0.0.0-pr351.71",
   "license": "MIT",
   "description": "Allows composition of a React-with-Redux application entirely from a list of pluggable packages",
   "main": "dist/src/index.js",
@@ -51,5 +51,5 @@
     "registry": "https://registry.npmjs.org/",
     "versionBumpStrategy": "patch"
   },
-  "stableVersion": "1.302.85"
+  "stableVersion": "1.302.86"
 }

package/src/repluggableAppDebug/debug.d.ts

@@ -23,10 +23,25 @@ export interface DependencyTree {
     deps: { api: string; subtree: DependencyTree | null }[]
 }
 
+export interface RootUnreadyAPIInfo {
+    key: AnySlotKey
+    declaredBy: 'nobody' | { entryPointName: string }
+    requiredBy: string[]
+}
+
+export interface UnreadyEntryPointsReport {
+    unreadyEntryPoints: EntryPoint[]
+    rootUnreadyAPIs: RootUnreadyAPIInfo[]
+    rootUnreadyEntryPoints: EntryPoint[]
+    probableDependencyCycle: boolean
+}
+
 export interface RepluggableDebugUtils {
     apis(): APIDebugInfo[]
     unReadyEntryPoints(): EntryPoint[]
-    getRootUnreadyAPI(): SlotKey<any>
+    getUnreadyEntryPointsReport(): UnreadyEntryPointsReport
+    /** @deprecated use getUnreadyEntryPointsReport() - this returns only the first of possibly many root unready APIs */
+    getRootUnreadyAPI(): SlotKey<any> | undefined
     whyEntryPointUnready(name: string): void
     findAPI(name: string): APIDebugInfo[]
     getAPIOrEntryPointsDependencies(

package/src/repluggableAppDebug/index.ts

@@ -1 +1 @@
-export { setupDebugInfo } from './repluggableAppDebug'
+export { setupDebugInfo, RootUnreadyAPIInfo, UnreadyEntryPointsReport } from './repluggableAppDebug'

package/src/repluggableAppDebug/repluggableAppDebug.ts

@@ -36,54 +36,74 @@ function mapApiToEntryPoint(allPackages: EntryPoint[]) {
     return apiToEntryPoint
 }
 
-/**
- * a function that returns all the entry points in the system with their declared APIs and dependencies
- */
-const getAllEntryPoints = () => {
-    return [
-        ...globalThis.repluggableAppDebug.utils.unReadyEntryPoints(),
-        ...[...globalThis.repluggableAppDebug.addedShells].map(([_, shell]) => shell.entryPoint)
-    ]
+export interface RootUnreadyAPIInfo {
+    key: AnySlotKey
+    /**
+     * 'nobody'  -> not declared by any entry point in the host (missing package / pact)
+     * otherwise -> declared by an INSTALLED shell whose contributeAPI never completed (hung async contribution)
+     */
+    declaredBy: 'nobody' | { entryPointName: string }
+    /** names of unready entry points directly blocked on this API */
+    requiredBy: string[]
+}
+
+export interface UnreadyEntryPointsReport {
+    unreadyEntryPoints: EntryPoint[]
+    rootUnreadyAPIs: RootUnreadyAPIInfo[]
+    /** unready entry points directly blocked on a root unready API */
+    rootUnreadyEntryPoints: EntryPoint[]
+    /** true when entry points are unready but no root unready API exists - their dependencies form a cycle */
+    probableDependencyCycle: boolean
 }
 
+type UnreadyReportParams = Pick<SetupDebugInfoParams, 'readyAPIs' | 'getOwnSlotKey' | 'getUnreadyEntryPoints' | 'addedShells'>
+
 /**
- * this function is used to get the root unready API in case there are too many to understand.
- * for example if you have 200 unready entry points, running this function will give you the first unready API that
- * will unblock the rest of the entry point (note that there might be more than one)
- *
- * this function basically takes the first unready entry point, get its dependencies and iterates over them to find an API that is not ready
- * at this point it follows the same process recursively until it reaced the target API.
+ * Computes all root unready APIs at once: dependencies of unready entry points that are neither ready
+ * nor declared by another unready entry point (i.e. the APIs actually blocking the host from loading).
  */
-const getRootUnreadyAPI = (host: AppHost) => {
-    return () => {
-        // get all unready entry points
-        const allEntryPoints = getAllEntryPoints()
-        const unReadyAPIsArray = []
-        // get the depdenencies of the first unready entry point
-        let dependenciesOfUnreadyEntryPoint = allEntryPoints?.[0]?.getDependencyAPIs?.()
-
-        while (dependenciesOfUnreadyEntryPoint?.length) {
-            const currentAPI = dependenciesOfUnreadyEntryPoint.pop()
-
-            if (!currentAPI) {
-                continue
-            }
-            // try to get the API from this host, we are looking for an API that is not ready
-            try {
-                const api = host.getAPI(currentAPI as SlotKey<any>)
-                if (api) {
-                    continue
+const createGetUnreadyEntryPointsReport = ({ readyAPIs, getOwnSlotKey, getUnreadyEntryPoints, addedShells }: UnreadyReportParams) => {
+    return (): UnreadyEntryPointsReport => {
+        const unreadyEntryPoints = getUnreadyEntryPoints()
+        const isReady = (key: AnySlotKey) => readyAPIs.has(getOwnSlotKey(key as SlotKey<any>))
+
+        const declaredByUnready = new Set<string>()
+        unreadyEntryPoints.forEach(entryPoint => entryPoint.declareAPIs?.().forEach(key => declaredByUnready.add(key.name)))
+
+        const declaredByInstalled = new Map<string, string>()
+        for (const shell of addedShells.values()) {
+            shell.entryPoint.declareAPIs?.().forEach(key => declaredByInstalled.set(key.name, shell.entryPoint.name))
+        }
+
+        const rootByName = new Map<string, RootUnreadyAPIInfo>()
+        unreadyEntryPoints.forEach(entryPoint => {
+            entryPoint.getDependencyAPIs?.().forEach(key => {
+                if (isReady(key) || declaredByUnready.has(key.name)) {
+                    return
                 }
-            } catch (e) {
-                unReadyAPIsArray.push(currentAPI)
-                // we found an API that is unready, lets find which entry point declares it
-                const declarer = allEntryPoints.find(entryPointData =>
-                    entryPointData.declareAPIs?.().some(api => currentAPI?.name === api.name)
-                )
-                dependenciesOfUnreadyEntryPoint = declarer?.getDependencyAPIs?.()
-            }
+                const declarerName = declaredByInstalled.get(key.name)
+                const info = rootByName.get(key.name) ?? {
+                    key,
+                    declaredBy: declarerName ? { entryPointName: declarerName } : ('nobody' as const),
+                    requiredBy: []
+                }
+                info.requiredBy.push(entryPoint.name)
+                rootByName.set(key.name, info)
+            })
+        })
+
+        const rootUnreadyAPIs = [...rootByName.values()]
+        const rootAPINames = new Set(rootByName.keys())
+        const rootUnreadyEntryPoints = unreadyEntryPoints.filter(entryPoint =>
+            entryPoint.getDependencyAPIs?.().some(key => rootAPINames.has(key.name))
+        )
+
+        return {
+            unreadyEntryPoints,
+            rootUnreadyAPIs,
+            rootUnreadyEntryPoints,
+            probableDependencyCycle: unreadyEntryPoints.length > 0 && rootUnreadyAPIs.length === 0
         }
-        return unReadyAPIsArray.reverse()[0]
     }
 }
 
@@ -207,7 +227,9 @@ export function setupDebugInfo({
                 }
             })
         },
-        getRootUnreadyAPI: getRootUnreadyAPI(host),
+        getUnreadyEntryPointsReport: createGetUnreadyEntryPointsReport({ readyAPIs, getOwnSlotKey, getUnreadyEntryPoints, addedShells }),
+        /** @deprecated use getUnreadyEntryPointsReport() - this returns only the first of possibly many root unready APIs */
+        getRootUnreadyAPI: (): AnySlotKey | undefined => utils.getUnreadyEntryPointsReport().rootUnreadyAPIs[0]?.key,
         unReadyEntryPoints: (): EntryPoint[] => getUnreadyEntryPoints(),
         whyEntryPointUnready: (name: string) => {
             const unreadyEntryPoint = _.find(

package/test/repluggableAppDebug.spec.ts

@@ -245,4 +245,154 @@ describe('RepluggableAppDebug', () => {
             expect(unreadyAPIs).toEqual({ name: 'unreadyAPI' })
         })
     })
+
+    describe('getUnreadyEntryPointsReport', () => {
+        const getReport = async () => {
+            await new Promise(resolve => setTimeout(resolve, 0))
+            return globalThis.repluggableAppDebug.utils.getUnreadyEntryPointsReport()
+        }
+
+        it('should report no unready entry points when all are loaded', async () => {
+            createAppHost([
+                {
+                    name: 'entryPoint',
+                    declareAPIs: () => []
+                }
+            ])
+
+            const report = await getReport()
+
+            expect(report).toEqual({
+                unreadyEntryPoints: [],
+                rootUnreadyAPIs: [],
+                rootUnreadyEntryPoints: [],
+                probableDependencyCycle: false
+            })
+        })
+
+        it('should report all root unready APIs of independent unready clusters', async () => {
+            createAppHost([
+                {
+                    name: 'entryPoint A',
+                    getDependencyAPIs: () => [{ name: 'missing A' }]
+                },
+                {
+                    name: 'entryPoint B',
+                    getDependencyAPIs: () => [{ name: 'missing B' }]
+                }
+            ])
+
+            const report = await getReport()
+
+            expect(report.rootUnreadyAPIs).toEqual([
+                { key: { name: 'missing A' }, declaredBy: 'nobody', requiredBy: ['entryPoint A'] },
+                { key: { name: 'missing B' }, declaredBy: 'nobody', requiredBy: ['entryPoint B'] }
+            ])
+            expect(report.rootUnreadyEntryPoints.map(entryPoint => entryPoint.name)).toEqual(['entryPoint A', 'entryPoint B'])
+            expect(report.probableDependencyCycle).toBe(false)
+        })
+
+        it('should report only the root API of a transitively blocked chain', async () => {
+            createAppHost([
+                {
+                    name: 'entryPoint A',
+                    getDependencyAPIs: () => [{ name: 'API B' }]
+                },
+                {
+                    name: 'entryPoint B',
+                    declareAPIs: () => [{ name: 'API B' }],
+                    getDependencyAPIs: () => [unreadAPI]
+                }
+            ])
+
+            const report = await getReport()
+
+            expect(report.rootUnreadyAPIs).toEqual([{ key: unreadAPI, declaredBy: 'nobody', requiredBy: ['entryPoint B'] }])
+            expect(report.rootUnreadyEntryPoints.map(entryPoint => entryPoint.name)).toEqual(['entryPoint B'])
+            expect(report.unreadyEntryPoints.map(entryPoint => entryPoint.name)).toEqual(['entryPoint A', 'entryPoint B'])
+        })
+
+        it('should report roots of sibling branches, including APIs declared by an installed shell that never contributed them', async () => {
+            createAppHost([
+                {
+                    name: 'entryPoint 0',
+                    getDependencyAPIs: () => [{ name: 'missing API' }, { name: 'API B' }]
+                },
+                {
+                    name: 'entryPoint 1',
+                    declareAPIs: () => [{ name: 'API B' }]
+                }
+            ])
+
+            const report = await getReport()
+
+            expect(report.rootUnreadyAPIs).toEqual([
+                { key: { name: 'missing API' }, declaredBy: 'nobody', requiredBy: ['entryPoint 0'] },
+                { key: { name: 'API B' }, declaredBy: { entryPointName: 'entryPoint 1' }, requiredBy: ['entryPoint 0'] }
+            ])
+        })
+
+        it('should aggregate all entry points blocked on the same root API', async () => {
+            createAppHost([
+                {
+                    name: 'entryPoint A',
+                    getDependencyAPIs: () => [unreadAPI]
+                },
+                {
+                    name: 'entryPoint B',
+                    getDependencyAPIs: () => [unreadAPI]
+                }
+            ])
+
+            const report = await getReport()
+
+            expect(report.rootUnreadyAPIs).toEqual([{ key: unreadAPI, declaredBy: 'nobody', requiredBy: ['entryPoint A', 'entryPoint B'] }])
+        })
+
+        it('should flag a probable dependency cycle when unready entry points have no root unready API', async () => {
+            createAppHost(
+                [
+                    {
+                        name: 'entryPoint A',
+                        declareAPIs: () => [{ name: 'API X' }],
+                        getDependencyAPIs: () => [{ name: 'API Y' }]
+                    },
+                    {
+                        name: 'entryPoint B',
+                        declareAPIs: () => [{ name: 'API Y' }],
+                        getDependencyAPIs: () => [{ name: 'API X' }]
+                    }
+                ],
+                { monitoring: {}, disableCheckCircularDependencies: true }
+            )
+
+            const report = await getReport()
+
+            expect(report.rootUnreadyAPIs).toEqual([])
+            expect(report.unreadyEntryPoints.map(entryPoint => entryPoint.name)).toEqual(['entryPoint A', 'entryPoint B'])
+            expect(report.probableDependencyCycle).toBe(true)
+        })
+
+        it('should not hang getRootUnreadyAPI on a dependency cycle', async () => {
+            createAppHost(
+                [
+                    {
+                        name: 'entryPoint A',
+                        declareAPIs: () => [{ name: 'API X' }],
+                        getDependencyAPIs: () => [{ name: 'API Y' }]
+                    },
+                    {
+                        name: 'entryPoint B',
+                        declareAPIs: () => [{ name: 'API Y' }],
+                        getDependencyAPIs: () => [{ name: 'API X' }]
+                    }
+                ],
+                { monitoring: {}, disableCheckCircularDependencies: true }
+            )
+
+            const unreadyAPIs = await getUnreadyAPIs()
+
+            expect(unreadyAPIs).toBeUndefined()
+        }, 3000)
+    })
 })

package/test/testKit.spec.tsx

@@ -12,7 +12,8 @@ import {
     asyncLoadMockPackage,
     dependsOnMockPackageEntryPoint,
     MockPublicAPI,
-    createAppHostAndWaitForLoading
+    createAppHostAndWaitForLoading,
+    AppHostLoadingTimeoutError
 } from '../testKit'
 
 interface APIKeys {
@@ -147,7 +148,61 @@ describe('App Host TestKit', () => {
         it('should throw if failed to load all packages', async () => {
             const hostPromise = createAppHostAndWaitForLoading([dependsOnMockPackageEntryPoint], [])
             jest.runAllTimers()
-            await expect(hostPromise).rejects.toThrow(new RegExp(MockPublicAPI.name))
+            await expect(hostPromise).rejects.toThrow(new RegExp(MockAPI.name))
+        })
+
+        it('should reject with a structured report of all root unready APIs', async () => {
+            const hostPromise = createAppHostAndWaitForLoading(
+                [
+                    {
+                        name: 'entryPoint A',
+                        declareAPIs: () => [{ name: 'API A' }],
+                        getDependencyAPIs: () => [{ name: 'missing A' }]
+                    },
+                    {
+                        name: 'entryPoint B',
+                        declareAPIs: () => [{ name: 'API B' }],
+                        getDependencyAPIs: () => [{ name: 'missing B' }]
+                    }
+                ],
+                []
+            )
+            jest.runAllTimers()
+            const error: AppHostLoadingTimeoutError = await hostPromise.then(
+                () => {
+                    throw new Error('expected hostPromise to reject')
+                },
+                e => e
+            )
+
+            expect(error).toBeInstanceOf(AppHostLoadingTimeoutError)
+            expect(error.report.rootUnreadyAPIs.map(info => info.key.name)).toEqual(['missing A', 'missing B'])
+            expect(error.message).toContain('"missing A"')
+            expect(error.message).toContain('"missing B"')
+            expect(error.message).toContain('required by: entryPoint A')
+            expect(error.message).toContain('required by: entryPoint B')
+        })
+
+        it('should respect a custom loading timeout', async () => {
+            let settled = false
+            const hostPromise = createAppHostAndWaitForLoading([dependsOnMockPackageEntryPoint], [], { timeout: 10000 })
+            hostPromise.catch(() => (settled = true))
+
+            jest.advanceTimersByTime(9999)
+            await Promise.resolve()
+            await Promise.resolve()
+            expect(settled).toBe(false)
+
+            jest.advanceTimersByTime(1)
+            await expect(hostPromise).rejects.toBeInstanceOf(AppHostLoadingTimeoutError)
+        })
+
+        it('should not leave a pending timeout after successful loading', async () => {
+            const hostPromise = createAppHostAndWaitForLoading([dependsOnMockPackageEntryPoint, asyncLoadMockPackage], [])
+            jest.advanceTimersByTime(500)
+            const host = await hostPromise
+            expect(host.getAPI(MockPublicAPI)).toBeDefined()
+            expect(jest.getTimerCount()).toBe(0)
         })
     })
 })