node-autotask 0.15.0 → 0.16.0

package/ARCHITECTURE.md

@@ -534,6 +534,14 @@ export interface RequestOptions {
      that premise is unprovable from the response, and the #104 classifier pins this
      code as `unknown` for a write (never blindly resend). `idempotent: true` /
      `maxRetries` remain the explicit opt-ins.
+   - **Maintenance-window wait (weekly window):** a non-JSON `2xx` that reads as a
+     maintenance notice is waited out for up to `maintenanceMaxWaitMs` (default 1 h,
+     polled every `maintenancePollMs` = 30 s) from the first such page — for reads
+     AND writes, because the edge answered before the vendor application saw the
+     request. It does not consume `maxRetries`, each post-wait attempt gets a fresh
+     `timeoutMs`, and the timer is re-armed around the wait. On exhaustion the error
+     carries `details.maintenance = { waits, waitedMs, maxWaitMs, exhausted }`. A page
+     that does not read as maintenance (a wrong `baseUrl`) never enters the loop.
    - **Per-call budget override:** `InvokeOptions.maxRetries` / `MutationOpts.maxRetries`
      threads the transport's per-request override through a mutation (and its
      auxiliary reads, e.g. a partial-update merge read); `0` = exactly one send per

package/README.md

@@ -397,8 +397,10 @@ The SDK ships the mechanical substrate, not a server (no MCP imports, no zod):
    gains two server-category codes: `UNEXPECTED_CONTENT_TYPE` (a non-JSON 2xx
    whose `Content-Type` is not a JSON media type — the vendor maintenance
    page; `details` carries the content-type + a 256-byte truncated snippet
-   that the MCP servers wrap as untrusted host text; a `GET` or an explicitly
-   `idempotent`-flagged call retries, a write makes ONE call and says the write
+   that the MCP servers wrap as untrusted host text; a maintenance notice is waited
+   out for up to `maintenanceMaxWaitMs` (default 1 h — the weekly window is usually
+   under 30 min) for reads and writes, otherwise a `GET` or an explicitly
+   `idempotent`-flagged call retries and a write makes ONE call and says the write
    may have taken effect) and `EMPTY_RESPONSE` (a blank 2xx on a call that expects a result
    — `expectBody`, non-DELETE by default; `DELETE` / 204 keep `undefined` and
    the delete ops synthesize `{ id }` from the path id on a blank answer). A

package/dist/{chunk-LH5BXQ7A.js → chunk-GWALLMAM.js}

@@ -127,13 +127,13 @@ import {
   VersionInformationResource,
   VersionResource,
   ZoneInformationResource
-} from "./chunk-AXVYQPTB.js";
+} from "./chunk-NB254T3F.js";
 import {
   AutotaskConfigError,
   HttpClient,
   resolveConfig,
   runWithSignal
-} from "./chunk-CSA6QSV6.js";
+} from "./chunk-U6JUHHMB.js";
 
 // src/client.ts
 var AutotaskClient = class {