node-autotask 0.32.0 → 0.33.0

package/dist/{chunk-FVHPN7ZR.js → chunk-5DS6F6GF.js}

@@ -25,6 +25,7 @@ import {
   createNamePlan,
   cursorToPath,
   decodeFileData,
+  effectiveRequiredFields,
   formatUnknownNameList,
   formatVendorDetail,
   isAutotaskError,
@@ -40,10 +41,10 @@ import {
   unwrapItems,
   unwrapOperation,
   vendorId
-} from "./chunk-R6HLJCI2.js";
+} from "./chunk-MFDQHFGJ.js";
 import {
   CAPABILITIES
-} from "./chunk-M2EGFPGF.js";
+} from "./chunk-VKE56TTN.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -273,11 +274,11 @@ function tzOffsetMs(tz, ms) {
 }
 function localDayStartMs(y, m, d, tz) {
   if (tz === void 0) return Date.UTC(y, m - 1, d);
-  const candidate = Date.UTC(y, m - 1, d);
-  const offset = tzOffsetMs(tz, candidate);
-  let start = candidate - offset;
+  const candidate2 = Date.UTC(y, m - 1, d);
+  const offset = tzOffsetMs(tz, candidate2);
+  let start = candidate2 - offset;
   if (tzOffsetMs(tz, start) !== offset) {
-    start = candidate - tzOffsetMs(tz, start);
+    start = candidate2 - tzOffsetMs(tz, start);
   }
   const p = wallParts(tz, start);
   if (p.d !== d) start += 864e5 - ((p.h * 60 + p.mi) * 60 + p.s) * 1e3;
@@ -1561,6 +1562,151 @@ async function fullProfile(resource, id, opts = {}, http) {
   return result;
 }
 
+// src/resources/special/companies/prepareCrmWrite.ts
+var FREEMAIL = /* @__PURE__ */ new Set(["gmail.com", "googlemail.com", "outlook.com", "hotmail.com", "live.com", "yahoo.com", "yahoo.com.au", "icloud.com", "bigpond.com", "optusnet.com.au", "me.com", "proton.me", "protonmail.com"]);
+var LIMIT = 10;
+var OP2 = "companies.prepareCrmWrite";
+async function readRows(http, path, filter) {
+  const res = await http.request({ method: "POST", idempotent: true, path, body: { MaxRecords: LIMIT * 5, filter }, operation: OP2 });
+  return unwrapItems(res).items;
+}
+var str = (v) => typeof v === "string" && v !== "" ? v : null;
+var bool = (v) => typeof v === "boolean" ? v : null;
+var norm = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, " ").replace(/\b(pty|ltd|limited|inc|llc)\b/g, "").replace(/\s+/g, " ").trim();
+function domainOf(input) {
+  if (!input) return null;
+  const host = input.trim().toLowerCase().replace(/^[a-z]+:\/\//, "").replace(/^.*@/, "").replace(/^www\./, "").split(/[/?#:]/)[0] ?? "";
+  return host.includes(".") && !FREEMAIL.has(host) ? host : null;
+}
+function candidate(r) {
+  return { id: r.id, companyName: str(r.companyName), webAddress: str(r.webAddress), phone: str(r.phone), isActive: bool(r.isActive) };
+}
+function has(v) {
+  return v !== void 0 && v !== null && v !== "";
+}
+async function prepareCrmWrite(resource, input, http) {
+  const intents = ["create_company", "add_contact", "update_contact", "update_company"];
+  if (!input || !intents.includes(input.intent)) throw new AutotaskConfigError(`prepareCrmWrite: intent must be one of ${intents.join(", ")}`);
+  const co = input.company ?? {};
+  const ct = input.contact ?? {};
+  const caveats = [
+    "Companies, resources and countries are blind surfaces on some tenants: a miss is not proof a record is absent, and owner / country candidates are lookups, not lists.",
+    "Company name matching is `contains` (exact names ranked first); there is no semantic search in the SDK."
+  ];
+  const needsInput = [];
+  let candidates = [];
+  let matchedBy = null;
+  let searched = false;
+  if (has(co.id)) {
+    searched = true;
+    const rows = await readRows(http, "/V1.0/Companies/query", [{ field: "id", op: "eq", value: co.id }]);
+    candidates = rows.map(candidate);
+    matchedBy = candidates.length ? "id" : null;
+  }
+  const domain = domainOf(co.domain) ?? domainOf(co.website) ?? domainOf(ct.emailAddress);
+  if (candidates.length === 0 && domain) {
+    searched = true;
+    candidates = (await resource.searchByDomain(domain, { limit: LIMIT })).map((c) => candidate(c));
+    matchedBy = candidates.length ? "domain" : null;
+  }
+  if (candidates.length === 0 && has(co.companyName)) {
+    searched = true;
+    const rows = (await resource.searchByIdentity({ companyName: co.companyName }, { limit: LIMIT })).map((c) => candidate(c));
+    const want = norm(co.companyName);
+    const exact = rows.filter((r) => r.companyName !== null && norm(r.companyName) === want);
+    candidates = exact.length ? exact : rows;
+    matchedBy = candidates.length ? exact.length ? "name_exact" : "name_contains" : null;
+  }
+  const status = !searched ? "not_searched" : candidates.length === 0 ? "none" : candidates.length === 1 ? "matched" : "ambiguous";
+  const companyID = status === "matched" ? candidates[0].id : null;
+  const company = { status, matchedBy, candidates };
+  if (status === "ambiguous") {
+    needsInput.push({ field: "company", why: `${candidates.length} companies match; choose one`, source: "policy", lookup: { candidates: candidates.map((c) => ({ id: c.id, companyName: c.companyName })) }, research: "ask" });
+  }
+  if (status === "none" && input.intent !== "create_company") {
+    needsInput.push({ field: "company", why: "no company matched; give a company id, name or domain, or use intent create_company (a miss is not proof of absence)", source: "policy", research: "ask" });
+  }
+  if (status === "not_searched" && input.intent !== "create_company") {
+    needsInput.push({ field: "company", why: "give a company id, name, domain/website or a contact email to search by", source: "policy", research: "ask" });
+  }
+  let locations = null;
+  if (companyID !== null) {
+    const rows = await readRows(http, "/V1.0/CompanyLocations/query", [{ field: "companyID", op: "eq", value: companyID }]);
+    const items = rows.map((r) => ({ id: r.id, name: str(r.name), isPrimary: bool(r.isPrimary), isActive: bool(r.isActive), city: str(r.city), state: str(r.state), postalCode: str(r.postalCode) }));
+    const active = items.filter((l) => l.isActive !== false);
+    const m = active.filter((l) => has(ct.city) && l.city?.toLowerCase() === String(ct.city).toLowerCase() || has(ct.postalCode) && l.postalCode === String(ct.postalCode));
+    const pick = has(ct.companyLocationID) ? { rule: "matched", locationID: ct.companyLocationID } : active.length === 1 ? { rule: "single", locationID: active[0].id } : active.length > 1 && m.length === 1 ? { rule: "matched", locationID: m[0].id } : active.length > 1 ? { rule: "ask", locationID: null } : { rule: "none", locationID: null };
+    locations = { items, pick };
+    if (input.intent === "add_contact" && pick.locationID === null) {
+      needsInput.push({
+        field: "companyLocationID",
+        why: active.length > 1 ? "the company has several active locations; do not guess" : "the company has no active location; create or reactivate one first",
+        source: "policy",
+        lookup: { candidates: active.map((l) => ({ id: l.id, name: l.name, isPrimary: l.isPrimary })) },
+        research: "ask"
+      });
+    }
+  }
+  let contacts = null;
+  if (input.intent !== "create_company" && (has(ct.emailAddress) || has(ct.firstName) && has(ct.lastName) || has(ct.id))) {
+    const pickFields = (r) => ({ id: r.id, firstName: r.firstName, lastName: r.lastName, emailAddress: r.emailAddress, companyID: r.companyID, companyLocationID: r.companyLocationID, isActive: r.isActive });
+    let rows = [];
+    let by = null;
+    if (has(ct.id)) rows = await readRows(http, "/V1.0/Contacts/query", [{ field: "id", op: "eq", value: ct.id }]);
+    else if (has(ct.emailAddress)) {
+      rows = await readRows(http, "/V1.0/Contacts/query", [{ field: "emailAddress", op: "eq", value: ct.emailAddress }]);
+      by = rows.length ? "email" : null;
+    }
+    if (rows.length === 0 && has(ct.firstName) && has(ct.lastName)) {
+      const f = [{ field: "firstName", op: "eq", value: ct.firstName }, { field: "lastName", op: "eq", value: ct.lastName }];
+      if (companyID !== null) f.push({ field: "companyID", op: "eq", value: companyID });
+      rows = await readRows(http, "/V1.0/Contacts/query", f);
+      by = rows.length ? "name" : null;
+    }
+    contacts = { duplicates: rows.slice(0, LIMIT).map(pickFields), matchedBy: by };
+    if (input.intent === "update_contact" && rows.length === 0) {
+      needsInput.push({ field: "contact", why: "no contact matched; give a contact id or email", source: "policy", research: "ask" });
+    }
+  }
+  if (input.intent === "create_company" && status !== "matched") {
+    const eff = effectiveRequiredFields(null, RELATIONSHIP_MAP.companies?.zoneFacts);
+    const research = (f) => ["companyType", "ownerResourceID", "countryID"].includes(f) ? "lookup" : "web_if_available_else_ask";
+    const lookups = {
+      companyType: { via: "operations.fieldCatalog", resource: "companies", field: "companyType", labels: true, note: "map the user wording to one returned label; never hardcode ids" },
+      ownerResourceID: { via: "resources.get / the staff resolver", note: "owners cannot be enumerated on a blind surface: take a known resource id and confirm it with resources.get" },
+      countryID: { via: "countries.query", note: "resolve the country name to an id; never guess" }
+    };
+    const wanted = [
+      ...eff.fields.filter((f) => f !== "isActive").map((f) => [f, "live-proven"]),
+      ...["address1", "city", "state", "postalCode", "countryID"].map((f) => [f, "policy"])
+    ];
+    for (const [f, source] of wanted) {
+      if (has(co[f]) || needsInput.some((n) => n.field === f)) continue;
+      needsInput.push({ field: f, why: source === "policy" ? `CRM policy: a new company needs ${f} (the vendor auto-creates a "Primary Address" location from it)` : `the vendor requires ${f} to create a company`, source, ...lookups[f] ? { lookup: lookups[f] } : {}, research: research(f) });
+    }
+  }
+  if (input.intent === "add_contact") {
+    for (const f of ["firstName", "lastName"]) if (!has(ct[f])) needsInput.push({ field: f, why: `the vendor requires contact ${f}`, source: "live-proven", research: "ask" });
+    if (!has(ct.emailAddress) && !has(ct.phone) && !has(ct.mobilePhone)) needsInput.push({ field: "emailAddress", why: "CRM policy: a contact needs an email or a phone number", source: "policy", research: "ask" });
+  }
+  let next = null;
+  const isInactive = (d) => d.isActive === false || d.isActive === 0;
+  const dups = contacts?.duplicates ?? [];
+  const sameCompany = companyID === null ? dups : dups.filter((d) => d.companyID === companyID);
+  const elsewhere = companyID === null ? [] : dups.filter((d) => d.companyID !== companyID && !isInactive(d));
+  if (input.intent === "add_contact" && sameCompany.length === 0 && elsewhere.length > 0) {
+    needsInput.push({ field: "contact", why: `a contact with this ${contacts?.matchedBy ?? "identity"} is active at another company: update it, move it with contacts.moveToCompany, or confirm a second record`, source: "policy", lookup: { duplicates: elsewhere }, research: "ask" });
+  }
+  if (needsInput.length === 0) {
+    const dup = sameCompany[0];
+    if (input.intent === "create_company") next = status === "matched" ? { operation: "companies.update", note: "the company already exists: update it instead of creating" } : { operation: "companies.create", note: 'then re-run with intent add_contact: the vendor auto-creates a "Primary Address" location (rename it with company_locations.update; locations cannot be deleted via the API)' };
+    else if (input.intent === "add_contact") next = dup ? { operation: "contacts.update", note: `a contact already matches by ${contacts?.matchedBy ?? "id"} (id ${String(dup.id)}): update it, or move it with contacts.moveToCompany if it belongs to another company` } : { operation: "contacts.create", note: `set companyID ${String(companyID)} and companyLocationID ${String(locations?.pick.locationID)}` };
+    else if (input.intent === "update_contact") next = { operation: "contacts.update", note: "send only the changed fields" };
+    else next = { operation: "companies.update", note: "send only the changed fields" };
+  }
+  return { intent: input.intent, company, locations, contacts, needsInput, next, caveats };
+}
+
 // src/resources/special/companies/unbilledWorkTypes.ts
 var UNBILLED_WORK_NOTE_CHARS_DEFAULT = 400;
 var UNBILLED_WORK_JOIN_SET_CAP = 300;
@@ -1671,7 +1817,7 @@ function validateUnbilledWorkOptions(companyId, opts) {
 }
 
 // src/resources/special/companies/unbilledWork.ts
-var OP2 = "companies.unbilledWork";
+var OP3 = "companies.unbilledWork";
 function capJoinSet(ids2, cap) {
   const sorted = [...new Set(ids2)].sort((a, b) => a - b);
   if (sorted.length <= cap) return { ids: sorted, truncated: false };
@@ -1708,14 +1854,14 @@ async function readCompanyAndParent(resource, id, includeParent) {
 }
 async function readJoinSets(http, companyIds, v) {
   const ticketsCond = [{ field: "companyID", op: "in", value: companyIds }];
-  const ticketsRaw = await boundedPart(http, "/V1.0/Tickets/query", ticketsCond, v.limit, OP2);
+  const ticketsRaw = await boundedPart(http, "/V1.0/Tickets/query", ticketsCond, v.limit, OP3);
   const projectsCond = [{ field: "companyID", op: "in", value: companyIds }];
-  const projectsRaw = await boundedPart(http, "/V1.0/Projects/query", projectsCond, v.limit, OP2);
+  const projectsRaw = await boundedPart(http, "/V1.0/Projects/query", projectsCond, v.limit, OP3);
   const projectIds = projectsRaw.items.map((p) => num(p.id)).filter((n) => n > 0);
   let taskIds = [];
   let tasksHasMore = false;
   if (projectIds.length > 0) {
-    const tasksRaw = await boundedPart(http, "/V1.0/Tasks/query", [{ field: "projectID", op: "in", value: projectIds }], v.limit, OP2);
+    const tasksRaw = await boundedPart(http, "/V1.0/Tasks/query", [{ field: "projectID", op: "in", value: projectIds }], v.limit, OP3);
     taskIds = tasksRaw.items.map((t) => num(t.id)).filter((n) => n > 0);
     tasksHasMore = tasksRaw.hasMore;
   }
@@ -1739,7 +1885,7 @@ async function readBillingPart(http, v, companyIds) {
   }
   const billingFields = resolveFieldsPreset("billing_join", "billing_items");
   const billingIncludeFields = [...billingFields, "id", ...v.includeNotes ? ["description"] : []];
-  const billingRaw = await boundedPart(http, "/V1.0/BillingItems/query", billingConditions, v.limit, OP2, billingIncludeFields);
+  const billingRaw = await boundedPart(http, "/V1.0/BillingItems/query", billingConditions, v.limit, OP3, billingIncludeFields);
   let billingItems = billingRaw.items;
   let billingNoteCharsTruncated = 0;
   if (v.includeNotes) {
@@ -1783,7 +1929,7 @@ async function readTimePart(http, v, join) {
     if (v.dateFrom !== void 0) timeConditions.push({ field: "dateWorked", op: "gte", value: v.dateFrom });
     if (v.dateTo !== void 0) timeConditions.push({ field: "dateWorked", op: "lte", value: v.dateTo });
     const timeFields = ["taskID", "ticketID", "hoursWorked", "dateWorked", "id", ...v.includeNotes ? ["summaryNotes"] : []];
-    const raw = await boundedPart(http, "/V1.0/TimeEntries/query", timeConditions, v.limit, OP2, timeFields);
+    const raw = await boundedPart(http, "/V1.0/TimeEntries/query", timeConditions, v.limit, OP3, timeFields);
     entries = raw.items;
     let cappedItems = entries;
     let noteCharsTruncated = 0;
@@ -2007,6 +2153,10 @@ var CompaniesResource = class extends BaseResource {
   unbilledWork(id, opts) {
     return unbilledWork(this, id, opts, this.http);
   }
+  /** Node-parity special op (hand-written in src/resources/special/companies.ts). */
+  prepareCrmWrite(input) {
+    return prepareCrmWrite(this, input, this.http);
+  }
 };
 
 // src/resources/company_alerts.ts
@@ -4834,11 +4984,11 @@ var ContractServiceUnitsResource = class extends BaseResource {
 };
 
 // src/resources/special/contracts/lineOfBusiness.ts
-var OP3 = "contracts.lineOfBusiness";
+var OP4 = "contracts.lineOfBusiness";
 function positiveId(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(OP3 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP3 });
+    throw new AutotaskConfigError(OP4 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP4 });
   }
   return n;
 }
@@ -4864,7 +5014,7 @@ async function lineOfBusiness(resource, contractIdIn, http, associationIdIn) {
       markers: { association: "missing", organizationalLevel2: "missing", organizationalLevel1: "missing" }
     };
   }
-  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP3, onError: "propagate" });
+  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP4, onError: "propagate" });
   const { association, organizationalLevel2, organizationalLevel1, markers } = chain.lineOfBusiness;
   return { contractId, associationSource, association, organizationalLevel2, organizationalLevel1, markers };
 }
