Helix\Asana\Task::_getMap()

Complexity

Conditions	1
Paths	1

Size

Total Lines	11
Code Lines	10

Duplication

Lines	0
Ratio	0 %

Importance

Changes

0

1 Method

Rating	Name	Duplication	Size	Complexity
A	Task::_getDir()	0	2	1

<?php

namespace Helix\Asana;

use Helix\Asana\Base\AbstractEntity;
use Helix\Asana\Base\AbstractEntity\CrudTrait;
use Helix\Asana\Base\AbstractEntity\WorkspaceTrait;
use Helix\Asana\Event\StoryEvent;
use Helix\Asana\Event\TaskEvent;
use Helix\Asana\Project\Section;
use Helix\Asana\Task\Attachment;
use Helix\Asana\Task\CustomValues;
use Helix\Asana\Task\External;
use Helix\Asana\Task\Like;
use Helix\Asana\Task\Membership;
use Helix\Asana\Task\Story;
use Helix\Asana\Webhook\TaskWebhook;

/**
 * A task.
 *
 * @see https://developers.asana.com/docs/asana-tasks
 * @see https://developers.asana.com/docs/task
 *
 * @method null|User    getAssignee         ()
 * @method bool         hasAssignee         ()
 * @method $this        setAssignee         (null|User $user)
 * @method string       getAssigneeStatus   ()
 * @method $this        setAssigneeStatus   (string $status)
 * @method bool         isCompleted         ()
 * @method $this        setCompleted        (bool $completed)
 * @method string       getCompletedAt      ()
 * @method string       getCreatedAt        ()
 * @method null|CustomValues getCustomFields() Premium only.
 * @method bool         hasCustomFields     () Premium only.
 * @method string       getDueOn            ()
 * @method $this        setDueOn            (string $date)
 * @method User[]       getFollowers        ()
 * @method bool         hasFollowers        ()
 * @method string       getHtmlNotes        ()
 * @method $this        setHtmlNotes        (string $notes)
 * @method bool         isLiked             ()
 * @method $this        setLiked            (bool $liked)
 * @method Like[]       getLikes            ()
 * @method Membership[] getMemberships      ()
 * @method bool         hasMemberships      ()
 * @method string       getModifiedAt       ()
 * @method string       getName             ()
 * @method $this        setName             (string $name)
 * @method string       getNotes            ()
 * @method $this        setNotes            (string $notes)
 * @method int          getNumLikes         ()
 * @method int          getNumSubtasks      ()
 * @method null|Task    getParent           ()
 * @method bool         hasParent           ()
 * @method string       getResourceSubtype  ()
 * @method $this        setResourceSubtype  (string $type)
 * @method string       getStartOn          ()
 * @method $this        setStartOn          (string $date)
 * @method Tag[]        getTags             ()
 * @method bool         hasTags             ()
 */
class Task extends AbstractEntity {

    use CrudTrait {
        create as private _create;
        update as private _update;
    }

    use WorkspaceTrait;

    const TYPE = 'task';
    const TYPE_DEFAULT = 'default_task';
    const TYPE_MILESTONE = 'milestone';

    const ASSIGN_INBOX = 'inbox';
    const ASSIGN_LATER = 'later';
    const ASSIGN_NEW = 'new';
    const ASSIGN_TODAY = 'today';
    const ASSIGN_UPCOMING = 'upcoming';

    protected static $map = [
        'assignee' => User::class,
        'custom_fields' => CustomValues::class,
        'external' => External::class, // not included by expanding "this". always lazy.
        'followers' => [User::class],
        'likes' => [Like::class],
        'memberships' => [Membership::class],
        'parent' => self::class,
        'tags' => [Tag::class],
        'workspace' => Workspace::class
    ];

    protected static $optFields = [
        'memberships' => 'memberships.(project|section)'
    ];

    final public function __toString (): string {
        return "tasks/{$this->getGid()}";
    }

    /**
     * Clears the diffs for `custom_fields` and `external` sub-objects after saving.
     */
    protected function _clearSubDiffs (): void {
        // use isset() to avoid has() fetch.
        if (isset($this->data['custom_fields'])) {
            $this->getCustomFields()->diff = [];
        }
        if (isset($this->data['external'])) {
            $this->getExternal()->diff = [];
        }
    }

    final protected function _getDir (): string {
        return 'tasks';
    }

    /**
     * Uploads a file attachment.
     *
     * @depends after-create
     * @param string $file
     * @return Attachment
     */
    public function addAttachment (string $file) {
        /** @var Attachment $attachment */
        $attachment = $this->factory(Attachment::class, ['parent' => $this]);
        return $attachment->upload($file);
    }

