node-autotask 0.83.0 → 0.85.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.
- package/CHANGELOG.md +17 -0
- package/MCP_TOOL_CATALOG.json +323 -11
- package/README.md +1 -1
- package/capabilities.json +1739 -361
- package/dist/capabilities-data.js +2463 -1085
- package/dist/capabilities.cjs +4 -4
- package/dist/capabilities.js +1 -1
- package/dist/{chunk-C2AFRW5M.cjs → chunk-7GNZT7Y7.cjs} +375 -93
- package/dist/{chunk-ZKAJVHHZ.js → chunk-EPJG7M5C.js} +42 -7
- package/dist/{chunk-DBEAS3IR.js → chunk-GTTAPAGP.js} +3 -3
- package/dist/{chunk-HQJLIRXW.js → chunk-HF5YG4TV.js} +5 -2
- package/dist/{chunk-QCA5R7QF.cjs → chunk-JCKYM7FD.cjs} +3 -3
- package/dist/{chunk-QEMBBAF5.cjs → chunk-JV6MX2U3.cjs} +237 -202
- package/dist/{chunk-CV56RIGS.js → chunk-L6YCH2I4.js} +370 -88
- package/dist/{chunk-5AHEJCSP.cjs → chunk-PBOH2OHJ.cjs} +33 -30
- package/dist/{index-8Hg6dytT.d.cts → index-CCW_EpLg.d.cts} +203 -140
- package/dist/{index-8Hg6dytT.d.ts → index-CCW_EpLg.d.ts} +203 -140
- package/dist/{index-DxESlIIg.d.cts → index-DkyNXWyt.d.cts} +108 -86
- package/dist/{index-nXhYAQOf.d.ts → index-rWcPjRpX.d.ts} +108 -86
- package/dist/index.cjs +84 -84
- package/dist/index.d.cts +6 -5
- package/dist/index.d.ts +6 -5
- package/dist/index.js +5 -5
- package/dist/operations/index.cjs +51 -51
- package/dist/operations/index.d.cts +4 -4
- package/dist/operations/index.d.ts +4 -4
- package/dist/operations/index.js +2 -2
- package/dist/pool.cjs +12 -12
- package/dist/pool.d.cts +1 -1
- package/dist/pool.d.ts +1 -1
- package/dist/pool.js +4 -4
- package/dist/resources/index.cjs +27 -27
- package/dist/resources/index.d.cts +2 -2
- package/dist/resources/index.d.ts +2 -2
- package/dist/resources/index.js +3 -3
- package/dist/types/index.d.cts +1 -1
- package/dist/types/index.d.ts +1 -1
- package/docs/API.md +32 -20
- package/docs/RELEASING.md +2 -1
- package/docs/VENDOR-QUIRKS.md +3 -1
- package/package.json +1 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { loadCapabilityRecords } from './chunk-
|
|
1
|
+
import { loadCapabilityRecords } from './chunk-GTTAPAGP.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';
|
|
@@ -402,13 +402,14 @@ function suggestedActionForStatus(status) {
|
|
|
402
402
|
return status >= 500 ? "The SDK already retried per its policy. A repeated 500 on one entity while others work usually means the API user lacks permission on that entity \u2014 ask the Autotask admin to grant it; otherwise retry once more at most." : void 0;
|
|
403
403
|
}
|
|
404
404
|
}
|
|
405
|
-
function errorFromStatus(status, body, url, operation, redactPersonalData = true, credential) {
|
|
405
|
+
function errorFromStatus(status, body, url, operation, redactPersonalData = true, credential, includeVendorDetails = true) {
|
|
406
406
|
const safeBody = redactResponseBody(body, { redactPersonalData });
|
|
407
|
-
|
|
407
|
+
const exposedBody = includeVendorDetails ? safeBody : void 0;
|
|
408
|
+
let detail = formatVendorDetail(exposedBody);
|
|
408
409
|
if (detail !== void 0 && detail.length > VENDOR_BODY_SUFFIX_LIMIT) {
|
|
409
410
|
detail = detail.slice(0, VENDOR_BODY_SUFFIX_LIMIT);
|
|
410
411
|
}
|
|
411
|
-
const suffix = detail === void 0 ? vendorBodySuffix(
|
|
412
|
+
const suffix = detail === void 0 ? vendorBodySuffix(exposedBody) : void 0;
|
|
412
413
|
const message = detail ?? (suffix !== void 0 ? `${statusDefaultMessage(status)}: ${suffix}` : statusDefaultMessage(status));
|
|
413
414
|
const shape = errorShapeForStatus(status);
|
|
414
415
|
const Ctor = shape?.Ctor ?? AutotaskError;
|
|
@@ -419,10 +420,10 @@ function errorFromStatus(status, body, url, operation, redactPersonalData = true
|
|
|
419
420
|
const credentialDetails = status === 401 ? credentialDiagnosticDetails(credential) : void 0;
|
|
420
421
|
const extraDetails = mergeDetails(void 0, credentialDetails);
|
|
421
422
|
const err = new Ctor(message, {
|
|
422
|
-
code: vendorCodeCandidate !== void 0 && isMachineCode(vendorCodeCandidate) ? vendorCodeCandidate : code,
|
|
423
|
+
code: vendorCodeCandidate !== void 0 && isMachineCode(vendorCodeCandidate) && (includeVendorDetails || vendorCodeCandidate.toLowerCase() === "itgenatr005") ? vendorCodeCandidate : code,
|
|
423
424
|
...category !== void 0 ? { category } : {},
|
|
424
425
|
httpStatus: status,
|
|
425
|
-
vendorError:
|
|
426
|
+
vendorError: exposedBody,
|
|
426
427
|
url,
|
|
427
428
|
operation,
|
|
428
429
|
retryable: status === 429 || status >= 500,
|
|
@@ -1441,6 +1442,11 @@ function resolveConfig(config) {
|
|
|
1441
1442
|
|
|
1442
1443
|
// src/http/types.ts
|
|
1443
1444
|
var IDEMPOTENT_METHODS = ["GET", "PUT", "DELETE"];
|
|
1445
|
+
var AUDIT_DECIMAL_ID = /^(?:0|[1-9]\d{0,18})$/;
|
|
1446
|
+
var MAX_AUDIT_ID = "9223372036854775807";
|
|
1447
|
+
function isAuditDecimalId(id) {
|
|
1448
|
+
return AUDIT_DECIMAL_ID.test(id) && (id.length < MAX_AUDIT_ID.length || id <= MAX_AUDIT_ID);
|
|
1449
|
+
}
|
|
1444
1450
|
function isRecord2(value) {
|
|
1445
1451
|
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
1446
1452
|
}
|
|
@@ -1638,17 +1644,39 @@ function refusedFilterShape(filter) {
|
|
|
1638
1644
|
if (t === "object" || t === "function") return "an object";
|
|
1639
1645
|
return t === "string" ? "a string" : `a ${t}`;
|
|
1640
1646
|
}
|
|
1641
|
-
function
|
|
1647
|
+
function assertQueryFilterForWire(conditions, operation, auditIds) {
|
|
1642
1648
|
if (!Array.isArray(conditions)) return;
|
|
1643
|
-
for (const
|
|
1644
|
-
if (!isRecord2(
|
|
1645
|
-
|
|
1646
|
-
|
|
1649
|
+
for (const input of conditions) {
|
|
1650
|
+
if (!isRecord2(input)) continue;
|
|
1651
|
+
const c = auditIds ? {} : input;
|
|
1652
|
+
if (auditIds) {
|
|
1653
|
+
for (const [key, value] of Object.entries(input)) {
|
|
1654
|
+
const lower = key.toLowerCase();
|
|
1655
|
+
if (!["op", "field", "value", "items", "udf"].includes(lower)) continue;
|
|
1656
|
+
if (Object.hasOwn(c, lower)) {
|
|
1657
|
+
throw new AutotaskConfigError("Audit filter predicates must provide each field once.", { operation });
|
|
1658
|
+
}
|
|
1659
|
+
c[lower] = value;
|
|
1660
|
+
}
|
|
1661
|
+
}
|
|
1662
|
+
if (Array.isArray(c.items)) assertQueryFilterForWire(c.items, operation, auditIds);
|
|
1663
|
+
if (c.udf === true || typeof c.field !== "string") continue;
|
|
1664
|
+
if (c.field.includes(".")) {
|
|
1647
1665
|
throw new AutotaskConfigError(
|
|
1648
1666
|
`${operation}: filter field "${c.field}" is a relation filter that was not resolved on this path \u2014 the request was not issued`,
|
|
1649
1667
|
{ operation, suggestedAction: "Use a query surface that resolves relation filters (query, queryAll, queryBounded, count, operations.aggregate), or filter by the <relation>ID field directly." }
|
|
1650
1668
|
);
|
|
1651
1669
|
}
|
|
1670
|
+
if (auditIds && c.field.trim().toLowerCase() === "id") {
|
|
1671
|
+
const values = Array.isArray(c.value) ? c.value : [c.value];
|
|
1672
|
+
if (c.value === void 0 && (c.op === "exist" || c.op === "notExist")) continue;
|
|
1673
|
+
if (values.length === 0 || values.some((value) => typeof value === "number" ? !Number.isSafeInteger(value) || value < 0 : typeof value !== "string" || !isAuditDecimalId(value))) {
|
|
1674
|
+
throw new AutotaskConfigError(`${operation}: audit log ID filters require a safe integer or an exact decimal string.`, {
|
|
1675
|
+
operation,
|
|
1676
|
+
suggestedAction: "Pass each large ID as an exact decimal string."
|
|
1677
|
+
});
|
|
1678
|
+
}
|
|
1679
|
+
}
|
|
1652
1680
|
}
|
|
1653
1681
|
}
|
|
1654
1682
|
|
|
@@ -1665,14 +1693,14 @@ function assertSafePath(path) {
|
|
|
1665
1693
|
return decoded === "." || decoded === ".." || /[/\\]/.test(decoded);
|
|
1666
1694
|
});
|
|
1667
1695
|
if (bad) {
|
|
1668
|
-
throw new AutotaskConfigError(`Refused request path ${JSON.stringify(path.slice(0, 200))}: not a plain absolute API path (dot segment, '#', '\\', control character or missing leading '/')`);
|
|
1696
|
+
throw new AutotaskConfigError(`Refused request path ${JSON.stringify(path.split("?", 1)[0].slice(0, 200))}: not a plain absolute API path (dot segment, '#', '\\', control character or missing leading '/')`);
|
|
1669
1697
|
}
|
|
1670
1698
|
}
|
|
1671
1699
|
function buildUrl(baseUrl, path, query) {
|
|
1672
1700
|
assertSafePath(path);
|
|
1673
1701
|
let url = baseUrl + path;
|
|
1674
1702
|
if (new URL(url).origin !== new URL(baseUrl).origin) {
|
|
1675
|
-
throw new AutotaskConfigError(`Refused request path ${JSON.stringify(path.slice(0, 200))}: it leaves the configured origin`);
|
|
1703
|
+
throw new AutotaskConfigError(`Refused request path ${JSON.stringify(path.split("?", 1)[0].slice(0, 200))}: it leaves the configured origin`);
|
|
1676
1704
|
}
|
|
1677
1705
|
if (query !== void 0) {
|
|
1678
1706
|
const params = new URLSearchParams();
|
|
@@ -1681,11 +1709,11 @@ function buildUrl(baseUrl, path, query) {
|
|
|
1681
1709
|
params.set(key, String(value));
|
|
1682
1710
|
}
|
|
1683
1711
|
const qs = params.toString();
|
|
1684
|
-
if (qs.length > 0) url +=
|
|
1712
|
+
if (qs.length > 0) url += `${path.includes("?") ? "&" : "?"}${qs}`;
|
|
1685
1713
|
}
|
|
1686
1714
|
return url;
|
|
1687
1715
|
}
|
|
1688
|
-
function cursorToPath(baseUrl, cursor) {
|
|
1716
|
+
function cursorToPath(baseUrl, cursor, resourcePath) {
|
|
1689
1717
|
const base = new URL(baseUrl);
|
|
1690
1718
|
let url;
|
|
1691
1719
|
try {
|
|
@@ -1698,6 +1726,18 @@ function cursorToPath(baseUrl, cursor) {
|
|
|
1698
1726
|
}
|
|
1699
1727
|
const basePath = base.pathname.replace(/\/+$/, "");
|
|
1700
1728
|
const path = basePath !== "" && url.pathname.startsWith(`${basePath}/`) ? url.pathname.slice(basePath.length) : url.pathname;
|
|
1729
|
+
if (resourcePath !== void 0) {
|
|
1730
|
+
let route;
|
|
1731
|
+
try {
|
|
1732
|
+
route = decodeURIComponent(path).toLowerCase().replace(/\/$/, "");
|
|
1733
|
+
} catch {
|
|
1734
|
+
throw new ResponseRejectedError("Refused the pagination cursor: invalid path encoding.");
|
|
1735
|
+
}
|
|
1736
|
+
const query = `${resourcePath.toLowerCase()}/query`;
|
|
1737
|
+
if (route !== query && route !== `${query}/next`) {
|
|
1738
|
+
throw new ResponseRejectedError("Refused the pagination cursor outside the original query route.");
|
|
1739
|
+
}
|
|
1740
|
+
}
|
|
1701
1741
|
return path + url.search;
|
|
1702
1742
|
}
|
|
1703
1743
|
function buildQueryBody(params) {
|
|
@@ -1714,6 +1754,16 @@ function effectiveIncludeFields(params) {
|
|
|
1714
1754
|
if (params.includeFields === void 0) return void 0;
|
|
1715
1755
|
return params.includeFields.includes("id") ? params.includeFields : [...params.includeFields, "id"];
|
|
1716
1756
|
}
|
|
1757
|
+
function assertGetQueryUrlLength(url) {
|
|
1758
|
+
const length = new URL(url).href.length;
|
|
1759
|
+
if (length > MAX_GET_LENGTH) {
|
|
1760
|
+
throw new QueryTooLongError(`GET query URL is ${length} chars; the vendor GET cap is ${MAX_GET_LENGTH}`);
|
|
1761
|
+
}
|
|
1762
|
+
}
|
|
1763
|
+
function buildQueryGetRequest(baseUrl, path, query) {
|
|
1764
|
+
assertGetQueryUrlLength(buildUrl(baseUrl, path, query));
|
|
1765
|
+
return { method: "GET", path, query };
|
|
1766
|
+
}
|
|
1717
1767
|
function buildQueryRequest(baseUrl, resourcePath, params) {
|
|
1718
1768
|
const queryPath = `${resourcePath}/query`;
|
|
1719
1769
|
if (params.via === "get") {
|
|
@@ -1724,18 +1774,7 @@ function buildQueryRequest(baseUrl, resourcePath, params) {
|
|
|
1724
1774
|
if (filter !== void 0) search.filter = filter.filter;
|
|
1725
1775
|
if (params.maxRecords !== void 0) search.maxRecords = params.maxRecords;
|
|
1726
1776
|
if (includeFields !== void 0) search.includeFields = includeFields;
|
|
1727
|
-
|
|
1728
|
-
method: "GET",
|
|
1729
|
-
path: queryPath,
|
|
1730
|
-
query: { search: JSON.stringify(search) }
|
|
1731
|
-
};
|
|
1732
|
-
const url = buildUrl(baseUrl, queryPath, req.query);
|
|
1733
|
-
if (url.length > MAX_GET_LENGTH) {
|
|
1734
|
-
throw new QueryTooLongError(
|
|
1735
|
-
`GET query URL is ${url.length} chars; the vendor GET cap is ${MAX_GET_LENGTH}`
|
|
1736
|
-
);
|
|
1737
|
-
}
|
|
1738
|
-
return req;
|
|
1777
|
+
return buildQueryGetRequest(baseUrl, queryPath, { search: JSON.stringify(search) });
|
|
1739
1778
|
}
|
|
1740
1779
|
return { method: "POST", path: queryPath, body: buildQueryBody(params), idempotent: true };
|
|
1741
1780
|
}
|
|
@@ -10656,6 +10695,69 @@ var RELATIONSHIP_MAP = {
|
|
|
10656
10695
|
},
|
|
10657
10696
|
"deleteBoundary": null,
|
|
10658
10697
|
"markerField": null
|
|
10698
|
+
},
|
|
10699
|
+
"deleted_task_activity_logs": {
|
|
10700
|
+
"resource": "deleted_task_activity_logs",
|
|
10701
|
+
"apiEntity": "DeletedTaskActivityLog",
|
|
10702
|
+
"kind": "entity",
|
|
10703
|
+
"path": "DeletedTaskActivityLogs",
|
|
10704
|
+
"parentScoped": false,
|
|
10705
|
+
"tier": "advanced",
|
|
10706
|
+
"workflowResource": false,
|
|
10707
|
+
"group": "B",
|
|
10708
|
+
"parent": null,
|
|
10709
|
+
"children": [],
|
|
10710
|
+
"naturalKeys": {
|
|
10711
|
+
"hasSearch": false,
|
|
10712
|
+
"searchCovers": null,
|
|
10713
|
+
"findBy": []
|
|
10714
|
+
},
|
|
10715
|
+
"blindSurfaces": null,
|
|
10716
|
+
"zoneFacts": null,
|
|
10717
|
+
"deleteBoundary": null,
|
|
10718
|
+
"markerField": null
|
|
10719
|
+
},
|
|
10720
|
+
"deleted_ticket_activity_logs": {
|
|
10721
|
+
"resource": "deleted_ticket_activity_logs",
|
|
10722
|
+
"apiEntity": "DeletedTicketActivityLog",
|
|
10723
|
+
"kind": "entity",
|
|
10724
|
+
"path": "DeletedTicketActivityLogs",
|
|
10725
|
+
"parentScoped": false,
|
|
10726
|
+
"tier": "advanced",
|
|
10727
|
+
"workflowResource": false,
|
|
10728
|
+
"group": "B",
|
|
10729
|
+
"parent": null,
|
|
10730
|
+
"children": [],
|
|
10731
|
+
"naturalKeys": {
|
|
10732
|
+
"hasSearch": false,
|
|
10733
|
+
"searchCovers": null,
|
|
10734
|
+
"findBy": []
|
|
10735
|
+
},
|
|
10736
|
+
"blindSurfaces": null,
|
|
10737
|
+
"zoneFacts": null,
|
|
10738
|
+
"deleteBoundary": null,
|
|
10739
|
+
"markerField": null
|
|
10740
|
+
},
|
|
10741
|
+
"deleted_ticket_logs": {
|
|
10742
|
+
"resource": "deleted_ticket_logs",
|
|
10743
|
+
"apiEntity": "DeletedTicketLog",
|
|
10744
|
+
"kind": "entity",
|
|
10745
|
+
"path": "DeletedTicketLogs",
|
|
10746
|
+
"parentScoped": false,
|
|
10747
|
+
"tier": "advanced",
|
|
10748
|
+
"workflowResource": false,
|
|
10749
|
+
"group": "B",
|
|
10750
|
+
"parent": null,
|
|
10751
|
+
"children": [],
|
|
10752
|
+
"naturalKeys": {
|
|
10753
|
+
"hasSearch": false,
|
|
10754
|
+
"searchCovers": null,
|
|
10755
|
+
"findBy": []
|
|
10756
|
+
},
|
|
10757
|
+
"blindSurfaces": null,
|
|
10758
|
+
"zoneFacts": null,
|
|
10759
|
+
"deleteBoundary": null,
|
|
10760
|
+
"markerField": null
|
|
10659
10761
|
}
|
|
10660
10762
|
};
|
|
10661
10763
|
var BLIND_SURFACE_STAMPS = {
|
|
@@ -15984,6 +16086,15 @@ var UNTRUSTED_FIELDS_BY_RESOURCE = {
|
|
|
15984
16086
|
],
|
|
15985
16087
|
"resource_attachments": [
|
|
15986
16088
|
"title"
|
|
16089
|
+
],
|
|
16090
|
+
"deleted_task_activity_logs": [
|
|
16091
|
+
"noteOrAttachmentTitle"
|
|
16092
|
+
],
|
|
16093
|
+
"deleted_ticket_activity_logs": [
|
|
16094
|
+
"noteOrAttachmentTitle"
|
|
16095
|
+
],
|
|
16096
|
+
"deleted_ticket_logs": [
|
|
16097
|
+
"ticketTitle"
|
|
15987
16098
|
]
|
|
15988
16099
|
};
|
|
15989
16100
|
|
|
@@ -16420,6 +16531,74 @@ function credentialShapeExpectation(headers, auth) {
|
|
|
16420
16531
|
|
|
16421
16532
|
// src/http/envelope.ts
|
|
16422
16533
|
var INVALID_SHAPE_ACTION = "Report the unexpected response shape; verify baseUrl points at the REST API.";
|
|
16534
|
+
var AUDIT_READ_PATH = /^\/v1\.0\/(DeletedTaskActivityLogs|DeletedTicketActivityLogs|DeletedTicketLogs)\/(query\/(?:next|previous|count)|[^/?]+)\/?(?:\?.*)?$/i;
|
|
16535
|
+
function isAuditLogResource(resource) {
|
|
16536
|
+
return /^(deleted_task_activity_logs|deleted_ticket_activity_logs|deleted_ticket_logs)$/.test(resource);
|
|
16537
|
+
}
|
|
16538
|
+
function isDeletedAuditRead(operation) {
|
|
16539
|
+
const [resource = "", verb, suffix] = operation?.split(".") ?? [];
|
|
16540
|
+
return suffix === void 0 && (verb === "get" || verb === "query") && isAuditLogResource(resource);
|
|
16541
|
+
}
|
|
16542
|
+
function auditReadTarget(path, operation) {
|
|
16543
|
+
const match = AUDIT_READ_PATH.exec(path);
|
|
16544
|
+
const target = match?.[2]?.toLowerCase();
|
|
16545
|
+
if (target === "query" || target === "query/next" || target === "query/previous") return "query";
|
|
16546
|
+
if (target === "entityinformation") return void 0;
|
|
16547
|
+
if (target === "query/count") return target;
|
|
16548
|
+
if (target !== void 0 && !isAuditDecimalId(target)) {
|
|
16549
|
+
throw new AutotaskConfigError("Audit log ID must be a non-negative signed 64-bit integer.", { operation });
|
|
16550
|
+
}
|
|
16551
|
+
return target;
|
|
16552
|
+
}
|
|
16553
|
+
function decodeResponseJson(text, auditTarget) {
|
|
16554
|
+
if (auditTarget === void 0) return JSON.parse(text);
|
|
16555
|
+
if (auditTarget === "query/count") {
|
|
16556
|
+
return JSON.parse(text, (key, value, context) => key === "queryCount" && typeof value === "number" && !isAuditDecimalId(context?.source ?? "") ? null : value);
|
|
16557
|
+
}
|
|
16558
|
+
const idTokens = /* @__PURE__ */ new WeakMap();
|
|
16559
|
+
const body = JSON.parse(text, function(key, value, context) {
|
|
16560
|
+
if (key === "id" && typeof value === "number" && context?.source !== void 0) {
|
|
16561
|
+
idTokens.set(this, context.source);
|
|
16562
|
+
}
|
|
16563
|
+
return value;
|
|
16564
|
+
});
|
|
16565
|
+
const rows = isRecord2(body) ? auditTarget === "query" ? body.items : [body.item] : void 0;
|
|
16566
|
+
if (Array.isArray(rows)) {
|
|
16567
|
+
for (const row of rows) {
|
|
16568
|
+
if (!isRecord2(row) || typeof row.id !== "number") continue;
|
|
16569
|
+
const token = idTokens.get(row);
|
|
16570
|
+
if (token === void 0 || !isAuditDecimalId(token)) row.id = null;
|
|
16571
|
+
else if (!Number.isSafeInteger(row.id)) row.id = token;
|
|
16572
|
+
}
|
|
16573
|
+
}
|
|
16574
|
+
return body;
|
|
16575
|
+
}
|
|
16576
|
+
function isAuditItem(item) {
|
|
16577
|
+
if (!isRecord2(item)) return false;
|
|
16578
|
+
const { id } = item;
|
|
16579
|
+
return typeof id === "number" ? Number.isSafeInteger(id) && id >= 0 : typeof id === "string" && isAuditDecimalId(id);
|
|
16580
|
+
}
|
|
16581
|
+
function isAuditPage(body) {
|
|
16582
|
+
if (!Array.isArray(body.items) || !isRecord2(body.pageDetails)) return false;
|
|
16583
|
+
const { nextPageUrl } = body.pageDetails;
|
|
16584
|
+
return (nextPageUrl === null || typeof nextPageUrl === "string" && nextPageUrl.trim() !== "") && body.items.every(isAuditItem);
|
|
16585
|
+
}
|
|
16586
|
+
function validateAuditResponse(body, target, operation) {
|
|
16587
|
+
if (target === void 0) return;
|
|
16588
|
+
if (target === "query/count") {
|
|
16589
|
+
unwrapQueryCount(body, operation);
|
|
16590
|
+
return;
|
|
16591
|
+
}
|
|
16592
|
+
const valid = isRecord2(body) && (target === "query" ? isAuditPage(body) : body.item === null || isAuditItem(body.item) && String(body.item.id) === target);
|
|
16593
|
+
if (!valid) {
|
|
16594
|
+
throw new AutotaskError("Expected a valid audit log response for the requested path.", {
|
|
16595
|
+
code: "INVALID_RESPONSE",
|
|
16596
|
+
category: "server",
|
|
16597
|
+
operation,
|
|
16598
|
+
suggestedAction: INVALID_SHAPE_ACTION
|
|
16599
|
+
});
|
|
16600
|
+
}
|
|
16601
|
+
}
|
|
16423
16602
|
function attachEmptyReasonDetails(err) {
|
|
16424
16603
|
if (err.operation === void 0) return;
|
|
16425
16604
|
const dot = err.operation.indexOf(".");
|
|
@@ -16445,7 +16624,7 @@ function attachEmptyReasonDetails(err) {
|
|
|
16445
16624
|
} : {
|
|
16446
16625
|
surface,
|
|
16447
16626
|
kind: "not-found",
|
|
16448
|
-
note: `no ${resource} record exists at this id (a miss is the data, not an error condition)`,
|
|
16627
|
+
note: isDeletedAuditRead(surface) ? "No audit log entry at this ID was visible to this API user." : `no ${resource} record exists at this id (a miss is the data, not an error condition)`,
|
|
16449
16628
|
authority: `${resource}.query`,
|
|
16450
16629
|
remedy: `query the ${resource} collection (a bounded queryBounded walk) or verify the id from the authority surface \u2014 do not retry the same get`
|
|
16451
16630
|
};
|
|
@@ -16483,7 +16662,7 @@ function unwrapItem(body, id, operation, entity) {
|
|
|
16483
16662
|
resourceIds: id !== void 0 ? [id] : void 0,
|
|
16484
16663
|
...id !== void 0 && entity !== void 0 ? { details: { idRefs: [{ entity, id }] } } : {},
|
|
16485
16664
|
operation,
|
|
16486
|
-
suggestedAction: "Verify the id, or resolve the record by name first."
|
|
16665
|
+
suggestedAction: isDeletedAuditRead(operation) ? "Verify the log ID and check API-user access." : "Verify the id, or resolve the record by name first."
|
|
16487
16666
|
}
|
|
16488
16667
|
);
|
|
16489
16668
|
attachEmptyReasonDetails(err);
|
|
@@ -16492,8 +16671,9 @@ function unwrapItem(body, id, operation, entity) {
|
|
|
16492
16671
|
return item;
|
|
16493
16672
|
}
|
|
16494
16673
|
function unwrapQueryCount(body, operation) {
|
|
16495
|
-
|
|
16496
|
-
|
|
16674
|
+
const count = isRecord2(body) ? body.queryCount : void 0;
|
|
16675
|
+
if (typeof count !== "number" || !Number.isInteger(count) || count < 0 || count > 2147483647) {
|
|
16676
|
+
const err = new AutotaskError("Expected the count envelope { queryCount: non-negative int32 }", {
|
|
16497
16677
|
code: "INVALID_RESPONSE",
|
|
16498
16678
|
category: "server",
|
|
16499
16679
|
operation,
|
|
@@ -16502,7 +16682,7 @@ function unwrapQueryCount(body, operation) {
|
|
|
16502
16682
|
attachEmptyReasonDetails(err);
|
|
16503
16683
|
throw err;
|
|
16504
16684
|
}
|
|
16505
|
-
return
|
|
16685
|
+
return count;
|
|
16506
16686
|
}
|
|
16507
16687
|
function unwrapOperation(body, operation) {
|
|
16508
16688
|
const value = isRecord2(body) ? body.itemId !== void 0 ? body.itemId : body.id : void 0;
|
|
@@ -16856,8 +17036,7 @@ var HttpClient = class {
|
|
|
16856
17036
|
since,
|
|
16857
17037
|
retryAfterMs: s.maintenancePollMs,
|
|
16858
17038
|
httpStatus: status,
|
|
16859
|
-
contentType,
|
|
16860
|
-
bodySnippet: bodySnippet(text, this.redactPersonalData),
|
|
17039
|
+
...s.getQuery ? {} : { contentType, bodySnippet: bodySnippet(text, this.redactPersonalData) },
|
|
16861
17040
|
maintenanceDetected: true
|
|
16862
17041
|
},
|
|
16863
17042
|
suggestedAction: unknownWrite ? `A maintenance-shaped page answered ${method} ${opts.path} (HTTP ${status}); it was NOT waited out or re-sent \u2014 a non-2xx edge page can arrive after the request was forwarded, so verify the record before re-issuing (only a GET or an explicitly idempotent-flagged call waits this window out).` : `The Autotask zone is in its maintenance window (since ${since}); retry after the window (windows usually last 30-90 min).`
|
|
@@ -16962,7 +17141,7 @@ var HttpClient = class {
|
|
|
16962
17141
|
return { retry: true };
|
|
16963
17142
|
}
|
|
16964
17143
|
throw new AutotaskNetworkError(
|
|
16965
|
-
`Network error during ${method} ${opts.path}: ${err instanceof Error ? err.message : String(err)}`,
|
|
17144
|
+
`Network error during ${method} ${opts.path}: ${s.url.includes("?") ? "transport failure" : err instanceof Error ? err.message : String(err)}`,
|
|
16966
17145
|
ctx
|
|
16967
17146
|
);
|
|
16968
17147
|
}
|
|
@@ -16983,7 +17162,7 @@ var HttpClient = class {
|
|
|
16983
17162
|
if (err instanceof AutotaskError) throw err;
|
|
16984
17163
|
if (s.signal.aborted || isAbortLike(err)) throw this.interrupted(s);
|
|
16985
17164
|
throw new AutotaskNetworkError(
|
|
16986
|
-
`Network error reading the response of ${method} ${opts.path}: ${err instanceof Error ? err.message : String(err)}`,
|
|
17165
|
+
`Network error reading the response of ${method} ${opts.path}: ${s.url.includes("?") ? "transport failure" : err instanceof Error ? err.message : String(err)}`,
|
|
16987
17166
|
ctx
|
|
16988
17167
|
);
|
|
16989
17168
|
}
|
|
@@ -17010,10 +17189,11 @@ var HttpClient = class {
|
|
|
17010
17189
|
}
|
|
17011
17190
|
let parsed;
|
|
17012
17191
|
try {
|
|
17013
|
-
parsed =
|
|
17192
|
+
parsed = decodeResponseJson(text, s.auditTarget);
|
|
17014
17193
|
} catch {
|
|
17015
17194
|
return this.handleNonJson2xx(s, res, status, text);
|
|
17016
17195
|
}
|
|
17196
|
+
validateAuditResponse(parsed, s.auditTarget, opts.operation);
|
|
17017
17197
|
return {
|
|
17018
17198
|
done: true,
|
|
17019
17199
|
value: opts.skipResponseRedaction ? parsed : redactResponseBody(parsed, { redactPersonalData: this.redactPersonalData }),
|
|
@@ -17030,13 +17210,12 @@ var HttpClient = class {
|
|
|
17030
17210
|
httpStatus: status,
|
|
17031
17211
|
details: {
|
|
17032
17212
|
httpStatus: status,
|
|
17033
|
-
contentType,
|
|
17034
|
-
bodySnippet: bodySnippet(text, this.redactPersonalData)
|
|
17213
|
+
...s.getQuery ? {} : { contentType, bodySnippet: bodySnippet(text, this.redactPersonalData) }
|
|
17035
17214
|
},
|
|
17036
17215
|
// The content-type is host-sourced (a host-supplied
|
|
17037
17216
|
// baseUrl can serve arbitrary HTML) — capped, never prose;
|
|
17038
17217
|
// the raw snippet rides details only.
|
|
17039
|
-
suggestedAction: retriable5xx ? `The zone answered with a non-JSON body (content-type: ${contentType.slice(0, 100)}); the zone is likely in a maintenance window \u2014 retry after the window, or verify baseUrl points at the REST API.` : `The zone answered a write with a non-JSON body (content-type: ${contentType.slice(0, 100)}); the request may have taken effect \u2014 verify the record before re-issuing (writes are never auto-retried).`
|
|
17218
|
+
suggestedAction: method === "GET" || retriable5xx ? `The zone answered with a non-JSON body (content-type: ${s.getQuery ? "non-JSON" : contentType.slice(0, 100)}); the zone is likely in a maintenance window \u2014 retry after the window, or verify baseUrl points at the REST API.` : `The zone answered a write with a non-JSON body (content-type: ${contentType.slice(0, 100)}); the request may have taken effect \u2014 verify the record before re-issuing (writes are never auto-retried).`
|
|
17040
17219
|
}
|
|
17041
17220
|
) : new AutotaskError(`Invalid JSON response body for ${method} ${opts.path}`, {
|
|
17042
17221
|
...ctx,
|
|
@@ -17082,7 +17261,7 @@ var HttpClient = class {
|
|
|
17082
17261
|
nonJsonBody = text;
|
|
17083
17262
|
}
|
|
17084
17263
|
}
|
|
17085
|
-
const nonJsonSnippet = nonJsonBody === void 0 ? void 0 : bodySnippet(nonJsonBody, this.redactPersonalData);
|
|
17264
|
+
const nonJsonSnippet = nonJsonBody === void 0 || s.getQuery ? void 0 : bodySnippet(nonJsonBody, this.redactPersonalData);
|
|
17086
17265
|
const nonJsonIsMaintenance = s.maintenancePage;
|
|
17087
17266
|
const nonJsonIsHtmlCandidate = nonJsonBody !== void 0 && isHtmlLike(res.headers.get("Content-Type"), nonJsonBody);
|
|
17088
17267
|
if (nonJsonIsMaintenance) {
|
|
@@ -17106,9 +17285,12 @@ var HttpClient = class {
|
|
|
17106
17285
|
);
|
|
17107
17286
|
}
|
|
17108
17287
|
if (target !== void 0 && targetViolation === null && target !== this.baseUrl) {
|
|
17288
|
+
const retryUrl = buildUrl(target, s.wirePath);
|
|
17289
|
+
if (s.getQuery) assertGetQueryUrlLength(retryUrl);
|
|
17109
17290
|
s.zoneRetry = { from: this.baseUrl, to: target };
|
|
17110
17291
|
this.repointZoneBase(target);
|
|
17111
|
-
s.url =
|
|
17292
|
+
s.url = retryUrl;
|
|
17293
|
+
s.ctx.url = s.url.split("?", 1)[0];
|
|
17112
17294
|
return RETRY;
|
|
17113
17295
|
}
|
|
17114
17296
|
}
|
|
@@ -17116,10 +17298,11 @@ var HttpClient = class {
|
|
|
17116
17298
|
const err = errorFromStatus(
|
|
17117
17299
|
status,
|
|
17118
17300
|
body,
|
|
17119
|
-
s.url,
|
|
17301
|
+
s.ctx.url,
|
|
17120
17302
|
opts.operation,
|
|
17121
17303
|
this.redactPersonalData,
|
|
17122
|
-
credentialShapeExpectation(s.headers, this.auth)
|
|
17304
|
+
credentialShapeExpectation(s.headers, this.auth),
|
|
17305
|
+
!s.getQuery
|
|
17123
17306
|
);
|
|
17124
17307
|
err.correlationId = s.correlationId;
|
|
17125
17308
|
this.stampMaintenance(s, err);
|
|
@@ -17204,11 +17387,20 @@ var HttpClient = class {
|
|
|
17204
17387
|
async request(opts) {
|
|
17205
17388
|
const method = opts.method;
|
|
17206
17389
|
const url = buildUrl(this.baseUrl, opts.path, opts.query);
|
|
17390
|
+
const wirePath = url.slice(this.baseUrl.length);
|
|
17391
|
+
const path = wirePath.split("?", 1)[0];
|
|
17392
|
+
const route = decodeURIComponent(path);
|
|
17393
|
+
const auditTarget = auditReadTarget(route, opts.operation);
|
|
17207
17394
|
const headers = withAuthHeaders(opts.headers, this.auth);
|
|
17208
17395
|
assertCredentialShape(headers, this.auth);
|
|
17209
|
-
|
|
17210
|
-
|
|
17396
|
+
const requestUrl = new URL(url);
|
|
17397
|
+
const queryRoute = /\/query(?:\/|$)/i.test(route);
|
|
17398
|
+
const getQuery = method === "GET" && queryRoute && requestUrl.search !== "";
|
|
17399
|
+
if (getQuery) assertGetQueryUrlLength(url);
|
|
17211
17400
|
const bodyText = opts.body !== void 0 ? JSON.stringify(opts.body) : void 0;
|
|
17401
|
+
if (queryRoute) assertQueryFilters(opts, requestUrl, auditTarget === "query" || auditTarget === "query/count", bodyText);
|
|
17402
|
+
opts = { ...opts, path };
|
|
17403
|
+
if (bodyText !== void 0) headers["Content-Type"] = "application/json";
|
|
17212
17404
|
const correlationId = newCorrelationId();
|
|
17213
17405
|
const timeoutMs = opts.timeoutMs ?? this.timeoutMs;
|
|
17214
17406
|
const started = Date.now();
|
|
@@ -17216,7 +17408,10 @@ var HttpClient = class {
|
|
|
17216
17408
|
const deadline = new AbortController();
|
|
17217
17409
|
const s = {
|
|
17218
17410
|
opts,
|
|
17411
|
+
wirePath,
|
|
17412
|
+
getQuery,
|
|
17219
17413
|
method,
|
|
17414
|
+
auditTarget,
|
|
17220
17415
|
url,
|
|
17221
17416
|
headers,
|
|
17222
17417
|
bodyText,
|
|
@@ -17257,7 +17452,7 @@ var HttpClient = class {
|
|
|
17257
17452
|
// undefined (the vendor's 204 / empty delete answer; the delete callers
|
|
17258
17453
|
// synthesize the result from the path id).
|
|
17259
17454
|
expectBody: opts.expectBody ?? method !== "DELETE",
|
|
17260
|
-
ctx: { operation: opts.operation, url, correlationId },
|
|
17455
|
+
ctx: { operation: opts.operation, url: url.split("?", 1)[0], correlationId },
|
|
17261
17456
|
lastStatus: void 0,
|
|
17262
17457
|
zoneRetry: void 0,
|
|
17263
17458
|
attempt: 0,
|
|
@@ -17309,19 +17504,30 @@ function isMaintenancePage(status, contentType, text) {
|
|
|
17309
17504
|
return true;
|
|
17310
17505
|
}
|
|
17311
17506
|
}
|
|
17312
|
-
function
|
|
17313
|
-
const operation = opts.operation ?? opts.path;
|
|
17314
|
-
const
|
|
17315
|
-
|
|
17316
|
-
|
|
17317
|
-
|
|
17318
|
-
|
|
17319
|
-
|
|
17320
|
-
|
|
17321
|
-
|
|
17322
|
-
|
|
17507
|
+
function assertQueryFilters(opts, url, auditIds, bodyText) {
|
|
17508
|
+
const operation = opts.operation ?? opts.path.split("?", 1)[0];
|
|
17509
|
+
const validate7 = (value) => {
|
|
17510
|
+
if (value === null || typeof value !== "object") return;
|
|
17511
|
+
for (const [key, filter] of Object.entries(value)) {
|
|
17512
|
+
if (key.toLowerCase() === "filter") assertQueryFilterForWire(filter, operation, auditIds);
|
|
17513
|
+
}
|
|
17514
|
+
};
|
|
17515
|
+
const parse = (json) => auditIds ? JSON.parse(
|
|
17516
|
+
json,
|
|
17517
|
+
(_key, value, context) => typeof value === "number" && context?.source !== void 0 && !isAuditDecimalId(context.source) ? null : value
|
|
17518
|
+
) : JSON.parse(json);
|
|
17519
|
+
validate7(auditIds && bodyText !== void 0 ? parse(bodyText) : opts.body);
|
|
17520
|
+
for (const [key, search] of url.searchParams) {
|
|
17521
|
+
if (key.toLowerCase() !== "search") continue;
|
|
17522
|
+
let parsed;
|
|
17523
|
+
try {
|
|
17524
|
+
parsed = parse(search);
|
|
17525
|
+
} catch {
|
|
17526
|
+
if (auditIds) throw new AutotaskConfigError("Expected a JSON search object for the audit query.", { operation });
|
|
17527
|
+
continue;
|
|
17528
|
+
}
|
|
17529
|
+
validate7(parsed);
|
|
17323
17530
|
}
|
|
17324
|
-
if (parsed !== null && typeof parsed === "object") assertNoRelationLeaf(parsed.filter, operation);
|
|
17325
17531
|
}
|
|
17326
17532
|
|
|
17327
17533
|
// src/pagination.ts
|
|
@@ -17341,7 +17547,7 @@ async function* paginate(fetchPage, opts = {}) {
|
|
|
17341
17547
|
}
|
|
17342
17548
|
const p = await fetchPage(page, pageSize);
|
|
17343
17549
|
yield p;
|
|
17344
|
-
if (!p.hasMore || p.items.length === 0) return;
|
|
17550
|
+
if (!p.hasMore || p.items.length === 0 && !opts.continueOnEmpty) return;
|
|
17345
17551
|
page += 1;
|
|
17346
17552
|
}
|
|
17347
17553
|
}
|
|
@@ -18658,21 +18864,27 @@ var FK_TABLE_PATH = {
|
|
|
18658
18864
|
billingCode: "/V1.0/BillingCodes",
|
|
18659
18865
|
contract: "/V1.0/Contracts",
|
|
18660
18866
|
company: "/V1.0/Companies",
|
|
18661
|
-
ticket: "/V1.0/Tickets"
|
|
18867
|
+
ticket: "/V1.0/Tickets",
|
|
18868
|
+
product: "/V1.0/Products",
|
|
18869
|
+
configurationItemCategory: "/V1.0/ConfigurationItemCategories"
|
|
18662
18870
|
};
|
|
18663
18871
|
var FK_GET_OPERATION = {
|
|
18664
18872
|
role: "roles.get",
|
|
18665
18873
|
billingCode: "billing_codes.get",
|
|
18666
18874
|
contract: "contracts.get",
|
|
18667
18875
|
company: "companies.get",
|
|
18668
|
-
ticket: "tickets.get"
|
|
18876
|
+
ticket: "tickets.get",
|
|
18877
|
+
product: "products.get",
|
|
18878
|
+
configurationItemCategory: "configuration_item_categories.get"
|
|
18669
18879
|
};
|
|
18670
18880
|
var FK_NAME_FIELD = {
|
|
18671
18881
|
role: "name",
|
|
18672
18882
|
billingCode: "name",
|
|
18673
18883
|
contract: "contractName",
|
|
18674
18884
|
company: "companyName",
|
|
18675
|
-
ticket: "ticketNumber"
|
|
18885
|
+
ticket: "ticketNumber",
|
|
18886
|
+
product: "name",
|
|
18887
|
+
configurationItemCategory: "name"
|
|
18676
18888
|
};
|
|
18677
18889
|
function fkName(record, table) {
|
|
18678
18890
|
if (table === "ticket") {
|
|
@@ -18747,7 +18959,9 @@ async function resolveCompositeNames(http, plan, opts = {}) {
|
|
|
18747
18959
|
billingCode: client.billingCodes,
|
|
18748
18960
|
contract: client.contracts,
|
|
18749
18961
|
company: client.companies,
|
|
18750
|
-
ticket: client.tickets
|
|
18962
|
+
ticket: client.tickets,
|
|
18963
|
+
product: client.products,
|
|
18964
|
+
configurationItemCategory: client.configurationItemCategories
|
|
18751
18965
|
};
|
|
18752
18966
|
for (const fk2 of plan.recordFks) {
|
|
18753
18967
|
const key = `${fk2.table}:${fk2.id}`;
|
|
@@ -19027,6 +19241,9 @@ var MODEL_FIELD_SETS = {
|
|
|
19027
19241
|
"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"],
|
|
19028
19242
|
"countries": ["id", "addressFormatID", "countryCode", "displayName", "invoiceTemplateID", "isActive", "isDefaultCountry", "name", "purchaseOrderTemplateID", "quoteTemplateID"],
|
|
19029
19243
|
"currencies": ["id", "currencyNegativeFormat", "currencyPositiveFormat", "description", "displaySymbol", "exchangeRate", "isActive", "isInternalCurrency", "lastModifiedDateTime", "name", "updateResourceId"],
|
|
19244
|
+
"deleted_task_activity_logs": ["id", "typeID", "taskID", "taskNumber", "noteOrAttachmentTitle", "createdByResourceID", "activityDateTime", "startDateTime", "endDateTime", "hoursWorked", "deletedByResourceID", "deletedDateTime"],
|
|
19245
|
+
"deleted_ticket_activity_logs": ["id", "typeID", "ticketID", "ticketNumber", "noteOrAttachmentTitle", "createdByResourceID", "activityDateTime", "startDateTime", "endDateTime", "hoursWorked", "deletedByResourceID", "deletedDateTime"],
|
|
19246
|
+
"deleted_ticket_logs": ["id", "ticketID", "ticketNumber", "ticketTitle", "deletedByResourceID", "deletedDateTime"],
|
|
19030
19247
|
"departments": ["id", "description", "name", "number", "primaryLocationID"],
|
|
19031
19248
|
"domain_registrars": ["id", "name", "url"],
|
|
19032
19249
|
"expense_item_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "expenseItemID", "expenseReportID", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
|
|
@@ -19142,6 +19359,9 @@ var MODEL_DATE_FIELDS = {
|
|
|
19142
19359
|
"contract_ticket_purchases": ["datePurchased", "endDate", "startDate"],
|
|
19143
19360
|
"contracts": ["endDate", "lastModifiedDateTime", "startDate"],
|
|
19144
19361
|
"currencies": ["lastModifiedDateTime"],
|
|
19362
|
+
"deleted_task_activity_logs": ["activityDateTime", "startDateTime", "endDateTime", "deletedDateTime"],
|
|
19363
|
+
"deleted_ticket_activity_logs": ["activityDateTime", "startDateTime", "endDateTime", "deletedDateTime"],
|
|
19364
|
+
"deleted_ticket_logs": ["deletedDateTime"],
|
|
19145
19365
|
"expense_item_attachments": ["attachDate"],
|
|
19146
19366
|
"expense_items": ["expenseDate"],
|
|
19147
19367
|
"expense_report_attachments": ["attachDate"],
|
|
@@ -19371,7 +19591,10 @@ var ROW_FK_TABLES = {
|
|
|
19371
19591
|
contractID: "contract",
|
|
19372
19592
|
ticketID: "ticket",
|
|
19373
19593
|
roleID: "role",
|
|
19374
|
-
billingCodeID: "billingCode"
|
|
19594
|
+
billingCodeID: "billingCode",
|
|
19595
|
+
productID: "product",
|
|
19596
|
+
vendorID: "company",
|
|
19597
|
+
configurationItemCategoryID: "configurationItemCategory"
|
|
19375
19598
|
};
|
|
19376
19599
|
var isResourceFkField = (field) => field === "resourceID" || field.endsWith("ResourceID");
|
|
19377
19600
|
function rowNamePlan(rows, resourceKey, picklistFields = []) {
|
|
@@ -19541,14 +19764,20 @@ var QueryBase = class {
|
|
|
19541
19764
|
// ------------------------------------------------------------------
|
|
19542
19765
|
// Query walk (wired to the G3 walker; cursor-follow per the pinned wire)
|
|
19543
19766
|
// ------------------------------------------------------------------
|
|
19544
|
-
/**
|
|
19767
|
+
/** Follow the vendor cursor with the initial query method and, for POST, the same QueryModel (issue #118). */
|
|
19545
19768
|
async fetchPage(params, page, pageSize, state2) {
|
|
19546
|
-
if (params.includeFields !== void 0) {
|
|
19769
|
+
if (state2.initialRequest === void 0 && params.includeFields !== void 0) {
|
|
19547
19770
|
params = { ...params, includeFields: params.includeFields.map((field) => normalizeOwnField(this.config.key, field)) };
|
|
19548
19771
|
}
|
|
19549
19772
|
const operation = `${this.config.key}.query`;
|
|
19550
19773
|
if (page === 1) {
|
|
19774
|
+
const filter = normalizedConditions(params.filter);
|
|
19775
|
+
if (filter !== void 0 && isAuditLogResource(this.config.key)) {
|
|
19776
|
+
assertQueryFilterForWire(normalizeInValues(filter), operation, true);
|
|
19777
|
+
}
|
|
19551
19778
|
const req = buildQueryRequest(this.http.baseUrl, this.resourcePath, { ...params, maxRecords: pageSize });
|
|
19779
|
+
if (req.body !== void 0) req.body = JSON.parse(JSON.stringify(req.body));
|
|
19780
|
+
state2.initialRequest = req;
|
|
19552
19781
|
const body2 = await this.http.request({ ...req, operation });
|
|
19553
19782
|
return this.readPage(body2, page, pageSize, state2);
|
|
19554
19783
|
}
|
|
@@ -19560,10 +19789,25 @@ var QueryBase = class {
|
|
|
19560
19789
|
operation
|
|
19561
19790
|
});
|
|
19562
19791
|
}
|
|
19563
|
-
const
|
|
19792
|
+
const cursorResource = isAuditLogResource(this.config.key) ? this.resourcePath : void 0;
|
|
19793
|
+
if (state2.initialRequest?.method === "GET") {
|
|
19794
|
+
const path = cursorToPath(this.http.baseUrl, cursor, cursorResource);
|
|
19795
|
+
const separator = path.indexOf("?");
|
|
19796
|
+
const route = separator < 0 ? path : path.slice(0, separator);
|
|
19797
|
+
const cursorParams = new URLSearchParams(separator < 0 ? "" : path.slice(separator + 1));
|
|
19798
|
+
const search = state2.initialRequest.query?.search;
|
|
19799
|
+
for (const key of [...cursorParams.keys()]) {
|
|
19800
|
+
if (key.toLowerCase() === "search") cursorParams.delete(key);
|
|
19801
|
+
}
|
|
19802
|
+
if (typeof search === "string") cursorParams.set("search", search);
|
|
19803
|
+
const req = buildQueryGetRequest(this.http.baseUrl, route + "?" + cursorParams.toString());
|
|
19804
|
+
const body2 = await this.http.request({ ...req, operation });
|
|
19805
|
+
return this.readPage(body2, page, pageSize, state2);
|
|
19806
|
+
}
|
|
19807
|
+
const body = state2.initialRequest?.body ?? buildQueryBody({ ...params, maxRecords: pageSize });
|
|
19564
19808
|
const res = await this.http.request({
|
|
19565
19809
|
method: "POST",
|
|
19566
|
-
path: cursorToPath(this.http.baseUrl, cursor),
|
|
19810
|
+
path: cursorToPath(this.http.baseUrl, cursor, cursorResource),
|
|
19567
19811
|
body,
|
|
19568
19812
|
operation,
|
|
19569
19813
|
idempotent: true
|
|
@@ -19622,10 +19866,10 @@ var QueryBase = class {
|
|
|
19622
19866
|
const walk = await this.relationWalkParams(rest, `${this.config.key}.query`);
|
|
19623
19867
|
if (walk === void 0) return;
|
|
19624
19868
|
if (!label || client === void 0) {
|
|
19625
|
-
yield* paginateItems(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk) });
|
|
19869
|
+
yield* paginateItems(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk), continueOnEmpty: isAuditLogResource(this.config.key) });
|
|
19626
19870
|
return;
|
|
19627
19871
|
}
|
|
19628
|
-
for await (const page of paginate(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk) })) {
|
|
19872
|
+
for await (const page of paginate(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk), continueOnEmpty: isAuditLogResource(this.config.key) })) {
|
|
19629
19873
|
const labelled = await labelRows(client, this.config.key, page.items);
|
|
19630
19874
|
yield* labelled.rows;
|
|
19631
19875
|
}
|
|
@@ -19634,13 +19878,13 @@ var QueryBase = class {
|
|
|
19634
19878
|
async *queryPageIter(params) {
|
|
19635
19879
|
const walk = await this.relationWalkParams(params, `${this.config.key}.query`);
|
|
19636
19880
|
if (walk === void 0) return;
|
|
19637
|
-
yield* paginate(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk) });
|
|
19881
|
+
yield* paginate(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk), continueOnEmpty: isAuditLogResource(this.config.key) });
|
|
19638
19882
|
}
|
|
19639
19883
|
/** Collect every item across all pages (the resource `queryAll` surface; 1000-page guarded; relation filters resolve first, #281). */
|
|
19640
19884
|
async queryAllItems(params) {
|
|
19641
19885
|
const walk = await this.relationWalkParams(params, `${this.config.key}.query`);
|
|
19642
19886
|
if (walk === void 0) return [];
|
|
19643
|
-
return collectAll(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk), maxRecords: walk.maxTotalRecords });
|
|
19887
|
+
return collectAll(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk), continueOnEmpty: isAuditLogResource(this.config.key), maxRecords: walk.maxTotalRecords });
|
|
19644
19888
|
}
|
|
19645
19889
|
/**
|
|
19646
19890
|
* `queryBounded` — server-side pagination (the MCP query surface): ONE call
|
|
@@ -19651,12 +19895,10 @@ var QueryBase = class {
|
|
|
19651
19895
|
* AutotaskConfigError; it is NOT a page size). The page-1 request uses
|
|
19652
19896
|
* the internal page size min(500, limit) (the `latest` mechanism sizes
|
|
19653
19897
|
* its walk from the matching count). Explicit `walk.maxRows` replaces
|
|
19654
|
-
* the total cap; `limit` then only sizes pages.
|
|
19655
|
-
*
|
|
19656
|
-
*
|
|
19657
|
-
*
|
|
19658
|
-
* page size), so the walk reuses `fetchPage` (the shared cursor machinery)
|
|
19659
|
-
* with a per-walk closure state (walks never share state).
|
|
19898
|
+
* the total cap; `limit` then only sizes pages. Continuations follow the
|
|
19899
|
+
* cursor with the initial method. POST keeps the same QueryModel body
|
|
19900
|
+
* across pages (issue #118). GET combines the cursor with the original search.
|
|
19901
|
+
* Each walk keeps its own request and cursor state.
|
|
19660
19902
|
* - The 1000-page guard still applies as a SOFT stop: a walk that would
|
|
19661
19903
|
* fetch a 1001st page stops with `hasMore: true` (never a throw — this
|
|
19662
19904
|
* is a bounded read, not the `paginate` generator's error path).
|
|
@@ -19818,7 +20060,7 @@ var QueryBase = class {
|
|
|
19818
20060
|
if (consume === void 0) items.push(...take);
|
|
19819
20061
|
else await consume(take, pages2);
|
|
19820
20062
|
if (fetched >= limit) break;
|
|
19821
|
-
if (!page.hasMore || page.items.length === 0) break;
|
|
20063
|
+
if (!page.hasMore || page.items.length === 0 && !isAuditLogResource(this.config.key)) break;
|
|
19822
20064
|
}
|
|
19823
20065
|
const names = nameNotes.size === 0 ? void 0 : {
|
|
19824
20066
|
note: [...nameNotes].join("; "),
|
|
@@ -19965,13 +20207,17 @@ var QueryBase = class {
|
|
|
19965
20207
|
};
|
|
19966
20208
|
let lo = 0n;
|
|
19967
20209
|
let hi;
|
|
19968
|
-
|
|
19969
|
-
|
|
19970
|
-
|
|
19971
|
-
|
|
19972
|
-
|
|
20210
|
+
if (isAuditLogResource(this.config.key)) {
|
|
20211
|
+
hi = BigInt(MAX_AUDIT_ID);
|
|
20212
|
+
} else {
|
|
20213
|
+
for (let t = 1n; ; t = t << 1n) {
|
|
20214
|
+
spend();
|
|
20215
|
+
if (await this.countAboveId(baseConds, t) <= latest) {
|
|
20216
|
+
hi = t;
|
|
20217
|
+
break;
|
|
20218
|
+
}
|
|
20219
|
+
lo = t;
|
|
19973
20220
|
}
|
|
19974
|
-
lo = t;
|
|
19975
20221
|
}
|
|
19976
20222
|
while (hi - lo > 1n) {
|
|
19977
20223
|
const mid = lo + hi >> 1n;
|
|
@@ -22328,6 +22574,36 @@ var SIMPLE_RESOURCES = [
|
|
|
22328
22574
|
helpers: { search: true, resolve: true, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
|
|
22329
22575
|
opForms: { get: "global", update: "global" }
|
|
22330
22576
|
},
|
|
22577
|
+
{
|
|
22578
|
+
key: "deleted_task_activity_logs",
|
|
22579
|
+
accessor: "deletedTaskActivityLogs",
|
|
22580
|
+
resourcePath: "/V1.0/DeletedTaskActivityLogs",
|
|
22581
|
+
deletable: false,
|
|
22582
|
+
udfCapable: false,
|
|
22583
|
+
ops: { query: true, queryAll: false, count: true, get: true, create: false, update: false, delete: false, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
|
|
22584
|
+
helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
|
|
22585
|
+
opForms: { get: "global" }
|
|
22586
|
+
},
|
|
22587
|
+
{
|
|
22588
|
+
key: "deleted_ticket_activity_logs",
|
|
22589
|
+
accessor: "deletedTicketActivityLogs",
|
|
22590
|
+
resourcePath: "/V1.0/DeletedTicketActivityLogs",
|
|
22591
|
+
deletable: false,
|
|
22592
|
+
udfCapable: false,
|
|
22593
|
+
ops: { query: true, queryAll: false, count: true, get: true, create: false, update: false, delete: false, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
|
|
22594
|
+
helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
|
|
22595
|
+
opForms: { get: "global" }
|
|
22596
|
+
},
|
|
22597
|
+
{
|
|
22598
|
+
key: "deleted_ticket_logs",
|
|
22599
|
+
accessor: "deletedTicketLogs",
|
|
22600
|
+
resourcePath: "/V1.0/DeletedTicketLogs",
|
|
22601
|
+
deletable: false,
|
|
22602
|
+
udfCapable: false,
|
|
22603
|
+
ops: { query: true, queryAll: false, count: true, get: true, create: false, update: false, delete: false, getEntityInfo: true, getFieldInfo: true, getUdfInfo: true },
|
|
22604
|
+
helpers: { search: false, resolve: false, getContext: false, createIfNotExists: false, attachToDocument: false, findBy: [] },
|
|
22605
|
+
opForms: { get: "global" }
|
|
22606
|
+
},
|
|
22331
22607
|
{
|
|
22332
22608
|
key: "departments",
|
|
22333
22609
|
accessor: "departments",
|
|
@@ -23337,7 +23613,7 @@ var GenericResource = class extends BaseResource {
|
|
|
23337
23613
|
}
|
|
23338
23614
|
async fetchPage(params, page, pageSize, state2) {
|
|
23339
23615
|
const key = this.config.key;
|
|
23340
|
-
if (isScopedAttachmentResource(key)) admitScopedAttachmentQuery(key, params);
|
|
23616
|
+
if (state2.initialRequest === void 0 && isScopedAttachmentResource(key)) admitScopedAttachmentQuery(key, params);
|
|
23341
23617
|
return super.fetchPage(params, page, pageSize, state2);
|
|
23342
23618
|
}
|
|
23343
23619
|
async countGlobal(params) {
|
|
@@ -25343,6 +25619,9 @@ async function validateAggregate(operation, filter, opts) {
|
|
|
25343
25619
|
const known = await checkFieldNames(resourceKey, conditions, opts, problems);
|
|
25344
25620
|
const groupBy = parseGroupBy(opts, oracles, known, problems);
|
|
25345
25621
|
const sum = checkSumFields("sum", opts.sum, problems);
|
|
25622
|
+
if (resourceKey !== void 0 && isAuditLogResource(resourceKey) && sum.some((field) => field.toLowerCase() === "id")) {
|
|
25623
|
+
problems.push("sum: audit log IDs are exact identifiers. Use groupBy for IDs or count for record totals.");
|
|
25624
|
+
}
|
|
25346
25625
|
const { top, limit } = parseTopAndLimit(opts, problems);
|
|
25347
25626
|
if (problems.length > 0) {
|
|
25348
25627
|
throw new AutotaskConfigError(
|
|
@@ -25653,7 +25932,10 @@ function validateFetchManyItems(items, cap, opName = "fetchByIds", capRef = `FET
|
|
|
25653
25932
|
continue;
|
|
25654
25933
|
}
|
|
25655
25934
|
try {
|
|
25656
|
-
parseIdentifier(item.id, `${at}.id`);
|
|
25935
|
+
const id = parseIdentifier(item.id, `${at}.id`);
|
|
25936
|
+
if (isAuditLogResource(resourceKey) && !isAuditDecimalId(String(id))) {
|
|
25937
|
+
problems.push(`${at}.id: audit log ID must be a non-negative signed 64-bit integer`);
|
|
25938
|
+
}
|
|
25657
25939
|
} catch {
|
|
25658
25940
|
if (typeof item.id === "string") {
|
|
25659
25941
|
problems.push(
|