mytart 0.5.1 → 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

@@ -760,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",
@@ -779,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;
 }
 
@@ -966,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);
   }
@@ -983,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

@@ -716,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",
@@ -735,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;
 }
 
@@ -922,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);
   }
@@ -939,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.1",
+  "version": "0.5.2",
   "description": "Multi-Yield Tracking & Analytics Relay Tool — framework-agnostic analytics for any project",
   "keywords": [
     "analytics",