node-autotask 0.10.0 → 0.12.0

package/dist/operations/index.js

@@ -8,10 +8,15 @@ import {
   DELETE_BOUNDARY_NOTES,
   DeleteBoundaryError,
   EXPAND_RESOURCE_NAMES_MAX_IDS,
+  FETCH_BY_IDS_CHUNK_SIZE,
+  FETCH_BY_IDS_MAX_ITEMS,
+  FETCH_MANY_MAX_ITEMS,
   FIELD_CACHE_KINDS,
   FIELD_CATALOG_HONESTY_NOTE,
   MARKER_FIELDS,
   MAX_FIELD_CATALOG_WIRE,
+  MODEL_DATE_FIELDS,
+  MODEL_FIELD_SETS,
   MarkerUnsafeIdError,
   NotFoundError,
   PICKLIST_VALUE_NOT_SERVED_NOTE,
@@ -21,19 +26,20 @@ import {
   RecoveryTruncatedError,
   WORKFLOW_RESOURCES,
   buildFilter,
-  buildQueryRequest,
   camelKey,
   clampPageSize,
   expandResourceNames,
+  fetchByIds,
+  fetchMany,
   fieldCatalog,
   isAutotaskError,
   isRecord,
   parseIdentifier,
-  unwrapItems
-} from "../chunk-HWC2WPX2.js";
+  validateFetchManyItems
+} from "../chunk-GD4JRPYF.js";
 import {
   CAPABILITIES
-} from "../chunk-6KFP5HV3.js";
+} from "../chunk-4A6XLQHE.js";
 
 // src/operations/searchAcrossResources.ts
 var DEFAULT_LIMIT = 25;
@@ -138,298 +144,64 @@ async function resolveAny(client, identifier, opts = {}) {
   return { identifier, results, matches };
 }
 
