node-autotask 0.70.0 → 0.72.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/MCP_TOOL_CATALOG.json +515 -9
  3. package/README.md +1 -1
  4. package/capabilities.json +2108 -293
  5. package/dist/capabilities-data.js +2107 -292
  6. package/dist/capabilities.cjs +4 -4
  7. package/dist/capabilities.js +1 -1
  8. package/dist/{chunk-TYUTIZWB.js → chunk-A4IRIYZ5.js} +6 -2
  9. package/dist/{chunk-3RANR2RY.js → chunk-EGG2RGL5.js} +433 -8
  10. package/dist/{chunk-MN5VLBCI.js → chunk-F2TYZKJS.js} +2 -2
  11. package/dist/{chunk-YQX45JBG.cjs → chunk-HJVTA7SI.cjs} +34 -30
  12. package/dist/{chunk-SCFB5MF3.js → chunk-K33DPJFK.js} +3 -3
  13. package/dist/{chunk-YRRTE2NF.cjs → chunk-KVC5DZAP.cjs} +438 -13
  14. package/dist/{chunk-KAZE4WC7.cjs → chunk-SPME362B.cjs} +3 -3
  15. package/dist/{chunk-GVP2WW47.cjs → chunk-V5UGW6KZ.cjs} +177 -177
  16. package/dist/{index-COQEG55Q.d.cts → index-BXnhBnhN.d.cts} +248 -1
  17. package/dist/{index-COQEG55Q.d.ts → index-BXnhBnhN.d.ts} +248 -1
  18. package/dist/{index-CGW80Uzc.d.cts → index-CqsY5YHt.d.cts} +7 -2
  19. package/dist/{index-By9Zw2Oc.d.ts → index-DxfspQR1.d.ts} +7 -2
  20. package/dist/index.cjs +84 -84
  21. package/dist/index.d.cts +3 -3
  22. package/dist/index.d.ts +3 -3
  23. package/dist/index.js +5 -5
  24. package/dist/operations/index.cjs +51 -51
  25. package/dist/operations/index.d.cts +5 -5
  26. package/dist/operations/index.d.ts +5 -5
  27. package/dist/operations/index.js +2 -2
  28. package/dist/pool.cjs +12 -12
  29. package/dist/pool.d.cts +1 -1
  30. package/dist/pool.d.ts +1 -1
  31. package/dist/pool.js +4 -4
  32. package/dist/resources/index.cjs +27 -27
  33. package/dist/resources/index.d.cts +2 -2
  34. package/dist/resources/index.d.ts +2 -2
  35. package/dist/resources/index.js +3 -3
  36. package/dist/types/index.d.cts +1 -1
  37. package/dist/types/index.d.ts +1 -1
  38. package/docs/API.md +86 -6
  39. package/docs/RELEASING.md +11 -3
  40. package/package.json +1 -1
@@ -1,4 +1,4 @@
1
- import { loadCapabilityRecords } from './chunk-SCFB5MF3.js';
1
+ import { loadCapabilityRecords } from './chunk-K33DPJFK.js';
2
2
  import { NoopLogger, REDACTED, deepMarkUntrusted, wrapUntrusted } from './chunk-7NKB4UXV.js';
3
3
  import { randomUUID, createHash } from 'crypto';
4
4
  import { AsyncLocalStorage } from 'async_hooks';
@@ -2395,6 +2395,22 @@ var RELATIONSHIP_MAP = {
2395
2395
  "delete": true
2396
2396
  }
2397
2397
  },
