node-autotask 0.31.0 → 0.32.0

package/dist/{chunk-6UA544OR.js → chunk-FVHPN7ZR.js}

@@ -40,10 +40,10 @@ import {
   unwrapItems,
   unwrapOperation,
   vendorId
-} from "./chunk-INSFDXHP.js";
+} from "./chunk-R6HLJCI2.js";
 import {
   CAPABILITIES
-} from "./chunk-EPOHRNSX.js";
+} from "./chunk-M2EGFPGF.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -446,7 +446,7 @@ function dateOnlyWindowBounds(kind, now, tz) {
 }
 async function dateWindowQuery(http, path, field, kind, limit, operation, now, tz) {
   const zone = tz === void 0 ? void 0 : validateZone(tz, operation);
-  const { from, to } = dateWindowBounds(kind, now, zone);
+  const { from, to } = dateOnlyWindowBounds(kind, now, zone);
   const filter = [
     { field, op: "gte", value: from },
     { field, op: "lte", value: to }
@@ -484,15 +484,16 @@ function customRangeDay(value, label, zone, opName) {
   return { y, mo, d, ms };
 }
 async function customRangeQuery(http, path, field, from, to, limit, operation, zone) {
-  const fromB = customRangeDay(from, "from", zone, operation);
-  const toB = customRangeDay(to, "to", zone, operation);
+  if (zone !== void 0) validateZone(zone, operation);
+  const fromB = customRangeDay(from, "from", void 0, operation);
+  const toB = customRangeDay(to, "to", void 0, operation);
   if (fromB.ms > toB.ms) {
     throw new AutotaskConfigError(
       `${operation}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`,
       { operation }
     );
   }
-  const toEndMs = zone === void 0 ? toB.ms + DAY_MS - 1 : localDayEndMs(toB.y, toB.mo, toB.d, zone);
+  const toEndMs = toB.ms + DAY_MS - 1;
   const filter = [
     { field, op: "gte", value: isoUtc(fromB.ms) },
     { field, op: "lte", value: isoUtc(toEndMs) }
@@ -12575,6 +12576,33 @@ var TicketWebhooksResource = class extends BaseResource {
   }
 };
 
+// src/resources/special/time_entries/posted.ts
+var isApproved = (entry) => typeof entry.billingApprovalDateTime === "string" && entry.billingApprovalDateTime.trim() !== "";
+async function postedStateOf(http, entries, op) {
+  const states = /* @__PURE__ */ new Map();
+  const ids2 = [...new Set(entries.map((e) => e.id))];
+  let incomplete = false;
+  for (let c = 0; c < ids2.length; c += FETCH_BY_IDS_CHUNK_SIZE) {
+    const chunk = ids2.slice(c, c + FETCH_BY_IDS_CHUNK_SIZE);
+    const res = await http.request({
+      method: "POST",
+      idempotent: true,
+      path: "/V1.0/BillingItems/query",
+      body: { MaxRecords: 500, IncludeFields: ["id", "timeEntryID"], filter: [{ field: "timeEntryID", op: "in", value: chunk }] },
+      operation: op
+    });
+    const { items, pageDetails } = unwrapItems(res);
+    const billed = new Set(items.map((i) => i.timeEntryID));
+    const more = pageDetails.nextPageUrl != null;
+    if (more) incomplete = true;
+    for (const id of chunk) {
+      if (billed.has(id)) states.set(id, "posted");
+      else if (!more) states.set(id, "unposted");
+    }
+  }
+  return { states, incomplete };
+}
+
 // src/resources/special/time_entries/windows.ts
 var DAY_MS2 = 864e5;
 var iso2 = (ms) => new Date(ms).toISOString().slice(0, 19) + "Z";
@@ -12615,14 +12643,23 @@ async function customRange3(_resource, from, to, http, opts) {
   const { items } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), "time_entries.customRange", http);
   return items;
 }
-async function postedDateStatusQuery(_resource, mode, http, opts) {
-  const filter = [
-    { field: "postedDate", op: mode === "posted" ? "exist" : "notExist" }
-  ];
-  if (opts?.ticketID !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
+async function postedStateQuery(_resource, mode, http, opts) {
   const operation = mode === "posted" ? "time_entries.getPosted" : "time_entries.getUnposted";
-  const { items } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), operation, http);
-  return items;
+  const window = { from: null, to: null };
+  const filter = [];
+  const fromB = opts?.dateFrom === void 0 ? void 0 : customRangeDay(opts.dateFrom, "from", void 0, operation);
+  const toB = opts?.dateTo === void 0 ? void 0 : customRangeDay(opts.dateTo, "to", void 0, operation);
+  if (fromB && toB && fromB.ms > toB.ms) {
+    throw new AutotaskConfigError(`${operation}: dateFrom (${iso2(fromB.ms)}) must not be after dateTo (${iso2(toB.ms)})`, { operation });
+  }
+  if (fromB) filter.push({ field: "dateWorked", op: "gte", value: window.from = iso2(fromB.ms) });
+  if (toB) filter.push({ field: "dateWorked", op: "lte", value: window.to = iso2(toB.ms + DAY_MS2 - 1) });
+  if (opts?.ticketID !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
+  const read = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), operation, http);
+  const { states, incomplete } = await postedStateOf(http, read.items, operation);
+  const items = read.items.filter((e) => states.get(e.id) === mode);
+  const approvedCount = items.filter(isApproved).length;
+  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;
@@ -12637,26 +12674,25 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
     { field: "dateWorked", op: "gte", value: iso2(fromB.ms) },
     { field: "dateWorked", op: "lte", value: iso2(windowToMs) }
   ];