-// src/field-sets.ts
-var MODEL_FIELD_SETS = {
-  "appointments": ["id", "createDateTime", "creatorResourceID", "description", "endDateTime", "resourceID", "startDateTime", "title", "updateDateTime"],
-  "billing_codes": ["id", "afterHoursWorkType", "billingCodeType", "department", "description", "externalNumber", "generalLedgerAccount", "isActive", "isExcludedFromNewContracts", "markupRate", "name", "taxCategoryID", "unitCost", "unitPrice", "useType"],
-  "billing_items": ["id", "accountManagerWhenApprovedID", "billingCodeID", "billingItemType", "companyID", "configurationItemID", "contractBlockID", "contractChargeID", "contractID", "contractServiceAdjustmentID", "contractServiceBundleAdjustmentID", "contractServiceBundleID", "contractServiceBundlePeriodID", "contractServiceID", "contractServicePeriodID", "description", "expenseItemID", "extendedPrice", "internalCurrencyExtendedPrice", "internalCurrencyRate", "internalCurrencyTaxDollars", "internalCurrencyTotalAmount", "invoiceID", "itemApproverID", "itemDate", "itemName", "lineItemFullDescription", "lineItemGroupDescription", "milestoneID", "nonBillable", "organizationalLevelAssociationID", "ourCost", "postedDate", "postedOnTime", "projectChargeID", "projectID", "purchaseOrderNumber", "quantity", "rate", "roleID", "serviceBundleID", "serviceID", "sortOrderID", "subType", "taskID", "taxDollars", "ticketChargeID", "ticketID", "timeEntryID", "totalAmount", "vendorID", "webServiceDate"],
-  "change_request_links": ["id", "changeRequestTicketID", "problemOrIncidentTicketID"],
-  "checklist_libraries": ["id", "description", "entityType", "isActive", "name"],
-  "checklist_library_checklist_items": ["id", "checklistLibraryID", "isImportant", "itemName", "knowledgebaseArticleID", "position", "soapParentPropertyId"],
-  "classification_icons": ["id", "description", "isActive", "isSystem", "name", "relativeUrl"],
-  "companies": ["id", "additionalAddressInformation", "address1", "address2", "alternatePhone1", "alternatePhone2", "apiVendorID", "assetValue", "billToCompanyLocationID", "billToAdditionalAddressInformation", "billingAddress1", "billingAddress2", "billToAddressToUse", "billToAttention", "billToCity", "billToCountryID", "billToState", "billToZipCode", "city", "classification", "companyCategoryID", "companyName", "companyNumber", "companyType", "competitorID", "countryID", "createDate", "createdByResourceID", "currencyID", "fax", "impersonatorCreatorResourceID", "invoiceEmailMessageID", "invoiceMethod", "invoiceNonContractItemsToParentCompany", "invoiceTemplateID", "isActive", "isClientPortalActive", "isEnabledForComanaged", "isSample", "isTaskFireActive", "isTaxExempt", "lastActivityDate", "lastTrackedModifiedDateTime", "marketSegmentID", "ownerResourceID", "parentCompanyID", "phone", "postalCode", "purchaseOrderTemplateID", "quoteEmailMessageID", "quoteTemplateID", "sicCode", "state", "stockMarket", "stockSymbol", "surveyCompanyRating", "taxID", "taxRegionID", "territoryID", "webAddress", "userDefinedFields"],
-  "company_alerts": ["id", "alertText", "alertTypeID", "companyID", "soapParentPropertyId"],
-  "company_locations": ["id", "address1", "address2", "alternatePhone1", "alternatePhone2", "city", "companyID", "countryID", "description", "fax", "isActive", "isPrimary", "isTaxExempt", "overrideCompanyTaxSettings", "name", "phone", "postalCode", "roundtripDistance", "state", "taxRegionID", "soapParentPropertyId"],
-  "company_notes": ["id", "actionType", "assignedResourceID", "companyID", "completedDateTime", "contactID", "createDateTime", "endDateTime", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastModifiedDate", "name", "note", "opportunityID", "startDateTime", "soapParentPropertyId"],
-  "company_site_configurations": ["id", "companyID", "locationName", "soapParentPropertyId", "userDefinedFields"],
-  "company_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "configuration_item_billing_product_associations": ["id", "billingProductID", "configurationItemID", "effectiveDate", "expirationDate", "soapParentPropertyId"],
-  "configuration_item_categories": ["id", "displayColorRGB", "isActive", "isClientPortalDefault", "isGlobalDefault", "name", "nickname"],
-  "configuration_item_category_udf_associations": ["id", "configurationItemCategoryID", "isRequired", "userDefinedFieldDefinitionID", "soapParentPropertyId"],
-  "configuration_item_dns_records": ["id", "createDateTime", "data", "installedProductID", "timeToLiveSeconds", "dnsType", "soapParentPropertyId"],
-  "configuration_item_notes": ["id", "configurationItemID", "createDateTime", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "title", "soapParentPropertyId"],
-  "configuration_item_related_items": ["id", "configurationItemID", "relatedConfigurationItemID", "relationship", "soapParentPropertyId"],
-  "configuration_item_ssl_subject_alternative_names": ["id", "configurationItemID", "name", "soapParentPropertyId"],
-  "configuration_item_types": ["id", "isActive", "name"],
-  "configuration_item_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "configuration_items": ["id", "apiVendorID", "configurationItemCategoryID", "companyID", "companyLocationID", "configurationItemType", "contactID", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "createdByPersonID", "dailyCost", "dattoAvailableKilobytes", "dattoDeviceMemoryMegabytes", "dattoDrivesErrors", "dattoHostname", "dattoInternalIP", "dattoKernelVersionID", "dattoLastCheckInDateTime", "dattoNICSpeedKilobitsPerSecond", "dattoNumberOfAgents", "dattoNumberOfDrives", "dattoNumberOfVolumes", "dattoOffsiteUsedBytes", "dattoOSVersionID", "dattoPercentageUsed", "dattoProtectedKilobytes", "dattoRemoteIP", "dattoSerialNumber", "dattoUptimeSeconds", "dattoUsedKilobytes", "dattoZFSVersionID", "deviceNetworkingID", "domain", "domainRegistrarID", "domainRegistrationDateTime", "domainLastUpdatedDateTime", "domainExpirationDateTime", "hourlyCost", "impersonatorCreatorResourceID", "installDate", "installedByContactID", "installedByID", "isActive", "lastActivityPersonID", "lastActivityPersonType", "lastModifiedTime", "location", "monthlyCost", "notes", "numberOfUsers", "parentConfigurationItemID", "perUseCost", "productID", "referenceNumber", "referenceTitle", "rmmDeviceAuditAntivirusStatusID", "rmmDeviceAuditArchitectureID", "rmmDeviceAuditBackupStatusID", "rmmDeviceAuditDescription", "rmmDeviceAuditDeviceTypeID", "rmmDeviceAuditDisplayAdaptorID", "rmmDeviceAuditDomainID", "rmmDeviceAuditExternalIPAddress", "rmmDeviceAuditHostname", "rmmDeviceAuditIPAddress", "rmmDeviceAuditLastUser", "rmmDeviceAuditMacAddress", "rmmDeviceAuditManufacturerID", "rmmDeviceAuditFirmwareID", "rmmDeviceAuditMemoryBytes", "rmmDeviceAuditMissingPatchCount", "rmmDeviceAuditMobileNetworkOperatorID", "rmmDeviceAuditMobileNumber", "rmmDeviceAuditModelID", "rmmDeviceAuditMotherboardID", "rmmDeviceAuditOperatingSystem", "rmmDeviceAuditPatchStatusID", "rmmDeviceAuditProcessorID", "rmmDeviceAuditServicePackID", "rmmDeviceAuditSNMPContact", "rmmDeviceAuditSNMPLocation", "rmmDeviceAuditSNMPName", "rmmDeviceAuditSoftwareStatusID", "rmmDeviceAuditStorageBytes", "rmmDeviceID", "rmmDeviceUID", "rmmVsaxDeviceID", "rmmOpenAlertCount", "serialNumber", "serviceBundleID", "serviceID", "serviceLevelAgreementID", "setupFee", "sourceChargeID", "sourceChargeType", "sslSource", "sslCommonName", "sslValidFromDateTime", "sslValidUntilDateTime", "sslIssuedBy", "sslOrganization", "sslOrganizationUnit", "sslLocation", "sslSerialNumber", "sslSignatureAlgorithm", "vendorID", "warrantyExpirationDate", "rmmIsInMaintenanceMode", "rmmIsMobileDeviceManagementEnrolled", "rmmDeviceUrl", "userDefinedFields"],
-  "contact_group_contacts": ["id", "contactId", "contactGroupId", "soapParentPropertyId"],
-  "contact_groups": ["id", "name", "isActive"],
-  "contact_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "contacts": ["id", "additionalAddressInformation", "addressLine", "addressLine1", "alternatePhone", "apiVendorID", "bulkEmailOptOutTime", "city", "companyID", "companyLocationID", "countryID", "createDate", "emailAddress", "emailAddress2", "emailAddress3", "extension", "externalID", "facebookUrl", "faxNumber", "firstName", "impersonatorCreatorResourceID", "isActive", "isOptedOutFromBulkEmail", "lastActivityDate", "lastModifiedDate", "lastName", "linkedInUrl", "middleInitial", "mobilePhone", "namePrefix", "nameSuffix", "note", "receivesEmailNotifications", "phone", "primaryContact", "roomNumber", "solicitationOptOut", "solicitationOptOutTime", "state", "surveyOptOut", "title", "twitterUrl", "zipCode", "soapParentPropertyId", "userDefinedFields"],
-  "contract_billing_rules": ["id", "contractID", "createChargesAsBillable", "dailyProratedCost", "dailyProratedPrice", "determineUnits", "endDate", "executionMethod", "includeItemsInChargeDescription", "invoiceDescription", "isActive", "isDailyProrationEnabled", "maximumUnits", "minimumUnits", "productID", "startDate", "soapParentPropertyId"],
-  "contract_block_hour_factors": ["id", "blockHourMultiplier", "contractHourlyRate", "contractID", "internalCurrencyContractHourlyRate", "roleID", "soapParentPropertyId"],
-  "contract_blocks": ["id", "contractID", "datePurchased", "endDate", "hourlyRate", "hours", "hoursApproved", "invoiceNumber", "isPaid", "paymentNumber", "paymentType", "startDate", "status", "soapParentPropertyId"],
-  "contract_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
-  "contract_exclusion_billing_codes": ["id", "billingCodeID", "contractID", "soapParentPropertyId"],
-  "contract_exclusion_roles": ["id", "contractID", "roleID", "soapParentPropertyId"],
-  "contract_exclusion_set_excluded_roles": ["id", "contractExclusionSetID", "excludedRoleID", "soapParentPropertyId"],
-  "contract_exclusion_set_excluded_work_types": ["id", "contractExclusionSetID", "excludedWorkTypeID", "soapParentPropertyId"],
-  "contract_exclusion_sets": ["id", "description", "isActive", "name"],
-  "contract_milestones": ["id", "amount", "billingCodeID", "contractID", "createDate", "creatorResourceID", "dateDue", "description", "internalCurrencyAmount", "isInitialPayment", "organizationalLevelAssociationID", "status", "title", "soapParentPropertyId"],
-  "contract_notes": ["id", "contractID", "createDateTime", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "title", "soapParentPropertyId"],
-  "contract_rates": ["id", "contractHourlyRate", "contractID", "internalCurrencyContractHourlyRate", "roleID", "soapParentPropertyId"],
-  "contract_retainers": ["id", "amount", "amountApproved", "contractID", "datePurchased", "endDate", "internalCurrencyAmount", "internalCurrencyAmountApproved", "invoiceNumber", "isPaid", "paymentID", "paymentNumber", "startDate", "status", "soapParentPropertyId"],
-  "contract_role_costs": ["id", "contractID", "rate", "resourceID", "roleID", "soapParentPropertyId"],
-  "contract_service_bundle_units": ["id", "approveAndPostDate", "contractID", "contractServiceBundleID", "cost", "endDate", "internalCurrencyPrice", "organizationalLevelAssociationID", "price", "serviceBundleID", "startDate", "units", "soapParentPropertyId"],
-  "contract_service_bundles": ["id", "adjustedPrice", "contractID", "internalCurrencyAdjustedPrice", "internalCurrencyUnitPrice", "internalDescription", "invoiceDescription", "quoteItemID", "serviceBundleID", "unitPrice", "soapParentPropertyId"],
-  "contract_service_units": ["id", "approveAndPostDate", "contractID", "contractServiceID", "cost", "endDate", "internalCurrencyPrice", "organizationalLevelAssociationID", "price", "serviceID", "startDate", "units", "vendorCompanyID", "soapParentPropertyId"],
-  "contract_services": ["id", "contractID", "internalCurrencyAdjustedPrice", "internalCurrencyUnitPrice", "internalDescription", "invoiceDescription", "quoteItemID", "serviceID", "unitCost", "unitPrice", "soapParentPropertyId"],
-  "contract_ticket_purchases": ["id", "contractID", "datePurchased", "endDate", "invoiceNumber", "isPaid", "paymentNumber", "paymentType", "perTicketRate", "startDate", "status", "ticketsPurchased", "ticketsUsed", "soapParentPropertyId"],
-  "contracts": ["id", "billingPreference", "billToCompanyContactID", "billToCompanyID", "companyID", "contactID", "contactName", "contractCategory", "contractExclusionSetID", "contractName", "contractNumber", "contractPeriodType", "contractType", "description", "endDate", "estimatedCost", "estimatedHours", "estimatedRevenue", "exclusionContractID", "internalCurrencyOverageBillingRate", "internalCurrencySetupFee", "isCompliant", "isDefaultContract", "lastModifiedDateTime", "opportunityID", "organizationalLevelAssociationID", "overageBillingRate", "purchaseOrderNumber", "renewedContractID", "serviceLevelAgreementID", "setupFee", "setupFeeBillingCodeID", "startDate", "status", "timeReportingRequiresStartAndStopTimes", "userDefinedFields"],
-  "countries": ["id", "addressFormatID", "countryCode", "displayName", "invoiceTemplateID", "isActive", "isDefaultCountry", "name", "purchaseOrderTemplateID", "quoteTemplateID"],
-  "departments": ["id", "description", "name", "number", "primaryLocationID"],
-  "domain_registrars": ["id", "name", "url"],
-  "expense_item_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "expenseItemID", "expenseReportID", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "expense_items": ["id", "companyID", "description", "destination", "entertainmentLocation", "expenseCategory", "expenseCurrencyExpenseAmount", "expenseCurrencyID", "expenseDate", "expenseReportID", "glCode", "haveReceipt", "internalCurrencyExpenseAmount", "internalCurrencyReimbursementAmount", "isBillableToCompany", "isReimbursable", "isRejected", "miles", "odometerEnd", "odometerStart", "origin", "paymentType", "projectID", "purchaseOrderNumber", "reimbursementCurrencyReimbursementAmount", "taskID", "ticketID", "workType", "soapParentPropertyId"],
-  "expense_reports": ["id", "amountDue", "approvedDate", "approverID", "departmentNumber", "internalCurrencyCashAdvanceAmount", "internalCurrencyExpenseTotal", "name", "organizationalLevelAssociationID", "quickBooksReferenceNumber", "reimbursementCurrencyAmountDue", "reimbursementCurrencyCashAdvanceAmount", "reimbursementCurrencyID", "rejectionReason", "status", "submit", "submitDate", "submitterID", "weekEnding"],
-  "holiday_sets": ["id", "holidaySetDescription", "holidaySetName"],
-  "holidays": ["id", "holidayDate", "holidayName", "holidaySetID", "soapParentPropertyId"],
-  "inventory_products": ["id", "availableUnits", "backOrderQuantity", "bin", "createDateTime", "createdByResourceID", "inventoryLocationID", "onHandUnits", "pickedUnits", "productID", "quantityMaximum", "quantityMinimum", "referenceNumber", "reservedUnits", "unitsOnOrder"],
-  "invoices": ["id", "batchID", "comments", "companyID", "createDateTime", "creatorResourceID", "dueDate", "fromDate", "invoiceDateTime", "invoiceEditorTemplateID", "invoiceNumber", "invoiceTotal", "isVoided", "orderNumber", "paidDate", "paymentTerm", "taxGroup", "taxRegionName", "toDate", "totalTaxValue", "voidedByResourceID", "voidedDate", "webServiceDate"],
-  "notification_history": ["id", "companyID", "entityNumber", "entityTitle", "initiatingContactID", "initiatingResourceID", "isActive", "isDeleted", "isTemplateJob", "notificationHistoryTypeID", "notificationSentTime", "opportunityID", "projectID", "quoteID", "recipientDisplayName", "recipientEmailAddress", "taskID", "templateName", "ticketID", "timeEntryID"],
-  "opportunities": ["id", "advancedField1", "advancedField2", "advancedField3", "advancedField4", "advancedField5", "amount", "assessmentScore", "barriers", "closedDate", "companyID", "contactID", "cost", "createDate", "creatorResourceID", "description", "helpNeeded", "impersonatorCreatorResourceID", "lastActivity", "leadSource", "lossReason", "lossReasonDetail", "lostDate", "market", "monthlyCost", "monthlyRevenue", "nextStep", "onetimeCost", "onetimeRevenue", "opportunityCategoryID", "organizationalLevelAssociationID", "ownerResourceID", "primaryCompetitor", "probability", "productID", "projectedCloseDate", "promisedFulfillmentDate", "promotionName", "quarterlyCost", "quarterlyRevenue", "rating", "relationshipAssessmentScore", "revenueSpread", "revenueSpreadUnit", "salesOrderID", "salesProcessPercentComplete", "semiannualCost", "semiannualRevenue", "stage", "startDate", "status", "technicalAssessmentScore", "throughDate", "title", "totalAmountMonths", "useQuoteTotals", "winReason", "winReasonDetail", "yearlyCost", "yearlyRevenue", "userDefinedFields"],
-  "opportunity_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "opportunity_categories": ["id", "displayColorRGB", "isActive", "isGlobalDefault", "name", "nickname"],
-  "phases": ["id", "createDate", "creatorResourceID", "description", "dueDate", "estimatedHours", "externalID", "isScheduled", "lastActivityDateTime", "parentPhaseID", "phaseNumber", "projectID", "startDate", "title", "soapParentPropertyId"],
-  "product_vendors": ["id", "isActive", "isDefault", "productID", "vendorCost", "vendorID", "vendorPartNumber", "soapParentPropertyId"],
-  "products": ["id", "billingType", "chargeBillingCodeID", "createdByResourceID", "createdTime", "defaultVendorID", "description", "doesNotRequireProcurement", "externalProductID", "impersonatorCreatorResourceID", "internalProductID", "isActive", "isEligibleForRma", "isSerialized", "link", "manufacturerName", "manufacturerProductName", "markupRate", "msrp", "name", "periodType", "priceCostMethod", "productBillingCodeID", "productCategory", "sku", "unitCost", "unitPrice", "vendorProductNumber", "defaultInstalledProductCategoryID", "userDefinedFields"],
-  "project_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "estimatedCost", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "projectID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
-  "project_notes": ["id", "createDateTime", "createdByContactID", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "isAnnouncement", "lastActivityDate", "noteType", "projectID", "publish", "title", "soapParentPropertyId"],
-  "projects": ["id", "actualBilledHours", "actualHours", "changeOrdersBudget", "changeOrdersRevenue", "companyID", "companyOwnerResourceID", "completedDateTime", "completedPercentage", "contractID", "createDateTime", "creatorResourceID", "department", "description", "duration", "endDateTime", "estimatedSalesCost", "estimatedTime", "extProjectNumber", "extProjectType", "impersonatorCreatorResourceID", "laborEstimatedCosts", "laborEstimatedMarginPercentage", "laborEstimatedRevenue", "lastActivityDateTime", "lastActivityPersonType", "lastActivityResourceID", "opportunityID", "organizationalLevelAssociationID", "originalEstimatedRevenue", "projectCostEstimatedMarginPercentage", "projectCostsBudget", "projectCostsRevenue", "projectLeadResourceID", "projectName", "projectNumber", "projectType", "purchaseOrderNumber", "sgda", "startDateTime", "status", "statusDateTime", "statusDetail", "userDefinedFields"],
-  "purchase_approvals": ["id", "costType", "isApproved", "rejectNote"],
-  "purchase_order_item_receiving": ["id", "purchaseOrderItemID", "quantityBackOrdered", "quantityNowReceiving", "quantityPreviouslyReceived", "receiveDate", "receivedByResourceID", "serialNumber", "vendorInvoiceNumber", "soapParentPropertyId"],
-  "purchase_order_items": ["id", "chargeID", "contractID", "estimatedArrivalDate", "internalCurrencyUnitCost", "inventoryLocationID", "memo", "orderID", "productID", "projectID", "quantity", "salesOrderID", "ticketID", "unitCost", "soapParentPropertyId"],
-  "purchase_orders": ["id", "cancelDateTime", "createDateTime", "creatorResourceID", "externalPONumber", "fax", "freight", "generalMemo", "impersonatorCreatorResourceID", "internalCurrencyFreight", "latestEstimatedArrivalDate", "paymentTerm", "phone", "purchaseForCompanyID", "purchaseOrderNumber", "purchaseOrderTemplateID", "shippingDate", "shippingType", "shipToAddress1", "shipToAddress2", "shipToCity", "shipToName", "shipToPostalCode", "shipToState", "showEachTaxInGroup", "showTaxCategory", "status", "submitDateTime", "taxRegionID", "useItemDescriptionsFrom", "vendorID", "vendorInvoiceNumber", "additionalVendorInvoiceNumbers"],
-  "quote_items": ["id", "averageCost", "chargeID", "description", "expenseID", "highestCost", "internalCurrencyLineDiscount", "internalCurrencyUnitDiscount", "internalCurrencyUnitPrice", "isOptional", "isTaxable", "laborID", "lineDiscount", "markupRate", "name", "percentageDiscount", "periodType", "productID", "quantity", "quoteID", "quoteItemType", "serviceBundleID", "serviceID", "shippingID", "sortOrderID", "taxCategoryID", "totalEffectiveTax", "unitCost", "unitDiscount", "unitPrice", "soapParentPropertyId"],
-  "quote_locations": ["id", "address1", "address2", "city", "postalCode", "state"],
-  "quote_templates": ["id", "calculateTaxSeparately", "createDate", "createdBy", "currencyNegativeFormat", "currencyPositiveFormat", "dateFormat", "description", "displayTaxCategorySuperscripts", "isActive", "lastActivityBy", "lastActivityDate", "name", "numberFormat", "pageLayout", "pageNumberFormat", "showEachTaxInGroup", "showGridHeader", "showTaxCategory", "showVerticalGridLines"],
-  "quotes": ["id", "approvalStatus", "approvalStatusChangedByResourceID", "approvalStatusChangedDate", "billToLocationID", "calculateTaxSeparately", "comment", "companyID", "contactID", "createDate", "creatorResourceID", "description", "effectiveDate", "expirationDate", "extApprovalContactResponse", "extApprovalResponseDate", "extApprovalResponseSignature", "externalQuoteNumber", "groupByID", "impersonatorCreatorResourceID", "isActive", "lastActivityDate", "lastModifiedBy", "lastPublishedByResourceID", "lastPublishedDateTime", "name", "opportunityID", "paymentTerm", "paymentType", "primaryQuote", "proposalProjectID", "purchaseOrderNumber", "quoteNumber", "quoteTemplateID", "shippingType", "shipToLocationID", "showEachTaxInGroup", "showTaxCategory", "soldToLocationID", "taxRegionID"],
-  "resource_role_queues": ["id", "queueID", "resourceID", "soapParentPropertyId"],
-  "resource_roles": ["id", "departmentID", "isActive", "queueID", "resourceID", "roleID", "soapParentPropertyId"],
-  "resource_skills": ["id", "resourceID", "skillDescription", "skillID", "skillLevel", "soapParentPropertyId"],
-  "resource_time_off_approvers": ["id", "resourceID", "approverResourceID", "approvalLevel", "soapParentPropertyId"],
-  "resource_time_off_balances": ["id", "resourceID", "floatingHolidayAnnualAllowance", "floatingHolidayBalance", "floatingHolidayPlanned", "floatingHolidayUsed", "floatingHolidayWaitingApproval", "personalTimeAnnualAllowance", "personalTimeBalance", "personalTimePlanned", "personalTimeUsed", "personalTimeWaitingApproval", "sickTimeAnnualAllowance", "sickTimeBalance", "sickTimePlanned", "sickTimeUsed", "sickTimeWaitingApproval", "vacationTimeAnnualAllowance", "vacationTimeBalance", "vacationTimePlanned", "vacationTimeUsed", "vacationTimeWaitingApproval", "year", "soapParentPropertyId"],
-  "resources": ["id", "accountingReferenceID", "dateFormat", "defaultServiceDeskRoleID", "email", "email2", "email3", "emailTypeCode", "emailTypeCode2", "emailTypeCode3", "firstName", "gender", "greeting", "hireDate", "homePhone", "initials", "internalCost", "isActive", "lastName", "licenseType", "locationID", "middleName", "mobilePhone", "numberFormat", "officeExtension", "officePhone", "payrollIdentifier", "payrollType", "resourceType", "suffix", "surveyResourceRating", "timeFormat", "title", "travelAvailabilityPct", "userName", "userType"],
-  "roles": ["id", "description", "hourlyFactor", "hourlyRate", "isActive", "isExcludedFromNewContracts", "isSystemRole", "name", "quoteItemDefaultTaxCategoryId", "roleType"],
-  "service_call_task_resources": ["id", "resourceID", "serviceCallTaskID", "soapParentPropertyId"],
-  "service_call_tasks": ["id", "serviceCallID", "taskID", "soapParentPropertyId"],
-  "service_call_ticket_resources": ["id", "resourceID", "serviceCallTicketID", "soapParentPropertyId"],
-  "service_call_tickets": ["id", "serviceCallID", "ticketID", "soapParentPropertyId"],
-  "service_calls": ["id", "cancelationNoticeHours", "canceledByResourceID", "canceledDateTime", "companyID", "companyLocationID", "createDateTime", "creatorResourceID", "description", "duration", "endDateTime", "impersonatorCreatorResourceID", "isComplete", "lastModifiedDateTime", "startDateTime", "status"],
-  "service_level_agreement_results": ["id", "firstResponseElapsedHours", "firstResponseInitiatingResourceID", "firstResponseResourceID", "isFirstResponseMet", "isResolutionMet", "isResolutionPlanMet", "resolutionElapsedHours", "resolutionPlanElapsedHours", "resolutionPlanResourceID", "resolutionResourceID", "serviceLevelAgreementName", "ticketID", "soapParentPropertyId"],
-  "services": ["id", "billingCodeID", "createDate", "creatorResourceID", "description", "invoiceDescription", "isActive", "lastModifiedDate", "markupRate", "name", "periodType", "serviceLevelAgreementID", "unitCost", "unitPrice", "updateResourceID", "vendorCompanyID", "manufacturerServiceProvider", "manufacturerServiceProviderProductNumber", "catalogNumberPartNumber", "sku", "internalID", "externalID", "url", "userDefinedFields"],
-  "skills": ["id", "categoryID", "description", "isActive", "name"],
-  "subscription_periods": ["id", "periodCost", "periodDate", "periodPrice", "postedDate", "purchaseOrderNumber", "subscriptionID", "soapParentPropertyId"],
-  "subscriptions": ["id", "configurationItemID", "description", "effectiveDate", "expirationDate", "impersonatorCreatorResourceID", "materialCodeID", "organizationalLevelAssociationID", "periodCost", "periodPrice", "periodType", "purchaseOrderNumber", "status", "subscriptionName", "totalCost", "totalPrice", "vendorID", "userDefinedFields"],
-  "survey_results": ["id", "companyID", "companyRating", "completeDate", "contactID", "contactRating", "resourceRating", "sendDate", "surveyID", "surveyRating", "ticketID"],
-  "surveys": ["id", "description", "displayName", "name"],
-  "tag_aliases": ["id", "alias", "tagID", "soapParentPropertyId"],
-  "tag_groups": ["id", "displayColor", "isActive", "isSystem", "label"],
-  "tags": ["id", "createDateTime", "isActive", "isExcludedFromAutomaticTagging", "isSystem", "label", "lastModifiedDateTime", "tagGroupID"],
-  "task_secondary_resources": ["id", "resourceID", "roleID", "taskID", "soapParentPropertyId"],
-  "tasks": ["id", "assignedResourceID", "assignedResourceRoleID", "billingCodeID", "canClientPortalUserCompleteTask", "companyLocationID", "completedByResourceID", "completedByType", "completedDateTime", "createDateTime", "creatorResourceID", "creatorType", "departmentID", "description", "endDateTime", "estimatedHours", "externalID", "hoursToBeScheduled", "isTaskBillable", "isVisibleInClientPortal", "lastActivityDateTime", "lastActivityPersonType", "lastActivityResourceID", "phaseID", "priority", "priorityLabel", "projectID", "purchaseOrderNumber", "remainingHours", "startDateTime", "status", "taskCategoryID", "taskNumber", "taskType", "title", "soapParentPropertyId", "userDefinedFields"],
-  "ticket_additional_configuration_items": ["id", "configurationItemID", "ticketID", "soapParentPropertyId"],
-  "ticket_additional_contacts": ["id", "contactID", "ticketID", "soapParentPropertyId"],
-  "ticket_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "ticketID", "ticketNoteID", "timeEntryID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "ticket_categories": ["id", "displayColorRGB", "isActive", "isApiOnly", "isGlobalDefault", "name", "nickname"],
-  "ticket_category_field_defaults": ["id", "description", "estimatedHours", "issueTypeID", "organizationalLevelAssociationID", "priority", "purchaseOrderNumber", "queueID", "resolution", "serviceLevelAgreementID", "sourceID", "status", "subIssueTypeID", "ticketCategoryID", "ticketTypeID", "title", "workTypeID", "soapParentPropertyId"],
-  "ticket_change_request_approvals": ["id", "approveRejectDateTime", "approveRejectNote", "contactID", "isApproved", "resourceID", "ticketID", "soapParentPropertyId"],
-  "ticket_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "ticketID", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
-  "ticket_checklist_items": ["id", "completedByResourceID", "completedDateTime", "isCompleted", "isImportant", "itemName", "knowledgebaseArticleID", "position", "ticketID", "soapParentPropertyId"],
-  "ticket_history": ["id", "action", "date", "detail", "resourceID", "ticketID", "soapParentPropertyId"],
-  "ticket_note_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "ticketID", "ticketNoteID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "ticket_note_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "ticket_notes": ["id", "createDateTime", "createdByContactID", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "publish", "ticketID", "title", "soapParentPropertyId"],
-  "ticket_secondary_resources": ["id", "resourceID", "roleID", "ticketID", "soapParentPropertyId"],
-  "ticket_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "tickets": ["id", "apiVendorID", "assignedResourceID", "assignedResourceRoleID", "billingCodeID", "changeApprovalBoard", "changeApprovalStatus", "changeApprovalType", "changeInfoField1", "changeInfoField2", "changeInfoField3", "changeInfoField4", "changeInfoField5", "companyID", "companyLocationID", "completedByResourceID", "completedDate", "configurationItemID", "contactID", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "createdByContactID", "creatorResourceID", "creatorType", "currentServiceThermometerRating", "description", "dueDateTime", "estimatedHours", "externalID", "firstResponseAssignedResourceID", "firstResponseDateTime", "firstResponseDueDateTime", "firstResponseInitiatingResourceID", "hoursToBeScheduled", "impersonatorCreatorResourceID", "isAssignedToComanaged", "issueType", "isVisibleToComanaged", "lastActivityDate", "lastActivityPersonType", "lastActivityResourceID", "lastCustomerNotificationDateTime", "lastCustomerVisibleActivityDateTime", "lastTrackedModificationDateTime", "monitorID", "monitorTypeID", "opportunityID", "organizationalLevelAssociationID", "previousServiceThermometerRating", "priority", "problemTicketId", "projectID", "purchaseOrderNumber", "queueID", "resolution", "resolutionPlanDateTime", "resolutionPlanDueDateTime", "resolvedDateTime", "resolvedDueDateTime", "rmaStatus", "rmaType", "rmmAlertID", "serviceLevelAgreementHasBeenMet", "serviceLevelAgreementID", "serviceLevelAgreementPausedNextEventHours", "serviceThermometerTemperature", "source", "status", "subIssueType", "ticketCategory", "ticketNumber", "ticketType", "title", "userDefinedFields"],
-  "time_entries": ["id", "billingApprovalDateTime", "billingApprovalLevelMostRecent", "billingApprovalResourceID", "billingCodeID", "contractID", "contractServiceBundleID", "contractServiceID", "createDateTime", "creatorUserID", "dateWorked", "endDateTime", "hoursToBill", "hoursWorked", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "internalBillingCodeID", "internalNotes", "isInternalNotesVisibleToComanaged", "isNonBillable", "lastModifiedDateTime", "lastModifiedUserID", "offsetHours", "resourceID", "roleID", "showOnInvoice", "startDateTime", "summaryNotes", "taskID", "ticketID", "timeEntryType"],
-  "time_entry_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "taskID", "ticketID", "timeEntryID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "time_off_requests": ["id", "approvedDateTime", "approveRejectResourceID", "createdByResourceID", "createDateTime", "endTime", "hours", "impersonatorApproveRejectResourceID", "lastModifiedByResourceID", "lastModifiedDateTime", "lastApprovedLevel", "reason", "rejectReason", "requestDate", "resourceID", "startTime", "status", "timeOffRequestType", "soapParentPropertyId"]
-};
-
-// src/operations/fetchMany.ts
-var FETCH_MANY_MAX_ITEMS = 20;
-function validateFetchManyItems(items, cap, opName = "fetchMany", capRef = `FETCH_MANY_MAX_ITEMS = ${FETCH_MANY_MAX_ITEMS}`, validation) {
-  if (!Array.isArray(items)) {
-    throw new AutotaskConfigError(
-      `${opName}: items must be the items ARRAY \u2014 one positional arg, [{ resource: string, id: number, fields?: string[] }] (got ${Array.isArray(items) ? "an array" : typeof items})`,
-      {
-        suggestedAction: 'Pass args = [[{ resource: "tickets", id: 123 }, { resource: "projects", id: 456 }]] \u2014 the items array is the single positional argument.'
-      }
-    );
-  }
-  if (items.length === 0) {
-    throw new AutotaskConfigError(`${opName}: items must not be empty (a zero-item batch is a shape error, not a no-op)`, {
-      suggestedAction: "Pass at least one { resource, id } item \u2014 or use the resource's query op for a filtered read."
-    });
-  }
-  if (items.length > cap) {
-    throw new AutotaskConfigError(
-      `${opName}: ${items.length} items over the ${cap}-item cap (${capRef}) \u2014 zero items were fetched (pre-request)`,
-      {
-        suggestedAction: `Split the batch into groups of <= ${cap} items \u2014 or, for more than ${cap} records / a filtered set, use the resource's bounded query op (<resource>.query).`
-      }
-    );
-  }
-  const problems = [];
-  for (let i = 0; i < items.length; i += 1) {
-    const it = items[i];
-    const at = `items[${i}]`;
-    if (typeof it !== "object" || it === null || Array.isArray(it)) {
-      problems.push(`${at}: must be an object { resource: string, id: number, fields?: string[] }`);
-      continue;
-    }
-    const item = it;
-    if (typeof item.resource !== "string" || item.resource.trim() === "") {
-      problems.push(`${at}.resource: required \u2014 the plan resource key (string, e.g. 'tickets'; see autotask_catalog)`);
-      continue;
-    }
-    const resourceKey = item.resource;
-    const fields = MODEL_FIELD_SETS[resourceKey];
-    if (fields === void 0) {
-      problems.push(
-        `${at}.resource: "${resourceKey}" is not a single-record GETtable resource (${Object.keys(MODEL_FIELD_SETS).length} known) \u2014 see autotask_catalog for the exact plan keys`
-      );
-      continue;
-    }
-    const rel = RELATIONSHIP_MAP[resourceKey];
-    if (rel !== void 0 && rel.parentScoped) {
-      problems.push(
-        `${at}.resource: "${resourceKey}" is a parent-scoped child \u2014 its get needs (parentId, id); fetchMany takes single numeric ids of TOP-LEVEL records (scoped reads: client.${camelKey(resourceKey)}.get(parentId, id))`
-      );
-      continue;
-    }
-    try {
-      parseIdentifier(item.id, `${at}.id`);
-    } catch {
-      if (typeof item.id === "string") {
-        problems.push(
-          `${at}.id: "${item.id}" is not a vendor numeric id \u2014 non-numeric string identifiers are autotask_resolve_any territory (resolveAny / the resource's findBy* helpers)`
-        );
-      } else if (typeof item.id === "number") {
-        problems.push(
-          `${at}.id: ${item.id} is not a non-negative safe integer (a JS number this large is already corrupted \u2014 pass the canonical integer string form)`
-        );
-      } else {
-        problems.push(`${at}.id: required \u2014 the vendor numeric id (safe integer, or the canonical integer string for ids above 2^53)`);
-      }
-      continue;
-    }
-    if (item.fields !== void 0) {
-      if (!Array.isArray(item.fields) || item.fields.some((f) => typeof f !== "string")) {
-        problems.push(`${at}.fields: must be an array of exact vendor field names (discover them via operations.fieldCatalog)`);
-        continue;
-      }
-      if (validation?.fieldCheck !== false) {
-        const authoritative = validation?.fieldSetsByResource?.get(resourceKey) ?? fields;
-        for (const f of item.fields) {
-          if (!authoritative.includes(f)) {
-            problems.push(
-              `${at}.fields: "${f}" is not a field of ${resourceKey} \u2014 a hallucinated field is a shape error, not a silent projection-miss (exact vendor field names via operations.fieldCatalog)`
-            );
-          }
-        }
-      }
-    }
-  }
-  if (problems.length > 0) {
-    throw new AutotaskConfigError(
-      `${opName}: ${problems.length} problem(s) found pre-request (zero wire was issued)
-- ` + problems.join("\n- "),
-      { suggestedAction: "Fix every item above and call again \u2014 validation covers the whole batch up-front (one round, zero wire)." }
-    );
+// src/operations/aggregate.ts
+var AGGREGATE_TOP_MAX = 100;
+var AGGREGATE_DEFAULT_TOP = 25;
+var AGGREGATE_DEFAULT_LIMIT = BOUNDED_QUERY_MAX_LIMIT;
+var AGGREGATE_DATE_BUCKETS = ["month", "week", "year"];
+var DATE_ONLY_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d{1,9})?(Z|[+-]\d{2}:?\d{2})?$/;
+function parseDateInstant(v) {
+  if (typeof v !== "string") return null;
+  let m = v.match(DATE_ONLY_RE);
+  if (m) {
+    return validUtc(Number(m[1]), Number(m[2]), Number(m[3])) ?? null;
+  }
+  m = v.match(DATETIME_RE);
+  if (m) {
+    const t = validUtc(Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4]), Number(m[5]), Number(m[6]));
+    if (t === null) return null;
+    const zone = m[8];
+    if (zone === void 0 || zone === "Z") return t;
+    const sign = zone[0] === "-" ? -1 : 1;
+    const hh = Number(zone.slice(1, 3));
+    const mm = Number(zone.slice(zone.length - 2));
+    return t - sign * (hh * 60 + mm) * 6e4;
   }
+  return null;
 }
