node-autotask 0.11.0 → 0.12.1

package/dist/{chunk-CJONZQ7E.js → chunk-P35GFG2H.js}

@@ -4,6 +4,9 @@ import {
   BLIND_SURFACE_STAMPS,
   BaseResource,
   ConflictError,
+  EMPTY_REASON_STAMPS,
+  FETCH_BY_IDS_CHUNK_SIZE,
+  FETCH_BY_IDS_MAX_ITEMS,
   NotFoundError,
   RELATIONSHIP_MAP,
   ResolutionError,
@@ -30,10 +33,10 @@ import {
   unwrapItem,
   unwrapItems,
   unwrapOperation
-} from "./chunk-LNRN45XS.js";
+} from "./chunk-ZOA5HUFX.js";
 import {
   CAPABILITIES
-} from "./chunk-7L23FDQW.js";
+} from "./chunk-NACI2NDF.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -4534,6 +4537,1252 @@ var ContractServiceUnitsResource = class extends BaseResource {
   }
 };
 
+// src/resources/special/contracts.ts
+var PROFITABILITY_OPT_KEYS = [
+  "dateFrom",
+  "dateTo",
+  "labourCostMethod",
+  "labourRatePerHour",
+  "includeRecurringCosts",
+  "includeUnbilledRevenue",
+  "externalMonthlyCosts",
+  "groupByActivity",
+  "staleAfterDays",
+  "maxTicketsForJoin",
+  "limit"
+];
+var LABOUR_METHOD_SET = [
+  "billing_item_our_cost",
+  "contract_role_cost",
+  "resource_internal_cost",
+  "provided"
+];
+var PROFITABILITY_MAX_WINDOW_MONTHS = 36;
+var RECURRING_DRIFT_EPSILON = 5e-3;
+var ESTIMATE_DEVIATION_THRESHOLD_PCT = 10;
+var CLOSED_STATUS_LABEL_RE = /resolved|completed|cancelled|canceled|closed|deleted/i;
+var PROFITABILITY_WIRE_BUDGET = 21;
+var BLOCK_HOURS_LABEL_RE = /block\s*hours?/i;
+var TIME_AND_MATERIALS_LABEL_RE = /time.*materials?/i;
+var NOT_ACTIVE_LABEL_RE = /cancel|inactive/i;
+var SUBSCRIPTION_NOT_ACTIVE_STATUS_IDS = /* @__PURE__ */ new Set([2, 3]);
+var PERIOD_TYPE_MONTHLY_FACTOR = { 2: 1, 3: 1 / 3, 4: 1 / 6, 5: 1 / 12 };
+var PERIOD_TYPE_ONE_TIME = 1;
+var SERVICE_LINE_FKS = ["contractServiceID", "contractServiceBundleID", "contractServicePeriodID", "contractServiceBundlePeriodID", "contractServiceAdjustmentID", "contractServiceBundleAdjustmentID"];
+var CHARGE_LINE_FKS = ["contractChargeID", "ticketChargeID", "projectChargeID"];
+var DATE_RE2 = /^\d{4}-\d{2}-\d{2}$/;
+function num2(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+function isDateYMD2(v) {
+  return typeof v === "string" && DATE_RE2.test(v) && !Number.isNaN(Date.parse(v));
+}
+function monthsInWindow(dateFrom, dateTo) {
+  const a = `${dateFrom.slice(0, 7)}`;
+  const b = `${dateTo.slice(0, 7)}`;
+  if (a > b) return 0;
+  const ay = Number(a.slice(0, 4));
+  const am = Number(a.slice(5, 7));
+  const by = Number(b.slice(0, 4));
+  const bm = Number(b.slice(5, 7));
+  return (by - ay) * 12 + (bm - am) + 1;
+}
+function monthsBetween(dateFrom, dateTo) {
+  const out = [];
+  let y = Number(dateFrom.slice(0, 4));
+  let m = Number(dateFrom.slice(5, 7));
+  const end = dateTo.slice(0, 7);
+  for (; ; ) {
+    const tag = `${y}-${String(m).padStart(2, "0")}`;
+    out.push(tag);
+    if (tag === end) break;
+    m += 1;
+    if (m === 13) {
+      m = 1;
+      y += 1;
+    }
+    if (out.length > 500) break;
+  }
+  return out;
+}
+function dayAfter(date) {
+  return new Date(Date.parse(date) + 864e5).toISOString().slice(0, 10);
+}
+function monthBounds(month, dateFrom, dateTo) {
+  const y = Number(month.slice(0, 4));
+  const m = Number(month.slice(5, 7));
+  const first = `${month}-01`;
+  const nextFirst = new Date(Date.UTC(y, m, 1)).toISOString().slice(0, 10);
+  const toExcl = dayAfter(dateTo);
+  return {
+    start: first > dateFrom ? first : dateFrom,
+    endExclusive: nextFirst < toExcl ? nextFirst : toExcl
+  };
+}
+function chargeCost(charge) {
+  const ext = charge["extendedCost"];
+  const fromUnits = num2(charge["unitCost"]) * num2(charge["unitQuantity"]);
+  if (typeof ext === "number" && Number.isFinite(ext) && !(ext === 0 && fromUnits !== 0)) return ext;
+  return fromUnits;
+}
+function isOneTimePeriod(periodType, label) {
+  return label !== void 0 ? /one[\s-]*time/i.test(label) : periodType === PERIOD_TYPE_ONE_TIME;
+}
+function periodMonthlyFactor(periodType, label) {
+  if (label !== void 0) {
+    if (/semi/i.test(label)) return 1 / 6;
+    if (/quarter/i.test(label)) return 1 / 3;
+    if (/annual|year/i.test(label)) return 1 / 12;
+    if (/month/i.test(label)) return 1;
+    return null;
+  }
+  return typeof periodType === "number" ? PERIOD_TYPE_MONTHLY_FACTOR[periodType] ?? null : null;
+}
+var BILLING_ITEM_TYPE_KIND = {
+  1: "labour",
+  2: "labour",
+  3: "charges",
+  4: "expenses",
+  5: "other",
+  6: "recurring",
+  7: "charges",
+  8: "other"
+};
+function billingLineType(item) {
+  const byType = BILLING_ITEM_TYPE_KIND[num2(item["billingItemType"])];
+  if (byType !== void 0) return byType;
+  if (num2(item["timeEntryID"]) > 0) return "labour";
+  if (num2(item["expenseItemID"]) > 0) return "expenses";
+  if (CHARGE_LINE_FKS.some((k) => num2(item[k]) > 0)) return "charges";
+  if (SERVICE_LINE_FKS.some((k) => num2(item[k]) > 0)) return "recurring";
+  return "other";
+}
+function internalAmount(row, internalKey, localKey) {
+  const v = row[internalKey];
+  return typeof v === "number" && Number.isFinite(v) ? v : num2(row[localKey]);
+}
+function cents(v) {
+  return v === null ? null : Math.round(v * 100) / 100;
+}
+async function readPicklists(http, entityPath, operation) {
+  const res = await http.request({ method: "GET", path: `${entityPath}/entityInformation/fields`, operation });
+  const body = typeof res === "object" && res !== null ? res : {};
+  const fields = Array.isArray(body["fields"]) ? body["fields"] : [];
+  const out = /* @__PURE__ */ new Map();
+  for (const f of fields) {
+    if (f["isPickList"] !== true || typeof f["name"] !== "string" || !Array.isArray(f["picklistValues"])) continue;
+    const values = /* @__PURE__ */ new Map();
+    for (const p of f["picklistValues"]) {
+      const id = typeof p["value"] === "string" ? Number.parseInt(p["value"], 10) : Number.NaN;
+      if (Number.isFinite(id)) values.set(id, String(p["label"] ?? ""));
+    }
+    out.set(f["name"], values);
+  }
+  return out;
+}
+function dateToDay(v) {
+  if (typeof v !== "string" || v.length < 10) return null;
+  const d = Date.parse(v.slice(0, 10));
+  return Number.isNaN(d) ? null : Math.floor(d / 864e5);
+}
+function validateProfitabilityOptions(contractId, opts) {
+  if (opts === void 0 || (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
+    throw new AutotaskConfigError(
+      `profitability: opts must be the options object (got ${opts === void 0 ? "undefined" : Array.isArray(opts) ? "an array" : typeof opts})`,
+      { operation: "contracts.profitability" }
+    );
+  }
+  const problems = [];
+  for (const key of Object.keys(opts)) {
+    if (!PROFITABILITY_OPT_KEYS.includes(key)) {
+      problems.push(
+        `unknown opts key "${key}" \u2014 the bag is closed: ${PROFITABILITY_OPT_KEYS.join(", ")}`
+      );
+    }
+  }
+  if (!isDateYMD2(opts.dateFrom)) problems.push(`dateFrom is required (YYYY-MM-DD) (got ${String(opts.dateFrom)})`);
+  if (!isDateYMD2(opts.dateTo)) problems.push(`dateTo is required (YYYY-MM-DD) (got ${String(opts.dateTo)})`);
+  if (isDateYMD2(opts.dateFrom) && isDateYMD2(opts.dateTo) && opts.dateTo < opts.dateFrom) {
+    problems.push(`dateTo must be >= dateFrom (got ${opts.dateTo})`);
+  }
+  if (isDateYMD2(opts.dateFrom) && isDateYMD2(opts.dateTo) && opts.dateTo >= opts.dateFrom) {
+    const months = monthsInWindow(opts.dateFrom, opts.dateTo);
+    if (months > PROFITABILITY_MAX_WINDOW_MONTHS) {
+      problems.push(
+        `window must span at most ${PROFITABILITY_MAX_WINDOW_MONTHS} months (the per-month windowing budget stays bounded; got ${months} months)`
+      );
+    }
+  }
+  const method = opts.labourCostMethod ?? "billing_item_our_cost";
+  if (!LABOUR_METHOD_SET.includes(method)) {
+    problems.push(`labourCostMethod must be one of: ${LABOUR_METHOD_SET.join(", ")} (got ${String(opts.labourCostMethod)})`);
+  }
+  let rate = null;
+  if (opts.labourRatePerHour !== void 0) {
+    if (typeof opts.labourRatePerHour !== "number" || !Number.isFinite(opts.labourRatePerHour) || opts.labourRatePerHour < 0) {
+      problems.push(`labourRatePerHour must be a finite number >= 0 (got ${String(opts.labourRatePerHour)})`);
+    } else {
+      rate = opts.labourRatePerHour;
+    }
+  }
+  if (method === "provided" && rate === null) {
+    problems.push(`labourRatePerHour is required (finite number >= 0) when labourCostMethod is "provided" (got ${String(opts.labourRatePerHour)})`);
+  }
+  for (const key of ["includeRecurringCosts", "includeUnbilledRevenue", "groupByActivity"]) {
+    const v = opts[key];
+    if (v !== void 0 && typeof v !== "boolean") problems.push(`${key} must be a boolean (got ${String(v)})`);
+  }
+  if (opts.externalMonthlyCosts !== void 0) {
+    const emc = opts.externalMonthlyCosts;
+    if (!Array.isArray(emc)) {
+      problems.push("externalMonthlyCosts must be an array of finite numbers >= 0, indexed by month from dateFrom (got a non-array)");
+    } else {
+      const max = isDateYMD2(opts.dateFrom) && isDateYMD2(opts.dateTo) && opts.dateTo >= opts.dateFrom ? monthsInWindow(opts.dateFrom, opts.dateTo) : Infinity;
+      for (let i = 0; i < emc.length; i++) {
+        const v = emc[i];
+        if (typeof v !== "number" || !Number.isFinite(v) || v < 0) {
+          problems.push(`externalMonthlyCosts[${i}] must be a finite number >= 0 (got ${String(v)})`);
+        }
+      }
+      if (emc.length > max) {
+        problems.push(`externalMonthlyCosts must be an array of finite numbers >= 0, indexed by month from dateFrom, with at most ${max} entries (got ${emc.length})`);
+      }
+    }
+  }
+  const stale = opts.staleAfterDays ?? 30;
+  if (!Number.isInteger(stale) || stale < 1) problems.push(`staleAfterDays must be an integer >= 1 (got ${String(opts.staleAfterDays)})`);
+  const mtj = opts.maxTicketsForJoin ?? 500;
+  if (!Number.isInteger(mtj) || mtj < 1 || mtj > 500) {
+    problems.push(`maxTicketsForJoin must be an integer 1..500 (the in-filter cap; got ${String(opts.maxTicketsForJoin)})`);
+  }
+  let limit = 50;
+  if (opts.limit !== void 0) {
+    if (!Number.isInteger(opts.limit) || opts.limit < 1) {
+      problems.push(`limit must be an integer >= 1 (got ${String(opts.limit)})`);
+    } else {
+      limit = Math.min(opts.limit, 500);
+    }
+  }
+  try {
+    parseIdentifier(contractId, "contractId");
+  } catch (err) {
+    problems.push(err instanceof AutotaskError ? err.message : "contractId must be a vendor numeric id");
+  }
+  if (problems.length > 0) {
+    throw new AutotaskConfigError(
+      `profitability: ${problems.length} problem(s) found pre-request (zero wire was issued)
+- ` + problems.join("\n- "),
+      { operation: "contracts.profitability" }
+    );
+  }
+  return {
+    dateFrom: opts.dateFrom,
+    dateTo: opts.dateTo,
+    method,
+    labourRatePerHour: rate,
+    includeRecurringCosts: opts.includeRecurringCosts ?? true,
+    includeUnbilledRevenue: opts.includeUnbilledRevenue ?? true,
+    externalMonthlyCosts: Array.isArray(opts.externalMonthlyCosts) ? [...opts.externalMonthlyCosts] : [],
+    groupByActivity: opts.groupByActivity ?? true,
+    staleAfterDays: stale,
+    maxTicketsForJoin: mtj,
+    limit
+  };
+}
+async function boundedPart2(http, path, conditions, limit, operation, includeFields) {
+  const body = { MaxRecords: limit, filter: conditions };
+  if (includeFields !== void 0) body.IncludeFields = includeFields;
+  const res = await http.request({
+    method: "POST",
+    idempotent: true,
+    path,
+    body,
+    operation
+  });
+  const { items, pageDetails } = unwrapItems(res, operation);
+  const capped = items.length >= limit;
+  return { items, capped, hasMore: capped && pageDetails.nextPageUrl != null };
+}
+function capJoinSet2(ids, cap) {
+  const sorted = [...new Set(ids)].sort((a, b) => a - b);
+  if (sorted.length <= cap) return { ids: sorted, truncated: false, total: sorted.length };
+  return { ids: sorted.slice(0, cap), truncated: true, total: sorted.length };
+}
+async function fetchByIdsPart(http, entityPath, ids, fields, operation) {
+  const unique = [...new Set(ids)].sort((a, b) => a - b);
+  const byKey = /* @__PURE__ */ new Map();
+  const misses = [];
+  const notes = [];
+  for (let c = 0; c < unique.length; c += FETCH_BY_IDS_CHUNK_SIZE) {
+    const chunk = unique.slice(c, c + FETCH_BY_IDS_CHUNK_SIZE);
+    const chunkKeys = new Set(chunk);
+    try {
+      const body = {
+        MaxRecords: FETCH_BY_IDS_CHUNK_SIZE,
+        filter: [{ field: "id", op: "in", value: chunk }],
+        IncludeFields: fields
+      };
+      const res = await http.request({ method: "POST", idempotent: true, path: `${entityPath}/query`, body, operation });
+      const { items: rows } = unwrapItems(res, operation);
+      for (const row of rows) {
+        const k = num2(row.id);
+        if (k > 0 && chunkKeys.has(k)) byKey.set(k, row);
+      }
+    } catch (err) {
+      const code = err instanceof AutotaskError ? err.code : "SERVER_ERROR";
+      for (const k of chunk) {
+        if (!byKey.has(k) && !misses.some((m) => m.id === k)) misses.push({ id: k, code, message: err instanceof Error ? err.message : String(err) });
+      }
+    }
+  }
+  const queryMissed = unique.filter((k) => !byKey.has(k) && !misses.some((m) => m.id === k));
+  for (const k of queryMissed) {
+    try {
+      const res = await http.request({ method: "GET", path: `${entityPath}/${k}`, operation });
+      byKey.set(k, unwrapItem(res, k, operation));
+    } catch (err) {
+      if (err instanceof NotFoundError) {
+        misses.push({ id: k, code: "NOT_FOUND", message: err.message });
+      } else if (err instanceof AutotaskError) {
+        misses.push({ id: k, code: err.code, message: err.message });
+      } else {
+        misses.push({ id: k, code: "SERVER_ERROR", message: err instanceof Error ? err.message : String(err) });
+      }
+    }
+  }
+  const items = unique.map((k) => byKey.get(k)).filter((r) => r !== void 0);
+  const gotByQuery = unique.length - queryMissed.length;
+  if (queryMissed.length > 0 && gotByQuery === 0 && byKey.size > 0) {
+    notes.push(
+      `the chunk \`id in\` query returned 0 rows for ${byKey.size} id(s) \u2014 the per-id get fallback resolved them (the list-scoping quirk: get-by-id is the authority)`
+    );
+  }
+  const foundIds = new Set(byKey.keys());
+  if (misses.length > 0) {
+    const byCode = /* @__PURE__ */ new Map();
+    for (const m of misses) byCode.set(m.code, (byCode.get(m.code) ?? 0) + 1);
+    notes.push(`${misses.length} id(s) unreadable: ${[...byCode.entries()].map(([code, n]) => `${n} \xD7 ${code}`).join(", ")} (per-item typed misses \u2014 the rest resolved)`);
+  }
+  return { items, foundIds, misses, notes };
+}
+function ladderFrom(ctx) {
+  const rungs = [];
+  const push = (s) => rungs.push(s);
+  switch (ctx.method) {
+    case "billing_item_our_cost":
+      push("billing_item.ourCost");
+      push("contract_role_costs.rate");
+      push("resource.internalCost");
+      break;
+    case "contract_role_cost":
+      push("contract_role_costs.rate");
+      push("resource.internalCost");
+      break;
+    case "resource_internal_cost":
+      push("resource.internalCost");
+      break;
+    case "provided":
+      break;
+  }
+  if (ctx.rate !== null) push("provided");
+  return rungs;
+}
+function hoursOf(entry) {
+  const h = entry["hoursWorked"];
+  return typeof h === "number" && Number.isFinite(h) && h > 0 ? h : 0;
+}
+function resolveLabour(entry, ctx) {
+  const id = num2(entry["id"]);
+  const hours = hoursOf(entry);
+  for (const rung of ladderFrom(ctx)) {
+    if (rung === "billing_item.ourCost") {
+      const items = ctx.billedByEntryId.get(id) ?? [];
+      const costs = items.map((i) => i["ourCost"]).filter((v) => typeof v === "number" && Number.isFinite(v) && v >= 0);
+      if (costs.length > 0) {
+        return {
+          source: "billing_item.ourCost",
+          cost: costs.reduce((a, b) => a + b, 0),
+          rate: null,
+          evidence: { billingItemIds: items.map((i) => num2(i["id"])) }
+        };
+      }
+      continue;
+    }
+    if (rung === "contract_role_costs.rate") {
+      const resId = num2(entry["resourceID"]);
+      const roleId = num2(entry["roleID"]);
+      const row = resId > 0 && roleId > 0 ? ctx.roleCostByResourceRole.get(`${resId}:${roleId}`) ?? ctx.roleCostByRole.get(roleId) : roleId > 0 ? ctx.roleCostByRole.get(roleId) : void 0;
+      const rate = row ? row["rate"] : void 0;
+      if (row !== void 0 && typeof rate === "number" && Number.isFinite(rate) && rate >= 0) {
+        const matched = row !== void 0 && resId > 0 && roleId > 0 && ctx.roleCostByResourceRole.get(`${resId}:${roleId}`) !== void 0 ? "resource+role" : "role";
+        return { source: "contract_role_costs.rate", cost: rate * hours, rate, evidence: { contractRoleCostId: num2(row["id"]), matched } };
+      }
+      continue;
+    }
+    if (rung === "resource.internalCost") {
+      const resId = num2(entry["resourceID"]);
+      const r = resId > 0 ? ctx.resourcesById.get(resId) : void 0;
+      const ic = r ? r["internalCost"] : void 0;
+      if (r !== void 0 && typeof ic === "number" && Number.isFinite(ic) && ic >= 0) {
+        return { source: "resource.internalCost", cost: ic * hours, rate: ic, evidence: { resourceId: resId } };
+      }
+      continue;
+    }
+    if (rung === "provided" && ctx.rate !== null) {
+      return { source: "provided", cost: ctx.rate * hours, rate: ctx.rate, evidence: {} };
+    }
+  }
+  return { source: "missing", cost: null, rate: null, evidence: {} };
+}
+async function expandByMonth(http, path, fullWindowCond, limit, operation, fields, dateField, dateFrom, dateTo, wires) {
+  const months = monthsBetween(dateFrom, dateTo);
+  const seen = /* @__PURE__ */ new Set();
+  const all = [];
+  const cappedMonths = [];
+  const fullMonths = [];
+  for (const m of months) {
+    const b = monthBounds(m, dateFrom, dateTo);
+    const cond = [
+      ...fullWindowCond.filter((c) => c.field !== dateField),
+      { field: dateField, op: "gte", value: b.start },
+      { field: dateField, op: "lt", value: b.endExclusive }
+    ];
+    const page = await boundedPart2(http, path, cond, limit, operation, fields);
+    wires.issued += 1;
+    for (const row of page.items) {
+      const k = num2(row["id"]);
+      if (seen.has(k)) continue;
+      seen.add(k);
+      all.push(row);
+    }
+    if (page.capped) cappedMonths.push(m);
+    if (page.capped && page.hasMore) fullMonths.push(m);
+  }
+  const partNote = `per-month windowing fired: ${months.length} month read(s) added after the full-window page carried a live cursor (no cursor walk \u2014 the single-page house rule)` + (fullMonths.length > 0 ? ` | month ${fullMonths.join(", ")} hit the limit of ${limit} \u2014 figures cover the returned rows only; widen with a narrower window or higher limit` : "");
+  wires.note = (wires.note ? wires.note + " | " : "") + partNote;
+  return { items: all, capped: cappedMonths.length > 0, hasMore: fullMonths.length > 0, note: partNote, status: "ok", truncatedMonths: fullMonths };
+}
+async function degradable(read) {
+  try {
+    return await read();
+  } catch (err) {
+    if (!(err instanceof AutotaskError)) throw err;
+    return { items: [], capped: false, hasMore: false, absent: err.code, absentMessage: err.message };
+  }
+}
+function fmtHours(h) {
+  const r = Math.round(h * 100) / 100;
+  return String(r);
+}
+function fmtNum(v) {
+  const r = Math.round(v * 100) / 100;
+  return String(r);
+}
+function pctOrNa(r) {
+  return r === null ? "n/a" : `${Math.round(r * 1e3) / 10}%`;
+}
+function dedupeSortCap(ids, limit) {
+  return [...new Set(ids)].sort((a, b) => Number(a) - Number(b)).slice(0, limit);
+}
+async function profitability(resource, contractId, opts, rawHttp) {
+  const v = validateProfitabilityOptions(contractId, opts ?? {});
+  const OP2 = "contracts.profitability";
+  const id = parseIdentifier(contractId, "contractId");
+  const idNum = typeof id === "number" ? id : Number(id);
+  const wires = { issued: 0, requests: 0, budget: PROFITABILITY_WIRE_BUDGET };
+  const asOf = (/* @__PURE__ */ new Date()).toISOString();
+  const asOfMs = Date.parse(asOf);
+  const toExcl = dayAfter(v.dateTo);
+  const windowOn = (field) => [{ field, op: "gte", value: v.dateFrom }, { field, op: "lt", value: toExcl }];
+  const http = { request: (o) => {
+    wires.requests += 1;
+    return rawHttp.request(o);
+  } };
+  const readPart = (path, conditions, fields) => {
+    wires.issued += 1;
+    return degradable(() => boundedPart2(http, path, conditions, v.limit, OP2, fields));
+  };
+  const skipPart = (note) => ({ items: [], capped: false, hasMore: false, status: "skipped", note });
+  const stampPart = (key, raw, conditions, extraNotes) => {
+    if (raw.absent !== void 0) {
+      return { items: [], capped: false, hasMore: false, status: "absent", absent: raw.absent, note: `absent: the read failed (${raw.absent}: ${raw.absentMessage ?? ""}) \u2014 the monthly figures it feeds carry it in coverage_gaps` };
+    }
+    const st = unbilledWorkPartStatus(key, conditions, raw.items);
+    return {
+      items: raw.items,
+      capped: raw.capped,
+      hasMore: raw.hasMore,
+      status: st.status,
+      blindSurface: st.blindSurface,
+      note: [st.note, ...extraNotes ?? []].filter(Boolean).join(" | ") || void 0,
+      emptyReason: raw.items.length === 0 && st.status === "ok" ? EMPTY_REASON_STAMPS[key]?.query : void 0
+    };
+  };
+  const truncatedMonths = {};
+  const windowedPart = async (name, key, path, cond, fields, dateField) => {
+    const first = await readPart(path, cond, fields);
+    if (first.absent !== void 0 || !first.hasMore) return { part: stampPart(key, first, cond), rows: first.items };
+    const wp = await degradable(() => expandByMonth(http, path, cond, v.limit, OP2, fields, dateField, v.dateFrom, v.dateTo, wires));
+    if (!("truncatedMonths" in wp)) return { part: stampPart(key, wp, cond), rows: [] };
+    const { truncatedMonths: tm, ...part } = wp;
+    truncatedMonths[name] = tm;
+    return { part, rows: wp.items };
+  };
+  const contractCached = rawHttp.readCache?.get(`/V1.0/Contracts/${id}`) !== void 0;
+  const contract = await resource.get(id);
+  wires.issued += 1;
+  if (!contractCached) wires.requests += 1;
+  const contractRow = contract;
+  const companyID = num2(contractRow["companyID"]);
+  const contractType = num2(contractRow["contractType"]);
+  let customer = null;
+  let customerStatus = "skipped";
+  let customerAbsent;
+  if (companyID > 0) {
+    try {
+      const res = await http.request({
+        method: "GET",
+        path: `/V1.0/Companies/${companyID}`,
+        operation: OP2
+      });
+      const item = unwrapItem(res, companyID, OP2);
+      customer = item ?? null;
+      customerStatus = "ok";
+    } catch (err) {
+      if (!(err instanceof AutotaskError)) throw err;
+      if (!(err instanceof NotFoundError)) {
+        customerStatus = "absent";
+        customerAbsent = err.code;
+      }
+    }
+    wires.issued += 1;
+  }
+  let contractTypeLabel = null;
+  if (contractType > 0) {
+    wires.issued += 1;
+    try {
+      contractTypeLabel = (await readPicklists(http, "/V1.0/Contracts", OP2)).get("contractType")?.get(contractType) ?? null;
+    } catch (err) {
+      if (!(err instanceof AutotaskError)) throw err;
+    }
+  }
+  const contractTypeKnown = contractTypeLabel !== null;
+  const isBlockHours = contractTypeKnown && BLOCK_HOURS_LABEL_RE.test(contractTypeLabel);
+  const isTimeAndMaterials = contractTypeKnown && TIME_AND_MATERIALS_LABEL_RE.test(contractTypeLabel);
+  const servicesCond = [{ field: "contractID", op: "eq", value: id }];
+  const servicesRaw = await readPart("/V1.0/ContractServices/query", servicesCond, ["id", "serviceID", "unitPrice", "unitCost", "internalCurrencyUnitPrice", "internalDescription"]);
+  const unitsCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("startDate")];
+  const units = await windowedPart("contractServiceUnits", "contract_service_units", "/V1.0/ContractServiceUnits/query", unitsCond, ["id", "contractServiceID", "serviceID", "units", "price", "cost", "internalCurrencyPrice", "startDate", "endDate", "approveAndPostDate"], "startDate");
+  const unitRows = units.rows;
+  let chargesPart;
+  let charges = [];
+  let chargesCond = [];
+  if (v.includeRecurringCosts) {
+    chargesCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("datePurchased")];
+    const raw = await readPart("/V1.0/ContractCharges/query", chargesCond, ["id", "chargeType", "billableAmount", "extendedCost", "unitCost", "unitPrice", "unitQuantity", "datePurchased", "isBilled", "status", "contractServiceID"]);
+    charges = raw.items;
+    chargesPart = stampPart("contract_charges", raw, chargesCond);
+  } else {
+    chargesPart = skipPart("skipped: includeRecurringCosts is false (zero wire)");
+  }
+  const roleCostsCond = [{ field: "contractID", op: "eq", value: id }];
+  const roleCostsRaw = await readPart("/V1.0/ContractRoleCosts/query", roleCostsCond, ["id", "rate", "resourceID", "roleID"]);
+  const ratesCond = [{ field: "contractID", op: "eq", value: id }];
+  const ratesRaw = await readPart("/V1.0/ContractRates/query", ratesCond, ["id", "roleID", "contractHourlyRate", "internalCurrencyContractHourlyRate"]);
+  let blocksPart;
+  if (!isBlockHours) {
+    blocksPart = skipPart(
+      contractTypeKnown ? `skipped: not a Block Hours contract (contractType ${contractType} "${contractTypeLabel}") \u2014 included hours apply to hour blocks only (zero wire)` : `skipped: the contract type is unknown (contractType ${contractType || "absent"}; label unresolved) \u2014 included hours are not evaluable (zero wire)`
+    );
+  } else {
+    const blocksCond = [{ field: "contractID", op: "eq", value: id }];
+    const raw = await readPart("/V1.0/ContractBlocks/query", blocksCond, ["id", "datePurchased", "startDate", "endDate", "hours", "hoursApproved", "status", "isPaid"]);
+    blocksPart = stampPart("contract_blocks", raw, blocksCond);
+  }
+  const billingCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("itemDate")];
+  const billingFields = ["id", "invoiceID", "timeEntryID", "ticketID", "ourCost", "quantity", "rate", "extendedPrice", "internalCurrencyExtendedPrice", "itemDate", "postedDate", "nonBillable", "billingCodeID", "billingItemType", "expenseItemID", ...SERVICE_LINE_FKS, ...CHARGE_LINE_FKS];
+  const billing = await windowedPart("billingItems", "billing_items", "/V1.0/BillingItems/query", billingCond, billingFields, "itemDate");
+  const billingItems = billing.part;
+  const billingRows = billing.rows;
+  const invoiceIds = [...new Set(billingRows.map((b) => num2(b["invoiceID"])).filter((n) => n > 0))];
+  let invoicesPart;
+  let invoices = [];
+  if (invoiceIds.length === 0) {
+    invoicesPart = skipPart("skipped: the billing part has no invoiceIDs (zero wire)");
+  } else {
+    const capped = capJoinSet2(invoiceIds, FETCH_BY_IDS_MAX_ITEMS);
+    if (capped.truncated) wires.note = (wires.note ? wires.note + " | " : "") + `invoiceJoinTruncated: the join set is capped at ${FETCH_BY_IDS_MAX_ITEMS} of ${capped.total} invoice ids (the fetch-by-ids cap) \u2014 the figures cover the returned set only`;
+    const fb = await fetchByIdsPart(http, "/V1.0/Invoices", capped.ids, ["id", "invoiceNumber", "invoiceTotal", "paidDate", "isVoided", "dueDate"], OP2);
+    wires.issued += 1;
+    invoices = fb.items;
+    invoicesPart = { items: fb.items, capped: capped.truncated, hasMore: capped.truncated, status: "ok", note: fb.notes.join(" | ") || void 0 };
+  }
+  const timeCond = [{ field: "contractID", op: "eq", value: id }, ...windowOn("dateWorked")];
+  const timeFields = ["id", "ticketID", "taskID", "resourceID", "roleID", "hoursWorked", "hoursToBill", "dateWorked", "startDateTime", "endDateTime", "isNonBillable", "timeEntryType", "billingCodeID", "createDateTime"];
+  const time = await windowedPart("timeEntries", "time_entries", "/V1.0/TimeEntries/query", timeCond, timeFields, "dateWorked");
+  const timeEntries = time.part;
+  const entries = time.rows;
+  const ticketFields = ["id", "ticketNumber", "title", "status", "ticketCategory", "contractID", "createDate", "resolvedDateTime", "completedDate", "lastActivityDate", "dueDateTime"];
+  const createdInWindow = [{ field: "contractID", op: "eq", value: id }, ...windowOn("createDate")];
+  const refTicketIds = capJoinSet2(entries.map((e) => num2(e["ticketID"])).filter((n) => n > 0), v.maxTicketsForJoin);
+  const ticketsActCond = refTicketIds.ids.length === 0 ? createdInWindow : [{ op: "or", items: [{ op: "and", items: createdInWindow }, { field: "id", op: "in", value: refTicketIds.ids }] }];
+  const ticketsActRaw = await readPart("/V1.0/Tickets/query", ticketsActCond, ticketFields);
+  let openStatusSet = null;
+  let statusNote;
+  wires.issued += 1;
+  try {
+    const values = (await readPicklists(http, "/V1.0/Tickets", OP2)).get("status");
+    if (values === void 0 || values.size === 0) {
+      statusNote = "the tickets.status picklist is not exposed to this API user \u2014 the open-status labels are unavailable";
+    } else {
+      const open = [...values].filter(([, label]) => !CLOSED_STATUS_LABEL_RE.test(label)).map(([v2]) => v2);
+      if (open.length === 0) {
+        statusNote = "every tickets.status picklist label is closed-class \u2014 no open statuses exist in this tenant";
+      } else {
+        openStatusSet = new Set(open);
+      }
+    }
+  } catch (err) {
+    statusNote = `the tickets.status field catalog read failed (${err instanceof AutotaskError ? err.code : "SERVER_ERROR"}: ${err instanceof Error ? err.message : String(err)}) \u2014 the open-status labels are unavailable`;
+  }
+  let ticketsOpenPart;
+  let openTickets = [];
+  if (openStatusSet === null) {
+    ticketsOpenPart = skipPart(`skipped: ${statusNote} (zero wire)`);
+  } else {
+    const openCond = [{ field: "contractID", op: "eq", value: id }, { field: "status", op: "in", value: [...openStatusSet] }];
+    const raw = await readPart("/V1.0/Tickets/query", openCond, ticketFields);
+    openTickets = raw.items;
+    ticketsOpenPart = stampPart("tickets", raw, openCond, ["openStatusHeuristic: true (the open set is the tenant picklist minus the closed-class labels)"]);
+  }
+  const resourceIds = [...new Set(entries.map((t) => num2(t["resourceID"])).filter((n) => n > 0))];
+  let resourcesPart;
+  let resources = [];
+  const resourceMissIds = /* @__PURE__ */ new Set();
+  if (resourceIds.length === 0) {
+    resourcesPart = skipPart("skipped: the time part has no resourceIDs (zero wire)");
+  } else {
+    const capped = capJoinSet2(resourceIds, FETCH_BY_IDS_MAX_ITEMS);
+    if (capped.truncated) wires.note = (wires.note ? wires.note + " | " : "") + `resourceJoinTruncated: the join set is capped at ${FETCH_BY_IDS_MAX_ITEMS} of ${capped.total} resource ids (the fetch-by-ids cap) \u2014 the figures cover the returned set only`;
+    const fb = await fetchByIdsPart(http, "/V1.0/Resources", capped.ids, ["id", "internalCost", "firstName", "lastName", "isActive", "userType"], OP2);
+    wires.issued += 1;
+    resources = fb.items;
+    for (const m of fb.misses) if (m.code === "NOT_FOUND") resourceMissIds.add(m.id);
+    resourcesPart = { items: fb.items, capped: capped.truncated, hasMore: capped.truncated, status: "ok", note: fb.notes.join(" | ") || void 0 };
+  }
+  const fetchedTickets = /* @__PURE__ */ new Map();
+  for (const t of [...ticketsActRaw.items, ...openTickets]) {
+    const k = num2(t["id"]);
+    if (k > 0 && !fetchedTickets.has(k)) fetchedTickets.set(k, t);
+  }
+  const contractTickets = [...fetchedTickets.values()].filter((t) => num2(t["contractID"]) === idNum);
+  const ticketJoin = capJoinSet2(contractTickets.map((t) => num2(t["id"])), v.maxTicketsForJoin);
+  const joinNote = ticketJoin.truncated ? `the ticket join set is capped at ${v.maxTicketsForJoin} of ${ticketJoin.total} ids \u2014 the expenses + the miscoding probe cover the returned join set only` : void 0;
+  let expensesPart;
+  let expenses = [];
+  if (ticketJoin.ids.length === 0) {
+    expensesPart = skipPart("skipped: the contract has no fetched tickets to join against (an empty join set is NOT evidence of no expenses \u2014 zero wire)");
+  } else {
+    const expCond = [{ field: "ticketID", op: "in", value: ticketJoin.ids }, ...windowOn("expenseDate")];
+    const raw = await readPart("/V1.0/ExpenseItems/query", expCond, ["id", "expenseDate", "expenseCategory", "paymentType", "expenseCurrencyExpenseAmount", "internalCurrencyExpenseAmount", "ticketID"]);
+    expenses = raw.items;
+    expensesPart = stampPart("expense_items", raw, expCond, joinNote === void 0 ? void 0 : [joinNote]);
+  }
+  let probePart;
+  let probeRows = [];
+  if (ticketJoin.ids.length === 0) {
+    probePart = skipPart("skipped: the contract has no fetched tickets to probe against (zero wire) \u2014 check 1 (miscoded_time_out) is not evaluable");
+  } else {
+    const probeCond = [
+      { field: "ticketID", op: "in", value: ticketJoin.ids },
+      { op: "or", items: [{ field: "contractID", op: "noteq", value: id }, { field: "contractID", op: "notExist" }] },
+      ...windowOn("dateWorked")
+    ];
+    const raw = await readPart("/V1.0/TimeEntries/query", probeCond, ["id", "ticketID", "contractID", "resourceID", "hoursWorked", "dateWorked"]);
+    probeRows = raw.items;
+    probePart = stampPart("time_entries", raw, probeCond, joinNote === void 0 ? void 0 : [joinNote]);
+  }
+  let configurationItemsPart;
+  let cis = [];
+  if (!v.includeRecurringCosts) {
+    configurationItemsPart = skipPart("skipped: includeRecurringCosts is false (zero wire)");
+  } else {
+    const ciCond = [{ field: "contractID", op: "eq", value: id }];
+    const raw = await readPart("/V1.0/ConfigurationItems/query", ciCond, ["id", "configurationItemName", "status", "contractID"]);
+    cis = raw.items;
+    configurationItemsPart = stampPart("configuration_items", raw, ciCond);
+  }
+  let subscriptionsPart;
+  let subscriptions = [];
+  const subFactor = /* @__PURE__ */ new Map();
+  const oneTimeSubs = /* @__PURE__ */ new Set();
+  const cancelledSubs = /* @__PURE__ */ new Set();
+  if (cis.length === 0) {
+    subscriptionsPart = skipPart("skipped: the CI join found no configuration items \u2014 the subscriptions part is not evaluable (zero wire)");
+  } else {
+    const ciIds = capJoinSet2(cis.map((c) => num2(c["id"])).filter((n) => n > 0), FETCH_BY_IDS_MAX_ITEMS);
+    const subCond = [{ field: "configurationItemID", op: "in", value: ciIds.ids }];
+    const raw = await readPart("/V1.0/Subscriptions/query", subCond, ["id", "subscriptionName", "configurationItemID", "periodCost", "periodPrice", "periodType", "effectiveDate", "expirationDate", "status", "totalCost"]);
+    subscriptions = raw.items;
+    let labels = null;
+    if (subscriptions.length > 0) {
+      wires.issued += 1;
+      try {
+        labels = await readPicklists(http, "/V1.0/Subscriptions", OP2);
+      } catch (err) {
+        if (!(err instanceof AutotaskError)) throw err;
+      }
+    }
+    for (const x of subscriptions) {
+      const sid = num2(x["id"]);
+      const periodLabel = labels?.get("periodType")?.get(num2(x["periodType"]));
+      subFactor.set(sid, periodMonthlyFactor(x["periodType"], periodLabel));
+      if (isOneTimePeriod(x["periodType"], periodLabel)) oneTimeSubs.add(sid);
+      const statusLabel = labels?.get("status")?.get(num2(x["status"]));
+      const notActive = statusLabel !== void 0 ? NOT_ACTIVE_LABEL_RE.test(statusLabel) : labels === null && SUBSCRIPTION_NOT_ACTIVE_STATUS_IDS.has(num2(x["status"]));
+      if (notActive) cancelledSubs.add(sid);
+    }
+    const unknownPeriods = [...new Set(subscriptions.filter((x) => subFactor.get(num2(x["id"])) === null && !oneTimeSubs.has(num2(x["id"]))).map((x) => String(x["periodType"] ?? "absent")))];
+    subscriptionsPart = stampPart("subscriptions", raw, subCond, [
+      "scope: the subscriptions on the CIs this contract covers \u2014 periodCost prorated to a month by periodType into tooling_cost.vendor, REPORTED but NOT folded into total_cost/profit/margin (subscriptions bill outside the contract)",
+      ...subscriptions.length > 0 && labels === null ? ["the Subscriptions field catalog read failed \u2014 the verified id maps apply (periodType 1 One-Time, 2 Monthly, 3 Quarterly, 4 Semi-Annual, 5 Yearly; status 2 Cancelled / 3 Inactive excluded)"] : [],
+      ...cancelledSubs.size > 0 ? [`${cancelledSubs.size} not-active (cancelled/inactive) subscription(s) excluded from tooling_cost.vendor`] : [],
+      ...oneTimeSubs.size > 0 ? [`${oneTimeSubs.size} one-time subscription(s): periodCost booked whole in the effectiveDate month, never prorated`] : [],
+      ...unknownPeriods.length > 0 ? [`unrecognised periodType ${unknownPeriods.join(", ")} \u2014 those subscriptions are excluded from tooling_cost.vendor (not prorated)`] : []
+    ]);
+  }
+  const servicesPart = stampPart("contract_services", servicesRaw, servicesCond);
+  const unitsPart = units.part;
+  const roleCostsPart = stampPart("contract_role_costs", roleCostsRaw, roleCostsCond);
+  const ratesPart = stampPart("contract_rates", ratesRaw, ratesCond);
+  const ticketsActivityPart = stampPart("tickets", ticketsActRaw, ticketsActCond, [
+    ...ticketsActRaw.hasMore ? [`${fetchedTickets.size} ticket(s) returned of possibly more \u2014 the checks cover the returned set only`] : [],
+    ...refTicketIds.truncated ? [`the time-referenced ticket ids are capped at ${v.maxTicketsForJoin} of ${refTicketIds.total} \u2014 the rest read as ticket_not_in_fetched_set`] : []
+  ]);
+  const billedByEntryId = /* @__PURE__ */ new Map();
+  for (const b of billingRows) {
+    const te = num2(b["timeEntryID"]);
+    if (te <= 0) continue;
+    const arr = billedByEntryId.get(te) ?? [];
+    arr.push(b);
+    billedByEntryId.set(te, arr);
+  }
+  const roleCostByResourceRole = /* @__PURE__ */ new Map();
+  const roleCostByRole = /* @__PURE__ */ new Map();
+  for (const rc of roleCostsRaw.items) {
+    const resId = num2(rc["resourceID"]);
+    const roleId = num2(rc["roleID"]);
+    if (resId > 0 && roleId > 0) roleCostByResourceRole.set(`${resId}:${roleId}`, rc);
+    else if (roleId > 0) roleCostByRole.set(roleId, rc);
+  }
+  const resourcesById = new Map(resources.map((r) => [num2(r["id"]), r]));
+  const ladderCtx = { method: v.method, rate: v.labourRatePerHour, billedByEntryId, roleCostByResourceRole, roleCostByRole, resourcesById, resourceMissIds };
+  const entryResolution = /* @__PURE__ */ new Map();
+  for (const e of entries) entryResolution.set(num2(e["id"]), resolveLabour(e, ladderCtx));
+  const activeRungs = ladderFrom(ladderCtx);
+  const sources = {};
+  for (const rung of activeRungs) sources[rung] = { entries: 0, hours: 0, cost: 0 };
+  sources.missing = { entries: 0, hours: 0, cost: 0 };
+  const resolutionNotes = [];
+  if (v.method === "billing_item_our_cost") {
+    const noItems = entries.filter((e) => !billedByEntryId.has(num2(e["id"]))).length;
+    if (noItems > 0) resolutionNotes.push(`${noItems} ${noItems === 1 ? "entry" : "entries"} had no billing item (non-billable or unposted) \u2014 rung 1 not usable`);
+  }
+  for (const resId of [...resourceMissIds].sort((a, b) => a - b)) {
+    const n = entries.filter((e) => num2(e["resourceID"]) === resId).length;
+    resolutionNotes.push(`resource ${resId} unreadable (fetchByIds NOT_FOUND) \u2014 rung 3 unavailable for ${n} ${n === 1 ? "entry" : "entries"}`);
+  }
+  for (const e of entries) {
+    const r = entryResolution.get(num2(e["id"]));
+    const bucket = sources[r.source] ?? sources.missing;
+    bucket.entries += 1;
+    bucket.hours += hoursOf(e);
+    bucket.cost += r.cost ?? 0;
+  }
+  for (const b of Object.values(sources)) b.cost = cents(b.cost);
+  const unresolvedHours = sources.missing.hours;
+  if (unresolvedHours > 0) resolutionNotes.push(`${fmtHours(unresolvedHours)} hours unresolved (missing rate) \u2014 total_cost is a lower bound`);
+  const costRateResolution = { method: v.method, sources, unresolvedHours, notes: resolutionNotes };
+  const months = monthsBetween(v.dateFrom, v.dateTo);
+  const monthOf = (date) => typeof date === "string" && DATE_RE2.test(`${date}`.slice(0, 10)) ? date.slice(0, 7) : null;
+  const inMonth = (date, m) => monthOf(date) === m;
+  const unitIn = (unit, m) => inMonth(unit["startDate"], m);
+  const lineRevenue = (b) => internalAmount(b, "internalCurrencyExtendedPrice", "extendedPrice");
+  const expectedBasis = unitsPart.status !== "absent" && (servicesRaw.items.length > 0 || unitRows.length > 0);
+  const expectedIn = (m) => unitRows.filter((u) => unitIn(u, m)).reduce((a, u) => a + internalAmount(u, "internalCurrencyPrice", "price"), 0);
+  const recurringIn = (m) => {
+    if (!v.includeRecurringCosts) return 0;
+    let total = 0;
+    for (const c of charges) if (inMonth(c["datePurchased"], m)) total += chargeCost(c);
+    for (const u of unitRows) if (unitIn(u, m)) total += num2(u["cost"]);
+    return total;
+  };
+  const invoicesById = new Map(invoices.map((i) => [num2(i["id"]), i]));
+  const billedServiceIn = (m) => {
+    let billed = 0;
+    const ids = [];
+    for (const b of billingRows) {
+      if (!inMonth(b["itemDate"], m) || billingLineType(b) !== "recurring") continue;
+      const invId = num2(b["invoiceID"]);
+      const inv = invId > 0 ? invoicesById.get(invId) : void 0;
+      if (inv === void 0 || inv["isVoided"] === true) continue;
+      billed += lineRevenue(b);
+      ids.push(num2(b["id"]));
+    }
+    return { billed, ids };
+  };
+  const contractRateByRole = /* @__PURE__ */ new Map();
+  for (const r of ratesRaw.items) {
+    const rate = typeof r["internalCurrencyContractHourlyRate"] === "number" ? r["internalCurrencyContractHourlyRate"] : r["contractHourlyRate"];
+    if (num2(r["roleID"]) > 0 && typeof rate === "number" && Number.isFinite(rate)) contractRateByRole.set(num2(r["roleID"]), rate);
+  }
+  const monthlyParts = [
+    ["contractServiceUnits", unitsPart],
+    ["contractCharges", chargesPart],
+    ["contractRoleCosts", roleCostsPart],
+    ["billingItems", billingItems],
+    ["timeEntries", timeEntries],
+    ["expenses", expensesPart],
+    ["subscriptions", subscriptionsPart]
+  ];
+  const coverageGaps = (m) => {
+    const gaps = [];
+    for (const [name, p] of monthlyParts) {
+      if (p.status === "absent") gaps.push(`${name}: absent (${p.absent})`);
+      else if (truncatedMonths[name] !== void 0) {
+        if (truncatedMonths[name].includes(m)) gaps.push(`${name}: truncated at limit ${v.limit}`);
+      } else if (p.hasMore) gaps.push(`${name}: capped at limit ${v.limit}`);
+    }
+    return gaps;
+  };
+  const monthly = [];
+  for (let mi = 0; mi < months.length; mi++) {
+    const m = months[mi];
+    const mBilling = billingRows.filter((b) => inMonth(b["itemDate"], m));
+    let revenueInvoiced = 0;
+    let revenueVoided = 0;
+    let postedUninvoiced = 0;
+    const byType = { recurring: 0, labour: 0, charges: 0, expenses: 0, other: 0 };
+    let unresolvedInvoice = 0;
+    let unresolvedLines = 0;
+    for (const b of mBilling) {
+      const invId = num2(b["invoiceID"]);
+      if (invId <= 0) {
+        postedUninvoiced += lineRevenue(b);
+        continue;
+      }
+      const inv = invoicesById.get(invId);
+      if (inv === void 0) {
+        unresolvedInvoice += lineRevenue(b);
+        unresolvedLines += 1;
+        continue;
+      }
+      if (inv["isVoided"] === true) revenueVoided += lineRevenue(b);
+      else {
+        revenueInvoiced += lineRevenue(b);
+        byType[billingLineType(b)] += lineRevenue(b);
+      }
+    }
+    const expected = v.includeUnbilledRevenue && expectedBasis ? expectedIn(m) : null;
+    const expectedUnbilled = expected === null ? 0 : Math.max(0, expected - billedServiceIn(m).billed);
+    const mEntries = entries.filter((e) => inMonth(e["dateWorked"], m));
+    let labourHours = 0;
+    let labourTotal = 0;
+    let unresolved = 0;
+    const rateSources = {};
+    for (const rung of activeRungs) rateSources[rung] = { entries: 0, hours: 0, cost: 0 };
+    rateSources.missing = { entries: 0, hours: 0, cost: 0 };
+    for (const e of mEntries) {
+      const r = entryResolution.get(num2(e["id"]));
+      labourHours += hoursOf(e);
+      const bucket = rateSources[r.source];
+      bucket.entries += 1;
+      bucket.hours += hoursOf(e);
+      bucket.cost += r.cost ?? 0;
+      if (r.source === "missing") unresolved += hoursOf(e);
+      else labourTotal += r.cost ?? 0;
+    }
+    const unposted = mEntries.filter((e) => e["isNonBillable"] !== true && !billedByEntryId.has(num2(e["id"])));
+    const unpostedHours = unposted.reduce((a, e) => a + Math.max(0, num2(e["hoursToBill"])), 0);
+    let unpostedTime;
+    if (!contractTypeKnown) {
+      unpostedTime = { entries: unposted.length, hours: unpostedHours, value: null, absent: "CONTRACT_TYPE_UNKNOWN" };
+    } else if (!isTimeAndMaterials) {
+      unpostedTime = { entries: unposted.length, hours: unpostedHours, value: null, absent: "NOT_TIME_AND_MATERIALS_CONTRACT" };
+    } else if (unposted.some((e) => !contractRateByRole.has(num2(e["roleID"])))) {
+      unpostedTime = { entries: unposted.length, hours: unpostedHours, value: null, absent: "NO_CONTRACT_RATE" };
+    } else {
+      const value = unposted.reduce((a, e) => a + Math.max(0, num2(e["hoursToBill"])) * contractRateByRole.get(num2(e["roleID"])), 0);
+      unpostedTime = { entries: unposted.length, hours: unpostedHours, value };
+    }
+    let toolingVendor = subscriptionsPart.status === "skipped" || subscriptionsPart.status === "absent" ? null : 0;
+    if (toolingVendor !== null) {
+      for (const s of subscriptions) {
+        const eff = monthOf(s["effectiveDate"]) ?? "0000-00";
+        const exp = monthOf(s["expirationDate"]) ?? "9999-99";
+        const sid = num2(s["id"]);
+        if (cancelledSubs.has(sid)) continue;
+        if (oneTimeSubs.has(sid)) {
+          if (eff === m) toolingVendor += num2(s["periodCost"]);
+          continue;
+        }
+        const factor = subFactor.get(sid) ?? null;
+        if (factor !== null && eff <= m && m <= exp) toolingVendor += num2(s["periodCost"]) * factor;
+      }
+    }
+    const callerSupplied = v.externalMonthlyCosts[mi] ?? 0;
+    const recurring = recurringIn(m);
+    let expenseCost = 0;
+    for (const x of expenses) if (inMonth(x["expenseDate"], m)) expenseCost += num2(x["internalCurrencyExpenseAmount"]);
+    const totalCost = labourTotal + callerSupplied + recurring + expenseCost;
+    const profit = revenueInvoiced - totalCost;
+    const margin = revenueInvoiced > 0 ? profit / revenueInvoiced : null;
+    const nonLabour = totalCost - labourTotal;
+    const resolvedHours = mEntries.filter((e) => entryResolution.get(num2(e["id"])).source !== "missing").reduce((a, e) => a + hoursOf(e), 0);
+    const avgRate = resolvedHours > 0 ? labourTotal / resolvedHours : 0;
+    const breakEven = avgRate > 0 ? Math.max(0, (revenueInvoiced - nonLabour) / avgRate) : null;
+    for (const b of Object.values(rateSources)) b.cost = cents(b.cost);
+    const gaps = coverageGaps(m);
+    if (unresolvedLines > 0) gaps.push(`invoices: ${unresolvedLines} line(s) on unresolved invoices`);
+    monthly.push({
+      month: m,
+      revenue_invoiced: cents(revenueInvoiced),
+      revenue_by_type: { recurring: cents(byType.recurring), labour: cents(byType.labour), charges: cents(byType.charges), expenses: cents(byType.expenses), other: cents(byType.other) },
+      revenue_voided_excluded: cents(revenueVoided),
+      revenue_posted_uninvoiced: cents(postedUninvoiced),
+      revenue_unresolved_invoice: cents(unresolvedInvoice),
+      revenue_expected: cents(expected),
+      revenue_expected_unbilled: cents(expectedUnbilled),
+      unposted_time: { ...unpostedTime, value: cents(unpostedTime.value) },
+      labour_hours: labourHours,
+      labour_cost: { total: cents(labourTotal), unresolvedHours: unresolved, rateSources },
+      tooling_cost: { vendor: cents(toolingVendor), caller_supplied: cents(callerSupplied) },
+      recurring_cost: cents(recurring),
+      expense_cost: cents(expenseCost),
+      total_cost: cents(totalCost),
+      profit: cents(profit),
+      margin,
+      break_even_hours: breakEven,
+      coverage_gaps: gaps
+    });
+  }
+  const warnings = [];
+  warnings.push({
+    code: "miscoded_time_out",
+    count: probeRows.length,
+    sample_ids: dedupeSortCap(probeRows.map((p) => num2(p["id"])), v.limit)
+  });
+  const crossTimeEntries = entries.filter((e) => {
+    const t = num2(e["ticketID"]);
+    if (t <= 0) return false;
+    const ticket = fetchedTickets.get(t);
+    return ticket !== void 0 && num2(ticket["contractID"]) !== idNum;
+  });
+  warnings.push({ code: "cross_contract_ticket_time", count: crossTimeEntries.length, sample_ids: dedupeSortCap(crossTimeEntries.map((e) => num2(e["id"])), v.limit) });
+  const tupleGroups = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    const key = [String(num2(e["resourceID"])), String(e["dateWorked"] ?? ""), String(num2(e["ticketID"])), String(e["hoursWorked"] ?? "")].join("|");
+    const arr = tupleGroups.get(key) ?? [];
+    arr.push(e);
+    tupleGroups.set(key, arr);
+  }
+  const dupAll = [];
+  const dupSample = [];
+  for (const group of tupleGroups.values()) {
+    if (group.length < 2) continue;
+    const sorted = [...group].sort((a, b) => num2(a["id"]) - num2(b["id"]));
+    for (const e of sorted) dupAll.push(num2(e["id"]));
+    for (const e of sorted.slice(1)) dupSample.push(num2(e["id"]));
+  }
+  warnings.push({ code: "duplicate_entries", count: dupAll.length, sample_ids: dedupeSortCap(dupSample, v.limit) });
+  const zeroHours = entries.filter((e) => {
+    const h = e["hoursWorked"];
+    return !(typeof h === "number" && Number.isFinite(h) && h > 0);
+  });
+  warnings.push({ code: "zero_negative_hours", count: zeroHours.length, sample_ids: dedupeSortCap(zeroHours.map((e) => num2(e["id"])), v.limit) });
+  const outPeriod = entries.filter((e) => {
+    const t = num2(e["ticketID"]);
+    if (t <= 0) return false;
+    const ticket = fetchedTickets.get(t);
+    if (ticket === void 0) return false;
+    const dW = dateToDay(e["dateWorked"]);
+    if (dW === null) return false;
+    const created = dateToDay(ticket["createDate"]);
+    if (created !== null && dW < created) return true;
+    const ends = [dateToDay(ticket["resolvedDateTime"]), dateToDay(ticket["completedDate"])].filter((d) => d !== null);
+    if (ends.length > 0 && dW > Math.min(...ends)) return true;
+    return false;
+  });
+  warnings.push({ code: "time_outside_ticket_period", count: outPeriod.length, sample_ids: dedupeSortCap(outPeriod.map((e) => num2(e["id"])), v.limit) });
+  const missingRate = entries.filter((e) => entryResolution.get(num2(e["id"])).source === "missing");
+  warnings.push({ code: "missing_cost_rate", count: missingRate.length, sample_ids: dedupeSortCap(missingRate.map((e) => num2(e["id"])), v.limit) });
+  let driftCount = 0;
+  const driftIds = /* @__PURE__ */ new Set();
+  if (v.includeRecurringCosts) {
+    for (let i = 1; i < months.length; i++) {
+      const r1 = recurringIn(months[i]);
+      const r0 = recurringIn(months[i - 1]);
+      if (r1 <= 0 || r0 <= 0 || Math.abs(r1 - r0) <= RECURRING_DRIFT_EPSILON) continue;
+      driftCount += 1;
+      const mA = months[i - 1];
+      const mB = months[i];
+      for (const c of charges) {
+        const cA = inMonth(c["datePurchased"], mA) ? chargeCost(c) : 0;
+        const cB = inMonth(c["datePurchased"], mB) ? chargeCost(c) : 0;
+        if (Math.abs(cB - cA) > 0) driftIds.add(num2(c["id"]));
+      }
+      for (const u of unitRows) {
+        const cA = unitIn(u, mA) ? num2(u["cost"]) : 0;
+        const cB = unitIn(u, mB) ? num2(u["cost"]) : 0;
+        if (Math.abs(cB - cA) > 0) driftIds.add(num2(u["id"]));
+      }
+    }
+  }
+  warnings.push({ code: "recurring_cost_drift", count: driftCount, sample_ids: dedupeSortCap([...driftIds], v.limit) });
+  let expectedUnbilledCount = 0;
+  const expectedUnbilledSamples = [];
+  if (v.includeUnbilledRevenue && expectedBasis) {
+    for (const m of months) {
+      const { billed, ids } = billedServiceIn(m);
+      if (expectedIn(m) > billed + 5e-3) {
+        expectedUnbilledCount += 1;
+        for (const i of ids) expectedUnbilledSamples.push(i);
+      }
+    }
+  }
+  warnings.push({ code: "expected_unbilled_revenue", count: expectedUnbilledCount, sample_ids: dedupeSortCap(expectedUnbilledSamples, v.limit) });
+  const driftTickets = [...fetchedTickets.values()].filter((t) => num2(t["contractID"]) !== idNum);
+  const unresolvedRefs = entries.filter((e) => num2(e["ticketID"]) > 0 && !fetchedTickets.has(num2(e["ticketID"])));
+  warnings.push({
+    code: "cross_contract_tickets",
+    count: driftTickets.length + unresolvedRefs.length,
+    sample_ids: dedupeSortCap([...driftTickets.map((t) => num2(t["id"])), ...unresolvedRefs.map((e) => num2(e["id"]))], v.limit)
+  });
+  const stale = [];
+  if (openStatusSet !== null) {
+    for (const t of contractTickets) {
+      const status = t["status"];
+      if (typeof status !== "number" || !openStatusSet.has(status)) continue;
+      const lastDay = dateToDay(t["lastActivityDate"]);
+      if (lastDay === null) continue;
+      const days = asOfMs / 864e5 - lastDay;
+      if (days > v.staleAfterDays) stale.push(num2(t["id"]));
+    }
+  }
+  warnings.push({ code: "open_stale_tickets", count: stale.length, sample_ids: dedupeSortCap(stale, v.limit) });
+  let estimateCount = 0;
+  const estimateSample = [];
+  let estimateNote;
+  {
+    const actualRevenue = monthly.reduce((a, r) => a + r.revenue_invoiced, 0);
+    const actualCost = monthly.reduce((a, r) => a + r.total_cost, 0);
+    const termStart = dateToDay(contractRow["startDate"]);
+    const termEnd = dateToDay(contractRow["endDate"]);
+    const fromDay = dateToDay(v.dateFrom);
+    const toDay = dateToDay(v.dateTo);
+    if (termStart !== null && termEnd !== null && fromDay !== null && toDay !== null) {
+      const overlapStart = Math.max(termStart, fromDay);
+      const overlapEnd = Math.min(termEnd, toDay);
+      const termDays = termEnd - termStart + 1;
+      const overlapDays = overlapEnd >= overlapStart ? overlapEnd - overlapStart + 1 : 0;
+      if (termDays > 0 && overlapDays > 0) {
+        const frac = overlapDays / termDays;
+        const estRev = num2(contractRow["estimatedRevenue"]);
+        const estCost = num2(contractRow["estimatedCost"]);
+        const devRev = estRev > 0 ? Math.abs(actualRevenue - estRev * frac) / (estRev * frac) : null;
+        const devCost = estCost > 0 ? Math.abs(actualCost - estCost * frac) / (estCost * frac) : null;
+        if (devRev !== null && devRev > ESTIMATE_DEVIATION_THRESHOLD_PCT / 100 || devCost !== null && devCost > ESTIMATE_DEVIATION_THRESHOLD_PCT / 100) {
+          estimateCount = 1;
+          estimateSample.push(idNum);
+        }
+        estimateNote = `estimate vs actual (window-prorated ${overlapDays}/${termDays} days): revenue ${pctOrNa(devRev)} deviation (actual ${fmtNum(actualRevenue)} vs prorated ${fmtNum(estRev * frac)}), cost ${pctOrNa(devCost)} deviation (actual ${fmtNum(actualCost)} vs prorated ${fmtNum(estCost * frac)})`;
+      }
+    }
+  }
+  warnings.push({ code: "estimate_vs_actual", count: estimateCount, sample_ids: estimateSample, ...estimateCount === 1 && estimateNote !== void 0 ? { note: estimateNote } : {} });
+  const entriesByTicket = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    const t = num2(e["ticketID"]);
+    if (t <= 0) continue;
+    const arr = entriesByTicket.get(t) ?? [];
+    arr.push(e);
+    entriesByTicket.set(t, arr);
+  }
+  const expenseByTicket = /* @__PURE__ */ new Map();
+  for (const x of expenses) {
+    const t = num2(x["ticketID"]);
+    if (t <= 0) continue;
+    expenseByTicket.set(t, (expenseByTicket.get(t) ?? 0) + num2(x["internalCurrencyExpenseAmount"]));
+  }
+  const ticketCost = (t) => {
+    const tid = num2(t["id"]);
+    const es = entriesByTicket.get(tid) ?? [];
+    let cost = expenseByTicket.get(tid) ?? 0;
+    for (const e of es) cost += entryResolution.get(num2(e["id"])).cost ?? 0;
+    return cost;
+  };
+  const ticketHours = (t) => (entriesByTicket.get(num2(t["id"])) ?? []).reduce((a, e) => a + hoursOf(e), 0);
+  const allTickets = [...fetchedTickets.values()];
+  const activityCategories = [];
+  if (v.groupByActivity) {
+    const byCat = /* @__PURE__ */ new Map();
+    for (const t of allTickets) {
+      const cat = num2(t["ticketCategory"]) > 0 ? num2(t["ticketCategory"]) : null;
+      const arr = byCat.get(cat) ?? [];
+      arr.push(t);
+      byCat.set(cat, arr);
+    }
+    for (const [cat, tickets] of byCat) {
+      let entryCount = 0;
+      let hours = 0;
+      let cost = 0;
+      for (const t of tickets) {
+        const es = entriesByTicket.get(num2(t["id"])) ?? [];
+        entryCount += es.length;
+        hours += es.reduce((a, e) => a + hoursOf(e), 0);
+        cost += ticketCost(t);
+      }
+      activityCategories.push({
+        ticketCategory: cat,
+        ticketCount: tickets.length,
+        entryCount,
+        hours,
+        cost: cents(cost),
+        sample_ticketNumbers: dedupeSortCap(tickets.map((t) => num2(t["ticketNumber"])).filter((n) => n > 0), v.limit)
+      });
+    }
+    activityCategories.sort((a, b) => b.cost - a.cost || (a.ticketCategory === null ? 1 : b.ticketCategory === null ? -1 : (a.ticketCategory ?? 0) - (b.ticketCategory ?? 0)));
+  }
+  const highestCostTickets = allTickets.map((t) => ({
+    ticketId: num2(t["id"]),
+    ticketNumber: num2(t["ticketNumber"]) > 0 ? num2(t["ticketNumber"]) : null,
+    title: typeof t["title"] === "string" ? t["title"] : "",
+    status: typeof t["status"] === "number" ? t["status"] : null,
+    hours: ticketHours(t),
+    cost: cents(ticketCost(t)),
+    lastActivityDate: typeof t["lastActivityDate"] === "string" ? t["lastActivityDate"] : null
+  })).sort((a, b) => b.cost - a.cost || a.ticketId - b.ticketId).slice(0, v.limit);
+  const miscoding = /* @__PURE__ */ new Map();
+  const putMiscoding = (e, reason) => {
+    const eid = num2(e["id"]);
+    if (eid <= 0 || miscoding.has(eid)) return;
+    const c = num2(e["contractID"]);
+    miscoding.set(eid, { entryId: eid, reason, ticketId: num2(e["ticketID"]) > 0 ? num2(e["ticketID"]) : null, contractId: c > 0 ? c : null, hours: num2(e["hoursWorked"]) });
+  };
+  for (const p of probeRows) putMiscoding(p, num2(p["contractID"]) > 0 ? "ticket_of_other_contract" : "no_contract_on_entry");
+  for (const e of crossTimeEntries) putMiscoding(e, "ticket_of_other_contract");
+  for (const e of unresolvedRefs) putMiscoding(e, "ticket_not_in_fetched_set");
+  const possibleMiscoding = [...miscoding.values()].sort((a, b) => a.entryId - b.entryId).slice(0, v.limit);
+  const openRenewal = [];
+  if (openStatusSet !== null) {
+    for (const t of contractTickets) {
+      const status = t["status"];
+      if (typeof status !== "number" || !openStatusSet.has(status)) continue;
+      const last = t["lastActivityDate"];
+      const lastDay = typeof last === "string" ? (asOfMs - Date.parse(last.slice(0, 10))) / 864e5 : null;
+      const staleDays = lastDay !== null && lastDay > v.staleAfterDays ? Math.floor(lastDay) : null;
+      openRenewal.push({
+        kind: "ticket",
+        id: num2(t["id"]),
+        label: typeof t["title"] === "string" && t["title"] !== "" ? t["title"] : `ticket ${num2(t["ticketNumber"]) > 0 ? num2(t["ticketNumber"]) : num2(t["id"])}`,
+        date: typeof last === "string" ? last.slice(0, 10) : null,
+        detail: staleDays !== null ? `open \u2014 stale ${staleDays} days (last activity)` : "open"
+      });
+    }
+  }
+  for (const s of subscriptions) {
+    openRenewal.push({
+      kind: "subscription",
+      id: num2(s["id"]),
+      label: typeof s["subscriptionName"] === "string" && s["subscriptionName"] !== "" ? s["subscriptionName"] : `subscription ${num2(s["id"])}`,
+      date: typeof s["expirationDate"] === "string" ? s["expirationDate"].slice(0, 10) : null,
+      detail: `periodType: ${typeof s["periodType"] === "number" ? s["periodType"] : "unknown"} (period cost ${fmtNum(num2(s["periodCost"]))}${cancelledSubs.has(num2(s["id"])) ? " \u2014 not active, not in tooling_cost.vendor" : oneTimeSubs.has(num2(s["id"])) ? " \u2014 one-time, booked in its effective month" : subFactor.get(num2(s["id"])) == null ? " \u2014 unrecognised period, not in tooling_cost.vendor" : `, ${fmtNum(num2(s["periodCost"]) * subFactor.get(num2(s["id"])))}/month`})`
+    });
+  }
+  const contractEndDay = dateToDay(contractRow["endDate"]);
+  if (contractEndDay !== null) {
+    openRenewal.push({
+      kind: "contract_end",
+      id: idNum,
+      label: typeof contractRow["contractName"] === "string" && contractRow["contractName"] !== "" ? contractRow["contractName"] : `contract ${idNum}`,
+      date: String(contractRow["endDate"]).slice(0, 10),
+      detail: `the contract ends ${String(contractRow["endDate"]).slice(0, 10)}`
+    });
+  }
+  const blocks = blocksPart.items;
+  for (const b of blocks) {
+    const purchased = num2(b["hours"]);
+    const approved = num2(b["hoursApproved"]);
+    const left = purchased - approved;
+    openRenewal.push({
+      kind: "included_hours_burn",
+      id: num2(b["id"]),
+      label: `hour block ${num2(b["id"])}`,
+      date: typeof b["endDate"] === "string" ? b["endDate"].slice(0, 10) : null,
+      detail: `${fmtHours(approved)} h approved of ${fmtHours(purchased)} h purchased (${left >= 0 ? `${fmtHours(left)} h left` : `${fmtHours(Math.abs(left))} h over`})`
+    });
+  }
+  const purchasedHours = blocks.reduce((a, b) => a + num2(b["hours"]), 0);
+  const approvedHours = blocks.reduce((a, b) => a + num2(b["hoursApproved"]), 0);
+  const includedHours = !contractTypeKnown ? { value: null, absent: "CONTRACT_TYPE_UNKNOWN" } : !isBlockHours ? { value: null, absent: "NOT_BLOCK_HOURS_CONTRACT" } : blocksPart.status === "absent" ? { value: null, absent: blocksPart.absent } : { value: { purchased: purchasedHours, approved: approvedHours, remaining: purchasedHours - approvedHours } };
+  return {
+    contract,
+    customer,
+    ...customerAbsent !== void 0 ? { customerAbsent } : {},
+    contract_type: contractTypeKnown ? { id: contractType, label: contractTypeLabel } : { id: contractType > 0 ? contractType : null, label: null, absent: "CONTRACT_TYPE_UNKNOWN" },
+    included_hours: includedHours,
+    period: { dateFrom: v.dateFrom, dateTo: v.dateTo, months, asOf },
+    currency: {
+      companyCurrencyID: customer && typeof customer["currencyID"] === "number" ? customer["currencyID"] : null,
+      note: "single-currency P&L in the INTERNAL currency: revenue is billing items internalCurrencyExtendedPrice and service units internalCurrencyPrice (each falling back to the local field when absent), unposted value the internalCurrencyContractHourlyRate; costs are internal (ourCost/role cost/internalCost, charge extendedCost, unit cost, internalCurrencyExpenseAmount). companyCurrencyID is the customer context stamp only"
+    },
+    monthly,
+    activity_categories: activityCategories,
+    highest_cost_tickets: highestCostTickets,
+    possible_miscoding: possibleMiscoding,
+    open_renewal_items: openRenewal,
+    data_quality_warnings: warnings,
+    costRateResolution,
+    parts: {
+      contract: "ok",
+      customer: customerStatus,
+      contractServices: servicesPart.status,
+      contractServiceUnits: unitsPart.status,
+      contractCharges: chargesPart.status,
+      contractRoleCosts: roleCostsPart.status,
+      contractRates: ratesPart.status,
+      contractBlocks: blocksPart.status,
+      billingItems: billingItems.status,
+      invoices: invoicesPart.status,
+      timeEntries: timeEntries.status,
+      ticketsActivity: ticketsActivityPart.status,
+      ticketsOpen: ticketsOpenPart.status,
+      resources: resourcesPart.status,
+      expenses: expensesPart.status,
+      miscodingProbe: probePart.status,
+      configurationItems: configurationItemsPart.status,
+      subscriptions: subscriptionsPart.status
+    },
+    contractServices: servicesPart,
+    contractServiceUnits: unitsPart,
+    contractCharges: chargesPart,
+    contractRoleCosts: roleCostsPart,
+    contractRates: ratesPart,
+    contractBlocks: blocksPart,
+    billingItems,
+    invoices: invoicesPart,
+    timeEntries,
+    ticketsActivity: ticketsActivityPart,
+    ticketsOpen: ticketsOpenPart,
+    resources: resourcesPart,
+    expenses: expensesPart,
+    miscodingProbe: probePart,
+    configurationItems: configurationItemsPart,
+    subscriptions: subscriptionsPart,
+    wires: { issued: wires.issued, requests: wires.requests, budget: wires.budget, note: wires.note }
+  };
+}
+
 // src/resources/contracts.ts
 var ContractsResource = class extends BaseResource {
   constructor(http, pageSize) {
@@ -4599,6 +5848,10 @@ var ContractsResource = class extends BaseResource {
   async search(query, opts) {
     return this.searchBase(query, opts);
   }
+  /** Node-parity special op (hand-written in src/resources/special/contracts.ts). */
+  profitability(id, opts) {
+    return profitability(this, id, opts, this.http);
+  }
 };
 
 // src/resources/contract_ticket_purchases.ts
@@ -9083,11 +10336,11 @@ async function slaHealthCheck(_resource, id, opts = {}, http) {
   );
   const slas = rows.map((row) => {
     const bool = (v) => typeof v === "boolean" ? v : null;
-    const num2 = (v) => typeof v === "number" ? v : null;
+    const num3 = (v) => typeof v === "number" ? v : null;
     const milestones = [
-      { name: "firstResponse", met: bool(row.isFirstResponseMet), elapsedHours: num2(row.firstResponseElapsedHours) },
-      { name: "resolution", met: bool(row.isResolutionMet), elapsedHours: num2(row.resolutionElapsedHours) },
-      { name: "resolutionPlan", met: bool(row.isResolutionPlanMet), elapsedHours: num2(row.resolutionPlanElapsedHours) }
+      { name: "firstResponse", met: bool(row.isFirstResponseMet), elapsedHours: num3(row.firstResponseElapsedHours) },
+      { name: "resolution", met: bool(row.isResolutionMet), elapsedHours: num3(row.resolutionElapsedHours) },
+      { name: "resolutionPlan", met: bool(row.isResolutionPlanMet), elapsedHours: num3(row.resolutionPlanElapsedHours) }
     ];
     return { id: Number(row.id), name: row.serviceLevelAgreementName ?? null, milestones };
   });