teams.ts

packages/ninety-client/src/resources/teams.ts

1. /**
2. * Teams. GET /teams, confirmed against the live API.
3. *
4. * Returns a bare array of { _id, name, companyId, project, deleted }.
5. *
6. * No membership: there is no users, members, or userIds field, which is why
7. * the harvest path in roster.ts is required, not a fallback. Re-check the live
8. * response before assuming otherwise; it is cheap to check and expensive to
9. * assume.
10. *
11. * Meridian has three: Leadership Team, Operations Team, All Hands.
12. */
14. import type { HttpClient } from './../http.js'
15. import { RawTeamSchema, normalizeTeam, type Team } from './../types.js'
17. export interface TeamQuery {
18. /** Ninety models projects as teams. Excluded by default. */
19. includeProjects?: boolean
20. includeDeleted?: boolean
21. }
23. export class TeamsResource {
24. constructor(private readonly http: HttpClient) {}
26. async list(q: TeamQuery = {}): Promise<Team[]> {
27. const raw = await this.http.get('/teams')
28. if (!Array.isArray(raw)) {
29. throw new Error(`GET /teams did not return an array (got ${typeof raw}). Shape changed; update teams.ts.`)
30. }
31. const teams = raw.map((t) => normalizeTeam(RawTeamSchema.parse(t)))
32. return teams.filter(
33. (t) => (q.includeDeleted || !t.deleted) && (q.includeProjects || !t.isProject),
34. )
35. }
37. /** Name lookup for rendering, though to-dos already carry `teamName`. */
38. async byId(): Promise<Map<string, Team>> {
39. const teams = await this.list({ includeProjects: true, includeDeleted: true })
40. return new Map(teams.map((t) => [t.id, t]))
41. }
42. }