@@ -5338,7 +5488,7 @@ function appendWiresNote(wires, note) {
   wires.note = (wires.note ? wires.note + " | " : "") + note;
 }
 function makeFetchCtx(rawHttp, v, contractId, budget) {
-  const OP11 = PROFITABILITY_OP;
+  const OP12 = PROFITABILITY_OP;
   const id = parseIdentifier(contractId, "contractId");
   const idNum = typeof id === "number" ? id : Number(id);
   const wires = { issued: 0, requests: 0, budget };
@@ -5350,19 +5500,19 @@ function makeFetchCtx(rawHttp, v, contractId, budget) {
   } };
   const readPart = (path, conditions, fields) => {
     wires.issued += 1;
-    return degradable(() => boundedPart(http, path, conditions, v.limit, OP11, fields));
+    return degradable(() => boundedPart(http, path, conditions, v.limit, OP12, 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, OP11, fields, dateField, v.dateFrom, v.dateTo, wires));
+    const wp = await degradable(() => expandByMonth(http, path, cond, v.limit, OP12, 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: OP11, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
+  return { v, OP: OP12, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
 }
 
 // src/resources/special/contracts/profitability.stages.ts
@@ -10734,22 +10884,22 @@ function uiLinkFor(http, entity, id) {
 }
 
 // src/resources/special/ticket_charges.ts
-var OP4 = "ticket_charges.moveToTicket";
+var OP5 = "ticket_charges.moveToTicket";
 var COPY = ["name", "description", "chargeType", "billingCodeID", "productID", "unitQuantity", "unitCost", "unitPrice", "datePurchased", "isBillableToCompany", "notes", "purchaseOrderNumber", "internalPurchaseOrderNumber"];
 var CONTRACT_SCOPED = ["contractServiceID", "contractServiceBundleID"];
 async function readCharge(http, id, retries) {
-  const rows = await queryRows(http, "TicketCharges", [{ field: "id", op: "eq", value: id }], OP4, retries);
+  const rows = await queryRows(http, "TicketCharges", [{ field: "id", op: "eq", value: id }], OP5, retries);
   return rows[0] ?? null;
 }
 async function checkSource({ http, source, sourceId, sourceTicketId, toTicketId }) {
   if (source.isBilled === true) {
-    throw refuse("MOVE_BLOCKED_BILLED", `${OP4}: ticket charge ${sourceId} is billed \u2014 move it in the Autotask UI`, { sourceId, toTicketId }, OP4, {
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP5}: ticket charge ${sourceId} is billed \u2014 move it in the Autotask UI`, { sourceId, toTicketId }, OP5, {
       manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "tickets", sourceTicketId), reason: "billed charges are not moved by the API (the ticket link opens its charges)" }
     });
   }
 }
 var SPEC = {
-  operation: OP4,
+  operation: OP5,
   entity: "ticket_charge",
   readSource: readCharge,
   sourceTicketId: (s) => typeof s.ticketID === "number" ? s.ticketID : null,
@@ -11418,12 +11568,12 @@ async function slaHealthCheck(_resource, id, opts = {}, http) {
     "tickets.slaHealthCheck"
   );
   const slas = rows.map((row) => {
-    const bool = (v) => typeof v === "boolean" ? v : null;
+    const bool2 = (v) => typeof v === "boolean" ? v : null;
     const num2 = (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: bool2(row.isFirstResponseMet), elapsedHours: num2(row.firstResponseElapsedHours) },
+      { name: "resolution", met: bool2(row.isResolutionMet), elapsedHours: num2(row.resolutionElapsedHours) },
+      { name: "resolutionPlan", met: bool2(row.isResolutionPlanMet), elapsedHours: num2(row.resolutionPlanElapsedHours) }
     ];
     return { id: Number(row.id), name: row.serviceLevelAgreementName ?? null, milestones };
   });
@@ -11441,11 +11591,11 @@ async function summary(_resource, id, opts = {}, http) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const ageDays = typeof ticket.createDate === "string" && ticket.createDate !== "" ? Math.max(0, Math.floor((now.getTime() - Date.parse(ticket.createDate)) / MS)) : null;
   const pick = (v) => typeof v === "number" ? v : null;
-  const str = (v) => typeof v === "string" && v !== "" ? v : null;
+  const str2 = (v) => typeof v === "string" && v !== "" ? v : null;
   return {
     ticketId,
-    ticketNumber: str(ticket.ticketNumber),
-    title: str(ticket.title),
+    ticketNumber: str2(ticket.ticketNumber),
+    title: str2(ticket.title),
     description: desc.value,
     descriptionLength: desc.length,
     descriptionTruncated: desc.truncated,
@@ -11455,8 +11605,8 @@ async function summary(_resource, id, opts = {}, http) {
     contactID: pick(ticket.contactID),
     assignedResourceID: pick(ticket.assignedResourceID),
     projectID: pick(ticket.projectID),
-    createDate: str(ticket.createDate),
-    dueDateTime: str(ticket.dueDateTime),
+    createDate: str2(ticket.createDate),
+    dueDateTime: str2(ticket.dueDateTime),
     ageDays
   };
 }
@@ -12203,7 +12353,7 @@ async function fullContext(resource, id, opts = {}, http) {
 }
 
 // src/resources/special/tickets/forResource.ts
-var OP5 = "tickets.forResource";
+var OP6 = "tickets.forResource";
 var TICKET_CHUNK = 100;
 var LIMIT_DEFAULT = 100;
 var LIMIT_MAX = 500;
@@ -12212,7 +12362,7 @@ var TICKET_FIELDS2 = ["id", "ticketNumber", "title", "status", "assignedResource
 function positiveId2(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(`${OP5}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP6 });
   }
   return n;
 }
@@ -12222,28 +12372,28 @@ async function ticketPage(http, filter, maxRecords, fields) {
     idempotent: true,
     path: "/V1.0/Tickets/query",
     body: { MaxRecords: maxRecords, filter, IncludeFields: fields },
-    operation: OP5
+    operation: OP6
   });
-  const page = unwrapItems(res, OP5);
+  const page = unwrapItems(res, OP6);
   return { rows: page.items, more: page.pageDetails.nextPageUrl !== null };
 }
 async function forResource(_resource, resourceIDIn, http, opts = {}) {
-  if (opts === null || typeof opts !== "object") throw new AutotaskConfigError(`${OP5}: opts must be an object`, { operation: OP5 });
+  if (opts === null || typeof opts !== "object") throw new AutotaskConfigError(`${OP6}: opts must be an object`, { operation: OP6 });
   const resourceID = positiveId2(resourceIDIn, "resourceID");
   const scope = opts.scope ?? "both";
   if (scope !== "primary" && scope !== "secondary" && scope !== "both") {
-    throw new AutotaskConfigError(`${OP5}: scope must be 'primary', 'secondary' or 'both' (got ${JSON.stringify(opts.scope)})`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: scope must be 'primary', 'secondary' or 'both' (got ${JSON.stringify(opts.scope)})`, { operation: OP6 });
   }
   if (opts.openOnly !== void 0 && typeof opts.openOnly !== "boolean") {
-    throw new AutotaskConfigError(`${OP5}: openOnly must be a boolean`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: openOnly must be a boolean`, { operation: OP6 });
   }
   const limit = opts.limit === void 0 ? LIMIT_DEFAULT : opts.limit;
   if (!Number.isInteger(limit) || limit < 1 || limit > LIMIT_MAX) {
-    throw new AutotaskConfigError(`${OP5}: limit must be an integer 1-${LIMIT_MAX} (got ${String(opts.limit)})`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: limit must be an integer 1-${LIMIT_MAX} (got ${String(opts.limit)})`, { operation: OP6 });
   }
   const includeFields = opts.includeFields ?? [];
   if (!Array.isArray(includeFields) || includeFields.some((f) => typeof f !== "string" || f.length === 0)) {
-    throw new AutotaskConfigError(`${OP5}: includeFields must be a list of field names`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: includeFields must be a list of field names`, { operation: OP6 });
   }
   const openOnly = opts.openOnly === true;
   const fields = [.../* @__PURE__ */ new Set([...TICKET_FIELDS2, ...includeFields])];
@@ -12258,9 +12408,9 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
       idempotent: true,
       path: "/V1.0/TicketSecondaryResources/query",
       body: { MaxRecords: LINK_READ_CAP, filter: [{ field: "resourceID", op: "eq", value: resourceID }], IncludeFields: ["ticketID"] },
-      operation: OP5
+      operation: OP6
     });
