feat(grafanaplane/oncall): add helpers to set teamId on schedules and shifts (#93)

* feat(grafanaplane/oncall): add helpers to set teamId on schedules and shifts

* docs

Author: Duologic

docs/oncall/schedule/index.md

@@ -15,6 +15,7 @@
   * [`fn withShifts(shifts)`](#fn-calendarwithshifts)
   * [`fn withSlackChannelId(value)`](#fn-calendarwithslackchannelid)
   * [`fn withSlackUserGroup(value)`](#fn-calendarwithslackusergroup)
+  * [`fn withTeamId(teamId)`](#fn-calendarwithteamid)
   * [`fn withTimeZone(value)`](#fn-calendarwithtimezone)
 
 ## Fields
@@ -131,6 +132,21 @@ PARAMETERS:
 
 call users change.
 Slack user group id. Members of user group will be updated when on-call users change.
+#### fn calendar.withTeamId
+
+```jsonnet
+calendar.withTeamId(teamId)
+```
+
+PARAMETERS:
+
+* **teamId** (`string`)
+
+`withTeamId` configures the Team ID on the schedule and shifts.
+
+Parameters:
+  - `teamId` should be the ID of the team as a string.
+
 #### fn calendar.withTimeZone
 
 ```jsonnet

grafanaplane/oncall/schedule.libsonnet

@@ -81,6 +81,9 @@ local forProvider = schedule.spec.parameters.forProvider;
         shift
         // Inject matching labels to identify Shifts as belonging to this Schedule.
         + raw.oncall.v1alpha1.onCallShift.spec.parameters.withSelectorLabel('schedule-%s' % self.claimName)
+        + (if std.objectHas(self.schedule.spec.parameters.forProvider, 'teamId')
+           then raw.oncall.v1alpha1.onCallShift.spec.parameters.forProvider.withTeamId(self.schedule.spec.parameters.forProvider.teamId)
+           else {})
         for shift in self.shifts
       ],
     },
@@ -93,6 +96,23 @@ local forProvider = schedule.spec.parameters.forProvider;
       claimName:: claimName,
     },
 
+    '#withTeamId':: d.func.new(
+      |||
+        `withTeamId` configures the Team ID on the schedule and shifts.
+
+        Parameters:
+          - `teamId` should be the ID of the team as a string.
+      |||,
+      [
+        d.argument.new('teamId', d.T.string),
+      ]
+    ),
+    withTeamId(teamId):: {
+      // Constructor nests the resource beneath the `chain` key, so we wrap the
+      // raw function to do the same.
+      schedule+: forProvider.withTeamId(teamId),
+    },
+
     '#withShifts':: d.func.new(
       |||
         `withShifts` sets an array of Shifts on a calendar-type Schedule.