@doist/todoist-api-typescript 1.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Doist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# Todoist API TypeScript Client
+
+This is the official TypeScript API client for the Todoist REST API.
+
+## Installation
+
+```
+npm install @doist/todoist-api-typescript
+```
+
+### Usage
+
+An example of initializing the API client and fetching a user's tasks:
+
+```typescript
+import { TodoistApi } from '@doist/todoist-api-typescript'
+
+const api = new TodoistApi('YOURTOKEN')
+
+api.getTasks()
+    .then((tasks) => console.log(tasks))
+    .catch((error) => console.log(error))
+```
+
+### Documentation
+
+For more detailed reference documentation, have a look at the [API documentation with TypeScript examples](https://developer.todoist.com/rest/v1/?javascript).
+
+## Development and Testing
+
+Instead of having an example app in the repository to assist development and testing, we have included [ts-node](https://github.com/TypeStrong/ts-node) as a dev dependency. This allows us to have a scratch file locally that can import and utilize the API while developing or reviewing pull requests without having to manage a separate app project.
+
+-   `npm install`
+-   Add a file named `scratch.ts` in the `src` folder.
+-   Configure your IDE to run the scratch file with `ts-node` (instructions for [VSCode](https://medium.com/@dupski/debug-typescript-in-vs-code-without-compiling-using-ts-node-9d1f4f9a94a), [WebStorm](https://www.jetbrains.com/help/webstorm/running-and-debugging-typescript.html#ws_ts_run_debug_server_side_ts_node)), or you can optionally run ts-node in a terminal using instructions [here](https://github.com/TypeStrong/ts-node) (`npx ts-node ./src/scratch.ts` should be enough).
+-   Import and call the relevant modules and run the scratch file.
+
+Example scratch.ts file:
+
+```
+/* eslint-disable no-console */
+import { TodoistApi } from './TodoistApi'
+
+const token = 'YOURTOKEN'
+const api = new TodoistApi(token)
+
+api.getProjects()
+    .then((projects) => {
+        console.log(projects)
+    })
+    .catch((error) => console.error(error))
+```
+
+## Releases
+
+A new version is published to the NPM Registry whenever a new release on GitHub is created.
+
+The version in both package.json and package-lock.json is updated with:
+
+`npm version <major|minor|patch> --no-git-tag-version`
+
+Once these changes have been pushed and merged, a release should be created, and a GitHub Action will automatically perform all the necessary steps and will release the version number that's specified inside the `package.json` file's version field.
+
+Users of the API client can then update to this version in their `package.json`.
+
+### Feedback
+
+Any feedback, such as bugs, questions, comments, etc. can be reported as _Issues_ in this repository, and will be handled by us in Todoist.
+
+### Contributions
+
+We would also love contributions in the form of _Pull requests_ in this repository.

package/dist/TodoistApi.d.ts

@@ -0,0 +1,35 @@
+import { Task, Project, Label, User, Section, Comment } from './types/entities';
+import { AddLabelArgs, AddProjectArgs, AddSectionArgs, AddProjectCommentArgs, AddTaskArgs, AddTaskCommentArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetTasksArgs, UpdateCommentArgs, UpdateLabelArgs, UpdateProjectArgs, UpdateSectionArgs, UpdateTaskArgs, QuickAddTaskArgs } from './types/requests';
+export declare class TodoistApi {
+    authToken: string;
+    constructor(authToken: string);
+    getTask(id: number): Promise<Task>;
+    getTasks(args?: GetTasksArgs): Promise<Task[]>;
+    addTask(args: AddTaskArgs, requestId?: string): Promise<Task>;
+    quickAddTask(args: QuickAddTaskArgs): Promise<Task>;
+    updateTask(id: number, args: UpdateTaskArgs, requestId?: string): Promise<boolean>;
+    closeTask(id: number, requestId?: string): Promise<boolean>;
+    reopenTask(id: number, requestId?: string): Promise<boolean>;
+    deleteTask(id: number, requestId?: string): Promise<boolean>;
+    getProject(id: number): Promise<Project>;
+    getProjects(): Promise<Project[]>;
+    addProject(args: AddProjectArgs, requestId?: string): Promise<Project>;
+    updateProject(id: number, args: UpdateProjectArgs, requestId?: string): Promise<boolean>;
+    deleteProject(id: number, requestId?: string): Promise<boolean>;
+    getProjectCollaborators(projectId: number): Promise<User[]>;
+    getSections(projectId?: number): Promise<Section[]>;
+    getSection(id: number): Promise<Section>;
+    addSection(args: AddSectionArgs, requestId?: string): Promise<Section>;
+    updateSection(id: number, args: UpdateSectionArgs, requestId?: string): Promise<boolean>;
+    deleteSection(id: number, requestId?: string): Promise<boolean>;
+    getLabel(id: number): Promise<Label>;
+    getLabels(): Promise<Label[]>;
+    addLabel(args: AddLabelArgs, requestId?: string): Promise<Label>;
+    updateLabel(id: number, args: UpdateLabelArgs, requestId?: string): Promise<boolean>;
+    deleteLabel(id: number, requestId?: string): Promise<boolean>;
+    getComments(args: GetTaskCommentsArgs | GetProjectCommentsArgs): Promise<Comment[]>;
+    getComment(id: number): Promise<Comment>;
+    addComment(args: AddTaskCommentArgs | AddProjectCommentArgs, requestId?: string): Promise<Comment>;
+    updateComment(id: number, args: UpdateCommentArgs, requestId?: string): Promise<boolean>;
+    deleteComment(id: number, requestId?: string): Promise<boolean>;
+}

package/dist/TodoistApi.js

@@ -0,0 +1,469 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TodoistApi = void 0;
+var entities_1 = require("./types/entities");
+var restClient_1 = require("./restClient");
+var taskConverters_1 = require("./utils/taskConverters");
+var url_join_1 = __importDefault(require("url-join"));
+var endpoints_1 = require("./consts/endpoints");
+var validators_1 = require("./utils/validators");
+var TodoistApi = /** @class */ (function () {
+    function TodoistApi(authToken) {
+        this.authToken = authToken;
+    }
+    TodoistApi.prototype.getTask = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_TASKS, String(id)), this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateTask)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getTasks = function (args) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_TASKS, this.authToken, args)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateTaskArray)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.addTask = function (args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_TASKS, this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateTask)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.quickAddTask = function (args) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response, task;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_SYNC_BASE_URI, endpoints_1.ENDPOINT_SYNC_QUICK_ADD, this.authToken, args)];
+                    case 1:
+                        response = _a.sent();
+                        task = (0, taskConverters_1.getTaskFromQuickAddResponse)(response.data);
+                        return [2 /*return*/, (0, validators_1.validateTask)(task)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.updateTask = function (id, args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_TASKS, String(id)), this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.closeTask = function (id, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_TASKS, String(id), endpoints_1.ENDPOINT_REST_TASK_CLOSE), this.authToken, undefined, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.reopenTask = function (id, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_TASKS, String(id), endpoints_1.ENDPOINT_REST_TASK_REOPEN), this.authToken, undefined, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.deleteTask = function (id, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('DELETE', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_TASKS, String(id)), this.authToken, undefined, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getProject = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_PROJECTS, String(id)), this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateProject)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getProjects = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_PROJECTS, this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateProjectArray)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.addProject = function (args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_PROJECTS, this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateProject)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.updateProject = function (id, args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_PROJECTS, String(id)), this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.deleteProject = function (id, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('DELETE', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_PROJECTS, String(id)), this.authToken, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getProjectCollaborators = function (projectId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(projectId);
+                        return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_PROJECTS, String(projectId), endpoints_1.ENDPOINT_REST_PROJECT_COLLABORATORS), this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateUserArray)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getSections = function (projectId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_SECTIONS, this.authToken, projectId && { projectId: projectId })];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateSectionArray)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getSection = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_SECTIONS, String(id)), this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateSection)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.addSection = function (args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_SECTIONS, this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateSection)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.updateSection = function (id, args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_SECTIONS, String(id)), this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.deleteSection = function (id, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('DELETE', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_SECTIONS, String(id)), this.authToken, undefined, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getLabel = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_LABELS, String(id)), this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateLabel)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getLabels = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_LABELS, this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateLabelArray)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.addLabel = function (args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_LABELS, this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateLabel)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.updateLabel = function (id, args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_LABELS, String(id)), this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.deleteLabel = function (id, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('DELETE', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_LABELS, String(id)), this.authToken, undefined, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getComments = function (args) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_COMMENTS, this.authToken, args)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateCommentArray)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.getComment = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('GET', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_COMMENTS, String(id)), this.authToken)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateComment)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.addComment = function (args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, endpoints_1.ENDPOINT_REST_COMMENTS, this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateComment)(response.data)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.updateComment = function (id, args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('POST', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_COMMENTS, String(id)), this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    TodoistApi.prototype.deleteComment = function (id, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        entities_1.Int.check(id);
+                        return [4 /*yield*/, (0, restClient_1.request)('DELETE', endpoints_1.API_REST_BASE_URI, (0, url_join_1.default)(endpoints_1.ENDPOINT_REST_COMMENTS, String(id)), this.authToken, undefined, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
+    return TodoistApi;
+}());
+exports.TodoistApi = TodoistApi;

package/dist/authentication.d.ts

@@ -0,0 +1,19 @@
+export declare type Permission = 'task:add' | 'data:read' | 'data:read_write' | 'data:delete' | 'project:delete';
+export declare type AuthTokenResponse = {
+    accessToken: string;
+    state: string;
+};
+export declare type AuthTokenRequestArgs = {
+    clientId: string;
+    clientSecret: string;
+    code: string;
+};
+export declare type RevokeAuthTokenRequestArgs = {
+    clientId: string;
+    clientSecret: string;
+    accessToken: string;
+};
+export declare function getAuthStateParameter(): string;
+export declare function getAuthorizationUrl(clientId: string, permissions: Permission[], state: string): string;
+export declare function getAuthToken(args: AuthTokenRequestArgs): Promise<AuthTokenResponse>;
+export declare function revokeAuthToken(args: RevokeAuthTokenRequestArgs): Promise<boolean>;