-    const page = unwrapItems(res, OP5);
+    const page = unwrapItems(res, OP6);
     for (const row of page.items) if (typeof row.ticketID === "number" && !linkIds.includes(row.ticketID)) linkIds.push(row.ticketID);
     if (page.items.length >= LINK_READ_CAP || page.pageDetails.nextPageUrl !== null) capped = true;
   }
@@ -12313,11 +12463,11 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
 }
 
 // src/resources/special/tickets/lineOfBusiness.ts
-var OP6 = "tickets.lineOfBusiness";
+var OP7 = "tickets.lineOfBusiness";
 function positiveId3(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(OP6 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP6 });
+    throw new AutotaskConfigError(OP7 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP7 });
   }
   return n;
 }
@@ -12340,7 +12490,7 @@ async function lineOfBusiness2(resource, ticketIdIn, http, associationIdIn) {
       if (contractRef !== void 0) {
         const client = http.client;
         if (client === void 0) {
-          throw new AutotaskConfigError(OP6 + ": the transport is not wired to an AutotaskClient (the composite must run through the client)", { operation: OP6 });
+          throw new AutotaskConfigError(OP7 + ": the transport is not wired to an AutotaskClient (the composite must run through the client)", { operation: OP7 });
         }
         try {
           const contract = await client.contracts.get(contractRef);
@@ -12371,7 +12521,7 @@ async function lineOfBusiness2(resource, ticketIdIn, http, associationIdIn) {
       markers: { association: contractUnread ? "unresolved" : "missing", organizationalLevel2: "missing", organizationalLevel1: "missing" }
     };
   }
-  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP6, onError: "propagate" });
+  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP7, onError: "propagate" });
   const { association, organizationalLevel2, organizationalLevel1, markers } = chain.lineOfBusiness;
   return { ticketId, associationSource, contractId, association, organizationalLevel2, organizationalLevel1, markers };
 }