-function project(value, fields) {
-  const out = {};
-  for (const f of fields) {
-    if (f in value) out[f] = value[f];
+function validUtc(y, mo, d, h = 0, mi = 0, s = 0) {
+  const dt = new Date(Date.UTC(y, mo - 1, d, h, mi, s));
+  if (y >= 0 && y < 100) dt.setUTCFullYear(y);
+  if (dt.getUTCFullYear() !== y || dt.getUTCMonth() !== mo - 1 || dt.getUTCDate() !== d || dt.getUTCHours() !== h || dt.getUTCMinutes() !== mi || dt.getUTCSeconds() !== s) {
+    return null;
   }
-  return out;
+  return dt.getTime();
 }
-async function fetchMany(client, items, opts = {}) {
-  if (opts.maxItems !== void 0) {
-    if (!Number.isInteger(opts.maxItems) || opts.maxItems < 1) {
-      throw new AutotaskConfigError(`fetchMany: maxItems must be an integer >= 1 (got ${String(opts.maxItems)})`);
-    }
-  }
-  if (opts.liveFields !== void 0 && typeof opts.liveFields !== "boolean") {
-    throw new AutotaskConfigError(`fetchMany: liveFields must be a boolean (got ${typeof opts.liveFields})`);
-  }
-  const cap = Math.min(FETCH_MANY_MAX_ITEMS, opts.maxItems ?? FETCH_MANY_MAX_ITEMS);
-  if (opts.liveFields === true) {
-    validateFetchManyItems(items, cap, void 0, void 0, { fieldCheck: false });
-    const liveFieldSets = /* @__PURE__ */ new Map();
-    for (const item of items) {
-      const key = item.resource;
-      if (liveFieldSets.has(key)) continue;
-      const holder = client[camelKey(key)];
-      if (holder === void 0) {
-        throw new AutotaskConfigError(`fetchMany: the client exposes no accessor for resource "${key}"`, {
-          suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
-        });
-      }
-      try {
-        const rows = await holder.getFieldInfo();
-        const names = [];
-        for (const row of rows) {
-          if (typeof row.name === "string") names.push(row.name);
-        }
-        liveFieldSets.set(key, names.length > 0 ? names : null);
-      } catch (err) {
-        if (!isAutotaskError(err) || err.code === "ABORTED") throw err;
-        liveFieldSets.set(key, null);
-      }
-    }
-    validateFetchManyItems(items, cap, void 0, void 0, { fieldSetsByResource: liveFieldSets });
-  } else {
-    validateFetchManyItems(items, cap);
-  }
-  const results = [];
-  for (const item of items) {
-    const key = item.resource;
-    const id = parseIdentifier(item.id, `items[${results.length}].id`);
-    const holder = client[camelKey(key)];
-    if (holder === void 0) {
-      throw new AutotaskConfigError(`fetchMany: the client exposes no accessor for resource "${key}"`, {
-        suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
-      });
-    }
-    try {
-      const value = await holder.get(id);
-      results.push({ resource: key, id, found: true, value: item.fields !== void 0 ? project(value, item.fields) : value });
-    } catch (err) {
-      if (err instanceof NotFoundError) {
-        results.push({ resource: key, id, found: false, value: null, error: { code: "NOT_FOUND", message: err.message } });
-      } else if (isAutotaskError(err) && err.code !== "ABORTED") {
-        const e = { code: err.code, message: err.message };
-        if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
-        results.push({ resource: key, id, found: false, value: null, error: e });
-      } else {
-        throw err;
-      }
-    }
+var pad2 = (n) => String(n).padStart(2, "0");
+function isoWeekLabel(ms) {
+  const d = new Date(ms);
+  const dow = d.getUTCDay() || 7;
+  const S = d.getUTCFullYear() < 200 ? 100 : 0;
+  const thu = new Date(Date.UTC(d.getUTCFullYear() + S, d.getUTCMonth(), d.getUTCDate() + (4 - dow)));
+  const isoYear = thu.getUTCFullYear() - S;
+  const week = Math.ceil(((thu.getTime() - Date.UTC(thu.getUTCFullYear(), 0, 1)) / 864e5 + 1) / 7);
+  return `${isoYear}-W${pad2(week)}`;
+}
+function dateBucketLabel(value, bucket) {
+  if (value === null || value === void 0) return null;
+  const t = parseDateInstant(value);
+  if (t === null) return value;
+  const d = new Date(t);
+  switch (bucket) {
+    case "month":
+      return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}`;
+    case "year":
+      return `${d.getUTCFullYear()}`;
+    case "week":
+      return isoWeekLabel(t);
   }
-  const ok = results.filter((r) => r.found).length;
-  return { results, ok, failed: results.length - ok };
 }
-
-// src/operations/aggregate.ts
-var AGGREGATE_TOP_MAX = 100;
-var AGGREGATE_DEFAULT_TOP = 25;
-var AGGREGATE_DEFAULT_LIMIT = BOUNDED_QUERY_MAX_LIMIT;
 var QUERY_RESOURCE_KEYS = (() => {
   const s = /* @__PURE__ */ new Set();
   for (const rec of CAPABILITIES) if (rec.operation === "query") s.add(rec.resource);
@@ -485,6 +257,7 @@ function validateAggregate(operation, filter, opts) {
     }
   }
   const fieldSets = resourceKey !== void 0 ? MODEL_FIELD_SETS[resourceKey] : void 0;
+  const dateSets = resourceKey !== void 0 ? MODEL_DATE_FIELDS[resourceKey] : void 0;
   const checkFields = (name, fields) => {
     if (fields === void 0) return [];
     if (!Array.isArray(fields) || fields.length === 0 || fields.some((f) => typeof f !== "string" || f.trim() === "")) {
@@ -501,7 +274,39 @@ function validateAggregate(operation, filter, opts) {
     }
     return out;
   };
-  const groupBy = checkFields("groupBy", opts.groupBy);
+  const groupBy = [];
+  if (opts.groupBy !== void 0) {
+    if (!Array.isArray(opts.groupBy) || opts.groupBy.length === 0 || opts.groupBy.some((f) => typeof f !== "string" || f.trim() === "")) {
+      problems.push("groupBy must be a non-empty array of exact vendor field names (a date-typed field may carry the closed bucket suffix @month | @week | @year \u2014 discover them via operations.fieldCatalog)");
+    } else {
+      for (const f of opts.groupBy) {
+        const at = f.indexOf("@");
+        if (at === -1) {
+          if (fieldSets === void 0 || !fieldSets.includes(f)) {
+            problems.push(`groupBy: "${f}" is not a field of ${resourceKey} \u2014 a hallucinated field is a shape error, not a silent fold-miss (exact vendor field names via operations.fieldCatalog)`);
+          } else {
+            groupBy.push({ name: f, base: f });
+          }
+          continue;
+        }
+        const base = f.slice(0, at);
+        const suffix = f.slice(at + 1);
+        if (!AGGREGATE_DATE_BUCKETS.includes(suffix)) {
+          problems.push(`groupBy: "${f}": unknown bucket suffix "${suffix}" \u2014 the closed set is month | week | year (the suffix applies to date-typed fields only)`);
+          continue;
+        }
+        if (fieldSets === void 0 || !fieldSets.includes(base)) {
+          problems.push(`groupBy: "${f}": "${base}" is not a field of ${resourceKey} \u2014 a hallucinated field is a shape error, not a silent fold-miss (exact vendor field names via operations.fieldCatalog)`);
+          continue;
+        }
+        if (dateSets === void 0 || !dateSets.includes(base)) {
+          problems.push(`groupBy: "${f}": "${base}" is not a date field of ${resourceKey} (the @month/@week/@year bucket suffix applies to date-typed fields of the resource's vendored model \u2014 exact vendor field names via operations.fieldCatalog)`);
+          continue;
+        }
+        groupBy.push({ name: f, base, bucket: suffix });
+      }
+    }
+  }
   const sum = checkFields("sum", opts.sum);
   let top = AGGREGATE_DEFAULT_TOP;
   if (opts.top !== void 0) {
@@ -551,9 +356,10 @@ async function aggregate(client, operation, filter, opts = {}) {
   for (const item of res.items) {
     const key = {};
     const values = [];
-    for (const f of v.groupBy) {
-      const value = item[f] === void 0 ? null : item[f];
-      key[f] = value;
+    for (const spec of v.groupBy) {
+      const raw = item[spec.base] === void 0 ? null : item[spec.base];
+      const value = spec.bucket === void 0 ? raw : dateBucketLabel(raw, spec.bucket);
+      key[spec.name] = value;
       values.push(value);
     }
     const keyOrder = JSON.stringify(values);
@@ -582,130 +388,6 @@ async function aggregate(client, operation, filter, opts = {}) {
   return result;
 }
 
-// src/operations/fetchByIds.ts
-var FETCH_BY_IDS_MAX_ITEMS = 500;
-var FETCH_BY_IDS_CHUNK_SIZE = 250;
-function project2(value, fields) {
-  const out = {};
-  for (const f of fields) {
-    if (f in value) out[f] = value[f];
-  }
-  return out;
-}
-function resourcePathOf(key, holder) {
-  const path = holder?.resourcePath;
-  if (typeof path !== "string" || path === "") {
-    throw new AutotaskConfigError(`fetchByIds: the client exposes no ${key} resource path (registry drift)`, {
-      suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
-    });
-  }
-  return path;
-}
-async function fetchByIds(client, items, opts = {}) {
-  if (opts.maxItems !== void 0) {
-    if (!Number.isInteger(opts.maxItems) || opts.maxItems < 1) {
-      throw new AutotaskConfigError(`fetchByIds: maxItems must be an integer >= 1 (got ${String(opts.maxItems)})`);
-    }
-  }
-  const cap = Math.min(FETCH_BY_IDS_MAX_ITEMS, opts.maxItems ?? FETCH_BY_IDS_MAX_ITEMS);
-  validateFetchManyItems(items, cap, "fetchByIds", `FETCH_BY_IDS_MAX_ITEMS = ${FETCH_BY_IDS_MAX_ITEMS}`);
-  const groups = /* @__PURE__ */ new Map();
-  const canonical = [];
-  for (let i = 0; i < items.length; i += 1) {
-    const item = items[i];
-    const id = parseIdentifier(item.id, `items[${i}].id`);
-    canonical[i] = id;
-    const g = groups.get(item.resource) ?? { indices: [], fields: /* @__PURE__ */ new Set(), anyFields: false };
-    g.indices.push(i);
-    if (item.fields !== void 0) {
-      g.anyFields = true;
-      for (const f of item.fields) g.fields.add(f);
-    }
-    groups.set(item.resource, g);
-  }
-  const byKey = /* @__PURE__ */ new Map();
-  for (const [key, group] of groups) {
-    const holder = client[camelKey(key)];
-    if (holder === void 0) {
-      throw new AutotaskConfigError(`fetchByIds: the client exposes no accessor for resource "${key}"`, {
-        suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
-      });
-    }
-    const resourcePath = resourcePathOf(key, holder);
-    const unique = [];
-    const seen = /* @__PURE__ */ new Set();
-    for (const i of group.indices) {
-      const k = String(canonical[i]);
-      if (!seen.has(k)) {
-        seen.add(k);
-        unique.push(canonical[i]);
-      }
-    }
-    const includeFields = group.anyFields && group.indices.every((i) => items[i].fields !== void 0) ? [...group.fields] : void 0;
-    const kOf = (id) => `${key}:${String(id)}`;
-    for (let c = 0; c < unique.length; c += FETCH_BY_IDS_CHUNK_SIZE) {
-      const chunk = unique.slice(c, c + FETCH_BY_IDS_CHUNK_SIZE);
-      const chunkKeys = new Set(chunk.map((id) => String(id)));
-      try {
-        const req = buildQueryRequest(client.http.baseUrl, resourcePath, {
-          filter: [{ field: "id", op: "in", value: chunk }],
-          maxRecords: FETCH_BY_IDS_CHUNK_SIZE,
-          includeFields
-        });
-        const res = await client.http.request({ ...req, operation: `${key}.fetchByIds` });
-        const { items: rows } = unwrapItems(res, `${key}.fetchByIds`);
-        for (const row of rows) {
-          const k = String(row.id);
-          if (!chunkKeys.has(k)) continue;
-          const q = kOf(k);
-          if (!byKey.has(q)) byKey.set(q, { found: true, value: row });
-        }
-      } catch (err) {
-        if (isAutotaskError(err) && err.code !== "ABORTED") {
-          const e = { code: err.code, message: err.message };
-          if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
-          for (const u of chunk) {
-            const q = kOf(u);
-            if (!byKey.has(q)) byKey.set(q, { found: false, value: null, error: e });
-          }
-          continue;
-        }
-        throw err;
-      }
-    }
-    for (const id of unique) {
-      const k = kOf(id);
-      if (byKey.has(k)) continue;
-      try {
-        const value = await holder.get(id);
-        byKey.set(k, { found: true, value });
-      } catch (err) {
-        if (err instanceof NotFoundError) {
-          byKey.set(k, { found: false, value: null, error: { code: "NOT_FOUND", message: err.message } });
-        } else if (isAutotaskError(err) && err.code !== "ABORTED") {
-          const e = { code: err.code, message: err.message };
-          if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
-          byKey.set(k, { found: false, value: null, error: e });
-        } else {
-          throw err;
-        }
-      }
-    }
-  }
-  const results = [];
-  for (let i = 0; i < items.length; i += 1) {
-    const item = items[i];
-    const id = canonical[i];
-    const out = byKey.get(`${item.resource}:${String(id)}`);
-    const value = out.found ? item.fields !== void 0 ? project2(out.value, item.fields) : out.value : null;
-    results.push(
-      out.found ? { resource: item.resource, id, found: true, value } : { resource: item.resource, id, found: false, value: null, error: out.error }
-    );
-  }
-  const ok = results.filter((r) => r.found).length;
-  return { results, ok, failed: results.length - ok };
-}
-
 // src/operations/relationshipMap.ts
 async function relationshipMap(client, resourceKey) {
   void client;
@@ -1537,6 +1219,7 @@ async function invokeDelete(client, operation, args = [], opts = {}) {
   return invokeMode(client, operation, args, { ...opts, mode: "delete" });
 }
 export {
+  AGGREGATE_DATE_BUCKETS,
   AGGREGATE_DEFAULT_LIMIT,
   AGGREGATE_DEFAULT_TOP,
   AGGREGATE_TOP_MAX,
@@ -1559,6 +1242,7 @@ export {
   aggregate,
   blindSurfaces,
   createGuidance,
+  dateBucketLabel,
   expandResourceNames,
   fetchByIds,
   fetchMany,