node-autotask 0.28.0 → 0.29.0

package/dist/{chunk-SYX6EWMT.js → chunk-T4SZGOJB.js}

@@ -34,14 +34,16 @@ import {
   parseVendorErrors,
   resolveCompositeNames,
   resolveFieldsPreset,
+  resolveLineOfBusinessChain,
   truncateNoteChars,
   unwrapItem,
   unwrapItems,
-  unwrapOperation
-} from "./chunk-IRVZGW5K.js";
+  unwrapOperation,
+  vendorId
+} from "./chunk-KVT5V7SA.js";
 import {
   CAPABILITIES
-} from "./chunk-6EQSXYRW.js";
+} from "./chunk-WKP442HS.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -5299,7 +5301,7 @@ function appendWiresNote(wires, note) {
   wires.note = (wires.note ? wires.note + " | " : "") + note;
 }
 function makeFetchCtx(rawHttp, v, contractId, budget) {
-  const OP9 = PROFITABILITY_OP;
+  const OP10 = PROFITABILITY_OP;
   const id = parseIdentifier(contractId, "contractId");
   const idNum = typeof id === "number" ? id : Number(id);
   const wires = { issued: 0, requests: 0, budget };
@@ -5311,19 +5313,19 @@ function makeFetchCtx(rawHttp, v, contractId, budget) {
   } };
   const readPart = (path, conditions, fields) => {
     wires.issued += 1;
-    return degradable(() => boundedPart(http, path, conditions, v.limit, OP9, fields));
+    return degradable(() => boundedPart(http, path, conditions, v.limit, OP10, fields));
   };
   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, OP9, fields, dateField, v.dateFrom, v.dateTo, wires));
+    const wp = await degradable(() => expandByMonth(http, path, cond, v.limit, OP10, 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 };
   };
-  return { v, OP: OP9, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
+  return { v, OP: OP10, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
 }
 
 // src/resources/special/contracts/profitability.stages.ts
@@ -12061,6 +12063,7 @@ async function addCompositeNames(http, ctx, entriesPart, result, opts) {
   builder.addFk("contract", t["contractID"]);
   builder.addFk("billingCode", t["billingCodeID"]);
   builder.addFk("role", t["assignedResourceRoleID"]);
+  builder.addLineOfBusiness(t["organizationalLevelAssociationID"]);
   for (const e of entriesPart.items) {
     builder.addResource(e["resourceID"]);
     builder.addFk("role", e["roleID"]);
@@ -12084,6 +12087,12 @@ async function addCompositeNames(http, ctx, entriesPart, result, opts) {
     return row;
   });
   result.names = names.section;
+  result.lineOfBusiness = names.lineOfBusiness ?? {
+    association: null,
+    organizationalLevel2: null,
+    organizationalLevel1: null,
+    markers: { association: "missing", organizationalLevel2: "missing", organizationalLevel1: "missing" }
+  };
   result.truncated = result.truncated || names.section.truncated;
 }
 async function fullContext(resource, id, opts = {}, http) {
@@ -12257,6 +12266,38 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
   };
 }
 
