WazeWrap (Self-Contained)

Lightweight alerts and script update monitoring for Waze Map Editor (WME) scripts

Version: 2026.04.26 (Date-based versioning)
Build: Self-contained single file with all dependencies embedded

---

What's New in This Version

✨ Self-Contained Build — No external dependencies, all CSS and libraries embedded inline
🚀 Zero External Requests — Removed jQuery UI loader, uses WME's Bootstrap for button styling
🔧 Improved Initialization — Deferred toastr loading prevents jQuery timing errors
📦 Easy Deployment — Single file ready for Greasyfork (no CDN dependencies)

Features

✨ Alert System — Display user-friendly notifications with multiple levels
🔔 Script Update Monitoring — Automatically check for and notify users of script updates
📊 Update Dashboard — Beautiful modal showing available script updates
⚙️ Settings Tab — Customize alert visibility and preferences in WME sidebar
💾 Persistent History — Remember alert history and settings across sessions

---

Quick Start

1. Add to Your Script

In your Tampermonkey script header (add from Greasyfork when published):

// @require https://greasyfork.org/scripts/24851-wazewrap/code/WazeWrap.js

Note: This self-contained version includes all dependencies (toastr, CSS) inline. No external requests are made.

2. Wait for Initialization

Check WazeWrap.Ready to know when it's initialized:

// Check if ready immediately
if (WazeWrap && WazeWrap.Ready) {
  WazeWrap.Alerts.success('MyScript', 'Script initialized!');
}

// Or wait for it with a simple loop
function waitForReady(callback, tries = 0) {
  if (WazeWrap && WazeWrap.Ready) {
    callback();
  } else if (tries < 1000) {
    setTimeout(() => waitForReady(callback, tries + 1), 100);
  }
}

waitForReady(() => {
  WazeWrap.Alerts.success('MyScript', 'Script initialized!');
});

3. Use the API

// Show alerts
WazeWrap.Alerts.info('MyScript', 'Information message');
WazeWrap.Alerts.warning('MyScript', 'Warning message');
WazeWrap.Alerts.error('MyScript', 'Error message');
WazeWrap.Alerts.success('MyScript', 'Success message');

// Show confirmation dialog
WazeWrap.Alerts.confirm(
  'MyScript',
  'Are you sure?',
  () => {
    console.log('OK clicked');
  },
  () => {
    console.log('Cancel clicked');
  },
);

// Monitor for script updates
const updateMonitor = new WazeWrap.Alerts.ScriptUpdateMonitor('MyScript', '1.0.0', 'https://greasyfork.org/scripts/12345/my-script.user.js', GM_xmlhttpRequest);
updateMonitor.start(2); // Check every 2 hours

---

API Reference

Alerts

WazeWrap.Alerts.info(title, message, [disableTimeout, disableClickToClose, timeOut])

Display an info notification.

WazeWrap.Alerts.info('MyScript', 'Processing complete');
WazeWrap.Alerts.info('MyScript', 'Click to dismiss', false, true); // No auto-dismiss

WazeWrap.Alerts.warning(title, message)

Display a warning notification.

WazeWrap.Alerts.warning('MyScript', 'Invalid input');

WazeWrap.Alerts.error(title, message)

Display an error notification.

WazeWrap.Alerts.error('MyScript', 'Failed to load data');

WazeWrap.Alerts.success(title, message)

Display a success notification.

WazeWrap.Alerts.success('MyScript', 'Changes saved!');

WazeWrap.Alerts.debug(title, message)

Display a debug notification (minimal styling).

WazeWrap.Alerts.debug('MyScript', 'Debug info: ' + JSON.stringify(data));

WazeWrap.Alerts.confirm(title, message, okFn, cancelFn, [okText, cancelText])

Display a confirmation dialog.

WazeWrap.Alerts.confirm(
  'MyScript',
  'Delete item?',
  () => deleteItem(),
  () => console.log('Cancelled'),
  'Delete',
  'Cancel',
);

WazeWrap.Alerts.prompt(title, message, [defaultText, okFn, cancelFn])

Display a text input dialog.

WazeWrap.Alerts.prompt(
  'MyScript',
  'Enter your name:',
  'Default Name',
  (text) => console.log('User entered: ' + text),
  () => console.log('Cancelled'),
);

Script Update Monitoring

new WazeWrap.Alerts.ScriptUpdateMonitor(scriptName, version, downloadUrl, GM_xmlhttpRequest, [metaUrl, metaRegExp])

Create a monitor to check for script updates.

Parameters:

• scriptName (string) — Display name of your script
• version (string/number) — Current installed version
• downloadUrl (string) — URL to .user.js file (for Greasy Fork)
• GM_xmlhttpRequest (function) — Reference to GM_xmlhttpRequest from your script
• metaUrl (string, optional) — URL to metadata file with version info
• metaRegExp (RegExp, optional) — Regex to extract version (default: /@version\s+(.+)/i)

Methods:

const monitor = new WazeWrap.Alerts.ScriptUpdateMonitor('MyScript', '1.0.0', 'https://greasyfork.org/scripts/12345/my-script.user.js', GM_xmlhttpRequest);

// Start checking every 2 hours (default), immediately check first (default)
monitor.start(2, true);

// Stop checking
monitor.stop();

Interface

WazeWrap.Interface.ShowScriptUpdate(scriptName, version, updateHTML, [greasyforkLink, forumLink])

Display the script update dashboard with custom HTML.

WazeWrap.Interface.ShowScriptUpdate(
  'MyScript',
  '2.0.0',
  '<h4>New Features</h4><ul><li>Feature 1</li><li>Feature 2</li></ul>',
  'https://greasyfork.org/scripts/12345/my-script',
  'https://forum.waze.com/...',
);

---

Status Flag

Check if WazeWrap is ready:

if (WazeWrap.Ready) {
  // WazeWrap is fully initialized
  WazeWrap.Alerts.info('MyScript', 'Ready!');
}

---

Examples

Example 1: Simple Alert

// @require https://greasyfork.org/scripts/24851-wazewrap/code/WazeWrap.js

function init() {
  if (WazeWrap && WazeWrap.Ready) {
    WazeWrap.Alerts.success('MyScript', 'Hello, WME!');
  } else {
    setTimeout(init, 100);
  }
}

init();

Example 2: Update Monitor

// @require https://greasyfork.org/scripts/24851-wazewrap/code/WazeWrap.js
// @grant GM_xmlhttpRequest

function init() {
  if (WazeWrap && WazeWrap.Ready) {
    const updateMonitor = new WazeWrap.Alerts.ScriptUpdateMonitor('MyScript', GM_info.script.version, 'https://greasyfork.org/scripts/12345/my-script.user.js', GM_xmlhttpRequest);
    updateMonitor.start(2); // Check every 2 hours
  } else {
    setTimeout(init, 100);
  }
}

init();

Example 3: User Confirmation

// @require https://greasyfork.org/scripts/24851-wazewrap/code/WazeWrap.js

function init() {
  if (WazeWrap && WazeWrap.Ready) {
    WazeWrap.Alerts.confirm(
      'MyScript',
      'Apply changes to 50 segments?',
      () => {
        applyChanges();
        WazeWrap.Alerts.success('MyScript', 'Changes applied!');
      },
      () => {
        WazeWrap.Alerts.info('MyScript', 'Cancelled');
      },
      'Apply',
      'Cancel',
    );
  } else {
    setTimeout(init, 100);
  }
}

init();