@loggerjs/browser 0.1.0 → 0.3.0

package/README.md

@@ -51,7 +51,7 @@ const logger = createLogger({
 logger.info("page loaded");
 ```
 
-Logs batch over HTTP, queue while offline, replay with backoff when the network returns, and flush via `sendBeacon` when the tab closes.
+Logs batch over HTTP, queue while offline, replay with backoff when the network returns, and attempt a last-chance best-effort `sendBeacon` flush when the tab closes.
 
 ## Transports
 
@@ -60,7 +60,7 @@ Logs batch over HTTP, queue while offline, replay with backoff when the network
 | `browserHttpTransport` | your collector — batching, offline queue, online replay with backoff, `sendBeacon` on page hide |
 | `indexedDbTransport` | a local, queryable IndexedDB store (TTL, pruning, optional Storage Buckets and durability hints) |
 | `browserWebSocketTransport` | a WebSocket (codec-encoded batches, queues while closed) |
-| `browserServiceWorkerTransport` | a service worker for centralized delivery |
+| `browserServiceWorkerTransport` | a service worker for centralized delivery; `ready()` waits for `serviceWorker.ready` with `target: "ready"` |
 | `browserBroadcastChannelTransport` | other tabs via `BroadcastChannel` |
 | `offlineFirstTransport` | a local store first, then forwards online |
 
@@ -71,6 +71,11 @@ Logs batch over HTTP, queue while offline, replay with backoff when the network
 - `exportLogsToZip()` + `downloadBlob()` — export a persisted store as a zip containing `logs.ndjson` and `manifest.json`.
 - Call the `indexedDbTransport()` instance's `stats()` to read flush, prune, query, drop, and buffer-depth counters.
 
+Browser delivery has runtime loss windows: tab close can cut off async work,
+`sendBeacon` is size- and user-agent-limited, service worker delivery depends on
+activation and lifetime, and IndexedDB persistence depends on quota and browser
+storage policy. Use an IndexedDB offline queue when reload survival matters.
+
 ## Integrations (19)
 
 | Group | Integrations |

package/dist/index.cjs

@@ -470,7 +470,7 @@ function browserServiceWorkerTransport(options = {}) {
 	const mapBatch = options.mapBatch ?? defaultMapBatch;
 	const queue = [];
 	let readyWorker;
-	let readyStarted = false;
+	let readyPromise;
 	let lastContext;
 	const reportError = (error, context, operation, droppedEvents = 0) => {
 		try {
@@ -521,27 +521,35 @@ function browserServiceWorkerTransport(options = {}) {
 			post(worker, item, context);
 		}
 	};
-	const startReady = (context) => {
-		if (target !== "ready" || readyStarted) return;
-		readyStarted = true;
+	const dropQueued = (reason) => {
+		const pending = queue.splice(0);
+		for (const item of pending) reportDrop(item, reason);
+		return pending.reduce((total, item) => total + item.events.length, 0);
+	};
+	const waitForReady = (context) => {
+		if (currentWorker()) return Promise.resolve();
+		if (target !== "ready") return Promise.reject(/* @__PURE__ */ new Error("service worker controller is not available"));
+		if (readyPromise) return readyPromise;
 		const container = options.serviceWorker ?? serviceWorkerContainer();
 		if (!container?.ready) {
-			reportError(/* @__PURE__ */ new Error("serviceWorker.ready is not available"), context, "ready");
-			return;
+			const error = /* @__PURE__ */ new Error("serviceWorker.ready is not available");
+			reportError(error, context, "ready", dropQueued("ready"));
+			return Promise.reject(error);
 		}
-		container.ready.then((registration) => {
+		readyPromise = container.ready.then((registration) => {
 			readyWorker = workerFromRegistration(registration);
-			if (!readyWorker) {
-				const pending = queue.splice(0);
-				for (const item of pending) reportDrop(item, "unavailable");
-				return;
-			}
-			drain(context);
+			if (!readyWorker) throw new Error("service worker registration has no active worker");
+			drain(context ?? lastContext);
 		}).catch((error) => {
-			const pending = queue.splice(0);
-			for (const item of pending) reportDrop(item, "ready");
-			reportError(error, context, "ready", pending.reduce((total, item) => total + item.events.length, 0));
+			readyPromise = void 0;
+			const droppedEvents = dropQueued("ready");
+			reportError(error, context ?? lastContext, "ready", droppedEvents);
+			throw error;
 		});
+		return readyPromise;
+	};
+	const startReady = (context) => {
+		waitForReady(context).catch(() => {});
 	};
 	const enqueue = (item) => {
 		if (queue.length >= maxQueueSize) {
@@ -575,6 +583,9 @@ function browserServiceWorkerTransport(options = {}) {
 		queueSize() {
 			return queue.length;
 		},
+		ready() {
+			return waitForReady();
+		},
 		log(event, context) {
 			send({
 				events: [event],