@@ -12662,12 +12812,12 @@ async function postedStateQuery(_resource, mode, http, opts) {
   return { items, hasMore: read.hasMore || incomplete, window, approvedCount, unapprovedCount: items.length - approvedCount };
 }
 async function postedWithin(_resource, from, to, http, opts, opLabel = "time_entries.postedWithin") {
-  const OP11 = opLabel;
-  if (opts?.tz !== void 0) validateZone(opts.tz, OP11);
-  const fromB = customRangeDay(from, "from", void 0, OP11);
-  const toB = customRangeDay(to, "to", void 0, OP11);
+  const OP12 = opLabel;
+  if (opts?.tz !== void 0) validateZone(opts.tz, OP12);
+  const fromB = customRangeDay(from, "from", void 0, OP12);
+  const toB = customRangeDay(to, "to", void 0, OP12);
   if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP11}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP11 });
+    throw new AutotaskConfigError(`${OP12}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP12 });
   }
   const windowToMs = toB.ms + DAY_MS2 - 1;
   const filter = [
@@ -12676,8 +12826,8 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
   ];
   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), OP11, http);
-  const { states, incomplete } = await postedStateOf(http, items, OP11);
+  const { items, hasMore } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP12, http);
+  const { states, incomplete } = await postedStateOf(http, items, OP12);
   let postedCount = 0;
   let unpostedCount = 0;
   for (const state of states.values()) {
@@ -12887,7 +13037,7 @@ async function resolveCode(http, family, familyLabel2, pinnedId, departments, op
 }
 
 // src/resources/special/time_entries/createForResource.ts
-var OP7 = "time_entries.createForResource";
+var OP8 = "time_entries.createForResource";
 var PARAM_KEYS = /* @__PURE__ */ new Set([
   "internallAllocationCodeID",
   "ticketID",
@@ -12923,30 +13073,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: OP7 }
+      { operation: OP8 }
     );
   }
   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: OP7 }
+      { operation: OP8 }
     );
   }
   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: OP7 }
+      { operation: OP8 }
     );
   }
   return pins;
 }
 async function assertResourceActive(http, rid) {
-  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP7);
+  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP8);
   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: OP7,
+      operation: OP8,
       category: "not_found",
       suggestedAction: "Resolve the resource id (resources.get / resources.search) and retry."
     });
@@ -12955,7 +13105,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: OP7,
+      operation: OP8,
       suggestedAction: "Activate the resource or pick an active one."
     });
   }
@@ -12965,11 +13115,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, OP7);
+  code = await resolveCode(http, familyOf(linkage), familyLabel(familyOf(linkage)), pinnedForCode, departments, OP8);
   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, OP7);
+    code = await resolveCode(http, USE_TYPE_INTERNAL, familyLabel(USE_TYPE_INTERNAL), void 0, departments, OP8);
     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) {
@@ -12979,7 +13129,7 @@ async function resolveAllocationCode(http, rid, linkage, pins, departments) {
         families: familiesTried,
         resourceDepartments: [...departments].sort((a, b) => a - b)
       },
-      { operation: OP7 }
+      { operation: OP8 }
     );
   }
   const resolvedCode = codeInfo(code);
@@ -13018,7 +13168,7 @@ function createDryRun2(http, rid, body, linkage, usedLinkage, resolvedCode) {
   }
   return buildDryRunResult(
     {
-      operation: OP7,
+      operation: OP8,
       method: "POST",
       path: "/V1.0/TimeEntries",
       ids: [rid],
@@ -13060,7 +13210,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}`, OP7);
+          const task = await fetchItem2(http, `/V1.0/Tasks/${pins.task}`, OP8);
           taskRoleFetched = true;
           if (task !== null) pushLadder(task.assignedResourceRoleID);
         }
