mytart 0.5.0 → 0.5.2

package/README.md

@@ -402,6 +402,45 @@ export class MyProvider extends BaseProvider {
 }
 ```
 
+## Framework Integration
+
+### Page View Tracking
+
+mytart does **not** send automatic page views — `send_page_view: false` is set in the GA `gtag('config')` call, and other providers have no auto-pageview behaviour. This means your framework is responsible for calling `analytics.page()` on navigation.
+
+### SvelteKit (Svelte 5)
+
+Create a shared analytics instance and use `$effect` in your root layout to reactively track page URL changes:
+
+```typescript
+// src/lib/analytics.ts
+import { Mytart } from 'mytart';
+
+export const analytics = new Mytart({
+  providers: [
+    { provider: 'google-analytics', measurementId: 'G-XXXXXXXXXX', appType: 'browser', enabled: true },
+    { provider: 'meta-pixel', pixelId: '123456789', appType: 'browser', enabled: true },
+  ],
+});
+```
+
+```svelte
+<!-- src/routes/+layout.svelte -->
+<script lang="ts">
+  import { page } from '$app/state';
+  import { analytics } from '$lib/analytics';
+
+  $effect(() => {
+    // Runs on initial load and every client-side navigation
+    analytics.page({ url: page.url.href });
+  });
+</script>
+
+<slot />
+```
+
+> **Why `$effect`?** Svelte 5's `$effect` reactively tracks `page.url.href`. Whenever SvelteKit performs a client-side navigation and the URL changes, the effect re-runs and sends a single page view. This avoids the double-fire problem that can occur with `onMount` + `afterNavigate`, and works correctly on initial load.
+
 ## License
 
 MIT

package/dist/index.js

@@ -146,7 +146,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
       window.gtag("consent", "default", consentParams);
     }
     window.gtag("js", /* @__PURE__ */ new Date());
-    const configParams = {};
+    const configParams = {
+      send_page_view: false
+    };
     if (this.config.signals === true) {
       configParams["allow_google_signals"] = true;
       configParams["allow_ad_personalization_signals"] = true;
@@ -154,11 +156,7 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
       configParams["allow_google_signals"] = false;
       configParams["allow_ad_personalization_signals"] = false;
     }
-    if (Object.keys(configParams).length > 0) {
-      window.gtag("config", this.config.measurementId, configParams);
-    } else {
-      window.gtag("config", this.config.measurementId);
-    }
+    window.gtag("config", this.config.measurementId, configParams);
     return new Promise((resolve) => {
       const script = document.createElement("script");
       script.async = true;
@@ -762,12 +760,14 @@ var PostHogProvider = class extends BaseProvider {
 };
 
 // src/utils/hash.ts
-var import_crypto = require("crypto");
-function sha256(value) {
+async function sha256(value) {
   if (/^[a-f0-9]{64}$/.test(value)) {
     return value;
   }
-  return (0, import_crypto.createHash)("sha256").update(value).digest("hex");
+  const data = new TextEncoder().encode(value);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
 }
 var PII_FIELDS = /* @__PURE__ */ new Set([
   "em",
@@ -781,15 +781,22 @@ var PII_FIELDS = /* @__PURE__ */ new Set([
   "zp",
   "country"
 ]);
-function hashUserData(userData) {
+async function hashUserData(userData) {
   const result = {};
+  const hashPromises = [];
   for (const [key, value] of Object.entries(userData)) {
     if (PII_FIELDS.has(key) && typeof value === "string" && value.length > 0) {
-      result[key] = sha256(value);
+      hashPromises.push({ key, promise: sha256(value) });
     } else {
       result[key] = value;
     }
   }
+  const settled = await Promise.all(
+    hashPromises.map(async ({ key, promise }) => ({ key, hash: await promise }))
+  );
+  for (const { key, hash } of settled) {
+    result[key] = hash;
+  }
   return result;
 }
 
@@ -968,7 +975,7 @@ var MetaPixelProvider = class extends BaseProvider {
    * Merges cached user data (from `identify()` / config) with any per-event
    * overrides, then SHA-256 hashes known PII fields.
    */
-  buildUserData(overrides) {
+  async buildUserData(overrides) {
     const merged = { ...this.cachedUserData, ...overrides };
     return hashUserData(merged);
   }
@@ -985,7 +992,7 @@ var MetaPixelProvider = class extends BaseProvider {
         event_name: event,
         event_time: timestamp ? Math.floor(timestamp.getTime() / 1e3) : Math.floor(Date.now() / 1e3),
         action_source: "website",
-        user_data: this.buildUserData(userDataOverrides)
+        user_data: await this.buildUserData(userDataOverrides)
       };
       if (eventId) {
         eventData["event_id"] = eventId;

package/dist/index.mjs

@@ -102,7 +102,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
       window.gtag("consent", "default", consentParams);
     }
     window.gtag("js", /* @__PURE__ */ new Date());
-    const configParams = {};
+    const configParams = {
+      send_page_view: false
+    };
     if (this.config.signals === true) {
       configParams["allow_google_signals"] = true;
       configParams["allow_ad_personalization_signals"] = true;
@@ -110,11 +112,7 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
       configParams["allow_google_signals"] = false;
       configParams["allow_ad_personalization_signals"] = false;
     }
-    if (Object.keys(configParams).length > 0) {
-      window.gtag("config", this.config.measurementId, configParams);
-    } else {
-      window.gtag("config", this.config.measurementId);
-    }
+    window.gtag("config", this.config.measurementId, configParams);
     return new Promise((resolve) => {
       const script = document.createElement("script");
       script.async = true;
@@ -718,12 +716,14 @@ var PostHogProvider = class extends BaseProvider {
 };
 
 // src/utils/hash.ts
-import { createHash } from "crypto";
-function sha256(value) {
+async function sha256(value) {
   if (/^[a-f0-9]{64}$/.test(value)) {
     return value;
   }
-  return createHash("sha256").update(value).digest("hex");
+  const data = new TextEncoder().encode(value);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
 }
 var PII_FIELDS = /* @__PURE__ */ new Set([
   "em",
@@ -737,15 +737,22 @@ var PII_FIELDS = /* @__PURE__ */ new Set([
   "zp",
   "country"
 ]);
-function hashUserData(userData) {
+async function hashUserData(userData) {
   const result = {};
+  const hashPromises = [];
   for (const [key, value] of Object.entries(userData)) {
     if (PII_FIELDS.has(key) && typeof value === "string" && value.length > 0) {
-      result[key] = sha256(value);
+      hashPromises.push({ key, promise: sha256(value) });
     } else {
       result[key] = value;
     }
   }
+  const settled = await Promise.all(
+    hashPromises.map(async ({ key, promise }) => ({ key, hash: await promise }))
+  );
+  for (const { key, hash } of settled) {
+    result[key] = hash;
+  }
   return result;
 }
 
@@ -924,7 +931,7 @@ var MetaPixelProvider = class extends BaseProvider {
    * Merges cached user data (from `identify()` / config) with any per-event
    * overrides, then SHA-256 hashes known PII fields.
    */
-  buildUserData(overrides) {
+  async buildUserData(overrides) {
     const merged = { ...this.cachedUserData, ...overrides };
     return hashUserData(merged);
   }
@@ -941,7 +948,7 @@ var MetaPixelProvider = class extends BaseProvider {
         event_name: event,
         event_time: timestamp ? Math.floor(timestamp.getTime() / 1e3) : Math.floor(Date.now() / 1e3),
         action_source: "website",
-        user_data: this.buildUserData(userDataOverrides)
+        user_data: await this.buildUserData(userDataOverrides)
       };
       if (eventId) {
         eventData["event_id"] = eventId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mytart",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Multi-Yield Tracking & Analytics Relay Tool — framework-agnostic analytics for any project",
   "keywords": [
     "analytics",