@letpeoplework/lighthouse-client 1.5.0 → 1.6.0

package/dist/index.cjs

@@ -787,7 +787,8 @@ var FEATURE_REQUIRES_SERVER_NEWER_THAN = {
   cumulativeStateTime: "v26.5.24.10",
   recurringBlackoutRules: "v26.5.29.5",
   workItemAgePercentiles: "v26.6.7.1",
-  mcpOAuthPassThrough: "v26.6.16.14"
+  mcpOAuthPassThrough: "v26.6.16.14",
+  blockedCountHistory: "v26.7.3.1"
 };
 var parseServerVersion = (raw) => {
   const trimmed = raw.trim().replace(/^v/iu, "");
@@ -1231,6 +1232,32 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
         )
       };
     },
+    getTeamBlockedCountHistory: async (teamId, range) => {
+      const unsupported = await ensureServerSupports("blockedCountHistory");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/blockedCountHistory?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioBlockedCountHistory: async (portfolioId, range) => {
+      const unsupported = await ensureServerSupports("blockedCountHistory");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/blockedCountHistory?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
     getTeamCumulativeStateTime: async (teamId, range, itemIds) => {
       const unsupported = await ensureServerSupports("cumulativeStateTime");
       if (unsupported) {

package/dist/index.d.cts

@@ -219,6 +219,20 @@ type TotalWorkItemAgeOverTimeResult = {
     readonly endDate: string;
     readonly daily: readonly DailyTotalWorkItemAge[];
 };
+/**
+ * One captured point on the blocked-items-over-time trend: how many items were
+ * blocked on {@link recordedAt}. Returned by the team/portfolio
+ * `blockedCountHistory` metric. `recordedAt` is an ISO date string.
+ *
+ * The complementary "what is blocked right now, and for how long" view rides on
+ * the existing WIP snapshot (`getTeamWip` / `getPortfolioWip`): from Lighthouse
+ * newer than v26.7.3.1 each WIP work item carries `isBlocked` and, when blocked,
+ * a `blockedSince` timestamp.
+ */
+type BlockedCountSnapshot = {
+    readonly recordedAt: string;
+    readonly blockedCount: number;
+};
 type CumulativeStateTimeStateRow = {
     readonly state: string;
     readonly workflowOrder: number;
@@ -318,6 +332,8 @@ type LighthouseClient = {
     readonly getPortfolioTotalWorkItemAgeInfo: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioWorkItemAgeOverTime: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<WorkItemAgeOverTimeResult>>;
     readonly getPortfolioTotalWorkItemAgeOverTime: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<TotalWorkItemAgeOverTimeResult>>;
+    readonly getTeamBlockedCountHistory: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly BlockedCountSnapshot[]>>;
+    readonly getPortfolioBlockedCountHistory: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly BlockedCountSnapshot[]>>;
     readonly getTeamCumulativeStateTime: (teamId: number, range?: MetricsDateRange, itemIds?: readonly number[]) => Promise<LighthouseApiResult<CumulativeStateTimeResult>>;
     readonly getTeamCumulativeStateTimeItems: (teamId: number, state: string, range?: MetricsDateRange, itemIds?: readonly number[]) => Promise<LighthouseApiResult<CumulativeStateTimeItemsResult>>;
     readonly getTeamCumulativeStateTimeCandidates: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<CumulativeStateTimeCandidatesResult>>;
@@ -354,6 +370,7 @@ declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
     readonly recurringBlackoutRules: "v26.5.29.5";
     readonly workItemAgePercentiles: "v26.6.7.1";
     readonly mcpOAuthPassThrough: "v26.6.16.14";
+    readonly blockedCountHistory: "v26.7.3.1";
 };
 /**
  * Returns true when `candidate` is strictly newer than `baseline`, false when
@@ -363,4 +380,4 @@ declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
 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 DayOfWeek, FEATURE_REQUIRES_SERVER_NEWER_THAN, 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 };
+export { type BacktestInput, type BlockedCountSnapshot, 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, FEATURE_REQUIRES_SERVER_NEWER_THAN, 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

@@ -219,6 +219,20 @@ type TotalWorkItemAgeOverTimeResult = {
     readonly endDate: string;
     readonly daily: readonly DailyTotalWorkItemAge[];
 };
+/**
+ * One captured point on the blocked-items-over-time trend: how many items were
+ * blocked on {@link recordedAt}. Returned by the team/portfolio
+ * `blockedCountHistory` metric. `recordedAt` is an ISO date string.
+ *
+ * The complementary "what is blocked right now, and for how long" view rides on
+ * the existing WIP snapshot (`getTeamWip` / `getPortfolioWip`): from Lighthouse
+ * newer than v26.7.3.1 each WIP work item carries `isBlocked` and, when blocked,
+ * a `blockedSince` timestamp.
+ */
+type BlockedCountSnapshot = {
+    readonly recordedAt: string;
+    readonly blockedCount: number;
+};
 type CumulativeStateTimeStateRow = {
     readonly state: string;
     readonly workflowOrder: number;
@@ -318,6 +332,8 @@ type LighthouseClient = {
     readonly getPortfolioTotalWorkItemAgeInfo: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
     readonly getPortfolioWorkItemAgeOverTime: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<WorkItemAgeOverTimeResult>>;
     readonly getPortfolioTotalWorkItemAgeOverTime: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<TotalWorkItemAgeOverTimeResult>>;
+    readonly getTeamBlockedCountHistory: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly BlockedCountSnapshot[]>>;
+    readonly getPortfolioBlockedCountHistory: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly BlockedCountSnapshot[]>>;
     readonly getTeamCumulativeStateTime: (teamId: number, range?: MetricsDateRange, itemIds?: readonly number[]) => Promise<LighthouseApiResult<CumulativeStateTimeResult>>;
     readonly getTeamCumulativeStateTimeItems: (teamId: number, state: string, range?: MetricsDateRange, itemIds?: readonly number[]) => Promise<LighthouseApiResult<CumulativeStateTimeItemsResult>>;
     readonly getTeamCumulativeStateTimeCandidates: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<CumulativeStateTimeCandidatesResult>>;
@@ -354,6 +370,7 @@ declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
     readonly recurringBlackoutRules: "v26.5.29.5";
     readonly workItemAgePercentiles: "v26.6.7.1";
     readonly mcpOAuthPassThrough: "v26.6.16.14";
+    readonly blockedCountHistory: "v26.7.3.1";
 };
 /**
  * Returns true when `candidate` is strictly newer than `baseline`, false when
@@ -363,4 +380,4 @@ declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
 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 DayOfWeek, FEATURE_REQUIRES_SERVER_NEWER_THAN, 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 };
+export { type BacktestInput, type BlockedCountSnapshot, 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, FEATURE_REQUIRES_SERVER_NEWER_THAN, 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

@@ -751,7 +751,8 @@ var FEATURE_REQUIRES_SERVER_NEWER_THAN = {
   cumulativeStateTime: "v26.5.24.10",
   recurringBlackoutRules: "v26.5.29.5",
   workItemAgePercentiles: "v26.6.7.1",
-  mcpOAuthPassThrough: "v26.6.16.14"
+  mcpOAuthPassThrough: "v26.6.16.14",
+  blockedCountHistory: "v26.7.3.1"
 };
 var parseServerVersion = (raw) => {
   const trimmed = raw.trim().replace(/^v/iu, "");
@@ -1195,6 +1196,32 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
         )
       };
     },
+    getTeamBlockedCountHistory: async (teamId, range) => {
+      const unsupported = await ensureServerSupports("blockedCountHistory");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/teams/${teamId}/metrics/blockedCountHistory?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
+    getPortfolioBlockedCountHistory: async (portfolioId, range) => {
+      const unsupported = await ensureServerSupports("blockedCountHistory");
+      if (unsupported) {
+        return unsupported;
+      }
+      const r = getResolvedMetricsDateRange(range);
+      return requestJson(
+        configuration,
+        dependencies,
+        `/v1/portfolios/${portfolioId}/metrics/blockedCountHistory?${getMetricsDateRangeQuery(r)}`,
+        { method: "GET" }
+      );
+    },
     getTeamCumulativeStateTime: async (teamId, range, itemIds) => {
       const unsupported = await ensureServerSupports("cumulativeStateTime");
       if (unsupported) {

package/package.json

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