@letpeoplework/lighthouse-client 0.7.0 → 1.0.0

package/dist/index.cjs

@@ -24,6 +24,8 @@ __export(index_exports, {
   createLighthouseClient: () => createLighthouseClient,
   getClientPackageContract: () => getClientPackageContract,
   getDefaultMetricsDateRange: () => getDefaultMetricsDateRange,
+  getStandaloneDiscoveryLockfilePath: () => getStandaloneDiscoveryLockfilePath,
+  loadStandaloneDiscoveryContract: () => loadStandaloneDiscoveryContract,
   parseStandaloneDiscoveryContract: () => parseStandaloneDiscoveryContract,
   pollCliAuthSession: () => pollCliAuthSession,
   queryServerAuthMode: () => queryServerAuthMode,
@@ -31,6 +33,9 @@ __export(index_exports, {
   validateLighthouseConnectivity: () => validateLighthouseConnectivity
 });
 module.exports = __toCommonJS(index_exports);
+var import_promises = require("fs/promises");
+var import_node_os = require("os");
+var import_node_path = require("path");
 var getClientPackageContract = () => ({
   name: "@letpeoplework/lighthouse-client",
   capabilities: [
@@ -41,6 +46,7 @@ var getClientPackageContract = () => ({
   ]
 });
 var SUPPORTED_DISCOVERY_CONTRACT_VERSION = 1;
+var STANDALONE_DISCOVERY_LOCKFILE_NAME = "standalone.lock.json";
 var isObjectRecord = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -155,6 +161,47 @@ var parseStandaloneDiscoveryContract = (serializedContract) => {
     detectedAtUtc
   });
 };
+var getStandaloneDiscoveryLockfilePath = () => {
+  if (process.env.LIGHTHOUSE_STANDALONE_LOCKFILE_PATH !== void 0) {
+    return process.env.LIGHTHOUSE_STANDALONE_LOCKFILE_PATH;
+  }
+  if (process.platform === "darwin") {
+    return (0, import_node_path.join)(
+      (0, import_node_os.homedir)(),
+      "Library",
+      "Application Support",
+      "Lighthouse",
+      STANDALONE_DISCOVERY_LOCKFILE_NAME
+    );
+  }
+  if (process.platform === "win32") {
+    return (0, import_node_path.join)(
+      process.env.APPDATA ?? (0, import_node_path.join)((0, import_node_os.homedir)(), "AppData", "Roaming"),
+      "Lighthouse",
+      STANDALONE_DISCOVERY_LOCKFILE_NAME
+    );
+  }
+  return (0, import_node_path.join)(
+    process.env.XDG_CONFIG_HOME ?? (0, import_node_path.join)((0, import_node_os.homedir)(), ".config"),
+    "Lighthouse",
+    STANDALONE_DISCOVERY_LOCKFILE_NAME
+  );
+};
+var loadStandaloneDiscoveryContract = async () => {
+  try {
+    const serializedContract = await (0, import_promises.readFile)(
+      getStandaloneDiscoveryLockfilePath(),
+      "utf8"
+    );
+    const parsedContract = parseStandaloneDiscoveryContract(serializedContract);
+    if (!parsedContract.isValid) {
+      return null;
+    }
+    return parsedContract.contract;
+  } catch {
+    return null;
+  }
+};
 var getResolvedEndpoint = (mode, lighthouseUrl) => {
   const apiBaseUrl = getApiBaseUrl(lighthouseUrl);
   return {
@@ -656,6 +703,54 @@ 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 addUtcDays = (dateStr, days) => {
+  const d = /* @__PURE__ */ new Date(`${dateStr}T00:00:00Z`);
+  d.setUTCDate(d.getUTCDate() + days);
+  return d.toISOString().split("T")[0];
+};
+var computeItemAge = (dayDate, startedDate) => {
+  const day = Date.parse(`${dayDate}T00:00:00Z`);
+  const started = Date.parse(startedDate);
+  const diffDays = Math.floor((day - started) / 864e5);
+  return Math.max(1, diffDays + 1);
+};
+var deriveWorkItemAgeOverTime = (startDate, endDate, wipData) => {
+  const daily = Object.entries(
+    wipData.workItemsPerUnitOfTime
+  ).map(([dayIndexStr, items]) => {
+    const dayIndex = Number.parseInt(dayIndexStr, 10);
+    const date = addUtcDays(startDate, dayIndex);
+    const ageItems = items.filter(
+      (item) => item.startedDate != null && item.startedDate.length > 0
+    ).map((item) => ({
+      id: item.id,
+      name: item.name,
+      referenceId: item.referenceId,
+      age: computeItemAge(date, item.startedDate)
+    }));
+    return { date, items: ageItems };
+  });
+  daily.sort((a, b) => a.date.localeCompare(b.date));
+  return { startDate, endDate, daily };
+};
+var deriveTotalWorkItemAgeOverTime = (startDate, endDate, wipData) => {
+  const daily = Object.entries(
+    wipData.workItemsPerUnitOfTime
+  ).map(([dayIndexStr, items]) => {
+    const dayIndex = Number.parseInt(dayIndexStr, 10);
+    const date = addUtcDays(startDate, dayIndex);
+    const activeItems = items.filter(
+      (item) => item.startedDate != null && item.startedDate.length > 0
+    );
+    const totalAge = activeItems.reduce(
+      (sum, item) => sum + computeItemAge(date, item.startedDate),
+      0
+    );
+    return { date, totalAge, itemCount: activeItems.length };
+  });
+  daily.sort((a, b) => a.date.localeCompare(b.date));
+  return { startDate, endDate, daily };
+};
 var createLighthouseClient = (configuration, dependencies = {}) => ({
   checkConnectivity: async () => {
     const fetchDependency = getFetchDependency(dependencies);
@@ -850,6 +945,42 @@ var createLighthouseClient = (configuration, dependencies = {}) => ({
       { 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(
@@ -925,6 +1056,42 @@ var createLighthouseClient = (configuration, dependencies = {}) => ({
       { 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
+      )
+    };
+  },
   getFeaturesByIds: async (ids) => {
     const queryString = ids.map((id) => `ids=${encodeURIComponent(id)}`).join("&");
     return requestJson(
@@ -992,6 +1159,8 @@ var createLighthouseClient = (configuration, dependencies = {}) => ({
   createLighthouseClient,
   getClientPackageContract,
   getDefaultMetricsDateRange,
+  getStandaloneDiscoveryLockfilePath,
+  loadStandaloneDiscoveryContract,
   parseStandaloneDiscoveryContract,
   pollCliAuthSession,
   queryServerAuthMode,

package/dist/index.d.cts

@@ -50,6 +50,8 @@ type ConnectivityValidationResult = {
     readonly endpoint?: ResolvedLighthouseEndpoint;
 };
 declare const parseStandaloneDiscoveryContract: (serializedContract: string) => StandaloneDiscoveryContractParseResult;
+declare const getStandaloneDiscoveryLockfilePath: () => string;
+declare const loadStandaloneDiscoveryContract: () => Promise<StandaloneDiscoveryContract | null>;
 declare const validateLighthouseConnectivity: (configuration: LighthouseConnectionConfiguration, dependencies: ConnectivityDependencies, requestInit?: RequestInit) => Promise<ConnectivityValidationResult>;
 type LighthouseClientAuth = {
     readonly kind: "none";
@@ -167,6 +169,31 @@ type BacktestInput = {
     readonly historicalStartDate: string;
     readonly historicalEndDate: string;
 };
+type WorkItemAgeEntry = {
+    readonly id: number;
+    readonly name: string;
+    readonly referenceId: string;
+    readonly age: number;
+};
+type DailyWorkItemAge = {
+    readonly date: string;
+    readonly items: readonly WorkItemAgeEntry[];
+};
+type DailyTotalWorkItemAge = {
+    readonly date: string;
+    readonly totalAge: number;
+    readonly itemCount: number;
+};
+type WorkItemAgeOverTimeResult = {
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly daily: readonly DailyWorkItemAge[];
+};
+type TotalWorkItemAgeOverTimeResult = {
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly daily: readonly DailyTotalWorkItemAge[];
+};
 type LighthouseClient = {
     readonly checkConnectivity: () => Promise<ConnectivityValidationResult>;
     readonly getVersion: () => Promise<LighthouseApiResult<string>>;
@@ -203,8 +230,12 @@ type LighthouseClient = {
     readonly getPortfolioWip: (portfolioId: number, asOfDate: string) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getPortfolioCycleTimeData: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getPortfolioPredictabilityScore: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
+    readonly getTeamWorkItemAgeOverTime: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<WorkItemAgeOverTimeResult>>;
+    readonly getTeamTotalWorkItemAgeOverTime: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<TotalWorkItemAgeOverTimeResult>>;
     readonly getPortfolioTotalWorkItemAge: (portfolioId: number, asOfDate: string) => Promise<LighthouseApiResult<number>>;
     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 getFeaturesByIds: (ids: readonly number[]) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getFeaturesByReferences: (refs: readonly string[]) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getFeatureWorkItems: (featureId: number) => Promise<LighthouseApiResult<readonly unknown[]>>;
@@ -220,4 +251,4 @@ type LighthouseClientDependencies = {
 };
 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 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, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, 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 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 TotalWorkItemAgeOverTimeResult, type WorkItemAgeEntry, type WorkItemAgeOverTimeResult, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, loadStandaloneDiscoveryContract, parseStandaloneDiscoveryContract, pollCliAuthSession, queryServerAuthMode, startCliAuthSession, validateLighthouseConnectivity };

package/dist/index.d.ts

@@ -50,6 +50,8 @@ type ConnectivityValidationResult = {
     readonly endpoint?: ResolvedLighthouseEndpoint;
 };
 declare const parseStandaloneDiscoveryContract: (serializedContract: string) => StandaloneDiscoveryContractParseResult;
+declare const getStandaloneDiscoveryLockfilePath: () => string;
+declare const loadStandaloneDiscoveryContract: () => Promise<StandaloneDiscoveryContract | null>;
 declare const validateLighthouseConnectivity: (configuration: LighthouseConnectionConfiguration, dependencies: ConnectivityDependencies, requestInit?: RequestInit) => Promise<ConnectivityValidationResult>;
 type LighthouseClientAuth = {
     readonly kind: "none";
@@ -167,6 +169,31 @@ type BacktestInput = {
     readonly historicalStartDate: string;
     readonly historicalEndDate: string;
 };
+type WorkItemAgeEntry = {
+    readonly id: number;
+    readonly name: string;
+    readonly referenceId: string;
+    readonly age: number;
+};
+type DailyWorkItemAge = {
+    readonly date: string;
+    readonly items: readonly WorkItemAgeEntry[];
+};
+type DailyTotalWorkItemAge = {
+    readonly date: string;
+    readonly totalAge: number;
+    readonly itemCount: number;
+};
+type WorkItemAgeOverTimeResult = {
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly daily: readonly DailyWorkItemAge[];
+};
+type TotalWorkItemAgeOverTimeResult = {
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly daily: readonly DailyTotalWorkItemAge[];
+};
 type LighthouseClient = {
     readonly checkConnectivity: () => Promise<ConnectivityValidationResult>;
     readonly getVersion: () => Promise<LighthouseApiResult<string>>;
@@ -203,8 +230,12 @@ type LighthouseClient = {
     readonly getPortfolioWip: (portfolioId: number, asOfDate: string) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getPortfolioCycleTimeData: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getPortfolioPredictabilityScore: (portfolioId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<unknown>>;
+    readonly getTeamWorkItemAgeOverTime: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<WorkItemAgeOverTimeResult>>;
+    readonly getTeamTotalWorkItemAgeOverTime: (teamId: number, range?: MetricsDateRange) => Promise<LighthouseApiResult<TotalWorkItemAgeOverTimeResult>>;
     readonly getPortfolioTotalWorkItemAge: (portfolioId: number, asOfDate: string) => Promise<LighthouseApiResult<number>>;
     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 getFeaturesByIds: (ids: readonly number[]) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getFeaturesByReferences: (refs: readonly string[]) => Promise<LighthouseApiResult<readonly unknown[]>>;
     readonly getFeatureWorkItems: (featureId: number) => Promise<LighthouseApiResult<readonly unknown[]>>;
@@ -220,4 +251,4 @@ type LighthouseClientDependencies = {
 };
 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 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, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, 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 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 TotalWorkItemAgeOverTimeResult, type WorkItemAgeEntry, type WorkItemAgeOverTimeResult, createLighthouseAuthContext, createLighthouseClient, getClientPackageContract, getDefaultMetricsDateRange, getStandaloneDiscoveryLockfilePath, loadStandaloneDiscoveryContract, parseStandaloneDiscoveryContract, pollCliAuthSession, queryServerAuthMode, startCliAuthSession, validateLighthouseConnectivity };

package/dist/index.js

@@ -1,4 +1,7 @@
 // src/index.ts
+import { readFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
 var getClientPackageContract = () => ({
   name: "@letpeoplework/lighthouse-client",
   capabilities: [
@@ -9,6 +12,7 @@ var getClientPackageContract = () => ({
   ]
 });
 var SUPPORTED_DISCOVERY_CONTRACT_VERSION = 1;
+var STANDALONE_DISCOVERY_LOCKFILE_NAME = "standalone.lock.json";
 var isObjectRecord = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -123,6 +127,47 @@ var parseStandaloneDiscoveryContract = (serializedContract) => {
     detectedAtUtc
   });
 };
+var getStandaloneDiscoveryLockfilePath = () => {
+  if (process.env.LIGHTHOUSE_STANDALONE_LOCKFILE_PATH !== void 0) {
+    return process.env.LIGHTHOUSE_STANDALONE_LOCKFILE_PATH;
+  }
+  if (process.platform === "darwin") {
+    return join(
+      homedir(),
+      "Library",
+      "Application Support",
+      "Lighthouse",
+      STANDALONE_DISCOVERY_LOCKFILE_NAME
+    );
+  }
+  if (process.platform === "win32") {
+    return join(
+      process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"),
+      "Lighthouse",
+      STANDALONE_DISCOVERY_LOCKFILE_NAME
+    );
+  }
+  return join(
+    process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"),
+    "Lighthouse",
+    STANDALONE_DISCOVERY_LOCKFILE_NAME
+  );
+};
+var loadStandaloneDiscoveryContract = async () => {
+  try {
+    const serializedContract = await readFile(
+      getStandaloneDiscoveryLockfilePath(),
+      "utf8"
+    );
+    const parsedContract = parseStandaloneDiscoveryContract(serializedContract);
+    if (!parsedContract.isValid) {
+      return null;
+    }
+    return parsedContract.contract;
+  } catch {
+    return null;
+  }
+};
 var getResolvedEndpoint = (mode, lighthouseUrl) => {
   const apiBaseUrl = getApiBaseUrl(lighthouseUrl);
   return {
@@ -624,6 +669,54 @@ 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 addUtcDays = (dateStr, days) => {
+  const d = /* @__PURE__ */ new Date(`${dateStr}T00:00:00Z`);
+  d.setUTCDate(d.getUTCDate() + days);
+  return d.toISOString().split("T")[0];
+};
+var computeItemAge = (dayDate, startedDate) => {
+  const day = Date.parse(`${dayDate}T00:00:00Z`);
+  const started = Date.parse(startedDate);
+  const diffDays = Math.floor((day - started) / 864e5);
+  return Math.max(1, diffDays + 1);
+};
+var deriveWorkItemAgeOverTime = (startDate, endDate, wipData) => {
+  const daily = Object.entries(
+    wipData.workItemsPerUnitOfTime
+  ).map(([dayIndexStr, items]) => {
+    const dayIndex = Number.parseInt(dayIndexStr, 10);
+    const date = addUtcDays(startDate, dayIndex);
+    const ageItems = items.filter(
+      (item) => item.startedDate != null && item.startedDate.length > 0
+    ).map((item) => ({
+      id: item.id,
+      name: item.name,
+      referenceId: item.referenceId,
+      age: computeItemAge(date, item.startedDate)
+    }));
+    return { date, items: ageItems };
+  });
+  daily.sort((a, b) => a.date.localeCompare(b.date));
+  return { startDate, endDate, daily };
+};
+var deriveTotalWorkItemAgeOverTime = (startDate, endDate, wipData) => {
+  const daily = Object.entries(
+    wipData.workItemsPerUnitOfTime
+  ).map(([dayIndexStr, items]) => {
+    const dayIndex = Number.parseInt(dayIndexStr, 10);
+    const date = addUtcDays(startDate, dayIndex);
+    const activeItems = items.filter(
+      (item) => item.startedDate != null && item.startedDate.length > 0
+    );
+    const totalAge = activeItems.reduce(
+      (sum, item) => sum + computeItemAge(date, item.startedDate),
+      0
+    );
+    return { date, totalAge, itemCount: activeItems.length };
+  });
+  daily.sort((a, b) => a.date.localeCompare(b.date));
+  return { startDate, endDate, daily };
+};
 var createLighthouseClient = (configuration, dependencies = {}) => ({
   checkConnectivity: async () => {
     const fetchDependency = getFetchDependency(dependencies);
@@ -818,6 +911,42 @@ var createLighthouseClient = (configuration, dependencies = {}) => ({
       { 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(
@@ -893,6 +1022,42 @@ var createLighthouseClient = (configuration, dependencies = {}) => ({
       { 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
+      )
+    };
+  },
   getFeaturesByIds: async (ids) => {
     const queryString = ids.map((id) => `ids=${encodeURIComponent(id)}`).join("&");
     return requestJson(
@@ -959,6 +1124,8 @@ export {
   createLighthouseClient,
   getClientPackageContract,
   getDefaultMetricsDateRange,
+  getStandaloneDiscoveryLockfilePath,
+  loadStandaloneDiscoveryContract,
   parseStandaloneDiscoveryContract,
   pollCliAuthSession,
   queryServerAuthMode,

package/package.json

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