asana 3.0.1 → 3.0.2

package/README.md

@@ -1,18 +1,7 @@
 # asana [![GitHub release][release-image]][release-url] [![NPM Version][npm-image]][npm-url]
 
-> **Important**
-> Version 3.X.X is the newest release of our Node client library and currently in public beta. This means that while it has the latest Asana features, we're still putting on the final touches to ensure it's as stable and reliable as possible.
->
->🛠️ **Looking Ahead**
->
-> This version will receive updates going forward, and it’s on track to reach full stability soon. Your input is invaluable in this process! If you spot any issues, have suggestions, or need help, don’t hesitate to reach out. You can open a GitHub issue or submit your feedback directly to us.
-> 
->📖 **Get Started with Examples and Resources**
->
-> For now, if you’re in search of a version that has stood the test of time and is proven to be stable, we recommend using version 1.0.2. You can easily install it using:  `npm install asana@1.0.2` and following v1 samples and documentation.
-
 - API version: 1.0
-- Package version: 3.0.1
+- Package version: 3.0.2
 
 ## Installation
 
@@ -29,7 +18,7 @@ npm install asana --save
 Include the latest release directly from GitHub:
 
 ```html
-<script src="https://github.com/Asana/node-asana/releases/download/v3.0.1/asana-min.js"></script>
+<script src="https://github.com/Asana/node-asana/releases/download/v3.0.2/asana-min.js"></script>
 ```
 
 Example usage (**NOTE**: be careful not to expose your access token):
