node-autotask 0.15.0 → 0.17.0

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

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

package/dist/{index-M0qJIiRt.d.ts → index-BAFdPxjG.d.ts}

@@ -198,7 +198,10 @@ declare class ResourceNameCache {
  * Every error carries the structured contract: `code` (stable SCREAMING_SNAKE
  * machine code), `category`, `retryable`, plus `operation`, `httpStatus`,
  * `vendorError` (the vendor payload under a documented key, deep-redacted —
- * the INV-A1 hotfix), `resourceIds`,
+ * the INV-A1 hotfix), `resourceIds` (the LEGACY unlabeled id list — the
+ * stamp sites name records of several vendor entities and say nothing about
+ * which; every SDK stamp site that sets it also sets `details.idRefs`, the
+ * labeled `{ entity, id }` companion — issue #116),
  * `suggestedAction` (deterministic next step only), `correlationId` and `url`.
  *
  * `item: null` on a single GET (HTTP 200) is a NOT FOUND, not a success — the
@@ -207,12 +210,49 @@ declare class ResourceNameCache {
  * the node's errorHandler and parsed defensively here.
  */
 type ErrorCategory = 'auth' | 'not_found' | 'validation' | 'conflict' | 'rate_limit' | 'server' | 'network' | 'timeout' | 'resolution' | 'policy';
+/**
+ * A labeled id reference (issue #116). The legacy `resourceIds` field reads
+ * as Autotask **Resource** (staff) ids, but the special ops stamp ids of
+ * many other entities into it (ticket / company / contact / billing-code /
+ * the failed record's own id on a generic `get`), unlabeled — so feeding an
+ * error's `resourceIds` to `operations.expandResourceNames` (whose only wire
+ * verb is `GET /V1.0/Resources/{id}`) resolves a colliding non-staff id to
+ * an unrelated person's name. Every SDK stamp site that sets `resourceIds`
+ * now also sets `details.idRefs` — the same ids, each labeled with the vendor entity
+ * it identifies — so consumers can resolve against the entity the error
+ * actually names instead of parsing the message.
+ *
+ * `entity` is the vendor entity name (singular snake_case — `company`,
+ * `ticket`, `contact`, `billing_code`, `resource`, ...; the de-pluralized
+ * vendor table name — the same word the error message uses; the SDK
+ * resource key is the same word plural). `resource` (staff) is the ONLY
+ * entity `operations.expandResourceNames` resolves — a ref of any other
+ * entity must NOT be fed to it.
+ */
+interface ErrorIdRef {
+    /** The vendor entity the id identifies (singular snake_case, e.g. `company`, `ticket`, `resource` = staff). */
+    entity: string;
+    /** The value that addresses the record at that entity's endpoint: the
+     *  vendor id (a safe integer, or the canonical integer-string form) —
+     *  except `resource_time_off_balances.getByYear`, where the endpoint's
+     *  path key is the YEAR (the vendor defines no record-id read for this
+     *  entity). */
+    id: number | string;
+}
 interface AutotaskErrorOptions {
     code?: string;
     category?: ErrorCategory;
     operation?: string;
     httpStatus?: number;
     vendorError?: unknown;
+    /**
+     * The ids the error is about. LEGACY, unlabeled: reads as Resource
+     * (staff) ids but the stamp sites name records of several entities
+     * (issue #116). Kept for compatibility; the labeled form rides on
+     * `details.idRefs` (`ErrorIdRef[]`) and is what consumers should use.
+     * The pairing above is a guarantee of the SDK stamp sites — an error you
+     * construct yourself may set `resourceIds` without `details.idRefs`.
+     */
     resourceIds?: (number | string)[];
     suggestedAction?: string;
     correlationId?: string;
@@ -224,9 +264,11 @@ interface AutotaskErrorOptions {
      * (`{ resource, reason/note, ... }` on DELETE_BOUNDARY /
      * MARKER_UNSAFE_ID / RECOVERY_TRUNCATED); issue #14 — `emptyReason`
      * (the typed reason a miss / drift carries — { kind, note, authority,
-     * remedy }) and `pointerNote` (the known-unusable-op pointer sentence).
-     * Additive only — the status, code, message and retryability are never
-     * derived from it.
+     * remedy }) and `pointerNote` (the known-unusable-op pointer sentence);
+     * issue #116 — `idRefs` (`ErrorIdRef[]`, the labeled `{ entity, id }`
+     * companion of the legacy `resourceIds` — every SDK stamp site that sets
+     * `resourceIds` also sets it). Additive only — the status, code, message
+     * and retryability are never derived from it.
      */
     details?: Record<string, unknown>;
 }
