Update readme file, Update composer.json file, Exception updates

Alle exceptions thrown in Response are now general AmazonError with json
return string for full compability

Readme.md

@@ -1,11 +1,19 @@
-# Amazon Incentives - Gift on Demand standa alone class
+# Amazon Incentives - Gift Codes on Demand stand alone class
 
 This is a abastract from (https://github.com/kamerk22/AmazonGiftCode) to be not dependend on Laravel base code.
 
-Uses .env file to load configuration data
+Amazon Gift Codes On Demand (AGCOD). Integration for Amazon Incentive API.
+
+## How to install
+
+`composer request gullevek/amazon-incentives`
 
 ## _ENV variables needed
 
+Uses .env file to load configuration data
+
+The below keys are searched in the _ENV file for loading
+
 * AWS_GIFT_CARD_KEY
 * AWS_GIFT_CARD_SECRET
 * AWS_GIFT_CARD_PARTNER_ID
@@ -15,14 +23,15 @@ Uses .env file to load configuration data
 
 ## How to use
 
-The class must be loaded with an autoloader (see test/autoloader.php for example).
-
 The above _ENV variables must be set (Except AWS_DEBUG, defaults to off).
 
 ### create gift card
 
 ```php
-$aws_gc = Amazon\AmazonIncentives::make()->buyGiftCard((float)$value);
+use gullevek\AmazonIncentives\AmazonIncentives;
+// buy a gift card with a value
+$value = 500;
+$aws_gc = AmazonIncentives::make()->buyGiftCard((float)$value);
 // the two below are need if we want to cancel the card
 // get gift card id (gcID)
 $aws_gc->getId();
@@ -55,14 +64,14 @@ Recommended to pool requests. Or check when last requests where sent and then pr
 
 ```php
 // use getCreationRequestId() and getId() from request
-$aws_gc = Amazon\AmazonIncentives::make()->cancelGiftCard($creation_request_id, $gift_card_id);
+$aws_gc = gullevek\AmazonIncentives\AmazonIncentives::make()->cancelGiftCard($creation_request_id, $gift_card_id);
 // return is as above
 ```
 
 ### check balance
 
 ```php
-$aws_gc = Amazon\AmazonIncentives::make()->getAvailableFunds();
+$aws_gc = gullevek\AmazonIncentives\AmazonIncentives::make()->getAvailableFunds();
 ```
 
 ## Exceptions
@@ -71,6 +80,12 @@ If the HTTPS request does not return 220 OK it will throw an exception.
 
 The error code is the curl handler error code.
 The error message is json encoded array with the layout
+
+Use
+```php
+$exception_array = gullevek\AmazonIncentives\AmazonIncentives::decodeExceptionMessage($exception_message);
+```
+to extract the below array from the thrown exception
 ```php
 [
 	'status' => 'AWS Status FAILURE or RESEND',
@@ -84,18 +99,25 @@ The error message is json encoded array with the layout
 
 `status`, `code` and `type` must be checked on a failure.
 
-**NOTE**: if code is E999 then this is a request flood error:
+**NOTE**: if code is T001 then this is a request flood error:
 In this case the request has to be resend after a certain waiting period.
 
+**NOTE**: if code is E999 some other critical error has happened
+
+**NOTE**: if code is E001 if the return create/cancel/check calls is not an array
+
+**NOTE**: if code is C001 a curl error has happened
+
+**NOTE**: any other NON amazon error will have only 'message' set if run through decode
+
 ## Debugging
 
 If AWS_DEBUG is set to 1 and internal array will be written with debug info.
 
-The Amazon\Debug\AmazonDebug class handles all this.
+The gulleek\AmazonIncentives\Debug\AmazonDebug class handles all this.
 
-In the Amazon\AWS\AWS main class the debugger gets set
-* setFlag that turns debugger on/off
-* setId (to set unique id for each run)
+In the gulleek\AmazonIncentives\AmazonIncentives main class the debugger gets set
+* setDebug that turns debugger on/off and if on sets unique id (getId to check)
 
 New entries can be written with
 

composer.json

@@ -0,0 +1,24 @@
+{
+    "name": "gullevek/amazon-incentives",
+    "description": "Amazon Gift Codes, Gift on Demand, Incentives",
+    "keywords": ["AmazonGiftCode", "Amazon", "GiftCard", "AGCOD", "Incentives API", "Amazon Incentives API"],
+    "type": "library",
+    "license": "help",
+    "autoload": {
+        "psr-4": {
+            "gullevek\\AmazonIncentives\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "Clemens Schwaighofer",
+            "email": "gullevek@gullevek.org",
+            "homepage": "http://gullevek.org"
+        }
+    ],
+    "homepage": "https://github.com/gullevek/AmazonIncentives",
+    "minimum-stability": "dev",
+    "require": {
+		"php": ">=7.4.0"
+	}
+}

src/AWS/AWS.php

@@ -1,14 +1,14 @@
 <?php
 
-namespace Amazon\AWS;
+namespace gullevek\AmazonIncentives\AWS;
 
-use Amazon\Client\Client;
-use Amazon\Config\Config;
-use Amazon\Exceptions\AmazonErrors;
-use Amazon\Debug\AmazonDebug;
-use Amazon\Response\CancelResponse;
-use Amazon\Response\CreateBalanceResponse;
-use Amazon\Response\CreateResponse;
+use gullevek\AmazonIncentives\Client\Client;
+use gullevek\AmazonIncentives\Config\Config;
+use gullevek\AmazonIncentives\Exceptions\AmazonErrors;
+use gullevek\AmazonIncentives\Debug\AmazonDebug;
+use gullevek\AmazonIncentives\Response\CancelResponse;
+use gullevek\AmazonIncentives\Response\CreateBalanceResponse;
+use gullevek\AmazonIncentives\Response\CreateResponse;
 
 class AWS
 {
@@ -34,8 +34,6 @@ class AWS
 	public function __construct(Config $config)
 	{
 		$this->config = $config;
-		AmazonDebug::setFlag($config->getDebug());
-		AmazonDebug::setId();
 		AmazonDebug::writeLog([__METHOD__ => date('Y-m-d H:m:s.u')]);
 	}
 
@@ -154,7 +152,7 @@ class AWS
 			'Service' => $k_service_hexis,
 		]]);
 
-		$url = 'https://' . $endpoint . '/' . $service_operation;
+		$url = 'https://' . (string)$endpoint . '/' . $service_operation;
 		$headers = $this->buildHeaders($payload, $authorization_value, $date_time_string, $service_target);
 		return (new Client())->request($url, $headers, $payload);
 	}
@@ -268,6 +266,30 @@ class AWS
 	}
 
 	/**
+	 * get the region based on endpoint
+	 * list as of 2021/10/20
+	 * WHERE			URL										REGION
+	 * North America	https://agcod-v2-gamma.amazon.com		us-east-1
+	 * 					https://agcod-v2.amazon.com
+	 * (US, CA, MX)
+	 * Europe and Asia	https://agcod-v2-eu-gamma.amazon.com	eu-west-1
+	 * 					https://agcod-v2-eu.amazon.com
+	 * (IT, ES, DE, FR, UK, TR, UAE, KSA, PL, NL, SE)
+	 * Far East			https://agcod-v2-fe-gamma.amazon.com	us-west-2
+	 * 					https://agcod-v2-fe.amazon.com
+	 * (JP, AU, SG)
+	 *
+	 * CURRENCY
+	 * USD for US
+	 * EUR for EU (IT, ES, DE, FR, PL, NL, SE)
+	 * JPY for JP
+	 * CAD for CA
+	 * AUD for AU
+	 * TRY for TR
+	 * AED for UAE
+	 * MXN for MX
+	 * GBP for UK
+	 *
 	 * @return string
 	 */
 	public function getRegion(): string

