node-autotask 0.40.0 → 0.41.0

package/dist/{chunk-VDVBXXJW.js → chunk-LR6FDJI3.js}

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-Y6YJYKBZ.js";
+} from "./chunk-ZVSSAULC.js";
 import {
   wrapUntrusted
 } from "./chunk-5VHSLJMR.js";
@@ -22729,7 +22729,7 @@ function appendWiresNote(wires, note) {
   wires.note = (wires.note ? wires.note + " | " : "") + note;
 }
 function makeFetchCtx(rawHttp, v, contractId, budget) {
-  const OP9 = PROFITABILITY_OP;
+  const OP8 = PROFITABILITY_OP;
   const id = parseIdentifier(contractId, "contractId");
   const idNum = typeof id === "number" ? id : Number(id);
   const wires = { issued: 0, requests: 0, budget };
@@ -22741,19 +22741,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, OP8, 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, OP8, 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: OP8, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
 }
 
 // src/resources/special/contracts/profitability.stages.ts
@@ -24385,50 +24385,50 @@ async function queryTimeEntries(_resource, filter, limit, operation, http, curso
   const { items, pageDetails } = unwrapItems(res);
   return { items, hasMore: pageDetails.nextPageUrl != null, nextCursor: pageDetails.nextPageUrl ?? null };
 }
