Merge pull request #669 from Kit/emit-js-custom-event-on-subscribe

Emit JS `CustomEvent` when a user subscribes to a ConvertKit Form

resources/frontend/js/convertkit.js

@@ -114,13 +114,24 @@ function convertStoreSubscriberEmailAsIDInCookie( emailAddress ) {
 			if ( convertkit.debug ) {
 				console.log( response );
 			}
+
+			return response.json();
 		}
 	)
 	.then(
 		function ( result ) {
 			if ( convertkit.debug ) {
 				console.log( result );
 			}
+
+			// Emit custom event with subscriber ID.
+			convertKitEmitCustomEvent(
+				'convertkit_user_subscribed',
+				{
+					id: result.data.id,
+					email: emailAddress
+				}
+			);
 		}
 	)
 	.catch(
@@ -181,6 +192,24 @@ function convertKitSleep( milliseconds ) {
 
 }
 
+/**
+ * Emit a custom event with optional detail data.
+ *
+ * This function creates and dispatches a custom event with the specified
+ * event name and detail data.
+ *
+ * @since 2.5.0
+ *
+ * @param {string} eventName	The name of the custom event to emit.
+ * @param {Object} [detail={}] 	Optional detail data to include with the event.
+ */
+function convertKitEmitCustomEvent( eventName, detail ) {
+
+	const event = new CustomEvent( eventName, { detail } );
+	document.dispatchEvent( event );
+
+}
+
 /**
  * Register events
  */