@letpeoplework/lighthouse-client 1.2.0 → 1.4.0

package/dist/index.cjs

@@ -579,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(
@@ -597,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,
@@ -636,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 {
@@ -682,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,
@@ -706,6 +732,7 @@ var getMetricsDateRangeQuery = (range) => `startDate=${encodeURIComponent(range.
 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 getDefinitionIdQuerySuffix = (definitionId) => definitionId !== void 0 ? `&definitionId=${encodeURIComponent(definitionId)}` : "";
 var addUtcDays = (dateStr, days) => {
   const d = /* @__PURE__ */ new Date(`${dateStr}T00:00:00Z`);
   d.setUTCDate(d.getUTCDate() + days);
@@ -756,7 +783,9 @@ var deriveTotalWorkItemAgeOverTime = (startDate, endDate, wipData) => {
   return { startDate, endDate, daily };
 };
 var FEATURE_REQUIRES_SERVER_NEWER_THAN = {
-  cumulativeStateTime: "v26.5.24.10"
+  cumulativeStateTime: "v26.5.24.10",
+  recurringBlackoutRules: "v26.5.29.5",
+  workItemAgePercentiles: "v26.6.7.1"
 };
 var parseServerVersion = (raw) => {
   const trimmed = raw.trim().replace(/^v/iu, "");
@@ -977,12 +1006,25 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
       `/v1/teams/${teamId}/metrics/wip?${getMetricsAsOfDateQuery(asOfDate)}`,
       { method: "GET" }
     ),
-    getTeamCycleTimePercentiles: async (teamId, range) => {
+    getTeamCycleTimePercentiles: async (teamId, range, definitionId) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}${getDefinitionIdQuerySuffix(definitionId)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamWorkItemAgePercentiles: async (teamId, range) => {
+      const unsupported = await ensureServerSupports("workItemAgePercentiles");
+      if (unsupported) {
+        return unsupported;
+      }
       const r = getResolvedMetricsDateRange(range);
       return requestJson(
         configuration,
         dependencies,
-        `/v1/teams/${teamId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
+        `/v1/teams/${teamId}/metrics/workItemAgePercentiles?${getMetricsDateRangeQuery(r)}`,
         { method: "GET" }
       );
     },
@@ -1068,12 +1110,25 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
         { method: "GET" }
       );
     },
