lsb11/shopify-capi-validator

This is a command-line tool that checks event tracking payloads for Meta Conversions API and TikTok Events API before you send them live. Both platforms have a well-known frustration: if you send an incorrectly formatted event, they accept it silently and simply never count it, leaving you with missing conversion data and a degraded match quality score. This tool catches those formatting errors locally, so you find out before the data is lost. The most common mistakes it catches include sending timestamps in milliseconds instead of seconds (Meta expects 10-digit Unix timestamps, not 13-digit ones), sending raw unhashed email addresses and phone numbers instead of SHA-256 hashed versions, and omitting required fields like currency on purchase events. Each of these mistakes causes silent failures on both platforms, and this tool flags them with plain-English explanations and suggestions for how to fix each one. You can run it without installing anything, using npx directly against a JSON file or piping data from anywhere including curl output, log lines, or other tools. It can auto-detect which platform a payload is for, or you can specify Meta or TikTok explicitly. It also supports a machine-readable JSON output mode, which makes it suitable for use in automated CI pipelines. The exit code is non-zero when any check fails, which integrates cleanly with standard testing workflows. The tool has no external dependencies and is released under the MIT license, making it straightforward to add to any project or run on the fly during development. It can also be used as a JavaScript library directly in code if you want to validate payloads programmatically rather than from the command line. The README includes a full list of what is checked for both Meta and TikTok payloads.