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-df015666c8d57cf91d4239bffeb549736581af5653e0ec2cd94357c434975e31.yml
-openapi_spec_hash: fceca44f4bd5f5f8fdbbaa6c80fc0410
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-1a3093fde00ba57a88035a89fca1627e3343e5c6cba2854ee6ebf8bac9640489.yml
+openapi_spec_hash: 547e0e84b0d09880a8305ddac57cc44a
 config_hash: 27e44ed36b9c5617b580ead7231a594a

src/Events/UnwrapWebhookEvent.php

@@ -0,0 +1,199 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Increase\Events;
+
+use Increase\Core\Attributes\Required;
+use Increase\Core\Concerns\SdkModel;
+use Increase\Core\Contracts\BaseModel;
+use Increase\Events\UnwrapWebhookEvent\Category;
+use Increase\Events\UnwrapWebhookEvent\Type;
+
+/**
+ * Events are records of things that happened to objects at Increase. Events are accessible via the List Events endpoint and can be delivered to your application via webhooks. For more information, see our [webhooks guide](https://increase.com/documentation/webhooks).
+ *
+ * @phpstan-type UnwrapWebhookEventShape = array{
+ *   id: string,
+ *   associatedObjectID: string,
+ *   associatedObjectType: string,
+ *   category: Category|value-of<Category>,
+ *   createdAt: \DateTimeInterface,
+ *   type: Type|value-of<Type>,
+ * }
+ */
+final class UnwrapWebhookEvent implements BaseModel
+{
+    /** @use SdkModel<UnwrapWebhookEventShape> */
+    use SdkModel;
+
+    /**
+     * The Event identifier.
+     */
+    #[Required]
+    public string $id;
+
+    /**
+     * The identifier of the object that generated this Event.
+     */
+    #[Required('associated_object_id')]
+    public string $associatedObjectID;
+
+    /**
+     * The type of the object that generated this Event.
+     */
+    #[Required('associated_object_type')]
+    public string $associatedObjectType;
+
+    /**
+     * The category of the Event. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
+     *
+     * @var value-of<Category> $category
+     */
+    #[Required(enum: Category::class)]
+    public string $category;
+
+    /**
+     * The time the Event was created.
+     */
+    #[Required('created_at')]
+    public \DateTimeInterface $createdAt;
+
+    /**
+     * A constant representing the object's type. For this resource it will always be `event`.
+     *
+     * @var value-of<Type> $type
+     */
+    #[Required(enum: Type::class)]
+    public string $type;
+
+    /**
+     * `new UnwrapWebhookEvent()` is missing required properties by the API.
+     *
+     * To enforce required parameters use
+     * ```
+     * UnwrapWebhookEvent::with(
+     *   id: ...,
+     *   associatedObjectID: ...,
+     *   associatedObjectType: ...,
+     *   category: ...,
+     *   createdAt: ...,
+     *   type: ...,
+     * )
+     * ```
+     *
+     * Otherwise ensure the following setters are called
+     *
+     * ```
+     * (new UnwrapWebhookEvent)
+     *   ->withID(...)
+     *   ->withAssociatedObjectID(...)
+     *   ->withAssociatedObjectType(...)
+     *   ->withCategory(...)
+     *   ->withCreatedAt(...)
+     *   ->withType(...)
+     * ```
+     */
+    public function __construct()
+    {
+        $this->initialize();
+    }
+
+    /**
+     * Construct an instance from the required parameters.
+     *
+     * You must use named parameters to construct any parameters with a default value.
+     *
+     * @param Category|value-of<Category> $category
+     * @param Type|value-of<Type> $type
+     */
+    public static function with(
+        string $id,
+        string $associatedObjectID,
+        string $associatedObjectType,
+        Category|string $category,
+        \DateTimeInterface $createdAt,
+        Type|string $type,
+    ): self {
+        $self = new self;
+
+        $self['id'] = $id;
+        $self['associatedObjectID'] = $associatedObjectID;
+        $self['associatedObjectType'] = $associatedObjectType;
+        $self['category'] = $category;
+        $self['createdAt'] = $createdAt;
+        $self['type'] = $type;
+
+        return $self;
+    }
+
+    /**
+     * The Event identifier.
+     */
+    public function withID(string $id): self
+    {
+        $self = clone $this;
+        $self['id'] = $id;
+
+        return $self;
+    }
+
+    /**
+     * The identifier of the object that generated this Event.
+     */
+    public function withAssociatedObjectID(string $associatedObjectID): self
+    {
+        $self = clone $this;
+        $self['associatedObjectID'] = $associatedObjectID;
+
+        return $self;
+    }
+
+    /**
+     * The type of the object that generated this Event.
+     */
+    public function withAssociatedObjectType(string $associatedObjectType): self
+    {
+        $self = clone $this;
+        $self['associatedObjectType'] = $associatedObjectType;
+
+        return $self;
+    }
+
+    /**
+     * The category of the Event. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
+     *
+     * @param Category|value-of<Category> $category
+     */
+    public function withCategory(Category|string $category): self
+    {
+        $self = clone $this;
+        $self['category'] = $category;
+
+        return $self;
+    }
+
+    /**
+     * The time the Event was created.
+     */
+    public function withCreatedAt(\DateTimeInterface $createdAt): self
+    {
+        $self = clone $this;
+        $self['createdAt'] = $createdAt;
+
+        return $self;
+    }
+
+    /**
+     * A constant representing the object's type. For this resource it will always be `event`.
+     *
+     * @param Type|value-of<Type> $type
+     */
+    public function withType(Type|string $type): self
+    {
+        $self = clone $this;
+        $self['type'] = $type;
+
+        return $self;
+    }
+}