feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 232
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-4df3552a635fafa2af8caa70f7daed96996b4263da92fb96e03cbf3c1b4931b4.yml
-openapi_spec_hash: 77a141ca0b0c00f8117cea15374a734d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-cc66158bcd1307d07051dcfd43d73dad380a7d8eb637620b21ff4a59e6073b68.yml
+openapi_spec_hash: add50aa92e44e568b1efa8dba7bdb2d5
 config_hash: 27e44ed36b9c5617b580ead7231a594a

src/CheckTransfers/CheckTransfer/Mailing.php

@@ -11,47 +11,31 @@
 /**
  * If the check has been mailed by Increase, this will contain details of the shipment.
  *
- * @phpstan-type MailingShape = array{
- *   imageID: string|null,
- *   mailedAt: \DateTimeInterface,
- *   trackingNumber: string|null,
- * }
+ * @phpstan-type MailingShape = array{mailedAt: \DateTimeInterface}
  */
 final class Mailing implements BaseModel
 {
     /** @use SdkModel<MailingShape> */
     use SdkModel;
 
-    /**
-     * The ID of the file corresponding to an image of the check that was mailed, if available.
-     */
-    #[Required('image_id')]
-    public ?string $imageID;
-
     /**
      * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the check was mailed.
      */
     #[Required('mailed_at')]
     public \DateTimeInterface $mailedAt;
 
-    /**
-     * The tracking number of the shipment, if available for the shipping method.
-     */
-    #[Required('tracking_number')]
-    public ?string $trackingNumber;
-
     /**
      * `new Mailing()` is missing required properties by the API.
      *
      * To enforce required parameters use
      * ```
-     * Mailing::with(imageID: ..., mailedAt: ..., trackingNumber: ...)
+     * Mailing::with(mailedAt: ...)
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
-     * (new Mailing)->withImageID(...)->withMailedAt(...)->withTrackingNumber(...)
+     * (new Mailing)->withMailedAt(...)
      * ```
      */
     public function __construct()
@@ -64,27 +48,11 @@ public function __construct()
      *
      * You must use named parameters to construct any parameters with a default value.
      */
-    public static function with(
-        ?string $imageID,
-        \DateTimeInterface $mailedAt,
-        ?string $trackingNumber
-    ): self {
+    public static function with(\DateTimeInterface $mailedAt): self
+    {
         $self = new self;
 
-        $self['imageID'] = $imageID;
         $self['mailedAt'] = $mailedAt;
-        $self['trackingNumber'] = $trackingNumber;
-
-        return $self;
-    }
-
-    /**
-     * The ID of the file corresponding to an image of the check that was mailed, if available.
-     */
-    public function withImageID(?string $imageID): self
-    {
-        $self = clone $this;
-        $self['imageID'] = $imageID;
 
         return $self;
     }
@@ -99,15 +67,4 @@ public function withMailedAt(\DateTimeInterface $mailedAt): self
 
         return $self;
     }
-
-    /**
-     * The tracking number of the shipment, if available for the shipping method.
-     */
-    public function withTrackingNumber(?string $trackingNumber): self
-    {
-        $self = clone $this;
-        $self['trackingNumber'] = $trackingNumber;
-
-        return $self;
-    }
 }

src/CheckTransfers/CheckTransfer/Submission.php

@@ -15,15 +15,23 @@
  * @phpstan-import-type SubmittedAddressShape from \Increase\CheckTransfers\CheckTransfer\Submission\SubmittedAddress
  *
  * @phpstan-type SubmissionShape = array{
+ *   previewFileID: string|null,
  *   submittedAddress: SubmittedAddress|SubmittedAddressShape,
  *   submittedAt: \DateTimeInterface,
+ *   trackingNumber: string|null,
  * }
  */
 final class Submission implements BaseModel
 {
     /** @use SdkModel<SubmissionShape> */
     use SdkModel;
 
+    /**
+     * The ID of the file corresponding to an image of the check that was mailed, if available.
+     */
+    #[Required('preview_file_id')]
+    public ?string $previewFileID;
+
     /**
      * The address we submitted to the printer. This is what is physically printed on the check.
      */
@@ -36,18 +44,33 @@ final class Submission implements BaseModel
     #[Required('submitted_at')]
     public \DateTimeInterface $submittedAt;
 
+    /**
+     * The tracking number for the check shipment.
+     */
+    #[Required('tracking_number')]
+    public ?string $trackingNumber;
+
     /**
      * `new Submission()` is missing required properties by the API.
      *
      * To enforce required parameters use
      * ```
-     * Submission::with(submittedAddress: ..., submittedAt: ...)
+     * Submission::with(
+     *   previewFileID: ...,
+     *   submittedAddress: ...,
+     *   submittedAt: ...,
+     *   trackingNumber: ...,
+     * )
      * ```
      *
      * Otherwise ensure the following setters are called
      *
      * ```
-     * (new Submission)->withSubmittedAddress(...)->withSubmittedAt(...)
+     * (new Submission)
+     *   ->withPreviewFileID(...)
+     *   ->withSubmittedAddress(...)
+     *   ->withSubmittedAt(...)
+     *   ->withTrackingNumber(...)
      * ```
      */
     public function __construct()
@@ -63,13 +86,28 @@ public function __construct()
      * @param SubmittedAddress|SubmittedAddressShape $submittedAddress
      */
     public static function with(
+        ?string $previewFileID,
         SubmittedAddress|array $submittedAddress,
-        \DateTimeInterface $submittedAt
+        \DateTimeInterface $submittedAt,
+        ?string $trackingNumber,
     ): self {
         $self = new self;
 
+        $self['previewFileID'] = $previewFileID;
         $self['submittedAddress'] = $submittedAddress;
         $self['submittedAt'] = $submittedAt;
+        $self['trackingNumber'] = $trackingNumber;
+
+        return $self;
+    }
+
+    /**
+     * The ID of the file corresponding to an image of the check that was mailed, if available.
+     */
+    public function withPreviewFileID(?string $previewFileID): self
+    {
+        $self = clone $this;
+        $self['previewFileID'] = $previewFileID;
 
         return $self;
     }
@@ -98,4 +136,15 @@ public function withSubmittedAt(\DateTimeInterface $submittedAt): self
 
         return $self;
     }
+
+    /**
+     * The tracking number for the check shipment.
+     */
+    public function withTrackingNumber(?string $trackingNumber): self
+    {
+        $self = clone $this;
+        $self['trackingNumber'] = $trackingNumber;
+
+        return $self;
+    }
 }