    /**
     * Posts a comment on an existing task and returns it.
     *
     * @param string $text
     * @return Story
     */
    public function addComment (string $text) {
        return $this->newComment()->setText($text)->create();

The call to Helix\Asana\Task\Story::setText() has too many arguments starting with $text.

    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task[] $tasks
     * @return $this
     */
    public function addDependencies (array $tasks) {
        $this->api->post("{$this}/addDependencies", ['dependents' => static::_getGids($tasks)]);
        return $this;
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task $task
     * @return $this
     */
    public function addDependency (Task $task) {
        return $this->addDependencies([$task]);
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task $task
     * @return $this
     */
    public function addDependent (Task $task) {
        return $this->addDependents([$task]);
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task[] $tasks
     * @return $this
     */
    public function addDependents (array $tasks) {
        $this->api->post("{$this}/addDependents", ['dependents' => static::_getGids($tasks)]);
        return $this;
    }

    /**
     * Adds a follower.
     *
     * @param User $user
     * @return $this
     */
    public function addFollower (User $user) {
        return $this->addFollowers([$user]);
    }

    /**
     * Adds followers.
     *
     * @param User[] $users
     * @return $this
     */
    public function addFollowers (array $users) {
        if ($this->hasGid()) {
            $this->api->post("{$this}/addFollowers", ['followers' => static::_getGids($users)]);
            $this->_merge('followers', $users);
        }
        else {
            $this->_merge('followers', $users, true);
        }
        return $this;
    }

    /**
     * Adds a tag.
     *
     * @param Tag $tag
     * @return $this
     */
    public function addTag (Tag $tag) {
        if ($this->hasGid()) {
            $this->api->post("{$this}/addTag", ['tag' => $tag->getGid()]);
            $this->_merge('tags', [$tag]);
        }
        else {
            $this->_merge('tags', [$tag], true);
        }
        return $this;
    }

    /**
     * Adds the task to a project section.
     *
     * @param Section $section
     * @return $this
     */
    public function addToProject (Section $section) {
        $project = $section->getProject();
        if ($this->hasGid()) {
            $this->api->post("{$this}/addProject", [
                'project' => $project->getGid(),
                'section' => $section->getGid()
            ]);
            if (isset($this->data['memberships'])) {
                $this->data['memberships'][] = $this->factory(Membership::class)->_setData([

Are you sure the assignment to $this->data['memberships'][] is correct as $this->factory(Helix\Asana\Task\Membership::class)->_setData(array('project' => $project, 'section' => $section)) targeting Helix\Asana\Base\Data::_setData() seems to always return null.

                    'project' => $project,
                    'section' => $section
                ]);
            }
        }
        else {
            if (!$this->hasWorkspace()) {
                $this->setWorkspace($project->getWorkspace());

It seems like $project->getWorkspace() can also be of type null; however, parameter $workspace of Helix\Asana\Task::setWorkspace() does only seem to accept Helix\Asana\Workspace, maybe add an additional type check?

            }
            $membership = $this->factory(Membership::class);
            $membership->_set('project', $section->getProject());
            $membership->_set('section', $section);
            $this->data['memberships'][] = $membership;
            $this->diff['memberships'] = true;
        }
        return $this;
    }

    /**
     * Creates and returns a webhook.
     *
     * @depends after-create
     * @param string $target
     * @return TaskWebhook
     */
    public function addWebhook (string $target) {
        /** @var TaskWebhook $webhook */
        $webhook = $this->factory(TaskWebhook::class);
        return $webhook->create($this, $target);
    }

    /**
     * @return $this
     */
    public function create () {
        $this->_create();
        $this->_clearSubDiffs();
        return $this;
    }

    /**
     * Creates and returns job to duplicate the task.
     *
     * @see https://developers.asana.com/docs/#duplicate-a-task
     *
     * @depends after-create
     * @param string $name
     * @param string[] $include
     * @return Job
     */
    public function duplicate (string $name, array $include) {
        $remote = $this->api->post("{$this}/duplicate", [
            'name' => $name,
            'include' => array_values($include)
        ]);
        return $this->factory(Job::class, $remote);

It seems like $remote can also be of type null; however, parameter $data of Helix\Asana\Base\Data::factory() does only seem to accept array, maybe add an additional type check?

    }

    /**
     * Returns the task's files.
     *
     * @depends after-create
     * @return Attachment[]
     */
    public function getAttachments () {
        return $this->loadAll(Attachment::class, "{$this}/attachments");
    }

    /**
     * Returns the task's comments.
     *
     * @depends after-create
     * @return Story[]
     */
    public function getComments () {
        return array_values(array_filter($this->getStories(), function(Story $story) {
            return $story->isComment();
        }));
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @return Task[]
     */
    public function getDependencies () {
        return $this->loadAll(self::class, "{$this}/dependencies");
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @return Task[]
     */
    public function getDependents () {
        return $this->loadAll(self::class, "{$this}/dependents");
    }

    /**
     * Returns events since the last sync.
     *
     * @depends after-create
     * @param null|string $token
     * @return TaskEvent[]|StoryEvent[]
     */
    public function getEvents (&$token) {
        return $this->api->sync($this, $token);

The expression return $this->api->sync($this, $token) returns an array which contains values of type Helix\Asana\Event\ProjectEvent which are incompatible with the documented value type Helix\Asana\Event\StoryEvent|Helix\Asana\Event\TaskEvent.

    }

    /**
     * @return External
     */
    public function getExternal () {
        return $this->_get('external') ?? $this->data['external'] = $this->factory(static::$map['external']);
    }

    /**
     * @return Project[]
     */
    public function getProjects () {
        return array_map(function(Membership $membership) {
            return $membership->getProject();
        }, $this->getMemberships());
    }

    /**
     * Returns the task's activity.
     *
     * @depends after-create
     * @return Story[]
     */
    public function getStories () {
        return $this->loadAll(Story::class, "{$this}/stories");
    }

    /**
     * Returns the task's subtasks.
     *
     * @depends after-create
     * @return Task[]
     */
    public function getSubTasks () {
        return $this->loadAll(self::class, "{$this}/subtasks");
    }

    /**
     * Returns the task's URL.
     *
     * @depends after-create
     * @return string
     */
    public function getUrl (): string {
        return "https://app.asana.com/0/0/{$this->getGid()}";
    }

    /**
     * Returns the task's webhooks.
     *
     * @depends after-create
     * @return TaskWebhook[]
     */
    public function getWebhooks () {
        return $this->loadAll(TaskWebhook::class, 'webhooks', [
            'workspace' => $this->getWorkspace()->getGid(),
            'resource' => $this->getGid()
        ]);
    }

    /**
     * @return bool
     */
    public function isRenderedAsSeparator (): bool {
        return $this->_is('is_rendered_as_separator');
    }

    /**
     * Instantiates and returns a new comment.
     *
     * @depends after-create
     * @return Story
     */
    public function newComment () {
        /** @var Story $comment */
        $comment = $this->factory(Story::class, [
            'resource_subtype' => Story::TYPE_COMMENT_ADDED
        ]);
        return $comment->_set('task', $this);
    }

    /**
     * Instantiates and returns a new subtask.
     *
     * @depends after-create
     * @return Task
     */
    public function newSubTask () {
        /** @var Task $sub */
        $sub = $this->factory(self::class);
        return $sub->setParent($this);
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task[] $tasks
     * @return $this
     */
    public function removeDependencies (array $tasks) {
        $this->api->post("{$this}/removeDependencies", ['dependencies' => static::_getGids($tasks)]);
        return $this;
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task $task
     * @return $this
     */
    public function removeDependency (Task $task) {
        return $this->removeDependencies([$task]);
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task $task
     * @return $this
     */
    public function removeDependent (Task $task) {
        return $this->removeDependents([$task]);
    }

    /**
     * Premium feature.
     *
     * @depends after-create
     * @param Task[] $tasks
     * @return $this
     */
    public function removeDependents (array $tasks) {
        $this->api->post("{$this}/removeDependents", ['dependents' => static::_getGids($tasks)]);
        return $this;
    }

    /**
     * Removes a follower.
     *
     * @param User $user
     * @return $this
     */
    public function removeFollower (User $user) {
        return $this->removeFollowers([$user]);
    }

    /**
     * Removes followers.
     *
     * @param User[] $users
     * @return $this
     */
    public function removeFollowers (array $users) {
        if ($this->hasGid()) {
            $this->api->post("{$this}/removeFollowers", ['followers' => static::_getGids($users)]);
        }
        $this->_remove('followers', $users);
        return $this;
    }

    /**
     * Removes the task from a project.
     *
     * @param Project $project
     * @return $this
     */
    public function removeFromProject (Project $project) {
        $gid = $project->getGid();
        if ($this->hasGid()) {
            $this->api->post("{$this}/removeProject", ['project' => $gid]);
        }
        if (isset($this->data['memberships'])) {
            $this->data['memberships'] = array_values(array_filter($this->data['memberships'], function(Membership $membership) use ($gid) {
                return $membership->getProject()->getGid() !== $gid;
            }));
        }
        return $this;
    }

    /**
     * Removes a tag.
     *
     * @param Tag $tag
     * @return $this
     */
    public function removeTag (Tag $tag) {
        if ($this->hasGid()) {
            $this->api->post("{$this}/removeTag", ['tag' => $tag->getGid()]);
        }
        $this->_remove('tags', [$tag]);
        return $this;
    }

    /**
     * Makes the task a subtask of another.
     *
     * @param null|Task $parent
     * @return $this
     */
    public function setParent (?self $parent) {
        if ($this->hasGid()) {
            $this->api->post("{$this}/setParent", ['parent' => $parent ? $parent->getGid() : null]);
            $this->data['parent'] = $parent;
        }
        else {
            $this->_set('parent', $parent);
        }
        return $this;
    }

    /**
     * @param bool $flag
     * @return $this
     */
    public function setRenderedAsSeparator (bool $flag) {
        return $this->_set('is_rendered_as_separator', $flag);
    }

    /**
     * @return $this
     */
    public function update () {
        $this->_update();
        $this->_clearSubDiffs();
        return $this;
    }

}