node-autotask 0.9.0 → 0.11.0

package/dist/{chunk-UYJ5V262.js → chunk-CJONZQ7E.js}

@@ -4,34 +4,36 @@ import {
   BLIND_SURFACE_STAMPS,
   BaseResource,
   ConflictError,
-  FIELD_CATALOG_HONESTY_NOTE,
   NotFoundError,
   RELATIONSHIP_MAP,
   ResolutionError,
   StaleObjectError,
+  TICKET_LABEL_FIELDS,
   UNTRUSTED_FIELDS_BY_RESOURCE,
+  addLabelSibling,
+  addNameSibling,
   blindStampFor,
   buildDryRunResult,
   buildFilter,
   clampPageSize,
+  createNamePlan,
   cursorToPath,
   decodeFileData,
-  expandResourceNames,
-  fieldCatalog,
   formatVendorDetail,
   isAutotaskError,
   mergePartialBody,
   parseIdentifier,
   parseVendorErrors,
+  resolveCompositeNames,
   resolveFieldsPreset,
   truncateNoteChars,
   unwrapItem,
   unwrapItems,
   unwrapOperation
-} from "./chunk-UDWV4VVD.js";
+} from "./chunk-LNRN45XS.js";
 import {
   CAPABILITIES
-} from "./chunk-BZPFDRAE.js";
+} from "./chunk-7L23FDQW.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -820,181 +822,6 @@ var ClassificationIconsResource = class extends BaseResource {
   }
 };
 
