node-autotask 0.21.0 → 0.24.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   AutotaskClient
-} from "./chunk-JRSU6PKP.js";
+} from "./chunk-ICCU2S62.js";
 import "./chunk-DMMMWO6A.js";
 import {
   AppointmentsResource,
@@ -131,7 +131,7 @@ import {
   VersionInformationResource,
   VersionResource,
   ZoneInformationResource
-} from "./chunk-GBVUXAUA.js";
+} from "./chunk-IOVFTIW6.js";
 import {
   AGENT_PROFILE,
   AUTH_HEADERS,
@@ -191,6 +191,7 @@ import {
   MAX_UDF_PER_QUERY,
   MIN_PREFIX_SUMMARY_LENGTH,
   MarkerUnsafeIdError,
+  MoveRefusedError,
   NoopLogger,
   NotFoundError,
   PERSONAL_RESPONSE_FIELDS,
@@ -267,8 +268,8 @@ import {
   validateFilter,
   withAuthHeaders,
   zoneUrl
-} from "./chunk-KD6LOSAK.js";
-import "./chunk-DM67SXCO.js";
+} from "./chunk-BBQBWVBE.js";
+import "./chunk-WJD26CPN.js";
 import "./chunk-UPQIUWOS.js";
 
 // src/credentials.ts
@@ -481,15 +482,33 @@ async function timeCheck(id, fn) {
     };
   }
 }
