@jenil_121/ga-bridge 1.0.2 → 1.0.3

package/README.md

@@ -1,72 +1,28 @@
 # Twinalyze GA Bridge
 
-Twinalyze GA Bridge is a lightweight browser bridge that listens to GA4 `gtag('event', ...)` calls and forwards the same event to Twinalyze using the existing Twinalyze web SDK.
+A lightweight bridge to forward Google Analytics (`gtag.js`) events to Twinalyze automatically.
 
-## What it does
+This allows you to use Google Analytics as the source of truth and mirror the same events into Twinalyze without modifying existing tracking code.
 
-- waits for `window.gtag`
-- wraps GA4 `gtag('event', eventName, params)` calls
-- lets GA handle the event first
-- then sends the same event to `window.twinalyze.track(eventName, params)`
-- optionally validates GA-safe event names
-- queues events if Twinalyze SDK is not ready yet
+---
 
-## Files
+## 🚀 Features
 
-- `src/twinalyze-ga-bridge.js` → source file
-- `dist/twinalyze-ga-bridge.min.js` → minified build output
+- Forward GA events (`gtag('event', ...)`) to Twinalyze
+- Uses **GA callback-based forwarding** (Amplitude-like strict mode)
+- Ensures:
+  - If GA event succeeds → Twinalyze receives it
+  - If GA event fails → Twinalyze does NOT receive it
+- No fallback (strict dependency on GA)
+- Automatic installation
+- Debug mode support
+- Adds `__from_bridge: true` flag to all forwarded events
 
-## Installation
+---
 
-Load scripts in this order:
+## 📦 Installation
 
-1. Google Analytics
-2. Twinalyze Web SDK
-3. Twinalyze GA Bridge
+### CDN (Recommended)
 
 ```html
-<!-- 1. Load GA -->
-<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXX"></script>
-<script>
-  window.dataLayer = window.dataLayer || [];
-  function gtag(){ dataLayer.push(arguments); }
-  gtag('js', new Date());
-  gtag('config', 'G-XXXXXXXX');
-</script>
-
-<!-- 2. Load Twinalyze SDK -->
-<script src="https://cdn.jsdelivr.net/npm/@twinalyze/web-analytics@1.0.14/dist/cdn.global.min.js"></script>
-<script>
-  window.twinalyze.init({
-    apiKey: "PUBLIC_WRITE_KEY",
-    organization: "ORG_ID",
-    socketUrl: "https://www.twinalyze.com/"
-  });
-</script>
-
-<!-- 3. Load Twinalyze GA Bridge -->
-<script src="https://cdn.jsdelivr.net/npm/@jenil_121/ga-bridge@1.0.1/dist/twinalyze-ga-bridge.min.js"></script>
-```
-
-## Usage
-
-After setup, use GA normally:
-
-```html
-<script>
-  gtag('event', 'purchase', {
-    value: 999,
-    currency: 'INR'
-  });
-</script>
-```
-
-This event will be sent to:
-- Google Analytics
-- Twinalyze
-
-## Notes
-
-- The bridge depends on both `window.gtag` and `window.twinalyze`
-- Load order is important
-- This package is a bridge plugin, not a replacement for the Twinalyze SDK
+<script src="https://cdn.jsdelivr.net/npm/@jenil_121/ga-bridge@1.0.0/dist/twinalyze-ga-bridge.min.js"></script>

package/dist/twinalyze-ga-bridge.min.js