-function pagingOpts(opts, OP9) {
+function pagingOpts(opts, OP8) {
   if (opts?.countOnly !== void 0 && typeof opts.countOnly !== "boolean") {
-    throw new AutotaskConfigError(`${OP9}: countOnly must be a boolean`, { operation: OP9 });
+    throw new AutotaskConfigError(`${OP8}: countOnly must be a boolean`, { operation: OP8 });
   }
   const countOnly = opts?.countOnly === true;
   const cursor = opts?.cursor;
   if (cursor !== void 0 && (typeof cursor !== "string" || cursor.trim() === "")) {
-    throw new AutotaskConfigError(`${OP9}: cursor must be the non-empty nextCursor of a previous call`, { operation: OP9 });
+    throw new AutotaskConfigError(`${OP8}: cursor must be the non-empty nextCursor of a previous call`, { operation: OP8 });
   }
   if (cursor !== void 0 && cursor.length > CURSOR_MAX) {
-    throw new ResponseRejectedError(`${OP9}: refused the pagination cursor: ${cursor.length} chars is over the ${CURSOR_MAX}-char cap (a vendor nextPageUrl is far shorter)`);
+    throw new ResponseRejectedError(`${OP8}: refused the pagination cursor: ${cursor.length} chars is over the ${CURSOR_MAX}-char cap (a vendor nextPageUrl is far shorter)`);
   }
   if (cursor !== void 0 && countOnly) {
-    throw new AutotaskConfigError(`${OP9}: cursor does not apply with countOnly (countOnly reads every page itself)`, { operation: OP9 });
+    throw new AutotaskConfigError(`${OP8}: cursor does not apply with countOnly (countOnly reads every page itself)`, { operation: OP8 });
   }
   const budget = opts?.maxVendorCalls ?? COUNT_BUDGET_DEFAULT;
   if (!Number.isInteger(budget) || budget < 1 || budget > COUNT_BUDGET_MAX) {
-    throw new AutotaskConfigError(`${OP9}: maxVendorCalls must be an integer 1-${COUNT_BUDGET_MAX} (got ${String(opts?.maxVendorCalls)})`, { operation: OP9 });
+    throw new AutotaskConfigError(`${OP8}: maxVendorCalls must be an integer 1-${COUNT_BUDGET_MAX} (got ${String(opts?.maxVendorCalls)})`, { operation: OP8 });
   }
   return { ...cursor === void 0 ? {} : { cursor }, countOnly, budget };
 }
-function budgetExceeded(OP9, details, midWalk) {
+function budgetExceeded(OP8, details, midWalk) {
   const { estimate, budget, total } = details;
   const raise = midWalk ? budget < COUNT_BUDGET_MAX ? `, or pass a maxVendorCalls above ${budget} for headroom past the estimate` : "" : estimate <= COUNT_BUDGET_MAX ? ` or pass maxVendorCalls >= ${estimate}` : "";
   return new AutotaskError(
-    midWalk ? `${OP9}: countOnly stopped at the ${budget}-call budget mid-walk: the walk needed more calls than the ${estimate} estimated from the ${total}-entry count (more entries than counted, or an extra page such as an empty continuation page), so the next call, which may be the closing re-count, did not fit; no partial total is returned` : `${OP9}: countOnly needs an estimated ${estimate} vendor calls for ${total} entries (1 count + 1 per ${PAGE} entries + 1 join per 250 + 1 re-count), over the ${budget}-call budget; nothing was read past the count`,
-    { code: "BUDGET_EXCEEDED", category: "policy", operation: OP9, details, suggestedAction: `Narrow the dateWorked window (dateFrom/dateTo)${raise}.` }
+    midWalk ? `${OP8}: countOnly stopped at the ${budget}-call budget mid-walk: the walk needed more calls than the ${estimate} estimated from the ${total}-entry count (more entries than counted, or an extra page such as an empty continuation page), so the next call, which may be the closing re-count, did not fit; no partial total is returned` : `${OP8}: countOnly needs an estimated ${estimate} vendor calls for ${total} entries (1 count + 1 per ${PAGE} entries + 1 join per 250 + 1 re-count), over the ${budget}-call budget; nothing was read past the count`,
+    { code: "BUDGET_EXCEEDED", category: "policy", operation: OP8, details, suggestedAction: `Narrow the dateWorked window (dateFrom/dateTo)${raise}.` }
   );
 }
-async function countPostedState(http, filter, OP9, budget, window) {
+async function countPostedState(http, filter, OP8, budget, window) {
   let issued = 0;
   let estimate = 0;
   let counted = 0;
   const spend = () => {
-    if (issued >= budget) throw budgetExceeded(OP9, { estimate, budget, total: counted, issued }, true);
+    if (issued >= budget) throw budgetExceeded(OP8, { estimate, budget, total: counted, issued }, true);
     issued += 1;
   };
   spend();
   counted = unwrapQueryCount(
-    await http.request({ method: "POST", idempotent: true, path: "/V1.0/TimeEntries/query/count", body: { filter }, operation: OP9 }),
-    OP9
+    await http.request({ method: "POST", idempotent: true, path: "/V1.0/TimeEntries/query/count", body: { filter }, operation: OP8 }),
+    OP8
   );
   estimate = 1 + Math.max(1, Math.ceil(counted / PAGE)) + Math.ceil(counted / 250) + 1;
-  if (estimate > budget) throw budgetExceeded(OP9, { estimate, budget, total: counted, issued }, false);
+  if (estimate > budget) throw budgetExceeded(OP8, { estimate, budget, total: counted, issued }, false);
   const states = /* @__PURE__ */ new Map();
   let cursor = null;
   do {
@@ -24438,15 +24438,15 @@ async function countPostedState(http, filter, OP9, budget, window) {
       idempotent: true,
       path: cursor === null ? "/V1.0/TimeEntries/query" : entryCursorPath(http.baseUrl, cursor),
       body: { MaxRecords: PAGE, IncludeFields: ["id"], filter },
-      operation: OP9
+      operation: OP8
     });
     const page = unwrapItems(res);
-    const joined = await postedStateOf(http, page.items, OP9, spend);
+    const joined = await postedStateOf(http, page.items, OP8, spend);
     if (joined.incomplete) {
-      throw new AutotaskError(`${OP9}: countOnly refused: a billing-item join page was truncated (more than 500 billing items for 250 entries), so the posted split cannot be confirmed`, {
+      throw new AutotaskError(`${OP8}: countOnly refused: a billing-item join page was truncated (more than 500 billing items for 250 entries), so the posted split cannot be confirmed`, {
         code: "RESOLUTION_TRUNCATED",
         category: "resolution",
-        operation: OP9,
+        operation: OP8,
         details: { issued, budget },
         suggestedAction: "Narrow the dateWorked window, or page it with cursor (rows mode reports unconfirmed entries via hasMore)."
       });
@@ -24456,14 +24456,14 @@ async function countPostedState(http, filter, OP9, budget, window) {
   } while (cursor !== null);
   spend();
   const recounted = unwrapQueryCount(
-    await http.request({ method: "POST", idempotent: true, path: "/V1.0/TimeEntries/query/count", body: { filter }, operation: OP9 }),
-    OP9
+    await http.request({ method: "POST", idempotent: true, path: "/V1.0/TimeEntries/query/count", body: { filter }, operation: OP8 }),
+    OP8
   );
   if (states.size !== counted && states.size !== recounted) {
-    throw new AutotaskError(`${OP9}: countOnly read ${states.size} distinct entries but the window counted ${counted} before the walk and ${recounted} after it (a page repeated or dropped entries, or the window changed mid-walk); no total is returned. Retry the call`, {
+    throw new AutotaskError(`${OP8}: countOnly read ${states.size} distinct entries but the window counted ${counted} before the walk and ${recounted} after it (a page repeated or dropped entries, or the window changed mid-walk); no total is returned. Retry the call`, {
       code: "INVALID_RESPONSE",
       category: "server",
-      operation: OP9,
+      operation: OP8,
       details: { reason: "count_mismatch", streamed: states.size, counted, recounted, issued, budget },
       suggestedAction: "Retry the call; a window that changes during the walk can fail or pass depending on timing."
     });
@@ -24520,13 +24520,13 @@ async function postedStateQuery(_resource, mode, http, opts) {
   return { items, hasMore: read.hasMore || incomplete, window, nextCursor: read.nextCursor, unconfirmed, approvedCount, unapprovedCount: items.length - approvedCount };
 }
 async function postedWithin(_resource, from, to, http, opts, opLabel = "time_entries.postedWithin") {
-  const OP9 = opLabel;
-  const paging = pagingOpts(opts, OP9);
-  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 OP8 = opLabel;
+  const paging = pagingOpts(opts, OP8);
+  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);
   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(`${OP8}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP8 });
   }
   const windowToMs = toB.ms + DAY_MS2 - 1;
   const filter = [
@@ -24536,9 +24536,9 @@ 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 window = { from: iso2(fromB.ms), to: iso2(windowToMs) };
-  if (paging.countOnly) return countPostedState(http, filter, OP9, paging.budget, window);
-  const { items, hasMore, nextCursor } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP9, http, paging.cursor);
-  const { states, incomplete } = await postedStateOf(http, items, OP9);
+  if (paging.countOnly) return countPostedState(http, filter, OP8, paging.budget, window);
+  const { items, hasMore, nextCursor } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP8, http, paging.cursor);
+  const { states, incomplete } = await postedStateOf(http, items, OP8);
   let postedCount = 0;
   let unpostedCount = 0;
   for (const state of states.values()) {
@@ -25308,103 +25308,6 @@ async function approve(resource, id, opts = {}, http) {
   };
 }
 
-// src/resources/special/time_entries/recentTickets.ts
-var OP8 = "time_entries.recentTickets";
-var DAY_MS3 = 864e5;
-var TICKET_CHUNK = 100;
-var TICKET_FIELDS2 = ["id", "ticketNumber", "title", "status", "assignedResourceID", "companyID"];
-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(`${OP8}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP8 });
-  }
-  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 });
-  }
-  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);
-  if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP8}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`, { operation: OP8 });
-  }
-  const windowToMs = toB.ms + DAY_MS3 - 1;
-  const { items: entries, hasMore } = await queryTimeEntries(
-    _resource,
-    [
-      { field: "dateWorked", op: "gte", value: isoUtc(fromB.ms) },
-      { field: "dateWorked", op: "lte", value: isoUtc(windowToMs) },
-      { field: "resourceID", op: "eq", value: resourceID }
-    ],
-    clampWindowLimit(opts.limit),
-    OP8,
-    http
-  );
-  const groups = /* @__PURE__ */ new Map();
-  let entriesWithoutTicket = 0;
-  for (const e of entries) {
-    if (typeof e.ticketID !== "number") {
-      entriesWithoutTicket += 1;
-      continue;
-    }
-    const g = groups.get(e.ticketID) ?? { entryCount: 0, totalHours: 0, lastWorked: "" };
-    g.entryCount += 1;
-    g.totalHours += e.hoursWorked ?? 0;
-    if ((e.dateWorked ?? "") > g.lastWorked) g.lastWorked = e.dateWorked ?? "";
-    groups.set(e.ticketID, g);
-  }
-  const ids2 = [...groups.keys()];
-  const tickets = /* @__PURE__ */ new Map();
-  for (let c = 0; c < ids2.length; c += TICKET_CHUNK) {
-    const chunk = ids2.slice(c, c + TICKET_CHUNK);
-    const filter = [{ field: "id", op: "in", value: chunk }];
-    const res = await http.request({
-      method: "POST",
-      idempotent: true,
-      path: "/V1.0/Tickets/query",
-      body: { MaxRecords: TICKET_CHUNK, filter, IncludeFields: TICKET_FIELDS2 },
-      operation: OP8
-    });
-    for (const t of unwrapItems(res, OP8).items) if (typeof t.id === "number") tickets.set(t.id, t);
-  }
-  const items = [];
-  const unresolvedTicketIDs = [];
-  let excludedTickets = 0;
-  for (const [ticketID, g] of groups) {
-    const t = tickets.get(ticketID);
-    if (t === void 0) unresolvedTicketIDs.push(ticketID);
-    if (companyID !== void 0 && t?.companyID !== companyID) {
-      if (t !== void 0) excludedTickets += 1;
-      continue;
-    }
-    items.push({
-      ticketID,
-      ...t?.ticketNumber !== void 0 ? { ticketNumber: t.ticketNumber } : {},
-      ...t?.title !== void 0 ? { title: t.title } : {},
-      ...t?.status !== void 0 ? { status: t.status } : {},
-      ...t?.assignedResourceID !== void 0 ? { assignedResourceID: t.assignedResourceID } : {},
-      ...t?.companyID !== void 0 ? { companyID: t.companyID } : {},
-      entryCount: g.entryCount,
-      totalHours: Math.round(g.totalHours * 100) / 100,
-      lastWorked: g.lastWorked
-    });
-  }
-  items.sort((a, b) => a.lastWorked < b.lastWorked ? 1 : a.lastWorked > b.lastWorked ? -1 : a.ticketID - b.ticketID);
-  return {
-    items,
-    entriesRead: entries.length,
-    entriesWithoutTicket,
-    unresolvedTicketIDs,
-    ...companyID !== void 0 ? { excludedTickets } : {},
-    window: { from: isoUtc(fromB.ms), to: isoUtc(windowToMs) },
-    truncated: hasMore
-  };
-}
-
 // src/resources/time_entries.ts
 var TimeEntriesResource = class extends BaseResource {
   constructor(http, pageSize) {
@@ -25536,11 +25439,6 @@ var TimeEntriesResource = class extends BaseResource {
   postedWithin(from, to, opts) {
     return postedWithin(this, from, to, this.http, opts);
   }
-  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts).
-   * @deprecated Since 0.38.0, removed in the next minor. Use operations.aggregate(client, 'time_entries.query', [{ field: 'resourceID', op: 'eq', value: R }, { field: 'dateWorked', op: 'gte', value: FROM }, { field: 'dateWorked', op: 'lte', value: TO }], { groupBy: ['ticketID'], sum: ['hoursWorked'] }) — group keys carry ticketIDName; add { field: 'ticket.companyID', op: 'eq', value: C } to scope by company. */
-  recentTickets(from, to, opts) {
-    return recentTickets(this, from, to, this.http, opts);
-  }
   /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
   today(opts) {
     return windowQuery3(this, "today", this.http, opts);