@webority/analytics 0.2.1 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Webority Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,7 @@
 {
     "name": "@webority/analytics",
-    "version": "0.2.1",
+    "version": "0.3.0",
+    "license": "MIT",
     "type": "module",
     "main": "src/index.js",
     "exports": {
@@ -10,9 +11,9 @@
         "src"
     ],
     "scripts": {
-        "lint": "biome lint ./src",
-        "format": "biome format --write ./src",
-        "check": "biome check ./src",
+        "lint": "biome lint ./src ./test",
+        "format": "biome format --write ./src ./test",
+        "check": "biome check ./src ./test",
         "test": "node test/smoke.mjs"
     },
     "dependencies": {

package/src/analytics.js

@@ -22,19 +22,28 @@ export function initAnalytics(config) {
     });
 
     if (isActive()) {
-        ensurePosthogInitialized();
+        warmUp();
     }
 }
 
+// Starts the loader without waiting for it. The rejection handler is what keeps a failed
+// load inside the package: the bridge clears its cached promise before rethrowing, so the
+// next event retries, and the product never sees an unhandled rejection.
+function warmUp() {
+    ensurePosthogInitialized().catch(() => {
+        // Retried on the next call. Analytics must stay invisible to the product.
+    });
+}
+
 export function setConsent(granted) {
     state.consentOverride = granted;
 
     if (granted && isEligible()) {
-        // A prior revoke leaves an already-initialized instance opted out — re-grant must undo it.
+        // A prior revoke leaves an already-initialized instance opted out, so re-granting must undo it.
         if (state.posthogInstance) {
             state.posthogInstance.opt_in_capturing();
         } else {
-            ensurePosthogInitialized();
+            warmUp();
         }
         return;
     }
@@ -93,7 +102,7 @@ export function resetIdentity() {
 export function registerEvents(names) {
     for (const name of names) {
         if (!EVENT_NAME_PATTERN.test(name)) {
-            throw new Error(`@webority/analytics: invalid event name "${name}" — expected snake_case`);
+            throw new Error(`@webority/analytics: invalid event name "${name}". Expected snake_case.`);
         }
         state.registeredEvents.add(name);
     }
@@ -101,7 +110,7 @@ export function registerEvents(names) {
 
 export function trackEvent(name, props = {}) {
     if (!state.registeredEvents.has(name)) {
-        throw new Error(`@webority/analytics: event "${name}" is not registered — call registerEvents() first`);
+        throw new Error(`@webority/analytics: event "${name}" is not registered. Call registerEvents() first.`);
     }
     capture(name, props);
 }

package/src/state.js

@@ -8,12 +8,14 @@ export const state = {
     registeredEvents: new Set(Object.values(events)),
 };
 
+// registeredEvents is deliberately not reset: an event name is part of the product's
+// vocabulary, not of one analytics session, so a product that registers at module scope and
+// starts analytics later in a bootstrap effect keeps its registrations.
 export function resetState(config) {
     state.config = config;
     state.consentOverride = null;
     state.posthogInstance = null;
     state.posthogInitPromise = null;
-    state.registeredEvents = new Set(Object.values(events));
 }
 
 export function isEligible() {