node-autotask 0.28.0 → 0.30.0

package/dist/{chunk-IRVZGW5K.js → chunk-QQPCJT2L.js}

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-6EQSXYRW.js";
+} from "./chunk-TZC4ZAA6.js";
 
 // src/auth.ts
 var AUTH_HEADERS = {
@@ -17390,8 +17390,18 @@ function createNamePlan(labelFields = []) {
   const resSeen = /* @__PURE__ */ new Set();
   const recordFks = [];
   const fkSeen = /* @__PURE__ */ new Set();
+  let lineOfBusinessId;
+  let lineOfBusinessSource;
+  let lineOfBusinessContractId;
   return {
-    plan: () => ({ resourceIds, recordFks, labelFields }),
+    plan: () => ({
+      resourceIds,
+      recordFks,
+      labelFields,
+      ...lineOfBusinessId !== void 0 ? { lineOfBusinessId } : {},
+      ...lineOfBusinessSource !== void 0 ? { lineOfBusinessSource } : {},
+      ...lineOfBusinessContractId !== void 0 ? { lineOfBusinessContractId } : {}
+    }),
     addResource: (value) => {
       if (!isVendorId(value)) return;
       const k = String(value);
@@ -17407,6 +17417,18 @@ function createNamePlan(labelFields = []) {
         fkSeen.add(k);
         recordFks.push({ table, id: value });
       }
+    },
+    addLineOfBusinessFromContract: (value) => {
+      if (!isVendorId(value)) return;
+      lineOfBusinessContractId = value;
+    },
+    addLineOfBusiness: (value, origin) => {
+      if (!isVendorId(value)) return;
+      lineOfBusinessId = value;
+      if (origin !== void 0) {
+        lineOfBusinessSource = origin.source;
+        if (origin.contractId !== void 0) lineOfBusinessContractId = origin.contractId;
+      }
     }
   };
 }
@@ -17438,6 +17460,82 @@ function faultRow(err) {
   const e = err;
   return e.httpStatus !== void 0 ? { code: e.code, message: e.message, httpStatus: e.httpStatus } : { code: e.code, message: e.message };
 }
+function vendorId(value) {
+  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 1 ? value : void 0;
+  if (typeof value === "string" && /^[0-9]+$/.test(value.trim())) {
+    const n = Number(value.trim());
+    return Number.isSafeInteger(n) && n >= 1 ? n : void 0;
+  }
+  return void 0;
+}
+async function resolveLineOfBusinessChain(http, associationId, options) {
+  const operation = options.operation ?? "compositeNames";
+  const degrade = options.onError === "degrade";
+  const get = (path) => {
+    const res = http.request({ method: "GET", path, operation }).then((body) => {
+      const b = body;
+      if (b === null || !("item" in b) || b.item === null || b.item === void 0) return null;
+      return b.item;
+    });
+    if (!degrade) {
+      return res.catch((e) => {
+        if (e instanceof NotFoundError) return null;
+        throw e;
+      });
+    }
+    return res.catch((e) => {
+      if (e instanceof NotFoundError || isAutotaskError(e) && e.code !== "ABORTED") return null;
+      throw e;
+    });
+  };
+  let remaining = options.budget;
+  if (remaining < 1) {
+    return {
+      lineOfBusiness: { association: null, organizationalLevel2: null, organizationalLevel1: null, markers: { association: "capped", organizationalLevel2: "capped", organizationalLevel1: "capped" } },
+      used: 0,
+      truncated: true
+    };
+  }
+  remaining -= 1;
+  const association = await get(`/V1.0/OrganizationalLevelAssociations/${associationId}`);
+  const associationMarker = association === null ? "unresolved" : "ok";
+  if (association === null) {
+    return {
+      lineOfBusiness: { association: null, organizationalLevel2: null, organizationalLevel1: null, markers: { association: associationMarker, organizationalLevel2: "missing", organizationalLevel1: "missing" } },
+      used: 1,
+      truncated: false
+    };
+  }
+  const l2Id = vendorId(association.organizationalLevel2ID);
+  const l1Id = vendorId(association.organizationalLevel1ID);
+  let l2Marker = l2Id !== void 0 ? "unresolved" : "missing";
+  let l1Marker = l1Id !== void 0 ? "unresolved" : "missing";
+  const need = (l2Id !== void 0 ? 1 : 0) + (l1Id !== void 0 ? 1 : 0);
+  let l2 = null;
+  let l1 = null;
+  let used = 1;
+  let truncated = false;
+  if (need > 0 && remaining < need) {
+    truncated = true;
+    if (l2Id !== void 0) l2Marker = "capped";
+    if (l1Id !== void 0) l1Marker = "capped";
+  } else {
+    used += need;
+    const [r2, r1] = await Promise.all([
+      l2Id !== void 0 ? get(`/V1.0/OrganizationalLevel2s/${l2Id}`) : Promise.resolve(null),
+      l1Id !== void 0 ? get(`/V1.0/OrganizationalLevel1s/${l1Id}`) : Promise.resolve(null)
+    ]);
+    l2 = r2;
+    l1 = r1;
+    if (l2Id !== void 0) l2Marker = l2 === null ? "unresolved" : "ok";
+    if (l1Id !== void 0) l1Marker = l1 === null ? "unresolved" : "ok";
+  }
+  return {
+    lineOfBusiness: { association, organizationalLevel2: l2, organizationalLevel1: l1, markers: { association: associationMarker, organizationalLevel2: l2Marker, organizationalLevel1: l1Marker } },
+    used,
+    truncated
+  };
+}
 async function resolveCompositeNames(http, plan, opts = {}) {
   if (opts.maxNameReads !== void 0 && (!Number.isInteger(opts.maxNameReads) || opts.maxNameReads < 1)) {
     throw new AutotaskConfigError(`composite names: maxNameReads must be an integer >= 1 (got ${String(opts.maxNameReads)})`);
@@ -17451,6 +17549,8 @@ async function resolveCompositeNames(http, plan, opts = {}) {
   const nameCache = http.resourceNameCache;
   const section = { truncated: false, rows: {}, reasons: {} };
   let remaining = budget;
+  let contractLobPointer;
+  let contractLobUnread;
   const coldResource = [];
   for (const id of plan.resourceIds) {
     if (nameCache !== void 0 && nameCache.get(id) !== void 0) continue;
@@ -17494,18 +17594,27 @@ async function resolveCompositeNames(http, plan, opts = {}) {
       if (remaining < 1) {
         section.rows[key] = { name: null, blind: false, capped: true };
         section.truncated = true;
+        if (fk.table === "contract" && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
+          contractLobUnread = "capped";
+        }
         continue;
       }
       remaining -= 1;
     }
     try {
       const record = await holders[fk.table].get(fk.id);
+      if (fk.table === "contract" && plan.lineOfBusinessId === void 0 && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
+        contractLobPointer = vendorId(record["organizationalLevelAssociationID"]);
+      }
       section.rows[key] = { name: fkName(record, fk.table), blind: false, capped: false };
     } catch (err) {
       if (err instanceof NotFoundError) {
         section.rows[key] = { name: null, blind: true, capped: false };
       } else if (isAutotaskError(err) && err.code !== "ABORTED") {
         section.rows[key] = { name: null, blind: false, capped: false, error: faultRow(err) };
+        if (fk.table === "contract" && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
+          contractLobUnread = "unresolved";
+        }
       } else {
         throw err;
       }
@@ -17531,8 +17640,31 @@ async function resolveCompositeNames(http, plan, opts = {}) {
     }
     if (!usable) for (const f of plan.labelFields) section.reasons[f] = FIELD_CATALOG_HONESTY_NOTE;
   }
+  let lineOfBusiness = null;
+  const lobId = plan.lineOfBusinessId ?? contractLobPointer;
+  if (lobId !== void 0) {
+    const chain = await resolveLineOfBusinessChain(http, lobId, { budget: remaining, onError: "degrade" });
+    remaining -= chain.used;
+    if (chain.truncated) section.truncated = true;
+    const fromContract = plan.lineOfBusinessId === void 0;
+    lineOfBusiness = {
+      ...chain.lineOfBusiness,
+      ...fromContract ? { source: "contract", contractId: plan.lineOfBusinessContractId } : plan.lineOfBusinessSource !== void 0 ? { source: plan.lineOfBusinessSource } : {},
+      ...!fromContract && plan.lineOfBusinessContractId !== void 0 ? { contractId: plan.lineOfBusinessContractId } : {}
+    };
+  } else if (contractLobUnread !== void 0 && plan.lineOfBusinessContractId !== void 0) {
+    lineOfBusiness = {
+      source: "contract",
+      contractId: plan.lineOfBusinessContractId,
+      association: null,
+      organizationalLevel2: null,
+      organizationalLevel1: null,
+      markers: { association: contractLobUnread, organizationalLevel2: "missing", organizationalLevel1: "missing" }
+    };
+  }
   return {
     section,
+    lineOfBusiness,
     resourceName: (id) => section.rows[`resource:${id}`]?.name ?? null,
     recordName: (table, id) => section.rows[`${table}:${id}`]?.name ?? null,
     labelFor: (field, value) => {
@@ -20297,6 +20429,8 @@ export {
   createNamePlan,
   addNameSibling,
   addLabelSibling,
+  vendorId,
+  resolveLineOfBusinessChain,
   resolveCompositeNames,
   FETCH_MANY_MAX_ITEMS,
   validateFetchManyItems,