-// src/operations/compositeNames.ts
-var DEFAULT_MAX_NAME_READS = 20;
-var TICKET_LABEL_FIELDS = ["status", "priority", "ticketType", "issueType", "subIssueType", "source", "queueID"];
-function isVendorId(value) {
-  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 0;
-  if (typeof value === "string") return /^\d+$/.test(value);
-  return false;
-}
-function createNamePlan(labelFields = []) {
-  const resourceIds = [];
-  const resSeen = /* @__PURE__ */ new Set();
-  const recordFks = [];
-  const fkSeen = /* @__PURE__ */ new Set();
-  return {
-    plan: () => ({ resourceIds, recordFks, labelFields }),
-    addResource: (value) => {
-      if (!isVendorId(value)) return;
-      const k = String(value);
-      if (!resSeen.has(k)) {
-        resSeen.add(k);
-        resourceIds.push(value);
-      }
-    },
-    addFk: (table, value) => {
-      if (!isVendorId(value)) return;
-      const k = `${table}:${String(value)}`;
-      if (!fkSeen.has(k)) {
-        fkSeen.add(k);
-        recordFks.push({ table, id: value });
-      }
-    }
-  };
-}
-function addNameSibling(row, field, resolve) {
-  const value = row[field];
-  if (value === void 0) return;
-  row[`${field}Name`] = isVendorId(value) ? resolve(value) : null;
-}
-function addLabelSibling(row, field, names) {
-  const value = row[field];
-  if (value === void 0) return;
-  row[`${field}Label`] = names.labelFor(field, value);
-}
-var FK_TABLE_PATH = {
-  role: "/V1.0/Roles",
-  billingCode: "/V1.0/BillingCodes",
-  contract: "/V1.0/Contracts"
-};
-var FK_NAME_FIELD = {
-  role: "name",
-  billingCode: "name",
-  contract: "contractName"
-};
-function fkName(record, table) {
-  const value = record[FK_NAME_FIELD[table]];
-  return typeof value === "string" && value.trim() !== "" ? value : null;
-}
-function faultRow(err) {
-  const e = err;
-  return e.httpStatus !== void 0 ? { code: e.code, message: e.message, httpStatus: e.httpStatus } : { code: e.code, message: e.message };
-}
-async function resolveCompositeNames(http, plan, opts = {}) {
-  if (opts.maxNameReads !== void 0 && (!Number.isInteger(opts.maxNameReads) || opts.maxNameReads < 1)) {
-    throw new AutotaskConfigError(`composite names: maxNameReads must be an integer >= 1 (got ${String(opts.maxNameReads)})`);
-  }
-  const budget = Math.min(DEFAULT_MAX_NAME_READS, opts.maxNameReads ?? DEFAULT_MAX_NAME_READS);
-  const client = http.client;
-  if (client === void 0) {
-    throw new AutotaskConfigError("composite names: the transport is not wired to an AutotaskClient (the composite must run through the client)");
-  }
-  const readCache = http.readCache;
-  const nameCache = http.resourceNameCache;
-  const section = { truncated: false, rows: {}, reasons: {} };
-  let remaining = budget;
-  const coldResource = [];
-  for (const id of plan.resourceIds) {
-    if (nameCache !== void 0 && nameCache.get(id) !== void 0) continue;
-    if (readCache !== void 0 && readCache.get(`/V1.0/Resources/${id}`) !== void 0) continue;
-    coldResource.push(id);
-  }
-  const withinBudget = coldResource.slice(0, remaining);
-  const overBudgetResource = coldResource.slice(remaining);
-  remaining -= withinBudget.length;
-  for (const id of overBudgetResource) {
-    section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
-    section.truncated = true;
-  }
-  const overSet = new Set(overBudgetResource.map((id) => String(id)));
-  const opIds = plan.resourceIds.filter((id) => !overSet.has(String(id)));
-  if (opIds.length > 0) {
-    let pass = opIds;
-    if (pass.length > 500) {
-      for (const id of pass.slice(500)) {
-        section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
-        section.truncated = true;
-      }
-      pass = pass.slice(0, 500);
-    }
-    const res = await expandResourceNames(client, pass);
-    for (const r of res.results) {
-      const row = { name: r.name, blind: r.blind, capped: false };
-      if (r.error !== void 0) row.error = faultRow(r.error);
-      section.rows[`resource:${r.id}`] = row;
-    }
-  }
-  const holders = {
-    role: client.roles,
-    billingCode: client.billingCodes,
-    contract: client.contracts
-  };
-  for (const fk of plan.recordFks) {
-    const key = `${fk.table}:${fk.id}`;
-    const cold = readCache === void 0 || readCache.get(`${FK_TABLE_PATH[fk.table]}/${fk.id}`) === void 0;
-    if (cold) {
-      if (remaining < 1) {
-        section.rows[key] = { name: null, blind: false, capped: true };
-        section.truncated = true;
-        continue;
-      }
-      remaining -= 1;
-    }
-    try {
-      const record = await holders[fk.table].get(fk.id);
-      section.rows[key] = { name: fkName(record, fk.table), blind: false, capped: false };
-    } catch (err) {
-      if (err instanceof NotFoundError) {
-        section.rows[key] = { name: null, blind: true, capped: false };
-      } else if (isAutotaskError(err) && err.code !== "ABORTED") {
-        section.rows[key] = { name: null, blind: false, capped: false, error: faultRow(err) };
-      } else {
-        throw err;
-      }
-    }
-  }
-  const picklists = {};
-  if (plan.labelFields.length > 0) {
-    let usable = true;
-    try {
-      const catalog = await fieldCatalog(client, { resources: ["tickets"], labels: true, fields: [...plan.labelFields] });
-      const row = catalog.rows.find((r) => r.resource === "tickets");
-      if (row === void 0 || row.error !== null || row.fields === void 0) {
-        usable = false;
-      } else {
-        for (const f of plan.labelFields) {
-          const frow = row.fields.find((x) => x.name === f);
-          picklists[f] = frow?.picklistValues;
-        }
-      }
-    } catch (err) {
-      if (isAutotaskError(err) && err.code !== "ABORTED") usable = false;
-      else throw err;
-    }
-    if (!usable) for (const f of plan.labelFields) section.reasons[f] = FIELD_CATALOG_HONESTY_NOTE;
-  }
-  return {
-    section,
-    resourceName: (id) => section.rows[`resource:${id}`]?.name ?? null,
-    recordName: (table, id) => section.rows[`${table}:${id}`]?.name ?? null,
-    labelFor: (field, value) => {
-      if (value === null || value === void 0) return null;
-      const values = picklists[field];
-      if (values === void 0) {
-        section.reasons[field] = FIELD_CATALOG_HONESTY_NOTE;
-        return null;
-      }
-      const hit = values.find((v) => String(v.value) === String(value));
-      if (hit === void 0) {
-        section.reasons[field] = FIELD_CATALOG_HONESTY_NOTE;
-        return null;
-      }
-      return typeof hit.label === "string" ? hit.label : null;
-    }
-  };
-}
-
 // src/resources/special/companies.ts
 var DEFAULT_LIMIT2 = 25;
 var MAX_LIMIT2 = 500;
