node-autotask 0.39.0 → 0.39.1

package/dist/{chunk-LD5UPSDB.js → chunk-LDTJNLX7.js}

@@ -30,10 +30,10 @@ import {
   unwrapItems,
   unwrapOperation,
   vendorId
-} from "./chunk-FV5PJLIZ.js";
+} from "./chunk-LN3HQQBR.js";
 import {
   CAPABILITIES
-} from "./chunk-2KQS3RHQ.js";
+} from "./chunk-GDSCYY2G.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {

package/dist/{chunk-FV5PJLIZ.js → chunk-LN3HQQBR.js}

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-2KQS3RHQ.js";
+} from "./chunk-GDSCYY2G.js";
 import {
   wrapUntrusted
 } from "./chunk-5VHSLJMR.js";
@@ -20530,6 +20530,7 @@ var BaseResource = class extends MutationBase {
 
 // src/operations/compositeNames.ts
 var PICKLIST_VALUE_NOT_SERVED_NOTE = "The picklist is served to this API user, but this record's value is not in it (an inactive or unexposed value) \u2014 the label cannot be resolved and is null; refreshing the field catalog will not surface it. (A picklist the vendor does not expose at all is reported with the field-catalog honesty note instead.)";
+var PICKLIST_CATALOG_UNAVAILABLE_NOTE = "The field-catalog read that serves picklist labels failed for this call, so this label is unavailable (null), not absent: the value may well have one. Retry the call once the catalog read succeeds (see names.catalogError).";
 var DEFAULT_MAX_NAME_READS = 20;
 var TICKET_LABEL_FIELDS = ["status", "priority", "ticketType", "issueType", "subIssueType", "source", "queueID"];
 function isVendorId(value) {
@@ -20840,7 +20841,7 @@ async function resolveCompositeNames(http, plan, opts = {}) {
       }
       const hit = values.find((v) => String(v.value) === String(value));
       if (hit === void 0) {
-        section.reasons[field] = PICKLIST_VALUE_NOT_SERVED_NOTE;
+        if (String(value) !== "0") section.reasons[field] = PICKLIST_VALUE_NOT_SERVED_NOTE;
         return null;
       }
       return typeof hit.label === "string" ? hit.label : null;
@@ -20861,6 +20862,7 @@ function untrustedName(name) {
   const [[capped]] = truncateNoteChars([{ v: name }], LABEL_NAME_MAX_CHARS, ["v"]);
   return wrapUntrusted(capped.v) ?? capped.v;
 }
+var lastPicklists = /* @__PURE__ */ new WeakMap();
 function readNamesOpt(value, where) {
   if (value === void 0) return true;
   if (typeof value !== "boolean") {
@@ -20873,17 +20875,31 @@ async function labelRows(client, resourceKey, rows) {
   for (const row of rows) for (const k of Object.keys(row)) keys.add(k);
   if (keys.size === 0) return { rows: [...rows] };
   let picklistFields = [];
+  let unavailable = [];
+  let catalogError;
   const modelFields = MODEL_FIELD_SETS[resourceKey] ?? [];
   const candidates = [...keys].filter((f) => f !== "id" && modelFields.includes(f) && ROW_FK_TABLES[f] === void 0 && !isResourceFkField(f));
   if (candidates.length > 0) try {
     const catalog = await fieldCatalog(client, { resources: [resourceKey], labels: true });
-    const fields = catalog.rows.find((r) => r.resource === resourceKey)?.fields ?? [];
-    picklistFields = fields.filter((f) => f.isPickList && candidates.includes(f.name)).map((f) => f.name);
+    const row = catalog.rows.find((r) => r.resource === resourceKey);
+    const known = lastPicklists.get(client) ?? /* @__PURE__ */ new Map();
+    lastPicklists.set(client, known);
+    if (row?.fields === void 0) {
+      const last = known.get(resourceKey);
+      unavailable = (last ?? []).filter((f) => candidates.includes(f));
+      if (last === void 0 || unavailable.length > 0) {
+        catalogError = row?.error ?? { code: "INVALID_RESPONSE", message: `fieldCatalog: no ${resourceKey} row` };
+      }
+    } else {
+      const all = row.fields.filter((f) => f.isPickList).map((f) => f.name);
+      known.set(resourceKey, all);
+      picklistFields = all.filter((f) => candidates.includes(f));
+    }
   } catch (err) {
     if (!isAutotaskError(err) || err.code === "ABORTED") throw err;
   }
-  const labelled = (field) => picklistFields.includes(field) || ROW_FK_TABLES[field] !== void 0 || isResourceFkField(field);
-  if (![...keys].some(labelled)) return { rows: [...rows] };
+  const labelled = (field) => picklistFields.includes(field) || unavailable.includes(field) || ROW_FK_TABLES[field] !== void 0 || isResourceFkField(field);
+  if (catalogError === void 0 && ![...keys].some(labelled)) return { rows: [...rows] };
   const builder = createNamePlan(picklistFields, resourceKey);
   for (const row of rows) {
     for (const [field, value] of Object.entries(row)) {
@@ -20898,8 +20914,10 @@ async function labelRows(client, resourceKey, rows) {
   const out = rows.map((row) => {
     const r = { ...row };
     for (const [field, value] of Object.entries(row)) {
-      const set = value !== null && value !== void 0 && value !== 0 && value !== "0" && names !== void 0;
-      if (picklistFields.includes(field)) r[`${field}Label`] = set ? names.labelFor(field, value) : null;
+      const has2 = value !== null && value !== void 0 && names !== void 0;
+      if (picklistFields.includes(field)) r[`${field}Label`] = has2 ? names.labelFor(field, value) : null;
+      else if (unavailable.includes(field)) r[`${field}Label`] = null;
+      const set = has2 && value !== 0 && value !== "0";
       const table = ROW_FK_TABLES[field];
       if (table !== void 0) r[`${field}Name`] = set && isVendorId(value) ? untrustedName(names.recordName(table, value)) : null;
       else if (isResourceFkField(field)) r[`${field}Name`] = set && isVendorId(value) ? untrustedName(names.resourceName(value)) : null;
@@ -20907,16 +20925,28 @@ async function labelRows(client, resourceKey, rows) {
     if (r["assignedResourceIDName"] !== void 0) r["assignedResourceName"] = r["assignedResourceIDName"];
     return r;
   });
-  if (names === void 0) return { rows: out };
-  const capped = Object.values(names.section.rows).filter((row) => row.capped).length;
-  const reasons = names.section.reasons;
-  if (capped === 0 && Object.keys(reasons).length === 0) return { rows: out };
+  const capped = names === void 0 ? 0 : Object.values(names.section.rows).filter((row) => row.capped).length;
+  const unresolved = Object.keys(names?.section.reasons ?? {});
+  const reasons = { ...names?.section.reasons };
+  for (const f of unavailable) reasons[f] = PICKLIST_CATALOG_UNAVAILABLE_NOTE;
+  if (capped === 0 && unresolved.length === 0 && catalogError === void 0) return { rows: out };
   const parts = [];
   if (capped > 0) parts.push(`${capped} id(s) left unlabelled (their *Name is null): the per-call cap of ${DEFAULT_MAX_NAME_READS} uncached name reads was hit \u2014 names already read are cached, so repeating or narrowing the call labels more`);
-  if (Object.keys(reasons).length > 0) parts.push(`picklist label(s) unavailable for ${Object.keys(reasons).join(", ")} (see reasons)`);
+  if (unresolved.length > 0) parts.push(`picklist label(s) unavailable for ${unresolved.join(", ")} (see reasons)`);
+  if (catalogError !== void 0) {
+    parts.push(
+      `the ${resourceKey} field catalog read failed (${catalogError.code}), so picklist labels are unavailable for this call, not absent: ` + (unavailable.length > 0 ? `the *Label is null for ${unavailable.join(", ")}` : "no *Label sibling was added (the picklist fields are unknown until a catalog read succeeds)") + " \u2014 retry the call to label them"
+    );
+  }
   return {
     rows: out,
-    names: { truncated: capped > 0, capped, note: parts.join("; "), ...Object.keys(reasons).length > 0 ? { reasons } : {} }
+    names: {
+      truncated: capped > 0,
+      capped,
+      note: parts.join("; "),
+      ...Object.keys(reasons).length > 0 ? { reasons } : {},
+      ...catalogError !== void 0 ? { catalogError } : {}
+    }
   };
 }
 async function labelFetchResults(client, result) {
@@ -20935,11 +20965,13 @@ async function labelFetchResults(client, result) {
   }
   if (summaries.length === 0) return { ...result, results };
   const reasons = Object.assign({}, ...summaries.map((s) => s.reasons ?? {}));
+  const catalogError = summaries.find((s) => s.catalogError !== void 0)?.catalogError;
   const names = {
     truncated: summaries.some((s) => s.truncated),
     capped: summaries.reduce((n, s) => n + s.capped, 0),
     note: summaries.map((s) => s.note).join("; "),
-    ...Object.keys(reasons).length > 0 ? { reasons } : {}
+    ...Object.keys(reasons).length > 0 ? { reasons } : {},
+    ...catalogError !== void 0 ? { catalogError } : {}
   };
   return { ...result, results, names };
 }
@@ -26608,6 +26640,7 @@ export {
   MIN_FIELD_CATALOG_MAX_BYTES,
   fieldCatalog,
   PICKLIST_VALUE_NOT_SERVED_NOTE,
+  PICKLIST_CATALOG_UNAVAILABLE_NOTE,
   TICKET_LABEL_FIELDS,
   createNamePlan,
   addNameSibling,