-    getPortfolioCycleTimePercentiles: async (portfolioId, range) => {
+    getPortfolioCycleTimePercentiles: async (portfolioId, range, definitionId) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}${getDefinitionIdQuerySuffix(definitionId)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioWorkItemAgePercentiles: async (portfolioId, range) => {
+      const unsupported = await ensureServerSupports("workItemAgePercentiles");
+      if (unsupported) {
+        return unsupported;
+      }
       const r = getResolvedMetricsDateRange(range);
       return requestJson(
         configuration,
         dependencies,
-        `/v1/portfolios/${portfolioId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
+        `/v1/portfolios/${portfolioId}/metrics/workItemAgePercentiles?${getMetricsDateRangeQuery(r)}`,
         { method: "GET" }
       );
     },
@@ -1300,6 +1355,54 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
       `/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,

package/dist/index.d.cts

@@ -4,7 +4,7 @@ type ClientPackageContract = {
     readonly capabilities: readonly ClientCapability[];
 };
 declare const getClientPackageContract: () => ClientPackageContract;
-type ConnectivityCategory = "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "unexpected";
+type ConnectivityCategory = "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "concurrency-conflict" | "unexpected";
 type StandaloneDiscoveryContract = {
     readonly contractVersion: 1;
     readonly lighthouseUrl: string;
@@ -257,6 +257,23 @@ type CumulativeStateTimeCandidateRow = {
 type CumulativeStateTimeCandidatesResult = {
     readonly items: readonly CumulativeStateTimeCandidateRow[];
 };
+type DayOfWeek = "Sunday" | "Monday" | "Tuesday" | "Wednesday" | "Thursday" | "Friday" | "Saturday";
+type RecurringBlackoutRule = {
+    readonly id: number;
+    readonly weekdays: readonly DayOfWeek[];
+    readonly intervalWeeks: number;
+    readonly start: string;
+    readonly end: string | null;
+    readonly description: string;
+    readonly summary: string;
+};
+type RecurringBlackoutRuleInput = {
+    readonly weekdays: readonly DayOfWeek[];
+    readonly intervalWeeks: number;
+    readonly start: string;
+    readonly end: string | null;
+    readonly description: string;
+};
 type LighthouseClient = {
     readonly checkConnectivity: () => Promise<ConnectivityValidationResult>;
     readonly getVersion: () => Promise<LighthouseApiResult<string>>;
@@ -281,13 +298,15 @@ type LighthouseClient = {
     readonly getTeamArrivals: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getTeamWipOverTime: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getTeamWip: (teamId: number, asOfDate: string) => Promise<LighthouseApiResult<readonly unknown[]>>;
-    readonly getTeamCycleTimePercentiles: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getTeamCycleTimePercentiles: (teamId: number, range?: MetricsDateRange, definitionId?: number) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getTeamWorkItemAgePercentiles: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getTeamCycleTimeData: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getTeamPredictabilityScore: (teamId: number, range?: MetricsDateRange, view?: ThroughputFilterView) => Promise<LighthouseApiResult<unknown>>;
     readonly getTeamTotalWorkItemAge: (teamId: number, asOfDate: string) => Promise<LighthouseApiResult<number>>;
     readonly getTeamTotalWorkItemAgeInfo: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioThroughput: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
-    readonly getPortfolioCycleTimePercentiles: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getPortfolioCycleTimePercentiles: (portfolioId: number, range?: MetricsDateRange, definitionId?: number) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getPortfolioWorkItemAgePercentiles: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getPortfolioArrivals: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioWipOverTime: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioWip: (portfolioId: number, asOfDate: string) => Promise<LighthouseApiResult<readonly unknown[]>>;
@@ -312,6 +331,10 @@ type LighthouseClient = {
     readonly createDelivery: (portfolioId: number, payload: LighthouseWritePayload) => Promise<LighthouseApiResult<unknown>>;
     readonly updateDelivery: (deliveryId: number, payload: LighthouseWritePayload) => Promise<LighthouseApiResult<unknown>>;
     readonly deleteDelivery: (deliveryId: number) => Promise<LighthouseApiResult<undefined>>;
+    readonly getRecurringBlackoutRules: () => Promise<LighthouseApiResult<readonly RecurringBlackoutRule[]>>;
+    readonly createRecurringBlackoutRule: (payload: LighthouseWritePayload) => Promise<LighthouseApiResult<RecurringBlackoutRule>>;
+    readonly updateRecurringBlackoutRule: (id: number, payload: LighthouseWritePayload) => Promise<LighthouseApiResult<RecurringBlackoutRule>>;
+    readonly deleteRecurringBlackoutRule: (id: number) => Promise<LighthouseApiResult<undefined>>;
     readonly runManualForecast: (teamId: number, payload: ManualForecastInput) => Promise<LighthouseApiResult<unknown>>;
     readonly runBacktest: (teamId: number, payload: BacktestInput) => Promise<LighthouseApiResult<unknown>>;
 };
@@ -326,4 +349,4 @@ type LighthouseClientDependencies = {
 declare const isServerVersionNewerThan: (candidate: string, baseline: string) => boolean | null;
 declare const createLighthouseClient: (configuration: LighthouseClientConfiguration, dependencies?: LighthouseClientDependencies) => LighthouseClient;
 
-export { type BacktestInput, type CliAuthSessionPollResult, type CliAuthSessionStartError, type CliAuthSessionStartOutcome, type CliAuthSessionStartResult, type CliConnection, type CliServerAuthMode, type CliServerConnection, type CliStandaloneConnection, type ClientCapability, type ClientPackageContract, type ConnectivityCategory, type ConnectivityDependencies, type ConnectivityFetchResponse, type ConnectivityValidationResult, type CumulativeStateTimeCandidateRow, type CumulativeStateTimeCandidatesResult, type CumulativeStateTimeItemRow, type CumulativeStateTimeItemsResult, type CumulativeStateTimeResult, type CumulativeStateTimeStateRow, type DailyTotalWorkItemAge, type DailyWorkItemAge, type LighthouseApiError, type LighthouseApiResult, type LighthouseAuthContext, type LighthouseAuthOverrides, type LighthouseAuthStatus, type LighthouseAuthStore, type LighthouseClient, type LighthouseClientAuth, type LighthouseClientConfiguration, type LighthouseClientDependencies, type LighthouseConnectionConfiguration, type LighthouseWritePayload, type ManualForecastInput, type MetricsDateRange, type ResolvedLighthouseEndpoint, type ServerAuthModeResult, type StandaloneDiscoveryContract, type StandaloneDiscoveryContractParseResult, type StoredLighthouseAuth, type ThroughputFilterView, type TotalWorkItemAgeOverTimeResult, type WorkItemAgeEntry, type WorkItemAgeOverTimeResult, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, isServerVersionNewerThan, loadStandaloneDiscoveryContract, parseStandaloneDiscoveryContract, pollCliAuthSession, queryServerAuthMode, startCliAuthSession, validateLighthouseConnectivity };
+export { type BacktestInput, type CliAuthSessionPollResult, type CliAuthSessionStartError, type CliAuthSessionStartOutcome, type CliAuthSessionStartResult, type CliConnection, type CliServerAuthMode, type CliServerConnection, type CliStandaloneConnection, type ClientCapability, type ClientPackageContract, type ConnectivityCategory, type ConnectivityDependencies, type ConnectivityFetchResponse, type ConnectivityValidationResult, type CumulativeStateTimeCandidateRow, type CumulativeStateTimeCandidatesResult, type CumulativeStateTimeItemRow, type CumulativeStateTimeItemsResult, type CumulativeStateTimeResult, type CumulativeStateTimeStateRow, type DailyTotalWorkItemAge, type DailyWorkItemAge, type DayOfWeek, type LighthouseApiError, type LighthouseApiResult, type LighthouseAuthContext, type LighthouseAuthOverrides, type LighthouseAuthStatus, type LighthouseAuthStore, type LighthouseClient, type LighthouseClientAuth, type LighthouseClientConfiguration, type LighthouseClientDependencies, type LighthouseConnectionConfiguration, type LighthouseWritePayload, type ManualForecastInput, type MetricsDateRange, type RecurringBlackoutRule, type RecurringBlackoutRuleInput, type ResolvedLighthouseEndpoint, type ServerAuthModeResult, type StandaloneDiscoveryContract, type StandaloneDiscoveryContractParseResult, type StoredLighthouseAuth, type ThroughputFilterView, type TotalWorkItemAgeOverTimeResult, type WorkItemAgeEntry, type WorkItemAgeOverTimeResult, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, isServerVersionNewerThan, loadStandaloneDiscoveryContract, parseStandaloneDiscoveryContract, pollCliAuthSession, queryServerAuthMode, startCliAuthSession, validateLighthouseConnectivity };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ type ClientPackageContract = {
     readonly capabilities: readonly ClientCapability[];
 };
 declare const getClientPackageContract: () => ClientPackageContract;
-type ConnectivityCategory = "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "unexpected";
+type ConnectivityCategory = "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "concurrency-conflict" | "unexpected";
 type StandaloneDiscoveryContract = {
     readonly contractVersion: 1;
     readonly lighthouseUrl: string;
@@ -257,6 +257,23 @@ type CumulativeStateTimeCandidateRow = {
 type CumulativeStateTimeCandidatesResult = {
     readonly items: readonly CumulativeStateTimeCandidateRow[];
 };
+type DayOfWeek = "Sunday" | "Monday" | "Tuesday" | "Wednesday" | "Thursday" | "Friday" | "Saturday";
+type RecurringBlackoutRule = {
+    readonly id: number;
+    readonly weekdays: readonly DayOfWeek[];
+    readonly intervalWeeks: number;
+    readonly start: string;
+    readonly end: string | null;
+    readonly description: string;
+    readonly summary: string;
+};
+type RecurringBlackoutRuleInput = {
+    readonly weekdays: readonly DayOfWeek[];
+    readonly intervalWeeks: number;
+    readonly start: string;
+    readonly end: string | null;
+    readonly description: string;
+};
 type LighthouseClient = {
     readonly checkConnectivity: () => Promise<ConnectivityValidationResult>;
     readonly getVersion: () => Promise<LighthouseApiResult<string>>;
@@ -281,13 +298,15 @@ type LighthouseClient = {
     readonly getTeamArrivals: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getTeamWipOverTime: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getTeamWip: (teamId: number, asOfDate: string) => Promise<LighthouseApiResult<readonly unknown[]>>;
-    readonly getTeamCycleTimePercentiles: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getTeamCycleTimePercentiles: (teamId: number, range?: MetricsDateRange, definitionId?: number) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getTeamWorkItemAgePercentiles: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getTeamCycleTimeData: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getTeamPredictabilityScore: (teamId: number, range?: MetricsDateRange, view?: ThroughputFilterView) => Promise<LighthouseApiResult<unknown>>;
     readonly getTeamTotalWorkItemAge: (teamId: number, asOfDate: string) => Promise<LighthouseApiResult<number>>;
     readonly getTeamTotalWorkItemAgeInfo: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioThroughput: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
-    readonly getPortfolioCycleTimePercentiles: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getPortfolioCycleTimePercentiles: (portfolioId: number, range?: MetricsDateRange, definitionId?: number) => Promise<LighthouseApiResult<readonly unknown[]>>;
+    readonly getPortfolioWorkItemAgePercentiles: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getPortfolioArrivals: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioWipOverTime: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioWip: (portfolioId: number, asOfDate: string) => Promise<LighthouseApiResult<readonly unknown[]>>;
@@ -312,6 +331,10 @@ type LighthouseClient = {
     readonly createDelivery: (portfolioId: number, payload: LighthouseWritePayload) => Promise<LighthouseApiResult<unknown>>;
     readonly updateDelivery: (deliveryId: number, payload: LighthouseWritePayload) => Promise<LighthouseApiResult<unknown>>;
     readonly deleteDelivery: (deliveryId: number) => Promise<LighthouseApiResult<undefined>>;
+    readonly getRecurringBlackoutRules: () => Promise<LighthouseApiResult<readonly RecurringBlackoutRule[]>>;
+    readonly createRecurringBlackoutRule: (payload: LighthouseWritePayload) => Promise<LighthouseApiResult<RecurringBlackoutRule>>;
+    readonly updateRecurringBlackoutRule: (id: number, payload: LighthouseWritePayload) => Promise<LighthouseApiResult<RecurringBlackoutRule>>;
+    readonly deleteRecurringBlackoutRule: (id: number) => Promise<LighthouseApiResult<undefined>>;
     readonly runManualForecast: (teamId: number, payload: ManualForecastInput) => Promise<LighthouseApiResult<unknown>>;
     readonly runBacktest: (teamId: number, payload: BacktestInput) => Promise<LighthouseApiResult<unknown>>;
 };
@@ -326,4 +349,4 @@ type LighthouseClientDependencies = {
 declare const isServerVersionNewerThan: (candidate: string, baseline: string) => boolean | null;
 declare const createLighthouseClient: (configuration: LighthouseClientConfiguration, dependencies?: LighthouseClientDependencies) => LighthouseClient;
 
-export { type BacktestInput, type CliAuthSessionPollResult, type CliAuthSessionStartError, type CliAuthSessionStartOutcome, type CliAuthSessionStartResult, type CliConnection, type CliServerAuthMode, type CliServerConnection, type CliStandaloneConnection, type ClientCapability, type ClientPackageContract, type ConnectivityCategory, type ConnectivityDependencies, type ConnectivityFetchResponse, type ConnectivityValidationResult, type CumulativeStateTimeCandidateRow, type CumulativeStateTimeCandidatesResult, type CumulativeStateTimeItemRow, type CumulativeStateTimeItemsResult, type CumulativeStateTimeResult, type CumulativeStateTimeStateRow, type DailyTotalWorkItemAge, type DailyWorkItemAge, type LighthouseApiError, type LighthouseApiResult, type LighthouseAuthContext, type LighthouseAuthOverrides, type LighthouseAuthStatus, type LighthouseAuthStore, type LighthouseClient, type LighthouseClientAuth, type LighthouseClientConfiguration, type LighthouseClientDependencies, type LighthouseConnectionConfiguration, type LighthouseWritePayload, type ManualForecastInput, type MetricsDateRange, type ResolvedLighthouseEndpoint, type ServerAuthModeResult, type StandaloneDiscoveryContract, type StandaloneDiscoveryContractParseResult, type StoredLighthouseAuth, type ThroughputFilterView, type TotalWorkItemAgeOverTimeResult, type WorkItemAgeEntry, type WorkItemAgeOverTimeResult, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, isServerVersionNewerThan, loadStandaloneDiscoveryContract, parseStandaloneDiscoveryContract, pollCliAuthSession, queryServerAuthMode, startCliAuthSession, validateLighthouseConnectivity };
+export { type BacktestInput, type CliAuthSessionPollResult, type CliAuthSessionStartError, type CliAuthSessionStartOutcome, type CliAuthSessionStartResult, type CliConnection, type CliServerAuthMode, type CliServerConnection, type CliStandaloneConnection, type ClientCapability, type ClientPackageContract, type ConnectivityCategory, type ConnectivityDependencies, type ConnectivityFetchResponse, type ConnectivityValidationResult, type CumulativeStateTimeCandidateRow, type CumulativeStateTimeCandidatesResult, type CumulativeStateTimeItemRow, type CumulativeStateTimeItemsResult, type CumulativeStateTimeResult, type CumulativeStateTimeStateRow, type DailyTotalWorkItemAge, type DailyWorkItemAge, type DayOfWeek, type LighthouseApiError, type LighthouseApiResult, type LighthouseAuthContext, type LighthouseAuthOverrides, type LighthouseAuthStatus, type LighthouseAuthStore, type LighthouseClient, type LighthouseClientAuth, type LighthouseClientConfiguration, type LighthouseClientDependencies, type LighthouseConnectionConfiguration, type LighthouseWritePayload, type ManualForecastInput, type MetricsDateRange, type RecurringBlackoutRule, type RecurringBlackoutRuleInput, type ResolvedLighthouseEndpoint, type ServerAuthModeResult, type StandaloneDiscoveryContract, type StandaloneDiscoveryContractParseResult, type StoredLighthouseAuth, type ThroughputFilterView, type TotalWorkItemAgeOverTimeResult, type WorkItemAgeEntry, type WorkItemAgeOverTimeResult, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, isServerVersionNewerThan, loadStandaloneDiscoveryContract, parseStandaloneDiscoveryContract, pollCliAuthSession, queryServerAuthMode, startCliAuthSession, validateLighthouseConnectivity };

package/dist/index.js

@@ -544,6 +544,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(
@@ -562,12 +603,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,
@@ -601,12 +637,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 {
@@ -647,12 +678,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,
@@ -671,6 +697,7 @@ var getMetricsDateRangeQuery = (range) => `startDate=${encodeURIComponent(range.
 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 getDefinitionIdQuerySuffix = (definitionId) => definitionId !== void 0 ? `&definitionId=${encodeURIComponent(definitionId)}` : "";
 var addUtcDays = (dateStr, days) => {
   const d = /* @__PURE__ */ new Date(`${dateStr}T00:00:00Z`);
   d.setUTCDate(d.getUTCDate() + days);
@@ -721,7 +748,9 @@ var deriveTotalWorkItemAgeOverTime = (startDate, endDate, wipData) => {
   return { startDate, endDate, daily };
 };
 var FEATURE_REQUIRES_SERVER_NEWER_THAN = {
-  cumulativeStateTime: "v26.5.24.10"
+  cumulativeStateTime: "v26.5.24.10",
+  recurringBlackoutRules: "v26.5.29.5",
+  workItemAgePercentiles: "v26.6.7.1"
 };
 var parseServerVersion = (raw) => {
   const trimmed = raw.trim().replace(/^v/iu, "");
@@ -942,12 +971,25 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
       `/v1/teams/${teamId}/metrics/wip?${getMetricsAsOfDateQuery(asOfDate)}`,
       { method: "GET" }
     ),
-    getTeamCycleTimePercentiles: async (teamId, range) => {
+    getTeamCycleTimePercentiles: async (teamId, range, definitionId) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}${getDefinitionIdQuerySuffix(definitionId)}`,
+        { method: "GET" }
+      );
+    },
+    getTeamWorkItemAgePercentiles: async (teamId, range) => {
+      const unsupported = await ensureServerSupports("workItemAgePercentiles");
+      if (unsupported) {
+        return unsupported;
+      }
       const r = getResolvedMetricsDateRange(range);
       return requestJson(
         configuration,
         dependencies,
-        `/v1/teams/${teamId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
+        `/v1/teams/${teamId}/metrics/workItemAgePercentiles?${getMetricsDateRangeQuery(r)}`,
         { method: "GET" }
       );
     },
@@ -1033,12 +1075,25 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
         { method: "GET" }
       );
     },
-    getPortfolioCycleTimePercentiles: async (portfolioId, range) => {
+    getPortfolioCycleTimePercentiles: async (portfolioId, range, definitionId) => {
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}${getDefinitionIdQuerySuffix(definitionId)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioWorkItemAgePercentiles: async (portfolioId, range) => {
+      const unsupported = await ensureServerSupports("workItemAgePercentiles");
+      if (unsupported) {
+        return unsupported;
+      }
       const r = getResolvedMetricsDateRange(range);
       return requestJson(
         configuration,
         dependencies,
-        `/v1/portfolios/${portfolioId}/metrics/cycleTimePercentiles?${getMetricsDateRangeQuery(r)}`,
+        `/v1/portfolios/${portfolioId}/metrics/workItemAgePercentiles?${getMetricsDateRangeQuery(r)}`,
         { method: "GET" }
       );
     },
@@ -1265,6 +1320,54 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
       `/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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letpeoplework/lighthouse-client",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Shared Lighthouse API client contracts",
   "repository": "https://github.com/LetPeopleWork/lighthouse-clients",
   "type": "module",