HEX
Server: LiteSpeed
System: Linux server315.web-hosting.com 4.18.0-553.54.1.lve.el8.x86_64 #1 SMP Wed Jun 4 13:01:13 UTC 2025 x86_64
User: globfdxw (6114)
PHP: 8.1.34
Disabled: NONE
Upload Files
File: //home/globfdxw/www/wp-content/plugins/give/src/Subscriptions/Models/SubscriptionNote.php
<?php

namespace Give\Subscriptions\Models;

use DateTime;
use Give\Subscriptions\Factories\SubscriptionNoteFactory;
use Give\Subscriptions\ValueObjects\SubscriptionNoteType;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\Exceptions\Primitives\InvalidArgumentException;
use Give\Framework\Models\Contracts\ModelCrud;
use Give\Framework\Models\Contracts\ModelHasFactory;
use Give\Framework\Models\Model;
use Give\Framework\Models\ModelQueryBuilder;
use Give\Framework\Models\ValueObjects\Relationship;
use Give\Subscriptions\DataTransferObjects\SubscriptionNoteQueryData;

/**
 * @since 4.8.0
 *
 * @property int $id
 * @property string $content
 * @property int $subscriptionId
 * @property SubscriptionNoteType $type
 * @property DateTime $createdAt
 * @property Subscription $subscription
 */
class SubscriptionNote extends Model implements ModelCrud, ModelHasFactory
{
    /**
     * {@inheritdoc}
     */
    protected $properties = [
        'id' => 'int',
        'content' => 'string',
        'subscriptionId' => 'int',
        'type' => SubscriptionNoteType::class,
        'createdAt' => DateTime::class,
    ];

    /**
     * {@inheritdoc}
     */
    protected $relationships = [
        'subscription' => Relationship::BELONGS_TO,
    ];

    /**
     * @since 4.8.0
     *
     * @return SubscriptionNote|null
     */
    public static function find($id)
    {
        return give()->subscriptions->notes->getById($id);
    }

    /**
     * @since 4.8.0
     *
     * @return $this
     *
     * @throws Exception|InvalidArgumentException
     */
    public static function create(array $attributes): SubscriptionNote
    {
        $subscriptionNote = new static($attributes);

        give()->subscriptions->notes->insert($subscriptionNote);

        return $subscriptionNote;
    }

    /**
     * @since 4.8.0
     *
     * @return void
     *
     * @throws Exception|InvalidArgumentException
     */
    public function save()
    {
        if (! $this->id) {
            give()->subscriptions->notes->insert($this);
        } else {
            give()->subscriptions->notes->update($this);
        }
    }

    /**
     * @since 4.8.0
     *
     * @throws Exception|InvalidArgumentException
     */
    public function delete(): bool
    {
        return give()->subscriptions->notes->delete($this);
    }

    /**
     * @since 4.8.0
     *
     * @return ModelQueryBuilder<SubscriptionNote>
     */
    public static function query(): ModelQueryBuilder
    {
        return give()->subscriptions->notes->prepareQuery();
    }

    /**
     * @since 4.8.0
     *
     * @return ModelQueryBuilder<Subscription>
     */
    public function subscription(): ModelQueryBuilder
    {
        return give()->subscriptions->queryById($this->subscriptionId);
    }

    /**
     * @since 4.8.0
     *
     * @param  object  $object
     */
    public static function fromQueryBuilderObject($object): SubscriptionNote
    {
        return SubscriptionNoteQueryData::fromObject($object)->toSubscriptionNote();
    }

    /**
     * @since 4.8.0
     */
    public static function factory(): SubscriptionNoteFactory
    {
        return new SubscriptionNoteFactory(static::class);
    }
}