feat: generate enum constants

KristofersOzolinsMagebit · KristofersOzolinsMagebit · commit 3468f46f54e2 · 2026-01-19T18:19:38.000+02:00
diff --git a/generated/Magebit/UcpSpec/Discovery/UCPDiscoveryProfileSigningKeysItem.php b/generated/Magebit/UcpSpec/Discovery/UCPDiscoveryProfileSigningKeysItem.php
@@ -14,6 +14,9 @@
 
 interface UCPDiscoveryProfileSigningKeysItem
 {
+    public const USE_SIG = 'sig';
+    public const USE_ENC = 'enc';
+
     /**
      * Key ID. Referenced in signature headers to identify which key to use for verification.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Ap2MandateCheckoutResponseWithAp2.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Ap2MandateCheckoutResponseWithAp2.php
@@ -27,6 +27,13 @@
  */
 interface Ap2MandateCheckoutResponseWithAp2
 {
+    public const STATUS_INCOMPLETE = 'incomplete';
+    public const STATUS_REQUIRES_ESCALATION = 'requires_escalation';
+    public const STATUS_READY_FOR_COMPLETE = 'ready_for_complete';
+    public const STATUS_COMPLETE_IN_PROGRESS = 'complete_in_progress';
+    public const STATUS_COMPLETED = 'completed';
+    public const STATUS_CANCELED = 'canceled';
+
     /**
      * @return UcpResponseCheckout
      */
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/CheckoutResponse.php b/generated/Magebit/UcpSpec/Schemas/Shopping/CheckoutResponse.php
@@ -27,6 +27,13 @@
  */
 interface CheckoutResponse
 {
+    public const STATUS_INCOMPLETE = 'incomplete';
+    public const STATUS_REQUIRES_ESCALATION = 'requires_escalation';
+    public const STATUS_READY_FOR_COMPLETE = 'ready_for_complete';
+    public const STATUS_COMPLETE_IN_PROGRESS = 'complete_in_progress';
+    public const STATUS_COMPLETED = 'completed';
+    public const STATUS_CANCELED = 'canceled';
+
     /**
      * @return UcpResponseCheckout
      */
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/DiscountAppliedDiscount.php b/generated/Magebit/UcpSpec/Schemas/Shopping/DiscountAppliedDiscount.php
@@ -17,6 +17,9 @@
  */
 interface DiscountAppliedDiscount
 {
+    public const METHOD_EACH = 'each';
+    public const METHOD_ACROSS = 'across';
+
     /**
      * The discount code. Omitted for automatic discounts.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/DiscountCheckout.php b/generated/Magebit/UcpSpec/Schemas/Shopping/DiscountCheckout.php
@@ -27,6 +27,13 @@
  */
 interface DiscountCheckout
 {
+    public const STATUS_INCOMPLETE = 'incomplete';
+    public const STATUS_REQUIRES_ESCALATION = 'requires_escalation';
+    public const STATUS_READY_FOR_COMPLETE = 'ready_for_complete';
+    public const STATUS_COMPLETE_IN_PROGRESS = 'complete_in_progress';
+    public const STATUS_COMPLETED = 'completed';
+    public const STATUS_CANCELED = 'canceled';
+
     /**
      * @return UcpResponseCheckout
      */
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/Adjustment.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/Adjustment.php
@@ -17,6 +17,10 @@
  */
 interface Adjustment
 {
+    public const STATUS_PENDING = 'pending';
+    public const STATUS_COMPLETED = 'completed';
+    public const STATUS_FAILED = 'failed';
+
     /**
      * Adjustment event identifier.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/CardCredential.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/CardCredential.php
@@ -19,6 +19,10 @@
  */
 interface CardCredential
 {
+    public const CARD_NUMBER_TYPE_FPAN = 'fpan';
+    public const CARD_NUMBER_TYPE_NETWORK_TOKEN = 'network_token';
+    public const CARD_NUMBER_TYPE_DPAN = 'dpan';
+
     /**
      * The credential type identifier for card credentials.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/Expectation.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/Expectation.php
@@ -17,6 +17,10 @@
  */
 interface Expectation
 {
+    public const METHOD_TYPE_SHIPPING = 'shipping';
+    public const METHOD_TYPE_PICKUP = 'pickup';
+    public const METHOD_TYPE_DIGITAL = 'digital';
+
     /**
      * Expectation identifier.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/FulfillmentAvailableMethodResponse.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/FulfillmentAvailableMethodResponse.php
@@ -19,6 +19,9 @@
  */
 interface FulfillmentAvailableMethodResponse
 {
+    public const TYPE_SHIPPING = 'shipping';
+    public const TYPE_PICKUP = 'pickup';
+
     /**
      * Fulfillment method type this availability applies to.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/FulfillmentMethodCreateRequest.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/FulfillmentMethodCreateRequest.php
@@ -19,6 +19,9 @@
  */
 interface FulfillmentMethodCreateRequest
 {
+    public const TYPE_SHIPPING = 'shipping';
+    public const TYPE_PICKUP = 'pickup';
+
     /**
      * Fulfillment method type.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/FulfillmentMethodResponse.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/FulfillmentMethodResponse.php
@@ -19,6 +19,9 @@
  */
 interface FulfillmentMethodResponse
 {
+    public const TYPE_SHIPPING = 'shipping';
+    public const TYPE_PICKUP = 'pickup';
+
     /**
      * Unique fulfillment method identifier.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/Message.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/Message.php
@@ -17,6 +17,12 @@
  */
 interface Message
 {
+    public const CONTENT_TYPE_PLAIN = 'plain';
+    public const CONTENT_TYPE_MARKDOWN = 'markdown';
+    public const SEVERITY_RECOVERABLE = 'recoverable';
+    public const SEVERITY_REQUIRES_BUYER_INPUT = 'requires_buyer_input';
+    public const SEVERITY_REQUIRES_BUYER_REVIEW = 'requires_buyer_review';
+
     /**
      * Message type discriminator.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/MessageError.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/MessageError.php
@@ -17,6 +17,12 @@
  */
 interface MessageError
 {
+    public const CONTENT_TYPE_PLAIN = 'plain';
+    public const CONTENT_TYPE_MARKDOWN = 'markdown';
+    public const SEVERITY_RECOVERABLE = 'recoverable';
+    public const SEVERITY_REQUIRES_BUYER_INPUT = 'requires_buyer_input';
+    public const SEVERITY_REQUIRES_BUYER_REVIEW = 'requires_buyer_review';
+
     /**
      * Message type discriminator.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/MessageInfo.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/MessageInfo.php
@@ -17,6 +17,9 @@
  */
 interface MessageInfo
 {
+    public const CONTENT_TYPE_PLAIN = 'plain';
+    public const CONTENT_TYPE_MARKDOWN = 'markdown';
+
     /**
      * Message type discriminator.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/MessageWarning.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/MessageWarning.php
@@ -17,6 +17,9 @@
  */
 interface MessageWarning
 {
+    public const CONTENT_TYPE_PLAIN = 'plain';
+    public const CONTENT_TYPE_MARKDOWN = 'markdown';
+
     /**
      * Message type discriminator.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/OrderLineItem.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/OrderLineItem.php
@@ -17,6 +17,10 @@
  */
 interface OrderLineItem
 {
+    public const STATUS_PROCESSING = 'processing';
+    public const STATUS_PARTIAL = 'partial';
+    public const STATUS_FULFILLED = 'fulfilled';
+
     /**
      * Line item identifier.
      *
diff --git a/generated/Magebit/UcpSpec/Schemas/Shopping/Types/TotalResponse.php b/generated/Magebit/UcpSpec/Schemas/Shopping/Types/TotalResponse.php
@@ -17,6 +17,14 @@
  */
 interface TotalResponse
 {
+    public const TYPE_ITEMS_DISCOUNT = 'items_discount';
+    public const TYPE_SUBTOTAL = 'subtotal';
+    public const TYPE_DISCOUNT = 'discount';
+    public const TYPE_FULFILLMENT = 'fulfillment';
+    public const TYPE_TAX = 'tax';
+    public const TYPE_FEE = 'fee';
+    public const TYPE_TOTAL = 'total';
+
     /**
      * Type of total categorization.
      *
diff --git a/src/InterfaceBuilder.php b/src/InterfaceBuilder.php
@@ -164,11 +164,64 @@ private function addProperties(
         $properties = $schema['properties'] ?? [];
         $required = $schema['required'] ?? [];
 
+        // First, add enum constants for all properties with enum values
+        foreach ($properties as $propertyName => $property) {
+            $this->addEnumConstants($interface, $propertyName, $property, $currentFile);
+        }
+
+        // Then add getter methods
         foreach ($properties as $propertyName => $property) {
             $this->addPropertyMethod($interface, $propertyName, $property, $required, $currentFile, $namespace);
         }
     }
 
+    /**
+     * Add enum constants for a property if it has enum values
+     *
+     * @param InterfaceType $interface Interface to add constants to
+     * @param string $propertyName Name of the property
+     * @param array $property Property schema definition
+     * @param string $currentFile Current file path for resolving references
+     * @return void
+     */
+    private function addEnumConstants(
+        InterfaceType $interface,
+        string $propertyName,
+        array $property,
+        string $currentFile
+    ): void {
+        // Resolve $ref if present
+        $resolvedProperty = $property;
+        if (isset($property['$ref'])) {
+            try {
+                $resolvedProperty = $this->parser->resolveRef($property['$ref'], $currentFile);
+            } catch (\Exception $e) {
+                // If resolution fails, use original property
+                return;
+            }
+        }
+
+        // Check if property has enum values
+        if (!isset($resolvedProperty['enum']) || !is_array($resolvedProperty['enum'])) {
+            return;
+        }
+
+        // Generate constant name prefix from property name
+        $prefix = strtoupper(preg_replace('/([a-z])([A-Z])/', '$1_$2', $propertyName));
+        $prefix = strtoupper(str_replace(['-', '.'], '_', $prefix));
+
+        // Add a constant for each enum value
+        foreach ($resolvedProperty['enum'] as $enumValue) {
+            // Generate constant name from enum value
+            $constantSuffix = strtoupper(str_replace(['-', '.', ' '], '_', $enumValue));
+            $constantName = $prefix . '_' . $constantSuffix;
+
+            // Add the constant
+            $interface->addConstant($constantName, $enumValue)
+                ->setPublic();
+        }
+    }
+
     /**
      * Add a single property as getter method
      *

Original file line number	Diff line number	Diff line change
`@@ -14,6 +14,9 @@`
`14`	`14`
`15`	`15`	`interface UCPDiscoveryProfileSigningKeysItem`
`16`	`16`	`{`
	`17`	`+ public const USE_SIG = 'sig';`
	`18`	`+ public const USE_ENC = 'enc';`
	`19`	`+`
`17`	`20`	`/**`
`18`	`21`	`* Key ID. Referenced in signature headers to identify which key to use for verification.`
`19`	`22`	`*`
Original file line number	Diff line number	Diff line change
`@@ -17,6 +17,9 @@`
`17`	`17`	`*/`
`18`	`18`	`interface DiscountAppliedDiscount`
`19`	`19`	`{`
	`20`	`+ public const METHOD_EACH = 'each';`
	`21`	`+ public const METHOD_ACROSS = 'across';`
	`22`	`+`
`20`	`23`	`/**`
`21`	`24`	`* The discount code. Omitted for automatic discounts.`
`22`	`25`	`*`
Original file line number	Diff line number	Diff line change
`@@ -17,6 +17,10 @@`
`17`	`17`	`*/`
`18`	`18`	`interface Adjustment`
`19`	`19`	`{`
	`20`	`+ public const STATUS_PENDING = 'pending';`
	`21`	`+ public const STATUS_COMPLETED = 'completed';`
	`22`	`+ public const STATUS_FAILED = 'failed';`
	`23`	`+`
`20`	`24`	`/**`
`21`	`25`	`* Adjustment event identifier.`
`22`	`26`	`*`
Original file line number	Diff line number	Diff line change
`@@ -19,6 +19,10 @@`
`19`	`19`	`*/`
`20`	`20`	`interface CardCredential`
`21`	`21`	`{`
	`22`	`+ public const CARD_NUMBER_TYPE_FPAN = 'fpan';`
	`23`	`+ public const CARD_NUMBER_TYPE_NETWORK_TOKEN = 'network_token';`
	`24`	`+ public const CARD_NUMBER_TYPE_DPAN = 'dpan';`
	`25`	`+`
`22`	`26`	`/**`
`23`	`27`	`* The credential type identifier for card credentials.`
`24`	`28`	`*`
Original file line number	Diff line number	Diff line change
`@@ -19,6 +19,9 @@`
`19`	`19`	`*/`
`20`	`20`	`interface FulfillmentAvailableMethodResponse`
`21`	`21`	`{`
	`22`	`+ public const TYPE_SHIPPING = 'shipping';`
	`23`	`+ public const TYPE_PICKUP = 'pickup';`
	`24`	`+`
`22`	`25`	`/**`
`23`	`26`	`* Fulfillment method type this availability applies to.`
`24`	`27`	`*`