fix!: Adjustment mapping and model sharing

fix: Map subscription transaction adjustments
fix: Remove unused subscription classes
fix: Ensure Adjustment items are mapped
fix!: Transaction include to use core Adjustment
fix!: Refactor Adjustments and related entities
  - CreateAdjustment now has a write specific AdjustmentItem
  - Adjustment entities are shared between Adjustments and Subscriptions
    - AdjustmentProration
    - AdjustmentType
    - AdjustmentTimePeriod

BREAKING CHANGE: See below

- To create an Adjustment you must now use `\Paddle\SDK\Resources\Adjustments\Operations\Create\AdjustmentItem`
- Adjustment entities sub objects now utilise shared models

src/Entities/Adjustment.php

@@ -11,7 +11,7 @@
 
 namespace Paddle\SDK\Entities;
 
-use Paddle\SDK\Entities\Adjustment\AdjustmentItemTotals;
+use Paddle\SDK\Entities\Adjustment\AdjustmentItem;
 use Paddle\SDK\Entities\Shared\Action;
 use Paddle\SDK\Entities\Shared\AdjustmentStatus;
 use Paddle\SDK\Entities\Shared\CurrencyCode;
@@ -23,7 +23,7 @@ class Adjustment implements Entity
     /**
      * @internal
      *
-     * @param array<AdjustmentItemTotals> $items
+     * @param array<AdjustmentItem> $items
      */
     protected function __construct(
         public string $id,
@@ -55,7 +55,7 @@ public static function from(array $data): self
             creditAppliedToBalance: $data['credit_applied_to_balance'] ?? null,
             currencyCode: CurrencyCode::from($data['currency_code']),
             status: AdjustmentStatus::from($data['status']),
-            items: $data['items'],
+            items: array_map(fn (array $item) => AdjustmentItem::from($item), $data['items']),
             totals: TotalAdjustments::from($data['totals']),
             payoutTotals: isset($data['payout_totals']) ? PayoutTotalsAdjustment::from($data['payout_totals']) : null,
             createdAt: DateTime::from($data['created_at']),

src/Entities/Adjustment/AdjustmentItem.php

@@ -11,12 +11,31 @@
 
 namespace Paddle\SDK\Entities\Adjustment;
 
+use Paddle\SDK\Entities\Shared\AdjustmentItemTotals;
+use Paddle\SDK\Entities\Shared\AdjustmentProration;
+use Paddle\SDK\Entities\Shared\AdjustmentType;
+
 class AdjustmentItem
 {
     public function __construct(
+        public string $id,
         public string $itemId,
         public AdjustmentType $type,
         public string|null $amount,
+        public AdjustmentProration|null $proration,
+        public AdjustmentItemTotals $totals,
     ) {
     }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            id: $data['id'],
+            itemId: $data['item_id'],
+            type: AdjustmentType::from($data['type']),
+            amount: $data['amount'] ?? null,
+            proration: $data['proration'] ? AdjustmentProration::from($data['proration']) : null,
+            totals: AdjustmentItemTotals::from($data['totals']),
+        );
+    }
 }

src/Entities/Shared/AdjustmentItemTotals.php

@@ -19,4 +19,13 @@ public function __construct(
         public string $total,
     ) {
     }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            subtotal: $data['subtotal'],
+            tax: $data['tax'],
+            total: $data['total'],
+        );
+    }
 }

src/Entities/Adjustment/AdjustmentProration.php → src/Entities/Shared/AdjustmentProration.php

@@ -9,7 +9,7 @@
  * |-------------------------------------------------------------|.
  */
 
-namespace Paddle\SDK\Entities\Adjustment;
+namespace Paddle\SDK\Entities\Shared;
 
 class AdjustmentProration
 {
@@ -18,4 +18,12 @@ public function __construct(
         public AdjustmentTimePeriod $billingPeriod,
     ) {
     }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            rate: $data['rate'],
+            billingPeriod: AdjustmentTimePeriod::from($data['billing_period']),
+        );
+    }
 }

src/Entities/Adjustment/AdjustmentTimePeriod.php → src/Entities/Shared/AdjustmentTimePeriod.php

@@ -9,7 +9,9 @@
  * |-------------------------------------------------------------|.
  */
 
-namespace Paddle\SDK\Entities\Adjustment;
+namespace Paddle\SDK\Entities\Shared;
+
+use Paddle\SDK\Entities\DateTime;
 
 class AdjustmentTimePeriod
 {
@@ -18,4 +20,12 @@ public function __construct(
         public \DateTimeInterface $endsAt,
     ) {
     }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            startsAt: DateTime::from($data['starts_at']),
+            endsAt: DateTime::from($data['ends_at']),
+        );
+    }
 }

src/Entities/Adjustment/AdjustmentType.php → src/Entities/Shared/AdjustmentType.php

@@ -9,7 +9,7 @@
  * |-------------------------------------------------------------|.
  */
 
-namespace Paddle\SDK\Entities\Adjustment;
+namespace Paddle\SDK\Entities\Shared;
 
 enum AdjustmentType: string
 {

src/Entities/Subscription/SubscriptionAdjustmentItem.php

@@ -11,17 +11,29 @@
 
 namespace Paddle\SDK\Entities\Subscription;
 
-use Paddle\SDK\Entities\Adjustment\AdjustmentType;
 use Paddle\SDK\Entities\Shared\AdjustmentItemTotals;
+use Paddle\SDK\Entities\Shared\AdjustmentProration;
+use Paddle\SDK\Entities\Shared\AdjustmentType;
 
 class SubscriptionAdjustmentItem
 {
     public function __construct(
         public string $itemId,
         public AdjustmentType $type,
         public string|null $amount,
-        public SubscriptionProration $proration,
+        public AdjustmentProration $proration,
         public AdjustmentItemTotals $totals,
     ) {
     }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            itemId: $data['item_id'],
+            type: AdjustmentType::from($data['type']),
+            amount: $data['amount'] ?? null,
+            proration: AdjustmentProration::from($data['proration']),
+            totals: AdjustmentItemTotals::from($data['totals']),
+        );
+    }
 }

src/Entities/Subscription/SubscriptionAdjustmentPreview.php

@@ -17,4 +17,13 @@ public function __construct(
         public TotalAdjustments $totals,
     ) {
     }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            transactionId: $data['transaction_id'],
+            items: array_map(fn (array $item) => SubscriptionAdjustmentItem::from($item), $data['items']),
+            totals: TotalAdjustments::from($data['totals']),
+        );
+    }
 }

src/Entities/Subscription/SubscriptionNextTransaction.php

@@ -30,7 +30,10 @@ public static function from(array $data): self
         return new self(
             billingPeriod: SubscriptionTimePeriod::from($data['billing_period']),
             details: TransactionDetailsPreview::from($data['details']),
-            adjustments: [],
+            adjustments: array_map(
+                fn (array $adjustment) => SubscriptionAdjustmentPreview::from($adjustment),
+                $data['adjustments'],
+            ),
         );
     }
 }