+// src/resources/special/tickets/lineOfBusiness.ts
+var OP5 = "tickets.lineOfBusiness";
+function positiveId2(value, name) {
+  const n = typeof value === "string" && /^[0-9]+$/.test(value.trim()) ? Number(value) : value;
+  if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 1) {
+    throw new AutotaskConfigError(OP5 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP5 });
+  }
+  return n;
+}
+async function lineOfBusiness(resource, ticketIdIn, http, associationIdIn) {
+  const ticketId = positiveId2(ticketIdIn, "ticketId");
+  let associationId;
+  if (associationIdIn !== void 0) {
+    associationId = positiveId2(associationIdIn, "associationId");
+  } else {
+    const ticket = await resource.get(ticketId);
+    associationId = vendorId(ticket.organizationalLevelAssociationID);
+  }
+  if (associationId === void 0) {
+    return {
+      ticketId,
+      association: null,
+      organizationalLevel2: null,
+      organizationalLevel1: null,
+      markers: { association: "missing", organizationalLevel2: "missing", organizationalLevel1: "missing" }
+    };
+  }
+  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP5, onError: "propagate" });
+  const { association, organizationalLevel2, organizationalLevel1, markers } = chain.lineOfBusiness;
+  return { ticketId, association, organizationalLevel2, organizationalLevel1, markers };
+}
+
 // src/resources/special/tickets/statusSemantics.ts
 async function statusSemantics(_resource, opts = {}, http) {
   return resolveTicketStatusSemantics(http, opts);
@@ -12375,6 +12416,10 @@ var TicketsResource = class extends BaseResource {
   forResource(resourceID, opts) {
     return forResource(this, resourceID, this.http, opts);
   }
+  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
+  lineOfBusiness(ticketId, associationId) {
+    return lineOfBusiness(this, ticketId, this.http, associationId);
+  }
 };
 
 // src/resources/ticket_webhooks.ts
@@ -12503,12 +12548,12 @@ async function postedDateStatusQuery(_resource, mode, http, opts) {
   return items;
 }
 async function postedWithin(_resource, from, to, http, opts, opLabel = "time_entries.postedWithin") {
-  const OP9 = opLabel;
-  if (opts?.tz !== void 0) validateZone(opts.tz, OP9);
-  const fromB = customRangeDay(from, "from", void 0, OP9);
-  const toB = customRangeDay(to, "to", void 0, OP9);
+  const OP10 = opLabel;
+  if (opts?.tz !== void 0) validateZone(opts.tz, OP10);
+  const fromB = customRangeDay(from, "from", void 0, OP10);
+  const toB = customRangeDay(to, "to", void 0, OP10);
   if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP9}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP9 });