@@ -1 +1 @@
-!function(e){var t={waitForGaCallback:!0,validateGaEventNames:!0,eventTimeout:2e3,debug:!1,maxWrapRetries:200,wrapRetryInterval:100,skipEvents:["page_view"]},n=/^[A-Za-z][A-Za-z0-9_]{0,39}$/,a={options:t,wrapped:!1,originalGtag:null,wrapRetries:0,queue:[]};function i(){if(a.options.debug)try{console.log.apply(console,["[TwinalyzeGABridge]"].concat([].slice.call(arguments)))}catch(e){}}function r(){try{console.warn.apply(console,["[TwinalyzeGABridge]"].concat([].slice.call(arguments)))}catch(e){}}function o(){return e.twinalyze||e.TwinalyzeAnalytics||null}function l(e){return e&&"object"==typeof e&&!Array.isArray(e)?Object.assign({},e):{}}function c(e,t){a.queue.push({eventName:e,params:t})}function u(){var e=o();if(e&&"function"==typeof e.track)for(;a.queue.length;){var t=a.queue.shift();try{e.track(t.eventName,t.params)}catch(e){r("Failed to flush queued event:",t.eventName,e)}}}function p(e,t){var n=o();if(!n||"function"!=typeof n.track)return c(e,t),void r("Twinalyze SDK not ready, queued event:",e);try{n.track(e,t)}catch(n){r("Twinalyze track failed, queued event:",e,n),c(e,t)}}function s(){if(a.wrapped)return!0;if("function"!=typeof e.gtag)return!1;a.originalGtag=e.gtag;var t=function(){var e=Array.prototype.slice.call(arguments);if("event"!==e[0])return a.originalGtag.apply(this,e);var t,o=e[1],c=l(e[2]);if(t=o,-1!==a.options.skipEvents.indexOf(t))return i("Skipping mirrored event:",o),a.originalGtag.apply(this,e);if(a.options.validateGaEventNames&&!function(e){return"string"==typeof e&&n.test(e)}(o))return r("Invalid GA event name, skipping Twinalyze mirror:",o),a.originalGtag.apply(this,e);var s=c.event_callback,g=c.event_timeout||a.options.eventTimeout;if(a.options.waitForGaCallback){var f=Object.assign({},c,{event_timeout:g,event_callback:function(){try{"function"==typeof s&&s()}catch(e){r("User event_callback failed:",e)}var e=l(c);delete e.event_callback,delete e.event_timeout,p(o,e),u()}});return a.originalGtag.call(this,"event",o,f)}var v=l(c);return delete v.event_callback,delete v.event_timeout,p(o,v),u(),a.originalGtag.apply(this,e)};return t.__twinalyzeWrapped=!0,t.__original=a.originalGtag,e.gtag=t,a.wrapped=!0,u(),i("gtag wrapped successfully"),!0}function g(){s()||(a.wrapRetries+=1,a.wrapRetries>=a.options.maxWrapRetries?r("window.gtag not found. Bridge could not attach."):setTimeout(g,a.options.wrapRetryInterval))}function f(e){a.options=Object.assign({},t,e||{}),g(),u()}e.twinalyzeGABridge={init:f,rebind:s,flushQueue:u,version:"1.0.0"},e.twinalyzeGABridgeConfig&&f(e.twinalyzeGABridgeConfig)}(window);
+!function(e){"use strict";var t={debug:!0,forwardOnlyValidEvents:!0,addBridgeFlag:!0,bridgeFlagKey:"__from_bridge",installWaitMs:1500,eventTimeout:2e3},n="__gaTwinalyzeBridgeInstalled",o=/^[A-Za-z][A-Za-z0-9_]{0,39}$/;function i(){if(!e.__TWINALYZE_GA_BRIDGE_DEBUG__)return;var t=Array.prototype.slice.call(arguments);t.unshift("[Twinalyze GA Bridge]"),console.log.apply(console,t)}function r(){var t=Array.prototype.slice.call(arguments);t.unshift("[Twinalyze GA Bridge]"),console.warn.apply(console,t)}function a(e){return e&&"object"==typeof e&&!Array.isArray(e)}function l(e){return"string"==typeof e&&o.test(e)}function g(){return e.twinalyze||e.TwinalyzeAnalytics||null}function c(){var n=e.TwinalyzeGABridgeConfig||{},o={};for(var i in t)o[i]=t[i];for(var r in n)o[r]=n[r];return o}function d(){var t=c();if(e.__TWINALYZE_GA_BRIDGE_DEBUG__=!!t.debug,e[n])return void i("already installed");if("function"!=typeof e.gtag)return void r("gtag not found");var o=g();if(!o||"function"!=typeof o.track)return void r("twinalyze.track not found");var d=e.gtag;e.gtag=function(){var n=Array.prototype.slice.call(arguments);if(i("gtag call:",n),"event"===n[0]){var o=n[1],u=a(n[2])?Object.assign({},n[2]):{};if(t.forwardOnlyValidEvents&&!l(o))return r("invalid GA event name:",o),d.apply(e,n);var p=u.event_callback;return u.event_timeout="number"==typeof u.event_timeout?u.event_timeout:t.eventTimeout,u.event_callback=function(){i("GA callback fired:",o);try{"function"==typeof p&&p()}catch(e){console.error("[Twinalyze GA Bridge] old callback error",e)}try{var n=Object.assign({},u);if(delete n.event_callback,delete n.event_timeout,t.addBridgeFlag&&(n[t.bridgeFlagKey]=!0),!(s=g())||"function"!=typeof s.track)return void r("twinalyze.track missing during forward:",o);i("forwarding event:",o,n),s.track(o,n)}catch(e){console.error("[Twinalyze GA Bridge] track error",e)}var s},d.call(e,"event",o,u)}return d.apply(e,n)},e[n]=!0,i("installed successfully")}function u(){var e=c();setTimeout(d,e.installWaitMs)}u()}(window);

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@jenil_121/ga-bridge",
-  "version": "1.0.2",
-  "description": "GA4 to Twinalyze browser bridge",
+  "version": "1.0.3",
+  "description": "Twinalyze GA Bridge (GA → Twinalyze event forwarding)",
   "main": "dist/twinalyze-ga-bridge.min.js",
   "files": [
-    "dist",
-    "README.md"
+    "dist"
   ],
-  "scripts": {
-    "build": "terser src/twinalyze-ga-bridge.js -c -m -o dist/twinalyze-ga-bridge.min.js",
-    "prepublishOnly": "npm run build"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
+  "keywords": [
+    "twinalyze",
+    "google-analytics",
+    "gtag",
+    "analytics",
+    "bridge"
+  ],
+  "author": "Your Name",
   "license": "MIT"
 }