src/Amazon/Debug/AmazonDebug.php

@@ -1,56 +0,0 @@
-<?php
-
-// simple write all into an array that we can poll in the return group
-
-namespace Amazon\Debug;
-
-class AmazonDebug
-{
-	private static $log = [];
-	private static $debug = false;
-	private static $id = null;
-
-	public function __construct()
-	{
-	}
-
-	public static function setId(?string $id = null): void
-	{
-		if (self::$debug === false) {
-			return;
-		}
-		if ($id === null) {
-			$id = uniqid();
-		}
-		self::$id = $id;
-	}
-
-	public static function getId(): string
-	{
-		return self::$id;
-	}
-
-	public static function setFlag(bool $debug): void
-	{
-		self::$debug = $debug;
-	}
-
-	public static function writeLog(array $data): void
-	{
-		if (self::$debug === false) {
-			return;
-		}
-		self::$log[self::$id][] = $data;
-	}
-
-	public static function getLog(?string $id = null): array
-	{
-		if ($id === null) {
-			return self::$log;
-		} else {
-			return self::$log[$id] ?? [];
-		}
-	}
-}
-
-// __END__

src/AmazonIncentives.php

@@ -34,11 +34,12 @@
  * error handler/retry
  */
 
-namespace Amazon;
+namespace gullevek\AmazonIncentives;
 
-use Amazon\AWS\AWS;
-use Amazon\Config\Config;
-use Amazon\Exceptions\AmazonErrors;
+use gullevek\AmazonIncentives\AWS\AWS;
+use gullevek\AmazonIncentives\Config\Config;
+use gullevek\AmazonIncentives\Exceptions\AmazonErrors;
+use gullevek\AmazonIncentives\Debug\AmazonDebug;
 
 class AmazonIncentives
 {
@@ -65,18 +66,14 @@ class AmazonIncentives
 		// load AWS settings
 		// fail here if settings missing
 		$this->config = new Config($key, $secret, $partner, $endpoint, $currency, $debug);
+		// init debug
+		AmazonDebug::setDebug($this->config->getDebug());
 	}
 
 	// *********************************************************************
 	// PRIVATE HELPER METHODS
 	// *********************************************************************
 
-	// *********************************************************************
-	// PUBLIC DEBUG METHODS
-	// *********************************************************************
-
-	// like log collector (array) and returner
-
 	// *********************************************************************
 	// PUBLIC METHODS
 	// *********************************************************************

src/Client/Client.php

@@ -1,9 +1,9 @@
 <?php
 
-namespace Amazon\Client;
+namespace gullevek\AmazonIncentives\Client;
 
-use Amazon\Exceptions\AmazonErrors;
-use Amazon\Debug\AmazonDebug;
+use gullevek\AmazonIncentives\Exceptions\AmazonErrors;
+use gullevek\AmazonIncentives\Debug\AmazonDebug;
 
 class Client implements ClientInterface
 {
@@ -79,19 +79,19 @@ class Client implements ClientInterface
 			case CURLE_COULDNT_CONNECT:
 			case CURLE_COULDNT_RESOLVE_HOST:
 			case CURLE_OPERATION_TIMEOUTED:
-				$msg = 'Could not connect to AWS (' . $url . ').  Please check your '
-					. 'internet connection and try again.';
+				$message = 'Could not connect to AWS (' . $url . ').  Please check your '
+					. 'internet connection and try again. [' . $message . ']';
 				break;
 			case CURLE_SSL_CACERT:
 			case CURLE_SSL_PEER_CERTIFICATE:
-				$msg = 'Could not verify AWS SSL certificate.  Please make sure '
+				$message = 'Could not verify AWS SSL certificate.  Please make sure '
 					. 'that your network is not intercepting certificates.  '
 					. '(Try going to ' . $url . 'in your browser.)  '
-					. 'If this problem persists,';
+					. '[' . $message . ']';
 				break;
 			case 0:
 			default:
-				$msg = 'Unexpected error communicating with AWS. ' . $message;
+				$message = 'Unexpected error communicating with AWS: ' . $message;
 		}
 
 		// throw an error like in the normal reqeust, but set to CURL error

src/Client/ClientInterface.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Amazon\Client;
+namespace gullevek\AmazonIncentives\Client;
 
 interface ClientInterface
 {

src/Config/Config.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Amazon\Config;
+namespace gullevek\AmazonIncentives\Config;
 
 class Config implements ConfigInterface
 {
@@ -80,9 +80,9 @@ class Config implements ConfigInterface
 	}
 
 	/**
-	 * @return string
+	 * @return string|null
 	 */
-	public function getEndpoint(): string
+	public function getEndpoint(): ?string
 	{
 		return $this->endpoint;
 	}
@@ -100,9 +100,9 @@ class Config implements ConfigInterface
 	}
 
 	/**
-	 * @return string
+	 * @return string|null
 	 */
-	public function getAccessKey(): string
+	public function getAccessKey(): ?string
 	{
 		return $this->access_key;
 	}
@@ -119,9 +119,9 @@ class Config implements ConfigInterface
 	}
 
 	/**
-	 * @return string
+	 * @return string|null
 	 */
-	public function getSecret(): string
+	public function getSecret(): ?string
 	{
 		return $this->secret_key;
 	}
@@ -138,9 +138,9 @@ class Config implements ConfigInterface
 	}
 
 	/**
-	 * @return string
+	 * @return string|null
 	 */
-	public function getCurrency(): string
+	public function getCurrency(): ?string
 	{
 		return $this->currency;
 	}
@@ -158,9 +158,9 @@ class Config implements ConfigInterface
 	}
 
 	/**
-	 * @return string
+	 * @return string|null
 	 */
-	public function getPartner(): string
+	public function getPartner(): ?string
 	{
 		return $this->partner_id;
 	}
@@ -177,9 +177,9 @@ class Config implements ConfigInterface
 	}
 
 	/**
-	 * @return bool
+	 * @return bool|null
 	 */
-	public function getDebug(): bool
+	public function getDebug(): ?bool
 	{
 		return $this->debug;
 	}

src/Config/ConfigInterface.php

@@ -1,13 +1,13 @@
 <?php
 
