@letpeoplework/lighthouse-client 1.1.0 → 1.3.0

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   getClientPackageContract: () => getClientPackageContract,
   getDefaultMetricsDateRange: () => getDefaultMetricsDateRange,
   getStandaloneDiscoveryLockfilePath: () => getStandaloneDiscoveryLockfilePath,
+  isServerVersionNewerThan: () => isServerVersionNewerThan,
   loadStandaloneDiscoveryContract: () => loadStandaloneDiscoveryContract,
   parseStandaloneDiscoveryContract: () => parseStandaloneDiscoveryContract,
   pollCliAuthSession: () => pollCliAuthSession,
@@ -578,6 +579,47 @@ var toApiError = (statusCode, reason) => ({
   reason,
   statusCode
 });
+var CONCURRENCY_CONFLICT_STATUS = 409;
+var CONCURRENCY_CONFLICT_GUIDANCE = "This edit conflicts because the item was changed by someone else. Re-fetch the current settings to obtain the latest concurrency token, then re-apply your change.";
+var getProblemDetailsMessage = (body) => {
+  if (!isObjectRecord(body)) {
+    return void 0;
+  }
+  for (const key of ["detail", "title", "message"]) {
+    const value = body[key];
+    if (typeof value === "string" && value.trim().length > 0) {
+      return value.trim();
+    }
+  }
+  return void 0;
+};
+var getResponseBody = async (response) => {
+  try {
+    if (response.json !== void 0) {
+      return await response.json();
+    }
+    return JSON.parse(await response.text());
+  } catch {
+    return void 0;
+  }
+};
+var toConcurrencyConflictError = (serverMessage) => ({
+  category: "concurrency-conflict",
+  reason: serverMessage === void 0 ? CONCURRENCY_CONFLICT_GUIDANCE : `${serverMessage} ${CONCURRENCY_CONFLICT_GUIDANCE}`,
+  statusCode: CONCURRENCY_CONFLICT_STATUS
+});
+var toResponseError = async (response) => {
+  if (response.status === CONCURRENCY_CONFLICT_STATUS) {
+    const serverMessage = getProblemDetailsMessage(
+      await getResponseBody(response)
+    );
+    return toConcurrencyConflictError(serverMessage);
+  }
+  return toApiError(
+    response.status,
+    `Request failed with status ${response.status}.`
+  );
+};
 var requestText = async (configuration, dependencies, route) => {
   const fetchDependency = getFetchDependency(dependencies);
   const connectivityResult = await validateLighthouseConnectivity(
@@ -596,12 +638,7 @@ var requestText = async (configuration, dependencies, route) => {
       getRequestInit(configuration.auth)
     );
     if (!response.ok) {
-      return getErrorResult(
-        toApiError(
-          response.status,
-          `Request failed with status ${response.status}.`
-        )
-      );
+      return getErrorResult(await toResponseError(response));
     }
     return {
       ok: true,
@@ -635,12 +672,7 @@ var requestJson = async (configuration, dependencies, route, requestOptions) =>
       getRequestInit(configuration.auth, requestOptions)
     );
     if (!response.ok) {
-      return getErrorResult(
-        toApiError(
-          response.status,
-          `Request failed with status ${response.status}.`
-        )
-      );
+      return getErrorResult(await toResponseError(response));
     }
     if (response.json === void 0) {
       return {
@@ -681,12 +713,7 @@ var requestNoContent = async (configuration, dependencies, route, requestOptions
       getRequestInit(configuration.auth, requestOptions)
     );
     if (!response.ok) {
-      return getErrorResult(
-        toApiError(
-          response.status,
-          `Request failed with status ${response.status}.`
-        )
-      );
+      return getErrorResult(await toResponseError(response));
     }
     return {
       ok: true,
@@ -703,6 +730,7 @@ var requestNoContent = async (configuration, dependencies, route, requestOptions
 var getResolvedMetricsDateRange = (range) => range ?? getDefaultMetricsDateRange();
 var getMetricsDateRangeQuery = (range) => `startDate=${encodeURIComponent(range.startDate)}&endDate=${encodeURIComponent(range.endDate)}`;
 var getMetricsAsOfDateQuery = (asOfDate) => `asOfDate=${encodeURIComponent(asOfDate)}`;
+var getItemIdsQuerySuffix = (itemIds) => itemIds && itemIds.length > 0 ? itemIds.map((id) => `&itemIds=${encodeURIComponent(id)}`).join("") : "";
 var getViewQuerySuffix = (view) => view === "filtered" ? "&view=filtered" : "";
 var addUtcDays = (dateStr, days) => {
   const d = /* @__PURE__ */ new Date(`${dateStr}T00:00:00Z`);
@@ -753,408 +781,614 @@ var deriveTotalWorkItemAgeOverTime = (startDate, endDate, wipData) => {
   daily.sort((a, b) => a.date.localeCompare(b.date));
   return { startDate, endDate, daily };
 };
-var createLighthouseClient = (configuration, dependencies = {}) => ({
-  checkConnectivity: async () => {
-    const fetchDependency = getFetchDependency(dependencies);
-    return validateLighthouseConnectivity(
-      configuration.connection,
-      {
-        fetch: fetchDependency
-      },
-      getRequestInit(configuration.auth)
-    );
-  },
-  getVersion: async () => requestText(configuration, dependencies, "/v1/version/current"),
-  listWorkTrackingConnections: async () => requestJson(
-    configuration,
-    dependencies,
-    "/v1/worktrackingsystemconnections",
-    {
-      method: "GET"
-    }
-  ),
-  getWorkTrackingConnection: async (connectionId) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/worktrackingsystemconnections/${connectionId}`,
-    {
-      method: "GET"
-    }
-  ),
-  createWorkTrackingConnection: async (payload) => requestJson(
-    configuration,
-    dependencies,
-    "/v1/worktrackingsystemconnections",
-    {
-      method: "POST",
-      body: payload
-    }
-  ),
-  updateWorkTrackingConnection: async (connectionId, payload) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/worktrackingsystemconnections/${connectionId}`,
-    {
-      method: "PUT",
-      body: payload
-    }
-  ),
-  deleteWorkTrackingConnection: async (connectionId) => requestNoContent(
-    configuration,
-    dependencies,
-    `/v1/worktrackingsystemconnections/${connectionId}`,
-    {
-      method: "DELETE"
-    }
-  ),
-  listTeams: async () => requestJson(configuration, dependencies, "/v1/teams", {
-    method: "GET"
-  }),
-  getTeam: async (teamId) => requestJson(configuration, dependencies, `/v1/teams/${teamId}`, {
-    method: "GET"
-  }),
-  createTeam: async (payload) => requestJson(configuration, dependencies, "/v1/teams", {
-    method: "POST",
-    body: payload
-  }),
-  updateTeam: async (teamId, payload) => requestJson(configuration, dependencies, `/v1/teams/${teamId}`, {
-    method: "PUT",
-    body: payload
-  }),
-  deleteTeam: async (teamId) => requestNoContent(configuration, dependencies, `/v1/teams/${teamId}`, {
-    method: "DELETE"
-  }),
-  refreshTeam: async (teamId) => requestNoContent(configuration, dependencies, `/v1/teams/${teamId}`, {
-    method: "POST"
-  }),
-  listPortfolios: async () => requestJson(
-    configuration,
-    dependencies,
-    "/v1/portfolios",
-    {
-      method: "GET"
+var FEATURE_REQUIRES_SERVER_NEWER_THAN = {
+  cumulativeStateTime: "v26.5.24.10",
+  recurringBlackoutRules: "v26.5.29.5"
+};
+var parseServerVersion = (raw) => {
+  const trimmed = raw.trim().replace(/^v/iu, "");
+  if (trimmed.length === 0) {
+    return null;
+  }
+  const segments = trimmed.split(".");
+  const parsed = [];
+  for (const segment of segments) {
+    if (!/^\d+$/u.test(segment)) {
+      return null;
     }
-  ),
-  getPortfolio: async (portfolioId) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/portfolios/${portfolioId}`,
-    {
-      method: "GET"
+    parsed.push(Number(segment));
+  }
+  return parsed.length > 0 ? parsed : null;
+};
+var isServerVersionNewerThan = (candidate, baseline) => {
+  const left = parseServerVersion(candidate);
+  const right = parseServerVersion(baseline);
+  if (left === null || right === null) {
+    return null;
+  }
+  const length = Math.max(left.length, right.length);
+  for (let index = 0; index < length; index += 1) {
+    const l = left[index] ?? 0;
+    const r = right[index] ?? 0;
+    if (l !== r) {
+      return l > r;
     }
-  ),
-  createPortfolio: async (payload) => requestJson(configuration, dependencies, "/v1/portfolios", {
-    method: "POST",
-    body: payload
-  }),
-  updatePortfolio: async (portfolioId, payload) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/portfolios/${portfolioId}`,
-    {
-      method: "PUT",
-      body: payload
+  }
+  return false;
+};
+var createLighthouseClient = (configuration, dependencies = {}) => {
+  let cachedServerVersion;
+  const getCachedServerVersion = async () => {
+    if (cachedServerVersion === void 0) {
+      const result = await requestText(
+        configuration,
+        dependencies,
+        "/v1/version/current"
+      );
+      cachedServerVersion = result.ok ? result.value : null;
     }
-  ),
-  deletePortfolio: async (portfolioId) => requestNoContent(
-    configuration,
-    dependencies,
-    `/v1/portfolios/${portfolioId}`,
-    {
-      method: "DELETE"
+    return cachedServerVersion;
+  };
+  const ensureServerSupports = async (feature) => {
+    const version = await getCachedServerVersion();
+    if (version === null) {
+      return null;
     }
-  ),
-  refreshPortfolio: async (portfolioId) => requestNoContent(
-    configuration,
-    dependencies,
-    `/v1/portfolios/${portfolioId}/refresh`,
-    {
-      method: "POST"
+    const baseline = FEATURE_REQUIRES_SERVER_NEWER_THAN[feature];
+    const newer = isServerVersionNewerThan(version, baseline);
+    if (newer === null || newer) {
+      return null;
     }
-  ),
-  getTeamThroughput: async (teamId, range, view) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+    return {
+      ok: false,
+      error: {
+        category: "misconfigured",
+        reason: `This Lighthouse server (${version}) does not support "${feature}" \u2014 it requires a version newer than ${baseline}. Upgrade Lighthouse to use this client feature.`
+      }
+    };
+  };
+  return {
+    checkConnectivity: async () => {
+      const fetchDependency = getFetchDependency(dependencies);
+      return validateLighthouseConnectivity(
+        configuration.connection,
+        {
+          fetch: fetchDependency
+        },
+        getRequestInit(configuration.auth)
+      );
+    },
+    getVersion: async () => requestText(configuration, dependencies, "/v1/version/current"),
+    listWorkTrackingConnections: async () => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/throughput?${getMetricsDateRangeQuery(r)}${getViewQuerySuffix(view)}`,
-      { method: "GET" }
-    );
-  },
-  getTeamArrivals: async (teamId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      "/v1/worktrackingsystemconnections",
+      {
+        method: "GET"
+      }
+    ),
+    getWorkTrackingConnection: async (connectionId) => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/arrivals?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-  },
-  getTeamWipOverTime: async (teamId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      `/v1/worktrackingsystemconnections/${connectionId}`,
+      {
+        method: "GET"
+      }
+    ),
+    createWorkTrackingConnection: async (payload) => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-  },
-  getTeamWip: async (teamId, asOfDate) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/teams/${teamId}/metrics/wip?${getMetricsAsOfDateQuery(asOfDate)}`,
-    { method: "GET" }
-  ),
-  getTeamCycleTimePercentiles: async (teamId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      "/v1/worktrackingsystemconnections",
+      {
+        method: "POST",
+        body: payload
+      }
+    ),
+    updateWorkTrackingConnection: async (connectionId, payload) => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-  },
-  getTeamCycleTimeData: async (teamId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      `/v1/worktrackingsystemconnections/${connectionId}`,
+      {
+        method: "PUT",
+        body: payload
+      }
+    ),
+    deleteWorkTrackingConnection: async (connectionId) => requestNoContent(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/cycleTimeData?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-  },
-  getTeamPredictabilityScore: async (teamId, range, view) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      `/v1/worktrackingsystemconnections/${connectionId}`,
+      {
+        method: "DELETE"
+      }
+    ),
+    listTeams: async () => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/multiitemforecastpredictabilityscore?${getMetricsDateRangeQuery(r)}${getViewQuerySuffix(view)}`,
-      { method: "GET" }
-    );
-  },
-  getTeamTotalWorkItemAge: async (teamId, asOfDate) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/teams/${teamId}/metrics/totalWorkItemAge?${getMetricsAsOfDateQuery(asOfDate)}`,
-    { method: "GET" }
-  ),
-  getTeamTotalWorkItemAgeInfo: async (teamId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      "/v1/teams",
+      {
+        method: "GET"
+      }
+    ),
+    getTeam: async (teamId) => requestJson(configuration, dependencies, `/v1/teams/${teamId}`, {
+      method: "GET"
+    }),
+    createTeam: async (payload) => requestJson(configuration, dependencies, "/v1/teams", {
+      method: "POST",
+      body: payload
+    }),
+    updateTeam: async (teamId, payload) => requestJson(configuration, dependencies, `/v1/teams/${teamId}`, {
+      method: "PUT",
+      body: payload
+    }),
+    deleteTeam: async (teamId) => requestNoContent(configuration, dependencies, `/v1/teams/${teamId}`, {
+      method: "DELETE"
+    }),
+    refreshTeam: async (teamId) => requestNoContent(configuration, dependencies, `/v1/teams/${teamId}`, {
+      method: "POST"
+    }),
+    listPortfolios: async () => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/totalWorkItemAgeInfo?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-  },
-  getTeamWorkItemAgeOverTime: async (teamId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    const wipResult = await requestJson(
+      "/v1/portfolios",
+      {
+        method: "GET"
+      }
+    ),
+    getPortfolio: async (portfolioId) => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-    if (!wipResult.ok) {
-      return wipResult;
-    }
-    return {
-      ok: true,
-      value: deriveWorkItemAgeOverTime(r.startDate, r.endDate, wipResult.value)
-    };
-  },
-  getTeamTotalWorkItemAgeOverTime: async (teamId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    const wipResult = await requestJson(
+      `/v1/portfolios/${portfolioId}`,
+      {
+        method: "GET"
+      }
+    ),
+    createPortfolio: async (payload) => requestJson(configuration, dependencies, "/v1/portfolios", {
+      method: "POST",
+      body: payload
+    }),
+    updatePortfolio: async (portfolioId, payload) => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-    if (!wipResult.ok) {
-      return wipResult;
-    }
-    return {
-      ok: true,
-      value: deriveTotalWorkItemAgeOverTime(
-        r.startDate,
-        r.endDate,
-        wipResult.value
-      )
-    };
-  },
-  getPortfolioThroughput: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      `/v1/portfolios/${portfolioId}`,
+      {
+        method: "PUT",
+        body: payload
+      }
+    ),
+    deletePortfolio: async (portfolioId) => requestNoContent(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/throughput?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-  },
-  getPortfolioCycleTimePercentiles: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      `/v1/portfolios/${portfolioId}`,
+      {
+        method: "DELETE"
+      }
+    ),
+    refreshPortfolio: async (portfolioId) => requestNoContent(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-  },
-  getPortfolioArrivals: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      `/v1/portfolios/${portfolioId}/refresh`,
+      {
+        method: "POST"
+      }
+    ),
+    getTeamThroughput: async (teamId, range, view) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/throughput?${getMetricsDateRangeQuery(r)}${getViewQuerySuffix(view)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamArrivals: async (teamId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/arrivals?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamWipOverTime: async (teamId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamWip: async (teamId, asOfDate) => requestJson(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/arrivals?${getMetricsDateRangeQuery(r)}`,
+      `/v1/teams/${teamId}/metrics/wip?${getMetricsAsOfDateQuery(asOfDate)}`,
       { method: "GET" }
-    );
-  },
-  getPortfolioWipOverTime: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+    ),
+    getTeamCycleTimePercentiles: async (teamId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamCycleTimeData: async (teamId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/cycleTimeData?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamPredictabilityScore: async (teamId, range, view) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/multiitemforecastpredictabilityscore?${getMetricsDateRangeQuery(r)}${getViewQuerySuffix(view)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamTotalWorkItemAge: async (teamId, asOfDate) => requestJson(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+      `/v1/teams/${teamId}/metrics/totalWorkItemAge?${getMetricsAsOfDateQuery(asOfDate)}`,
       { method: "GET" }
-    );
-  },
-  getPortfolioWip: async (portfolioId, asOfDate) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/portfolios/${portfolioId}/metrics/wip?${getMetricsAsOfDateQuery(asOfDate)}`,
-    { method: "GET" }
-  ),
-  getPortfolioCycleTimeData: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+    ),
+    getTeamTotalWorkItemAgeInfo: async (teamId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/totalWorkItemAgeInfo?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamWorkItemAgeOverTime: async (teamId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      const wipResult = await requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+      if (!wipResult.ok) {
+        return wipResult;
+      }
+      return {
+        ok: true,
+        value: deriveWorkItemAgeOverTime(
+          r.startDate,
+          r.endDate,
+          wipResult.value
+        )
+      };
+    },
+    getTeamTotalWorkItemAgeOverTime: async (teamId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      const wipResult = await requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+      if (!wipResult.ok) {
+        return wipResult;
+      }
+      return {
+        ok: true,
+        value: deriveTotalWorkItemAgeOverTime(
+          r.startDate,
+          r.endDate,
+          wipResult.value
+        )
+      };
+    },
+    getPortfolioThroughput: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/throughput?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioCycleTimePercentiles: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioArrivals: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/arrivals?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioWipOverTime: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioWip: async (portfolioId, asOfDate) => requestJson(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/cycleTimeData?${getMetricsDateRangeQuery(r)}`,
+      `/v1/portfolios/${portfolioId}/metrics/wip?${getMetricsAsOfDateQuery(asOfDate)}`,
       { method: "GET" }
-    );
-  },
-  getPortfolioPredictabilityScore: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+    ),
+    getPortfolioCycleTimeData: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/cycleTimeData?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioPredictabilityScore: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/multiitemforecastpredictabilityscore?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioTotalWorkItemAge: async (portfolioId, asOfDate) => requestJson(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/multiitemforecastpredictabilityscore?${getMetricsDateRangeQuery(r)}`,
+      `/v1/portfolios/${portfolioId}/metrics/totalWorkItemAge?${getMetricsAsOfDateQuery(asOfDate)}`,
       { method: "GET" }
-    );
-  },
-  getPortfolioTotalWorkItemAge: async (portfolioId, asOfDate) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/portfolios/${portfolioId}/metrics/totalWorkItemAge?${getMetricsAsOfDateQuery(asOfDate)}`,
-    { method: "GET" }
-  ),
-  getPortfolioTotalWorkItemAgeInfo: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+    ),
+    getPortfolioTotalWorkItemAgeInfo: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/totalWorkItemAgeInfo?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioWorkItemAgeOverTime: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      const wipResult = await requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+      if (!wipResult.ok) {
+        return wipResult;
+      }
+      return {
+        ok: true,
+        value: deriveWorkItemAgeOverTime(
+          r.startDate,
+          r.endDate,
+          wipResult.value
+        )
+      };
+    },
+    getPortfolioTotalWorkItemAgeOverTime: async (portfolioId, range) => {
+      const r = getResolvedMetricsDateRange(range);
+      const wipResult = await requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+      if (!wipResult.ok) {
+        return wipResult;
+      }
+      return {
+        ok: true,
+        value: deriveTotalWorkItemAgeOverTime(
+          r.startDate,
+          r.endDate,
+          wipResult.value
+        )
+      };
+    },
+    getTeamCumulativeStateTime: async (teamId, range, itemIds) => {
+      const unsupported = await ensureServerSupports("cumulativeStateTime");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/cumulativeStateTime?${getMetricsDateRangeQuery(r)}${getItemIdsQuerySuffix(itemIds)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamCumulativeStateTimeItems: async (teamId, state, range, itemIds) => {
+      const unsupported = await ensureServerSupports("cumulativeStateTime");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/cumulativeStateTime/items?state=${encodeURIComponent(state)}&${getMetricsDateRangeQuery(r)}${getItemIdsQuerySuffix(itemIds)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamCumulativeStateTimeCandidates: async (teamId, range) => {
+      const unsupported = await ensureServerSupports("cumulativeStateTime");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/cumulativeStateTime/candidates?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioCumulativeStateTime: async (portfolioId, range, itemIds) => {
+      const unsupported = await ensureServerSupports("cumulativeStateTime");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/cumulativeStateTime?${getMetricsDateRangeQuery(r)}${getItemIdsQuerySuffix(itemIds)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioCumulativeStateTimeItems: async (portfolioId, state, range, itemIds) => {
+      const unsupported = await ensureServerSupports("cumulativeStateTime");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/cumulativeStateTime/items?state=${encodeURIComponent(state)}&${getMetricsDateRangeQuery(r)}${getItemIdsQuerySuffix(itemIds)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioCumulativeStateTimeCandidates: async (portfolioId, range) => {
+      const unsupported = await ensureServerSupports("cumulativeStateTime");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/cumulativeStateTime/candidates?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getFeaturesByIds: async (ids) => {
+      const queryString = ids.map((id) => `ids=${encodeURIComponent(id)}`).join("&");
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/features?${queryString}`,
+        { method: "GET" }
+      );
+    },
+    getFeaturesByReferences: async (refs) => {
+      const queryString = refs.map((r) => `featureReferences=${encodeURIComponent(r)}`).join("&");
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/features/references?${queryString}`,
+        { method: "GET" }
+      );
+    },
+    getFeatureWorkItems: async (featureId) => requestJson(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/totalWorkItemAgeInfo?${getMetricsDateRangeQuery(r)}`,
+      `/v1/features/${featureId}/workitems`,
       { method: "GET" }
-    );
-  },
-  getPortfolioWorkItemAgeOverTime: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    const wipResult = await requestJson(
+    ),
+    listDeliveries: async (portfolioId) => requestJson(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
+      `/v1/deliveries/portfolio/${portfolioId}`,
       { method: "GET" }
-    );
-    if (!wipResult.ok) {
-      return wipResult;
-    }
-    return {
-      ok: true,
-      value: deriveWorkItemAgeOverTime(r.startDate, r.endDate, wipResult.value)
-    };
-  },
-  getPortfolioTotalWorkItemAgeOverTime: async (portfolioId, range) => {
-    const r = getResolvedMetricsDateRange(range);
-    const wipResult = await requestJson(
+    ),
+    createDelivery: async (portfolioId, payload) => requestJson(
       configuration,
       dependencies,
-      `/v1/portfolios/${portfolioId}/metrics/wipOverTime?${getMetricsDateRangeQuery(r)}`,
-      { method: "GET" }
-    );
-    if (!wipResult.ok) {
-      return wipResult;
-    }
-    return {
-      ok: true,
-      value: deriveTotalWorkItemAgeOverTime(
-        r.startDate,
-        r.endDate,
-        wipResult.value
-      )
-    };
-  },
-  getFeaturesByIds: async (ids) => {
-    const queryString = ids.map((id) => `ids=${encodeURIComponent(id)}`).join("&");
-    return requestJson(
+      `/v1/deliveries/portfolio/${portfolioId}`,
+      { method: "POST", body: payload }
+    ),
+    updateDelivery: async (deliveryId, payload) => requestJson(
       configuration,
       dependencies,
-      `/v1/features?${queryString}`,
-      { method: "GET" }
-    );
-  },
-  getFeaturesByReferences: async (refs) => {
-    const queryString = refs.map((r) => `featureReferences=${encodeURIComponent(r)}`).join("&");
-    return requestJson(
+      `/v1/deliveries/${deliveryId}`,
+      { method: "PUT", body: payload }
+    ),
+    deleteDelivery: async (deliveryId) => requestNoContent(
       configuration,
       dependencies,
-      `/v1/features/references?${queryString}`,
-      { method: "GET" }
-    );
-  },
-  getFeatureWorkItems: async (featureId) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/features/${featureId}/workitems`,
-    { method: "GET" }
-  ),
-  listDeliveries: async (portfolioId) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/deliveries/portfolio/${portfolioId}`,
-    { method: "GET" }
-  ),
-  createDelivery: async (portfolioId, payload) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/deliveries/portfolio/${portfolioId}`,
-    { method: "POST", body: payload }
-  ),
-  updateDelivery: async (deliveryId, payload) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/deliveries/${deliveryId}`,
-    { method: "PUT", body: payload }
-  ),
-  deleteDelivery: async (deliveryId) => requestNoContent(
-    configuration,
-    dependencies,
-    `/v1/deliveries/${deliveryId}`,
-    { method: "DELETE" }
-  ),
-  runManualForecast: async (teamId, payload) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/forecast/manual/${teamId}`,
-    { method: "POST", body: payload }
-  ),
-  runBacktest: async (teamId, payload) => requestJson(
-    configuration,
-    dependencies,
-    `/v1/forecast/backtest/${teamId}`,
-    { method: "POST", body: payload }
-  )
-});
+      `/v1/deliveries/${deliveryId}`,
+      { method: "DELETE" }
+    ),
+    getRecurringBlackoutRules: async () => {
+      const unsupported = await ensureServerSupports("recurringBlackoutRules");
+      if (unsupported) {
+        return unsupported;
+      }
+      return requestJson(
+        configuration,
+        dependencies,
+        "/v1/recurring-blackout-rules",
+        { method: "GET" }
+      );
+    },
+    createRecurringBlackoutRule: async (payload) => {
+      const unsupported = await ensureServerSupports("recurringBlackoutRules");
+      if (unsupported) {
+        return unsupported;
+      }
+      return requestJson(
+        configuration,
+        dependencies,
+        "/v1/recurring-blackout-rules",
+        { method: "POST", body: payload }
+      );
+    },
+    updateRecurringBlackoutRule: async (id, payload) => {
+      const unsupported = await ensureServerSupports("recurringBlackoutRules");
+      if (unsupported) {
+        return unsupported;
+      }
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/recurring-blackout-rules/${id}`,
+        { method: "PUT", body: payload }
+      );
+    },
+    deleteRecurringBlackoutRule: async (id) => {
+      const unsupported = await ensureServerSupports("recurringBlackoutRules");
+      if (unsupported) {
+        return unsupported;
+      }
+      return requestNoContent(
+        configuration,
+        dependencies,
+        `/v1/recurring-blackout-rules/${id}`,
+        { method: "DELETE" }
+      );
+    },
+    runManualForecast: async (teamId, payload) => requestJson(
+      configuration,
+      dependencies,
+      `/v1/forecast/manual/${teamId}`,
+      { method: "POST", body: payload }
+    ),
+    runBacktest: async (teamId, payload) => requestJson(
+      configuration,
+      dependencies,
+      `/v1/forecast/backtest/${teamId}`,
+      { method: "POST", body: payload }
+    )
+  };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createLighthouseAuthContext,
@@ -1162,6 +1396,7 @@ var createLighthouseClient = (configuration, dependencies = {}) => ({
   getClientPackageContract,
   getDefaultMetricsDateRange,
   getStandaloneDiscoveryLockfilePath,
+  isServerVersionNewerThan,
   loadStandaloneDiscoveryContract,
   parseStandaloneDiscoveryContract,
   pollCliAuthSession,