Without this field all the test cases still pass, but for the wrong
reason, since the origin field is checked before other event properties.

We need a way for the client to request configuration from an embedding
frame over `postMessage`.

JSON-RPC is a well-known, simple and convenient format for RPC messages.

There are several npm packages which claim to offer this functionality
but at the time of writing, none appeared to be sufficiently well
tested/supported/documented.

There is an existing partial postMessage JSON-RPC server implementation in
src/sidebar/cross-origin-rpc.js. The non-app specific parts of that will
be moved into this module in future.

Add documentation for externalContainerSelector

Update to Node 10 for Jenkins and Travis builds

The official Docker node builds now have Yarn preinstalled, so use that
instead of a community-provided image.

Use `yarn version --minor` to bump the package version.

This requires Yarn >= v1.7.0.

Inject a default organization into groups objects without organizations

Create annotation when clicking "Annotate" button label

Hide "Public" group for unauthenticated users (alternate implementation)

Implement a business requirement that the "Public" group should be
hidden from the groups list if all these conditions are met:

 - The user is logged-out
 - The current document has groups associated with it
 - The user has not visited a direct-link to an annotation in "Public"

---

This requirement introduces a complexity in that deciding which group to
focus and fetch annotations for after initially fetching groups now
depends on the current profile. However the profile and groups are
fetched concurrently to reduce the number of API round-trips before we
can show annotations in the client.

Fortunately we don't need to know the exact userid to know which group
to focus, only whether the list of groups was fetched as a logged-in
user or not. This can be determined from the access token that was sent
with the `/api/groups` request.

Remove obsolete JSDoc comments

Add an option to return metadata in the response as well as just the
JSON response from the server. This will initially be used to determine
the access token that was used to make the request and therefore whether
it was authenticated or not. In future it could also return information
from HTTP headers or the status code if useful.

Remove unnecessary extra `/api/groups` call on startup

Respond to PR feedback.

This event is never broadcast anywhere. A comment referenced this being
called when a user leaves a group, but this is handled in the `streamer`
service by calling `groups.load()` directly.

On startup an initial `FRAME_CONNECTED` event is fired when the main
frame connects to the sidebar. This triggered an extra `/api/groups`
fetch. Avoid this by recording the main frame URI used in the last
groups fetch in  `load()`. The existing test in the `FRAME_CONNECTED`
handler then skips the `load()` call if this URI has not changed.

The group service does not have `add` or `remove` methods any more.

Fix `groups.focused()` error if localStorage is empty when client loads

Use a pointer cursor for highlights

If the client started and local storage did not contain a saved
last-viewed group ID, then `groups.load()` would attempt to call
`store.focusGroup(null)`. As a result subsequent calls to
`groups.focused()` would return null and code in various places in the
application expects that there will always be a focused group.

Fix the problem by not setting the focus group after groups are fetched
unless the previously-focused group was set and exists in the new
groups list.

Also improve the behavior of `store.focusGroup` by making it leave the
focused group untouched if the specified group has not been loaded, but
log an error so we'll know (via Sentry) if it happens again.

Fixes #750

The `annotator-hl` class contains a `cursor: pointer;` rule already, but
it only applies to mobile devices (more precisely, devices which lack a
sufficiently accurate primary pointer, like a mouse). I simply removed
this restriction so that the rule applies across the board.

Closes: hypothesis/product-backlog#703

Fix a bug where clicking on the text "Annotate", as opposed to the icon,
of the Annotate button would result in a highlight being created.

When clicking on the text, `event.target` was the "Annotate" `<span>`
instead of the `<button>` and so the `isAnnotateCommand` test failed.

Convert share dialog links to use bouncer instead of via.

If the URL is not encoded, a frame URL such as
"http://example.com/foo&bar=baz" will generate the page share link
"https://hyp.is/go?url=http://example.com/foo&bar=baz" where the
"&bar..." part becomes a separate parameter instead of part of the "url" param.

Also remove the check to see if the user is already on a via page.
Via inserts a <link rel="canonical" href="{original URL}"> tag in the
proxied page and therefore frames[0].uri is the original URL and never
https://via.hypothes.is/{original URL}

Fixes https://github.com/hypothesis/product-backlog/issues/335