-  if (opts?.posted === true) filter.push({ field: "postedDate", op: "exist" });
-  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), OP11, http);
+  const { states, incomplete } = await postedStateOf(http, items, OP11);
   let postedCount = 0;
-  for (const item of items) {
-    const postedDate = item.postedDate;
-    if (typeof postedDate === "string" ? postedDate.trim() !== "" : postedDate !== null && postedDate !== void 0) {
-      postedCount += 1;
-    }
+  let unpostedCount = 0;
+  for (const state of states.values()) {
+    if (state === "posted") postedCount += 1;
+    else unpostedCount += 1;
   }
+  const keep = opts?.posted === void 0 ? void 0 : opts.posted ? "posted" : "unposted";
   return {
-    items,
+    items: keep === void 0 ? items : items.filter((e) => states.get(e.id) === keep),
     postedCount,
-    unpostedCount: items.length - postedCount,
+    unpostedCount,
     window: { from: iso2(fromB.ms), to: iso2(windowToMs) },
     // A live next-page cursor past the bounded read: the counts above cover
     // the returned rows ONLY when this is true (issue #66 AC1 — the 500-row cap case is the general case).
-    truncated: hasMore
+    truncated: hasMore || incomplete
   };
 }
 async function dateWorkedWindow(resource, from, to, http, opts) {
@@ -13411,11 +13447,11 @@ var TimeEntriesResource = class extends BaseResource {
   }
   /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
   getPosted(opts) {
-    return postedDateStatusQuery(this, "posted", this.http, opts);
+    return postedStateQuery(this, "posted", this.http, opts);
   }
   /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
   getUnposted(opts) {
-    return postedDateStatusQuery(this, "unposted", this.http, opts);
+    return postedStateQuery(this, "unposted", this.http, opts);
   }
   /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
   last14(opts) {

package/dist/{chunk-PCLL536B.cjs → chunk-IKPFR6K2.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8;
 
-var _chunkQXUN2VCJcjs = require('./chunk-QXUN2VCJ.cjs');
+var _chunkDCTHO7CQcjs = require('./chunk-DCTHO7CQ.cjs');
 
 // src/auth.ts
 var AUTH_HEADERS = {
@@ -10863,8 +10863,8 @@ var EMPTY_REASON_STAMPS = {
 var POINTER_NOTES = {
   "ticket_history.query": `W1 (ww29 (australia-nz) live 2026-10-04; vendor contract change live-verified 2026-10-06): the vendor requires ticket_history.query to be supplied with exactly ONE ticketID-equals filter \u2014 an unfiltered call 500s by contract (10-06 text: "When querying the TicketHistory entity you are required to supply one and only one ticketID equals filter"). WITH the filter the query WORKS (live 2026-10-06: rows returned, hasMore true \u2014 a single {op:'eq', field:'ticketID', value:<id>} condition; the filter vocabulary is eq/noteq/gt/gte/lt/lte/beginsWith/endsWith/contains/exist/notExist/in/notIn/and/or). tickets.timeline / tickets.fullContext remain the convenient composites; raw history rows come from the filtered query.`,
   "time_entries.create": `W-A3 (ww29 (australia-nz) live 2026-10-04; re-walled 2026-10-06; scope re-stamped 2026-10-21): for a time_entries.create whose (resourceID, roleID) pair selects the API-only user's own resource, the vendor refused with "API-only user cannot be selected for this field" (10-04 text: "The specified AssignedResourceID and AssignedRoleID combination is not currently defined"). This is a (resource, role) pair wall, NOT a blanket refusal of time-entry writes: live time_entries.create calls succeeded on 2026-10-21 (pair not recorded; two entries created, read back, 1.0 h total). The authorised pair set has NOT been re-adjudicated by a live probe; if a create fails with the pair-validation text, check the resource's role authorisation (whoAmI / the resource record) and try another pair. createForResource's 10-06 wall is likewise unconfirmed for other pairs. Working reads remain postedWithin / the window helpers (W-D3 pointer note).`,
-  "time_entries.getPosted": "W-D3 (ww29 (australia-nz) live 2026-10-04, re-verified live 2026-10-15): this zone's TimeEntry entity exposes NO posted-state filter field \u2014 the vendor rejects postingStatus, postedDate and status with \"Unable to find X in the TimeEntry Entity\" (live field-existence oracle 2026-10-04: only dateWorked / resourceID / ticketID / taskID resolve as filter fields). Re-probed 2026-10-15 (ww29 re-probe campaign): time_entries.getPosted live 500, vendor body verbatim 'Unable to find postedDate in the TimeEntry Entity.' \u2014 a vendor endpoint defect on AU03, not a transient fault: posted cannot be filtered server-side on this zone \u2014 use time_entries.postedWithin (the dateWorked window, live-verified working \u2014 omit the `posted` narrowing on this zone: it sends postedDate, which the zone 500s) or read time_entries.query and derive posted-state from the fields your zone's entity exposes",
-  "time_entries.getUnposted": "W-D3 (ww29 (australia-nz) live 2026-10-04, re-verified live 2026-10-15): this zone's TimeEntry entity exposes NO posted-state filter field \u2014 the vendor rejects postingStatus, postedDate and status with \"Unable to find X in the TimeEntry Entity\" (live field-existence oracle 2026-10-04: only dateWorked / resourceID / ticketID / taskID resolve as filter fields). Re-probed 2026-10-15 (ww29 re-probe campaign): time_entries.getUnposted live 500, vendor body verbatim 'Unable to find postedDate in the TimeEntry Entity.' \u2014 a vendor endpoint defect on AU03, not a transient fault: unposted cannot be filtered server-side on this zone \u2014 use time_entries.postedWithin (the dateWorked window, live-verified working \u2014 omit the `posted` narrowing on this zone: it sends postedDate, which the zone 500s) or read time_entries.query and derive posted-state from the fields your zone's entity exposes",
+  "time_entries.getPosted": `W-D3 (ww29 (australia-nz) live 2026-10-04, re-verified live 2026-10-27): this zone's TimeEntry entity exposes NO posted-state field \u2014 reads carry no postedDate/postedOnTime and a postedDate exist/notExist filter fails with SERVER_ERROR "Unable to find postedDate in the TimeEntry Entity". time_entries.getPosted therefore no longer sends any postedDate condition: posted state is derived from billing_items.timeEntryID (an entry is posted when a billing item references it, whether or not billingApprovalDateTime is set \u2014 ww29 never populates it). If a call still fails, the fault is NOT the old postedDate wall: it is a billing_items join/read fault (typed error \u2014 429 RATE_LIMITED included \u2014 propagates, no partial result). The dateWorked window reads time_entries.postedWithin / time_entries.dateWorkedWindow use the same derivation.`,
+  "time_entries.getUnposted": `W-D3 (ww29 (australia-nz) live 2026-10-04, re-verified live 2026-10-27): this zone's TimeEntry entity exposes NO posted-state field \u2014 reads carry no postedDate/postedOnTime and a postedDate exist/notExist filter fails with SERVER_ERROR "Unable to find postedDate in the TimeEntry Entity". time_entries.getUnposted therefore no longer sends any postedDate condition: unposted state is derived from billing_items.timeEntryID (an entry is posted when a billing item references it, whether or not billingApprovalDateTime is set \u2014 ww29 never populates it). If a call still fails, the fault is NOT the old postedDate wall: it is a billing_items join/read fault (typed error \u2014 429 RATE_LIMITED included \u2014 propagates, no partial result). The dateWorked window reads time_entries.postedWithin / time_entries.dateWorkedWindow use the same derivation.`,
   "authenticate.get": "W2: authenticate.get is DESIGNATOR-ONLY \u2014 it returns the designator identity, not a tenant data surface; a miss/empty here is not a data-empty signal (no emptyReason is attached by design \u2014 a false reason would be worse than none)"
 };
 var BLIND_SURFACE_INVENTORY = {
@@ -17031,7 +17031,7 @@ function buildEntityTypeMap() {
 }
 var ENTITY_TYPE_TO_RESOURCE = buildEntityTypeMap();
 var ENUMERABLE_RESOURCES = new Set(
-  _chunkQXUN2VCJcjs.CAPABILITIES.filter((rec) => rec.resource !== "operations" && (rec.operation === "query" || rec.operation === "get")).map(
+  _chunkDCTHO7CQcjs.CAPABILITIES.filter((rec) => rec.resource !== "operations" && (rec.operation === "query" || rec.operation === "get")).map(
     (rec) => rec.resource
   )
 );
@@ -17108,7 +17108,7 @@ function capabilitySets() {
   const fieldOps = /* @__PURE__ */ new Map();
   const udfOps = /* @__PURE__ */ new Map();
   const resources = /* @__PURE__ */ new Set();
-  for (const rec of _chunkQXUN2VCJcjs.CAPABILITIES) {
+  for (const rec of _chunkDCTHO7CQcjs.CAPABILITIES) {
     if (rec.resource === "operations") continue;
     resources.add(rec.resource);
     if (rec.operation === "getFieldInfo") fieldOps.set(rec.resource, rec);
@@ -17120,7 +17120,7 @@ var derivedIndex = null;
 function derivedFieldsFor(resource) {
   if (derivedIndex === null) {
     derivedIndex = /* @__PURE__ */ new Map();
-    for (const rec of _chunkQXUN2VCJcjs.CAPABILITIES) {
+    for (const rec of _chunkDCTHO7CQcjs.CAPABILITIES) {
       const declared = _optionalChain([rec, 'access', _127 => _127.metadata, 'optionalAccess', _128 => _128.derivedFields]);
       if (!Array.isArray(declared) || derivedIndex.has(rec.resource)) continue;
       const rows = [];