wip: create customer if it doesn't already exist

example/06-create-customer-if-no-match.php

@@ -0,0 +1,66 @@
+<?php
+/**
+ * This example attempts to find a customer by the email address, supplied as
+ * the first argument to the script. If there is no match, it will create a new
+ * customer.
+ *
+ * The script requires the following arguments, in order:
+ * 1. email address
+ * 2. first name
+ * 3. last name
+ * 4. mobile number
+ *
+ * For any example to work, you must supply your own secrets in config.ini:
+ * - username
+ * - client
+ * - secret_key
+ */
+
+use BrightFlair\SpektrixAPI\CustomerNotFoundException;
+
+chdir(dirname(__DIR__));
+require "vendor/autoload.php";
+
+$config = parse_ini_file("config.ini");
+$client = new BrightFlair\SpektrixAPI\Client(
+	$config["username"],
+	$config["client"],
+	$config["secret_key"],
+);
+
+$email = $argv[1] ?? null;
+if(!$email) {
+	fwrite(STDERR, "No email address supplied\n");
+	exit(1);
+}
+$firstName = $argv[2] ?? null;
+if(!$firstName) {
+	fwrite(STDERR, "No first name supplied\n");
+	exit(1);
+}
+$lastName = $argv[3] ?? null;
+if(!$lastName) {
+	fwrite(STDERR, "No last name supplied\n");
+	exit(1);
+}
+$mobileNumber = $argv[4] ?? null;
+if(!$mobileNumber) {
+	fwrite(STDERR, "No mobile number supplied\n");
+	exit(1);
+}
+
+try {
+	$customer = $client->getCustomer(email: $email);
+	echo "Customer found!\n";
+	echo "ID: $customer->id\n";
+	echo "Email: $customer->email\n";
+	echo "First name: $customer->firstName\n";
+	echo "Last name: $customer->lastName\n";
+}
+catch(CustomerNotFoundException) {
+	echo "No customer was found with the email address $email\n";
+	echo "Creating new customer...\n";
+
+// TODO: This simply isn't working. HTTP 500 with no reason why. I'm going to have to get back in contact with the team.
+	$customer = $client->createCustomer($email, $firstName, $lastName, $mobileNumber);
+}

src/Client.php

@@ -22,6 +22,40 @@ public function __construct(
 		$this->http = $fetchClient ?? new Http();
 	}
 
+	public function createCustomer(
+		string $email,
+		?string $firstName = null,
+		?string $lastName = null,
+		?string $mobile = null,
+	):Customer {
+		$endpoint = Endpoint::createCustomer;
+		$authenticatedRequest = new AuthenticatedRequest(
+			$this->secretKey,
+			$endpoint,
+			$this->client,
+			[
+				"email" => $email,
+				"firstName" => $firstName ?? "",
+				"lastName" => $lastName ?? "",
+				"mobile" => $mobile ?? "",
+				"birthDate" => ("D, d M Y H:i:s T"),
+				"friendlyId" => uniqid(),
+			]
+		);
+
+		if($json = $this->json($authenticatedRequest)) {
+			return new Customer(
+				$json->getString("id"),
+				$json->getString("email"),
+				firstName: $json->getString("firstName"),
+				lastName: $json->getString("lastName"),
+				mobile: $json->getString("mobile"),
+			);
+		}
+
+		throw new CustomerNotFoundException($email ?? $id);
+	}
+
 	public function getCustomer(
 		?string $id = null,
 		?string $email = null,
@@ -150,6 +184,7 @@ public function addTagToCustomer(
 		throw new SpektrixAPIException("Error adding tag ID $tagId to customer $customerId");
 	}
 
+
 	public function removeTagFromCustomer(
 		Tag|string $tag,
 		Customer|string $customer,
@@ -175,7 +210,6 @@ public function removeTagFromCustomer(
 		$this->json($authenticatedRequest);
 	}
 
-
 	private function json(AuthenticatedRequest $authenticatedRequest):?JsonObject {
 		$authorizationHeader = Signature::AUTH_PREFIX
 			. " "
@@ -191,6 +225,10 @@ private function json(AuthenticatedRequest $authenticatedRequest):?JsonObject {
 			"Authorization" => $authorizationHeader,
 		];
 
+		if($authenticatedRequest->body) {
+			$httpHeaders["Content-type"] = "application/x-www-form-urlencoded";
+		}
+
 		$init = [
 			"method" => $authenticatedRequest->httpMethod,
 			"headers" => $httpHeaders,

src/Endpoint.php

@@ -2,6 +2,7 @@
 namespace BrightFlair\SpektrixAPI;
 
 enum Endpoint:string {
+	case createCustomer = "POST v3/customers email={email}&firstName={firstName}&lastName={lastName}&mobile={mobile}"; //&Phone={mobile}&Title=XX&Password=ABCDEFGHIJKLMNOPQRSTUVWXYZ&BirthDate=2024-01-31T22:45:56.2997626+00:00
 	case getCustomerById = "GET v3/customers/{id}";
 	case getCustomerByEmail = "GET v3/customers?email={email}";
 	case getAllTags = "GET v3/tags";