@@ -1092,6 +919,22 @@ async function familyChildPage(http, parentID) {
   const { items, pageDetails } = unwrapItems(res, "companies.search");
   return { rows: items, hasNext: pageDetails.nextPageUrl !== null };
 }
+function assertSearchWithDetailOpts(opts) {
+  if (opts === void 0) return;
+  if (typeof opts !== "object" || opts === null || Array.isArray(opts)) {
+    throw new AutotaskConfigError("companies.searchWithDetail: opts must be an object { limit?: number }", {
+      operation: "companies.searchWithDetail"
+    });
+  }
+  for (const key of Object.keys(opts)) {
+    if (key !== "limit") {
+      throw new AutotaskConfigError(
+        `companies.searchWithDetail: unknown opts key "${key}" \u2014 the bag is closed: limit (includeFamily is a companies.search option)`,
+        { operation: "companies.searchWithDetail" }
+      );
+    }
+  }
+}
 async function searchWithFamily(_resource, query, opts = {}, http) {
   if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
     throw new AutotaskConfigError("companies.search: opts must be an object { limit?: number, includeFamily?: boolean }");
@@ -1640,7 +1483,8 @@ async function unbilledWork(resource, companyId, opts = {}, http) {
       capped: false,
       hasMore: false,
       status: "skipped",
-      note: "skipped: the company (set) has no tickets or tasks in the returned join set \u2014 no tasks/tickets to join against is NOT evidence of no time entries (zero wire)"
+      // joinNotes ride the skipped part too: an empty join set from a PARTIAL read (e.g. a full projects page) is not a true zero
+      note: ["skipped: the company (set) has no tickets or tasks in the returned join set \u2014 no tasks/tickets to join against is NOT evidence of no time entries (zero wire)", ...joinNotes].join(" | ")
     };
   } else {
     const timeConditions = taskCap.ids.length > 0 && ticketCap.ids.length > 0 ? [{ op: "or", items: [{ field: "taskID", op: "in", value: taskCap.ids }, { field: "ticketID", op: "in", value: ticketCap.ids }] }] : taskCap.ids.length > 0 ? [{ field: "taskID", op: "in", value: taskCap.ids }] : [{ field: "ticketID", op: "in", value: ticketCap.ids }];
@@ -1833,6 +1677,13 @@ var CompaniesResource = class extends BaseResource {
   async search(query, opts) {
     return searchWithFamily(this, query, opts, this.http);
   }
+  /** `search` with an empty result explained. Same closed opts discipline as `search`: only `limit` is
+   * accepted here (an unknown key is refused pre-request, zero wire — never silently dropped); the
+   * family block is a `search`-only option. */
+  async searchWithDetail(query, opts = {}) {
+    assertSearchWithDetailOpts(opts);
+    return super.searchWithDetail(query, opts);
+  }
   /** Get the Company with its primary context records in one call (each part a single-record
    * fetch; no sub-lists; absent/dangling references come back null). */
   async getContext(id) {
@@ -11082,4 +10933,3 @@ export {
   VersionResource,
   ZoneInformationResource
 };
-//# sourceMappingURL=chunk-UYJ5V262.js.map

package/dist/chunk-FLB2X6O5.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/chunk-IDPB4N2Q.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/{chunk-UDWV4VVD.js → chunk-LNRN45XS.js}

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-BZPFDRAE.js";
+} from "./chunk-7L23FDQW.js";
 
 // src/auth.ts
 var AUTH_HEADERS = {
@@ -349,14 +349,15 @@ var QueryTooLongError = class extends AutotaskError {
     this.name = "QueryTooLongError";
   }
 };
-var MISSING_REQUIRED_FIELD = /^Missing Required Field:\s*([A-Za-z_][A-Za-z0-9_]*)/;
+var MISSING_REQUIRED_FIELD = /Missing Required Field:\s*([A-Za-z_][A-Za-z0-9_]*)/;
+var VALUE_DOES_NOT_EXIST_FOR_FIELD = /Value does not exist for the required field\s+([A-Za-z_][A-Za-z0-9_]*)/;
 function parseVendorErrors(body) {
   if (!isRecord(body) || !Array.isArray(body.errors)) return void 0;
   const out = [];
   for (const entry of body.errors) {
     if (typeof entry === "string") {
       const item2 = { message: entry };
-      const m = MISSING_REQUIRED_FIELD.exec(entry);
+      const m = MISSING_REQUIRED_FIELD.exec(entry) ?? VALUE_DOES_NOT_EXIST_FOR_FIELD.exec(entry);
       if (m) item2.field = m[1];
       out.push(item2);
       continue;
@@ -372,7 +373,11 @@ function parseVendorErrors(body) {
   }
   return out;
 }
-var DETERMINISTIC_VENDOR_500_PHRASES = [/exceeds maximum length/i];
+var DETERMINISTIC_VENDOR_500_PHRASES = [
+  /exceeds maximum length/i,
+  /Missing Required Field/i,
+  /Value does not exist for the required field/i
+];
 function isDeterministicVendor500(entries) {
   if (entries === void 0) return false;
   return entries.some(
@@ -2621,16 +2626,20 @@ var RELATIONSHIP_MAP = {
         "liveProvenPrefix": [
           "endDateTime",
           "actionType",
-          "startDateTime"
+          "startDateTime",
+          "assignedResourceID"
         ],
-        "unproven": true,
+        "unproven": false,
         "blocker": {
-          "kind": "unknown",
-          "message": "create refused (stage-11 apply-matrix, marker FULL100W-1791110339): the final vendor response is preserved verbatim in vendorEvidence (the campaign artifact; its 300-char detail truncation is as recorded on disk)",
-          "remedy": "the wall is opaque in the campaign record \u2014 inspect vendorEvidence for the exact vendor text, re-run the create with a live probe (dry-run first), and adjudicate against the vendored spec before retrying."
+          "kind": "delete-absent",
+          "message": 'create succeeded live (DG-1 verification, 2026-10-11, ww29, parent company 29683380, record id 30230658, marker name "node-autotask DG-1 create probe") once the four vendor-required body fields were present \u2014 actionType, assignedResourceID, startDateTime, endDateTime \u2014 plus the parent companyID in the path. The vendor reports a missing required field as HTTP 500 SERVER_ERROR naming the field; it is a deterministic rejection, not a transient fault (the SDK now answers retryable: false \u2014 add the field, do not retry). The vendor defines no DELETE endpoint for this resource (W-A1) \u2014 the record is residue; cleanup is UI-only.',
+          "remedy": "provision via the API as proven: send actionType (picklist, e.g. 3 = Note: General), assignedResourceID (a resource id), startDateTime and endDateTime (UTC ISO) in the body and the company id as the parent; name and note are optional content fields. Clean up the residue record in the Autotask UI (the marker name is the lookup handle) \u2014 there is no API delete path."
         },
         "vendorEvidence": [
-          '{"error":true,"code":"SERVER_ERROR","category":"server","retryable":true,"httpStatus":500,"operation":"company_notes.create","suggestedAction":"Retry with backoff; the server error is transient.","correlationId":"7ef594cb-74dd-4a29-a7f7-2a5d5eb515f0","message":"Value does not exist for the required '
+          `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'assignedResourceID': Value does not exist for the required field assignedResourceID. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`,
+          `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'actionType': Missing Required Field: actionType. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`,
+          `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'endDateTime': Missing Required Field: endDateTime. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`,
+          `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'startDateTime': Missing Required Field: startDateTime. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`
         ],
         "deleteBoundary": {
           "available": false,
@@ -11940,16 +11949,20 @@ var CREATE_GUIDANCE = {
       "liveProvenPrefix": [
         "endDateTime",
         "actionType",
-        "startDateTime"
+        "startDateTime",
+        "assignedResourceID"
       ],
-      "unproven": true,
+      "unproven": false,
       "blocker": {
-        "kind": "unknown",
-        "message": "create refused (stage-11 apply-matrix, marker FULL100W-1791110339): the final vendor response is preserved verbatim in vendorEvidence (the campaign artifact; its 300-char detail truncation is as recorded on disk)",
-        "remedy": "the wall is opaque in the campaign record \u2014 inspect vendorEvidence for the exact vendor text, re-run the create with a live probe (dry-run first), and adjudicate against the vendored spec before retrying."
+        "kind": "delete-absent",
+        "message": 'create succeeded live (DG-1 verification, 2026-10-11, ww29, parent company 29683380, record id 30230658, marker name "node-autotask DG-1 create probe") once the four vendor-required body fields were present \u2014 actionType, assignedResourceID, startDateTime, endDateTime \u2014 plus the parent companyID in the path. The vendor reports a missing required field as HTTP 500 SERVER_ERROR naming the field; it is a deterministic rejection, not a transient fault (the SDK now answers retryable: false \u2014 add the field, do not retry). The vendor defines no DELETE endpoint for this resource (W-A1) \u2014 the record is residue; cleanup is UI-only.',
+        "remedy": "provision via the API as proven: send actionType (picklist, e.g. 3 = Note: General), assignedResourceID (a resource id), startDateTime and endDateTime (UTC ISO) in the body and the company id as the parent; name and note are optional content fields. Clean up the residue record in the Autotask UI (the marker name is the lookup handle) \u2014 there is no API delete path."
       },
       "vendorEvidence": [
-        '{"error":true,"code":"SERVER_ERROR","category":"server","retryable":true,"httpStatus":500,"operation":"company_notes.create","suggestedAction":"Retry with backoff; the server error is transient.","correlationId":"7ef594cb-74dd-4a29-a7f7-2a5d5eb515f0","message":"Value does not exist for the required '
+        `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'assignedResourceID': Value does not exist for the required field assignedResourceID. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`,
+        `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'actionType': Missing Required Field: actionType. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`,
+        `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'endDateTime': Missing Required Field: endDateTime. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`,
+        `{"error":true,"code":"SERVER_ERROR","category":"server","retryable":false,"httpStatus":500,"operation":"company_notes.create","message":"Field 'startDateTime': Missing Required Field: startDateTime. ; on record number [1].","suggestedAction":"Deterministic field rejection \u2014 fix the value, do not retry. Consult operations.fieldCatalog for the field catalog (types, required, maxLength)."}`
       ],
       "deleteBoundary": {
         "available": false,
@@ -13936,9 +13949,9 @@ var CREATE_GUIDANCE = {
       "picklist-unexposed": 5,
       "undocumented-ladder": 1,
       "resource-role-pair": 2,
-      "delete-absent": 7,
+      "delete-absent": 8,
       "non-mutable": 0,
-      "unknown": 13
+      "unknown": 12
     }
   }
 };
@@ -16126,6 +16139,182 @@ async function fieldCatalog(client, opts) {
   };
 }
 
+// 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 DEFAULT_MAX_NAME_READS = 20;
+var TICKET_LABEL_FIELDS = ["status", "priority", "ticketType", "issueType", "subIssueType", "source", "queueID"];
+function isVendorId(value) {
+  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 0;
+  if (typeof value === "string") return /^\d+$/.test(value);
+  return false;
+}
+function createNamePlan(labelFields = []) {
+  const resourceIds = [];
+  const resSeen = /* @__PURE__ */ new Set();
+  const recordFks = [];
+  const fkSeen = /* @__PURE__ */ new Set();
+  return {
+    plan: () => ({ resourceIds, recordFks, labelFields }),
+    addResource: (value) => {
+      if (!isVendorId(value)) return;
+      const k = String(value);
+      if (!resSeen.has(k)) {
+        resSeen.add(k);
+        resourceIds.push(value);
+      }
+    },
+    addFk: (table, value) => {
+      if (!isVendorId(value)) return;
+      const k = `${table}:${String(value)}`;
+      if (!fkSeen.has(k)) {
+        fkSeen.add(k);
+        recordFks.push({ table, id: value });
+      }
+    }
+  };
+}
+function addNameSibling(row, field, resolve) {
+  const value = row[field];
+  if (value === void 0) return;
+  row[`${field}Name`] = isVendorId(value) ? resolve(value) : null;
+}
+function addLabelSibling(row, field, names) {
+  const value = row[field];
+  if (value === void 0) return;
+  row[`${field}Label`] = names.labelFor(field, value);
+}
+var FK_TABLE_PATH = {
+  role: "/V1.0/Roles",
+  billingCode: "/V1.0/BillingCodes",
+  contract: "/V1.0/Contracts"
+};
+var FK_NAME_FIELD = {
+  role: "name",
+  billingCode: "name",
+  contract: "contractName"
+};
+function fkName(record, table) {
+  const value = record[FK_NAME_FIELD[table]];
+  return typeof value === "string" && value.trim() !== "" ? value : null;
+}
+function faultRow(err) {
+  const e = err;
+  return e.httpStatus !== void 0 ? { code: e.code, message: e.message, httpStatus: e.httpStatus } : { code: e.code, message: e.message };
+}
+async function resolveCompositeNames(http, plan, opts = {}) {
+  if (opts.maxNameReads !== void 0 && (!Number.isInteger(opts.maxNameReads) || opts.maxNameReads < 1)) {
+    throw new AutotaskConfigError(`composite names: maxNameReads must be an integer >= 1 (got ${String(opts.maxNameReads)})`);
+  }
+  const budget = Math.min(DEFAULT_MAX_NAME_READS, opts.maxNameReads ?? DEFAULT_MAX_NAME_READS);
+  const client = http.client;
+  if (client === void 0) {
+    throw new AutotaskConfigError("composite names: the transport is not wired to an AutotaskClient (the composite must run through the client)");
+  }
+  const readCache = http.readCache;
+  const nameCache = http.resourceNameCache;
+  const section = { truncated: false, rows: {}, reasons: {} };
+  let remaining = budget;
+  const coldResource = [];
+  for (const id of plan.resourceIds) {
+    if (nameCache !== void 0 && nameCache.get(id) !== void 0) continue;
+    if (readCache !== void 0 && readCache.get(`/V1.0/Resources/${id}`) !== void 0) continue;
+    coldResource.push(id);
+  }
+  const withinBudget = coldResource.slice(0, remaining);
+  const overBudgetResource = coldResource.slice(remaining);
+  remaining -= withinBudget.length;
+  for (const id of overBudgetResource) {
+    section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
+    section.truncated = true;
+  }
+  const overSet = new Set(overBudgetResource.map((id) => String(id)));
+  const opIds = plan.resourceIds.filter((id) => !overSet.has(String(id)));
+  if (opIds.length > 0) {
+    let pass = opIds;
+    if (pass.length > 500) {
+      for (const id of pass.slice(500)) {
+        section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
+        section.truncated = true;
+      }
+      pass = pass.slice(0, 500);
+    }
+    const res = await expandResourceNames(client, pass);
+    for (const r of res.results) {
+      const row = { name: r.name, blind: r.blind, capped: false };
+      if (r.error !== void 0) row.error = faultRow(r.error);
+      section.rows[`resource:${r.id}`] = row;
+    }
+  }
+  const holders = {
+    role: client.roles,
+    billingCode: client.billingCodes,
+    contract: client.contracts
+  };
+  for (const fk of plan.recordFks) {
+    const key = `${fk.table}:${fk.id}`;
+    const cold = readCache === void 0 || readCache.get(`${FK_TABLE_PATH[fk.table]}/${fk.id}`) === void 0;
+    if (cold) {
+      if (remaining < 1) {
+        section.rows[key] = { name: null, blind: false, capped: true };
+        section.truncated = true;
+        continue;
+      }
+      remaining -= 1;
+    }
+    try {
+      const record = await holders[fk.table].get(fk.id);
+      section.rows[key] = { name: fkName(record, fk.table), blind: false, capped: false };
+    } catch (err) {
+      if (err instanceof NotFoundError) {
+        section.rows[key] = { name: null, blind: true, capped: false };
+      } else if (isAutotaskError(err) && err.code !== "ABORTED") {
+        section.rows[key] = { name: null, blind: false, capped: false, error: faultRow(err) };
+      } else {
+        throw err;
+      }
+    }
+  }
+  const picklists = {};
+  if (plan.labelFields.length > 0) {
+    let usable = true;
+    try {
+      const catalog = await fieldCatalog(client, { resources: ["tickets"], labels: true, fields: [...plan.labelFields] });
+      const row = catalog.rows.find((r) => r.resource === "tickets");
+      if (row === void 0 || row.error !== null || row.fields === void 0) {
+        usable = false;
+      } else {
+        for (const f of plan.labelFields) {
+          const frow = row.fields.find((x) => x.name === f);
+          picklists[f] = frow?.picklistValues;
+        }
+      }
+    } catch (err) {
+      if (isAutotaskError(err) && err.code !== "ABORTED") usable = false;
+      else throw err;
+    }
+    if (!usable) for (const f of plan.labelFields) section.reasons[f] = FIELD_CATALOG_HONESTY_NOTE;
+  }
+  return {
+    section,
+    resourceName: (id) => section.rows[`resource:${id}`]?.name ?? null,
+    recordName: (table, id) => section.rows[`${table}:${id}`]?.name ?? null,
+    labelFor: (field, value) => {
+      if (value === null || value === void 0) return null;
+      const values = picklists[field];
+      if (values === void 0) {
+        section.reasons[field] = FIELD_CATALOG_HONESTY_NOTE;
+        return null;
+      }
+      const hit = values.find((v) => String(v.value) === String(value));
+      if (hit === void 0) {
+        section.reasons[field] = PICKLIST_VALUE_NOT_SERVED_NOTE;
+        return null;
+      }
+      return typeof hit.label === "string" ? hit.label : null;
+    }
+  };
+}
+
 // src/resources/base.ts
 var BOUNDED_QUERY_DEFAULT_LIMIT = 500;
 var BOUNDED_QUERY_MAX_LIMIT = 2500;
@@ -18008,6 +18197,11 @@ export {
   WORKFLOW_RESOURCES,
   MAX_FIELD_CATALOG_WIRE,
   FIELD_CATALOG_HONESTY_NOTE,
-  fieldCatalog
+  fieldCatalog,
+  PICKLIST_VALUE_NOT_SERVED_NOTE,
+  TICKET_LABEL_FIELDS,
+  createNamePlan,
+  addNameSibling,
+  addLabelSibling,
+  resolveCompositeNames
 };
-//# sourceMappingURL=chunk-UDWV4VVD.js.map