-async function runDoctor(client, opts = {}) {
-  const cfg = client.config;
-  const timeoutMs = opts.timeoutMs ?? DOCTOR_CHECK_TIMEOUT_MS;
-  let issued = 0;
-  let tenantBudget = null;
+function failFrom(err, what) {
+  if (err instanceof RateLimitError && (err.code === "RATE_LIMITED_COOLDOWN" || err.notSent === true)) {
+    return {
+      status: "fail",
+      message: `${what} \u2014 refused LOCALLY by the tenant 429 cooldown gate (the call was NOT sent)`,
+      hint: err.suggestedAction
+    };
+  }
+  if (err.code === "RATE_LIMITED") {
+    return {
+      status: "fail",
+      message: `${what} \u2014 refused by the LOCAL client-side rate limiter (per-process budget; not a vendor 429)`,
+      hint: err.suggestedAction
+    };
+  }
+  const statusLabel = err.httpStatus !== void 0 ? ` (HTTP ${err.httpStatus})` : "";
+  return { status: "fail", message: `${what} failed${statusLabel} \u2014 machine code ${err.code}`, hint: err.suggestedAction };
+}
+function skip(why) {
+  return { status: "skip", message: `skipped: ${why}` };
+}
+var ZONE_UNAVAILABLE_SKIP = "zone discovery proved the API or credentials unavailable (check #zone)";
+function makeWire(run, timeoutMs) {
   const wire = async (method, path, operation, extra = {}) => {
-    issued += 1;
+    run.issued += 1;
     try {
-      const body = await client.http.request({
+      const body = await run.client.http.request({
         method,
         path,
         query: extra.query,
@@ -507,25 +526,10 @@ async function runDoctor(client, opts = {}) {
       throw err;
     }
   };
-  const failFrom = (err, what) => {
-    if (err instanceof RateLimitError && (err.code === "RATE_LIMITED_COOLDOWN" || err.notSent === true)) {
-      return {
-        status: "fail",
-        message: `${what} \u2014 refused LOCALLY by the tenant 429 cooldown gate (the call was NOT sent)`,
-        hint: err.suggestedAction
-      };
-    }
-    if (err.code === "RATE_LIMITED") {
-      return {
-        status: "fail",
-        message: `${what} \u2014 refused by the LOCAL client-side rate limiter (per-process budget; not a vendor 429)`,
-        hint: err.suggestedAction
-      };
-    }
-    const statusLabel = err.httpStatus !== void 0 ? ` (HTTP ${err.httpStatus})` : "";
-    return { status: "fail", message: `${what} failed${statusLabel} \u2014 machine code ${err.code}`, hint: err.suggestedAction };
-  };
-  const configCheck = await timeCheck("config", async () => {
+  return wire;
+}
+async function checkConfig(cfg) {
+  return timeCheck("config", async () => {
     const zone = cfg.zone ?? "custom baseUrl";
     const host = new URL(cfg.baseUrl).host;
     const bits = [`configuration complete (zone ${zone} \u2192 ${host})`];
@@ -533,8 +537,11 @@ async function runDoctor(client, opts = {}) {
     if (cfg.rateLimit !== void 0) bits.push(`client-side rate limiter ENABLED (${cfg.rateLimit.perHour}/hr \u2014 the doctor's calls count against it)`);
     return { status: "pass", message: bits.join("; ") };
   });
-  const zoneOutcome = await timeCheck("zone", async () => {
-    const out = await wire("GET", "/V1.0/ZoneInformation", "doctor.zone", { query: { user: cfg.userName } });
+}
+async function checkZone(run) {
+  const cfg = run.client.config;
+  return timeCheck("zone", async () => {
+    const out = await run.wire("GET", "/V1.0/ZoneInformation", "doctor.zone", { query: { user: cfg.userName } });
     if (out.error) {
       const f = failFrom(out.error, "zone discovery (zoneInformation.get)");
       return { ...f, value: { code: out.error.code, httpStatus: out.error.httpStatus } };
@@ -551,25 +558,31 @@ async function runDoctor(client, opts = {}) {
     }
     return { status: "pass", message: `zone discovery OK: "${body.zoneName}" (actual host: ${actualHost})`, value: body };
   });
+}
+function isZoneUnavailable(zoneOutcome) {
   const zoneFailCode = zoneOutcome.check.status === "fail" && zoneOutcome.value !== void 0 && "code" in zoneOutcome.value ? zoneOutcome.value : void 0;
-  const zoneUnavailable = zoneFailCode !== void 0 && (zoneFailCode.code === "NETWORK_ERROR" || zoneFailCode.code === "TIMEOUT" || zoneFailCode.httpStatus === 401 || zoneFailCode.httpStatus === 403 || zoneFailCode.code === "RATE_LIMITED_COOLDOWN" || zoneFailCode.code === "RATE_LIMITED");
-  const skip = (why) => ({ status: "skip", message: `skipped: ${why}` });
-  const connectivity = await timeCheck("connectivity", async () => {
-    if (zoneUnavailable) return skip("zone discovery proved the API or credentials unavailable (check #zone)");
+  return zoneFailCode !== void 0 && (zoneFailCode.code === "NETWORK_ERROR" || zoneFailCode.code === "TIMEOUT" || zoneFailCode.httpStatus === 401 || zoneFailCode.httpStatus === 403 || zoneFailCode.code === "RATE_LIMITED_COOLDOWN" || zoneFailCode.code === "RATE_LIMITED");
+}
+async function checkConnectivity(run, zoneUnavailable) {
+  return timeCheck("connectivity", async () => {
+    if (zoneUnavailable) return skip(ZONE_UNAVAILABLE_SKIP);
     const t0 = Date.now();
-    const out = await wire("GET", "/V1.0/Version", "doctor.connectivity");
+    const out = await run.wire("GET", "/V1.0/Version", "doctor.connectivity");
     const ms = Date.now() - t0;
     if (out.error) return failFrom(out.error, "API reachability (version.get)");
     const body = out.body;
     return { status: "pass", message: `API reachable (version ${body.majorVersion}.${body.minorVersion} build ${body.build}, ${ms}ms round trip)` };
   });
+}
+async function checkReads(run, zoneUnavailable) {
+  const cfg = run.client.config;
   const readChecks = [];
   for (const entity of DOCTOR_ENTITIES) {
     const id = `read.${entity.key}`;
     const result = await timeCheck(id, async () => {
-      if (zoneUnavailable) return skip("zone discovery proved the API or credentials unavailable (check #zone)");
+      if (zoneUnavailable) return skip(ZONE_UNAVAILABLE_SKIP);
       const req = buildQueryRequest(cfg.baseUrl, entity.path, { maxRecords: 1 });
-      const out = await wire(req.method, req.path, `doctor.${id}`, { body: req.body, idempotent: req.idempotent });
+      const out = await run.wire(req.method, req.path, `doctor.${id}`, { body: req.body, idempotent: req.idempotent });
       if (out.error) {
         const f = failFrom(out.error, `read access to ${entity.label}`);
         if (out.error.httpStatus === 403) {
@@ -585,9 +598,12 @@ async function runDoctor(client, opts = {}) {
     });
     readChecks.push(result.check);
   }
-  const threshold = await timeCheck("threshold", async () => {
-    if (zoneUnavailable) return skip("zone discovery proved the API or credentials unavailable (check #zone)");
-    const out = await wire(
+  return readChecks;
+}
+async function checkThreshold(run, zoneUnavailable) {
+  return timeCheck("threshold", async () => {
+    if (zoneUnavailable) return skip(ZONE_UNAVAILABLE_SKIP);
+    const out = await run.wire(
       "GET",
       "/V1.0/ThresholdInformation",
       "doctor.threshold",
@@ -596,7 +612,7 @@ async function runDoctor(client, opts = {}) {
     if (out.error) return failFrom(out.error, "API usage headroom (thresholdInformation.get)");
     const body = out.body;
     const headroom = body.externalRequestThreshold - body.currentTimeframeRequestCount;
-    tenantBudget = {
+    run.tenantBudget = {
       threshold: body.externalRequestThreshold,
       timeframeSeconds: body.requestThresholdTimeframe,
       used: body.currentTimeframeRequestCount,
@@ -610,6 +626,18 @@ async function runDoctor(client, opts = {}) {
     }
     return { status: "pass", message: `API usage headroom OK: ${headroom}/${body.externalRequestThreshold} requests remaining in the current timeframe` };
   });
+}
+async function runDoctor(client, opts = {}) {
+  const cfg = client.config;
+  const timeoutMs = opts.timeoutMs ?? DOCTOR_CHECK_TIMEOUT_MS;
+  const run = { client, issued: 0, tenantBudget: null };
+  run.wire = makeWire(run, timeoutMs);
+  const configCheck = await checkConfig(cfg);
+  const zoneOutcome = await checkZone(run);
+  const zoneUnavailable = isZoneUnavailable(zoneOutcome);
+  const connectivity = await checkConnectivity(run, zoneUnavailable);
+  const readChecks = await checkReads(run, zoneUnavailable);
+  const threshold = await checkThreshold(run, zoneUnavailable);
   const checks = [
     configCheck.check,
     zoneOutcome.check,
@@ -625,8 +653,8 @@ async function runDoctor(client, opts = {}) {
     checks,
     budget: {
       localLimiter: { enabled: cfg.rateLimit !== void 0, perHour: cfg.rateLimit?.perHour ?? null },
-      tenant: tenantBudget,
-      requestBudget: { max: DOCTOR_MAX_REQUESTS, issued }
+      tenant: run.tenantBudget,
+      requestBudget: { max: DOCTOR_MAX_REQUESTS, issued: run.issued }
     },
     summary
   };
@@ -797,6 +825,7 @@ export {
   MIN_PREFIX_SUMMARY_LENGTH,
   MarkerUnsafeIdError,
   ModulesResource,
+  MoveRefusedError,
   NoopLogger,
   NotFoundError,
   NotificationHistoryResource,