@@ -236,6 +278,7 @@ declare class AutotaskError extends Error {
     operation?: string;
     httpStatus?: number;
     vendorError?: unknown;
+    /** Legacy unlabeled id list (issue #116) — see `AutotaskErrorOptions.resourceIds`; the labeled companion rides on `details.idRefs`. */
     resourceIds?: (number | string)[];
     suggestedAction?: string;
     correlationId?: string;
@@ -784,6 +827,9 @@ declare const DEFAULT_PAGE_SIZE = 10;
 declare const MAX_PAGE_SIZE = 500;
 declare const DEFAULT_TIMEOUT_MS = 30000;
 declare const DEFAULT_MAX_RETRIES = 3;
+/** Autotask runs a weekly maintenance window (typically < 30 min); wait out one hour by default. */
+declare const DEFAULT_MAINTENANCE_MAX_WAIT_MS = 3600000;
+declare const DEFAULT_MAINTENANCE_POLL_MS = 30000;
 declare const DEFAULT_MAX_CONCURRENT = 10;
 /** Default response-size cap (64 MiB) — bounds a runaway/hostile body in memory. */
 declare const DEFAULT_MAX_RESPONSE_BYTES: number;
@@ -827,6 +873,23 @@ interface AutotaskConfig {
      * The client's retry budget (default 3; 0 disables auto-retry). Three legs, two rules (issues #105/#109): the 429 leg retries on the pre-#105 retriable set (GET/PUT/DELETE + idempotent-flagged calls); the 5xx/network leg and the non-JSON-2xx (#24) leg retry GET + idempotent-flagged calls only. A per-call override rides `InvokeOptions.maxRetries` / `MutationOpts.maxRetries`.
      */
     maxRetries?: number;
+    /**
+     * Maintenance-window auto-retry (the weekly Autotask maintenance window — the
+     * edge answers a non-JSON HTML page, `UNEXPECTED_CONTENT_TYPE`, before the
+     * vendor application ever sees the request). While such a page persists the
+     * transport waits `maintenancePollMs` and retries, up to this many ms from the
+     * first maintenance response. Default 3_600_000 (1 hour — a typical window is
+     * under 30 minutes); `0` disables the wait and surfaces the error at once.
+     *
+     * Applies to READS AND WRITES. The maintenance page is served by the edge (the
+     * vendor never processed the request), which is exactly the case where a
+     * bounded auto-retry is safe; the general `unknown` write-outcome rule is
+     * unaffected — a 5xx / network / timeout error never auto-retries a write.
+     * The wait does not consume the `maxRetries` budget and is bounded per call.
+     */
+    maintenanceMaxWaitMs?: number;
+    /** Poll interval while waiting out a maintenance page. Default 30_000. */
+    maintenancePollMs?: number;
     /** Optional request log sink. Default: no-op. */
     logger?: Logger;
     /** Concurrency guard (API allows <=10 concurrent). Default 10. */
@@ -1089,6 +1152,8 @@ interface ResolvedAutotaskConfig {
     pageSize: number;
     timeoutMs: number;
     maxRetries: number;
+    maintenanceMaxWaitMs: number;
+    maintenancePollMs: number;
     maxConcurrent: number;
     maxResponseBytes: number;
     logger: Logger;
@@ -1205,6 +1270,13 @@ interface RequestOptions {
      * the transport chain order.
      */
     maxRetries?: number;
+    /**
+     * Maintenance-window wait override (default: config.maintenanceMaxWaitMs).
+     * `0` disables the wait for this call. Does not consume `maxRetries`.
+     */
+    maintenanceMaxWaitMs?: number;
+    /** Maintenance poll override (default: config.maintenancePollMs). */
+    maintenancePollMs?: number;
     /**
      * Issue #25: does this call expect a non-empty 2xx body? Default:
      * `method !== 'DELETE'` (computed in `request`) — a blank 2xx on a
@@ -1326,6 +1398,9 @@ declare class HttpClient {
     };
     private readonly auth;
     private readonly maxRetries;
+    /** Maintenance-window auto-retry budget + poll (issue #112 follow-up; see config). */
+    private readonly maintenanceMaxWaitMs;
+    private readonly maintenancePollMs;
     private readonly maxResponseBytes;
     private readonly perHour;
     /** The resolved profile (issue #4) — the agent profile changes the
@@ -1475,9 +1550,13 @@ declare function unwrapItems<T>(body: unknown, operation?: string): {
 /**
  * get: expects `{ item: T }`. `item === null` THROWS `NotFoundError` (the
  * vendor not-found signal — HTTP may be 200) with `httpStatus: 200` and
- * `resourceIds: [id]` when `id` is given.
+ * `resourceIds: [id]` when `id` is given — and, when `entity` is given as
+ * well, the labeled companion `details.idRefs: [{ entity, id }]` (issue
+ * #116: the legacy field never says which vendor table the id addresses,
+ * and the caller of a generic get knows it — the vendor entity name,
+ * singular snake_case, e.g. `company`, `ticket`, `resource`).
  */
-declare function unwrapItem<T>(body: unknown, id?: Identifier, operation?: string): T;
+declare function unwrapItem<T>(body: unknown, id?: Identifier, operation?: string, entity?: string): T;
 /** count: expects `{ queryCount: number }` (an object, not a bare number) → the plain number. */
 declare function unwrapQueryCount(body: unknown, operation?: string): number;
 /** create/update/delete: expects `{ itemId }` (accepts `{ id }` too) → `{ id }`. */
@@ -1993,6 +2072,8 @@ declare abstract class BaseResource<T = Record<string, unknown>, TCreate = Recor
     protected readonly defaultPageSize: number;
     /** Versioned global URL segment (from the config), e.g. '/V1.0/Companies'. */
     protected get resourcePath(): string;
+    /** The vendor entity this resource's ids identify (issue #116 — the `details.idRefs` label, e.g. `company`). */
+    protected get entityName(): string;
     /** Parent-scoped template (from the config); undefined for top-level resources. */
     protected get parentScopedPath(): string | undefined;
     /** Parent field used to narrow the global query (from the config). */
@@ -9255,4 +9336,4 @@ declare class AutotaskClient {
     }): Promise<PromiseSettledResult<R>[]>;
 }
 
-export { ConfigurationItemRelatedItemsResource as $, type AutotaskConfig as A, BadRequestError as B, CREDENTIAL_HEADER_NAMES as C, type ClassificationIconsResourceQueryParams as D, CompaniesResource as E, type CompaniesResourceQueryParams as F, CompanyAlertsResource as G, type CompanyAlertsResourceQueryParams as H, CompanyLocationsResource as I, type CompanyLocationsResourceQueryParams as J, CompanyNotesResource as K, type CompanyNotesResourceQueryParams as L, CompanySiteConfigurationsResource as M, type CompanySiteConfigurationsResourceQueryParams as N, CompanyWebhooksResource as O, type CompanyWebhooksResourceQueryParams as P, type ConfigProfile as Q, ConfigurationItemBillingProductAssociationsResource as R, type ConfigurationItemBillingProductAssociationsResourceQueryParams as S, ConfigurationItemCategoriesResource as T, type ConfigurationItemCategoriesResourceQueryParams as U, ConfigurationItemCategoryUdfAssociationsResource as V, type ConfigurationItemCategoryUdfAssociationsResourceQueryParams as W, ConfigurationItemDnsRecordsResource as X, type ConfigurationItemDnsRecordsResourceQueryParams as Y, ConfigurationItemNotesResource as Z, type ConfigurationItemNotesResourceQueryParams as _, AutotaskClient as a, type ContractsResourceQueryParams as a$, type ConfigurationItemRelatedItemsResourceQueryParams as a0, ConfigurationItemSslSubjectAlternativeNamesResource as a1, type ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams as a2, ConfigurationItemTypesResource as a3, type ConfigurationItemTypesResourceQueryParams as a4, ConfigurationItemWebhooksResource as a5, type ConfigurationItemWebhooksResourceQueryParams as a6, ConfigurationItemsResource as a7, type ConfigurationItemsResourceQueryParams as a8, ConfirmationRequiredError as a9, type ContractExclusionSetsResourceQueryParams as aA, ContractMilestonesResource as aB, type ContractMilestonesResourceQueryParams as aC, ContractNotesResource as aD, type ContractNotesResourceQueryParams as aE, ContractRatesResource as aF, type ContractRatesResourceQueryParams as aG, ContractRetainersResource as aH, type ContractRetainersResourceQueryParams as aI, ContractRoleCostsResource as aJ, type ContractRoleCostsResourceQueryParams as aK, ContractServiceAdjustmentsResource as aL, type ContractServiceAdjustmentsResourceQueryParams as aM, ContractServiceBundleAdjustmentsResource as aN, type ContractServiceBundleAdjustmentsResourceQueryParams as aO, ContractServiceBundleUnitsResource as aP, type ContractServiceBundleUnitsResourceQueryParams as aQ, ContractServiceBundlesResource as aR, type ContractServiceBundlesResourceQueryParams as aS, ContractServiceUnitsResource as aT, type ContractServiceUnitsResourceQueryParams as aU, ContractServicesResource as aV, type ContractServicesResourceQueryParams as aW, ContractTicketPurchasesResource as aX, type ContractTicketPurchasesResourceQueryParams as aY, type ContractsProfitabilityResult as aZ, ContractsResource as a_, ConflictError as aa, ContactGroupContactsResource as ab, type ContactGroupContactsResourceQueryParams as ac, ContactGroupsResource as ad, type ContactGroupsResourceQueryParams as ae, ContactWebhooksResource as af, type ContactWebhooksResourceQueryParams as ag, ContactsResource as ah, type ContactsResourceQueryParams as ai, ContractBillingRulesResource as aj, type ContractBillingRulesResourceQueryParams as ak, ContractBlockHourFactorsResource as al, type ContractBlockHourFactorsResourceQueryParams as am, ContractBlocksResource as an, type ContractBlocksResourceQueryParams as ao, ContractChargesResource as ap, type ContractChargesResourceQueryParams as aq, ContractExclusionBillingCodesResource as ar, type ContractExclusionBillingCodesResourceQueryParams as as, ContractExclusionRolesResource as at, type ContractExclusionRolesResourceQueryParams as au, ContractExclusionSetExcludedRolesResource as av, type ContractExclusionSetExcludedRolesResourceQueryParams as aw, ContractExclusionSetExcludedWorkTypesResource as ax, type ContractExclusionSetExcludedWorkTypesResourceQueryParams as ay, ContractExclusionSetsResource as az, AGENT_PROFILE as b, OpportunityAttachmentsResource as b$, type CooldownStore as b0, type CostRateResolution as b1, CountriesResource as b2, type CountriesResourceQueryParams as b3, type CredentialShapeExpectation as b4, DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD as b5, DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES as b6, DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS as b7, DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE as b8, DEFAULT_CIRCUIT_BREAKER_WINDOW_MS as b9, ExpenseReportsResource as bA, type ExpenseReportsResourceQueryParams as bB, ForbiddenError as bC, HolidaySetsResource as bD, type HolidaySetsResourceQueryParams as bE, HolidaysResource as bF, type HolidaysResourceQueryParams as bG, HostPolicyDeniedError as bH, HttpClient as bI, IDEMPOTENT_METHODS as bJ, InMemoryCircuitBreakerStore as bK, InMemoryCooldownStore as bL, InventoryProductsResource as bM, type InventoryProductsResourceQueryParams as bN, InvoicesResource as bO, type InvoicesResourceQueryParams as bP, type Logger as bQ, MAX_PAGES as bR, MAX_PAGE_SIZE as bS, MarkerUnsafeIdError as bT, ModulesResource as bU, NoopLogger as bV, NotFoundError as bW, NotificationHistoryResource as bX, type NotificationHistoryResourceQueryParams as bY, OpportunitiesResource as bZ, type OpportunitiesResourceQueryParams as b_, DEFAULT_COOLDOWN_DEFAULT_MS as ba, DEFAULT_COOLDOWN_MAX_ENTRIES as bb, DEFAULT_COOLDOWN_MAX_MS as bc, DEFAULT_FIELD_CACHE_TTL_MS as bd, DEFAULT_MAX_CONCURRENT as be, DEFAULT_MAX_RESPONSE_BYTES as bf, DEFAULT_MAX_RETRIES as bg, DEFAULT_MAX_SCAN_PAGES as bh, DEFAULT_MAX_SCAN_RECORDS as bi, DEFAULT_PAGE_SIZE as bj, DEFAULT_READ_CACHE_TTL_MS as bk, DEFAULT_RESOURCE_NAME_CACHE_TTL_MS as bl, DEFAULT_TIMEOUT_MS as bm, DEFAULT_ZONE as bn, DeleteBoundaryError as bo, DepartmentsResource as bp, type DepartmentsResourceQueryParams as bq, DomainRegistrarsResource as br, type DomainRegistrarsResourceQueryParams as bs, EmptyResponseError as bt, EntityInformationResource as bu, type ErrorCategory as bv, ExpenseItemAttachmentsResource as bw, type ExpenseItemAttachmentsResourceQueryParams as bx, ExpenseItemsResource as by, type ExpenseItemsResourceQueryParams as bz, AppointmentsResource as c, ResourceTimeOffBalancesResource as c$, type OpportunityAttachmentsResourceQueryParams as c0, OpportunityCategoriesResource as c1, type OpportunityCategoriesResourceQueryParams as c2, type PageFetcher as c3, type PaginateOptions as c4, PaginationLimitError as c5, PhasesResource as c6, type PhasesResourceQueryParams as c7, ProductVendorsResource as c8, type ProductVendorsResourceQueryParams as c9, PurchaseOrdersResource as cA, type PurchaseOrdersResourceQueryParams as cB, QueryTooLongError as cC, QuoteItemsResource as cD, type QuoteItemsResourceQueryParams as cE, QuoteLocationsResource as cF, type QuoteLocationsResourceQueryParams as cG, QuoteTemplatesResource as cH, type QuoteTemplatesResourceQueryParams as cI, QuotesResource as cJ, type QuotesResourceQueryParams as cK, REDACTED as cL, RateLimitError as cM, RecoveryTruncatedError as cN, type RequestOptions as cO, ResolutionError as cP, type ResolvedAutotaskConfig as cQ, ResourceRoleQueuesResource as cR, type ResourceRoleQueuesResourceQueryParams as cS, ResourceRolesResource as cT, type ResourceRolesResourceQueryParams as cU, ResourceSkillsResource as cV, type ResourceSkillsResourceQueryParams as cW, ResourceTimeOffAdditionalResource as cX, type ResourceTimeOffAdditionalResourceQueryParams as cY, ResourceTimeOffApproversResource as cZ, type ResourceTimeOffApproversResourceQueryParams as c_, ProductsResource as ca, type ProductsResourceQueryParams as cb, type ProfitRateSource as cc, type ProfitabilityActivityCategory as cd, type ProfitabilityDataQualityWarning as ce, type ProfitabilityHighestCostTicket as cf, type ProfitabilityLabourCostMethod as cg, type ProfitabilityMiscoding as ch, type ProfitabilityMonthlyRow as ci, type ProfitabilityOpenRenewalItem as cj, type ProfitabilityOptions as ck, type ProfitabilityPart as cl, type ProfitabilityPartDigest as cm, type ProfitabilityRevenueByType as cn, ProjectChargesResource as co, type ProjectChargesResourceQueryParams as cp, ProjectNotesResource as cq, type ProjectNotesResourceQueryParams as cr, ProjectsResource as cs, type ProjectsResourceQueryParams as ct, PurchaseApprovalsResource as cu, type PurchaseApprovalsResourceQueryParams as cv, PurchaseOrderItemReceivingResource as cw, type PurchaseOrderItemReceivingResourceQueryParams as cx, PurchaseOrderItemsResource as cy, type PurchaseOrderItemsResourceQueryParams as cz, type AppointmentsResourceQueryParams as d, type TicketHistoryResourceQueryParams as d$, type ResourceTimeOffBalancesResourceQueryParams as d0, ResourcesResource as d1, type ResourcesResourceQueryParams as d2, ResponseRejectedError as d3, RolesResource as d4, type RolesResourceQueryParams as d5, ServerError as d6, ServiceCallTaskResourcesResource as d7, type ServiceCallTaskResourcesResourceQueryParams as d8, ServiceCallTasksResource as d9, type TagGroupsResourceQueryParams as dA, TagsResource as dB, type TagsResourceQueryParams as dC, TaskSecondaryResourcesResource as dD, type TaskSecondaryResourcesResourceQueryParams as dE, TasksResource as dF, type TasksResourceQueryParams as dG, ThresholdInformationResource as dH, TicketAdditionalConfigurationItemsResource as dI, type TicketAdditionalConfigurationItemsResourceQueryParams as dJ, TicketAdditionalContactsResource as dK, type TicketAdditionalContactsResourceQueryParams as dL, TicketAttachmentsResource as dM, type TicketAttachmentsResourceQueryParams as dN, TicketCategoriesResource as dO, type TicketCategoriesResourceQueryParams as dP, TicketCategoryFieldDefaultsResource as dQ, type TicketCategoryFieldDefaultsResourceQueryParams as dR, TicketChangeRequestApprovalsResource as dS, type TicketChangeRequestApprovalsResourceQueryParams as dT, TicketChargesResource as dU, type TicketChargesResourceQueryParams as dV, TicketChecklistItemsResource as dW, type TicketChecklistItemsResourceQueryParams as dX, TicketChecklistLibrariesResource as dY, type TicketChecklistLibrariesResourceQueryParams as dZ, TicketHistoryResource as d_, type ServiceCallTasksResourceQueryParams as da, ServiceCallTicketResourcesResource as db, type ServiceCallTicketResourcesResourceQueryParams as dc, ServiceCallTicketsResource as dd, type ServiceCallTicketsResourceQueryParams as de, ServiceCallsResource as df, type ServiceCallsResourceQueryParams as dg, ServiceLevelAgreementResultsResource as dh, type ServiceLevelAgreementResultsResourceQueryParams as di, ServicesResource as dj, type ServicesResourceQueryParams as dk, SkillsResource as dl, type SkillsResourceQueryParams as dm, StaleObjectError as dn, SubscriptionPeriodsResource as dp, type SubscriptionPeriodsResourceQueryParams as dq, SubscriptionsResource as dr, type SubscriptionsResourceQueryParams as ds, SurveyResultsResource as dt, type SurveyResultsResourceQueryParams as du, SurveysResource as dv, type SurveysResourceQueryParams as dw, TagAliasesResource as dx, type TagAliasesResourceQueryParams as dy, TagGroupsResource as dz, AuthenticateResource as e, type BlindSurfaceInfo as e$, TicketNoteAttachmentsResource as e0, type TicketNoteAttachmentsResourceQueryParams as e1, TicketNoteWebhooksResource as e2, type TicketNoteWebhooksResourceQueryParams as e3, TicketNotesResource as e4, type TicketNotesResourceQueryParams as e5, TicketSecondaryResourcesResource as e6, type TicketSecondaryResourcesResourceQueryParams as e7, TicketWebhooksResource as e8, type TicketWebhooksResourceQueryParams as e9, defaultCircuitBreakerStore as eA, defaultCooldownStore as eB, errorFromStatus as eC, formatVendorDetail as eD, isAutotaskError as eE, isBreakerFailure as eF, isCredentialHeaderName as eG, isDeterministicVendor500 as eH, mergeDetails as eI, paginate as eJ, paginateItems as eK, parseVendorErrors as eL, passthrough as eM, redactRecord as eN, resetDefaultCircuitBreakerStore as eO, resetDefaultCooldownStore as eP, resolveBaseUrl as eQ, resolveConfig as eR, resolveCredentials as eS, runWithSignal as eT, toArray as eU, totalPagesFor as eV, unwrapItem as eW, unwrapItems as eX, unwrapOperation as eY, unwrapQueryCount as eZ, zoneUrl as e_, TicketsResource as ea, type TicketsResourceQueryParams as eb, TimeEntriesResource as ec, type TimeEntriesResourceQueryParams as ed, TimeEntryAttachmentsResource as ee, type TimeEntryAttachmentsResourceQueryParams as ef, TimeOffRequestsResource as eg, type TimeOffRequestsResourceQueryParams as eh, UnauthorizedError as ei, UnexpectedContentTypeError as ej, UnprocessableEntityError as ek, type VendorFieldError as el, VersionInformationResource as em, VersionResource as en, ZONES as eo, ZONE_CATALOG as ep, ZoneInformationResource as eq, type ZoneName as er, buildBreakerKey as es, buildQueryRequest as et, buildTenantKey as eu, buildUrl as ev, clampPageSize as ew, collectAll as ex, cooldownDurationMs as ey, cursorToPath as ez, AutotaskAbortError as f, type RelationshipResource as f0, type BlindSurfaceInventory as f1, type BlindSurfaceRow as f2, type CreateBlockerKind as f3, type CreateGuidanceReport as f4, type FieldCacheKind as f5, FIELD_CACHE_KINDS as f6, AutotaskConfigError as g, AutotaskError as h, type AutotaskErrorOptions as i, AutotaskNetworkError as j, AutotaskTimeoutError as k, BillingCodesResource as l, type BillingCodesResourceQueryParams as m, BillingItemsResource as n, type BillingItemsResourceQueryParams as o, CREDENTIAL_SHAPE_POINTER as p, ChangeRequestLinksResource as q, type ChangeRequestLinksResourceQueryParams as r, ChecklistLibrariesResource as s, type ChecklistLibrariesResourceQueryParams as t, ChecklistLibraryChecklistItemsResource as u, type ChecklistLibraryChecklistItemsResourceQueryParams as v, CircuitBreakerError as w, type CircuitBreakerState as x, type CircuitBreakerStore as y, ClassificationIconsResource as z };
+export { ConfigurationItemRelatedItemsResource as $, type AutotaskConfig as A, BadRequestError as B, CREDENTIAL_HEADER_NAMES as C, type ClassificationIconsResourceQueryParams as D, CompaniesResource as E, type CompaniesResourceQueryParams as F, CompanyAlertsResource as G, type CompanyAlertsResourceQueryParams as H, CompanyLocationsResource as I, type CompanyLocationsResourceQueryParams as J, CompanyNotesResource as K, type CompanyNotesResourceQueryParams as L, CompanySiteConfigurationsResource as M, type CompanySiteConfigurationsResourceQueryParams as N, CompanyWebhooksResource as O, type CompanyWebhooksResourceQueryParams as P, type ConfigProfile as Q, ConfigurationItemBillingProductAssociationsResource as R, type ConfigurationItemBillingProductAssociationsResourceQueryParams as S, ConfigurationItemCategoriesResource as T, type ConfigurationItemCategoriesResourceQueryParams as U, ConfigurationItemCategoryUdfAssociationsResource as V, type ConfigurationItemCategoryUdfAssociationsResourceQueryParams as W, ConfigurationItemDnsRecordsResource as X, type ConfigurationItemDnsRecordsResourceQueryParams as Y, ConfigurationItemNotesResource as Z, type ConfigurationItemNotesResourceQueryParams as _, AutotaskClient as a, type ContractsResourceQueryParams as a$, type ConfigurationItemRelatedItemsResourceQueryParams as a0, ConfigurationItemSslSubjectAlternativeNamesResource as a1, type ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams as a2, ConfigurationItemTypesResource as a3, type ConfigurationItemTypesResourceQueryParams as a4, ConfigurationItemWebhooksResource as a5, type ConfigurationItemWebhooksResourceQueryParams as a6, ConfigurationItemsResource as a7, type ConfigurationItemsResourceQueryParams as a8, ConfirmationRequiredError as a9, type ContractExclusionSetsResourceQueryParams as aA, ContractMilestonesResource as aB, type ContractMilestonesResourceQueryParams as aC, ContractNotesResource as aD, type ContractNotesResourceQueryParams as aE, ContractRatesResource as aF, type ContractRatesResourceQueryParams as aG, ContractRetainersResource as aH, type ContractRetainersResourceQueryParams as aI, ContractRoleCostsResource as aJ, type ContractRoleCostsResourceQueryParams as aK, ContractServiceAdjustmentsResource as aL, type ContractServiceAdjustmentsResourceQueryParams as aM, ContractServiceBundleAdjustmentsResource as aN, type ContractServiceBundleAdjustmentsResourceQueryParams as aO, ContractServiceBundleUnitsResource as aP, type ContractServiceBundleUnitsResourceQueryParams as aQ, ContractServiceBundlesResource as aR, type ContractServiceBundlesResourceQueryParams as aS, ContractServiceUnitsResource as aT, type ContractServiceUnitsResourceQueryParams as aU, ContractServicesResource as aV, type ContractServicesResourceQueryParams as aW, ContractTicketPurchasesResource as aX, type ContractTicketPurchasesResourceQueryParams as aY, type ContractsProfitabilityResult as aZ, ContractsResource as a_, ConflictError as aa, ContactGroupContactsResource as ab, type ContactGroupContactsResourceQueryParams as ac, ContactGroupsResource as ad, type ContactGroupsResourceQueryParams as ae, ContactWebhooksResource as af, type ContactWebhooksResourceQueryParams as ag, ContactsResource as ah, type ContactsResourceQueryParams as ai, ContractBillingRulesResource as aj, type ContractBillingRulesResourceQueryParams as ak, ContractBlockHourFactorsResource as al, type ContractBlockHourFactorsResourceQueryParams as am, ContractBlocksResource as an, type ContractBlocksResourceQueryParams as ao, ContractChargesResource as ap, type ContractChargesResourceQueryParams as aq, ContractExclusionBillingCodesResource as ar, type ContractExclusionBillingCodesResourceQueryParams as as, ContractExclusionRolesResource as at, type ContractExclusionRolesResourceQueryParams as au, ContractExclusionSetExcludedRolesResource as av, type ContractExclusionSetExcludedRolesResourceQueryParams as aw, ContractExclusionSetExcludedWorkTypesResource as ax, type ContractExclusionSetExcludedWorkTypesResourceQueryParams as ay, ContractExclusionSetsResource as az, AGENT_PROFILE as b, type NotificationHistoryResourceQueryParams as b$, type CooldownStore as b0, type CostRateResolution as b1, CountriesResource as b2, type CountriesResourceQueryParams as b3, type CredentialShapeExpectation as b4, DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD as b5, DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES as b6, DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS as b7, DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE as b8, DEFAULT_CIRCUIT_BREAKER_WINDOW_MS as b9, type ExpenseItemAttachmentsResourceQueryParams as bA, ExpenseItemsResource as bB, type ExpenseItemsResourceQueryParams as bC, ExpenseReportsResource as bD, type ExpenseReportsResourceQueryParams as bE, ForbiddenError as bF, HolidaySetsResource as bG, type HolidaySetsResourceQueryParams as bH, HolidaysResource as bI, type HolidaysResourceQueryParams as bJ, HostPolicyDeniedError as bK, HttpClient as bL, IDEMPOTENT_METHODS as bM, InMemoryCircuitBreakerStore as bN, InMemoryCooldownStore as bO, InventoryProductsResource as bP, type InventoryProductsResourceQueryParams as bQ, InvoicesResource as bR, type InvoicesResourceQueryParams as bS, type Logger as bT, MAX_PAGES as bU, MAX_PAGE_SIZE as bV, MarkerUnsafeIdError as bW, ModulesResource as bX, NoopLogger as bY, NotFoundError as bZ, NotificationHistoryResource as b_, DEFAULT_COOLDOWN_DEFAULT_MS as ba, DEFAULT_COOLDOWN_MAX_ENTRIES as bb, DEFAULT_COOLDOWN_MAX_MS as bc, DEFAULT_FIELD_CACHE_TTL_MS as bd, DEFAULT_MAINTENANCE_MAX_WAIT_MS as be, DEFAULT_MAINTENANCE_POLL_MS as bf, DEFAULT_MAX_CONCURRENT as bg, DEFAULT_MAX_RESPONSE_BYTES as bh, DEFAULT_MAX_RETRIES as bi, DEFAULT_MAX_SCAN_PAGES as bj, DEFAULT_MAX_SCAN_RECORDS as bk, DEFAULT_PAGE_SIZE as bl, DEFAULT_READ_CACHE_TTL_MS as bm, DEFAULT_RESOURCE_NAME_CACHE_TTL_MS as bn, DEFAULT_TIMEOUT_MS as bo, DEFAULT_ZONE as bp, DeleteBoundaryError as bq, DepartmentsResource as br, type DepartmentsResourceQueryParams as bs, DomainRegistrarsResource as bt, type DomainRegistrarsResourceQueryParams as bu, EmptyResponseError as bv, EntityInformationResource as bw, type ErrorCategory as bx, type ErrorIdRef as by, ExpenseItemAttachmentsResource as bz, AppointmentsResource as c, type ResourceTimeOffAdditionalResourceQueryParams as c$, OpportunitiesResource as c0, type OpportunitiesResourceQueryParams as c1, OpportunityAttachmentsResource as c2, type OpportunityAttachmentsResourceQueryParams as c3, OpportunityCategoriesResource as c4, type OpportunityCategoriesResourceQueryParams as c5, type PageFetcher as c6, type PaginateOptions as c7, PaginationLimitError as c8, PhasesResource as c9, type PurchaseOrderItemReceivingResourceQueryParams as cA, PurchaseOrderItemsResource as cB, type PurchaseOrderItemsResourceQueryParams as cC, PurchaseOrdersResource as cD, type PurchaseOrdersResourceQueryParams as cE, QueryTooLongError as cF, QuoteItemsResource as cG, type QuoteItemsResourceQueryParams as cH, QuoteLocationsResource as cI, type QuoteLocationsResourceQueryParams as cJ, QuoteTemplatesResource as cK, type QuoteTemplatesResourceQueryParams as cL, QuotesResource as cM, type QuotesResourceQueryParams as cN, REDACTED as cO, RateLimitError as cP, RecoveryTruncatedError as cQ, type RequestOptions as cR, ResolutionError as cS, type ResolvedAutotaskConfig as cT, ResourceRoleQueuesResource as cU, type ResourceRoleQueuesResourceQueryParams as cV, ResourceRolesResource as cW, type ResourceRolesResourceQueryParams as cX, ResourceSkillsResource as cY, type ResourceSkillsResourceQueryParams as cZ, ResourceTimeOffAdditionalResource as c_, type PhasesResourceQueryParams as ca, ProductVendorsResource as cb, type ProductVendorsResourceQueryParams as cc, ProductsResource as cd, type ProductsResourceQueryParams as ce, type ProfitRateSource as cf, type ProfitabilityActivityCategory as cg, type ProfitabilityDataQualityWarning as ch, type ProfitabilityHighestCostTicket as ci, type ProfitabilityLabourCostMethod as cj, type ProfitabilityMiscoding as ck, type ProfitabilityMonthlyRow as cl, type ProfitabilityOpenRenewalItem as cm, type ProfitabilityOptions as cn, type ProfitabilityPart as co, type ProfitabilityPartDigest as cp, type ProfitabilityRevenueByType as cq, ProjectChargesResource as cr, type ProjectChargesResourceQueryParams as cs, ProjectNotesResource as ct, type ProjectNotesResourceQueryParams as cu, ProjectsResource as cv, type ProjectsResourceQueryParams as cw, PurchaseApprovalsResource as cx, type PurchaseApprovalsResourceQueryParams as cy, PurchaseOrderItemReceivingResource as cz, type AppointmentsResourceQueryParams as d, TicketChecklistLibrariesResource as d$, ResourceTimeOffApproversResource as d0, type ResourceTimeOffApproversResourceQueryParams as d1, ResourceTimeOffBalancesResource as d2, type ResourceTimeOffBalancesResourceQueryParams as d3, ResourcesResource as d4, type ResourcesResourceQueryParams as d5, ResponseRejectedError as d6, RolesResource as d7, type RolesResourceQueryParams as d8, ServerError as d9, TagAliasesResource as dA, type TagAliasesResourceQueryParams as dB, TagGroupsResource as dC, type TagGroupsResourceQueryParams as dD, TagsResource as dE, type TagsResourceQueryParams as dF, TaskSecondaryResourcesResource as dG, type TaskSecondaryResourcesResourceQueryParams as dH, TasksResource as dI, type TasksResourceQueryParams as dJ, ThresholdInformationResource as dK, TicketAdditionalConfigurationItemsResource as dL, type TicketAdditionalConfigurationItemsResourceQueryParams as dM, TicketAdditionalContactsResource as dN, type TicketAdditionalContactsResourceQueryParams as dO, TicketAttachmentsResource as dP, type TicketAttachmentsResourceQueryParams as dQ, TicketCategoriesResource as dR, type TicketCategoriesResourceQueryParams as dS, TicketCategoryFieldDefaultsResource as dT, type TicketCategoryFieldDefaultsResourceQueryParams as dU, TicketChangeRequestApprovalsResource as dV, type TicketChangeRequestApprovalsResourceQueryParams as dW, TicketChargesResource as dX, type TicketChargesResourceQueryParams as dY, TicketChecklistItemsResource as dZ, type TicketChecklistItemsResourceQueryParams as d_, ServiceCallTaskResourcesResource as da, type ServiceCallTaskResourcesResourceQueryParams as db, ServiceCallTasksResource as dc, type ServiceCallTasksResourceQueryParams as dd, ServiceCallTicketResourcesResource as de, type ServiceCallTicketResourcesResourceQueryParams as df, ServiceCallTicketsResource as dg, type ServiceCallTicketsResourceQueryParams as dh, ServiceCallsResource as di, type ServiceCallsResourceQueryParams as dj, ServiceLevelAgreementResultsResource as dk, type ServiceLevelAgreementResultsResourceQueryParams as dl, ServicesResource as dm, type ServicesResourceQueryParams as dn, SkillsResource as dp, type SkillsResourceQueryParams as dq, StaleObjectError as dr, SubscriptionPeriodsResource as ds, type SubscriptionPeriodsResourceQueryParams as dt, SubscriptionsResource as du, type SubscriptionsResourceQueryParams as dv, SurveyResultsResource as dw, type SurveyResultsResourceQueryParams as dx, SurveysResource as dy, type SurveysResourceQueryParams as dz, AuthenticateResource as e, unwrapOperation as e$, type TicketChecklistLibrariesResourceQueryParams as e0, TicketHistoryResource as e1, type TicketHistoryResourceQueryParams as e2, TicketNoteAttachmentsResource as e3, type TicketNoteAttachmentsResourceQueryParams as e4, TicketNoteWebhooksResource as e5, type TicketNoteWebhooksResourceQueryParams as e6, TicketNotesResource as e7, type TicketNotesResourceQueryParams as e8, TicketSecondaryResourcesResource as e9, collectAll as eA, cooldownDurationMs as eB, cursorToPath as eC, defaultCircuitBreakerStore as eD, defaultCooldownStore as eE, errorFromStatus as eF, formatVendorDetail as eG, isAutotaskError as eH, isBreakerFailure as eI, isCredentialHeaderName as eJ, isDeterministicVendor500 as eK, mergeDetails as eL, paginate as eM, paginateItems as eN, parseVendorErrors as eO, passthrough as eP, redactRecord as eQ, resetDefaultCircuitBreakerStore as eR, resetDefaultCooldownStore as eS, resolveBaseUrl as eT, resolveConfig as eU, resolveCredentials as eV, runWithSignal as eW, toArray as eX, totalPagesFor as eY, unwrapItem as eZ, unwrapItems as e_, type TicketSecondaryResourcesResourceQueryParams as ea, TicketWebhooksResource as eb, type TicketWebhooksResourceQueryParams as ec, TicketsResource as ed, type TicketsResourceQueryParams as ee, TimeEntriesResource as ef, type TimeEntriesResourceQueryParams as eg, TimeEntryAttachmentsResource as eh, type TimeEntryAttachmentsResourceQueryParams as ei, TimeOffRequestsResource as ej, type TimeOffRequestsResourceQueryParams as ek, UnauthorizedError as el, UnexpectedContentTypeError as em, UnprocessableEntityError as en, type VendorFieldError as eo, VersionInformationResource as ep, VersionResource as eq, ZONES as er, ZONE_CATALOG as es, ZoneInformationResource as et, type ZoneName as eu, buildBreakerKey as ev, buildQueryRequest as ew, buildTenantKey as ex, buildUrl as ey, clampPageSize as ez, AutotaskAbortError as f, unwrapQueryCount as f0, zoneUrl as f1, type BlindSurfaceInfo as f2, type RelationshipResource as f3, type BlindSurfaceInventory as f4, type BlindSurfaceRow as f5, type CreateBlockerKind as f6, type CreateGuidanceReport as f7, type FieldCacheKind as f8, FIELD_CACHE_KINDS as f9, AutotaskConfigError as g, AutotaskError as h, type AutotaskErrorOptions as i, AutotaskNetworkError as j, AutotaskTimeoutError as k, BillingCodesResource as l, type BillingCodesResourceQueryParams as m, BillingItemsResource as n, type BillingItemsResourceQueryParams as o, CREDENTIAL_SHAPE_POINTER as p, ChangeRequestLinksResource as q, type ChangeRequestLinksResourceQueryParams as r, ChecklistLibrariesResource as s, type ChecklistLibrariesResourceQueryParams as t, ChecklistLibraryChecklistItemsResource as u, type ChecklistLibraryChecklistItemsResourceQueryParams as v, CircuitBreakerError as w, type CircuitBreakerState as x, type CircuitBreakerStore as y, ClassificationIconsResource as z };

package/dist/{index-BXIwhAN4.d.cts → index-CjC0oWZX.d.cts}

@@ -198,7 +198,10 @@ declare class ResourceNameCache {
  * Every error carries the structured contract: `code` (stable SCREAMING_SNAKE
  * machine code), `category`, `retryable`, plus `operation`, `httpStatus`,
  * `vendorError` (the vendor payload under a documented key, deep-redacted —
- * the INV-A1 hotfix), `resourceIds`,
+ * the INV-A1 hotfix), `resourceIds` (the LEGACY unlabeled id list — the
+ * stamp sites name records of several vendor entities and say nothing about
+ * which; every SDK stamp site that sets it also sets `details.idRefs`, the
+ * labeled `{ entity, id }` companion — issue #116),
  * `suggestedAction` (deterministic next step only), `correlationId` and `url`.
  *
  * `item: null` on a single GET (HTTP 200) is a NOT FOUND, not a success — the
@@ -207,12 +210,49 @@ declare class ResourceNameCache {
  * the node's errorHandler and parsed defensively here.
  */
 type ErrorCategory = 'auth' | 'not_found' | 'validation' | 'conflict' | 'rate_limit' | 'server' | 'network' | 'timeout' | 'resolution' | 'policy';
+/**
+ * A labeled id reference (issue #116). The legacy `resourceIds` field reads
+ * as Autotask **Resource** (staff) ids, but the special ops stamp ids of
+ * many other entities into it (ticket / company / contact / billing-code /
+ * the failed record's own id on a generic `get`), unlabeled — so feeding an
+ * error's `resourceIds` to `operations.expandResourceNames` (whose only wire
+ * verb is `GET /V1.0/Resources/{id}`) resolves a colliding non-staff id to
+ * an unrelated person's name. Every SDK stamp site that sets `resourceIds`
+ * now also sets `details.idRefs` — the same ids, each labeled with the vendor entity
+ * it identifies — so consumers can resolve against the entity the error
+ * actually names instead of parsing the message.
+ *
+ * `entity` is the vendor entity name (singular snake_case — `company`,
+ * `ticket`, `contact`, `billing_code`, `resource`, ...; the de-pluralized
+ * vendor table name — the same word the error message uses; the SDK
+ * resource key is the same word plural). `resource` (staff) is the ONLY
+ * entity `operations.expandResourceNames` resolves — a ref of any other
+ * entity must NOT be fed to it.
+ */
+interface ErrorIdRef {
+    /** The vendor entity the id identifies (singular snake_case, e.g. `company`, `ticket`, `resource` = staff). */
+    entity: string;
+    /** The value that addresses the record at that entity's endpoint: the
+     *  vendor id (a safe integer, or the canonical integer-string form) —
+     *  except `resource_time_off_balances.getByYear`, where the endpoint's
+     *  path key is the YEAR (the vendor defines no record-id read for this
+     *  entity). */
+    id: number | string;
+}
 interface AutotaskErrorOptions {
     code?: string;
     category?: ErrorCategory;
     operation?: string;
     httpStatus?: number;
     vendorError?: unknown;
+    /**
+     * The ids the error is about. LEGACY, unlabeled: reads as Resource
+     * (staff) ids but the stamp sites name records of several entities
+     * (issue #116). Kept for compatibility; the labeled form rides on
+     * `details.idRefs` (`ErrorIdRef[]`) and is what consumers should use.
+     * The pairing above is a guarantee of the SDK stamp sites — an error you
+     * construct yourself may set `resourceIds` without `details.idRefs`.
+     */
     resourceIds?: (number | string)[];
     suggestedAction?: string;
     correlationId?: string;
@@ -224,9 +264,11 @@ interface AutotaskErrorOptions {
      * (`{ resource, reason/note, ... }` on DELETE_BOUNDARY /
      * MARKER_UNSAFE_ID / RECOVERY_TRUNCATED); issue #14 — `emptyReason`
      * (the typed reason a miss / drift carries — { kind, note, authority,
-     * remedy }) and `pointerNote` (the known-unusable-op pointer sentence).
-     * Additive only — the status, code, message and retryability are never
-     * derived from it.
+     * remedy }) and `pointerNote` (the known-unusable-op pointer sentence);
+     * issue #116 — `idRefs` (`ErrorIdRef[]`, the labeled `{ entity, id }`
+     * companion of the legacy `resourceIds` — every SDK stamp site that sets
+     * `resourceIds` also sets it). Additive only — the status, code, message
+     * and retryability are never derived from it.
      */
     details?: Record<string, unknown>;
 }
@@ -236,6 +278,7 @@ declare class AutotaskError extends Error {
     operation?: string;
     httpStatus?: number;
     vendorError?: unknown;
+    /** Legacy unlabeled id list (issue #116) — see `AutotaskErrorOptions.resourceIds`; the labeled companion rides on `details.idRefs`. */
     resourceIds?: (number | string)[];
     suggestedAction?: string;
     correlationId?: string;
@@ -784,6 +827,9 @@ declare const DEFAULT_PAGE_SIZE = 10;
 declare const MAX_PAGE_SIZE = 500;
 declare const DEFAULT_TIMEOUT_MS = 30000;
 declare const DEFAULT_MAX_RETRIES = 3;
+/** Autotask runs a weekly maintenance window (typically < 30 min); wait out one hour by default. */
+declare const DEFAULT_MAINTENANCE_MAX_WAIT_MS = 3600000;
+declare const DEFAULT_MAINTENANCE_POLL_MS = 30000;
 declare const DEFAULT_MAX_CONCURRENT = 10;
 /** Default response-size cap (64 MiB) — bounds a runaway/hostile body in memory. */
 declare const DEFAULT_MAX_RESPONSE_BYTES: number;
@@ -827,6 +873,23 @@ interface AutotaskConfig {
      * The client's retry budget (default 3; 0 disables auto-retry). Three legs, two rules (issues #105/#109): the 429 leg retries on the pre-#105 retriable set (GET/PUT/DELETE + idempotent-flagged calls); the 5xx/network leg and the non-JSON-2xx (#24) leg retry GET + idempotent-flagged calls only. A per-call override rides `InvokeOptions.maxRetries` / `MutationOpts.maxRetries`.
      */
     maxRetries?: number;
+    /**
+     * Maintenance-window auto-retry (the weekly Autotask maintenance window — the
+     * edge answers a non-JSON HTML page, `UNEXPECTED_CONTENT_TYPE`, before the
+     * vendor application ever sees the request). While such a page persists the
+     * transport waits `maintenancePollMs` and retries, up to this many ms from the
+     * first maintenance response. Default 3_600_000 (1 hour — a typical window is
+     * under 30 minutes); `0` disables the wait and surfaces the error at once.
+     *
+     * Applies to READS AND WRITES. The maintenance page is served by the edge (the
+     * vendor never processed the request), which is exactly the case where a
+     * bounded auto-retry is safe; the general `unknown` write-outcome rule is
+     * unaffected — a 5xx / network / timeout error never auto-retries a write.
+     * The wait does not consume the `maxRetries` budget and is bounded per call.
+     */
+    maintenanceMaxWaitMs?: number;
+    /** Poll interval while waiting out a maintenance page. Default 30_000. */
+    maintenancePollMs?: number;
     /** Optional request log sink. Default: no-op. */
     logger?: Logger;
     /** Concurrency guard (API allows <=10 concurrent). Default 10. */
@@ -1089,6 +1152,8 @@ interface ResolvedAutotaskConfig {
     pageSize: number;
     timeoutMs: number;
     maxRetries: number;
+    maintenanceMaxWaitMs: number;
+    maintenancePollMs: number;
     maxConcurrent: number;
     maxResponseBytes: number;
     logger: Logger;
@@ -1205,6 +1270,13 @@ interface RequestOptions {
      * the transport chain order.
      */
     maxRetries?: number;
+    /**
+     * Maintenance-window wait override (default: config.maintenanceMaxWaitMs).
+     * `0` disables the wait for this call. Does not consume `maxRetries`.
+     */
+    maintenanceMaxWaitMs?: number;
+    /** Maintenance poll override (default: config.maintenancePollMs). */
+    maintenancePollMs?: number;
     /**
      * Issue #25: does this call expect a non-empty 2xx body? Default:
      * `method !== 'DELETE'` (computed in `request`) — a blank 2xx on a
@@ -1326,6 +1398,9 @@ declare class HttpClient {
     };
     private readonly auth;
     private readonly maxRetries;
+    /** Maintenance-window auto-retry budget + poll (issue #112 follow-up; see config). */
+    private readonly maintenanceMaxWaitMs;
+    private readonly maintenancePollMs;
     private readonly maxResponseBytes;
     private readonly perHour;
     /** The resolved profile (issue #4) — the agent profile changes the
@@ -1475,9 +1550,13 @@ declare function unwrapItems<T>(body: unknown, operation?: string): {
 /**
  * get: expects `{ item: T }`. `item === null` THROWS `NotFoundError` (the
  * vendor not-found signal — HTTP may be 200) with `httpStatus: 200` and
- * `resourceIds: [id]` when `id` is given.
+ * `resourceIds: [id]` when `id` is given — and, when `entity` is given as
+ * well, the labeled companion `details.idRefs: [{ entity, id }]` (issue
+ * #116: the legacy field never says which vendor table the id addresses,
+ * and the caller of a generic get knows it — the vendor entity name,
+ * singular snake_case, e.g. `company`, `ticket`, `resource`).
  */
-declare function unwrapItem<T>(body: unknown, id?: Identifier, operation?: string): T;
+declare function unwrapItem<T>(body: unknown, id?: Identifier, operation?: string, entity?: string): T;
 /** count: expects `{ queryCount: number }` (an object, not a bare number) → the plain number. */
 declare function unwrapQueryCount(body: unknown, operation?: string): number;
 /** create/update/delete: expects `{ itemId }` (accepts `{ id }` too) → `{ id }`. */
@@ -1993,6 +2072,8 @@ declare abstract class BaseResource<T = Record<string, unknown>, TCreate = Recor
     protected readonly defaultPageSize: number;
     /** Versioned global URL segment (from the config), e.g. '/V1.0/Companies'. */
     protected get resourcePath(): string;
+    /** The vendor entity this resource's ids identify (issue #116 — the `details.idRefs` label, e.g. `company`). */
+    protected get entityName(): string;
     /** Parent-scoped template (from the config); undefined for top-level resources. */
     protected get parentScopedPath(): string | undefined;
     /** Parent field used to narrow the global query (from the config). */
@@ -9255,4 +9336,4 @@ declare class AutotaskClient {
     }): Promise<PromiseSettledResult<R>[]>;
 }
 
-export { ConfigurationItemRelatedItemsResource as $, type AutotaskConfig as A, BadRequestError as B, CREDENTIAL_HEADER_NAMES as C, type ClassificationIconsResourceQueryParams as D, CompaniesResource as E, type CompaniesResourceQueryParams as F, CompanyAlertsResource as G, type CompanyAlertsResourceQueryParams as H, CompanyLocationsResource as I, type CompanyLocationsResourceQueryParams as J, CompanyNotesResource as K, type CompanyNotesResourceQueryParams as L, CompanySiteConfigurationsResource as M, type CompanySiteConfigurationsResourceQueryParams as N, CompanyWebhooksResource as O, type CompanyWebhooksResourceQueryParams as P, type ConfigProfile as Q, ConfigurationItemBillingProductAssociationsResource as R, type ConfigurationItemBillingProductAssociationsResourceQueryParams as S, ConfigurationItemCategoriesResource as T, type ConfigurationItemCategoriesResourceQueryParams as U, ConfigurationItemCategoryUdfAssociationsResource as V, type ConfigurationItemCategoryUdfAssociationsResourceQueryParams as W, ConfigurationItemDnsRecordsResource as X, type ConfigurationItemDnsRecordsResourceQueryParams as Y, ConfigurationItemNotesResource as Z, type ConfigurationItemNotesResourceQueryParams as _, AutotaskClient as a, type ContractsResourceQueryParams as a$, type ConfigurationItemRelatedItemsResourceQueryParams as a0, ConfigurationItemSslSubjectAlternativeNamesResource as a1, type ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams as a2, ConfigurationItemTypesResource as a3, type ConfigurationItemTypesResourceQueryParams as a4, ConfigurationItemWebhooksResource as a5, type ConfigurationItemWebhooksResourceQueryParams as a6, ConfigurationItemsResource as a7, type ConfigurationItemsResourceQueryParams as a8, ConfirmationRequiredError as a9, type ContractExclusionSetsResourceQueryParams as aA, ContractMilestonesResource as aB, type ContractMilestonesResourceQueryParams as aC, ContractNotesResource as aD, type ContractNotesResourceQueryParams as aE, ContractRatesResource as aF, type ContractRatesResourceQueryParams as aG, ContractRetainersResource as aH, type ContractRetainersResourceQueryParams as aI, ContractRoleCostsResource as aJ, type ContractRoleCostsResourceQueryParams as aK, ContractServiceAdjustmentsResource as aL, type ContractServiceAdjustmentsResourceQueryParams as aM, ContractServiceBundleAdjustmentsResource as aN, type ContractServiceBundleAdjustmentsResourceQueryParams as aO, ContractServiceBundleUnitsResource as aP, type ContractServiceBundleUnitsResourceQueryParams as aQ, ContractServiceBundlesResource as aR, type ContractServiceBundlesResourceQueryParams as aS, ContractServiceUnitsResource as aT, type ContractServiceUnitsResourceQueryParams as aU, ContractServicesResource as aV, type ContractServicesResourceQueryParams as aW, ContractTicketPurchasesResource as aX, type ContractTicketPurchasesResourceQueryParams as aY, type ContractsProfitabilityResult as aZ, ContractsResource as a_, ConflictError as aa, ContactGroupContactsResource as ab, type ContactGroupContactsResourceQueryParams as ac, ContactGroupsResource as ad, type ContactGroupsResourceQueryParams as ae, ContactWebhooksResource as af, type ContactWebhooksResourceQueryParams as ag, ContactsResource as ah, type ContactsResourceQueryParams as ai, ContractBillingRulesResource as aj, type ContractBillingRulesResourceQueryParams as ak, ContractBlockHourFactorsResource as al, type ContractBlockHourFactorsResourceQueryParams as am, ContractBlocksResource as an, type ContractBlocksResourceQueryParams as ao, ContractChargesResource as ap, type ContractChargesResourceQueryParams as aq, ContractExclusionBillingCodesResource as ar, type ContractExclusionBillingCodesResourceQueryParams as as, ContractExclusionRolesResource as at, type ContractExclusionRolesResourceQueryParams as au, ContractExclusionSetExcludedRolesResource as av, type ContractExclusionSetExcludedRolesResourceQueryParams as aw, ContractExclusionSetExcludedWorkTypesResource as ax, type ContractExclusionSetExcludedWorkTypesResourceQueryParams as ay, ContractExclusionSetsResource as az, AGENT_PROFILE as b, OpportunityAttachmentsResource as b$, type CooldownStore as b0, type CostRateResolution as b1, CountriesResource as b2, type CountriesResourceQueryParams as b3, type CredentialShapeExpectation as b4, DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD as b5, DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES as b6, DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS as b7, DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE as b8, DEFAULT_CIRCUIT_BREAKER_WINDOW_MS as b9, ExpenseReportsResource as bA, type ExpenseReportsResourceQueryParams as bB, ForbiddenError as bC, HolidaySetsResource as bD, type HolidaySetsResourceQueryParams as bE, HolidaysResource as bF, type HolidaysResourceQueryParams as bG, HostPolicyDeniedError as bH, HttpClient as bI, IDEMPOTENT_METHODS as bJ, InMemoryCircuitBreakerStore as bK, InMemoryCooldownStore as bL, InventoryProductsResource as bM, type InventoryProductsResourceQueryParams as bN, InvoicesResource as bO, type InvoicesResourceQueryParams as bP, type Logger as bQ, MAX_PAGES as bR, MAX_PAGE_SIZE as bS, MarkerUnsafeIdError as bT, ModulesResource as bU, NoopLogger as bV, NotFoundError as bW, NotificationHistoryResource as bX, type NotificationHistoryResourceQueryParams as bY, OpportunitiesResource as bZ, type OpportunitiesResourceQueryParams as b_, DEFAULT_COOLDOWN_DEFAULT_MS as ba, DEFAULT_COOLDOWN_MAX_ENTRIES as bb, DEFAULT_COOLDOWN_MAX_MS as bc, DEFAULT_FIELD_CACHE_TTL_MS as bd, DEFAULT_MAX_CONCURRENT as be, DEFAULT_MAX_RESPONSE_BYTES as bf, DEFAULT_MAX_RETRIES as bg, DEFAULT_MAX_SCAN_PAGES as bh, DEFAULT_MAX_SCAN_RECORDS as bi, DEFAULT_PAGE_SIZE as bj, DEFAULT_READ_CACHE_TTL_MS as bk, DEFAULT_RESOURCE_NAME_CACHE_TTL_MS as bl, DEFAULT_TIMEOUT_MS as bm, DEFAULT_ZONE as bn, DeleteBoundaryError as bo, DepartmentsResource as bp, type DepartmentsResourceQueryParams as bq, DomainRegistrarsResource as br, type DomainRegistrarsResourceQueryParams as bs, EmptyResponseError as bt, EntityInformationResource as bu, type ErrorCategory as bv, ExpenseItemAttachmentsResource as bw, type ExpenseItemAttachmentsResourceQueryParams as bx, ExpenseItemsResource as by, type ExpenseItemsResourceQueryParams as bz, AppointmentsResource as c, ResourceTimeOffBalancesResource as c$, type OpportunityAttachmentsResourceQueryParams as c0, OpportunityCategoriesResource as c1, type OpportunityCategoriesResourceQueryParams as c2, type PageFetcher as c3, type PaginateOptions as c4, PaginationLimitError as c5, PhasesResource as c6, type PhasesResourceQueryParams as c7, ProductVendorsResource as c8, type ProductVendorsResourceQueryParams as c9, PurchaseOrdersResource as cA, type PurchaseOrdersResourceQueryParams as cB, QueryTooLongError as cC, QuoteItemsResource as cD, type QuoteItemsResourceQueryParams as cE, QuoteLocationsResource as cF, type QuoteLocationsResourceQueryParams as cG, QuoteTemplatesResource as cH, type QuoteTemplatesResourceQueryParams as cI, QuotesResource as cJ, type QuotesResourceQueryParams as cK, REDACTED as cL, RateLimitError as cM, RecoveryTruncatedError as cN, type RequestOptions as cO, ResolutionError as cP, type ResolvedAutotaskConfig as cQ, ResourceRoleQueuesResource as cR, type ResourceRoleQueuesResourceQueryParams as cS, ResourceRolesResource as cT, type ResourceRolesResourceQueryParams as cU, ResourceSkillsResource as cV, type ResourceSkillsResourceQueryParams as cW, ResourceTimeOffAdditionalResource as cX, type ResourceTimeOffAdditionalResourceQueryParams as cY, ResourceTimeOffApproversResource as cZ, type ResourceTimeOffApproversResourceQueryParams as c_, ProductsResource as ca, type ProductsResourceQueryParams as cb, type ProfitRateSource as cc, type ProfitabilityActivityCategory as cd, type ProfitabilityDataQualityWarning as ce, type ProfitabilityHighestCostTicket as cf, type ProfitabilityLabourCostMethod as cg, type ProfitabilityMiscoding as ch, type ProfitabilityMonthlyRow as ci, type ProfitabilityOpenRenewalItem as cj, type ProfitabilityOptions as ck, type ProfitabilityPart as cl, type ProfitabilityPartDigest as cm, type ProfitabilityRevenueByType as cn, ProjectChargesResource as co, type ProjectChargesResourceQueryParams as cp, ProjectNotesResource as cq, type ProjectNotesResourceQueryParams as cr, ProjectsResource as cs, type ProjectsResourceQueryParams as ct, PurchaseApprovalsResource as cu, type PurchaseApprovalsResourceQueryParams as cv, PurchaseOrderItemReceivingResource as cw, type PurchaseOrderItemReceivingResourceQueryParams as cx, PurchaseOrderItemsResource as cy, type PurchaseOrderItemsResourceQueryParams as cz, type AppointmentsResourceQueryParams as d, type TicketHistoryResourceQueryParams as d$, type ResourceTimeOffBalancesResourceQueryParams as d0, ResourcesResource as d1, type ResourcesResourceQueryParams as d2, ResponseRejectedError as d3, RolesResource as d4, type RolesResourceQueryParams as d5, ServerError as d6, ServiceCallTaskResourcesResource as d7, type ServiceCallTaskResourcesResourceQueryParams as d8, ServiceCallTasksResource as d9, type TagGroupsResourceQueryParams as dA, TagsResource as dB, type TagsResourceQueryParams as dC, TaskSecondaryResourcesResource as dD, type TaskSecondaryResourcesResourceQueryParams as dE, TasksResource as dF, type TasksResourceQueryParams as dG, ThresholdInformationResource as dH, TicketAdditionalConfigurationItemsResource as dI, type TicketAdditionalConfigurationItemsResourceQueryParams as dJ, TicketAdditionalContactsResource as dK, type TicketAdditionalContactsResourceQueryParams as dL, TicketAttachmentsResource as dM, type TicketAttachmentsResourceQueryParams as dN, TicketCategoriesResource as dO, type TicketCategoriesResourceQueryParams as dP, TicketCategoryFieldDefaultsResource as dQ, type TicketCategoryFieldDefaultsResourceQueryParams as dR, TicketChangeRequestApprovalsResource as dS, type TicketChangeRequestApprovalsResourceQueryParams as dT, TicketChargesResource as dU, type TicketChargesResourceQueryParams as dV, TicketChecklistItemsResource as dW, type TicketChecklistItemsResourceQueryParams as dX, TicketChecklistLibrariesResource as dY, type TicketChecklistLibrariesResourceQueryParams as dZ, TicketHistoryResource as d_, type ServiceCallTasksResourceQueryParams as da, ServiceCallTicketResourcesResource as db, type ServiceCallTicketResourcesResourceQueryParams as dc, ServiceCallTicketsResource as dd, type ServiceCallTicketsResourceQueryParams as de, ServiceCallsResource as df, type ServiceCallsResourceQueryParams as dg, ServiceLevelAgreementResultsResource as dh, type ServiceLevelAgreementResultsResourceQueryParams as di, ServicesResource as dj, type ServicesResourceQueryParams as dk, SkillsResource as dl, type SkillsResourceQueryParams as dm, StaleObjectError as dn, SubscriptionPeriodsResource as dp, type SubscriptionPeriodsResourceQueryParams as dq, SubscriptionsResource as dr, type SubscriptionsResourceQueryParams as ds, SurveyResultsResource as dt, type SurveyResultsResourceQueryParams as du, SurveysResource as dv, type SurveysResourceQueryParams as dw, TagAliasesResource as dx, type TagAliasesResourceQueryParams as dy, TagGroupsResource as dz, AuthenticateResource as e, type BlindSurfaceInfo as e$, TicketNoteAttachmentsResource as e0, type TicketNoteAttachmentsResourceQueryParams as e1, TicketNoteWebhooksResource as e2, type TicketNoteWebhooksResourceQueryParams as e3, TicketNotesResource as e4, type TicketNotesResourceQueryParams as e5, TicketSecondaryResourcesResource as e6, type TicketSecondaryResourcesResourceQueryParams as e7, TicketWebhooksResource as e8, type TicketWebhooksResourceQueryParams as e9, defaultCircuitBreakerStore as eA, defaultCooldownStore as eB, errorFromStatus as eC, formatVendorDetail as eD, isAutotaskError as eE, isBreakerFailure as eF, isCredentialHeaderName as eG, isDeterministicVendor500 as eH, mergeDetails as eI, paginate as eJ, paginateItems as eK, parseVendorErrors as eL, passthrough as eM, redactRecord as eN, resetDefaultCircuitBreakerStore as eO, resetDefaultCooldownStore as eP, resolveBaseUrl as eQ, resolveConfig as eR, resolveCredentials as eS, runWithSignal as eT, toArray as eU, totalPagesFor as eV, unwrapItem as eW, unwrapItems as eX, unwrapOperation as eY, unwrapQueryCount as eZ, zoneUrl as e_, TicketsResource as ea, type TicketsResourceQueryParams as eb, TimeEntriesResource as ec, type TimeEntriesResourceQueryParams as ed, TimeEntryAttachmentsResource as ee, type TimeEntryAttachmentsResourceQueryParams as ef, TimeOffRequestsResource as eg, type TimeOffRequestsResourceQueryParams as eh, UnauthorizedError as ei, UnexpectedContentTypeError as ej, UnprocessableEntityError as ek, type VendorFieldError as el, VersionInformationResource as em, VersionResource as en, ZONES as eo, ZONE_CATALOG as ep, ZoneInformationResource as eq, type ZoneName as er, buildBreakerKey as es, buildQueryRequest as et, buildTenantKey as eu, buildUrl as ev, clampPageSize as ew, collectAll as ex, cooldownDurationMs as ey, cursorToPath as ez, AutotaskAbortError as f, type RelationshipResource as f0, type BlindSurfaceInventory as f1, type BlindSurfaceRow as f2, type CreateBlockerKind as f3, type CreateGuidanceReport as f4, type FieldCacheKind as f5, FIELD_CACHE_KINDS as f6, AutotaskConfigError as g, AutotaskError as h, type AutotaskErrorOptions as i, AutotaskNetworkError as j, AutotaskTimeoutError as k, BillingCodesResource as l, type BillingCodesResourceQueryParams as m, BillingItemsResource as n, type BillingItemsResourceQueryParams as o, CREDENTIAL_SHAPE_POINTER as p, ChangeRequestLinksResource as q, type ChangeRequestLinksResourceQueryParams as r, ChecklistLibrariesResource as s, type ChecklistLibrariesResourceQueryParams as t, ChecklistLibraryChecklistItemsResource as u, type ChecklistLibraryChecklistItemsResourceQueryParams as v, CircuitBreakerError as w, type CircuitBreakerState as x, type CircuitBreakerStore as y, ClassificationIconsResource as z };
+export { ConfigurationItemRelatedItemsResource as $, type AutotaskConfig as A, BadRequestError as B, CREDENTIAL_HEADER_NAMES as C, type ClassificationIconsResourceQueryParams as D, CompaniesResource as E, type CompaniesResourceQueryParams as F, CompanyAlertsResource as G, type CompanyAlertsResourceQueryParams as H, CompanyLocationsResource as I, type CompanyLocationsResourceQueryParams as J, CompanyNotesResource as K, type CompanyNotesResourceQueryParams as L, CompanySiteConfigurationsResource as M, type CompanySiteConfigurationsResourceQueryParams as N, CompanyWebhooksResource as O, type CompanyWebhooksResourceQueryParams as P, type ConfigProfile as Q, ConfigurationItemBillingProductAssociationsResource as R, type ConfigurationItemBillingProductAssociationsResourceQueryParams as S, ConfigurationItemCategoriesResource as T, type ConfigurationItemCategoriesResourceQueryParams as U, ConfigurationItemCategoryUdfAssociationsResource as V, type ConfigurationItemCategoryUdfAssociationsResourceQueryParams as W, ConfigurationItemDnsRecordsResource as X, type ConfigurationItemDnsRecordsResourceQueryParams as Y, ConfigurationItemNotesResource as Z, type ConfigurationItemNotesResourceQueryParams as _, AutotaskClient as a, type ContractsResourceQueryParams as a$, type ConfigurationItemRelatedItemsResourceQueryParams as a0, ConfigurationItemSslSubjectAlternativeNamesResource as a1, type ConfigurationItemSslSubjectAlternativeNamesResourceQueryParams as a2, ConfigurationItemTypesResource as a3, type ConfigurationItemTypesResourceQueryParams as a4, ConfigurationItemWebhooksResource as a5, type ConfigurationItemWebhooksResourceQueryParams as a6, ConfigurationItemsResource as a7, type ConfigurationItemsResourceQueryParams as a8, ConfirmationRequiredError as a9, type ContractExclusionSetsResourceQueryParams as aA, ContractMilestonesResource as aB, type ContractMilestonesResourceQueryParams as aC, ContractNotesResource as aD, type ContractNotesResourceQueryParams as aE, ContractRatesResource as aF, type ContractRatesResourceQueryParams as aG, ContractRetainersResource as aH, type ContractRetainersResourceQueryParams as aI, ContractRoleCostsResource as aJ, type ContractRoleCostsResourceQueryParams as aK, ContractServiceAdjustmentsResource as aL, type ContractServiceAdjustmentsResourceQueryParams as aM, ContractServiceBundleAdjustmentsResource as aN, type ContractServiceBundleAdjustmentsResourceQueryParams as aO, ContractServiceBundleUnitsResource as aP, type ContractServiceBundleUnitsResourceQueryParams as aQ, ContractServiceBundlesResource as aR, type ContractServiceBundlesResourceQueryParams as aS, ContractServiceUnitsResource as aT, type ContractServiceUnitsResourceQueryParams as aU, ContractServicesResource as aV, type ContractServicesResourceQueryParams as aW, ContractTicketPurchasesResource as aX, type ContractTicketPurchasesResourceQueryParams as aY, type ContractsProfitabilityResult as aZ, ContractsResource as a_, ConflictError as aa, ContactGroupContactsResource as ab, type ContactGroupContactsResourceQueryParams as ac, ContactGroupsResource as ad, type ContactGroupsResourceQueryParams as ae, ContactWebhooksResource as af, type ContactWebhooksResourceQueryParams as ag, ContactsResource as ah, type ContactsResourceQueryParams as ai, ContractBillingRulesResource as aj, type ContractBillingRulesResourceQueryParams as ak, ContractBlockHourFactorsResource as al, type ContractBlockHourFactorsResourceQueryParams as am, ContractBlocksResource as an, type ContractBlocksResourceQueryParams as ao, ContractChargesResource as ap, type ContractChargesResourceQueryParams as aq, ContractExclusionBillingCodesResource as ar, type ContractExclusionBillingCodesResourceQueryParams as as, ContractExclusionRolesResource as at, type ContractExclusionRolesResourceQueryParams as au, ContractExclusionSetExcludedRolesResource as av, type ContractExclusionSetExcludedRolesResourceQueryParams as aw, ContractExclusionSetExcludedWorkTypesResource as ax, type ContractExclusionSetExcludedWorkTypesResourceQueryParams as ay, ContractExclusionSetsResource as az, AGENT_PROFILE as b, type NotificationHistoryResourceQueryParams as b$, type CooldownStore as b0, type CostRateResolution as b1, CountriesResource as b2, type CountriesResourceQueryParams as b3, type CredentialShapeExpectation as b4, DEFAULT_CIRCUIT_BREAKER_FAILURE_THRESHOLD as b5, DEFAULT_CIRCUIT_BREAKER_MAX_ENTRIES as b6, DEFAULT_CIRCUIT_BREAKER_OPEN_TIMEOUT_MS as b7, DEFAULT_CIRCUIT_BREAKER_SUCCESSES_TO_CLOSE as b8, DEFAULT_CIRCUIT_BREAKER_WINDOW_MS as b9, type ExpenseItemAttachmentsResourceQueryParams as bA, ExpenseItemsResource as bB, type ExpenseItemsResourceQueryParams as bC, ExpenseReportsResource as bD, type ExpenseReportsResourceQueryParams as bE, ForbiddenError as bF, HolidaySetsResource as bG, type HolidaySetsResourceQueryParams as bH, HolidaysResource as bI, type HolidaysResourceQueryParams as bJ, HostPolicyDeniedError as bK, HttpClient as bL, IDEMPOTENT_METHODS as bM, InMemoryCircuitBreakerStore as bN, InMemoryCooldownStore as bO, InventoryProductsResource as bP, type InventoryProductsResourceQueryParams as bQ, InvoicesResource as bR, type InvoicesResourceQueryParams as bS, type Logger as bT, MAX_PAGES as bU, MAX_PAGE_SIZE as bV, MarkerUnsafeIdError as bW, ModulesResource as bX, NoopLogger as bY, NotFoundError as bZ, NotificationHistoryResource as b_, DEFAULT_COOLDOWN_DEFAULT_MS as ba, DEFAULT_COOLDOWN_MAX_ENTRIES as bb, DEFAULT_COOLDOWN_MAX_MS as bc, DEFAULT_FIELD_CACHE_TTL_MS as bd, DEFAULT_MAINTENANCE_MAX_WAIT_MS as be, DEFAULT_MAINTENANCE_POLL_MS as bf, DEFAULT_MAX_CONCURRENT as bg, DEFAULT_MAX_RESPONSE_BYTES as bh, DEFAULT_MAX_RETRIES as bi, DEFAULT_MAX_SCAN_PAGES as bj, DEFAULT_MAX_SCAN_RECORDS as bk, DEFAULT_PAGE_SIZE as bl, DEFAULT_READ_CACHE_TTL_MS as bm, DEFAULT_RESOURCE_NAME_CACHE_TTL_MS as bn, DEFAULT_TIMEOUT_MS as bo, DEFAULT_ZONE as bp, DeleteBoundaryError as bq, DepartmentsResource as br, type DepartmentsResourceQueryParams as bs, DomainRegistrarsResource as bt, type DomainRegistrarsResourceQueryParams as bu, EmptyResponseError as bv, EntityInformationResource as bw, type ErrorCategory as bx, type ErrorIdRef as by, ExpenseItemAttachmentsResource as bz, AppointmentsResource as c, type ResourceTimeOffAdditionalResourceQueryParams as c$, OpportunitiesResource as c0, type OpportunitiesResourceQueryParams as c1, OpportunityAttachmentsResource as c2, type OpportunityAttachmentsResourceQueryParams as c3, OpportunityCategoriesResource as c4, type OpportunityCategoriesResourceQueryParams as c5, type PageFetcher as c6, type PaginateOptions as c7, PaginationLimitError as c8, PhasesResource as c9, type PurchaseOrderItemReceivingResourceQueryParams as cA, PurchaseOrderItemsResource as cB, type PurchaseOrderItemsResourceQueryParams as cC, PurchaseOrdersResource as cD, type PurchaseOrdersResourceQueryParams as cE, QueryTooLongError as cF, QuoteItemsResource as cG, type QuoteItemsResourceQueryParams as cH, QuoteLocationsResource as cI, type QuoteLocationsResourceQueryParams as cJ, QuoteTemplatesResource as cK, type QuoteTemplatesResourceQueryParams as cL, QuotesResource as cM, type QuotesResourceQueryParams as cN, REDACTED as cO, RateLimitError as cP, RecoveryTruncatedError as cQ, type RequestOptions as cR, ResolutionError as cS, type ResolvedAutotaskConfig as cT, ResourceRoleQueuesResource as cU, type ResourceRoleQueuesResourceQueryParams as cV, ResourceRolesResource as cW, type ResourceRolesResourceQueryParams as cX, ResourceSkillsResource as cY, type ResourceSkillsResourceQueryParams as cZ, ResourceTimeOffAdditionalResource as c_, type PhasesResourceQueryParams as ca, ProductVendorsResource as cb, type ProductVendorsResourceQueryParams as cc, ProductsResource as cd, type ProductsResourceQueryParams as ce, type ProfitRateSource as cf, type ProfitabilityActivityCategory as cg, type ProfitabilityDataQualityWarning as ch, type ProfitabilityHighestCostTicket as ci, type ProfitabilityLabourCostMethod as cj, type ProfitabilityMiscoding as ck, type ProfitabilityMonthlyRow as cl, type ProfitabilityOpenRenewalItem as cm, type ProfitabilityOptions as cn, type ProfitabilityPart as co, type ProfitabilityPartDigest as cp, type ProfitabilityRevenueByType as cq, ProjectChargesResource as cr, type ProjectChargesResourceQueryParams as cs, ProjectNotesResource as ct, type ProjectNotesResourceQueryParams as cu, ProjectsResource as cv, type ProjectsResourceQueryParams as cw, PurchaseApprovalsResource as cx, type PurchaseApprovalsResourceQueryParams as cy, PurchaseOrderItemReceivingResource as cz, type AppointmentsResourceQueryParams as d, TicketChecklistLibrariesResource as d$, ResourceTimeOffApproversResource as d0, type ResourceTimeOffApproversResourceQueryParams as d1, ResourceTimeOffBalancesResource as d2, type ResourceTimeOffBalancesResourceQueryParams as d3, ResourcesResource as d4, type ResourcesResourceQueryParams as d5, ResponseRejectedError as d6, RolesResource as d7, type RolesResourceQueryParams as d8, ServerError as d9, TagAliasesResource as dA, type TagAliasesResourceQueryParams as dB, TagGroupsResource as dC, type TagGroupsResourceQueryParams as dD, TagsResource as dE, type TagsResourceQueryParams as dF, TaskSecondaryResourcesResource as dG, type TaskSecondaryResourcesResourceQueryParams as dH, TasksResource as dI, type TasksResourceQueryParams as dJ, ThresholdInformationResource as dK, TicketAdditionalConfigurationItemsResource as dL, type TicketAdditionalConfigurationItemsResourceQueryParams as dM, TicketAdditionalContactsResource as dN, type TicketAdditionalContactsResourceQueryParams as dO, TicketAttachmentsResource as dP, type TicketAttachmentsResourceQueryParams as dQ, TicketCategoriesResource as dR, type TicketCategoriesResourceQueryParams as dS, TicketCategoryFieldDefaultsResource as dT, type TicketCategoryFieldDefaultsResourceQueryParams as dU, TicketChangeRequestApprovalsResource as dV, type TicketChangeRequestApprovalsResourceQueryParams as dW, TicketChargesResource as dX, type TicketChargesResourceQueryParams as dY, TicketChecklistItemsResource as dZ, type TicketChecklistItemsResourceQueryParams as d_, ServiceCallTaskResourcesResource as da, type ServiceCallTaskResourcesResourceQueryParams as db, ServiceCallTasksResource as dc, type ServiceCallTasksResourceQueryParams as dd, ServiceCallTicketResourcesResource as de, type ServiceCallTicketResourcesResourceQueryParams as df, ServiceCallTicketsResource as dg, type ServiceCallTicketsResourceQueryParams as dh, ServiceCallsResource as di, type ServiceCallsResourceQueryParams as dj, ServiceLevelAgreementResultsResource as dk, type ServiceLevelAgreementResultsResourceQueryParams as dl, ServicesResource as dm, type ServicesResourceQueryParams as dn, SkillsResource as dp, type SkillsResourceQueryParams as dq, StaleObjectError as dr, SubscriptionPeriodsResource as ds, type SubscriptionPeriodsResourceQueryParams as dt, SubscriptionsResource as du, type SubscriptionsResourceQueryParams as dv, SurveyResultsResource as dw, type SurveyResultsResourceQueryParams as dx, SurveysResource as dy, type SurveysResourceQueryParams as dz, AuthenticateResource as e, unwrapOperation as e$, type TicketChecklistLibrariesResourceQueryParams as e0, TicketHistoryResource as e1, type TicketHistoryResourceQueryParams as e2, TicketNoteAttachmentsResource as e3, type TicketNoteAttachmentsResourceQueryParams as e4, TicketNoteWebhooksResource as e5, type TicketNoteWebhooksResourceQueryParams as e6, TicketNotesResource as e7, type TicketNotesResourceQueryParams as e8, TicketSecondaryResourcesResource as e9, collectAll as eA, cooldownDurationMs as eB, cursorToPath as eC, defaultCircuitBreakerStore as eD, defaultCooldownStore as eE, errorFromStatus as eF, formatVendorDetail as eG, isAutotaskError as eH, isBreakerFailure as eI, isCredentialHeaderName as eJ, isDeterministicVendor500 as eK, mergeDetails as eL, paginate as eM, paginateItems as eN, parseVendorErrors as eO, passthrough as eP, redactRecord as eQ, resetDefaultCircuitBreakerStore as eR, resetDefaultCooldownStore as eS, resolveBaseUrl as eT, resolveConfig as eU, resolveCredentials as eV, runWithSignal as eW, toArray as eX, totalPagesFor as eY, unwrapItem as eZ, unwrapItems as e_, type TicketSecondaryResourcesResourceQueryParams as ea, TicketWebhooksResource as eb, type TicketWebhooksResourceQueryParams as ec, TicketsResource as ed, type TicketsResourceQueryParams as ee, TimeEntriesResource as ef, type TimeEntriesResourceQueryParams as eg, TimeEntryAttachmentsResource as eh, type TimeEntryAttachmentsResourceQueryParams as ei, TimeOffRequestsResource as ej, type TimeOffRequestsResourceQueryParams as ek, UnauthorizedError as el, UnexpectedContentTypeError as em, UnprocessableEntityError as en, type VendorFieldError as eo, VersionInformationResource as ep, VersionResource as eq, ZONES as er, ZONE_CATALOG as es, ZoneInformationResource as et, type ZoneName as eu, buildBreakerKey as ev, buildQueryRequest as ew, buildTenantKey as ex, buildUrl as ey, clampPageSize as ez, AutotaskAbortError as f, unwrapQueryCount as f0, zoneUrl as f1, type BlindSurfaceInfo as f2, type RelationshipResource as f3, type BlindSurfaceInventory as f4, type BlindSurfaceRow as f5, type CreateBlockerKind as f6, type CreateGuidanceReport as f7, type FieldCacheKind as f8, FIELD_CACHE_KINDS as f9, AutotaskConfigError as g, AutotaskError as h, type AutotaskErrorOptions as i, AutotaskNetworkError as j, AutotaskTimeoutError as k, BillingCodesResource as l, type BillingCodesResourceQueryParams as m, BillingItemsResource as n, type BillingItemsResourceQueryParams as o, CREDENTIAL_SHAPE_POINTER as p, ChangeRequestLinksResource as q, type ChangeRequestLinksResourceQueryParams as r, ChecklistLibrariesResource as s, type ChecklistLibrariesResourceQueryParams as t, ChecklistLibraryChecklistItemsResource as u, type ChecklistLibraryChecklistItemsResourceQueryParams as v, CircuitBreakerError as w, type CircuitBreakerState as x, type CircuitBreakerStore as y, ClassificationIconsResource as z };