ultimate-jekyll-manager 0.0.117 → 0.0.119

package/README.md

@@ -282,6 +282,114 @@ Add the `.btn-action` class to protect custom elements that trigger important ac
   - `_test_trialEligible=false`: User is not eligible for trial
 * `_test_cardProcessor`: Force a specific payment processor for testing (e.g., `_test_cardProcessor=stripe` or `_test_cardProcessor=paypal`)
 
+## JavaScript API
+
+### Ultimate Jekyll Libraries
+
+Ultimate Jekyll provides helper libraries in `src/assets/js/libs/` that can be imported as needed in your page modules.
+
+#### Prerendered Icons Library
+
+The prerendered icons library provides access to icons defined in page frontmatter. Icons are rendered server-side for optimal performance.
+
+**Import:**
+```javascript
+import { getPrerenderedIcon } from '__main_assets__/js/libs/prerendered-icons.js';
+```
+
+**Function: `getPrerenderedIcon(iconName)`**
+
+**Parameters:**
+- `iconName` (string) - Name of the icon to retrieve (matches `data-icon` attribute in frontmatter)
+
+**Returns:**
+- (string) Icon HTML or empty string if not found
+
+**Example:**
+```javascript
+import { getPrerenderedIcon } from '__main_assets__/js/libs/prerendered-icons.js';
+
+// Get a pre-rendered icon
+const appleIcon = getPrerenderedIcon('apple');
+
+// Use in your page
+document.querySelector('.device-icon').innerHTML = appleIcon;
+```
+
+**Setup:**
+Define icons in your page frontmatter:
+```yaml
+---
+prerender_icons:
+  - name: "apple"
+    class: "fa-3xl"
+  - name: "android"
+    class: "fa-2xl"
+  - name: "chrome"
+    class: "fa-lg"
+---
+```
+
+Icons are automatically rendered in the page HTML and can be retrieved by importing the library function.
+
+#### Authorized Fetch Library
+
+The authorized fetch library simplifies authenticated API requests by automatically adding Firebase authentication tokens.
+
+**Import:**
+```javascript
+import authorizedFetch from '__main_assets__/js/libs/authorized-fetch.js';
+```
+
+**Function: `authorizedFetch(url, options)`**
+
+**Parameters:**
+- `url` (string) - The API endpoint URL
+- `options` (Object) - Request options for wonderful-fetch (method, body, timeout, etc.)
+
+**Returns:**
+- (Promise) - The response from the API
+
+**Example:**
+```javascript
+import authorizedFetch from '__main_assets__/js/libs/authorized-fetch.js';
+
+// Make an authenticated API call
+const response = await authorizedFetch(serverApiURL, {
+  method: 'POST',
+  timeout: 30000,
+  response: 'json',
+  tries: 2,
+  body: {
+    command: 'user:get-data',
+    payload: { id: 'example' }
+  }
+});
+```
+
+**How It Works:**
+1. Retrieves the current Firebase user's ID token automatically
+2. Adds the token to the request as an `Authorization: Bearer <token>` header
+3. Makes the request using wonderful-fetch
+4. Throws an error if no authenticated user is found
+
+**Benefits:**
+- No need to manually call `webManager.auth().getIdToken()`
+- No need to add `authenticationToken` to request body
+- Centralized authentication handling
+- Consistent authentication across all API calls
+
+#### FormManager Library
+
+Custom library for form handling with built-in state management and validation.
+
+**Import:**
+```javascript
+import { FormManager } from '__main_assets__/js/libs/form-manager.js';
+```
+
+**Documentation:** See [form-manager.js](src/assets/js/libs/form-manager.js) for full API and usage examples.
+
 ### Icons
 * Fontawesome
   * https://fontawesome.com/search

package/TODO.md

@@ -34,7 +34,7 @@ MAKE COMPONENTS? ASK CLAUDE HOW AND IF ITS POSSIBLE
 
 FIX SIGNIN/SINGUP FORM
 
-https://192.168.86.69:4000/payment/checkout?product=premium&_test_trialEligible=true&_test_appId=dev&_test_cardProcessor=stripe
+https://192.168.86.69:4000/payment/checkout?product=premium&_dev_trialEligible=true&_dev_appId=dev&_dev_cardProcessor=stripe
 
 filter-adaptive-inverse
 

package/dist/assets/js/core/auth.js

