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,6 +1,6 @@
1
1
  'use strict';
2
2
 
3
- var chunkKAZE4WC7_cjs = require('./chunk-KAZE4WC7.cjs');
3
+ var chunkSPME362B_cjs = require('./chunk-SPME362B.cjs');
4
4
  var chunkBD4AUGCJ_cjs = require('./chunk-BD4AUGCJ.cjs');
5
5
  var crypto = require('crypto');
6
6
  var async_hooks = require('async_hooks');
@@ -2397,6 +2397,22 @@ var RELATIONSHIP_MAP = {
2397
2397
  "delete": true
2398
2398
  }
2399
2399
  },
2400
+ {
2401
+ "resource": "company_attachments",
2402
+ "apiEntity": "CompanyAttachment",
2403
+ "parentField": "companyID",
2404
+ "parentSegment": "Attachments",
2405
+ "tier": "extended",
2406
+ "workflowResource": false,
2407
+ "specialOps": [],
2408
+ "searchCovers": null,
2409
+ "scopedOps": {
2410
+ "create": true,
2411
+ "query": true,
2412
+ "update": false,
2413
+ "delete": true
2414
+ }
2415
+ },
2400
2416
  {
2401
2417
  "resource": "company_locations",
2402
2418
  "apiEntity": "CompanyLocation",
@@ -2678,7 +2694,24 @@ var RELATIONSHIP_MAP = {
2678
2694
  "segment": "Notes",
2679
2695
  "field": "companyID"
2680
2696
  },
2681
- "children": [],
2697
+ "children": [
2698
+ {
2699
+ "resource": "company_note_attachments",
2700
+ "apiEntity": "CompanyNoteAttachment",
2701
+ "parentField": "companyNoteID",
2702
+ "parentSegment": "Attachments",
2703
+ "tier": "extended",
2704
+ "workflowResource": false,
2705
+ "specialOps": [],
2706
+ "searchCovers": null,
2707
+ "scopedOps": {
2708
+ "create": true,
2709
+ "query": true,
2710
+ "update": false,
2711
+ "delete": true
2712
+ }
2713
+ }
2714
+ ],
2682
2715
  "naturalKeys": {
2683
2716
  "hasSearch": true,
2684
2717
  "searchCovers": "name only (contains)",
@@ -2965,7 +2998,7 @@ var RELATIONSHIP_MAP = {
2965
2998
  "parent": {
2966
2999
  "resource": "configuration_items",
2967
3000
  "segment": "DnsRecords",
2968
- "field": "configurationItemID"
3001
+ "field": "installedProductID"
2969
3002
  },
2970
3003
  "children": [],
2971
3004
  "naturalKeys": {
@@ -3235,7 +3268,7 @@ var RELATIONSHIP_MAP = {
3235
3268
  {
3236
3269
  "resource": "configuration_item_dns_records",
3237
3270
  "apiEntity": "ConfigurationItemDnsRecord",
3238
- "parentField": "configurationItemID",
3271
+ "parentField": "installedProductID",
3239
3272
  "parentSegment": "DnsRecords",
3240
3273
  "tier": "extended",
3241
3274
  "workflowResource": false,
@@ -6168,6 +6201,22 @@ var RELATIONSHIP_MAP = {
6168
6201
  "field": "projectID"
6169
6202
  },
6170
6203
  "children": [
6204
+ {
6205
+ "resource": "task_notes",
6206
+ "apiEntity": "TaskNote",
6207
+ "parentField": "taskID",
6208
+ "parentSegment": "Notes",
6209
+ "tier": "extended",
6210
+ "workflowResource": false,
6211
+ "specialOps": [],
6212
+ "searchCovers": null,
6213
+ "scopedOps": {
6214
+ "create": true,
6215
+ "query": true,
6216
+ "update": true,
6217
+ "delete": false
6218
+ }
6219
+ },
6171
6220
  {
6172
6221
  "resource": "task_secondary_resources",
6173
6222
  "apiEntity": "TaskSecondaryResource",
@@ -9502,6 +9551,184 @@ var RELATIONSHIP_MAP = {
9502
9551
  "zoneFacts": null,
9503
9552
  "deleteBoundary": null,
9504
9553
  "markerField": null
9554
+ },
9555
+ "attachment_info": {
9556
+ "resource": "attachment_info",
9557
+ "apiEntity": "AttachmentInfo",
9558
+ "kind": "entity",
9559
+ "path": "AttachmentInfo",
9560
+ "parentScoped": false,
9561
+ "tier": "extended",
9562
+ "workflowResource": false,
9563
+ "group": "A",
9564
+ "parent": null,
9565
+ "children": [],
9566
+ "naturalKeys": {
9567
+ "hasSearch": false,
9568
+ "searchCovers": null,
9569
+ "findBy": []
9570
+ },
9571
+ "blindSurfaces": null,
9572
+ "zoneFacts": null,
9573
+ "deleteBoundary": null,
9574
+ "markerField": null
9575
+ },
9576
+ "company_attachments": {
9577
+ "resource": "company_attachments",
9578
+ "apiEntity": "CompanyAttachment",
9579
+ "kind": "entity",
9580
+ "path": "CompanyAttachments",
9581
+ "parentScoped": true,
9582
+ "tier": "extended",
9583
+ "workflowResource": false,
9584
+ "group": "A",
9585
+ "parent": {
9586
+ "resource": "companies",
9587
+ "segment": "Attachments",
9588
+ "field": "companyID"
9589
+ },
9590
+ "children": [],
9591
+ "naturalKeys": {
9592
+ "hasSearch": false,
9593
+ "searchCovers": null,
9594
+ "findBy": []
9595
+ },
9596
+ "blindSurfaces": null,
9597
+ "zoneFacts": {
9598
+ "createGuidance": {
9599
+ "createOp": "company_attachments.create",
9600
+ "parentScoped": true,
9601
+ "liveProvenPrefix": [],
9602
+ "unproven": true,
9603
+ "blocker": {
9604
+ "kind": "unknown",
9605
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
9606
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
9607
+ },
9608
+ "requiresByValue": [
9609
+ {
9610
+ "field": "attachmentType",
9611
+ "value": "FILE_ATTACHMENT",
9612
+ "requires": {
9613
+ "allOf": [
9614
+ "data"
9615
+ ]
9616
+ }
9617
+ }
9618
+ ],
9619
+ "vendorEvidence": [
9620
+ "Specification: POST /V1.0/Companies/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
9621
+ ],
9622
+ "deleteBoundary": {
9623
+ "available": true,
9624
+ "note": null
9625
+ }
9626
+ }
9627
+ },
9628
+ "deleteBoundary": null,
9629
+ "markerField": null
9630
+ },
9631
+ "company_note_attachments": {
9632
+ "resource": "company_note_attachments",
9633
+ "apiEntity": "CompanyNoteAttachment",
9634
+ "kind": "entity",
9635
+ "path": "CompanyNoteAttachments",
9636
+ "parentScoped": true,
9637
+ "tier": "extended",
9638
+ "workflowResource": false,
9639
+ "group": "A",
9640
+ "parent": {
9641
+ "resource": "company_notes",
9642
+ "segment": "Attachments",
9643
+ "field": "companyNoteID"
9644
+ },
9645
+ "children": [],
9646
+ "naturalKeys": {
9647
+ "hasSearch": false,
9648
+ "searchCovers": null,
9649
+ "findBy": []
9650
+ },
9651
+ "blindSurfaces": null,
9652
+ "zoneFacts": {
9653
+ "createGuidance": {
9654
+ "createOp": "company_note_attachments.create",
9655
+ "parentScoped": true,
9656
+ "liveProvenPrefix": [],
9657
+ "unproven": true,
9658
+ "blocker": {
9659
+ "kind": "unknown",
9660
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
9661
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
9662
+ },
9663
+ "requiresByValue": [
9664
+ {
9665
+ "field": "attachmentType",
9666
+ "value": "FILE_ATTACHMENT",
9667
+ "requires": {
9668
+ "allOf": [
9669
+ "data"
9670
+ ]
9671
+ }
9672
+ }
9673
+ ],
9674
+ "vendorEvidence": [
9675
+ "Specification: POST /V1.0/CompanyNotes/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
9676
+ ],
9677
+ "deleteBoundary": {
9678
+ "available": true,
9679
+ "note": null
9680
+ }
9681
+ }
9682
+ },
9683
+ "deleteBoundary": null,
9684
+ "markerField": null
9685
+ },
9686
+ "task_notes": {
9687
+ "resource": "task_notes",
9688
+ "apiEntity": "TaskNote",
9689
+ "kind": "entity",
9690
+ "path": "TaskNotes",
9691
+ "parentScoped": true,
9692
+ "tier": "extended",
9693
+ "workflowResource": false,
9694
+ "group": "A",
9695
+ "parent": {
9696
+ "resource": "tasks",
9697
+ "segment": "Notes",
9698
+ "field": "taskID"
9699
+ },
9700
+ "children": [],
9701
+ "naturalKeys": {
9702
+ "hasSearch": false,
9703
+ "searchCovers": null,
9704
+ "findBy": []
9705
+ },
9706
+ "blindSurfaces": null,
9707
+ "zoneFacts": {
9708
+ "createGuidance": {
9709
+ "createOp": "task_notes.create",
9710
+ "parentScoped": true,
9711
+ "liveProvenPrefix": [],
9712
+ "unproven": true,
9713
+ "blocker": {
9714
+ "kind": "unknown",
9715
+ "message": "TaskNotes creation has not been verified; module, permissions, project state and category settings may restrict it.",
9716
+ "remedy": "Use current field metadata and preview first; baseline-project notes are read-only."
9717
+ },
9718
+ "vendorEvidence": [
9719
+ "https://autotask.net/help/developerhelp/Content/APIs/REST/Entities/TaskNotesEntity.htm"
9720
+ ],
9721
+ "deleteBoundary": {
9722
+ "available": false,
9723
+ "note": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API."
9724
+ }
9725
+ }
9726
+ },
9727
+ "deleteBoundary": {
9728
+ "note": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API.",
9729
+ "proof": "spec-derived"
9730
+ },
9731
+ "markerField": "title"
9505
9732
  }
9506
9733
  };
9507
9734
  var BLIND_SURFACE_STAMPS = {
@@ -9611,7 +9838,8 @@ var DELETE_BOUNDARY_NOTES = {
9611
9838
  "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.",
9612
9839
  "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.",
9613
9840
  "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.",
9614
- "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."
9841
+ "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.",
9842
+ "task_notes": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API."
9615
9843
  };
9616
9844
  var RESPONSE_DRIFT_MARKERS = {
9617
9845
  "ticket_checklist_libraries": {
@@ -11209,6 +11437,36 @@ var CREATE_GUIDANCE = {
11209
11437
  "note": null
11210
11438
  }
11211
11439
  },
11440
+ {
11441
+ "resource": "company_attachments",
11442
+ "createOp": "company_attachments.create",
11443
+ "parentScoped": true,
11444
+ "liveProvenPrefix": [],
11445
+ "unproven": true,
11446
+ "blocker": {
11447
+ "kind": "unknown",
11448
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
11449
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
11450
+ },
11451
+ "vendorEvidence": [
11452
+ "Specification: POST /V1.0/Companies/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
11453
+ ],
11454
+ "deleteBoundary": {
11455
+ "available": true,
11456
+ "note": null
11457
+ },
11458
+ "requiresByValue": [
11459
+ {
11460
+ "field": "attachmentType",
11461
+ "value": "FILE_ATTACHMENT",
11462
+ "requires": {
11463
+ "allOf": [
11464
+ "data"
11465
+ ]
11466
+ }
11467
+ }
11468
+ ]
11469
+ },
11212
11470
  {
11213
11471
  "resource": "company_locations",
11214
11472
  "createOp": "company_locations.create",
@@ -11226,6 +11484,36 @@ var CREATE_GUIDANCE = {
11226
11484
  "note": null
11227
11485
  }
11228
11486
  },
11487
+ {
11488
+ "resource": "company_note_attachments",
11489
+ "createOp": "company_note_attachments.create",
11490
+ "parentScoped": true,
11491
+ "liveProvenPrefix": [],
11492
+ "unproven": true,
11493
+ "blocker": {
11494
+ "kind": "unknown",
11495
+ "message": "Attachment creation is documented; valid input remains subject to API-user permissions and vendor validation.",
11496
+ "remedy": "Read the current field and picklist metadata, supply the named parent id, and preview the attachment before applying."
11497
+ },
11498
+ "vendorEvidence": [
11499
+ "Specification: POST /V1.0/CompanyNotes/{parentId}/Attachments returns OperationResultModel. Official attachment guidance requires base64 data for FILE_ATTACHMENT. No live create was performed."
11500
+ ],
11501
+ "deleteBoundary": {
11502
+ "available": true,
11503
+ "note": null
11504
+ },
11505
+ "requiresByValue": [
11506
+ {
11507
+ "field": "attachmentType",
11508
+ "value": "FILE_ATTACHMENT",
11509
+ "requires": {
11510
+ "allOf": [
11511
+ "data"
11512
+ ]
11513
+ }
11514
+ }
11515
+ ]
11516
+ },
11229
11517
  {
11230
11518
  "resource": "company_notes",
11231
11519
  "createOp": "company_notes.create",
@@ -12997,6 +13285,25 @@ var CREATE_GUIDANCE = {
12997
13285
  "note": null
12998
13286
  }
12999
13287
  },
13288
+ {
13289
+ "resource": "task_notes",
13290
+ "createOp": "task_notes.create",
13291
+ "parentScoped": true,
13292
+ "liveProvenPrefix": [],
13293
+ "unproven": true,
13294
+ "blocker": {
13295
+ "kind": "unknown",
13296
+ "message": "TaskNotes creation has not been verified; module, permissions, project state and category settings may restrict it.",
13297
+ "remedy": "Use current field metadata and preview first; baseline-project notes are read-only."
13298
+ },
13299
+ "vendorEvidence": [
13300
+ "https://autotask.net/help/developerhelp/Content/APIs/REST/Entities/TaskNotesEntity.htm"
13301
+ ],
13302
+ "deleteBoundary": {
13303
+ "available": false,
13304
+ "note": "The vendor defines no DELETE for task_notes (spec-derived); a created task note cannot be removed through the public API."
13305
+ }
13306
+ },
13000
13307
  {
13001
13308
  "resource": "task_secondary_resources",
13002
13309
  "createOp": "task_secondary_resources.create",
@@ -13532,7 +13839,7 @@ var CREATE_GUIDANCE = {
13532
13839
  }
13533
13840
  ],
13534
13841
  "counts": {
13535
- "total": 99,
13842
+ "total": 102,
13536
13843
  "byKind": {
13537
13844
  "ok": 41,
13538
13845
  "blind-reference": 16,
@@ -13542,7 +13849,7 @@ var CREATE_GUIDANCE = {
13542
13849
  "resource-role-pair": 2,
13543
13850
  "delete-absent": 0,
13544
13851
  "non-mutable": 0,
13545
- "unknown": 23
13852
+ "unknown": 26
13546
13853
  }
13547
13854
  }
13548
13855
  };
@@ -14259,6 +14566,19 @@ var UNTRUSTED_FIELDS_BY_RESOURCE = {
14259
14566
  "user_defined_field_list_items": [
14260
14567
  "valueForDisplay",
14261
14568
  "valueForExport"
14569
+ ],
14570
+ "attachment_info": [
14571
+ "title"
14572
+ ],
14573
+ "company_attachments": [
14574
+ "title"
14575
+ ],
14576
+ "company_note_attachments": [
14577
+ "title"
14578
+ ],
14579
+ "task_notes": [
14580
+ "description",
14581
+ "title"
14262
14582
  ]
14263
14583
  };
14264
14584
 
@@ -16133,7 +16453,7 @@ async function capabilitySets() {
16133
16453
  const fieldOps = /* @__PURE__ */ new Map();
16134
16454
  const udfCapable = /* @__PURE__ */ new Set();
16135
16455
  const resources = /* @__PURE__ */ new Set();
16136
- for (const rec of await chunkKAZE4WC7_cjs.loadCapabilityRecords()) {
16456
+ for (const rec of await chunkSPME362B_cjs.loadCapabilityRecords()) {
16137
16457
  if (rec.resource === "operations") continue;
16138
16458
  resources.add(rec.resource);
16139
16459
  if (rec.operation === "getFieldInfo") fieldOps.set(rec.resource, rec);
@@ -16144,7 +16464,7 @@ async function capabilitySets() {
16144
16464
  var derivedIndexPromise = null;
16145
16465
  function derivedIndexLoad() {
16146
16466
  if (derivedIndexPromise === null) {
16147
- derivedIndexPromise = chunkKAZE4WC7_cjs.loadCapabilityRecords().then((records) => {
16467
+ derivedIndexPromise = chunkSPME362B_cjs.loadCapabilityRecords().then((records) => {
16148
16468
  const index = /* @__PURE__ */ new Map();
16149
16469
  for (const rec of records) {
16150
16470
  const declared = rec.metadata?.derivedFields;
@@ -17247,6 +17567,7 @@ function cachedMetadataGet(http, resource, kind, path, operation, unwrap, fresh
17247
17567
  // src/field-sets.ts
17248
17568
  var MODEL_FIELD_SETS = {
17249
17569
  "appointments": ["id", "createDateTime", "creatorResourceID", "description", "endDateTime", "resourceID", "startDateTime", "title", "updateDateTime"],
17570
+ "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"],
17250
17571
  "billing_codes": ["id", "afterHoursWorkType", "billingCodeType", "department", "description", "externalNumber", "generalLedgerAccount", "isActive", "isExcludedFromNewContracts", "markupRate", "name", "taxCategoryID", "unitCost", "unitPrice", "useType"],
17251
17572
  "billing_item_approval_levels": ["id", "approvalDateTime", "approvalLevel", "approvalResourceID", "timeEntryID"],
17252
17573
  "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"],
@@ -17256,7 +17577,9 @@ var MODEL_FIELD_SETS = {
17256
17577
  "classification_icons": ["id", "description", "isActive", "isSystem", "name", "relativeUrl"],
17257
17578
  "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"],
17258
17579
  "company_alerts": ["id", "alertText", "alertTypeID", "companyID", "soapParentPropertyId"],
17580
+ "company_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "companyID", "companyNoteID", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "salesOrderID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
17259
17581
  "company_locations": ["id", "address1", "address2", "alternatePhone1", "alternatePhone2", "city", "companyID", "countryID", "description", "fax", "isActive", "isPrimary", "isTaxExempt", "overrideCompanyTaxSettings", "name", "phone", "postalCode", "roundtripDistance", "state", "taxRegionID", "soapParentPropertyId"],
17582
+ "company_note_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "companyID", "companyNoteID", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "salesOrderID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
17260
17583
  "company_notes": ["id", "actionType", "assignedResourceID", "companyID", "completedDateTime", "contactID", "createDateTime", "endDateTime", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastModifiedDate", "name", "note", "opportunityID", "startDateTime", "soapParentPropertyId"],
17261
17584
  "company_site_configurations": ["id", "companyID", "locationName", "soapParentPropertyId", "userDefinedFields"],
17262
17585
  "company_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
@@ -17350,6 +17673,7 @@ var MODEL_FIELD_SETS = {
17350
17673
  "tag_aliases": ["id", "alias", "tagID", "soapParentPropertyId"],
17351
17674
  "tag_groups": ["id", "displayColor", "isActive", "isSystem", "label"],
17352
17675
  "tags": ["id", "createDateTime", "isActive", "isExcludedFromAutomaticTagging", "isSystem", "label", "lastModifiedDateTime", "tagGroupID"],
17676
+ "task_notes": ["id", "createDateTime", "creatorResourceID", "createdByContactID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "publish", "taskID", "title", "soapParentPropertyId"],
17353
17677
  "task_secondary_resources": ["id", "resourceID", "roleID", "taskID", "soapParentPropertyId"],
17354
17678
  "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"],
17355
17679
  "tax_regions": ["id", "isActive", "name"],
@@ -17376,9 +17700,12 @@ var MODEL_FIELD_SETS = {
17376
17700
  };
17377
17701
  var MODEL_DATE_FIELDS = {
17378
17702
  "appointments": ["createDateTime", "endDateTime", "startDateTime", "updateDateTime"],
17703
+ "attachment_info": ["attachDate"],
17379
17704
  "billing_item_approval_levels": ["approvalDateTime"],
17380
17705
  "billing_items": ["itemDate", "postedDate", "postedOnTime", "webServiceDate"],
17381
17706
  "companies": ["createDate", "lastActivityDate", "lastTrackedModifiedDateTime"],
17707
+ "company_attachments": ["attachDate"],
17708
+ "company_note_attachments": ["attachDate"],
17382
17709
  "company_notes": ["completedDateTime", "createDateTime", "endDateTime", "lastModifiedDate", "startDateTime"],
17383
17710
  "configuration_item_billing_product_associations": ["effectiveDate", "expirationDate"],
17384
17711
  "configuration_item_dns_records": ["createDateTime"],
@@ -17423,6 +17750,7 @@ var MODEL_DATE_FIELDS = {
17423
17750
  "subscriptions": ["effectiveDate", "expirationDate"],
17424
17751
  "survey_results": ["completeDate", "sendDate"],
17425
17752
  "tags": ["createDateTime", "lastModifiedDateTime"],
17753
+ "task_notes": ["createDateTime", "lastActivityDate"],
17426
17754
  "tasks": ["completedDateTime", "createDateTime", "endDateTime", "lastActivityDateTime", "startDateTime"],
17427
17755
  "ticket_attachments": ["attachDate"],
17428
17756
  "ticket_change_request_approvals": ["approveRejectDateTime"],
@@ -19547,6 +19875,36 @@ var BaseResource = class extends MutationBase {
19547
19875
  }
19548
19876
  };
19549
19877
 
19878
+ // src/resources/special/taskNotes.ts
19879
+ var WRITABLE = /* @__PURE__ */ new Set(["id", "itemId", "createdByContactID", "description", "noteType", "publish", "taskID", "title"]);
19880
+ function admitTaskNote(data, parentId, creating) {
19881
+ const parent = parseIdentifier(parentId, "parentId");
19882
+ const fail = (message) => {
19883
+ throw new AutotaskConfigError(`task_notes: ${message}`);
19884
+ };
19885
+ if (data === null || typeof data !== "object" || Array.isArray(data)) fail("data must be a record");
19886
+ const body = data;
19887
+ for (const key of Object.keys(body)) if (!WRITABLE.has(key)) fail(`${key} is not a writable TaskNotes field`);
19888
+ for (const [field, maximum] of [["description", 3200], ["title", 250]]) {
19889
+ const value = body[field];
19890
+ if (value !== void 0 && (typeof value !== "string" || value.length > maximum)) fail(`${field} must be a string of at most ${maximum} characters`);
19891
+ }
19892
+ if (creating && (typeof body.description !== "string" || body.description.trim() === "")) fail("description is required");
19893
+ for (const field of ["noteType", "publish"]) {
19894
+ const value = body[field];
19895
+ if ((creating || value !== void 0) && (typeof value !== "number" || !Number.isSafeInteger(value))) fail(`${field} must be an integer from the current field metadata`);
19896
+ }
19897
+ if (creating && body.taskID === void 0) fail("taskID is required in the create body and must match parentId");
19898
+ for (const field of ["createdByContactID", "taskID"]) {
19899
+ if (body[field] !== void 0) {
19900
+ if (typeof body[field] !== "number") fail(`${field} must be a numeric identifier`);
19901
+ const id = parseIdentifier(body[field], field);
19902
+ if (field === "taskID" && String(id) !== String(parent)) fail("taskID must match the parentId path argument");
19903
+ }
19904
+ }
19905
+ if (!creating && !Object.keys(body).some((key) => key !== "id" && key !== "itemId")) fail("update must contain a writable field");
19906
+ }
19907
+
19550
19908
  // src/resources/simple.ts
19551
19909
  var isIdentifier = (v) => typeof v === "number" || typeof v === "string";
19552
19910
  var SIMPLE_RESOURCES = [
@@ -19561,6 +19919,16 @@ var SIMPLE_RESOURCES = [
19561
19919
  helpers: { search: false, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19562
19920
  opForms: { get: "global", create: "global", update: "global", delete: "global" }
19563
19921
  },
19922
+ {
19923
+ key: "attachment_info",
19924
+ accessor: "attachmentInfo",
19925
+ resourcePath: "/V1.0/AttachmentInfo",
19926
+ deletable: false,
19927
+ udfCapable: false,
19928
+ ops: { query: true, queryAll: false, count: true, get: true, create: false, update: false, delete: false, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
19929
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19930
+ opForms: { get: "global" }
19931
+ },
19564
19932
  {
19565
19933
  key: "billing_codes",
19566
19934
  accessor: "billingCodes",
@@ -19652,6 +20020,20 @@ var SIMPLE_RESOURCES = [
19652
20020
  helpers: { search: false, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19653
20021
  opForms: { get: "scoped", create: "scoped", update: "scoped", delete: "scoped" }
19654
20022
  },
20023
+ {
20024
+ key: "company_attachments",
20025
+ accessor: "companyAttachments",
20026
+ resourcePath: "/V1.0/CompanyAttachments",
20027
+ parentScopedPath: "/V1.0/Companies/{parentId}/Attachments",
20028
+ parentPath: "/V1.0/Companies",
20029
+ parentField: "companyID",
20030
+ deletable: true,
20031
+ udfCapable: false,
20032
+ attachmentGet: true,
20033
+ ops: { query: true, queryAll: false, count: true, get: true, create: true, update: false, delete: true, getEntityInfo: true, getFieldInfo: true, getUdfInfo: false, download: false },
20034
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
20035
+ opForms: { get: "scoped", create: "scoped", delete: "scoped" }
20036
+ },
19655
20037
  {
19656
20038
  key: "company_locations",
19657
20039
  accessor: "companyLocations",
@@ -19666,6 +20048,20 @@ var SIMPLE_RESOURCES = [
19666
20048
  helpers: { search: true, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
19667
20049
  opForms: { get: "scoped", create: "scoped", update: "scoped", delete: "scoped" }
19668
20050
  },
20051
+ {
20052
+ key: "company_note_attachments",
20053
+ accessor: "companyNoteAttachments",
20054
+ resourcePath: "/V1.0/CompanyNoteAttachments",
20055
+ parentScopedPath: "/V1.0/CompanyNotes/{parentId}/Attachments",
20056
+ parentPath: "/V1.0/CompanyNotes",
20057
+ parentField: "companyNoteID",
20058
+ deletable: true,
20059
+ udfCapable: false,
20060
+ attachmentGet: true,
20061
+ ops: { query: true, queryAll: false, count: true, get: true, create: true, update: false, delete: true, getEntityInfo: true, getFieldInfo: true, getUdfInfo: false, download: false },
20062
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
20063
+ opForms: { get: "scoped", create: "scoped", delete: "scoped" }
20064
+ },
19669
20065
  {
19670
20066
  key: "company_notes",
19671
20067
  accessor: "companyNotes",
@@ -19752,7 +20148,7 @@ var SIMPLE_RESOURCES = [
19752
20148
  resourcePath: "/V1.0/ConfigurationItemDnsRecords",
19753
20149
  parentScopedPath: "/V1.0/ConfigurationItems/{parentId}/DnsRecords",
19754
20150
  parentPath: "/V1.0/ConfigurationItems",
19755
- parentField: "configurationItemID",
20151
+ parentField: "installedProductID",
19756
20152
  deletable: true,
19757
20153
  udfCapable: false,
19758
20154
  ops: { query: true, queryAll: false, count: true, get: true, create: false, update: false, delete: true, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
@@ -20740,6 +21136,19 @@ var SIMPLE_RESOURCES = [
20740
21136
  helpers: { search: false, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
20741
21137
  opForms: { get: "global", create: "global", update: "global", delete: "global" }
20742
21138
  },
21139
+ {
21140
+ key: "task_notes",
21141
+ accessor: "taskNotes",
21142
+ resourcePath: "/V1.0/TaskNotes",
21143
+ parentScopedPath: "/V1.0/Tasks/{parentId}/Notes",
21144
+ parentPath: "/V1.0/Tasks",
21145
+ parentField: "taskID",
21146
+ deletable: false,
21147
+ udfCapable: false,
21148
+ ops: { query: true, queryAll: false, count: true, get: true, create: true, update: true, delete: false, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
21149
+ helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
21150
+ opForms: { get: "scoped", create: "scoped", update: "scoped" }
21151
+ },
20743
21152
  {
20744
21153
  key: "task_secondary_resources",
20745
21154
  accessor: "taskSecondaryResources",
@@ -21002,6 +21411,19 @@ var SIMPLE_RESOURCES = [
21002
21411
  var GenericResource = class extends BaseResource {
21003
21412
  constructor(http, config, pageSize) {
21004
21413
  super(http, config, pageSize);
21414
+ if (["company_attachments", "company_note_attachments"].includes(config.key)) this.getUdfInfo = async () => {
21415
+ throw new OperationNotSupportedError(config.key, "getUdfInfo");
21416
+ };
21417
+ if (config.ops?.create === false || config.key === "company_attachments") this.createIfNotExists = async () => {
21418
+ throw new OperationNotSupportedError(config.key, "createIfNotExists");
21419
+ };
21420
+ if (config.key === "task_notes") {
21421
+ const compose = this.createIfNotExists.bind(this);
21422
+ this.createIfNotExists = async (a, b, c = {}) => {
21423
+ admitTaskNote(b, a, true);
21424
+ return compose(a, b, c);
21425
+ };
21426
+ }
21005
21427
  }
21006
21428
  /** #293 QA F2: the superset exposes every generic method, but a row whose ops/helpers
21007
21429
  * flags mark an op absent (the plain entities) refuses it client-side, pre-wire — the
@@ -21051,6 +21473,7 @@ var GenericResource = class extends BaseResource {
21051
21473
  const parentId = a;
21052
21474
  const data2 = b;
21053
21475
  const opts2 = c ?? {};
21476
+ if (this.config.key === "task_notes") admitTaskNote(data2, parentId, true);
21054
21477
  if (opts2.dryRun === true) return this.runCreateDryRun(data2, parentId);
21055
21478
  return this.createScopedRaw(parentId, data2, opts2);
21056
21479
  }
@@ -21068,6 +21491,7 @@ var GenericResource = class extends BaseResource {
21068
21491
  const id2 = b;
21069
21492
  const data2 = c;
21070
21493
  const opts2 = d ?? {};
21494
+ if (this.config.key === "task_notes") admitTaskNote(data2, parentId, false);
21071
21495
  if (opts2.dryRun === true) return this.runUpdateDryRun(id2, data2, opts2, parentId);
21072
21496
  if (this.config.collectionUpdate !== true) {
21073
21497
  await this.guardStaleBeforeMutation(id2, opts2, `${this.config.key}.update`, parentId);
@@ -21190,6 +21614,7 @@ var GenericResource = class extends BaseResource {
21190
21614
  }
21191
21615
  /** Download the attachment bytes (GET .../{id}/data; node-proven path, quirk #9) → Buffer. */
21192
21616
  async download(parentId, id) {
21617
+ this.requireOp("download");
21193
21618
  if (this.config.attachmentGet !== true) throw new OperationNotSupportedError(this.config.key, "download");
21194
21619
  return this.downloadScoped(parentId, id);
21195
21620
  }
@@ -22978,7 +23403,7 @@ function dateBucketLabel(value, bucket) {
22978
23403
  var queryResourceKeysPromise = null;
22979
23404
  function queryResourceKeys() {
22980
23405
  if (queryResourceKeysPromise === null) {
22981
- queryResourceKeysPromise = chunkKAZE4WC7_cjs.loadCapabilityRecords().then((records) => {
23406
+ queryResourceKeysPromise = chunkSPME362B_cjs.loadCapabilityRecords().then((records) => {
22982
23407
  const s = /* @__PURE__ */ new Set();
22983
23408
  for (const rec of records) if (rec.operation === "query") s.add(rec.resource);
22984
23409
  return s;
@@ -23100,7 +23525,7 @@ function parseTopAndLimit(opts, problems) {
23100
23525
  return { top, limit };
23101
23526
  }
23102
23527
  async function checkFieldNames(resourceKey, conditions, opts, problems) {
23103
- const records = resourceKey === void 0 ? [] : await chunkKAZE4WC7_cjs.loadCapabilityRecords();
23528
+ const records = resourceKey === void 0 ? [] : await chunkSPME362B_cjs.loadCapabilityRecords();
23104
23529
  const record = resourceKey === void 0 ? void 0 : records.find((r) => r.resource === resourceKey && r.operation === "query");
23105
23530
  if (record === void 0) return void 0;
23106
23531
  const strings = (v) => Array.isArray(v) ? v.filter((f) => typeof f === "string" && f.trim() !== "") : [];
@@ -23745,7 +24170,7 @@ async function uiLink(client, input) {
23745
24170
  var indexPromise = null;
23746
24171
  function operationIndex() {
23747
24172
  if (indexPromise === null) {
23748
- indexPromise = chunkKAZE4WC7_cjs.loadCapabilityRecords().then((records) => new Map(records.map((r) => [r.id, r])));
24173
+ indexPromise = chunkSPME362B_cjs.loadCapabilityRecords().then((records) => new Map(records.map((r) => [r.id, r])));
23749
24174
  }
23750
24175
  return indexPromise;
23751
24176
  }