2398
+ {
2399
+ "resource": "company_attachments",
2400
+ "apiEntity": "CompanyAttachment",
2401
+ "parentField": "companyID",
2402
+ "parentSegment": "Attachments",
2403
+ "tier": "extended",
2404
+ "workflowResource": false,
2405
+ "specialOps": [],
2406
+ "searchCovers": null,
2407
+ "scopedOps": {
2408
+ "create": true,
2409
+ "query": true,
2410
+ "update": false,
2411
+ "delete": true
2412
+ }
2413
+ },
2398
2414
  {
2399
2415
  "resource": "company_locations",
2400
2416
  "apiEntity": "CompanyLocation",
@@ -2676,7 +2692,24 @@ var RELATIONSHIP_MAP = {
2676
2692
  "segment": "Notes",
2677
2693
  "field": "companyID"
2678
2694
  },
2679
- "children": [],
2695
+ "children": [
2696
+ {
2697
+ "resource": "company_note_attachments",
2698
+ "apiEntity": "CompanyNoteAttachment",
2699
+ "parentField": "companyNoteID",
2700
+ "parentSegment": "Attachments",
2701
+ "tier": "extended",
2702
+ "workflowResource": false,
2703
+ "specialOps": [],
2704
+ "searchCovers": null,
2705
+ "scopedOps": {
2706
+ "create": true,
2707
+ "query": true,
2708
+ "update": false,
2709
+ "delete": true
2710
+ }
2711
+ }
2712
+ ],
2680
2713
  "naturalKeys": {
2681
2714
  "hasSearch": true,
2682
2715
  "searchCovers": "name only (contains)",
@@ -2963,7 +2996,7 @@ var RELATIONSHIP_MAP = {
2963
2996
  "parent": {
2964
2997
  "resource": "configuration_items",
2965
2998
  "segment": "DnsRecords",
2966
- "field": "configurationItemID"
2999
+ "field": "installedProductID"
2967
3000
  },
2968
3001
  "children": [],
2969
3002
  "naturalKeys": {
@@ -3233,7 +3266,7 @@ var RELATIONSHIP_MAP = {
3233
3266
  {
3234
3267
  "resource": "configuration_item_dns_records",
3235
3268
  "apiEntity": "ConfigurationItemDnsRecord",
3236
- "parentField": "configurationItemID",
3269
+ "parentField": "installedProductID",
3237
3270
  "parentSegment": "DnsRecords",
3238
3271
  "tier": "extended",
3239
3272
  "workflowResource": false,
@@ -6166,6 +6199,22 @@ var RELATIONSHIP_MAP = {
6166
6199
  "field": "projectID"
6167
6200
  },
6168
6201
  "children": [
6202
+ {
6203
+ "resource": "task_notes",
6204
+ "apiEntity": "TaskNote",
6205
+ "parentField": "taskID",
6206
+ "parentSegment": "Notes",
6207
+ "tier": "extended",
6208
+ "workflowResource": false,
6209
+ "specialOps": [],
6210
+ "searchCovers": null,
6211
+ "scopedOps": {
6212
+ "create": true,
6213
+ "query": true,
6214
+ "update": true,
6215
+ "delete": false
6216
+ }
6217
+ },
6169
6218
  {
6170
6219
  "resource": "task_secondary_resources",
6171
6220
  "apiEntity": "TaskSecondaryResource",
@@ -9500,6 +9549,184 @@ var RELATIONSHIP_MAP = {
9500
9549
  "zoneFacts": null,
9501
9550
  "deleteBoundary": null,
9502
9551
  "markerField": null
9552
+ },
9553
+ "attachment_info": {
9554
+ "resource": "attachment_info",
9555
+ "apiEntity": "AttachmentInfo",
9556
+ "kind": "entity",
9557
+ "path": "AttachmentInfo",
9558
+ "parentScoped": false,
9559
+ "tier": "extended",
9560
+ "workflowResource": false,
9561
+ "group": "A",
9562
+ "parent": null,
9563
+ "children": [],
9564
+ "naturalKeys": {
9565
+ "hasSearch": false,
9566
+ "searchCovers": null,
9567
+ "findBy": []
9568
+ },
9569
+ "blindSurfaces": null,
9570
+ "zoneFacts": null,
9571
+ "deleteBoundary": null,
9572
+ "markerField": null
9573
+ },
9574
+ "company_attachments": {
9575
+ "resource": "company_attachments",
9576
+ "apiEntity": "CompanyAttachment",
9577
+ "kind": "entity",
9578
+ "path": "CompanyAttachments",
9579
+ "parentScoped": true,
9580
+ "tier": "extended",
9581
+ "workflowResource": false,
9582
+ "group": "A",
9583
+ "parent": {
9584
+ "resource": "companies",
9585
+ "segment": "Attachments",
9586
+ "field": "companyID"
9587
+ },
9588
+ "children": [],
9589
+ "naturalKeys": {
9590
+ "hasSearch": false,
9591
+ "searchCovers": null,
9592
+ "findBy": []
9593
+ },
9594
+ "blindSurfaces": null,
9595
+ "zoneFacts": {
9596
+ "createGuidance": {
9597
+ "createOp": "company_attachments.create",
9598
+ "parentScoped": true,
9599
+ "liveProvenPrefix": [],
9600
+ "unproven": true,
9601
+ "blocker": {
9602
+ "kind": "unknown",
9603
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
9604
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
9605
+ },
9606
+ "requiresByValue": [
9607
+ {
9608
+ "field": "attachmentType",
9609
+ "value": "FILE_ATTACHMENT",
9610
+ "requires": {
9611
+ "allOf": [
9612
+ "data"
9613
+ ]
9614
+ }
9615
+ }
9616
+ ],
9617
+ "vendorEvidence": [
9618
+ "Specification: POST /V1.0/Companies/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
9619
+ ],
9620
+ "deleteBoundary": {
9621
+ "available": true,
9622
+ "note": null
9623
+ }
9624
+ }
9625
+ },
9626
+ "deleteBoundary": null,
9627
+ "markerField": null
9628
+ },
9629
+ "company_note_attachments": {
9630
+ "resource": "company_note_attachments",
9631
+ "apiEntity": "CompanyNoteAttachment",
9632
+ "kind": "entity",
9633
+ "path": "CompanyNoteAttachments",
9634
+ "parentScoped": true,
9635
+ "tier": "extended",
9636
+ "workflowResource": false,
9637
+ "group": "A",
9638
+ "parent": {
9639
+ "resource": "company_notes",
9640
+ "segment": "Attachments",
9641
+ "field": "companyNoteID"
9642
+ },
9643
+ "children": [],
9644
+ "naturalKeys": {
9645
+ "hasSearch": false,
9646
+ "searchCovers": null,
9647
+ "findBy": []
9648
+ },
9649
+ "blindSurfaces": null,
9650
+ "zoneFacts": {
9651
+ "createGuidance": {
9652
+ "createOp": "company_note_attachments.create",
9653
+ "parentScoped": true,
9654
+ "liveProvenPrefix": [],
9655
+ "unproven": true,
9656
+ "blocker": {
9657
+ "kind": "unknown",
9658
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
9659
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
9660
+ },
9661
+ "requiresByValue": [
9662
+ {
9663
+ "field": "attachmentType",
9664
+ "value": "FILE_ATTACHMENT",
9665
+ "requires": {
9666
+ "allOf": [
9667
+ "data"
9668
+ ]
9669
+ }
9670
+ }
9671
+ ],
9672
+ "vendorEvidence": [
9673
+ "Specification: POST /V1.0/CompanyNotes/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
9674
+ ],
9675
+ "deleteBoundary": {
9676
+ "available": true,
9677
+ "note": null
9678
+ }
9679
+ }
9680
+ },
9681
+ "deleteBoundary": null,
9682
+ "markerField": null
9683
+ },
9684
+ "task_notes": {
9685
+ "resource": "task_notes",
9686
+ "apiEntity": "TaskNote",
9687
+ "kind": "entity",
9688
+ "path": "TaskNotes",
9689
+ "parentScoped": true,
9690
+ "tier": "extended",
9691
+ "workflowResource": false,
9692
+ "group": "A",
9693
+ "parent": {
9694
+ "resource": "tasks",
9695
+ "segment": "Notes",
9696
+ "field": "taskID"
9697
+ },
9698
+ "children": [],
9699
+ "naturalKeys": {
9700
+ "hasSearch": false,
9701
+ "searchCovers": null,
9702
+ "findBy": []
9703
+ },
9704
+ "blindSurfaces": null,
9705
+ "zoneFacts": {
9706
+ "createGuidance": {
9707
+ "createOp": "task_notes.create",
9708
+ "parentScoped": true,
9709
+ "liveProvenPrefix": [],
9710
+ "unproven": true,
9711
+ "blocker": {
9712
+ "kind": "unknown",
9713
+ "message": "TaskNotes creation has not been verified; module, permissions, project state and category settings may restrict it.",
9714
+ "remedy": "Use current field metadata and preview first; baseline-project notes are read-only."
9715
+ },
9716
+ "vendorEvidence": [
9717
+ "https://autotask.net/help/developerhelp/Content/APIs/REST/Entities/TaskNotesEntity.htm"
9718
+ ],
9719
+ "deleteBoundary": {
9720
+ "available": false,
9721
+ "note": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API."
9722
+ }
9723
+ }
9724
+ },
9725
+ "deleteBoundary": {
9726
+ "note": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API.",
9727
+ "proof": "spec-derived"
9728
+ },
9729
+ "markerField": "title"
9503
9730
  }
9504
9731
  };
9505
9732
  var BLIND_SURFACE_STAMPS = {
@@ -9609,7 +9836,8 @@ var DELETE_BOUNDARY_NOTES = {
9609
9836
  "ticket_notes": "the vendor defines no DELETE for ticket_notes (spec-derived: the vendored api-docs.json defines no DELETE on the entity's paths) \u2014 a create cannot be undone through the API; cleanup is UI-only.",
9610
9837
  "tickets": "the vendor defines no DELETE for tickets (spec-derived: the vendored api-docs.json defines no DELETE on the entity's paths) \u2014 a create cannot be undone through the API; cleanup is UI-only.",
9611
9838
  "user_defined_field_definitions": "the vendor defines no DELETE for user_defined_field_definitions (spec-derived: the vendored api-docs.json defines no DELETE on the entity's paths) \u2014 a UDF definition cannot be deleted through the API; deactivation is via isActive (vendor soft-removal); hard cleanup is UI-only.",
9612
- "user_defined_field_list_items": "the vendor defines no DELETE for user_defined_field_list_items (spec-derived: the vendored api-docs.json defines no DELETE on the standalone or parent-scoped ListItems paths) \u2014 a picklist value cannot be deleted through the API; deactivation is via isActive (vendor soft-removal); hard cleanup is UI-only."
9839
+ "user_defined_field_list_items": "the vendor defines no DELETE for user_defined_field_list_items (spec-derived: the vendored api-docs.json defines no DELETE on the standalone or parent-scoped ListItems paths) \u2014 a picklist value cannot be deleted through the API; deactivation is via isActive (vendor soft-removal); hard cleanup is UI-only.",
9840
+ "task_notes": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API."
9613
9841
  };
9614
9842
  var RESPONSE_DRIFT_MARKERS = {
9615
9843
  "ticket_checklist_libraries": {
@@ -11207,6 +11435,36 @@ var CREATE_GUIDANCE = {
11207
11435
  "note": null
11208
11436
  }
11209
11437
  },
11438
+ {
11439
+ "resource": "company_attachments",
11440
+ "createOp": "company_attachments.create",
11441
+ "parentScoped": true,
11442
+ "liveProvenPrefix": [],
11443
+ "unproven": true,
11444
+ "blocker": {
11445
+ "kind": "unknown",
11446
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
11447
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
11448
+ },
11449
+ "vendorEvidence": [
11450
+ "Specification: POST /V1.0/Companies/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
11451
+ ],
11452
+ "deleteBoundary": {
11453
+ "available": true,
11454
+ "note": null
11455
+ },
11456
+ "requiresByValue": [
11457
+ {
11458
+ "field": "attachmentType",
11459
+ "value": "FILE_ATTACHMENT",
11460
+ "requires": {
11461
+ "allOf": [
11462
+ "data"
11463
+ ]
11464
+ }
11465
+ }
11466
+ ]
11467
+ },
11210
11468
  {
11211
11469
  "resource": "company_locations",
11212
11470
  "createOp": "company_locations.create",
@@ -11224,6 +11482,36 @@ var CREATE_GUIDANCE = {
11224
11482
  "note": null
11225
11483
  }
11226
11484
  },
11485
+ {
11486
+ "resource": "company_note_attachments",
11487
+ "createOp": "company_note_attachments.create",
11488
+ "parentScoped": true,
11489
+ "liveProvenPrefix": [],
11490
+ "unproven": true,
11491
+ "blocker": {
11492
+ "kind": "unknown",
11493
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
11494
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
11495
+ },
11496
+ "vendorEvidence": [
11497
+ "Specification: POST /V1.0/CompanyNotes/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
11498
+ ],
11499
+ "deleteBoundary": {
11500
+ "available": true,
11501
+ "note": null
11502
+ },
11503
+ "requiresByValue": [
11504
+ {
11505
+ "field": "attachmentType",
11506
+ "value": "FILE_ATTACHMENT",
11507
+ "requires": {
11508
+ "allOf": [
11509
+ "data"
11510
+ ]
11511
+ }
11512
+ }
11513
+ ]
11514
+ },
11227
11515
  {
11228
11516
  "resource": "company_notes",
11229
11517
  "createOp": "company_notes.create",
@@ -12995,6 +13283,25 @@ var CREATE_GUIDANCE = {
12995
13283
  "note": null
12996
13284
  }
12997
13285
  },
13286
+ {
13287
+ "resource": "task_notes",
13288
+ "createOp": "task_notes.create",
13289
+ "parentScoped": true,
13290
+ "liveProvenPrefix": [],
13291
+ "unproven": true,
13292
+ "blocker": {
13293
+ "kind": "unknown",
13294
+ "message": "TaskNotes creation has not been verified; module, permissions, project state and category settings may restrict it.",
13295
+ "remedy": "Use current field metadata and preview first; baseline-project notes are read-only."
13296
+ },
13297
+ "vendorEvidence": [
13298
+ "https://autotask.net/help/developerhelp/Content/APIs/REST/Entities/TaskNotesEntity.htm"
13299
+ ],
13300
+ "deleteBoundary": {
13301
+ "available": false,
13302
+ "note": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API."
13303
+ }
13304
+ },
12998
13305
  {
12999
13306
  "resource": "task_secondary_resources",
13000
13307
  "createOp": "task_secondary_resources.create",
@@ -13530,7 +13837,7 @@ var CREATE_GUIDANCE = {
13530
13837
  }
13531
13838
  ],
13532
13839
  "counts": {
13533
- "total": 99,
13840
+ "total": 102,
13534
13841
  "byKind": {
13535
13842
  "ok": 41,
13536
13843
  "blind-reference": 16,
@@ -13540,7 +13847,7 @@ var CREATE_GUIDANCE = {
13540
13847
  "resource-role-pair": 2,
13541
13848
  "delete-absent": 0,
13542
13849
  "non-mutable": 0,
13543
- "unknown": 23
13850
+ "unknown": 26
13544
13851
  }
13545
13852
  }
13546
13853
  };
@@ -14257,6 +14564,19 @@ var UNTRUSTED_FIELDS_BY_RESOURCE = {
14257
14564
  "user_defined_field_list_items": [
14258
14565
  "valueForDisplay",
14259
14566
  "valueForExport"
14567
+ ],
14568
+ "attachment_info": [
14569
+ "title"
14570
+ ],
14571
+ "company_attachments": [
14572
+ "title"
14573
+ ],
14574
+ "company_note_attachments": [
14575
+ "title"
14576
+ ],
14577
+ "task_notes": [
14578
+ "description",
14579
+ "title"
14260
14580
  ]
14261
14581
  };
14262
14582
 
@@ -17245,6 +17565,7 @@ function cachedMetadataGet(http, resource, kind, path, operation, unwrap, fresh
17245
17565
  // src/field-sets.ts
17246
17566
  var MODEL_FIELD_SETS = {
17247
17567
  "appointments": ["id", "createDateTime", "creatorResourceID", "description", "endDateTime", "resourceID", "startDateTime", "title", "updateDateTime"],
17568
+ "attachment_info": ["id", "articleID", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "companyID", "companyNoteID", "configurationItemID", "configurationItemNoteID", "contentType", "contractID", "contractNoteID", "creatorType", "documentID", "expenseItemID", "expenseReportID", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "parentType", "projectID", "projectNoteID", "publish", "resourceID", "salesOrderID", "taskID", "taskNoteID", "ticketID", "ticketNoteID", "timeEntryID", "title", "soapParentPropertyId"],
17248
17569
  "billing_codes": ["id", "afterHoursWorkType", "billingCodeType", "department", "description", "externalNumber", "generalLedgerAccount", "isActive", "isExcludedFromNewContracts", "markupRate", "name", "taxCategoryID", "unitCost", "unitPrice", "useType"],
17249
17570
  "billing_item_approval_levels": ["id", "approvalDateTime", "approvalLevel", "approvalResourceID", "timeEntryID"],
17250
17571
  "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"],
@@ -17254,7 +17575,9 @@ var MODEL_FIELD_SETS = {
17254
17575
  "classification_icons": ["id", "description", "isActive", "isSystem", "name", "relativeUrl"],
17255
17576
  "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"],
17256
17577
  "company_alerts": ["id", "alertText", "alertTypeID", "companyID", "soapParentPropertyId"],
17578
+ "company_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "companyID", "companyNoteID", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "salesOrderID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
17257
17579
  "company_locations": ["id", "address1", "address2", "alternatePhone1", "alternatePhone2", "city", "companyID", "countryID", "description", "fax", "isActive", "isPrimary", "isTaxExempt", "overrideCompanyTaxSettings", "name", "phone", "postalCode", "roundtripDistance", "state", "taxRegionID", "soapParentPropertyId"],
17580
+ "company_note_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "companyID", "companyNoteID", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "salesOrderID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
17258
17581
  "company_notes": ["id", "actionType", "assignedResourceID", "companyID", "completedDateTime", "contactID", "createDateTime", "endDateTime", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastModifiedDate", "name", "note", "opportunityID", "startDateTime", "soapParentPropertyId"],
17259
17582
  "company_site_configurations": ["id", "companyID", "locationName", "soapParentPropertyId", "userDefinedFields"],
17260
17583
  "company_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
@@ -17348,6 +17671,7 @@ var MODEL_FIELD_SETS = {
17348
17671
  "tag_aliases": ["id", "alias", "tagID", "soapParentPropertyId"],
17349
17672
  "tag_groups": ["id", "displayColor", "isActive", "isSystem", "label"],
17350
17673
  "tags": ["id", "createDateTime", "isActive", "isExcludedFromAutomaticTagging", "isSystem", "label", "lastModifiedDateTime", "tagGroupID"],
17674
+ "task_notes": ["id", "createDateTime", "creatorResourceID", "createdByContactID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "publish", "taskID", "title", "soapParentPropertyId"],
17351
17675
  "task_secondary_resources": ["id", "resourceID", "roleID", "taskID", "soapParentPropertyId"],
17352
17676
  "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"],
17353
17677
  "tax_regions": ["id", "isActive", "name"],
@@ -17374,9 +17698,12 @@ var MODEL_FIELD_SETS = {
17374
17698
  };
17375
17699
  var MODEL_DATE_FIELDS = {
17376
17700
  "appointments": ["createDateTime", "endDateTime", "startDateTime", "updateDateTime"],
17701
+ "attachment_info": ["attachDate"],
17377
17702
  "billing_item_approval_levels": ["approvalDateTime"],
17378
17703
  "billing_items": ["itemDate", "postedDate", "postedOnTime", "webServiceDate"],
17379
17704
  "companies": ["createDate", "lastActivityDate", "lastTrackedModifiedDateTime"],
17705
+ "company_attachments": ["attachDate"],
17706
+ "company_note_attachments": ["attachDate"],
17380
17707
  "company_notes": ["completedDateTime", "createDateTime", "endDateTime", "lastModifiedDate", "startDateTime"],
17381
17708
  "configuration_item_billing_product_associations": ["effectiveDate", "expirationDate"],
17382
17709
  "configuration_item_dns_records": ["createDateTime"],
@@ -17421,6 +17748,7 @@ var MODEL_DATE_FIELDS = {
17421
17748
  "subscriptions": ["effectiveDate", "expirationDate"],
17422
17749
  "survey_results": ["completeDate", "sendDate"],
17423
17750
  "tags": ["createDateTime", "lastModifiedDateTime"],
17751
+ "task_notes": ["createDateTime", "lastActivityDate"],
17424
17752
  "tasks": ["completedDateTime", "createDateTime", "endDateTime", "lastActivityDateTime", "startDateTime"],
17425
17753
  "ticket_attachments": ["attachDate"],
17426
17754
  "ticket_change_request_approvals": ["approveRejectDateTime"],
@@ -19545,6 +19873,36 @@ var BaseResource = class extends MutationBase {
19545
19873
  }
19546
19874
  };
19547
19875
 
19876
+ // src/resources/special/taskNotes.ts
19877
+ var WRITABLE = /* @__PURE__ */ new Set(["id", "itemId", "createdByContactID", "description", "noteType", "publish", "taskID", "title"]);
19878
+ function admitTaskNote(data, parentId, creating) {
19879
+ const parent = parseIdentifier(parentId, "parentId");
19880
+ const fail = (message) => {
19881
+ throw new AutotaskConfigError(`task_notes: ${message}`);
19882
+ };
19883
+ if (data === null || typeof data !== "object" || Array.isArray(data)) fail("data must be a record");
19884
+ const body = data;
19885
+ for (const key of Object.keys(body)) if (!WRITABLE.has(key)) fail(`${key} is not a writable TaskNotes field`);
19886
+ for (const [field, maximum] of [["description", 3200], ["title", 250]]) {
19887
+ const value = body[field];
19888
+ if (value !== void 0 && (typeof value !== "string" || value.length > maximum)) fail(`${field} must be a string of at most ${maximum} characters`);
19889
+ }
19890
+ if (creating && (typeof body.description !== "string" || body.description.trim() === "")) fail("description is required");
19891
+ for (const field of ["noteType", "publish"]) {
19892
+ const value = body[field];
19893
+ if ((creating || value !== void 0) && (typeof value !== "number" || !Number.isSafeInteger(value))) fail(`${field} must be an integer from the current field metadata`);
19894
+ }
19895
+ if (creating && body.taskID === void 0) fail("taskID is required in the create body and must match parentId");
19896
+ for (const field of ["createdByContactID", "taskID"]) {
19897
+ if (body[field] !== void 0) {
19898
+ if (typeof body[field] !== "number") fail(`${field} must be a numeric identifier`);
19899
+ const id = parseIdentifier(body[field], field);
19900
+ if (field === "taskID" && String(id) !== String(parent)) fail("taskID must match the parentId path argument");
19901
+ }
19902
+ }
19903
+ if (!creating && !Object.keys(body).some((key) => key !== "id" && key !== "itemId")) fail("update must contain a writable field");
19904
+ }
19905
+
19548
19906
  // src/resources/simple.ts
19549
19907
  var isIdentifier = (v) => typeof v === "number" || typeof v === "string";
19550
19908
  var SIMPLE_RESOURCES = [
@@ -19559,6 +19917,16 @@ var SIMPLE_RESOURCES = [
19559
19917
  helpers: { search: false, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19560
19918
  opForms: { get: "global", create: "global", update: "global", delete: "global" }
19561
19919
  },
19920
+ {
19921
+ key: "attachment_info",
19922
+ accessor: "attachmentInfo",
19923
+ resourcePath: "/V1.0/AttachmentInfo",
19924
+ deletable: false,
19925
+ udfCapable: false,
19926
+ ops: { query: true, queryAll: false, count: true, get: true, create: false, update: false, delete: false, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
19927
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19928
+ opForms: { get: "global" }
19929
+ },
19562
19930
  {
19563
19931
  key: "billing_codes",
19564
19932
  accessor: "billingCodes",
@@ -19650,6 +20018,20 @@ var SIMPLE_RESOURCES = [
19650
20018
  helpers: { search: false, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19651
20019
  opForms: { get: "scoped", create: "scoped", update: "scoped", delete: "scoped" }
19652
20020
  },
20021
+ {
20022
+ key: "company_attachments",
20023
+ accessor: "companyAttachments",
20024
+ resourcePath: "/V1.0/CompanyAttachments",
20025
+ parentScopedPath: "/V1.0/Companies/{parentId}/Attachments",
20026
+ parentPath: "/V1.0/Companies",
20027
+ parentField: "companyID",
20028
+ deletable: true,
20029
+ udfCapable: false,
20030
+ attachmentGet: true,
20031
+ ops: { query: true, queryAll: false, count: true, get: true, create: true, update: false, delete: true, getEntityInfo: true, getFieldInfo: true, getUdfInfo: false, download: false },
20032
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
20033
+ opForms: { get: "scoped", create: "scoped", delete: "scoped" }
20034
+ },
19653
20035
  {
19654
20036
  key: "company_locations",
19655
20037
  accessor: "companyLocations",
@@ -19664,6 +20046,20 @@ var SIMPLE_RESOURCES = [
19664
20046
  helpers: { search: true, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19665
20047
  opForms: { get: "scoped", create: "scoped", update: "scoped", delete: "scoped" }
19666
20048
  },
20049
+ {
20050
+ key: "company_note_attachments",
20051
+ accessor: "companyNoteAttachments",
20052
+ resourcePath: "/V1.0/CompanyNoteAttachments",
20053
+ parentScopedPath: "/V1.0/CompanyNotes/{parentId}/Attachments",
20054
+ parentPath: "/V1.0/CompanyNotes",
20055
+ parentField: "companyNoteID",
20056
+ deletable: true,
20057
+ udfCapable: false,
20058
+ attachmentGet: true,
20059
+ ops: { query: true, queryAll: false, count: true, get: true, create: true, update: false, delete: true, getEntityInfo: true, getFieldInfo: true, getUdfInfo: false, download: false },
20060
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
20061
+ opForms: { get: "scoped", create: "scoped", delete: "scoped" }
20062
+ },
19667
20063
  {
19668
20064
  key: "company_notes",
19669
20065
  accessor: "companyNotes",
@@ -19750,7 +20146,7 @@ var SIMPLE_RESOURCES = [
19750
20146
  resourcePath: "/V1.0/ConfigurationItemDnsRecords",
19751
20147
  parentScopedPath: "/V1.0/ConfigurationItems/{parentId}/DnsRecords",
19752
20148
  parentPath: "/V1.0/ConfigurationItems",
19753
- parentField: "configurationItemID",
20149
+ parentField: "installedProductID",
19754
20150
  deletable: true,
19755
20151
  udfCapable: false,
19756
20152
  ops: { query: true, queryAll: false, count: true, get: true, create: false, update: false, delete: true, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
@@ -20738,6 +21134,19 @@ var SIMPLE_RESOURCES = [
20738
21134
  helpers: { search: false, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
20739
21135
  opForms: { get: "global", create: "global", update: "global", delete: "global" }
20740
21136
  },
21137
+ {
21138
+ key: "task_notes",
21139
+ accessor: "taskNotes",
21140
+ resourcePath: "/V1.0/TaskNotes",
21141
+ parentScopedPath: "/V1.0/Tasks/{parentId}/Notes",
21142
+ parentPath: "/V1.0/Tasks",
21143
+ parentField: "taskID",
21144
+ deletable: false,
21145
+ udfCapable: false,
21146
+ ops: { query: true, queryAll: false, count: true, get: true, create: true, update: true, delete: false, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
21147
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
21148
+ opForms: { get: "scoped", create: "scoped", update: "scoped" }
21149
+ },
20741
21150
  {
20742
21151
  key: "task_secondary_resources",
20743
21152
  accessor: "taskSecondaryResources",
@@ -21000,6 +21409,19 @@ var SIMPLE_RESOURCES = [
21000
21409
  var GenericResource = class extends BaseResource {
21001
21410
  constructor(http, config, pageSize) {
21002
21411
  super(http, config, pageSize);
21412
+ if (["company_attachments", "company_note_attachments"].includes(config.key)) this.getUdfInfo = async () => {
21413
+ throw new OperationNotSupportedError(config.key, "getUdfInfo");
21414
+ };
21415
+ if (config.ops?.create === false || config.key === "company_attachments") this.createIfNotExists = async () => {
21416
+ throw new OperationNotSupportedError(config.key, "createIfNotExists");
21417
+ };
21418
+ if (config.key === "task_notes") {
21419
+ const compose = this.createIfNotExists.bind(this);
21420
+ this.createIfNotExists = async (a, b, c = {}) => {
21421
+ admitTaskNote(b, a, true);
21422
+ return compose(a, b, c);
21423
+ };
21424
+ }
21003
21425
  }
21004
21426
  /** #293 QA F2: the superset exposes every generic method, but a row whose ops/helpers
21005
21427
  * flags mark an op absent (the plain entities) refuses it client-side, pre-wire — the
@@ -21049,6 +21471,7 @@ var GenericResource = class extends BaseResource {
21049
21471
  const parentId = a;
21050
21472
  const data2 = b;
21051
21473
  const opts2 = c ?? {};
21474
+ if (this.config.key === "task_notes") admitTaskNote(data2, parentId, true);
21052
21475
  if (opts2.dryRun === true) return this.runCreateDryRun(data2, parentId);
21053
21476
  return this.createScopedRaw(parentId, data2, opts2);
21054
21477
  }
@@ -21066,6 +21489,7 @@ var GenericResource = class extends BaseResource {
21066
21489
  const id2 = b;
21067
21490
  const data2 = c;
21068
21491
  const opts2 = d ?? {};
21492
+ if (this.config.key === "task_notes") admitTaskNote(data2, parentId, false);
21069
21493
  if (opts2.dryRun === true) return this.runUpdateDryRun(id2, data2, opts2, parentId);
21070
21494
  if (this.config.collectionUpdate !== true) {
21071
21495
  await this.guardStaleBeforeMutation(id2, opts2, `${this.config.key}.update`, parentId);
@@ -21188,6 +21612,7 @@ var GenericResource = class extends BaseResource {
21188
21612
  }
21189
21613
  /** Download the attachment bytes (GET .../{id}/data; node-proven path, quirk #9) → Buffer. */
21190
21614
  async download(parentId, id) {
21615
+ this.requireOp("download");
21191
21616
  if (this.config.attachmentGet !== true) throw new OperationNotSupportedError(this.config.key, "download");
21192
21617
  return this.downloadScoped(parentId, id);
21193
21618
  }
@@ -1,5 +1,5 @@
1
- import { GenericResource, readTasks, parseIdentifier, AutotaskConfigError, StaleObjectError, buildDryRunResult, createNamePlan, resolveCompositeNames, addNameSibling, NotFoundError, unwrapItems, ConflictError, clientOf, compositePartLimit, invokeRead, compositePart, openTicketsOfPart, unwrapOperation, unwrapItem, ResolutionError, joinedCompositePart, runMove, resolveTicketStatusSemantics, openStatusFilter, isClosedStatus, vendorId, isAutotaskError, resolveLineOfBusinessChain, cachedRecordGet, uiLinkFor, refuse, queryRows, mergePartialBody, AutotaskError, TICKET_LABEL_FIELDS, addLabelSibling, parseVendorErrors, RELATIONSHIP_MAP, cursorToPath } from './chunk-3RANR2RY.js';
2
- import { loadCapabilityRecords } from './chunk-SCFB5MF3.js';
1
+ import { GenericResource, readTasks, parseIdentifier, AutotaskConfigError, StaleObjectError, buildDryRunResult, createNamePlan, resolveCompositeNames, addNameSibling, NotFoundError, unwrapItems, ConflictError, clientOf, compositePartLimit, invokeRead, compositePart, openTicketsOfPart, unwrapOperation, unwrapItem, ResolutionError, joinedCompositePart, runMove, resolveTicketStatusSemantics, openStatusFilter, isClosedStatus, vendorId, isAutotaskError, resolveLineOfBusinessChain, cachedRecordGet, uiLinkFor, refuse, queryRows, mergePartialBody, AutotaskError, TICKET_LABEL_FIELDS, addLabelSibling, parseVendorErrors, RELATIONSHIP_MAP, cursorToPath } from './chunk-EGG2RGL5.js';
2
+ import { loadCapabilityRecords } from './chunk-K33DPJFK.js';
3
3
 
4
4
  // src/resources/special/configuration_items.ts
5
5
  async function fetchRecord(http, path, label, readOpts) {