@@ -1,4 +1,4 @@
-import fetch from 'wonderful-fetch';
+import authorizedFetch from '__main_assets__/js/libs/authorized-fetch.js';
 
 // Auth Module
 export default function (Manager, options) {
@@ -32,7 +32,7 @@ export default function (Manager, options) {
       console.log('[Auth] state changed:', state);
 
       // Set user ID for analytics tracking
-      setAnalyticsUserId(user);
+      setAnalyticsUserId(user, webManager);
 
       // Check if we're in the process of signing out
       if (authSignout === 'true' && user) {
@@ -119,9 +119,10 @@ function redirect(url, returnUrl) {
   window.location.href = newURL;
 }
 
-function setAnalyticsUserId(user) {
+function setAnalyticsUserId(user, webManager) {
   const userId = user?.uid;
   const email = user?.email;
+  const metaPixelId = webManager.config.tracking['meta-pixel'];
 
   // Short-circuit if no user
   if (!userId) {
@@ -129,7 +130,7 @@ function setAnalyticsUserId(user) {
     gtag('set', { user_id: null });
 
     // Facebook Pixel - Clear advanced matching
-    fbq('init', fbq.pixelId, {});
+    fbq('init', metaPixelId, {});
 
     // TikTok Pixel - Clear user data
     ttq.identify({});
@@ -147,7 +148,7 @@ function setAnalyticsUserId(user) {
   });
 
   // Facebook Pixel - Set advanced matching with user data
-  fbq('init', fbq.pixelId, {
+  fbq('init', metaPixelId, {
     external_id: userId,
     // em: email ? btoa(email.toLowerCase().trim()) : undefined,
     em: email,
@@ -166,9 +167,6 @@ function setAnalyticsUserId(user) {
 // Send user metadata to server (affiliate, UTM params, etc.)
 async function sendUserSignupMetadata(user, webManager) {
   try {
-    // Get the auth token
-    const token = await webManager.auth().getIdToken();
-
     // Get affiliate data from storage
     const affiliateData = webManager.storage().get('marketing.affiliate', null);
     const utmData = webManager.storage().get('marketing.utm', null);
@@ -193,11 +191,10 @@ async function sendUserSignupMetadata(user, webManager) {
     // Get server API URL
     const serverApiURL = webManager.getApiUrl() + '/backend-manager';
 
-    // Make API call to reset API key
-    const response = await fetch(serverApiURL, {
+    // Make API call to send signup metadata
+    const response = await authorizedFetch(serverApiURL, {
       method: 'POST',
       body: {
-        authenticationToken: token,
         command: 'user:sign-up',
         payload: payload
       }

package/dist/assets/js/core/cookieconsent.js

@@ -310,59 +310,66 @@ export default function (Manager, options) {
 
   // Tracking functions
   function trackCookieBannerShown() {
-    gtag('event', 'cookie_banner_shown', {
+    gtag('event', 'cookie_banner_show', {
       event_category: 'consent'
     });
-    fbq('trackCustom', 'CookieBannerShown');
+    fbq('trackCustom', 'CookieBannerShow');
     ttq.track('ViewContent', {
-      content_name: 'Cookie Banner'
+      content_id: 'cookie-banner-show',
+      content_type: 'product',
+      content_name: 'Cookie Banner Show'
     });
   }
 
   function trackCookieAccepted() {
-    gtag('event', 'cookie_consent_accepted', {
+    gtag('event', 'cookie_consent_accept', {
       event_category: 'consent',
       consent_type: config.type
     });
-    fbq('trackCustom', 'CookieConsentAccepted');
+    fbq('trackCustom', 'CookieConsentAccept');
     ttq.track('ClickButton', {
-      content_name: 'Cookie Consent Accept',
-      content_type: 'consent'
+      content_id: 'cookie-consent-accept',
+      content_type: 'product',
+      content_name: 'Cookie Consent Accept'
     });
   }
 
   function trackCookieDenied() {
-    gtag('event', 'cookie_consent_denied', {
+    gtag('event', 'cookie_consent_deny', {
       event_category: 'consent',
       consent_type: config.type
     });
-    fbq('trackCustom', 'CookieConsentDenied');
+    fbq('trackCustom', 'CookieConsentDeny');
     ttq.track('ClickButton', {
-      content_name: 'Cookie Consent Deny',
-      content_type: 'consent'
+      content_id: 'cookie-consent-deny',
+      content_type: 'product',
+      content_name: 'Cookie Consent Deny'
     });
   }
 
   function trackCookieAutoAccepted(trigger) {
-    gtag('event', 'cookie_consent_auto_accepted', {
+    gtag('event', 'cookie_consent_auto_accept', {
       event_category: 'consent',
       trigger: trigger
     });
-    fbq('trackCustom', 'CookieConsentAutoAccepted', {
+    fbq('trackCustom', 'CookieConsentAutoAccept', {
       trigger: trigger
     });
     ttq.track('ViewContent', {
-      content_name: 'Cookie Consent Auto Accept',
-      content_type: trigger
+      content_id: 'cookie-consent-auto-accept',
+      content_type: 'product',
+      content_name: 'Cookie Consent Auto Accept'
     });
   }
 
   function trackCookiePolicyReopened() {
-    gtag('event', 'cookie_policy_reopened', {
+    gtag('event', 'cookie_policy_reopen', {
       event_category: 'consent'
     });
-    fbq('trackCustom', 'CookiePolicyReopened');
+    fbq('trackCustom', 'CookiePolicyReopen');
     ttq.track('ClickButton', {
+      content_id: 'cookie-policy-reopen',
+      content_type: 'product',
       content_name: 'Cookie Policy Reopen'
     });
   }

package/dist/assets/js/core/exit-popup.js

@@ -177,20 +177,21 @@ export default function (Manager, options) {
 
   // Tracking functions
   function trackExitPopupShown() {
-    gtag('event', 'exit_popup_shown', {
+    gtag('event', 'exit_popup_show', {
       event_category: 'engagement',
       event_label: config.title,
       page_path: window.location.pathname
     });
 
-    fbq('trackCustom', 'ExitPopupShown', {
-      content_name: config.title,
+    fbq('trackCustom', 'ExitPopupShow', {
+      content_name: 'Exit Popup Show',
       page_path: window.location.pathname
     });
 
     ttq.track('ViewContent', {
-      content_name: 'Exit Popup',
-      content_type: config.title
+      content_id: 'exit-popup-show',
+      content_type: 'product',
+      content_name: 'Exit Popup Show'
     });
   }
 
@@ -207,24 +208,26 @@ export default function (Manager, options) {
     });
 
     ttq.track('ClickButton', {
-      content_name: 'Exit Popup CTA',
-      content_type: config.okButton?.text || 'OK'
+      content_id: 'exit-popup-click',
+      content_type: 'product',
+      content_name: 'Exit Popup Click'
     });
   }
 
   function trackExitPopupDismissed() {
-    gtag('event', 'exit_popup_dismissed', {
+    gtag('event', 'exit_popup_dismiss', {
       event_category: 'engagement',
       event_label: config.title
     });
 
-    fbq('trackCustom', 'ExitPopupDismissed', {
-      content_name: config.title
+    fbq('trackCustom', 'ExitPopupDismiss', {
+      content_name: 'Exit Popup Dismiss'
     });
 
     ttq.track('ViewContent', {
-      content_name: 'Exit Popup Dismissed',
-      content_type: config.title
+      content_id: 'exit-popup-dismiss',
+      content_type: 'product',
+      content_name: 'Exit Popup Dismiss'
     });
   }
 };

package/dist/assets/js/core/social-sharing.js

@@ -289,6 +289,8 @@ export default function (Manager, options) {
 
   // Tracking functions
   function trackShare(platformKey, shareConfig) {
+    const platformName = platforms[platformKey]?.name || platformKey;
+
     gtag('event', 'share', {
       method: platformKey,
       content_type: 'article',
@@ -302,9 +304,9 @@ export default function (Manager, options) {
     });
 
     ttq.track('Share', {
-      content_name: shareConfig.title,
-      content_url: shareConfig.url,
-      share_method: platformKey
+      content_id: `social-share-${platformKey}`,
+      content_type: 'product',
+      content_name: `Social Share ${platformName}`
     });
   }
 
@@ -319,7 +321,9 @@ export default function (Manager, options) {
     });
 
     ttq.track('ClickButton', {
-      content_name: 'Copy Link'
+      content_id: 'social-share-copy-link',
+      content_type: 'product',
+      content_name: 'Social Share Copy Link'
     });
   }
 };

package/dist/assets/js/libs/auth/pages.js

@@ -620,6 +620,7 @@ export default function (Manager) {
 
   function trackLogin(method, user) {
     const userId = user.uid;
+    const methodName = method.charAt(0).toUpperCase() + method.slice(1);
 
     // Google Analytics 4
     gtag('event', 'login', {
@@ -629,21 +630,22 @@ export default function (Manager) {
 
     // Facebook Pixel
     fbq('trackCustom', 'Login', {
+      content_name: `Account Login ${methodName}`,
       method: method,
-      status: 'success'
     });
 
     // TikTok Pixel
     ttq.track('Login', {
-      content_name: 'Account',
-      content_id: userId,
-      status: 'success'
+      content_id: `account-login-${method}`,
+      content_type: 'product',
+      content_name: `Account Login ${methodName}`
     });
   }
 
   // Analytics tracking functions
   function trackSignup(method, user) {
     const userId = user.uid;
+    const methodName = method.charAt(0).toUpperCase() + method.slice(1);
 
     // Google Analytics 4
     gtag('event', 'sign_up', {
@@ -653,17 +655,15 @@ export default function (Manager) {
 
     // Facebook Pixel
     fbq('track', 'CompleteRegistration', {
-      content_name: 'Account',
-      status: 'success',
-      value: 0,
-      currency: 'USD'
+      content_name: `Account Registration ${methodName}`,
+      method: method,
     });
 
     // TikTok Pixel
     ttq.track('CompleteRegistration', {
-      content_name: 'Account',
-      content_id: userId,
-      status: 'success'
+      content_id: `account-registration-${method}`,
+      content_type: 'product',
+      content_name: `Account Registration ${methodName}`
     });
   }
 
@@ -683,8 +683,9 @@ export default function (Manager) {
 
     // TikTok Pixel
     ttq.track('SubmitForm', {
-      content_name: 'Password Reset',
-      content_type: 'account_recovery'
+      content_id: 'password-reset',
+      content_type: 'product',
+      content_name: 'Password Reset'
     });
   }
 }