-namespace Amazon\Config;
+namespace gullevek\AmazonIncentives\Config;
 
 interface ConfigInterface
 {
 	/**
-	 * @return String
+	 * @return string|null
 	 */
-	public function getEndpoint(): string;
+	public function getEndpoint(): ?string;
 
 	/**
 	 * @param string $endpoint
@@ -16,9 +16,9 @@ interface ConfigInterface
 	public function setEndpoint(string $endpoint): ConfigInterface;
 
 	/**
-	 * @return String
+	 * @return string|null
 	 */
-	public function getAccessKey(): string;
+	public function getAccessKey(): ?string;
 
 	/**
 	 * @param string $key
@@ -27,9 +27,9 @@ interface ConfigInterface
 	public function setAccessKey(string $key): ConfigInterface;
 
 	/**
-	 * @return String
+	 * @return string|null
 	 */
-	public function getSecret(): string;
+	public function getSecret(): ?string;
 
 	/**
 	 * @param string $secret
@@ -38,9 +38,9 @@ interface ConfigInterface
 	public function setSecret(string $secret): ConfigInterface;
 
 	/**
-	 * @return String
+	 * @return string|null
 	 */
-	public function getCurrency(): string;
+	public function getCurrency(): ?string;
 
 	/**
 	 * @param string $currency
@@ -49,9 +49,9 @@ interface ConfigInterface
 	public function setCurrency(string $currency): ConfigInterface;
 
 	/**
-	 * @return String
+	 * @return string|null
 	 */
-	public function getPartner(): string;
+	public function getPartner(): ?string;
 
 	/**
 	 * @param string $partner
@@ -60,9 +60,9 @@ interface ConfigInterface
 	public function setPartner(string $partner): ConfigInterface;
 
 	/**
-	 * @return bool
+	 * @return bool|null
 	 */
-	public function getDebug(): bool;
+	public function getDebug(): ?bool;
 
 	/**
 	 * @param bool $debug

src/Debug/AmazonDebug.php

@@ -0,0 +1,106 @@
+<?php
+
+// simple write all into an array that we can poll in the return group
+// to activate AmazonDebug::setDebug(true) must be called once
+
+namespace gullevek\AmazonIncentives\Debug;
+
+class AmazonDebug
+{
+	private static $log = [];
+	private static $debug = false;
+	private static $id = null;
+
+	/**
+	 * set the ID for current run
+	 * if debug is off, nothing will be set and id is null
+	 * This is run on setFlag, if debug is true
+	 *
+	 * @param  string|null $id If not set, will default to uniqid() call
+	 * @return void
+	 */
+	private static function setId(?string $id = null): void
+	{
+		if (self::$debug === false) {
+			return;
+		}
+		if ($id === null) {
+			$id = uniqid();
+		}
+		self::$id = $id;
+	}
+
+	/**
+	 * set the debug flag.
+	 * This is automatically run in gullevek\AmazonIncentives\AmazonIncentives::__construct
+	 * No need to run manuall
+	 *
+	 * @param  boolean     $debug Can only be True or False
+	 * @param  string|null $id    If not set, will default to uniqid() call
+	 * @return void
+	 */
+	public static function setDebug(bool $debug, ?string $id = null): void
+	{
+		self::$debug = $debug;
+		if (self::$debug === false) {
+			return;
+		}
+		self::setId($id);
+	}
+
+	/**
+	 * returns current debug flag status
+	 *
+	 * @return boolean True if debug is on, False if debug is off
+	 */
+	public static function getDebug(): bool
+	{
+		return self::$debug;
+	}
+
+	/**
+	 * get the current set ID, can return null if debug is off
+	 *
+	 * @return string|null Current set ID for this log run
+	 */
+	public static function getId(): ?string
+	{
+		return self::$id;
+	}
+
+	/**
+	 * write a log entry
+	 * Data is as array key -> value
+	 * Will be pushed as new array entry int log
+	 * Main key is the set Id for this run
+	 *
+	 * @param  array $data Any array data to store in the log
+	 * @return void
+	 */
+	public static function writeLog(array $data): void
+	{
+		if (self::$debug === false) {
+			return;
+		}
+		self::$log[self::getId()][] = $data;
+	}
+
+	/**
+	 * get all logs written since first class run
+	 * or get all log entries for given ID
+	 *
+	 * @param  string|null $id If set returns only this id logs
+	 *                         or empty array if not found
+	 * @return array           Always array, empty if not data or not found
+	 */
+	public static function getLog(?string $id = null): array
+	{
+		if ($id === null) {
+			return self::$log;
+		} else {
+			return self::$log[$id] ?? [];
+		}
+	}
+}
+
+// __END__

src/Exceptions/AmazonErrors.php

@@ -1,8 +1,9 @@
 <?php
 
-namespace Amazon\Exceptions;
+namespace gullevek\AmazonIncentives\Exceptions;
 
 use RuntimeException;
+use gullevek\AmazonIncentives\Debug\AmazonDebug;
 
 class AmazonErrors extends RuntimeException
 {
@@ -29,8 +30,8 @@ class AmazonErrors extends RuntimeException
 				'type' => $error_type,
 				'message' => $message,
 				// atach log data if exists
-				'log_id' => \Amazon\Debug\AmazonDebug::getId(),
-				'log' => \Amazon\Debug\AmazonDebug::getLog(),
+				'log_id' => AmazonDebug::getId(),
+				'log' => AmazonDebug::getLog(),
 			]),
 			$_error_code
 		);

src/Response/CancelResponse.php

@@ -1,6 +1,9 @@
 <?php
 