@@ -1011,6 +1000,6 @@ client.callApi(
 ```
 
 [release-image]: https://img.shields.io/github/release/asana/node-asana.svg
-[release-url]: https://github.com/Asana/node-asana/releases/tag/v3.0.1
+[release-url]: https://github.com/Asana/node-asana/releases/tag/v3.0.2
 [npm-image]: http://img.shields.io/npm/v/asana.svg?style=flat-square
 [npm-url]: https://www.npmjs.org/package/asana

package/build-tests/README.md

@@ -0,0 +1,19 @@
+# Test Build
+
+This directory contains tests that are meant to be ran locally
+
+1. Install dependencies: `npm i`
+
+2. Setup Environment Variables. Create a `.env` file within the root of the project directory with the following information
+
+```
+PERSONAL_ACCESS_TOKEN=<YOUR_ASANA_PERSONAL_ACCESS_TOKEN>
+TEAM_GID=<YOUR_TEAM_GID>
+TEXT_CUSTOM_FIELD_GID=<YOUR_TEXT_CUSTOM_FIELD_GID> -> NOTE: make sure that there is at least one task that has this custom field and the value of the custom field on that task is `custom_value`
+USER_GID=<YOUR_USER_GID>
+WORKSPACE_GID=<YOUR_WORKSPACE_GID>
+```
+
+3. Run tests: `npm run testbuild`
+
+TIP: to debug, add `debugger;` to the location of the test code you want to debug and re-run `npm run testbuild`

package/build-tests/api/ProjectsApi.js

@@ -0,0 +1,178 @@
+(function (root, factory) {
+    if (typeof define === "function" && define.amd) {
+        // AMD.
+        define(["expect.js", "../../src/index"], factory);
+    } else if (typeof module === "object" && module.exports) {
+        // CommonJS-like environments that support module.exports, like Node.
+        factory(require("expect.js"), require("../../src/index"));
+    } else {
+        // Browser globals (root is window)
+        factory(root.expect, root.Asana);
+    }
+})(this, function (expect, Asana) {
+    "use strict";
+
+    var TEAM_GID;
+    var WORKSPACE_GID;
+
+    var projectsApiInstance;
+    var project;
+    var projects;
+
+    before(async function () {
+        require('dotenv').config()
+        TEAM_GID = process.env.TEAM_GID;
+        WORKSPACE_GID = process.env.WORKSPACE_GID;
+
+        let client = Asana.ApiClient.instance;
+        let token = client.authentications["token"];
+        token.accessToken = process.env.PERSONAL_ACCESS_TOKEN;
+
+        projectsApiInstance = new Asana.ProjectsApi();
+    });
+
+    describe("ProjectsApi", function () {
+        describe("createProject", function () {
+            it("should have created project", async function () {
+                let body = {
+                    data: {
+                        name: "Project 1",
+                        notes: "Some description",
+                        team: TEAM_GID,
+                    },
+                };
+
+                try {
+                    project = await projectsApiInstance.createProject(body, {});
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(project).to.be.ok();
+            });
+            it("should have a `name`", function () {
+                expect(project.data.name).to.be("Project 1");
+            });
+            it("should have a description/`notes`", function () {
+                expect(project.data.notes).to.be("Some description");
+            });
+        });
+        describe("updateProject", function () {
+            it("should have updated project", async function () {
+                let body = {
+                    data: {
+                        name: "Project 1 - Updated",
+                        notes: "Updated description",
+                    },
+                };
+
+                try {
+                    project = await projectsApiInstance.updateProject(
+                        body,
+                        project.data.gid,
+                        {}
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(project).to.be.ok();
+            });
+            it("should have updated project `name`", function () {
+                expect(project.data.name).to.be("Project 1 - Updated");
+            });
+            it("should have updated project description/`notes`", function () {
+                expect(project.data.notes).to.be("Updated description");
+            });
+        });
+        describe("getProject", function () {
+            it("should return project", async function () {
+                let response;
+                try {
+                    response = await projectsApiInstance.getProject(
+                        project.data.gid,
+                        {}
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(response).to.ok();
+            });
+        });
+        describe("getProject with `opt_fields`", function () {
+            describe("ask for `html_notes` and `due_on` properties in `opt_fields`", function () {
+                it("should return project", async function () {
+                    let opts = {
+                        opt_fields: "html_notes,due_on",
+                    };
+
+                    try {
+                        project = await projectsApiInstance.getProject(
+                            project.data.gid,
+                            opts
+                        );
+                    } catch (error) {
+                        throw error.response.body;
+                    }
+                    expect(project).to.ok();
+                });
+                it("should have `html_notes`", async function () {
+                    expect(project.data.html_notes).not.to.equal(null);
+                });
+                it("should have `due_on` with `null` value", async function () {
+                    expect(project.data.due_on).to.be(null);
+                });
+            });
+        });
+        describe("getProjects", function () {
+            it("should return an array of projects", async function () {
+                let opts = {
+                    limit: 100,
+                    workspace: WORKSPACE_GID,
+                };
+                try {
+                    projects = await projectsApiInstance.getProjects(opts);
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(projects).to.be.ok();
+                expect(projects.data).to.be.an("array");
+            });
+        });
+        describe("getProjects with `opt_fields`", function () {
+            describe("ask for `color` and `completed` properties in `opt_fields`", function () {
+                it("should return an array of projects", async function () {
+                    let opts = {
+                        workspace: WORKSPACE_GID,
+                        opt_fields: "color,completed",
+                    };
+
+                    try {
+                        projects = await projectsApiInstance.getProjects(opts);
+                    } catch (error) {
+                        throw error.response.body;
+                    }
+                    expect(projects).to.be.ok();
+                    expect(projects.data).to.be.an("array");
+                });
+                it("should have `workspace`", function () {
+                    expect("color" in projects.data[0]).to.be(true);
+                });
+                it("should have `completed`", function () {
+                    expect("completed" in projects.data[0]).to.be(true);
+                });
+            });
+        });
+        describe("deleteProject", function () {
+            it("should be deleted", async function () {
+                let response;
+                try {
+                    response = await projectsApiInstance.deleteProject(
+                        project.data.gid
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(response.data).to.be.empty();
+            });
+        });
+    });
+});

package/build-tests/api/TasksApi.js

@@ -0,0 +1,260 @@
+// NOTE: Because these tests are making live API calls, we decided to write these tests in a particular order to optimize speed and reduce API calls.
+// The down side to this approach is that these tests are tightly coupled.
+(function (root, factory) {
+    if (typeof define === "function" && define.amd) {
+        // AMD.
+        define(["expect.js", "../../src/index"], factory);
+    } else if (typeof module === "object" && module.exports) {
+        // CommonJS-like environments that support module.exports, like Node.
+        factory(require("expect.js"), require("../../src/index"));
+    } else {
+        // Browser globals (root is window)
+        factory(root.expect, root.Asana);
+    }
+})(this, function (expect, Asana) {
+    "use strict";
+
+    var TEXT_CUSTOM_FIELD_GID;
+    var USER_GID;
+    var WORKSPACE_GID;
+
+    var tasksApiInstance;
+    var task;
+    var tasks;
+
+    before(async function () {
+        require('dotenv').config()
+        TEXT_CUSTOM_FIELD_GID = process.env.TEXT_CUSTOM_FIELD_GID;
+        USER_GID = process.env.USER_GID;
+        WORKSPACE_GID = process.env.WORKSPACE_GID;
+
+        let client = Asana.ApiClient.instance;
+        let token = client.authentications["token"];
+        token.accessToken = process.env.PERSONAL_ACCESS_TOKEN;
+        tasksApiInstance = new Asana.TasksApi();
+    });
+
+    describe("TasksApi", function () {
+        describe("createTask", function () {
+            it("should have created task", async function () {
+                let body = {
+                    data: {
+                        assignee: USER_GID,
+                        name: "Task 1",
+                        notes: "Some description",
+                        workspace: WORKSPACE_GID,
+                    },
+                };
+                try {
+                    task = await tasksApiInstance.createTask(body, {});
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(task).to.be.ok();
+            });
+            it("should have a `name`", function () {
+                expect(task.data.name).to.be("Task 1");
+            });
+            it("should have a description/`notes`", function () {
+                expect(task.data.notes).to.be("Some description");
+            });
+        });
+        describe("updateTask", function () {
+            it("should have updated task", async function () {
+                let body = {
+                    data: {
+                        name: "Task 1 - Updated",
+                        notes: "Updated description",
+                    },
+                };
+                try {
+                    task = await tasksApiInstance.updateTask(
+                        body,
+                        task.data.gid,
+                        {}
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(task).to.be.ok();
+            });
+            it("should have updated task `name`", function () {
+                expect(task.data.name).to.be("Task 1 - Updated");
+            });
+            it("should have updated task description/`notes`", function () {
+                expect(task.data.notes).to.be("Updated description");
+            });
+        });
+        describe("getTask", function () {
+            it("should return task", async function () {
+                let response;
+                try {
+                    response = await tasksApiInstance.getTask(
+                        task.data.gid,
+                        {}
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(response).to.ok();
+            });
+        });
+        describe("getTask with `opt_fields`", function () {
+            describe("task for `html_notes` and `due_on` properties in `opt_fields`", function () {
+                it("should return task", async function () {
+                    let opts = {
+                        opt_fields: "html_notes,due_on",
+                    };
+                    try {
+                        task = await tasksApiInstance.getTask(
+                            task.data.gid,
+                            opts
+                        );
+                    } catch (error) {
+                        throw error.response.body;
+                    }
+                    expect(task).to.be.ok();
+                });
+                it("should have `html_notes`", function () {
+                    expect(task.data.html_notes).not.to.equal(null);
+                });
+                it("should have `due_on` with `null` value", function () {
+                    expect(task.data.due_on).to.be(null);
+                });
+            });
+        });
+        describe("getTasks", function () {
+            it("should return an array of tasks", async function () {
+                let tasksApiInstance = new Asana.TasksApi();
+                let opts = {
+                    limit: 100,
+                    assignee: USER_GID,
+                    workspace: WORKSPACE_GID,
+                };
+                try {
+                    tasks = await tasksApiInstance.getTasks(opts);
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(tasks).to.be.ok();
+                expect(tasks.data).to.be.an("array");
+            });
+        });
+        describe("getTasks with `opt_fields`", function () {
+            describe("ask for `workspace` and `due_on` properties in `opt_fields`", function () {
+                it("should return an array of tasks", async function () {
+                    let tasksApiInstance = new Asana.TasksApi();
+                    let opts = {
+                        assignee: USER_GID,
+                        workspace: WORKSPACE_GID,
+                        opt_fields: "workspace,due_on",
+                    };
+
+                    try {
+                        tasks = await tasksApiInstance.getTasks(opts);
+                    } catch (error) {
+                        throw error.response.body;
+                    }
+                    expect(tasks).to.be.ok();
+                    expect(tasks.data).to.be.an("array");
+                });
+                it("should have `workspace`", function () {
+                    expect(tasks.data[0].workspace).not.to.equal(null);
+                });
+                it("should have `due_on`", function () {
+                    expect("due_on" in tasks.data[0]).to.be(true);
+                });
+            });
+        });
+        describe("getTasks limit 1", function () {
+            it("should return an array with 1 task", async function () {
+                let tasksApiInstance = new Asana.TasksApi();
+                let opts = {
+                    limit: 1,
+                    assignee: USER_GID,
+                    workspace: WORKSPACE_GID,
+                };
+
+                try {
+                    tasks = await tasksApiInstance.getTasks(opts);
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(tasks.data.length).to.be(1);
+                expect(tasks.data).to.be.an("array");
+            });
+        });
+        describe("searchTasksForWorkspace", function () {
+            it("should return an array of tasks", async function () {
+                let opts = {
+                    text: "Task",
+                    completed: false,
+                };
+
+                try {
+                    tasks = await tasksApiInstance.searchTasksForWorkspace(
+                        WORKSPACE_GID,
+                        opts
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(tasks).to.be.ok();
+                expect(tasks.data).to.be.an("array");
+            });
+        });
+        describe("searchTasksForWorkspace with custom field parameter - MATCH", function () {
+            it("should return an array with one task that has matching custom field value from search query", async function () {
+                let opts = {
+                    limit: 1,
+                    [`custom_fields.${TEXT_CUSTOM_FIELD_GID}.value`]:
+                        "custom_value",
+                };
+
+                try {
+                    tasks = await tasksApiInstance.searchTasksForWorkspace(
+                        WORKSPACE_GID,
+                        opts
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(tasks).to.be.ok();
+                expect(tasks.data.length).to.be(1);
+            });
+        });
+        describe("searchTasksForWorkspace with custom field parameter - NO MATCH", function () {
+            it("should return an empty array", async function () {
+                let opts = {
+                    [`custom_fields.${TEXT_CUSTOM_FIELD_GID}.value`]:
+                        "inimw8I23M4FRTPfApu1",
+                };
+
+                try {
+                    tasks = await tasksApiInstance.searchTasksForWorkspace(
+                        WORKSPACE_GID,
+                        opts
+                    );
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(tasks.data).to.be.empty();
+            });
+        });
+        describe("deleteTask", function () {
+            it("should be deleted", async function () {
+                let response;
+                try {
+                    // NOTE: In the above tasks we are setting the global task variable in different tests. Make sure
+                    // that future tests don't overwrite the original task created with another task otherwise
+                    // that original task won't be deleted
+                    response = await tasksApiInstance.deleteTask(task.data.gid);
+                } catch (error) {
+                    throw error.response.body;
+                }
+                expect(response).to.be.ok();
+                expect(response.data).to.be.empty();
+            });
+        });
+    });
+});

package/codegen/templates/README.mustache

@@ -1,16 +1,5 @@
 # {{projectName}} [![GitHub release][release-image]][release-url] [![NPM Version][npm-image]][npm-url]
 
-> **Important**
-> Version 3.X.X is the newest release of our Node client library and currently in public beta. This means that while it has the latest Asana features, we're still putting on the final touches to ensure it's as stable and reliable as possible.
->
->🛠️ **Looking Ahead**
->
-> This version will receive updates going forward, and it’s on track to reach full stability soon. Your input is invaluable in this process! If you spot any issues, have suggestions, or need help, don’t hesitate to reach out. You can open a GitHub issue or submit your feedback directly to us.
-> 
->📖 **Get Started with Examples and Resources**
->
-> For now, if you’re in search of a version that has stood the test of time and is proven to be stable, we recommend using version 1.0.2. You can easily install it using:  `npm install asana@1.0.2` and following v1 samples and documentation.
-
 - API version: {{appVersion}}
 - Package version: {{projectVersion}}
 {{^hideGenerationTimestamp}}

package/codegen/templates/package.mustache

@@ -9,7 +9,8 @@
     "type": "git"
   },
   "scripts": {
-    "test": "mocha --require @babel/register --recursive"
+    "test": "mocha --require @babel/register --recursive",
+    "testbuild": "mocha --timeout 20000 --require @babel/register --recursive 'build-tests/api/*.js'"
   },
   "browser": {
     "fs": false
@@ -38,6 +39,7 @@
     "@babel/plugin-syntax-import-meta": "^7.0.0",
     "@babel/preset-env": "^7.0.0",
     "@babel/register": "^7.0.0",
+    "dotenv": "^16.4.1",
     "expect.js": "^0.3.1",
     "mocha": "^8.0.1",
     "sinon": "^7.2.0"

package/dist/ApiClient.js

@@ -28,7 +28,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  */
 /**
 * @module ApiClient
-* @version 3.0.1
+* @version 3.0.2
 */
 /**
 * Manages low level client-server communications, parameter marshalling, etc. There should not be any need for an
@@ -400,14 +400,14 @@ var ApiClient = exports.ApiClient = /*#__PURE__*/function () {
       // set header parameters
       if (typeof navigator === 'undefined' || typeof window === 'undefined') {
         headerParams['X-Asana-Client-Lib'] = new URLSearchParams({
-          'version': "3.0.1",
+          'version': "3.0.2",
           'language': 'NodeJS',
           'language_version': process.version,
           'os': process.platform
         }).toString();
       } else {
         headerParams['X-Asana-Client-Lib'] = new URLSearchParams({
-          'version': "3.0.1",
+          'version': "3.0.2",
           'language': 'BrowserJS'
         }).toString();
       }

package/dist/api/AttachmentsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * Attachments service.
 * @module api/AttachmentsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var AttachmentsApi = exports.AttachmentsApi = /*#__PURE__*/function () {
   /**

package/dist/api/AuditLogAPIApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * AuditLogAPI service.
 * @module api/AuditLogAPIApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var AuditLogAPIApi = exports.AuditLogAPIApi = /*#__PURE__*/function () {
   /**

package/dist/api/BatchAPIApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * BatchAPI service.
 * @module api/BatchAPIApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var BatchAPIApi = exports.BatchAPIApi = /*#__PURE__*/function () {
   /**

package/dist/api/CustomFieldSettingsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * CustomFieldSettings service.
 * @module api/CustomFieldSettingsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var CustomFieldSettingsApi = exports.CustomFieldSettingsApi = /*#__PURE__*/function () {
   /**

package/dist/api/CustomFieldsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * CustomFields service.
 * @module api/CustomFieldsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var CustomFieldsApi = exports.CustomFieldsApi = /*#__PURE__*/function () {
   /**

package/dist/api/EventsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * Events service.
 * @module api/EventsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var EventsApi = exports.EventsApi = /*#__PURE__*/function () {
   /**

package/dist/api/GoalRelationshipsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * GoalRelationships service.
 * @module api/GoalRelationshipsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var GoalRelationshipsApi = exports.GoalRelationshipsApi = /*#__PURE__*/function () {
   /**

package/dist/api/GoalsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * Goals service.
 * @module api/GoalsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var GoalsApi = exports.GoalsApi = /*#__PURE__*/function () {
   /**

package/dist/api/JobsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * Jobs service.
 * @module api/JobsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var JobsApi = exports.JobsApi = /*#__PURE__*/function () {
   /**

package/dist/api/MembershipsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * Memberships service.
 * @module api/MembershipsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var MembershipsApi = exports.MembershipsApi = /*#__PURE__*/function () {
   /**

package/dist/api/OrganizationExportsApi.js

@@ -29,7 +29,7 @@ var Collection = require('../utils/collection');
 /**
 * OrganizationExports service.
 * @module api/OrganizationExportsApi
-* @version 3.0.1
+* @version 3.0.2
 */
 var OrganizationExportsApi = exports.OrganizationExportsApi = /*#__PURE__*/function () {
   /**