👋 really cool package! Thanks for continuing the work on google-analytics-lite.

Trying to use this with Gatsby but builds aren't happy with isWeb:

"window" is not available during server side rendering.

See our docs page for more info on this error: https://gatsby.dev/debug-html


  1 | import randomId from 'uid';
> 2 | const isWeb = typeof window.document !== 'undefined';
    | ^
  3 | /**
  4 |  * https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters
  5 |  */


  WebpackError: ReferenceError: window is not defined

Would it be possible to do an undefined check on window first? Not sure what isWeb should be in a SSR environment. Alternatively, that check could just be moved into pageView which should only be called on the client.

https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#dr

Using the value of document.referrer

When shouldSend is used to delay requests (ie: because the network is down), it can result in a huge burst of API calls, which can lead to rate limiting. Instead, when a delayed request is resumed, it should be added to a queue that is drained at a specified rate.

This option is only called after network errors. Invalid requests are never retried.

When shouldRetry can return a promise to delay the retry until the desired time. This makes it a great integration point for libraries, allowing this package to remain lightweight.

Use case

To avoid dropping data!

While the shouldSend option can avoid sending requests while the network is down, it can't retry requests that were sent before the network went down. That's where shouldRetry comes in handy.

Using the /batch endpoint (see here), we can implement request batching for bandwidth/performance reasons.