-namespace Amazon\Response;
+namespace gullevek\AmazonIncentives\Response;
+
+use gullevek\AmazonIncentives\Exceptions\AmazonErrors;
+use gullevek\AmazonIncentives\Debug\AmazonDebug;
 
 class CancelResponse
 {
@@ -40,7 +43,7 @@ class CancelResponse
 	public function __construct(array $json_response)
 	{
 		$this->raw_json = $json_response;
-		$this->log = \Amazon\Debug\AmazonDebug::getLog(\Amazon\Debug\AmazonDebug::getId());
+		$this->log = AmazonDebug::getLog(AmazonDebug::getId());
 		$this->parseJsonResponse($json_response);
 	}
 
@@ -91,7 +94,13 @@ class CancelResponse
 	public function parseJsonResponse(array $json_response): self
 	{
 		if (!is_array($json_response)) {
-			throw new \RuntimeException('Response must be a scalar value');
+			throw AmazonErrors::getError(
+				'FAILURE',
+				'E001',
+				'NonScalarValue',
+				'Response must be a scalar value',
+				0
+			);
 		}
 		if (array_key_exists('gcId', $json_response)) {
 			$this->id = $json_response['gcId'];

src/Response/CreateBalanceResponse.php

@@ -1,6 +1,9 @@
 <?php
 
-namespace Amazon\Response;
+namespace gullevek\AmazonIncentives\Response;
+
+use gullevek\AmazonIncentives\Exceptions\AmazonErrors;
+use gullevek\AmazonIncentives\Debug\AmazonDebug;
 
 class CreateBalanceResponse
 {
@@ -47,7 +50,7 @@ class CreateBalanceResponse
 	public function __construct(array $json_response)
 	{
 		$this->raw_json = $json_response;
-		$this->log = \Amazon\Debug\AmazonDebug::getLog(\Amazon\Debug\AmazonDebug::getId());
+		$this->log = AmazonDebug::getLog(AmazonDebug::getId());
 		$this->parseJsonResponse($json_response);
 	}
 
@@ -108,7 +111,13 @@ class CreateBalanceResponse
 	public function parseJsonResponse(array $json_response): self
 	{
 		if (!is_array($json_response)) {
-			throw new \RuntimeException('Response must be a scalar value');
+			throw AmazonErrors::getError(
+				'FAILURE',
+				'E001',
+				'NonScalarValue',
+				'Response must be a scalar value',
+				0
+			);
 		}
 		if (array_key_exists('amount', $json_response['availableFunds'])) {
 			$this->amount = $json_response['availableFunds']['amount'];

src/Response/CreateResponse.php

@@ -1,6 +1,9 @@
 <?php
 
-namespace Amazon\Response;
+namespace gullevek\AmazonIncentives\Response;
+
+use gullevek\AmazonIncentives\Exceptions\AmazonErrors;
+use gullevek\AmazonIncentives\Debug\AmazonDebug;
 
 class CreateResponse
 {
@@ -74,7 +77,7 @@ class CreateResponse
 	public function __construct(array $json_response)
 	{
 		$this->raw_json = $json_response;
-		$this->log = \Amazon\Debug\AmazonDebug::getLog(\Amazon\Debug\AmazonDebug::getId());
+		$this->log = AmazonDebug::getLog(AmazonDebug::getId());
 		$this->parseJsonResponse($json_response);
 	}
 
@@ -166,7 +169,13 @@ class CreateResponse
 	public function parseJsonResponse(array $json_response): self
 	{
 		if (!is_array($json_response)) {
-			throw new \RuntimeException('Response must be a scalar value');
+			throw AmazonErrors::getError(
+				'FAILURE',
+				'E001',
+				'NonScalarValue',
+				'Response must be a scalar value',
+				0
+			);
 		}
 		if (array_key_exists('gcId', $json_response)) {
 			$this->id = $json_response['gcId'];

test/autoloader.php

@@ -1,63 +0,0 @@
-<?php // phpcs:ignore PSR1.Files.SideEffects
-
-declare(strict_types=1);
-
-namespace Autoloader;
-
-// shall implement an auto loader
-
-if (class_exists('Autoload', false) === false) {
-	// define the auto loader class
-	class Autoload
-	{
-		// we do it simple here
-		// passes on the class to load and we search here in namespace
-		// to load that class
-		public static function load($class)
-		{
-			// print "(1) Class: $class / DIR: " . __DIR__ . "<br>";
-			// set directory seperator (we need to replace from namespace)
-			$DS = DIRECTORY_SEPARATOR;
-			// base lib
-			$LIB = defined('LIB') ? LIB : '../src' . $DS;
-			// if lib is in path at the end, do not add lib again
-			// note that $LIB can have a directory seperator at the end
-			// strip that out before we do a match
-			$_LIB = rtrim($LIB, $DS);
-			if (!preg_match("|$_LIB$|", __DIR__)) {
-				$LIB .= $DS;
-			} else {
-				$LIB = '';
-			}
-			// default path is unset
-			$path = false;
-			// set path on full dir
-			// if we have the namespace in the class, strip it out
-			$len = 0;
-			if (strpos($class, __NAMESPACE__) !== false) {
-				$len = strlen(__NAMESPACE__);
-			}
-			// set default extension
-			$extension = '.php';
-			// set full include path
-			$path = __DIR__ . $DS . $LIB . substr($class, $len);
-			// replace namespace \ with dir sepeator
-			$path = str_replace('\\', $DS, $path) . $extension;
-			// print "(2) Class clean: $path<br>";
-			// if path is set and a valid file
-			if ($path !== false && is_file($path)) {
-				// print "<b>(3)</b> Load Path: $path<br>";
-				// we should sub that
-				// self::loadFile($path);
-				include $path;
-				return true;
-			}
-			return false;
-		}
-		// end class define
-	}
-
-	spl_autoload_register('Autoloader\Autoload::load', true, true);
-} // end check for already defined
-
-// __END__

test/aws_gift_card_tests.php

@@ -1,12 +1,67 @@
 <?php // phpcs:ignore PSR1.Files.SideEffects
 
-// test for Amazon Gift Card Incentives
+// Tests for Amazon Gift Card Incentives
 
-// general auto loader
-require 'autoloader.php';
-// env file loader
+/**
+ * write log as string from array data
+ * includes timestamp
+ *
+ * @param  array  $data Debug log array data to add to the json string
+ * @return string
+ */
+function writeLog(array $data): string
+{
+	return json_encode([
+		'date' => date('Y-m-d H:i:s'),
+		'log' => $data
+	]) . "\n";
+}
+
+/**
+ * translate the UTC amazon date string to Y-m-d H:i:s standard
+ *
+ * @param  string $date A UTC string date from Amazon
+ * @return string
+ */
+function dateTr(string $date): string
+{
+	return date('Y-m-d H:i:s', strtotime($date));
+}
+
+/**
+ * print exception string
+ *
+ * @param  string  $call_request Call request, eg buyGiftCard
+ * @param  integer $error_code   $e Exception error code
+ * @param  array   $error        Array from the Exception message json string
+ * @param  boolean $debug_print  If we should show the debug log
+ * @return void
+ */
+function printException(
+	string $call_request,
+	int $error_code,
+	array $error,
+	bool $debug_print
+): void {
+	print "AWS: " . $call_request . ": " . $error['status']
+		. " [" . $error_code . "]: "
+		. $error['code'] . " | " . $error['type']
+		. " | " . $error['message'];
+	if ($debug_print === true) {
+		print "<pre>" . print_r($error['log'][$error['log_id'] ?? ''] ?? [], true) . "</pre>";
+	}
+}
+
+// composer auto loader
+$loader = require '../vendor/autoload.php';
+// need to add this or it will not load here
+$loader->addPsr4('gullevek\\', __DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'src');
+// print "LOADER: <pre>" . print_r($loader, true) . "</pre>";
+// env file loader (simple)
 require 'read_env_file.php';
 
+use gullevek\AmazonIncentives\AmazonIncentives;
+
 // load env data with dotenv
 readEnvFile(__DIR__);
 
@@ -17,8 +72,9 @@ print "<h1>Amazon Gift Card Incentives</h1><br>";
 // aws key: AWS_GIFT_CARD_KEY
 // aws secret: AWS_GIFT_CARD_SECRET
 // partner id: AWS_GIFT_CARD_PARTNER_ID
-// optional
 // currency: AWS_ICENTIVE_CURRENCY
+// optional
+// debug: AWS_DEBUG (if not set: off)
 
 // as in .env
 // AWS_GIFT_CARD_ENDPOINT.TEST
@@ -35,34 +91,13 @@ foreach (
 	$_ENV[$key] = $_ENV[$key . '.' . strtoupper((LOCATION))] ?? $_ENV[$key] ?? '';
 }
 
-/*
-	ENDPOINTS:
-
-- remove '-gamma' for non sandox
-WHERE			URL										REGION
-North America	https://agcod-v2-gamma.amazon.com		us-east-1
-				https://agcod-v2.amazon.com
-(US, CA, MX)
-Europe and Asia	https://agcod-v2-eu-gamma.amazon.com	eu-west-1
-				https://agcod-v2-eu.amazon.com
-(IT, ES, DE, FR, UK, TR, UAE, KSA, PL, NL, SE)
-Far East		https://agcod-v2-fe-gamma.amazon.com	us-west-2
-				https://agcod-v2-fe.amazon.com
-(JP, AU, SG)
-
-CURRENCY
-USD for US
-EUR for EU
-JPY for JP
-CAD for CA
-AUD for AU
-TRY for TR
-AED for UAE
-
-*/
+// open debug file output
+$fp = fopen('log/debug.' . date('YmdHis') . '.log', 'w');
 
+// run info test (prints ENV vars)
+$run_info_test = false;
 // run test to get funds info
-$run_fund_test = false;
+$run_fund_test = true;
 // run the normal get/cancel gift card tests
 $run_gift_tests = true;
 // run mock error check tests
@@ -77,29 +112,31 @@ $mock_debug = false;
 // wait in seconds between mock tests
 $mock_wait = 2;
 
-$aws = new Amazon\AmazonIncentives();
-// $aws->createGiftCard(100);
-print "checkMe: <pre>" . print_r($aws->checkMe(), true) . "</pre>";
-print "<hr>";
-
-
-// we should open log file to collect all creationRequestId/gcId
-// so we can test and cancel
+if ($run_info_test === true) {
+	$aws = new AmazonIncentives();
+	print "checkMe: <pre>" . print_r($aws->checkMe(), true) . "</pre>";
+	fwrite($fp, writeLog($aws->checkMe()));
+	print "<hr>";
+}
 
 // check balance
 if ($run_fund_test === true) {
 	try {
-		$aws_test = Amazon\AmazonIncentives::make()->getAvailableFunds();
-		print "AWS: getAvailableFunds: <pre>" . print_r($aws_test, true) . "</pre><br>";
-	} catch (Exception $e) {
-		print "AWS: getAvailableFunds: " . $error['status']
-			. " [" . $e->getCode() . "]: "
-			. $error['code'] . " | " . $error['type']
-			. " | " . $error['message'] . ": ";
+		$aws_test = AmazonIncentives::make()->getAvailableFunds();
+		print "AWS: getAvailableFunds: " .  $aws_test->getStatus() . ": "
+			. "Amount: " . $aws_test->getAmount() . ", "
+			. "Currency: " . $aws_test->getCurrency() . ", "
+			. "Timestamp: " . $aws_test->getTimestamp();
 		if ($debug_print === true) {
-			print "/<pre>" . print_r($error['log'][$error['log_id'] ?? ''] ?? [], true) . "</pre>";
+			print "<pre>" . print_r($aws_test, true) . "</pre>";
 		}
+		fwrite($fp, writeLog((array)$aws_test));
+	} catch (Exception $e) {
+		$error = AmazonIncentives::decodeExceptionMessage($e->getMessage());
+		printException('getAvailableFunds', $e->getCode(), $error, $debug_print);
+		fwrite($fp, writeLog($error));
 	};
+	print "<br>";
 	sleep($debug_wait);
 	// print "LOG: <pre>" . print_r($aws_test->getLog(), true) . "</pre><br>";
 	print "<hr>";
@@ -108,51 +145,97 @@ if ($run_fund_test === true) {
 if ($run_gift_tests === true) {
 	// create card
 	$value = 1000;
-	// we must be sure we pass FLOAT there
-	$aws_test = Amazon\AmazonIncentives::make()->buyGiftCard((float)$value);
-	$creation_request_id = $aws_test->getCreationRequestId();
-	$gift_card_id = $aws_test->getId();
-	$claim_code = $aws_test->getClaimCode();
-	$request_status = $aws_test->getStatus();
-	print "AWS: buyGiftCard: " . $request_status . ": "
-		. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id . ", "
-		. "CLAIM CODE: <b>" . $claim_code . "</b><br>";
-	if ($debug_print === true) {
-		print "<pre>" . print_r($aws_test, true) . "</pre><br>";
+	$creation_request_id = '';
+	$gift_card_id = '';
+	try {
+		// we must be sure we pass FLOAT there
+		$aws_test = AmazonIncentives::make()->buyGiftCard((float)$value);
+		$creation_request_id = $aws_test->getCreationRequestId();
+		$gift_card_id = $aws_test->getId();
+		$claim_code = $aws_test->getClaimCode();
+		$expiration_date = $aws_test->getExpirationDate();
+		$request_status = $aws_test->getStatus();
+		print "AWS: buyGiftCard: " . $request_status . ": "
+			. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id . ", "
+			. "EXPIRE DATE: <b>" . dateTr($expiration_date) . "</b>, "
+			. "CLAIM CODE: <b>" . $claim_code . "</b>";
+		if ($debug_print === true) {
+			print "<pre>" . print_r($aws_test, true) . "</pre>";
+		}
+		fwrite($fp, writeLog((array)$aws_test));
+	} catch (\Exception $e) {
+		$error = AmazonIncentives::decodeExceptionMessage($e->getMessage());
+		printException('buyGiftCard', $e->getCode(), $error, $debug_print);
+		fwrite($fp, writeLog($error));
 	}
+	print "<br>";
 	sleep($debug_wait);
-	// cancel above created card card
-	$aws_test = Amazon\AmazonIncentives::make()->cancelGiftCard($creation_request_id, $gift_card_id);
-	$request_status = $aws_test->getStatus();
-	print "AWS: cancelGiftCard: " . $request_status . ": "
-		. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id
-		. "<br>";
-	if ($debug_print === true) {
-		print "<pre>" . print_r($aws_test, true) . "</pre><br>";
+	try {
+		// cancel above created card card
+		$aws_test = AmazonIncentives::make()->cancelGiftCard($creation_request_id, $gift_card_id);
+		$request_status = $aws_test->getStatus();
+		print "AWS: cancelGiftCard: " . $request_status . ": "
+			. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id;
+		if ($debug_print === true) {
+			print "<pre>" . print_r($aws_test, true) . "</pre>";
+		}
+		fwrite($fp, writeLog((array)$aws_test));
+	} catch (\Exception $e) {
+		$error = AmazonIncentives::decodeExceptionMessage($e->getMessage());
+		print "AWS: cancelGiftCard: " . $error['status']
+			. " [" . $e->getCode() . "]: "
+			. $error['code'] . " | " . $error['type']
+			. " | " . $error['message'];
+		if ($debug_print === true) {
+			print "<pre>" . print_r($error['log'][$error['log_id'] ?? ''] ?? [], true) . "</pre>";
+		}
+		fwrite($fp, writeLog($error));
 	}
+	print "<br>";
 	sleep($debug_wait);
 
 	// set same request ID twice to get same response test
-	$aws_test = Amazon\AmazonIncentives::make()->buyGiftCard((float)$value);
-	$creation_request_id = $aws_test->getCreationRequestId();
-	$gift_card_id = $aws_test->getId();
-	$claim_code = $aws_test->getClaimCode();
-	$request_status = $aws_test->getStatus();
-	print "AWS: buyGiftCard: CODE A: " . $request_status . ": "
-		. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id . ", "
-		. "CLAIM CODE: <b>" . $claim_code . "</b><br>";
-	if ($debug_print === true) {
-		print "<pre>" . print_r($aws_test, true) . "</pre><br>";
+	try {
+		$aws_test = AmazonIncentives::make()->buyGiftCard((float)$value);
+		$creation_request_id = $aws_test->getCreationRequestId();
+		$gift_card_id = $aws_test->getId();
+		$claim_code = $aws_test->getClaimCode();
+		$expiration_date = $aws_test->getExpirationDate();
+		$request_status = $aws_test->getStatus();
+		print "AWS: buyGiftCard: CODE A: " . $request_status . ": "
+			. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id . ", "
+			. "EXPIRE DATE: <b>" . dateTr($expiration_date) . "</b>, "
+			. "CLAIM CODE: <b>" . $claim_code . "</b>";
+		if ($debug_print === true) {
+			print "<pre>" . print_r($aws_test, true) . "</pre>";
+		}
+		fwrite($fp, writeLog((array)$aws_test));
+	} catch (\Exception $e) {
+		$error = AmazonIncentives::decodeExceptionMessage($e->getMessage());
+		printException('cancelGiftCard', $e->getCode(), $error, $debug_print);
+		fwrite($fp, writeLog($error));
 	}
+	print "<br>";
 	sleep($debug_wait);
-	$aws_test = Amazon\AmazonIncentives::make()->buyGiftCard((float)$value, $creation_request_id);
-	$request_status = $aws_test->getStatus();
-	print "AWS: buyGiftCard: SAME CODE A AGAIN: " . $request_status . ": "
-		. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id . ", "
-		. "CLAIM CODE: <b>" . $claim_code . "</b><br>";
-	if ($debug_print === true) {
-		print "<pre>" . print_r($aws_test, true) . "</pre><br>";
+	try {
+		$aws_test = AmazonIncentives::make()->buyGiftCard((float)$value, $creation_request_id);
+		$request_status = $aws_test->getStatus();
+		// same?
+		$expiration_date = $aws_test->getExpirationDate();
+		print "AWS: buyGiftCard: SAME CODE A AGAIN: " . $request_status . ": "
+			. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id . ", "
+			. "EXPIRE DATE: <b>" . dateTr($expiration_date) . "</b>, "
+			. "CLAIM CODE: <b>" . $claim_code . "</b>";
+		if ($debug_print === true) {
+			print "<pre>" . print_r($aws_test, true) . "</pre>";
+		}
+		fwrite($fp, writeLog((array)$aws_test));
+	} catch (\Exception $e) {
+		$error = AmazonIncentives::decodeExceptionMessage($e->getMessage());
+		printException('buyGiftCard', $e->getCode(), $error, $debug_print);
+		fwrite($fp, writeLog($error));
 	}
+	print "<br>";
 	print "<hr>";
 	sleep($debug_wait);
 }
@@ -164,6 +247,7 @@ if ($mock_debug === true) {
 	$mock_value = 500;
 
 	$mock['F0000'] = [ 'ret' => '', 'st' => 'SUCCESS']; // success mock
+	$mock['F1000'] = [ 'ret' => 'F100', 'st' => 'FAILURE']; // SimpleAmountIsNull, etc
 	$mock['F2003'] = [ 'ret' => 'F200', 'st' => 'FAILURE']; // InvalidAmountInput
 	$mock['F2004'] = [ 'ret' => 'F200', 'st' => 'FAILURE']; // InvalidAmountValue
 	$mock['F2005'] = [ 'ret' => 'F200', 'st' => 'FAILURE']; // InvalidCurrencyCodeInput
@@ -181,12 +265,12 @@ if ($mock_debug === true) {
 	foreach ($mock as $creation_id => $mock_return) {
 		print "<b>TS: " . microtime() . "</b>: ";
 		try {
-			$aws_test = Amazon\AmazonIncentives::make()->buyGiftCard((float)$mock_value, $creation_id);
+			$aws_test = AmazonIncentives::make()->buyGiftCard((float)$mock_value, $creation_id);
 			$creation_request_id = $aws_test->getCreationRequestId();
 			$gift_card_id = $aws_test->getId();
 			$claim_code = $aws_test->getClaimCode();
 			$request_status = $aws_test->getStatus();
-			print "AWS: MOCK: " . $creation_id . ": buyGiftCard: " . $request_status . ": "
+			print "AWS: MOCK: " . $creation_id . ": buyGiftCard: <b>" . $request_status . "</b>: "
 				. "creationRequestId: " . $creation_request_id . ", gcId: " . $gift_card_id . ", "
 				. "CLAIM CODE: <b>" . $claim_code . "</b>: ";
 			if ($mock_return['st'] == $request_status) {
@@ -197,8 +281,9 @@ if ($mock_debug === true) {
 			if ($mock_debug === true) {
 				print "<pre>" . print_r($aws_test, true) . "</pre>";
 			}
+			fwrite($fp, writeLog((array)$aws_test));
 		} catch (Exception $e) {
-			$error = Amazon\AmazonIncentives::decodeExceptionMessage($e->getMessage());
+			$error = AmazonIncentives::decodeExceptionMessage($e->getMessage());
 			print "AWS: MOCK: " . $creation_id . ": buyGiftCard: " . $error['status']
 				. " [" . $e->getCode() . "]: "
 				. $error['code'] . " | " . $error['type']
@@ -212,8 +297,9 @@ if ($mock_debug === true) {
 				print $mock_failure;
 			}
 			if ($mock_debug === true) {
-				print "/<pre>" . print_r($error['log'][$error['log_id'] ?? ''] ?? [], true) . "</pre>";
+				print "<pre>" . print_r($error['log'][$error['log_id'] ?? ''] ?? [], true) . "</pre>";
 			}
+			fwrite($fp, writeLog($error));
 		}
 		print "<br>";
 		// Waiting a moment, so we don't flood
@@ -222,4 +308,6 @@ if ($mock_debug === true) {
 	print "<hr>";
 }
 
+fclose($fp);
+
 // __END__

test/log/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

vendor/autoload.php

@@ -0,0 +1,7 @@
+<?php
+
+// autoload.php @generated by Composer
+
+require_once __DIR__ . '/composer/autoload_real.php';
+
+return ComposerAutoloaderInit0c8f6bec90a6d60040a922f19a1f0e64::getLoader();

vendor/composer/ClassLoader.php

@@ -0,0 +1,572 @@
+<?php
+
+/*
+ * This file is part of Composer.
+ *
+ * (c) Nils Adermann <naderman@naderman.de>
+ *     Jordi Boggiano <j.boggiano@seld.be>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Composer\Autoload;
+
+/**
+ * ClassLoader implements a PSR-0, PSR-4 and classmap class loader.
+ *
+ *     $loader = new \Composer\Autoload\ClassLoader();
+ *
+ *     // register classes with namespaces
+ *     $loader->add('Symfony\Component', __DIR__.'/component');
+ *     $loader->add('Symfony',           __DIR__.'/framework');
+ *
+ *     // activate the autoloader
+ *     $loader->register();
+ *
+ *     // to enable searching the include path (eg. for PEAR packages)
+ *     $loader->setUseIncludePath(true);
+ *
+ * In this example, if you try to use a class in the Symfony\Component
+ * namespace or one of its children (Symfony\Component\Console for instance),
+ * the autoloader will first look for the class under the component/
+ * directory, and it will then fallback to the framework/ directory if not
+ * found before giving up.
+ *
+ * This class is loosely based on the Symfony UniversalClassLoader.
+ *
+ * @author Fabien Potencier <fabien@symfony.com>
+ * @author Jordi Boggiano <j.boggiano@seld.be>
+ * @see    https://www.php-fig.org/psr/psr-0/
+ * @see    https://www.php-fig.org/psr/psr-4/
+ */
+class ClassLoader
+{
+    /** @var ?string */
+    private $vendorDir;
+
+    // PSR-4
+    /**
+     * @var array[]
+     * @psalm-var array<string, array<string, int>>
+     */
+    private $prefixLengthsPsr4 = array();
+    /**
+     * @var array[]
+     * @psalm-var array<string, array<int, string>>
+     */
+    private $prefixDirsPsr4 = array();
+    /**
+     * @var array[]
+     * @psalm-var array<string, string>
+     */
+    private $fallbackDirsPsr4 = array();
+
+    // PSR-0
+    /**
+     * @var array[]
+     * @psalm-var array<string, array<string, string[]>>
+     */
+    private $prefixesPsr0 = array();
+    /**
+     * @var array[]
+     * @psalm-var array<string, string>
+     */
+    private $fallbackDirsPsr0 = array();
+
+    /** @var bool */
+    private $useIncludePath = false;
+
+    /**
+     * @var string[]
+     * @psalm-var array<string, string>
+     */
+    private $classMap = array();
+
+    /** @var bool */
+    private $classMapAuthoritative = false;
+
+    /**
+     * @var bool[]
+     * @psalm-var array<string, bool>
+     */
+    private $missingClasses = array();
+
+    /** @var ?string */
+    private $apcuPrefix;
+
+    /**
+     * @var self[]
+     */
+    private static $registeredLoaders = array();
+
+    /**
+     * @param ?string $vendorDir
+     */
+    public function __construct($vendorDir = null)
+    {
+        $this->vendorDir = $vendorDir;
+    }
+
+    /**
+     * @return string[]
+     */
+    public function getPrefixes()
+    {
+        if (!empty($this->prefixesPsr0)) {
+            return call_user_func_array('array_merge', array_values($this->prefixesPsr0));
+        }
+
+        return array();
+    }
+
+    /**
+     * @return array[]
+     * @psalm-return array<string, array<int, string>>
+     */
+    public function getPrefixesPsr4()
+    {
+        return $this->prefixDirsPsr4;
+    }
+
+    /**
+     * @return array[]
+     * @psalm-return array<string, string>
+     */
+    public function getFallbackDirs()
+    {
+        return $this->fallbackDirsPsr0;
+    }
+
+    /**
+     * @return array[]
+     * @psalm-return array<string, string>
+     */
+    public function getFallbackDirsPsr4()
+    {
+        return $this->fallbackDirsPsr4;
+    }
+
+    /**
+     * @return string[] Array of classname => path
+     * @psalm-var array<string, string>
+     */
+    public function getClassMap()
+    {
+        return $this->classMap;
+    }
+
+    /**
+     * @param string[] $classMap Class to filename map
+     * @psalm-param array<string, string> $classMap
+     *
+     * @return void
+     */
+    public function addClassMap(array $classMap)
+    {
+        if ($this->classMap) {
+            $this->classMap = array_merge($this->classMap, $classMap);
+        } else {
+            $this->classMap = $classMap;
+        }
+    }
+
+    /**
+     * Registers a set of PSR-0 directories for a given prefix, either
+     * appending or prepending to the ones previously set for this prefix.
+     *
+     * @param string          $prefix  The prefix
+     * @param string[]|string $paths   The PSR-0 root directories
+     * @param bool            $prepend Whether to prepend the directories
+     *
+     * @return void
+     */
+    public function add($prefix, $paths, $prepend = false)
+    {
+        if (!$prefix) {
+            if ($prepend) {
+                $this->fallbackDirsPsr0 = array_merge(
+                    (array) $paths,
+                    $this->fallbackDirsPsr0
+                );
+            } else {
+                $this->fallbackDirsPsr0 = array_merge(
+                    $this->fallbackDirsPsr0,
+                    (array) $paths
+                );
+            }
+
+            return;
+        }
+
+        $first = $prefix[0];
+        if (!isset($this->prefixesPsr0[$first][$prefix])) {
+            $this->prefixesPsr0[$first][$prefix] = (array) $paths;
+
+            return;
+        }
+        if ($prepend) {
+            $this->prefixesPsr0[$first][$prefix] = array_merge(
+                (array) $paths,
+                $this->prefixesPsr0[$first][$prefix]
+            );
+        } else {
+            $this->prefixesPsr0[$first][$prefix] = array_merge(
+                $this->prefixesPsr0[$first][$prefix],
+                (array) $paths
+            );
+        }
+    }
+
+    /**
+     * Registers a set of PSR-4 directories for a given namespace, either
+     * appending or prepending to the ones previously set for this namespace.
+     *
+     * @param string          $prefix  The prefix/namespace, with trailing '\\'
+     * @param string[]|string $paths   The PSR-4 base directories
+     * @param bool            $prepend Whether to prepend the directories
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return void
+     */
+    public function addPsr4($prefix, $paths, $prepend = false)
+    {
+        if (!$prefix) {
+            // Register directories for the root namespace.
+            if ($prepend) {
+                $this->fallbackDirsPsr4 = array_merge(
+                    (array) $paths,
+                    $this->fallbackDirsPsr4
+                );
+            } else {
+                $this->fallbackDirsPsr4 = array_merge(
+                    $this->fallbackDirsPsr4,
+                    (array) $paths
+                );
+            }
+        } elseif (!isset($this->prefixDirsPsr4[$prefix])) {
+            // Register directories for a new namespace.
+            $length = strlen($prefix);
+            if ('\\' !== $prefix[$length - 1]) {
+                throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
+            }
+            $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
+            $this->prefixDirsPsr4[$prefix] = (array) $paths;
+        } elseif ($prepend) {
+            // Prepend directories for an already registered namespace.
+            $this->prefixDirsPsr4[$prefix] = array_merge(
+                (array) $paths,
+                $this->prefixDirsPsr4[$prefix]
+            );
+        } else {
+            // Append directories for an already registered namespace.
+            $this->prefixDirsPsr4[$prefix] = array_merge(
+                $this->prefixDirsPsr4[$prefix],
+                (array) $paths
+            );
+        }
+    }
+
+    /**
+     * Registers a set of PSR-0 directories for a given prefix,
+     * replacing any others previously set for this prefix.
+     *
+     * @param string          $prefix The prefix
+     * @param string[]|string $paths  The PSR-0 base directories
+     *
+     * @return void
+     */
+    public function set($prefix, $paths)
+    {
+        if (!$prefix) {
+            $this->fallbackDirsPsr0 = (array) $paths;
+        } else {
+            $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths;
+        }
+    }
+
+    /**
+     * Registers a set of PSR-4 directories for a given namespace,
+     * replacing any others previously set for this namespace.
+     *
+     * @param string          $prefix The prefix/namespace, with trailing '\\'
+     * @param string[]|string $paths  The PSR-4 base directories
+     *
+     * @throws \InvalidArgumentException
+     *
+     * @return void
+     */
+    public function setPsr4($prefix, $paths)
+    {
+        if (!$prefix) {
+            $this->fallbackDirsPsr4 = (array) $paths;
+        } else {
+            $length = strlen($prefix);
+            if ('\\' !== $prefix[$length - 1]) {
+                throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
+            }
+            $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
+            $this->prefixDirsPsr4[$prefix] = (array) $paths;
+        }
+    }
+
+    /**
+     * Turns on searching the include path for class files.
+     *
+     * @param bool $useIncludePath
+     *
+     * @return void
+     */
+    public function setUseIncludePath($useIncludePath)
+    {
+        $this->useIncludePath = $useIncludePath;
+    }
+
+    /**
+     * Can be used to check if the autoloader uses the include path to check
+     * for classes.
+     *
+     * @return bool
+     */
+    public function getUseIncludePath()
+    {
+        return $this->useIncludePath;
+    }
+
+    /**
+     * Turns off searching the prefix and fallback directories for classes
+     * that have not been registered with the class map.
+     *
+     * @param bool $classMapAuthoritative
+     *
+     * @return void
+     */
+    public function setClassMapAuthoritative($classMapAuthoritative)
+    {
+        $this->classMapAuthoritative = $classMapAuthoritative;
+    }
+
+    /**
+     * Should class lookup fail if not found in the current class map?
+     *
+     * @return bool
+     */
+    public function isClassMapAuthoritative()
+    {
+        return $this->classMapAuthoritative;
+    }
+
+    /**
+     * APCu prefix to use to cache found/not-found classes, if the extension is enabled.
+     *
+     * @param string|null $apcuPrefix
+     *
+     * @return void
+     */
+    public function setApcuPrefix($apcuPrefix)
+    {
+        $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null;
+    }
+
+    /**
+     * The APCu prefix in use, or null if APCu caching is not enabled.
+     *
+     * @return string|null
+     */
+    public function getApcuPrefix()
+    {
+        return $this->apcuPrefix;
+    }
+
+    /**
+     * Registers this instance as an autoloader.
+     *
+     * @param bool $prepend Whether to prepend the autoloader or not
+     *
+     * @return void
+     */
+    public function register($prepend = false)
+    {
+        spl_autoload_register(array($this, 'loadClass'), true, $prepend);
+
+        if (null === $this->vendorDir) {
+            return;
+        }
+
+        if ($prepend) {
+            self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders;
+        } else {
+            unset(self::$registeredLoaders[$this->vendorDir]);
+            self::$registeredLoaders[$this->vendorDir] = $this;
+        }
+    }
+
+    /**
+     * Unregisters this instance as an autoloader.
+     *
+     * @return void
+     */
+    public function unregister()
+    {
+        spl_autoload_unregister(array($this, 'loadClass'));
+
+        if (null !== $this->vendorDir) {
+            unset(self::$registeredLoaders[$this->vendorDir]);
+        }
+    }
+
+    /**
+     * Loads the given class or interface.
+     *
+     * @param  string    $class The name of the class
+     * @return true|null True if loaded, null otherwise
+     */
+    public function loadClass($class)
+    {
+        if ($file = $this->findFile($class)) {
+            includeFile($file);
+
+            return true;
+        }
+
+        return null;
+    }
+
+    /**
+     * Finds the path to the file where the class is defined.
+     *
+     * @param string $class The name of the class
+     *
+     * @return string|false The path if found, false otherwise
+     */
+    public function findFile($class)
+    {
+        // class map lookup
+        if (isset($this->classMap[$class])) {
+            return $this->classMap[$class];
+        }
+        if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) {
+            return false;
+        }
+        if (null !== $this->apcuPrefix) {
+            $file = apcu_fetch($this->apcuPrefix.$class, $hit);
+            if ($hit) {
+                return $file;
+            }
+        }
+
+        $file = $this->findFileWithExtension($class, '.php');
+
+        // Search for Hack files if we are running on HHVM
+        if (false === $file && defined('HHVM_VERSION')) {
+            $file = $this->findFileWithExtension($class, '.hh');
+        }
+
+        if (null !== $this->apcuPrefix) {
+            apcu_add($this->apcuPrefix.$class, $file);
+        }
+
+        if (false === $file) {
+            // Remember that this class does not exist.
+            $this->missingClasses[$class] = true;
+        }
+
+        return $file;
+    }
+
+    /**
+     * Returns the currently registered loaders indexed by their corresponding vendor directories.
+     *
+     * @return self[]
+     */
+    public static function getRegisteredLoaders()
+    {
+        return self::$registeredLoaders;
+    }
+
+    /**
+     * @param  string       $class
+     * @param  string       $ext
+     * @return string|false
+     */
+    private function findFileWithExtension($class, $ext)
+    {
+        // PSR-4 lookup
+        $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
+
+        $first = $class[0];
+        if (isset($this->prefixLengthsPsr4[$first])) {
+            $subPath = $class;
+            while (false !== $lastPos = strrpos($subPath, '\\')) {
+                $subPath = substr($subPath, 0, $lastPos);
+                $search = $subPath . '\\';
+                if (isset($this->prefixDirsPsr4[$search])) {
+                    $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
+                    foreach ($this->prefixDirsPsr4[$search] as $dir) {
+                        if (file_exists($file = $dir . $pathEnd)) {
+                            return $file;
+                        }
+                    }
+                }
+            }
+        }
+
+        // PSR-4 fallback dirs
+        foreach ($this->fallbackDirsPsr4 as $dir) {
+            if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
+                return $file;
+            }
+        }
+
+        // PSR-0 lookup
+        if (false !== $pos = strrpos($class, '\\')) {
+            // namespaced class name
+            $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
+                . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
+        } else {
+            // PEAR-like class name
+            $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
+        }
+
+        if (isset($this->prefixesPsr0[$first])) {
+            foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
+                if (0 === strpos($class, $prefix)) {
+                    foreach ($dirs as $dir) {
+                        if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+                            return $file;
+                        }
+                    }
+                }
+            }
+        }
+
+        // PSR-0 fallback dirs
+        foreach ($this->fallbackDirsPsr0 as $dir) {
+            if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+                return $file;
+            }
+        }
+
+        // PSR-0 include paths.
+        if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
+            return $file;
+        }
+
+        return false;
+    }
+}
+
+/**
+ * Scope isolated include.
+ *
+ * Prevents access to $this/self from included files.
+ *
+ * @param  string $file
+ * @return void
+ * @private
+ */
+function includeFile($file)
+{
+    include $file;
+}

vendor/composer/LICENSE

@@ -0,0 +1,21 @@
+
+Copyright (c) Nils Adermann, Jordi Boggiano
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

vendor/composer/autoload_classmap.php

@@ -0,0 +1,10 @@
+<?php
+
+// autoload_classmap.php @generated by Composer
+
+$vendorDir = dirname(dirname(__FILE__));
+$baseDir = dirname($vendorDir);
+
+return array(
+    'Composer\\InstalledVersions' => $vendorDir . '/composer/InstalledVersions.php',
+);

vendor/composer/autoload_namespaces.php

@@ -0,0 +1,9 @@
+<?php
+
+// autoload_namespaces.php @generated by Composer
+
+$vendorDir = dirname(dirname(__FILE__));
+$baseDir = dirname($vendorDir);
+
+return array(
+);

vendor/composer/autoload_psr4.php

@@ -0,0 +1,10 @@
+<?php
+
+// autoload_psr4.php @generated by Composer
+
+$vendorDir = dirname(dirname(__FILE__));
+$baseDir = dirname($vendorDir);
+
+return array(
+    'gullevek\\AmazonIncentives\\' => array($baseDir . '/src'),
+);

vendor/composer/autoload_real.php

@@ -0,0 +1,55 @@
+<?php
+
+// autoload_real.php @generated by Composer
+
+class ComposerAutoloaderInit0c8f6bec90a6d60040a922f19a1f0e64
+{
+    private static $loader;
+
+    public static function loadClassLoader($class)
+    {
+        if ('Composer\Autoload\ClassLoader' === $class) {
+            require __DIR__ . '/ClassLoader.php';
+        }
+    }
+
+    /**
+     * @return \Composer\Autoload\ClassLoader
+     */
+    public static function getLoader()
+    {
+        if (null !== self::$loader) {
+            return self::$loader;
+        }
+
+        spl_autoload_register(array('ComposerAutoloaderInit0c8f6bec90a6d60040a922f19a1f0e64', 'loadClassLoader'), true, true);
+        self::$loader = $loader = new \Composer\Autoload\ClassLoader(\dirname(\dirname(__FILE__)));
+        spl_autoload_unregister(array('ComposerAutoloaderInit0c8f6bec90a6d60040a922f19a1f0e64', 'loadClassLoader'));
+
+        $useStaticLoader = PHP_VERSION_ID >= 50600 && !defined('HHVM_VERSION') && (!function_exists('zend_loader_file_encoded') || !zend_loader_file_encoded());
+        if ($useStaticLoader) {
+            require __DIR__ . '/autoload_static.php';
+
+            call_user_func(\Composer\Autoload\ComposerStaticInit0c8f6bec90a6d60040a922f19a1f0e64::getInitializer($loader));
+        } else {
+            $map = require __DIR__ . '/autoload_namespaces.php';
+            foreach ($map as $namespace => $path) {
+                $loader->set($namespace, $path);
+            }
+
+            $map = require __DIR__ . '/autoload_psr4.php';
+            foreach ($map as $namespace => $path) {
+                $loader->setPsr4($namespace, $path);
+            }
+
+            $classMap = require __DIR__ . '/autoload_classmap.php';
+            if ($classMap) {
+                $loader->addClassMap($classMap);
+            }
+        }
+
+        $loader->register(true);
+
+        return $loader;
+    }
+}

vendor/composer/autoload_static.php

@@ -0,0 +1,36 @@
+<?php
+
+// autoload_static.php @generated by Composer
+
+namespace Composer\Autoload;
+
+class ComposerStaticInit0c8f6bec90a6d60040a922f19a1f0e64
+{
+    public static $prefixLengthsPsr4 = array (
+        'G' => 
+        array (
+            'gullevek\\AmazonIncentives\\' => 26,
+        ),
+    );
+
+    public static $prefixDirsPsr4 = array (
+        'gullevek\\AmazonIncentives\\' => 
+        array (
+            0 => __DIR__ . '/../..' . '/src',
+        ),
+    );
+
+    public static $classMap = array (
+        'Composer\\InstalledVersions' => __DIR__ . '/..' . '/composer/InstalledVersions.php',
+    );
+
+    public static function getInitializer(ClassLoader $loader)
+    {
+        return \Closure::bind(function () use ($loader) {
+            $loader->prefixLengthsPsr4 = ComposerStaticInit0c8f6bec90a6d60040a922f19a1f0e64::$prefixLengthsPsr4;
+            $loader->prefixDirsPsr4 = ComposerStaticInit0c8f6bec90a6d60040a922f19a1f0e64::$prefixDirsPsr4;
+            $loader->classMap = ComposerStaticInit0c8f6bec90a6d60040a922f19a1f0e64::$classMap;
+
+        }, null, ClassLoader::class);
+    }
+}