node-autotask 0.9.0 → 0.10.0

package/dist/chunk-FLB2X6O5.cjs

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

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

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-BZPFDRAE.js";
+} from "./chunk-6KFP5HV3.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

package/dist/chunk-IDPB4N2Q.cjs

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

package/dist/{chunk-QJU2N32V.js → chunk-NVJ2PTN3.js}

@@ -127,13 +127,13 @@ import {
   VersionInformationResource,
   VersionResource,
   ZoneInformationResource
-} from "./chunk-UYJ5V262.js";
+} from "./chunk-3VB6N44U.js";
 import {
   AutotaskConfigError,
   HttpClient,
   resolveConfig,
   runWithSignal
-} from "./chunk-UDWV4VVD.js";
+} from "./chunk-HWC2WPX2.js";
 
 // src/client.ts
 var AutotaskClient = class {
@@ -477,4 +477,3 @@ var AutotaskClient = class {
 export {
   AutotaskClient
 };
-//# sourceMappingURL=chunk-QJU2N32V.js.map