@letpeoplework/lighthouse-client 1.4.0 → 1.6.0

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  FEATURE_REQUIRES_SERVER_NEWER_THAN: () => FEATURE_REQUIRES_SERVER_NEWER_THAN,
   createLighthouseAuthContext: () => createLighthouseAuthContext,
   createLighthouseClient: () => createLighthouseClient,
   getClientPackageContract: () => getClientPackageContract,
@@ -785,7 +786,9 @@ var deriveTotalWorkItemAgeOverTime = (startDate, endDate, wipData) => {
 var FEATURE_REQUIRES_SERVER_NEWER_THAN = {
   cumulativeStateTime: "v26.5.24.10",
   recurringBlackoutRules: "v26.5.29.5",
-  workItemAgePercentiles: "v26.6.7.1"
+  workItemAgePercentiles: "v26.6.7.1",
+  mcpOAuthPassThrough: "v26.6.16.14",
+  blockedCountHistory: "v26.7.3.1"
 };
 var parseServerVersion = (raw) => {
   const trimmed = raw.trim().replace(/^v/iu, "");
@@ -1229,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) {
@@ -1419,6 +1448,7 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  FEATURE_REQUIRES_SERVER_NEWER_THAN,
   createLighthouseAuthContext,
   createLighthouseClient,
   getClientPackageContract,

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>>;
@@ -341,6 +357,21 @@ type LighthouseClient = {
 type LighthouseClientDependencies = {
     readonly fetch?: (url: string, init?: RequestInit) => Promise<ConnectivityFetchResponse>;
 };
+/**
+ * Server-version gating for endpoints that did not exist in older Lighthouse
+ * releases. At development time the NEXT release number is unknown, so each
+ * feature records the LAST released version that did NOT have it; the server
+ * must report a version STRICTLY NEWER than that baseline for the feature to be
+ * callable. Update the baseline to the current latest release whenever a new
+ * server-dependent feature is wrapped.
+ */
+declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
+    readonly cumulativeStateTime: "v26.5.24.10";
+    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
  * it is equal-or-older, and null when either string is unparseable (treat as
@@ -349,4 +380,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 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 };
+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>>;
@@ -341,6 +357,21 @@ type LighthouseClient = {
 type LighthouseClientDependencies = {
     readonly fetch?: (url: string, init?: RequestInit) => Promise<ConnectivityFetchResponse>;
 };
+/**
+ * Server-version gating for endpoints that did not exist in older Lighthouse
+ * releases. At development time the NEXT release number is unknown, so each
+ * feature records the LAST released version that did NOT have it; the server
+ * must report a version STRICTLY NEWER than that baseline for the feature to be
+ * callable. Update the baseline to the current latest release whenever a new
+ * server-dependent feature is wrapped.
+ */
+declare const FEATURE_REQUIRES_SERVER_NEWER_THAN: {
+    readonly cumulativeStateTime: "v26.5.24.10";
+    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
  * it is equal-or-older, and null when either string is unparseable (treat as
@@ -349,4 +380,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 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 };
+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

@@ -750,7 +750,9 @@ var deriveTotalWorkItemAgeOverTime = (startDate, endDate, wipData) => {
 var FEATURE_REQUIRES_SERVER_NEWER_THAN = {
   cumulativeStateTime: "v26.5.24.10",
   recurringBlackoutRules: "v26.5.29.5",
-  workItemAgePercentiles: "v26.6.7.1"
+  workItemAgePercentiles: "v26.6.7.1",
+  mcpOAuthPassThrough: "v26.6.16.14",
+  blockedCountHistory: "v26.7.3.1"
 };
 var parseServerVersion = (raw) => {
   const trimmed = raw.trim().replace(/^v/iu, "");
@@ -1194,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) {
@@ -1383,6 +1411,7 @@ var createLighthouseClient = (configuration, dependencies = {}) => {
   };
 };
 export {
+  FEATURE_REQUIRES_SERVER_NEWER_THAN,
   createLighthouseAuthContext,
   createLighthouseClient,
   getClientPackageContract,

package/package.json

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