From 3599329b57caab7e8ff6d3aba0412bde778cd26d Mon Sep 17 00:00:00 2001
From: Konstantinos Arvanitakis <arvanitakis@radical-elements.com>
Date: Sun, 19 Jul 2026 00:50:15 +0300
Subject: [PATCH] Feature: Add ManifestResult DTO for carrier manifest batching

Completes the carrier-agnostic shipping abstraction (CarrierFulfillmentInterface, SupportsManifestBatching, Shipment model) with the result type SupportsManifestBatching::issueManifest() returns.
---
 .../DataTransferObjects/ManifestResult.php    | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 src/Shipping/DataTransferObjects/ManifestResult.php

diff --git a/src/Shipping/DataTransferObjects/ManifestResult.php b/src/Shipping/DataTransferObjects/ManifestResult.php
new file mode 100644
index 0000000..a855421
--- /dev/null
+++ b/src/Shipping/DataTransferObjects/ManifestResult.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace Modules\Core\Shipping\DataTransferObjects;
+
+use Illuminate\Support\Collection;
+
+class ManifestResult
+{
+    private function __construct(
+        public readonly bool $success,
+        public readonly ?string $reference,
+        public readonly Collection $includedShipments,
+        public readonly Collection $blockedShipments,
+        public readonly ?string $reason,
+    ) {}
+
+    public static function success(string $reference, Collection $includedShipments): self
+    {
+        return new self(true, $reference, $includedShipments, collect(), null);
+    }
+
+    public static function blocked(Collection $blockedShipments, string $reason): self
+    {
+        return new self(false, null, collect(), $blockedShipments, $reason);
+    }
+}