@@ -13086,7 +13236,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, OP7);
+  const roleRows = await resourceRoleRows(http, rid, OP8);
   const departments = roleRows.departments;
   const { usedLinkage, resolvedCode } = await resolveAllocationCode(http, rid, linkage, pins, departments);
   const defaults = windowDefaults(params);
@@ -13109,12 +13259,12 @@ function discoveryField(err, body, defaults) {
 }
 
 // src/resources/special/time_entries/move.ts
-var OP8 = "time_entries.moveToTicket";
+var OP9 = "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: OP8, maxRetries: retries });
+    const res = await http.request({ method: "GET", path: `/V1.0/TimeEntries/${id}`, operation: OP9, maxRetries: retries });
     return res?.item ?? null;
   } catch (e) {
     if (isAutotaskError(e) && (e.httpStatus === 404 || e.code === "NOT_FOUND")) return null;
@@ -13124,27 +13274,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", `${OP8}: time entry ${sourceId} is on a task \u2014 only ticket time entries are moved`, ids2, OP8);
+    throw refuse("MOVE_SOURCE_UNSUPPORTED", `${OP9}: time entry ${sourceId} is on a task \u2014 only ticket time entries are moved`, ids2, OP9);
   }
   if (source.billingApprovalDateTime || source.billingApprovalResourceID || source.billingApprovalLevelMostRecent) {
-    throw refuse("MOVE_BLOCKED_APPROVED", `${OP8}: time entry ${sourceId} has billing approval set \u2014 move it in the Autotask UI`, ids2, OP8, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "approved entries are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_APPROVED", `${OP9}: time entry ${sourceId} has billing approval set \u2014 move it in the Autotask UI`, ids2, OP9, { 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 }], OP8, retries);
+    billing = await queryRows(http, "BillingItems", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP9, retries);
   } catch {
-    throw refuse("MOVE_BLOCKED_BILLED", `${OP8}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP8, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billing state unreadable" } });
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP9}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP9, { 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", `${OP8}: time entry ${sourceId} is billed or posted \u2014 move it in the Autotask UI`, ids2, OP8, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billed entries are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP9}: time entry ${sourceId} is billed or posted \u2014 move it in the Autotask UI`, ids2, OP9, { 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 }], OP8, retries);
+  const attachments = await queryRows(http, "TimeEntryAttachments", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP9, retries);
   if (attachments.length > 0) {
-    throw refuse("MOVE_BLOCKED_ATTACHMENTS", `${OP8}: time entry ${sourceId} has attachments, which a delete would destroy \u2014 move it in the Autotask UI`, ids2, OP8, { 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", `${OP9}: time entry ${sourceId} has attachments, which a delete would destroy \u2014 move it in the Autotask UI`, ids2, OP9, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "entries with attachments are not moved by the API" } });
   }
 }
 var SPEC2 = {
-  operation: OP8,
+  operation: OP9,
   entity: "time_entry",
   readSource: readTimeEntry,
   sourceTicketId: (s) => typeof s.ticketID === "number" ? s.ticketID : null,
@@ -13179,7 +13329,7 @@ function moveToTicket2(_resource, sourceId, toTicketId, opts, http) {
 }
 
 // src/resources/special/time_entries/approve.ts
-var OP9 = "time_entries.approve";
+var OP10 = "time_entries.approve";
 var APPROVAL_LEVELS_PATH = "/V1.0/BillingItemApprovalLevels";
 function toIso(value) {
   if (value instanceof Date) {
@@ -13217,7 +13367,7 @@ async function approve(resource, id, opts = {}, http) {
   if (opts.dryRun === true) {
     return buildDryRunResult(
       {
-        operation: OP9,
+        operation: OP10,
         method: "POST",
         path: APPROVAL_LEVELS_PATH,
         ids: [numericId],
@@ -13240,10 +13390,10 @@ async function approve(resource, id, opts = {}, http) {
     method: "POST",
     path: APPROVAL_LEVELS_PATH,
     body,
-    operation: OP9,
+    operation: OP10,
     maxRetries: opts.maxRetries
   });
-  const levelId = toNumber(parseIdentifier(unwrapOperation(created, OP9).id, "billingItemApprovalLevelID"));
+  const levelId = toNumber(parseIdentifier(unwrapOperation(created, OP10).id, "billingItemApprovalLevelID"));
   await resource.update(
     numericId,
     { billingApprovalDateTime: approvalDateTime, billingApprovalResourceID: approvalResourceID },
@@ -13266,28 +13416,28 @@ async function approve(resource, id, opts = {}, http) {
 }
 
 // src/resources/special/time_entries/recentTickets.ts
-var OP10 = "time_entries.recentTickets";
+var OP11 = "time_entries.recentTickets";
 var DAY_MS3 = 864e5;
 var TICKET_CHUNK2 = 100;
 var TICKET_FIELDS3 = ["id", "ticketNumber", "title", "status", "assignedResourceID", "companyID"];
 function positiveId4(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(`${OP10}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP10 });
+    throw new AutotaskConfigError(`${OP11}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP11 });
   }
   return n;
 }
 async function recentTickets(_resource, from, to, http, opts) {
   if (opts === void 0 || opts === null || typeof opts !== "object") {
-    throw new AutotaskConfigError(`${OP10}: opts { resourceID, companyID?, tz?, limit? } is required`, { operation: OP10 });
+    throw new AutotaskConfigError(`${OP11}: opts { resourceID, companyID?, tz?, limit? } is required`, { operation: OP11 });
   }
   const resourceID = positiveId4(opts.resourceID, "resourceID");
   const companyID = opts.companyID === void 0 ? void 0 : positiveId4(opts.companyID, "companyID");
-  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 (opts.tz !== void 0) validateZone(opts.tz, OP11);
+  const fromB = customRangeDay(from, "from", void 0, OP11);
+  const toB = customRangeDay(to, "to", void 0, OP11);
   if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP10}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`, { operation: OP10 });
+    throw new AutotaskConfigError(`${OP11}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`, { operation: OP11 });
   }
   const windowToMs = toB.ms + DAY_MS3 - 1;
   const { items: entries, hasMore } = await queryTimeEntries(
@@ -13298,7 +13448,7 @@ async function recentTickets(_resource, from, to, http, opts) {
       { field: "resourceID", op: "eq", value: resourceID }
     ],
     clampWindowLimit(opts.limit),
-    OP10,
+    OP11,
     http
   );
   const groups = /* @__PURE__ */ new Map();
@@ -13324,9 +13474,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: OP10
+      operation: OP11
     });
-    for (const t of unwrapItems(res, OP10).items) if (typeof t.id === "number") tickets.set(t.id, t);
+    for (const t of unwrapItems(res, OP11).items) if (typeof t.id === "number") tickets.set(t.id, t);
   }
   const items = [];
   const unresolvedTicketIDs = [];