obsidian-integration-testing 11.0.0 → 12.1.0

package/dist/lib/esm/transport-factory.d.mts

@@ -19,7 +19,16 @@ export declare function createTransportFromOptions(options?: ObsidianTransportOp
  * The transport is cached per worker process so WebSocket/Appium sessions
  * are reused across calls within the same test worker.
  *
- * @param options - Transport configuration. Defaults to CLI transport.
+ * This is the single entry point every worker-side caller uses for the **ambient**
+ * transport, so it is also where a failed global setup is turned into a failing test.
+ * A failed setup publishes no transport options, and `undefined` options mean the owned
+ * **desktop** CDP default — so without this guard an Android project's suite would run
+ * on desktop and then die on an unrelated CDP error, hiding the real cause (**L9**).
+ * The setup path itself is unaffected: `coreSetup` builds its transport through
+ * {@link createTransportFromOptions} with explicit options.
+ *
+ * @param options - Transport configuration. Defaults to an owned desktop CDP transport.
  * @returns The cached or newly created transport.
+ * @throws {IntegrationSetupFailedError} When this project's global setup failed.
  */
 export declare function getOrCreateTransport(options?: ObsidianTransportOptions): Promise<ObsidianTransport>;