@letpeoplework/lighthouse-client 1.0.1 → 1.2.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,
@@ -703,6 +704,8 @@ 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`);
   d.setUTCDate(d.getUTCDate() + days);
@@ -752,408 +755,565 @@ 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"
+};
+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) => {
-    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)}`,
-      { 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) => {
-    const r = getResolvedMetricsDateRange(range);
-    return requestJson(
+      `/v1/worktrackingsystemconnections/${connectionId}`,
+      {
+        method: "DELETE"
+      }
+    ),
+    listTeams: async () => requestJson(
       configuration,
       dependencies,
-      `/v1/teams/${teamId}/metrics/multiitemforecastpredictabilityscore?${getMetricsDateRangeQuery(r)}`,
-      { 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" }
+    ),
+    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,
@@ -1161,6 +1321,7 @@ var createLighthouseClient = (configuration, dependencies = {}) => ({
   getClientPackageContract,
   getDefaultMetricsDateRange,
   getStandaloneDiscoveryLockfilePath,
+  isServerVersionNewerThan,
   loadStandaloneDiscoveryContract,
   parseStandaloneDiscoveryContract,
   pollCliAuthSession,