Add methods for the team model

[JSReds]

Change-type: minor

Resolves: #
HQ:
See:
Depends-on:
Change-type: major|minor|patch

---

Contributor checklist

• Includes tests
• Includes typings
• Includes updated documentation
• Includes updated build output

[JSReds]

TODO:

Add getAll and assignToFleet methods

[thgreasi]

• Mark it as async
• then add a throw in case organizationSlugOrId is unexpected

[JSReds]

do you mean by adding a pine.get(resource: 'organization', ...) or by checking if the argument is of type string | number ?

[thgreasi]

I'm fine with either :) IE

• Checking for number/string and throwing invalid parameter error
• doing just a sdk.modelsorganization.get()

[JSReds]

this method is repeated in multiple files with different implementations, is that fine if I move it to /utils/index.ts to reuse it @thgreasi ?

[JSReds]

should we check that the teamId exist ?

[JSReds]

I noticed that the API already throws an error when the teamId doesn't exist, but it returns a generic internal server error. I was trying to avoid the additional request 🤔 but what do you think? Should we throw a more specific error ?

[JSReds]

Regarding the internal server error: the same issue applies here for teamApplicationAccessId

[JSReds]

I'm not entirely sure, but do you think it's worth updating this method to accept one of the following options?

For example:

applicationIdOrSlug: number | string | number[] | string[]  
roleName: BalenaSdk.ApplicationMembershipRoles | BalenaSdk.ApplicationMembershipRoles[]  

Or alternatively:

applicationSlugOrIdAndRole: { idOrSlug: number | string, roleName: BalenaSdk.ApplicationMembershipRoles }[]  

(just consider the idea not names that I gave as an example)

And then wrapping it in a batch function from utils. What do you think?

[thgreasi]

Suggested change

	`new_rename_${TEST_TEAM_NAME}`,
	`${TEST_TEAM_NAME}_new_rename`,

[thgreasi]

Suggested change

	it('should be able to create a new team, using organization id', async function () {
	const teamName = `${TEST_TEAM_NAME}_${Date.now()}`;
	const team = await balena.models.team.create(
	ctx.initialOrganization.id,
	teamName,
	);
	ctx.newTeam1 = team;
	expect(team).to.have.property('name', teamName);
	});
	it('should be able to create a new team, using organization handle', async function () {
	const teamName = `${TEST_TEAM_NAME}_${Date.now()}_2`;
	const team = await balena.models.team.create(
	ctx.initialOrganization.handle,
	teamName,
	);
	ctx.newTeam2 = team;
	expect(team).to.have.property('name', teamName);
	});
	for (const propName of organizationRetrievalFields) {
	it(`should be able to create a new team, using organization ${propName}`, async function () {
	const teamName = `${TEST_TEAM_NAME}_${Date.now()}_${propName}`;
	const team = await balena.models.team.create(
	ctx.initialOrganization[propName],
	teamName,
	);
	ctx.newTeam1 = team;
	expect(team).to.have.property('name', teamName);
	});
	}