+    throw new AutotaskConfigError(`${OP10}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP10 });
   }
   const windowToMs = toB.ms + DAY_MS2 - 1;
   const filter = [
@@ -12519,7 +12564,7 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
   else if (opts?.posted === false) filter.push({ field: "postedDate", op: "notExist" });
   if (opts?.ticketID !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
   if (opts?.resourceID !== void 0) filter.push({ field: "resourceID", op: "eq", value: opts.resourceID });
-  const { items, hasMore } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP9, http);
+  const { items, hasMore } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP10, http);
   let postedCount = 0;
   for (const item of items) {
     const postedDate = item.postedDate;
@@ -12729,7 +12774,7 @@ async function resolveCode(http, family, familyLabel2, pinnedId, departments, op
 }
 
 // src/resources/special/time_entries/createForResource.ts
-var OP5 = "time_entries.createForResource";
+var OP6 = "time_entries.createForResource";
 var PARAM_KEYS = /* @__PURE__ */ new Set([
   "internallAllocationCodeID",
   "ticketID",
@@ -12765,30 +12810,30 @@ function validateCreateParams(params) {
   if (pinCount > 1) {
     throw new AutotaskConfigError(
       "createForResource: exactly one linkage pin is honoured (internallAllocationCodeID | ticketID | taskID) \u2014 the vendor gate requires exactly one; pass one pin (or none for the default internal linkage)",
-      { operation: OP5 }
+      { operation: OP6 }
     );
   }
   if (pins.role !== void 0 && pins.code !== void 0) {
     throw new AutotaskConfigError(
       "createForResource: a pinned roleID is only meaningful with the task/ticket linkage (internallAllocationCodeID pins the internal linkage and owns the code) \u2014 drop one",
-      { operation: OP5 }
+      { operation: OP6 }
     );
   }
   if (params.hoursWorked !== void 0 && (typeof params.hoursWorked !== "number" || !Number.isFinite(params.hoursWorked) || params.hoursWorked <= 0)) {
     throw new AutotaskConfigError(
       `createForResource: hoursWorked must be a positive finite number (got ${String(params.hoursWorked)})`,
-      { operation: OP5 }
+      { operation: OP6 }
     );
   }
   return pins;
 }
 async function assertResourceActive(http, rid) {
-  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP5);
+  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP6);
   if (rec === null) {
     throw new ResourceInvalidError(`Resource ${rid} was not found \u2014 a time entry cannot attach to a missing resource`, {
       resourceIds: [rid],
       details: { idRefs: [{ entity: "resource", id: rid }] },
-      operation: OP5,
+      operation: OP6,
       category: "not_found",
       suggestedAction: "Resolve the resource id (resources.get / resources.search) and retry."
     });
@@ -12797,7 +12842,7 @@ async function assertResourceActive(http, rid) {
     throw new ResourceInvalidError(`Resource ${rid} is not active (isActive !== true) \u2014 the vendor would reject a time entry for an inactive resource`, {
       resourceIds: [rid],
       details: { idRefs: [{ entity: "resource", id: rid }] },
-      operation: OP5,
+      operation: OP6,
       suggestedAction: "Activate the resource or pick an active one."
     });
   }
@@ -12807,11 +12852,11 @@ async function resolveAllocationCode(http, rid, linkage, pins, departments) {
   const pinnedForCode = pins.code !== void 0 ? pins.code : pins.role;
   let code = null;
   const familiesTried = [];
-  code = await resolveCode(http, familyOf(linkage), familyLabel(familyOf(linkage)), pinnedForCode, departments, OP5);
+  code = await resolveCode(http, familyOf(linkage), familyLabel(familyOf(linkage)), pinnedForCode, departments, OP6);
   familiesTried.push({ family: familyOf(linkage), label: familyLabel(familyOf(linkage)), filters: [{ field: "useType", op: "eq", value: familyOf(linkage) }, { field: "isActive", op: "eq", value: true }] });
   if (code === null && linkage === "task" && pins.role === void 0) {
     usedLinkage = "internal";
-    code = await resolveCode(http, USE_TYPE_INTERNAL, familyLabel(USE_TYPE_INTERNAL), void 0, departments, OP5);
+    code = await resolveCode(http, USE_TYPE_INTERNAL, familyLabel(USE_TYPE_INTERNAL), void 0, departments, OP6);
     familiesTried.push({ family: USE_TYPE_INTERNAL, label: familyLabel(USE_TYPE_INTERNAL), filters: [{ field: "useType", op: "eq", value: USE_TYPE_INTERNAL }, { field: "isActive", op: "eq", value: true }] });
   }
   if (code === null) {
@@ -12821,7 +12866,7 @@ async function resolveAllocationCode(http, rid, linkage, pins, departments) {
         families: familiesTried,
         resourceDepartments: [...departments].sort((a, b) => a - b)
       },
-      { operation: OP5 }
+      { operation: OP6 }
     );
   }
   const resolvedCode = codeInfo(code);
@@ -12860,7 +12905,7 @@ function createDryRun2(http, rid, body, linkage, usedLinkage, resolvedCode) {
   }
   return buildDryRunResult(
     {
-      operation: OP5,
+      operation: OP6,
       method: "POST",
       path: "/V1.0/TimeEntries",
       ids: [rid],
@@ -12902,7 +12947,7 @@ async function createWithAttempts(resource, http, opts, body, defaults, pins, us
       const gate3 = ROLE_REJECTION_PATTERN.test(text);
       if (usedLinkage !== "internal" && gate3) {
         if (!taskRoleFetched && usedLinkage === "task" && pins.task !== void 0) {
-          const task = await fetchItem2(http, `/V1.0/Tasks/${pins.task}`, OP5);
+          const task = await fetchItem2(http, `/V1.0/Tasks/${pins.task}`, OP6);
           taskRoleFetched = true;
           if (task !== null) pushLadder(task.assignedResourceRoleID);
         }
@@ -12928,7 +12973,7 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
   const pins = validateCreateParams(params);
   await assertResourceActive(http, rid);
   const linkage = pins.code !== void 0 ? "internal" : pins.ticket !== void 0 ? "ticket" : pins.task !== void 0 ? "task" : "internal";
-  const roleRows = await resourceRoleRows(http, rid, OP5);
+  const roleRows = await resourceRoleRows(http, rid, OP6);
   const departments = roleRows.departments;
   const { usedLinkage, resolvedCode } = await resolveAllocationCode(http, rid, linkage, pins, departments);
   const defaults = windowDefaults(params);
@@ -12951,12 +12996,12 @@ function discoveryField(err, body, defaults) {
 }
 
 // src/resources/special/time_entries/move.ts
-var OP6 = "time_entries.moveToTicket";
+var OP7 = "time_entries.moveToTicket";
 var COPY2 = ["resourceID", "roleID", "billingCodeID", "dateWorked", "startDateTime", "endDateTime", "hoursWorked", "offsetHours", "summaryNotes", "internalNotes", "isNonBillable", "showOnInvoice"];
 var CONTRACT_SCOPED2 = ["contractID", "contractServiceID", "contractServiceBundleID"];
 async function readTimeEntry(http, id, retries) {
   try {
-    const res = await http.request({ method: "GET", path: `/V1.0/TimeEntries/${id}`, operation: OP6, maxRetries: retries });
+    const res = await http.request({ method: "GET", path: `/V1.0/TimeEntries/${id}`, operation: OP7, maxRetries: retries });
     return res?.item ?? null;
   } catch (e) {
     if (isAutotaskError(e) && (e.httpStatus === 404 || e.code === "NOT_FOUND")) return null;
@@ -12966,27 +13011,27 @@ async function readTimeEntry(http, id, retries) {
 async function checkSource2({ http, source, sourceId, toTicketId, retries }) {
   const ids2 = { sourceId, toTicketId };
   if (source.taskID !== null && source.taskID !== void 0) {
-    throw refuse("MOVE_SOURCE_UNSUPPORTED", `${OP6}: time entry ${sourceId} is on a task \u2014 only ticket time entries are moved`, ids2, OP6);
+    throw refuse("MOVE_SOURCE_UNSUPPORTED", `${OP7}: time entry ${sourceId} is on a task \u2014 only ticket time entries are moved`, ids2, OP7);
   }
   if (source.billingApprovalDateTime || source.billingApprovalResourceID || source.billingApprovalLevelMostRecent) {
-    throw refuse("MOVE_BLOCKED_APPROVED", `${OP6}: time entry ${sourceId} has billing approval set \u2014 move it in the Autotask UI`, ids2, OP6, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "approved entries are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_APPROVED", `${OP7}: time entry ${sourceId} has billing approval set \u2014 move it in the Autotask UI`, ids2, OP7, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "approved entries are not moved by the API" } });
   }
   let billing;
   try {
-    billing = await queryRows(http, "BillingItems", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP6, retries);
+    billing = await queryRows(http, "BillingItems", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP7, retries);
   } catch {
-    throw refuse("MOVE_BLOCKED_BILLED", `${OP6}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP6, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billing state unreadable" } });
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP7}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP7, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billing state unreadable" } });
   }
   if (billing.some((b) => b.invoiceID || b.postedDate)) {
-    throw refuse("MOVE_BLOCKED_BILLED", `${OP6}: time entry ${sourceId} is billed or posted \u2014 move it in the Autotask UI`, ids2, OP6, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billed entries are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP7}: time entry ${sourceId} is billed or posted \u2014 move it in the Autotask UI`, ids2, OP7, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billed entries are not moved by the API" } });
   }
-  const attachments = await queryRows(http, "TimeEntryAttachments", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP6, retries);
+  const attachments = await queryRows(http, "TimeEntryAttachments", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP7, retries);
   if (attachments.length > 0) {
-    throw refuse("MOVE_BLOCKED_ATTACHMENTS", `${OP6}: time entry ${sourceId} has attachments, which a delete would destroy \u2014 move it in the Autotask UI`, ids2, OP6, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "entries with attachments are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_ATTACHMENTS", `${OP7}: time entry ${sourceId} has attachments, which a delete would destroy \u2014 move it in the Autotask UI`, ids2, OP7, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "entries with attachments are not moved by the API" } });
   }
 }
 var SPEC2 = {
-  operation: OP6,
+  operation: OP7,
   entity: "time_entry",
   readSource: readTimeEntry,
   sourceTicketId: (s) => typeof s.ticketID === "number" ? s.ticketID : null,
@@ -13021,7 +13066,7 @@ function moveToTicket2(_resource, sourceId, toTicketId, opts, http) {
 }
 
 // src/resources/special/time_entries/approve.ts
-var OP7 = "time_entries.approve";
+var OP8 = "time_entries.approve";
 var APPROVAL_LEVELS_PATH = "/V1.0/BillingItemApprovalLevels";
 function toIso(value) {
   if (value instanceof Date) {
@@ -13059,7 +13104,7 @@ async function approve(resource, id, opts = {}, http) {
   if (opts.dryRun === true) {
     return buildDryRunResult(
       {
-        operation: OP7,
+        operation: OP8,
         method: "POST",
         path: APPROVAL_LEVELS_PATH,
         ids: [numericId],
@@ -13082,10 +13127,10 @@ async function approve(resource, id, opts = {}, http) {
     method: "POST",
     path: APPROVAL_LEVELS_PATH,
     body,
-    operation: OP7,
+    operation: OP8,
     maxRetries: opts.maxRetries
   });
-  const levelId = toNumber(parseIdentifier(unwrapOperation(created, OP7).id, "billingItemApprovalLevelID"));
+  const levelId = toNumber(parseIdentifier(unwrapOperation(created, OP8).id, "billingItemApprovalLevelID"));
   await resource.update(
     numericId,
     { billingApprovalDateTime: approvalDateTime, billingApprovalResourceID: approvalResourceID },
@@ -13108,28 +13153,28 @@ async function approve(resource, id, opts = {}, http) {
 }
 
 // src/resources/special/time_entries/recentTickets.ts
-var OP8 = "time_entries.recentTickets";
+var OP9 = "time_entries.recentTickets";
 var DAY_MS3 = 864e5;
 var TICKET_CHUNK2 = 100;
 var TICKET_FIELDS3 = ["id", "ticketNumber", "title", "status", "assignedResourceID", "companyID"];
-function positiveId2(value, name) {
+function positiveId3(value, name) {
   const n = typeof value === "string" && /^\d+$/.test(value.trim()) ? Number(value) : value;
   if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 1) {
-    throw new AutotaskConfigError(`${OP8}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP8 });
+    throw new AutotaskConfigError(`${OP9}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP9 });
   }
   return n;
 }
 async function recentTickets(_resource, from, to, http, opts) {
   if (opts === void 0 || opts === null || typeof opts !== "object") {
-    throw new AutotaskConfigError(`${OP8}: opts { resourceID, companyID?, tz?, limit? } is required`, { operation: OP8 });
+    throw new AutotaskConfigError(`${OP9}: opts { resourceID, companyID?, tz?, limit? } is required`, { operation: OP9 });
   }
-  const resourceID = positiveId2(opts.resourceID, "resourceID");
-  const companyID = opts.companyID === void 0 ? void 0 : positiveId2(opts.companyID, "companyID");
-  if (opts.tz !== void 0) validateZone(opts.tz, OP8);
-  const fromB = customRangeDay(from, "from", void 0, OP8);
-  const toB = customRangeDay(to, "to", void 0, OP8);
+  const resourceID = positiveId3(opts.resourceID, "resourceID");
+  const companyID = opts.companyID === void 0 ? void 0 : positiveId3(opts.companyID, "companyID");
+  if (opts.tz !== void 0) validateZone(opts.tz, OP9);
+  const fromB = customRangeDay(from, "from", void 0, OP9);
+  const toB = customRangeDay(to, "to", void 0, OP9);
   if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP8}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`, { operation: OP8 });
+    throw new AutotaskConfigError(`${OP9}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`, { operation: OP9 });
   }
   const windowToMs = toB.ms + DAY_MS3 - 1;
   const { items: entries, hasMore } = await queryTimeEntries(
@@ -13140,7 +13185,7 @@ async function recentTickets(_resource, from, to, http, opts) {
       { field: "resourceID", op: "eq", value: resourceID }
     ],
     clampWindowLimit(opts.limit),
-    OP8,
+    OP9,
     http
   );
   const groups = /* @__PURE__ */ new Map();
@@ -13166,9 +13211,9 @@ async function recentTickets(_resource, from, to, http, opts) {
       idempotent: true,
       path: "/V1.0/Tickets/query",
       body: { MaxRecords: TICKET_CHUNK2, filter, IncludeFields: TICKET_FIELDS3 },
-      operation: OP8
+      operation: OP9
     });
-    for (const t of unwrapItems(res, OP8).items) if (typeof t.id === "number") tickets.set(t.id, t);
+    for (const t of unwrapItems(res, OP9).items) if (typeof t.id === "number") tickets.set(t.id, t);
   }
   const items = [];
   const unresolvedTicketIDs = [];